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

統合の呼び出しタスク

統合の呼び出しタスクを使用すると、Google Cloud プロジェクト内で作成された他の統合を呼び出すことができます。

統合の呼び出しタスクは、メインの統合（親統合）を使用して制御される複数の小規模な統合（サブ統合）を定義する必要がある場合に便利です。サブ統合を実行した後、メイン統合でサブ統合のレスポンスを読み取ることもできます。

準備

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

統合の呼び出しタスクを設定する

統合の呼び出しタスクを構成するには:

Google Cloud コンソールで [Application Integration] ページに移動します。
Application Integration に移動
ナビゲーションメニューで [統合] をクリックします。
[統合] ページが開き、Google Cloud プロジェクトで使用可能なすべての統合が一覧表示されます。
既存の統合を選択するか、[統合の作成] をクリックして新しい統合を作成します。
新しい統合を作成する場合:
1. [統合の作成] ペインで名前と説明を入力します。
2. 統合のリージョンを選択します。
  注: [リージョン] プルダウンには、Google Cloud プロジェクトにプロビジョニングされたリージョンのみが表示されます。新しいリージョンをプロビジョニングするには、[リージョンを有効にする] をクリックします。詳細については、新しいリージョンを有効にするをご覧ください。
3. 統合用のサービスアカウントを選択します。統合のサービスアカウントの詳細は、統合ツールバーの [統合の概要] ペインでいつでも変更または更新できます。
  注: サービスアカウントを選択するオプションは、選択したリージョンで統合ガバナンスを有効にしている場合にのみ表示されます。
4. [作成] をクリックします。
統合エディタで統合が開きます。
統合エディタのナビゲーションバーで、[タスク] をクリックして、使用可能なタスクとコネクタのリストを表示します。
統合エディタで、[Call Integration] 要素をクリックして配置します。
デザイナーで [Call Integration] タスク要素をクリックして、[Call Integration] タスク構成ペインを表示します。
以下のサブ統合の詳細を構成します。
1. API トリガー ID: 呼び出す統合の API トリガー ID を入力します。1 つの統合を呼び出すことも、同じトリガー ID で複数の統合を呼び出すこともできます。
2. この API トリガー ID を持つすべて統合を実行する: このオプションを選択すると、同じ API トリガー ID を持つすべての統合を呼び出します。
  たとえば、統合 A と統合 B が同じ API トリガー ID を持つ場合、統合 A と統合 B の両方が実行されます。
  
  注: このオプションを選択すると、サブ統合のレスポンスはメイン統合で使用できなくなります。サブ統合のレスポンスにアクセスする場合は、[単一の統合を実行する] オプションを選択します。
3. Run a single integration: [Integration name] フィールドで指定された統合のみを呼び出すには、このオプションを選択します。サブ統合レスポンス変数のマッピングで説明されているフィールドを構成することで、サブ統合からレスポンスにアクセスしてマッピングできます。
4. 実行戦略: 呼び出すサブ統合の実行モードを選択します。
  - SYNC: サブ統合を同期モードで実行します。このモードでは、メイン統合はサブ統合が完了するのを待ってから、ダウンストリームタスクを続行します。
  - ASYNC: 非同期モードでサブ統合を実行します。このモードでは、メイン統合はサブ統合の完了を待ちません。サブ統合を呼び出した直後に、メインの統合によってダウンストリームのタスクが実行されます。
    
    このオプションを選択した場合は、[Execution delay (in milliseconds)] を設定します。設定した場合、統合が実行されるまでの遅延時間を指定します。
  プロパティへの変更は自動的に保存されます。

サブ統合レスポンス変数をマッピングする

次の表に、メイン統合とサブ統合の間で変数をマッピングする構成プロパティを示します。

プロパティ 説明

プロパティ	説明
`Map to sub-integration input(s)`	メイン統合からサブ統合に値をマッピングします。このフィールドでは、Key-Value ペアの形式の値を指定します。ここで、キーはメイン統合の変数で、値はサブ統合の対応する入力変数です。たとえば、メイン統合の `productID` 変数を `subIntProductID` サブ統合変数にマッピングする場合は、[Integration variable to map from] フィールドから `productID` を選択し、[Subintegration input to map to] フィールドに「`subIntProductID`」と入力します。
`Map values to sub-integration output(s)`	サブ統合出力変数をメイン統合変数にマッピングします。 [マッピング元のサブ統合の出力] をクリックして、サブ統合を選択します。[Integration variable to map to] をクリックし、対応するメインの統合変数を選択します。注: このフィールドは、SYNC実行戦略で [単一統合を実行] オプションが選択された場合にのみ表示されます。

Map to sub-integration input(s)

メイン統合からサブ統合に値をマッピングします。このフィールドでは、Key-Value ペアの形式の値を指定します。ここで、キーはメイン統合の変数で、値はサブ統合の対応する入力変数です。

たとえば、メイン統合の productID 変数を subIntProductID サブ統合変数にマッピングする場合は、[Integration variable to map from] フィールドから productID を選択し、[Subintegration input to map to] フィールドに「subIntProductID」と入力します。

Map values to sub-integration output(s)

サブ統合出力変数をメイン統合変数にマッピングします。

[マッピング元のサブ統合の出力] をクリックして、サブ統合を選択します。[Integration variable to map to] をクリックし、対応するメインの統合変数を選択します。

ベストプラクティス

統合の呼び出しタスクに適用される使用量上限については、使用量上限をご覧ください。

エラー処理方法

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