Bevezetés a forgatókönyvekbe

A forgatókönyv egy gráf. Blokkokat (a műveleteket) társítások kötnek össze, amelyek értékeket és jeleket szállítanak. A motor akkor futtat le egy blokkot, amint minden bekötött bemenete kapott valamit.

Ez az, ami a Restormban a többi API-kliens kérés előtti és kérés utáni szkriptjeit váltja fel — egy döntő előnnyel: az áramlás látható.

Jobb kattintás a projektfában ▸ Hozzáadás ▸ Forgatókönyv.

Mire jó

• Hívások láncolása, egy érték átadásával egyikről a másikra: erőforrás létrehozása, az azonosítójának kiolvasása, majd felhasználása a következő hívásban.
• Ellenőrzés: állítások, JSON-séma-validálás, összehasonlítás.
• Elágazás és ciklusok: if, switch, for, forEach, while, retry.
• Több átvitel összehangolása: MQTT-feliratkozás megnyitása, művelet kiváltása HTTP-n, majd annak ellenőrzése, hogy megérkezik-e az üzenet.
• Automatizálás: ugyanaz a forgatókönyv fut a felületen és ablak nélkül, folyamatos integrációban.

Az építőelemek

Fogalom	Mi ez
Blokk (csomópont)	Egy művelet. Kilencven típus áll rendelkezésre — lásd a katalógust
Port	Egy blokk bekötési pontja, típussal és iránnyal
Társítás (él)	Vezeték egy kimeneti és egy bemeneti port között
Választó	Egy társításon áthaladó értékre alkalmazott útvonal (data.items[0].id)
Futásváltozó	Megnevezett érték, amely a futtatás közben beállítható és visszaolvasható
Paraméter	A forgatókönyv bemenete, indításkor vagy a parancssorban megadva
Kimenet	A forgatókönyv hívója felé közzétett eredmény

A három port, amellyel minden blokk rendelkezik

Ezek nem szerepelnek a beállítások között: a blokk keretének a részei.

Port	Irány	Szerep
in	Bemenet	A kiváltó. Több bejövő társítást is elfogad, és ilyenkor megvárja, hogy mindegyik megérkezzen — ez a „várni több ág befejezésére” sorompó
error	Kimenet	A hibaútvonal. Minden, ami elhasal, erre lép ki
done	Kimenet	Akkor lép ki, amikor a blokk és a teljes alatta lévő részgráf befejeződött

A done és az értékkimenet közötti különbség fontos: egy érték azonnal kilép, amint elkészült, a done viszont megvárja, hogy minden befejeződjön, ami tőle függ.

Az első forgatókönyv

1. Adjon a gráfhoz egy HTTP-kérés műveletet, és kösse hozzá egy meglévő kéréshez.
2. Adjon hozzá egy Assert műveletet eq operátorral.
3. Húzzon egy társítást a kérés response portjáról az állítás a bemenetére, és állítsa be ezen a társításon a status választót.
4. Az állításban b értéke legyen 200.
5. Kattintson a Futtatás gombra.

Az állításnak két kimenete van, then és else: mindkettőre érdemes egy Log vagy egy Toast műveletet kötni, hogy látszódjon az eredmény.

Hogyan tovább

• Forgatókönyv felépítése — a szerkesztő műveletei.
• Portok és társítások — a végrehajtási modell részletesen.
• Változók és adatok — hogyan áramlanak az értékek.
• Műveletek katalógusa — a 90 blokk.
• Kódműveletek — amikor a gráf nem elég.

Kiadás

A forgatókönyvek megtervezése és futtatása a felületen a Community kiadás része. A headless futtatás CI-ben és a lépésenkénti hibakeresés a Pro kiadást igényli — lásd: Előfizetések és képességek.