Message Inspector パイプライン コンポーネント
このパイプライン コンポーネントにより、マルチパート メッセージのすべての部分、およびメッセージ コンテキストを確認し、メッセージに問題があるかどうかを判断できます。 このコンポーネントはトラブルシューティングの目的で使用します。
このパイプライン コンポーネントにより、XML ファイルは指定されたディレクトリにドロップされます。 これらの各ファイルは、RNIFv2.0 メッセージの 4 つの部分 (Preamble Header、Delivery Header、Service Header、Service Content) のいずれか、または RNIFv1.1 メッセージの 3 つの部分 (Preamble Header、Service Header、Service Content) のいずれかを含んでいます。 もう 1 つの XML ファイルは、メッセージ コンテキストを含んでいます。
このコンポーネントは、カスタム パイプラインに構築し、送信ポートに接続します。 送信ポートにフィルタを作成し、監視するメッセージをサブスクライブします。 このトラブルシューティングは、Microsoft® BizTalk Accelerator for RosettaNet (BTARN) が既に実行している標準処理に加えて行われます。
Message Inspector パイプライン コンポーネントを使用したカスタム パイプラインの構築
Message Inspector パイプライン コンポーネントを使用するには、このコンポーネントを含むカスタム パイプラインを構築し、展開する必要があります。 詳細については、BizTalk Server ヘルプの「パイプライン Designerを使用したパイプラインの作成」を参照してください。
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 エクスプローラー] をクリックします。
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] をクリック します。
ソリューション エクスプローラーでプロジェクト名を右クリックし、[追加] をポイントして、[新しい項目の追加] をクリックします。
[ 新しい項目の追加 ] ダイアログ ボックスで、[ パイプラインの送信] を選択し、[ 名前 ] ボックスにカスタム パイプライン ファイルの名前を入力し、[ 開く] をクリックします。
注意
Message Inspector パイプライン コンポーネントは、受信ポートではなく、送信ポートのみに追加します。
[ツールボックス] ウィンドウの [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 Pipeline Designerで、[BTARN Message Inspector Component]\(BTARN メッセージインスペクター コンポーネント\) 図形を選択します。
Visual Studio プロパティ ウィンドウの [ディレクトリ] ボックスに、XML ファイルを削除するディレクトリの名前を入力します。
ソリューション エクスプローラーでプロジェクト名を右クリックし、[ビルド] をクリックします。 ビルドが成功することを確認します。
ソリューション エクスプローラーでプロジェクト名を右クリックし、[配置] をクリックします。 展開が成功することを確認します。
Visual Studio の [表示] メニューの [BizTalk エクスプローラー] をクリックします。
[ 送信ポート] を右クリックし、[ 送信ポートの追加] をクリックします。
[ 新しい送信ポートの作成 ] ダイアログ ボックスで、[OK] をクリック します。
[ 送信ポートのプロパティ ] ダイアログ ボックスの [名前 ] ボックスに、送信ポートの名前を入力し、左側のウィンドウで [プライマリ] が選択されている状態で、右側のウィンドウで [ トランスポートの種類 ] をクリックし、[ ファイル] を選択します。
[ 送信ポートのプロパティ ] ダイアログ ボックスの [ アドレス (URI)] ボックスで、省略記号ボタン (...) をクリックします。
[ ファイル トランスポートのプロパティ ] ダイアログ ボックスで、 宛先 フォルダー名を入力し、左側のウィンドウで [ 送信 ] をクリックし、右側のウィンドウの [送信パイプライン ] で、先ほど作成したカスタム パイプラインを選択します。
左側 のウィンドウで [フィルター] & [マップ ] をクリックし、[ フィルター] をクリックします。
右側のペインにフィルター式を入力し、パイプラインで XML ファイルをドロップするファイルの種類を指定します。 たとえば、すべての RNIF v1.1 メッセージのファイルを削除する場合は、[ プロパティ ] で [Microsoft.Solutions.BTARN.Schemas.RNIFv11.GlobalBusinessAction] を選択し、[ オペレーター] で [存在] を選択し、[ OK] をクリックします。
BizTalk エクスプローラーで、先ほど作成した送信ポートを右クリックし、[参加] をクリックし、もう一度送信ポートを右クリックして、[開始] をクリックします。
注釈
通常の処理では、一度に確認できるのはメッセージの一部分 (オーケストレーションでメッセージの本文として指定した部分) のみです。 したがって、BizTalk 管理コンソールではメッセージの一部分しか確認できないため、トラブルシューティングの能力も限定されます。 メッセージインスペクターパイプラインコンポーネントは、この制限を克服するのに役立ちます。