Získať údaje o článku

V pracovných postupoch, ktoré vyžadujú údaje článku na blogu, môžete na získanie informácií o článku z obchodu Shopify použiť akciu Získať údaje o článku.

Poznámka

Ide o typ akcie Získať údaje. Ak chcete zistiť, ako tento typ akcie použiť so spúšťačom Plánovaný čas a slučkami For each, pozrite si časť Plány, získanie údajov a pracovné postupy so slučkami v aplikácii Shopify Flow.

Konfigurácia

Polia

Akcia Získať údaje o článku obsahuje nasledujúce polia:

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

Pole	Popis
Zoradiť údaje podľa	Povinné. Parametre, podľa ktorých sú zoradené ú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ť až 100 výsledkov.
Dopyt	Povinné. Vyberte si z bežných dopytov alebo vyberte možnosť Pokročilé a vytvorte si vlastný.

Reťazec dopytu

Toto je vzorový dopyt na získanie článkov publikovaných za posledný deň:

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

Premenná published_at je filter dostupný v dopyte na články a možno ho použiť viackrát alebo kombinovať s inými premennými. Premenná Liquid scheduledAt je k dispozícii v pracovných postupoch, ktoré používajú spúšťač Plánovaný čas. Štítok Liquid date_minus je špeciálny štítok aplikácie Flow, ktorý vám umožňuje odpočítať čas od dátumu.

Pri dopytovaní údajov je užitočné vedieť:

• Zoznam dostupných filtrov článkov

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

• Hodnoty polí dopytu nie sú vždy zdokumentované. V niektorých prípadoch je možné tieto hodnoty nájsť 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ť niektoré hodnoty dopytov pre objednávky, vyfiltrujte stránku Objednávky v administrátorskom paneli a potom skontrolujte adresu URL.

• Vo svojom obchode môžete spustiť alebo otestovať dopyt pomocou aplikácie Shopify GraphiQL.

• Dávajte pozor na to, čo sa stane, ak váš dopyt zlyhá. 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 využiť rôznymi spôsobmi:

• Ak potrebujete každú položku zoznamu spracovať samostatne, napríklad ku každej pridať štítok, môžete použiť akciu For each.
• Ak potrebujete agregovať údaje, napríklad spočítať, koľko výsledkov sa vrátilo, môžete použiť akcie Count alebo Sum.
• Ak potrebujete zoznam použiť ako výstup, napríklad na odoslanie e-mailu so všetkými položkami, vrátené údaje môžete využiť priamo v nasledujúcich akciách.

Ak chcete k vráteným údajom pristupovať v krokoch nasledujúcich po tejto akcii, použite premennú s názvom Získať údaje o článku, čo je zoznam článkov. Túto premennú môžete použiť v podmienkach aj akciách. Zoznam článkov môžete napríklad odoslať v akcii Odoslať interný e-mail takto:

{% for single_article in GetArticleData %}
    * {{ single_article.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ý používa akciu Získať údaje o objednávke dvakrát, prvá premenná pre vrátené údaje je getOrderData a druhá premenná je 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 Naplánovaný čas. V pracovnom postupe, ktorý používa spúšťač Naplánovaný čas, sa pracovný postup spustí v zadanom čase, a nie ako výsledok udalosti. Keďže v obchode ani v aplikácii neexistuje žiadna konkrétna udalosť, ktorá by pracovný postup spustila, automaticky sa nezahrnú žiadne údaje.

Referenčná príručka API

Ďalšie informácie o rozhraní API, ktoré sa používa v tejto akcii, nájdete v časti Dopyt Articles.