Variablat dhe të dhënat brenda një skenari

Një skenar ka tri mekanizma për t’i bërë të qarkullojnë të dhënat. Ata plotësojnë njëri-tjetrin dhe të dish cilin të zgjedhësh të kursen shumë kabllëzim të panevojshëm.

1. Shenjat mbi lidhjet

Mekanizmi kryesor: një kuti prodhon një vlerë, ajo udhëton mbi lidhjen, ndonjëherë e riformuar nga një zgjedhës, dhe mbërrin te hyrja e kutisë pasuese.

Kjo është e qartë dhe e lexueshme: fluksi i të dhënave është vetë vizatimi.

Përdoreni për gjithçka që është lokale — rezultati i një thirrjeje i konsumuar nga thirrja pasuese.

2. Variablat e ekzekutimit

Një hapësirë e emërtuar, specifike për ekzekutimin:

• Përcakto variabël shkruan një vlerë;
• Lexo variabël e rilexon atë;
• një vlerë e tipizuar variable e lexon në fluturim, brenda cilësdo fushë;
• {{nom}} e lexon brenda një gjedheje (Transform template, Map);
• objekti vars e lexon brenda një veprimi kodi;
• Shto te lista dhe Hiq nga lista mund të shkruajnë drejtpërdrejt brenda variablës burimore.

Një variabël ekzekutimi e mbulon mjedisin gjatë kohës së ekzekutimit: një kërkesë që përdor {{token}} do të marrë token-in e vendosur nga skenari e jo atë të mjedisit.

Përdoreni për atë që është globale për ekzekutimin: një token, një identifikues korrelacioni, një numërues — në vend që të tërhiqni një lidhje përgjatë të gjithë grafit.

3. Parametrat dhe daljet

• Kutia Input / Param deklaron një ose disa parametra të emërtuar, secilin me tipin e vet. Ajo lëshon një objekt të vetëm { name: value, … }.

  Vlerat vijnë, sipas rendit: nga nisja (ndërfaqja ose MCP), nga rreshti i komandës (--param name=value), ose nga një kërkesë ndërvepruese nëse skenari e arrin kutinë pa pasur ndonjë vlerë të disponueshme.

• Kutia Output / Return ekspozon një rezultat të emërtuar te thirrësi. Një skenar i thirrur nga një veprim Ekzekuto skenarin i bën daljet e veta të dukshme mbi portën output:<name> të thirrësit.

Kjo është ajo që lejon përbërjen: një skenar «lidhu» që kthen një token, i ripërdorur nga të tjerët.

Mjediset

Një veprim kërkese ka një portë env: kabllëzimi aty i një mjedisi (vlerë e tipizuar environment, ose emër mjedisi) e ekzekuton thirrjen brenda atij mjedisi.

Kjo është mënyra për ta bërë të njëjtin skenar të punojë kundrejt staging dhe pastaj production pa dyfishuar asgjë — kalojeni mjedisin si parametër të skenarit.

Zgjidhja në modalitetin headless

Të gjitha vlerat e tipizuara zgjidhen në të njëjtën mënyrë brenda ndërfaqes dhe pa dritare: lista të personalizuara, numërime, parapamje mjedisi. Një skenar që funksionon brenda ndërfaqes funksionon edhe në CI.

Një emër mjedisi i dykuptimtë (dy mjedise homonime) shkakton një gabim të qartë: kalojeni atëherë identifikuesin.

Shndërrimi i parametrave në rreshtin e komandës

--param merr tekst; Restorm e shndërron atë sipas tipit të deklaruar të parametrit:

Tipi i deklaruar	Çfarë kaloni
Numerik	--param Seuil=42
Boolean	--param Actif=true (pranohen 1, yes, on)
Llogaritje date	Një datë, ose një vulë kohore epoch
Listë	JSON: --param Ids='[1,2,3]'
Numërim	Vlera, e validuar kundrejt bashkësisë së lejuar
Listë e personalizuar	Etiketa, e shndërruar në vlerë (Rouge → FF0000)
Mjedis	Një emër ose një identifikues mjedisi
Pjesa tjetër	Vargu i papërpunuar

Një shndërrim i pamundur e bën nisjen të dështojë me një mesazh të qartë, në vend që të ekzekutohet me një vlerë të gabuar.