Készpénzkövetési munkamenet adatainak lekérése
Azokban a munkafolyamatokban, amelyek készpénzkövetési munkamenetadatokat igényelnek, a Készpénzkövetési munkamenet adatainak lekérése művelettel kérheti le a készpénzkövetési munkamenetekre vonatkozó információkat a POS Pro rendszerből. A készpénzkövetési munkamenetek az üzlet pénztárgépeiben lévő készpénz nyomon követésére szolgálnak.
Ezen az oldalon
Konfiguráció
Mezők
A Készpénzkövetési munkamenet adatainak lekérése művelet a következő mezőket tartalmazza.
| Mező | Leírás |
|---|---|
| Adatok rendezése | Kötelező. Azok a paraméterek, amelyek alapján a keresési lekérdezés által visszaadott adatokat rendezi a rendszer. |
| 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 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 lezárt készpénzkövetési munkameneteket kéri le:
closing_time:<='{{ scheduledAt }}' AND closing_time:>'{{ scheduledAt | date_minus: "1 day" }}'A closing_time változó a CashTrackingSessions lekérdezésben 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őpont kiváltót használó munkafolyamatokban érhető el. 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:
A lekérdezéseknek egy bizonyos szintaxist kell követniük
A lekérdezési mezők értékei nem mindig dokumentáltak. Egyes 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, amikor szűr. Például a rendelési lekérdezések egyes értékeinek megkereséséhez szűrjön a Rendelések oldalra 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).
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 fel:
- Ha minden listaelemet külön kell kezelnie, például címkét szeretne hozzáadni mindegyikhez, akkor használhatja a For each műveletet.
- Ha összesítenie kell az adatokat, például meg kell számolnia, hogy hány találat érkezett, akkor használhatja a Számlálás vagy a Összegzés műveletet.
- Ha ki kell adnia a listát, például egy e-mailt kell küldenie 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 Get cash tracking session data nevű változót, amely a készpénzkövetési munkamenetek listája. Ezt a változót feltételekben és műveletekben egyaránt használhatja. Például elküldheti a készpénzkövetési munkamenetek listáját egy Belső e-mail küldése műveletben, az alábbiak szerint:
{% for single_cash_tracking_session in GetCashTrackingSessionData %}
* {{ single_cash_tracking_session.id }}
{% endfor %}Kiváltók
Ezt a műveletet bármilyen munkafolyamatban használhatja, beleértve az Ütemezett időpont kiváltót is. Az Ütemezett időpont kiváltót használó munkafolyamatok esetében 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 üzletében vagy egy alkalmazásban, amely elindítaná a munkafolyamatot, alapértelmezetten nem tartalmaz adatokat.
API-referencia
Az ebben a műveletben használt API-val kapcsolatos további információkért lásd a CashTrackingSessions lekérdezést.