Proměnné a data ve scénáři

Scénář má tři mechanismy, kterými nechává data putovat. Doplňují se navzájem a vědět, který zvolit, ušetří spoustu zbytečného zapojování.

1. Tokeny na propojeních

Hlavní mechanismus: blok vytvoří hodnotu, ta putuje po propojení, případně ji přetvaruje selektor, a dorazí na vstup následujícího bloku.

Je to explicitní a čitelné: tok dat je ten obrázek.

Používejte jej na všechno lokální — na výsledek volání, který spotřebuje následující volání.

2. Proměnné běhu

Pojmenovaný prostor, vlastní jednomu běhu:

• Nastavit proměnnou hodnotu zapíše;
• Získat proměnnou ji zase přečte;
• hodnota typu variable ji přečte za běhu v kterémkoli poli;
• {{nom}} ji přečte v šabloně (Transform template, Map);
• objekt vars ji přečte v akci s kódem;
• Přidat do seznamu a Odebrat ze seznamu mohou zapisovat přímo do zdrojové proměnné.

Proměnná běhu po dobu běhu překrývá prostředí: požadavek, který používá {{token}}, si vezme token vložený scénářem, a nikoli token z prostředí.

Používejte ji na to, co je pro celý běh globální: token, korelační identifikátor, čítač — místo abyste táhli propojení skrz celý graf.

3. Parametry a výstupy

• Blok Input / Param deklaruje jeden nebo více pojmenovaných parametrů, každý se svým typem. Vysílá jediný objekt { name: value, … }.

  Hodnoty přicházejí v tomto pořadí: ze spuštění (rozhraní nebo MCP), z příkazové řádky (--param name=value), nebo z interaktivního dotazu, pokud scénář k bloku dorazí bez dostupné hodnoty.

• Blok Output / Return zpřístupní pojmenovaný výsledek tomu, kdo scénář zavolal. Scénář volaný akcí Spustit scénář své výstupy zviditelní na portu output:<name> volajícího bloku.

Právě to umožňuje skládání: scénář „přihlásit se“, který vrátí token, jenž pak znovu použijí ostatní.

Prostředí

Akce požadavku má port env: zapojíte-li do něj prostředí (hodnota typu environment, nebo název prostředí), volání se provede v tomto prostředí.

Je to způsob, jak nechat tentýž scénář běžet proti staging a poté production, aniž byste cokoli duplikovali — prostředí předejte jako parametr scénáře.

Vyhodnocování v režimu headless

Všechny typované hodnoty se vyhodnocují stejně v rozhraní i bez okna: vlastní seznamy, výčtové typy, náhledy prostředí. Scénář, který funguje v rozhraní, funguje i v CI.

Nejednoznačný název prostředí (dvě prostředí se stejným názvem) vyvolá výslovnou chybu: v takovém případě předejte identifikátor.

Převod parametrů na příkazové řádce

--param přijímá text; Restorm ho převede podle deklarovaného typu parametru:

Deklarovaný typ	Co předáte
Číslo	--param Seuil=42
Boolean	--param Actif=true (přijímá se i 1, yes, on)
Výpočet s datem	Datum, nebo časovou značku epoch
Seznam	JSON: --param Ids='[1,2,3]'
Výčtový typ	Hodnotu, ověřenou proti povolené množině
Vlastní seznam	Popisek, převedený na hodnotu (Rouge → FF0000)
Prostředí	Název nebo identifikátor prostředí
Vše ostatní	Holý řetězec

Nemožný převod nechá spuštění selhat s jasnou zprávou, místo aby se běh provedl se špatnou hodnotou.