Lấy dữ liệu công ty
Trong các dòng công việc sử dụng dữ liệu công ty, bạn có thể dùng hành động Lấy dữ liệu công ty để lấy thông tin công ty từ cửa hàng.
Cấu hình
Trường
Hành động Lấy dữ liệu công ty có chứa các trường sau đây, dùng để xây dựng truy vấn:
| 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ố lượng kết quả tối đa | Bắt buộc. Số lượng kết quả tối đa mà truy vấn tìm kiếm bạn chọn có thể trả về. Bạn có thể nhận tối đa 100 kết quả một lần. |
| Truy vấn | Bắt buộc. Chọn từ các truy vấn phổ biến hoặc chọn Nâng cao để tự tạo. |
Chuỗi truy vấn
Đây là ví dụ về truy vấn để lấy các công ty được cập nhật trong ngày qua:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Biến updated_at là bộ lọc trong Truy vấn 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 khả dụng trên các dòng công việc đã dùng yếu tố kích hoạt Thời gian đã lên lịch. Thẻ Liquid date_minus là thẻ Flow đặc biệt cho phép bạn trừ đi 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 công ty khả dụng
- 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ó 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 công ty (một danh sách các 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 công ty trong thao tác Gửi email nội bộ như sau:
{% for single_company in GetCompanyData %}
* {{ 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 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 thêm vào.