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

Dans les flux de travail qui utilisent des données d’emplacement d’entreprise, vous pouvez utiliser l’action Récupérer les données d’emplacement d’entreprise pour récupérer les informations sur les emplacements d’entreprise de votre boutique.

Configuration

Champs

L’action Récupérer les données d’emplacement d’entreprise contient les champs suivants, qui sont utilisés pour créer la requête :

Chaîne de requête

Voici un exemple de requête pour obtenir les emplacements d’entreprise qui ont été mis à jour au cours du dernier jour :

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

La variable updated_at est un filtre disponible pour la requête d’emplacements d’entreprise et peut être utilisée plusieurs fois ou combinée avec d’autres variables. La variable Liquid scheduledAt est disponible pour les flux de travail qui utilisent le déclencheur Heure programmée. La balise Liquid date_minus est une balise Flow spéciale qui vous permet de soustraire du temps à une date.

Lors de l’interrogation de données, il est utile de savoir ce qui suit :

• Liste des filtres d’emplacement d’entreprise disponibles
• Les requêtes doivent suivre une certaine syntaxe
• Les valeurs des champs de requête ne sont pas toujours documentées. Dans certains cas, vous pouvez trouver les valeurs en consultant la documentation de l’API. Sinon, vous pouvez souvent trouver les valeurs de champ dans les URL de l’interface administrateur lorsque vous appliquez des filtres. Par exemple, pour trouver des valeurs de requête de commande, filtrez la page Commandes dans l’interface administrateur, puis consultez l’URL.
• Vous pouvez exécuter ou tester une requête dans votre boutique à l’aide de l’appli Shopify GraphiQL.
• Sachez ce qui se passe si votre requête échoue. L’API retournera souvent tous les résultats (au lieu d’aucun).

Données retournées

Toutes les actions Récupérer des données retournent une liste contenant entre 0 et 100 ressources. Selon votre cas d’utilisation, vous souhaiterez peut-être utiliser ces données de différentes manières :

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

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

{% for single_company in GetCompanyLocationData %}
* {{ single_company.name }}
{% endfor %}

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 à l’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 incluse automatiquement.

Référence d’API

• Ressource Emplacements d’entreprise
• Filtres de requête d’emplacements d’entreprise