Debugging-Werkzeug

Mit den Debugging-Werkzeugen können Sie komplexe Automatisierungen mit verschachtelten Aufgaben reparieren. Debuggen Sie übergeordnete sowie die darin enthaltenen untergeordneten Bots, um Probleme schnell und detailliert zu identifizieren und zu beheben. Sie können jede untergeordnete Automatisierung einzeln untersuchen, um sicherzustellen, dass jeder Teil Ihrer Automatisierung korrekt funktioniert. Das führt zu effizienteren und zuverlässigeren Automatisierungsprozessen.

Werkzeug zur Fehlerbehebung verwenden

Wählen Sie auf der Seite Automation den Bot aus, den Sie debuggen möchten, und bearbeiten Sie ihn. Sie können das Werkzeug Fehlerbehebung ausführen über das Hilfsprogramm Assistent oder über den Bot Editor aufrufen.

Auf das Werkzeug zur Fehlerbehebung zugreifen

Wenn Sie das Werkzeug Fehlerbehebung ausführen aus dem Bot Editor aufrufen:
  • Sie können Aktionen und Variablen innerhalb eines Bots hinzufügen, aktualisieren oder löschen. Sie können den Bot weiter bearbeiten, solange der Debugging-Prozess noch nicht begonnen hat.
  • Wenn Sie mit dem Debuggen beginnen, wird ein violetter Header unter dem Bot-Namen im Bot Editor angezeigt. Hier wird Jetzt Fehlerbehebung gefolgt vom Namen des Bots angezeigt, der debuggt wird.
  • Der Header zeigt außerdem eine hierarchische Stapelliste von Bots, genau wie im Aufrufstapel. Aus dieser Stapelliste von Bots können Sie zu einem bestimmten Bot navigieren und und prüfen, in welcher Zeile Sie den aktuellen untergeordneten Bot aufgerufen haben. Im Header wird ferner ein Link angezeigt, auf den Sie klicken können, um zu dem aktuellen Bot zu navigieren und das Debugging fortzusetzen, falls Sie sich von dem aktuellen Bot entfernt haben.
  • Unter dem Header werden dieselben Fehlerbehebungs-Steuerelemente wie im Assistenten angezeigt, damit Sie schnell auf die Fehlerbehebungs-Steuerung zugreifen können.
  • Das Feld Aktionen auf der linken Seite des Bot Editors wird automatisch reduziert. Dies hilft bei der Bereitstellung eines größeren horizontalen Bereichs, um das Hinzufügen der Aktionen im Bot Editor während der Fehlersuche anzuzeigen. Sobald die Fehlersuche beendet ist, wird der Bereich Aktionen wieder erweitert.
Anmerkung:
  • Das Aufrufen eines Debuggers startet nicht das Debugging.
  • Bevor Sie mit dem Debugging beginnen, stellen Sie sicher, dass Sie alle Validierungsfehler in Ihren Bots behoben haben.
  • Sie können den Bot in den Ansichten Ablauf und Liste debuggen. Für eine bessere Sichtbarkeit Ihrer Aktionen empfehlen wir jedoch, dass Sie Ihren Bot in der Ansicht Liste debuggen.
Wenn Sie das Hilfsprogramm Assistent aus dem Bot Editor, dem API-Editor oder dem Vorlagen-Editor öffnen und ihn an eine bestimmte Position verschieben, behält der Editor die letzte Position des Hilfsprogramms Assistent bei, auch wenn Sie den Editor verlassen. Die Standardposition des Hilfsprogramms Assistent entspricht der letzten Position, an die Sie es vor dem Verlassen des Editors bewegt haben:
  • auch dann, wenn eine Nutzersitzung zeitlich begrenzt ist oder der Browser abrupt geschlossen wird.
  • auch dann, wenn Sie den Editor von einem anderen Browser aus öffnen oder sich mit denselben Anmeldedaten in einer anderen Sitzung anmelden.

Dies verbessert die Benutzerfreundlichkeit des Assistenten, da Sie den Assistenten nicht mehr bei jedem Öffnen des Aktionens im Editor auf die rechte Seite des Editors verschieben müssen, um den Bereich Bot anzuzeigen.

Debug-Steuerelemente

Anmerkung:
  • Es gibt keine Begrenzung für die Anzahl der untergeordneten Bots, in die Sie einsteigen können.
  • Die Debugging-Funktion für einen untergeordneten Bot wird vom Bot-Agent (Version 22.60.23 und später) und TaskBot-Paket (Version 2.8.0-20230530-152744 und später) unterstützt.
Aktionen Symbole Tastaturkürzel Beschreibung
Fehlerbehebung starten Startknopf F6 Verwenden Sie die Option Fehlerbehebung starten, um die Fehlerbehebung zu starten.
Zur nächsten Aktion gehen Step-over-Knopf F7 Verwenden Sie Zur nächsten Aktion gehen, um jeweils eine Aktion zu debuggen. Nachdem Sie ein Debugging für die aktuelle Aktion ausgeführt haben, können Sie Zur nächsten Aktion gehen verwenden, um zur nächsten Aktion in der Sequenz zu gelangen.
Weiter zum nächsten Haltepunkt Schaltfläche „Weiter zum nächsten Haltepunkt“ F6 Verwenden Sie Weiter zum nächsten Haltepunkt, um direkt zum nächsten Haltepunkt zu gelangen. Weiter zum nächsten Haltepunkt führt die aktuelle Aktion aus, geht dann zum nächsten Haltepunkt und pausiert.
Anmerkung: Wenn das Debugging läuft, ändert sich das Symbol Fehlerbehebung starten zu Weiter zum nächsten Haltepunkt.
Aktuelle Aktion aufrufen Step-in-Taste F8 Verwenden Sie Aktuelle Aktion aufrufen, um in den untergeordneten Bot einzusteigen, um das Debugging durchzuführen. Aktuelle Aktion aufrufen ist nur aktiviert, wenn Sie einen untergeordneten Bot mit TaskBot > Ausführen Aktion aufrufen.
Aktuellen Bot verlassen Step-out-Taste Umschalt+F8 Verwenden Sie Aktuellen Bot verlassen, um nach der Fehlerbehebung aus dem untergeordneten Bot auszusteigen und an der nächsten Zeile des Bots anzuhalten (von der Zeile aus gesehen, an der Sie eingestiegen sind).
Anmerkung: Aktuellen Bot verlassen wird erst aktiviert, nachdem Sie in den untergeordneten Bot eingestiegen sind.
Debugging stoppen Stopp-Taste Umschalt+F6 Verwenden Sie die Option Debugging stoppen, um den Debugging-Prozess zu stoppen.

Aufrufstapel

Mit Aufrufstapel können Sie die Reihenfolge des Aufrufs von Bots bestimmen und schnell von einem Bot zum nächsten wechseln. „Aufrufstapel“ listet die derzeit aktiven Automatisierungen auf, einschließlich übergeordneter und untergeordneter Bots, mit der Zeilennummer und dem Ordner, in dem sie sich befinden. Der derzeit aktive Bot wird hervorgehoben und oben in der Liste angezeigt.

Mit Aufrufstapel können Sie den Pfad des Fehlers vom Ursprung aus verfolgen, um zu verstehen, wie der Fehler aufgetreten ist. So können Sie die Ursache von Problemen besser identifizieren, insbesondere bei komplexen Automatisierungen mit mehrstufiger Verschachtelung.

Beim Zugriff wird der untergeordnete Bot dem Aufrufstapel hinzugefügt. Wenn Sie aus dem untergeordneten Bot aussteigen oder das Debugging des untergeordneten Bots abgeschlossen haben, wird der Bot aus dem Aufrufstapel entfernt. Der übergeordnete Bot wird jetzt zum aktuellen Bot, für den die Fehlerbehebung durchgeführt wird.

Je nach dem Bot, der im Aufrufstapel ausgewählt ist, werden unter Beobachtete Variablen die Variablen für den ausgewählten Bot angezeigt. Unter Beobachtete Variablen können Sie dann die Variable auswählen, deren aktueller Wert beobachtet werden soll.

Aufrufstapelansicht

Haltepunkte

Haltepunkte beim Debuggen sind Werkzeuge, die es Ihnen ermöglichen, die Ausführung eines Programms oder einer Automatisierung an einem bestimmten Punkt zu unterbrechen. Damit können Sie den aktuellen Zustand der Anwendung überprüfen, einschließlich der überwachten Variablen und des Ausführungsflusses, um sicherzustellen, dass Ihre Automatisierung wie erwartet funktioniert.

Haltepunkteinstellungen

Durch das Aktivieren von Haltepunkten in übergeordneten und untergeordneten Bots können Sie den Debugging-Prozess während einer Bot-Ausführung anhalten, um die Werte der beobachteten Variablen und den aktuellen Status der Automatisierung zu prüfen. Um eine bestimmte Aktion zu unterbrechen und ein Debugging durchzuführen, können Sie einen Haltepunkt bei dieser Aktion einfügen. Dies ist nützlich für komplexe und lang andauernde Prozesse, die sich über mehrere Aufgaben oder untergeordnete Automatisierungen erstrecken.

Überprüfen Sie die folgende Tabelle, um zu erfahren, wie Sie Haltepunkte aktivieren und deaktivieren können.
Aktionen Symbole und Tastenkombinationen Beschreibung
Haltepunkt aktivieren

Schaltfläche „Haltepunkt aktivieren“

F9

Um einen Haltepunkt einzufügen, klicken Sie auf die vertikalen Ellipsen in der entsprechenden Codezeile und wählen Sie Haltepunkt aktivieren.

Alternativ können Sie einen Haltepunkt auch aktivieren, indem Sie auf die entsprechende Zeilennummer klicken. Es wird ein Haltepunktsymbol über der Zeilennummer angezeigt.

Anmerkung: Wenn Sie einen Haltepunkt für eine bestimmte Codezeile aktivieren, hebt das Werkzeug Fehlerbehebung ausführen diesen hervor und kennzeichnet ihn mit einer „Pausieren“-Schaltfläche auf der rechten Seite der Codezeile.
Haltepunkt deaktivieren

Schaltfläche „Haltepunkt deaktivieren“

F9

Um einen Haltepunkt zu deaktivieren, klicken Sie auf die vertikalen Ellipsen in der entsprechenden Codezeile und wählen Sie Haltepunkt deaktivieren. Der Haltepunkt wird inaktiv. Zusätzlich können Sie auch auf das Haltepunktsymbol über der jeweiligen Zeilennummer klicken, um den Haltepunkt zu deaktivieren.
Alle Haltepunkte löschen

Schaltfläche „Alle Haltepunkte löschen“

Umschalt+F9

Klicken Sie zum Löschen aller Haltepunkte auf das Symbol Alle Haltepunkte löschen.

So verwenden Sie Haltepunkte zum Debuggen

Wenn Sie den Haltepunkt aktivieren, wird die spezifische Aktion, für die das Debugging ausgeführt wird, mit einem Pausenzeichen hervorgehoben. Nachdem Sie den Haltepunkt hinzugefügt haben, um das Debugging-Werkzeug anzuhalten, können Sie Weiter zum nächsten Haltepunkt, Zur nächsten Aktion gehen oder Aktuelle Aktion aufrufen auswählen oder den Debugging-Prozess mit Stoppen anhalten.

Haltepunkte, die während des Debuggens zu einem bestimmten Bot hinzugefügt werden, werden automatisch gespeichert, sodass alle Haltepunkte erhalten bleiben, selbst wenn Sie Ihre Automatisierung schließen und erneut öffnen oder zwischen verschiedenen Debugging-Sitzungen wechseln.
Anmerkung:
  • Das Einchecken eines bestimmten Bot wird keine neue Version des Bot erstellen, da er nicht mehr geändert wird.
  • Das Kopieren eines Bot kopiert keine Haltepunkte.

Haltepunkt zu Zeile 2 hinzugefügt

Sie können während des Debuggens spontan Haltepunkte einrichten. Wenn Sie beispielsweise den Status eines übergeordneten Elements Bot eines vorhandenen untergeordneten Elements Bot prüfen möchten, können Sie über die Aufrufliste zu diesem Bot navigieren und bei Bedarf Haltepunkte innerhalb des übergeordneten Elements Bot hinzufügen. Nachdem Sie den Haltepunkt aktiviert haben, wird Bot beim nächsten Haltepunkt, den Sie gerade hinzugefügt haben, angehalten, wenn Sie auf die Option Weiter zum nächsten Haltepunkt klicken.

Lassen Sie uns ein Szenario untersuchen, in dem Sie beim Debuggen einer Automatisierung Haltepunkte in bestimmten Bots aktivieren und beobachten, wie sie sich verhält.
  1. Stellen Sie sich vor, Sie automatisieren den Prozess des Client-Onboardings und haben drei Bots für diesen Prozess erstellt, nämlich den Client-Datensammler-Bot, der einen Verifizierungsprozess-Bot enthält, der wiederum einen Willkommenskommunikator-Bot enthält.
  2. Aktivieren Sie einen Haltepunkt innerhalb des Willkommenskommunikator-Bots, an dem das Debugging pausieren soll.
  3. Klicken Sie auf das Symbol Debuggen starten.

    Der Bot wird automatisch in den Willkommenskommunikator-Bot eintreten und an dem gesetzten Haltepunkt pausieren.

  4. Treten Sie aus dem Willkommenskommunikator-Bot.

    Sie werden feststellen, dass die Automatisierung direkt beim Client-Datensammler-Bot pausiert.

    Anmerkung: Beim Verlassen eines bestimmten Bot sollte der Bot idealerweise an der Linie anhalten, die unmittelbar auf die Linie folgt, von der Sie aus dem übergeordneten Bot eingetreten sind. In diesem Szenario sind Sie jedoch nicht explizit in den Willkommenskommunikator-Bot eingetreten; er wurde aufgrund des Haltepunkts automatisch betreten.
  5. Ähnlich verhält es sich, wenn Sie Schritt auslassen von der letzten Zeile des Willkommenskommunikator-Bots ausführen, wird der Bot direkt beim Client-Datensammler-Bot pausieren.

Weitere Informationen zu Debugging-Werkzeugen finden Sie unter Leveraging code analysis and debug tool to improve and optimize your automation development.