Cikkadatok lekérése
Azokban a munkafolyamatokban, amelyekhez blogcikk-adatok szükségesek, a Cikkadatok lekérése művelettel kérhet le cikkinformációkat a Shopify-üzletből.
Ezen az oldalon
Konfiguráció
Mezők
A Cikkadatok lekérése művelet a következő mezőket tartalmazza:
| Mező | Leírás |
|---|---|
| Adatok rendezési szempontja | Kötelező. A paraméterek, amelyek alapján a keresési lekérdezés által visszaadott adatok rendezve vannak. |
| 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 a saját lekérdezés létrehozásához. |
Lekérdezési karakterlánc
Ez egy példa az elmúlt egy napban közzétett cikkek lekérdezésére:
published_at:<='{{ scheduledAt }}' AND published_at:>'{{ scheduledAt | date_minus: "1 day" }}'A published_at változó a Cikkek lekérdezése esetén elérhető szűrő, amelyet többször is használhat, vagy kombinálhat más változókkal. A scheduledAt Liquid-változó az Ütemezett idő kiváltót használó munkafolyamatokban érhető el. A date_minus Liquid-címke egy speciális Flow-címke, amely lehetővé teszi az idő kivonását egy adott dátumból.
Adatok lekérésekor hasznos tudni a következőket:
A lekérdezéseknek egy meghatározott szintaxist kell követniük
A lekérdezések mezőértékei nincsenek mindig dokumentálva. Bizonyos esetekben az értékeket az API-dokumentációban találhatja meg. Alternatív megoldásként a mezőértékeket gyakran megtalálhatja az adminisztrációs felület URL-címeiben is a szűrés során. Például egyes rendelési 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 lekérdezéseket a Shopify GraphiQL alkalmazás segítségével futtathatja vagy tesztelheti a boltjában.
Gondoljon arra, hogy mi történik, ha a lekérdezés sikertelen. Gyakran előfordul, hogy az API (a semmi helyett) az összes találatot visszaadja.
Visszakapott adatok
Minden Adatok lekérése művelet egy 0–100 erőforrásból álló listát ad vissza. A használati esettől függően ezt az adatot többféleképpen is felhasználhatja:
- Ha minden egyes listaelemre külön van szüksége, például ha mindegyikhez egy címkét szeretne hozzáadni, használhatja a Minden egyes műveletet.
- Ha az adatok összesítésére van szüksége, például meg szeretné számolni a visszaadott találatokat, használhatja a Számlálás vagy az Összegzés műveleteket.
- Ha a listát kimenetként szeretné használni, például egy e-mailt szeretne küldeni az összes elemmel, a visszakapott adatokat közvetlenül felhasználhatja a későbbi műveletekben.
Ha ezen művelet után következő lépésekben szeretne hozzáférni a visszakapott adatokhoz, használja a cikkek listáját tartalmazó Cikkadatok lekérése nevű változót. Ezt a változót mind a feltételekben, mind a műveletekben használhatja. Például elküldheti a cikkek listáját egy ehhez hasonló Belső e-mail küldése műveletben:
{% for single_article in GetArticleData %}
* {{ single_article.title }}
{% endfor %}Kiváltók
Ezt a műveletet bármely munkafolyamatban használhatja, beleértve az Ütemezett idő kiváltót is. Egy olyan munkafolyamat esetében, amely az Ütemezett idő kiváltót használja, a munkafolyamat egy esemény bekövetkezése helyett egy Ön által megadott időpontban indul el. Mivel nincs olyan konkrét esemény a boltjában vagy egy alkalmazásban, amely elindítaná a munkafolyamatot, nem tartalmaz automatikusan adatokat.
API-referencia
A műveletben használt API-val kapcsolatos további információkért tekintse meg a Cikkek lekérdezése részt.