Lấy dữ liệu địa điểm công ty

Trong dòng công việc sử dụng dữ liệu địa điểm công ty, bạn có thể dùng thao tác Lấy dữ liệu địa điểm công ty để lấy thông tin địa điểm công ty từ cửa hàng.

Cấu hình

Trường

Thao tác Lấy dữ liệu địa điểm công ty chứa các trường sau để xây dựng truy vấn:

Chuỗi truy vấn

Đây là truy vấn mẫu để lấy các địa điểm công ty đã cập nhật trong ngày qua:

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

Biến updated_at là một bộ lọc có trong truy vấn Địa điểm công ty 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 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 từ một ngày.

Khi truy vấn dữ liệu, bạn nên biết:

• Danh sách các bộ lọc địa điểm công ty có sẵn
• Truy vấn phải tuân theo một cú pháp nhất định
• Giá trị trường truy vấn không phải lúc nào cũng có 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 API. Ngoài ra, bạn thường có thể tìm thấy các giá trị trường trong URL trong 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 kiểm tra truy vấn trong cửa hàng của mình bằng ứng dụng Shopify GraphiQL.
• Hãy lưu ý những gì sẽ xảy ra nếu truy vấn bị lỗi. 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ả các thao tác Lấy dữ liệu đều trả về danh sách chứa 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 Cho mỗi.
• Nếu cần tổng hợp dữ liệu, chẳng hạn như đếm số 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ể 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 địa điểm công ty (một danh sách các địa điểm công ty). 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 địa điểm trong thao tác Gửi email nội bộ như sau:

{% for single_company in GetCompanyLocationData %}
* {{ single_company.name }}
{% 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 một thời gian do bạn chỉ định, thay vì là kết quả của một sự kiện. Vì không có sự kiện cụ thể nào trong cửa hàng hoặc từ một ứng dụng làm bắt đầu dòng công việc, nên không có dữ liệu nào tự động được đưa vào.

Tài liệu tham khảo API

• Tài nguyên địa điểm công ty
• Bộ lọc truy vấn địa điểm công ty