Récupérer les données d’emplacement

Dans les flux de travail qui nécessitent des données d’emplacement, vous pouvez utiliser l’action Récupérer les données d’emplacement pour récupérer des informations sur les emplacements de votre boutique Shopify. Les emplacements correspondent à tous les lieux où vous stockez votre stock, vendez des produits, ou expédiez ou traitez des commandes.

Remarque

Il s’agit d’une action de type Récupérer des données. Pour comprendre comment utiliser ce type d’action avec le déclencheur Heure programmée et les boucles Pour chaque, consultez la page Planifications, récupération de données et flux de travail en boucle dans Shopify Flow.

Configuration

Champs

L’action Récupérer les données d’emplacement contient les champs suivants.

Champs utilisés dans les actions Récupérer des données.

Champ	Description
Trier les données par	Requis. Les paramètres par lesquels les données renvoyées par la requête de recherche sont triées.
Nombre maximal de résultats	Requis. Le nombre maximal de résultats pouvant être renvoyés par la requête de recherche que vous sélectionnez. Vous pouvez en renvoyer jusqu’à 100 à la fois.
Requête	Requis. Faites votre choix parmi les requêtes courantes ou sélectionnez Avancé pour créer la vôtre.

Chaîne de requête

Voici un exemple de requête pour obtenir les emplacements pour lesquels le retrait en magasin est activé :

pickup_in_store:enabled

La variable pickup_in_store est un filtre disponible dans la requête Locations et peut être utilisée plusieurs fois ou combinée avec d’autres variables.

Lorsque vous interrogez des données, il est utile de savoir ce qui suit :

• Liste des filtres d’emplacement disponibles

• Les requêtes doivent respecter une certaine syntaxe

• Les valeurs des champs de requête ne sont pas toujours documentées. Dans certains cas, les valeurs peuvent être trouvées en consultant la documentation de l’API. Sinon, vous pouvez souvent trouver les valeurs des champs dans les URL de l’interface administrateur lorsque vous appliquez un filtre. Par exemple, pour trouver des valeurs de requête de commande, filtrez la page Commandes dans l’interface administrateur, puis vérifiez l’URL.

• Vous pouvez exécuter ou tester une requête dans votre boutique à l’aide de l’appli Shopify GraphiQL.

• Faites attention à ce qui se passe si votre requête échoue. Souvent, l’API renvoie tous les résultats (au lieu d’aucun).

Données renvoyées

Toutes les actions Récupérer des données renvoient une liste de 0 à 100 ressources. En fonction de votre cas d’utilisation, vous pouvez utiliser ces données de différentes manières :

• Si vous devez traiter chaque élément de la liste individuellement, par exemple pour ajouter une balise à chacun, vous pouvez utiliser l’action Pour chaque.
• Si vous avez besoin d’agréger des données, par exemple pour compter le nombre de résultats renvoyés, vous pouvez utiliser les actions Compter ou Somme.
• Si vous avez besoin de la liste en sortie, par exemple pour envoyer un e-mail avec tous les articles, vous pouvez utiliser les données renvoyées directement dans les actions suivantes.

Pour accéder aux données renvoyées dans les étapes qui suivent cette action, utilisez la variable nommée Récupérer les données d’emplacement, qui est une liste d’emplacements. Vous pouvez utiliser cette variable dans les conditions et les actions. Par exemple, vous pouvez envoyer la liste des emplacements dans une action Envoyer un e-mail interne comme celle-ci :

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

Remarque

Si une action Récupérer des données est utilisée plusieurs fois dans un même flux de travail, un numéro est ajouté au nom de la variable. Par exemple, dans un flux de travail qui utilise deux fois l’action Récupérer les données de la commande, la première variable pour les données renvoyées est getOrderData et la seconde est getOrderData1. Ce nom ne peut pas être personnalisé.

Déclencheurs

Vous pouvez utiliser cette action dans n’importe quel flux de travail, y compris avec le déclencheur Heure programmée. Dans un flux de travail qui utilise le déclencheur Heure programmée, le flux de travail démarre à une heure que vous avez spécifiée, plutôt qu’à la suite d’un événement. Étant donné qu’aucun événement spécifique dans votre boutique ou provenant d’une appli ne démarre le flux de travail, aucune donnée n’est automatiquement incluse.

Référence d’API

Pour en savoir plus sur l’API utilisée dans cette action, consultez la requête Locations.