Változók és adatok a forgatókönyvben
Egy forgatókönyv három mechanizmussal tudja az adatokat továbbítani. Ezek kiegészítik egymást, és sok fölösleges bekötést megtakarít annak ismerete, hogy melyiket kell választani.
1. Tokenek a társításokon
Section titled “1. Tokenek a társításokon”A fő mechanizmus: egy blokk előállít egy értéket, az érték végigmegy a társításon, útközben esetleg egy választó átformálja, majd megérkezik a következő blokk bemenetére.
Ez kifejezett és olvasható: az adatáramlás maga a rajz.
Mindarra érdemes használni, ami helyi — egy hívás eredménye, amelyet a következő hívás használ fel.
2. A futásváltozók
Section titled “2. A futásváltozók”Egy megnevezett tér, amely a futtatáshoz tartozik:
- a Változó beállítása ír egy értéket;
- a Változó lekérése visszaolvassa;
- a
variabletípusú érték menet közben olvassa ki, bármelyik mezőben; - a
{{name}}sablonban olvassa ki (Transform template, Map); - a
varsobjektum egy kódműveletben olvassa ki; - a Hozzáadás a listához és az Eltávolítás a listából közvetlenül a forrásváltozóba is írhat.
A futásváltozó a futtatás idejére elfedi a környezetet: a {{token}}
kifejezést használó kérés a forgatókönyv által beállított tokent kapja meg, nem
a környezetét.
Arra érdemes használni, ami a futtatás egészére globális: egy token, egy korrelációs azonosító, egy számláló — ahelyett, hogy társítást kellene húzni az egész gráfon keresztül.
3. Paraméterek és kimenetek
Section titled “3. Paraméterek és kimenetek”-
Az Input / Param blokk egy vagy több megnevezett paramétert deklarál, mindegyiket a saját típusával. Egyetlen objektumot ad ki:
{ name: value, … }.Az értékek a következő sorrendben érkeznek: az indításból (felület vagy MCP), a parancssorból (
--param name=value), vagy egy interaktív bekérésből, ha a forgatókönyv elérhető érték nélkül jut el a blokkig. -
Az Output / Return blokk egy megnevezett eredményt tesz elérhetővé a hívó számára. A Forgatókönyv futtatása művelettel meghívott forgatókönyv a kimeneteit a hívó
output:<name>portján teszi láthatóvá.
Ez teszi lehetővé az összeállítást: egy „bejelentkezés” forgatókönyv, amely visszaad egy tokent, a többi pedig újra felhasználja.
Környezetek
Section titled “Környezetek”A kérésműveleteknek van env portja: ha egy környezet kerül rá (environment
típusú érték vagy környezetnév), a hívás abban a környezetben fut le.
Így futtatható ugyanaz a forgatókönyv előbb a staging, majd a production
környezet ellen, bármi megkettőzése nélkül — a környezetet a forgatókönyv
paraméterként érdemes átadni.
Feloldás headless módban
Section titled “Feloldás headless módban”Minden típusos érték ugyanúgy oldódik fel a felületen és ablak nélkül: egyéni értéklisták, felsorolások, környezeti előnézetek. Ami a felületen működik, az CI-ben is működik.
A kétértelmű környezetnév (két azonos nevű környezet) kifejezett hibát okoz: ilyenkor az azonosítót kell átadni.
Paraméterek átalakítása a parancssorban
Section titled “Paraméterek átalakítása a parancssorban”A --param szöveget kap; a Restorm a paraméter deklarált típusa szerint
alakítja át:
| Deklarált típus | Mit kell átadni |
|---|---|
| Szám | --param Seuil=42 |
| Boolean | --param Actif=true (az 1, yes, on is elfogadott) |
| Dátumszámítás | Egy dátum vagy egy epoch időbélyeg |
| Lista | JSON: --param Ids='[1,2,3]' |
| Felsorolás | Az érték, az engedélyezett halmazzal szemben ellenőrizve |
| Egyéni értéklista | A felirat, amely értékké alakul (Rouge → FF0000) |
| Környezet | Egy környezet neve vagy azonosítója |
| A többi | A nyers karakterlánc |
A lehetetlen átalakítás megbuktatja az indítást egy világos üzenettel, ahelyett hogy hibás értékkel futna le.