Gegevens van abonnementscontract ophalen

In workflows die abonnementscontractgegevens gebruiken, kun je de actie Gegevens van abonnementscontract ophalen gebruiken om abonnementscontractgegevens uit je winkel op te halen.

Op deze pagina

Configuratie

Velden

De actie Gegevens van abonnementscontract ophalen bevat de volgende velden, die worden gebruikt om de query samen te stellen:

Velden die worden gebruikt in de Get data-acties.
Veld	Beschrijving
Gegevens sorteren op	Vereist. De parameters waarop de gegevens die door de zoekopdracht worden geretourneerd, worden gesorteerd.
Maximum aantal resultaten	Vereist. Het maximum 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 aan te maken.

Querytekenreeks

Dit is een voorbeeldquery voor het ophalen van abonnementscontracten met de status ACTIVE:

status: ACTIVE

De variabele status is een filter die beschikbaar is voor de query voor abonnementscontracten en kan meerdere keren worden gebruikt.

Bij het opvragen van gegevens is het handig om het volgende te weten:

Lijst met beschikbare filters
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-documenten. Je kunt de veldwaarden ook vaak vinden in de URL's in het beheerpaneel wanneer je filtert. Als je bijvoorbeeld een aantal querywaarden voor bestellingen wilt vinden, filter je de pagina Bestellingen in het beheerpaneel en controleer je 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. De API retourneert vaak alle resultaten (in plaats van geen).

Geretourneerde gegevens

Alle Get data-acties retourneren een lijst van 0 tot 100 resources. Afhankelijk van je use case 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, kun je de actie For each gebruiken.
Als je gegevens wilt aggregeren, bijvoorbeeld om te tellen hoeveel resultaten er zijn geretourneerd, kun je de acties Count of Sum gebruiken.
Als je de lijst wilt uitvoeren, bijvoorbeeld om een e-mail te sturen met alle artikelen, kun je de geretourneerde gegevens rechtstreeks in de daaropvolgende acties gebruiken.

Om toegang te krijgen tot de geretourneerde gegevens in stappen die op deze actie volgen, gebruik je de variabele met de naam Gegevens van abonnementscontact ophalen. Dit is een lijst met abonnementscontracten. Je kunt deze variabele gebruiken in zowel voorwaarden als acties. Je kunt de lijst met bestellingen bijvoorbeeld als volgt verzenden in een Interne e-mail verzenden-actie:

{% for single_contract in GetSubscriptionContractData %}
* {{ single_contract.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 opgenomen.