Détails d'exécution du flux

Affichez les informations d’exécution d’une action ou d’un flux directement à partir de l’environnement de conception, telles que l’état actuel, les éléments exécutés et les valeurs produites. Ouvrez les enregistrements connexes à partir des éditeurs incorporés Now Platform ou dans un nouvel onglet.

Chaque fois que vous testez un flux, le système génère des informations sur la configuration et les valeurs d’exécution produites en tant que détails d’exécution du flux. Vous pouvez afficher les détails de l’exécution du flux dans l’onglet Opérations de Studio de workflow. Sélectionnez une exécution de flux pour ouvrir la page des détails de son exécution associée.

Figure 1. Exemple de détails d’exécution de flux pour les exécutions du jour

Chaque page de détails d’exécution affiche des informations d’exécution sur le flux.

• Nom du flux
• Actualiser les données de flux
• État du flux
• Options d’enregistrement connexe
• Statistiques de flux

Figure 2. Détails de l’exécution de l’échantillon

Niveau de génération de rapports

Le niveau de génération de rapports détermine les détails d’exécution qu’un flux, un flux secondaire ou une action génère pendant les opérations normales. Par défaut, Studio de workflow ne génère aucun détail d’exécution pendant les opérations normales. Studio de workflow Génère les détails complets de l’exécution du flux lorsque vous testez un flux, un flux secondaire ou une action individuel. Lorsque votre instance génère et stocke plus de détails d’exécution, la génération de rapports a un impact plus important sur les performances de votre instance.

Chaque niveau de génération de rapports génère progressivement plus de détails sur l’exécution du flux.

Désactivé

Le système ne génère pas les détails de l’exécution du flux. Le système ne génère les détails d’exécution que lorsque vous exécutez un test.

Remarque :

Le test d’une action ou d’un flux génère des détails d’exécution au niveau de la trace.

De base : états et durées d'exécution uniquement

Le système génère les détails de l’exécution pour chaque flux, flux secondaire et exécution d’action. Vous pouvez afficher l’état et la durée d’exécution de ces éléments de base. Vous pouvez également consulter les valeurs de configuration et d’exécution des déclencheurs de flux, des entrées et des sorties de flux secondaire.

Complet : valeurs de configuration et d'exécution (pour le débogage uniquement)

Le système génère les détails de configuration et d’exécution pour chaque flux, flux secondaire et exécution d’action. Vous pouvez afficher l’état d’exécution, la durée, les valeurs d’entrée et les valeurs de sortie de tous les éléments. Pour les actions personnalisées, vous pouvez également voir l’état d’exécution, la durée, les valeurs d’entrée et les valeurs de sortie de ses étapes. Vous pouvez également voir les valeurs de configuration des déclencheurs de flux, des flux secondaires, des actions et des étapes qui font partie d’une action personnalisée.

Important :

Seuls les utilisateurs disposant du rôle fd_read_operations_all peuvent voir les informations de configuration et d’exécution telles que les valeurs d’enregistrement dans les détails d’exécution du flux. Les utilisateurs sans ce rôle ne verront que les détails de base sur l’état et la durée.

Trace : toutes les valeurs (à des fins de test et de support uniquement)

Le système génère les détails de configuration et d’exécution pour chaque flux, flux secondaire, action et exécution d’étape. Vous pouvez afficher l’état d’exécution, la durée, les valeurs d’entrée et les valeurs de sortie de tous les éléments. Vous pouvez également consulter les valeurs de configuration pour les déclencheurs de flux, les flux secondaires, les actions et les étapes.

Important :

Seuls les utilisateurs disposant du rôle fd_read_operations_all peuvent voir les informations de configuration et d’exécution telles que les valeurs d’enregistrement dans les détails d’exécution du flux. Les utilisateurs sans ce rôle ne verront que les détails de base sur l’état et la durée. Le test d’une action ou d’un flux génère des détails d’exécution au niveau de la trace.

Si un flux s’exécute alors que la génération de rapports est désactivée, les détails des exécutions passées ne sont jamais disponibles pour le flux, même si le niveau de génération de rapports change ultérieurement. Si un flux s’exécute pendant que la génération de rapports est activée, les détails de l’exécution sont disponibles pour cette exécution de flux, même si le niveau de génération de rapports change. Le niveau de génération de rapports n’a aucun effet sur les enregistrements de contexte et de journal.

Vous pouvez configurer le niveau de génération de rapports par défaut que le système utilise pour générer les détails de l’exécution à chaque exécution d’un flux. Pour plus d'informations, consultez Activer la génération de rapports de flux.

Actualiser les données de flux

Mettez à jour les données d’exécution du flux selon les besoins. Définissez une préférence de flux pour actualiser automatiquement les données de flux lorsque vous exécutez un test. Consultez Préférences utilisateur pour les flux.

État du flux

Tous les flux actifs se trouvent dans l’un de ces états.

Terminé

Le flux a exécuté toutes les actions avec succès. Les statistiques de flux affichent les détails de configuration et d’exécution de chaque action.

Annulé

Le flux a été arrêté parce que la durée d’exécution du flux a dépassé la valeur du délai d’expiration du flux, ou quelqu’un a annulé manuellement le flux.

En attente

Le flux a été mis en pause sur une action qui attend qu’une condition soit remplie avant de continuer. Les statistiques de flux affichent les détails de configuration et d’exécution des actions effectuées ainsi que des actions en attente du remplissage d’une condition. Les flux à l’état En attente affichent une action d’interface utilisateur Annuler le flux dans l’en-tête.

En pause

Le flux a été mis en pause pour permettre l’exécution de flux de priorité plus élevée ou pour permettre un arrêt approprié du nœud. Les statistiques de flux affichent les détails de configuration et d’exécution des actions effectuées.

Présomption d'interruption

Le flux est en cours d’exécution depuis plus de 15 minutes et n’a plus d’ID de transaction valide pour le nœud actuel. Sinon, le flux s’exécute depuis plus de huit heures sur un autre nœud. Le flux peut s’être arrêté en raison d’une interruption inattendue telle que l’arrêt de sa transaction ou le redémarrage de son nœud.

Erreur

Le flux s’est arrêté avec une erreur. Les statistiques de flux affichent les détails de configuration et d’exécution des actions effectuées et les détails de configuration de l’action qui a produit l’erreur. Les flux à l’état Erreur affichent une action d’interface utilisateur Accéder à l’erreur dans l’en-tête.

Remarque :

Lorsqu’une action entraîne une erreur, le flux cesse de s’exécuter à ce moment-là et entraîne un état d’erreur.

Options d’enregistrement connexe

À partir de la page Détails de l’exécution, vous pouvez accéder aux enregistrements liés au flux actuel.

Ouvrir le flux

Utilisez cette option pour effectuer des changements de configuration et publier une nouvelle instance du flux. La modification de la configuration du flux ne modifie aucun flux actuellement actif.

Ouvrir l'enregistrement de contexte

Utilisez cette option pour afficher l’état du flux, la durée d’exécution et les entrées de journal connexes à partir d’une vue de formulaire standard. Cette option ouvre l’enregistrement de contexte dans un nouvel onglet.

Ouvrir les journaux de flux

Utilisez ce lien pour afficher les informations détaillées du journal sur chaque action. Ce lien ouvre la liste des entrées de journal dans un nouvel onglet.

Ouvrir l’enregistrement actuel

Pour les flux qui ont un déclencheur basé sur les enregistrements, utilisez ce lien pour afficher l’enregistrement de déclenchement dans une fenêtre contextuelle.

Ouvrir l’action

Utilisez ce lien pour effectuer des changements de configuration et publier une nouvelle instance de l’action. La modification de la configuration de l’action ne modifie aucun flux actuellement actif. Ce lien n’est pas disponible pour les actions de base fournies par ServiceNow.

Statistiques de flux

Utilisez les statistiques de flux pour afficher les détails de configuration et les valeurs d’exécution de chaque composant de flux. La sélection d’un déclencheur ou d’une action développe la ligne et affiche des détails de configuration et d’exécution à son sujet.

Figure 3. Exemples de statistiques de flux

Les détails des types d’exécution suivants sont disponibles.

Source de l'appel

Affichez la source d’appel qui a démarré un flux, un flux secondaire ou une action.

Exécuter en tant que

Identifiez si le flux a été exécuté en tant que système ou en tant qu’utilisateur qui a déclenché le flux.

Exécuter avec des rôles

Identifiez les rôles accordés à l’utilisateur qui a déclenché le flux.

Métadonnées d'intégration

Affichez les données de transaction telles que la connexion et les informations d’identification utilisées, le serveur MID utilisé, l’hôte cible et la taille de la charge utile. Les métadonnées d’intégration ne s’affichent que pour les étapes d’intégration et nécessitent un abonnement distinct Hub d'intégration . Pour plus d’informations, consultez la section Étapes d’intégration.

Détails de la configuration

Affichez la liste des variables d’entrée pour identifier toute erreur de configuration avec l’action. Chaque variable a sa propre ligne affichant son nom, son type de données, ses paramètres de configuration et sa valeur d’exécution. Les paramètres de configuration affichent les valeurs dynamiques sous forme de pilules. Les valeurs d’exécution affichent les enregistrements générés sous forme de lien.

Remarque :

Les variables qui ont des fonctions de transformation n’affichent qu’une seule valeur d’exécution, qui est le résultat de toutes les transformations.

Données de sortie

Affichez la liste des variables de sortie pour identifier toute erreur de configuration avec l’action.

Journaux

Utilisez les entrées de journal pour identifier les problèmes potentiels de traitement ou de performances. Chaque entrée de journal a sa propre ligne affichant la date de création, le niveau de journal et le message du journal. Si l’action ne génère aucun journal, les statistiques affichent la chaîne Aucun journal.

Remarque :

Les journaux affichent l’heure au format UTC, car les journaux doivent être enregistrés sous forme de chaînes afin que l’instance puisse partager les données de journal entre ses multiples nœuds. Étant donné que chaque nœud peut se trouver dans un fuseau horaire différent, le format UTC est utilisé comme format commun pour préserver les valeurs d’heure correctes.

Étapes

Utilisez la liste des étapes pour identifier toute erreur de configuration avec l’action. Chaque étape a sa propre ligne affichant le nom de la variable, le type de données, les paramètres de configuration et la valeur d’exécution. Les actions de base n’affichent pas les étapes, car vous ne pouvez pas modifier leur configuration.

Modifiez la propriété système pour tronquer les com.snc.process_flow.reporting.serialized.val_size_limit valeurs d’exécution dans la configuration de l’étape des détails d’exécution du flux. Pour en savoir plus, consultez Studio de workflow Propriétés système du flux.

Heure de début

Affichez l’heure locale à laquelle une action a commencé.

Durée d'exécution

Utilisez la durée d’exécution pour identifier les problèmes potentiels de traitement ou de performances. La durée d’exécution est mesurée en millisecondes. À partir de la Washington DC version, la durée d’exécution répertorie le temps total d’exécution d’un élément. Le temps total inclut ces éléments.

• Temps dans la file d’attente de l’événement
• Temps dans la file d’attente ECC
• Temps de traitement de l’événement
• Temps d’exécution dans le moteur de flux
• Temps de communication avec un serveur MID

Informations sur le nouvel essai

Utilisez la section Informations sur les nouvelles tentatives pour afficher les détails de la politique relative aux nouveaux essais. Ces informations comprennent le type de stratégie de nouvelle tentative, le temps écoulé et la prochaine demande de nouvelle tentative planifiée. La section Informations sur les nouveaux essais s’affiche uniquement lorsque la politique des nouveaux essais est activée dans l’étape. Pour plus d'informations, consultez Politique des nouveaux essais.

Source de l'appel

La source de l’appel répertorie ce qui a démarré un flux, un flux secondaire ou une action.

Source	Description
Studio de workflow Test	Le flux a démarré parce que quelqu’un a sélectionné l’option Test à partir de l’interface Studio de workflow . Les conditions de déclenchement du flux ont été ignorées.
Déclencheur CRUD	Le flux a démarré lorsque les conditions de déclenchement basées sur les enregistrements ont été remplies.
Déclencheur de date	Le flux a démarré lorsque les conditions de déclenchement basées sur le calendrier ont été remplies.
Déclencheur de mesure	Le flux a commencé lorsque les conditions de déclenchement MetricBase d’un MetricBase ont été satisfaits.
Catalogue de services Répétition	Le flux a commencé lorsqu’un Catalogue de services élément a été demandé.
Script	Le flux est démarré à partir d’un appel de méthode dans un script, telle qu’une règle métier.
Script en arrière-plan	Le flux est démarré à partir d’un appel de méthode dans le module Scripts - Arrière-plan .

Visionneuse de texte incorporé

Studio de workflow Affiche de volumineux enregistrements de configuration et de sortie d’exécution basés sur du texte, tels que la sortie d’e-mail, les charges utiles XML ou les étapes de script à l’aide d’une visionneuse de texte incorporée. La visionneuse de texte incorporé peut formater le texte en HTML, en texte brut ou en JavaScript à code couleur. Pour les étapes de script, la visionneuse de texte met en surbrillance les lignes de code contenant des erreurs.

Figure 4. Exemple de vue de texte d’une étape de script

Affichage des résultats pour chaque élément de la logique de flux

Studio de workflow Affiche un contrôle de sélecteur pour afficher la configuration et les résultats d’exécution de chaque élément traité par la logique de flux. Sélectionnez un numéro d’enregistrement pour afficher les détails de sa configuration et de son exécution.

Figure 5. Exemples de statistiques de flux pour chaque élément de la logique de flux

Détails de l’exécution du flux secondaire

Les analystes de processus peuvent afficher les détails d’exécution du flux secondaire à partir de plusieurs emplacements.

Flux parent

Un flux parent répertorie les détails d’exécution de chaque flux secondaire qu’il appelle en tant qu’éléments en ligne. Développez l’étape du flux secondaire pour afficher les détails de l’exécution du flux secondaire.

Flux secondaire

Le système génère les détails d’exécution de flux pour chaque exécution de flux secondaire. Affichez les détails de l’exécution du flux secondaire directement à partir de la liste des exécutions de flux.

Prise en charge du rôle d’utilisateur

Vous pouvez contrôler l’accès aux détails d’exécution du flux en accordant des rôles d’utilisateur. Pour plus d’informations sur les rôles d’utilisateur disponibles Studio de workflow , reportez-vous à la section Accès de l’utilisateur aux Studio de workflow flux.

Tableau 1. Studio de workflow Rôles pour les détails d’exécution

Titre du rôle [name]	Description	Contient des rôles
flow_operator	Vous permet d’afficher les détails de l’exécution du flux, les tableaux de bord et les journaux. Les administrateurs peuvent accorder ce rôle aux utilisateurs qui souhaitent pouvoir afficher les résultats de l’exécution, mais pas les créer, les modifier ou les tester.	Aucun
fd_read_operations	Vous permet d’afficher les détails de base du flux et de l’exécution des actions. Lorsque la génération de rapports est activée, les utilisateurs disposant de ce rôle ne peuvent voir que les détails de base de l’exécution, tels que l’état et la durée d’exécution. Si le niveau de génération de rapports génère des détails supplémentaires, les utilisateurs dotés de ce rôle ne peuvent pas les voir. Les administrateurs peuvent accorder ce rôle aux utilisateurs qui ont uniquement besoin d’afficher les résultats de l’exécution de base, mais pas de créer, de modifier ou de tester des flux et des actions. Remarque : Les rôles en lecture seule sont incompatibles avec les rôles qui fournissent un accès en écriture, tels que flow_designer ou action_designer. Évitez d’accorder au même utilisateur un rôle d’accès en lecture seule et en écriture.	Aucun
fd_read_operations_all	Vous permet d’afficher tous les détails du flux généré et de l’exécution de l’action. Lorsque Reporting est activé, les utilisateurs disposant de ce rôle peuvent afficher tous les détails d’exécution disponibles. L’utilisateur ne peut voir que les détails définis par la propriété système au niveau de la génération de rapports. Les administrateurs peuvent accorder ce rôle aux utilisateurs qui ont besoin d’afficher tous les résultats de flux, mais pas de créer, de modifier ou de tester des flux et des actions. Remarque : Les rôles en lecture seule sont incompatibles avec les rôles qui fournissent un accès en écriture, tels que flow_designer ou action_designer. Évitez d’accorder au même utilisateur un rôle d’accès en lecture seule et en écriture.	fd_read_operations