Grundlagen des Debuggens

Debuggen in Flow auf der Erstellungs-Arbeitsfläche, das Ausführungsspannen, Vorfälle, Fehlerinspektion und Pseudo-Ausgabe zum isolierten Testen von Workflows abdeckt.

Das Debuggen in Flow erfolgt auf derselben 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 erkennen.

Starten einer Debug-Sitzung

Die Schaltfläche Debug in der Symbolleiste führt den Prozess aus. Der Ausführungsbereich wird unten auf dem Bildschirm angezeigt und Spans werden in Echtzeit ausgefüllt, während jeder Knoten ausgeführt wird.

The Stop button ends the session explicitly. Any change to the process also exits the debug session automatically. Refer to The Canvas for a full overview of debug controls and the execution panel layout.

Lesen des Ausführungsbereichs

Der Ausführungsbereich hat drei Registerkarten. Jede beantwortet eine andere Frage.

Spannen

Die Registerkarte „Spans“ zeigt den Ausführungs-Trace an – jeden ausgeführten Knoten in der Reihenfolge mit Zeitangaben sowie einem Success- oder Fehlerindikator. Durch Auswahl eines Spans wird der entsprechende Knoten auf der Arbeitsfläche hervorgehoben, sodass Sie leicht sehen können, welchen Punkt die Ausführung erreicht hat.

Vorfälle

Auf der Registerkarte Vorfälle werden Fehler gesammelt, die während der Ausführung aufgetreten sind, gruppiert nach Knoten. Jede Gruppe wird standardmäßig erweitert, sodass die darin enthaltenen Fehler und Warnungen sofort sichtbar sind. 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 Laufzeitvariablenwerte an, die in drei Abschnitte unterteilt sind: Eingaben (Werte, die an den Workflow übergeben werden), Ausgaben (erzeugte Werte) und Variablen (interne Workflow-Variablen). 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.

Each section has its own title and a search field for filtering values by name, and each keeps its own collapse or expand state independently of the others. You can also toggle a section from the keyboard — press Enter or Space on a focused section header without affecting its parent section.

Identifizieren von Fehlern

Nach einer Debug-Ausführung zeigt jeder Knoten auf der Arbeitsfläche einen Success- oder Fehlerindikator an. Die Spanne des fehlgeschlagenen Knotens auf der Registerkarte „Spans“ hebt ihn auf der Arbeitsfläche hervor. Die Registerkarte Vorfälle zeigt die Fehlermeldung an. Der Eigenschaftenbereich des fehlgeschlagenen Knotens zeigt das vollständige Error-Object im Ausgabebereich an.

Das Error-Object enthält ein message Feld (von Menschen lesbare Beschreibung) und ein detail Feld (technische Ursache). Beginnen Sie mit message, weil darin Fehlerzusammenfassung für den Benutzer enthalten ist.

Verwenden von Pseudo-Knoten

Mit der Pseudo-Ausgabe können Sie einen Teil eines Prozesses isoliert testen. Wenn Sie die Pseudo-Ausgabe für einen Knoten festlegen, überspringt er die tatsächliche Ausführung und fügt stattdessen Ihre Testdaten nachgelagert ein.

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

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

Tipps

• Spans zuerst, Vorfälle danach. Spans zeigen das vollständige Ausführungsbild an; Vorfälle zeigen nur an, was fehlgeschlagen ist.
• Variablenwerte zeigen Datenabweichungen an. Vergleichen Sie die Daten, die ein Knoten erhalten hat, mit den Daten, die der nächste Knoten erwartete.
• 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 die Logik debuggen, ohne auf externe Systeme zu warten.
• Kleine Iterationen sind schneller. Eine Korrektur pro Debug-Zyklus ist effizienter als zu versuchen, alles in einem Durchlauf zu korrigieren.
• Beschreibende Knotennamen verbessern die Lesbarkeit der Traces. Spans und Vorfälle verweisen auf Knotennamen – Namen, die beschreiben, was ein Knoten tut, machen das Scannen von Ausführungsabläufen einfacher.

Zugehörige Seiten

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