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.

Wichtig:

• The Delay and Retry Scope activities are not supported and do not work properly when used in the Main workflow of an Orchestration Process. In such cases, they should be placed inside a No Persist Scope activity.

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

• Bei Fehler fortfahren – Gibt an, ob die Automatisierung auch dann fortgesetzt werden soll, wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche Werte (True, False). Der Standardwert ist False. Wenn das Feld leer ist, ein Fehler ausgelöst oder die Anzahl der Wiederholungen überschritten wird, wird die Ausführung des Projekts angehalten. Wenn der Wert auf True gesetzt ist, wird die Ausführung des Projekts ungeachtet eines Fehlers 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.

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

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 – Gibt die Zeit zwischen den einzelnen Wiederholungen an.

Plattformübergreifende Konfiguration

Designer-Panel

• Aktivitätstext – 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.

Zusätzliche Eigenschaften

• Bei Fehler fortfahren – Gibt an, ob die Automatisierung auch dann fortgesetzt werden soll, wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche Werte (True, False). Der Standardwert ist False. Wenn das Feld leer ist, ein Fehler ausgelöst oder die Anzahl der Wiederholungen überschritten wird, wird die Ausführung des Projekts angehalten. Wenn der Wert auf True gesetzt ist, wird die Ausführung des Projekts ungeachtet eines Fehlers 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 – Gibt die Zeit zwischen den einzelnen Wiederholungen an.

Beispiel zur Verwendung der Aktivität Retry Scope in Windows-Projekten

Die Aktivität Retry Scope wird verwendet, um einen Fehler abzufangen und zu behandeln. Daher ähnelt er Try Catch.

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 stoppen:

• Wenn der Wert der Zufallsvariable dreimal hintereinander von Null 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 zweite Nachricht ist diejenige, die Sie in der Aktivität Throw hinzugefügt haben.

• Wenn der Wert der Zufälligen Variablen Null 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.

1. Erstellen Sie eine neue Sequenz und fügen Sie die Aktivität Wiederholungsumfang (Retry Scope) hinzu.
2. Legen Sie im Eigenschaftenbereich den Wert 3 für die Anzahl der Wiederholungen und den Wert 5 für Wiederholungsintervall fest. Das bedeutet, dass wir versuchen, das Notepad-Fenster dreimal zu öffnen und das Intervall zwischen den Versuchen fünf Sekunden beträgt.
3. Fügen Sie im Abschnitt Action eine Assign-Aktion hinzu:
   1. Erstellen Sie im Feld Speichern in der Aktivität Assign eine Variable und nennen Sie sie „Random“.

   2. Schreiben Sie in das Feld Zu speichernder Wert den folgenden Ausdruck:

      (Now.Millisecond Mod 5).ToString()

      
4. Fügen Sie im Abschnitt Action eine If-Aktivität hinzu.
   1. Fügen Sie im Feld Bedingung den folgenden Ausdruck hinzu, wobei „Random“ die zuvor erstellte Variable ist. Der Ausdruck überprüft, ob der Variablenwert sich von Null unterscheidet:

      Random <> "0"

   2. Im Abschnitt Then der Aktivität If:
      • Fügen Sie eine Message box-Aktivität mit folgendem Text hinzu: „Editor-Fenster konnte nicht gestartet werden“.
      • Fügen Sie unter Message box eine Aktivität Throw hinzu und geben Sie folgenden Ausdruck im Feld Ausnahme ein:

        New System.Exception(“Notepad failed to start”)

        Diese Aktivitäten werden ausgeführt, wenn die Bedingung „true“ ist.

      

   3. Im Abschnitt Else der If-Aktivität:

      • Fügen Sie eine Open Application-Aktivität hinzu und geben Sie die Editor-Anwendung auf dem Bildschirm an. Stellen Sie sicher, dass das Feld DateiName den vollständigen Pfad zur ausführbaren Editor-Datei auf Ihrem Gerät enthält.

        Diese Aktivität wird ausgeführt, wenn die Bedingung False ist.

      

5. Um die Schleife zu beenden, fügen Sie im Abschnitt Bedingung der Aktivität Retry Scope eine Check App State-Aktivität hinzu und geben Sie das Editor-Fenster an.