Dohvati podatke o katalogu

U tijekovima rada koji zahtijevaju podatke o katalogu možete upotrijebiti radnju Dohvati podatke o katalogu kako biste dohvatili informacije o B2B katalogu iz svoje trgovine. Katalozi su grupe proizvoda s prilagođenim cijenama za određene B2B korisnike ili lokacije poduzeća.

Napomena

Ovo je vrsta radnje Dohvati podatke. Kako biste saznali kako upotrebljavati ovu vrstu radnje uz pokretač Zakazano vrijeme i petlje Za svaki, pogledajte Rasporedi, dohvaćanje podataka i petlje u tijekovima rada u aplikaciji Shopify Flow.

Konfiguracija

Polja

Radnja Dohvati podatke o katalogu sadrži sljedeća polja:

Polja upotrijebljena u radnjama Dohvati podatke.

Polje	Opis
Sortiraj podatke prema	Obavezno. Parametri prema kojima se sortiraju podaci koje je vratio upit za pretraživanje.
Maksimalan broj rezultata	Obavezno. Maksimalan broj rezultata koje može vratiti odabrani upit za pretraživanje. Istovremeno možete vratiti do 100 rezultata.
Upit	Obavezno. Odaberite jedan od uobičajenih upita ili odaberite Napredno kako biste izradili vlastiti.

Niz upita

Ovo je primjer upita za dohvaćanje svih aktivnih kataloga:

status:ACTIVE

Varijabla status je filtar koji je dostupan u upitu za kataloge i može se upotrebljavati više puta ili u kombinaciji s drugim varijablama.

Prilikom postavljanja upita za podatke korisno je znati sljedeće:

• Popis dostupnih filtara kataloga

• Upiti moraju slijediti određenu sintaksu

• Vrijednosti polja upita nisu uvijek dokumentirane. U nekim se slučajevima vrijednosti mogu pronaći pregledom dokumentacije za API. Alternativno, vrijednosti polja često možete pronaći u URL-ovima u administratorskoj ploči prilikom filtriranja. Na primjer, da biste pronašli neke vrijednosti upita za narudžbe, filtrirajte stranicu Narudžbe u administratorskoj ploči i zatim provjerite URL.

• Upit možete pokrenuti ili testirati u svojoj trgovini pomoću aplikacije Shopify GraphiQL.

• Imajte na umu što se događa ako vaš upit ne uspije. API će često vratiti sve rezultate (umjesto nijednog).

Vraćeni podaci

Sve radnje za dohvaćanje podataka vraćaju popis od 0 do 100 resursa. Ovisno o vašem slučaju upotrebe, te podatke možete upotrijebiti na različite načine:

• Ako trebate obraditi svaku stavku na popisu pojedinačno, na primjer dodati oznaku za svaku od njih, možete upotrijebiti radnju Za svaku.
• Ako trebate agregirati podatke, na primjer prebrojiti koliko je rezultata vraćeno, možete upotrijebiti radnje Prebroji ili Zbroji.
• Ako trebate ispisati popis, na primjer poslati e-poruku sa svim stavkama, vraćene podatke možete izravno upotrijebiti u sljedećim radnjama.

Za pristup vraćenim podacima u koracima koji slijede nakon ove radnje upotrijebite varijablu pod nazivom Dohvati podatke o katalogu, što je popis kataloga. Ovu varijablu možete upotrijebiti u uvjetima i radnjama. Na primjer, možete poslati popis kataloga u radnji Pošalji internu e-poruku na sljedeći način:

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

Napomena

Ako se radnja Dohvati podatke u jednom tijeku rada upotrebljava više puta, nazivu varijable dodaje se broj. Na primjer, u tijeku rada koji dvaput upotrebljava radnju Dohvati podatke o narudžbi, prva varijabla za vraćene podatke je getOrderData, a druga getOrderData1. Ovaj se naziv ne može prilagoditi.

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 ne postoji određeni događaj u vašoj trgovini ili iz aplikacije koji pokreće tijek rada, podaci nisu automatski uključeni.

Referenca za API

Za više informacija o API-ju koji se upotrebljava u ovoj radnji pogledajte upit za kataloge.