Lấy mục nhập siêu đối tượng

Bạn có thể sử dụng thao tác Lấy mục nhập siêu đối tượng để truy xuất danh sách mục nhập cho một siêu đối tượng từ cửa hàng dựa trên truy vấn tùy chọn. Xem tài liệu về siêu đối tượng để biết thêm thông tin.

Cấu hình

Trường

Thao tác Lấy mục nhập siêu đối tượng chứa một menu thả xuống để chỉ định định nghĩa siêu đối tượng cũng như các trường sau đây dùng để tạo truy vấn:

Chuỗi truy vấn

Đây là truy vấn ví dụ để lấy mục nhập siêu đối tượng nếu giá trị trường email khớp với địa chỉ email trong đơn hàng:

{{fields.email}}:"{{order.email}}"

Đây là truy vấn ví dụ để lấy các mục nhập siêu đối tượng đã cập nhật trong ngày hôm qua:

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

Biến updated_at là một bộ lọc trong Truy vấn siêu đối tượng và có thể sử 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ó trong 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ừ thời gian khỏi một ngày.

Khi truy vấn dữ liệu, cần lưu ý:

• Danh sách các bộ lọc siêu đối tượng hiện có
• Việc truy vấn siêu đối tượng theo giá trị trường yêu cầu siêu đối tượng phải được bật tính năng lọc, có thể kích hoạt trong tùy chọn dữ liệu tùy chỉnh của bảng điều khiển quản trị Shopify.
• Truy vấn phải tuân theo một cú pháp nhất định
• Không phải lúc nào cũng có tài liệu về giá trị trường truy vấn. Trong một số trường hợp, bạn có thể tìm thấy các giá trị này khi xem tài liệu API. Hoặc bạn thường có thể tìm thấy giá trị trường trong URL ở 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ị, rồi 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.
• Hãy lưu ý đến điều 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ả thao tác Lấy dữ liệu đều trả về một danh sách gồm 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 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, chẳng hạn như đếm số lượng kết quả 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 chứa tất cả các mục, bạn có thể trực tiếp sử dụng dữ liệu trả về trong những thao tác tiếp theo.

Để truy cập dữ liệu trả về ở các bước nối tiếp thao tác này, hãy sử dụng biến có tên Lấy mục nhập siêu đối tượng. Đây là danh sách các mục nhập siêu đối tượng. 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 cặp khóa-giá trị cho mục nhập siêu đối tượng trong thao tác Gửi email nội bộ như sau:

{% for getMetaobjectEntries_item in getMetaobjectEntries %}
Key-value pairs for entry:
  {% for fields_item in getMetaobjectEntries_item.system.fields %}
    {{fields_item.key}}:{{fields_item.value}}
  {% endfor %}
{% 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 sẽ 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 không có dữ liệu nào được tự động đưa vào.

Chi tiết API

• Tài nguyên siêu đối tượng
• Bộ lọc truy vấn siêu đối tượng
• Truy vấn siêu đối tượng theo giá trị trường