Obtenir des entrées de métaobjets

Vous pouvez utiliser l'action Obtenir des entrées de métaobjets pour récupérer une liste d'entrées pour un métaobjet depuis votre boutique en fonction de la requête facultative. Consultez la documentation sur les métaobjets pour plus d’informations.

Configuration

Champs

L’action Obtenir des entrées de métaobjets 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 :

Champs utilisés dans les actions « Obtenir des données ».
ChampDescription
Trier les données parObligatoire. Paramètres selon lesquels les données renvoyées par la requête de recherche sont triées.
Nombre maximum de résultatsObligatoire. La quantité maximale de résultats qui peut être renvoyée par la requête de recherche que vous sélectionnez. Vous pouvez en retourner jusqu’à 100 à la fois.
RequêteObligatoire. Choisissez parmi les requêtes courantes ou sélectionnez Avancée pour créer les vôtres.

Chaîne de requête

Il s’agit d’un exemple de requête pour obtenir des entrées de métaobjets si la valeur d'un champ email correspond à l'adresse e-mail sur une commande :

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

Il s’agit d’un exemple de requête pour obtenir des entrées de métaobjets 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 Métaobjets et peut être utilisée plusieurs fois ou combinée à d’autres variables. La variable Liquid scheduledAt est disponible dans les flux de travail qui utilisent le déclencheur Date/heure prévues. La balise Liquid date_minus est une balise Flow spéciale, qui vous permet de soustraire du temps d’une date.

Lorsque vous requerrez des données, il est utile de connaître ce qui suit :

Données renvoyées

Toutes les actions Obtenir des données renvoient une liste entre 0 et 100 ressource. Selon l’usage que vous en faites, vous voudrez peut-être utiliser ces données de différentes manières :

  • Si vous devez gérer chaque article de la liste individuellement, par exemple pour ajouter une balise à chacun, vous pouvez utiliser l’action Pour chacun.
  • Si vous devez agréger les données, telles que le nombre de résultats retournés, vous pouvez utiliser les actions Quantité ou Somme.
  • Si vous avez besoin d’une liste de sorties, comme 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 selon les étapes qui suivent cette action, utilisez la variable appelée Get metaobject entries (Obtenir des entrées de métaobjets), qui est une liste d’entrées de métaobjets. Vous pouvez utiliser cette variable à la fois dans les conditions et les actions. Par exemple, vous pouvez envoyer la liste de paires clé-valeur pour les entrées de métaobjets dans une action Envoyer un e-mail interne comme celle-ci :

{% 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 dans le déclencheur Date/heure prévues. Dans un flux de travail utilisant le déclencheur Date/heure prévues, le flux démarre à un moment que vous avez spécifié, plutôt qu’à la suite d’un événement. Étant donné qu’il n’y a pas d’événement spécifique dans votre boutique ou provenant d’une application qui démarre le flux de travail, aucune donnée n’est incluse automatiquement.

Détails de l’API

Vous ne trouvez pas les réponses que vous recherchez ? Nous sommes là pour vous aider.