機械翻訳について

実行時の呼出し接続の動的更新

実行時に使用する呼出し接続を動的に更新できます。 この機能を使用すると、単一の統合を使用して、同じアプリケーションの複数のエンド・システムまたはインスタンスにリクエストを送信でき、単一の統合でスイッチ・アクションで構成された各エンドポイントまたは複数の呼出し接続に対して個別の統合を作成する必要がなくなります。

動的な接続機能

動的接続には、次の機能があります。

  • 接続は、プロジェクトに対してローカルにすることも、プロジェクト間で共有することも、スタンドアロン(プロジェクトのコンテキストではなくグローバルに使用可能)にすることもできます。
  • 各接続は、様々なプロパティおよびセキュリティ・ポリシーを使用して定義できます。 たとえば、FTP公開キー認証セキュリティ・ポリシーを設計時に構成したFTP over SSL呼出し接続は、FTPサーバー・アクセス・ポリシー・セキュリティ・ポリシーで構成されたsFTP接続によって実行時にオーバーライドできます。
  • 接続は、接続性エージェントでオーバーライドできます。 たとえば、設計時に接続性エージェントなしで構成された「FTPアダプタ」呼出し接続は、接続性エージェントで構成された「FTPアダプタ」呼出し接続によって実行時にオーバーライドできます。
  • 使用するランタイム接続は、受信メッセージのペイロードのプロパティによって、またはルックアップ表関数の結果によって定義されます。

    ノート:

    参照表ベースの式は、設計時参照ウィザードでのみサポートされ、実行時にマッパーではサポートされません。
  • 呼出し接続の場合、XPath式を指定することも、オプションでソース・ペイロードに対する参照表関数の結果を指定することもできます。 実際のデータに対して評価されると、その特定の呼出し接続に対して、実行時に使用する接続IDの値が提供されます。
  • 動的に使用される起動接続は、実行時にアクティビティ・ストリームで追跡および監視できます。

動的接続の構成および使用

この例では、2つのプロジェクトにまたがる動的接続を作成および使用する方法について説明します。 動的接続は、単一のプロジェクトまたはスタンドアロン環境(プロジェクトの外部)で作成および使用することもできます。

この例では、2つのプロジェクトが作成されます。


Dyn Conn Project 2およびDyn Conn Project 1プロジェクト名が、タイプおよび最終更新詳細とともに表示されます。

プロジェクト「Dyn Connプロジェクト2」は次のもので構成されます:
  • 統合「dyn connデモftp e2e」。
  • 接続FTP 138キー・ベース共有: このキー・ベースの接続(FTP公開キー認証)は、両方のプロジェクトで共有されます。 この項では、「Dyn Connプロジェクト1」での実行時にこの接続を動的に使用します。
  • 接続FTP 147プロジェクト2: これは、ユーザー名/パスワード・ベースの接続(FTPサーバー・アクセス・ポリシー)です。
  • 接続FTP 138プロジェクト2: これは、ユーザー名/パスワード・ベースの接続(FTPサーバー・アクセス・ポリシー)です。
  • 接続Restトリガー: この接続によって統合がトリガーされます。


Dyn Conn Project 2プロジェクトが表示されます。 上部には、「設計」、「デプロイ」および「監視」ボタンがあります。 中央の右側には2つのアイコンがあります。 右端には5つのアイコンがあります。 「設計」の下には、「統合」、「ヘルスケア」および「B2B」アイコンがあります。 中央には「統合」セクションと「接続」セクションがあります。 このプロジェクト内で作成された統合と接続については、このイメージで説明します。

プロジェクト「Dyn Connプロジェクト1」は次のもので構成されます:
  • 統合「dyn connデモftp」。
  • 接続FTP 138キー・ベース: この接続は、Dyn Connプロジェクト2プロジェクトの共有キー・ベース接続(FTP公開キー認証)を参照します。
  • 接続FTP 147プロジェクト1: これは、ユーザー名/パスワード・ベースの接続(FTPサーバー・アクセス・ポリシー)です。
  • 接続FTP 138プロジェクト1: これは、ユーザー名/パスワード・ベースの接続(FTPサーバー・アクセス・ポリシー)です。
  • 接続Restトリガー: この接続によって統合がトリガーされます。


Dyn Conn Project 1プロジェクトが表示されます。 上部には、「設計」、「デプロイ」および「監視」ボタンがあります。 中央の右側には2つのアイコンがあります。 右端には5つのアイコンがあります。 「設計」の下には、「統合」、「ヘルスケア」および「B2B」アイコンがあります。 中央には「統合」セクションと「接続」セクションがあります。 このプロジェクト内で作成された統合と接続については、このイメージで説明します。

  1. 「Dyn Connプロジェクト2」で、編集のために「dyn connデモftp e2e」統合を開きます。

    「FTP 138プロジェクト2」 「FTPアダプタ」呼出し接続は、設計で使用されています。


    表示される統合には、トリガー、マップ、起動およびマップが含まれます。 起動アクションの上にカーソルが置かれ、タイプ(FTP)、エンドポイント名および接続名(FTP 138 Project 2)が表示されます。

  2. 統合キャンバスで、この呼出し接続を編集のために開きます。
  3. 「基本情報」ページで、「続行」をクリックします。
  4. 「動的接続」ページで、「動的接続の有効化」を選択して、実行時に使用する動的接続IDを指定します。

    「動的接続ID」フィールドが表示されます。

  5. 「開発者ビューに切替え」 ビューのスイッチアイコンをクリックします。
  6. 動的接続IDは、2つの方法のいずれかで指定します。
    • 入力ソース: dynamic-connection-id問合せパラメータを使用して、接続IDをXPath式として渡す場合にクリックします。 XPath式は、実行時に使用される動的呼出し接続の接続IDに評価されます。
    • 関数: 参照表関数を使用して、異なるリージョンを表す異なる接続IDを渡す場合にクリックします。

    この例では、dynamic-connection-id XPath式がフィールドにドラッグされます。


    統合は左側に表示されます。 呼出し接続は編集用に選択されています。 「動的接続の編集」ページが表示されます。 入力ソース・タブと関数タブが表示されます。 「入力ソース」ツリーが展開され、dynamic-connection-idが表示されます。 右側には、「動的接続の有効化」チェック・ボックスが選択されています。 この下には、動的接続IDのXPath式が移入された「動的接続ID」フィールドがあります。 このフィールドの右側に2つのアイコンが表示されます。

  7. 更新を保存します。

    統合を実行する時期です。

  8. 「Dyn Connプロジェクト1」プロジェクトに移動します。
  9. 「dyn connデモftp」統合にマウス・ポインタを重ねて実行します。
  10. 「アクション」 「アクション」アイコンメニューから、「実行」を選択します。
  11. 「本文」タブで、使用するペイロード・ファイル(この例では、sample.jsonという名前)をアップロードします。
  12. 「URIパラメータ」タブで、次を指定します:
    • file-name: ペイロードのファイル名。
    • directory: ファイルを書き込むターゲット・ディレクトリ。
    • dynamic-connection-id: FTPアダプタは、実行時に動的に使用する接続を呼び出します。 文字の入力を開始して、選択可能な呼出し接続の表示をフィルタします。 この例では、「FTP 138キー・ベース」が選択されています。 これは、ステップ7で動的XPath式を定義した共有呼出し接続です。 このフィールドを空白のままにすると、動的接続ではなく、設計時に追加された接続が使用されます。


      「構成および実行」ページが表示されます。 「実行」ボタンが上部に表示されます。 「リクエスト」セクションが表示されます。このセクションは、URIパラメータ(選択済)、ヘッダー、本文、cURLおよび統合プロパティ・タブで構成されています。 この下には、file-nameパラメータとその値、ディレクトリ・パラメータとその値、およびdynamic-connection-idパラメータとその値があります。

  13. 「実行」をクリックします。
  14. アクティビティ・ストリームの接続およびワイヤー・メッセージを展開します。

    接続メッセージは、設計時接続のかわりに動的接続が使用されたことを示します。 ワイヤー・メッセージは、使用される接続ID (「FTP 138キー・ベース」)および使用される接続タイプ(ftp)を識別します。


    「構成および実行」ページが表示されます。 「実行」ボタンが上部に表示されます。 「リクエスト」セクションが表示されます。このセクションは、URIパラメータ(選択済)、ヘッダー、本文、cURLおよび統合プロパティ・タブで構成されています。 この下には、file-nameパラメータとその値、ディレクトリ・パラメータとその値、およびdynamic-connection-idパラメータとその値があります。

詳細は、ビデオをご覧ください: