View Source

このセクションの内容

コマンドラインの使用方法をすばやく参照する方法

-help コマンドラインオプションを使用します。

dottestcli.exe -help

ZIP ディストリビューションからインストールした後に dotTEST が正しく機能しない場合

Windows のビルトインの unzip ユーティリティでインストールパッケージを展開する場合、Windows が .zip ファイルを信頼できないと見なし、パッケージのコンテンツへのアクセスをブロックすることがあります。これを防ぐには、以下のいずれかの処理を行います。

.zip ファイルのプロパティで [ブロックの解除] オプションが有効になっていることを確認します。
Windows のビルトインの unzip ユーティリティ以外のソフトウェアを使用して、インストールパッケージの内容を展開します。

Visual Studio 2017 でライトウェイトソリューションロードが有効化されている場合、dotTEST がビルド成果物を発見できない。

デフォルトでは、dotTEST は解析の前にソリューションやプロジェクトをビルドして、.exe ファイルや .dll ファイルなどの必要なビルド成果物を取得しようとします。Visual Studio 2017 でライトウェイトソリューションロードオプションが有効化されている場合、dotTEST はソリューションをビルドできません。結果として、必要なビルド成果物が利用できないか、最新の状態でないため、解析が行われなかったり、一部のルールが実行されなかったりする場合があります。この問題を防ぐには、以下のいずれかの操作を行います。

ライトウェイトソリューションロードオプションを無効にします。
dottest.build.builder_id オプションに msbuild を設定して MSBuild にビルドを委譲します。詳細については「ソリューションおよびプロジェクトのビルド」を参照してください。
解析の前にソリューションをビルドし、dottest.build.nobuild オプションに true を設定するか、コマンドラインオプション -nobuild を渡してビルドフェーズをスキップするよう dotTEST を設定します。詳細については「ソリューションおよびプロジェクトのビルド」を参照してください。

レジストリキーの接頭辞を指定して dotTEST を Visual Studio と統合している場合に失敗したインストールを修正する方法

長い接頭辞を指定すると、Windows のパスの長さの制限によりインストールが失敗する場合があります。dotTEST が正常にインストールされるようにするには、インストール中に短い接頭辞を指定します。

起動時に Visual Studio 2017 または 2019 の速度を Parasoft Plugin またはそのコンポーネントが低下させているという通知を受け取る理由

Visual Studio 2017 および 2019 には新しくパフォーマンス管理オプションが導入され、起動時間に影響を与える可能性がある拡張機能をモニターし、管理できるようになりました。結果として、Parasoft Plugin がインストールされていると、Visual Studio の起動時間が長くなったことを示すポップアップ警告が表示される場合があります。ポップアップウィンドウで [Manage performance] リンクをクリックして起動時間を確認し、警告の表示を無効にすることができます。

Visual Studio の指摘事項に関連付けられた .aspx ファイルを dotTEST が開けない場合

dotTEST を使用すると、[Findings] ビューで指摘事項をダブルクリックするか、コンテキストメニューの [Go to] オプションを使用することで、指摘事項に関連付けられたファイルを自動的に開き、関連するコード行に移動できます。

ただし、指摘事項がレポートされるコードが .aspx ファイルにある場合、dotTEST はファイルを開くことができないことがあり、代わりに、対応する .aspx.cs ファイルを開くことがあります。この場合、指摘事項に関連付けられた .aspx ファイルを手動で開き、ルールをトリガーしたコードに移動する必要があります。

Visual Studio 2015 でコードマーカーが表示されない場合

Parasoft DTP Plugin for Visual Studio を再インストールした場合、Visual Studio 2015 のエディターに解析の指摘事項やコードカバレッジを示すコードマーカーが表示されない場合があります。これは、Visual Studio の既知の問題によるものです (詳細については「MEFCache bug breaks text adorments in any package」を参照 )。

コードマーカーが正しく表示されるようにするには、再インストールまたは Parasoft DTP Plugin をアップデートするたびに Visual Studio MEF キャッシュを消去します。それには、以下の方法があります。

MFC キャッシュを自動的に消去する Clear MEF Component Cache 拡張を使用します (ここからダウンロード)
キャッシュディレクトリを手動で削除します。インストールの方法によって、以下のいずれかの場所にキャッシュディレクトリがあります。
- デフォルトのオプションでプラグインをインストールした場合: %localappdata%\Microsoft\VisualStudio\14.0\ComponentModelCache
- インストール時に <SUFFIX> パラメーターを使用して Visual Studio のレジストリ接尾辞を指定した場合: %localappdata%\Microsoft\VisualStudio\14.0<suffix_name>\ComponentModelCache

dotTEST レポートで一部の文字が正しく表示されない場合

Parasoft 製品によって生成されたレポートを使用するには、環境に sans-serif フォントがある必要があります。国別文字などの一部の文字がレポートで正しく表示されない場合は、システムに sans-serif フォントがインストールされていることを確認してください。

dotTEST を Visual Studio 2013 と統合したとき、結果がレポートされないルールやメトリクスがある

Visual Studio 2013 から dotTEST の解析を実行する場合、一部の静的解析ルールおよびメトリクスは、マシンに Visual Studio Update 5 がインストールされていることを必要とします。Visual Studio Update 5 をインストールするか、コマンドラインから解析を実行します。

VSTest で単体テストを実行したとき、api-ms-win-crt-runtime-l1-1-0.dll is missing エラーが発生する

Universal C Runtime in Windows (KB2999226) アップデートをインストールします。アップデートおよびインストールの詳細については https://support.microsoft.com/en-us/help/2999226/update-for-universal-c-runtime-in-windows を参照してください。

dotTEST がカバレッジ情報を収集できない

カバレッジ収集時に適切な PDB ファイルが存在するかを確認してください。解析対象のアセンブリそれぞれに、ビルド時に生成された PDB ファイルが必要です。
一部のバージョンの .NET Core には、dotTEST が .NET Core アプリケーションのカバレッジを収集するのを妨げるバグがある場合があります。アプリケーションカバレッジが確実に収集されるよう、 dotTEST とともに提供されている dottest.Hooks アセンブリを IIS がデプロイされているアプリケーションフォルダーに配置します。このアセンブリは [INSTALL DIR]/integration/iis/bin/dottest/dotnet にあります。

dotTEST の解析が失敗し、空のレポートが生成される場合

マシンのセットアップによっては、dotTEST に Visual Studio のパスおよびバージョンが提供されず、それが原因で dotTEST がプロジェクトをオープンし解析することができない場合があります。その場合、以下の環境変数を手動で設定する必要があります。

SET VSINSTALLDIR=[path to your Visual Studio installation directory]
例: SET VSINSTALLDIR=C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional
SET VISUALSTUDIOVERSION=[version number of your Visual Studio]
例: VISUALSTUDIOVERSION=15.0

Visual Studio のバージョン番号

製品名	バージョン名
Visual Studio 2017	15.0
Visual Studio 2015	14.0
Visual Studio 2013	12.0
Visual Studio 2012	11.0

dotTEST が Visual Studio で解析を完了できない場合

Windows で FIPS モードが有効になっている場合、dotTEST が解析を完了できないことがあります。解析が正常に完了するようにするには、システムのオプションで FIPS モードを無効にする必要がある場合があります。

マシン ID が変わってしまうのを防ぐ方法

ネットワーク環境が変わると、マシン ID の計算に使用されるインターフェイスが変わり、結果としてマシン ID が一定でなくなる可能性があります。PARASOFT_SUPPORT_NET_INTERFACES 環境変数を使用すると、安定したインターフェイスを指定し、マシン ID が変化するのを防ぐことができます。

PARASOFT_SUPPORT_NET_INTERFACES 環境変数を作成します。
変数に安定した Ethernet ネットワークインスタンスを指定します。仮想インターフェイス、一時インターフェイス、ループバックインターフェイスは使用しないでください。
- Windows の場合: ネットワークカードの MAC アドレスを指定します。ipconfig -all コマンドを実行すると、アドレスを取得できます。例:
SET PARASOFT_SUPPORT_NET_INTERFACES=00-10-D9-27-AC-85

問題が解決しない場合、PARASOFT_DEBUG_NET_INTERFACES 環境変数を作成して true を指定すると、診断情報を取得できます。テクニカルサポートに送信可能なチェック手順や、マシン ID の計算に使用されているインターフェイスが標準出力に表示されます。マシン ID の計算に使用されているインターフェイスには [SELECTED] という接頭辞が付きます。

プロキシ経由で dotTEST を操作する方法

プロキシサーバー経由で接続する場合、通常、-D コマンドラインオプションを使用して JVM にプロトコル固有のシステムプロパティを渡して接続する必要があります。

dotTEST を操作する場合、HTTPS プロトコルのシステムプロパティ (https.proxyHost および https.proxyPort) が設定されていることを確認してください。コマンドは次のようになります。

java -Dhttps.proxyHost=myserver.example.com -Dhttps.proxyPort=8080

Visual Studio では、プロキシモードはサポートされていません。

コマンド ラインの使用方法をすばやく参照する方法