Récupérer les entrées de métaobjet

Vous pouvez utiliser l’action Récupérer les entrées de métaobjet pour récupérer une liste d’entrées pour un métaobjet dans votre boutique sur la base de la requête facultative. Pour en savoir plus, consultez la documentation sur les métaobjets.

Configuration

Champs

L’action Récupérer les entrées de métaobjet contient un menu déroulant permettant de spécifier la définition de métaobjet ainsi que les champs suivants, qui sont utilisés pour créer la requête :

Chaîne de requête

Voici un exemple de requête permettant d’obtenir les entrées de métaobjet si la valeur d’un champ email correspond à l’adresse e-mail figurant sur une commande :

{{fields.email}}:"{{order.email}}"

Voici un exemple de requête permettant d’obtenir les entrées de métaobjet 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 de métaobjets et peut être utilisée plusieurs fois ou combinée à d’autres variables. La variable Liquid scheduledAt est disponible pour les flux de travail qui ont utilisé le déclencheur Heure programmée. La balise Liquid date_minus est une balise Flow spéciale qui vous permet de soustraire une durée à une date.

Lorsque vous effectuez des requêtes sur des données, il est utile de savoir ce qui suit :

• Liste des filtres de métaobjet disponibles
• L’interrogation de métaobjets par valeur de champ nécessite que le filtrage soit activé pour le métaobjet. Cette option peut être activée dans les options pour les données personnalisées de l’interface administrateur Shopify.
• 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 ces 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 des filtres. 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.
• Soyez attentif à ce qui se passe si votre requête échoue. Souvent, l’API renverra tous les résultats (au lieu d’aucun).

Données renvoyées

Toutes les actions Obtenir des données renvoient une liste contenant entre 0 et 100 ressources. Selon votre cas d’utilisation, vous pouvez utiliser ces données de plusieurs façons :

• Si vous devez traiter chaque article de la liste individuellement, par exemple pour ajouter une balise à chacun d’eux, vous pouvez alors utiliser l’action Pour chaque.
• Si vous devez agréger des données, par exemple pour compter le nombre de résultats renvoyés, vous pouvez alors utiliser les actions Compter ou Sommer.
• 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 Obtenir les entrées de métaobjet, qui est une liste d’entrées de métaobjet. Vous pouvez utiliser cette variable dans des conditions et des actions. Par exemple, vous pouvez envoyer la liste des paires clé-valeur pour les entrées de métaobjet dans une action Envoyer un e-mail interne comme suit :

{% for getMetaobjectEntries_item in getMetaobjectEntries %}
Key-value pairs for entry:
  {% for fields_item in getMetaobjectEntries_item.system.fields %}
    {{fields_item.key}}:{{fields_item.value}}
  {% endfor %}
{% 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. Puisqu’aucun événement particulier dans votre boutique ou provenant d’une application ne démarre le flux de travail, aucune donnée n’est automatiquement incluse.

Détails de l’API

• Ressource de métaobjet
• Filtres de requête de métaobjet
• Interroger des métaobjets par valeur de champ