Der Rezept-Editor

Der Rezept-Editor ist die Arbeitsfläche im Recipes-Fenster: Legen Sie dort ein Rezept an oder öffnen Sie eines, und arbeiten Sie im Canvas-Tab. Jedes geöffnete Rezept erhält einen eigenen Tab; die Editor-Kopfzeile enthält die Graphbearbeitung, Konsole, Verlauf, Testlauf, Konfigurieren, Speichern und die Vollbildsteuerung. Auf der Arbeitsfläche stehen Zoom, Verschieben, eine Minikarte, Validierungsmeldungen und Knotenverbindungen zur Verfügung.

Die Screenshots zeigen die englische Oberfläche von Budgie Echo.

Aufbau der Arbeitsfläche

• Knoten sind Aktionen. Ziehen Sie sie, um den Graphen anzuordnen, wählen Sie sie zum Kopieren oder Löschen aus und doppelklicken Sie auf einen Knoten, um ihn zu bearbeiten.
• Kanten verbinden einen Ausgabeport der Quelle mit einem Eingabeport des Ziels. Nach einer abgeschlossenen Ausführung werden Kanten hervorgehoben, die Daten übertragen haben. Wählen Sie eine solche Kante, um den aufgezeichneten Wert zu prüfen.
• Konfigurieren bearbeitet Metadaten, Trigger, Sprachplätze und Verarbeitungsoptionen des Workflows.
• Speichern persistiert Aktionen, Positionen und Kanten des Graphen. Für Metadaten besitzt der Dialog „Konfigurieren“ eine eigene Speicherfunktion.
• Rückgängig, Wiederholen, Kopieren und Einfügen beziehen sich auf die aktuelle Auswahl der Arbeitsfläche. Der Editor warnt außerdem vor verwaisten oder unerreichbaren Knoten sowie unzulässigen Zyklen.

Knoten und Daten

Jeder Knoten akzeptiert den benannten Steuereingang main. Jeder gewöhnliche Knoten stellt einen Steuerausgang main bereit, auch Aktionen ohne Datenwert. Steuerports bestimmen, was als Nächstes ausgeführt wird; Datenausgaben bestimmen, welche Werte als Variablen referenziert werden können.

Eine Verbindung mit dem Port main eines Zielknotens wird als Kante gespeichert. Ist der primäre Wert des Ziels leer, fügt der Editor zusätzlich eine Referenz auf den Quellknoten ein, beispielsweise {{source_node_id}}. Zur Laufzeit wird ein Aktionsergebnis unter der stabilen Knoten-ID gespeichert. Der Ausgabename im E/A-Tab kann gleichzeitig einen verständlicheren Alias veröffentlichen.

Kontrollfluss

Kontrollflussknoten leiten über benannte Ausgänge weiter:

• If/Else: true oder false.
• Schleife: loop für den Schleifenkörper und done für die Fortsetzung.
• Switch: der erste passende Port case:<pattern>, andernfalls default.
• Try/Catch: try bei normaler Ausführung und catch, wenn ein Knoten im geschützten Bereich fehlschlägt.

Nur der von einem abgeschlossenen Knoten ausgelöste Port aktiviert seine verbundene Kante. Ein fehlgeschlagener Knoten löst keinen Ausgabeport aus. Gewöhnliche Zyklen werden abgewiesen; die unterstützte Ausnahme ist eine Rückkante aus dem Schleifenkörper in einen Schleifenknoten.

Einstiegspunkte

In einem expliziten Graphen ist ein Einstiegspunkt ein Knoten ohne eingehende Kante, die keine Schleifenrückkante ist. Einstiegsknoten werden zuerst eingeplant. Mehrere Einstiegsknoten sind zulässig; ihre Deklarationsreihenfolge sorgt für eine deterministische Rangfolge.

Ein isolierter Knoten in einem Graphen mit mehreren Knoten wird als verwaist gemeldet. Ein Knoten, der von keinem Einstiegspunkt aus erreicht werden kann, gilt als unerreichbar. Beheben Sie Validierungswarnungen, bevor Sie sich auf eine Ausführung verlassen.

Ein älterer Workflow ohne explizite Kanten bleibt eine lineare Kette und wird in der gespeicherten Reihenfolge seiner Aktionen ausgeführt.

Endzustände

Ein Endknoten besitzt für den ausgelösten Port keine ausgehende Kante. Sobald er erreicht wird, endet dieser Zweig. Ein Workflow ist abgeschlossen, nachdem der Scheduler den erreichbaren Graphen einschließlich übersprungener Zweige aufgelöst hat. Ein Fehler kann den Workflow beenden, dem konfigurierten Fehlerverhalten folgen oder einen verbundenen catch-Bereich betreten.

Die Workflow-Ausgabe auf Workflow-Ebene benennt die Variable, die als Endergebnis zurückgegeben wird. Ist sie nicht gesetzt, kann Echo auf eine Schrittausgabe oder den üblichen Wert processed_text zurückfallen. Weitere Einzelheiten finden Sie unter Ausgaben.

Benannte Ports

Portnamen gehören zum gespeicherten Vertrag des Graphen. main ist der Standardeingang und der gewöhnliche Ausgang. Namen des Kontrollflusses sind exakt. Switch behält das Fallmuster in case:<pattern> bei. Wenn Sie ein Switch-Muster umbenennen, ändert sich damit der Port, den seine Kante verwenden muss.

Steuerung und Daten sind getrennt: Eine Mitteilung kann über main fortfahren, ohne eine Variable zu veröffentlichen. Ein If/Else-Knoten kann unabhängig von der Wahl zwischen true und false ein Datenergebnis bereitstellen.

Aktionsauswahl

Wählen Sie + (Schritt hinzufügen), um die Aktionsauswahl zu öffnen. Aktionen sind nach Funktionsbereichen gruppiert, darunter Core, Dateisystem, Text, System, App-Steuerung, Netzwerk, Mathematik und Daten, Arrays, Persistenz, Benutzeroberfläche sowie Kontrollfluss.

Die erzeugte Aktionsreferenz ist die maßgebliche Quelle für Felder, Steuerports, Datenausgabe, Ausführungsstatus, Berechtigungsgrenze und Laufzeitbestätigung jeder Aktion.

Tabs „Konfiguration“ und „E/A“

Doppelklicken Sie auf einen Knoten, um seinen Editor zu öffnen:

• Konfiguration enthält die aktionsspezifischen Felder und einen optionalen benutzerdefinierten Namen. Verbundene vorgelagerte Knoten können als Einfügehilfen erscheinen.
• E/A wählt für unterstützte Aktionen die primäre Eingabe, benennt die Ausgabe datenliefernder Aktionen und listet die aktuell verfügbaren Variablen auf.

Die E/A-Liste gilt nur vorwärts: Sie enthält Workflow-Eingaben und Ausgaben früherer Aktionen in der gespeicherten Aktionsreihenfolge. Verwenden Sie bei komplexen Graphen explizite Kanten und stabile, aussagekräftige Ausgabenamen. Prüfen Sie anschließend den tatsächlichen Datenfluss unter Workflow-Ausführungen.