Gauti vietos duomenis

Darbo eigose, kurioms reikalingi vietos duomenys, galite naudoti veiksmą Gauti vietos duomenis, kad gautumėte informaciją apie vietą iš Jūsų „Shopify“ parduotuvės. Vietos yra bet kuri vieta, kurioje laikote inventorių, parduodate produktus arba siunčiate ar vykdote užsakymus.

Pastaba

Tai yra veiksmo Gauti duomenis tipas. Norėdami suprasti, kaip naudoti šio tipo veiksmą su paleidikliu Suplanuotas laikas ir ciklais Kiekvienam, žr. „Shopify Flow“ planavimas, duomenų gavimas ir ciklinės darbo eigos.

Konfigūracija

Laukai

Veiksmas Gauti vietos duomenis apima šiuos laukus.

Laukai, naudojami veiksmuose „Gauti duomenis“.

Laukas	Aprašas
Rikiuoti duomenis pagal	Būtina. Parametrai, pagal kuriuos rikiuojami paieškos užklausos grąžinti duomenys.
Maksimalus rezultatų skaičius	Būtina. Maksimalus rezultatų, kuriuos gali grąžinti Jūsų pasirinkta paieškos užklausa, skaičius. Vienu metu galite grąžinti iki 100.
Užklausa	Būtina. Pasirinkite vieną iš įprastų užklausų arba pasirinkite Išplėstinė, kad sukurtumėte savo.

Užklausos eilutė

Toliau pateikiamas užklausos pavyzdys, kaip gauti vietas, kuriose įjungtas atsiėmimas parduotuvėje:

pickup_in_store:enabled

Kintamasis pickup_in_store yra filtras, pasiekiamas Locations query. Jį galima naudoti kelis kartus arba derinti su kitais kintamaisiais.

Teikiant duomenų užklausas naudinga žinoti:

• Galimų vietos filtrų sąrašas

• Užklausos turi atitikti tam tikrą sintaksę

• Užklausos laukų reikšmės ne visada dokumentuojamos. Kai kuriais atvejais reikšmes galima rasti peržiūrėjus API dokumentus. Arba laukų reikšmes dažnai galite rasti URL adresuose administratoriaus skydelyje, kai taikote filtrą. Pavyzdžiui, norėdami rasti kai kurias užsakymo užklausos reikšmes, filtruokite puslapį „Užsakymai“ administratoriaus skydelyje, o tada patikrinkite URL.

• Galite paleisti arba išbandyti užklausą savo parduotuvėje naudodami „Shopify GraphiQL“ programėlę.

• Nepamirškite, kas nutinka, jei užklausa nepavyksta. Dažnai API grąžins visus rezultatus (o ne nė vieno).

Grąžinami duomenys

Visi veiksmai Gauti duomenis grąžina sąrašą nuo 0 iki 100 išteklių. Atsižvelgiant į Jūsų naudojimo atvejį, šiuos duomenis galite naudoti įvairiais būdais:

• Jei kiekvieną sąrašo elementą reikia apdoroti atskirai, pavyzdžiui, prie kiekvieno pridėti žymą, galite naudoti veiksmą Kiekvienam.
• Jei reikia apibendrinti duomenis, pavyzdžiui, suskaičiuoti, kiek rezultatų buvo grąžinta, galite naudoti veiksmus Skaičiuoti arba Sumuoti.
• Jei Jums reikia viso sąrašo, pavyzdžiui, norint išsiųsti el. laišką su visais daiktais, tuomet grąžintus duomenis galite tiesiogiai naudoti vėlesniuose veiksmuose.

Norėdami pasiekti grąžintus duomenis veiksmuose, einančiuose po šio veiksmo, naudokite kintamąjį, pavadintą Gauti vietos duomenis, kuris yra vietų sąrašas. Šį kintamąjį galite naudoti tiek sąlygose, tiek veiksmuose. Pavyzdžiui, galite nusiųsti vietų sąrašą veiksme Siųsti vidinį el. laišką, kaip nurodyta toliau:

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

Pastaba

Jei veiksmas Gauti duomenis naudojamas kelis kartus vienoje darbo eigoje, prie kintamojo pavadinimo pridedamas skaičius. Pavyzdžiui, darbo eigoje, kurioje veiksmas Gauti užsakymo duomenis naudojamas du kartus, pirmasis grąžintų duomenų kintamasis yra getOrderData, o antrasis – getOrderData1. Šio pavadinimo negalima tinkinti.

Paleidikliai

Šį veiksmą galite naudoti bet kurioje darbo eigoje, įskaitant paleidiklį Suplanuotas laikas. Darbo eigoje, kurioje naudojamas paleidiklis Suplanuotas laikas, darbo eiga pradedama Jūsų nurodytu laiku, o ne dėl įvykio. Kadangi nėra konkretaus įvykio Jūsų parduotuvėje arba programėlėje, kuris paleistų darbo eigą, jokie duomenys automatiškai neįtraukiami.

API nuoroda

Daugiau informacijos apie šiame veiksme naudojamą API rasite Locations query.