Behandeln Sie Fehler

Leiten Sie fehlgeschlagene Knoten an Fehler-Handler weiter, protokollieren Sie Fehlerdetails, versuchen Sie es erneut mit vorübergehenden Fehlern und beenden Sie nicht bearbeitbare Fehler ordnungsgemäß.

Was Sie erstellen: Ein Workflow, der einen fehlgeschlagenen Knoten an einen separaten Pfad weiterleitet, den Fehler mit nützlichem Kontext protokolliert, vorübergehende Fehler wiederholt, wenn dies sinnvoll ist, und sauber beendet, wenn der Fehler nicht bearbeitbar ist. Nach dieser Anleitung haben Sie ein Muster, das Sie in jeden vorhandenen Workflow ablegen können.

Was Sie benötigen

• Ein UiPath Automation Cloud-Konto mit Zugriff auf Maestro Flow.
• Ein vorhandener Flow-Workflow mit mindestens einem Knoten, der fehlschlagen kann und ein Fehler-Handle verfügbar macht – z. B. ein HTTP-Anforderungs- oder Extraktionsknoten.

Verwendete Knoten

• HTTP-Anforderung – der fehleranfällige Knoten in diesem Beispiel
• Skript – protokolliert die Fehlerdetails
• Beenden – Beendet den Workflow mit einem Failed -Status bei nicht bearbeitbaren Fehlern

Schritte

1. Verbinden Sie das Fehler-Handle des Knotens

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

1. Öffnen Sie Ihren Workflow auf der Arbeitsfläche und wählen Sie den fehleranfälligen Knoten.
2. Ziehen Sie von dessen Fehlerhandle – dem Connector unten rechts neben dem Knoten – auf einen neuen Skriptknoten .

Dadurch wird ein Fehlerpfad erstellt. Wenn der Knoten fehlschlägt, wird die Ausführung entlang dieses Pfads weitergeleitet, anstatt den Prozess anzuhalten. (Knoten, die kein Fehler-Handle verfügbar machen, unterstützen keine Fehlerbehandlung – ein Fehler stoppt dort den Prozess und erscheint auf der Registerkarte Vorfälle .)

2. Protokollieren Sie den Fehler

Lesen Sie im Skriptknoten auf dem Fehlerpfad 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. Die vollständige Feldreferenz finden Sie unter Fehlerbehandlung.

3. Vorübergehende Fehler wiederholen (optional)

Wenn der Fehler wahrscheinlich vorübergehend ist – ein Netzwerkfehler oder ein Ratenlimit – versuchen Sie es erneut, bevor Sie aufgeben. Der HTTP-Anforderungsknoten verfügt über integrierte Wiederholungen: Konfigurieren Sie die Wiederholungsanzahl in seinen Eigenschaften und versucht die Anforderung mehrmals erneut, bevor die Fehlerbehandlung ausgelöst wird. Nur der endgültige Fehler leitet zum Fehlerpfad weiter.

Warnung:

Nur idempotente Vorgänge wiederholen. Das Wiederholen eines Knotens mit Nebenwirkungen (Schreiben von Daten, Senden einer Nachricht) kann Duplikate erstellen.

4. Beenden, wenn nicht wiederherstellbar

Fügen Sie auf dem Fehlerpfad nach dem Skriptknoten einen Terminate -Knoten hinzu. Festlegen:

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

Dadurch wird der Fehler im Ausführungsverlauf mit einer nützlichen Beschreibung aufgezeichnet, die in Beobachtungsausführungen sichtbar ist.

5. Testen und debuggen

Um den Fehlerpfad absichtlich auszulösen:

1. Legen Sie die URL im HTTP-Anforderungsknoten 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 die Routen der Ausführungsablaufverfolgung innerhalb des Fehlerpfads.
3. Stellen Sie die richtige URL wieder her.

Überprüfen Sie die Konsolenausgabe des Skriptknotens in der Ablaufverfolgung, um zu bestätigen, dass die Fehlerdetails protokolliert werden.

Ergebnis

Ihr Workflow leitet Fehler an den Fehlerpfad weiter, protokolliert die Fehlerdetails, wiederholt optional vorübergehende Fehler und endet sauber mit einem beschreibenden Fehlerstatus. Sie können bestätigen, dass der Fehlerpfad funktioniert, indem Sie eine ungültige URL im HTTP-Anforderungsknoten verwenden und die Konsolenausgabe des Skriptknotens in der Ausführungsablaufverfolgung überprüfen.

Erweitern Sie diesen Workflow

• Warnung bei Fehler senden – Fügen Sie auf dem Fehlerpfad vor dem Knoten Termine eine HTTP-Anforderung oder einen Integrationsknoten hinzu, um einen Slack-Kanal zu benachrichtigen oder ein Vorfallticket zu erstellen.
• Fortfahren statt beenden – Wenn der Schritt nicht kritisch ist, lassen Sie für den Fehlerpfad einen Fallback-Wert festlegen und verbinden Sie den Hauptpfad erneut, anstatt zu beenden.
• Dieses Muster überall anwenden – Weitere Muster (Protokollieren und Fortfahren, Fallback-Werte, Eskalation) finden Sie in der Referenz zur Fehlerbehandlung .