Évaluation des erreurs d’action
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.
- 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.
- 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
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 ServiceNow®gestion des erreurs de flux et d’actions : pourquoi et comment tester les erreurs - CoE d’automatisation Worfklow.
- Gestion des erreurs de flux et d’action Niveau 1 : nouvelle tentative et action Évaluation des erreurs : CoE de l’automatisation du workflow
- Gestion des erreurs de flux et d’action Niveau 2 : Logique de flux : CoE d’automatisation des workflows
- Gestion des erreurs de flux et d’action Niveau 3 : Gestion des erreurs de flux : CoE d’automatisation du workflow
- Gestion des erreurs de flux et d’action Niveau 4 : bonnes pratiques et résumé : CoE de l’automatisation des workflows
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.