Získať údaje o kolekcii
V pracovných postupoch, ktoré vyžadujú údaje o kolekcii, môžete na získanie informácií o kolekcii z obchodu použiť akciu Získať údaje o kolekcii.
Konfigurácia
Polia
Akcia Získať údaje o kolekcii obsahuje nasledujúce polia.
| Pole | Popis |
|---|---|
| Zoradiť údaje podľa | Povinné. Parametre, podľa ktorých sa zoradia údaje vrátené vyhľadávacím dopytom. |
| Maximálny počet výsledkov | Povinné. Maximálny počet výsledkov, ktoré môže vrátiť vybratý vyhľadávací dopyt. Naraz môžete vrátiť maximálne 100 výsledkov. |
| Dopyt | Povinné. Vyberte si z bežných dopytov alebo vyberte možnosť Rozšírené a vytvorte si vlastný dopyt. |
Reťazec dopytu
Tu je príklad dopytu na získanie kolekcií, ktoré boli aktualizované za posledný deň:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Premenná updated_at je filter, ktorý je k dispozícii v dopyte na kolekcie, a dá sa použiť viackrát alebo kombinovať s inými premennými. Premenná Liquid scheduledAt je dostupná v pracovných postupoch, ktoré použili spúšťač v plánovanom čase. Značka Liquid date_minus je špeciálna značka aplikácie Flow, ktorá umožňuje odpočítať čas od dátumu.
Pri dopytovaní údajov je užitočné vedieť:
- Zoznam dostupných filtrov kolekcií
- Dopyty musia spĺňať určitú syntax
- Hodnoty polí dopytu nie sú vždy zdokumentované. V niektorých prípadoch nájdete hodnoty v dokumentácii k rozhraniu API. Prípadne môžete hodnoty polí často nájsť v adresách URL v administrátorskom paneli pri filtrovaní. Ak chcete napríklad nájsť určité hodnoty dopytu pre Objednávky, vyfiltrujte stránku Objednávky v administrátorskom paneli a potom skontrolujte adresu URL.
- Dopyt vo svojom obchode môžete spustiť alebo otestovať pomocou aplikácie Shopify GraphiQL.
- Nezabúdajte na to, čo sa stane v prípade zlyhania dopytu. Rozhranie API často vráti všetky výsledky (namiesto žiadnych).
Vrátené údaje
Všetky akcie Získať údaje vrátia zoznam s počtom od 0 do 100 zdrojov. V závislosti od vášho prípadu použitia môžete tieto údaje použiť rôznymi spôsobmi:
- Ak potrebujete spracovať každú položku zoznamu samostatne, napríklad pridať ku každej štítok, môžete použiť akciu Pre každé.
- Ak potrebujete agregovať údaje, napríklad spočítať, koľko výsledkov sa vrátilo, môžete použiť akcie Počet alebo Súčet.
- Ak potrebujete zoznam vyviesť, napríklad odoslať e‑mail so všetkými položkami, vrátené údaje môžete použiť priamo v nasledujúcich akciách.
Ak chcete získať prístup k vráteným údajom v krokoch, ktoré nasledujú po tejto akcii, použite premennú s názvom Získať údaje o kolekcii, ktorá predstavuje zoznam kolekcií. Túto premennú môžete použiť v podmienkach aj v akciách. Zoznam kolekcií môžete napríklad odoslať v akcii Odoslať interný e‑mail takto:
{% for single_collection in GetCollectionData %}
* {{ single_collection.title }}
{% endfor %}Spúšťače
Túto akciu môžete použiť v ľubovoľnom pracovnom postupe vrátane spúšťača Naplánovaný čas. V pracovnom postupe s týmto spúšťačom sa pracovný postup nezačína v dôsledku udalosti, ale v čase, ktorý zadáte. Keďže vo vašom obchode alebo z aplikácie neexistuje žiadna konkrétna udalosť, ktorá by spustila pracovný postup, automaticky sa nezahrnú žiadne údaje.