Hent lokaliseringsdata

I arbeidsflyter som krever lokaliseringsdata, kan du bruke handlingen Hent lokaliseringsdata til å hente lokaliseringsinformasjon fra Shopify-butikken din. Lokalisasjoner er alle steder du oppbevarer varer, selger produkter, sender eller innfrir bestillinger fra.

Merk

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

Konfigurasjon

Felt

Handlingen Hent lokaliseringsdata inneholder følgende felt.

Felt som brukes i Hent data-handlinger.

Felt	Beskrivelse
Sorter data etter	Påkrevd. Parameterne som dataene returnert av søket skal sorteres etter.
Maksimalt antall resultater	Påkrevd. Maksimalt antall resultater som kan returneres av søket du velger. Du kan returnere opptil 100 om gangen.
Spørring	Påkrevd. Velg fra vanlige spørringer eller velg Avansert for å lage din egen.

Spørringsstreng

Dette er et eksempel på en spørring for å hente lokalisasjoner som har aktivert henting i butikk:

pickup_in_store:enabled

Variabelen pickup_in_store er et filter som er tilgjengelig i Lokalisasjoner-spørringen, og kan brukes flere ganger eller kombineres med andre variabler.

Når du spør etter data, er det nyttig å vite:

• Liste over tilgjengelige lokaliseringsfiltre

• Spørringer må følge en bestemt syntaks

• Verdier for spørringsfelt er ikke alltid dokumentert. I noen tilfeller kan du finne verdiene ved å se i 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 at du vil bruke disse dataene på forskjellige 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, kan du bruke variabelen kalt Hent lokaliseringsdata, som er en liste over lokalisasjoner. Du kan bruke denne variabelen i både betingelser og handlinger. Du kan for eksempel sende listen over lokalisasjoner i handlingen Send intern e-post slik:

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% 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. Siden ingen bestemt hendelse i butikken eller fra en app starter arbeidsflyten, blir ingen data inkludert automatisk.

API-referanse

Du finner mer informasjon om API-et som brukes i denne handlingen i Lokalisasjoner-spørringen.