Lấy dữ liệu mặt hàng tồn kho
Trong dòng công việc yêu cầu dữ liệu mặt hàng tồn kho, có thể sử dụng hành động Lấy dữ liệu mặt hàng tồn kho để lấy thông tin mặt hàng tồn kho từ cửa hàng. Mặt hàng tồn kho là các đơn vị hàng sẵn có thực tế được theo dõi cho các biến thể sản phẩm.
Cấu hình
Trường
Hành động Lấy dữ liệu mặt hàng tồn kho chứa các trường sau:
| Trường | Mô tả |
|---|---|
| Sắp xếp dữ liệu theo | Bắt buộc. Tham số dùng để sắp xếp dữ liệu trả về bởi truy vấn tìm kiếm. |
| Số kết quả tối đa | Bắt buộc. Số lượng kết quả tối đa có thể trả về bởi truy vấn tìm kiếm đã chọ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 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à truy vấn ví dụ để lấy các mặt hàng tồn kho được theo dõi:
tracked:trueBiến tracked là một bộ lọc có sẵn trên truy vấn Mặt hàng tồn kho và có thể sử dụng nhiều lần hoặc kết hợp với các biến khác.
Khi truy vấn dữ liệu, 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 các giá trị trường truy vấn cũng có 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, 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 áp dụng bộ 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.
Có thể chạy hoặc kiểm tra truy vấn trong cửa hàng bằng ứng dụng Shopify GraphiQL.
Cần lưu ý về điều sẽ xảy ra nếu truy vấn bị lỗi. Thường thì API sẽ trả về toàn bộ kết quả (thay vì không có kết quả nào).
Dữ liệu trả về
Mọi 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 thuộc vào trường hợp sử dụng, có thể tận 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 từng mục, 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ề, 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 tất cả mặt hàng, bạn có thể sử dụng trực tiếp dữ liệu trả về trong các thao tác tiếp theo.
Để truy cập dữ liệu trả về trong các bước theo sau thao tác này, hãy sử dụng biến có tên Lấy dữ liệu mặt hàng tồn kho, đây là một danh sách các mặt hàng tồn kho. Bạn có thể sử dụng biến này trong cả điều kiện và thao tác. Ví dụ: Bạn có thể gửi danh sách mặt hàng tồn kho trong thao tác Gửi email nội bộ tương tự như sau:
{% for single_inventory_item in getInventoryItemData %}
* SKU: {{ single_inventory_item.sku }} - Cost: {{ single_inventory_item.unitCost.amount }}
{% 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 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ừ ứng dụng để bắt đầu dòng công việc nên sẽ không có dữ liệu nào được tự động đưa vào.
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, hãy xem Truy vấn mặt hàng tồn kho.