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 ausgegebenen Fehler und den fehlgeschlagenen Workflow gespeichert. Die zu protokollierende Fehlerstufe kann in der Aktivität 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: In Studio kann außer bei Bibliotheksprojekten jeder beliebige Workflow als globale Ausnahmebearbeitung (Global Exception Handler) markiert werden.

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-Aktionen wie Weiter, Stopp, 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:

Bei Verwendung der Globalen Ausnahmebearbeitung (Global Exception Handler) mit einem Projekt, das ein Abfangen versuchen (Try Catch) enthält, müssen Sie darauf achten, dass die Aktivitäten in einer Sequenz (Sequence) innerhalb des Containers Versuchen (Try) gruppiert werden. Andernfalls führt die Globale Ausnahmebearbeitung (Global Exception Handler) nichts aus.

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. Erstellen Sie einen leeren Prozess, indem Sie die Schritte auf der Seite Erstellen eines Basisprozesses ausführen.
2. Öffnen Sie Notepad und speichern Sie ein Dokument auf Ihrem Computer.
3. Ziehen Sie im Aktivitäten (Activities)-Panel eine Type Into-Aktivität in das Designer (Designer)-Panel. Die Aktivität wird automatisch einer Sequence hinzugefügt.
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. Fügen Sie aus dem Panel Aktivitäten (Activities) eine Aktivität Hotkey senden (Send Hotkey) in den Workflow ein. Zeigen Sie das Notepad-Fenster an, wählen Sie Strg in der Aktivität und geben Sie im Schlüsselfeld s ein. Das Notepad-Dokument wird nach Eingabe des Textes gespeichert.
6. Fügen Sie aus dem Panel Aktivitäten eine Close Application-Aktivität zum Workflow hinzu. Zeigen Sie das Notepad-Fenster mit Auf Element auf dem Bildschirm deuten an. Der sich ergebende Workflow sollte folgendermaßen aussehen:
   
   

   

   
   

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. Fügen Sie aus dem Panel Aktivitäten eine Assign-Aktivität unter Fehler protokollieren in der Sequence Globaler Handler hinzu. Fügen Sie der Aktivität retryCount hinzu, und weisen Sie sie dem errorInfo.RetryCount-Ausdruck zu, um zu zählen, wie oft die Ausnahme generiert wird.
5. Fügen Sie eine weitere 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. Fügen Sie dem Workflow eine If-Aktivität hinzu. Legen Sie die Bedingung auf retryCount < 3 fest, um die Anzahl der erneuten Versuche auf 3 zu begrenzen.
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