Értékesítési terv csoport adatainak lekérése

Azokban a munkafolyamatokban, amelyek értékesítési terv csoport adatokat igényelnek, az Értékesítési terv csoport adatainak lekérése művelettel kérheti le a rendelési adatokat az üzletéből.

Konfiguráció

Mezők

Az Értékesítési terv csoport adatainak lekérése művelet a következő mezőket tartalmazza, amelyek a lekérdezés összeállítására szolgálnak:

Az Adatok lekérése műveletekben használt mezők.
MezőLeírás
Adatok rendezéseKötelező. A paraméterek, amelyek alapján a keresési lekérdezés által visszaadott adatok rendezve lesznek.
Találatok maximális számaKötelező. A kiválasztott keresési lekérdezés által visszaadható találatok maximális száma. Egyszerre legfeljebb 100-at adhat vissza.
LekérdezésKö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

Ez egy példa lekérdezés az elmúlt napon frissített értékesítési terv csoportok lekérésére:

name='Subscribe & Save'

A category változó egy szűrő, amely az Értékesítési terv csoport lekérdezésen érhető el, és az értékesítési terv csoportok adott kategóriáinak kiválasztására használható.

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

  • Az elérhető értékesítési terv csoport szű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 adminisztrációs felületen a szűréskor használt URL-ekben. 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 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 minden listaelemét külön kell kezelnie, például mindegyikhez címkét kell adnia, akkor használhatja a Ciklus műveletet.
  • Ha adatokat szeretne összesíteni, például meg szeretné számolni, hogy hány eredményt kapott, akkor használhatja a Számlálás vagy az Ö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 a műveletet követő lépésekben használja az Értékesítési terv csoport adatainak lekérése nevű változót, amely az értékesítési terv csoportok listája. Ezt a változót feltételekben és műveletekben is használhatja. Például elküldheti az értékesítési terv csoportok listáját egy Belső e-mail küldése műveletben, az alábbiak szerint:

{% for getSellingPlanGroupData_item in getSellingPlanGroupData %}
  {{getSellingPlanGroupData_item.name}}
{% endfor %}

Példa

Például egy munkafolyamat futtatása minden vasárnap reggel 9:00-ra van ütemezve. Az Értékesítési terv csoport adatainak lekérése művelet az elmúlt héten létrehozott értékesítési terv csoportok adatainak gyűjtésére szolgál. Ha az értékesítési terv csoportokhoz társított termékek a legkelendőbbek, akkor az értékesítési terv csoport position (pozíciója) növekedhet.

API-referencia