Lấy dữ liệu phiên theo dõi tiền mặt
Trong các dòng công việc yêu cầu dữ liệu phiên theo dõi tiền mặt, bạn có thể sử dụng thao tác Lấy dữ liệu phiên theo dõi tiền mặt để lấy thông tin phiên theo dõi tiền mặt từ POS Pro. Các phiên theo dõi tiền mặt được sử dụng để theo dõi tiền mặt trong máy tính tiền tại cửa hàng của bạn.
Cấu hình
Trường
Thao tác Lấy dữ liệu phiên theo dõi tiền mặt chứa các trường sau.
| Trường | Mô tả |
|---|---|
| Sắp xếp dữ liệu theo | Bắt buộc. Các tham số để sắp xếp dữ liệu do truy vấn tìm kiếm trả về. |
| Số lượng kết quả tối đa | Bắt buộc. Số lượng kết quả tối đa có thể trả về từ truy vấn tìm kiếm mà bạn đã chọn. Bạn có thể trả về tối đa 100 kết quả cùng một lúc. |
| Truy vấn | Bắt buộc. Chọn từ các truy vấn chung hoặc chọn Nâng cao để tạo truy vấn của riêng bạn. |
Chuỗi truy vấn
Đây là ví dụ về truy vấn để lấy các phiên theo dõi tiền mặt đã đóng trong ngày qua:
closing_time:<='{{ scheduledAt }}' AND closing_time:>'{{ scheduledAt | date_minus: "1 day" }}'Biến closing_time là bộ lọc có trong truy vấn CashTrackingSessions và có thể sử dụng nhiều lần hoặc kết hợp với các biến khác. Biến Liquid scheduledAt có trên các dòng công việc đã sử dụng yếu tố kích hoạt Thời gian đã lên lịch. Thẻ Liquid date_minus là một thẻ Flow đặc biệt cho phép bạn trừ đi thời gian từ một ngày.
Khi truy vấn dữ liệu, bạn cần lưu ý:
Các truy vấn phải tuân theo cú pháp nhất định
Không phải lúc nào giá trị trường truy vấn cũng được ghi lại. Trong một số trường hợp, bạn có thể tìm thấy các giá trị này bằng cách xem tài liệu API. Ngoài ra, bạn thường có thể tìm thấy giá trị trường trong URL thuộc bảng điều khiển quản trị khi lọc. Ví dụ: để tìm một số giá trị truy vấn Đơn hàng, hãy lọc trang Đơn hàng trong bảng điều khiển quản trị, sau đó kiểm tra URL.
Bạn có thể chạy hoặc thử nghiệm truy vấn trong cửa hàng bằng cách sử dụng ứng dụng Shopify GraphiQL.
Cần lưu ý điều gì sẽ xảy ra nếu truy vấn bị lỗi. Thông thường, API sẽ trả về tất cả kết quả (thay vì không có kết quả nào).
Dữ liệu trả về
Mọi thao tác Lấy dữ liệu đều trả về danh sách chứa 0 đến 100 tài nguyên. Tùy thuộc vào trường hợp sử dụng mà bạn có thể muốn sử dụng dữ liệu này theo nhiều cách khác nhau:
- Nếu cần xử lý riêng từng mục trong danh sách, chẳng hạn như gắn thẻ cho mỗi mục, bạn có thể sử dụng thao tác Cho mỗi.
- Nếu cần tổng hợp dữ liệu, chẳng hạn như đếm số lượng kết quả được trả về, bạn có thể sử dụng thao tác Đếm hoặc Tổng.
- Nếu cần xuất danh sách, chẳng hạn như gửi email có tất cả các mục, bạn có thể sử dụng trực tiếp dữ liệu trả về ở những thao tác tiếp theo.
Để truy cập dữ liệu trả về ở các bước tiếp theo, hãy sử dụng biến có tên Lấy dữ liệu phiên theo dõi tiền mặt. Đây là danh sách các phiên theo dõi tiền mặt. Bạn có thể sử dụng biến này ở cả điều kiện và thao tác. Ví dụ: bạn có thể gửi danh sách các phiên theo dõi tiền mặt trong thao tác Gửi email nội bộ như sau:
{% for single_cash_tracking_session in GetCashTrackingSessionData %}
* {{ single_cash_tracking_session.id }}
{% endfor %}Yếu tố kích hoạt
Bạn có thể sử dụng thao tác này trong bất kỳ dòng công việc nào, bao gồm cả yếu tố kích hoạt Thời gian đã lên lịch. Trong dòng công việc sử dụng yếu tố kích hoạt Thời gian đã lên lịch, dòng công việc bắt đầu vào thời điểm mà bạn đã chỉ định, thay vì do một sự kiện. Do không có sự kiện cụ thể nào trong cửa hàng hoặc từ một ứng dụng để bắt đầu dòng công việc, không có dữ liệu nào được đưa vào tự động.
Tài liệu tham khảo API
Để biết thêm thông tin về API được sử dụng trong thao tác này, xem truy vấn CashTrackingSessions.