Katalógusadatok lekérése

Azon munkafolyamatokban, amelyek katalógusadatokat igényelnek, a Katalógusadatok lekérése műveletet használhatja a B2B-katalógus információinak lekérésére az üzletéből. A katalógusok olyan termékek csoportjai, amelyek egyedi árképzéssel rendelkeznek bizonyos B2B-ügyfelek vagy a vállalkozás telephelyei számára.

Ezen az oldalon

Konfiguráció

Mezők

A Katalógusadatok lekérése művelet a következő mezőket tartalmazza:

Az Adatok lekérése műveletekben használt mezők.
Mező	Leírás
Adatok rendezése	Kötelező. A keresési lekérdezés által visszaadott adatok rendezésének 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 az összes aktív katalógus lekéréséhez:

status:ACTIVE

A status változó a katalógusokra 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 rendelkezésre álló katalógusszűrők listája
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 kell kimenetként adnia, például egy e-mailt szeretne küldeni az összes tétellel, akkor a visszaadott adatokat közvetlenül felhasználhatja a későbbi műveletekben.

A visszaadott adatokhoz a műveletet követő lépésekben a Katalógusadatok lekérése nevű változó használatával férhet hozzá, amely a katalógusok listáját tartalmazza. Ezt a változót feltételekben és műveletekben egyaránt használhatja. Például egy ehhez hasonló Belső e-mail küldése műveletben elküldheti a katalógusok listáját:

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% 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 a megadott időpontban indulnak el, nem pedig egy esemény eredményeként. Mivel nincs konkrét esemény az üzletében vagy valamelyik alkalmazásban, amely elindítaná a munkafolyamatot, nincsenek automatikusan belefoglalt adatok.

API-referencia

A műveletben használt API-val kapcsolatos további információkért tekintse meg a katalógusokra vonatkozó lekérdezést.