Súgó
Bejelentkezés

Cégadatok lekérése

A cégadatokat használó munkafolyamatokban a Cégadatok lekérése művelettel kérhet le céginformációkat az üzletéből.

Ezen az oldalon

Konfiguráció

Mezők

A Cégadatok lekérése művelet a következő mezőket tartalmazza, amelyek a lekérdezés összeállítására szolgálnak:

Az Adatok lekérése műveletekben használt mezők.
MezőLeírás
Adatok rendezéseKötelező. Azok a paraméterek, amelyek alapján a lekérdezés által visszaadott adatok rendezve vannak.
Találatok maximális számaKötelező. A kiválasztott lekérdezés által visszaadható találatok maximális száma. Egyszerre legfeljebb 100-at adhat vissza.
LekérdezésKö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 cégek 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 Cégek 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ő cégszű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 adatokat kell összesítenie, például meg kell számolnia, hogy hány találat érkezett vissza, akkor használhatja a Számlálás vagy az Összegzés műveletet.
  • Ha ki szeretné adni a listát, például e-mailt szeretne küldeni az összes tétellel, akkor a visszakapott adatokat közvetlenül felhasználhatja a további műveletekben.

A műveletet követő lépésekben a visszakapott adatok eléréséhez használja a Cégadatok lekérdezése nevű változót, amely a cégek listája. Ezt a változót feltételekben és műveletekben egyaránt használhatja. Például a cégek listáját a következőképpen küldheti el egy Belső e-mail küldése műveletben:

{% for single_company in GetCompanyData %}
* {{ single_company.name }}
{% endfor %}

Kiváltók

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

API-referencia