Hent data om gavekort

I workflows, der kræver data om gavekort, kan du bruge handlingen Hent data om gavekort til at hente oplysninger om gavekort fra din butik.

Det er vigtigt at bemærke, at din butik har både gavekortprodukter, som bruges til at generere gavekort, og selve gavekortene, som er de faktiske gavekort, som kunderne kan bruge til at foretage køb. Handlingen Hent data om gavekort henter oplysninger om selve gavekortene. Hvis du vil hente oplysninger om gavekortprodukter, skal du bruge handlingerne Hent produktdata eller Hent produktvariantdata.

På denne side

Konfiguration

Felter

Handlingen Hent data om gavekort 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	Krævet. De parametre, som de data, der returneres af søgeforespørgslen, sorteres efter.
Maksimalt antal resultater	Krævet. 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	Krævet. 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 gavekort, der blev opdateret inden for den seneste dag:

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

Variablen created_at er et filter, der er tilgængeligt i forespørgslen om gavekort, og kan bruges flere gange eller kombineres med andre variabler. Liquid-variablen scheduledAt er tilgængelig i workflows, der bruger udløseren Planlagt tidspunkt. Liquid-tagget date_minus er et særligt Flow-tag, der giver dig mulighed for at trække tid fra en dato.

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

Liste over tilgængelige filtre for gavekort
Forespørgsler skal følge en bestemt syntaks
Feltværdier for forespørgsler er ikke altid dokumenterede. I nogle tilfælde kan værdierne findes ved at kigge i API-dokumentationen. Alternativt kan du ofte finde feltværdierne i webadresserne i administratorpanelet, når du filtrerer. Hvis du f.eks. vil finde nogle forespørgselsværdier for ordrer, skal du filtrere siden Ordrer i administratorpanelet og derefter tjekke webadressen.
Du kan køre eller teste en forespørgsel i din butik ved hjælp af Shopify GraphiQL-appen.
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 dit anvendelsestilfælde kan du bruge disse data på forskellige måder:

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

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

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

Udløsere

Du kan bruge denne handling i ethvert workflow, 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 en specifik hændelse i din butik eller fra en app, der starter workflowet, medtages der ikke automatisk data.