Získať údaje o spoločnosti

V pracovných postupoch, ktoré využívajú údaje o spoločnostiach, môžete použiť akciu Získať údaje o spoločnosti na získanie informácií o spoločnosti z vášho obchodu.

Konfigurácia

Polia

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

Polia používané v akciách Získať údaje.
PolePopis
Zoradiť údaje podľaPovinné. Parametre, podľa ktorých sa zoradia údaje vrátené vyhľadávacím dopytom.
Maximálny počet výsledkovPovinné. 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.
DopytPovinné. 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 spoločností, 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 spoločnosti, 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 spoločností
  • Dopyty musia spĺňať určitú syntax
  • 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 spoločnosti, čo je zoznam spoločností. Túto premennú môžete použiť v podmienkach aj akciách. Zoznam spoločností môžete napríklad odoslať v akcii Odoslať interný e‑mail takto:

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

Spúšťače

Túto akciu môžete použiť v ktoromkoľ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 vo vašom obchode alebo aplikácii nie je žiadna konkrétna udalosť, ktorá spúšťa pracovný postup, automaticky sa nezahrnú žiadne údaje.

Referenčná príručka rozhrania API