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 inventar, sælger produkter eller afsender eller klargøre ordrer.

Bemærk

Dette er en handling af typen Hent data. Du kan opnå en bedre forståelse for, hvordan du bruger denne type handling med udløseren Planlagt tidspunkt og For hver-loops, i denne vejledning.

Konfiguration

Felter

Handlingen Hent lokationsdata indeholder følgende felter.

Felter, der bruges i handlinger af typen “Hent data”.

Felt	Beskrivelse
Sortér data efter	Påkrævet. De parametre, som de data der returneres af søgeforespørgslen, sorteres efter.
Det maksimale antal resultater	Påkrævet. Det maksimale antal resultater, der kan returneres af den valgte søgeforespørgsel. Du kan returnere op til 100 ad gangen.
Forespørgsel	Påkrævet. Vælg mellem almindelige forespørgsler, eller vælg Avanceret for at oprette din egen.

Forespørgselsstreng

Dette er et eksempel på forespørgsel til at få lokationer, der har afhentning i butikken aktiveret:

pickup_in_store:enabled

Variablen pickup_in_store er et filter, der er tilgængeligt i Lokationsforepørgsel, og som kan bruges flere gange eller kombineres med andre variabler.

Når du forespørger om data, er det brugbart at vide:

• Liste over tilgængelige filtre for lokation

• Forespørgsler skal følge en bestemt syntaks

• Værdierne for forespørgselsfeltet er ikke altid dokumenteret. I nogle tilfælde kan du finde værdierne ved at kigge i API-dokumenterne. Du kan ofte også finde feltværdierne i webadresserne i administratoren, når du filtrerer. Hvis du f.eks. gerne vil finde værdier for ordreforespørgsler, 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 forespørgslen mislykkes. API’en returnerer ofte alle resultater (i stedet for ingen).

Returnerede data

Alle handlinger af typen Hent data returnerer en liste over 0-100 ressourcer. Du kan bruge disse data på forskellige måder afhængigt af dit brugsscenarie:

• Hvis du f.eks. skal håndtere hvert listeelement enkeltvis, f.eks. ved at tilføje et tag for hvert element, kan du bruge handlingen For each.
• Hvis du skal bruge aggregerede data, f.eks. optællinger af returnerede resultater, kan du bruge handlingerne Antal eller Sum.
• Hvis du skal sende listen ud, f.eks. ved at sende en mail med alle elementerne, kan du bruge de returnerede data direkte i efterfølgende handlinger. Hvis du vil tilgå de returnerede data i trin, der følger denne handling, skal du bruge variablen med navnet Hent lokationsdata, som er en liste over lokationer. Du kan både bruge denne variabel i betingelser og handlinger. Du kan f.eks. sende listen over lokationer i handlingen Send intern mail på følgende måde:

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

Bemærk

Hvis handlingen Hent data er brugt flere gange i et enkelt workflow, føjes der et tal til variabelnavnet. Den første variabel for returnerede data i workflows, der bruger handlingen Hent ordredata to gange, er f.eks. getOrderData, mens den anden variabel er getOrderData1. Navnet kan ikke tilpasses.

Triggere

Du kan bruge denne handling alle workflow, herunder udløseren Planlagt tid. I et workflow, der bruger udløseren Planlagt tid, starter workflowet på et tidspunkt, som du har angivet, i stedet for som følge af et event. Da der ikke er nogen specifik hændelse i din butik eller fra en app, der starter workflowet, inkluderes der ikke nogen data automatisk.

API-reference

For mere information om den API , der bruges i denne handling, se lokationsforespørgslen.