Omgeving
Omgevingsvariabelen slaan herbruikbare waarden op waarnaar je kunt verwijzen in verzoeken in Opnieuw versturen, Automatiseren en Workflows.
Variabelen maken en bewerken
- Open Omgeving vanuit de linkernavigatie.
- Klik op Nieuw.
- Voer een naam in die begint met een letter of onderstrepingsteken, gevolgd door letters, cijfers, onderstrepingstekens of koppeltekens (maximaal 64 tekens).
- Voer de waarde in.
- Schakel Geheim in als de waarde gevoelig is (API-sleutels, tokens, wachtwoorden). Geheime waarden worden gemaskeerd in de interface en uitgesloten van AI-context.
- Klik op Opslaan.
Klik om een bestaande variabele te bewerken op de rij en pas de naam of waarde aan.
Variabelen in verzoeken gebruiken
Verwijs naar een omgevingsvariabele met het voorvoegsel env.:
{{env.VARIABLE_NAME}}Voorbeelden:
- Hostveld:
{{env.TARGET_HOST}}(sla een hostnaam op, geen volledige URL). - Authorization-header:
Bearer {{env.AUTH_TOKEN}}. - Verzoekbody:
{"tenant": "{{env.TENANT_ID}}"}; schakel bodysjablonen in Opnieuw versturen in wanneer je vervangingen in de body wilt.
Ogma vult geldige omgevingsplaceholders in op het moment van versturen. Een ontbrekende variabele veroorzaakt een fout in plaats van stilzwijgend een niet-ingevulde waarde te versturen. Verzendingen via Onbewerkt en Hex in Opnieuw versturen behouden exacte bytes en vullen geen placeholders in.
Reikwijdte van variabelen
Kies Globaal voor waarden die worden gedeeld door projecten in deze Ogma-werkruimte, of Project voor waarden die bij het actieve project horen. Projectwaarden overschrijven globale waarden met dezelfde naam. Opnieuw versturen ondersteunt ook overschrijvingen op verzameling- en sessieniveau; de prioriteit is sessie, verzameling, project en vervolgens globaal.
Transformaties en dynamische waarden
Voeg transformaties toe met een pipe, bijvoorbeeld {{env.AUTH_TOKEN|base64_encode}} of {{env.SEARCH|url_encode}}. De keten wordt van links naar rechts toegepast. Controleer de uitvoer met een testverzoek: onbekende transformatienamen worden overgeslagen en niet als fouten gemeld.
Ingebouwde waarden hebben geen opgeslagen variabele nodig:
| Placeholder | Waarde |
|---|---|
{{$timestamp}} | Huidige Unix-tijd in milliseconden. |
{{$timestamp_s}} | Huidige Unix-tijd in seconden. |
{{$uuid}} | Een nieuwe UUID. |
{{$random(16)}} | 16 willekeurige bytes weergegeven als hexadecimaal. |
{{$date(%Y-%m-%d)}} | Huidige UTC-datum volgens een datumformaatpatroon. |
Opgeslagen waarden worden niet recursief ingevuld. Als een waarde een andere placeholder bevat, blijft die geneste tekst letterlijk behouden.
Toegang door de AI-assistent
De AI-assistent kan namen en waarden van niet-geheime variabelen lezen om context te bieden wanneer je vraagt een verzoek te analyseren of een testplan op te stellen. Geheime variabelen worden nooit in AI-context opgenomen.
Veelvoorkomende toepassingen
| Variabele | Voorbeeldwaarde |
|---|---|
BASE_URL | https://api.example.com |
AUTH_TOKEN | eyJhbGci... (markeer als geheim) |
TARGET_HOST | app.example.com |
API_KEY | sk-... (markeer als geheim) |
USER_ID | 12345 |