Variablen und Daten in einem Szenario

Ein Szenario verfügt über drei Mechanismen, um Daten fließen zu lassen. Sie ergänzen sich, und zu wissen, welchen man wählt, erspart viel unnötige Verdrahtung.

1. Die Tokens auf den Verbindungen

Der Hauptmechanismus: Ein Baustein erzeugt einen Wert, dieser reist über die Verbindung, gegebenenfalls umgeformt durch einen Selektor, und kommt am Eingang des nächsten Bausteins an.

Das ist explizit und lesbar: Der Datenfluss ist die Zeichnung.

Verwenden Sie ihn für alles Lokale — das Ergebnis eines Aufrufs, das vom nächsten Aufruf konsumiert wird.

2. Die Run-Variablen

Ein benannter, der Ausführung eigener Raum:

• Variable setzen schreibt einen Wert;
• Variable lesen liest ihn wieder;
• ein typisierter Wert variable liest ihn spontan, in beliebigen Feldern;
• {{name}} liest ihn in einer Vorlage (Transform template, Map);
• das Objekt vars liest ihn in einer Code-Aktion;
• Zur Liste hinzufügen und Aus Liste entfernen können direkt in die Quellvariable schreiben.

Eine Run-Variable überlagert die Umgebung für die Dauer der Ausführung: Eine Anfrage, die {{token}} verwendet, nimmt das vom Szenario gesetzte Token statt des Tokens der Umgebung.

Verwenden Sie sie für das, was für die gesamte Ausführung global ist: ein Token, eine Korrelations-ID, ein Zähler — statt eine Verbindung durch den gesamten Graphen zu ziehen.

3. Parameter und Ausgänge

• Der Baustein Input / Param deklariert einen oder mehrere benannte Parameter, jeweils mit seinem Typ. Er gibt ein einziges Objekt { name: value, … } aus.

  Die Werte stammen, in dieser Reihenfolge: aus dem Start (Oberfläche oder MCP), aus der Kommandozeile (--param name=value) oder aus einer interaktiven Abfrage, falls das Szenario den Baustein ohne verfügbaren Wert erreicht.

• Der Baustein Output / Return stellt dem Aufrufer ein benanntes Ergebnis bereit. Ein von einer Aktion Szenario ausführen aufgerufenes Szenario macht seine Ausgänge am Port output:<name> des Aufrufers sichtbar.

Das ist es, was das Komponieren ermöglicht: ein Szenario „Verbinden“, das ein Token zurückgibt, das von anderen wiederverwendet wird.

Umgebungen

Eine Anfrage-Aktion besitzt einen Port env: Eine Umgebung damit zu verdrahten (typisierter Wert environment, oder Umgebungsname) führt den Aufruf in dieser Umgebung aus.

Das ist der Weg, um dasselbe Szenario gegen staging und dann production laufen zu lassen, ohne irgendetwas zu duplizieren — geben Sie die Umgebung als Szenarioparameter weiter.

Auflösung im Headless-Modus

Alle typisierten Werte werden auf dieselbe Weise in der Oberfläche und ohne Fenster aufgelöst: benutzerdefinierte Listen, Aufzählungen, Umgebungsvorschauen. Ein Szenario, das in der Oberfläche funktioniert, funktioniert auch in der CI.

Ein mehrdeutiger Umgebungsname (zwei gleichnamige Umgebungen) löst einen expliziten Fehler aus: Geben Sie dann den Identifikator an.

Konvertierung von Kommandozeilenparametern

--param erhält Text; Restorm konvertiert ihn gemäß dem deklarierten Typ des Parameters:

Deklarierter Typ	Was Sie übergeben
Numerisch	--param Seuil=42
Boolean	--param Actif=true (1, yes, on werden akzeptiert)
Datumsberechnung	Ein Datum, oder ein Epoch-Zeitstempel
Liste	JSON: --param Ids='[1,2,3]'
Enumeration	Der Wert, gegen die zulässige Menge validiert
Benutzerdefinierte Liste	Die Bezeichnung, in einen Wert umgewandelt (Rouge → FF0000)
Umgebung	Ein Name oder ein Umgebungs-Identifikator
Alles andere	Die rohe Zeichenkette

Eine unmögliche Konvertierung lässt den Start fehlschlagen, mit einer klaren Meldung, statt mit einem falschen Wert auszuführen.