进程配置 XML 元素参考

处理配置文件确定以下功能的布局和功能: 产品积压工作和团队速度、 迭代积压工作、团队容量和燃尽图、 任务。、 利益干系人反馈和 我的工作。可以从团队项目或访问导出这些配置文件， AgileConfiguration 和 CommonConfiguration，它们在您从 Visual Studio Team Foundation Server 2012下载的过程模板。通过修改在 AgileConfiguration 指定的定义自定义积压工作页的布局，因此，您自定义区域常见到多个功能通过修改在 CommonConfiguration 指定的定义。

有关可自定义功能的概述，请参见 使用进程配置自定义积压工作和板页。

说明
有关团队如何使用积压工作和任务键盘页，请参见 敏捷规划和迭代。

本主题

• AgileConfiguration:语法结构和组件

• CommonConfiguration:语法结构和组件

AgileConfiguration:语法结构和组件

通过修改在 AgileProjectConfiguration 元素中包含的元素自定义积压工作页。若要自定义产品积压页，修改在 ProductBacklog 元素内的元素，并且，自定义 " 迭代积压页，修改在 IterationBacklog 元素中包含的元素。

下面的 XML 的示例演示了定义敏捷过程在 AgileConfiguration.xml 文件中包含配置的代码结构。此示例对应于敏捷软件开发的 MSF v6.0 定义默认值的语法。

<?xml version="1.0" encoding="utf-8"?>
<AgileProjectConfiguration>
  <ProductBacklog>
    <Columns>
      <Column refname="System.Title" width="400" />
      <Column refname="System.State" width="100" />
      <Column refname="Microsoft.VSTS.Scheduling.StoryPoints" width="50" />
      <Column refname="System.IterationPath" width="200" />
    </Columns>
    <AddPanel>
      <Fields>
        <Field refname="System.Title" />
      </Fields>
    </AddPanel>
  </ProductBacklog>
  <IterationBacklog>
    <Columns>
      <Column refname="Microsoft.VSTS.Scheduling.StoryPoints" width="50" />
      <Column refname="System.Title" width="400" />
      <Column refname="System.State" width="100" />
      <Column refname="System.AssignedTo" width="100" />
      <Column refname="Microsoft.VSTS.Scheduling.RemainingWork" width="50" />
    </Columns>
  </IterationBacklog>
</AgileProjectConfiguration>

返回页首

积压页的 XML 元素

下表描述 AgileProjectConfiguration 根元素的子元素。可以使用这些元素指定应出现在积压工作页的列和字段。

元素	说明和语法	注释
AddPanel	用于的容器元素指定 “quick 添加”体验，字段在新积压工作项定义的面板区域内出现。 <AddPanel>     <Fields>        <Field . . . />        . . .    </Fields> </AddPanel>	必需。只有一个实例。 必须至少指定一个 Fields 元素。 “quick 添加”体验只出现在 Team Web Access的产品积压页。
Column	指定字段显示为积压工作页的列。 <Column refname="FieldReferenceName" width="FieldWidth" />	必需。 对于每一列要显示在显示积压工作中列出的页，必须为工作项类型定义与积压工作项的字段引用名称。必须为字段指定了宽度一个正整数。
Columns	指定 Column 元素的集合。 <Columns>    <Column . . . />    . . . </Columns>	必需。一个仅实例每 IterationBacklog 和 ProductBacklog 父元素的。 您必须指定列要显示在显示产品积压工作 " 或 " 迭代积压的页。
Field	指定字段在产品积压工作页的面板内出现。 <Field refname=”FieldReferenceName” />	必需。在 Fields 父元素中包含的一个或多个元素。 在定义一个工作项添加到积压工作时，可以指定要在该配置 AddPanel 节中列出了过程的字段指定值。 ，如下面的代码示例显示，默认配置指定 标题 字段作为唯一的字段示: <AddPanel>    <Fields>       <Field refname="System.Title" />    </Fields> </AddPanel>
Fields	指定 Field 元素的集合。 <Fields> <Field . . . />    . . . </Fields>	必需。为 AddPanel 父元素只定义的一个实例。 指定要快速指定，在将项添加到产品积压工作中的字段。
IterationBacklog	用于的容器元素自定义标显示工作项分配给特定迭代页的布局。 <IterationBacklog workItemCountLimit="MaximumLimit" >    <Columns> . . . </Columns>    . . .  </IterationBacklog >	必需。只有一个实例。 您指定列数，列宽和填充这些页的每一列显示积压工作项列出分配给迭代的字段。 默认情况下，任务键盘限制提供 500 个工作项。通过指定值更改此限制 workItemCountLimit 属性。
ProductBacklog	用于的容器元素自定义显示产品积压工作，并包含添加的工作项的一个面板到积压页的布局。 <ProductBacklog>    <Columns> . . . </Columns>    <AddPanel> . . . </ AddPanel> </ProductBacklog >	必需。只有一个实例。 您指定列数，列宽和填充这些页的每一列显示积压工作项列表指派给产品积压工作的字段。产品积压工作显示于积压工作中的任何活动的项目，包括指派给迭代的问题。

返回页首

CommonConfiguration:语法结构和组件

使用 CommonProjectConfiguration 组件，则自定义任务的页，支持若干子元素。TypeFields 指定用于工作项类型获取特定信息的字段。的其他子元素，例如， RequirementWorkItems、 TaskWorkItems和 BugWorkItems 指定类别组与由特定引用处理配置功能区域的这些类型。

下面的 XML 示例演示定义常用的进程在 CommonConfiguration.xml 文件中包含配置的代码结构。此示例对应于敏捷软件开发的 MSF v6.0 定义默认值的语法。

<?xml version="1.0" encoding="utf-8"?>
<CommonProjectConfiguration>
  <TypeFields>
    <TypeField refname="System.AreaPath" type="Team" />
    <TypeField refname="Microsoft.VSTS.Scheduling.RemainingWork" type="RemainingWork" format="format h" />
    <TypeField refname="Microsoft.VSTS.Common.StackRank" type="Order" />
    <TypeField refname="Microsoft.VSTS.Scheduling.StoryPoints" 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>
  <RequirementWorkItems category="Microsoft.RequirementCategory" plural="Stories">
    <States>
      <State value="New" type="Proposed" />
      <State value="Active" type="InProgress" />
      <State value="Resolved" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </RequirementWorkItems>
  <TaskWorkItems category="Microsoft.TaskCategory">
    <States>
      <State value="New" type="Proposed" />
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </TaskWorkItems>
  <BugWorkItems category="Microsoft.BugCategory">
   <States>
        <State value="Active" type="InProgress" />
        <State value="Resolved" type="Resolved" />
        <State value="Closed" type="Complete" />
      </States> 
  </BugWorkItems>
  <FeedbackRequestWorkItems category="Microsoft.FeedbackRequestCategory" plural="Feedback Requests">
    <States>
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </FeedbackRequestWorkItems>
  <FeedbackResponseWorkItems category="Microsoft.FeedbackResponseCategory" plural="Feedback Responses">
    <States>
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </FeedbackResponseWorkItems>
  <Weekends>
    <DayOfWeek>Saturday</DayOfWeek>
    <DayOfWeek>Sunday</DayOfWeek>
  </Weekends>
</CommonProjectConfiguration>

返回页首

公共领域的 XML 元素

下表描述 CommonProjectConfiguration 元素的子元素。这些组件配置支持该页显示两个与 Team Web Access、 团队资源管理器 和反馈请求窗体区域。

重要事项
值赋给 CategoryName 必须对应于为团队项目定义的类别组。在定义文件中指定类别组类别。对于 Visual Studio ALM 最新版本，五个新类定义。有关更多信息，请参见 类别，处理配置和工作项的特定类型的禁用创建。

元素	说明和语法	注释
BugWorkItems	指定对应于 bug 工作项并将积压工作项和工作流状态与 metastates 的类别。 <BugWorkItems category=”CategoryName”>     <States>        <State . . . />        . . .    </States> </BugWorkItems	必需。CategoryName 必须对应于为团队项目定义的类别。
DayOfWeek	指定对应于非工作的日的一周。 <DayOfWeek>NameOfADay</DayOfWeek>	Weekends 元素的必需子元素。 有效名称对应于英语周: Sunday、 Monday、 Tuesday、 Wednesday、 Thursday、 Friday和 Saturday。 说明 无论 Team Foundation Server，安装的语言必须指定一周的日英语，。
FeedbackResponseWorkItems	指定对应于工作项类型用于获取反馈响应并将这些项的工作流状态与 metastates 的类别。	必需。不要自定义。 CategoryName 必须对应于为团队项目定义的类别组。
FeedbackRequestWorkItems	指定对应于工作项类型用于获取反馈请求并将这些项的工作流状态与 metastates 的类别。	必需。不要自定义。 CategoryName 必须对应于为团队项目定义的类别组。指定使用 Categories.xml 文件的类别组。
RequirementWorkItems	指定对应于积压工作项，如用户情景，要求和产品积压工作项和关联积压工作项和工作流状态与 metastates 的类别。 <RequirementWorkItems category="CategoryName" plural="NameOfBacklogItems" >    <States>       <State . . . />       . . .    </States> </RequirementWorkItems>	必需。 CategoryName 必须对应于为团队项目定义的类别组。指定使用 Categories.xml 文件的类别组。
State	分配工作流状态。 metastate。Metastates 表示分组支持工作流状态管理在任务键盘的工作流状态或其他进程配置元素。 <State type="TypeName" value="ValueName"/>	必需。 TypeName 的有效值对应于值赋给工作流中的 STATE 分别定义为的工作项类型在类别组中出现，。 ValueName 的有效值对应为以下枚举值之一:在为的工作项类型定义的工作流内类别组中出现，分别。 agile: Proposed:指示是新，则不提交或不工作的工作项。 InProgress:指示进行了或主动处理的工作项。 Complete:指示已实现工作项。 bug:除了敏捷 metastates 外，包含指示解决 bug 的 Resolved metastate。 反馈: Requested、 Received、 Reviewed和 Declined。 有关更多信息，请参见 工作流状态， metastates，和进程配置。
States	指定的 State 元素的集合关联工作项类型的工作流状态与 metastates。 <States>    <State . . . />    . . . </States>	BugWorkItems、 FeedbackResponseWorkItems、 FeedbackRequestWorkItems、 RequirementWorkItems 和 TaskWorkItems 元素的必需元素。 State 元素用于分配工作流状态。 metastates。
TaskWorkItems	指定对应于任务项并将任务工作流状态与 metastates 的类别。 <TaskWorkItems category="CategoryName">    <States>       <State . . . />       . . .    </States> </TaskWorkItems>	必需。 CategoryName 必须对应于为团队项目定义的类别组。您指定要使用的 Categories.xml 文件的类别组。 积压工作和键盘页列出对应于 States 元素中指定的状态值的那些工作项。
TypeField	指定值引用支持事件类型受支持的功能区的字段的引用名称。指定将在 TypeFields 容器元素内此元素。 <TypeField refname=”FieldReferenceName” type=”NameOfType” [format="{0} TimeUnitString"] / > 指定格式才有效，当 type="RemainingWork"。可以为要将出现在达到栏位于当前迭代积压工作页中和任务键盘的 TimeUnitString 指定任意文本字符串。	必需。您必须指定字段对应您在工作项中的类型使用获取特定信息的字段。 对积压工作和任务键盘页面: Activity:用于支持容量由事件功能。为使用指定要执行的操作类型工作项的任务类型指定中定义的字段。 Effort:指定用于的字段计算团队速度。为使用获取工作量级别或工作量的相对分级积压工作项需要实现积压工作项的类型指定中定义的字段。 Order:指定用于的字段定义积压工作项的排序顺序在迭代积压工作和任务的页。指定用于获取相对优先级分配到积压工作项的字段。工作项在页列出基于升序如定义由此类型的字段。 RemainingWork:指定用于的字段计算剩余工作和燃尽图。指定用于获取小时或天的数目完成任务所剩余的字段。 为 format 指定的值在积压工作和任务键盘使用页剩余工作 " 报表。例如，在中，当报告容量由事件或容量每个团队成员，或者在列标题旁边的任务状态的任务中则上。 对于 TimeUnitString，指定要使用反映时间值的所有文本字符串，如小时或天。 例如，下面的值都是有效的: format="{0} h" format="{0} hours" format="hours {0}" format="time {0}" Team:指定用于的字段关联积压工作和任务键盘页与团队。此字段应保持设置为其默认值， System.AreaPath。 对反馈请求形式: 说明 您不必更改为以下 TypeField 元素所做的默认指派。这些分配对应于用于的字段访问在工作项的反馈请求类型所对应的信息。 ApplicationStartInformation:指定用于的字段获取该路径执行应用程序。 ApplicationLaunchInstructions:指定用于的字段获取生成命令。 ApplicationType:指定用于的字段获取应用程序的类型。列表的类型对应于指定允许的值类型定义为反馈请求。
TypeFields	指定 TypeField 元素的集合。 <TypeFields>    <TypeField . . . />    . . . </TypeFields>	必需。 必须指定要引用支持函数显示在积压工作、任务键盘和反馈请求窗体字段的类型。
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>
TypeFieldValues	指定 TypeFieldValue 元素的集合。 <TypeFieldValues>    <TypeFieldValue . . . />    . . . </TypeFieldValues>	对 TypeFieldValue ，当 type="ApplicationType"。 必须为要显示在反馈请求窗体字段的类型指定值。
Weekends	用于的容器元素指定非工作的日。 <Weekends>    <DayOfWeek> . . . </DayOfWeek >    . . . </ Weekends >	选项。 ，如果要占用的容量和燃尽图的计算时，非工作的日指定非工作的日。

返回页首

请参见

参考

托管进程配置 witadmin []

概念

更新升级的团队项目以访问新功能

使用进程配置自定义积压工作和板页