Lấy dữ liệu bài viết

Trong các dòng công việc yêu cầu dữ liệu bài viết trên blog, bạn có thể sử dụng thao tác Lấy dữ liệu bài viết để truy xuất thông tin bài viết từ cửa hàng Shopify.

Lưu ý

Đây là một loại thao tác Lấy dữ liệu. Để hiểu cách 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 For each, tham khảo phần 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 bài viết 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ố để sắp xếp dữ liệu do truy vấn tìm kiếm trả về.
Số kết quả tối đa	Bắt buộc. Số kết quả tối đa có thể được trả về theo 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à truy vấn mẫu để lấy các bài viết đã xuất bản vào ngày trước đó:

published_at:<='{{ scheduledAt }}' AND published_at:>'{{ scheduledAt | date_minus: "1 day" }}'

Biến published_at là một bộ lọc có sẵn trên Truy vấn bài viết và có thể được dùng nhiều lần hoặc kết hợp với các biến khác. Biến Liquid scheduledAt có trên các dòng công việc sử dụng yếu tố kích hoạt Thời gian đã lên lịch. Thẻ Liquid date_minus là một thẻ Flow đặc biệt cho phép bạn trừ bớt thời gian khỏi một ngày.

Khi truy vấn dữ liệu, bạn nên lưu ý:

• Danh sách các bộ lọc bài viết có sẵn

• 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 nhận trong tài liệu. Trong một số trường hợp, bạn có thể tìm thấy các giá trị này bằng cách xem tài liệu về API. Ngoài ra, bạn thường có thể tìm thấy giá trị trường trong URL tại 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 trong bảng điều khiển quản trị, sau đó kiểm tra URL.

• Bạn có thể chạy hoặc thử nghiệm truy vấn trong cửa hàng bằng cách sử dụng ứng dụng Shopify GraphiQL.

• Lưu ý điều 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ó kết quả nào).

Dữ liệu trả về

Mọi thao tác 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, 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ư thêm thẻ cho từng mục, bạn có thể sử dụng thao tác For each.
• Nếu cần tổng hợp dữ liệu, chẳng hạn như đếm số lượng kết quả được trả về, bạn có thể sử 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 có tất cả các mặt hàng, bạn có thể dùng trực tiếp dữ liệu trả về ở các thao tác tiếp theo.

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

{% for single_article in GetArticleData %}
    * {{ single_article.title }}
    {% endfor %}

Lưu ý

Nếu một thao tác Lấy dữ liệu được sử dụng nhiều lần trong một dòng công việc, thì 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. Tên này không thể tùy chỉnh.

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 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ừ một ứng dụng để bắt đầu dòng công việc, không có dữ liệu nào được đưa vào tự động.

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, xem truy vấn Articles.