Leltári tétel adatainak lekérése
A leltári tételek adatait igénylő munkafolyamatokban a Leltári tétel adatainak lekérése művelet használatával kérheti le a leltári tételek adatait az üzletéből. A leltári tételek a termékváltozatok esetében nyomon követett tényleges készletegységeket jelentik.
Ezen az oldalon
Konfiguráció
Mezők
A Leltári tétel adatainak lekérése művelet a következő mezőket tartalmazza:
| Mező | Leírás |
|---|---|
| Adatok rendezési szempontja | Kötelező. A keresési lekérdezés által visszaadott adatok rendezési paraméterei. |
| 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 találat adható vissza. |
| Lekérdezés | Kötelező. Válasszon a gyakori lekérdezések közül, vagy saját lekérdezés létrehozásához válassza a Speciális lehetőséget. |
Lekérdezési karakterlánc
Ez egy példalekérdezés a nyomon követett leltári tételek lekéréséhez:
tracked:trueA tracked változó a leltári tételekre vonatkozó lekérdezés egyik elérhető szűrője, amely többször is használható, vagy más változókkal is kombinálható.
Adatok lekérdezésekor hasznos tudni a következőket:
A lekérdezéseknek bizonyos szintaxist kell követniük
A lekérdezésmezők értékei nincsenek mindig dokumentálva. Bizonyos esetekben az értékek megtalálhatók az API-dokumentációban. Emellett az adminisztrációs felületen a szűrések során gyakran megtalálhatja a mezőértékeket az URL-ekben. Például a rendelésekkel kapcsolatos lekérdezések értékeinek megtalálásához szűrje a Rendelések oldalt az adminisztrációs felületen, majd ellenőrizze az URL-t.
A Shopify GraphiQL app használatával lekérdezést futtathat vagy tesztelhet az üzletében.
Vegye figyelembe, mi történik, ha a lekérdezés meghiúsul. Az API gyakran az összes eredményt visszaadja (ahelyett, hogy egyet sem adna vissza).
Visszaadott adatok
Minden Adatok lekérése 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 ezeket az adatokat különböző módokon használhatja fel:
- Ha az egyes listatételeket egyenként kell kezelnie, például mindegyikhez címkét szeretne adni, akkor használhatja a Minden egyes műveletet.
- Ha összesítenie kell az adatokat, például meg kell számolnia a visszaadott találatokat, akkor használhatja a Számlálás vagy az Összeg műveleteket.
- Ha a listát kimenetként szeretné használni, például az összes tételt el szeretné küldeni e-mailben, a visszaadott adatokat közvetlenül felhasználhatja a későbbi műveletekben.
A visszaadott adatoknak a műveletet követő lépésekben való eléréséhez használja a Leltáritétel-adatok lekérése nevű változót, amely a leltári tételek listája. Ezt a változót feltételekben és műveletekben egyaránt használhatja. Például elküldheti a leltári tételek listáját egy ehhez hasonló Belső e-mail küldése műveletben:
{% for single_inventory_item in getInventoryItemData %}
* SKU: {{ single_inventory_item.sku }} - Cost: {{ single_inventory_item.unitCost.amount }}
{% endfor %}Kiváltók
Ezt a műveletet bármely munkafolyamatban használhatja, beleértve az Ütemezett időpont kiváltót is. Egy olyan munkafolyamatban, amely az Ütemezett időpont kiváltót használja, a munkafolyamat az Ön által megadott időpontban indul el, nem pedig egy esemény eredményeként. Mivel az üzletében vagy valamelyik alkalmazásban nincs konkrét esemény, amely elindítaná a munkafolyamatot, nem kerül bele automatikusan semmilyen adat.
API-referencia
Az ebben a műveletben használt API-val kapcsolatos további információkat a Leltári tételek lekérdezése részben találja.