Déclencheurs de métachamps
Déclenchez un workflow Shopify Flow quand un métachamp change, pour 10 types de propriétaires : produit, variante, client, commande, page et plus.
Les déclencheurs de métachamp se déclenchent lorsqu’une définition de métachamp spécifique change, quel que soit le type de propriétaire parmi les 10 proposés. Vous choisissez les métachamps à surveiller, une définition à la fois ; ainsi, une boutique comportant des centaines de métachamps ne déclenchera ces événements que pour ceux qui intéressent un workflow donné.
Types de propriétaires avec assistance
Produit, Variante de produit, Collection, Client, Commande, Entreprise, Site de l'entreprise, Blog, Article de blog et Page.
En configurer un
L'exemple présenté sur cette page surveille un métachamp de produit appelé « Rating » (custom.rating), le type de valeur qu'une application d'avis enregistre.
1. Sélectionnez le métachamp
- Ouvrez la section « Déclencheurs de métachamps » dans le menu de navigation de l'application.
- Cliquez sur « Ajouter un déclencheur ».
- Choisissez le type de ressource auquel appartient le métachamp, par exemple « Produit ».
- Sélectionnez la définition du métachamp dans la liste (effectuez une recherche par nom s'il y en a plusieurs), puis cliquez sur « Ajouter un déclencheur ».
Seuls les métachamps pour lesquels une définition a été créée sont répertoriés (interface d'administration Shopify, Paramètres, Données personnalisées). La liste est conservée pendant une heure ; il se peut donc qu'une définition que vous venez de créer ne figure pas dans la liste : cliquez sur « Actualiser les métachamps » à côté de « Ajouter un déclencheur » et rouvrez la boîte de dialogue.
2. Le métachamp est désormais surveillé
Le métachamp apparaît dans la liste avec la mention « Actif ». Il n'y a rien d'autre à activer : le fait de l'ajouter ici revient à l'activer. La suppression met fin à sa surveillance.
L'application enregistre d'abord la valeur actuelle de ce métachamp dans vos enregistrements existants, de sorte que la toute première modification s'effectue déjà avec l'ancienne valeur correcte.
3. Ce que représente un événement
Dès lors, chaque modification apportée à ce métachamp déclenche l'événement « Métachamp Update » dans Shopify Flow. Cet événement contient l'espace de noms et la clé, l'enregistrement auquel il se rapporte, la nouvelle valeur, ainsi que previousValue, c'est-à-dire la valeur antérieure du métachamp. previousValue est vide lorsque le métachamp vient d'être défini pour la première fois. Cela vaut également pour un métachamp déjà renseigné lors de la création de l’enregistrement, par exemple un client créé via un formulaire dont les réponses sont stockées dans des métachamps : l’événement se déclenche une seule fois, avec une valeur previousValue vide.
Dans cet exemple, la note est passée de 4,5 à 2,5. Une condition de workflow « la valeur est inférieure à 3 et la valeur précédente est égale ou supérieure à 3 » se déclenche une seule fois, au moment où la note passe en dessous de 3, et non à chaque modification ultérieure. Étape par étape : Déclencheurs de métachamps, étape par étape.
Les déclencheurs génériques et les déclencheurs typés
Il existe deux façons de prendre en compte les modifications apportées aux métachamps :
| Déclencheur | Couverture | Fournit |
|---|---|---|
| Mise à jour de Métachamp | Les 10 types de propriétaires | Espace de noms, clé, identifiant du propriétaire, ancienne et nouvelle valeur |
| Mise à jour de la commande des métachamps | Commandes uniquement | La même chose, avec en plus la commande sous forme de référence native Shopify Flow |
| Mise à jour des métachamps des produits | Produits uniquement | La même chose, avec en plus le produit en tant que référence native |
| Mise à jour des métachamps clients | Réservé aux clients | La même chose, avec en plus le client comme référence native |
| Mise à jour des métachamps des variantes de produit | Uniquement les variantes de produit | La même chose, avec en plus le produit parent en tant que référence native |
Utilisez un déclencheur de type « typé » lorsque votre workflow doit agir sur la ressource elle-même, par exemple pour attribuer une balise à la commande ou lire ses articles. La référence native permet à Shopify Flow d'utiliser directement ses propres actions Shopify sur cette ressource, sans étape de recherche.
Utilisez le déclencheur générique lorsque vous avez simplement besoin de savoir qu'une valeur a changé, ou lorsque vous surveillez un type de propriétaire qui ne dispose pas de variante typée.
Les déclencheurs de type disposent chacun de leur propre commutateur sur la page « Déclencheurs » (l'activation d'un workflow Shopify Flow utilisant l'un d'entre eux le met en marche) et se déclenchent en plus du déclencheur générique. Ils partagent un même événement ; par conséquent, l'activation des deux n'entraîne pas de double comptage sur votre quota.
Guides
- Déclencher une Shopify Flow lors des mises à jour des méchamps de commande
- Déclencher l'Shopify Flowation lors de modifications des méta-champs d'un produit
- Déclencher l'Shopify Flow lors de la mise à jour des méta-champs client
- Déclencheurs de métachamps, étape par étape : un exemple concret pour chacun des cinq déclencheurs de métachamps.