Zmienne i środowiska
Zmienne aplikacji Restorm żyją w folderze zmiennych, który może przechowywać wiele ich zestawów: po jednym na środowisko.
Środowiska i podśrodowiska
Section titled “Środowiska i podśrodowiska”Środowisko to lista par klucz / wartość. Może ono zawierać podśrodowiska, które dziedziczą po środowisku nadrzędnym i nadpisują to, co w nich zostało zdefiniowane ponownie.
To właściwe narzędzie do odwzorowania układu staging → staging / customer A,
staging / customer B: wspólną bazę zapisuje się raz, powtarza się wyłącznie
różnicę.
Wybór aktywnego środowiska
Section titled “Wybór aktywnego środowiska”Selektor środowiska znajduje się po lewej stronie smartbara każdej zakładki żądania. Wyświetla kolorową pastylkę oraz nazwę środowiska.
Okno podręczne zawiera pole wyboru „Zastosuj do wszystkich żądań”: po
zaznaczeniu przełącza cały folder naraz — dokładnie o to chodzi przy
przenoszeniu całego projektu z local na staging.
Typy wartości
Section titled “Typy wartości”Zmienna to nie tylko ciąg znaków. Restorm udostępnia następujące typy:
| Typ | Czym jest |
|---|---|
| Ciąg znaków | Wartość literalna, wysyłana bez zmian |
| Wyrażenie | Szablon Handlebars — jedyny typ, w którym {{ }} są obliczane |
| Liczba | Liczba wraz z formatem wyświetlania |
| Wartość logiczna | Prawda / fałsz |
| Data/godzina | Data w formacie ISO wraz z formatem wyświetlania |
| Kolor | Kolor szesnastkowy |
| Sekret | Odwołanie do źródła sekretu — wartość nigdy nie trafia do pliku projektu |
| Lista | Lista wartości |
| Wyliczenie / Wyliczenie wielokrotne | Wartość ograniczona zaimportowanym wyliczeniem |
| Własna lista / Własna lista wielokrotna | Wybór według etykiety z własnej listy wartości |
| Zmienna | Odwołanie do innej zmiennej |
| Środowisko | Odwołanie do środowiska |
| Null | Jawna wartość pusta |
Kolejność rozwiązywania
Section titled “Kolejność rozwiązywania”Od najbardziej ogólnego do najbardziej szczegółowego — wygrywa ostatni:
- środowisko główne, następnie każde podśrodowisko z łańcucha;
- zmienne samego środowiska, w kolejności ich zadeklarowania: zmienna może więc opierać się na tych zdefiniowanych powyżej;
- zmienne uruchomienia ustawione przez scenariusz (akcja Ustaw zmienną), które przesłaniają środowisko na czas wykonania;
- wartości właściwe dla żądania (nagłówki, parametry zapytania, parametry ścieżki), przy czym każda grupa rozwiązuje się na zgromadzonym kontekście;
- na końcu
{{ }}zapisane bezpośrednio w polach żądania — zob. Zmienne inline.
Restorm wykonuje przy tym kilka przebiegów: wyrażenie ze środowiska nadrzędnego może więc pobrać wartość zdefiniowaną ponownie przez środowisko podrzędne.
Zmienne wyłączone
Section titled “Zmienne wyłączone”Każda zmienna ma pole aktywacji. Zmienna wyłączona nie wchodzi do kontekstu — to czysty sposób na tymczasowe zneutralizowanie nadpisania bez jego usuwania.
Przy imporcie pary klucz / wartość, których wartość rozwiązuje się do pustej, zostają automatycznie wyłączone: pierwsze uruchomienie nie wysyła więc chmary pustych nagłówków.
A co z helperami?
Section titled “A co z helperami?”Każde wyrażenie jest szablonem Handlebars, z ponad setką dostępnych helperów: ciągi znaków, matematyka, daty, listy, kodowanie, haszowanie, dane losowe.