过程配置 XML 元素引用
过程配置用于定义你的团队可使用 Agile 计划工具访问的默认配置和功能。 这些工具(可从 Web 门户查看)包括产品积压工作 (backlog)、冲刺 (sprint) 积压工作 (backlog)、看板和任务板。 在 Visual Studio Online 中或在本地 Team Foundation Server (TFS) 上创建团队项目时,你可使用这些工具。
配置元素指定工作项类型 (WIT)、默认列、工具使用的字段以及其他元素。 进行的主配置可通过定义过程配置 XML 定义文件的 PortfolioBacklog、RequirementBacklog 和 TaskBacklog 部分来确定将为项目组合、产品和冲刺 (sprint) 积压工作 (backlog) 显示的项。 此外,过程配置还为需要映射的所有 WIT 定义工作流状态-元状态映射。
配置和自定义团队项目的敏捷计划工具通过定义 ProcessConfiguration 文件汇总了你可以通过用户界面配置的内容和需要配置的内容。
通过 ProcessConfiguration 自定义的区域:
配置积压工作 (backlog)
|
|
若要更新过程配置,你需要导出 XML 定义文件,对该文件进行相应编辑,然后再将其导入。 可使用 witadmin 命令行工具导入和导出文件。
备注
本主题中显示的语法示例对应于 Scrum 过程模板中定义的默认分配。若要访问过程模板的最新版本,请使用过程模板管理器安装 TFS 的最新版本并下载模板。
配置积压工作 (backlog)
可以为产品积压工作 (backlog)、冲刺 (sprint) 积压工作 (backlog) 和项目组合积压工作 (backlog) 自定义以下元素:
元状态映射:将工作流状态映射到元状态。 这些映射支持显示所有 Agile 计划工具,包括看板和任务板。
快速添加面板:指定出现的 WIT 和工作项字段,以便将项快速添加到积压工作 (backlog)。
若要更改被视为积压工作 (backlog) 项或任务的工作项类型,请将它们添加到相应的类别中。 有关示例,请参阅将 Bug 添加到任务板或积压工作 (backlog) 中。
列字段:定义默认字段和列顺序。
你可以在以下示例中显示的 XML 节内配置积压工作 (backlog):
<PortfolioBacklogs>
<PortfolioBacklog category="Microsoft.EpicCategory" pluralName="Epics" singularName="Epic" workItemCountLimit="1000">
. . .
</PortfolioBacklog>
<PortfolioBacklog category="Microsoft.FeatureCategory" pluralName="Features" singularName="Feature" parent="Microsoft.EpicCategory" workItemCountLimit="1000">
. . .
</PortfolioBacklog>
</PortfolioBacklogs>
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Stories" singularName="User Story" workItemCountLimit="1000">
. . .
</RequirementBacklog>
<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" singularName="Task" workItemCountLimit="1000">
. . .
</TaskBacklog>
元素 |
描述 |
---|---|
PortfolioBacklogs |
可选。 项目组合积压工作 (backlog) 的容器元素。 |
PortfolioBacklog |
可选。 最多五个实例。 定义项目组合积压工作 (backlog) 的元状态映射、默认列和快速添加面板的容器元素。
为特性赋值,如下所述:
|
RequirementBacklog |
必需。 仅一个实例。 定义产品积压工作 (backlog) 的元状态映射、默认列和快速添加面板的容器元素。 产品积压工作 (backlog) 显示团队的积压工作 (backlog) 中的所有活动项。
|
TaskBacklog |
必需。 仅一个实例。 用于自定义冲刺 (sprint) 积压工作 (backlog) 的布局的容器元素。
|
实现说明
默认情况下,每个积压工作 (backlog) 限定为总共 1000 个工作项。 可以通过为 workItemCountLimit 特性指定值来更改此限制。
分配给 CategoryName 的值必须与为团队项目定义的类别组对应。 可以在类别的定义文件中指定类别组。
使用项目组合积压工作 (backlog) 组织积压工作 (backlog)、查看较低级别的积压工作 (backlog) 项的汇总和查看多个团队的进度。 新的和升级的团队项目包含两个项目组合积压工作 (backlog) 级别:功能和长篇故事。 最多可以添加三个附加级别。 只有顶级项目组合积压工作 (backlog) 没有指定父类别。
备注
可能需要具有高级访问权限才能执行一些项目组合积压工作 (backlog) 功能。
你的产品积压工作 (backlog)ee518933(v=vs.140).md 与你的项目计划(即团队计划交付内容的路线图)相对应。 它列出其 WIT 属于要求类别的工作项。 若要管理与默认团队项目提供的 WIT 不同的 WIT,可以将 WIT 添加到要求类别,并将工作流状态映射到元状态。
冲刺 (sprint) 或迭代积压工作 (backlog) 同时显示你和你的团队在特定冲刺 (sprint) 周期提交的一组要求,以及与这些要求相关的任务。 可使用父子链接类型将任务链接到要求。 由于这些积压工作 (backlog) 上显示的 WIT 对应于产品积压工作 (backlog) 上显示的相同类型,因此你在产品积压工作 (backlog) 上执行的许多自定义工作都将定义冲刺 (sprint) 积压工作 (backlog) 的功能。
将工作流状态映射到元状态
大多数 WIT 要求将其工作流状态映射到元状态。 工作流状态定义了工作项从首次激活或创建状态转换为已关闭或已完成状态的方式。 例如,为 Scrum 产品积压工作 (backlog) 项定义的状态定义了四种状态进度,从**“新建”、“已批准”、“已提交”到“已完成”,同时还包括第五种状态(即“已删除”**)以说明从积压工作 (backlog) 中移除且未实现的状态。
另一方面,元状态确定了 Agile 计划工具如何处理每个工作流状态。 积压工作 (backlog) 和任务板使用的主要元状态为 Proposed、InProgress 和 Complete。
通过将每个工作流状态关联到元状态,执行用于显示积压工作 (backlog) 和任务板的后台操作以帮助你了解如何正确解释每个工作项的状态。 例如,为 Scrum 产品积压工作 (backlog) 定义以下映射。
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Backlog items" singularName="Backlog item">
<States>
<State value="New" type="Proposed" />
<State value="Approved" type="Proposed" />
<State value="Committed" type="InProgress" />
<State value="Done" type="Complete" />
</States>
. . .
</RequirementBacklog >
有三类元状态:Agile、Bug 和反馈。 下表介绍了映射特性和值。
元素 |
描述 |
---|---|
State |
必需。 将工作流状态分配给元状态。
TypeName 的有效值对应于为 STATE(位于分配给类别组的 WIT 的 WORKFLOW 部分中)分配的值。 ValueName 的有效值对应于下列枚举值之一:
|
States |
指定将 WIT 工作流状态和元状态关联的 State 元素的集合。 以下父元素的必需元素:
|
自定义默认列和列顺序
可在 Columns 部分中指定要显示在每个积压工作 (backlog) 上的字段。 通过**“列选项”**对话框进行的更改会保留,直到你再次更改它们。
下面是由产品积压工作 (backlog) 的 Scrum 过程模板定义的默认配置。
<Columns>
<Column refname="Microsoft.VSTS.Common.Priority" width="400" />
<Column refname="System.Title" width="400" />
<Column refname="System.State" width="100" />
<Column refname="Microsoft.VSTS.Scheduling.Effort" width="50" />
<Column refname="System.IterationPath" width="200" />
</Columns>
元素 |
描述 |
---|---|
Columns |
指定 Column 元素的集合。 积压工作 (backlog) 元素的必需元素:PortfolioBacklog、RequirementBacklog 和 TaskBacklog。 |
Column |
指定要在积压工作 (backlog) 上显示为列的字段。
|
任务板列标题
显示在任务板上的列标题对应于为分配到任务类别的默认 WIT 分配的工作流状态。 列顺序对应于工作流转换的自然进度,从左向右移动。 若要修改列布局,你需要修改分配给任务类别的 WIT 的工作流。 必须将为任务类别中的默认任务类型定义的工作流状态分配给有效的元状态,如映射工作项类型的类别的元状态中所述。
自定义快速添加面板
你可以为任何快速添加面板添加字段。 例如,下面的示例将**“业务价值”**添加到产品积压工作 (backlog) 面板中。
该面板只显示包含在所选 WIT 的 WIT 定义的 FIELDS 部分中的字段。 例如,如果选择 Bug WIT,则仅显示标题,因为没有为 Bug 定义“业务价值”。 若要将另一个 WIT 添加到面板中,请将它添加到要求类别中,如此处所述。
以下代码对应于 Visual Studio Scrum 和 MSF for Agile 过程模板中定义的默认分配。
<AddPanel>
<Fields>
<Field refname="System.Title" />
</Fields>
</AddPanel>
元素 |
描述 |
---|---|
AddPanel |
用于指定“快速添加”体验的容器元素,显示在定义了新积压工作 (backlog) 项的面板区域内的字段。 |
Fields |
指定 Field 元素的集合。 |
Field |
指定要显示在产品积压工作 (backlog) 的面板内的工作项字段。
同一字段应显示在积压工作 (backlog) 类别中包括的每个 WIT 的工作项窗体中。 |
更改任务板上可显示的工作项的数目
出于性能原因,任务板限制为最多显示 1000 个工作项。 当你打开任务板时,所有工作项都会加载到缓存中。 限制工作项的数目可能会缩短加载时间。 可以通过为 workItemCountLimit 元素的 TaskBacklog 特性指定值来更改此限制。
例如,你可以通过指定 workItemCountLimit="800" 来减少限制:
<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" singularName="Task" workItemCountLimit="800" >
. . .
</TaskBacklog>
映射工具特定的工作项类型的元状态
为其他 WIT 类别定义元状态映射。 对于 Scrum 过程模板,这包括反馈请求和响应类别的映射。 对于 MSF Agile 和 CMMI 过程模板,它还包括 Bug 类别的映射。 (Scrum 包括要求类别中的 Bug,因此可定义 RequirementBacklog 节中的元状态映射。)
<FeedbackRequestWorkItems category="Microsoft.FeedbackRequestCategory" pluralName="Feedback Requests" singularName="Feedback Request">
<States>
<State value="Active" type="InProgress" />
<State value="Closed" type="Complete" />
</States>
</FeedbackRequestWorkItems>
<FeedbackResponseWorkItems category="Microsoft.FeedbackResponseCategory" pluralName="Feedback Responses" singularName="Feedback Response">
<States>
<State value="Active" type="InProgress" />
<State value="Closed" type="Complete" />
</States>
</FeedbackResponseWorkItems>
下表描述了用于定义工具特定的工作项类型的元状态映射的其他元素。 有关分配实际状态值和类型的信息,请参阅映射工作项类型的类别的元状态。 CategoryName 必须对应于为团队项目定义的类别。
元素 |
描述 |
---|---|
BugWorkItems |
可选。 为分配给 Bug 类别的工作项类型定义元状态映射的容器元素。 除了控制这些映射如何用于 Agile 工具的显示外,在开发人员使用“我的工作”移动 Bug 时,它们还控制团队资源管理器中“我的工作”功能更新 Bug 状态的方式。 若要了解详细信息,请参阅 ALM 开发人员生活中的一天:为用户情景编写新代码。
|
FeedbackRequestWorkItems |
必需。 不要自定义。 为分配给反馈请求类别的工作项类型定义元状态映射的容器元素。
|
FeedbackResponseWorkItems |
必需。 不要自定义。 为分配给反馈响应类别的工作项类型定义元状态映射的容器元素。
|
TestPlanWorkItems |
仅在你自定义测试计划的工作流状态并且支持从与 Visual Studio 2013.2 或更早版本一起安装的测试管理器版本连接到团队项目时需要。 为分配给测试计划类别的工作项类型定义元状态映射的容器元素。 例如:
|
TestSuiteWorkItems |
仅在你自定义测试套件的工作流状态并且支持从与 Visual Studio 2013.2 或更早版本一起安装的测试管理器版本连接到团队项目时需要。 为分配给测试套件类别的工作项类型定义元状态映射的容器元素。 例如:
|
若要映射 TestPlanWorkItems 或 TestSuiteWorkItems 的元状态,你必须将应用程序层服务器升级到 TFS 2013.3。 然后,你可以自定义测试计划和测试套件的工作流状态。
若要了解详细信息,请参阅导入和导出过程配置。
分配在 Agile 计划工具和图表中使用的字段
可以更改用于计算容量、燃尽图 (burndown chart)、预测和速度的工作项字段。 你对某个默认分配所做的任何更改都应与对用于定义和捕获该值的信息的 WIT 所做的更改对应。
例如,如果更改分配给 refname 的 type="Activity",则应包括分配给任务类别(它将捕获活动信息)的 WIT 定义中的相同字段。
<TypeFields>
<TypeField refname="System.AreaPath" type="Team" />
<TypeField refname="Microsoft.VSTS.Scheduling.RemainingWork" type="RemainingWork" format="format h" />
<TypeField refname=" Microsoft.VSTS.Common.BacklogPriority" type="Order" />
<TypeField refname="Microsoft.VSTS.Scheduling.Effort" type="Effort" />
<TypeField refname="Microsoft.VSTS.Common.Activity" type="Activity" />
<TypeField refname="Microsoft.VSTS.Feedback.ApplicationStartInformation" type="ApplicationStartInformation" />
<TypeField refname="Microsoft.VSTS.Feedback.ApplicationLaunchInstructions" type="ApplicationLaunchInstructions" />
<TypeField refname="Microsoft.VSTS.Feedback.ApplicationType" type="ApplicationType">
<TypeFieldValues>
<TypeFieldValue value="Web application" type="WebApp" />
<TypeFieldValue value="Remote machine" type="RemoteMachine" />
<TypeFieldValue value="Client application" type="ClientApp" />
</TypeFieldValues>
</TypeField>
</TypeFields>
元素 |
描述 |
---|---|
TypeFields |
必需。 指定 TypeField 元素的集合。 |
TypeField |
必需。 指定一个字段的引用名称,该字段的值支持功能区域的一类活动。 指定的字段应与你在 WIT 中用来捕获功能信息的字段对应。
仅在 type="RemainingWork" 时指定该格式。 可以为你希望在当前冲刺 (sprint) 积压工作 (backlog) 的容量栏上以及任务板上显示的 TimeUnitString 指定任意文本字符串。 对于 Agile 工具:
对于反馈请求表单: 备注 不必更改为以下 TypeField 元素进行的默认分配。这些分配对应于用于捕获分配给反馈请求类别的 WIT 中相应信息的字段。
|
TypeFieldValues |
当 TypeFieldValue 时,此元素是 type="ApplicationType" 所必需的。 指定用于反馈请求表单中的 TypeFieldValue 元素的集合。 |
TypeFieldValue |
必需。 不要自定义。 指定要显示在反馈请求表单上的应用程序类型的名称。
默认分配对应于反馈请求表单的类型定义中指定的允许值。
|
实现说明
如果你更改了 TypeFields 部分中的字段,则应在 WIT 定义中做出相应的更改。 例如,如果更改分配的字段以捕获工作 Effort,则应在产品积压工作 (backlog) 项和 Bug 的 WIT 定义中进行相同的更改(对于 Scrum)。
使用此索引可查找字段的引用名称。
分配非工作日
从容量规划工具和燃尽图进行的计算中删除非工作日。 默认 Visual Studio Online 过程和 TFS 过程模板将星期六和星期日指定为非工作日。 创建团队项目之后,每个团队可以设置其特定非工作日。
<Weekends>
<DayOfWeek>Saturday</DayOfWeek>
<DayOfWeek>Sunday</DayOfWeek>
</Weekends>
元素 |
描述 |
---|---|
DayOfWeek |
Weekends 元素的必需子元素。 指定一周中对应于非工作日的一天。
有效名称对应于一星期中每一天的英语名称:Sunday、Monday、Tuesday、Wednesday、Thursday、Friday 和 Saturday。 备注 必须以英文指定星期几,无论本地 TFS 的安装语言如何。 |
Weekends |
可选。 用于指定非工作日的容器元素。 如果你想在计算容量和燃尽图 (burndown chart) 时考虑非工作日,请指定非工作日。 |
更改工作项类型的颜色
总之,在查看基于指派给 WIT 的颜色的询问结果或积压工作 (backlog) 时可以区分 WIT。
Scrum 过程模板定义以下颜色分配。 这些颜色分配对于 Agile 和 CMMI 模板是相似的。
<WorkItemColors>
<WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="ProductBacklogItem" />
<WorkItemColor primary="FF773B93" secondary="FFEEE2F2" name="Feature" />
<WorkItemColor primary="FFFF7B00" secondary="FFFFD7B5" name="Epic" />
<WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Task" />
<WorkItemColor primary="FFCC293D" secondary="FFFAEAE5" name="Bug" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Code Review Request" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Code Review Response" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Feedback Request" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Feedback Response" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Impediment" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Shared Step" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Test Case" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Test Plan" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Test Suite" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Shared Parameter" />
</WorkItemColors>
元素 |
描述 |
---|---|
WorkItemColors |
可选。 用于指定工作项类型的颜色的容器元素。 |
WorkItemColor |
指定用于在 Web 门户中显示 WIT 的颜色。 主要颜色用于列表显示,辅助颜色用于面板显示(例如,任务板或看板)。
|
指定属性和行为
当前只能指定一个属性。 BugsBehavior 属性针对 bug 以及 Bug 类别中定义的其他 WIT 在积压工作 (backlog) 和板上的显示方式定义默认配置。 基本上,可以配置 bug 是被视为要求、任务还是不会出现在积压工作 (backlog) 和板上。 创建团队项目之后,每个团队可以设置所需行为。
<Properties>
<Property name="BugsBehavior" value="AsTasks" />
<Property name="HiddenBacklogs" value="Microsoft.EpicCategory" />
</Properties>
元素 |
描述 |
---|---|
Properties |
可选。 用于指定默认属性和行为的容器元素。 |
Property |
指定在使用新功能更新团队项目时,对新团队或现有团队进行的默认分配。 团队可以通过其团队设置选择所需的行为。 BugsBehavior 会为在积压工作 (backlog) 或板上显示 bug 来设置默认值。 HiddenBacklogs 指定对于团队处于非活动状态的积压工作 (backlog) 的类别。 BugsBehavior 的允许值对应于:
|
问题解答
问:如何自定义其他 Agile 工具功能?
**答:**某些自定义可通过用户界面执行。 其他自定义组要编辑过程配置或其他团队项目对象。 相关概述,请参阅配置和自定义团队项目的敏捷计划工具。
问:你是否想添加或更改任务板或产品积压工作 (backlog) 上显示的 WIT?
**答:**如果你已添加自定义 WIT,并希望将其添加到积压工作 (backlog) 或任务板中,则可以这样做。 不能将它们同时显示在两个位置中。 请参阅将工作项类型添加到积压工作和板了解方法。