Gegevens van bedrijfslocatie ophalen
In workflows die gegevens van bedrijfslocaties gebruiken, kun je de actie Gegevens van bedrijfslocatie ophalen gebruiken om informatie over bedrijfslocaties op te halen uit je winkel.
Configuratie
Velden
De actie Gegevens van bedrijfslocatie ophalen bevat de volgende velden, die worden gebruikt om de query op te bouwen:
| Veld | Beschrijving |
|---|---|
| Gegevens sorteren op | Vereist. De parameters waarop de gegevens die door de zoekopdracht worden geretourneerd, worden gesorteerd. |
| Maximum aantal resultaten | Vereist. Het maximum aantal resultaten dat kan 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 bedrijfslocaties die 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 voor bedrijfslocaties 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 filters voor bedrijfslocaties
- Query's moeten een bepaalde syntaxis volgen
- De waarden van queryvelden zijn niet altijd gedocumenteerd. In sommige gevallen kun je de waarden vinden door in de API-documenten te kijken. Je kunt de veldwaarden ook vaak vinden in de URL's in het beheerpaneel wanneer je filtert. Om bijvoorbeeld bepaalde querywaarden voor bestellingen te 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 moet verwerken, bijvoorbeeld om voor elk item een tag toe te voegen, kun je de actie Voor elke gebruiken.
- Als je gegevens wilt aggregeren, bijvoorbeeld om te tellen hoeveel resultaten er zijn geretourneerd, kun je de acties Tellen of Sommeren gebruiken.
- Als je de lijst nodig hebt, bijvoorbeeld om een e-mail met alle artikelen te sturen, dan kun je de geretourneerde gegevens rechtstreeks in vervolgacties gebruiken.
Gebruik de variabele Get company location data, een lijst met bedrijfslocaties, om toegang te krijgen tot de geretourneerde gegevens in stappen die op deze actie volgen. Je kunt deze variabele in zowel voorwaarden als acties gebruiken. Je kunt de lijst met locaties bijvoorbeeld als volgt in een Interne e-mail verzenden-actie versturen:
{% for single_company in GetCompanyLocationData %}
* {{ single_company.name }}
{% 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 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.