studio
2024.10
true
UiPath logo, featuring letters U and I in white
Studio-Benutzerhandbuch
Last updated 4. Dez. 2024

Debugging-Aktionen

Das Debugging einer einzelnen Datei oder des gesamten Projekts kann sowohl auf der Menüband-Registerkarte Design oder Debuggen durchgeführt werden. Der Debugging-Prozess ist jedoch nicht verfügbar, wenn Projektdateien Validierungsfehler aufweisen.



Gehen in (Step Into)

Verwenden Sie Einzelschritt, um Aktivitäten einzeln zu debuggen. Wenn diese Aktion ausgelöst wird, wird der Debugger geöffnet und hebt die Aktivität hervor, bevor sie ausgeführt wird.

Wenn Einzelschritt mit Aktivitäten zum Abrufen einer Workflow-Datei verwendet wird, wird der Workflow auf einer neuen Registerkarte im ReadOnly-Modus geöffnet und jede Aktivität wird nacheinander ausgeführt.

Der Tastaturkurzbefehl für Einzelschritt ist F11.

Übergehen (Step Over)

Im Gegensatz zur Aktion Einzelschritt öffnet Prozedurschritt nicht den aktuellen Container. Wenn die Aktion verwendet wird, debuggt sie die nächste Aktivität und hebt Container hervor (wie Flowcharts, Sequences oder Invoke Workflow File-Aktivitäten), ohne diese zu öffnen.

Diese Aktion ist praktisch zum Überspringen der Analyse großer Container, die beim Ausführen wahrscheinlich keine Probleme auslösen werden.

Prozedurschritt kann über die Tastenkombination F10 aufgerufen werden.

Rückschritt

Mit dieser Aktion wird der Schritt bis zur nächsten Anweisung durchgeführt, dann wird die Ausführung auf der Ebene des aktuellen Containers angehalten. Rückschritt schließt die Ausführung von Aktivitäten im aktuellen Container ab, bevor das Debugging angehalten wird. Diese Option funktioniert gut mit verschachtelten Sequences.

Rückschritt kann über die Tastenkombination Umschalt+F11 aufgerufen werden.

Wiederholen

Wiederholen führt die vorherige Aktivität erneut aus und gibt die Ausnahme aus, wenn sie erneut auftritt. Die Aktivität, die die Ausnahme ausgelöst hat, wird hervorgehoben und Details über den Fehler werden in den Panels Lokal und Aufrufliste angezeigt.

Ignorieren

Die Aktion Ignore kann verwendet werden, um eine aufgetretene Ausnahme zu ignorieren und die Ausführung ab der nächsten Aktivität fortzusetzen, sodass der Rest des Workflows gedebuggt werden kann.

Diese Aktion ist nützlich, wenn man die Aktivität, die die Ausnahme ausgelöst hat, überspringt und den verbleibenden Teil des Projekts weiter debuggt.

Neu starten

Neu starten ist verfügbar, nachdem eine Ausnahme ausgelöst wurde und der Debug-Prozess angehalten wurde. Die Aktion dient dazu, den Debugging-Prozess ab der ersten Aktivität des Projekts neu zu starten. Verwenden Sie Langsamer Schritt, um die Debugging-Geschwindigkeit zu verringern und Aktivitäten während der Ausführung ordnungsgemäß zu überprüfen.

Bitte beachten Sie, dass bei dieser Option nach Verwendung der Aktion Ab dieser Aktivität ausführen das Debugging ab der zuvor angegebenen Aktivität neu gestartet wird.

Unterbrechung (Break)

Mit Unterbrechung können Sie den Debugging-Prozess jederzeit anhalten. Die Aktivität, für die das Debuggen durchgeführt wird, bleibt im angehaltenen Zustand hervorgehoben. Sobald dies geschehen ist, können Sie Fortfahren, Einzelschritt, Prozedurschritt oder Beenden für den Debugging-Prozess wählen.

Wir empfehlen die Verwendung von Unterbrechung zusammen mit Langsamer Schritt, damit Sie genau wissen, wann das Debugging angehalten werden muss.

In dieser Situation kann als Alternative zu Langsamer Schritt (Slow Step) das Panel Ausgabe (Output) überwacht und für die Aktivität, für welche gerade die Fehlersuche durchgeführt wird, Haltepunkt (Break) verwendet werden.

Fokussieren (Focus)

Mit Ausführungspunkt fokussieren (Focus Execution Point) können Sie zum aktuellen Haltepunkt oder zu der Aktivität zurückkehren, die bei der Fehlersuchen einen Fehler verursacht hat. Die Schaltfläche Fokussieren (Focus) bietet eine einfachere Möglichkeit, nach dem Navigieren durch den Prozess zu der Aktivität zurückzukehren, die den Fehler verursacht hat, und die Fehlersuche fortzusetzen.

Alternativ können Sie bei einer Unterbrechung der Fehlersuche wegen eines erreichten Haltepunkts mit Fokussieren (Focus) nach dem Navigieren durch die im Automationsprozess enthaltenen Aktivitäten zu dem besagten Haltepunkt zurückkehren.

In einem dritten Fall wird die Fehlersuche entweder nach Gehen in (Step Into) oder Übergehen (Step Over) und Navigieren durch den Prozess unterbrochen. In diesem Fehl kehren Sie mit Fokussieren (Focus) zu der Aktivität zurück, bei der die Fehlersuche unterbrochen wurde.

Im Kontextmenü Haltepunkte können Sie die Option Fokus auswählen, um die Aktivität mit dem Haltepunkt hervorzuheben.

Langsamer Schritt (Slow Step)

Mit Langsamer Schritt (Slow Step) können Sie sich beliebige Aktivitäten bei der Fehlersuche aus der Nähe ansehen. Während diese Aktion aktiviert ist, sind die Aktivitäten im Fehlersuchprozess hervorgehoben. Überdies sind Container wie Flowcharts, Sequences oder Workflow-Datei-aufrufen-(Invoke Workflow File)Aktivitäten geöffnet. Dieser Vorgang ist ähnlich wie Gehen in (Step Into), jedoch ohne den Fehlersuchvorgang zu pausieren.

Langsamer Schritt (Slow Step) kann sowohl vor als auch während der Fehlersuche aktiviert werden. Durch Aktivieren der Aktion wird die Fehlersuche nicht pausiert.

Obwohl die Bezeichnung Langsamer Schritt (Slow Step) lautet, bietet die Aktion 4 verschiedene Geschwindigkeiten. Der Schritt mit der ausgewählten Geschwindigkeit führt den Fehlersuchvorgang langsamer als den vorherigen aus. So läuft die Fehlersuche mit Langsamer Schritt (Slow Step) in der Geschwindigkeit 1x am langsamsten und am schnellsten mit der Geschwindigkeit 4x ab. Mit anderen Worten, die Geschwindigkeit bestimmt, wie schnell der Debugger von einer Aktivität zu nächsten springt.

Immer, wenn Sie auf Langsamer Schritt (Slow Step) klicken, ändert sich die Geschwindigkeit um einen Schritt. Sie ist leicht am Symbol zu erkennen, das entsprechend aktualisiert wird.

Ausführungspfad

Die Menüband-Schaltfläche Ausführungspfad ist standardmäßig deaktiviert. Wenn diese Option aktiviert ist, wird der genaue Ausführungspfad beim Debuggen angezeigt. Während der Prozess ausgeführt wird, wird jede Aktivität im Bedienfeld Designer hervorgehoben und markiert, die Ihnen die Ausführung wie möglich anzeigt:

  • ausgeführte Aktivitäten werden grün markiert und hervorgehoben;
  • Aktivitäten, die nicht ausgeführt wurden, werden in keiner Weise gekennzeichnet;
  • Aktivitäten, die eine Ausnahme ausgelöst haben, werden rot markiert und hervorgehoben.



Elemente hervorheben

Wenn aktiviert, werden UI-Elemente bei der Fehlersuche hervorgehoben. Die Option kann sowohl mit regulärer als auch schrittweiser Fehlersuche verwendet werden.

Protokollaktivitäten

Wenn aktiviert, werden gedebuggte Aktivitäten als Ablaufverfolgungsprotokolle im Panel Ausgabe angezeigt. Beachten Sie, dass die Optionen Elemente hervorheben und Aktivitäten protokollieren nur vor dem Debuggen umgeschaltet werden können und erhalten bleiben, wenn Sie das Automatisierungsprojekt erneut öffnen. Für aufgerufene Workflows gilt dies nur, wenn diese Dateien im Panel Designer geöffnet werden.

Protokolle werden automatisch an den Orchestrator geschickt, wenn eine Verbindung besteht. Sie können sie jedoch auch lokal speichern, indem Sie die Option Entwicklungsprotokollierung zulassen auf der Registerkarte Roboter-Einstellungen im Fenster „Benutzer hinzufügen“ oder „Benutzer bearbeiten“ deaktivieren.

Das Deaktivieren von Protokollaktivitäten (Log Activities) ist eine Möglichkeit, kleinere Protokolldateien an Orchestrator zu senden.

Hinweis: Wenn Prozesse von Studio ausgeführt werden, sind die an Orchestrator gesendeten Protokolle immer Trace, wenn Protokollaktivitäten deaktiviert sind, und Verbose, wenn „Aktivitäten protokollieren“ aktiviert ist. Dadurch werden sowohl die Einstellung „Roboter“ als auch „Orchestrator“ außer Kraft gesetzt.

Der Debugger protokolliert standardmäßig Aktivitäten, sodass jeder Schritt im Panel Ausgabe (Output) erscheint. Wir empfehlen, ihn zwecks leichterer Nachverfolgung aktiviert zu lassen, wie Sie im Bild unten sehen können:



Das Problem hierbei ist, dass ein oder mehrere Eingabefelder der Benutzereingabe-Sequence leer sind, was eine True-Bedingung für die Ablaufentscheidung darstellt. Dies können Sie daran erkennen, dass die Benutzereingabe-Sequence bei der Fehlersuche doppelt ausgeführt wird, was bedeutet, dass ein oder mehrere Felder bei der ersten Ausführung leer gelassen wurden.

Wenn Sie die Option Aktivitäten protokollieren (Log Activities) bei der Fehlersuche deaktivieren, werden im Panel Ausgabe (Output) keine Nachverfolgungsprotokolle angezeigt. Bei einer normalen Ausführung ohne Fehler bekommen Sie nur die Zeiten für Anfang und Ende der Ausführung zu sehen. Durch Hinzufügen einer Protokollnachricht (Log Message) können Sie jedoch feststellen, wo Probleme auftreten könnten.

Beispielsweise können Sie eine Protokollnachrichts- (Log Message) Aktivität hinzufügen, die Sie informiert, dass in diesem Fall ein oder zwei Eingabefelder leer sind. Wie Sie unten sehen können, erscheint diese Nachricht bei der Fehlersuche auch dann im Panel Ausgabe (Output), wenn die Option Aktivitäten protokollieren (Log Activities) deaktiviert ist:



Denken Sie daran, dass Sie die Nachrichten im Panel Ausgabe (Output) jederzeit filtern können, indem Sie einfach die Sie interessierenden Warnungstypen auswählen oder sogar alle Meldungen löschen.



Beachten Sie, dass standardmäßig alle Debugging-Protokolle an Orchestrator gesendet werden. Sie können dies deaktivieren, indem Sie die Option Entwicklungsprotokollierung zulassen auf der Registerkarte Einstellungen im Fenster Roboter hinzufügen oder bearbeiten löschen. Wenn diese Option deaktiviert ist, werden Debugging-Protokolle nur lokal gespeichert.

Bei Ausnahme fortsetzen

Diese Debugfunktion ist standardmäßig deaktiviert. Wenn im Menüband deaktiviert, löst sie den Ausführungsfehler aus und stoppt das Debuggen, hebt die Aktivität hervor, die die Ausnahme ausgelöst hat, und protokolliert die Ausnahme im Bedienfeld Ausgabe. Wenn zuvor ein globaler Ausnahmehandler im Projekt festgelegt wurde, wird die Ausnahme an den Handler weitergegeben.

Wenn diese Option aktiviert ist, wird die Ausnahme im Bedienfeld Ausgabe protokolliert, die Ausführung wird fortgesetzt.

Bild in Bild

Die Option Bild in Bild ist auf der Registerkarte Debuggen sowohl für das Ausführen als auch für das Debuggen von Prozessen oder Bibliotheken in einer separaten Sitzung auf Ihrem Computer verfügbar.

Wenn diese Option aktiviert ist, startet der Prozess immer dann, wenn Sie Ausführen oder Datei ausführen, Debuggen oder Datei debuggen auswählen, entweder in einer separaten Sitzung oder auf einem virtuellen Desktop in der Benutzersitzung. Wenn Bild in Bild deaktiviert ist, erfolgen Debugging und Ausführung in der aktuellen Sitzung.

Die Option zum Ausführen eines Prozesses in Bild in Bild (BiB) kann in der beaufsichtigten Automatisierung sehr nützlich sein. Überprüfen Sie, ob ein Prozess im BiB-Modus erfolgreich ausgeführt wird, und aktualisieren Sie dann die Projekteinstellungen, um anzugeben, ob er nach der Veröffentlichung mit dieser Funktion ausgeführt werden kann:

  1. Klicken Sie im Bereich Projekt auf Einstellungen docs image, um das Fenster „Projekteinstellungen“ zu öffnen.
  2. Auf der Registerkarte Allgemein:

    • BiB-Optionen – Geben Sie an, ob das Projekt mit Bild in Bild getestet wurde und ob es standardmäßig im BiB-Modus starten soll.

      • Für BiB-Verwendung getestet; in BiB starten – Die Automatisierung wurde für die Ausführung im BiB-Modus genehmigt. Wenn sie ausgeführt wird, startet sie standardmäßig im BiB-Modus.
      • Für BiB-Verwendung getestet; standardmäßig nicht in BiB starten – Die Automatisierung wurde für die Ausführung im BiB-Modus genehmigt. Sie wird standardmäßig in der Hauptsitzung oder auf dem Desktop gestartet.
      • Nicht für die BiB-Verwendung getestet – Die Automatisierung wurde nicht für die Ausführung im BiB-Modus genehmigt. Sie wird standardmäßig in der Hauptsitzung oder auf dem Desktop gestartet. Wenn der Benutzer sie im BiB-Modus ausführt, wird er in einem Dialogfeld darüber informiert, dass diese Funktion nicht getestet wurde, und muss dies bestätigen, bevor er fortfahren kann.
    • BiB-Typ – Wählen Sie aus, wie die Automatisierung von der Benutzersitzung isoliert werden soll, wenn das Projekt im BiB-Modus ausgeführt wird: Neue Sitzung (untergeordnete Sitzung auf der Maschine) oder Neuer Desktop (virtueller Desktop in der Benutzersitzung).

Weitere Informationen, einschließlich zu Einschränkungen dieser Funktion, finden Sie unter Bild in Bild im Handbuch zu Robot.

Remote-Debugging

Wenn diese Funktion aktiviert ist, werden alle Ausführungs- und Debugging-Vorgänge auf einem angegebenen Remote-Roboter anstelle des lokal installierten Roboters ausgeführt, sodass Sie die Automatisierung in verschiedenen Umgebungen testen können. Weitere Informationen finden Sie unter Remote-Debugging.

Ausführungsprofil erstellen

Sie können Leistungsengpässe im Workflow identifizieren, wenn Sie die Datei debuggen. Weitere Informationen finden Sie unter Ausführungsprofil.

Protokolle öffnen

Wenn Sie auf Protokolle öffnen klicken, wird der Ordner %localappdata%\UiPath\Logs angezeigt, in dem die Protokolle lokal gespeichert sind. Das Namensformat von Protokolldateien ist YYYY-DD-MM_Component.log (wie beispielsweise 2018-09-12_Execution.log oder 2018-09-12_Studio.log). Weitere Informationen zur Protokollierung finden Sie hier.

War diese Seite hilfreich?

Hilfe erhalten
RPA lernen – Automatisierungskurse
UiPath Community-Forum
Uipath Logo White
Vertrauen und Sicherheit
© 2005–2024 UiPath. Alle Rechte vorbehalten