Oldaladatok lekérése

Az oldaladatokat igénylő munkafolyamatokban az Oldaladatok lekérése műveletet használhatja arra, hogy oldaladatokat kérjen le az üzletéből. Az Oldalak az online áruház olyan weblapjai, amelyek ritkán változó információkat tartalmaznak, például a Rólunk oldal vagy a Kapcsolat oldal.

Megjegyzés

Ez az Adatok lekérése műveletek egyik típusa. Ha szeretné megérteni, hogyan használhatja ezt a művelettípust az Ütemezett időpont kiváltóval és a Minden egyes ciklusokkal, olvassa el az Ütemezések, adatlekérés és munkafolyamat-ciklusok a Shopify Flow-ban című részt.

Konfiguráció

Mezők

Az Oldaladatok lekérése művelet a következő mezőket tartalmazza:

Az Adatok lekérése műveletekben használt mezők.

Mező	Leírás
Adatok rendezési szempontja	Kötelező. Azok a paraméterek, amelyek alapján a keresési lekérdezés által visszaadott adatok rendezve lesznek.
Eredmények maximális száma	Kötelező. A kiválasztott keresési lekérdezés által visszaadható eredmények maximális száma. Egyszerre legfeljebb 100 eredményt kaphat 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éldalekérdezés a közzétett oldalak lekérésére:

published_status:published

A published_status változó az Oldalak lekérdezésénél elérhető szűrő, amely többször is használható, illetve más változókkal is kombinálható.

Adatok lekérdezésekor érdemes tudni a következőket:

• Az elérhető oldalszűrők listája

• A lekérdezéseknek 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 adminisztrációs felületen lévő URL-ekben is, amikor szűrést alkalmaz. Például néhány Rendelés-lekérdezési érték megkereséséhez 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 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 adna vissza).

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:

• Ha a lista minden egyes tételét külön kell kezelnie, például mindegyikhez címkét kell hozzáadnia, akkor használhatja a Minden egyes műveletet.
• Ha összesítenie kell az adatokat, például meg kell számolnia, hogy hány eredményt kapott vissza, akkor a Számlálás vagy az Összegzés műveletet használhatja.
• Ha a listát kimenetként szeretné használni, például az összes tételt el szeretné küldeni e-mailben, a visszaadott adatokat közvetlenül felhasználhatja a későbbi műveletekben.

A visszaadott adatoknak a műveletet követő lépésekben való eléréséhez használja az Oldaladatok lekérése nevű változót, amely az oldalak listáját tartalmazza. Ezt a változót feltételekben és műveletekben egyaránt használhatja. Például elküldheti az oldalak listáját egy ehhez hasonló Belső e-mail küldése műveletben:

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

Megjegyzés

Ha egy Adatok lekérése műveletet többször is használ egyetlen munkafolyamatban, akkor a változó neve egy számmal egészül ki. Például egy olyan munkafolyamatban, amely kétszer használja a Rendelési adatok lekérése műveletet, a visszaadott adatok első változója a getOrderData, a második változója pedig a getOrderData1. Ez a név nem szabható testre.

Kiváltók

Ezt a műveletet bármely munkafolyamatban használhatja, beleértve az Ütemezett időpont kiváltót is. Egy olyan munkafolyamatban, amely az Ütemezett időpont kiváltót használja, a munkafolyamat az Ön által megadott időpontban indul el, nem pedig egy esemény eredményeként. Mivel az üzletében vagy valamelyik alkalmazásban nincs konkrét esemény, amely elindítaná a munkafolyamatot, nem kerül bele automatikusan semmilyen adat.

API-referencia

Az ebben a műveletben használt API-val kapcsolatos további információkat az Oldalak lekérdezése részben találja.