Productgegevens ophalen

In workflows die productgegevens gebruiken, kun je de actie Productgegevens ophalen gebruiken om productinformatie uit je winkel op te halen.

Op deze pagina

Configuratie

Velden

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

Velden die worden gebruikt in de acties 'Gegevens ophalen'.
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.

Querytekenreeks

Dit is een voorbeeldquery voor het ophalen van producten 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 voor de productquery en kan meerdere keren worden gebruikt of met andere variabelen worden gecombineerd. 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 is het handig om het volgende te weten:

Lijst met beschikbare productfilters
Query's moeten een bepaalde syntaxis volgen
Queryveldwaarden zijn niet altijd gedocumenteerd. In sommige gevallen zijn de waarden te 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 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 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 wilt verwerken, bijvoorbeeld om aan elk item een tag toe te voegen, kun je de actie Voor elke gebruiken.
Als je gegevens wilt verzamelen, bijvoorbeeld om te tellen hoeveel resultaten er zijn geretourneerd, kun je de acties Tellen of Optellen gebruiken.
Als je de lijst wilt uitvoeren, bijvoorbeeld om een e-mail met alle artikelen te verzenden, kun je de geretourneerde gegevens rechtstreeks in de vervolgacties gebruiken.

Om toegang te krijgen tot de geretourneerde gegevens in stappen die na deze actie komen, gebruik je de variabele met de naam Productgegevens ophalen, wat een lijst met producten is. Je kunt deze variabele gebruiken in zowel voorwaarden als acties. Je kunt bijvoorbeeld de lijst met producten verzenden in een actie Interne e-mail verzenden als volgt:

{% for single_product in GetProductData %}
* {{ single_product.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 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

Sjablonen

Producten met een tag in de toekomst aan een collectie toevoegen

Op een later tijdstip alle producten met een bepaalde tag ophalen en ze vervolgens aan een collectie toevoegen. Template bekijken

Inactieve producten verwijderen

Producten zonder voorraad die in een jaar niet zijn bijgewerkt, verwijderen. Template bekijken

Producten met een bepaalde tag in de toekomst publiceren

Op een toekomstige datum producten met een bepaalde tag ophalen en publiceren. Maakt gebruik van de trigger 'Geplande tijd' en de actie 'Productgegevens ophalen'. Template bekijken

De tag 'nieuw' 90 dagen na het aanmaken van het product verwijderen

Haalt elke dag maximaal 100 producten op die meer dan 90 dagen geleden zijn aangemaakt en die nog steeds de tag 'nieuw' hebben. De workflow verwijdert deze tags vervolgens voor elk product. Template bekijken

Producten inplannen om op de opgegeven datum en tijd uit de webshop te worden verwijderd

Op een specifieke toekomstige datum producten uit de webshop verwijderen op basis van tag, ID of SKU. Maakt gebruik van de trigger 'Geplande tijd', de actie 'Productgegevens ophalen' en de 'voor elke'-loop. Template bekijken

Dagelijks een e-mailoverzicht verzenden met producten die niet op voorraad zijn

Haalt elke dag alle producten op met een voorraad van 0 en verzendt een e-mailoverzicht. Maakt gebruik van de actie 'Productgegevens ophalen' en de trigger 'Geplande tijd'. Template bekijken

E-mailmelding verzenden wanneer een variant met een dubbele SKU wordt toegevoegd

Wanneer een nieuwe variant wordt toegevoegd, wordt gekeken of andere varianten dezelfde SKU gebruiken. Zo ja, dan wordt er een interne e-mail verzonden met links naar de betreffende producten en varianten. Template bekijken

Productvarianten in de uitverkoop volgen met een productmetaveld

Stelt een metaveld in voor een product als ten minste een van de varianten in de uitverkoop is. Dit kan handig zijn om bij te houden welke producten momenteel in de uitverkoop zijn. Template bekijken