このセクションの内容:
カバレッジ データの保存
カバレッジ データはかなりの容量を消費します。容量を節約するために、DTP はデフォルトで最後の 2 つのビルドのカバレッジ データを保管します。フィルター中の古いビルドのデータは定期的なデータベースの最適化の際に削除されます。最適化されたビルドをウィジェットの設定時に選択した場合、以下のメッセージが表示されます。
「データがありません。ターゲット ビルドに詳細データがありません。」
テストとカバレッジの保管設定をカスタマイズする方法については「データの保存期間の設定」を参照してください。
カバレッジ データの保存設定は、次のウィジェットには適用されません。
アプリケーション カバレッジのサポート
アプリケーション カバレッジを収集している場合、ランタイム カバレッジ データのみが DTP に送信され、対応する静的カバレッジ データは送信されないことがあります。このような場合、カバレッジ ウィジェットは可能な限り多くの情報を表示しようとします。使用例には次の 2 つがあります: アプリケーション カバレッジの詳細については、以下を参照してください。
カバレッジ - パーセント
このウィジェットは、ビルドの行カバレッジのパーセンテージを表示します。ウィジェットは、最新のビルドまたはベースライン ビルド (ロックされたビルド) のいずれかのカバレッジを表示できます。詳細については「ビルドのロックとアーカイブ」を参照してください。
ウィジェットの構成
| タイトル | デフォルトのタイトルの代わりにダッシュボードに表示する新しいタイトルを入力します。 |
|---|---|
| フィルター | [ダッシュボード設定] を選択してダッシュボード フィルターを使用するか、メニューからフィルターを選択します。 |
| カバレッジ イメージ | メニューからカバレッジ イメージを選択して、ウィジェットにカバレッジ データを表示します。「カバレッジ イメージとフィルターの関連付け」を参照してください。 |
| ターゲット ビルド | 比較のための現行データとするビルドをメニューから選択します。 |
アクション
ウィジェットをクリックすると、ビルドとフィルターでフィルタリングされたカバレッジ エクスプローラーが開きます。詳細については「カバレッジ エクスプローラー」を参照してください。
カスタム ダッシュボード プロパティ
ダッシュボード定義 JSON ファイルで以下のプロパティを指定して、カスタム ダッシュボード プロパティにこのウィジェットを追加できます (詳細については「カスタム ダッシュボード テンプレート」を参照)。
"name": "coverage", "type": "native", "uuid": "a12eefab-25b6-4127-9ad6-a472208142b4"
カバレッジ - サマリーの傾向
このウィジェットは、選択したフィルターについて以下の情報を表示します。
- 現在のカバレッジ率のレベル
- 前日からのカバレッジの変化 ( [期間] の設定から取得)
- ベースライン ビルドからターゲット ビルドまでのカバレッジの変化を示す折れ線グラフ
ウィジェットの構成
| タイトル | デフォルトのタイトルの代わりにダッシュボードに表示する新しいタイトルを入力します。 |
|---|---|
| フィルター | [ダッシュボード設定] を選択してダッシュボード フィルターを使用するか、メニューからフィルターを選択します。 |
| 期間 | ダッシュボード設定を選択してダッシュボードの日付範囲を使用するか、メニューから期間を選択します。 |
| カバレッジ イメージ | メニューからカバレッジ イメージを選択して、ウィジェットにカバレッジ データを表示します。「カバレッジ イメージとフィルターの関連付け」を参照してください。 |
| ベースライン ビルド | メニューからビルドを選択して比較のための初期データを設定します。 |
| ターゲット ビルド | 比較のための現行データとするビルドをメニューから選択します。 |
アクション
- ウィジェットをクリックすると、カバレッジ エクスプローラーが表示されます (「カバレッジ エクスプローラー」を参照)。
- 折れ線グラフ上にマウス ポインターを置くと、レポートされたビルドのカバレッジが表示されます。
カスタム ダッシュボード プロパティ
ダッシュボード定義 JSON ファイルで以下のプロパティを指定して、カスタム ダッシュボード プロパティにこのウィジェットを追加できます (詳細については「カスタム ダッシュボード テンプレート」を参照)。
"name": "coverage", "type": "native", "uuid": "bfd6867c-81b8-40f1-ba01-6b3af8914ac1"
カバレッジ - 傾向
このウィジェットは、指定された期間におけるカバレッジの変化を表示します。グラフの線がない箇所は、カバレッジ情報がないビルドを表します。
ウィジェットの構成
| タイトル | デフォルトのタイトルの代わりにダッシュボードに表示する新しいタイトルを入力します。 |
|---|---|
| フィルター | [ダッシュボード設定] を選択してダッシュボード フィルターを使用するか、メニューからフィルターを選択します。 |
| 期間 | ダッシュボード設定を選択してダッシュボードの日付範囲を使用するか、メニューから期間を選択します。 |
| カバレッジ イメージ | ドロップダウン メニューからカバレッジ イメージを選択して、ウィジェットにカバレッジ データを表示します。「カバレッジ イメージとフィルターの関連付け」を参照してください。 |
アクション
以下の操作を行うことができます。
- ウィジェットをクリックすると、カバレッジ エクスプローラーが表示されます。「カバレッジ エクスプローラー」を参照してください。
- グラフ上にマウス ポインタを置くと、そのビルドのカバレッジが表示されます。
カスタム ダッシュボード プロパティ
ダッシュボード定義 JSON ファイルで以下のプロパティを指定して、カスタム ダッシュボード プロパティにこのウィジェットを追加できます (詳細については「カスタム ダッシュボード テンプレート」を参照)。
"name": "coverage", "type": "native", "uuid": "31e7cb3c-1319-4d33-8157-8118771ee3f1"
Jenkins Cobertura カバレッジ - パーセント
このウィジェットは、Jenkins の Cobertura プラグインがレポートした指定のジョブについて、コード カバレッジ率、カバーされたコードの行数、およびコードの総行数を表示します。このウィジェットを適切に動作させるには、Jenkins API が英語を返す必要があります。
このウィジェットは DTP Enterprise ライセンスを必要とします。
詳細については Parasoft 製品カスタマー センター ([email protected]) にお問い合わせください。
ウィジェットの構成
| タイトル | デフォルトのタイトルの代わりにダッシュボードに表示する新しいタイトルを入力します。 |
|---|---|
| Jenkins サーバー | Jenkins サーバーの URL を入力します。プロトコル (HTTP、 HTTPS) とポートを含めます。このフィールドは必須です。 |
| Jenkins ジョブ | ジョブ名を指定します。このフィールドは必須です。 |
| Jenkins ユーザー | (オプション) Jenkins サーバーにアクセスするユーザーの名前を指定します。ユーザーはプロジェクトにアクセスできなければなりません。 特定ユーザーのログインを提供しない場合、Jenkins ベースのウィジェットが正常に動作するには、匿名の読み取りアクセスを Jenkins サーバーが許可する必要があります。 |
| Jenkins 認証 | (オプション) Jenkins サーバーにアクセスするユーザーのパスワードを指定します。ユーザーはプロジェクトにアクセスできなければなりません。 特定ユーザーのログインを提供しない場合、Jenkins ベースのウィジェットが正常に動作するには、匿名の読み取りアクセスを Jenkins サーバーが許可する必要があります。 |
アクション
ウィジェットをクリックすると、新しいウィンドウに Jenkins のコード カバレッジ情報が表示されます。
カスタム ダッシュボード プロパティ
ダッシュボード定義 JSON ファイルで以下のプロパティを指定して、カスタム ダッシュボード プロパティにこのウィジェットを追加できます (詳細については「カスタム ダッシュボード テンプレート」を参照)。
"name": "test.jenkins_cobertura_coverage" "type": "native", "uuid": "b9a1c83e-652b-458c-8eb3-e0159f6083be"
Jenkins Cobertura - サマリー
このウィジェットは、Jenkins の Cobertura プラグインがレポートした指定のジョブについてのコード カバレッジ率を表示します。カバーされたコードの行数、コードの総行数、および最後の実行のビルド ID が含まれます。このウィジェットを適切に動作させるには、Jenkins API が英語を返す必要があります。
このウィジェットは DTP Enterprise ライセンスを必要とします。
詳細については Parasoft 製品カスタマー センター ([email protected]) にお問い合わせください。
ウィジェットの構成
| タイトル | デフォルトのタイトルの代わりにダッシュボードに表示する新しいタイトルを入力します。 |
|---|---|
| Jenkins サーバー | Jenkins サーバーの URL を入力します。プロトコル (HTTP、 HTTPS) とポートを含めます。このフィールドは必須です。 |
| Jenkins ジョブ | ジョブ名を指定します。このフィールドは必須です。 |
| Jenkins ユーザー | (オプション) Jenkins サーバーにアクセスするユーザーの名前を指定します。ユーザーはプロジェクトにアクセスできなければなりません。 特定ユーザーのログインを提供しない場合、Jenkins ベースのウィジェットが正常に動作するには、匿名の読み取りアクセスを Jenkins サーバーが許可する必要があります。 |
| Jenkins 認証 | (オプション) Jenkins サーバーにアクセスするユーザーのパスワードを指定します。ユーザーはプロジェクトにアクセスできなければなりません。 特定ユーザーのログインを提供しない場合、Jenkins ベースのウィジェットが正常に動作するには、匿名の読み取りアクセスを Jenkins サーバーが許可する必要があります。 |
アクション
ウィジェットをクリックすると、新しいウィンドウに Jenkins のコード カバレッジ情報が表示されます。
カスタム ダッシュボード プロパティ
ダッシュボード定義 JSON ファイルで以下のプロパティを指定して、カスタム ダッシュボード プロパティにこのウィジェットを追加できます (詳細については「カスタム ダッシュボード テンプレート」を参照)。
"name": "Jenkins Cobertura - Summary", "type": "native", "uuid": "86ee93c1-58d3-4ca7-89d7-cda9b095478c"
Modified Coverage - パーセント
このウィジェットは、コードの変更 (機能の実装など) に関連するテスト スコープを削減するのに役立ちます。カバーされなかったコードにテスターが集中できるため、テストが効率化されます。また、テストされていない変更に関連するリスクの追跡記録を管理する上でも役立ちます。Modified Code Coverage は次のアクションを実行します。
- ファイル変更に関連するカバレッジ データを分析します
- 変更されたファイルのコード行を特定します
- まだカバーされていない新しい/変更されたコード行の中で、どの行がカバー可能かをレポートします
アーティファクトは、ベースライン ビルド以降に変更されたコード行のカバレッジ率をレポートするウィジェットとして実装されます。また、新規または変更された各コード行で達成されたカバレッジをグラフィカルに示します。
このウィジェットは DTP Enterprise ライセンスを必要とします。
詳細については Parasoft 製品カスタマー センター ([email protected]) にお問い合わせください。
ユーザーのアップグレード
2022.1 より前のバージョンの DTP からアップグレードしていて、Process Intelligence Pack の Modified Coverage ウィジェットを使用していた場合は、インストールから古いウィジェットを手動で削除する必要があります。これを行うには、次のファイルを削除します。<DTP_DATA_DIR>/grs/plugins/widgets/coverage.modifiedCodeCoverage.def.json.
要件
- カバレッジ解析の実行からラン コンフィギュレーションを取得するよう、DTP のフィルターを少なくとも 1 つ構成する必要があります。
- 次の Parasoft ツールのテストおよびカバレッジ データがサポートされています。
- C/C++test Standard、dotTEST、および Jtest 10.4.3 以降
- C/C++test Professional 10.4.3 以降
- SOAtest 9.10.7 以降
- DTP にパブリッシュされるレポートは一貫した情報を持たなければならない適切なリソース情報がビルドの 1 つ以上のレポートにない場合、詳細レポートにカバレッジ データではなく N/A が表示されることがあります。その場合、DTP にレポートを送るコード解析ツールのソース関連の設定が適切に設定されているかどうか確認してください。詳細についてはツールのドキュメントを参照してください。
DTP からソース コードにアクセスできなければなりません。DTP をソース管理システムと統合できます。または解析の一部として DTP にソースをパブリッシュするように Parasoft コード解析ツールを設定できます。詳細については、「ソース コード ビューの設定」を参照してください。
ソースについての情報は一貫していなければならない
DTP が Parasoft 静的解析/テスト ツールのレポートからソースを読み込む場合、ツールの .properties 構成ファイル (ツールのドキュメントを参照) または DTP の共有プロジェクト設定 (「プロジェクトの Parasoft Tool 設定」を参照) で
report.dtp.publish.srcプロパティをminまたはfullに設定することで、必ずソース情報を含めるようにしてください。DTP がソース管理システムからソースを読み込む場合は、必ずscontrolおよびreport.scontrolプロパティを適切に設定してください。かい離、未完了、または一貫性のないソース情報がある場合、Modified Coverage 拡張はデータを適切に表示できません。
ビルドのロック
DTPは、データベースから大量のデータを継続的に受け取って消去します。デフォルトでは、ビルドに関連する単体テストとカバレッジ情報は、単体テストとカバレッジ情報を含むビルドが同じ DTP プロジェクトに対してさらに 2 つレポートされた後、自動的に削除されます。ベースライン データを含むビルドをロックすることで、データが削除されるのを防止できます。Modified Coverage および/または DTP 監査レポートでビルドを使用する間、ベースライン ビルド IDをロックすることを推奨します。カバレッジ データとテスト データを含むベースライン ビルドは必ずロックするべきです。詳細については「ビルドのロックとアーカイブ」を参照してください。
このウィジェットは DTP Enterprise ライセンスを必要とします。
詳細については Parasoft 製品カスタマー センター ([email protected]) にお問い合わせください。
ウィジェットの構成
| タイトル | デフォルトのタイトルの代わりにダッシュボードに表示する新しいタイトルを入力します。 |
|---|---|
| フィルター | [ダッシュボード設定] を選択してダッシュボード フィルターを使用するか、メニューからフィルターを選択します。 |
| 期間 | [ダッシュボード設定] を選択してダッシュボードの期間を使用するか、メニューから期間を選択します。 |
| ベースライン ビルド | 比較するビルドを選択します。デフォルトでは「前回のビルド」が選択されます。 |
| ターゲット ビルド | ベースライン ビルドに対して比較したいビルドを選択します。デフォルトでは「データがある最新ビルド」が選択されます。 |
デフォルトでは、ベースライン ビルドが「前回のビルド」に、そしてターゲット ビルドが「データがある最後のビルド」に設定されます。このウィジェットは、最新の 2 つのビルドを自動的に選択しますが、これらのビルドにテストとカバレッジの詳細が含まれていない場合もあります。ウィジェットを構成する際に DTP でビルド管理ページを確認し (「ビルド管理」を参照)、適切なベースライン ビルドとターゲット ビルドを使用するべきです。
このウィジェットは、ベースライン ビルドからターゲット ビルドの間にテストでカバーされた、変更されたコード行の割合を表示します。
アクション
ウィジェットをクリックすると、各ファイルのカバレッジを示す詳細レポートが表示されます。
ベースライン ビルドとターゲット ビルドの間で変更されたテスト可能なコードをハイライトするために、赤と緑が使用されます。緑は、少なくとも 1 つのテスト ケースがコードをカバーしたことを示します。赤は、コードをカバーしたテスト ケースがないことを示します。
カスタム ダッシュボード プロパティ
ダッシュボード定義 JSON ファイルで以下のプロパティを指定して、カスタム ダッシュボード プロパティにこのウィジェットを追加できます (詳細については「カスタム ダッシュボード テンプレート」を参照)。
"name": "modified_code_coverage", "type": "native", "uuid": "eeba8492-f110-4046-af7e-063cbcdf033f"
ポートフォリオ - カバレッジ統計情報
このウィジェットは、指定されたポートフォリオのフィルターのカバレッジ統計を表示します。DTP でポートフォリオを設定する方法については、「ポートフォリオの設定」を参照してください。
このウィジェットには、カバレッジの割合、カバーされた行、合計行数が表示されます。
ポートフォリオのフィルターに関連付けられているプロジェクトのメンバーである場合、そのフィルターのウィジェットにエントリが表示されます。チーム メンバーシップの詳細については「プロジェクトへのチームの追加」を参照してください。DTP のビルトイン ユーザー権限の詳細については「権限」を参照してください。
このウィジェットは DTP Enterprise ライセンスを必要とします。 詳細については Parasoft 製品カスタマー センター ([email protected]) にお問い合わせください。
ウィジェットの構成
| タイトル | デフォルトのタイトルの代わりにダッシュボードに表示する新しいタイトルを入力します。 |
|---|---|
| ポートフォリオ | メニューからポートフォリオを選択します。詳細については「ポートフォリオの設定」を参照してください。 |
| ビルド | すべてのフィルターで使用するビルド ID を入力します。ビルド ID が指定されていない場合、デフォルトで最新のビルドが使用されます。 ビルド ID の詳細については「ビルド管理」を参照してください。 |
| ビルド列の表示 | ウィジェットに [ビルド] 列を含めるには、メニューから [Yes] を選択します。[ビルド] 列には、[ビルド] フィールドで指定されたビルド ID が表示されます。 [ビルド] 列を非表示にする場合は [No] を選択します。[ビルド] 列が含まれていない場合は、[フィルター] 列のフィルターにポインタを合わせると、ビルド ID を表示できます。 ビルド ID の詳細については「ビルド管理」を参照してください。 |
| 幅 | DTP ダッシュボードは、6 列のグリッドであり、行数に制限はありません。ウィジェットの列の数を指定します。デフォルトは 3 です。 「ダッシュボードのグリッド」も参照してください。 |
| 高さ | DTP ダッシュボードは、6 列のグリッドであり、行数に制限はありません。ウィジェットの行数を指定します。デフォルトは 2 です。 「ダッシュボードのグリッド」も参照してください。 |
アクション
リンクをクリックすると、カバレッジ エクスプローラー が開き、結果が表示されます。
列ヘッダーをクリックしてデータをソートします。
カスタム ダッシュボード プロパティ
ダッシュボード定義 JSON ファイルで以下のプロパティを指定して、カスタム ダッシュボード プロパティにこのウィジェットを追加できます (詳細については「カスタム ダッシュボード テンプレート」を参照)。
"name": "portfolio.coverage_statistics", "type": "native", "id": "4cf20b98-c246-4f5e-8813-72cbaa3f1f50"
リソース グループ - 上位 10 ツリー マップ
このウィジェットは、フィルター中で最もカバレッジ率の高い上位 10 個のリソース グループを表示します。タイルはそれぞれリソース グループを表します。色が濃く大きなタイルは、カバレッジ率が高いリソース グループです。
リソース グループは、1 つの以上の ANT ファイル パターンによって定義されたリソース (ファイルおよび/またはフォルダー) の集合です。リソース グループの詳細については「プロジェクトへのリソース グループの追加」を参照してください。
このウィジェットは DTP Enterprise ライセンスを必要とします。
詳細については Parasoft 製品カスタマー センター ([email protected]) にお問い合わせください。
ウィジェットの構成
| タイトル | デフォルトのタイトルの代わりにダッシュボードに表示する新しいタイトルを入力します。 |
|---|---|
| フィルター | [ダッシュボード設定] を選択してダッシュボード フィルターを使用するか、メニューからフィルターを選択します。 |
| 期間 | ダッシュボード設定を選択してダッシュボードの日付範囲を使用するか、メニューから期間を選択します。 |
| カバレッジ イメージ | メニューからカバレッジ イメージを選択して、ウィジェットにカバレッジ データを表示します。「カバレッジ イメージとフィルターの関連付け」を参照してください。 |
| ターゲット ビルド | メニューから、参照したいデータを含むビルドを選択します。 |
アクション
タイルの上にマウス ポインタを置くと、リソース グループ名とカバレッジが表示されます。タイルをクリックすると、リソース グループについてのカバレッジ情報が カバレッジ エクスプローラー に表示されます。
カスタム ダッシュボード プロパティ
ダッシュボード定義 JSON ファイルで以下のプロパティを指定して、カスタム ダッシュボード プロパティにこのウィジェットを追加できます (詳細については「カスタム ダッシュボード テンプレート」を参照)。
"name": "Resource_Groups" "type": "native", "id": "2e096c46-3f23-4997-a1a2-664d582522e8"
リソース グループ - 上位 5 表
このウィジェットは、最もカバレッジ率が高い上位 5 個のリソース グループを表示します。設定によってこの表は昇順または降順でソートできます。
このウィジェットは DTP Enterprise ライセンスを必要とします。
詳細については Parasoft 製品カスタマー センター ([email protected]) にお問い合わせください。
ウィジェットの構成
| タイトル | デフォルトのタイトルの代わりにダッシュボードに表示する新しいタイトルを入力します。 |
|---|---|
| フィルター | [ダッシュボード設定] を選択してダッシュボード フィルターを使用するか、メニューからフィルターを選択します。 |
| 期間 | ダッシュボード設定を選択してダッシュボードの日付範囲を使用するか、メニューから期間を選択します。 |
| ターゲット ビルド | メニューから、参照したいデータを含むビルドを選択します。 |
| ソート順 | メニューから、データのソート順序を選択します。 |
| カバレッジ イメージ | メニューからカバレッジ イメージを選択して、ウィジェットにカバレッジ データを表示します。「カバレッジ イメージとフィルターの関連付け」を参照してください。 |
アクション
リソース グループ名をクリックすると、そのリソース グループのカバレッジ情報が カバレッジ エクスプローラー に表示されます。
[さらに表示] をクリックすると、リソース グループ レポート が表示されます。
カスタム ダッシュボード プロパティ
ダッシュボード定義 JSON ファイルで以下のプロパティを指定して、カスタム ダッシュボード プロパティにこのウィジェットを追加できます (詳細については「カスタム ダッシュボード テンプレート」を参照)。
"name": "Resource_Groups" "type": "native", "id": "48b9f13c-a968-484d-a69a-48a2cdf39c3f"
