Construirea unui scenariu

Editorul

Canavaua în centru, paleta de adăugare și inspectorul în jur. Cutiile se deplasează cu mouse-ul, iar vizualizarea se deplasează și se mărește.

Adăugarea unei cutii

Din paletă, organizată pe categorii: control, compunere (cereri și conexiuni), liste, bucle, timp, matematică, algoritmică, formate de date, codificare, interfață, utilitare.

O acțiune legată de o cerere (Cerere HTTP, Cerere SOAP, toate acțiunile de conexiune) cere să desemnați cererea din proiect pe care o controlează.

Legătura scenariu ↔ cerere

Desemnarea unei cereri într-o acțiune creează o legătură puternică: acțiunea referențiază cererea prin identificatorul său, nu printr-o copie. Ce decurge de aici:

• cererea rămâne partajată — modificarea ei (URL, antete, corp) schimbă ce rulează toate scenariile care o folosesc, la următoarea lor execuție;
• legătura supraviețuiește redenumirii sau mutării cererii în arbore: nu se sprijină nici pe nume, nici pe cale;
• din cerere, smartbar-ul poartă un buton „Folosită în scenarii” — acesta listează scenariile care o apelează și permite să săriți la ele. Este reflexul de avut înainte de a modifica o cerere partajată;
• o cerere lipsă (ștearsă sau absentă la deschiderea proiectului) face să eșueze validarea scenariului: butonul de redare rămâne blocat, iar cutia vinovată este semnalată — niciodată un scenariu stricat în tăcere.

Pentru a rejuca aceeași cerere fără să atingeți versiunea sa salvată, nu o modificați: folosiți suprascrierile (setare rapidă, suprascrieri de acțiune, legătură) descrise în Suprascrierea unei cereri.

Configurarea unei cutii

Fiecare cutie are câmpurile sale, completate direct pe cutie sau în inspector. Câmpurile acceptă valori tipizate — șir, număr, boolean, dată, expresie Handlebars, variabilă, listă personalizată, secret… — vedeți Variabile și medii.

Ctrl+Space declanșează autocompletarea variabilelor și a helperilor în câmpurile care o acceptă.

Cablarea

Trageți de la un port de ieșire spre un port de intrare.

Două reguli de știut:

1. Un port de intrare nu acceptă decât o singură legătură — cu excepția portului in, care acceptă oricâte și joacă atunci rol de barieră.
2. O ieșire de semnal pur nu poate alimenta o intrare de valoare pură. Tot restul este permis: o ieșire care poartă o valoare servește și ca declanșator.

Detalii: Porturi și legături.

Selectorul de legătură

O legătură poate purta un selector: o cale aplicată valorii aflate în tranzit.

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

Este ceea ce evită intercalarea unei cutii de transformare între fiecare apel și consumatorul său. Selectorul se reglează la crearea legăturii sau mai târziu; golirea lui îl șterge.

Suprascrierea unei cereri

O acțiune legată de o cerere o poate modifica fără să atingă cererea însăși. Patru straturi, în această ordine:

1. cererea așa cum este salvată;
2. o setare rapidă (quick config) desemnată pe acțiune — astfel se reutilizează o variantă salvată a unei cereri direct într-un scenariu, fără să o reintroduceți;
3. suprascrierile completate pe acțiune;
4. valoarea care sosește printr-o legătură pe portul de suprascriere.

Este modul curat de a rejuca același apel cu trei seturi de date.

Rejucarea la fiecare eveniment

Meniul contextual al unei cutii propune „Rejoacă la fiecare eveniment primit”. Activată, opțiunea transformă toate intrările cablate în porți „sau” neblocante: cutia se redeclanșează la fiecare valoare primită pe oricare port, în loc să aștepte ca toate să fie prezente.

Este indispensabilă pentru tratarea unui flux (fiecare mesaj MQTT, fiecare eveniment SSE) și este totodată ceea ce deblochează un ciclu de finalizare.

Parametri și ieșiri

• O cutie Input / Param declară parametrii scenariului. Ei sunt furnizați la lansare, în linia de comandă (--param name=value) sau ceruți la execuție, în mod interactiv.
• O cutie Output / Return expune un rezultat apelantului — util când scenariul este apelat de un altul prin acțiunea Rulează scenariul.

Organizarea

Restorm știe să aranjeze automat un graf (dispunere); cutiile rămân apoi deplasabile manual. Ctrl+Z anulează, Ctrl+Shift+Z reface.

Validarea

Butonul de redare este blocat atât timp cât rămân erori de validare: legătură invalidă, cerere lipsă, câmp obligatoriu gol. Cutiile vinovate sunt semnalate.