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.

The Global Exception Handler has two arguments, that should not be removed.

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.

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).

Debugging actions like Continue, Stop, Retry, Ignore, Restart and Slow Step are available in the ribbon. Ignore is used for continuing the execution from the next activity.

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 défini pour cliquer à l'intérieur d'un document Bloc-notes vide et enregistré, taper du texte et fermer l'application, mais pas avant de cliquer sur le bouton Enregistrer pour l'enregistrer.

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.

Création du workflow

1. Create a Blank Process by following the steps in the Creating a Basic Process page.

2. Ouvrez Bloc-notes et enregistrez un document sur votre machine.

3. From the Activities panel, drag a Type Into activity to the Designer panel. The activity is automatically added to a Sequence.

4. Dans l'activité Type Into, cliquez sur Indiquer à l'écran (Indicate on screen). Studio réduit et permet de cliquer à l'intérieur de la fenêtre Bloc-notes pour créer le sélecteur. Dans le champ de texte, entrez le texte souhaité entre guillemets.

5. From the Activities panel, add a Send Hotkey activity to the workflow. Indicate the Notepad window, and select Ctrl from the activity, type in s in the Key field. This saves the Notepad document after the text was typed in.

6. From the Activities panel, add a Close Application activity to the workflow. Indicate the Notepad window using Indicate on screen. The resulted workflow should look like this:

   

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. Dans l'onglet Variables (Variables), créez une variable Int32 nommée retryCount, définissez son étendue sur le Gestionnaire global d'exceptions (Global Exception Handler) entier, laissez le champ de valeur Par défaut (Default) vide. La variable stocke le nombre de nouvelles tentatives et augmente le nombre de 1 chaque fois qu'une erreur se produit.

3. Créez une variable String nommée failedActivity et définit son étendue sur le workflow entier. Cette variable stocke le nom de l'activité défaillante et la désigne dans le panneau Sortie (Output).

4. From the Activities panel, add an Assign activity below the Log Error in the Global Handler sequence. Add the retryCount to the activity and assign it the errorInfo.RetryCount expression, which counts the number of times the exception is thrown.

5. Ajoutez une autre activité Assign dans laquelle affecter l'expression errorInfo.ActivityInfo.Name à la variable failedActivity. À ce stade, le workflow doit ressembler à ceci :

   

6. Add an If activity to the workflow. Set the Condition to retryCount < 3 to limit the number of retries to 3.

7. Dans l'élément activité Assign de la catégorie Then, affectez ErrorAction.Retry à la variable result pour que le Gestionnaire global d'exceptions (Global Exception Handler) retente l'activité qui a levé l'exception.

8. Dans la catégorie Else, affectez ErrorAction.Abort à result pour que le Gestionnaire global d'exceptions (Global Exception Handler) abandonne l'exécution lorsque la condition est remplie. L'activité If doit ressembler à ceci :

   

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 d'une nouvelle tentative, 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