Principes de base du débogage

Débogage dans Flow sur la zone de dessin de création, couvrant les périodes d'exécution, les incidents, l'inspection des échecs et la sortie simulée pour tester les workflows de manière isolée.

Le débogage dans Flow se produit sur la même zone de dessin où vous créez. Il n'y a aucune vue de débogage distincte - vous exécutez votre processus, inspectez les résultats dans le panneau d'exécution et apportez des modifications lorsque vous détectez un problème.

Démarrage d’une session de Debug

Le bouton Debug de la barre d'outils exécute le processus. Le panneau d'exécution apparaît au bas de l'écran et s'alimentent en temps réel à mesure que chaque nœud s'exécute.

Le bouton Arrêt met fin à la session explicitement. Toute modification apportée au processus met également fin à la session de débogage automatiquement.

Reportez-vous à la zone de dessin pour obtenir une vue d'ensemble complète des contrôles de débogage et de la mise en page du panneau d'exécution.

Lecture du panneau d'exécution

Le panneau d'exécution a trois onglets. Chacun répond à une question différente.

Les étendues

L'onglet Étendues affiche la trace d'exécution - chaque nœud qui s'est exécuté, dans l'ordre, avec la durée et un indicateur de succès ou d'échec. La sélection d'une étendue met en surbrillance le nœud correspondant sur la zone de dessin, ce qui permet de voir exactement où l'exécution est parvenue.

Incidents

L'onglet Incidents collecte les erreurs qui se sont produites lors de l'exécution, regroupées par nœud. Chaque groupe est développé par défaut, de sorte que les erreurs et les avertissements qu'il contient sont immédiatement visibles. Chaque incident nomme le nœud qui a échoué et inclut le message d'erreur. Si votre processus s’est arrêté de manière inattendue, vérifiez d’abord ici.

Variables

L'onglet Variables affiche les valeurs des variables de runtime, divisées en trois sections: Entrées (valeurs transmises au workflow), Sorties (valeurs qu'elle produit) et Variables (variables internes du workflow). Sélectionnez une plage dans l'onglet Étendues et l'onglet Variables se met à jour pour afficher l'état à ce point de l'exécution. Utilisez cette option pour vérifier que les nœuds en amont ont produit les données que vous attendiez.

Identification des échecs

Après une exécution de débogage, chaque nœud de la zone de dessin affiche un indicateur de succès ou d'échec. L'étendue du nœud échoué dans l'onglet Étendues la met en surbrillance sur la zone de dessin. L'onglet Incidents affiche le message d'erreur. Le panneau Propriétés du nœud échoué affiche l'objet d'erreur complet dans la section de sortie.

L'objet d'erreur inclut un champ message (description lisible par un humain) et un champ detail (cause technique). Commencez par message, car il contient le résumé de l'échec orienté vers l'utilisateur.

Utilisation de nœuds simulés

La sortie simulée vous permet de tester une partie d'un processus de manière isolée. Lorsque vous définissez une sortie simulée sur un nœud, elle ignore l'exécution réelle et injecte plutôt vos données de test en aval.

Cela est utile lorsqu'un nœud en amont est lent, nécessite des identifiants non disponibles localement ou dépend de systèmes externes. Un double-clic sur le nœud ouvre sa vue développée, où la sortie simulée peut être définie sur les données que les nœuds en aval attendent.

La simulation de plusieurs nœuds à la fois permet à la session de débogage de se concentrer sur une section spécifique du processus.

Astuces

• Les étendues d'abord, les incidents ensuite. Les étendues donnent une vue d'ensemble de l'exécution ; les incidents ne montrent que ce qui a échoué.
• Les valeurs des variables révèlent des incompatibilités de données. Comparez les données qu'un nœud a reçues avec les données que le nœud suivant attendait.
• La simulation des dépendances externes permet une itération plus rapide. La simulation d'un nœud qui appelle une API ou déclenche un processus RPA vous permet de déboguer la logique sans attendre des systèmes externes.
• Les petites itérations sont plus rapides. Un correctif par cycle de débogage est plus efficace que d'essayer de tout corriger en une seule fois.
• Les noms de nœuds descriptifs améliorent la lisibilité de la trace. Les étendues et les incidents font référence aux noms de nœuds - des noms qui décrivent ce qu'un nœud fait facilitent l'analyse des traces d'exécution.

Pages liées

• La zone de dessin - contrôles de débogage complets et référence du panneau d'exécution
• Gestion des erreurs - configuration des branches d'erreur sur les nœuds
• Variables et flux de données - comment les variables fonctionnent dans les nœuds