“生成摘要”报表
“生成摘要”会列出各个生成并提供有关每个生成的测试结果、测试覆盖率、代码改动和质量说明的信息。
有关如何访问,刷新或管理报表的信息,请参见报表 (Agile)。
备注
此报告要求已使用 SQL Server Reporting Services 配置包含您的团队项目的团队项目集合。当打开团队资源管理器并展开您的团队项目节点时,如果未显示 “报告”,则此报告不可用。
主题内容
|
此报表可用于回答以下问题:
|
所需权限
若要查看报表,您必须被分配到或属于某个组,而该组已经在 Reporting Services 中被赋予**“Browser”**角色。 有关更多信息,请参见向团队项目中添加用户或管理权限。
报表中的数据
“生成摘要”报表中显示的数据派生自数据仓库。 此报表会以可视方式显示通过测试的百分比、要测试的代码以及多个生成间的代码更改。
除了最新生成以及连续或频繁的生成,您还可以查看手动和自动生成的结果。 此报表首先列出最新生成,并基于为报表指定的筛选器,包含在指定时间间隔内为已运行的所有生成捕获的生成结果。
您可一目了然地确定在所查看时间段内的多个生成定义的成功或失败情况,如下图所示。
下表说明为每个质量指示器显示的信息:
质量指示器 |
说明 |
---|---|
生成进度 |
指定生成的状态。 生成可以处于以下状态之一:
|
生成质量 |
指定对生成质量手动分配的评估。 可以添加或移除为团队项目定义的生成质量。 有关更多信息,请参见添加或移除生成质量值。 如果尚未对生成质量评级,则该列为空。 |
通过测试百分比 |
显示一个水平堆积条形图,并在绿色条上以叠加方式列出已通过测试的百分比。 剩余条段为红色,指示未通过测试的百分比。 图表的总长度始终等于列宽。 |
代码覆盖率百分比 |
显示一个水平堆积条形图,并在绿色条上以叠加方式列出已覆盖代码的百分比。 剩余条段为淡蓝色,指示生成中未测试的代码百分比。 图表的总长度始终等于列宽。 |
代码改动百分比(行) |
显示一个水平条形图,并在灰色条上以叠加的方式显示代码改动的百分比。 代码改动的计算方式是:确定团队已添加、删除或修改的代码行数,然后除以生成中的总行数。 条长度与百分比数字成正比,可随报表缩放,因此所有生成的最大代码改动量等于列宽。 |
可通过以下方法筛选“生成摘要”报表:
更改报表的开始和结束日期。
通过指定要包括在报表中的平台、配置、生成定义、生成质量或生成进度来筛选生成定义。
有关更多信息,请参见此主题后面的筛选报表。
必需的生成管理活动
为了使“生成摘要”报表有用,团队成员必须执行以下活动来管理生成:
配置生成系统。 若要使用 Team Foundation Build,必须设置生成系统。
有关更多信息,请参见Configuring Your Build System。
创建生成定义。 您可创建数个生成定义,可运行其中的每个生成定义为不同平台生成代码。 此外,还可以针对不同配置来运行每个生成。
有关更多信息,请参见定义生成过程。
定义要随生成自动运行的测试。 在生成定义中,您可以定义随生成运行的测试,还可以将测试通过定义为生成成功的必要条件。
有关更多信息,请参见定义基于默认模板的生成过程。
配置测试,使其收集代码覆盖率数据。 为了使代码覆盖率数据显示在报表中,团队成员必须设置测试以收集该数据。
有关更多信息,请参见使用测试设置的代码覆盖率已弃用和How to: Gather Code-Coverage Data with Generic Tests。
定期运行生成。 可按设置的时间间隔或在每次签入之后运行生成。 您可在使用时间表触发器时安排定期生成。
有关更多信息,请参见创建生成定义和运行、监视和管理生成。
(可选)对已完成的生成进行评级。 团队成员可使用生成资源管理器对生成进行手动评级。
有关更多信息,请参见对已完成生成的质量进行评级。
设置迭代的持续时间
若要了解团队在当前迭代中的进度,必须将报表的开始和结束日期设置为与当前迭代周期的开始和结束日期相符。
更改迭代的持续时间
在**“迭代开始(日期)”或“迭代结束(日期)”**旁,单击日历图标,然后单击一个日期。
单击**“查看报表”**。
解释报表
可以查看“生成摘要”报表以回答有关最新生成的问题。 与“每日生成结果”报表相比,此报表包含的信息更多。
报表回答的问题
可以使用此报表找到以下问题的答案:
一段时间内所有生成的状态如何?
哪些生成已成功?
哪些生成对代码进行了大量更改?
哪些生成已经可以安装?
测试执行了多少代码?
“生成摘要”报表不指示问题原因,但指出可以查看哪些内容,以确定问题的根源。 此报表也不指示生成问题的大小或重要性。
正常的报表版本
正常的“生成摘要”报表会显示以下指示性特征:
大多数生成都通过。
大多数测试都通过。
代码覆盖率很高。
代码改动显示的峰值很少。
不正常的报表版本
不正常的“生成摘要”报表版本将显示以下一个或多个指示性特征。 您可能需要根据以下指南进行调查:
许多生成失败。 调查生成失败的原因。
许多测试未通过。 调查并修复未通过的测试。
代码覆盖率大多为蓝色。 您可能需要编写更多自动测试。
代码改动显示峰值。 您可能需要验证是否有异常峰值。
筛选报表
可通过以下方法筛选“生成摘要”报表:
更改报表的开始和结束日期。
通过指定要包括在报表中的平台、配置、生成定义、生成质量和生成进度来筛选出现在报表中的生成集。
备注
您可以将生成定义配置为不运行测试、运行某些测试或运行所有测试。根据生成定义的配置,报表会有很大不同。
下图显示了可用的筛选器:
您必须按以下过程指定的顺序来应用筛选器。 某些筛选器的可用选项取决于之前设置的筛选器。
筛选报表中显示的生成
在**“平台”**列表中,选中要包括的每个平台对应的复选框。
在**“配置”**列表中,选中要包括的每个配置对应的复选框。
在**“生成定义”**列表中,选中要包括的每个生成定义对应的复选框。
在**“生成质量”**列表中,选中要包括的每个生成质量对应的复选框。
在**“进度”**列表中,选中要包括的每个生成进度对应的复选框。
单击**“查看报表”**。