Résolution des erreurs dans Shopify Flow

Lors de la création d’un nouveau flux de travail, vous pourriez rencontrer une erreur indiquant : Vous avez atteint la limite maximale autorisée de 1 000 flux de travail. Pour continuer, veuillez supprimer tous les flux de travail inutilisés et réessayer.

Flow limite le nombre de flux de travail qu’une boutique peut avoir à 1 000. Cela inclut les flux de travail actifs et inactifs. Si vous atteignez cette limite et que vous souhaitez créer un nouveau flux de travail, supprimez les flux de travail inutilisés ou inactifs.

Si votre boutique avait plus de 1 000 flux de travail avant la mise en place de cette limite, elle peut continuer à fonctionner avec plus de 1 000 flux de travail. Cependant, pour créer de nouveaux flux de travail, vous devez être en dessous de la limite.

Vous pourriez rencontrer cette erreur lorsque vous effectuez plusieurs actions dans l’appli Flow :

• Création d’un nouveau flux de travail
• Duplication d’un flux de travail
• Importation d’un flux de travail
• Installation d’un modèle

Lors de l’activation d’un flux de travail, un avertissement peut s’afficher pour indiquer que votre boutique compte plus de 10 flux de travail actifs utilisant le même déclencheur.

Le fait d’avoir de nombreux flux de travail partageant le même déclencheur peut entraîner des problèmes de performance, car chaque fois que l’événement déclencheur survient, Flow doit traiter tous les flux de travail qui y sont associés. Cette démultiplication peut ralentir les temps d’exécution et accroître l’utilisation des ressources.

Pour réduire le nombre de flux de travail sur un seul déclencheur, envisagez les approches suivantes :

• Regrouper les flux de travail qui utilisent le même déclencheur en un seul flux de travail comportant plusieurs branches et conditions.
• Désactiver ou supprimer les flux de travail qui ne sont plus nécessaires.
• Vérifier si certains flux de travail pourraient utiliser plutôt un déclencheur plus spécifique.

Lorsque vous ajoutez une nouvelle action à un flux de travail, vous pourriez rencontrer une erreur indiquant Données introuvables :

Cette erreur se produit, car de nombreuses actions, y compris Ajouter des balises de produit, nécessitent une ressource Shopify, comme un produit. Si cette ressource n’est pas disponible, l’action ne peut pas s’exécuter. Il arrive souvent que les flux de travail contiennent des données similaires aux données requises, mais qui ne fournissent pas réellement ce qui est nécessaire.

Les sections suivantes décrivent des scénarios courants qui peuvent causer cette erreur et expliquent comment les résoudre.

Problème 1 : une liste a été fournie par l’action Récupérer des données alors qu’un seul article était nécessaire

Souvent, un flux de travail fournit une liste de ressources Shopify, mais l’action n’autorise qu’une seule ressource. Par exemple, le flux de travail fournit une liste de produits par l’intermédiaire de l’action Récupérer les données sur les produits, mais l’action Ajouter des balises de produit requiert un seul produit.

Pour résoudre cette erreur, vous pouvez ajouter une action Pour chaque afin de parcourir la liste et d’appeler l’action pour chaque article de la liste. Cet exemple illustre à la fois l’erreur et la solution à l’aide de l’action Pour chaque :

Problème 2 : une liste a été fournie par le déclencheur alors qu’un seul article était nécessaire

Une erreur similaire peut se produire lorsqu’une action requiert une seule ressource, mais que le déclencheur fournit une liste. Par exemple, l’action Marquer un ordre de traitement de la commande comme traité requiert un ordre de traitement de la commande, mais le déclencheur provient d’une commande, qui fournit une liste d’ordres de traitement de la commande.

Pour résoudre cette erreur, comme pour le problème 1, vous pouvez ajouter une action Pour chaque afin de parcourir la liste en boucle et d’appeler l’action pour chaque article de la liste :

Vous pouvez également utiliser un déclencheur différent qui fournit la ressource requise. Par exemple, au lieu d’utiliser le déclencheur Commande créée, vous pouvez utiliser le déclencheur Ordre de traitement de la commande prêt à être traité, qui fournit un seul ordre de traitement de la commande.

Problème 3 : aucune donnée n’a été fournie par le déclencheur Heure planifiée

Le déclencheur Heure planifiée ne fournit pas de données sur les ressources Shopify. Si vous essayez de connecter des actions qui requièrent des ressources Shopify après le déclencheur, vous rencontrerez cette erreur.

Pour résoudre cette erreur, ajoutez une action, telle que Récupérer les données sur les produits, qui fournit les données requises. Comme indiqué dans le problème 1, vous devez également ajouter une action Pour chaque afin de parcourir en boucle toute liste renvoyée par une action qui récupère des données.

Problème 4 : aucune donnée n’a été fournie par un déclencheur d’appli

De manière similaire au problème 3, certains déclencheurs créés par des applis ne fournissent pas les données de ressource Shopify requises. Par exemple, un déclencheur « Avis créé » peut fournir une adresse e-mail, mais pas d’objet client, qui est nécessaire pour de nombreuses actions, telles que Ajouter des balises de client.

Pour résoudre cette erreur, vous pouvez peut-être utiliser une action « Récupérer des données » pour aller chercher la ressource Shopify dont vous avez besoin. Par exemple, vous pouvez utiliser l’action Récupérer les données sur les clients pour obtenir l’objet client à partir de l’adresse e-mail fournie par le déclencheur. Comme pour les autres problèmes, vous devez également ajouter une action Pour chaque pour parcourir en boucle toute liste renvoyée par une action qui récupère des données.

Si l’option « Récupérer des données » n’est pas disponible, vous devrez peut-être contacter le développeur d’appli pour lui demander s’il peut modifier son déclencheur afin de fournir les données requises.

Lorsque vous ajoutez de nouvelles étapes d’attente à votre flux de travail, vous pourriez rencontrer une erreur indiquant : Les flux de travail doivent comporter 40 étapes d’attente ou moins.

Flow limite à 40 le nombre d’étapes d’attente autorisées dans un flux de travail. Si vous rencontrez cette erreur, cela signifie que vous avez dépassé cette limite. Pour résoudre le problème, supprimez des étapes d’attente ailleurs dans votre flux de travail.

Si vous aviez déjà des flux de travail contenant plus de 40 étapes d’attente avant l’introduction de cette limite, votre flux de travail continue de fonctionner comme prévu. Toutefois, pour ajouter des étapes d’attente supplémentaires, vous devez d’abord en supprimer pour rester en dessous de la limite.

De plus, le temps d’attente total pour toutes les étapes d’attente ne peut pas dépasser 90 jours.

Lors de la modification de la valeur des champs de configuration dans les conditions de votre flux de travail, vous pourriez rencontrer une erreur indiquant : La valeur du champ de configuration doit être inférieure à 50 ko.

Flow limite la taille de la valeur d’un champ de configuration à 50 ko de données. Lorsque vous rencontrez cette erreur, vous avez atteint ou dépassé la limite. Pour résoudre le problème, raccourcissez la longueur des données que vous ajoutez à ce champ.

Si vous avez déjà des champs de configuration dont la valeur est égale ou supérieure à 50 ko, vos flux de travail continuent de s’exécuter comme prévu. Toutefois, pour apporter des modifications à votre flux de travail, vous devez revoir la valeur à l’origine de l’erreur.

Les erreurs Expiration du délai de l’étape se produisent généralement lorsqu’une tâche du flux de travail tente d’interroger un volume de données trop important au sein d’une même section. Cette erreur se produit souvent dans les flux de travail qui parcourent des listes en boucle, en particulier des listes imbriquées qui sont trop volumineuses pour être traitées rapidement.

Lorsque cette erreur se produit, le déclencheur ou l’étape d’attente affiche l’état nouvelle tentative en cours.

Pour résoudre ce problème, examinez les conditions qui accèdent aux listes et aux listes imbriquées afin de vous assurer qu’elles sont correctement configurées. Un problème courant est une condition qui vérifie tous les produits d’une boutique, au lieu de vérifier uniquement les produits d’une commande.

La plupart des actions de Flow impliquent des appels HTTP. Il arrive que des problèmes de réseau ou de serveur provoquent l’échec des appels HTTP et renvoient un code d’erreur compris entre 500 et 599. La présence d’une seule occurrence de cette erreur n’est pas un problème, mais des instances répétées peuvent indiquer un problème avec le serveur qui traite la tâche, plutôt qu’avec la configuration de l’étape.

Ce type d’erreur s’affiche le plus souvent au niveau de l’action Envoyer une requête HTTP, mais il peut se produire sur la plupart des tâches.

Le volume total de travail effectué par un flux de travail est limité par les limites de débit de 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 un flux de travail est très complexe ou contient une erreur de conception involontaire.

Les exemples suivants décrivent des situations qui peuvent entraîner cette erreur :

• Liquid ou des conditions dans le flux de travail parcourent en boucle une liste contenant de grandes quantités de données, par exemple en vérifiant les valeurs de champs méta qui contiennent du HTML.
• Liquid ou des conditions dans le flux de travail parcourent une longue liste en boucle, par exemple en parcourant shop.orders dans une boutique de grande taille.
• Un flux de travail crée une boucle infinie dans laquelle le flux de travail continue de créer de nouvelles exécutions de flux de travail. Par exemple, cela peut se produire si le flux de travail utilise le déclencheur Balises client ajoutées et inclut l’action Ajouter des balises client.

Si la limite est atteinte, vous recevez une erreur GraphQL mis au ralenti. Cette erreur peut affecter d’autres flux de travail lorsqu’ils tentent de s’exécuter, alors résolvez-la immédiatement si elle se produit.

Les actions Shopify nécessitent une ou plusieurs ressources, telles qu’un produit, un client ou une commande, pour s’exécuter. Si la ressource nécessaire n’est pas disponible, l’action ne peut pas s’exécuter comme prévu. Par exemple, une commande peut être créée dans l’interface administrateur Shopify sans client. Si vous exécutez une action, telle que Ajouter des balises de client, l’action échoue avec cette erreur.

Pour éviter cette erreur, ajoutez une condition avant l’action pour vérifier si la ressource existe. Dans l’exemple précédent, si vous souhaitez envoyer un e-mail interne dans le même flux de travail que Ajouter des balises de client, vous pouvez placer l’action d’envoi d’e-mail avant l’étape qui pourrait échouer ou utiliser l’une des approches suivantes :

Placez les actions dans des branches parallèles (lorsque 2 branches ou plus sortent d’une étape) :

Ajoutez une condition avant l’action pour vérifier si le client est présent. Par exemple, vous pouvez vérifier si commande / client / id n’est pas vide et existe.

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

Pour résoudre ce problème, assurez-vous que le compte utilisé pour le connecteur peut ouvrir la feuille et dispose d’un accès en modification. Si le mauvais compte est associé, vous pouvez le déconnecter et en connecter un nouveau.

Étapes :

1. Ouvrez un flux de travail existant ou créez-en un nouveau.
2. Ajoutez une action au flux de travail.
3. Sélectionnez le connecteur Google Sheets.
4. Cliquez sur Déconnecter, puis sur Connecter pour reconnecter le bon compte Google.

L’action Envoyer un e-mail de marketing n’envoie pas d’e-mails aux clients qui n’ont pas accepté de les recevoir, et elle échoue de manière permanente si le flux de travail tente de le faire.

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

Cette erreur indique qu’une ressource, telle que client ou commande, a été supprimée avant que le flux de travail ne puisse 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 également au niveau du déclencheur si la ressource est supprimée très rapidement après l’événement déclencheur.

Ce message indique que les exécutions d’un flux de travail prennent beaucoup de temps à s’exécuter. Ce problème est généralement dû à l’utilisation d’une grande quantité de données au sein d’un flux de travail, que Flow met beaucoup de temps à récupérer.

Ces cas sont généralement dus à des chemins de requête profonds qui parcourent plusieurs listes d’articles (par exemple, demander tous les champs méta pour tous les produits de toutes les collections auxquelles un produit appartient) :

Ce phénomène est également souvent corrélé à l’expiration du délai de l’étape de déclenchement d’un flux de travail.

Il est souvent possible d’améliorer les flux de travail qui effectuent une boucle sur tous les champs méta en utilisant un champ méta spécifique. L’accès à plusieurs listes imbriquées (comme tous les produits de toutes les collections d’un produit) ou à des listes particulièrement volumineuses (telles que les définitions de champs méta, qui contiennent tous les champs méta pour tous les objets) peut être involontaire, et la sélection du champ approprié (le produit unique ou un seul champ méta sur un objet) peut améliorer considérablement l’efficacité. Dans d’autres cas, l’utilisation d’une action « Obtenir les données sur le produit/la commande/le client » avec un filtre de requête peut réduire considérablement le nombre d’objets utilisés tout en accédant aux objets pertinents.

Ce message indique que les exécutions d’un flux de travail génèrent une grande quantité de données. La cause est généralement la présence de conditions complexes qui vérifient de nombreux champs, souvent en raison de la vérification de champs sur plusieurs niveaux de listes.

Par exemple, une condition telle que « Pour au moins une balise sur ce client, pour au moins un article du panier, pour au moins une balise sur l’article du panier » peut entraîner l’exécution de nombreuses vérifications et la génération d’une grande quantité de données pour afficher les résultats de ces vérifications :

Ce message indique que les exécutions d’un flux de travail échouent de manière répétée en raison d’un problème temporaire et que les nouvelles tentatives aboutissent rarement. Cela se produit souvent lorsque l’Admin API de Shopify ou l’appli d’un partenaire reçoit un volume élevé de requêtes.