Kollekcióadatok lekérése
Azokban a munkafolyamatokban, amelyek kollekcióadatokat igényelnek, a Kollekcióadatok lekérése művelettel kérheti le a kollekciókra vonatkozó információkat az üzletéből.
Ezen az oldalon
Konfiguráció
Mezők
A Kollekcióadatok lekérése művelet a következő mezőket tartalmazza.
| Mező | Leírás |
|---|---|
| Adatok rendezése | Kötelező. Azok a paraméterek, amelyek alapján a keresési lekérdezés által visszaadott adatokat rendezi a rendszer. |
| 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ési karakterlánc
Ez egy példa lekérdezés az elmúlt napon frissített kollekciók lekérésére:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Az updated_at változó egy szűrő, amely a Kollekciók lekérdezésen érhető el, és többször is használható, vagy kombinálható más változókkal. A scheduledAt Liquid-változó azokban a munkafolyamatokban érhető el, amelyek az Ütemezett idő kiváltót használták. A date_minus Liquid-címke egy speciális Flow-címke, amely lehetővé teszi, hogy időt vonjon le egy dátumból.
Az adatok lekérdezésekor hasznos tudni a következőket:
- Az elérhető kollekció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 a 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 lévő URL-ekben, amikor szűr. Például, hogy találjon néhány rendelési lekérdezési értéket, 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 adja vissza (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önféle módokon használhatja fel:
- Ha minden listaelemét egyenként kell kezelnie, például mindegyikhez címkét szeretne hozzáadni, akkor használhatja a Mindegyikre műveletet.
- Ha összesítenie kell az adatokat, például meg kell számolnia, hogy hány eredményt adtak vissza, akkor használhatja a Számlálás vagy a Összegzés műveletet.
- Ha a listát ki kell adnia, 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 Kollekcióadatok lekérése nevű változót, amely kollekciók listája. Ezt a változót feltételekben és műveletekben egyaránt használhatja. Például a kollekciók listáját elküldheti egy Belső e-mail küldése műveletben az alábbiak szerint:
{% for single_collection in GetCollectionData %}
* {{ single_collection.title }}
{% endfor %}Kiváltók
Ezt a műveletet bármely munkafolyamatban használhatja, beleértve az Ütemezett idő kiváltót is. Az Ütemezett idő kiváltót használó munkafolyamatban a munkafolyamat egy Ön által megadott időpontban indul el, nem pedig egy esemény eredményeként. Mivel nincs konkrét esemény az üzletében vagy egy alkalmazásban, amely elindítaná a munkafolyamatot, nincsenek automatikusan belefoglalt adatok.