カスタム パイプラインのデバッグ

カスタム パイプラインでメッセージ処理が失敗するときは、ソース レベルのデバッグを使用して、問題の特定と修正を行うことができます。 ソース レベルのデバッグは、BTSNTSVC.exe (カスタム パイプラインがデプロイされている場合) または Pipeline.exe (スタンドアロン パイプライン ツールを使用している場合) にアタッチすることで、Visual Studio デバッガーを使用して行われます。

手順

次の手順に従って、カスタム パイプラインをデバッグします。

配置済みのパイプラインをデバッグする方法

[グループ ハブ] ページからのクエリの追跡およびイベント ビューアーでは、配置済みのコンポーネントでのメッセージ処理の失敗に関する役立つ情報が提供されます。 この情報を使用すると、問題の原因を絞り込むことができます。 カスタム パイプラインが関係している場合には、ソース レベルのデバッグを使用して、問題のあるコードを特定できます。

Visual Studio を使用して配置済みのカスタム パイプラインをデバッグするには

1. カスタム パイプライン プロジェクト ソリューションを Visual Studio に読み込みます。

2. ソリューションの出力パスを Installation Folder>\Pipeline Components に<変更します。 ソリューション エクスプローラーでプロジェクトを右クリックし、[ビルド] タブをクリックし、[参照] ボタンをクリックして [インストール フォルダー>]\[パイプライン コンポーネント] ディレクトリを選択して出力パスを<変更します。

3. Visual Studio 内から、[ビルド | デプロイ] をクリックしてソリューションをデプロイします。

4. パイプラインを実行するホスト インスタンスを再起動します。 BizTalk Server管理コンソールを使用して、パイプラインを実行するホスト インスタンスに移動し、ホスト インスタンスを右クリックし、[再起動] をクリックします。

5. Visual Studio デバッガーを BTSNTSVC.exe にアタッチします。 これを行うには、[プロセスへのアタッチのデバッグ | ] をクリックし、[すべてのセッションでプロセスを表示] をクリックし、[BTSNTSVC.exe] をダブルクリックします。

6. ブレークポイントを設定します。

7. 適切な位置にメッセージをドロップして、カスタム パイプライン コンポーネントを開始します。 設定したブレークポイントで処理が停止します。

Pipeline.exe を使用してデバッグする方法

Pipeline.exe を使用してカスタム パイプラインをテストすることもできます。 これには、運用環境と同様の条件下で実行されないことを犠牲にしてパイプラインをデプロイする必要がないという利点があります。

Pipeline.exe と Visual Studio を使用してカスタム パイプラインをデバッグするには

1. カスタム パイプライン プロジェクト ソリューションを Visual Studio に読み込みます。

2. ソリューションの出力パスを Installation Folder>\Pipeline Components に<変更します。 ソリューション エクスプローラーでプロジェクトを右クリックし、[ビルド] タブをクリックし、[参照] ボタンをクリックして [インストール フォルダー>]\[パイプライン コンポーネント] ディレクトリを選択して出力パスを<変更します。

3. ソリューションの開始アクションを変更します。 ソリューション エクスプローラーでプロジェクトを右クリックし、[デバッグ] タブをクリックし、[外部プログラムの開始] をクリックし、[...] をクリックして、[インストール フォルダー]>\SDK\Utilities\PipelineTools に<移動し、[Pipeline.exe] を選択します。 [スタート オプション] で、コンポーネントに適したコマンド ライン引数を入力します。 Pipeline.exe の詳細については、「 パイプライン ツール」を参照してください。 一般的な構成では、パイプラインとサンプル ファイルを指定します。

   <Path>\YourPipeline.btp -d <Path>\YourTestFile.txt -c  
   

4. ブレークポイントを設定します。

5. F5 キーを押してデバッグを開始します。

参照

パイプライン ツール