Grundlagen des Debuggens

Debugging in Flow auf der Build-Arbeitsfläche, wobei Ausführungsspannen, Vorfälle, Fehlerprüfungen und Pseudo-Ausgaben für isolierte Testworkflows abgedeckt werden.

Das Debuggen in Flow erfolgt auf der gleichen Arbeitsfläche, auf der Sie erstellen. Es gibt keine separate Debug-Ansicht – Sie führen Ihren Prozess aus, überprüfen die Ergebnisse im Ausführungsbereich und nehmen Änderungen vor, wenn Sie ein Problem entdecken.

Starten einer Debug-Sitzung

Mit der Schaltfläche Debuggen in der Symbolleiste wird der Prozess ausgeführt. Der Ausführungsbereich wird am unteren Rand des Bildschirms angezeigt und wird in Echtzeit ausgefüllt, während jeder Knoten ausgeführt wird.

Die Schaltfläche Beenden beendet die Sitzung explizit. Bei jeder Änderung am Prozess wird auch die Debugging-Sitzung automatisch beendet.

Eine vollständige Übersicht über die Debug-Steuerelemente und das Layout des Ausführungsbereichs finden Sie auf der Arbeitsfläche .

Lesen des Ausführungsbereichs

Das Ausführungspanel verfügt über drei Registerkarten. Jeder beantwortet eine andere Frage.

Spannen

Die Registerkarte Spannen zeigt die Ausführungsablaufverfolgung an – jeden Knoten, der ausgeführt wurde, in der richtigen Reihenfolge mit Zeit und einem Erfolgs- oder Fehlerindikator. Wenn Sie eine Spanne auswählen, wird der entsprechende Knoten auf der Arbeitsfläche hervorgehoben, sodass Sie leicht genau erkennen können, wo die Ausführung erreicht wurde.

Vorfälle

Auf der Registerkarte Vorfälle werden während der Ausführung aufgetretene Fehler gesammelt. Jeder Vorfall benennt den fehlgeschlagenen Knoten und enthält die Fehlermeldung. Wenn Ihr Prozess unerwartet angehalten wurde, sehen Sie zuerst hier nach.

Variablen

Die Registerkarte Variablen zeigt runtime-Variablenwerte an. Wählen Sie eine Spanne auf der Registerkarte Spannen und die Registerkarte Variablen wird aktualisiert, um den Status zu diesem Zeitpunkt der Ausführung anzuzeigen. Damit können Sie überprüfen, ob vorgelagerte Knoten die erwarteten Daten erzeugt haben.

Identifizieren von Fehlern

Nach einer Debug-Ausführung zeigt jeder Knoten auf der Arbeitsfläche einen Erfolgs- oder Fehlerindikator an. Die Spanne des fehlgeschlagenen Knotens auf der Registerkarte „Span“ hebt ihn auf der Arbeitsfläche hervor. Auf der Registerkarte Vorfälle wird die Fehlermeldung angezeigt. Im Eigenschaftenbereich des fehlgeschlagenen Knotens wird das vollständige Fehlerobjekt im Ausgabeabschnitt angezeigt.

Das Fehlerobjekt enthält ein message -Feld (menschlich lesbare Beschreibung) und ein detail -Feld (technische Ursache). Beginnen Sie mit message , da es die Zusammenfassung der Benutzerfehler enthält.

Mithilfe von Pseudo-Knoten

Mit der Pseudo-Ausgabe können Sie einen Teil eines Prozesses isoliert testen. Wenn Sie eine Pseudo-Ausgabe auf einem Knoten festlegen, wird die eigentliche Ausführung übersprungen und Ihre Testdaten stattdessen nachgelagert eingefügt.

Dies ist nützlich, wenn ein Upstream-Knoten langsam ist, Anmeldeinformationen benötigt, die nicht lokal verfügbar sind, oder von externen Systemen abhängt. Wenn Sie auf den Knoten doppelklicken, wird die erweiterte Ansicht geöffnet, in der die Pseudo-Ausgabe auf die Daten festgelegt werden kann, die nachgelagerte Knoten erwarten.

Wenn Sie mehrere Knoten gleichzeitig verwenden, kann sich die Debugging-Sitzung auf einen bestimmten Abschnitt des Prozesses konzentrieren.

Tipps

• Spannen zuerst, Vorfälle dann. Spannen zeigen das vollständige Ausführungsbild an; Vorfälle zeigen nur, was funktioniert hat.
• Variablenwerte zeigen Datenkonflikte an. Vergleichen Sie die Daten, die ein Knoten erhalten hat, mit den Daten, die vom nächsten Knoten erwartet werden.
• Das Nachahmen externer Abhängigkeiten ermöglicht eine schnellere Iteration. Wenn Sie einen Knoten simulieren, der eine API aufruft oder einen RPA-Prozess auslöst, können Sie Ihre Logik debuggen, ohne auf externe Systeme zu warten.
• Kleine Iterationen sind schneller. Eine Korrektur pro Debugzyklus ist effizienter als der Versuch, alles in einem Durchlauf zu beheben.
• Beschreibenden Knotennamen verbessern die Lesbarkeit der Ablaufverfolgung. Spannen und Vorfälle verweisen auf Knotennamen – Namen, die beschreiben, was ein Knoten tut, erleichtern das Durchsuchen von Ausführungsablaufverfolgungen.

Zugehörige Seiten

• Die Arbeitsfläche – vollständige Debug-Steuerelemente und Ausführungsbereich
• Fehlerbehandlung – Konfigurieren von Fehlerverzweigungen auf Knoten
• Variablen und Datenfluss – wie Variablen über Knoten hinweg funktionieren