Gestion des exceptions - Amazon Quick

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Gestion des exceptions

La gestion des exceptions vous permet de gérer les erreurs et les situations inattendues dans vos automatisations. Amazon Quick Automate fournit des fonctionnalités permettant de créer, de déclencher et de gérer les exceptions de manière appropriée afin de garantir une gestion robuste des erreurs et la continuité des processus.

Types d'exceptions

Amazon Quick Automate prend en charge deux types d'exceptions :

  • Exceptions commerciales : utilisées pour les erreurs attendues liées à des violations des règles de gestion, telles que :

    • Données requises manquantes

    • Valeurs d'entrée non valides

    • Violations des politiques

  • Exceptions système : utilisées pour des erreurs techniques ou d'infrastructure telles que :

    • Défaillances de connexion

    • Délais de service

    • Erreurs d’authentification

Actions

Soulever une exception

Interrompt le flux du processus avec une exception. Utilisé pour déclencher ou lancer une exception afin de mettre fin au processus ou de prendre des mesures spécifiques pour gérer le scénario d'exception. Si vous ne souhaitez pas mettre fin au processus immédiatement, ajoutez un flux d'exceptions à votre étape de processus pour gérer l'exception. Propriétés :

  • Titre (facultatif) - Nom de l'action affiché dans la visualisation du processus (par exemple, « Raise validation error »)

  • Créer une exception personnalisée (obligatoire) - Lorsque cette option est sélectionnée, créez une nouvelle exception avec des détails personnalisés. Lorsque cette option est désactivée, déclenchez ou relancez une exception existante stockée dans une variable

  • Type d'exception (obligatoire) - Catégorie de l'exception (par exemple, « Exception commerciale », « Exception système »)

  • Motif de l'exception (obligatoire) - Identifiant court utilisé pour classer les exceptions similaires à des fins de signalement (par exemple, « REQUIRED_FIELD_MISSING », « INVALID_FORMAT »)

  • Message d'exception (obligatoire) - Description détaillée qui vous aidera à résoudre les problèmes (par exemple, « L'adresse e-mail du client est requise mais n'est pas fournie »)

  • Exception à lever (obligatoire lorsque l'option Créer une exception personnalisée est désactivée) - L'exception que vous souhaitez déclencher ou relancer, généralement stockée sous forme de variable (par exemple, new_exception)

Créer une exception personnalisée

Crée une exception sans la déclencher. Utilisé pour préparer une variable d'exception qui peut être déclenchée ultérieurement lors des étapes suivantes. Propriétés :

  • Titre (facultatif) - Nom de l'action affiché dans la visualisation du processus (par exemple, « Créer une exception de validation »)

  • Type d'exception (obligatoire) - Catégorie de l'exception (par exemple, « Exception commerciale », « Exception système »)

  • Motif de l'exception (obligatoire) - Identifiant court utilisé pour classer les exceptions similaires à des fins de signalement (par exemple, « REQUIRED_FIELD_MISSING »)

  • Message d'exception (obligatoire) - Description détaillée qui vous aidera à résoudre les problèmes (par exemple, « L'adresse e-mail du client est requise mais n'est pas fournie »)

  • Code d'erreur (facultatif) - Code numérique utilisé pour distinguer les différents types d'erreurs (par exemple, 404 pour une erreur introuvable, 503 pour un service indisponible)

  • Causé par (facultatif) - Référence à une autre exception qui a déclenché celle-ci, généralement stockée sous forme de variable (par exemple, original_exception)

  • Nouvelle exception (sortie) - Variable qui stockera l'exception nouvellement créée (par exemple, new_exception)

Flux d'exceptions

Définit comment gérer les exceptions survenant au cours d'une étape du processus. Utilisé pour créer un chemin alternatif à suivre lorsque des exceptions se produisent dans votre processus. Une fois qu'une exception est traitée, le processus passe à l'étape suivante. Déclenchez à nouveau l'exception si vous souhaitez mettre fin au processus. Ajoutez un flux d'exceptions en cliquant sur le bouton Flux d'exceptions plus situé à l'étape Processus. Propriétés :

  • Titre (facultatif) - Nom de l'action affiché dans la visualisation du processus (par exemple, « Gérer les erreurs de validation »)

  • Référence d'exception (obligatoire) : nom de variable faisant référence à l'exception dans le flux d'exceptions. Accédez aux détails des exceptions à l'aide de la variable ["property"] où la propriété peut être : type, raison, message, code ou caused_by (par exemple, erreur)

Note

Les flux d'exceptions ne peuvent être ajoutés qu'aux étapes du processus. Ils ne se trouvent pas autrement dans le panneau Actions.

Travailler avec des exceptions

Propriétés d'exception

Lorsque vous gérez des exceptions, vous pouvez accéder aux propriétés suivantes :

  • type - Catégorie de l'exception (« Exception commerciale » ou « Exception système »)

  • reason - Identifiant court pour l'exception

  • message - Description détaillée de l'erreur

  • code - Code d'erreur numérique s'il est fourni

  • caused_by - Exception d'origine qui a déclenché celle-ci le cas échéant

Bonnes pratiques

  • Utilisez des raisons d'exception descriptives pour faciliter la catégorisation et la création de rapports

  • Incluez des messages détaillés pour le dépannage

  • Implémenter une logique de nouvelle tentative pour les exceptions système temporaires

  • Envisagez une intervention humaine pour les exceptions commerciales

  • Tenez compte de l'impact sur le statut du dossier lors de la gestion des exceptions

  • Assurez-vous que les opérations de nettoyage critiques ont lieu même après des exceptions telles que le redémarrage d'un navigateur

  • Surveillez les fréquences et les modèles d'exception

  • Consultez régulièrement les journaux d'exceptions

  • Relancez les exceptions une fois traitées si vous ne souhaitez pas passer aux étapes restantes