É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é.

Important :

• Les activités Étendue de nouvelle tentative ( Retry Scope) ne sont pas prises en charge et ne fonctionnent pas correctement lorsqu'elles sont utilisées dans le workflow principal d'un processus d'orchestration. Dans de tels cas, elles doivent être placées dans une activité Étendue sans persistance (No Persist Scope) .

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

• Continuer en cas d'erreur (Continue On Error ) : précise si l’automatisation doit se poursuivre même si l’activité génère une erreur. Ce champ prend uniquement en charge les valeurs booléennes (Vrai (True), Faux (False)). La valeur par défaut est False. Par conséquent, si le champ est vide, une erreur est générée ou le nombre de nouvelles tentatives est dépassé, l’exécution du projet s’arrête. Si le champ indique au contraire True, l'exécution du projet se poursuit même en cas d'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.

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

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 ( Retry Interval ) - Spécifie la durée entre chaque nouvelle tentative.

Configuration multiplateforme

Module Designer

• Corps d'activité ( ActivityBody ) : 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.

Propriétés supplémentaires

• Continuer en cas d'erreur (Continue On Error ) : précise si l’automatisation doit se poursuivre même si l’activité génère une erreur. Ce champ prend uniquement en charge les valeurs booléennes (Vrai (True), Faux (False)). La valeur par défaut est False. Par conséquent, si le champ est vide, une erreur est générée ou le nombre de nouvelles tentatives est dépassé, l’exécution du projet s’arrête. Si le champ indique au contraire True, l'exécution du projet se poursuit même en cas d'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 ( Retry Interval ) - Spécifie la durée entre chaque nouvelle tentative.

Exemple d'utilisation de l'activité Retry Scope dans les projets Windows

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 :

• Si la valeur de la variable Aléatoire (Random) est différente de zéro trois fois dans une ligne, 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 ». Le deuxième message est celui que vous avez ajouté dans l’activité Lancer .

• Si la valeur de la variable Aléatoire est égale à zéro, le Robot ouvre le Bloc-notes ( Notepad ) et comme la condition de cette boucle est de trouver la fenêtre Bloc -notes (Notepad), le workflow se termine avec succès.

1. Créer une nouvelle séquence et ajouter l'activité Répéter la portée (Retry Scope).
2. Dans le panneau Propriétés , définissez la valeur 3 pour le Nombre de tentatives ( Number Of Retries) et définissez la valeur 5 pour Intervalle avant nouvelle tentative ( Retry Interval). Cela signifie que nous tentons d'ouvrir la fenêtre du Bloc-notes à trois reprises et que l'intervalle entre les tentatives est de cinq secondes.
3. Dans la section Action (Action), ajoutez une activité Affecter (Assign) :
   1. Dans le champ Enregistrer vers (Save to) de l’activité Affecter (Assign), créez une variable et nommez-la « Aléatoire ».

   2. Dans le champ Valeur à enregistrer ( Value to save ), écrivez l'expression suivante :

      (Now.Millisecond Mod 5).ToString()

      
4. Dans la section Action (Action), ajoutez une activité If .
   1. Dans le champ Condition , ajoutez l'expression suivante, où « Aléatoire » est la variable précédemment créée. L'expression vérifie si la valeur de la variable est différente de zéro :

      Random <> "0"

   2. Dans la section Puis (Then) de l'activité Si (If) :
      • Ajoutez une activité Message Box avec le texte suivant : « La fenêtre du Bloc-notes n'a pas pu démarrer ».
      • Dans la Zone de message ( Message Box), ajoutez une activité Lancer ( Throw ) et indiquez l'expression suivante dans le champ Exception :

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

        Ces activités s'exécutent lorsque la condition est vraie.

      

   3. Dans la section Autre ( Else ) de l'activité If :

      • Ajouter une activité Ouvrir l' application (Open Application ) et indiquer l'application Bloc-notes (Notepad) sur l'écran. Assurez-vous que le champ NomFichier contient le chemin complet du fichier exécutable Bloc-notes sur votre appareil.

        Cette activité s'exécute lorsque la condition est false.

      

5. Pour quitter la boucle, dans la section Condition de l'activité Étendue de nouvelle tentative ( Retry Scope ), ajoutez une activité Vérifier l'état de l'application (Check App State ) et indiquez la fenêtre du Bloc-notes.