Productgegevens ophalen

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

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 die bepalen hoe de gegevens die door de zoekquery zijn opgehaald gesorteerd worden.
Maximaal aantal resultaten	Vereist. Het maximumaantal resultaten dat kan worden geretourneerd door de zoekquery die je selecteert. Je kunt er maximaal 100 tegelijk retourneren.
Query	Vereist. Kies uit veelgebruikte query's of selecteer Geavanceerd om een eigen query te maken.

Tekenreeks query

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 dat beschikbaar is in de query Producten. Je kunt deze variabele meerdere keren gebruiken of combineren met andere variabelen. De Liquid-variabele scheduledAt is beschikbaar in workflows die de trigger Gepland tijdstip 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 volgende handig om te weten:

Lijst met beschikbare filters voor producten - Query's moeten een bepaalde syntaxis volgen.
Queryveldwaarden worden niet altijd gedocumenteerd. In sommige gevallen kun je de waarden vinden door naar de API-documentatie te kijken. Je kunt ook vaak de veldwaarden in de URL's in het Shopify-beheercentrum vinden wanneer je filtert. Als je bijvoorbeeld enkele querywaarden voor bestellingen wilt zoeken, filter je de pagina Bestellingen in het Shopify-beheercentrum en controleer je de URL.
Je kunt een zoekopdracht uitvoeren of testen in je winkel met behulp van de Shopify GraphiQL-app.
Let op wat er gebeurt als de query mislukt. Vaak retourneert de API alle resultaten (in plaats van geen resultaten).

Geretourneerde gegevens

Alle acties Gegevens ophalen retourneren een lijst met tussen de 0 en 100 bronnen. Afhankelijk van waarvoor de lijst bedoeld is, kun je deze gegevens op verschillende manieren gebruiken:

Als je elk artikel in de lijst afzonderlijk wilt verwerken, bijvoorbeeld om een tag voor elk toe te voegen, kun je de actie Voor elk gebruiken.
Als je gegevens wilt verzamelen, zoals het aantal geretourneerde resultaten, kun je de actie Aantal of Som gebruiken.
Als je de lijst wilt exporteren, bijvoorbeeld voor het verzenden van een e-mail met alle artikelen, kun je geretourneerde gegevens rechtstreeks in vervolgacties gebruiken.

Gebruik de variabele Productgegevens ophalen, een lijst met producten, om toegang te krijgen tot de geretourneerde gegevens in stappen die op deze actie volgen. Je kunt deze variabele zowel in voorwaarden als in acties gebruiken. Je kunt de lijst met producten bijvoorbeeld als volgt verzenden in een actie Interne e-mail verzenden:

{% for single_product in GetProductData %}
- {{ single_product.name }}
{% endfor %}

Triggers

Je kunt deze actie in elke workflow gebruiken, waaronder de triggerGeplande tijd. In een workflow met de trigger Geplande tijd begint de workflow op een tijd die je hebt opgegeven in plaats van als reactie op een gebeurtenis. Gegevens worden niet automatisch opgenomen omdat er geen specifieke gebeurtenis in je winkel of een app is waardoor de workflow start.

API-gegevens

Templates

Voeg in de toekomst producten met een tag toe aan een collectie

Haal op een tijdstip in de toekomst alle producten met een bepaalde tag op en voeg ze toe aan een collectie. Template bekijken

Verwijder inactieve producten

Verwijder producten zonder voorraad die al een jaar niet zijn bijgewerkt. Template bekijken

Producten met een bepaalde tag in de toekomst publiceren

Haal op een datum in de toekomst producten met een bepaalde tag op en publiceer ze. Gebruik de trigger Geplande tijd en de actie Productgegevens ophalen. Template bekijken

Tag 'nieuw product' verwijderen 90 dagen nadat het product is gemaakt

Elke dag worden maximaal 100 producten opgehaald die meer dan 90 dagen geleden zijn aangemaakt en die nog steeds de tag 'nieuw' hebben. De workflow verwijdert dan die tags voor elk product. Template bekijken

Plannen dat producten op een bepaalde datum en tijd uit de webshop worden verwijderd

Verwijder op één datum in de toekomst producten uit de webshop op basis van tag, ID of SKU. Maakt gebruik van de trigger Geplande tijd, de actie Productgegevens ophalen en de lus Voor elk. Template bekijken

Stuur een dagelijks e-mailoverzicht met producten die niet op voorraad zijn

Haalt elke dag alle producten op die nul voorraad hebben en stuurt een e-mailoverzicht. Gebruikt Productgegevens ophalen en de trigger Geplande tijd. Template bekijken

Stuur een melding per e-mail wanneer een variant is toegevoegd met een dubbele SKU

Kijkt of andere varianten dezelfde SKU gebruiken wanneer een nieuwe variant wordt toegevoegd. Als dat zo is, wordt er een interne e-mail gestuurd met links naar de desbetreffende producten en varianten. Template bekijken

Productvarianten in de uitverkoop volgen met behulp van een productmetaveld

Hiermee stel je een metaveld in voor een product als minstens een van de bijbehorende varianten in de uitverkoop is. Dit kan handig zijn als je volgt welke producten op dit moment in de uitverkoop zijn. Template bekijken