Évaluation des erreurs d’action

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 4 minutes de lecture
  • Activez les actions pour intercepter les défaillances d’étapes et continuer l’exécution. Identifiez quand des conditions d’erreur spécifiques se produisent et renvoyez votre propre code de statut 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 une action à continuer à s’exécuter. 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 de statut de l’action pour identifier les problèmes et fournir des détails pour les actions correctives.

    Composants de l’étape d’évaluation de l’erreur d’action

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

    Figure 1. Composants de l’étape d’évaluation de l’erreur
    Exemple d’étape configurée sur 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
    Pastille 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. Statut de l’étape > code
    Pastille de données d’entier indiquant si l’étape a généré 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 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 une valeur de 0 lorsqu’elle s’exécute correctement. Vous ne pouvez pas personnaliser ces codes.
    4. Statut de l’étape > message
    Pastille 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 se compose de ces composants de configuration.

    Figure 2. Composants de configuration de l’évaluation des erreurs
    Exemple d’erreur Section d’évaluation avec une condition d’erreur. L’exemple de condition d’erreur renvoie un code de statut de l’action de 100 et un message de statut de l’action indiquant 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. S’il n’y a aucune condition d’erreur correspondante, le statut 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 comportent une section d’évaluation des erreurs pour les étapes REST, SOAP et JDBC. Pour en savoir plus, voir .
    6. Ajouter une option de condition d’erreur
    Option permettant d’ajouter une condition d’erreur. Chaque condition d’erreur équivaut à un bloc de logique de flux else if. Une seule condition d’erreur peut être vraie à la fois.
    7. Configuration des conditions 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 pour lequel vous souhaitez que l’action revienne au flux
    • Message de statut de l’action vous souhaitez que l’action revienne au flux
    8. Statut de l’action
    Pastille de données d’objet contenant les détails d’exécution de l’action. Une action renvoie toujours un statut de l’action.
    9. Statut de l’action > code
    Pastille de données d’entier contenant le code renvoyé par la première condition d’erreur correspondante ou la dernière étape exécutée. Vous pouvez renvoyer votre propre code lorsque vous créez une condition d’erreur personnalisée.
    10. Statut de l’action > message
    Pastille de données de chaîne contenant le message produit par une condition d’erreur correspondante ou la dernière étape exécutée. 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 tirer parti des avantages offerts par l’évaluation des erreurs d’action.

    Autoriser uniquement les étapes indépendantes pour continuer l’exécution
    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 votre exécution peut être lente.
    Identifier les défaillances 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. 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 les conditions d’erreur que lorsque vous les modifiez.