ビルドの概要レポート

[アーティクル]
02/21/2013

ビルドの概要にはビルドの一覧が示され、各ビルドのテスト結果、テストカバレッジ、コードチャーン、および品質評価に関する情報が示されます。

レポートへのアクセス、レポートの更新または管理の方法については、「レポート (アジャイル)」を参照してください。

[!メモ]

このレポートを使用するには、チームプロジェクトを含むチームプロジェクトコレクションが SQL Server Reporting Services でプロビジョニングされている必要があります。このレポートは、チームエクスプローラーを開いて、チームプロジェクトノードを展開したときに [レポート] が表示されない場合は使用できません。

このトピックの内容

レポートのデータ
イテレーションの期間の設定
レポートの解釈
レポートのフィルター処理

このレポートを使用すると、次の事項を確認できます。

一定期間におけるすべてのビルドの状態
成功したビルド
コードに多数の変更が加えられているビルド
テストで実行されたコードの分量
すぐにインストールが可能なビルド

必要なアクセス許可

レポートを表示するには、Reporting Services で閲覧者ロールが割り当てられているグループに割り当てられているか、そのグループに属している必要があります。詳細については、「チームプロジェクトへのユーザーの追加」または「アクセス許可の管理」を参照してください。

レポートのデータ

ビルドの概要レポートに表示されるデータは、データウェアハウスから派生します。このレポートでは、合格したテストの割合、テストされているコード、および複数のビルド間でのコードの変更がビジュアルに表示されます。

最新のビルドや継続的なビルドまたは頻繁なビルドに加え、手動ビルドと自動ビルドの両方の結果を確認できます。このレポートでは、最初に最新のビルドが示され、レポートに指定したフィルターに従って、実行されたすべてのビルドについて指定された期間にキャプチャされたビルド結果が示されます。

次の図に示されているように、一定期間におけるレビュー対象の複数のビルド定義の成功または失敗をすぐに確認できます。

ビルドの概要レポートの例

次の表で、各品質指標で表示される情報について説明します。

品質指標	説明
ビルドの進行状態	ビルドの状態を示します。ビルドの状態は、次のいずれかになります。 [失敗]。ビルドはコンパイルに失敗したか、テストに合格しませんでした。 [一部成功]。ビルドの一部だけが正常にコンパイルされました。 [停止]。ビルドは手動で停止されました。 [成功]。ビルドは正常にコンパイルされ、テストが実行されました。
ビルドの品質評価	手動で割り当てられたビルドの品質の評価を指定します。チームプロジェクトに対して定義されているビルドの品質評価は追加または削除できます。詳細については、「ビルドの品質評価の値の追加または削除」を参照してください。ビルドの品質が評価されていない場合、列は空になります。
% テスト (成功)	合格したテストの割合を緑色の棒に重ね合わせて示す、横向きの積み上げ横棒グラフを表示します。残りの棒セグメントは、失敗したテストの割合を示す赤になります。グラフの合計の長さは、列の幅と同じになります。
% コードカバレッジ	カバーされたコードの割合を緑色の棒に重ね合わせて示す、横向きの積み上げ横棒グラフを表示します。残りの棒セグメントは、ビルドでテストされなかったコードの割合を示す明るい青になります。グラフの合計の長さは、列の幅と同じになります。
% コードチャーン (行)	コードチャーンの割合を灰色の棒に重ね合わせて示す、横向きの横棒グラフを表示します。コードチャーンは、チームが追加、削除、または変更したコードの行数をビルド内の合計行数で除算して算出されます。棒の長さは、割合を示す数値に比例し、レポート全体にスケーリングされているため、すべてのビルドにおけるコードチャーンの最大値は、列の幅と同じになります。

ビルドの概要レポートは、次の方法でフィルター処理できます。

レポートの開始日と終了日を変更します。
レポートに含めるプラットフォーム、構成、ビルド定義、ビルドの品質評価、またはビルドの進行状況を指定して、ビルド定義をフィルター処理します。

詳細については、このトピックの「レポートのフィルター処理」を参照してください。

必要なビルド管理アクティビティ

ビルドの概要レポートを有効に使用するために、チームメンバーはビルドを管理するための次のアクティビティを実行する必要があります。

ビルドシステムの設定。Team Foundation ビルドを使用するには、ビルドシステムを設定する必要があります。

詳細については、「Configuring Your Build System」を参照してください。
ビルド定義の作成。いくつかのビルド定義を作成し、各ビルド定義を実行して別のプラットフォームでコードを生成できます。また、別の構成で各ビルドを実行することもできます。

詳細については、「ビルド処理の定義」を参照してください。
ビルドの一部として自動的に実行するテストの定義。ビルド定義では、ビルドの一部としてテストを実行し、テストに失敗した場合はビルドが失敗するように定義できます。

詳細については、「既定テンプレートに基づくビルドプロセスの定義」を参照してください。
コードカバレッジデータを収集するテストの設定。コードカバレッジデータをレポートに表示するために、チームメンバーはテストをインストルメントしてそのデータを収集する必要があります。

詳細については、「テスト設定を使用したコードカバレッジの構成は使用されなくなりました」および「How to: Gather Code-Coverage Data with Generic Tests」を参照してください。
ビルドの定期的な実行。ビルドは、設定された間隔または毎チェックイン後に実行できます。スケジュールトリガーを使用すると、定期的なビルドをスケジュールできます。

詳細については、「ビルド定義の作成」および「ビルドの実行、監視、管理」を参照してください。
(省略可能) 完了したビルドの評価。チームメンバーは、ビルドエクスプローラーを使用してビルドを手動で評価できます。

詳細については、「完了したビルドの品質の評価」を参照してください。

イテレーションの期間の設定

現在のイテレーションにおけるチームの進行状況を理解するには、現在のイテレーションサイクルに合わせてレポートの開始日と終了日を設定する必要があります。

イテレーションの期間を変更するには

[イテレーション開始 (日付)] または [イテレーション終了 (日付)] の横にある予定表アイコンをクリックし、日付をクリックします。
[レポートの表示] をクリックします。

レポートの解釈

ビルドの概要レポートを確認することで、最新のビルドに関する事項を確認できます。このレポートには、一定期間内のビルド成功レポートよりも詳細な情報が含まれています。

レポートで確認できる事項

このレポートを使用すると、次の事項を確認できます。

一定期間におけるすべてのビルドの状態はどのような状態か。
成功したのはどのビルドか。
コードに多数の変更が加えられているのはどのビルドか。
すぐにインストールできるのはどのビルドか。
コードのどのくらいの部分がテストで実行されたか。

ビルドの概要レポートには問題の原因は示されませんが、問題の根本原因を確認する際に参照できる場所が示されています。また、このレポートにはビルドの問題の規模や重要度は示されません。

正常なレポート

正常なビルドの概要レポートには、次の指標が示されます。

ほとんどのビルドは合格しています。
ほとんどのテストは合格しています。
コードカバレッジが高い値を示しています。
コードチャーンはほとんど急増を示していません。

問題のあるレポート

問題のあるビルドの概要レポートには、次の問題のうち 1 つ以上が示されます。次のガイダンスに従って調べることができます。

多くのビルドが失敗している。ビルドが失敗している原因を調べます。
多くのテストが失敗している。合格できなかったテストを調べ、修正します。
コードカバレッジがほとんど青になっている。自動テストを追加で作成します。
コードチャーンが急増している。異常な急増の原因を検証します。

レポートのフィルター処理

ビルドの概要レポートは、次の方法でフィルター処理できます。

レポートの開始日と終了日を変更します。
レポートに含めるプラットフォーム、構成、ビルド定義、ビルドの品質評価、およびビルドの進行状況を指定して、レポートの対象であるビルドの一覧をフィルター処理します。

[!メモ]

ビルド定義を設定して、テストを実行しない、一部のテストのみ実行する、またはすべてのテストを実行することを指定できます。レポートは、ビルド定義の構成に応じて大きく変わります。

使用できるフィルターを次の図に示します。

ビルドの概要レポートのフィルター