Application Integration でサポートされているコネクタをご覧ください。

while ループタスク

一方、While ループタスクでは、指定した条件が満たされるまで、現在（メイン）の統合からサブ統合を繰り返し呼び出すことができます。

API トリガー ID と統合名は、実行するサブ統合を特定します。

このタスクでは、各サブ統合の実行からレスポンスを収集し、その値をダウンストリームタスクで使用するために現在の統合に保存することもできます。次のいずれかの方法でレスポンスを収集できます。

配列変数で各実行のレスポンスを照合し、配列の各要素は 1 つの特定の実行からのレスポンスを受け取ります。レスポンスを照合するには、Collect values from sub-integration output(s) プロパティを構成します。
すべての実行のレスポンスを 1 つの変数に集計します。レスポンスを集計するには、Override values from sub-integration output(s) プロパティを構成します。

準備

統合にユーザー管理のサービスアカウントが関連付けられていることを確認します。統合にユーザー管理のサービスアカウントが構成されていない場合は、デフォルトで、デフォルトのサービスアカウント（service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com）が認証に使用されます。
サービスアカウントに Application Integration の起動元 IAM ロールが付与されていることを確認します。サービスアカウントへのロールの付与については、サービスアカウントに対するアクセス権の管理をご覧ください。

構成プロパティ

次の表に、While Loop タスクの構成プロパティを示します。

プロパティ	データ型	説明
`API Trigger ID`	String（文字列）	実行するサブ統合のトリガー ID。この値は、サブ統合の API トリガーの [Trigger ID] フィールドで利用できます。
`Integration name`	String（文字列）	実行するサブ統合の名前。
`While loop condition`	なし	ループを終了する条件。サブ統合は、条件が満たされるまで実行されます。例: `$loopMetadata.current_iteration_count$< 10`。
`Map to sub-integration input(s)`	なし	現在の統合からサブ統合に渡す値。このプロパティの値は Key-Value ペアの形式です。キーは現在の統合の変数で、値はサブ統合で対応する入力変数です。たとえば、メイン統合に `subIntProductID` サブ統合変数にマッピングしたい `productID` 変数がある場合、[Integration variable to map from] プルダウンから `productID` を選択し、[Subintegration input to map to] 項目に `subIntProductID` を入力します。
`Collect values from sub-integration output(s)`	なし	サブ統合の実行結果を照合します。サブ統合が実行されるたびに、現在の統合の配列変数にサブ統合の出力を格納できます。[Sub-Integration output to collect from] フィールドにサブ統合の出力変数を入力し、[Integration variable to collect into] プルダウンから現在の統合の配列変数を選択します。配列の各要素には、特定のサブ統合実行のレスポンスが含まれます。たとえば、配列変数が `resultsArray` の場合、`resultsArray[0]` は 1 回目の実行からのレスポンスが含まれ、`resultsArray[1]` は 2 回目の実行からのレスポンスが含まれます。
`Override values from sub-integration output(s)`	なし	サブ統合実行の出力変数を読み取り、現在の統合の変数に保存します。 [Sub-integration output to map from] プルダウンからサブ統合の出力変数を選択し、[Integration function to override] プルダウンから現在の統合で対応する変数を選択します。[Map to additional sub-integration input(s)] プロパティ内の変数をマッピングすることで、現在の統合でオーバーライドされた変数を次のサブ統合に送信できます。その結果、サブ統合の実行からのレスポンスを累積的に集計できます。
`Loop metadata`	JSON 配列	そのサブ統合の実行の詳細を含む出力変数（サブ統合実行 ID、エラーメッセージ、実行中に渡された変数値など）。ループのメタデータには、`current_iteration_count`、`sub_integration_execution_ids`、`failure_location`、`current_element`、`iteration_element`、`failure_message` などの出力変数が含まれます。警告: ループメタデータで、出力変数の重複するキー（`Current Iteration Count` や `current_iteration_count` など）が見つかります。他のキーは非推奨になっているため、アンダースコア記号（`_`）を含む変数を使用することをおすすめします。

ベストプラクティス

While Loop タスクに適用される使用量上限については、使用量上限をご覧ください。

エラー処理方法

タスクのエラー処理方法では、一時的なエラーによってタスクが失敗した場合のアクションを指定します。エラー処理方式と、さまざまな種類のエラー処理方式の詳細については、エラー処理方法をご覧ください。

割り当てと上限

割り当てと上限については、割り当てと上限をご覧ください。

次のステップ

すべてのタスクとトリガーを確認する。
インテグレーションをテストして公開する方法について学習する。

エラー処理について学習する。
統合の実行ログについて学習する。