Získať údaje o stránke
V pracovných postupoch, ktoré vyžadujú údaje o stránke, môžete na získanie informácií o stránke z vášho obchodu použiť akciu Získať údaje o stránke. Stránky sú webové stránky vo vašom online obchode, ktoré obsahujú informácie, ktoré sa menia len zriedka, ako napríklad stránka O nás alebo kontaktná stránka.
Na tejto stránke
Konfigurácia
Polia
Akcia Získať údaje o stránke obsahuje nasledujúce polia:
| 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ť vybraný vyhľadávací dopyt. Naraz je možné vrátiť až 100 výsledkov. |
| Dopyt | Povinné. Vyberte si z bežných dopytov alebo výberom možnosti Rozšírené vytvorte svoj vlastný. |
Reťazec dopytu
Toto je vzorový dopyt na získanie publikovaných stránok:
published_status:publishedPremenná published_status je filter dostupný v dopyte na stránky a môže sa použiť viackrát alebo kombinovať s inými premennými.
Pri dopytovaní údajov je užitočné vedieť:
Dopyty musia dodržiavať určitú syntax
Hodnoty polí dopytov nie sú vždy zdokumentované. V niektorých prípadoch je možné tieto hodnoty nájsť v dokumentácii k API. Hodnoty polí sa tiež často dajú zistiť z adries URL v administrátorskom paneli pri filtrovaní. Ak chcete napríklad nájsť niektoré hodnoty dopytu pre objednávky, vyfiltrujte stránku Objednávky v administrátorskom paneli a potom skontrolujte adresu URL.
Dopyt môžete vo svojom obchode spustiť alebo otestovať pomocou aplikácie Shopify GraphiQL.
Majte na pamäti, čo sa stane, ak dopyt zlyhá. Rozhranie API často vráti všetky výsledky (namiesto žiadnych).
Vrátené údaje
Všetky akcie Získať údaje vracajú zoznam 0 až 100 zdrojov. V závislosti od vášho prípadu použitia môžete tieto údaje chcieť využiť rôznymi spôsobmi:
- Ak potrebujete s každou položkou zoznamu zaobchádzať samostatne, napríklad každej pridať š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 Spočítať alebo Sčítať.
- Ak potrebujete vytvoriť výstupný zoznam, 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 stránke, ktorá predstavuje zoznam stránok. Túto premennú môžete použiť v podmienkach aj akciách. Zoznam stránok môžete napríklad odoslať v akcii Odoslať interný e-mail takto:
{% for single_page in getPageData %}
* {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}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í vo vami zadanom čase, a nie v dôsledku udalosti. Keďže vo vašom obchode ani z aplikácie neexistuje žiadna konkrétna udalosť, ktorá pracovný postup spustí, nezahŕňajú sa automaticky žiadne údaje.
Referencia API
Ďalšie informácie o API, ktoré sa používa v tejto akcii, nájdete v časti Dopyt na stránky.