Varijable i podaci u scenariju

Scenarij raspolaže trima mehanizmima za kruženje podataka. Oni se nadopunjuju, a znati koji odabrati štedi mnogo suvišnog ožičavanja.

1. Tokeni na vezama

Glavni mehanizam: kutija proizvede vrijednost, ona putuje vezom, po potrebi je preoblikuje selektor, i stiže na ulaz sljedeće kutije.

To je izričito i čitljivo: tok podataka jest crtež.

Upotrijebite ga za sve što je lokalno — rezultat poziva koji troši sljedeći poziv.

2. Varijable izvođenja

Imenovani prostor, svojstven izvođenju:

• Postavi varijablu zapisuje vrijednost;
• Čitaj varijablu ponovno je čita;
• vrijednost tipa varijabla čita je u letu, u bilo kojem polju;
• {{naziv}} čita je u predlošku (Transform template, Map);
• objekt vars čita je u akciji koda;
• Dodaj na popis i Ukloni s popisa mogu zapisivati izravno u izvornu varijablu.

Varijabla izvođenja prekriva okruženje za vrijeme izvođenja: zahtjev koji koristi {{token}} uzet će token koji je postavio scenarij, a ne onaj iz okruženja.

Upotrijebite je za ono što je globalno za izvođenje: token, korelacijski identifikator, brojač — umjesto povlačenja veze kroz cijeli graf.

3. Parametri i izlazi

• Kutija Input / Param deklarira jedan ili više imenovanih parametara, svaki sa svojim tipom. Emitira jedan jedini objekt { name: value, … }.

  Vrijednosti dolaze, ovim redom: iz pokretanja (sučelje ili MCP), iz naredbene linije (--param name=value) ili iz interaktivnog upita ako scenarij dosegne kutiju bez dostupne vrijednosti.

• Kutija Output / Return izlaže imenovani rezultat pozivatelju. Scenarij koji poziva akcija Izvedi scenarij čini svoje izlaze vidljivima na portu output:<name> pozivatelja.

To omogućuje kompoziciju: scenarij „prijava” koji vraća token, a ostali ga ponovno koriste.

Okruženja

Akcija zahtjeva ima port env: ožičavanje okruženja na njega (vrijednost tipa environment ili naziv okruženja) izvodi poziv u tom okruženju.

To je način da isti scenarij pokrenete prema staging pa prema production bez ikakvog udvostručavanja — okruženje proslijedite kao parametar scenarija.

Razrješavanje u headless načinu

Sve se tipizirane vrijednosti razrješavaju jednako u sučelju i bez prozora: prilagođeni popisi, enumeracije, pregledi okruženja. Scenarij koji radi u sučelju radi i u CI-ju.

Dvosmislen naziv okruženja (dva istoimena okruženja) izaziva izričitu pogrešku: tada proslijedite identifikator.

Pretvorba parametara u naredbenoj liniji

--param prima tekst; Restorm ga pretvara prema deklariranom tipu parametra:

Deklarirani tip	Što prosljeđujete
Broj	--param Seuil=42
Boolean	--param Actif=true (prihvaćaju se 1, yes, on)
Izračun datuma	Datum ili epoch vremenska oznaka
Popis	JSON: --param Ids='[1,2,3]'
Enumeracija	Vrijednost, provjerena prema dopuštenom skupu
Prilagođeni popis	Naziv, pretvoren u vrijednost (Rouge → FF0000)
Okruženje	Naziv ili identifikator okruženja
Ostalo	Sirovi niz

Neizvediva pretvorba prekida pokretanje uz jasnu poruku, umjesto da se izvođenje nastavi s pogrešnom vrijednošću.