Hent data for bestillingsutkast

I arbeidsflyter som bruker data for bestillingsutkast, kan du bruke handlingen Hent data for bestillingsutkast for å hente informasjon om bestillingsutkast fra butikken din.

Merk

Dette er en type Hent data-handling. Hvis du vil forstå hvordan du bruker denne typen handling med utløseren Planlagt tidspunkt og For hver-løkker, kan du se Tidsplaner, henting av data og arbeidsflyter med løkker i Shopify Flow.

Konfigurasjon

Felt

Handlingen Hent data for bestillingsutkast inneholder følgende felt, som brukes til å bygge spørringen:

Felt som brukes i Hent data-handlinger.

Felt	Beskrivelse
Sorter data etter	Obligatorisk. Parameterne dataene som returneres av søkespørringen, sorteres etter.
Maksimalt antall resultater	Obligatorisk. Det maksimale antallet resultater som kan returneres av søkespørringen du velger. Du kan returnere opptil 100 om gangen.
Spørring	Obligatorisk. Velg fra vanlige spørringer eller velg Avansert for å lage din egen.

Spørringsstreng

Dette er et eksempel på en spørring for å hente bestillingsutkast som ble oppdatert i løpet av den siste dagen:

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

Variabelen updated_at er et filter som er tilgjengelig i spørringen for bestillingsutkast, og kan brukes flere ganger eller kombineres med andre variabler. Liquid-variabelen scheduledAt er tilgjengelig i arbeidsflyter som bruker utløseren Planlagt tidspunkt. Liquid-taggen date_minus er en spesiell Flow-tagg som lar deg trekke tid fra en dato.

Når du sender spørringer for data, er det nyttig å vite:

• Liste over tilgjengelige bestillingsfiltre
• Spørringer må følge en bestemt syntaks
• Spørringsfeltverdier er ikke alltid dokumentert. I noen tilfeller kan verdiene finnes ved å se på API-dokumentasjonen. Alternativt kan du ofte finne feltverdiene i URL-adressene i administratorpanelet når du filtrerer. For å finne noen verdier for bestillingsspørringer kan du for eksempel filtrere Ordre-siden i administratorpanelet og deretter sjekke URL-adressen.
• Du kan kjøre eller teste en spørring i butikken din ved hjelp av Shopify GraphiQL-appen.
• Vær oppmerksom på hva som skjer hvis spørringen mislykkes. Ofte vil API-et returnere alle resultater (i stedet for ingen).

Returnerte data

Alle Hent data-handlinger returnerer en liste med mellom 0 og 100 ressurser. Avhengig av bruksområdet ditt, kan det være lurt å bruke disse dataene på ulike måter:

• Hvis du må håndtere hvert listeelement individuelt, for eksempel for å legge til en tagg for hvert av dem, kan du bruke For hver-handlingen.
• Hvis du trenger å aggregere data, for eksempel å telle hvor mange resultater som ble returnert, kan du bruke handlingene Tell eller Summer.
• Hvis du trenger å sende listen som utdata, for eksempel sende en e-post med alle varene, kan du bruke de returnerte dataene direkte i etterfølgende handlinger.

For å få tilgang til de returnerte dataene i trinn som følger etter denne handlingen, bruker du variabelen med navnet Hent data for bestillingsutkast, som er en liste over bestillingsutkast. Du kan bruke denne variabelen i både betingelser og handlinger. Du kan for eksempel sende listen over bestillingsutkast i en Send intern e-post-handling som dette:

{% for single_order in GetDraftOrderData %}
* {{ single_order.name }}
{% endfor %}

Merk

Hvis en Hent data-handling brukes flere ganger i én enkelt arbeidsflyt, legges det til et tall i variabelnavnet. I en arbeidsflyt som for eksempel bruker handlingen Hent bestillingsdata to ganger, er den første variabelen for returnerte data getOrderData, og den andre variabelen er getOrderData1. Dette navnet kan ikke tilpasses.

Utløsere

Du kan bruke denne handlingen i enhver arbeidsflyt, inkludert utløseren Planlagt tidspunkt. I en arbeidsflyt som bruker utløseren Planlagt tidspunkt, starter arbeidsflyten på et tidspunkt du har angitt, i stedet for som et resultat av en hendelse. Fordi det ikke er noen bestemt hendelse i butikken eller fra en app som starter arbeidsflyten, inkluderes ingen data automatisk.

API-detaljer

• Bestillingsutkast-ressurs
• Spørringsfiltre for bestillingsutkast

Maler

Send daglig varsel med alle åpne bestillingsutkast

Hver dag kan du hente åpne bestillingsutkast, telle dem og sende en Slack-melding. Bruker utløseren Planlagt tidspunkt og handlingene Hent bestillingsutkast og Tell. Vis mal