Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Il se peut que vous souhaitiez parfois générer une erreur dans un pipeline de manière intentionnelle. Une activité de recherche peut ne retourner aucune donnée correspondante, ou une activité de script peut se terminer par une erreur interne. Quelle que soit la raison possible, vous pouvez maintenant utiliser une activité d’échec dans un pipeline et personnaliser à la fois son message d’erreur et son code d’erreur.
Quand utiliser l’activité Échec
L’activité d’échec est couramment utilisée dans les scénarios conditionnels où vous souhaitez que le pipeline échoue en fonction de conditions spécifiques :
- Échecs de validation des données : lorsque les données ne répondent pas aux normes de qualité
- Violations de logique métier : lorsque les règles d’entreprise ne sont pas satisfaites
- Vérifications des dépendances : lorsque les ressources ou sources de données requises ne sont pas disponibles
- Gestion des erreurs personnalisées : lorsque vous souhaitez fournir des informations d’erreur spécifiques au lieu d’erreurs système génériques
L’activité Échec est généralement connectée à d’autres activités à l’aide de la logique conditionnelle (activité If Condition) ou placée après les activités susceptibles de produire des conditions d’erreur.
Conditions préalables
Pour commencer, vous devez remplir les conditions préalables suivantes :
- Un compte de locataire avec un abonnement actif. Créer un compte gratuitement.
- Un espace de travail est créé.
Ajouter une activité Échec à un pipeline via l'interface utilisateur
Pour utiliser une activité "Fail" dans un pipeline, procédez comme suit :
Créez un pipeline dans votre espace de travail.
Recherchez l’activité Échec dans le volet Activités du pipeline, puis sélectionnez-la pour l’ajouter au canevas du pipeline. Il peut être nécessaire d’étendre la liste des activités à l’extrême droite du volet, ou l’icône Outlook peut être compressée sans étiqueter du texte sous celle-ci, comme illustré dans cette image, en fonction de la largeur de la fenêtre de votre navigateur.
Sélectionnez la nouvelle activité Échec sur le canevas si elle n’est pas déjà sélectionnée.
Reportez-vous aux instructions relatives aux paramètres généraux pour configurer l’onglet Paramètres généraux.
Sélectionnez l’onglet Paramètres de et fournissez un message d’erreur personnalisé et un code d’erreur que vous souhaitez que le pipeline signale lorsque l’activité est appelée. Ces valeurs s’affichent dans l’historique des exécutions du pipeline et les journaux lorsque l’activité Échec s’exécute, ce qui vous permet d’identifier la condition d’erreur spécifique qui a provoqué l’échec du pipeline.
Enregistrer et exécuter ou planifier le pipeline
L’activité Échec est généralement utilisée avec d’autres activités. Après avoir configuré toutes les autres activités requises pour votre pipeline, basculez vers l’onglet Accueil en haut de l’éditeur de pipeline, puis sélectionnez le bouton Enregistrer pour enregistrer votre pipeline. Sélectionnez Exécuter pour l'exécuter directement ou Planifier pour le planifier. Vous pouvez également afficher l’historique des exécutions ici ou configurer d’autres paramètres.
Exemple : échec du pipeline conditionnel
Voici un modèle courant pour l’échec d’un pipeline en fonction de conditions personnalisées :
- Utiliser une activité If Condition pour évaluer votre condition d’erreur personnalisée
- Dans la branche True de la condition If, ajoutez l’activité Échec
- Configurer l’activité Échec avec votre message d’erreur personnalisé qui décrit la condition spécifique remplie
- Dans la branche False , poursuivez l’exécution normale du pipeline
Ce modèle permet à votre pipeline d’échouer correctement avec des messages d’erreur significatifs lorsque des conditions métier ou de données spécifiques sont rencontrées.