Principes de base du débogage

Débogage dans Flux sur le canevas de construction, couvrant les étendues 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 Flux se produit sur le même canevas que vous créez. Il n'existe pas de 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 dans la barre d'outils exécute le processus. Le panneau d'exécution apparaît en bas de l'écran et les étendues sont remplies en temps réel au fur et à mesure de l'exécution de chaque nœud.

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

Reportez-vous à la zone de dessin pour obtenir un aperçu complet des contrôles de débogage et de la disposition du panneau d'exécution.

Lire le panneau d'exécution

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

Étendues

L'onglet Étendues affiche la Trace d'exécution - chaque nœud qui a été exécuté dans l'ordre, avec une synchronisation et un indicateur de réussite ou d'échec. La sélection d'une étendue met en surbrillance le nœud correspondant sur le canevas, ce qui permet de voir exactement où l'exécution a atteint.

Incidents

L'onglet Incidents collecte les erreurs qui se sont produites lors de l'exécution. 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. 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.

Identifier les échecs

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

L’objet d’erreur comprend un champ message (description lisible par un humain) et un champ detail (provoque technique). Commencez par message car il contient le résumé de l'échec destiné à 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 vos données de test en aval à la place.

Cela est utile lorsqu'un nœud en amont est lent, nécessite des informations d'identification non disponibles localement ou dépend de systèmes externes. Double-cliquer sur le nœud ouvre sa vue développée, où la sortie simulée peut être définie sur toutes les données attendues par les nœuds en aval.

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

• Tout d’abord, les incidents. Les étendues affichent la vue complète de l’exécution; les incidents affichent uniquement ce qui a cassé.
• Les valeurs des variables montrent des incompatibilités de données. Comparez les données reçues par un nœud avec les données attendues par le nœud suivant.
• 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 les systèmes externes.
• Les petites itérations sont plus rapides. Une correction par cycle de débogage est plus efficace que d’essayer de tout corriger en une seule fois.
• Les noms de nœud descriptifs améliorent la lisibilité du traçage. Les étendues et les incidents référencent les noms de nœuds - des noms qui décrivent ce qu'un nœud facilite 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 - fonctionnement des variables entre les nœuds