Preuzmi podatke o kolekciji

U tokovima posla koji zahtevaju podatke o kolekciji, možete da koristite akciju Preuzmi podatke o kolekciji da biste preuzeli informacije o kolekciji iz vaše prodavnice.

Napomena

Ovo je tip akcije Preuzmi podatke. Da biste razumeli kako da koristite ovaj tip akcije sa okidačem Zakazano vreme i For each petljama, pogledajte Rasporedi, preuzimanje podataka i tokovi posla sa petljama u rešenju Shopify Flow.

Konfiguracija

Polja

Akcija Preuzmi podatke o kolekciji sadrži sledeća polja.

Polja koja se koriste u akcijama Preuzmi podatke.

Polje	Opis
Sortiraj podatke po	Obavezno. Parametri po kojima se podaci koje je vratio upit za pretragu sortiraju.
Maksimalan broj rezultata	Obavezno. Maksimalni broj rezultata koje može da vrati izabrani upit za pretragu. Možete da vratite do 100 rezultata istovremeno.
Upit	Obavezno. Izaberite iz uobičajenih upita ili odaberite Napredno da biste kreirali sopstveni.

String upita

Ovo je primer upita za dobijanje kolekcija koje su ažurirane u toku prethodnog dana:

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

Promenljiva updated_at je filter dostupan u upitu Collections i može se koristiti više puta ili kombinovati sa drugim promenljivama. Liquid promenljiva scheduledAt je dostupna za tokove posla koji su koristili okidač Zakazano vreme. Liquid oznaka date_minus je posebna oznaka rešenja Flow koja vam omogućava da oduzmete vreme od datuma.

Kada kreirate upite za podatke, korisno je znati sledeće:

• Lista dostupnih filtera kolekcije
  • Upiti moraju da prate određenu sintaksu
• Vrednosti polja upita nisu uvek dokumentovane. U nekim slučajevima, vrednosti se mogu pronaći u API dokumentaciji. Takođe, vrednosti polja često možete da pronađete u URL-ovima u adminu prilikom filtriranja. Na primer, da biste pronašli neke vrednosti upita za porudžbine, filtrirajte stranicu „Porudžbine” u adminu, a zatim proverite URL.
• Možete da izvršite ili testirate upit u svojoj prodavnici pomoću aplikacije Shopify GraphiQL.
• Vodite računa o tome šta se dešava ako vaš upit ne uspe. Često će API vratiti sve rezultate (umesto nijednog).

Vraćeni podaci

Sve akcije Preuzmi podatke vraćaju listu od 0 do 100 resursa. U zavisnosti od vašeg slučaja korišćenja, ove podatke možete da koristite na različite načine:

• Ako treba da obradite svaku stavku liste pojedinačno, na primer da dodate oznaku za svaku od njih, možete da koristite akciju For each.
• Ako treba da grupišete podatke, kao što je brojanje koliko rezultata je vraćeno, možete da koristite akcije Count ili Sum.
• Ako je potrebno da prosledite listu kao izlazni rezultat, na primer da pošaljete imejl sa svim stavkama, onda možete da koristite vraćene podatke direktno u narednim akcijama.

Da biste pristupili vraćenim podacima u koracima koji slede posle ove akcije, koristite promenljivu Preuzmi podatke o kolekciji, koja predstavlja listu kolekcija. Ovu promenljivu možete da koristite u uslovima i akcijama. Na primer, možete da pošaljete listu kolekcija u akciji Pošalji interni imejl na sledeći način:

{% for single_collection in GetCollectionData %}
* {{ single_collection.title }}
{% endfor %}

Napomena

Ako se akcija Preuzmi podatke koristi više puta u jednom toku posla, tada se nazivu promenljive dodaje broj. Na primer, u toku posla koji dva puta koristi akciju Preuzmi podatke o porudžbini, prva promenljiva za vraćene podatke je getOrderData, a druga promenljiva je getOrderData1. Ovaj naziv ne može da se prilagođava.

Okidači

Ovu radnju možete da koristite u bilo kom toku posla, uključujući okidač Zakazano vreme. U toku posla koji koristi okidač Zakazano vreme, tok posla počinje u vreme koje ste naveli, a ne kao rezultat događaja. Budući da u vašoj prodavnici ili iz aplikacije nema određenog događaja koji pokreće tok posla, podaci nisu automatski uključeni.

API referenca

• Resurs kolekcije
• Filteri upita za kolekciju