この DTP ワークフロー アーティファクトは、ベースライン ビルドから変更されたコード行の割合をレポートし、新規または変更のコード行ごとに達成されたカバレッジをグラフィカルに表示します。ファイルの変更に関連するカバレッジ データを解析してファイルのコード行が変更されたかどうかを判断し、新規/変更のコード行について、カバーされた行とカバーされなかった行をレポートします。これは、コードの変更 (機能の実装など) に関連するテスト スコープを削減するのに役立ちます。カバーされなかったコードにテスターが集中できるため、テストが効率化されます。また、テストされていない変更に関連するリスクの追跡記録を管理する上でも役立ちます。
このセクションの内容:
要件
- Parasoft Extension Designer 5.3.3 以降
- Parasoft DTP 5.3.3 以降 (「サーバーの設定」を参照)
- DTP で以下を構成する必要があります。
- カバレッジ解析の実行からラン コンフィギュレーションを取得するよう、DTP のフィルターを少なくとも 1 つ構成する必要があります。
- DTP フィルターにカバレッジ データを送信するよう、Parasoft コード解析ツールを構成する必要があります。
DTP からソース コードにアクセスできなければなりません。DTP をソース管理システムと統合できます。または解析の一部として DTP にソースをパブリッシュするように Parasoft コード解析ツールを設定できます。詳細については、「ソース コード ビューの設定」を参照してください。
ソースについての情報は一貫していなければならない
DTP が Parasoft 静的解析/テスト ツールのレポートからソースを読み込む場合、ツールの .properties 構成ファイル (ツールのドキュメントを参照) または DTP の共有プロジェクト設定 (「プロジェクトでの Parasoft Test の設定」を参照) で
report.dtp.publish.srcプロパティをminまたはfullに設定することで、必ずソース情報を含めるようにしてください。DTP がソース管理システムからソースを読み込む場合は、必ずscontrolおよびreport.scontrolプロパティを適切に設定してください。かい離、未完了、または一貫性のないソース情報がある場合、Modified Coverage 拡張はデータを適切に表示できません。- ベースラインに対して比較を実行できるように、ベースライン カバレッジの「イメージ (ベースライン ビルド)」を DTP で設定する必要があります。詳細については次のセクションを参照してください。
定義
| DTP プロジェクト | 解析ツールがデータをレポートするルート レベル。プロジェクトにレポートされるすべてのラン コンフィギュレーションをまとめる「フィルター」があらかじめ設定されています。 |
|---|---|
| フィルター | 異なる解析実行からのデータをダッシュボード ウィジェットおよびレポートにどのように表示するかをまとめる DTP 構成。 |
| ラン コンフィギュレーション | ラン コンフィギュレーションは、一連の実行 (テスト実行および/または解析) を表します。同じ Parasoft 静的解析/テスト ツール、DTP プロジェクト、テスト コンフィギュレーション、およびセッション タグがある実行は、同じラン コンフィギュレーションにグループ化されます。ラン コンフィギュレーションは、フィルターに対して表示されるデータを絞り込むことができます。 |
| ビルド ID | 複数の解析実行を 1 つの「ビルド」に集約するために使用される解析実行メタデータ。 |
ビルドのロック
DTP は大量のデータを絶えず受け取るため、定期的にデータベースからテスト データを消去します。一般的に、ビルドに関連する単体テストとカバレッジ情報は、単体テストとカバレッジ情報を含むビルドが同じ DTP プロジェクトに対してさらに 2 つレポートされた後、自動的に削除されます。
ベースライン データを含むビルドをロックすることで、データが削除されるのを防止できます。Modified Coverage および/または DTP 監査レポートでビルドを使用する間、ベースライン ビルド IDをロックすることを推奨します。詳細については「ビルドのロックとアーカイブ」を参照してください。
カバレッジ データとテスト データを含むベースライン ビルドは必ずロックするべきです。
データのキャッシュ
このワークフローには、同一データに対する複数のリクエストを高速化するためのキャッシュ メカニズムがあります。データがリクエストされるとき、このスライスはまずデータがすでに計算されてキャッシュされているかを判断します。キャッシュが存在する場合、データは直接返され、時間のかかる計算はスキップされます。ただし、データがキャッシュされていない場合、キャッシュされたデータが別のビルドの組み合わせに関連付けられている場合、またはビルドの組み合わせにさらに解析データがレポートされた場合、キャッシュは消去されて再計算されます。フィルターおよびベースライン ビルドとターゲット ビルドの組み合わせごとに 1 つのキャッシュが存在します。
キャッシュの消去
このスライスは自動的にキャッシュを削除しないため、フィルターが増えるにつれてキャッシュが大きくなることがあります。古いキャッシュ データの消去を簡単にするために、このスライスには PIE データベースからすべてのキャッシュを削除する方法が用意されています。この方法は、キャッシュされた計算をすべて消去します。また、毎日 00:00 にもキャッシュを消去します。キャッシュの自動消去は、Clean Cache ノードを編集することで設定できます。
ウィジェットの構成
Untested Changes スライスを DTP にデプロイする際、プロセス インテリジェンス カテゴリの Modified Coverage – Percent ウィジェットをダッシュボードに追加することができます (「ウィジェットの追加」を参照してください)。
以下の設定を利用できます。
| タイトル | タイトル フィールドをクリックしてウィジェットの名前を変更します (オプション)。 |
|---|---|
| フィルター | [ダッシュボード設定] を選択してダッシュボード フィルターを使用するか、ドロップダウン メニューからフィルターを選択します。 |
| 期間 | [ダッシュボード設定] を選択してダッシュボードの期間を使用するか、ドロップダウン メニューから期間を選択します。 |
| ベースライン ビルド | 比較するビルドを選択します。デフォルトでは「前回のビルド」が選択されます。 |
| ターゲット ビルド | ベースライン ビルドに対して比較したいビルドを選択します。デフォルトでは「データがある最新ビルド」が選択されます。 |
正しいビルドを取得するためにビルド管理をチェックする
このウィジェットは、ベースライン ビルドからターゲット ビルドの間にテストでカバーされた、変更されたコード行の割合を表示します。
ウィジェットをクリックすると、各ファイルのカバレッジを示す詳細レポートが表示されます。
ベースライン ビルドとターゲット ビルドの間で変更されたテスト可能なコードをハイライトするために、赤と緑が使用されます。緑は、少なくとも 1 つのテスト ケースがコードをカバーしたことを示します。赤は、コードをカバーしたテスト ケースがないことを示します。
DTP にパブリッシュされるレポートは一貫した情報を持たなければならない
適切なリソース情報がビルドの 1 つ以上のレポートにない場合、詳細レポートにカバレッジ データではなく N/A が表示されることがあります。 その場合、DTP にレポートを送るコード解析ツールのソース関連の設定が適切に設定されているかどうか確認してください。詳細についてはツールのドキュメントを参照してください。
