Lấy dữ liệu hợp đồng đăng ký
Trong các dòng công việc sử dụng dữ liệu hợp đồng đăng ký, bạn có thể dùng hành động Lấy dữ liệu hợp đồng đăng ký để truy xuất thông tin hợp đồng đăng ký từ cửa hàng.
Trên trang này
Cấu hình
Trường
Hành động Lấy dữ liệu hợp đồng đăng ký chứa các trường sau đây, dùng để tạo truy vấn:
| Trường | Mô tả |
|---|---|
| Sắp xếp dữ liệu theo | Bắt buộc. Các tham số dùng để 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 bạn chọn. Bạn có thể nhận tối đa 100 kết quả mỗi lần. |
| Truy vấn | Bắt buộc. Chọn trong số các truy vấn phổ biến hoặc chọn Nâng cao để tự tạo truy vấn. |
Chuỗi truy vấn
Đây là ví dụ về truy vấn để lấy các hợp đồng đăng ký có trạng thái ACTIVE:
status: ACTIVEBiến status là một bộ lọc có sẵn trên Truy vấn hợp đồng đăng ký và có thể được sử dụng nhiều lần.
Khi truy vấn dữ liệu, bạn nên biết:
- Danh sách các bộ lọc có sẵn
- Các 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 lập tài liệu. Trong một số trường hợp, bạn có thể tìm thấy giá trị 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 trên 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 trên bảng điều khiển 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 gì 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ó gì).
Dữ liệu trả về
Tất cả hành động Lấy dữ liệu đều trả về danh sách có từ 0 đến 100 tài nguyên. Tùy vào trường hợp sử dụng, 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 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ổng.
- Nếu cần xuất danh sách, chẳng hạn như gửi email chứa tất cả các mục, bạn có thể sử dụng trực tiếp dữ liệu trả về trong các hành động tiếp theo.
Để truy cập dữ liệu trả về trong các bước sau hành động này, hãy sử dụng biến có tên Lấy dữ liệu hợp đồng đăng ký, đây là danh sách các hợp đồng đăng ký. 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 đơn hàng trong hành động Gửi email nội bộ như sau:
{% for single_contract in GetSubscriptionContractData %}
* {{ single_contract.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, 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 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 bắt đầu dòng công việc, nên không có dữ liệu nào được tự động đưa vào.