Získať údaje o lokalite spoločnosti

V pracovných postupoch, ktoré využívajú údaje o lokalite spoločnosti, môžete pomocou akcie Získať údaje o lokalite spoločnosti získať informácie o lokalite spoločnosti z vášho obchodu.

Konfigurácia

Polia

Akcia Získať údaje o lokalite spoločnosti obsahuje nasledujúce polia, ktoré sa používajú na vytvorenie dopytu:

Polia používané v akciách typu Získať údaje.
PolePopis
Zoradiť údaje podľaPovinné. Parametre, podľa ktorých sú zoradené údaje vrátené z vyhľadávacieho dopytu.
Maximálny počet výsledkovPovinné. Maximálny počet výsledkov, ktoré môže vrátiť vybraný vyhľadávací dopyt. Naraz sa môže vrátiť maximálne 100 výsledkov.
DopytPovinné. Vyberte si z bežných dopytov alebo výberom možnosti Rozšírené vytvorte svoj vlastný.

Reťazec dopytu

Toto je príklad dopytu na získanie lokalít spoločnosti, ktoré sa aktualizovali 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 rámci Dopytu na lokality spoločnosti a možno ho použiť viackrát alebo ho skombinovať s inými premennými. Premenná Liquid scheduledAt je k dispozícii v pracovných postupoch, ktoré použili spúšťač Naplánovaný čas. Značka Liquid date_minus je špeciálna značka aplikácie Flow, ktorá umožňuje odpočítať čas od dátumu.

Pri zadávaní dopytov na údaje je užitočné vedieť, že:

  • Zoznam dostupných filtrov lokalít spoločnosti
  • Dopyty sa musia riadiť určitou syntaxou
  • Hodnoty polí dopytu nie sú vždy zdokumentované. V niektorých prípadoch ich nájdete v dokumentácii k rozhraniu API. Hodnoty polí môžete často nájsť aj v adresách 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 vo svojom obchode môžete spustiť alebo otestovať pomocou aplikácie Shopify GraphiQL.
  • Dávajte pozor na to, č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 vrátia zoznam s 0 až 100 zdrojmi. 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 ku každej pridať štítok, môžete použiť akciu Pre každú.
  • Ak potrebujete agregovať údaje, napríklad zistiť počet vrátených výsledkov, môžete použiť akcie Počet alebo Súčet.
  • Ak potrebujete zoznam na výstupe, napríklad na odoslanie e‑mailu so všetkými položkami, môžete vrátené údaje použ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 lokalite spoločnosti, čo je zoznam lokalít spoločnosti. Túto premennú môžete použiť v podmienkach aj v akciách. Zoznam lokalít môžete napríklad odoslať v akcii Odoslať interný e‑mail takto:

{% for single_company in GetCompanyLocationData %}
* {{ single_company.name }}
{% endfor %}

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 určenom čase, nie v dôsledku udalosti. Keďže vo vašom obchode ani v aplikácii neexistuje žiadna konkrétna udalosť, ktorá by spustila pracovný postup, automaticky sa nezahrnú žiadne údaje.

Referencie rozhrania API