Úvod do scénářů

Scénář je graf. Bloky (jednotlivé akce) jsou spojené propojeními, která přenášejí hodnoty a signály. Motor spustí blok v okamžiku, kdy všechny jeho zapojené vstupy něco obdržely.

Právě to v aplikaci Restorm zastupuje skripty před požadavkem a po požadavku, jak je znáte z jiných klientů API — a to s jednou rozhodující výhodou: tok je vidět.

Klikněte pravým tlačítkem ve stromu ▸ Přidat ▸ Scénář.

K čemu to slouží

• Řetězit volání a předávat hodnotu z jednoho do druhého: vytvořit zdroj, získat jeho identifikátor a použít jej v následujícím volání.
• Kontrolovat: asserce, validace schématu JSON, srovnání.
• Větvit a opakovat: if, switch, for, forEach, while, retry.
• Orchestrovat několik přenosů: otevřít odběr MQTT, spustit akci přes HTTP a ověřit, že zpráva dorazí.
• Automatizovat: tentýž scénář běží v rozhraní i bez okna v průběžné integraci.

Stavební prvky

Pojem	Co to je
Blok (uzel)	Jedna akce. K dispozici je devadesát typů — viz katalog
Port	Typované a orientované místo pro zapojení na bloku
Propojení (hrana)	Vodič mezi výstupním a vstupním portem
Selektor	Cesta uplatněná na hodnotu, která prochází propojením (data.items[0].id)
Proměnná běhu	Pojmenovaná hodnota, zapsaná a znovu přečtená během běhu
Parametr	Vstup scénáře, zadaný při spuštění nebo na příkazové řádce
Výstup	Výsledek zpřístupněný tomu, kdo scénář zavolal

Tři porty, které má každý blok

Nejsou vypsané v jeho konfiguraci: patří k rámu samotného bloku.

Port	Směr	Role
in	Vstup	Spouštěč. Přijímá více vstupních propojení a pak čeká, dokud nedorazí všechna — je to bariéra „počkej, až se dokončí několik větví“
error	Výstup	Trasa selhání. Vše, co se nepovede, odchází tudy
done	Výstup	Vysílá se, jakmile blok a celý jeho navazující podgraf skončí

Rozdíl mezi done a hodnotovým výstupem je důležitý: hodnota vychází v okamžiku, kdy je vytvořená, kdežto done čeká, dokud neskončí vše, co na ní závisí.

První scénář

1. Přidejte akci Požadavek HTTP a svažte ji s existujícím požadavkem.
2. Přidejte akci Assert s operátorem eq.
3. Veďte propojení z portu response požadavku na vstup a asserce a na toto propojení nasaďte selektor status.
4. V asserci nastavte b na 200.
5. Klikněte na Spustit.

Asserce má dva výstupy, then a else: na každý z nich zapojte Log nebo Toast, abyste výsledek viděli procházet.

Kam dál

• Vytvoření scénáře — úkony v editoru.
• Porty a propojení — model běhu podrobně.
• Proměnné a data ve scénáři — jak hodnoty putují.
• Katalog akcí — všech 90 bloků.
• Akce s kódem — když graf nestačí.

Edice

Navrhovat a spouštět scénáře v rozhraní je součástí edice Community. Běh v režimu headless v CI a ladění po krocích vyžadují edici Pro — viz Plány a možnosti.