Gestionnaire global d'exceptions

Le Gestionnaire global d'exceptions (Global Exception Handler) est un type de workflow conçu pour déterminer le comportement du projet lorsque vous rencontrez une erreur d'exécution. Seul un Gestionnaire global d'exceptions (Global Exception Handler) peut être défini par projet d'automatisation.

Remarque : le Global Exception Handler n'est pas disponible pour les projets de bibliothèques, uniquement les processus.

Le Gestionnaire global d'exceptions (Global Exception Handler) comprend deux arguments, qui ne doivent pas être supprimés.

Le premier argument est errorInfo avec la direction Entrée (In) et il stocke les informations sur l'erreur générée et le workflow qui a échoué. Le niveau d'erreur à consigner peut être défini dans l'activité Log Message.

Remarque : utilisez la propriété ActivityInfo de errorInfo pour obtenir le nom de l'activité qui a levé l'exception et affichez-la dans le panneau Sortie (Output).

Le deuxième argument, result, a la direction de sortie (Out) et est utilisé pour déterminer le prochain comportement du processus lorsqu'il rencontre une erreur. Les valeurs suivantes peuvent être affectées à l'argument result :

• Continuer (Continue) : l'exception est levée à nouveau.
• Ignorer (Ignore) : l'exception est ignorée et l'exécution passe à l'activité suivante.
• Nouvelle tentative (Retry ) : l'activité qui a généré l'exception est retentée. Utilisez la méthode RetryCount pour errorInfo afin de compter le nombre de nouvelles tentatives de l'activité.

• Abandonner (Abort) : l'exécution s'arrête après l'exécution du Gestionnaire global d'exceptions (Global Exception Handler) actuel.

  Remarque : tout workflow peut être marqué comme Global Exception Handler dans Studio, sauf pour les projets de bibliothèques et Main.xaml.

Pour contrôler le comportement du workflow en cas d'erreur, le Gestionnaire global d'exceptions (Global Exception Handler) retente l'activité trois fois, puis abandonne avec un message d'erreur.

Traitement des erreurs lors du débogage

Lorsqu'une exception est détectée lors du débogage, l'activité défaillante est mise en surbrillance, l'exécution est suspendue et le type et les détails de l'exception sont mentionnés dans les panneaux Variables locales (Locals) et Pile d'appels (Call Stack).

Desactions de débogage telles que Continuer(Continue), Arrêter(Stop), Réessayer(Retry), Ignorer(Ignore), Redémarrer (Restart) et Pas à pas lent ( Slow Step ) sont disponibles dans le ruban. Ignorer (Ignore) permet de poursuivre l'exécution à partir de l'activité suivante.

Le bouton Nouvelle tentative (Retry) tente à nouveau d'exécuter l'activité en cours, sans que le Global Exception Handler n'intervienne. L'action Continuer (Continue) exécute le gestionnaire d'exception global, en tenant compte des valeurs précédemment choisies pour l'argument result, soit Continuer (Continue), Ignorer (Ignore), Nouvelle tentative (Retry) ou Abandonner (Abort).

Remarque :

Lorsque vous utilisez le Gestionnaire global d'exceptions (Global Exception Handler) avec un projet qui comprend une activité Try Catch, veillez à regrouper les activités dans une Séquence (Sequence) à l'intérieur du conteneur Try. Sinon, le Gestionnaire global d'exceptions (Global Exception Handler) ne s'exécute pas.

Dans le cas d'activités imbriquées, le Gestionnaire global d'exceptions (Global Exception Handler) s'exécute pour chaque activité de la pile d'appels. En revanche, il n'exécute pas d'activités directement encapsulées dans Try Catch, sauf si elles sont contenues dans une activité.

Exemple d'utilisation du Gestionnaire global d'exceptions

L'exemple suivant montre le comportement du projet lorsqu'une exception est levée lors de l'exécution.

Le projet d'automatisation est configuré pour saisir du texte dans un fichier .txt, puis pour fermer l'application, mais pas avant que le fichier n'ait été enregistré.

Création du workflow

1. Créez un processus vierge (Blank Process) en suivant les étapes de la page Création d'un processus de base.
2. Ouvrez le Bloc-notes et enregistrez un document sur votre machine. Vous pouvez nommer le fichier 1.txt.
3. Dans le panneau Activités (Activities), recherchez l'activité Utiliser l'application/le navigateur (Use Application/Browser) et faites-la glisser vers le panneau Concepteur (Designer).
4. Dans « Utiliser l'application/le navigateur :

   • Cliquez sur Indiquer l'application à automatiser (Indicate application to automate), puis déplacez le pointeur de la souris sur la fenêtre Bloc-notes. Lorsque la fenêtre est mise en surbrillance, cliquez n’importe où dedans.

     L'activité Utiliser l'application/le navigateur est mise à jour, le chemin d'accès est ajouté au champ Chemin d'accès à l'application (Application path) et une capture d'écran de la fenêtre apparaît à l'intérieur de l'activité.

   • Dans le panneau Propriétés (Properties), sélectionnez l'option Toujours (Always) pour la propriété Fermer (Close). Cela permet de garantir que le Bloc-notes est fermé après l'exécution de l'automatisation.
5. Ajoutez une activité Saisir dans (Type Into) dans le conteneur Faire (Do) de l'activité Utiliser l'application/le navigateur (Use Application/Browser). Cliquez sur Indiquer dans l'application (Indicate in App) pour sélectionner la fenêtre du Bloc-notes et ajoutez un texte entre guillemets dans le champ Tapez ceci (Type this). Cette activité écrit le texte dans le Bloc-notes.
6. Dans le panneau Activités (Activities), ajoutez une activité Raccourcis clavier (Keyboard Shortcuts) au workflow. Indiquez la fenêtre du Bloc-notes, puis sélectionnez Enregistrer le raccourci (Record Shortcut) et appuyez sur Ctrl + S pour enregistrer la combinaison de touches qui permet d'enregistrer le fichier après la saisie du texte.

   Le workflow final doit ressembler à ceci :

   
   

   

   
   

Ajout d'un Gestionnaire global d'exceptions

1. Dans l'onglet Conception (Design) faisant partie du Ruban (Ribbon), sélectionnez Nouveau (New) > Gestionnaire global (Global Handler). La fenêtre Nouveau gestionnaire global (New Global Handler) s'ouvre. Entrez un Nom (Name) pour le gestionnaire et enregistrez-le dans le chemin du projet. Cliquez sur Créer (Create), un Gestionnaire global d'exceptions (Global Exception Handler) est ajouté au projet d'automatisation.
   
   

   

   
   
2. Revenez au workflow que vous avez créé précédemment et modifiez-le pour qu'une activité ne puisse pas s'exécuter. Par exemple, dans l'activité Utiliser l'application/le navigateur, sélectionnez l'option Correspondance exacte avec le titre (Match exact title) et assurez-vous que le fichier soit bien fermé avant de cliquer sur Exécuter le fichier (Run File) dans le ruban.

Lorsque le Gestionnaire global d'exceptions (Global Exception Handler) rencontre une exception, il consigne le nom de l'activité défaillante et commence à relancer l'activité trois fois. S'il rencontre la même exception chaque fois et que le nombre de nouvelles tentatives atteint 3, l'exécution est abandonnée au niveau de l'activité qui a lancé l'exception.

Si lors de nouvelles tentatives, une exception est rencontrée, l'exécution du workflow continue et le Gestionnaire global d'exceptions (Global Exception Handler) n'intervient pas.

Téléchargez l'exemple