Pridobi podatke o lokaciji

V potekih dela, ki zahtevajo podatke o lokaciji, lahko uporabite dejanje Pridobi podatke o lokaciji, da pridobite informacije o lokaciji iz vaše trgovine Shopify. Lokacije so katero koli mesto, kjer shranjujete inventar, prodajate izdelke ali pošiljate oziroma izpolnjujete naročila.

Opomba

To je vrsta dejanja Pridobi podatke. Za razumevanje uporabe te vrste dejanja s sprožilcem Načrtovan čas in zankami Za vsakega si oglejte Urniki, pridobivanje podatkov in zanke v potekih dela v aplikaciji Shopify Flow.

Konfiguracija

Polja

Dejanje Pridobi podatke o lokaciji vsebuje naslednja polja.

Polja, uporabljena v dejanjih Pridobi podatke.

Polje	Opis
Razvrsti podatke po	Obvezno. Parametri, po katerih se razvrstijo podatki, ki jih vrne iskalna poizvedba.
Največje število rezultatov	Obvezno. Največje število rezultatov, ki jih lahko vrne izbrana iskalna poizvedba. Naenkrat lahko vrnete do 100 rezultatov.
Poizvedba	Obvezno. Izberite med pogostimi poizvedbami ali izberite Napredno, da ustvarite svojo.

Niz poizvedbe

Tukaj je primer poizvedbe za pridobivanje lokacij z omogočenim prevzemom v trgovini:

pickup_in_store:enabled

Spremenljivka pickup_in_store je filter, ki je na voljo pri poizvedbi po lokacijah, in ga je mogoče uporabiti večkrat ali kombinirati z drugimi spremenljivkami.

Pri ustvarjanju poizvedb za podatke je dobro vedeti:

• Seznam razpoložljivih filtrov za lokacije

• Poizvedbe morajo upoštevati določeno sintakso

• Vrednosti polj poizvedbe niso vedno dokumentirane. V nekaterih primerih lahko vrednosti najdete tako, da si ogledate dokumentacijo za API. Pogosto lahko vrednosti polj najdete tudi v URL-naslovih na skrbniški plošči med filtriranjem. Če želite na primer najti nekatere vrednosti poizvedbe za naročilo, filtrirajte stran Naročila na skrbniški plošči in nato preverite URL-naslov.

• Poizvedbo lahko zaženete ali preizkusite v svoji trgovini s pomočjo aplikacije Shopify GraphiQL.

• Upoštevajte, kaj se zgodi, če vaša poizvedba ne uspe. Pogosto bo API vrnil vse rezultate (namesto nobenega).

Vrnjeni podatki

Vsa dejanja Pridobi podatke vrnejo seznam od 0 do 100 virov. Glede na vaš primer uporabe boste te podatke morda želeli uporabiti na različne načine:

• Če morate obravnavati vsak element seznama posebej, na primer dodati oznako za vsakega, potem lahko uporabite dejanje Za vsakega.
• Če morate združiti podatke, na primer prešteti, koliko rezultatov je bilo vrnjenih, potem lahko uporabite dejanja Štetje ali Vsota.
• Če želite seznam izpisati, na primer poslati e-pošto z vsemi elementi, potem lahko uporabite vrnjene podatke neposredno v naslednjih dejanjih.

Za dostop do vrnjenih podatkov v korakih, ki sledijo temu dejanju, uporabite spremenljivko Pridobi podatke o lokaciji, ki je seznam lokacij. To spremenljivko lahko uporabite tako v pogojih kot v dejanjih. Seznam lokacij lahko na primer pošljete v dejanju Pošlji interno e-pošto takole:

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

Opomba

Če je dejanje Pridobi podatke uporabljeno večkrat v enem samem poteku dela, se imenu spremenljivke doda številka. Na primer, v poteku dela, ki dvakrat uporabi dejanje Pridobi podatke o naročilu, je prva spremenljivka za vrnjene podatke getOrderData, druga spremenljivka pa getOrderData1. Tega imena ni mogoče prilagoditi.

Sprožilci

To dejanje lahko uporabite v katerem koli poteku dela, vključno s sprožilcem Načrtovan čas. V poteku dela, ki uporablja sprožilec Načrtovan čas, se potek dela začne ob času, ki ga določite, in ne kot rezultat dogodka. Ker v vaši trgovini ali iz aplikacije ni določenega dogodka, ki bi zagnal potek dela, podatki niso samodejno vključeni.

Referenca API-ja

Za več informacij o API-ju, uporabljenem v tem dejanju, si oglejte poizvedbo po lokacijah.