Évaluation de l’erreur d’action

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 4 minutes de lecture
  • Activez les actions pour intercepter les défaillances d’étapes et continuer à s’exécuter. Identifiez quand des conditions d’erreur spécifiques se produisent et renvoyez votre propre code d’état de l’action, message d’état et état d’erreur.

    Avantages

    Activez l’évaluation des erreurs d’action pour bénéficier de ces avantages.
    • Interceptez les défaillances d’étape et autorisez 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’elle renvoie.
    • Fournir plus d’informations et d’options sur la gestion des erreurs aux concepteurs de flux. Utilisez vos propres codes et messages d’état de l’action pour identifier les problèmes et fournir les détails des actions correctives.

    Composants d’étapes d’évaluation des erreurs d’action

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

    Figure 1. Composants de l’étape d’évaluation de l’erreur
    Exemple d’étape configurée pour N’arrêtez pas l’action et passez à 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
    Pilule de données d’objet contenant les détails d’exécution de l’étape. Chaque étape d’une action renvoie un état d’étape.
    3. Code de > d’état de l’étape
    Pastille de données entière indiquant si l’étape a produit une erreur. Une étape renvoie la valeur 1 lorsqu’elle génère une erreur pour une raison quelconque. Par exemple, une étape peut générer une erreur si des données d’entrée obligatoires sont manquantes ou si elle renvoie une sortie dans le mauvais type de données. Une étape renvoie la valeur 0 lorsqu’elle s’exécute avec succès. Vous ne pouvez pas personnaliser ces codes.
    4. État de l’étape > message
    Pilule de données de chaîne contenant le message d’erreur produit par l’étape ou l’opération 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 comprend ces composants de configuration.

    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 de l’action de 100 et un message d’état de l’action Aucune tâche d’incident 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 à la recherche d’une correspondance possible. Une action renvoie le statut de l’action spécifié par la première condition d’erreur correspondante. Si aucune condition d’erreur ne correspond, l’état de l’action est défini sur l’état d’étape de la dernière exécution d’étape.
    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 pour lequel vous souhaitez que l’action revienne au flux
    • Code de statut de l’action pour lequel vous souhaitez que l’action revienne au flux
    • Message de statut de l’action indiquant que vous souhaitez que l’action revienne au flux
    8. Statut de l’action
    Pilule de données d’objet contenant les détails d’exécution de l’action. Une action renvoie toujours un statut d’action.
    9. Statut de l’action > code
    Pilule de données de nombre entier contenant le code renvoyé par la première condition d’erreur correspondante ou l’exécution de la dernière é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 l’exécution de la dernière étape. Vous pouvez renvoyer votre propre message lorsque vous créez une condition d’erreur personnalisée.

    Ressources de gestion des erreurs de flux et d’action

    Directives générales

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

    Autoriser uniquement les étapes indépendantes à exécuter
    Autorisez 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 défaillances d’étapes spécifiques
    Vous pouvez utiliser l’état de l’étape pour identifier quand une étape spécifique échoue. 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 des 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 des erreurs s’arrête lorsque l’action trouve une condition d’erreur correspondante. Mettre les conditions d’erreur générales en premier 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.