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.

The Global Exception Handler has two arguments, that should not be removed.

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.

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 like Continue, Stop, Retry, Ignore, Restart and Slow Step are available in the ribbon. Ignore is used for continuing the execution from the next activity.

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 Automationsprojekt ist darauf eingestellt, in einem leeren und gespeicherten Notepad-Dokument zu klicken, einen Text einzugeben und die Anwendung zu schließen, jedoch nicht, ohne zum Speichern die Schaltfläche Speichern zu betätigen.

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.

Erstellen des Workflows

1. Create a Blank Process by following the steps in the Creating a Basic Process page.

2. Öffnen Sie Notepad und speichern Sie ein Dokument auf Ihrem Computer.

3. From the Activities panel, drag a Type Into activity to the Designer panel. The activity is automatically added to a Sequence.

4. Klicken Sie in der Aktivität Eingeben (Type Into) auf Auf dem Bildschirm anzeigen (Indicate on Screen). Studio minimiert das Notepad-Fenster und fordert Sie auf, in diesem zu klicken, um den Selektor zu erstellen. Geben Sie den gewünschten Text in Anführungszeichen in das Textfeld ein.

5. From the Activities panel, add a Send Hotkey activity to the workflow. Indicate the Notepad window, and select Ctrl from the activity, type in s in the Key field. This saves the Notepad document after the text was typed in.

6. From the Activities panel, add a Close Application activity to the workflow. Indicate the Notepad window using Indicate on screen. The resulted workflow should look like this:

   

Hinzufügen einer globalen Ausnahmebearbeitung

1. Wählen Sie auf der Registerkarte Design des Menübands die Option Neu > Globaler Handler aus. Das Fenster Neuer globaler Handler wird geöffnet. Geben Sie einen Namen für den Handler an, und speichern Sie ihn im Projektpfad. Klicken Sie auf Erstellen. Ein globaler Ausnahmehandler wird dem Automatisierungsprojekt hinzugefügt.

2. Erstellen Sie auf der Registerkarte Variablen (Variables) eine Int32-Variable mit dem Namen retryCount. Legen Sie deren Bereich auf den gesamten Global Exception Handler fest und lassen Sie das Wertfeld Standard (Default) leer. Die Variable speichert die Anzahl der erneuten Versuche und erhöht die Anzahl beim Antreffen eines Fehler jedes Mal um 1.

3. Erstellen Sie eine String-Variable mit dem Namen failedActivity und legen Sie deren Bereich auf den gesamten Workflow fest. Diese Variablen speichern den Namen der fehlgeschlagenen Aktivität und vermerken diese im Panel Ausgabe (Output).

4. From the Activities panel, add an Assign activity below the Log Error in the Global Handler sequence. Add the retryCount to the activity and assign it the errorInfo.RetryCount expression, which counts the number of times the exception is thrown.

5. Fügen Sie eine weitere Zuordnen (Assign) Aktivität hinzu, in der Sie den Ausdruck errorInfo.ActivityInfo.Name zur Variablen failedActivity hinzufügen. An diesem Punkt sollte der Workflow folgendermaßen aussehen:

   

6. Add an If activity to the workflow. Set the Condition to retryCount < 3 to limit the number of retries to 3.

7. Ordnen Sie die ErrorAction.Retry im Aktivitätsteil Zuordnen (Assign) der Kategorie Dann (Then) der Variablen result zu, damit die globale Fehlerbearbeitung (Global Exception Handler) einen erneuten Versuch unternimmt, die Aktivität auszuführen, welche zu der Ausnahme geführt hat.

8. Weisen Sie die ErrorAction.Abort in der Kategorie Andernfalls (Else) zu result zu, damit die globale Fehlerbearbeitung (Global Exception Handler) abgebrochen wird, wenn die Bedingung erfüllt ist. Die Wenn (If)-Aktivität sollte folgendermaßen aussehen:

   

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 die globale Ausnahmebearbeitung (Global Exception Handler) setzt nicht ein.

Beispiel herunterladen