TIBCO Rendezvous Receive 成果物を作成する
通知またはイベントの作成は、BizTalk Serverで他の呼び出しを作成するのと似ています。 ここでは、TIBCO Rendezvous メッセージを待機する受信場所を作成する方法について説明します。
イベントと受信場所
TIBCO Rendezvous システムは、選択したサブジェクト名にメッセージを送信できます。 イベントの概念は、他の TIBCO Rendezvous プログラムによるメッセージの生成です。
次の手順は、受信場所のライフ サイクルについて説明しています。
受信場所が作成されます。
受信場所がホストに関連付けられます。
受信場所がオーケストレーションにバインドされます。
受信場所が有効化されます。
受信場所がメッセージを受信します。
重要
各受信場所には一意の名前が必要です。 2 つの受信場所は、同じBizTalk Server展開で同じ名前を持つことはできません。
重要
受信場所のドロップ場所に強力なアクセス制御リスト (ACL) を設定することをお勧めします。 たとえば、ファイルの受信場所がメッセージを取得するディレクトリに強力な ACL を設定し、認証されたユーザーだけがこの場所にメッセージを格納できるようにする必要があります。
受信ポートを作成する
[BizTalk Server管理] で、[BizTalk グループ] を展開し、[アプリケーション] を展開して、アプリケーションを展開します。
[ 受信ポート] を右クリックし、[ 新規] をポイントして、[ 一方向の受信ポート] をクリックします。
[ 受信ポートのプロパティ ] ウィンドウの [ 全般 ] ページで、次の操作を行います。
[ 名前] フィールドに「」と入力します
ReceiveFromTIBCORV。[認証グループ] ボックスで、 認証 を使用する場合のメッセージの処理方法を指定します。
[ 失敗したメッセージのルーティングを有効にする ] チェック ボックスをオンにします。
[ 受信場所 ] ページで、次の操作を行います。
[新規作成] をクリックします。
[ 受信場所 ] ウィンドウの [ 全般 ] ページで、受信場所の 名前 を入力します。
[ 種類 ] ドロップダウン リストから BizTalkServerIsolatedHost を選択し、[ 受信ハンドラー ] ドロップダウン リストからトランスポート アドレスを選択します。
[ 受信パイプライン ] ドロップダウン リストから、 XMLReceive または同等のパイプラインを選択します。
[ スケジュール ] ページで、[ 開始日 ] と [ 終了日 ] を選択して、ドキュメントの受信を制限します。
[サービス ウィンドウを 有効にする] チェック ボックスをオンにします。
[OK] をクリックします。
[ 受信マップ ] ページで、選択したポートでドキュメントを変換するための受信マップを選択します。
[ 追跡 ] ページで、目的の追跡メッセージ本文と追跡メッセージ のプロパティを選択します。
[OK] をクリックします。
トランスポートのプロパティを設定する
メッセージをリッスンするように Microsoft BizTalk Adapter for TIBCO Rendezvous を構成するときは、どのサブジェクト名をリッスンするかを指定します。 必須のプロパティはこれだけです。
[TIBCO Rendezvous Transport Properties]\(TIBCO Rendezvous Transport Properties\)\(TIBCO Rendezvous Transport Properties\)\(TIBCO Rendezvous Transport Properties\)\(TIBCO Rendezvous Transport Properties\)\(TIBCO Rendezvous Transport Properties\)\(TIBCO Rend
これが、アダプターがリッスンするサブジェクト名です (Rendezvous のワイルドカード文字を使用できます)。 最も単純な展開の場合は、必須のプロパティはこれだけです。
![[アダプターの必須プロパティ] ダイアログ ボックスを示す画像。](media/sadp-tibcorecvtranspropertiess.gif "SAdp_TIBCORecvTransPropertiess")
認定済みメッセージングが必要な場合は、[認定リスナーの設定] で再利用可能な名前と台帳ファイル名を指定します。
この設定は、分散キューを定義する場合は必須です。 保証付きメッセージングが必要ない場合は、各項目を空のままにします。 レジャー ファイル名と再利用可能名はどちらも、そのホストで定義されているすべてのポート、およびそのポートで実行される他の TIBCO Rendezvous プログラムをとおして一意であることが必要です。 そうでない場合は、ユーザー インターフェイスによって検出はされませんが、実行時にエラーがトラップされてログに記録されます。
分散キュー設定で、分散キューが不要な場合は、エントリを変更しないでください。
BizTalk Server グループでは、次に示す値が使用されます。 これらの値は、BizTalk Adapter for TIBCO Rendezvous が TIBCO RV への API 呼び出しを行うときに使用されます。
プロパティ 目的 台帳ファイル名 保証付きリスナー (またはグループ メンバー) のレジャー ファイルの名前です。 既定値は Null です。
値が指定されていない場合は、メモリ レジャーが使用されます。再利用可能な名前 保証付きリスナー (またはグループ メンバー) の再利用可能名です。 既定値は Null です。
再利用可能名は、プロセスを再起動時も維持するために必要です。 値が指定されていない場合は、生成された (再利用可能ではない) 名前が使用されます。分散キューが役に立つのは、TIBCO Rendezvous の受信場所を BizTalk Server グループ内に置く場合です。 その場合は、間隔とポリシーの値を入力してください。 アクティブ化間隔とハートビート間隔のどちらも、そのまま TIBCO Rendezvous に渡されます。 間隔は、同じ分散キューのすべての参加者の間で一致している必要があるので、値が入力されるのは 1 回だけです。 ポリシーについては、値がホストごとに異なるのが一般的です。 どのポリシー値も構文は同じです。ホストと値のペアをコロンで区切り、ペアとペアとをセミコロンで区切ります。
たとえば、host1:10、host2:20、host3:30 などです。
ホスト名は、有効な DNS ホスト名または IP アドレスでなければなりません。 ここで指定されたポリシーのそれぞれに対して、アダプターはそのホストに関連付けられた値を検出し、その値を TIBCO Rendezvous API で使用します。
すべてのコンピューターで値が同じである場合は、name:value ペアのリスト ( 20 など) の代わりに単純な値を Tibr に enteOn できます。
プロパティ 目的 アクティブ化間隔 この分散キューに対して使用されるスケジューラ重みポリシー。 この時間が経過してもスケジューラからハートビート メッセージが送られない場合は、TIBCO RV によって新しいスケジューラがアクティブ化されます。 既定値は 20 秒です。 ハートビート間隔 この分散キュー内で使用されるハートビート間隔。 "BizTalk Server グループ" パラメーターと共に使用されます。 これらの値は、BizTalk Adapter for TIBCO Rendezvous が TIBCO RV への API 呼び出しを行うときに使用されます。 この値は、グループのアクティブなスケジューラであるアダプターのインスタンスによって使用されます。スケジューラは、ここで指定された間隔 (秒単位) でハートビート メッセージをブロードキャストします。 既定値は 10 です。 スケジューラ重みポリシー 既定値 (Null) の場合は、グループのすべてのメンバーが同じ確率でスケジューラになります。 別の重みポリシーを設定したい場合は、ホストと重みの値ペアのリストを指定します。 既定値は Null です。 ワーカー処理能力ポリシー この分散キューに対して使用されるワーカー処理能力ポリシー。 この値は、1 つのグループ メンバーが同時に処理できるタスクの数を示します。 指定しない場合、既定値は 1 です。 ホストと容量のペアの値の一覧は、さまざまな容量ポリシーを提供します。 ワーカー重みポリシー この分散キューに対して使用されるワーカー重みポリシー。 この値は、TIBCO による分散キュー内のタスクの割り当てに使用される重みの値です。 使用可能なワーカーへのタスクの割り当ては、重みが大きい順に行われます。 既定値は 1 です。 [ 全般設定] を 展開し、TIBCO Rendezvous サーバーへの接続に必要なすべての情報を入力します。
プロパティ 目的 追加ワイルドカード置換 置換されるワイルドカード テキストを指定します。 作成されるメッセージの中の XML ターゲットの名前空間は、受信場所がリッスンしているサブジェクト名を使用して生成されます。 既定では、アダプターは、生成されたメッセージのテキスト GTWILDCARD に '>' ワイルドカードを置き換えます。 別のワイルドカードをこのフィールドで指定できます。 コード ページ番号 受信メッセージに含まれる文字列をエンコードするためにメッセージの発信元が使用するコード ページを指定します。 既定値は 65001 です。 (アダプターは、2 つの異なるコード ページ環境から生成された同じメッセージ 件名を持つことをサポートしていません。 要素ワイルドカード置換 置換される別のワイルドカード テキストを指定します。作成されるメッセージの中の XML ターゲットの名前空間は、受信場所がリッスンしているサブジェクト名を使用して生成されます。 既定の設定では、生成されたメッセージの中の "*" というワイルドカードはすべて、STARWILDCARD というテキストに置き換えられます。 別のワイルドカードをこのフィールドで指定できます。 イベント キュー名 Rendezvous Queue オブジェクトを作成するときに使用される名前を指定します。 これは、便宜上用意されている項目です (関連付けられているログ メッセージでイベント キュー名が表示されるため)。 既定値は空です。 Assert リッスンするサブジェクト名にワイルドカード文字が使用されている場合、ターゲット オーケストレーションの対象は、到達する可能性のある膨大なサブジェクトのセットのごく一部だけとなることがあります。 BizTalk Server への影響を最小限に抑え、データベース アクセスを減らすために、どのメッセージを BizTalk Server に送信するかをさらに詳しく指定することができます。 この項目の内容は、サブジェクト名をセミコロンで区切ったリストです (ワイルドカード文字は使用できません)。 ワイルドカードで指定されたサブジェクト名にメッセージが一致していても、メッセージのサブジェクト名がこのリストにある場合はメッセージは除外され、BizTalk Server には送信されません。 フィルターのロジックを反転させるには、フィルター値の前に "!" を付けます。 既定値は空 (フィルターなし) です。 サポートされていない型を文字列にマップする サポートされない型が見つかった場合にエラーを生成するか文字列にマッピングするかを指定します。 新しいバージョンの TIBCO Rendezvous でアダプターを使用する場合に使用できます。新しいバージョンでは、新しい型が追加されている可能性もあるからです。 BizTalk グループのメンバー True に設定されている場合は、分散キューのパラメーター ([分散キューの設定] ノードを参照) および保証付きリスナーのパラメーター ([認定済みリスナーの設定] ノードを参照) の設定が必須です。 既定値は False です。 パス TIBCO Rendezvous バイナリの場所を指すように設定します (この情報が PATH 環境変数で指定されていない場合)。 順序の維持 アダプターが受信したメッセージを、受信した順序で BizTalk Server にディスパッチするかどうかを指定します (たとえば、使用するディスパッチ スレッドが 1 つだけの場合)。 "保証付きメッセージング" のパラメーターが設定されていない場合は、メッセージが送信された順序でアダプターが受信する (送信元が 1 つだけ) とは限らないことに注意してください。 受信場所識別子 受信場所の名前です。 Reserved 特別な用途のために予約されているフィールドです。 [ランデブー トランスポート] を展開し、TIBCO Rendezvous デーモンとプログラム間の通信に必要なすべての情報を入力します。
トランスポート (ネットワーク、デーモン、サービス) は、TIBCO Rendezvous デーモンがメッセージを交換する方法を指定します。 これらの設定は、そのまま TIBCO Rendezvous API に送信されます。 既定値 (空) のままの場合は、既定の通信方法が使用されます。
TIBCO Rendezvous トランスポートには配信スコープ、つまりメッセージ送信先の集合が定義されます。 次に示すプロパティによって、トランスポートが定義されます。
パラメーター 説明 Daemon Rendezvous トランスポートの "デーモン" パラメーターの数値識別子を入力します。 Network Rendezvous の "ネットワーク" パラメーターの名前を入力します。 サービス ナム eRendezvous トランスポートのサービスの名前を入力します。 シングル サインオン (SSO) を使用する資格情報を指定します。
TIBCO Rendezvous システムにアクセスする方法は 2 つあります。 1 つは資格情報 ([ユーザー名] パラメーターと [パスワード] パラメーター) を使用する方法で、もう 1 つはシングル サインオン (SSO) を使用する方法です。
[SSO を使用してシングル サインオンを使用する] で [はい] を選択します。
注意
SSO の設定方法については、「 セキュリティ 」を参照してください。
一覧から関連アプリケーションを選択します。
エンタープライズ シングル サインオン ツールで作成された関連アプリケーションは TIBCO Rendezvous などのアプリケーションを表します。 Microsoft BizTalk Adapter for TIBCO Rendezvous では、アプリケーション ユーザーの資格情報が使用されます。 これらの資格情報は、指定された関連アプリケーションのサーバー システムの SSO データベースから取得されます。
注意
関連アプリケーションを作成する方法については、「 関連アプリケーションの作成」を参照してください。
必要なすべての情報を入力したら、[ 適用] をクリックし、[ OK] をクリックします。
TIBCO Rendezvous のメッセージを受信するには、BizTalk Adapter for TIBCO Rendezvous の接続パラメーターを設定する必要があります。