Locatiegegevens ophalen

In workflows waarvoor locatiegegevens nodig zijn, kun je de actie Locatiegegevens ophalen gebruiken om locatiegegevens uit je Shopify-winkel op te halen. Locaties zijn alle plekken waar je voorraad opslaat, producten verkoopt of bestellingen verzendt of afhandelt.

Op deze pagina

Configuratie

Velden

De actie Locatiegegevens ophalen bevat de volgende velden.

Velden die worden gebruikt in de acties Gegevens ophalen.
Veld	Beschrijving
Gegevens sorteren op	Vereist. De parameters waarop de gegevens die door de zoekopdracht worden geretourneerd, worden gesorteerd.
Maximum aantal resultaten	Vereist. De maximale hoeveelheid resultaten die kunnen worden geretourneerd door de zoekopdracht 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 locaties waarvoor afhalen in de winkel is ingeschakeld:

pickup_in_store:enabled

De variabele pickup_in_store is een filter dat beschikbaar is voor de locatiequery en kan meerdere keren worden gebruikt of worden gecombineerd met andere variabelen.

Bij het uitvoeren van query's is het handig om het volgende te weten:

Lijst met beschikbare locatiefilters
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 raadplegen. Je kunt de veldwaarden ook vaak vinden in de URL's in het beheerpaneel wanneer je filtert. Als je bijvoorbeeld een aantal querywaarden voor bestellingen wilt vinden, filter je de pagina Bestellingen in het beheerpaneel 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 Gegevens ophalen-acties retourneren een lijst van 0 tot 100 resources. Afhankelijk van je use-case, wil je deze gegevens misschien op verschillende manieren gebruiken:

Als je elk lijstitem afzonderlijk wilt verwerken, bijvoorbeeld om aan elk item een tag toe te voegen, dan kun je de actie Voor elke gebruiken.
Als je gegevens wilt aggregeren, zoals het aantal geretourneerde resultaten tellen, dan kun je de acties Tellen of Som gebruiken.
Als je de lijst als uitvoer wilt gebruiken, bijvoorbeeld om een e-mail met alle items te verzenden, 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 Get location data. Dit is een lijst met locaties. Je kunt deze variabele gebruiken in zowel voorwaarden als acties. Je kunt de lijst met locaties bijvoorbeeld als volgt verzenden in een actie Interne e-mail verzenden:

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

Triggers

Je kunt deze actie in elke workflow gebruiken, inclusief de Geplande tijd-trigger. In een workflow die de Geplande tijd-trigger gebruikt, start de workflow op een door jou opgegeven tijdstip en niet als gevolg 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-referentie

Zie de locatiequery voor meer informatie over de API die in deze actie wordt gebruikt.