Metaobjectvermeldingen ophalen

Je kunt de actie Metaobjectvermeldingen ophalen gebruiken om een lijst met vermeldingen voor een metaobject uit je winkel op te halen op basis van de optionele query. Zie de documentatie over metaobjects voor meer informatie.

Configuratie

Velden

De actie Metaobjectvermeldingen ophalen bevat een vervolgkeuzelijst voor het opgeven van de metaobjectdefinitie en de volgende velden, die worden gebruikt om de query op te bouwen:

Querytekenreeks

Dit is een voorbeeldquery voor het ophalen van metaobject-vermeldingen als de waarde van een e-mailveld overeenkomt met het e-mailadres bij een bestelling:

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

Dit is een voorbeeldquery voor het ophalen van metaobject-vermeldingen die in de afgelopen dag zijn bijgewerkt:

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

De variabele updated_at is een filter dat beschikbaar is voor de query Metaobjecten en kan meerdere keren worden gebruikt of worden gecombineerd met andere variabelen. De Liquid-variabele scheduledAt is beschikbaar voor workflows die de trigger Geplande tijd gebruiken. De Liquid-tag date_minus is een speciale Flow-tag waarmee je tijd van een datum kunt aftrekken.

Bij het opvragen van gegevens is het handig om het volgende te weten:

• Lijst met beschikbare metaobjectfilters
• Metaobjecten op veldwaarde queryen vereist dat voor het metaobject filteren is ingeschakeld, wat kan worden ingeschakeld in de opties voor aangepaste gegevens in het Shopify-beheercentrum.
• Query's moeten voldoen aan een bepaalde syntaxis
• Veldwaarden voor query's zijn niet altijd gedocumenteerd. In sommige gevallen zijn de waarden te vinden in de API-documenten. Je kunt de veldwaarden ook vaak vinden in de URL's in het beheercentrum wanneer je filtert. Als je bijvoorbeeld een aantal querywaarden voor bestellingen wilt vinden, filter je de pagina Bestellingen in het beheercentrum en controleer je de URL.
• Je kunt een query in je winkel uitvoeren of testen met de Shopify GraphiQL-app.
• Houd er rekening mee wat er gebeurt als je query mislukt. Vaak retourneert de API alle resultaten (in plaats van geen).

Geretourneerde gegevens

Alle acties van het type Gegevens ophalen retourneren een lijst van 0 tot 100 resources. Afhankelijk van je usecase kun je deze gegevens op verschillende manieren gebruiken:

• Als je elk lijstitem afzonderlijk moet verwerken, bijvoorbeeld om voor elk item een tag toe te voegen, kun je de actie Voor elke gebruiken.
• Als je gegevens moet aggregeren, bijvoorbeeld om te tellen hoeveel resultaten zijn geretourneerd, kun je de acties Tellen of Optellen gebruiken.
• Als je de lijst wilt uitvoeren, bijvoorbeeld om een e-mail te sturen met alle artikelen, dan kun je de geretourneerde gegevens rechtstreeks in vervolgacties gebruiken.

Om toegang te krijgen tot de geretourneerde gegevens in stappen die op deze actie volgen, gebruik je de variabele met de naam Metaobject-vermeldingen ophalen. Dit is een lijst met metaobject-vermeldingen. Je kunt deze variabele in zowel voorwaarden als acties gebruiken. Je kunt bijvoorbeeld de lijst met sleutel-waardeparen voor de metaobject-vermeldingen verzenden in een actie Interne e-mail verzenden, zoals hier:

{% 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 %}

Triggers

Je kunt deze actie in elke workflow gebruiken, inclusief de trigger Geplande tijd. In een workflow die de trigger Geplande tijd gebruikt, start de workflow op een door jou opgegeven tijdstip in plaats van naar aanleiding van een gebeurtenis. Omdat er geen specifieke gebeurtenis in je winkel of van een app is die de workflow start, worden er niet automatisch gegevens meegestuurd.

API-gegevens

• Metaobject-resource
• Queryfilters voor metaobjecten
• Metaobjecten queryen op veldwaarde