Forgatókönyv felépítése

A szerkesztő

Középen a vászon, körülötte a hozzáadási paletta és a vizsgáló. A blokkok egérrel mozgathatók, a nézet pásztázható és nagyítható.

Blokk hozzáadása

A palettáról, amely kategóriák szerint tagolódik: vezérlés, összeállítás (kérések és kapcsolatok), listák, ciklusok, idő, matematika, algoritmika, adatformátumok, kódolás, felület, segédeszközök.

A kéréshez kötött műveleteknél (HTTP-kérés, SOAP kérés, az összes kapcsolódási művelet) meg kell adni, hogy a projekt melyik kérését vezérlik.

A forgatókönyv ↔ kérés kapcsolat

Ha egy műveletben ki van választva egy kérés, azzal erős kapcsolat jön létre: a művelet az azonosítója alapján hivatkozik a kérésre, nem egy másolat útján. Ennek a következményei:

• a kérés megosztott marad — a módosítása (URL, fejlécek, törzs) megváltoztatja, hogy minden őt használó forgatókönyv mit futtat a következő futtatáskor;
• a kapcsolat túléli a kérés átnevezését vagy a projektfában való áthelyezését: sem a névre, sem az útvonalra nem támaszkodik;
• a kérés felől a smartbar tartalmaz egy „Ezt a kérést használó forgatókönyvek” gombot — felsorolja az őt meghívó forgatókönyveket, és át is lehet lépni rájuk. Ez az a lépés, amelyet megosztott kérés módosítása előtt érdemes megtenni;
• egy hiányzó kérés (törölt, vagy a projekt megnyitásakor nem található) megbuktatja a forgatókönyv ellenőrzését: a futtatás gomb letiltva marad, a hibás blokk pedig meg van jelölve — soha nincs csendben eltört forgatókönyv.

Ha ugyanazt a kérést a mentett változatának érintése nélkül kell újra lefuttatni, nem módosítani kell, hanem a felülírásokat érdemes használni (gyorsbeállítás, művelet szintű felülírások, társítás), lásd: Kérés felülírása.

Blokk beállítása

Minden blokknak megvannak a saját mezői, amelyek közvetlenül a blokkon vagy a vizsgálóban tölthetők ki. A mezők típusos értékeket fogadnak el — karakterlánc, szám, logikai érték, dátum, Handlebars-kifejezés, változó, egyéni értéklista, titok… —, lásd: Változók és környezetek.

A Ctrl+Space billentyűparancs a változók és a helperek automatikus kiegészítését hívja elő azokban a mezőkben, amelyek ezt támogatják.

Bekötés

Húzzon egy vezetéket egy kimeneti portról egy bemeneti portra.

Két szabályt kell ismerni:

1. Egy bemeneti port csak egyetlen társítást fogad el — kivéve az in portot, amely bármennyit elfogad, és ilyenkor sorompóként működik.
2. Tisztán jel típusú kimenet nem táplálhat tisztán érték típusú bemenetet. Minden más megengedett: az értéket szállító kimenet kiváltóként is működik.

Részletek: Portok és társítások.

Élválasztó

Egy társítás választót is hordozhat: egy útvonalat, amely az áthaladó értékre vonatkozik.

data.items[0].id
body['user-id']
status

Ennek köszönhetően nem kell minden hívás és a fogyasztója közé átalakító blokkot beszúrni. A választó a társítás létrehozásakor vagy később is beállítható; kiürítésével törlődik.

Kérés felülírása

A kéréshez kötött művelet módosíthatja a kérést anélkül, hogy magához a kéréshez hozzáérne. Négy réteg, ebben a sorrendben:

1. a kérés úgy, ahogyan el van mentve;
2. a műveleten kiválasztott gyorsbeállítás (quick config) — így lehet egy kérés elmentett változatát közvetlenül egy forgatókönyvben újra felhasználni, újbóli begépelés nélkül;
3. a műveleten megadott felülírások;
4. a felülírási portra társításon beérkező érték.

Ez a tiszta módja annak, hogy ugyanaz a hívás három különböző adathalmazzal fusson le.

Újrafuttatás minden eseménynél

A blokk helyi menüjében megtalálható az „Újrafuttatás minden beérkező eseménynél” lehetőség. Bekapcsolva minden bekötött bemenetet nem blokkoló „vagy” kapuvá alakít: a blokk minden beérkező értéknél újra elindul, bármelyik porton érkezzen is, ahelyett hogy megvárná mindegyiket.

Ez elengedhetetlen egy folyam feldolgozásához (minden MQTT-üzenet, minden SSE-esemény), és ez oldja fel a befejezési kört is.

Paraméterek és kimenetek

• Az Input / Param blokk deklarálja a forgatókönyv paramétereit. Ezek megadhatók indításkor, a parancssorban (--param name=value), vagy interaktív módban futás közben bekérhetők.
• Az Output / Return blokk egy eredményt tesz elérhetővé a hívó számára — akkor hasznos, ha a forgatókönyvet egy másik hívja meg a Forgatókönyv futtatása művelettel.

Rendezés

A Restorm képes automatikusan elrendezni egy gráfot (elrendezés); a blokkok utána is kézzel mozgathatók maradnak. A Ctrl+Z visszavon, a Ctrl+Shift+Z újra alkalmaz.

Ellenőrzés

A futtatás gomb le van tiltva, amíg ellenőrzési hiba van: érvénytelen társítás, hiányzó kérés, kitöltetlen kötelező mező. A hibás blokkok meg vannak jelölve.