查看 Application Integration 支援的連接器。

針對每個迴圈工作

針對每個迴圈工作可讓您從目前 (主要) 整合作業中重複呼叫子整合作業。此工作會對已設定的陣列變數進行迴迭，並針對陣列中的每個元素呼叫子整合作業。子整合作業的呼叫次數等於陣列變數的大小。

「API 觸發條件 ID」和「整合名稱」會標示要執行的子整合項目。

這項工作也會讓您收集每個子整合項目執行作業的回應，並將值儲存在目前的整合項目中，以便在下游工作中使用。您可以使用下列任一方法收集回覆：

  • 在陣列變數中彙整每次執行作業的回應，其中陣列的每個元素都包含特定執行作業的回應。如要彙整回應，請設定 Collect values from sub-integration output(s) 屬性。
  • 將所有執行作業的回應匯總至單一變數。如要匯總回應，請設定 Response parameter override mapping 屬性。

事前準備

設定屬性

下表說明「For Each 迴圈」工作項的設定屬性。

資源 資料類型 說明
API Trigger ID 字串 要執行的子整合項目的觸發 ID。

這個值可在子整合項目中的「API 觸發條件」「觸發 ID」欄位中找到。
Integration name 字串 要執行的子整合項目名稱。
List to iterate 布林值、字串、整數、雙倍精度浮點數或 JSON 型別的陣列。 應執行子整合的值清單。子整合作業會依序針對清單中的每個值執行。

您可以設定疊代元素子整合對應屬性，將疊代值傳遞至子整合。在這個屬性中，指定子整合作業中的變數，該變數必須對應到迭代值。
Iteration element sub-integration mapping N/A 子整合作業中的變數，必須為目前的疊代元素指派。
Map to additional sub-integration input(s) N/A 從目前整合項目傳遞至子整合項目的其他值。

這個屬性的值採用鍵/值組合的格式，其中鍵是目前整合中的變數，而值則是子整合中的對應輸入變數。舉例來說，假設您的主整合有 productID 變數，而您想將該變數對應至 subIntProductID 子整合變數，您可以從「Integration variable to map from」下拉式選單中選取 productID，然後在「Subintegration input to map to」下拉式選單中選取 subIntProductID。
Collect values from sub-integration output(s) N/A 彙整子整合作業的結果。

每次執行子整合作業時，您都可以將子整合作業的輸出內容儲存在目前整合作業的陣列變數中。從「要收集的子整合作業輸出內容」下拉式選單中選取子整合作業的輸出變數，以及從「要收集的整合作業變數」下拉式選單中選取目前整合作業中的陣列變數。陣列的每個元素都包含特定子整合執行作業的回應。舉例來說，如果陣列變數為 resultsArray，resultsArray[0] 會包含第一次執行的回應，resultsArray[1] 則會包含第二次執行的回應。
Response parameter override mapping N/A 讀取子整合作業執行作業的輸出變數，並將其儲存在目前整合作業的變數中。

從「要對應的子整合項輸出」下拉式選單中選取子整合項的輸出變數，然後從「要覆寫的整合項變數」下拉式選單中選取目前整合作業中的對應變數。您可以將目前整合作業中覆寫的變數傳送至下一個子整合作業，方法是將 Map 中的變數對應至其他子整合作業輸入屬性。因此，您可以累積匯總子整合作業的回應。
Loop metadata JSON 陣列 輸出變數，其中包含子整合作業的執行詳細資料，例如子整合作業執行 ID、錯誤訊息和執行期間傳遞的變數值。迴圈中繼資料包含變數，包括下列輸出變數：current_iteration_count、sub_integration_execution_ids、failure_location、current_element、iteration_element 和 failure_message。

最佳做法

如要瞭解適用於 For Each Loop 工作的工作限制，請參閱「 使用限制」一文。

錯誤處理策略

工作錯誤處理策略會指定在工作因暫時性錯誤而失敗時，應採取的動作。如要瞭解如何使用錯誤處理策略，以及各種錯誤處理策略，請參閱「錯誤處理策略」。

配額與限制

如要進一步瞭解配額和限制，請參閱「配額與限制」。

後續步驟