Share via


コード チャーン Excel レポート

コード チャーン レポートを使用すると、時間の経過に伴ってソース ファイルがどのように変化しているかを分析できます。このレポートは、過去 4 週間にチームが追加、削除、または変更を行ったコードの行の数を示します。

このレポートにアクセスする方法については、「Excel レポート (アジャイル)」を参照してください。

[!メモ]

コード チャーン レポートは、品質ダッシュボードから表示できます。このダッシュボードにアクセスできるのは、チーム プロジェクト ポータルが有効化され、Microsoft Office SharePoint Server 2007 を使用するようにプロビジョニングされている場合だけです。詳細については、「チーム プロジェクト ポータルまたはプロセス ガイダンスへのアクセス」を参照してください。

このトピックの内容

関連トピック

  • レポートのデータ

  • レポートの解釈

  • レポートのカスタマイズ

必要なアクセス許可

レポートを表示するには、チーム プロジェクトの SharePoint 製品に対する [読み取り] アクセス許可が割り当てられているグループに割り当てられているか、そのグループに属している必要があります。

レポートを変更またはカスタマイズするには、SQL Server Analysis Services の TfsWarehouseDataReaders セキュリティ ロールのメンバーである必要があります。また、チーム プロジェクトの SharePoint 製品に対する [メンバー] アクセス許可が割り当てられているグループに割り当てられているか、そのグループに属している必要があります。詳細については、「Visual Studio ALM 用データ ウェアハウスのデータベースへのアクセスの許可」および「アクセス許可の管理」を参照してください。

レポートのデータ

チームは、コード チャーン レポートで、コード ベースの揮発性および前の週に変更されたコードの行の数を確認できます。次の図が示すように、レポートには、チームが過去 4 週間に追加、削除、または変更を行ったコードの行の積み上げ面グラフが表示されます。

コード チャーン レポート

このレポートは、コードの変更としてキャプチャされ、データ ウェアハウスに格納された過去 4 週間以内のデータを示すピボットグラフ レポートに基づいています。すべての行 (コメント行または空白行を含む) がカウントされます。

Dd695782.collapse_all(ja-jp,VS.110).gifコード チャーンの追跡に必要なアクティビティ

正確で効果的なコード チャーン レポートが生成されるようにするためには、チーム メンバーは次のアクティビティを実行する必要があります。

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

    詳細については、「Configuring Your Build System」を参照してください。

  • ビルド定義の作成。いくつかのビルド定義を作成し、各ビルド定義を実行して別のプラットフォームのコードを生成できます。また、別の構成で各ビルドを実行することもできます。

    詳細については、「ビルド処理の定義」を参照してください。

  • ビルドの一部として自動的に実行するテストの定義。ビルド定義では、ビルドの一部としてテストを実行し、テストに失敗した場合はビルドが失敗するように定義できます。

    詳細については、「既定テンプレートに基づくビルド プロセスの定義」を参照してください。

  • コード カバレッジ データを収集するテストの設定。コード カバレッジ データをレポートに表示するために、チーム メンバーはテストをインストルメントしてそのデータを収集する必要があります。

    詳細については、「テスト設定を使用したコード カバレッジの構成は使用されなくなりました」および「How to: Gather Code-Coverage Data with Generic Tests」を参照してください。

  • ビルドの定期的な実行。ビルドは、設定された間隔で、またはチェックインが行われるたびに実行できます。スケジュール トリガーを使用すると、定期的なビルドを作成できます。

    詳細については、「ビルド定義の作成」および「ビルドの実行、監視、管理」を参照してください。

    [!メモ]

    チーム メンバーはビルド エクスプローラーを使用してビルドを手動で評価することができますが、この評価はビルド品質指標レポートには反映されません。ビルド評価は、ビルドの概要レポートに表示されます。詳細については、「完了したビルドの品質の評価」および「ビルドの概要レポート」を参照してください。

レポートの解釈

コード チャーンは、プロジェクトで発生している変更の量を数値化するのに効果的な手段です。一般に、コード チャーンが高レベルであれば、そのプロジェクトが安定していないことを示します。製品サイクルの開始時や、チームが多くの変更を実装した場合は、コード チャーンが高い値を示すことが予想されます。イテレーションの終了に向けて、またはリリースまでには、コード チャーンのレベルは下がっていくことが予想されます。これは、プロジェクトが以前よりも安定してきていることを示します。

コード チャーン レポートでは、次の事項を確認できます。

  • チームはどの程度の分量のコードをテストしているか。

  • チームがテストしているコードの分量は十分であるか。

  • コード カバレッジ メトリックおよびテスト メトリックに基づいてチームは目標を達成できそうか。

コード チャーンが品質に与える影響の詳細については、「品質のダッシュボード (アジャイル)」を参照してください。

レポートのカスタマイズ

コード チャーン レポートは、Office Excel で開いて、ピボットテーブル レポートのフィルター オプションまたは列フィールド リストを変更することでカスタマイズできます。このレポートは、次の表に示すようなその他のビューをサポートするように変更できます。

ビュー

アクション

イテレーションのコード チャーン

Iteration のフィルターを変更します (既定 = すべて)。

製品区分のコード チャーン

Area のフィルターを変更します (既定 = すべて)。

過去 6 週間、8 週間、またはそれ以上の期間のコード チャーン

列の [ピボットテーブルのフィールド リスト] で、@@Last 4 weeks@@ を別の Set に置き換えます。

ピボットテーブル レポートおよびピボットグラフ レポートの使用とカスタマイズの方法の詳細については、Microsoft Web サイトの次のページを参照してください。

参照

概念

品質のダッシュボード (アジャイル)

ビルド品質指標レポート

その他の技術情報

Excel レポート (アジャイル)