Anciennes et nouvelles valeurs : comment un workflow peut-il les exploiter ?

Anciennes et nouvelles valeurs : comment un workflow peut-il les exploiter ?

Copier la page

Shopify Flow

Les déclencheurs mis à jour de Flow transmettent à un workflow l'enregistrement tel qu'il se présente actuellement. Les pages d'aide d'Shopify le précisent pour chacun d'entre eux : seules les valeurs actuelles sont disponibles, les valeurs antérieures à la modification ne le sont pas. Pour une alerte signalant qu'un changement est survenu, cela suffit.

De nombreux workflows nécessitent davantage d’informations. « Le prix a baissé de plus de 10 % » nécessite l’ancien prix. « L’identifiant a changé, redirigez l’ancienne URL » nécessite l’ancien identifiant. « Le client s’est désabonné » nécessite de savoir qu’il était abonné auparavant. Chaque déclencheur de changement de cette application comporte ces deux valeurs ; ces workflows constituent donc à la fois une condition et une action, sans code et sans aucune saisie manuelle.

D'où provient la valeur indiquée ci-dessus ?

L'application mémorise la dernière valeur connue des champs qu'elle surveille, pour chaque enregistrement. Lorsque Shopify signale une mise à jour, elle effectue une comparaison et, si un champ surveillé présente une différence, elle déclenche le déclencheur en transmettant les deux valeurs. Deux détails sont importants dans la pratique :

  • La première fois que l'application détecte un enregistrement, elle se contente de le mémoriser. Aucun événement n'est déclenché, car il n'y a rien à comparer. Lorsque vous activez un déclencheur, l'application lit une seule fois vos enregistrements existants en arrière-plan, de sorte que la première modification effective déclenche déjà l'événement. Pour les commandes, elle lit par défaut les 60 derniers jours, et vous pouvez étendre cette période dans l'application.
  • Les valeurs correspondent au moment de la modification. Un workflow déclenché par un déclencheur « Mise à jour » de Flow lit l'enregistrement au moment de son exécution. Si l'enregistrement est à nouveau modifié une seconde plus tard, ou s'il est supprimé, ce workflow prend en compte l'état le plus récent ou ne parvient pas à charger l'enregistrement. Un événement de cette application conserve les valeurs avec lesquelles il a été créé. Vous pouvez les consulter ultérieurement dans l’historique des événements de l’application.
Un événement a été créé dans l'historique des événements, marqué comme « Réussi », avec l'ancien et le nouveau prix
Un événement, affiché dans l'historique des événements de l'application : le prix avant et après la modification.

Ce que vous ne pouvez construire qu'en utilisant la valeur précédente

Workflow Déclencheur La condition qui nécessite l'ancienne valeur Prêt à l'emploi
Rediriger l'ancienne URL lorsqu'un produit ou une collection est renommé(e) Modification de la référence du produit, modification de la référence de la collection aucun : la redirection s'effectue de oldHandle vers newHandle Rediriger les anciennes URL de produits lorsqu'un identifiant de produit change, Rediriger les anciennes URL de collection lorsqu'un identifiant de collection change
Balise les produits dont le prix a baissé de 10 % ou plus Modification du prix d'une variante de produit priceChange.percentChange est inférieur ou égal à -10 Marquez les produits lorsqu'une variante subit une baisse de prix de 10 % ou plus
Indiquez qu'un produit est en promotion, puis retirez cette indication Modification du prix d'une variante de produit priceChange.oldCompareAtPrice.amount est vide et priceChange.newCompareAtPrice.amount ne l'est pas, ou l'inverse Balise les produits comme étant en promotion lorsqu'un prix avant réduction est ajouté, Retirez la balise de promotion lorsqu'un prix avant réduction est supprimé
Valider une commande dès réception d'un paiement en attente Modification du statut financier de la commande oldFinancialStatus est égal à pending et newFinancialStatus est égal à paid Marquer les commandes lorsqu'un paiement en attente est reçu
Prévenez l'entrepôt lorsque l'adresse change après le paiement Modification de l'adresse de livraison de la commande aucun : le message affiche oldShippingAddress et shippingAddress Marquer les commandes lorsque l'adresse de livraison change après le paiement
Balisez les clients qui se désabonnent, puis retirez ces balises lorsqu'ils reviennent Modification du consentement des clients concernant le marketing par e-mail consentState est égal à unsubscribed ; oldConsentState vous indique quelle était sa valeur auparavant Attribuez une balise aux clients lorsqu'ils se désabonnent des e-mails marketing
Conservez l'ancienne référence pour votre ERP ou votre flux Modification de la référence d'une variante de produit aucun : skuChange.oldSku est enregistré dans un métachamp Enregistrer la référence précédente lorsqu'une référence de variante change
Réévaluez la marge lorsqu'un coût augmente Modification du prix d'une variante de produit variantCostChange.percentChange supérieur à 5 Marquez les produits pour un réexamen des marges lorsque le coût d'une variante augmente
Balisez un produit comme étant en rupture de stock une seule fois, dès qu'il franchit le seuil Modification du niveau de stock dans l'emplacement inventoryLevel.oldAvailable est supérieur ou égal à 5 et inventoryLevel.newAvailable est inférieur à 5 Balisez les produits comme étant en rupture de stock lorsque le niveau de stock passe en dessous de cinq

En voici trois autres que les marchands construisent eux-mêmes :

  • Indiquez l'ancienne adresse lorsqu'un client change d'adresse e-mail. L'événement « Changement d'adresse e-mail du client » contient les variables oldEmail et email. Envoyez la notification à oldEmail à l'aide d'une action d'e-mail qui prend une variable comme destinataire, par exemple Workflow Transactional Email. Sans l'ancienne adresse, il n'y a plus personne à avertir.
  • Réagissez à une étape correspondant à un statut personnalisé. Un métachamp loyalty.tier passe de silver à gold : l'événement « Mise à jour du métachamp client » contient les champs metafield.previousValue et metafield.value, ce qui permet au workflow de féliciter le client en cas de passage à un niveau supérieur et de ne rien signaler en cas de passage à un niveau inférieur.
  • Agissez sur une balise supprimée. Lorsqu'une balise est supprimée, l'enregistrement apparaît comme s'il n'avait jamais comporté cette balise. Les balises « Order », « Client », « Product » et « Commande provisoire » sont les balises supprimées. Voir Lancer un workflow lorsqu'une balise spécifique est ajoutée ou supprimée.

Chaque valeur avant et après, par déclencheur

Commandes

Déclencheur Avant et après
Balises de commande ajoutées, balises de commande supprimées addedTags, removedTags, previousTags, currentTags
Modification de la note de commande oldNote, newNote
Modification du statut financier de la commande oldFinancialStatus, newFinancialStatus
Modification du traitement des commandes oldFulfillmentStatus, newFulfillmentStatus et, par ligne ou par expédition, dans changes.items : traité, non traité, suivi mis à jour avec le numéro, l'URL et le nom de l'entreprise
Modification du statut d'affichage de la commande oldDisplayFulfillmentStatus, newDisplayFulfillmentStatus
Modification des attributs des commandes changes.items, avec changeType, key, oldValue et newValue
Modifications apportées aux articles de commande changes.items, avec changeType (ajouté, supprimé, quantité, prix ou variante modifiée) ainsi que l'ancienne et la nouvelle quantité, le prix et la variante
Modification de l'adresse de livraison de la commande shippingAddress et oldShippingAddress, chacun constituant également un champ distinct
Mise à jour de la commande du métachamp metafield.value, metafield.previousValue
Mise à jour de la commande changes.fields et changes.items avec field, oldValue, newValue pour le statut financier, le statut de traitement, les balises, les notes, les articles et les attributs personnalisés

Clients

Déclencheur Avant et après
Balises client ajoutées, balises client supprimées addedTags, removedTags, previousTags, currentTags
Modification de la note client oldNote, newNote
Changement de statut du client oldState, newState
Changement de nom du client firstName, lastName, oldFirstName, oldLastName
Modification de l'adresse e-mail du client email, oldEmail
Changement de numéro de téléphone du client phone, oldPhone
Changement d'adresse du client address et oldAddress, chacun constituant également un champ distinct
Modification du consentement des clients concernant le marketing par e-mail, modification du consentement des clients concernant le marketing par SMS consentState, optInLevel, oldConsentState, oldOptInLevel
Mise à jour des métachamps clients metafield.value, metafield.previousValue
Information destinée à nos clients changes.fields et changes.items pour les balises, les notes et l'état

Produits et variantes

Déclencheur Avant et après
Balises de produit ajoutées, balises de produit supprimées addedTags, removedTags, previousTags, currentTags
Modification du titre du produit, du nom d'affichage, de la description, du statut, du fournisseur et du type l'ancienne et la nouvelle valeur, par exemple oldTitle et newTitle
Produit publié sur la chaîne, produit retiré de la chaîne channels.added, channels.removed, channels.current
Modification du prix d'une variante de produit priceChange.oldPrice, newPrice, oldCompareAtPrice, newCompareAtPrice, delta, percentChange, direction
Modification du prix unitaire d'une variante de produit unitPriceChange.oldUnitPrice, newUnitPrice, delta, percentChange, direction
Modification du prix d'une variante de produit variantCostChange.oldCost, newCost, delta, percentChange, direction
Modification de la référence d'une variante de produit skuChange.oldSku, newSku
Modification du code-barres d'une variante de produit barcodeChange.oldBarcode, newBarcode, les listes des anciens et des nouveaux codes-barres, added, removed
Mise à jour des métachamps de produit, mise à jour des métachamps de variante de produit metafield.value, metafield.previousValue
Mise à jour du produit changes.fields et changes.items pour le titre, l'identifiant, la description, le statut, le fournisseur, le type de produit et les balises, et pour chaque variante : le prix, le prix avant réduction, la référence produit (SKU), le code-barres, la politique de gestion des stocks, la taxabilité, le titre, les options et l'image

Stocks, collections, emplacements et bien plus encore

Déclencheur Avant et après
Modification du niveau de stock, rupture de stock et réapprovisionnement à l'emplacement inventoryLevel.oldAvailable``newAvailable``delta``percentChange``direction, avec les emplacements
Modification du titre, de l'identifiant et de la description de la collection l'ancienne et la nouvelle valeur
Mise à jour de l'emplacement, Actualité de l'entreprise, Mise à jour de l'emplacement de l'entreprise, Mise à jour des réductions, Mise à jour du blog, Mise à jour d'un article de blog, Mise à jour d'une page changes.fields et changes.items de l'enregistrement, systématiquement
Mise à jour de la collection, mise à jour des commandes provisoires, mise à jour du marché la même liste changes, lorsque l'option Envoyer les anciennes et les nouvelles valeurs est activée
Les dix critères de classement pour les commandes provisoires la même structure que les commandes : balises, remarque, attributs, articles, statut, e-mail et adresses
Mise à jour des métachamps pour 15 types d'enregistrements metafield.value, metafield.previousValue

Référence complète sur les déclencheurs répertorie chaque déclencheur avec tous ses champs.

Les chiffres sont déjà calculés

Les conditions de Flow se comparent, elles ne font pas de calculs, et les montants financiers sont transmis à Flow sous forme de texte. Ainsi, l'expression « a baissé de plus de 10 % » ne peut pas être calculée au sein d'un workflow à partir de deux prix. Les déclencheurs « prix », « prix unitaire », « coût » et « stock » transmettent donc le résultat sous forme de chiffres :

Domaine Signification Exemple
delta nouvelle valeur moins ancienne valeur -5
percentChange la variation exprimée en pourcentage de l'ancienne valeur -12.5 signifie une baisse de 12,5 %
direction increase, decrease ou unchanged decrease
Sélecteur de variables de Shopify Flow pour la modification du prix d'une variante de produit, avec les paramètres « ancienPrix », « nouveauPrix », « delta », « variationEnPourcentage » et « direction »
Les variables « Prix de la variante de produit modifié » dans le sélecteur de Shopify Flow.
Condition de Shopify Flow : la variable « priceChange.percentChange » est inférieure à -10
Une condition relative au pourcentage calculé par l'application. Aucune étape de programmation n'est nécessaire.
Shopify Flow fournit-il la valeur précédente d'un champ ?

Pas avec ses propres déclencheurs mis à jour. Les pages d'aide d'Shopify concernant les déclencheurs « Produit mis à jour », « Commande mise à jour », « Client mis à jour » et les autres déclencheurs de mise à jour indiquent que seules les valeurs actuelles sont disponibles dans le workflow. Les déclencheurs de cette application transmettent la valeur avant et après la mise à jour.

Puis-je calculer l'ancienne valeur dans Shopify Flow ?

Uniquement si vous l'avez enregistré vous-même avant la modification, par exemple en copiant une valeur dans un métachamp à l'aide d'un autre workflow, puis en la récupérant. Cette copie doit exister avant la première modification et être conservée à chaque étape pour chaque enregistrement. L'application se charge de cette gestion pour les champs qu'elle surveille.

La valeur précédente est-elle disponible pour les métachamps ?

Oui. Chaque déclencheur de métachamp de cette application transmet metafield.previousValue en plus de metafield.value, pour 15 types d'enregistrements. Voir Modifications apportées aux métachamps dans Shopify Flow : les déclencheurs mis à jour et les déclencheurs de métachamps.

Pourquoi n'y a-t-il eu aucune réaction lors du premier changement de disque ?

L'application a besoin d'un point de départ. Lorsqu'un déclencheur est activé, elle lit vos enregistrements existants une seule fois en arrière-plan. Toute modification effectuée avant que cette lecture n'ait atteint l'enregistrement est simplement prise en compte. La modification suivante déclenche l'événement. Historique des événements et dépannage affiche l'état de cette synchronisation.

Prochaines étapes