Déclencheurs de métachamps
Déclenchez un workflow Shopify Flow quand un métachamp change, pour produit, commande, client et 7 autres types de propriétaires.
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éclenche 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 intitulé « Rating » (custom.rating), le type de valeur qu'une application d'avis peut générer.
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) et cliquez sur « Ajouter un déclencheur ».
Seuls les métachamps disposant d'une définition sont répertoriés (Shopify admin, 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 ouvrez à nouveau la boîte de dialogue.
2. Le métachamp est désormais surveillé
Le métachamp apparaît dans la liste comme « 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 qu'un événement implique
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 qu’une variable previousValue indiquant la valeur précédente du métachamp. La variable previousValue est vide lorsque le métachamp vient d’être défini pour la première fois.
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.
Le déclencheur générique 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 des métachamps par commande | 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 | Variante de produit uniquement | 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 « owner » qui ne dispose pas de variantes typées.
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.