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 Gestionnaire global d'exceptions (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 second argument, result comprend la direction Sortie (Out) et il est utilisé pour déterminer le comportement suivant 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.
• Réessayer (Retry) : l'activité qui a levé l'exception est retentée. Utilisez la méthode RetryCount de errorInfo pour 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 un Global Exception Handler dans Studio, à l'exception des projets de bibliothèque et de 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).

Des actions de débogage telles que Continuer, Arrêter, Réessayer, Ignorer, Redémarrer et Étape lente sont disponibles dans le ruban.Ignorer est utilisé pour poursuivre l'exécution à partir de l'activité suivante.

Le bouton Réessayer (Retry) réessaie d'exécuter l'activité actuelle sans l'intervention du Gestionnaire global d'exceptions. L'action Continuer (Continue) exécute le Gestionnaire global d'exceptions et prend en compte les valeurs auparavant choisies pour l'argument result, Continuer (Continue), Ignorer (Ignore), Réessayer (Retry) ou Abandonner (Abort).

Remarque :

Lorsque vous utilisez le Global Exception Handler avec un projet qui inclut Essayer/Capturer, veillez à regrouper les activités dans une Sequence à l'intérieur du conteneur Essayer.Sinon, le 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 vide 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 (Type Into) dans le conteneur Faire (Do) de l'activité Utiliser l'application/le navigateur. Cliquez sur Indiquer dans l'application pour sélectionner la fenêtre Bloc-notes et ajoutez/entrez un Text entre guillemets dans le champ Saisir cela.Cette activité écrit le texte dans le Bloc-notes.
6. Dans le panneau Activités, ajoutez une activité Raccourcis clavier au workflow. Indiquez la fenêtre Bloc-notes, puis sélectionnez Enregistrer le raccourci et appuyez sur Ctrl + S pour enregistrer la combinaison de touches qui enregistre le fichier après la saisie du Text.

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