Rendelési vázlat adatainak lekérése
A rendelési vázlatok adatait használó munkafolyamatokban a Rendelési vázlat adatainak lekérése művelettel kérheti le a rendelési vázlatok adatait az üzletéből.
Ezen az oldalon
Konfiguráció
Mezők
A Rendelési vázlat adatainak lekérése művelet a következő mezőket tartalmazza, amelyek a lekérdezés létrehozásához használatosak:
| Mező | Leírás |
|---|---|
| Adatok rendezése | Kötelező. A paraméterek, amelyek szerint 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-at 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ő karakterlánc
Az alábbiakban egy példa látható egy olyan lekérdezésre, amely az utolsó napon frissített rendelési vázlatokat kéri le:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Az updated_at változó egy szűrő, amely a Draft orders query-n érhető el, és többször is használható, illetve más változókkal is kombinálható. A scheduledAt Liquid változó az Ütemezett időpont kiváltót használó munkafolyamatokban érhető el. A date_minus Liquid címke egy speciális Flow-címke, amellyel időt vonhat ki egy dátumból.
Az adatok lekérdezésekor hasznos tudni a következőket:
- Az elérhető rendelési 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. Bizonyos 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őt alkalmaz. Például egyes rendeléslekérdezési értékek megkereséséhez szűrje a Rendelések oldalt 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 listaelemet egyenként kell kezelnie, például mindegyikhez címkét szeretne hozzáadni, akkor használhatja a For each műveletet.
- Ha összesítenie kell az adatokat, például meg kell számolnia, hogy hány eredményt adott vissza a rendszer, akkor a Count vagy a Sum műveletet használhatja.
- Ha ki kell adnia a listát, például hogy e-mailt küldjön az összes tétellel, akkor a visszaadott adatokat közvetlenül felhasználhatja a későbbi műveletekben.
A visszaadott adatok eléréséhez az ezt a műveletet követő lépésekben használja a Rendelési vázlat adatainak lekérése nevű változót, amely a rendelési vázlatok listája. Ezt a változót feltételekben és műveletekben egyaránt használhatja. Például elküldheti a rendelési vázlatok listáját egy Belső e-mail küldése műveletben az alábbiak szerint:
{% for single_order in GetDraftOrderData %}
* {{ single_order.name }}
{% 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ó munkafolyamat a megadott időpontban indul el, nem pedig egy esemény eredményeként. Mivel nincs olyan konkrét esemény az üzletben vagy egy alkalmazásban, amely elindítaná a munkafolyamatot, a rendszer nem tartalmaz automatikusan adatokat.
API-részletek
Sablonok
Napi értesítés küldése az összes nyitott rendelési vázlatról
Minden nap lekéri a nyitott rendelési vázlatokat, megszámolja őket, és Slack-üzenetet küld. Az Ütemezett időpont kiváltót, a Rendelési vázlatok lekérése és a Count műveleteket használja. Sablon megtekintése