Paginagegevens ophalen

In workflows waarvoor paginagegevens nodig zijn, kun je de actie Paginagegevens ophalen gebruiken om pagina-informatie uit je winkel op te halen. Pagina's zijn de webpagina's in je webshop met informatie die zelden verandert, zoals een Over ons-pagina of een Contact-pagina.

Opmerking

Dit is een type Gegevens ophalen-actie. Raadpleeg Schema's, gegevens ophalen en herhalende workflows in Shopify Flow als je wilt weten hoe je dit type actie kunt gebruiken met de trigger Geplande tijd en Voor elke-lussen (For each).

Configuratie

Velden

De actie Paginagegevens ophalen bevat de volgende velden:

Velden die in de acties van het type Gegevens ophalen worden gebruikt.

Veld	Beschrijving
Gegevens sorteren op	Vereist. De parameters waarop de gegevens die door de zoekopdracht worden geretourneerd, 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 veelgebruikte query's of selecteer Geavanceerd om je eigen query te maken.

Query-tekenreeks

Dit is een voorbeeldquery om gepubliceerde pagina's op te halen:

published_status:published

De variabele published_status is een filter dat beschikbaar is op de Pages-query en kan meerdere keren worden gebruikt of worden gecombineerd met andere variabelen.

Het is handig om het volgende te weten bij het opvragen van gegevens:

• Lijst met beschikbare paginafilters

• Query's moeten een bepaalde syntaxis volgen

• Queryveldwaarden worden niet altijd gedocumenteerd. In sommige gevallen kun je de waarden vinden door de API-documentatie te bekijken. Je kunt de veldwaarden ook vaak vinden in de URL's in het beheerpaneel wanneer je filtert. Om bijvoorbeeld enkele waarden van de Order-query te 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 behulp van de Shopify GraphiQL-app.

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

Geretourneerde gegevens

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

• Als je elk lijstitem afzonderlijk moet afhandelen, bijvoorbeeld om voor elk item een tag toe te voegen, dan kun je de actie Voor elke gebruiken.
• Als je gegevens moet samenvoegen, bijvoorbeeld om te tellen hoeveel resultaten er zijn geretourneerd, kun je de acties Tellen of Som gebruiken.
• Als je de lijst als output wilt gebruiken, bijvoorbeeld om een e-mail met alle artikelen te verzenden, kun je de geretourneerde gegevens rechtstreeks gebruiken in de daaropvolgende acties.

Gebruik de variabele Paginagegevens ophalen, een lijst met pagina's, om de geretourneerde gegevens te openen in de stappen na deze actie. Je kunt deze variabele in zowel voorwaarden als acties gebruiken. Je kunt bijvoorbeeld de lijst met pagina's in een actie van het type Interne e-mail verzenden verzenden, zoals in dit voorbeeld:

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

Opmerking

Als de actie Gegevens ophalen meerdere keren wordt gebruikt in één workflow, wordt er een getal aan de variabelenaam toegevoegd. Bijvoorbeeld: in een workflow die de actie Bestelgegevens ophalen (Get order data) twee keer gebruikt, is de eerste variabele voor geretourneerde gegevens getOrderData en de tweede variabele 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 die de trigger Geplande tijd gebruikt, start de workflow op een tijdstip dat je hebt opgegeven, en niet als resultaat van een 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

Bekijk de Pages-query voor meer informatie over de API die in deze actie wordt gebruikt.