チュートリアル: BizTalk Adapter for TIBCO Rendezvous を使用したデータの送信

  • [アーティクル]

BizTalk Adapter for TIBCO Rendezvous を使用して TIBCO システムにデータを送信できます。 このチュートリアルでは、これを示す SDK サンプルについて説明します。

前提条件

  • サンプルをビルドして展開するために、アダプターが実行されているBizTalk Serverに Visual Studio をインストールします。

  • サンプルでは、メッセージ コンテキストのプロパティを含んでいる Microsoft.BizTalk.Adapters.TibRV.Properties.dll という DLL を使用します。 ソリューションからこのライブラリへの参照を更新する必要がある場合があります。 詳細については、「BizTalk Server メッセージ コンテキストプロパティ (送信ハンドラー)」を参照してください。

サンプルについて

  • このサンプルでは、ファイル フォルダーから XML ファイルを取得し、そのファイルをオーケストレーションに送信し、BizTalk Adapter for TIBCO Rendezvous を使用して TIBCO システム内にレコードを作成します。

  • Visual Studio で設計されたこのサンプルは、BizTalk オーケストレーションで BizTalk Adapter for TIBCO Rendezvous を使用する基本的な機能を示しています。

  • サンプルの既定の場所は であり C:\Program Files\Microsoft BizTalk Adapters for Enterprise Applications\TIBCO(r) Rendezvous(r)\Sdk\OneWaySend、次のファイルが含まれています。

    ランタイム プロジェクトのファイル名 ランタイム プロジェクト ファイルの説明
    OneWaySend.btproj

    OneWaySend.sln    		 アプリケーションのプロジェクトおよびソリューション ファイル。
    Schema.xsd

    PropertySchema.xsd    		 アプリケーションのスキーマおよびプロパティ スキーマ ファイル。
    Orchestration.odx アプリケーションが使用するオーケストレーション。
    TIBCORendezvousOneWaySend.snk 厳密な名前のキー ファイル。

手順 1: BizTalk 管理にアダプターを追加する

  1. [BizTalk Server管理] で、[BizTalk グループ] を展開し、[プラットフォーム設定] を展開して、[アダプター] をクリックします。

  2. [ アダプター ] を右クリックし、[ 新規] をポイントして [アダプター の プロパティ ] ダイアログを表示します。

  3. [名前] フィールドに値を入力します。 たとえば、「 TIBCO Rendezvous」と入力します。

  4. [アダプター] ドロップダウンで使用可能なアダプターの一覧から [TIBCO(r) Rendezvous(r)] を選択し、[OK] をクリックします。

手順 2: 送信ポートを作成する

  1. [BizTalk Server管理] で、[BizTalk グループ]、[アプリケーション]、[BizTalk アプリケーション 1] の順に展開し、[送信ポート] をクリックします。

  2. [ 送信ポート ] を右クリックし、[ 新規]、[ 静的 One-Way 送信ポート]を ポイントして、[ 送信ポートのプロパティ ] ダイアログを表示します。

  3. [名前] フィールドに値を入力します (例: TIBCORndOneWaySP)。

  4. [ 種類 ] ドロップダウン ボックスで使用可能なアダプターの一覧から [TIBCO Rendezvous アダプター] を選択し、[ 構成 ] ボタンをクリックして [アダプター のトランスポートプロパティ ] ダイアログ ボックスを表示します。

    Note

    この値は、BizTalk Server管理コンソールで TIBCO エンタープライズ・メッセージ・システム・アダプターが作成されたときに指定された名前です。

  5. [Certified Sender Properties]\(認定送信者のプロパティ\) の値を入力します。

    プロパティ Value
    台帳ファイル名 永続的な認証されたメッセージ配信に使用する台帳ファイル名。
    再利用可能な名前 認証されたメッセージ配信に使用する再利用可能な送信者名です。 この名前は、ネットワーク上のすべての認証されたメッセージの送信者名の中で一意である必要があります。

  6. 資格情報の値を入力 します。

    プロパティ Value
    パスワード TIBCO Rendezvous サーバーのパスワード。
    ユーザー名 TIBCO Rendezvous サーバーのユーザー名。

  7. RendezvousTransport の値を入力します。

    プロパティ Value
    デーモン Rendezvous トランスポート デーモン パラメーター。
    ネットワーク Rendezvous トランスポート ネットワーク パラメーター。
    サービス Rendezvous トランスポート サービス パラメーター。

    プロパティの詳細については、「 送信成果物を作成する」を参照してください。

  8. [OK] をクリックします。

  9. [送信パイプライン] ドロップダウンで使用できるパイプラインの一覧から [XML 送信パイプライン] を選択し、[OK] をクリックします。

  10. 送信ポートを右クリックし、[ 開始 ] をクリックして参加し、送信ポートを開始します。

手順 3: 受信ポートを作成する

  1. [BizTalk Server管理] で、[BizTalk グループ]、[アプリケーション]、[BizTalk アプリケーション 1] の順に展開し、[受信ポート] をクリックします。

  2. [受信ポート] フォルダーを右クリックし、[ 新規]、[ 一方向の受信ポート... ] の順にクリックして、[受信ポートのプロパティ] ダイアログを表示します。

  3. [名前] フィールドに値 (TIBCORndOneWayFileRP など) を入力し、[OK] をクリックします。

手順 4: 受信場所を作成する

  1. 監視対象のファイル受信場所となるフォルダー (たとえば C:\Filesource) を作成します。

  2. 新しい受信ポートを右クリックし、[ 新規]、[ 受信場所... ] の順にクリックして、[ 受信場所のプロパティ ] ダイアログを表示します。

  3. [名前] フィールドに値を入力します (例: TIBCORndOneWayFileRL)。

  4. [種類] ドロップダウン ボックスで使用可能なアダプターの一覧から [ファイル] を選択し、[構成] ボタンをクリックして、[アダプターのトランスポートのプロパティ] ダイアログ ボックスを表示します。

  5. 前に作成したフォルダーの場所を [受信フォルダー] プロパティに入力し、[OK] をクリック します。

  6. [受信パイプライン] ドロップダウン ボックスで、使用可能なパイプラインの一覧から [XMLReceive] を選択し、[OK] をクリックします。

  7. 受信場所を右クリックし、[ 有効] をクリックします。

手順 5: スキーマからドキュメント インスタンスを生成する

  1. Visual Studio で、ソリューション エクスプローラーで Schema.xsd を右クリックし、[プロパティ] をクリックします。

  2. プロパティ ウィンドウで、[全般] セクションの [出力インスタンスファイル名] オプションをクリックして選択します。

  3. 省略記号ボタン (...) をクリックして、[ 出力ファイルの選択 ] ダイアログを表示します。

  4. 出力ファイル インスタンスのフォルダーと名前を指定します (例: C:\instance.xml して[ 保存] をクリックします。

    Note

    ファイル受信場所に指定したフォルダーの場所は、ここに指定しないでください。

  5. ソリューション エクスプローラーで [Schema.xsd] を右クリックし、[インスタンスの生成] をクリックして、指定した場所にドキュメント インスタンスを生成します。

手順 6: 生成されたドキュメント インスタンスを更新する

  1. 生成されたドキュメント インスタンスをテキスト エディターで開き (メモ帳が動作します)、ドキュメント インスタンスの内容を編集して、データが TIBCO システムで一意のレコードを生成するようにします。 たとえば、次のコードは、データ ファイルの最初の部分を示しています。

    <ns0:Root xmlns:ns0="http://TibcoRendezvousOneWaySend.TibcoRendezvousOneWaySendSchema">  
    <Name>Punya Palit</Name>  
    <MailAddress>Prose Ware, Inc.</MailAddress>  
</ns0:Root>

  2. 変更したドキュメント インスタンスを保存します。

手順 7: プロジェクトをビルドして配置する

  1. ソリューション エクスプローラーで OneWaySend プロジェクトを右クリックし、[プロパティ] をクリックしてプロジェクトのプロジェクト Designerを起動します。

  2. [ デプロイ ] タブをクリックします。

  3. [サーバー] プロパティと [構成データベース] プロパティの適切な値を BizTalk グループに入力します。

  4. ソリューション エクスプローラーで OneWaySend プロジェクトを右クリックし、[配置] をクリックしてプロジェクトをビルドし、アセンブリをBizTalk Server構成データベースに配置します。

手順 8: オーケストレーションをバインド、参加、開始する

  1. [BizTalk Server管理] で、[BizTalk グループ]、[アプリケーション]、[BizTalk アプリケーション 1] の順に展開し、[オーケストレーション] をクリックします。

  2. MMC ツール バーの [最新の情報に更新] ボタンをクリックするか、キーボードの F5 キーを押してBizTalk Server管理コンソール ビューを更新します。

  3. オーケストレーションをダブルクリックして、[ オーケストレーションのプロパティ ] ダイアログを表示します。

  4. ダイアログの左側のウィンドウで [ バインド ] をクリックして、オーケストレーションの [バインド] オプションを表示します。

  5. バインド オプションに適切な値を指定します。次に例を示します。

    パラメーター Value
    Host BizTalkServerApplication
    FileReceivePort TIBCORndOneWayFileRP
    TibcoRendezvousSend TIBCORndOneWaySP

  6. [OK] をクリックします。

  7. オーケストレーションを右クリックし、[ 開始 ] をクリックしてオーケストレーションに参加して開始します。

手順 9: ドキュメントを削除し、TIBCO システムをチェックする

  • 先ほど作成したドキュメント インスタンスを、アプリケーションが監視するファイル受信フォルダーにコピーします。

  • TIBCO Web インターフェイスを使用して、XML ファイルのデータからレコードが作成されたことを確認します。

ドキュメント インスタンスが正常に処理された場合、次の一連のイベントが発生します。

  1. ファイル アダプターがフォルダーからファイルを取得し、メッセージボックスに BizTalk メッセージとして公開します。

  2. この公開されたメッセージをオーケストレーションがサブスクライブします。その結果、BizTalk メッセージング エンジンによってオーケストレーションのインスタンスがアクティブ化され、メッセージがオーケストレーション インスタンスに送信されます。

  3. オーケストレーション インスタンスがオーケストレーションで指定されたロジックを使用してメッセージを処理し、メッセージ ボックスにメッセージを返します。

  4. この公開されたメッセージを TIBCO 送信ポートがサブスクライブします。その結果、BizTalk メッセージング エンジンによってこのメッセージが TIBCO 送信ポートに送信されます。

  5. 送信ポートがメッセージを BizTalk Adapter for TIBCO Rendezvous に渡します。

  6. BizTalk Adapter for TIBCO Rendezvous がメッセージを TIBCO システムに送信します。

参照

チュートリアル: BizTalk Adapter for TIBCO Rendezvous を使用したデータの受信
チュートリアル: Microsoft BizTalk Adapter for TIBCO Rendezvous の使用
はじめに