このセクションの内容
カスタム テスト コンフィギュレーションを作成するには、以下を行います。
- ローカルまたは DTP で既存のテスト コンフィギュレーションを複製します。
- 複製したコンフィギュレーションの設定を組織の開発ポリシーに合わせて変更します。
ローカルでのカスタム コンフィギュレーションの作成
ローカルでカスタム テスト コンフィギュレーションを作成するには、ビルトイン コンフィギュレーションをユーザー ディレクトリにコピーし、組織の開発ポリシーに合わせてカスタマイズします。
[Parasoft] メニューの[設定] (Eclipse)、[オプション] (NetBeans) または [設定] (IntelliJ) をクリックし、[コンフィギュレーション] を選択します。
コピーするテストコンフィギュレーションを右クリックし、[ローカルで複製] を選択します。
コピー元のテストコンフィギュレーションがあるディレクトリと同名のディレクトリが User ディレクトリに作成され、その下に複製したテストコンフィギュレーションが置かれます。
複製したテストコンフィギュレーションを右クリックし、[編集] を選択します。
注意: テスト コンフィギュレーション エディターは、別の Web サーバー プロセスで処理されるため、マシンにインストールされたファイアウォールが厳格な場合、プロセスがブロックされる場合があります。その場合、プロセスの実行を求めるプロンプトが表示されたら実行を許可してください。[テキストとして編集] を選択すると、簡易的なコンフィギュレーション エディター (非推奨) が開き、テキストで表現されたコンフィギュレーションが表示されます。
タブをクリックして関連のあるテスト コンフィギュレーション設定を表示します。テスト コンフィギュレーション設定の詳細については、設定の隣にある情報アイコン (i) にカーソルを合わせます。以下のタブがあります。
[一般的な設定] タブ
[一般的な設定] タブをクリックすると、テスト コンフィギュレーションの名前および場所を参照および変更できます。このタブで行った変更を保存するには、[保存] をクリックします。
[フォルダー] フィールドに名前を入力し、テスト コンフィギュレーションの場所を変更します。既存のフォルダー名を入力すると、テスト コンフィギュレーション ツリーの該当フォルダーにテスト コンフィギュレーションが移動されます。指定した名前がまだ存在しない場合、新しいフォルダーが作成され、テスト コンフィギュレーションが配置されます。フォルダー名をスラッシュ (/) で区切ると、フォルダーをネストすることができます。
[スコープ] タブ
[スコープ] タブには、テスト コンフィギュレーションがカバーするコードを定義するためのフィルターのセットがあります。スコープ情報を収集するには、 Jtest をソース管理システムに接続する必要があります。このタブで行った変更を保存するには、[保存] をクリックします。
時間フィルター
[時間フィルター] 設定を展開すると、ファイルまたは行レベルで時間ベースのフィルターを設定できます。時間フィルターを使用すると、解析スコープを特定の日付範囲または期間に制限することができます。scope.scontrol
に true
が設定され、Jtest にソース管理システムが設定されている場合、ソース管理システムの履歴から変更日時が取得されます。scope.local
が true の場合、変更日時は解析を実行するマシンのファイル システムから取得されます。
以下のオプションを選択できます。
ファイルレベルの設定
すべてのファイルをチェック | デフォルトの設定です。このオプションが選択されている場合、ユーザーが選択した解析スコープ内のすべてのファイルが対象になります。 |
---|---|
ローカルで変更されたファイルをチェック | このオプションが選択されている場合、ローカルで変更されたファイルだけがチェックされます。ソース管理システムのファイルは除外されます。このオプションを有効にするには、次を設定する必要があります。
|
特定の日付範囲内に変更されたファイルをチェック | このオプションが選択されている場合、対象とする日付範囲を指定します。指定された範囲内に変更または追加されたファイルがチェックされます。 |
最近 n 日間に変更されたファイルをチェック | このオプションが選択されている場合、対象とする日数を指定します。指定された日数内に変更または追加されたファイルがチェックされます。 |
現在のブランチと指定されたブランチの間に更新されたファイルをチェック | このオプションが選択されている場合、対象とするブランチ範囲を指定します。ユーザーのカレント ブランチと指定されたブランチの間に変更または追加されたファイルがチェックされます。ブランチ間で変更がないファイルは除外されます。以下のオプションを選択できます。
|
行レベルの設定
すべての行をチェック | デフォルトの設定です。このオプションが選択されている場合、ユーザーが選択した解析スコープ内のすべての行が対象になります。 |
---|---|
ローカルで変更された行をチェック | このオプションが選択されている場合、ローカルで変更された行だけがチェックされます。ソース管理システムの行は除外されます。このオプションを有効にするには、次を設定する必要があります。
|
次の日以降に更新された行をチェック | このオプションが選択されている場合、対象とする日付範囲を指定します。指定された範囲内に変更または追加された行がチェックされます。. |
最近 n 日間に更新された行をチェック | このオプションが選択されている場合、対象とする日数を指定します。指定された日数内に変更または追加された行がチェックされます。 |
ファイル パス フィルター
[ファイル パス フィルター] セクションを展開すると、解析に含める/除外するファイル パスのパターンを指定できます。ワークスペース/ソリューション内の相対パスを指定します。
以下のオプションを指定できます。
対象に含めるパス (ワイルドカード) | 対象に含めるファイルのカンマ区切りのリストを指定します。ワイルドカードがサポートされています(例: *.cpp、*.java、*.cs)。 |
---|---|
除外するパス (ワイルドカード) | 除外するファイルのカンマ区切りのリストを指定します。ワイルドカードがサポートされています(例: *.cpp、*.java、*.cs)。 |
[詳細] の三角形のマークを展開すると、正規表現を使用してファイル パス フィルターを設定できます。以下の設定を行うことができます。
対象に含めるパス (正規表現) | 正規表現を指定します。パターンに一致するファイルが解析対象に含められます。 |
---|---|
除外するパス (正規表現) | 正規表現を指定します。パターンに一致するファイルが解析対象から除外されます。 |
ファイル コンテンツ フィルター
[ファイル コンテンツ フィルター] セクションを展開すると、正規表現を指定し、ファイルのコンテンツに基づいて特定の種類のファイルを除外できます (例: 自動生成されたファイルなど)。
ファイル フィルターはコード ブロック フィルターより優先されます
2 つのフィルター タイプを同時に使用すると、競合が発生する可能性があります。
作成者フィルター
[作成者フィルター] セクションを展開すると、特定の作成者だけにスコープを制限することができます。scope.scontrol に true
が設定され、ソースい管理システムが設定されている場合、ソース管理システムから作成者が取得されます。 scope.xmlmap に
true
が設定され、XML マップが設定されている場合、マップから作成者が取得されます。
以下のオプションを指定できます。
作成者が所有するファイルだけを含める | このオプションを指定すると、[作成者のリスト] フィールドで指定された作成者が所有するファイルだけが対象に含められます。 |
---|---|
作成者が所有する行だけを含める | このオプションを指定すると、[作成者のリスト] フィールドで指定された作成者が所有する行だけが対象に含められます。 |
作成者のリスト | 解析対象とする作成者のカンマ区切りのリストを指定します。 |
ファイル サイズ フィルター
[ファイル サイズ フィルター] セクションを展開すると、ファイルのサイズに基づいて解析対象を制限できます。
コード ブロック オプション
[コード ブロック] オプションを展開すると、解析対象に含める/除外するコード ブロックを指定できます。
オプション
ファイル フィルターはコード ブロック フィルターより優先されます
2 つのフィルター タイプを同時に使用すると、競合が発生する可能性があります。
特定のブロック内の行だけを対象に含める | このオプションをオンにすると、[開始マーカー] および [終了マーカー] フィールドで指定したコードだけが解析対象となります。 |
---|---|
開始マーカー | 解析対象とするコード ブロックの開始マーカーを正規表現で指定します。 |
終了マーカー | 解析対象とするコード ブロックの終了マーカーを正規表現で指定します。 |
マーカーのないファイルをスキップ | このオプションをオンにすると、[開始マーカー] および [終了マーカー] フィールドで指定したパターンを含まないファイルがスキップされます。 |
[静的解析の設定] タブ
[静的解析の設定] タブをクリックし、[静的解析の有効化] チェックボックスをオンまたはオフにすると、静的解析およびフロー解析を有効または無効にできます。このタブで行った変更を保存するには、[保存] をクリックします。
詳細設定
[詳細設定] セクションを展開すると、以下のオプションを有効にできます。
- 各ルールに対してレポートされる違反数の上限を設定する
- エンジン ホストで設定された抑制を有効/無効にする
- [グローバル解析ルールをスキップ] オプションを有効にすると、グローバル データの収集と使用を防ぐことができます。
フロー解析詳細設定
[フロー解析詳細設定] セクションを展開すると、パフォーマンス、レポートの冗長性、null チェック メソッドのパラメーター化、チェック対象リソースを設定できます。
詳細については「フロー解析の設定」を参照してください。
制御フレームワークの置換の設定
[制御フレームワークの置換の設定] セクションを展開すると、実行時にインジェクト/初期化に使用するアノテーションを指定できます。アノテーションとして使用する完全修飾名のリストをカンマ区切りで入力します。
[静的解析] タブ
[静的解析] タブをクリックすると、コンフィギュレーションが使用する静的解析ルールを有効化/無効化できます。このページには、サポートされているすべてのルールが表示されます。このタブで行った変更を保存するには、[保存] をクリックします。
ルールの検索
検索バーを使用すると、特定のルールやルール カテゴリを検索できます。
[有効なルールだけを表示] オプションを有効にすると、有効なルールだけが表示されます。
ルール マップの表示
[Local Rule Map Applied] フィールドには、ルール マッピング ファイルがあるフォルダーへのパスが表示されます。表示された場所にある rulemap.xml ファイルは、すべてのローカル テスト コンフィギュレーションに適用されます (詳細については「カスタム ルールおよびマッピングのディレクトリの指定」を参照してください)。
ルールの有効化/無効化
ルールはカテゴリによって分類されています。カテゴリを展開し、テスト コンフィギュレーションで使用するルールを有効化します。
[有効化 [ルール数] ルール] または [無効化[ルール数] ルール] ボタンをクリックすると、コンフィギュレーション内のすべてのルールをすばやく有効化/無効化できます。
ルール ドキュメントの参照
ルールをクリックすると、ドキュメント パネルが開きます。
ブラウザーの新しいタブでルール ドキュメントを開くこともできます。
ブラウザーの新しいタブで有効なすべてのルールのドキュメントを開くには、次のアイコンをクリックします。
ルールのパラメータライズ
ルールがカスタマイズ可能な場合、ルールのオプション パネルでパラメーターを設定できます。ルールの設定を行うには、ルールをクリックし、[ルールのパラメーター] タブをクリックします。設定可能なオプションはルールによって異なります。
ルール マップの関連付け
テスト コンフィギュレーションと関連付けるカスタム ルール マップを選択します。
[メトリクス] タブ
[メトリクス] タブをクリックすると、解析中に収集/計算するメトリクスを有効化/無効化できます。このタブで行った変更を保存するには、[保存] をクリックします。
以下のアクションを実行できます。
- 検索フィールドにメトリクス ID を入力し、特定のメトリクスに移動します。
- [有効なルールだけを表示] オプションを有効にし、メトリクスをフィルタリングします。
- [有効化 [ルール数] メトリクス] または [無効化 [ルール数] メトリクス] をクリックし、テスト コンフィギュレーションのすべてのメトリクスを有効化/無効化します。
- 個々のメトリクスを有効化/無効化します。
- [許容範囲外の場合に静的解析違反をレポート] オプションを有効にし、メトリクスのしきい値の上限および下限を設定します。このオプションが有効な場合、[有効] 列に旗のアイコンが表示されます。
- メトリクスをクリックしてドキュメントを表示します。
[単体テスト/実行時] タブ
[単体テスト] タブまたは [実行時] タブをクリックすると、単体テストの実行およびカバレッジ データの収集を制御することができます。
単体テストの結果およびカバレッジ解析の収集を有効化/無効化できます。
DTP でのカスタム コンフィギュレーションの作成
[Parasoft] メニューの[設定] (Eclipse)、[オプション] (NetBeans) または [設定] (IntelliJ) をクリックし、[コンフィギュレーション] を選択します。
コピーするテストコンフィギュレーションを右クリックし、[DTPで複製] を選択します。
[DTP] ディレクトリにコンフィギュレーションが追加され、DTP サーバーにアップロードされます (「DTP との接続」を参照)。
- 複製したテストコンフィギュレーションを右クリックし、[編集] を選択します。
DTP にログインしていない場合、ブラウザーが開いて DTP のログイン ページが表示されます。認証情報を入力してログインします。
DTP の [テスト コンフィギュレーション] ページが開きます。 - テスト コンフィギュレーションのリストを開きます。複製されたコンフィギュレーションがテスト コンフィギュレーションのリストに表示されています。
- 複製されたテスト コンフィギュレーションをクリックして、設定インターフェイスを開きます。DTP でテスト コンフィギュレーションをカスタマイズする方法の詳細については、DTP のマニュアルを参照してください。