Środowisko

Zmienne środowiskowe przechowują wartości wielokrotnego użytku, do których można odwoływać się w żądaniach w panelach Ponowne wysyłanie, Automatyzacja i Przepływy pracy.

Tworzenie i edytowanie zmiennych

1. Otwórz Środowisko w lewym panelu nawigacji.
2. Kliknij Nowa, aby dodać zmienną.
3. Wprowadź nazwę zaczynającą się od litery lub podkreślenia, po których mogą występować litery, cyfry, podkreślenia lub łączniki (maksymalnie 64 znaki).
4. Wprowadź wartość.
5. Włącz Sekret, jeśli wartość jest poufna (klucze API, tokeny, hasła). Wartości sekretów są maskowane w interfejsie i wykluczane z kontekstu AI.
6. Kliknij Zapisz.

Aby edytować istniejącą zmienną, kliknij jej wiersz i zmień nazwę lub wartość.

Używanie zmiennych w żądaniach

Odwołuj się do zmiennej środowiskowej za pomocą prefiksu env.:

{{env.VARIABLE_NAME}}

Przykłady:

• Pole hosta: {{env.TARGET_HOST}} (zapisz nazwę hosta, a nie pełny URL).
• Nagłówek autoryzacji: Bearer {{env.AUTH_TOKEN}}.
• Treść żądania: {"tenant": "{{env.TENANT_ID}}"}; włącz szablony treści w panelu Ponowne wysyłanie, jeśli chcesz podstawiać wartości w treści.

Ogma podczas wysyłania podstawia wartości zmiennych w poprawnych symbolach zastępczych środowiska. Jeśli zmienna nie istnieje, Ogma zgłasza błąd zamiast bez ostrzeżenia wysłać symbol zastępczy niezastąpiony wartością. Wysyłanie w trybach Surowe (Raw) i Szesnastkowy (Hex) w panelu Ponowne wysyłanie zachowuje dokładne bajty i nie rozwija symboli zastępczych.

Zakres zmiennych

Wybierz Globalny dla wartości współdzielonych przez projekty w tym obszarze roboczym Ogma lub Projekt dla wartości należących do aktywnego projektu. Wartości projektu zastępują wartości globalne o tej samej nazwie. Ponowne wysyłanie obsługuje też nadpisania na poziomie kolekcji i sesji; kolejność pierwszeństwa to sesja, kolekcja, projekt, a następnie wartości globalne.

Transformacje i wartości dynamiczne

Dodawaj transformacje za pomocą pionowej kreski, na przykład {{env.AUTH_TOKEN|base64_encode}} lub {{env.SEARCH|url_encode}}. Łańcuch jest stosowany od lewej do prawej. Sprawdź wynik żądaniem testowym: nierozpoznane nazwy transformacji są pomijane, a nie zgłaszane jako błędy.

Wartości wbudowane nie wymagają zapisanej zmiennej:

Symbol zastępczy	Wartość
{{$timestamp}}	Bieżący czas Unix w milisekundach.
{{$timestamp_s}}	Bieżący czas Unix w sekundach.
{{$uuid}}	Nowy UUID.
{{$random(16)}}	16 losowych bajtów w zapisie szesnastkowym.
{{$date(%Y-%m-%d)}}	Bieżąca data UTC zgodnie ze wzorcem formatu daty.

Zapisane wartości nie są rozwijane rekurencyjnie. Jeśli wartość zawiera inny symbol zastępczy, tekst tego zagnieżdżonego symbolu pozostaje bez zmian.

Dostęp asystenta AI

Asystent AI może odczytywać nazwy i wartości zmiennych nieoznaczonych jako sekrety, aby uzyskać kontekst, gdy poprosisz go o analizę żądania lub przygotowanie planu testów. Zmienne oznaczone jako sekrety nigdy nie są uwzględniane w kontekście AI.

Typowe zastosowania

Zmienna	Przykładowa wartość
BASE_URL	https://api.example.com
AUTH_TOKEN	eyJhbGci... (oznacz jako sekret)
TARGET_HOST	app.example.com
API_KEY	sk-... (oznacz jako sekret)
USER_ID	12345

Powiązane strony

• Ponowne wysyłanie
• Automatyzacja
• Przepływy pracy