Lấy dữ liệu bộ sưu tập
Trong các dòng công việc yêu cầu dữ liệu bộ sưu tập, bạn có thể sử dụng thao tác Lấy dữ liệu bộ sưu tập để lấy thông tin bộ sưu tập từ cửa hàng.
Cấu hình
Trường
Hành động Lấy dữ liệu bộ sưu tập 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 thông 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 mà truy vấn tìm kiếm bạn chọn có thể trả về. Bạn có thể nhận tối đa 100 kết quả một 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ự tạo. |
Chuỗi truy vấn
Đây là ví dụ về truy vấn để lấy các bộ sưu tập được 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 trong Truy vấn bộ sưu tập 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 khả dụng trên các dòng công việc đã 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 biết:
- Danh sách các bộ lọc bộ sưu tập khả dụng
- Truy vấn phải tuân theo 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 thành tài liệu. Trong một số trường hợp, có thể tìm 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 ở trang 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 trang quản trị, sau đó kiểm tra URL.
- Bạn có thể chạy hoặc kiểm tra truy vấn trong cửa hàng bằng ứng dụng Shopify GraphiQL.
- Hãy lưu ý điều sẽ 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ề một danh sách chứa 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ể 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ư để thêm thẻ cho từng mục, bạn có thể sử 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ể sử 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 kèm theo tất cả các mục, bạn có thể trực tiếp sử dụng dữ liệu trả về trong những hành động tiếp theo.
Để truy cập dữ liệu trả về ở các bước diễn ra sau hành động này, hãy sử dụng biến có tên Lấy dữ liệu bộ sưu tập. Đây là danh sách các bộ sưu tập. Bạn có thể sử 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 bộ sưu tập trong hành động Gửi email nội bộ như sau:
{% for single_collection in GetCollectionData %}
* {{ single_collection.title }}
{% 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, bao gồm cả yếu tố kích hoạt Thời gian đã lên lịch. Ở 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 sẽ bắt đầu vào thời gian bạn chỉ định, thay vì bắt đầu do một sự kiện. Vì không có sự kiện cụ thể nào trong cửa hàng của bạn 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 được đưa vào tự động.