过程配置 XML 元素参考

过程配置用于定义你的团队可使用 Agile 计划工具访问的默认配置和功能。

这些工具（通过 Team Web Access (TWA) 查看）可显示基于一组工作项集，并且这些工作项会根据对过程配置 XML 定义文件 PortfolioBacklog、RequirementBacklog 和 TaskBacklog 部分所做的配置进行筛选。 此外，过程配置为需要映射的所有工作项类型 (WIT) 定义工作流状态-元状态映射。

若要了解更多信息，请参见 配置和自定义团队项目的敏捷计划工具。

可以自定义的区域：

• 配置积压工作 (backlog) 页

  • 映射工作项类型类别的元状态

  • 自定义默认列和列顺序

  • 自定义快速添加面板

  • 更改任务板上可显示的工作项的数目

• 映射工具特定的工作项类型的元状态

• 分配在 Agile 计划工具和图表中使用的字段

• 指定周末

• 更改工作项类型的颜色

若要更新过程配置，你需要导出 XML 定义文件，对该文件进行相应编辑，然后再将其导入。 可使用 witadmin 命令行工具导入和导出文件。

备注

本主题中显示的语法示例对应于 Visual Studio Scrum 2013 过程模板中定义的默认分配。若要访问过程模板的最新版本，请使用过程模板管理器安装 TFS 的最新版本并下载模板。

配置积压工作 (backlog) 页

有三种积压工作 (backlog) 页类型：产品积压工作 (backlog)、迭代或冲刺 (sprint) 积压工作 (backlog) 和项目组合积压工作 (backlog)。 可以通过下列方式自定义每个积压工作 (backlog) 页：

• 元状态映射：将工作流状态映射到元状态。 这些映射支持显示所有 Agile 计划页，包括看板和任务板。

• 快速添加面板：指定出现的 WIT 和工作项字段，以便将项快速添加到积压工作 (backlog)。

  若要更改被视为积压工作 (backlog) 项或任务的工作项类型，请将它们添加到相应的类别中。 有关示例，请参阅将 Bug 添加到任务板或积压工作 (backlog) 中。

• 列字段：定义默认字段和列顺序。

你可以在以下示例中显示的 XML 节内配置积压工作 (backlog) 页：

<PortfolioBacklogs>
   <PortfolioBacklog category="Microsoft.FeatureCategory" pluralName="Features" singularName="Feature">
. . . 
   </PortfolioBacklog>
</PortfolioBacklogs>
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName=" Backlog items" singularName=" Backlog item">
. . . 
</RequirementBacklog>
<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" singularName="Task">
. . . 
</TaskBacklog>

元素	描述
PortfolioBacklogs	可选。 项目组合积压工作 (backlog) 页的容器元素。
PortfolioBacklog	可选。 最多五个实例。 定义项目组合积压工作 (backlog) 页的元状态映射、默认列和快速添加面板的容器元素。 <PortfolioBacklog category="PortfolioCategory" parent="ParentCategory" pluralName="PluralName" singularName="SingleName">    <States> . . . </States>    <Columns> . . . </Columns>    <AddPanel> . . . </ AddPanel> </PortfolioBacklog > 为特性赋值，如下所述： category：指定已在类别定义文件中为团队项目定义的类别名称，该团队项目包含与此积压工作 (backlog) 类型关联的 WIT。 parent：指定代表层次结构中父级项目组合积压工作 (backlog) 的类别名称。 pluralName：指定在引用与此积压工作 (backlog) 类型关联的 WIT 时使用的复数标签。 例如，情景、目标、方案或长篇故事。 singularName：指定在引用与此积压工作 (backlog) 类型关联的 WIT 时使用的单个标签。 例如，情景、目标、方案或长篇故事。
RequirementBacklog	必需。 仅一个实例。 定义产品积压工作 (backlog) 页的元状态映射、默认列和快速添加面板的容器元素。 产品积压工作 (backlog) 显示团队的积压工作 (backlog) 中的所有活动项。 <RequirementBacklog category="RequirementCategory" pluralName="PluralName" singularName="SingleName">    <States> . . . </States>    <Columns> . . . </Columns>    <AddPanel> . . . </ AddPanel> </RequirementBacklog >
TaskBacklog	必需。 仅一个实例。 用于自定义显示分配给特定迭代的工作项的页面布局的容器元素。 <TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" singularName="Task workItemCountLimit="MaximumLimit"> . . .  </TaskBacklog > 默认情况下，任务板限定为总共 500 个工作项。 可以通过为 workItemCountLimit 特性指定值来更改此限制。

实现说明

• 分配给 CategoryName 的值必须与为团队项目定义的类别组对应。 可以在类别的定义文件中指定类别组。 有关详细信息，请参阅类别 XML 元素引用。

• 使用项目组合积压工作 (backlog) 查看较低级别的积压工作 (backlog) 项的汇总和查看多个团队的进度。 新的和升级后的团队项目包含一个标记为“功能”的级别。 最多可以添加四个附加级别。

  备注

  使用项目组合页可能需要你具备高级访问权限。有关详细信息，请参阅更改访问级别。

  有关使用项目组合积压工作 (backlog) 页的信息，请参阅处理项目组合积压工作 (backlog).

• 产品积压工作 (backlog) 表示正在开发的产品的要求的列表。 积压工作 (backlog) 项与基于用于创建团队项目的过程模板的特定的工作项类型（例如，产品积压工作 (backlog) 项、用户情景或要求）对应。 如果使用不同类型的工作项，或使用两种或两种以上的工作项来获取你的要求，则可以自定义产品积压工作 (backlog) 页来支持你的使用。

  有关使用产品积压工作 (backlog) 页的信息，请参阅创建积压工作 (backlog).

• 冲刺 (sprint) 或迭代积压工作 (backlog) 页同时显示你和你的团队在特定迭代周期提交的一组要求，以及与这些要求相关的任务。 必须使用子链接类型将任务链接到要求。 由于这些页上显示的工作项类型对应于产品积压工作 (backlog) 页上显示的相同类型，因此你在产品积压工作 (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	必需。 将工作流状态分配给元状态。 <State type="TypeName" value="ValueName"/> TypeName 的有效值对应于为 STATE（位于分配给类别组的 WIT 的 WORKFLOW 部分中）分配的值。 ValueName 的有效值对应于下列枚举值之一： Agile：用于所有工作项类型。 Proposed：指示新建、未提交或未处理的工作项。 InProgress：指示已提交的或主动处理的工作项。 Complete：指示已实现的工作项。 为使看板有效，必须将至少一个工作流状态映射到 Complete 元状态。 一旦工作流状态转换为与 Complete 元状态关联的状态，关联的工作项将不会出现在积压工作 (backlog) 项页上。 但它将继续在看板上列出。 工作流状态中未映射到某个支持的元状态的工作项将不会显示在积压工作 (backlog) 或面板页上。 Bug：仅用于在 Bug 类别中已分组的工作项类型。 除 Agile 元状态外，还包含指示已解决的 Bug 的 Resolved 元状态。 备注 只能将 Resolved 元状态分配给 BugWorkItems 元素下指定的工作流状态。 反馈：仅用于反馈请求类别或反馈响应类别中已分组的工作项类型。 Requested、Received、Reviewed 和 Declined。
States	指定将 WIT 工作流状态和元状态关联的 State 元素的集合。 以下父元素的必需元素： BugWorkItems PortfolioBacklog RequirementBacklog TaskBacklog TestPlanWorkItems TestSuiteWorkItems FeedbackRequestWorkItems FeedbackResponseWorkItems

自定义默认列和列顺序

你可以添加或移除列，更改列的顺序或更改显示积压工作 (backlog) 页的页的列宽。 通过**“列选项”**对话框对页所做的更改仍保留，直到你再次更改它们。 以下代码段简单地定义了默认值列的设置和顺序。

<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) 页上显示为列的字段。 <Column refname="FieldReferenceName" width="FieldWidth" />

任务板列标题

显示在任务板页上的列标题对应于为分配到任务类别的默认 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) 页的面板内的工作项字段。 <Field refname="FieldReferenceName"/> 同一字段应显示在积压工作 (backlog) 类别中包括的每个 WIT 的工作项窗体中。

更改任务板上可显示的工作项的数目

出于性能原因，任务板限制为最多显示 500 个工作项。 当你打开任务板时，所有工作项都会加载到缓存中。 限制工作项的数目可能会缩短加载时间。 可以通过为 TaskBacklog 元素的 workItemCountLimit 特性指定值来更改此限制。

例如，你可以通过添加 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 类别的工作项类型定义元状态映射的容器元素。 除了控制这些映射如何用于 TWA Agile 计划页的显示外，在开发人员使用“我的工作”移动 Bug 时，它们还控制团队资源管理器中“我的工作”功能更新 Bug 状态的方式。 若要了解更多信息，请参见 用户情景编写新代码。 <BugWorkItems category="CategoryName" pluralName="PluralName" singularName="SingleName">    <States> . . .    </States> </BugWorkItems>
FeedbackRequestWorkItems	必需。 不要自定义。 为分配给反馈请求类别的工作项类型定义元状态映射的容器元素。 <FeedbackResponseWorkItems category="CategoryName" pluralName="PluralName" singularName="SingleName">    <States> . . .    </States> </FeedbackRequestWorkItems>
FeedbackResponseWorkItems	必需。 不要自定义。 为分配给反馈响应类别的工作项类型定义元状态映射的容器元素。 <FeedbackResponseWorkItems category="CategoryName" pluralName="PluralName" singularName="SingleName">    <States> . . .    </States> </FeedbackResponseWorkItems>
TestPlanWorkItems	仅在你自定义测试计划的工作流状态并且支持从与 Visual Studio 2013.2 或更早版本一起安装的测试管理器版本连接到团队项目时需要。 为分配给测试计划类别的工作项类型定义元状态映射的容器元素。 例如： <TestPlanWorkItems category="Microsoft.TestPlanCategory" pluralName="Test Plans" singularName="Test Plan">     <States>       <State type="InProgress" value="Design" />       <State type="InProgress" value="Testing" />       <State type="Complete" value="Signed Off" />     </States>   </TestPlanWorkItems>
TestSuiteWorkItems	仅在你自定义测试套件的工作流状态并且支持从与 Visual Studio 2013.2 或更早版本一起安装的测试管理器版本连接到团队项目时需要。 为分配给测试套件类别的工作项类型定义元状态映射的容器元素。 例如： <TestSuiteWorkItems category="Microsoft.TestSuiteCategory" pluralName="Test Suites" singularName="Test Suite">     <States>       <State type="Proposed" value="Authoring" />       <State type="InProgress" value="Testing" />       <State type="Complete" value="Completed" />     </States>   </TestSuiteWorkItems>

若要映射 TestPlanWorkItems 或 TestSuiteWorkItems 的元状态，你必须将应用程序层服务器升级到 TFS 2013.3。 然后，你可以自定义测试计划和测试套件的工作流状态。

若要了解详细信息，请参阅导入和导出过程配置。

分配在 Agile 计划工具和图表中使用的字段

可以更改用于计算容量、燃尽图 (burndown chart)、预测和速度的工作项字段。 你对某个默认分配所做的任何更改都应与对用于定义和捕获该值的信息的 WIT 所做的更改对应。

例如，如果更改分配给 type="Activity" 的 refname，则应包括分配给任务类别（它将捕获活动信息）的 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 中用来捕获功能信息的字段对应。 <TypeField refname=”FieldReferenceName” type=”NameOfType” [format="{0} TimeUnitString"] / > 仅在 type="RemainingWork" 时指定该格式。 可以为你希望在当前迭代积压工作 (backlog) 页的容量栏上以及任务板上显示的 TimeUnitString 指定任意文本字符串。 对于 Agile 计划页： Activity：用于支持活动容量功能。 指定在分配给任务类别的 WIT 中使用的同一字段。 注意：Agile 计划工具容量页中显示的值反映在项目集合实例内的所有团队项目中为该字段定义的所有值的联合。 因此，要在冲刺 (sprint) 积压工作 (backlog) 页上限制为“容量”显示的值，你必须使值匹配所有团队项目中分配给 type="Activity" 的字段。 Effort：用于计算团队速度。 指定在分配给要求类别的 WIT 中使用的同一字段，你使用此要求类别捕获实现积压工作 (backlog) 项所需的工作量的估计工作量级别、情景点或大小。 Order：用于定义积压工作 (backlog) 和任务板页上的项的排序顺序。 根据此类型的字段定义的升序顺序在页面中列出工作项。 备注 可以通过在积压工作 (backlog) 页的列表中上下拖动项来移动它们。移动项时，后台进程会更新分配给 type="Order" 的字段。 RemainingWork：用于计算剩余工作和燃尽图 (burndown chart)。 指定分配给任务类别的 WIT 中使用的同一字段，你使用任务类别捕获完成任务所剩的小时数、天数或其他度量单位。 为 format 指定的值用于任何报告了剩余工作的积压工作 (backlog) 和任务板页上。 例如，当报告逐事件容量或每个团队成员容量，或者在任务板上任务状态的列标题旁边时。 对于 TimeUnitString，指定所有要用于反映时间值（例如，小时数或天数）的文本字符串。 例如，下列元素均有效： format="{0} h" format="{0} hours" format="hours {0}" format="time {0}" Team：用于将积压工作 (backlog) 页与团队相关联。 默认值为 System.AreaPath。 若要从区域路径中分离团队，你可以指定不同的字段，如下所述自定义团队项目以支持团队字段. 对于反馈请求表单： 备注 不必更改为以下 TypeField 元素进行的默认分配。这些分配对应于用于捕获分配给反馈请求类别的 WIT 中相应信息的字段。 ApplicationStartInformation：用于捕获用于执行应用程序的路径。 ApplicationLaunchInstructions：用于捕获启动说明。 ApplicationType：用于捕获应用程序的类型。 列出的类型对应于反馈请求的 WIT 定义中指定的允许值。 若要自定义此列表，请参阅自定义选取列表。
TypeFieldValues	当 type="ApplicationType" 时，此元素是 TypeFieldValue 所必需的。 指定用于反馈请求表单中的 TypeFieldValue 元素的集合。
TypeFieldValue	必需。 不要自定义。 指定要显示在反馈请求表单上的应用程序类型的名称。 <TypeFieldValue value="ApplicationTypeName" type="TypeApp"/> 默认分配对应于反馈请求表单的类型定义中指定的允许值。 <TypeFieldValues>    <TypeFieldValue value="Web application" type="WebApp" />    <TypeFieldValue value="Remote machine" type="RemoteMachine" />    <TypeFieldValue value="Client application" type="ClientApp" /> </TypeFieldValues>

实现说明

• 如果你更改了 TypeFields 部分中的字段，则应在 WIT 定义中做出相应的更改。 例如，如果更改分配的字段以捕获工作 Effort，则应在产品积压工作 (backlog) 项和 Bug 的 WIT 定义中进行相同的更改（对于 Scrum）。

• 使用此索引可查找字段的引用名称。

分配非工作日

容量规划和燃尽图 (burndown chart) 引用非工作日。 在每个 TFS 过程模板中定义以下非工作日。

<Weekends>
   <DayOfWeek>Saturday</DayOfWeek>
   <DayOfWeek>Sunday</DayOfWeek>
</Weekends>

元素	描述
DayOfWeek	Weekends 元素的必需子元素。 指定一周中对应于非工作日的一天。 <DayOfWeek>NameOfADay</DayOfWeek> 有效名称对应于一星期中每一天的英语名称：Sunday、Monday、Tuesday、Wednesday、Thursday、Friday 和 Saturday。 备注 必须以英文指定星期几，无论 Team Foundation Server 的安装语言如何。
Weekends	可选。 用于指定非工作日的容器元素。 如果你想在计算容量和燃尽图 (burndown chart) 时考虑非工作日，请指定非工作日。 与此有关的一些注释将显示在燃尽图 (burndown chart) 中，无法删除。

更改工作项类型的颜色

总之，在查看基于指派给 WIT 的颜色的询问结果或积压工作 (backlog) 时可以区分 WIT。

在 Scrum 过程模板中定义以下颜色分配。

<WorkItemColors>
   <WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="ProductBacklogItem" />
   <WorkItemColor primary="FF773B93" secondary="FFEEE2F2" name="Feature" />
   <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" />
</WorkItemColors>

元素	描述
WorkItemColors	可选。 用于指定工作项类型的颜色的容器元素。
WorkItemColor	指定用于在 TWA 中显示 WIT 的颜色。 主要颜色用于列表显示，辅助颜色用于面板显示（例如，任务板或看板）。 <WorkItemColor primary="HexColorCode" secondary="HexColorCode" name="witName" />

问题解答

问：如何自定义 TWA 中的 Agile 计划工具中出现的其他功能？

**答：**某些自定义可通过用户界面执行。 其他自定义组要编辑过程配置或其他团队项目对象。 有关概述，请参阅配置和自定义团队项目的敏捷计划工具。

问：是否要使用两个或两个以上的项目组合积压工作 (backlog)？

**答：**默认值体验支持一个项目组合积压工作 (backlog) 级别。 你最多可添加五个级别，如下所述向敏捷项目组合管理添加积压工作 (backlog).

问：你是否想添加或更改任务板或产品积压工作 (backlog) 上显示的 WIT？

**答：**如果你已添加自定义 WIT，并希望将其添加到积压工作 (backlog) 或任务板中，则可以这样做。 不能将它们同时显示在两个位置中。 通过阅读以下部分了解操作方式：向积压工作 (backlog) 或任务板添加 Bug。

问：是否要查看用于导入和导出过程配置的工作示例？

**答：**下面提供了一个示例：导入和导出过程配置 [witadmin].