Résolution de problèmes avec les erreurs Flow et les limites d’utilisation

Ce document décrit les erreurs et les limites courantes, les raisons pour lesquelles elles se produisent et la façon de les résoudre. Il existe deux types d’erreurs que vous pouvez rencontrer dans Flow : les erreurs permanentes et les erreurs momentanées.

Erreurs momentanées

Les erreurs momentanées sont des erreurs temporaires qui se produisent lorsque Flow ne parvient pas à terminer une tâche. Ces erreurs sont retentées jusqu’à ce qu’elles réussissent ou qu’elles atteignent une limite de temps. Par exemple, si Flow ne parvient pas à contacter un partenaire lors de l’exécution d’une action de connecteur, Flow retente la tâche plusieurs fois avant d’abandonner.

Les tentatives sont échelonnées, le délai entre chaque autre tentative augmentant par rapport au délai précédent. En règle générale, lorsqu’un flux de travail subit des erreurs momentanées, celui‑ci reste dans l’état en cours d’exécution pendant une longue période, à mesure que les tâches sont retentées.

Lorsqu’une tâche est retentée avec succès, le flux de travail se poursuit. Si une tâche retentée entraîne une erreur permanente, le flux de travail échoue. Chaque section de flux de travail a une limite supérieure d’exécution combinée de 36 heures. Si une étape comportant des erreurs momentanées échoue avant que cette limite ne soit atteinte, le flux de travail échoue.

Les flux de travail comportant des étapes d’attente sont divisés en sections, ce qui affecte la façon dont les délais sont calculés dans un flux de travail. Chaque section est un groupe de tâches qui sont exécutées ensemble, et chacune a son propre délai de 36 heures. Par exemple, si un flux de travail comporte une étape d’attente d’une heure, les tâches précédant l’étape d’attente seront exécutées ensemble dans une section et les tâches suivant l’étape d’attente seront exécutées ensemble dans une autre section. Si un flux de travail comporte plusieurs étapes d’attente, les tâches entre chaque étape d’attente seront exécutées ensemble dans une section. Les flux de travail sans étape d’attente sont considérés comme une seule section.

Les erreurs momentanées occasionnelles sont courantes. Toutefois, si vous avez un flux de travail qui rencontre systématiquement la même erreur momentanée lors de plusieurs exécutions, il se peut que votre flux de travail doive être reconfiguré.

L’étape a expiré

Step timed out : en règle générale, ces erreurs se produisent lorsqu’une tâche du flux de travail tente d’interroger une trop grande quantité de données dans une section. Cette erreur se produit fréquemment dans les flux de travail qui itèrent sur des listes (surtout des listes imbriquées) trop volumineuses pour être récupérées dans le délai imparti.

Lorsqu’un flux de travail rencontre cette erreur, l’étape de déclencheur ou d’attente s’affiche comme retrying.

Pour résoudre ce problème, examinez les conditions d’accès aux listes et aux listes imbriquées pour vérifier qu’elles sont correctes. Il arrive souvent qu’une condition vérifie tous les produits d’une boutique au lieu de ne vérifier que ceux d’une commande.

Statut 5xx

La plupart des actions Flow impliquent de faire des appels HTTP. Parfois, des problèmes de réseau ou d’autres problèmes de serveur peuvent faire échouer les appels HTTP et renvoyer un code d’erreur entre 500 et 599. Une seule occurrence de cette erreur ne pose pas de problème, mais des occurrences répétées peuvent indiquer un problème avec le serveur qui gère la tâche, plutôt que la configuration de l’étape.

Ce type d’erreur survient le plus souvent dans l’action Envoyer une requête HTTP, mais il peut se produire dans la plupart des tâches.

Accélérateur GraphQL

Le volume total de travail effectué par un flux de travail est limité par les limites d’appels à l’API, qui sont déterminées en partie par votre forfait. En règle générale, ces limites ne sont pas atteintes, sauf si le flux de travail est très complexe ou présente une erreur de conception involontaire. Voici des exemples de scénarios qui peuvent entraîner cette erreur :

• Liquid ou des conditions dans le flux de travail font tourner en boucle une liste contenant de grandes quantités de données, telles que la vérification des valeurs des champs méta qui contiennent du HTML.
• Liquid ou des conditions dans le flux de travail font tourner en boucle une liste importante, par exemple bouclant sur shop.orders dans une grande boutique.
• Un flux de travail entraîne une boucle infinie dans laquelle le flux de travail continue à créer de nouveaux flux de travail. Par exemple, cela peut se produire si le flux de travail utilise le déclencheur Balises clients ajoutées et inclut l’action Ajouter des balises de client.

Si la limite est atteinte, vous recevez une erreur GraphQL throttled. Cette erreur peut affecter d’autres flux de travail lorsqu’ils tentent de s’exécuter, de sorte que cette erreur doit être résolue immédiatement si elle se produit.

Erreurs permanentes

Les erreurs permanentes sont des erreurs qui se produisent lorsque Flow ne parvient pas à terminer une tâche et que la tâche ne peut pas être retentée. Par exemple, si Flow ne parvient pas à envoyer d’e‑mail en raison d’une adresse non valide, elle ne retente pas la tâche. Au lieu de cela, le flux de travail échoue.

Flow n’a pas l’autorisation d’accès à votre compte Google Sheets. Veuillez reconnecter votre compte.

Le connecteur Google Sheets vous oblige à associer votre compte Google à Flow pour avoir l’autorisation d’écrire sur la feuille. Cette erreur peut se produire lorsque Flow n’a pas l’autorisation d’écrire sur une feuille, soit parce que le compte a été dissocié de Flow, soit parce que ce compte n’est pas en mesure d’accéder à cette feuille.

Pour résoudre ce problème, vérifiez que le compte utilisé pour le connecteur est habilité à ouvrir la feuille et à la modifier. Si le compte relié n’est pas le bon, vous pouvez le déconnecter pour en connecter un autre.

Étapes :

1. Ouvrez ou créez un nouveau flux de travail.
2. Ajoutez une action.
3. Sélectionnez le connecteur Google Sheets.
4. Cliquez sur Déconnecter, puis sur Connecter.

Action Flow reçue avec des propriétés non valides. Le client refuse le marketing.

L’action Envoyer du marketing par e‑mail n’envoie pas d’e‑mails aux clients qui n’ont pas donné leur accord pour les recevoir, et échoue de manière permanente si le flux de travail tente de le faire.

Pour résoudre ce problème, ajoutez au flux de travail une condition qui vérifie le statut d’abonnement des clients. Vous pouvez vérifier que les clients ont accepté de recevoir des e-mails de marketing avant d’envoyer ces derniers. Suivez les étapes indiquées dans la section Gestion de listes d’abonnés aux e-mails.

Ressource manquante pour [type de ressource]

Cette erreur indique qu’une ressource, telle que customer ou order, a été supprimée avant que le flux de travail n’ait pu récupérer ses données. Le plus souvent, cela se produit après une étape d’attente, mais il est possible que cela se produise sur le déclencheur si la ressource est supprimée très rapidement après l’événement déclencheur.

Recevoir des notifications en cas d’erreur

Si des erreurs sont susceptibles d’avoir des conséquences sur le fonctionnement de votre boutique, vous pouvez configurer des notifications pour être prévenu lorsqu’une erreur se produit. Vous pouvez créer des notifications d’erreur sur le même modèle que n’importe quel autre flux de travail, en utilisant le déclencheur Une erreur de flux de travail s’est produite. Les notifications d’erreur sont conçues pour limiter le bruit. Aussi ne recevrez-vous qu’une seule notification par version de flux de travail.

Pour commencer, vous pouvez utiliser l’un des modèles suivants :

• Recevoir une alerte Shopify lorsque des erreurs d’exécution de flux de travail sont détectées
• Recevoir une notification par e-mail lorsque des erreurs d’exécution de flux de travail sont détectées
• Recevoir une notification Slack lorsque des erreurs d’exécution de flux de travail sont détectées

Nouvelle tentative d’exécution

Dans certains cas, l’exécution d’un flux de travail peut rencontrer une erreur ou ne pas s’exécuter comme prévu. Après avoir résolu les problèmes dans le flux de travail concerné, les exécutions antérieures peuvent être relancées manuellement afin de corriger rétroactivement le résultat de ces exécutions antérieures. En savoir plus sur la marche à suivre pour réessayer manuellement les exécutions de flux de travail.