Déclencheur de métachamp de produit

Déclencheur de métachamp de produit

Copier la page

Lancez un workflow Shopify Flow quand un métachamp de produit change et récupérez l'ancienne et la nouvelle valeur avec Workflow Trigger Extensions.

Un fabricant consigne l'étape de production dans le métachamp Statut de production (custom.production_status) du produit. Chaque fois que cette étape change, par exemple lorsque l'on passe de in_production à quality_check, l'équipe en charge de l'étape suivante doit en être informée.

Cette page explique comment lancer un workflow Shopify Flow dès qu’un métachamp d’un produit est modifié, à l’aide des extensions Workflow Trigger Extensions. Les étapes sont identiques pour tous les métachamps de ce type de ressource ; l’exemple utilise le statut de production (custom.production_status).

Ce dont vous avez besoin

  • Une définition de métachamp. Créez-la dans votre interface d'administration Shopify, sous Paramètres > Métachamps et métaobjets > Produits. Un métachamp sans définition ne peut pas faire l'objet d'un suivi.
  • L'autorisation Accès aux données relatives aux produits, aux variantes et aux collections. Veuillez l'accorder sur la page Autorisations de l'application ; pour plus d'informations, consultez Autorisations et accès aux données.

1. Suivre le métachamp

  1. Ouvrez la section Déclencheurs de métachamps dans l'application, puis cliquez sur Ajouter un déclencheur.
  2. Sélectionnez le type de ressource Produit.
  3. Cochez le métachamp Statut de production. Vous pouvez en cocher plusieurs à la fois ou utiliser l'option Tout sélectionner.
  4. Cliquez sur Ajouter un déclencheur.

Pour suivre tous les métachamps de ce type de ressource, y compris ceux que vous créerez ultérieurement, sélectionnez Tous les métachamps au lieu de cocher chacun d'entre eux individuellement, puis cliquez sur Suivre tous les métachamps.

La boîte de dialogue « Ajouter un déclencheur de métachamp » avec le type de ressource « Produit » et le métachamp « Statut de production » (custom.production_status) coché
Type de ressource : « Produit », la case « Métachamp » est cochée. L'option « Tous les métachamps » permet de suivre tous les métachamps de ce type.

Le nouveau déclencheur affiche Initialisation pendant que l'application lit la valeur actuelle du métachamp sur vos produits existants, puis Actif. C'est grâce à cette première lecture que la toute première modification s'accompagne d'emblée de la bonne valeur précédente.

Si le métachamp ne figure pas dans la liste, cliquez sur Actualiser les métachamps sur la page « Déclencheurs de métachamps » : l'application conserve la liste des définitions pendant une heure.

2. Ce que reçoit le workflow

Chaque modification déclenche l'événement Metafield Update dans Shopify Flow avec les valeurs suivantes :

Variable Valeur
resourceType PRODUCT
resourceId L'identifiant du produit, par exemple gid://shopify/Product/1234567890
metafieldKey Espace de noms et clé, ici custom.production_status
metafield.value La nouvelle valeur
metafield.previousValue La valeur avant la modification ; vide lorsque le métachamp a été défini pour la première fois
metafield.type Le type du métachamp, par exemple single_line_text_field

Mise à jour des métachamps du produit est un deuxième déclencheur pour la même modification. Il se lance en complément de « Mise à jour des métachamps » et intègre le produit en tant que référence native de Flow ; ainsi, les actions produit propres à Shopify s'appliquent à celui-ci sans étape de recherche. Les deux partagent un même événement ; leur utilisation simultanée n'est donc pas comptabilisée deux fois. Activez-le depuis la page Déclencheurs de l’application, ou activez un workflow qui l’utilise.

3. Mettre en place le workflow

  1. Dans Shopify Flow, créez un workflow et sélectionnez le déclencheur Mise à jour du métachamp parmi les extensions de déclencheurs de Workflow Trigger Extensions.
  2. Ajoutez une condition : resourceType est égal à PRODUCT. La mise à jour des métachamps s'applique à chaque type de ressource que vous suivez ; cette condition permet donc de limiter ce workflow aux produits. Si vous suivez plusieurs métachamps de ce type, ajoutez comme deuxième critère : metafieldKey est égal à custom.production_status.
  3. Ajoutez l'action souhaitée. Dans cet exemple, un e-mail interne est envoyé, indiquant l'ancienne et la nouvelle valeur.
Exemple de workflow dans Shopify Flow : mise à jour d'un métachamp, condition sur le type de ressource « PRODUCT » et envoi d'un e-mail interne
Exemple de workflow : le déclencheur, la condition liée au type de ressource et une action.

Commencez par l'exemple

  1. Téléchargez le fichier .flow joint au bas de cette page.
  2. Dans votre interface d'administration Shopify, ouvrez Shopify Flow, cliquez sur Importer et sélectionnez le fichier.
  3. Ouvrez l'étape Envoyer un e-mail interne et saisissez le destinataire. Le fichier ne contient délibérément aucune adresse.
  4. Activez le workflow.

Faites-en le vôtre

  • Ajoutez une deuxième condition sur metafield.value afin d'attribuer chaque étape à une équipe différente.
  • Ajoutez plutôt une balise au produit : sélectionnez l'action Ajouter des balises au produit et insérez {{resourceId}} dans le champ « produit ».
  • Comparez metafield.previousValue à metafield.value afin de ne réagir que lorsqu'une valeur augmente ou diminue.

À quelle vitesse réagit-il ?

Shopify informe l'application lorsqu'un produit est enregistré ; le workflow se lance donc généralement en quelques secondes.

En savoir plus