Gestionnaire des erreurs de flux

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 4 minutes de lecture
  • Permettre aux flux de détecter les erreurs. Exécutez une séquence d’actions et de flux secondaires pour identifier et corriger les problèmes. Par exemple, faire en sorte que les flux consignent les valeurs de sortie, envoient des notifications et exécutent des flux secondaires correctifs lorsqu’ils génèrent une erreur.

    Avantages

    Activez un gestionnaire d’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 les informations d’erreur 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 les 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. Gestionnaire des erreurs Composants de l’interface utilisateur
    Exemple de flux avec gestionnaire d’erreurs activé. La section Gestionnaire des erreurs contient les actions Consigner et Envoyer un e-mail.
    La gestion des erreurs de flux comprend les composants suivants.
    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 inclut toute combinaison d’actions, de logique de flux ou de flux secondaires.
    3. État de l’erreur
    Pastille de données d’objet contenant des détails sur l’erreur interceptée par le flux.
    4. Code > d’état de l’erreur
    Pilule de données de nombre entier 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 correctement exécuté. Vous pouvez définir vos propres codes d’erreur lorsque vous créez une action personnalisée.
    5. Message >'état de l’erreur
    Pilule de données de chaîne contenant le message d’erreur produit par l’action, l’étape ou le fonctionnement du système.

    États d’erreur disponibles

    L’activation du gestionnaire d’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 intercepté une erreur et a 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 est uniquement disponible lorsque vous activez un gestionnaire d’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 est uniquement disponible lorsque vous activez un gestionnaire d’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’a pas été détectée.
    • Une erreur se produit dans le flux lorsque le gestionnaire des 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 de gestion des erreurs. Si les éléments de la section de gestionnaire d’erreurs s’exécutent, le flux s’arrête à 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 à l’état Erreur.

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

    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 lorsque l’exécution d’une action ou d’un flux secondaire renvoie une erreur dans la section principale. Un flux arrêté ne peut exécuter aucune action ni aucun flux secondaire au-delà du point où il a renvoyé une erreur. L’ajout d’actions de gestion des erreurs et de flux secondaires à la section Gestionnaire des erreurs garantit qu’ils les exécutent en cas d’erreur.
    Capturer les informations sur l’état des erreurs
    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 et enregistrer les données qui peuvent nécessiter une correction.
    Supprimer les messages d’erreur de flux secondaire
    Vous pouvez activer le gestionnaire d’erreurs pour un flux secondaire afin d’éviter que ses erreurs ne se répercutent en cascade sur un flux parent. Si vous laissez vide la section Gestionnaire des erreurs du flux secondaire, vous vous assurez qu’elle 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 à s’adapter à 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 d’erreurs pour identifier ces données d’enregistrement comme une sortie de flux secondaire.