Artikelgegevens ophalen

In workflows waarvoor gegevens over blogartikelen nodig zijn, kun je de actie Artikelgegevens ophalen gebruiken om artikelinformatie uit je Shopify-winkel op te halen.

Opmerking

Dit is een type Gegevens ophalen-actie. Raadpleeg Schema's, gegevens ophalen en loops uitvoeren in workflows in Shopify Flow als je wilt weten hoe je dit type actie gebruikt in combinatie met de trigger Geplande tijd en For each-loops.

Configuratie

Velden

De actie Artikelgegevens ophalen bevat de volgende velden:

Velden die worden gebruikt in de Gegevens ophalen-acties.

Veld	Beschrijving
Gegevens sorteren op	Vereist. De parameters waarop de geretourneerde gegevens van de zoekopdracht worden gesorteerd.
Maximaal aantal resultaten	Vereist. Het maximale aantal resultaten dat kan worden geretourneerd door de geselecteerde zoekopdracht. Je kunt er maximaal 100 tegelijk retourneren.
Query	Vereist. Kies uit algemene query's of selecteer Geavanceerd om er zelf een aan te maken.

Query-tekenreeks

Dit is een voorbeeldquery voor het ophalen van artikelen die de afgelopen dag zijn gepubliceerd:

published_at:<='{{ scheduledAt }}' AND published_at:>'{{ scheduledAt | date_minus: "1 day" }}'

De variabele published_at is een filter dat beschikbaar is in de artikelenquery en meerdere keren kan worden gebruikt of kan worden gecombineerd met andere variabelen. 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 opvragen van gegevens is het handig om het volgende te weten:

• Lijst met beschikbare artikelfilters

• Query's moeten een bepaalde syntaxis volgen

• Queryveldwaarden zijn niet altijd gedocumenteerd. In sommige gevallen kun je de waarden vinden door de API-documentatie te raadplegen. Je kunt de veldwaarden vaak ook in de URL's in het beheercentrum vinden wanneer je filtert. Filter bijvoorbeeld de pagina Bestellingen in het beheercentrum en controleer vervolgens de URL om bepaalde querywaarden voor bestellingen te vinden.

• Je kunt een query in je winkel uitvoeren of testen met behulp van de Shopify GraphiQL-app.

• Houd er rekening mee wat er gebeurt als je query mislukt. Vaak retourneert de API dan alle resultaten (in plaats van geen).

Geretourneerde gegevens

Alle Gegevens ophalen-acties retourneren een lijst met 0 tot 100 resources. Afhankelijk van je usecase kun je deze gegevens op verschillende manieren gebruiken:

• Als je elk lijstitem afzonderlijk wilt verwerken, bijvoorbeeld om voor elk item een tag toe te voegen, dan kun je de actie For each gebruiken.
• Als je gegevens moet aggregeren, bijvoorbeeld om te tellen hoeveel resultaten zijn geretourneerd, dan kun je de acties Count of Sum gebruiken.
• Als je een output van de lijst nodig hebt, zoals het verzenden van een e-mail met alle items, kun je de geretourneerde gegevens rechtstreeks gebruiken in de daaropvolgende acties.

Als je de geretourneerde gegevens wilt openen in stappen die na deze actie komen, gebruik je de variabele Artikelgegevens ophalen. Dit is een lijst met artikelen. Je kunt deze variabele zowel in voorwaarden als acties gebruiken. Je kunt de lijst met artikelen bijvoorbeeld als volgt verzenden in de actie Interne e-mail verzenden:

{% for single_article in GetArticleData %}
    * {{ single_article.title }}
    {% endfor %}

Opmerking

Als een Gegevens ophalen-actie meerdere keren in één workflow wordt gebruikt, wordt er een cijfer aan de variabelenaam toegevoegd. In een workflow die bijvoorbeeld twee keer de actie Bestelgegevens ophalen gebruikt, is de eerste variabele voor geretourneerde gegevens getOrderData en de tweede getOrderData1. Deze naam kan niet worden aangepast.

Triggers

Je kunt deze actie in elke workflow gebruiken, inclusief bij de trigger Geplande tijd. In een workflow met de trigger Geplande tijd, start de workflow op een door jou opgegeven tijdstip en niet door een specifieke gebeurtenis. Omdat er geen specifieke gebeurtenis in je winkel of van een app is die de workflow start, worden er niet automatisch gegevens opgenomen.

API-referentie

Zie de artikelenquery voor meer informatie over de API die in deze actie wordt gebruikt.