Pridobi podatke o lokaciji podjetja

V potekih dela, ki uporabljajo podatke o lokaciji podjetja, lahko z dejanjem Pridobi podatke o lokaciji podjetja pridobite informacije o lokaciji podjetja iz vaše trgovine.

Konfiguracija

Polja

Dejanje Pridobi podatke o lokaciji podjetja vsebuje naslednja polja, ki se uporabijo za pripravo poizvedbe:

Polja, uporabljena v dejanjih Pridobi podatke.
PoljeOpis
Razvrsti podatke poObvezno. Parametri, po katerih so razvrščeni podatki, ki jih vrne iskalna poizvedba.
Največje število rezultatovObvezno. Največje število rezultatov, ki jih lahko vrne izbrana iskalna poizvedba. Naenkrat lahko vrnete do 100 rezultatov.
PoizvedbaObvezno. Izberite med pogostimi poizvedbami ali izberite Napredno, da ustvarite svojo.

Niz poizvedbe

To je primer poizvedbe za pridobivanje lokacij podjetja, ki so bile posodobljene v zadnjem dnevu:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

Spremenljivka updated_at je filter, ki je na voljo v poizvedbi o lokacijah podjetja in ga je mogoče uporabiti večkrat ali kombinirati z drugimi spremenljivkami. Spremenljivka Liquid scheduledAt je na voljo v potekih dela, ki so uporabili sprožilec Načrtovani čas. Oznaka Liquid date_minus je posebna oznaka Flow, ki omogoča odštevanje časa od datuma.

Pri poizvedovanju po podatkih je koristno vedeti naslednje:

  • Seznam razpoložljivih filtrov za lokacije podjetja
  • Poizvedbe morajo slediti določeni sintaksi
  • Vrednosti polj poizvedbe niso vedno dokumentirane. V nekaterih primerih lahko vrednosti najdete v dokumentaciji API-ja. Pogosto pa lahko vrednosti polj najdete tudi v naslovih URL v skrbniški plošči, ko uporabite filtre. Če želite na primer poiskati nekatere vrednosti poizvedbe za naročila, filtrirajte stran »Naročila« v skrbniški plošči in nato preverite URL-naslov.
  • Poizvedbo lahko v trgovini zaženete ali preizkusite z aplikacijo Shopify GraphiQL.
  • Bodite pozorni na to, kaj se zgodi, če poizvedba ne uspe. API pogosto vrne vse rezultate (namesto nobenega).

Vrnjeni podatki

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

  • Če morate vsak element seznama obdelati posamezno, na primer tako, da vsakemu dodate oznako, lahko uporabite dejanje Za vsak.
  • Če morate združiti podatke, na primer prešteti, koliko rezultatov je bilo vrnjenih, lahko uporabite dejanji Štetje ali Vsota.
  • Če morate izpisati seznam, na primer poslati e-pošto z vsemi elementi, lahko vrnjene podatke uporabite neposredno v naslednjih dejanjih.

Za dostop do vrnjenih podatkov v korakih, ki sledijo temu dejanju, uporabite spremenljivko z imenom Pridobi podatke o lokaciji podjetja, ki je seznam lokacij podjetja. 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 na naslednji način:

{% for single_company in GetCompanyLocationData %}
* {{ single_company.name }}
{% endfor %}

Sprožilci

To dejanje lahko uporabite v poljubnem poteku dela, vključno s sprožilcem Scheduled time. V poteku dela, ki uporablja sprožilec Scheduled time, se potek dela začne ob določenem času in ne kot posledica dogodka. Ker v trgovini ali aplikaciji ni določenega dogodka, ki bi zagnal potek dela, nobeni podatki niso samodejno vključeni.

Referenca za API