Recherche et suivi des exécutions de flux de travail

Après l’exécution d’un flux de travail, Flow fournit un journal des événements, appelé exécution de flux de travail, qui vous permet de suivre sa performance et son comportement.

Accéder aux exécutions de flux de travail

Vous pouvez suivre toutes les exécutions de flux de travail dans l’application Flow. L’examen des exécutions de flux de travail peut vous aider à identifier les problèmes potentiels liés au comportement du flux de travail.

Il peut être utile d’examiner les exécutions de tous les flux de travail lorsque vous cherchez à résoudre des problèmes ou que vous ne savez pas quel flux de travail vérifier. Si vous savez précisément quel flux de travail vous souhaitez examiner, vous pouvez alors accéder aux exécutions récentes de ce flux de travail uniquement.

Étapes :

Rechercher une exécution de flux de travail spécifique

Vous pouvez rechercher des exécutions de flux de travail dans Flow en utilisant l’une des méthodes suivantes :

• À partir des pages de ressources de l'interface administrateur Shopify, comme une commande ou un produit.
• Dans l’appli Flow, vous pouvez filtrer les listes d’exécutions récentes en utilisant les filtres de recherche courants suivants :
  • Par texte dans les données d’étape, comme un ID de client ou une référence de commande.
  • Par plage horaire, par exemple la date et l’heure auxquelles l’exécution aurait dû avoir lieu.

Éléments pouvant faire l’objet d’une recherche

La liste Exécutions récentes de l’appli Flow permet de filtrer la liste complète des exécutions par n’importe quelle combinaison des filtres suivants :

• Contient le texte : filtrez en fonction du contenu textuel brut des données utilisées dans l’exécution du flux de travail, comme une référence de commande dans une charge utile de déclencheur ou le nom de la balise dans une condition.
• Flux de travail : filtrez par nom de flux de travail.
• Actions effectuées : filtrez pour savoir si l’exécution a effectué des actions (vrai) ou n’a rien fait (faux).
• Erreurs : filtrez pour savoir si l’exécution contient des erreurs.
• Heure de début : filtrez par plage de dates et d’heures à laquelle l’exécution aurait dû commencer. En savoir plus sur le filtrage des exécutions par heure.
• Type de déclencheur : filtrez en fonction de la façon dont l’exécution a commencé. Les options incluent un événement déclencheur, une exécution manuelle ou une nouvelle tentative manuelle.
• Statut de la nouvelle tentative : filtrez pour savoir si l’exécution contient des nouvelles tentatives ou non.
• ID de l’exécution : filtrez par ID d’exécution spécifique. Vous pouvez également choisir d’inclure les nouvelles tentatives liées à un ID d’exécution spécifié.
• Balises : filtrez en fonction des balises de flux de travail qui s’appliquent à l’exécution.

Avant de lancer une recherche, déterminez les informations que vous pouvez rechercher dans l’exécution du flux de travail. Ces informations s’affichent dans les détails de l’exécution du flux de travail et incluent les types suivants :

• Tous les ID des ressources qui ont été utilisées dans l’exécution du flux de travail, telles que les références de commandes ou les ID de clients.
• Tout texte ou toutes données qui ont été inclus dans l’exécution du flux de travail, comme un nom de balise ou un titre de produit.

De plus, lorsque vous recherchez une exécution de flux de travail, tenez compte des limitations suivantes :

• La recherche est insensible à la casse.
• La chaîne de recherche ne doit pas inclure de ponctuation. Par exemple, si vous recherchez une référence de commande, recherchez 43843493 au lieu de gid://shopify/Order/43843493.
• Les journaux ne contiennent pas tous les détails sur les ressources utilisées dans votre flux de travail. Par exemple, si vous utilisez un ID de produit dans votre flux de travail, le journal d’exécution du flux de travail ne contient pas le nom ou le titre du produit, sauf si vous avez également utilisé ces champs.
• La recherche est limitée aux exécutions de flux de travail des 14 derniers jours.

Rechercher à partir de l’interface administrateur Shopify

Pour les ressources qui ont un menu Plus d’actions, vous pouvez lancer une recherche d’exécution de flux de travail en choisissant l’option Rechercher des exécutions Flow. Cette option est disponible pour les ressources suivantes :

• Commandes
• Commandes provisoires
• Clients
• Produits
• Variantes
• Collections

Si vous avez des difficultés à trouver une exécution, consultez la section Éléments pouvant faire l’objet d’une recherche.

Étapes :

1. Dans l’interface administrateur Shopify, ouvrez la ressource que vous souhaitez rechercher, comme une commande ou un produit.
2. Cliquez sur Plus d’actions.
3. Cliquez sur Rechercher des exécutions Flow.

Rechercher par texte dans les données d’étape

Dans l’appli Flow, vous pouvez rechercher toutes les données qui ont été incluses dans les sections données d’étape d’une exécution de flux de travail.

Si vous avez des difficultés à trouver une exécution, consultez la section Éléments pouvant faire l’objet d’une recherche.

Étapes :

1. Dans la liste Exécutions récentes de l’appli Flow, cliquez sur Ajouter un filtre.
2. Choisissez Contient le texte.
3. Saisissez le texte ou l’ID à rechercher.

Rechercher par plage horaire

Examinez les considérations suivantes pour trouver une exécution de flux de travail par plage horaire :

• Si le fuseau horaire de votre appareil est différent de celui de votre boutique, la date et l’heure d’une exécution de flux de travail peuvent être inexactes. Tenez compte de cette différence dans le filtre Heure de début que vous utilisez.
• Dans les boutiques à volume élevé, vous devrez peut-être utiliser une plage horaire étroite et d’autres filtres pour trouver plus facilement une exécution de flux de travail spécifique.
• Les exécutions de flux de travail sont stockées pendant 14 jours seulement après la fin de l’exécution.
• Il peut y avoir un délai entre le moment où un flux de travail s’exécute et celui où ses résultats s’affichent sur la page Exécutions récentes. Si les résultats d’un flux de travail récent ne sont pas encore disponibles, attendez quelques minutes et réessayez.

Étapes :

1. Dans la liste Exécutions récentes de l’appli Flow, cliquez sur Ajouter un filtre, puis sur Heure de début.
2. Dans le champ De, saisissez une date et une heure qui correspondent à l’heure à laquelle l’événement aurait dû se produire. Par exemple, pour un déclencheur Commande créée, utilisez l’heure à laquelle la commande a été créée. Veillez à saisir la valeur AM/PM appropriée.
3. Dans le champ À, saisissez une date et une heure qui se situent 10 minutes après la date et l’heure du champ De.
4. Examinez les résultats de la recherche. Les flux de travail s’exécutent généralement exactement en même temps qu’un événement déclencheur ou peu de temps après.
5. Cliquez sur un résultat qui correspond à l’heure et vérifiez que la ressource affichée correspond à la ressource que vous recherchez, telle que la commande.

Colonnes de la liste des exécutions récentes

La liste des exécutions récentes d’un flux de travail affiche des données clés sur les exécutions du flux de travail :

Affichage des détails d’une exécution de flux de travail

Pour accéder aux informations détaillées sur un flux de travail individuel, cliquez sur la ligne de l’exécution du flux de travail.

En haut, la section État indique si le flux de travail a été terminé. La section Actions indique le nombre d’actions du flux de travail qui ont été exécutées avec succès.

La section Détails affiche un aperçu du flux de travail et met en surbrillance le ou les chemins que le flux de travail a empruntés.

Après l’aperçu du flux de travail, vous pouvez afficher les résultats, les journaux et les données de chaque étape du flux de travail.

Pour chaque étape, vous pouvez agrandir la section Données de l’étape pour afficher les données qui ont été utilisées dans l’exécution du flux de travail. Ces données comprennent tous les ID des ressources qui ont été utilisées dans l’exécution du flux de travail, tels que les références des commandes ou les ID des clients, ainsi que tout texte ou toute donnée qui ont été inclus dans l’exécution du flux de travail, comme un nom de balise ou un titre de produit.

Flux de travail avec des actions de « boucle for each »

Les flux de travail qui incluent l’action Boucle For each (itérer) répètent les étapes plusieurs fois. Flow met en évidence le nombre d’articles qui ont suivi un chemin dans l’aperçu du flux de travail.

Flow affiche également les résultats de chaque itération de la boucle et vous permet de filtrer par actions effectuées et par erreurs afin de résoudre rapidement les problèmes liés aux boucles.

Annulation des exécutions de flux de travail en cours

Vous pouvez annuler une exécution de flux de travail dont l’état est En cours ou Limitation du débit lorsque vous souhaitez arrêter un flux de travail avant qu’il ne se termine. L’annulation d’une exécution de flux de travail peut être une option utile pour éviter d’atteindre les limites de l’API, lorsque vous remarquez que le flux de travail ne s’exécute pas comme prévu, ou pour éviter que les exécutions qui échouent n’encombrent votre liste Exécutions récentes.

Points à prendre en compte pour l’annulation des exécutions de flux de travail en cours

Avant d’annuler une exécution de flux de travail en cours, tenez compte des points suivants :

• Vous devez utiliser un appareil de bureau pour annuler les exécutions de flux de travail dans l’application Flow.
• Vous ne pouvez pas annuler les exécutions qui sont déjà terminées.
• Les exécutions annulées ne peuvent pas être reprises ultérieurement. Si vous avez besoin que le flux de travail s’exécute à nouveau, vous pouvez attendre que le flux de travail se déclenche automatiquement, effectuer une nouvelle tentative d’exécution ou démarrer manuellement une nouvelle exécution du flux de travail.
• L’annulation d’exécutions de flux de travail ne désactive pas automatiquement le flux de travail associé. Cependant, le fait de désactiver un flux de travail annule automatiquement toutes ses exécutions de flux de travail en cours.
• L’annulation des exécutions de flux de travail peut prendre de quelques secondes à une minute, en fonction de la complexité du flux de travail.

Annuler les exécutions de flux de travail en cours

Vous pouvez annuler une exécution de flux de travail en cours à tout moment. Il existe plusieurs façons d’annuler des exécutions de flux de travail en cours :

• Pour annuler une exécution spécifique, vous pouvez l’annuler directement à partir de la page de détails de l’exécution du flux de travail.
• Pour annuler plusieurs exécutions d’un même flux de travail, vous pouvez annuler des exécutions en bloc à partir de la liste Exécutions récentes du flux de travail.

Étapes :

Résolution des problèmes d’exécution des flux de travail

Dans certains cas, une exécution de flux de travail peut rencontrer une erreur ou ne pas s’exécuter comme prévu. Le plus souvent, cela se produit lorsqu’il y a un problème de configuration avec le flux de travail. En savoir plus sur la résolution des erreurs Flow et la nouvelle tentative d’exécution des flux de travail pour corriger rétroactivement le résultat des exécutions passées.