查看 Application Integration 支援的連接器。
while 迴圈工作
While 迴圈工作可讓您從目前 (主要) 整合中重複呼叫子整合，直到符合指定條件為止。
「API 觸發條件 ID」和「整合名稱」會標示要執行的子整合項目。
這項工作也會讓您收集每個子整合項目執行作業的回應，並將值儲存在目前的整合項目中，以便在下游工作中使用。您可以使用下列任一方法收集回覆：
- 在陣列變數中彙整每次執行作業的回應，其中陣列的每個元素都包含特定執行作業的回應。如要彙整回應，請設定
Collect values from sub-integration output(s)屬性。 - 將所有執行作業的回應匯總至單一變數。如要匯總回應，請設定
Override values from sub-integration output(s)屬性。
事前準備
- 請確認您已將使用者代管的服務帳戶連結至整合項目。如果整合作業未設定使用者自管服務帳戶，系統會預設使用預設服務帳戶 (
service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com) 進行驗證。 - 請確認服務帳戶具備 Application Integration 叫用者 IAM 角色。如要瞭解如何將角色授予服務帳戶，請參閱「管理服務帳戶的存取權」。
設定屬性
下表說明 While Loop 工作項的設定屬性。
| 資源 | 資料類型 | 說明 |
API Trigger ID
|
字串 | 要執行的子整合項目的觸發 ID。 這個值可在子整合項目中的「API 觸發條件」「觸發 ID」欄位中找到。 |
Integration name |
字串 | 要執行的子整合項目名稱。 |
While loop condition
|
不適用 | 終止迴圈的條件。子整合作業會執行，直到符合條件為止。例如 $loopMetadata.current_iteration_count$< 10。 |
Map to sub-integration input(s)
|
N/A | 從目前整合項目傳遞至子整合項目的值。
這個屬性的值採用鍵/值組合的格式，其中鍵是目前整合中的變數，而值則是子整合中的對應輸入變數。舉例來說，假設主要整合有 |
Collect values from sub-integration output(s)
|
N/A | 彙整子整合作業的結果。
每次執行子整合作業時，您都可以將子整合作業的輸出內容儲存在目前整合作業的陣列變數中。在「要收集的子整合作業輸出內容」欄位中輸入子整合作業的輸出變數，然後從「要收集至的整合作業變數」下拉式選單中選取目前整合作業中的陣列變數。陣列的每個元素都包含特定子整合執行作業的回應。舉例來說，如果陣列變數為 |
Override values from sub-integration output(s)
|
N/A | 讀取子整合作業執行作業的輸出變數，並將其儲存在目前整合作業的變數中。 從「要對應的子整合項輸出」下拉式選單中選取子整合項的輸出變數，然後從「要覆寫的整合項變數」下拉式選單中選取目前整合作業中的對應變數。您可以將目前整合作業中覆寫的變數傳送至下一個子整合作業，方法是將 Map 中的變數對應至其他子整合作業輸入屬性。因此，您可以累積匯總子整合作業的回應。 |
Loop metadata |
JSON 陣列 | 輸出變數，其中包含子整合作業執行作業的執行詳細資料，例如子整合作業執行 ID、錯誤訊息和執行期間傳遞的變數值。迴圈中繼資料包含變數，包括下列輸出變數：current_iteration_count、sub_integration_execution_ids、failure_location、current_element、iteration_element 和 failure_message。
|
最佳做法
如要瞭解適用於 While 迴圈工作項的用量限制，請參閱「 用量限制」一文。
錯誤處理策略
工作錯誤處理策略會指定在工作因暫時性錯誤而失敗時，應採取的動作。如要瞭解如何使用錯誤處理策略，以及各種錯誤處理策略，請參閱「錯誤處理策略」。
配額與限制
如要進一步瞭解配額和限制，請參閱「配額與限制」。