Sử dụng trường API có đối số trong Shopify Flow để tạo biến

Một số biến yêu cầu có thêm tham số để hoạt động chính xác trong dòng công việc Shopify Flow. Các tham số này là đối số mà bạn phải khai báo giá trị trước khi biến được coi là hoàn chỉnh và có thể dùng cho dòng công việc.

Ví dụ: trường product.inCollection sẽ xác định xem sản phẩm có nằm trong một bộ sưu tập được chỉ định hay không và trả về kết quả Boolean là true hoặc false. Tuy nhiên, phải có đối số id của bộ sưu tập cho trường này vì nếu không, biến sẽ không biết phải kiểm tra bộ sưu tập cụ thể nào. Để sử dụng trường này một cách chính xác, bạn phải đưa đối số vào làm một phần của trường. Ví dụ: khi truy vấn product.inCollection(id: "gid://shopify/Collection/123456"), Flow có thể xác định xem sản phẩm có nằm trong bộ sưu tập có ID là 123456 hay không, sau đó trả về kết quả true hoặc false như dự kiến. Khi tạo biến trong Shopify Flow, bạn không cần tìm kiếm các giá trị như ID bộ sưu tập hay sản phẩm. Flow cung cấp một công cụ chọn tài nguyên để bạn chọn giá trị mong muốn, đồng thời hệ thống sẽ tự động điền ID.

Để đơn giản hóa trải nghiệm truy vấn các trường có đối số, bạn có thể chỉ định tên biến mới cho biến bạn vừa tạo từ trường và đối số trong Shopify Flow. Ví dụ: nếu bộ sưu tập có ID là 123456 tên là Summer Bestsellers, bạn có thể chỉ định cho biến inCollection(id: "gid://shopify/Collection/123456") một tên đơn giản hơn là inSummerBestsellers. Khi đó, trong mọi bước tiếp theo của dòng công việc, bạn chỉ cần sử dụng biến product.inSummerBestsellers.

Do các đối số khác nhau tùy thuộc vào giá trị được chỉ định nên bạn có thể tạo ra nhiều biến mới từ một trường duy nhất yêu cầu có đối số. Ví dụ: bạn có thể tạo 3 biến khác biệt chỉ từ trường product.inCollection:

• product.inCollection(id: "gid://shopify/Collection/123456") có thể là product.inSummerBestsellers.
• product.inCollection(id: "gid://shopify/Collection/654321") có thể là product.inSwimwear.
• product.inCollection(id: "gid://shopify/Collection/112233") có thể là product.inBeachAccessories.

Các trường GraphQL Admin API được hỗ trợ trong Shopify Flow

Shopify Flow hỗ trợ các trường có đối số bắt buộc sau đây trong GraphQL Admin API:

• channel.hasCollection
• collection.hasProduct
• collection.publishedOnChannel
• collection.publishedOnPublication
• companyLocation.inCatalog
• inventoryItem.inventoryLevel
• location.inventoryLevel
• metaobject.field
• market.assignedCustomization
• marketLocalizableResource.marketLocalizations
• product.inCollection
• product.publishedOnChannel
• product.publishedOnPublication
• product.restrictedForResource
• publication.hasCollection
• publishable.publishedOnChannel
• publishable.publishedOnPublication
• sellingPlanGroup.appliesToProduct
• sellingPlanGroup.appliesToProductVariant
• sellingPlanGroup.appliesToProductVariants
• 20 trường loại translations, chẳng hạn như collection.translations và product.translations

Các trường GraphQL Admin API không được hỗ trợ trong Shopify Flow

Shopify Flow không hỗ trợ các trường sau đây:

• deliveryCarrierService.availableServicesForCountries
• inventoryLevel.quantities
• return.suggestedFinancialOutcome
• return.suggestedRefund
• shop.search

Để sử dụng dữ liệu từ các trường không được hỗ trợ này trong dòng công việc, bạn phải dùng thao tác Gửi yêu cầu HTTP.

Tạo biến từ trường có đối số

Bạn có thể tạo biến trong Shopify Flow cho mọi trường được hỗ trợ có yêu cầu đối số. Bạn chỉ cần tạo biến một lần trong một dòng công việc vì biến đó sẽ luôn ở dạng tùy chọn khả dụng trong mọi bước tiếp theo của dòng công việc.

Biến đã tạo không được chia sẻ với bất kỳ dòng công việc nào khác. Để sử dụng biến đó trong một dòng công việc khác, bạn phải thêm lại biến vào dòng công việc kia.

Các bước:

1. Trong dòng công việc Shopify Flow, nhấp vào Thêm biến ở một thao tác hoặc điều kiện.
2. Chọn trường yêu cầu đối số. Những trường này hiển thị nút +. Sau đó, nhấp vào + Tạo biến.
3. Trong hộp thoại Tạo biến , thực hiện các bước sau:
   1. Dựa trên trường đã chọn, thiết lập giá trị cho đối số bắt buộc.
   2. Tùy chọn: Trong trường Tên biến mới, tùy chỉnh tên muốn đặt cho biến mới. Tên này chỉ áp dụng cho dòng công việc hiện tại.
   3. Nhấp vào Thêm để làm mới bảng chọn biến.

Sau khi thêm biến mới vào dòng công việc, biến vẫn hiển thị dưới dạng tùy chọn trường và có thể nhanh chóng được tham chiếu trong các bước tiếp theo. Khi chọn Thêm biến, biến sẽ hiển thị lồng ghép bên dưới tùy chọn trường ban đầu trong danh sách trường.

Tạo biến từ trường siêu dữ liệu trong Shopify Flow

Trường siêu dữ liệu là một loại biến có trường yêu cầu đối số. Việc lấy dữ liệu trường siêu dữ liệu trong dòng công việc Shopify Flow hơi khác so với thao tác lấy dữ liệu trường tiêu chuẩn ở các biến khác. Lý do là bạn sẽ tạo và định nghĩa giá trị trường namespace và key của trường siêu dữ liệu, nên các giá trị này luôn là duy nhất đối với cửa hàng.

Ví dụ: trường product.inCollection luôn yêu cầu đối số id, bất kể bạn đang làm việc trong cửa hàng nào. Tuy nhiên, do bạn tự thiết lập không gian tên và khóa cho mọi trường siêu dữ liệu tạo trong cửa hàng, nên các đối số bắt buộc đều được tùy chỉnh. Vì vậy, biến đối với trường siêu dữ liệu sản phẩm lưu giữ hướng dẫn bảo quản cho sản phẩm quần áo mùa hè có thể là product.careGuideSummer.value, hoặc biến đối với trường siêu dữ liệu sản phẩm ghi lại ID của nhóm tuổi sử dụng sản phẩm có thể là product.ageGroup.value_item.taxonomyReference.id. Tên trường và đối số do bạn toàn quyền quyết định.

Tìm hiểu thêm về trường siêu dữ liệu trong Shopify Flow.