Lấy dữ liệu danh mục

Trong các dòng công việc yêu cầu dữ liệu danh mục, bạn có thể sử dụng thao tác Lấy dữ liệu danh mục để truy xuất thông tin danh mục B2B từ cửa hàng. Danh mục là các nhóm sản phẩm có định giá tùy chỉnh cho các khách hàng B2B hoặc địa điểm công ty cụ thể.

Lưu ý

Đây là một loại thao tác Lấy dữ liệu. Để hiểu cách sử dụng loại thao tác này với yếu tố kích hoạt Thời gian đã lên lịch trình và vòng lặp Cho từng, hãy tham khảo Lịch trình, lấy dữ liệu và dòng công việc lặp lại trong Shopify Flow.

Cấu hình

Trường

Thao tác Lấy dữ liệu danh mục có các trường sau:

Các trường được dùng trong thao tác Lấy dữ liệu.

Trường	Mô tả
Sắp xếp dữ liệu theo	Bắt buộc. Các thông 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ề 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 tất cả danh mục đang hoạt động:

status:ACTIVE

Biến status là một bộ lọc có sẵn trên truy vấn Danh mục và có thể được 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 ý:

• Danh sách các bộ lọc danh mục hiện có

• 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 có toàn bộ các mục, có thể sử dụng trực tiếp dữ liệu trả về ở các hành động tiếp theo.

Để truy cập dữ liệu trả về ở những bước sau hành động này, hãy sử dụng biến có tên Lấy dữ liệu danh mục. Đây là một danh sách danh mục. Có thể sử dụng biến này trong cả điều kiện và hành động. Ví dụ: Có thể gửi danh sách danh mục trong hành động Gửi email nội bộ tương tự như sau:

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% endfor %}

Lưu ý

Nếu hành động Lấy dữ liệu được dùng nhiều lần trong một dòng công việc, thì sẽ có thêm một số vào tên biến. Ví dụ: trong một dòng công việc sử dụng hành động Lấy dữ liệu đơn hàng hai lần, biến đầu tiên cho dữ liệu trả về là getOrderData và biến thứ hai là getOrderData1. Không thể tùy chỉnh tên này.

Yếu tố kích hoạt

Có thể sử dụng hành động này trong bất kỳ dòng công việc nào, kể 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 được 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 kích hoạt dòng công việc này, nên không có dữ liệu nào tự động được đưa vào.

Tài liệu tham khảo về API

Để biết thêm thông tin về API được sử dụng trong hành động này, hãy xem truy vấn Danh mục.