Grundlagen des Debuggens

Debuggen eines Workflows auf der Arbeitsfläche: Starten Sie eine Debug-Ausführung, lesen Sie die Ergebnisse, finden Sie Fehler und testen Sie Teile eines Workflows mit Pseudo-Objekten.

Das Debuggen erfolgt auf der gleichen Arbeitsfläche, auf der ein Workflow erstellt wird. Es gibt keine separate Debug-Ansicht: Eine Debug-Ausführung wird von der Arbeitsfläche aus gestartet, der Bereich unter der Arbeitsfläche zeigt die Ergebnisse an und auf der Arbeitsfläche werden Änderungen vorgenommen, wenn ein Problem auftritt.

Starten einer Debug-Sitzung

Run Debug (▶) in the bottom toolbar of the canvas starts a debug run, in every tool. If the trigger has inputs, a dialog asks for their values. In Studio Web, Debug at the top left of the toolbar does the same. A panel appears below the canvas, and the execution trace fills in as each node runs.

Debuggen anhalten beendet die Ausführung explizit, und jede Änderung am Workflow beendet sie auch. Die Flow-Arbeitsfläche beschreibt die Debug-Steuerelemente und den Bereich unter der Arbeitsfläche vollständig.

Lesen der Ergebnisse

Die Registerkarte Ausführungen unter der Arbeitsfläche besteht aus drei Teilen, die jeweils eine andere Frage beantworten:

• Debug-Ausführungen: Die Liste der Ausführungen mit dem Namen, der Dauer und dem Alter jeder Ausführung.
• Ausführungsablaufverfolgung: Jeder Knoten, der ausgeführt wurde, in der richtigen Reihenfolge, mit Zeit und einem Erfolgs- oder Fehlerindikator. Wenn Sie einen Knoten in der Ablaufverfolgung auswählen, wird er auf der Arbeitsfläche hervorgehoben und wenn Sie mit der Maus auf einen Knoten zeigen, wird angezeigt, wann er gestartet und beendet wurde.
• Details: Für eine Ausführung die Registerkarten Variablen, Vorfälle und Metadaten . Für einen Knoten die Eingaben, die er erhalten hat, und die Ausgaben, die er erzeugt hat.

Auf der Registerkarte Vorfälle werden die Fehler der Ausführung aufgelistet, gruppiert nach Knoten. Jeder Vorfall benennt den fehlgeschlagenen Knoten und enthält die Fehlermeldung. Ein unerwarteter Stopp wird am besten zuerst dort überprüft.

Die Registerkarte Variablen zeigt Laufzeitvariablenwerte in drei Abschnitten an: Eingaben (Werte, die an den Workflow übergeben werden), Ausgaben (erzeugte Werte) und Variablen (interne Workflow-Variablen). Das Auswählen eines Knotens in der Ablaufverfolgung zeigt den Status zu diesem Zeitpunkt an. Ein Feld Variablen filtern sucht die Werte nach Namen.

Identifizieren von Fehlern

Nach einer Debug-Ausführung zeigt jeder Knoten auf der Arbeitsfläche einen Erfolgs- oder Fehlerindikator an. Der fehlgeschlagene Knoten wird auch in der Ausführungsablaufverfolgung markiert und die Registerkarte Vorfälle zeigt die Fehlermeldung an.

Das Fehlerobjekt enthält ein message -Feld (menschlich lesbare Beschreibung) und ein detail -Feld (technische Ursache). Das Feld message enthält die für den Benutzer zugängliche Fehlerzusammenfassung, also ist es der Ort, an dem Sie beginnen können.

Verwenden von Pseudo-Knoten

Ein statischer Mock testet einen Teil eines Workflows isoliert. Ein Knoten mit einem statischen Pseudo-Objekt wird nicht ausgeführt und übergibt die Pseudo-Daten danach an die Knoten. Dies ist nützlich, wenn ein früherer Knoten langsam ist, Anmeldeinformationen benötigt, die lokal nicht verfügbar sind, oder von externen Systemen abhängt. Die erweiterte Ansicht des Knotens, die durch Doppelklicken auf den Knoten geöffnet wird, verfügt über ein Modusmenü in der Spalte Ausgabe . Statisches Pseudo-Objekt ersetzt die echte Antwort durch Daten, die die Knoten danach erwarten, und Generiert lässt ein LLM die Antwort erzeugen. Ausgabe- Pseudo-Objekt beschreibt beides.

Wenn Sie mehrere Knoten gleichzeitig verwenden, kann sich die Debug-Ausführung auf einen bestimmten Abschnitt des Workflows konzentrieren.

Tipps

• Zuerst die Ausführungsablaufverfolgung, dann Vorfälle: Die Ablaufverfolgung zeigt die gesamte Ausführung und die Vorfälle zeigen nur, was fehlgeschlagen ist.
• Variablenwerte zeigen Datenkonflikte: Vergleichen Sie die von einem Knoten empfangenen Daten mit den vom nächsten Knoten erwarteten Daten.
• Das Nachahmen externer Abhängigkeiten ermöglicht eine schnellere Iteration: Wenn Sie einen Knoten nachahmen, der eine API aufruft oder einen RPA-Prozess auslöst, kann die Logik debuggt werden, ohne auf externe Systeme warten zu müssen.
• Kleine Iterationen sind schneller: Eine Korrektur pro Debug-Zyklus ist effizienter als der Versuch, alles in einem Durchlauf zu beheben.
• Beschreibenden Knotennamen verbessern die Lesbarkeit der Ablaufverfolgung: Die Ablaufverfolgungs- und Vorfallsreferenzknotennamen sowie die Namen, die beschreiben, was ein Knoten tut, erleichtern das Durchsuchen der Ablaufverfolgungen.

Nächste Schritte

• Die Flow-Arbeitsfläche: die Debug-Steuerelemente und der Bereich unter der Arbeitsfläche.
• Fehlerbehandlung: Konfigurieren von Fehlerverzweigungen auf Knoten.
• Variablen und Datenfluss: So funktionieren Variablen über Knoten hinweg.
• Community: Stellen Sie Fragen und teilen Sie Workflows mit anderen Buildern im UiPath Forum.