在 Shopify Flow 中使用具備引數的 API 欄位建立變數
某些變數需要額外參數才能在 Shopify Flow 工作流程中正常運作。這些參數稱為引數，您必須為其宣告值，變數才算完整且可用於工作流程。
例如，product.inCollection 欄位會判斷商品是否位於指定的商品系列中，並回傳布林值 true 或 false 結果。然而，此欄位必須包含商品系列的 id 引數，否則變數將無法知道要檢查哪個特定商品系列。若要正確使用該欄位，您必須將引數包含在欄位中。例如查詢 product.inCollection(id: "gid://shopify/Collection/123456")，讓 Flow 能夠判斷商品是否位於 ID 為 123456 的商品系列中，並如期回傳 true 或 false。在 Shopify Flow 中建立變數時，您無須搜尋商品或商品系列 ID 等值。Flow 提供了資源選擇器，讓您選取所需的值，系統即會自動填入 ID。
為了簡化查詢具備引數的欄位體驗，您可以在 Shopify Flow 中為透過欄位與引數建立的變數指派新變數名稱。例如，如果 ID 為 123456 的商品系列名稱為 Summer Bestsellers，您就可以為 inCollection(id: "gid://shopify/Collection/123456") 變數指派一個較簡單的名稱：inSummerBestsellers。接著在後續的所有工作流程步驟中，您只要使用 product.inSummerBestsellers 變數即可。
由於引數會根據指派的值而有所不同，因此您可以從需要引數的單一欄位建立多個新變數。例如，您光是從 product.inCollection 欄位就能建立 3 個不重複的變數：
product.inCollection(id: "gid://shopify/Collection/123456")可以是product.inSummerBestsellers。product.inCollection(id: "gid://shopify/Collection/654321")可以是product.inSwimwear。product.inCollection(id: "gid://shopify/Collection/112233")可以是product.inBeachAccessories。
Shopify Flow 支援的 GraphQL Admin API 欄位
Shopify Flow 支援下列需要引數的 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 個
translations類型的欄位，例如 collection.translations 和 product.translations
Shopify Flow 不支援的 GraphQL Admin API 欄位
Shopify Flow 不支援下列欄位：
- deliveryCarrierService.availableServicesForCountries
- inventoryLevel.quantities
- return.suggestedFinancialOutcome
- return.suggestedRefund
- shop.search
若要在工作流程中使用這些不支援欄位的資料，您必須使用傳送 HTTP 要求動作。
從具備引數的欄位建立變數
您可以在 Shopify Flow 中為任何需要引數且受支援的欄位建立變數。您只需在單一工作流程中建立該變數一次，因為該變數會保留為工作流程所有後續步驟中的選項。
您建立的變數不會與任何其他工作流程共用，因此若要在另一個工作流程中使用此變數，您必須在該工作流程中再次新增。
步驟：
- 在 Shopify Flow 工作流程中，點擊動作或條件中的 新增變數。
- 選取需要引數的欄位。這些欄位會顯示
+按鈕。接著點擊 + 建立變數。 - 在「 建立變數 」對話方塊中，執行下列步驟：
- 根據您選取的欄位，為必要引數設定值。
- 選用：在 新變數名稱 欄位中，自訂新變數的名稱。此名稱僅適用於目前的工作流程。
- 點擊 新增 即可重新整理變數選取面板。
將新變數新增至工作流程後，該變數仍會以欄位選項的形式提供使用，您可以在後續步驟中快速參照。選擇 新增變數 時，系統會在欄位清單的原欄位選項下方以巢狀方式顯示該變數。
在 Shopify Flow 中從中繼欄位建立變數
中繼欄位是具備必填引數欄位的變數。在 Shopify Flow 工作流程中擷取中繼欄位資料，與擷取其他變數中的標準欄位資料略有不同，因為中繼欄位的 namespace 與 key 欄位值是由您建立並定義的，因此在您的商店中永遠是獨一無二的。
舉例來說，無論您在哪家商店作業，product.inCollection 欄位都必須輸入 id 引數。但是，因為您會在建立商店中每個中繼欄位時設定命名空間與鍵，所以所需引數皆為自訂。因此，擷取夏季服飾商品保養指示的中繼欄位變數可能是 product.careGuideSummer.value，而記錄適用商品年齡層 ID 的商品中繼欄位變數則可能是 product.ageGroup.value_item.taxonomyReference.id。欄位名稱和引數完全由您決定。
深入瞭解 Shopify Flow 中的中繼欄位。