Hent lokationsdata

I workflows, der kræver lokationsdata, kan du bruge handlingen Hent lokationsdata til at hente lokationsoplysninger fra din Shopify-butik. Lokationer er ethvert sted, hvor du opbevarer lagerbeholdning, sælger produkter eller afsender eller klargør ordrer.

Bemærk

Dette er en type Hent data-handling. Se Tidsplaner, hent data og gentagne workflows i Shopify Flow for at få mere at vide om, hvordan du bruger denne type handling sammen med udløseren Planlagt tidspunkt og For each-løkker.

Konfiguration

Felter

Handlingen Hent lokationsdata indeholder følgende felter.

Felter, der bruges i Hent data-handlinger.

Felt	Beskrivelse
Sortér data efter	Kræves. De parametre, som dataene fra søgeforespørgslen sorteres efter.
Maksimalt antal resultater	Kræves. Det maksimale antal resultater, der kan returneres af den valgte søgeforespørgsel. Du kan returnere op til 100 ad gangen.
Forespørgsel	Kræves. 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 lokationer, hvor afhentning i butik er aktiveret:

pickup_in_store:enabled

Variablen pickup_in_store er et filter, der er tilgængeligt for lokationsforespørgslen, og kan bruges flere gange eller kombineres med andre variabler.

Når du forespørger om data, er det en fordel at vide følgende:

• Liste over tilgængelige lokationsfiltre

• Forespørgsler skal følge en bestemt syntaks

• Værdier for forespørgselsfelter er ikke altid dokumenteret. I nogle tilfælde kan værdierne findes i API-dokumentationen. Alternativt kan du ofte finde feltværdierne i webadresserne i administratoren, når du filtrerer. Hvis du f.eks. vil finde nogle forespørgselsværdier for ordrer, skal du filtrere siden Ordrer i administratoren 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. API'en returnerer ofte alle resultater (i stedet for ingen).

Returnerede data

Alle Hent data-handlinger returnerer en liste med 0 til 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 tilføje et tag til hvert enkelt, kan du bruge handlingen For each.
• Hvis du har brug for at samle data, f.eks. tælle hvor mange resultater der blev returneret, kan du bruge handlingerne Tæl eller Sum.
• Hvis du har brug for at sende listen som output, f.eks. sende en mail med alle varerne, kan du bruge de returnerede data direkte i efterfølgende handlinger.

For at få adgang til de returnerede data i de efterfølgende trin skal du bruge variablen med navnet Hent lokationsdata, som er en liste over lokationer. Du kan bruge denne variabel i både betingelser og handlinger. Du kan f.eks. sende listen over lokationer i en Send intern mail-handling som denne:

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

Bemærk

Hvis en Hent data-handling bruges flere gange i samme workflow, føjes der et tal til variabelnavnet. I et workflow, der f.eks. bruger handlingen Hent ordredata to gange, er den første variabel for returnerede data getOrderData, og den anden variabel er getOrderData1. Dette navn kan ikke tilpasses.

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, og ikke som følge af en hændelse. Da der ikke er nogen specifik hændelse i din butik eller fra en app, som starter workflowet, inkluderes der ikke automatisk nogen data.

API-reference

Du kan få mere at vide om den API, der bruges i denne handling, i lokationsforespørgslen.