Fehler behandeln

Leiten Sie fehlgeschlagene Knoten an einen Fehlerpfad weiter, protokollieren Sie die Fehlerdetails, versuchen Sie es erneut mit temporären Fehlern und beenden Sie den Workflow bei nicht bearbeitbaren Fehlern sauber.

Was Sie erstellen

Ein Workflow, der einen fehlerhaften Knoten an einen separaten Pfad weiterleitet, den Fehler mit nützlichem Kontext protokolliert, temporäre Fehler wiederholt, wenn dies sinnvoll ist, und sauber beendet, wenn der Fehler nicht bearbeitbar ist. Das Ergebnis ist ein Muster, das in jeden bestehenden Workflow passt.

Bevor Sie beginnen

• Ein vorhandener Workflow mit mindestens einem Knoten, der fehlschlagen kann und eine Registerkarte Fehlerbehandlung hat, z. B. eine HTTP-Anforderung oder einen Extrahierungsknoten.

Verwendete Knoten

• HTTP-Anforderung: Der Knoten, der in diesem Beispiel fehlschlagen kann.
• Skript: Protokolliert die Fehlerdetails.
• Beenden: Beendet den Workflow bei nicht bearbeitbaren Fehlern.

Schritte

Tipp:

Wenn ein Codierungsagent eingerichtet ist, können Sie die manuellen Schritte überspringen. Fragen Sie:

Add error handling to the HTTP Request node in this Maestro Automate workflow: connect its error path to a Script node that logs the error message, retry temporary failures, and end the run with a Terminate node when the error can't be recovered.

Öffnen Sie dann den Workflow auf der Arbeitsfläche, vergleichen Sie ihn mit den folgenden Schritten und testen Sie ihn. Einrichten Ihres Codierungs-Agents beschreibt das Setup.

1. Verbinden Sie den Error-Handle des Knotens

Standardmäßig stoppt ein fehlgeschlagener Knoten den gesamten Workflow. Behandeln Sie stattdessen den Fehler:

1. Öffnen Sie den Workflow auf der Arbeitsfläche und wählen Sie den Knoten aus, der fehlschlagen kann.
2. Öffnen Sie die Registerkarte Fehlerbehandlung und aktivieren Sie die Option Fehlerbehandlung aktivieren. Ein Fehler- Handle wird unter dem Hauptausgabe-Handle angezeigt.
3. Wählen Sie + für das Fehler- Handle aus, suchen Sie nach Skript und wählen Sie es aus.

Dadurch wird ein Fehlerpfad erstellt. Wenn der Knoten fehlschlägt, folgt die Ausführung diesem Pfad, anstatt den Workflow anzuhalten. Ein Knoten ohne Fehler- Handle unterstützt keine Fehlerbehandlung, und ein Fehler dort stoppt den Workflow und wird auf der Registerkarte Vorfälle angezeigt.

2. Protokollieren Sie den Fehler

Lesen Sie im Script-Knoten auf dem Error-Pfad das Fehlerobjekt unter $vars.<node>.error:

const error = $vars.httpRequest1.error;
console.log('Step failed:', error.message);
console.log('Code:', error.code, '| HTTP status:', error.status);
return { logged: true };

Das Fehlerobjekt wird nur für den Fehlerpfad aufgefüllt. Auf der Seite Fehlerbehandlung wird der vollständige Satz von Fehlerfeldern aufgeführt.

3. Wiederholen Sie vorübergehende Fehler (optional)

Wenn der Fehler wahrscheinlich vorübergehend ist, z. B. eine Netzwerkunterbrechung oder eine Ratenbegrenzung, hilft es, vor dem Aufgeben erneut zu versuchen. Der HTTP-Anforderungsknoten verfügt über integrierte Wiederholungen: Wenn Sie die Anzahl der Wiederholungen auf der Registerkarte Erweitert festlegen, wird die Anforderung oft erneut versucht, bevor die Fehlerbehandlung ausgelöst wird. Nur der endgültige Fehler leitet zum Fehlerpfad weiter.

Warnung:

Wiederholen Sie nur Vorgänge, die sicher mehr als einmal ausgeführt werden können. Das Wiederholen eines Knotens mit Nebenwirkungen, wie dem Schreiben von Daten oder dem Senden einer Nachricht, kann Duplikate erstellen.

4. Beenden Sie den Flow, wenn der Fehler nicht behebbar ist

Fügen Sie auf dem Fehlerpfad nach dem Skriptknoten einen Terminate -Knoten hinzu. Um die Fehlerbeschreibung zurückzugeben, wählen Sie Ausgabevariable auf dem Knoten hinzufügen aus und geben Sie einen Wert an, der den Fehler enthält, z. B. $vars.httpRequest1.error.message.

Der Workflow endet am Knoten Beenden und die Ausführung wird in Ausführungen überwachen aufgeführt.

5. Testen und Debuggen

So lösen Sie den Error-Pfad absichtlich aus:

1. Legen Sie die URL im HTTP Request-Knoten vorübergehend auf einen ungültigen Wert fest (z. B. https://this-will-fail.example.com).
2. Select Run Debug (▶) in the bottom toolbar of the canvas and verify that the execution trace follows the error path.
3. Stellen Sie die korrekte URL wieder her.

Überprüfen Sie die Konsolenausgabe des Script-Knotens im Trace, um zu bestätigen, dass die Fehlerdetails protokolliert werden.

Ergebnis

Der Workflow leitet Fehler an den Fehlerpfad weiter, protokolliert die Fehlerdetails, wiederholt optional temporäre Fehler und endet sauber mit einem beschreibenden Fehlerstatus. Eine ungültige URL im HTTP-Anforderungsknoten bestätigt, dass der Fehlerpfad funktioniert.

Diesen Workflow erweitern

• Send an alert on failure: on the error path, before the Terminate node, add an HTTP Request or connector node to notify a Slack channel or create a ServiceNow incident.
• Fortfahren statt beenden: Wenn der Schritt nicht kritisch ist, legen Sie für den Fehlerpfad einen Fallback-Wert fest, und verbinden Sie den Hauptpfad erneut, anstatt zu beenden.
• Wenden Sie dieses Muster allgemein an: Auf der Seite Fehlerbehandlung werden weitere Muster beschrieben, z. B. „Protokollieren und Fortfahren“, „Fallback-Werte“ und „Eskalation“.

Nächste Schritte

• Bereitstellung eines Workflows: Lassen Sie den Workflow ohne Sie ausführen.
• Anleitungen: Weitere Workflows zum Erstellen.
• Community: Teilen Sie, was Sie erstellt haben, oder bitten Sie andere Builder um Hilfe.