Hent rabatdata

I workflows, der kræver rabatdata, kan du bruge handlingen Hent rabatdata til at hente rabatoplysninger fra din butik.

Bemærk

Dette er en handling af typen Hent data. Hvis du vil vide mere om, hvordan du bruger denne type handling med udløseren Planlagt tid og For hvert-løkker, kan du se Tidsplaner, hent data og gentagne workflows i Shopify Flow.

Konfiguration

Felter

Handlingen Hent rabatdata indeholder følgende felter, som bruges til at opbygge forespørgslen:

Felter, der bruges i handlinger af typen Hent data.

Felt	Beskrivelse
Sortér data efter	Obligatorisk. De parametre, som de data, der returneres af søgeforespørgslen, sorteres efter.
Maksimalt antal resultater	Obligatorisk. Det maksimale antal resultater, der kan returneres af den søgeforespørgsel, du vælger. Du kan returnere op til 100 ad gangen.
Forespørgsel	Obligatorisk. Vælg mellem almindelige forespørgsler, eller vælg Avanceret for at oprette din egen.

Forespørgselsstreng

Dette er et eksempel på en forespørgsel til at hente aktive rabatter, der bruger en kode:

method:code AND status:active

Variablerne method og status er filtre, der er tilgængelige for forespørgslen Rabatnode, og kan bruges flere gange eller kombineres med andre variabler.

Når du forespørger på data, er det en hjælp at vide:

• Liste over tilgængelige rabatfiltre.
• Forespørgsler skal følge en bestemt syntaks
• Værdier for forespørgselsfelter er ikke altid dokumenteret. I nogle tilfælde kan værdierne findes ved at se i API docs. Alternativt kan du ofte finde feltværdierne i webadresserne i administratoren, når du filtrerer. Hvis du f.eks. vil finde nogle forespørgselsværdier for ordrer, kan du filtrere siden Ordrer i administratoren og derefter tjekke webadressen.
• Du kan køre eller teste en forespørgsel i din butik med Shopify GraphiQL app.
• Vær opmærksom på, hvad der sker, hvis din forespørgsel mislykkes. Ofte returnerer API'en alle resultater (i stedet for ingen).

Returnerede data

Alle handlinger af typen Hent data returnerer en liste med mellem 0 og 100 ressourcer. Afhængigt af hvad du skal bruge disse data til, kan du anvende dem på forskellige måder:

• Hvis du har brug for at håndtere hvert element på listen individuelt, f.eks. for at tilføje et tag til hvert element, kan du bruge handlingen For each.
• Hvis du har brug for at samle data, f.eks. tælle hvor mange resultater der blev returneret, kan du bruge handlingerne Count eller Sum.
• Hvis du har brug for at udsende listen, f.eks. ved at sende en mail med alle varerne, kan du bruge de returnerede data direkte i efterfølgende handlinger.

For at få adgang til de returnerede data i trin, der følger efter denne handling, skal du bruge variablen med navnet Hent rabatdata, som er en liste over rabatter. Du kan bruge denne variabel i både betingelser og handlinger. Du kan f.eks. sende listen over automatiske apprabatter i en handling af typen Send intern mail som denne:

{% for discount_item in getDiscountData %}
{% if discount_item.discount.__typename == "DiscountAutomaticApp" %}
*  {{discount_item.discount.DiscountAutomaticApp.title}}
{% endif %}
{% endfor %}

Bemærk

Hvis en handling af typen Hent data bruges flere gange i et enkelt workflow, føjes der et tal til navnet på variablen. I et workflow, der f.eks. bruger handlingen Hent ordredata to gange, er den første variabel for returnerede data getOrderData, og den anden variabel er getOrderData1. Dette navn kan ikke tilpasses.

Udløsere

Du kan bruge denne handling i alle workflows, herunder udløseren Planlagt tidspunkt. I et workflow, der bruger udløseren Planlagt tidspunkt, starter workflowet på et tidspunkt, du har angivet, i stedet for som et resultat af en hændelse. Da der ikke er nogen specifik hændelse i din butik eller fra en app, der starter workflowet, medtages der ikke automatisk nogen data.

API-detaljer

• Rabatressource
• Forespørgselsfiltre for rabat

Skabeloner

Mail med ugentligt resume over aktive rabatter, der bruger en kode

Sender et resume over aktive rabatter, der bruger en kode. Workflowet kører efter en tidsplan hver mandag kl. 9.00. Du kan tilpasse workflowet for at ændre timingen, hvordan du modtager resumeet, den type rabatter, du vil inkludere, samt tilstand. Se skabelon