Dohvaćanje podataka o poduzeću

U tijekovima rada koji upotrebljavaju podatke o poduzeću možete upotrijebiti radnju Dohvaćanje podataka o poduzeću za dohvaćanje informacija o poduzeću iz trgovine.

Konfiguracija

Polja

Radnja Dohvaćanje podataka o poduzeću sadrži sljedeća polja koja se upotrebljavaju za kreiranje upita:

Polja koja se upotrebljavaju u radnjama dohvaćanja podataka.
PoljeOpis
Poredaj podatke premaObavezno. Parametri prema kojima se sortiraju podaci vraćeni upitom za pretraživanje.
Maksimalan broj rezultataObavezno. Maksimalan broj rezultata koji može biti vraćen odabranim upitom za pretraživanje. Može se vratiti najviše 100 odjednom.
UpitObavezno. Odaberite iz uobičajenih upita ili odaberite Napredno za izradu vlastitog.

Niz upita

Ovo je primjer upita za dohvaćanje poduzeća koja su ažurirana u posljednjem danu:

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

Varijabla updated_at filter je dostupan u upitu za poduzeća te se može upotrijebiti više puta ili kombinirati s drugim varijablama. Varijabla Liquid scheduledAt dostupna je u tijekovima rada koji upotrebljavaju pokretač zakazanog vremena. Oznaka Liquid date_minus posebna je oznaka Flow koja vam omogućuje oduzimanje vremena od datuma.

Pri postavljanju upita za podatke dobro je znati sljedeće:

  • Popis dostupnih filtera za poduzeća
  • Upiti moraju slijediti određenu sintaksu
  • Vrijednosti polja upita nisu uvijek dokumentirane. U nekim se slučajevima te vrijednosti mogu pronaći pregledom dokumentacije API-ja. Alternativno, prilikom filtriranja vrijednosti polja često možete pronaći u URL-ovima u administratorskoj ploči. Na primjer, za pronalaženje nekih vrijednosti upita za narudžbu filtrirajte stranicu Narudžbe u administratorskoj ploči, a zatim provjerite URL.
  • Upit u svojoj trgovini možete pokrenuti ili testirati s pomoću aplikacije Shopify GraphiQL.
  • Pripazite na to što se događa ako vaš upit ne uspije. API će često vratiti sve rezultate (umjesto nijednog).

Vraćeni podaci

Sve radnje Dohvati podatke vraćaju popis od 0 do 100 resursa. Ovisno o vašem slučaju upotrebe, te podatke možda želite upotrebljavati na različite načine:

  • Ako trebate pojedinačno rukovati svakom stavkom na popisu, primjerice kako biste svakoj dodali oznaku, tada možete upotrijebiti radnju Za svaki.
  • Ako trebate agregirati podatke, primjerice izbrojati koliko je rezultata vraćeno, možete upotrijebiti radnju Broj ili Zbroj.
  • Ako trebate izvesti popis, primjerice poslati e-poruku sa svim stavkama, tada vraćene podatke možete izravno upotrijebiti u narednim radnjama.

Za pristup vraćenim podacima u koracima koji slijede ovu radnju upotrijebite varijablu pod nazivom Dohvati podatke o poduzeću, koja predstavlja popis poduzeća. Tu varijablu možete upotrijebiti i u uvjetima i u radnjama. Na primjer, popis poduzeća možete poslati u radnji Pošalji internu e-poruku ovako:

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

Pokretači

Ovu radnju možete upotrijebiti u bilo kojem tijeku rada, uključujući pokretač Zakazano vrijeme. U tijeku rada koji upotrebljava pokretač Zakazano vrijeme tijek rada započinje u vrijeme koje ste odredili, a ne kao rezultat događaja. Budući da u vašoj trgovini ili iz aplikacije ne postoji određeni događaj koji pokreće tijek rada, podaci se ne uključuju automatski.

Referenca API-ja