Hent produktvariantdata

Merk

Et produkt har én eller flere produktvarianter. Et skjorteprodukt kan ha en produktvariant for hver størrelse- og fargekombinasjon.

I arbeidsflytene som bruker produktvariantdata kan du bruke handlingen Hent produktvariantdata for å hente produktvariantinformasjon fra butikken din.

Merk

Dette er en handling av typen hent data. For å forstå hvordan du bruker denne typen handling med planlagt tid-utløser og for hver-løkker, se denne veiledningen.

Konfigurasjon

Felter

Handlingen Hent produktvariantdata inneholder følgende felter, som brukes til å sette sammen spørringen:

Felter som brukes i handlinger av typen Hent data.

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 produktvarianter som er oppdatert i løpet av det siste døgnet:

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

Variabelen updated_at er et filter som er tilgjengelig i Produktvarianter-spørringen, og som 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:

• En liste over tilgjengelige produktvariantfiltre - 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 å få tilgang til returnerte data i trinn som følger denne handlingen kan du bruke handlingen Hent produktvariantdata, som er en liste med produktvarianter. Denne variabelen kan brukes både i betingelser og handlinger. Du kan for eksempel sende listen over bestillinger i handlingen Send interne e-postmeldinger slik som dette:

{% for single_variant in GetProductVariantData %}
- {{ single_variant.name }}
{% endfor %}

Merk

Hvis handlingen Hent data deretter brukes flere ganger i én enkelt arbeidsflyt, legges det til et nummer i variabelnavnet. I en arbeidsflyt som for eksempel bruker handlingen Hent bestillingsinformasjon to ganger er den første variabelen for returnert informasjon getOrderData, mens den andre variabelen er getOrderData1. Dette navnet kan ikke tilpasses.

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.

API-detaljer

• Ressurs for produktvariant
• Spørringsfiltre for produktvariant

Maler

Legg til en gratis (100 % rabatt) vare i nye bestillinger

Denne malen legger til en gratis, rabattert vare i nye bestillinger hvis varen er på lager. Den sjekker lagerbeholdningen, benytter 100 % rabatt og oppdaterer bestillingen uten å varsle kunden. Denne automasjonen kan være nyttig for å (1) gi bedre kundetilfredshet ved å inkludere en gratis overraskelsesvare i bestillingen, (2) promotere nye eller mindre kjente produkter ved å legge dem til som gratisprøver i bestillinger, eller (3) for å forenkle kampanjer ved å automatisere inkluderingen og rabatteringen av gratisvarer. Vis mal

Send et ukentlig e-postsammendrag med en liste over varianter med lav lagerbeholdning

Denne arbeidsflyten kjører etter en tidsplan (som én gang per uke). Den henter en liste over produktvarianter med lav lagerbeholdning, teller resultater og sender et e-postsammendrag med varianttitler og en kobling til administratorsiden for varianten. Vis mal