Helyszínadatok lekérése

Azokban a munkafolyamatokban, amelyek helyszínadatokat igényelnek, a Helyszínadatok lekérése művelettel kérhet le helyszíninformációkat a Shopify-üzletéből. A helyszínek olyan helyek, ahol készletet tárol, termékeket értékesít, vagy rendeléseket szállít ki és teljesít.

Ezen az oldalon

Konfiguráció

Mezők

A Helyszínadatok lekérése művelet a következő mezőket tartalmazza.

Az Adatlekérési műveletekben használt mezők.
Mező	Leírás
Adatok rendezése	Kötelező. Azok a paraméterek, amelyek alapján a keresési lekérdezés által visszaadott adatok rendezve lesznek.
Találatok maximális száma	Kötelező. A kiválasztott keresési lekérdezés által visszaadható találatok maximális száma. Egyszerre legfeljebb 100 adható vissza.
Lekérdezés	Kötelező. Válasszon a gyakori lekérdezések közül, vagy válassza a Speciális lehetőséget saját lekérdezés létrehozásához.

Lekérdezési karakterlánc

Az alábbiakban egy példa látható egy olyan lekérdezésre, amely azokat a helyszíneket kéri le, ahol engedélyezve van az üzletben történő átvétel:

pickup_in_store:enabled

A pickup_in_store változó egy szűrő, amely a Helyszínek lekérdezésén érhető el, és többször is használható, vagy más változókkal kombinálható.

Az adatok lekérdezésekor hasznos tudni a következőket:

Az elérhető helyszínszűrők listája
A lekérdezéseknek egy bizonyos szintaxist kell követniük
A lekérdezési mezők értékei nincsenek mindig dokumentálva. Egyes esetekben az értékek az API-dokumentációban találhatók meg. Alternatív megoldásként a mezőértékeket gyakran megtalálhatja az URL-ekben az adminisztrációs felületen, amikor szűr. Például egyes rendelési lekérdezési értékek megkereséséhez szűrjön a Rendelések oldalon az adminisztrációs felületen, majd ellenőrizze az URL-t.
A Shopify GraphiQL alkalmazás segítségével futtathat vagy tesztelhet egy lekérdezést az üzletében.
Ügyeljen arra, hogy mi történik, ha a lekérdezés sikertelen. Az API gyakran az összes eredményt visszaadja (ahelyett, hogy egyet sem).

Visszaadott adatok

Minden Adatlekérési művelet egy 0 és 100 közötti erőforrást tartalmazó listát ad vissza. A felhasználási esettől függően érdemes lehet ezeket az adatokat különböző módokon felhasználni:

Ha minden listaelemet egyenként kell kezelnie, például mindegyikhez címkét szeretne hozzáadni, akkor használhatja a Minden egyes elemre műveletet.
Ha összesítenie kell az adatokat, például meg kell számolnia, hogy hány eredményt adott vissza, akkor használhatja a Számlálás vagy a Összegzés műveletet.
Ha ki kell adnia a listát, például egy e-mailt kell küldenie az összes tétellel, akkor a visszaadott adatokat közvetlenül felhasználhatja a következő műveletekben.

A visszaadott adatok eléréséhez az ezt a műveletet követő lépésekben használja a Get location data nevű változót, amely a helyszínek listája. Ezt a változót feltételekben és műveletekben is használhatja. Például elküldheti a helyszínek listáját egy Belső e-mail küldése műveletben az alábbiak szerint:

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

Kiváltók

Ezt a műveletet bármely munkafolyamatban használhatja, beleértve az Ütemezett időpont kiváltót is. Az Ütemezett időpont kiváltót használó munkafolyamatok egy Ön által megadott időpontban indulnak el, nem pedig egy esemény hatására. Mivel nincs olyan konkrét esemény az üzletében vagy egy alkalmazásban, amely elindítaná a munkafolyamatot, nincsenek automatikusan belefoglalt adatok.

API-referencia

Az ebben a műveletben használt API-ról további információt a Helyszínek lekérdezése című részben talál.