Fehler behandeln

Leiten Sie fehlgeschlagene Knoten an Error-Handler weiter, protokollieren Sie Fehlerdetails, wiederholen Sie vorübergehende Fehler und beenden Sie nicht behebbare Fehler ordnungsgemäß.

Was Sie erstellen Einen Workflow, der einen fehlschlagenden Knoten an einen separaten Pfad weiterleitet, den Fehler mit nützlichem Kontext protokolliert, bei vorübergehenden Fehlern einen erneuten Versuch unternimmt, wo dies sinnvoll ist, und den Workflow sauber beendet, wenn der Fehler nicht behebbar ist. Nach dieser Anleitung verfügen Sie über ein Muster, das Sie in jeden vorhandenen Workflow übernehmen können.

Was Sie benötigen

• Ein UiPath Automation Cloud-Konto mit Zugriff auf Maestro Flow.
• Einen vorhandenen Flow mit mindestens einem Knoten, der fehlschlagen kann und einen Fehler-Handle bereitstellt – z. B. einen HTTP Request- oder Extract-Knoten.

Verwendete Knoten

• HTTP Request – der fehleranfällige Knoten in diesem Beispiel
• Script  – protokolliert die Fehlerdetails
• Beenden – beendet den Workflow mit einem Status bei nicht behebbaren FehlernFailed

Schritte

1. Verbinden Sie den Error-Handle des Knotens

Standardmäßig stoppt ein fehlgeschlagener Knoten den gesamten Prozess. So behandeln Sie den Fehler:

1. Öffnen Sie Ihren Workflow auf der Arbeitsfläche und wählen Sie den fehleranfälligen Knoten aus.
2. Ziehen Sie vom Error-Handle des Knotens – dem Connector unten rechts am Knoten – zu einem neuen Script-Knoten.

Dadurch wird ein Error-Pfad erstellt. Wenn der Knoten fehlschlägt, wird die Ausführung entlang dieses Pfads weitergeleitet, anstatt den Prozess anzuhalten. (Knoten, die keinen Error-Handle bereitstellen, unterstützen keine Fehlerbehandlung – ein Fehler hält den Prozess an 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 im Error-Pfad ausgefüllt. Eine vollständige Referenz der Felder finden Sie unter Fehlerbehandlung.

3. Wiederholen Sie vorübergehende Fehler (optional)

Wenn der Fehler wahrscheinlich vorübergehend ist – z. B. aufgrund einer kurzzeitigen Netzwerkstörung oder eines Rate Limits –, versuchen Sie es erneut, bevor Sie aufgeben. Der HTTP Request-Knoten verfügt über integrierte Wiederholungsversuche: Konfigurieren Sie die Anzahl der Wiederholungsversuche in seinen Eigenschaften. Die Anforderung wird entsprechend oft erneut ausgeführt, bevor der Error-Handle ausgelöst wird. Nur der endgültige Fehler wird an den Error-Pfad weitergeleitet.

Warnung:

Wiederholen Sie nur idempotente Vorgänge. Das erneute Ausführen eines Knotens mit Nebenwirkungen (Schreiben von Daten, Senden einer Nachricht) kann zu Duplikaten führen.

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

Fügen Sie im Error-Pfad nach dem Script-Knoten einen Terminate-Knoten hinzu. Festlegen:

• Status → Failed
• Nachricht → eine Beschreibung, die den Error enthält, z. B. $vars.httpRequest1.error.message

Dies zeichnet den Fehler mit einer aussagekräftigen Beschreibung im Ausführungsverlauf auf, die unter „Ausführungen beobachten“ sichtbar ist.

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. Führen Sie den Test aus und überprüfen Sie im Ausführungs-Trace, dass die Ausführung entlang des Error-Pfads weitergeleitet wird.
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

Ihr Workflow leitet Fehler an den Error-Pfad weiter, protokolliert die Fehlerdetails, führt bei vorübergehenden Fehlern optional Wiederholungsversuche durch und wird mit einem aussagekräftigen Fehlerstatus sauber beendet. Sie können überprüfen, ob der Error-Pfad funktioniert, indem Sie im HTTP Request-Knoten eine ungültige URL verwenden und die Konsolenausgabe des Script-Knotens im Ausführungs-Trace überprüfen.

Diesen Workflow erweitern

• Eine Warnung bei einem Fehler senden – Fügen Sie im Error-Pfad vor dem Terminate-Knoten einen HTTP Request- oder Integrationsknoten hinzu, um einen Slack-Kanal zu benachrichtigen oder ein Vorfall-Ticket zu erstellen.
• Fortfahren statt beenden – Wenn der Schritt nicht kritisch ist, legen Sie im Error-Pfad einen Fallback-Wert fest und verbinden Sie ihn wieder mit dem Hauptpfad, statt den Flow zu beenden.
• Wenden Sie dieses Muster überall an – weitere Muster (protokollieren und fortfahren, Fallback-Werte, Eskalation) finden Sie in der Referenz zur Fehlerbehandlung.