Lấy dữ liệu trang

Trong các dòng công việc yêu cầu dữ liệu trang, bạn có thể sử dụng thao tác Lấy dữ liệu trang để lấy thông tin trang từ cửa hàng. Trang là các trang web trên cửa hàng trực tuyến chứa thông tin ít khi thay đổi, chẳng hạn như trang Giới thiệu hoặc trang Liên hệ.

Lưu ý

Đây là 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 và vòng lặp Cho mỗi, hãy tham khảo Lịch trình, lấy dữ liệu và lặp lại dòng công việc trong Shopify Flow.

Cấu hình

Trường

Thao tác Lấy dữ liệu trang chứa 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 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ể trả về tới 100 kết quả mỗi lần.
Truy vấn	Bắt buộc. Chọn các truy vấn phổ biến hoặc chọn Nâng cao để tạo truy vấn của riêng bạn.

Chuỗi truy vấn

Đây là truy vấn ví dụ để lấy các trang đã đăng:

published_status:published

Biến published_status là bộ lọc có trong Truy vấn trang 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, bạn nên biết những điều sau:

• Danh sách các bộ lọc trang hiện có

• 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ó tài liệu đi kèm. 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 các 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ị rồi kiểm tra URL.

• Bạn có thể chạy hoặc kiểm tra truy vấn trên cửa hàng bằng ứng dụng Shopify GraphiQL.

• Cần lưu ý những gì sẽ xảy ra nếu truy vấn không thành công. Thường thì API sẽ trả về tất cả kết quả (thay vì không có gì).

Dữ liệu trả về

Tất cả thao tác Lấy dữ liệu sẽ trả về danh sách chứa từ 0 đến 100 tài nguyên. Tùy vào trường hợp sử dụng, bạn có thể sẽ muố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 mỗi mục, bạn có thể sử dụng thao tác Cho mỗi.
• Nếu cần tổng hợp dữ liệu, ví dụ như đếm số lượng kết quả trả về, bạn có thể dùng thao tác Đế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ục, 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 trang, đây là một danh sách các trang. 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 các trang trong thao tác Gửi email nội bộ tương tự như sau:

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

Lưu ý

Nếu thao tác Lấy dữ liệu được dùng nhiều lần trong cùng một dòng công việc, một số sẽ được thêm vào tên biến. Ví dụ: Trong dòng công việc sử dụng thao tác 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

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 trang.