Gegevens van cadeaubon ophalen

In workflows waarvoor cadeaubongegevens nodig zijn, kun je de actie Gegevens van cadeaubon ophalen gebruiken om cadeaubongegevens uit je winkel op te halen.

Belangrijk is dat je winkel zowel cadeaubonproducten heeft (waarmee cadeaubonnen worden gegenereerd) als de cadeaubonnen zelf (de daadwerkelijke cadeaubonnen die klanten kunnen gebruiken voor aankopen). De actie Gegevens van cadeaubon ophalen haalt informatie op over de cadeaubonnen zelf. Gebruik de acties Productgegevens ophalen of Productvariantgegevens ophalen om informatie over cadeaubonproducten op te halen.

Configuratie

Velden

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

Querytekenreeks

Dit is een voorbeeldquery voor het ophalen van cadeaubonnen die de afgelopen dag zijn bijgewerkt:

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

De created_at-variabele is een filter die beschikbaar is in de query voor cadeaubonnen en kan meerdere keren worden gebruikt of 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.

Wanneer je gegevens opvraagt met een query, is het handig om het volgende te weten:

• Lijst met beschikbare cadeaubonfilters

• Query's moeten een bepaalde syntaxis volgen

• Waarden van queryvelden zijn niet altijd gedocumenteerd. In sommige gevallen kun je de waarden 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 een aantal querywaarden voor bestellingen wilt vinden, filter je de pagina Bestellingen in het beheerpaneel en controleer je de URL.

• Je kunt een query uitvoeren of testen in je winkel 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 moet verwerken, bijvoorbeeld om voor elk item een tag toe te voegen, dan kun je de actie Voor elke gebruiken.
• Als je gegevens wilt verzamelen, bijvoorbeeld om te tellen hoeveel resultaten er zijn geretourneerd, dan kun je de acties Tellen of Optellen gebruiken.
• Als je de lijst wilt uitvoeren, bijvoorbeeld om een e-mail met alle artikelen te sturen, kun je de geretourneerde gegevens rechtstreeks in volgende acties gebruiken.

Om de geretourneerde gegevens te gebruiken in stappen die op deze actie volgen, gebruik je de variabele met de naam Cadeaubongegevens ophalen. Dit is een lijst met cadeaubonnen. Je kunt deze variabele gebruiken in zowel voorwaarden als acties. Je kunt bijvoorbeeld de lijst met cadeaubonnen als volgt verzenden in een Interne e-mail verzenden-actie:

{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.name }}
{% endfor %}

Triggers

Je kunt deze actie in elke workflow gebruiken, inclusief de Geplande tijd-trigger. In een workflow die de Geplande tijd-trigger gebruikt, start de workflow op een door jou opgegeven tijdstip en niet naar aanleiding 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-gegevens

• Cadeaubon-resource
• Queryfilters voor cadeaubonnen