Muuttujat ja data skenaariossa

Skenaariossa on kolme mekanismia datan siirtämiseen. Ne täydentävät toisiaan, ja oikean valitseminen säästää paljon turhaa kytkentää.

1. Kytkennöillä kulkevat arvot

Päämekanismi: lohko tuottaa arvon, se kulkee kytkentää pitkin, mahdollisesti valitsimen muotoilemana, ja saapuu seuraavan lohkon tuloon.

Tämä on selkeää ja luettavaa: datan virta on piirros.

Käytä sitä kaikkeen paikalliseen — kutsun tulokseen, jonka seuraava kutsu kuluttaa.

2. Suoritusmuuttujat

Nimetty tila, joka on suorituskohtainen:

• Aseta muuttuja kirjoittaa arvon;
• Hae muuttuja lukee sen takaisin;
• variable-tyyppinen arvo lukee sen lennossa missä tahansa kentässä;
• {{nom}} lukee sen mallipohjassa (Transform template, Map);
• vars-objekti lukee sen kooditoiminnossa;
• Lisää luetteloon ja Poista luettelosta voivat kirjoittaa suoraan lähdemuuttujaan.

Suoritusmuuttuja peittää ympäristön suorituksen ajaksi: pyyntö, joka käyttää muuttujaa {{token}}, ottaa skenaarion asettaman tokenin ympäristön tokenin sijaan.

Käytä sitä siihen, mikä on koko suorituksen laajuista: tokeniin, korrelaatiotunnisteeseen tai laskuriin — sen sijaan että vetäisit kytkennän koko graafin läpi.

3. Parametrit ja tulosteet

• Lohko Input / Param määrittelee yhden tai useamman nimetyn parametrin, kunkin omine tyyppeineen. Se lähettää yhden ainoan objektin { nom: valeur, … }.

  Arvot tulevat järjestyksessä: käynnistyksestä (käyttöliittymä tai MCP), komentoriviltä (--param nom=valeur) tai vuorovaikutteisesta kyselystä, jos skenaario saapuu lohkolle ilman käytettävissä olevaa arvoa.

• Lohko Output / Return tuo nimetyn tuloksen kutsujan saataville. Skenaario, jota kutsutaan toiminnolla Suorita skenaario, tuo tulosteensa näkyviin kutsujan portissa output:<nom>.

Juuri tämä mahdollistaa koostamisen: ”kirjaudu sisään” -skenaario, joka palauttaa tokenin, jota muut käyttävät uudelleen.

Ympäristöt

Pyyntötoiminnolla on portti env: siihen kytketty ympäristö (environment-tyyppinen arvo tai ympäristön nimi) suorittaa kutsun kyseisessä ympäristössä.

Näin sama skenaario voidaan ajaa ensin ympäristöä staging ja sitten ympäristöä production vastaan kahdentamatta yhtään mitään — anna ympäristö skenaarion parametrina.

Ratkaisu headless-tilassa

Kaikki tyypitetyt arvot ratkaistaan samalla tavalla käyttöliittymässä ja ilman ikkunaa: mukautetut luettelot, luettelotyypit ja ympäristön esikatselut. Skenaario, joka toimii käyttöliittymässä, toimii CI:ssä.

Moniselitteinen ympäristön nimi (kaksi samannimistä ympäristöä) aiheuttaa selkeän virheen: anna tällöin tunniste.

Komentoriviparametrien muunnos

--param vastaanottaa tekstiä; Restorm muuntaa sen parametrin ilmoitetun tyypin mukaan:

Ilmoitettu tyyppi	Mitä annat
Numeerinen	--param Seuil=42
Boolean	--param Actif=true (1, yes, on hyväksytään)
Date math	Päivämäärä tai epoch-aikaleima
Luettelo	JSON-muodossa: --param Ids='[1,2,3]'
Luettelotyyppi	Arvo, joka validoidaan sallittua joukkoa vastaan
Mukautettu arvoluettelo	Nimike, joka muunnetaan arvoksi (Rouge → FF0000)
Ympäristö	Ympäristön nimi tai tunniste
Muut	Raaka merkkijono

Mahdoton muunnos kaataa käynnistyksen selkeällä viestillä sen sijaan, että suoritus tapahtuisi väärällä arvolla.