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:

• Die Aktivitäten und Retry Scope werden nicht unterstützt und funktionieren nicht ordnungsgemäß, wenn sie im Hauptworkflow eines Orchestrierungsprozesses verwendet werden. In solchen Fällen sollten sie in eine No Persist Scope- Aktivität gesetzt werden.

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 wird 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 wird 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 Wiederholungsumfang (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 eine Aktivität Zuweisen ( Assign ) im Abschnitt Zuweisen ( Assign ) 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 eine If -Aktivität im Abschnitt Action 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 Dann (Then) der Aktivität Wenn (If):
      • Fügen Sie eine Aktivität Meldungsfeld ( Message box ) mit folgendem Text hinzu: „Editor-Fenster konnte nicht gestartet werden“.
      • Fügen Sie unter Nachrichtenbox ( Message box) eine Aktivität Werfen ( Throw ) hinzu und geben Sie folgenden Ausdruck im Feld Ausnahme ( Exception ) ein:

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

        Diese Aktivitäten werden ausgeführt, wenn die Bedingung erfüllt ist.

      

   3. Im Abschnitt Sonst ( Else ) der Aktivität Wenn (If):

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

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

      

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