テストケースの無効化

現時点ではテストケースを使用しないが、今後使用するかもしれない場合、テストケースを無効にできます。無効なテストケースは実行されません。また、ステータスは「テストケースの実行は無効」としてレポートされます。

テストケースを無効化すると、テストケースのマクロが次のように変更されます。

有効なテストケースのマクロ	無効なテストケースのマクロ
`CPPTEST_TEST(testcasename)`	`CPPTEST_TEST_DISABLED(testcasename)`
`CPPTEST_TEST_FAIL(testcasename)`	`CPPTEST_TEST_FAIL_DISABLED(testcasename)`
`CPPTEST_TEST_EXCEPTION(testcasename,ExcType)`	`CPPTEST_TEST_EXCEPTION_DISABLED(testcasename,ExcType)`
`CPPTEST_TEST_ERROR(testcasename,ErrorCode)`	`CPPTEST_TEST_ERROR_DISABLED(testcasename,ErrorCode)`

テストケースは、テストケースエクスプローラーまたはクラスビューから無効化することができます。

テストケースエクスプローラーから無効化する

テストケースエクスプローラーからテストケースを無効化するには、次の操作を行います。

無効化されたテストは、次のテスト実行でスキップされます。

テストケースエクスプローラーのフィルター機能 (ツールバーの [フィルター] ボタン) は、テストの有効/無効に関わらず利用できます。テストをフィルターした場合、テストの有効/無効は変更されません。

無効にしたテストケースを後で有効に戻すには、テストケースエクスプローラーでノードを右クリックし、ショートカットメニューの [有効化] をクリックします。

コードエディターからテストケースを無効化するには、次の操作を行います。

- デフォルトでは、自動生成テストクラスはテスト対象プロジェクト内の tests/autogenerated ディレクトリに保存されます。
- テストスイートファイルの保存先を確認または変更するには、テストに使用したテストコンフィギュレーションを開き、[生成] タブの [テストスイート] タブの [テストスイート出力ファイルとレイアウト] フィールドを参照します。詳細については「[テストスイート] タブ」を参照してください。
関連するソースコードを右クリックし、[Parasoft] > [C++test] > [テストスイート] > [テストスイートの無効化] をクリックします。

同様の方法で、無効化したテストケースを後で有効化することができます。[Parasoft] > [C++test] > [テストスイート] > [テストスイートの有効化] を選択します。

あるテストケースの結果を、現時点ではチェックする必要はないが今後チェックが必要になるかもしれない場合、コメントを追加してテストケースを無効にできます。今後このテストケースの結果をチェックしたい場合、単純にコメントを削除するだけでテストケースを有効に戻すことができます。

特定のテストケースの結果を無効化するには、次の操作を行います。

別の方法として、直接ソースコードを編集してコメントアウトすることもできます。

その場合も、コメントを削除すれば、またテストケースを有効に戻すことができます。

テストケースは、テストケースエクスプローラー、

クラスビュー、または [品質タスク] ビューから削除できます。

テストケースエクスプローラーから 1 つ以上のテストケースを恒久的に削除するには、次の操作を行います。

クラスビューから 1 つ以上のテストケースを恒久的に削除するには、次の操作を行います。

プロジェクトツリーで、削除するテストケースを選択します。
- デフォルトでは、自動生成テストクラスはテスト対象プロジェクト内の tests/autogenerated ディレクトリに保存されます。
- テストスイートファイルの保存先を確認または変更するには、テストに使用したテストコンフィギュレーションを開き、[生成] タブの [テストスイート] タブの [テストスイート出力ファイルとレイアウト] フィールドを参照します。詳細については「「[テストスイート] タブ」を参照してください。
選択したテストケースを右クリックし、ショートカットメニューの [C++test] > [テストケースの削除] をクリックします。

[品質タスク] ビューから 1 つ以上のテストケースを恒久的に削除するには、次の操作を行います。

削除するテストケースのノードを選択します。次のノードを選択できます。
- テストケースノード
- 違反ノード
- 違反ノードのチャイルド (スタックトレースの項目を含む)
選択したノードを右クリックし、ショートカットメニューの [テストケースを削除] をクリックします。

テストスイートは、テストケースエクスプローラー、クラスビュー、または [品質タスク] ビューから削除できます。

テストスイート全体を恒久的に削除するには、次の操作を行います。

クラスビューで、削除するテストスイートファイルを探します。
1. デフォルトでは、自動生成テストクラスはテスト対象プロジェクト内の tests/autogenerated ディレクトリに保存されます。
2. テストスイートファイルの保存先を確認または変更するには、テストに使用したテストコンフィギュレーションを開き、[生成] タブの [テストスイート] タブの [テストスイート出力ファイルとレイアウト] フィールドを参照します。詳細については「[テストスイート] タブ」を参照してください。
テストスイートファイルのノードを右クリックし、ショートカットメニューの [削除] をクリックします。