Collectiegegevens ophalen
In workflows waarvoor collectiegegevens nodig zijn, kun je de actie Collectiegegevens ophalen gebruiken om collectiegegevens uit je winkel op te halen.
Configuratie
Velden
De actie Collectiegegevens ophalen bevat de volgende velden.
| Veld | Beschrijving |
|---|---|
| Gegevens sorteren op | Vereist. De parameters waarmee de door de zoekterm geretourneerde gegevens worden gesorteerd. |
| Maximumaantal resultaten | Vereist. Het maximumaantal resultaten dat kan worden geretourneerd door de zoekterm die je selecteert. Je kunt er maximaal 100 per keer retourneren. |
| Query | Vereist. Kies uit veelvoorkomende query's of selecteer Geavanceerd om je eigen query aan te maken. |
Querytekenreeks
Dit is een voorbeeldquery om collecties op te halen 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 die beschikbaar is voor de query voor collecties 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 met een query is het handig om het volgende te weten:
- Lijst met beschikbare collectiefilters
- Query's moeten voldoen aan een bepaalde syntaxis
- De waarden van queryvelden zijn niet altijd gedocumenteerd. In sommige gevallen kun je de waarden vinden in de API-documentatie. Je kunt de veldwaarden ook vaak vinden in de URL's in het beheerpaneel wanneer je filtert. Als je bijvoorbeeld bepaalde waarden voor een bestelquery wilt vinden, filter je de pagina Bestellingen in het beheerpaneel en controleer je de URL.
- Je kunt een query uitvoeren of testen in je winkel 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 use-case 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, dan kun je de actie Voor elke gebruiken.
- Als je gegevens moet aggregeren, bijvoorbeeld om te tellen hoeveel resultaten er zijn geretourneerd, dan kun je de acties Aantal of Som gebruiken.
- Als je de lijst wilt gebruiken, bijvoorbeeld om een e-mail met alle artikelen te sturen, 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 Collectiegegevens ophalen. Dit is een lijst met collecties. Je kunt deze variabele gebruiken in zowel voorwaarden als acties. Je kunt de lijst met collecties bijvoorbeeld als volgt verzenden in een actie van het type Interne e-mail verzenden:
{% for single_collection in GetCollectionData %}
* {{ single_collection.title }}
{% 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 vanuit een app is die de workflow start, worden er niet automatisch gegevens meegestuurd.