Gegevens van conceptbestellingen ophalen

In workflows die gegevens van conceptbestellingen gebruiken, kun je de actie Gegevens van conceptbestellingen ophalen gebruiken om informatie over conceptbestellingen uit je winkel op te halen.

Let op

Dit is een type Gegevens ophalen-actie. Raadpleeg Workflows met planningen, gegevens ophalen en lussen in Shopify Flow voor meer informatie over hoe je dit type actie gebruikt met de trigger Geplande tijd en Voor elke-lussen.

Configuratie

Velden

De actie Gegevens van conceptbestellingen ophalen bevat de volgende velden, die worden gebruikt om de query op te bouwen:

Velden die worden gebruikt in de Gegevens ophalen-acties.

Veld	Beschrijving
Gegevens sorteren op	Vereist. De parameters waarmee de gegevens die door de query worden geretourneerd, worden gesorteerd.
Maximumaantal resultaten	Vereist. Het maximumaantal resultaten dat kan worden geretourneerd door de query die je selecteert. Je kunt er maximaal 100 tegelijk retourneren.
Query	Vereist. Kies uit veelvoorkomende query's of selecteer Geavanceerd om je eigen query aan te maken.

Query-tekenreeks

Dit is een voorbeeldquery voor het ophalen van conceptbestellingen 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 conceptbestellingen en kan meerdere keren worden gebruikt of worden gecombineerd met andere variabelen. De Liquid-variabele scheduledAt is beschikbaar in 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 uitvoeren van een query op gegevens is het handig om het volgende te weten:

• Lijst met beschikbare bestellingsfilters
• Query's moeten een bepaalde syntaxis volgen.
• De waarden van queryvelden zijn niet altijd gedocumenteerd. In sommige gevallen kun je de waarden vinden door de API-documenten te bekijken. Je kunt de veldwaarden ook vaak vinden in de URL's in het beheerpaneel wanneer je filtert. Filter bijvoorbeeld de pagina Bestellingen in het beheerpaneel en controleer vervolgens de URL om enkele querywaarden voor bestellingen te vinden.
• 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 Gegevens ophalen-acties retourneren een lijst van 0 tot 100 resources. Afhankelijk van je gebruiksscenario kun je deze gegevens op verschillende manieren gebruiken:

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

Om toegang te krijgen tot de geretourneerde gegevens in stappen die op deze actie volgen, gebruik je de variabele met de naam Get draft order data, wat een lijst met conceptbestellingen is. Je kunt deze variabele gebruiken in zowel voorwaarden als acties. Je kunt bijvoorbeeld de lijst met conceptbestellingen als volgt verzenden in een actie Interne e-mail verzenden:

{% for single_order in GetDraftOrderData %}
* {{ single_order.name }}
{% endfor %}

Let op

Als een Gegevens ophalen-actie meerdere keren in één workflow wordt gebruikt, wordt er een nummer aan de naam van de variabele toegevoegd. In een workflow die de actie Gegevens van bestellingen ophalen bijvoorbeeld twee keer gebruikt, is de eerste variabele voor geretourneerde gegevens getOrderData en de tweede getOrderData1. Deze naam kan niet worden aangepast.

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.

API-gegevens

• Conceptbestelling-resource
• Queryfilters voor conceptbestellingen

Templates

Dagelijkse melding verzenden met alle openstaande conceptbestellingen

Haal elke dag openstaande conceptbestellingen op, tel ze en verzend een Slack-bericht. Maakt gebruik van de trigger Geplande tijd en de acties Conceptbestellingen ophalen en Tellen. Template bekijken