Évaluation de l’erreur d’action

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 4 minutes de lecture
  • Activez les actions pour intercepter les échecs d’étape et continuer à les exécuter. Identifiez quand des conditions d’erreur spécifiques se produisent et renvoyez votre propre code d’état de l’action, votre message d’état et votre état d’erreur.

    Avantages

    Activez l’évaluation des erreurs d’action pour bénéficier de ces avantages.
    • Interceptez les échecs d’étape et autorisez la poursuite de l’exécution d’une action. Spécifiez le comportement d’échec de chaque étape que vous ajoutez à une action.
    • Créez vos propres conditions d’erreur. Spécifiez quand une action renvoie un état d’erreur, ainsi que les codes d’état et les messages qu’ils renvoient.
    • Fournissez plus d’informations et d’options sur la gestion des erreurs aux concepteurs de flux. Utilisez vos propres codes et messages d’état d’action pour identifier les problèmes et fournir des détails sur les actions correctives.

    Composants de l’étape d’évaluation des erreurs d’action

    Chaque étape propose ces composants d’évaluation des erreurs.

    Figure 1. Composants de l’étape d’évaluation des erreurs
    Exemple d’étape configuré pour Ne pas arrêter l’action et passer à l’étape suivante si cette étape échoue.
    1. Option en cas d’échec de cette étape
    Option permettant de continuer à exécuter l’étape suivante ou d’accéder à l’évaluation des erreurs. Cette option n’a aucun effet sur l’état de l’étape.
    2. État de l’étape
    Pastille de données d’objet contenant des détails d’exécution sur l’étape. Chaque étape d’une action renvoie un état d’étape.
    3. Code de > d’état de l’étape
    Pilule de données de nombre entier indiquant si l’étape a produit une erreur. Une étape renvoie une valeur de 1 lorsqu’elle génère une erreur pour une raison quelconque. Par exemple, une étape peut générer une erreur si elle n’a pas de données d’entrée obligatoires ou si elle renvoie une sortie dans un type de données incorrect. Une étape renvoie la valeur 0 lorsqu’elle s’exécute correctement. Vous ne pouvez pas personnaliser ces codes.
    4. Message >'état de l’étape
    Pilule de données de chaîne contenant le message d’erreur produit par l’opération de l’étape ou du système. Vous ne pouvez pas personnaliser le message d’état de l’étape.

    Composants de configuration de l’évaluation des erreurs d’action

    L’évaluation des erreurs d’action se compose des composants de configuration suivants.

    Figure 2. Composants de configuration de l’évaluation des erreurs
    Exemple de section d’évaluation d’erreur avec une condition d’erreur. L’exemple de condition d’erreur renvoie un code d’état d’action de 100 et un message d’état d’action indiquant qu’aucune tâche d’incident n’a été créée.
    5. Section d’évaluation des erreurs
    Section contenant les conditions d’erreur possibles. Lorsqu’une action s’exécute, elle évalue les conditions d’erreur disponibles de haut en bas en recherchant une correspondance possible. Une action renvoie l’état de l’action spécifié par la première condition d’erreur correspondante. S’il n’y a pas de condition d’erreur correspondante, l’état de l’action est défini sur l’état de la dernière étape exécutée.
    Remarque :
    Les actions de flux de données n’ont pas de section d’évaluation des erreurs.
    6. Ajouter une option de condition d’erreur
    Option permettant d’ajouter une condition d’erreur. Chaque condition d’erreur est équivalente à un bloc de logique de flux else if. Une seule condition d’erreur peut être vraie à la fois.
    7. Configuration de la condition d’erreur
    Options disponibles pour configurer une condition d’erreur.
    • Étiquette que vous souhaitez utiliser pour identifier cette condition d’erreur
    • Conditions qui doivent être remplies pour correspondre à cette condition d’erreur
    • État d’erreur dans lequel vous souhaitez que l’action revienne au flux
    • Code de statut de l’action auquel vous souhaitez que l’action revienne dans le flux
    • Statut de l’action Message indiquant que l’action doit revenir au flux
    8. Statut de l’action
    Pastille de données d’objet contenant des détails d’exécution sur l’action. Une action renvoie toujours un statut de l’action.
    9. Code > du statut de l’action
    Pilule de données de nombre entier contenant le code renvoyé par la première condition d’erreur correspondante ou par la dernière exécution d’étape. Vous pouvez renvoyer votre propre code lorsque vous créez une condition d’erreur personnalisée.
    10. Statut de l’action Message >
    Pilule de données de chaîne contenant le message produit par une condition d’erreur correspondante ou par l’exécution de la dernière étape. Vous pouvez renvoyer votre propre message lorsque vous créez une condition d’erreur personnalisée.

    Lignes directrices générales

    Suivez ces instructions pour bénéficier des avantages offerts par l’évaluation des erreurs d’action.

    Autoriser uniquement les étapes indépendantes à continuer à s’exécuter
    Autoriser une étape à continuer à s’exécuter si elle ne renvoie pas les données requises par une étape ultérieure. Si une étape fournit les données nécessaires pour les étapes ultérieures, vous savez que les étapes ultérieures ne peuvent pas s’exécuter correctement.
    Éviter plus de 10 conditions d’erreur
    Bien qu’il n’y ait pas de limite au nombre de conditions d’erreur que vous pouvez créer, chaque condition d’erreur nécessite une évaluation. Plus votre action doit évaluer de conditions d’erreur, plus son exécution peut être lente.
    Identifier les échecs d’étapes spécifiques
    Vous pouvez utiliser l’état de l’étape pour identifier l’échec d’une étape spécifique. L’identification d’une étape spécifique peut être utile lorsque votre action contient plusieurs instances du même type d’étape. Vous pouvez également identifier une étape spécifique afin qu’un gestionnaire d’erreurs de flux puisse prendre des mesures correctives spécifiques pour la défaillance.
    Placer les conditions d’erreur spécifiques avant les conditions d’erreur générales
    L’évaluation de l’erreur s’arrête lorsque l’action trouve une condition d’erreur correspondante. Donner la priorité aux conditions d’erreur générales peut empêcher l’action de correspondre à des conditions d’erreur spécifiques.
    Utiliser des étiquettes de condition d’erreur descriptive
    Identifiez une condition d’erreur sans avoir à la modifier. Par défaut, vous ne pouvez voir que les conditions d’erreur lorsque vous les modifiez.