Metaobjektum-bejegyzések lekérése
A Metaobjektum-bejegyzések lekérése művelettel lekérheti egy metaobjektum bejegyzéseinek listáját az üzletéből egy opcionális lekérdezés alapján. További információkért lásd a metaobjektumok dokumentációját.
Ezen az oldalon
Konfiguráció
Mezők
A Metaobjektum-bejegyzések lekérése művelet tartalmaz egy legördülő menüt a metaobjektum-definíció megadásához, valamint a következő mezőket, amelyek a lekérdezés összeállítására szolgálnak:
| Mező | Leírás |
|---|---|
| Adatok rendezése | Kötelező. Azok a paraméterek, amelyek alapján 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 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
Az alábbi példa egy olyan lekérdezést mutat be, amely akkor kér le metaobjektum-bejegyzéseket, ha egy email mező értéke megegyezik egy rendelésen szereplő e-mail-címmel:
{{fields.email}}:"{{order.email}}"Az alábbi példa egy olyan lekérdezést mutat be, amely az elmúlt napon frissített metaobjektum-bejegyzéseket kéri le:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Az updated_at változó egy szűrő, amely a Metaobjektumok lekérdezésében é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 Időzített 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 ki egy dátumból.
Adatok lekérdezésekor hasznos tudni a következőket:
- Az elérhető metaobjektum-szűrők listája
- A metaobjektumok mezőérték szerinti lekérdezéséhez szükséges, hogy a metaobjektumon engedélyezve legyen a szűrés, ami a Shopify adminisztrációs felületén, az egyéni adatok beállításainál engedélyezhető.
- 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. Másik lehetőségként a mezőértékeket gyakran megtalálhatja az adminisztrációs felületen lévő URL-ekben szűréskor. Például egyes rendelési lekérdezési értékek megtalálásához szűrjön rá a Rendelések oldalra 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 listatételt egyenként kell kezelnie, például mindegyikhez címkét szeretne hozzáadni, akkor használhatja a Ciklus (For each) 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 az Összegzés műveletet.
- Ha a teljes listát szeretné felhasználni, például egy e-mailt küldene az összes tétellel, akkor a visszaadott adatokat közvetlenül felhasználhatja a későbbi műveletekben.
A műveletet követő lépésekben a visszaadott adatok eléréséhez használja a Metaobjektum-bejegyzések lekérése nevű változót, amely a metaobjektum-bejegyzések listája. Ezt a változót feltételekben és műveletekben egyaránt használhatja. Például elküldheti a metaobjektum-bejegyzések kulcs-érték párjainak listáját egy Belső e-mail küldése műveletben, az alábbiak szerint:
{% for getMetaobjectEntries_item in getMetaobjectEntries %}
Key-value pairs for entry:
{% for fields_item in getMetaobjectEntries_item.system.fields %}
{{fields_item.key}}:{{fields_item.value}}
{% endfor %}
{% endfor %}Kiváltók
Ez a művelet bármilyen munkafolyamatban használható, beleértve az Időzített kiváltót is. Az Időzített kiváltót használó munkafolyamat egy Ön által megadott időpontban indul el, nem pedig egy esemény eredményeként. Mivel nincs olyan konkrét esemény az üzletében vagy egy alkalmazásban, amely elindítja a munkafolyamatot, nincsenek automatikusan belefoglalt adatok.