Étendue de nouvelle tentative (Retry Scope)

UiPath.Core.Activities.RetryScope

Description

Relance les tentatives d'exécution des activités contenues tant que la condition n'est pas remplie ou qu'un message d'erreur n'est pas généré.

Cette activité ne fonctionne pas comme prévu dans le workflow principal d'un processus d'orchestration.

Compatibilité du projet

Windows - Héritage | Windows | Multiplate-forme

Windows - Héritage, configuration Windows

Module Designer

• Action : ajoutez les activités à réexécuter dans cette section.
• Condition : ajoutez une activité de condition dans cette section.

  Par exemple, pour échouer et réessayer correctement lors de l’indication d’un élément d’IU, vous pouvez utiliser l’activité Modern UI Automation Vérifier l’état de l’application (Check App State) ou son homologue Classic Élément existant (Element Exists) en tant que condition et réessayer d’ouvrir l’application et de trouver l’élément d’IU.

Panneau propriétés

Commun

• NomAffichage (DisplayName) - Nom affiché de l'activité.

• Continue On Error : indique si l'automatisation doit se poursuivre, même lorsque l'activité génère une erreur. Ce champ ne prend en charge que des valeurs booléennes (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et qu'une erreur est générée, l'exécution du projet s'arrête. Si la valeur est définie sur True, l'exécution du projet se poursuit indépendamment de toute erreur.

  Remarque : si cette activité est incluse dans l'activité Try Catch et que la valeur de la propriété ContinuerSurErreur est « True », aucune erreur ne sera détectée lors de l'exécution du projet.

Divers

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Options

• Nombre de tentatives (NumberOfRetries) - Nombre de tentatives de la séquence.
• Intervalle avant nouvelle tentative ( RetryInterval) - Spécifie la durée entre chaque nouvelle tentative.

Configuration multiplateforme

Module Designer

• Action : ajoutez les activités à réexécuter dans cette section.
• Condition : ajoutez une activité de condition dans cette section.

  Par exemple, pour échouer et réessayer correctement lors de l’indication d’un élément d’IU, vous pouvez utiliser l’activité Modern UI Automation Vérifier l’état de l’application (Check App State) comme condition et réessayer d’ouvrir l’application et de trouver l’élément d’IU.

Commun

• Continue On Error : indique si l'automatisation doit se poursuivre, même lorsque l'activité génère une erreur. Ce champ ne prend en charge que des valeurs booléennes (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et qu'une erreur est générée, l'exécution du projet s'arrête. Si la valeur est définie sur True, l'exécution du projet se poursuit indépendamment de toute erreur.

  Remarque : si cette activité est incluse dans l'activité Try Catch et que la valeur de la propriété ContinuerSurErreur est « True », aucune erreur ne sera détectée lors de l'exécution du projet.

Options

• Nombre de tentatives (NumberOfRetries) - Nombre de tentatives de la séquence.
• Intervalle avant nouvelle tentative ( RetryInterval) - Spécifie la durée entre chaque nouvelle tentative.

Exemple d'utilisation de l'activité Retry Scope

L’activité Retry Scope (Étendue de nouvelle tentative) est utilisée pour intercepter et gérer une erreur, c’est pourquoi elle est similaire à l’activité Try Catch. Le workflow suivant tente d'ouvrir la fenêtre du Bloc-notes à 3 reprises et utilise la condition définie dans l'activité Étendue de nouvelle tentative (Retry Scope) pour arrêter la boucle.

1. Créer une nouvelle séquence et ajouter l'activité Répéter la portée (Retry Scope).
2. Dans le volet Propriétés (Properties), conserver la valeur par défaut Nombre de tentatives (NumberOfRetries) de 3 et la valeur Intervalle avant nouvelle tentative (Retry Interval) de 5. Cela signifie que nous tentons d'ouvrir la fenêtre Bloc-notes 3 fois et que l'intervalle entre les tentatives est de 5 secondes.
3. Dans la section Action (Action), ajouter une activité Affecter (Assign).
4. Créer une variable Valeur générique (GenericValue), nommée par exemple Aléatoire (Random) et l'ajouter au champ À (To) de l'activité Affecter (Assign).
5. Ajouter la valeur Now.Millisecond mod 5 à la variable en l'ajoutant au champValeur (Value) de l'activité Affecter (Assign).
   
   

   

   
   
6. Ajoutez une activité If et saisissez Random <> 0comme condition. Cela signifie que vous vérifiez si votre variable est différente de 0.

7. Dans la section Puis (Then) de l'activité (la condition ci-dessus est true) :

   • Ajouter une Zone de message (Message Box) indiquant "Échec du démarrage de la fenêtre du bloc-notes" (Notepad Window failed to start).
   • Dans la Zone de message (Message Box), ajouter une activité Lancer (Throw) pour générer une erreur.
   • Taper New System.Exception(“Notepad failed to start”) dans le champ Exception (Exception) sous Propriétés (Properties).

8. Dans la section Autre (Else) de l'activité Si (If) (la condition ci-dessus est false) :

   • Ajouter une activité Ouvrir l'application (Open Application) et indiquer Bloc-notes (Notepad) sur l'écran. Indiquer le chemin d'accès complet du fichier exécutable Bloc-notes (Notepad) dans la partie Nom de fichier (FileName) du champ Propriétés (Properties).

     
     

     

     
     

9. Pour quitter la boucle, ajouter une activité Élément existant (Element Exists) dans la section Condition (Condition) de Répéter la portée (Retry Scope) et indiquer la fenêtre Bloc-notes.

   Si des activités Modern sont utilisées, l’activité Vérifier l’état de l’application (Check App State) peut être utilisée comme condition dans l’activité Étendue de nouvelle tentative (Retry Scope).

   
   

   

   
   

Ce workflow simule une fenêtre du Bloc-notes défaillante. Si la valeur de la variable Random est différente de 0 trois fois de suite, le message « Échec du démarrage de la fenêtre du Bloc-notes » s’affiche à chaque fois et l’ensemble du workflow échoue avec l’erreur « Échec du démarrage du Bloc-notes ». Ce dernier message est celui ajouté dans l’activité Lancer.

Si la valeur de la variable Random est 0, le Robot ouvre le Bloc-notes (Notepad) et comme la condition existante de cette boucle est de trouver la fenêtre Bloc-notes (Notepad), le workflow se termine avec succès.

Téléchargez l'exemple