Pridobi podatke o zbirki

V potekih dela, ki zahtevajo podatke o zbirki, lahko uporabite dejanje Pridobi podatke o zbirki za pridobivanje informacij o zbirki iz vaše trgovine.

Opomba

To je vrsta dejanja Pridobi podatke. Za razumevanje, kako uporabljati to vrsto dejanja s sprožilcem Načrtovan čas in zankami Za vsak, si oglejte Urniki, pridobivanje podatkov in poteki dela z zankami v Shopify Flow.

Konfiguracija

Polja

Dejanje Pridobi podatke o zbirki vsebuje naslednja polja.

Polja, uporabljena v dejanjih za pridobivanje podatkov.

Polje	Opis
Razvrsti podatke po	Obvezno. Parametri, po katerih so razvrščeni podatki, ki jih vrne iskalna poizvedba.
Največje število rezultatov	Obvezno. Največje število rezultatov, ki jih lahko vrne izbrana iskalna poizvedba. Naenkrat lahko vrne do 100 rezultatov.
Poizvedba	Obvezno. Izberite eno od pogostih poizvedb ali izberite Napredno, da ustvarite svojo.

Niz poizvedbe

To je primer poizvedbe za pridobivanje zbirk, 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 pri poizvedbi za zbirke, in ga je mogoče uporabiti večkrat ali kombinirati z drugimi spremenljivkami. Spremenljivka Liquid scheduledAt je na voljo pri potekih dela, ki so uporabili sprožilec Načrtovan čas. Oznaka Liquid date_minus je posebna oznaka za Flow, ki omogoča odštevanje časa od datuma.

Pri poizvedovanju po podatkih je koristno vedeti naslednje:

• Seznam razpoložljivih filtrov za zbirke
  • Poizvedbe morajo upoštevati določeno sintakso
• Vrednosti polj poizvedbe niso vedno dokumentirane. V nekaterih primerih lahko vrednosti poiščete v dokumentaciji za API. Velikokrat pa lahko vrednosti polj najdete v URL-naslovih v skrbniški plošči, ko filtrirate vsebino. Na primer, če želite poiskati nekatere vrednosti poizvedbe za naročilo, filtrirajte stran Naročila v skrbniški plošči in nato preverite URL-naslov.
• Poizvedbo v vaši trgovini lahko zaženete ali preizkusite z aplikacijo Shopify GraphiQL.
• Bodite pozorni na to, kaj se zgodi, če je vaša poizvedba neuspešna. Pogosto bo API vrnil vse rezultate (namesto nobenega).

Vrnjeni podatki

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

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

Za dostop do vrnjenih podatkov v korakih, ki sledijo temu dejanju, uporabite spremenljivko z imenom Pridobi podatke o zbirki, ki predstavlja seznam zbirk. To spremenljivko lahko uporabite tako v pogojih kot v dejanjih. Seznam zbirk lahko na primer pošljete v dejanju Pošlji interno e-pošto na naslednji način:

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

Opomba

Če je dejanje Pridobi podatke uporabljeno večkrat v enem samem poteku dela, se imenu spremenljivke doda številka. Na primer, v poteku dela, ki dejanje Pridobi podatke o naročilu uporabi dvakrat, je prva spremenljivka za vrnjene podatke getOrderData, druga spremenljivka 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 ste ga določili, in ne kot rezultat dogodka. Ker v vaši trgovini ali aplikaciji ni določenega dogodka, ki bi zagnal potek dela, podatki niso samodejno vključeni.

Referenca za API

• Vir zbirke
• Filtri poizvedbe za zbirke