Hae sijaintitiedot

Sijaintietoja edellyttävissä työnkuluissa voit hakea sijaintitiedot Shopify-kaupastasi Hae sijaintitiedot ‑toiminnolla. Sijainti on mikä tahansa paikka, jossa sinulla on varastoa, myyt tuotetta, lähetät tilauksia tai täytät tilauksia.

Huomaa

Tämä on eräs Hae tietoja -toiminnon tyyppi. Jos haluat ymmärtää, miten tämän tyyppisiä toimintoja käytetään Asetettu aika ‑käynnistimen ja Kullekin tuotteelle ‑silmukoiden kanssa, tutustu tähän oppaaseen.

Määrittäminen

Kentät

Hae sijaintitiedot ‑toiminto sisältää seuraavat kentät.

Hae tietoja -toiminnoissa käytetyt kentät.

Kenttä	Kuvaus
Tietojen lajitteluperuste	Tämä on pakollinen. Parametrit, joiden mukaan hakukyselyn palauttamat tiedot lajitellaan.
Tulosten enimmäismäärä	Tämä on pakollinen. Hakukyselyn palauttamien tulosten suurin mahdollinen määrä. Voit palauttaa kerrallaan enintään 100.
Kysely	Tämä on pakollinen. Valitse yleisistä kyselyistä tai valitse Lisäasetukset luodaksesi oman.

Kyselyn merkkijono

Tässä on esimerkki kyselystä, jolla haetaan myymälästä noutamista tarjoavat sijainnit:

pickup_in_store:enabled

Esimerkissä oleva pickup_in_store-muuttuja on sijaintikyselyssä käytettävissä oleva suodatin, jota voi käyttää useita kertoja tai jonka voi yhdistää muihin muuttujiin.

Seuraavat asiat on hyvä tietää tietokyselyä luotaessa:

• Luettelo käytettävissä olevista sijaintisuodattimista

• Kyselyjen on noudatettava tiettyä syntaksia

• Kyselykenttien arvoja ei ole aina dokumentoitu. Joissain tapauksissa arvot löytyvät API-dokumenteista. Vaihtoehtoisesti voit usein löytää kentän arvot Adminin URL-osoitteista, kun suodatat. Jos esimerkiksi haluat löytää tilauskyselyn arvoja, suodata Tilaukset-sivu ylläpitäjässä ja tarkista sitten URL-osoite.

• Voit suorittaa tai testata kyselyä kaupassasi Shopify GraphiQL -sovelluksen avulla.

• Ole tietoinen siitä, mitä tapahtuu, jos kysely epäonnistuu. Usein API palauttaa kaikki tulokset (sen sijaan, että se ei palauttaisi yhtään).

Palautetut tiedot

Kaikki Hae tietoja -toiminnot palauttavat luettelon, jonka koko on 0-100 resurssia. Käyttötapauksestasi riippuen saatat haluta käyttää näitä tietoja eri tavoilla:

• Jos sinun täytyy käsitellä kutakin luettelon kohtaa erikseen, kuten lisätä kullekin tunnisteen, voit käyttää For each-toimintoa.
• Jos sinun täytyy yhdistellä tietoja, kuten laskea, kuinka monta tulosta palautettiin, voit käyttää Laske- tai Summa-toimintoja.
• Jos sinun täytyy tulostaa luettelo, kuten lähettää kaikki kohdat sisältävä sähköpostiviesti, voit käyttää palautettuja tietoja suoraan tätä toimintoa seuraavissa toiminnoissa. Jos haluat käyttää palautettuja tietoja tätä toimintoa seuraavissa vaiheissa, käytä Hae sijaintitiedot ‑muuttujaa, joka luettelee sijainnit. Voit käyttää tätä muuttujaa sekä ehdoissa että toiminnoissa. Voit esimerkiksi lähettää sijaintien luettelon Lähetä sisäinen sähköposti ‑toiminnolla seuraavasti:

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

Huomaa

Jos Hanki tietoja ‑toimintoa käytetään useita kertoja samassa työnkulussa, muuttujan nimeen lisätään luku. Esimerkiksi työnkulussa, jossa käytetään Hanki tilaustietoja ‑toimintoa kahdesti, palautettujen tietojen ensimmäinen muuttuja on getOrderData ja toinen on getOrderData1. Tätä nimeä ei voi muokata.

Käynnistimet

Voit käyttää tätä toimintoa kaikissa työnkuluissa, myös Asetettu aika -käynnistimessä. Työnkulussa, jossa käytetään Asetettu aika -käynnistintä, työnkulku käynnistyy määrittämänäsi aikana eikä jonkin tapahtuman seurauksena. Koska työnkulkua ei käynnistä tietty kaupan tai sovelluksen tapahtuma, siihen ei automaattisesti sisälly tietoja.

API-viite

Lisätietoja tässä toiminnossa käytetystä API:sta löytyy sijaintikyselyiden osiosta.