Obtention des données d’entreprise
Dans les flux de travail qui utilisent des données d’entreprise, vous pouvez utiliser l’action Obtenir les données d’entreprise pour récupérer les informations sur les entreprises de votre boutique.
Configuration
Champs
L’action Obtenir les données d’entreprise contient les champs suivants, qui sont utilisés pour élaborer la requête :
| Champ | Description |
|---|---|
| Trier les données par | Obligatoire. Les paramètres selon lesquels les données renvoyées par la requête de recherche sont triées. |
| Nombre maximum de résultats | Obligatoire. La quantité maximale 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 | Obligatoire. Choisissez 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 entreprises qui ont été mises à 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 dans la requête Entreprises 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.
Lorsque vous faites des requêtes de données, il est utile de savoir ce qui suit :
- Liste des filtres 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. Autrement, vous pouvez souvent trouver les valeurs des champs dans les URL de l’interface administrateur lorsque vous appliquez un filtre. Par exemple, pour trouver certaines 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 en utilisant l’application Shopify GraphiQL.
- Faites attention à ce qui se passe en cas d’échec de votre requête. Souvent, l’API renvoie tous les résultats (au lieu de n’en renvoyer aucun).
Données renvoyées
Toutes les actions Obtenir des données renvoient une liste de 0 à 100 ressources. Selon votre cas d’utilisation, vous pouvez 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, 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 d’utiliser la liste, par exemple pour envoyer un e-mail contenant 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 Obtenir les données de l’entreprise, qui est une liste d’entreprises. Vous pouvez utiliser cette variable à la fois dans les conditions et dans les actions. Par exemple, vous pouvez envoyer la liste des entreprises dans une action Envoyer un e-mail interne comme ceci :
{% for single_company in GetCompanyData %}
* {{ 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 à 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 application ne démarre le flux de travail, aucune donnée n’est incluse automatiquement.