Bedrijfsgegevens ophalen
In workflows die bedrijfsgegevens gebruiken, kun je de actie Bedrijfsgegevens ophalen gebruiken om bedrijfsgegevens op te halen uit je winkel.
Configuratie
Velden
De actie Bedrijfsgegevens ophalen bevat de volgende velden, die worden gebruikt om de query op te bouwen:
| Veld | Beschrijving |
|---|---|
| Gegevens sorteren op | Vereist. De parameters waarop de door de query geretourneerde gegevens 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. |
Querytekenreeks
Dit is een voorbeeldquery om bedrijven 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 bedrijven 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 bedrijfsfilters
- 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 wilt aggregeren, bijvoorbeeld om te tellen hoeveel resultaten er zijn geretourneerd, dan kun je de acties Tellen of Optellen gebruiken.
- Als je de lijst wilt gebruiken voor uitvoer, bijvoorbeeld om een e-mail met alle artikelen te verzenden, kun je de geretourneerde gegevens rechtstreeks in vervolgacties gebruiken.
Om toegang te krijgen tot de geretourneerde gegevens in stappen die na deze actie komen, gebruik je de variabele Get company data. Dit is een lijst met bedrijven. Je kunt deze variabele gebruiken in zowel voorwaarden als acties. Je kunt bijvoorbeeld de lijst met bedrijven verzenden in een Interne e-mail verzenden-actie zoals hier:
{% for single_company in GetCompanyData %}
* {{ single_company.name }}
{% endfor %}Triggers
Je kunt deze actie in elke workflow gebruiken, inclusief de Gepland tijdstip-trigger. In een workflow die de Gepland tijdstip-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 vanuit een app is die de workflow start, worden er niet automatisch gegevens meegestuurd.