Lấy dữ liệu đơn hàng nháp
Trong dòng công việc sử dụng dữ liệu đơn hàng nháp, bạn có thể dùng thao tác Lấy dữ liệu đơn hàng nháp để lấy thông tin đơn hàng nháp từ cửa hàng.
Trên trang này
Cấu hình
Trường
Thao tác Lấy dữ liệu đơn hàng nháp chứa các trường sau để xây dựng truy vấn:
| 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ố kết quả tối đa | Bắt buộc. Số kết quả tối đa truy vấn tìm kiếm đã chọn có thể trả về. Bạn có thể trả về tối đa 100 kết quả mỗi lần. |
| Truy vấn | Bắt buộc. Chọn từ các truy vấn phổ biến hoặc chọn Nâng cao để tạo truy vấn riêng. |
Chuỗi truy vấn
Dưới đây là ví dụ về truy vấn để lấy các đơn hàng nháp đã cập nhật trong ngày qua:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Biến updated_at là bộ lọc có trong Truy vấn đơn hàng nháp và có thể 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ó sẵn 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à 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 nên lưu ý những điều sau:
- Danh sách các bộ lọc đơn hàng có sẵn
- Truy vấn phải tuân theo một cú pháp nhất định
- Giá trị trường truy vấn không phải lúc nào cũng được ghi chú trong tài liệu. Trong một số trường hợp, 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 của 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 của mình bằng ứng dụng Shopify GraphiQL.
- Hãy lưu ý điều xảy ra nếu truy vấn không thành công. 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ề
Tất cả hành động Lấy dữ liệu đều trả về danh sách từ 0 đến 100 tài nguyên. Tùy thuộc vào trường hợp sử dụng, bạn có thể 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ể dùng hành động 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ả trả về, bạn có thể dùng hành động Đếm hoặc Tính 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ể dùng dữ liệu trả về trực tiếp trong những hành động tiếp theo.
Để truy cập dữ liệu trả về trong các bước tiếp theo của hành động này, hãy dùng biến có tên Lấy dữ liệu đơn hàng nháp. Đây là danh sách các đơn hàng nháp. Bạn có thể dùng biến này trong cả điều kiện và hành động. Ví dụ: bạn có thể gửi danh sách đơn hàng nháp bằng hành động Gửi email nội bộ như sau:
{% for single_order in GetDraftOrderData %}
* {{ single_order.name }}
{% endfor %}Yếu tố kích hoạt
Bạn có thể sử dụng hành động này trong bất kỳ dòng công việc nào, kể cả dòng công việc 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 này sẽ bắt đầu vào thời gian bạn chỉ định, thay vì do một sự kiện mang lại. Vì không có sự kiện cụ thể nào trong cửa hàng hoặc từ ứng dụng kích hoạt dòng công việc, nên sẽ không có dữ liệu nào tự động đưa vào.
Thông tin chi tiết API
Mẫu
Gửi thông báo hằng ngày kèm theo tất cả đơn hàng nháp đang mở
Hằng ngày, lấy các đơn hàng nháp đang mở, đếm số lượng rồi gửi tin nhắn Slack. Sử dụng yếu tố kích hoạt Thời gian đã lên lịch cùng với hành động Lấy đơn hàng nháp và hành động Đếm. Xem mẫu