Utilisation de champs d’API avec des arguments dans Shopify Flow pour créer des variables

Certaines variables nécessitent des paramètres supplémentaires pour fonctionner correctement dans un flux de travail Shopify Flow. Ces paramètres sont des arguments dont vous devez déclarer les valeurs avant que la variable ne soit considérée comme complète et utilisable par le flux de travail.

Par exemple, le champ product.inCollection détermine si un produit figure ou non dans une collection spécifiée et renvoie un résultat booléen true ou false. Cependant, l’argument id de la collection doit être inclus pour ce champ, car sinon la variable ne saura pas quelle collection spécifique vérifier. Pour utiliser le champ correctement, vous devez inclure l’argument dans le champ. Par exemple, interroger product.inCollection(id: "gid://shopify/Collection/123456") pour que Flow puisse déterminer si le produit se trouve ou non dans la collection dont l’ID est 123456, puis renvoyer true ou false comme prévu. Lors de la création de variables dans Shopify Flow, vous n’avez pas besoin de rechercher des valeurs telles que les ID de produits ou de collections. Flow fournit un sélecteur de ressources pour sélectionner la valeur que vous souhaitez, et l’ID est rempli automatiquement.

Pour simplifier l’interrogation des champs contenant des arguments, vous pouvez attribuer un nouveau nom de variable à la variable que vous créez à partir du champ et de l’argument dans Shopify Flow. Par exemple, si le nom de la collection dont l’ID est 123456 est Summer Bestsellers, vous pouvez attribuer à la variable inCollection(id: "gid://shopify/Collection/123456") le nom plus simple de inSummerBestsellers. Ensuite, dans toutes les étapes suivantes du flux de travail, vous pourrez simplement utiliser la variable product.inSummerBestsellers.

Comme les arguments diffèrent en fonction des valeurs qui leur sont attribuées, vous pouvez créer plusieurs nouvelles variables à partir d’un seul champ nécessitant des arguments. Par exemple, vous pouvez créer 3 variables uniques à partir du seul champ product.inCollection :

• product.inCollection(id: "gid://shopify/Collection/123456") peut être product.inSummerBestsellers.
• product.inCollection(id: "gid://shopify/Collection/654321") peut être product.inSwimwear.
• product.inCollection(id: "gid://shopify/Collection/112233") peut être product.inBeachAccessories.

Champs GraphQL Admin API pris en charge dans Shopify Flow

Shopify Flow prend en charge les champs suivants dans l’API GraphQL Admin API avec les arguments requis :

• channel.hasCollection
• collection.hasProduct
• collection.publishedOnChannel
• collection.publishedOnPublication
• companyLocation.inCatalog
• inventoryItem.inventoryLevel
• location.inventoryLevel
• metaobject.field
• market.assignedCustomization
• marketLocalizableResource.marketLocalizations
• product.inCollection
• product.publishedOnChannel
• product.publishedOnPublication
• product.restrictedForResource
• publication.hasCollection
• publishable.publishedOnChannel
• publishable.publishedOnPublication
• sellingPlanGroup.appliesToProduct
• sellingPlanGroup.appliesToProductVariant
• sellingPlanGroup.appliesToProductVariants
• 20 champs de type translations, tels que collection.translations et product.translations

Champs GraphQL Admin API non pris en charge dans Shopify Flow

Shopify Flow ne prend pas en charge les champs suivants :

• deliveryCarrierService.availableServicesForCountries
• inventoryLevel.quantities
• return.suggestedFinancialOutcome
• return.suggestedRefund
• shop.search

Pour utiliser les données de ces champs non pris en charge dans votre flux de travail, vous devez utiliser une action Envoyer une requête HTTP.

Création d’une variable à partir d’un champ contenant un argument

Vous pouvez créer une variable dans Shopify Flow pour tout champ pris en charge nécessitant un argument. Il vous suffit de créer la variable une seule fois dans un flux de travail donné, car la variable reste disponible en tant qu’option dans toutes les étapes suivantes du flux de travail.

La variable que vous créez n’est partagée avec aucun autre flux de travail. Par conséquent, pour l’utiliser dans un autre flux de travail, vous devez l’y ajouter à nouveau.

Étapes :

1. Dans un flux de travail Shopify Flow, cliquez sur Ajouter une variable dans une action ou une condition.
2. Sélectionnez un champ qui nécessite un argument. Ces champs affichent un bouton +. Ensuite, cliquez sur + Créer une variable.
3. Dans la boîte de dialogue Créer une variable , effectuez les étapes suivantes :
   1. En fonction du champ que vous avez sélectionné, définissez une valeur pour l’argument requis.
   2. Facultatif : dans le champ Nouveau nom de variable, personnalisez le nom que vous souhaitez donner à la nouvelle variable. Ce nom ne s’applique qu’au flux de travail actuel.
   3. Cliquez sur Ajouter pour actualiser le panneau de sélection de variables.

Après avoir ajouté la nouvelle variable à un flux de travail, celle-ci reste disponible en tant qu’option de champ et vous pouvez la référencer rapidement dans les étapes ultérieures. Lorsque vous choisissez Ajouter une variable, elle s’affiche imbriquée sous l’option de champ d’origine dans la liste des champs.

Création d’une variable à partir d’un champ méta dans Shopify Flow

Les champs méta sont un type de variable comportant des champs qui nécessitent des arguments. L’obtention de données de champ méta dans un flux de travail Shopify Flow diffère légèrement de l’obtention de données de champ standard pour d’autres variables, car c’est vous qui créez et définissez les valeurs des champs namespace et key du champ méta. Elles sont donc toujours propres à votre boutique.

Par exemple, le champ product.inCollection nécessite toujours l’argument id, quelle que soit la boutique dans laquelle vous travaillez. Cependant, comme vous définissez l’espace de nom et la clé pour chaque champ méta que vous créez dans votre boutique, les arguments requis sont personnalisés. Ainsi, une variable pour un champ méta de produit qui recueille les instructions d’entretien d’un vêtement d’été peut être product.careGuideSummer.value, ou une variable pour un champ méta de produit qui enregistre l’ID de la tranche d’âge à laquelle le produit est destiné peut être product.ageGroup.value_item.taxonomyReference.id. C’est vous qui déterminez entièrement les noms de champs et les arguments.

En savoir plus sur les champs méta dans Shopify Flow.