Gestionnaire des erreurs de flux

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 5 minutes de lecture

    • Activer les flux pour intercepter les erreurs. Exécutez une séquence d’actions et de flux secondaires pour identifier et corriger les problèmes. Par exemple, demander aux flux de consigner les valeurs de sortie, envoyer des notifications et exécuter des flux secondaires correctifs lorsqu’ils génèrent une erreur.

    Avantages

    Activez un gestionnaire des erreurs de flux pour bénéficier de ces avantages.
    • Automatisez l’identification des erreurs de flux au fur et à mesure qu’elles se produisent. Capturez et transmettez par push les informations sur les erreurs de flux plutôt que de rechercher manuellement les problèmes causés par des erreurs de flux.
    • Automatisez la résolution des erreurs de flux. Exécutez des actions et des flux secondaires pour mettre à jour les enregistrements plutôt que de mettre à jour manuellement les enregistrements affectés par des erreurs de flux.
    • Créez votre propre logique de gestion des erreurs d’action. Spécifiez quand les actions renvoient une erreur plutôt que de toujours renvoyer une erreur.

    Composants du gestionnaire des erreurs

    Figure 1. Composants de l’interface utilisateur du gestionnaire des erreurs
    Exemple de flux avec gestionnaire des erreurs activé. La section Gestionnaire des erreurs comporte les actions Consigner et Envoyer un e-mail.
    La gestion des erreurs de flux se compose de ces composants.
    1. Commutateur de gestionnaire d’erreurs
    Option permettant d’activer ou de désactiver la gestion des erreurs de flux. Lorsqu’il est activé, le flux affiche la section Gestionnaire des erreurs.
    2. Section Gestionnaire des erreurs
    Section du flux qui s’exécute lorsque le flux détecte une erreur. Utilisez cette section pour automatiser l’identification et la résolution des erreurs de flux. Vous pouvez ajouter jusqu’à 10 éléments dans cette section.
    Remarque :
    La limite de 10 éléments comprend toute combinaison d’actions, de logique de flux ou de flux secondaires.
    3. État de l’erreur
    Pilule de données d’objet contenant des détails sur l’erreur détectée par le flux.
    4. Code de > d’état d’erreur
    Pastille de données entière indiquant si le flux a produit une erreur. Par défaut, une valeur de 1 indique que le flux a produit une erreur. La valeur 0 indique que le flux s’est exécuté avec succès. Vous pouvez définir vos propres codes d’erreur lorsque vous créez une action personnalisée.
    5. Statut d’erreur > message
    Pilule de données de chaîne contenant le message d’erreur produit par l’action, l’étape ou l’opération système.

    États d’erreur disponibles

    L’activation du gestionnaire des erreurs modifie les états signalés dans les détails d’exécution du flux. Le gestionnaire des erreurs peut produire ces états de flux.

    Terminé (erreur détectée)
    État généré lorsque le flux a détecté une erreur et exécuté avec succès les éléments de la section Gestionnaire d’événements. Le flux génère cet état même lorsque la section Gestionnaire d’événements est vide. Cet état n’est disponible que lorsque vous activez un gestionnaire des erreurs de flux. Cet état n’est visible que sur la page des détails de l’exécution du flux. Les enregistrements de contexte de flux affichent plutôt l’état comme Terminé.
    Terminé (erreur ignorée)
    État généré lorsqu’une action personnalisée continue de s’exécuter après l’échec d’une étape. Lorsqu’une action génère cet état, elle le transmet au flux parent. Cet état n’est disponible que lorsque vous activez un gestionnaire des erreurs de flux. Cet état n’est visible que sur la page des détails de l’exécution du flux. Les enregistrements de contexte de flux affichent plutôt l’état comme Terminé.
    Erreur
    État généré lorsqu’une erreur n’est pas détectée.
    • Une erreur se produit dans le flux alors que le gestionnaire d’erreurs est désactivé
    • Une erreur se produit dans la section Gestionnaire des erreurs

    Lorsqu’une erreur se produit

    Lorsqu’une erreur se produit dans un flux avec un gestionnaire d’erreurs actif, le flux arrête d’exécuter d’autres actions et une logique de flux et exécute à la place les éléments de la section gestionnaire d’erreurs. Si les éléments de la section du gestionnaire d’erreurs s’exécutent, le flux s’arrête avec l’état Terminé (erreur détectée). Si le gestionnaire d’erreurs génère lui-même une erreur, le flux s’arrête avec l’état Erreur.

    Un flux ne peut pas réexécuter les éléments qui génèrent une erreur ou reprendre à partir de l’étape qui a généré une erreur. Vous pouvez utiliser Essayer la logique de flux pour continuer à exécuter un flux qui rencontre des erreurs dans le bloc d’essai.

    Ressources de gestion des erreurs de flux et d’action

    Pour plus d’informations sur l’utilisation de la gestion des erreurs dans les actions et les flux, consultez la publication de la communauté Vue d’ensemble de la gestion des erreurs de flux et d’action : pourquoi et comment tester les erreurs - Worfklow Automation CoE.ServiceNow®

    Directives générales

    Suivez ces instructions générales pour bénéficier des avantages offerts par la gestion des erreurs de flux.

    Éviter d’ajouter des éléments de gestion des erreurs à la section principale du flux
    Un flux s’arrête normalement lorsqu’une action ou un flux secondaire renvoie une erreur dans la section principale. Un flux arrêté ne peut pas exécuter d’actions ou de flux secondaires au-delà du point où il a renvoyé une erreur. L’ajout d’actions et de flux secondaires de gestion des erreurs à la section Gestionnaire d’erreurs garantit qu’ils les exécutent en cas d’erreur.
    Informations sur l’état de l’erreur de capture
    L’objet État de l’erreur contient des informations sur l’action qui a produit une erreur. Vous pouvez utiliser ces informations pour identifier la cause de l’erreur ainsi que pour enregistrer les données qui peuvent nécessiter une correction.
    Supprimer les messages d’erreur de flux secondaire
    Vous pouvez activer le gestionnaire des erreurs pour un flux secondaire afin d’éviter que ses erreurs ne se répercutent en cascade vers un flux parent. Si vous laissez la section Gestionnaire d’erreurs du flux secondaire vide, vous vous assurez qu’il génère toujours l’état Terminé (erreur détectée).
    Utiliser des flux secondaires pour éviter la limite de 10 éléments
    Plutôt que de forcer votre processus de gestion des erreurs à tenir dans une limite de 10 éléments, appelez des flux secondaires, qui peuvent contenir beaucoup plus d’éléments. Vous pouvez également utiliser les sorties de flux secondaire pour déclencher l’automatisation dans d’autres flux.
    Utiliser des flux secondaires pour prendre des mesures correctives
    Plutôt que de recréer la même séquence d’actions dans plusieurs flux, créez des flux secondaires réutilisables pour corriger les erreurs dans vos données d’enregistrement. Lorsqu’une erreur de flux laisse vos données d’enregistrement dans un état indésirable, utilisez des flux secondaires pour corriger ces enregistrements. Vous pouvez utiliser le gestionnaire des erreurs pour identifier ces données d’enregistrement en tant que sortie de flux secondaire.