Entwerfen eines Maestro Flow

Entwerfen Sie einen Maestro-Flow in Studio Web mithilfe der Flow-Arbeitsfläche, einschließlich wie Sie Trigger und Knoten hinzufügen und verbinden, Eigenschaften konfigurieren, Variablen verwalten, Fehler behandeln und Ihren Prozess debuggen.

Hinweis:

Maestro Flow befindet sich in der Vorschau.

Die Arbeitsfläche von Maestro Flow ist ein visueller Designer, mit dem Sie Automatisierungen erstellen können, indem Sie Knoten platzieren und diese nacheinander verbinden.

Die Arbeitsfläche „Maestro Flow“

Die Arbeitsfläche zeigt Ihren Flow als Diagramm von Knoten, die durch Kanten verbunden sind. Die Ausführung beginnt am Triggerknoten und durchläuft jeden verbundenen Knoten der Reihenfolge nach.

Um einen Knoten hinzuzufügen, wählen Sie den Ziehpunkt + an der ausgehenden Kante eines vorhandenen Knotens, um den Bereich Knoten hinzufügen zu öffnen. Um zwei Knoten manuell zu verbinden, ziehen Sie sie vom Ausgabe-Ziehpunkt eines Knotens zum Eingabepunkt eines anderen. Sie können jeden Knoten umbenennen, indem Sie seine Beschriftung auf der Arbeitsfläche von Maestro Flow öffnen.

Die obere Symbolleiste bietet:

• In der Cloud debuggen – Führt den Flow durchgängig in der Cloud aus.
• Schrittweise debuggen – durchläuft den Flow einen Knoten nach dem anderen.
• Veröffentlichen – Pakete und veröffentlicht den Flow in Orchestrator.

Hinzufügen von Triggern

Der Flow beginnt mit einem standardmäßigen Manual Trigger- Knoten, der den Flow bei Bedarf startet. Wählen Sie den Trigger auf der Arbeitsfläche aus, um ihn im Eigenschaftenbereich zu konfigurieren.

Trigger-Eigenschaften

• ID – Der Bezeichner des Triggers, der verwendet wird, um auf seine Ausgaben in Ausdrücken zu verweisen (z. B. $vars.manualTrigger1.output.userId).
• Beschriftung – der Anzeigename des Triggers auf der Arbeitsfläche.
• Variablen – Eingabevariablen, die dem Trigger gehören. Wenn der Trigger ausgelöst wird, sind seine Eingaben nachgelagert als $vars.<triggerId>.output.<inputName> verfügbar.

Hinzufügen von Knoten

Um einen Knoten hinzuzufügen, wählen Sie den Ziehpunkt + an der ausgehenden Kante eines beliebigen Knotens, um den Bereich Knoten hinzufügen zu öffnen. Wählen Sie dann eine Kategorie und den Knotentyp aus. Die vollständige Liste der verfügbaren Knotentypen finden Sie unter Über Maestro Flow.

Knoteneigenschaften

Wenn Sie einen Knoten auswählen, wird dessen Konfiguration im Eigenschaftenbereich auf der rechten Seite geöffnet, der in Abschnitte unterteilt ist:

• Allgemein – Die ID des Knotens (wird in $vars -Ausdrücken verwendet), Beschriftung (Anzeigename auf der Arbeitsfläche), Beschreibung und Symbolfarbe.
• Fehlerbehandlung – Schalten Sie die Option Fehlerbehandlung um, um dem Knoten einen Fehlerausgabehandle hinzuzufügen. Wenn diese Option aktiviert ist und der Knoten fehlschlägt, wird die Ausführung an den Fehlerpfad weitergeleitet, anstatt den Fluss anzuhalten.
• Variable aktualisieren – Weisen Sie einer Prozessvariablen einen Wert zu, wenn der Knoten abgeschlossen ist. Wählen Sie + Variablenaktualisierung hinzufügen, die Zielvariable und geben Sie den zuzuweisenden Ausdruck ein.

Auf der Registerkarte Variablen (neben den Eigenschaften) definieren Sie Variablen auf Prozessebene. Jede Variable hat einen Namen, einen Typ (String, Zahl, Boolescher Wert, Objekt oder Array) und eine Richtung (Eingabe, Ausgabe oder bidirektional).

Das Öffnen des Kontextmenüs für einen Knoten auf der Arbeitsfläche öffnet ein Kontextmenü mit: Haltepunkt hinzufügen, Probe hinzufügen, Kopieren, Ausschneiden, Einfügen und Löschen.

Variablen und Datenfluss

Knoten geben Daten nicht automatisch frei. Downstream-Knoten greifen über Ausdrücke mit dem Präfix $vars auf die Ausgabe eines Knotens zu.

Jeder Knoten, der Daten erzeugt, stellt seine Ausgabe als $vars.<nodeId>.output zur Verfügung. Die Knoten-ID wird basierend auf dem Knotentyp automatisch zugewiesen – z. B. ist der erste API-Workflow-Knoten apiWorkflow1. Sie können die ID eines Knotens im Abschnitt Allgemein des Eigenschaftenbereichs sehen und bearbeiten.

// Access the output of a node named apiWorkflow1
$vars.apiWorkflow1.output

// Access the response body of an HTTP request node
$vars.httpRequest1.output.body

Verwenden Sie die Registerkarte Variablen , um Variablen zu definieren, die im gesamten Prozess zugänglich sein müssen oder die die Prozesseingaben und -ausgaben definieren. Auf Variablen wird als $vars.<variableName> verwiesen.

Die vollständige Syntax für Ausdrücke und die Scoping-Regeln finden Sie unter Variablen und Datenfluss in der Maestro-Dokumentation.

Fehlerbearbeitung

Standardmäßig stoppt ein fehlgeschlagener Knoten den gesamten Flow. Um Fehler auf einem bestimmten Knoten zu behandeln, schalten Sie die Fehlerbehandlung aktivieren im Eigenschaftenbereich des Knotens um. Dadurch wird unten rechts neben dem Knoten auf der Arbeitsfläche ein Fehlerausgabehandle hinzugefügt. Verbinden Sie das Fehler-Handle mit einem nachgelagerten Knoten, um Fehler an einen separaten Pfad weiterzuleiten.

Wenn ein Knoten fehlschlägt und sein Fehler-Handle verbunden ist, sind die Fehlerdetails als $vars.<nodeId>.error auf dem Fehlerpfad verfügbar, mit Feldern wie message, code, status und detail.

Muster wie log-and-Continue, wiederholen und Alert-and-Terminate finden Sie unter Fehlerbehandlung in der Maestro-Dokumentation.

Debuggen eines Maestro Flow

Wählen Sie in der oberen Symbolleiste die Option In der Cloud debuggen, um den Flow von Anfang bis Ende auszuführen. Wählen Sie nach Abschluss der Ausführung einen beliebigen Knoten auf der Arbeitsfläche, um seine Ausgabe zu überprüfen. Erfolgreiche Knoten zeigen einen grünen Indikator an; Fehlgeschlagene Knoten zeigen die Fehlerdetails an, wenn sie ausgewählt sind.

Wählen Sie Schrittweise debuggen, um den Flow einen Knoten nach dem anderen zu durchlaufen.

Öffnen Sie das Kontextmenü für einen beliebigen Knoten und wählen Sie Haltepunkt hinzufügen , um die Ausführung auf diesem Knoten während einer Debug-Ausführung anzuhalten. Wählen Sie Test hinzufügen , um die Ausgabe des Knotens ohne Anhalten zu erfassen.

Zugehörige Links

• Variablen und Datenfluss
• Fehlerbearbeitung
• Unterflüsse
• Kontrollfluss
• Veröffentlichen und Bereitstellen eines Flows