Získať údaje o katalógu

V pracovných postupoch, ktoré vyžadujú údaje o katalógu, môžete použiť akciu Získať údaje o katalógu na získanie informácií o B2B katalógoch z obchodu. Katalógy sú skupiny produktov s prispôsobenou cenotvorbou pre konkrétnych zákazníkov B2B alebo lokality spoločnosti.

Poznámka

Toto je akcia typu Získať údaje. Ak chcete zistiť, ako používať tento typ akcie so spúšťačom Plánovaný čas a cyklami Pre každý, pozrite si časť Plány, získavanie údajov a cyklické pracovné postupy v aplikácii Shopify Flow.

Konfigurácia

Polia

Akcia Získať údaje o katalógu obsahuje nasledujúce polia:

Polia používané v akciách typu Získať údaje.

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ť vami vybraný vyhľadávací dopyt. Naraz môžete vrátiť maximálne 100 výsledkov.
Dopyt	Povinné. Vyberte si z bežných dopytov alebo výberom možnosti Rozšírené vytvorte vlastný.

Reťazec dopytu

Toto je príklad dopytu na získanie všetkých aktívnych katalógov:

status:ACTIVE

Premenná status je filter dostupný pre dopyt Catalogs a môžete ju použiť viackrát alebo kombinovať s inými premennými.

Pri dopytovaní údajov je dobré vedieť:

• Zoznam dostupných filtrov katalógu

• Dopyty musia dodržiavať určitú syntax

• Hodnoty polí dopytu nie sú vždy zdokumentované. V niektorých prípadoch môžete hodnoty nájsť v dokumentácii rozhrania API. Hodnoty polí často nájdete aj v adresách URL v administrátorskom paneli, keď použijete filtre. Ak napríklad chcete nájsť niektoré hodnoty pre dopyt Order, 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.

• Dávajte pozor 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 vracajú zoznam s počtom zdrojov od 0 do 100. V závislosti od vášho prípadu použitia môžete tieto údaje využiť rôznymi spôsobmi:

• Ak potrebujete spracovať každú položku zoznamu samostatne, napríklad každej pridať štítok, môžete použiť akciu Pre každé.
• Ak potrebujete agregovať údaje, napríklad spočítať vrátené výsledky, môžete použiť akciu Počet alebo Súčet.
• Ak potrebujete vytvoriť výstup pre zoznam, napríklad odoslať e‑mail so všetkými položkami, môžete vrátené údaje 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 katalógu, ktorá predstavuje zoznam katalógov. Túto premennú môžete použiť v podmienkach aj akciách. Zoznam katalógov môžete napríklad odoslať v akcii Odoslať interný e‑mail takto:

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

Poznámka

Ak sa akcia Získať údaje použije v jednom pracovnom postupe viackrát, k názvu premennej sa pridá číslo. Napríklad v pracovnom postupe, ktorý dvakrát používa akciu Získať údaje o objednávke, je prvá premenná pre vrátené údaje getOrderData a druhá getOrderData1. Tento názov sa nedá prispôsobiť.

Spúšťače

Túto akciu môžete použiť v akomkoľvek pracovnom postupe vrátane spúšťača Plánovaný čas. V pracovnom postupe, ktorý používa spúšťač Plánovaný čas, sa pracovný postup spustí v čase, ktorý ste určili, a nie v dôsledku udalosti. Keďže vo vašom obchode alebo z aplikácie neexistuje žiadna konkrétna udalosť, ktorá by pracovný postup spustila, automaticky sa nezahrnú žiadne údaje.

Referencia rozhrania API

Ďalšie informácie o rozhraní API použitom v tejto akcii nájdete v časti o dopyte Catalogs.