Pridobi podatke o katalogu

V potekih dela, ki zahtevajo podatke o katalogu, lahko uporabite dejanje Pridobi podatke o katalogu, da iz trgovine pridobite informacije o katalogu B2B. Katalogi so skupine izdelkov s prilagojenimi cenami za določene stranke B2B ali lokacije podjetij.

Opomba

To je dejanje vrste Pridobi podatke. Za razumevanje uporabe te vrste dejanja s sprožilcem Načrtovan čas in zankami Za vsakega si oglejte Razporedi, pridobivanje podatkov in ponavljajoči se poteki dela v Shopify Flow.

Konfiguracija

Polja

Dejanje Pridobi podatke o katalogu 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.

Poizvedbeni niz

To je primer poizvedbe za pridobivanje vseh aktivnih katalogov:

status:ACTIVE

Spremenljivka status je filter, ki je na voljo v poizvedbi o katalogih in se lahko uporabi večkrat ali kombinira z drugimi spremenljivkami.

Pri poizvedovanju po podatkih je koristno vedeti naslednje:

• Seznam razpoložljivih filtrov kataloga

• Poizvedbe morajo upoštevati določeno sintakso

• Vrednosti polj poizvedbe niso vedno dokumentirane. V nekaterih primerih lahko vrednosti najdete v dokumentaciji za API. Pogosto pa lahko vrednosti polj najdete tudi v URL-naslovih v skrbniški plošči, ko filtrirate vsebino. Da bi na primer našli vrednosti za poizvedbe naročil, filtrirajte stran Naročila v skrbniški plošči in nato preverite URL-naslov.

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

• Bodite pozorni na to, kaj se zgodi, če vaša poizvedba ne uspe. API pogosto vrne vse rezultate (namesto nobenega).

Vrnjeni podatki

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

• Če morate vsak element na seznamu obravnavati posamično, na primer, da za vsakega dodate oznako, lahko uporabite dejanje Za vsakega.
• Če morate združiti podatke, na primer prešteti, koliko rezultatov je bilo vrnjenih, lahko uporabite dejanje Štetje ali Vsota.
• Če morate izpisati seznam, na primer poslati e-pošto z vsemi elementi, lahko vrnjene podatke uporabite neposredno v nadaljnjih dejanjih.

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

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% endfor %}

Opomba

Če se dejanje Pridobi podatke v enem poteku dela uporabi večkrat, se imenu spremenljivke doda številka. Na primer, v poteku dela, ki dejanje Pridobi podatke naročila uporabi dvakrat, je prva spremenljivka za vrnjene podatke getOrderData, druga 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 aplikaciji ni specifičnega dogodka, ki bi sprožil potek dela, se nobeni podatki ne vključijo samodejno.

Referenca za API

Za več informacij o API-ju, uporabljenem v tem dejanju, glejte poizvedbo o katalogih.