Productvariantgegevens ophalen
In workflows die productvariantgegevens gebruiken, kun je de actie Productvariantgegevens ophalen gebruiken om gegevens over productvarianten uit je winkel op te halen.
Configuratie
Velden
De actie Productvariantgegevens ophalen bevat de volgende velden, die worden gebruikt om de query samen te stellen:
| Veld | Beschrijving |
|---|---|
| Gegevens sorteren op | Vereist. De parameters waarmee de gegevens die door de zoekopdracht worden geretourneerd, worden gesorteerd. |
| Maximumaantal resultaten | Vereist. Het maximumaantal 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 productvarianten die 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 in de query 'Productvarianten' 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.
Het volgende is handig om te weten wanneer je query's gebruikt:
- Lijst met beschikbare filters voor productvarianten
- Query's moeten een bepaalde syntaxis volgen
- 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 querywaarden voor bestellingen wilt vinden, filter je de pagina Bestellingen in het beheerpaneel en controleer je vervolgens 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 acties van het type Gegevens ophalen 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 er zijn geretourneerd, kun je de acties Tellen of Optellen gebruiken.
- Als je de lijst als geheel wilt gebruiken, bijvoorbeeld om een e-mail met alle artikelen te sturen, kun je de geretourneerde gegevens rechtstreeks in vervolgacties gebruiken.
Gebruik de variabele Get product variant data, een lijst met productvarianten, om toegang te krijgen tot de geretourneerde gegevens in stappen die op deze actie volgen. Je kunt deze variabele gebruiken in zowel voorwaarden als acties. Je kunt bijvoorbeeld de lijst met bestellingen als volgt verzenden in de actie Interne e-mail verzenden:
{% for single_variant in GetProductVariantData %}
* {{ single_variant.name }}
{% 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 en niet als gevolg van een gebeurtenis. Omdat er geen specifieke gebeurtenis in je winkel of van een app is die de workflow start, worden er geen gegevens automatisch opgenomen.
API-gegevens
Templates
Gratis artikel (met 100% korting) toevoegen aan nieuwe bestellingen
Deze template voegt een gratis artikel toe aan nieuwe bestellingen als het artikel op voorraad is. De template controleert de voorraad, past een korting van 100% toe en werkt de bestelling bij zonder de klant hiervan op de hoogte te stellen. Deze automatisering kan handig zijn om (1) de klanttevredenheid te verhogen door een gratis verrassingsartikel aan de bestelling toe te voegen, (2) nieuwe of minder bekende producten te promoten door ze als gratis proefmonsters aan bestellingen toe te voegen, of (3) promoties te stroomlijnen door het toevoegen en afprijzen van gratis artikelen te automatiseren. Template bekijken
Wekelijks e-mailoverzicht van productvarianten met lage voorraad verzenden
Deze workflow draait volgens een schema (bijvoorbeeld eenmaal per week). De workflow haalt een lijst op van productvarianten met een lage voorraad, telt de resultaten en verstuurt een e-mailoverzicht met de varianttitels en een link naar de beheerpagina voor de variant. Template bekijken