このパイプライン コンポーネントを使用すると、マルチパート メッセージのすべての部分とメッセージ コンテキストを調べて、メッセージに問題があるかどうかを判断できます。 このコンポーネントは、トラブルシューティングの目的で使用します。
パイプライン コンポーネントは、指定したディレクトリに XML ファイルをドロップします。 これらの各ファイルには、RNIFv2.0 メッセージ (Preamble ヘッダー、配信ヘッダー、サービス ヘッダー、およびサービス コンテンツ) の 4 つの部分のいずれか、または RNIFv1.1 メッセージの 3 つの部分 (プリアンブル ヘッダー、サービス ヘッダー、およびサービス コンテンツ) のいずれかが含まれています。 別の XML ファイルには、メッセージ コンテキストが含まれています。
このコンポーネントをカスタム パイプラインにビルドし、送信ポートにアタッチします。 監視するメッセージをサブスクライブするフィルターを送信ポートに作成します。 このトラブルシューティングは、Microsoft® BizTalk Accelerator for RosettaNet (BTARN) が既に実行している標準処理に加えて発生します。
Message Inspector パイプライン コンポーネントを使ってカスタムパイプラインを作成する
Message Inspector パイプライン コンポーネントを使用するには、コンポーネントを含むカスタム パイプラインをビルドしてデプロイする必要があります。 詳細については、BizTalk Server ヘルプの「パイプライン デザイナーを使用したパイプラインの作成」を参照してください。
Message Inspector パイプライン コンポーネントをデプロイするには
Visual Studio を起動します。
[ ファイル ] メニューの [ 開く] をポイントし、[ プロジェクト] をクリックします。
C:\Program Files (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component に移動し、[ MessageInspector.csproj] を選択して 、[ 開く] をクリックします。
Visual Studio コマンド プロンプトを開きます。
コマンド プロンプトで、C:\Program Files (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug に移動します。
コマンド プロンプトで 、「sn -k MessageInspector.snk」と 入力してキーを作成し、Enter キーを押します。
Visual Studio のソリューション エクスプローラーで、 MessageInspector を右クリックし、[ プロパティ] をクリックします。
[MessageInspector プロパティ] ページで、[署名] タブをクリックし、[アセンブリに署名する] チェック ボックスをオンにします。
[ 厳密な名前のキー ファイルの選択 ] ドロップダウンで、C:\Program Files (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug に移動し、[ MessageInspector.snk ] を選択して [ 開く] をクリックします。
ソリューション エクスプローラー で MessageInspector を右クリックし、[ ビルド] をクリックします。 [出力] ウィンドウで、ビルドが成功したことを確認します。
[ スタート] をクリックし、[ すべてのプログラム] をポイントし、[ アクセサリ] をポイントして、[ エクスプローラー] をクリックします。
Windows エクスプローラーで、C:\Program Files (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug に移動し、 Microsoft.Solutions.BTARN.SDK.MessageInspector.dll右クリックして、[ コピー] をクリックします。
C:\Program Files (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\Pipeline Components に移動し、[ パイプライン コンポーネント] を右クリックして、[ 貼り付け] をクリックします。
Visual Studio の [ ファイル ] メニューの [ 新規作成] をポイントし、[ プロジェクト] をクリックします。
[ 新しいプロジェクト ] ダイアログ ボックスの [テンプレート] ウィンドウで、[ 空の BizTalk Server プロジェクト] を選択し、[ 名前 ] ボックスにプロジェクトの名前を入力します。 [ 場所 ] ボックスで、プロジェクトを保存するフォルダーに移動し、[OK] をクリック します。
ソリューション エクスプローラーで、プロジェクト名を右クリックし、[ 追加] をポイントして、[ 新しい項目の追加] をクリックします。
[ 新しい項目の追加 ] ダイアログ ボックスで、[ パイプラインの送信] を選択し、[ 名前 ] ボックスにカスタム パイプライン ファイルの名前を入力し、[ 開く] をクリックします。
注
メッセージ インスペクター パイプライン コンポーネントは、ポートを送信するためだけに追加し、ポートを受信する場合は追加しません。
[ツールボックス] ウィンドウの [BizTalk パイプライン コンポーネント] ウィンドウ内を右クリックし、[ 項目の追加と削除] をクリックします。
[ ツールボックスのカスタマイズ ] ダイアログ ボックスの [ BizTalk パイプライン コンポーネント ] タブで、[ BTARN メッセージインスペクター コンポーネント] を選択し、[OK] をクリック します。
[ツールボックス] ウィンドウの [BizTalk パイプライン コンポーネント] ウィンドウで、 BTARN メッセージインスペクター コンポーネントをクリックしたまま、[ ここにドロップ ] ボックスにコンポーネントをドラッグします。
Visual Studio のソリューション エクスプローラーで、パイプライン プロジェクトの名前を右クリックし、[ プロパティ] をクリックします。
[ プロパティ ページ ]ダイアログ ボックスで、[ 共通プロパティ]、[ アセンブリ]の順にクリックします。
右側のウィンドウの アセンブリ キー ファイルに関連付けられているテキスト ボックスで、省略記号をクリックし、C:\Program Files (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug に移動し、 MessageInspector.snk を選択して 、[OK] をクリックします。
Visual Studio パイプライン デザイナーで、 BTARN Message Inspector コンポーネント 図形を選択します。
Visual Studio の [プロパティ] ウィンドウの [ ディレクトリ ] ボックスに、XML ファイルを削除するディレクトリの名前を入力します。
ソリューション エクスプローラーで、プロジェクト名を右クリックし、[ ビルド] をクリックします。 ビルドが成功したことを確認します。
ソリューション エクスプローラーで、プロジェクト名を右クリックし、[ 配置] をクリックします。 デプロイが成功したことを確認します。
Visual Studio の [ 表示 ] メニューの [ BizTalk エクスプローラー] をクリックします。
[ 送信ポート] を右クリックし、[ 送信ポートの追加] をクリックします。
[ 新しい送信ポートの作成 ] ダイアログ ボックスで、[ OK] をクリックします。
[ 送信ポートのプロパティ ] ダイアログ ボックスの [名前 ] ボックスに、左側のウィンドウで [プライマリ ] が選択された状態で送信ポートの名前を入力し、右側のウィンドウで [ トランスポートの種類 ] をクリックし、[ ファイル] を選択します。
[ 送信ポートのプロパティ ] ダイアログ ボックスの [ アドレス (URI)] ボックスで、省略記号ボタン (...) をクリックします。
[ ファイル トランスポートのプロパティ ] ダイアログ ボックスで、 宛先 フォルダー名を入力し、左側のウィンドウで [ 送信 ] をクリックし、右側のウィンドウの [送信パイプライン ] で、先ほど作成したカスタム パイプラインを選択します。
左側のウィンドウで [ フィルター] と [マップ ] をクリックし、[ フィルター] をクリックします。
右側のウィンドウにフィルター式を入力し、パイプラインで XML ファイルを削除するファイルの種類を指定します。 たとえば、すべての RNIF v1.1 メッセージのファイルを削除する場合は、[ プロパティ ] で Microsoft.Solutions.BTARN.Schemas.RNIFv11.GlobalBusinessAction を選択し、[ オペレーター ] で [存在] を選択し、[ OK] をクリックします。
BizTalk エクスプローラーで、先ほど作成した送信ポートを右クリックし、[ 参加] をクリックし、もう一度送信ポートを右クリックして、[ 開始] をクリックします。
注釈
一般的な処理では、一度に 1 つのメッセージ部分 (オーケストレーションでメッセージ本文として指定した部分) のみを調べることができます。 そのため、BizTalk 管理コンソール内の 1 つの部分のみを調べることができ、トラブルシューティングの機能は制限されています。 メッセージインスペクターパイプラインコンポーネントは、この制限を克服するのに役立ちます。