カスタム パイプラインでメッセージ処理が失敗した場合は、ソース レベルのデバッグを使用して問題を特定して修正できます。 ソース レベルのデバッグは、Visual Studio デバッガーを使用して、BTSNTSVC.exe にアタッチするか (カスタム パイプラインがデプロイされている場合)、または Pipeline.exe (スタンドアロン パイプライン ツールを使用する場合) を使用して行います。
プロシージャ
カスタム パイプラインをデバッグするには、次の手順を使用します。
デプロイされたパイプラインをデバッグする方法
グループ ハブ ページとイベント ビューアーからのクエリを追跡すると、デプロイされたコンポーネントでのメッセージ処理エラーに関する有用な情報が提供されます。 この情報は、多くの場合、問題の原因を絞り込むために使用できます。 カスタム パイプラインが関与されたら、ソース レベルのデバッグを使用して問題のあるコードを特定できます。
Visual Studio を使用してデプロイされたカスタム パイプラインをデバッグするには
カスタム パイプライン プロジェクト ソリューションを Visual Studio に読み込みます。
ソリューションの出力パスを <Installation Folder>\Pipeline Components に変更します。 ソリューション エクスプローラーでプロジェクトを右クリックし、[ビルド] タブをクリックし、[ 参照 ] ボタンをクリックし、 <Installation Folder>\Pipeline Components ディレクトリを選択して出力パスを変更します。
Visual Studio 内から、ビルド | Deploy をクリックしてソリューションをデプロイします。
パイプラインを実行するホスト インスタンスを再起動します。 BizTalk Server 管理コンソールを使用して、パイプラインを実行するホスト インスタンスに移動し、ホスト インスタンスを右クリックし、[ 再起動] をクリックします。
Visual Studio デバッガーを BTSNTSVC.exeにアタッチします。 これを行うには、[デバッグ] | [プロセスにアタッチ]、[すべてのセッションのプロセスの表示] の順にクリックし、BTSNTSVC.exeをダブルクリックします。
ブレークポイントを設定します。
メッセージを適切な場所にドロップして、カスタム パイプライン コンポーネントを開始します。 設定したブレークポイントで処理が停止します。
注
コードが例外をスローすると、BizTalk Server によって例外がキャッチされ、最終的にメッセージが中断されます。 この動作を回避するには、初回例外でブレークポイントを設定する必要があります。
Pipeline.exe を使用してデバッグする方法
Pipeline.exeを使用してカスタム パイプラインをテストすることもできます。 これには、運用環境と同様の条件下で実行されないことを犠牲にしてパイプラインをデプロイする必要がないという利点があります。
注
カスタム パイプラインでフラット ファイル アセンブラー/逆アセンブラーを使用している場合、Pipeline.exe は正しく実行されません。 これは、Pipeline.exe が BizTalk データベースにアクセスしないためです。 1つの解決策は、アセンブラー/逆アセンブラーコンポーネントを取り外し、FFDasm.exe と FFAsm.exeで個別にテストすることです。 詳細については、「 パイプライン ツール 」を参照してください。
Pipeline.exe と Visual Studio を使用してカスタム パイプラインをデバッグするには
カスタム パイプライン プロジェクト ソリューションを Visual Studio に読み込みます。
ソリューションの出力パスを <Installation Folder>\Pipeline Components に変更します。 ソリューション エクスプローラーでプロジェクトを右クリックし、[ビルド] タブをクリックし、[ 参照 ] ボタンをクリックし、 <Installation Folder>\Pipeline Components ディレクトリを選択して出力パスを変更します。
ソリューションの開始アクションを変更します。 ソリューション エクスプローラーでプロジェクトを右クリックし、[デバッグ] タブをクリックし、[外部プログラムの開始] をクリックし、[... ] をクリックして、[インストール フォルダー>\SDK\Utilities\PipelineTools and choose Pipeline.exe<に移動します。 [開始オプション] で、コンポーネントに適したコマンド ライン引数を入力します。 Pipeline.exeの詳細については、「 パイプライン ツール」を参照してください。 一般的な構成では、パイプラインとサンプル ファイルを指定します。
<Path>\YourPipeline.btp -d <Path>\YourTestFile.txt -cブレークポイントを設定します。
F5 キーを押してデバッグを開始します。