Vállalkozás telephelyadatainak lekérése

A vállalkozás telephelyadatait használó munkafolyamatokban a Vállalkozás telephelyadatainak lekérése művelettel kérhetők le a vállalkozás telephelyére vonatkozó információk az üzletből.

Konfiguráció

Mezők

A Vállalkozás telephelyadatainak lekérése művelet a következő mezőket tartalmazza, amelyek a lekérdezés létrehozásához használhatók:

Az Adatok lekérése műveletekben használt mezők.
MezőLeírás
Adatok rendezéseKötelező. A paraméterek, amelyek alapján a keresési lekérdezés által visszaadott adatok rendezve lesznek.
Találatok maximális számaKö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é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

Az alábbiakban egy példa látható egy olyan lekérdezésre, amely az elmúlt napon frissített vállalkozási telephelyeket kéri le:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

Az updated_at változó a Vállalkozások telephelyeinek lekérdezésénél elérhető szűrő, amely többször is használható, vagy más változókkal kombinálható. 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, amellyel időt vonhat ki egy dátumból.

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

  • Az elérhető vállalkozásitelephely-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 az API-dokumentációban találhatók meg. Alternatív megoldásként a mezőértékeket gyakran megtalálhatja az URL-ekben az adminisztrációs felületen, amikor szűrőt alkalmaz. Ha például meg szeretne találni 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ással 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 visszaadja (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 címkét szeretne hozzáadni mindegyikhez, akkor használhatja a Minden egyes elemre műveletet.
  • Ha összesítenie kell az adatokat, például meg kell számolnia, hogy hány eredményt adott vissza a rendszer, akkor használhatja a Számlálás vagy az Összegzés műveletet.
  • Ha ki kell adnia a listát, például egy e-mailt szeretne küldeni 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 Vállalkozás telephelyadatainak lekérése nevű változót, amely a vállalkozások telephelyeinek listája. Ezt a változót feltételekben és műveletekben egyaránt használhatja. Például elküldheti a telephelyek listáját egy Belső e-mail küldése műveletben, az alábbiak szerint:

{% for single_company in GetCompanyLocationData %}
* {{ single_company.name }}
{% 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ó munkafolyamatokban a 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 üzletben vagy egy alkalmazásban, amely elindítja a munkafolyamatot, a rendszer nem tartalmaz automatikusan adatokat.

API-referencia