UiPath Documentation
studio
latest
false
Wichtig :
Es kann 1–2 Wochen dauern, bis die Lokalisierung neu veröffentlichter Inhalte verfügbar ist.

Studio-Benutzerhandbuch

Global Exception Handler

Die globale Ausnahmebearbeitung (Global Exception Handler) ist ein Workflow, mit dem Sie das Verhalten des Projekts beim Antreffen eines Ausführungsfehlers bestimmen können. Pro Automationsprojekt kann nur eine globale Ausnahmebearbeitung (Global Exception Handler) angegeben werden.

Hinweis:

Die globale Ausnahmebearbeitung (Global Exception Handler) steht nur für Prozesse und nicht für Bibliotheksprojekte zur Verfügung.

Die globale Ausnahmebearbeitung (Global Exception Handler) umfasst zwei Argumente, die nicht entfernt werden sollten.

Das erste Argument ist errorInfo mit der Richtung Ein. Darin sind Informationen über den Fehler und den fehlgeschlagenen Workflow gespeichert. Die zu protokollierende Fehlerstufe kann in der Aktivität Meldungen protokollieren (Log Message) festgelegt werden.

Hinweis:

Mit der Eigenschaft ActivityInfo für errorInfo können Sie den Namen der Aktivität abrufen, die die Ausnahme ausgeworfen hat, und diese im Panel Ausgabe (Output) anzeigen.

Das zweite Argument ist result mit der Richtung Aus. Darin wird das Verhalten des Prozesses beim Antreffen des nächsten Fehlers festgelegt. Folgende Werte können dem Argument result zugeordnet werden:

  • Fortfahren (Continue) - Die Ausnahme wird erneut ausgegeben.
  • Ignorieren (Ignore): Die Ausnahme wird ignoriert und Ausführung ab der nächsten Aktivität fortgesetzt.
  • Wiederholen (Retry) - Die Aktivität, welche die Ausnahme generiert hat, wird wiederholt. Wählen Sie die Methode RetryCount, damit errorInfo zählt, wie oft erneut versucht wird, die Aktivität auszuführen.
  • Abbrechen (Abort) - Die Ausführung stoppt nach Ausführung der aktuellen Globalen Ausnahmebearbeitung (Global Exception Handler).
    Hinweis:

    Jeder Workflow kann in Studio als Global Exception Handler gekennzeichnet werden, mit Ausnahme von Bibliotheksprojekten und Main.xaml.

Um den Versuch zu unternehmen, das Verhalten eines Workflows im Falle eines Fehlers zu überprüfen, wiederholt die globale Fehlerbearbeitung (Global Exception Handler) die Aktivität drei Mal und bricht dann mit einer Fehlermeldung ab.

Bearbeitungsfehler bei der Fehlersuche

Wenn beim Debuggen eine Ausnahme erkannt wird, wird die fehlerhafte Aktivität hervorgehoben, die Ausführung wird angehalten, und der Typ und die Details der Ausnahme werden in den Panels Lokal und Aufrufliste angegeben.

Debugging-Actions wie Fortfahren, Anhalten, Wiederholen, Ignorieren, neu starten und langsamer Schritt sind im Menüband verfügbar.Ignorieren wird verwendet, um die Ausführung ab der nächsten Aktivität fortzusetzen.

Mit der Schaltfläche Wiederholen wird erneut versucht, die aktuelle Aktivität auszuführen, ohne dass der globale Ausnahmehandler eingreift. Mit der Aktion Fortfahren wird der globale Ausnahmehandler ausgeführt. Dabei werden die zuvor gewählten Werte für das result-Argument berücksichtigt, entweder Fortfahren, Ignorieren, Wiederholen oder Abbrechen.

Hinweis:

Wenn Sie den Global Exception Handler mit einem Projekt verwenden, das eine Try Catch enthält, stellen Sie sicher, dass Sie Aktivitäten in einer Sequence im Try-Container gruppieren. Andernfalls wird der Global Exception Handler nicht ausgeführt.

Bei verschachtelten Aktivitäten wird die Global Exception Handler für jede Aktivität im Aufrufstapel ausgeführt. Sie wird jedoch nicht für Aktivitäten ausgeführt, die direkt in einem Abfangen versuchen (Try Catch) eingeschlossen sind, sofern diese nicht in einer Aktivität enthalten sind.

Beispiel für die Verwendung der globalen Ausnahmebearbeitung

Das folgende Beispiel veranschaulicht das Projektverhalten bei einer Ausnahme während der Ausführung.

Das Automatisierungsprojekt ist darauf eingestellt, einen Text in eine TXT-Datei einzugeben und dann die Anwendung nach dem Speichern der Datei zu schließen.

Voraussetzungen

Erstellen des Workflows

  1. Öffnen Sie Notepad und speichern Sie ein Dokument auf Ihrem Computer. Sie können die Datei 1.txt nennen.
  2. Suchen Sie im Panel „Aktivitäten“ nach Use Application/Browser und ziehen Sie sie die Aktivität in das Designer-Panel.
  3. In „Use Application/Browser“
    • Klicken Sie auf Anwendung für Automatisierung anzeigen und bewegen Sie dann den Mauszeiger in das Notepad-Fenster. Wenn das Fenster hervorgehoben ist, klicken Sie auf eine beliebige Stelle darin. Die Aktivität „Use Application/Browser“ wird aktualisiert, der Pfad wird dem Feld Anwendungspfad hinzugefügt und ein Screenshot des Fensters wird innerhalb der Aktivität angezeigt.
    • Wählen Sie im Panel Eigenschaften die Option Always für die Eigenschaft Close aus. Dadurch wird sichergestellt, dass Notepad nach der Automatisierung geschlossen wird.
  4. Add a Type Into activity in the Use Application/Browser activity’s Do container. Select Indicate in App to select the Notepad window, and add enter a text between quotation marks in the Type this field. This activity writes the text into Notepad.
  5. Fügen Sie dem Workflow im Aktivitätenbereich eine Aktivität mit Tastenkombinationen hinzu. Geben Sie das Fenster Notepad an, wählen Sie dann Datensatz aufzeichnen und drücken Sie Strg + S, um die Tastenkombination aufzuzeichnen, die die Datei nach der Eingabe des Texts speichert.

Der endgültige Workflow sollte folgendermaßen aussehen:

Ergebnis

The workflow is created and displayed in the Designer panel, ready for the Global Exception Handler to be added.

Hinzufügen einer globalen Ausnahmebearbeitung

  1. In the Design tab part of the Ribbon, select New > Global Handler. The New Global Handler window opens. Type in a Name for the handler and save it in the project path. Select Create, a Global Exception Handler is added to the automation project.

  2. Go back to the workflow you created earlier and modify it so that an activity fails to execute. For example, in the Use Application/Browser activity, select the Match exact title option and make sure the file is closed before you select Run File in the ribbon.

Ergebnis

Wenn die globale Ausnahmebearbeitung (Global Exception Handler) eine Ausnahme antrifft, protokolliert sie den Namen der fehlgeschlagenen Aktivität und versucht drei Mal, die Aktivität zu starten. Stößt sie dabei jedes Mal auf dieselbe Ausnahme, wird die Ausführung nach 3 Versuchen auf der Stufe der Aktivität abgebrochen, welche die Ausnahme verursacht hat.

Wird bei einem der Wiederholungsversuche keine Ausnahme angetroffen, wird die Ausführung des Workflows fortgesetzt und der Global Exception Handler setzt nicht ein.

War diese Seite hilfreich?

Verbinden

Benötigen Sie Hilfe? Support

Möchten Sie lernen? UiPath Academy

Haben Sie Fragen? UiPath-Forum

Auf dem neuesten Stand bleiben