Přeskočit na obsah

Proměnné a prostředí

Proměnné aplikace Restorm žijí ve složce proměnných, která jich může obsahovat několik sad: jednu pro každé prostředí.

Prostředí je seznam párů klíč / hodnota. Může obsahovat podprostředí, která dědí od svého rodiče a přepisují to, co samy definují znovu.

Je to správný nástroj pro namodelování stagingstaging / customer A, staging / customer B: společný základ se napíše jednou, opakuje se pouze rozdíl.

Strom prostředí: nadřazené prostředí „Petstore“ a jeho dvě podprostředí „Staging“ a „Production“

Přepínač prostředí je vlevo ve smartbaru každé karty požadavku. Zobrazuje barevný odznak a název prostředí.

Vyskakovací panel nabízí zaškrtávací pole „Použít na všechny požadavky“: zaškrtnuté přepne celou složku najednou — a to je právě to, co chcete, když převádíte celý projekt z local na staging.

Proměnná není jen řetězec. Restorm nabízí tyto typy:

TypCo to je
ŘetězecLiterální hodnota, odeslaná tak, jak je
VýrazŠablona Handlebars — jediný typ, u kterého se {{ }} vyhodnocují
ČísloČíslo, s formátem zobrazení
BooleanPravda / nepravda
Datum a časDatum ve formátu ISO, s formátem zobrazení
BarvaŠestnáctková barva
Tajný klíčOdkaz na zdroj tajemství — hodnota nikdy neprojde souborem projektu
SeznamSeznam hodnot
Výčet / Vícenásobný výčetHodnota omezená naimportovaným výčtovým typem
Vlastní seznam / Vícenásobný vlastní seznamVolba podle popisku z vlastního seznamu hodnot
ProměnnáOdkaz na jinou proměnnou
ProstředíOdkaz na prostředí
NullExplicitní nulová hodnota

Od nejobecnějšího k nejkonkrétnějšímu — vítězí poslední:

  1. korunové prostředí, potom každé podprostředí v řetězu;
  2. proměnné samotného prostředí, v pořadí jejich deklarace: proměnná se tedy může opřít o ty, které jsou definované nad ní;
  3. proměnné běhu vložené scénářem (akce Nastavit proměnnou), které prostředí po dobu běhu překryjí;
  4. hodnoty vlastní požadavku (hlavičky, parametry dotazu, parametry cesty), přičemž každá skupina se vyhodnocuje nad dosud nasbíraným kontextem;
  5. nakonec {{ }} zapsané přímo do polí požadavku — viz Vložené proměnné.

Restorm navíc provádí několik průchodů: výraz z nadřazeného prostředí tak může získat hodnotu, kterou předefinoval potomek.

Každá proměnná má zaškrtávací pole pro aktivaci. Vypnutá proměnná do kontextu nevstupuje — je to čistý způsob, jak dočasně vyřadit přepsání, aniž byste ho smazali.

Při importu se páry klíč / hodnota, jejichž hodnota se vyhodnotí jako prázdná, automaticky vypnou: váš první běh tedy neodešle celý zástup prázdných hlaviček.

Každý výraz je šablona Handlebars a k dispozici je více než sto helperů: řetězce, matematika, data, seznamy, kódování, hashování, náhodná data.