Variabile și date într-un scenariu

Un scenariu dispune de trei mecanisme pentru a face să circule datele. Ele se completează, iar a ști pe care să îl alegeți evită multă cablare inutilă.

1. Jetoanele de pe legături

Mecanismul principal: o cutie produce o valoare, aceasta călătorește pe legătură, eventual remodelată de un selector, și ajunge în intrarea cutiei următoare.

Este explicit și lizibil: fluxul de date este desenul.

Folosiți-l pentru tot ce este local — rezultatul unui apel consumat de apelul următor.

2. Variabilele de rulare

Un spațiu denumit, propriu execuției:

• Definește variabilă scrie o valoare;
• Citește variabilă o recitește;
• o valoare tipizată variable o citește din zbor, în orice câmp;
• {{nom}} o citește într-un șablon (Transform template, Map);
• obiectul vars o citește într-o acțiune de cod;
• Adaugă la listă și Elimină din listă pot scrie direct în variabila sursă.

O variabilă de rulare acoperă mediul pe durata execuției: o cerere care folosește {{token}} va lua tokenul pus de scenariu, nu pe cel al mediului.

Folosiți-o pentru ceea ce este global la nivelul execuției: un token, un identificator de corelare, un contor — în loc să trageți o legătură prin tot graful.

3. Parametri și ieșiri

• Cutia Input / Param declară unul sau mai mulți parametri denumiți, fiecare cu tipul său. Ea emite un singur obiect { name: value, … }.

  Valorile vin, în ordine: de la lansare (interfață sau MCP), din linia de comandă (--param name=value) sau dintr-o cerere interactivă, dacă scenariul ajunge la cutie fără o valoare disponibilă.

• Cutia Output / Return expune un rezultat denumit apelantului. Un scenariu apelat de o acțiune Rulează scenariul își face ieșirile vizibile pe portul output:<name> al apelantului.

Este ceea ce permite compunerea: un scenariu „conectare” care returnează un token, reutilizat de celelalte.

Medii

O acțiune de cerere are un port env: cablarea unui mediu pe acesta (valoare tipizată environment sau nume de mediu) execută apelul în acel mediu.

Este modul de a rula același scenariu împotriva mediului staging și apoi production, fără să dublați nimic — transmiteți mediul ca parametru al scenariului.

Rezolvarea în mod headless

Toate valorile tipizate se rezolvă în același fel în interfață și fără fereastră: liste personalizate, enumerări, previzualizări de mediu. Un scenariu care funcționează în interfață funcționează și în CI.

Un nume de mediu ambiguu (două medii omonime) provoacă o eroare explicită: transmiteți atunci identificatorul.

Conversia parametrilor din linia de comandă

--param primește text; Restorm îl convertește în funcție de tipul declarat al parametrului:

Tip declarat	Ce transmiteți
Numeric	--param Seuil=42
Boolean	--param Actif=true (1, yes, on acceptate)
Calcul de dată	O dată sau un marcaj temporal epoch
Listă	JSON: --param Ids='[1,2,3]'
Enumerare	Valoarea, validată în raport cu setul autorizat
Listă personalizată	Eticheta, convertită în valoare (Rouge → FF0000)
Mediu	Un nume sau un identificator de mediu
Restul	Șirul brut

O conversie imposibilă face să eșueze lansarea, cu un mesaj clar, în loc să ruleze cu o valoare greșită.