Získať údaje o lokalite

V pracovných postupoch, ktoré vyžadujú údaje o lokalite, môžete na získanie informácií o lokalite zo svojho obchodu Shopify použiť akciu Získať údaje o lokalite. Lokality sú akékoľvek miesta, kde uskladňujete inventár, predávate produkty, prípadne z nich odosielate alebo vybavujete objednávky.

Poznámka

Toto je typ akcie Získať údaje. Ak chcete zistiť, ako tento typ akcie použiť so spúšťačom Naplánovaný čas a slučkami 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 lokalite obsahuje nasledujúce polia.

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

Reťazec dopytu

Toto je príklad dopytu na získanie lokalít, v ktorých je povolené vyzdvihnutie v predajni:

pickup_in_store:enabled

Premenná pickup_in_store predstavuje filter dostupný v dopyte na lokality a môže sa použiť viackrát alebo v kombinácii s inými premennými.

Pri dopytovaní údajov je užitočné vedieť nasledujúce skutočnosti:

• Zoznam dostupných filtrov lokalít

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

• Hodnoty polí dopytu nie sú vždy zdokumentované. V niektorých prípadoch tieto hodnoty nájdete v dokumentácii k API. Hodnoty polí môžete tiež často nájsť 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 môžete spustiť alebo otestovať vo svojom obchode 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 toho, aby nevrátilo žiadne).

Vrátené údaje

Všetky akcie Získať údaje vracajú zoznam s veľkosťou od 0 do 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 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 spočítať počet vrátených výsledkov, môžete použiť akcie Spočítať alebo Súčet.
• Ak potrebujete vytvoriť výstup so zoznamom, 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 nasledujúcich po tejto akcii, použite premennú s názvom Získať údaje o lokalite, čo je zoznam lokalít. Túto premennú môžete použiť v podmienkach aj akciách. Môžete napríklad odoslať zoznam lokalít v akcii Odoslať interný e-mail takto:

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

Poznámka

Ak sa v jednom pracovnom postupe viackrát použije akcia Získať údaje, 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á premenná je getOrderData1. Tento názov nie je možné upraviť.

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

Referenčná príručka k API

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