プロジェクトの内外での子統合の起動

機能

プロジェクト内の親統合は、次の場所にある子統合を起動するように構成できます:
- 同じプロジェクト内。
- 別のプロジェクトで、その統合がパブリックに設定されている場合。「プロジェクト統合をパブリックとして設定」を参照してください。
- グローバルに使用可能(つまり、統合はどのプロジェクトにも含まれません)。
実行時には、すべての統合のロケーションに関係なく、すべての統合動作が単一のアクティビティ・ストリームに統合されて表示されます。
たとえば、次の親子呼出しがサポートされています:
- Project Aの親統合1は、グローバルに使用可能な子統合6を起動します(統合はどのプロジェクトにもありません)。次に、子統合6によって子統合7が起動されます。子統合7もグローバルに使用可能です。
- Project Aの親統合2は、プロジェクトBの子統合3を起動します。
- グローバルに使用可能な親統合5では、このタイプの起動は許可されていないため、Project Aで統合1を起動できません。
プロジェクト内の親統合は、ロケーションに関係なく、実行時に2つの子統合のいずれかを動的に起動できます。たとえば、子統合の両方をグローバルに使用可能にしたり、一方の子統合をグローバルに使用可能にしたり、もう一方の子統合を別のプロジェクトに含めることができます。「子統合の動的な起動」を参照してください。

制限事項

REST、SOAPおよびスケジュール統合エンドポイントのみがサポートされます。
統合アダプタ・ウィザードで子統合を選択した場合に使用できるのは、アクティブ化された統合のみです。「親統合からの子統合の起動」を参照してください。
グローバルに使用可能な親統合(プロジェクト外)では、プロジェクト内の子統合を起動できません。グローバルに使用可能な親統合は、グローバルに使用可能な子統合のみを起動できます。
プロジェクト・デプロイメントをアクティブ化または非アクティブ化することを選択した場合は、そのプロジェクト以外のすべての子統合(別のプロジェクト内またはグローバルに使用可能かどうか)をそれぞれアクティブ化または非アクティブ化する必要があります。プロジェクト・デプロイメントでは、そのプロジェクト外の統合をアクティブ化または非アクティブ化できません。「プロジェクト・デプロイメントの作成と管理」を参照してください。
プロジェクト・デプロイメントをエクスポートする場合、そのプロジェクトの外部からの統合はいずれもエクスポートされたファイルに含められません。これらの統合は個別にエクスポートし、参照元のプロジェクトとともにターゲット・インスタンスにインポートする必要があります。
別のプロジェクトの統合への参照では、それ自体に外部参照がある統合を指定できます。一連の参照は、複数のプロジェクトにまたがることができます。

プロジェクト統合をパブリックとして設定

プロジェクト統合をパブリックに設定すると、その統合を別のプロジェクトの親統合によって起動できます。プロジェクト統合をパブリックとして設定しない場合、同じプロジェクトの親統合によってのみ起動できます。

プロジェクト統合をパブリックとして設定するには、次の2つの方法があります:

新しい統合の作成:

「統合」セクションで、統合が現在存在しない場合は「追加」をクリックし、統合がすでに存在する場合は+をクリックします。
作成する統合のタイプ(アプリケーションまたはスケジュール)を選択します。
「他のプロジェクトで使用可能」チェックボックスを選択します。

既存の統合を更新します:

統合の統合キャンバスに移動してパブリックにします。
「プライマリ情報」をクリックします。
「他のプロジェクトで使用可能」チェックボックスを選択します。

選択した場合、「他のプロジェクトで使用可能」チェック・ボックスを使用すると、「統合」アクションを統合キャンバスにドラッグしたときに起動される統合アダプタ・ウィザードで、別のプロジェクト内の統合を選択して表示できます。「親統合からの子統合の起動」を参照してください。

プロジェクトへのインポート後に親統合から子統合を動的に起動するための前提条件

プロジェクトの親統合から子統合を動的に起動するには、プロジェクトID、統合コードおよび統合バージョンが必要です。これは、グローバルに使用可能な統合(どのプロジェクトにも含まれない統合)とは異なります。この統合では、統合コードと統合バージョンのみを持つ親統合から子統合を動的に呼び出すことができます。

グローバルに使用可能な親統合とその子統合をプロジェクトにインポートし、親統合から2番目の子統合を動的にコールしようとした場合、子統合はプロジェクトからコールされません。かわりに、グローバルに使用可能な子統合がコールされます。これは、統合コードおよび統合バージョンのみがマッパーで構成でき、プロジェクト・コードは構成できないために発生します。

プロジェクトで2番目の統合を動的に起動するには、マッパーでプロジェクト・コード問合せパラメータを作成してマップする必要があります。

次のステップを実行すると仮定します。

2つの子統合を起動するように親統合を構成します。 3つの統合はすべてグローバルに利用可能であり、特定のプロジェクトの一部ではないことを意味します。
3つの統合をエクスポートし、プロジェクトにインポートします。
インポートされた親統合のマッパーを編集します。
構成するターゲット「プロジェクト・コード」ノードの値は、「ローカル統合」の下にはありません。

ソリューション: 次のステップを実行します:

統合キャンバスで、統合処理を編集する場合に選択します。
統合アダプタ・ウィザードのページで、変更を行わずに「続行」をクリックし、最後のページで「完了」をクリックします。このアクションは、マッパーにプロジェクト・コード・エントリを作成します。
マッパーを開き、「ローカル統合」の下のプロジェクトのターゲット「プロジェクト・コード」ノードが表示されるようになったことを確認します。

ここで、ターゲット問合せパラメータを作成し、それを「プロジェクト・コード」にマップする必要があります。
マッパーを終了します。
アダプタ・エンドポイント構成ウィザードで、編集のために「RESTアダプタ」トリガー接続を開きます。
「リクエスト・パラメータ」ページで、新しい問合せパラメータを作成します。この例では、ProjectCodeが作成されます。
ウィザードの残りのページをクリックし、「完了」をクリックします。
マッパーに戻ります。
新しいソース問合せパラメータが表示されるようになりました。
ソースの「プロジェクト・コード」問合せパラメータをターゲットの「プロジェクト・コード」にドラッグします。

「構成および実行」ページから後で親統合を実行すると、統合バージョン、統合コードおよびプロジェクト・コード・パラメータを使用できます。
「実行」をクリックします。プロジェクトの子統合が、グローバルに使用可能なバージョンではなく起動されるようになりました。

子統合の動的起動に関する情報が提供されます。「子統合の動的な起動」を参照してください。