Hent gavekortdata
I arbeidsflyter som krever gavekortdata, kan du bruke handlingen Hent gavekortdata til å hente gavekortinformasjon fra butikken din.
Viktigere, butikken din har både gavekortprodukter, som brukes til å generere gavekort, og selve gavekortene, som er det faktiske gavekortet som kunden kan bruke til kjøp. Handlingen Hent gavekortdata henter informasjon om gavekortet selv. For å få informasjon om gavekortprodukter, bruk datahandlingene Hent produktdata eller Hent produktvariant.
På denne siden
Konfigurasjon
Felter
Handlingen «hent gavekortinformasjon» inneholder følgende felter som brukes til å sette sammen spørringen:
| Felt | Beskrivelse |
|---|---|
| Sorter data etter | Påkrevd. Parameterne dataene som returneres av søket sorteres etter. |
| Maksimalt antall resultater | Påkrevd. Det maksimale antallet resultater som kan returneres av spørringen du velger. Du kan returnere opptil 100 av gangen. |
| Spørring | Påkrevd. Velg mellom vanlige spørringer, eller velg Avansert for å utforme din egen. |
Spørringsstreng
Dette er en eksempelspørring for å hente gavekort som er oppdatert i løpet av den siste dagen:
created_at:<='{{ scheduledAt }}' AND created_at:>'{{ scheduledAt | date_minus: "1 day" }}'Variabelen created_at er et filter tilgjengelig i gavekortspørringen. Det kan brukes flere ganger eller kombineres med andre variabler. Liquid-variabelen scheduledAt er tilgjengelig i arbeidsflyter som har brukt Utløseren Planlagt tid. Liquid-taggen date_minus er en spesiell Flow-tagg som lar deg trekke fra tid fra en dato.
Når du henter data, er det nyttig å vite:
Spørringer må følge en bestemt syntaks
Spørringsfeltverdier er ikke alltid dokumentert. I noen tilfeller kan du finne verdiene ved å se i API-dokumentasjonen. Alternativt finner du ofte feltverdier i URL-adressene i administrator når du filtrerer. For å finne noen bestillingsspørringsverdier, kan du for eksempel filtrere Bestillinger-siden i administrator og kontrollere URL-adressen.
Du kan kjøre eller teste en spørring i butikken ved å bruke Shopify GraphiQL-appen.
Vær oppmerksom på hva som skjer hvis spørringen mislykkes. API-et returnerer ofte alle resultater (i stedet for ingen).
Returnerte data
Alle handlinger av typen Hent data returnerer en liste på mellom 0 og 100 ressurser. Avhengig av bruksområdet kan disse dataene brukes på ulike måter:
- Hvis du har behov for å håndtere hvert listeelement individuelt, som å legge til en tagg for hvert element, kan du bruke handlingen For each.
- Hvis du har behov for å aggregere data, som å telle hvor mange resultater som er returnert, kan du bruke handlingene Count eller Sum.
- Hvis du har behov for å returnere listen, som å sende en e-postmelding med alle elementer, kan du bruke returnerte data direkte i påfølgende handlinger.
For å bruke de returnerte dataene i trinn som kommer etter denne handlingen, kan du bruke variabelen «hent gavekortinformasjon», som er en liste over gavekort. Denne variabelen kan brukes både i betingelser og handlinger. Du kan for eksempel sende listen over gavekort i handlingen «send en intern e-post», slik som dette:
{% for single_gift_card in GetGiftCardData %}
- {{ single_gift_card.name }}
{% endfor %}Utløsere
Du kan bruke denne handlingen i alle arbeidsflyter, inkludert utløseren Planlagt tid. I en arbeidsflyt som bruker utløseren Planlagt tid starter arbeidsflyten på et tidspunkt du bestemmer, og ikke som et resultat av en hendelse. Fordi det ikke er noen bestemt hendelse i butikken eller fra en app som starter arbeidsflyten, er ingen informasjon automatisk inkludert.