Bereich erneut versuchen (Retry Scope)

UiPath.Core.Activities.RetryScope

Beschreibung

Wiederholt so lange die enthaltene Aktivität, wie die Bedingung nicht erfüllt ist oder ein Fehler auftritt.

Diese Aktivität funktioniert im Hauptworkflow eines Orchestrierungsprozessesnicht wie erwartet.

Projektkompatibilität

Windows - Legacy | Windows | Plattformübergreifend

Windows – Legacy, Windows-Konfiguration

Designer-Panel

• Aktion – Fügen Sie Aktivitäten hinzu, die in diesem Abschnitt erneut ausgeführt werden sollen.
• Bedingung – Fügen Sie in diesem Abschnitt eine Bedingungsaktivität hinzu.

  Wenn Sie z. B. bei der Anzeige eines UI-Elements scheitern und es erneut versuchen möchten, können Sie die Modern UI Automation-Aktivität Check App State oder ihr klassisches Pendant Element Exists als Bedingung verwenden und erneut versuchen, die Anwendung zu öffnen und das UI-Element zu finden.

Eigenschaften-Panel

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.

• Fortfahren bei Fehler (Continue On Error) – Gibt an, ob die Automation fortgesetzt werden soll, auch wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche Werte (wahr, falsch). Der Standardwert ist falsch. Als Ergebnis ist das Feld leer und ein Fehler wird ausgegeben; die Ausführung des Projekts wird angehalten. Wenn der Wert auf Wahr gesetzt wird, wird die Ausführung des Projekts unabhängig von Fehlern fortgesetzt.

  Hinweis: Wenn diese Aktivität in Try Catch enthalten ist und der Wert der Eigenschaft BeiFehlerFortsetzen auf „True“ gesetzt ist, wird kein Fehler beim Ausführen des Projekts aufgefangen.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Optionen

• AnzahlderWiederholungen (NumberOfRetries) - Die Anzahl der versuchten Wiederholungen der Sequenz.
• Wiederholungsintervall ( RetryInterval) - Gibt die Dauer zwischen den einzelnen Wiederholungen an.

Plattformübergreifende Konfiguration

Designer-Panel

• Aktion – Fügen Sie Aktivitäten hinzu, die in diesem Abschnitt erneut ausgeführt werden sollen.
• Bedingung – Fügen Sie in diesem Abschnitt eine Bedingungsaktivität hinzu.

  Wenn Sie z. B. bei der Anzeige eines UI-Elements scheitern und es erneut versuchen möchten, können Sie die Modern UI Automation-Aktivität Check App State als Bedingung verwenden und erneut versuchen, die Anwendung zu öffnen und das UI-Element zu finden.

Allgemein

• Fortfahren bei Fehler (Continue On Error) – Gibt an, ob die Automation fortgesetzt werden soll, auch wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche Werte (wahr, falsch). Der Standardwert ist falsch. Als Ergebnis ist das Feld leer und ein Fehler wird ausgegeben; die Ausführung des Projekts wird angehalten. Wenn der Wert auf Wahr gesetzt wird, wird die Ausführung des Projekts unabhängig von Fehlern fortgesetzt.

  Hinweis: Wenn diese Aktivität in Try Catch enthalten ist und der Wert der Eigenschaft BeiFehlerFortsetzen auf „True“ gesetzt ist, wird kein Fehler beim Ausführen des Projekts aufgefangen.

Optionen

• AnzahlderWiederholungen (NumberOfRetries) - Die Anzahl der versuchten Wiederholungen der Sequenz.
• Wiederholungsintervall ( RetryInterval) - Gibt die Dauer zwischen den einzelnen Wiederholungen an.

Beispiel zur Verwendung der Wiederholungsumfangsaktivität (Retry Scope Activity)

Die Aktivität „ Retry Scope “ wird zum Erkennen und Behandeln eines Fehlers verwendet, weshalb sie „ Try Catch “ ähnelt. Der folgende Workflow versucht, das Notepad-Fenster dreimal zu öffnen und verwendet die in der Aktivität „Retry Scope“ festgelegte Bedingung, um die Schleife zu beenden.

1. Erstellen Sie eine neue Sequenz und fügen Sie die Aktivität Wiederholungsumfang (Retry Scope) hinzu.
2. Lassen Sie im Panel Eigenschaften (Properties) den Standardwert AnzahlderWiederholungen (NumberOfRetries) auf 3 und den Wiederholungsintervall (Retry Interval) auf 5. Das bedeutet, dass wir versuchen, das Editor-Fenster dreimal zu öffnen und das Intervall zwischen den Versuchen 5 Sekunden beträgt.
3. Fügen Sie eine Aktivität Zuweisen (Assign) im Abschnitt Zuweisen (Assign) hinzu.
4. Erstellen Sie eine Variable GenerischerWert (GenericValue), z. B. Willkürlich (Random), und fügen Sie sie dem Feld An (To) der Aktivität Zuweisen (Assign) hinzu.
5. Fügen Sie der Variablen den Wert Now.Millisecond mod 5 hinzu, indem Sie ihn zum Feld Wert (Value) der Aktivität Zuweisen (Assign) hinzufügen.
   
   

   

   
   
6. Fügen Sie eine Aktivität If hinzu und geben Sie als Bedingung Random <> 0 ein. Das bedeutet, dass Sie überprüfen, ob Ihre Variable nicht 0 ist.

7. Im Abschnitt Dann (Then) der Aktivität (die obige Bedingung ist wahr):

   • Fügen Sie eine Nachrichtenbox (Message box) mit dem Inhalt „Editor-Fenster konnte nicht gestartet werden“ hinzu.
   • Fügen Sie unter Nachrichtenbox (Message Box) eine Aktivität Werfen (Throw) hinzu, um einen Fehler zu verursachen.
   • Geben Sie New System.Exception(“Notepad failed to start”) im Feld Ausnahme (Exception) unter Eigenschaften (Properties) ein.

8. Im Abschnitt Sonst (Else) der Aktivität Wenn (If) (die obige Bedingung ist falsch):

   • Fügen Sie eine Aktivität Anwendung öffnen (Open Application) hinzu und geben Sie den Editor auf dem Bildschirm an. Geben Sie den vollständigen Pfad der ausführbaren Editor-Datei im Feldbereich DateiName (FileName) von Eigenschaften (Properties) an.

     
     

     

     
     

9. Um die Schleife zu beenden, fügen Sie die Aktivität Element vorhanden (Element Exists) im Abschnitt Bedingung (Condition) von Wiederholungsumfang (Retry Scope) hinzu und geben Sie das Editor-Fenster an.

   Wenn moderne Aktivitäten verwendet werden, kann die Aktivität Check App State als Bedingung im Retry Scope verwendet werden.

   
   

   

   
   

Dieser Workflow simuliert ein fehlerhaftes Fenster im Editor (Notepad). Wenn der Wert der Random-Variable dreimal hintereinander von 0 abweicht, wird jedes Mal die Meldung „Editor-Fenster konnte nicht gestartet werden“ angezeigt und der gesamte Workflow schlägt mit dem Fehler „Editor-Fenster konnte nicht gestartet werden“ fehl. Die letzte Nachricht ist diejenige, die in der Aktivität Throw hinzugefügt wurde.

Wenn der Wert der Variable Random 0 ist, öffnet der Roboter den Editor (Notepad), und da die Bedingung dieser Schleife darin besteht, das Fenster Editor (Notepad) zu finden, wird der Workflow erfolgreich abgeschlossen.

Beispiel herunterladen