自定义任务板页

项目
02/21/2013

您可以自定义 Team Web Access 任务键盘指定工作项的不同类型和增加的工作项的数量显示在页。例如，除了将显示任务外在任务键盘，您可能希望将bug。任务键盘，您的团队可更新工作项并报告进度。中显示的工作项包括指派给当前迭代及其父项目的所有任务，无论父分配的迭代。若要了解有关使用任务键盘，请参见运行迭代。

如果您的团队项目已使用创建过程模板除了 Visual Studio Application Lifecycle Management (ALM) 提供的参数以外或您自定义工作项类型定义或修改了其工作流，您可能需要自定义一个定义文件提供用于处理配置。

主题内容

工作显示在任务键盘页的项目类型
列标题和列顺序
排序积压工作项的顺序。
可以在任务键盘页项的数目

要求

若要运行 witadmin 命令行工具，您必须是 *** Team Foundation Administrators *** 组的成员或 *** 项目管理员 *** 项目的组的成员。有关更多信息，请参见Team Foundation Server 权限。
若要查看任务键盘页，您必须将团队Web访问权限。标准。可能还有其他许可证要求。有关更多信息，请参见对 Team Web Access 中的功能的访问权限。

工作显示在任务键盘页的项目类型

下列元素来确定哪些工作项显示在任务键盘页。

积压工作项对应的工作项类型指派给要求类别。已分配给当前迭代或对任务分配给当前迭代仅的积压工作项显示在任务键盘。它们可以在所有工作流状态。
可以添加为子任务到积压工作项的任务项对应于工作项类型的任务分配类别。

已分配给当前迭代仅的任务是否显示在任务键盘。

任务显示在其工作流状态下一列标题。在拖放从一个列的任务到另一个，将自动更新状态字段。

说明
如果您将某个工作项类型添加到任务类，请确保添加用于跟踪的工作项类型的定义的字段。

若要指定任务的类型中显示的工作项

若要运行 witadmin 命令行工具，请打开 Visual Studio 或团队资源管理器安装的命令提示符窗口并enter:
```
cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE
```
在 64 位 Windows 版本上，将 %programfiles% 替换为 %programfiles(x86)%。
键入以下命令，将您的数据替换为显示此处的参数，其中 CollectionURL 指定团队项目集合的URL，ProjectName 指定在集合中定义的团队项目的名称，并且，DirectoryPath 指定名称和位置以文件中导出。然后选择 *** 输入 ***。
```
witadmin exportcategories /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\categories.xml"
```
打开在记事本中的类文件，并将 "Task Category"的 CATEGORY 元素。
若要将工作项的新类型，添加指定另一个工作项类型的友好名称要添加的一个 WORKITEMTYPE 元素。

例如，以下语法添加“Bug”工作项类型为使用敏捷过程模板的团队项目的任务类别。
```
<CATEGORY name="Task Category" refname="Microsoft.TaskCategory">
   <DEFAULTWORKITEMTYPE name="Task" />
   <WORKITEMTYPE name="Bug" />
</CATEGORY> 
```
提示

您必须指定的工作项类型为团队项目定义的。工作项类型可能属于多个类别。但是，不能指定的工作项类型指定了为属于要求类别。

提示
您必须指定的工作项类型为团队项目定义的。工作项类型可能属于多个类别。但是，不能指定的工作项类型指定了为属于要求类别。

键入以下命令以导入定义文件:

witadmin importcategories /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\categories.xml"

分配metastates到工作项的任务类型的工作流状态

从 witadmin的命令提示符窗口，键入并将您的数据的以下命令在此处说明的参数，其中 CollectionURL 指定团队项目集合的URL，ProjectName 指定在集合中定义的团队项目的名称，并且，DirectoryPath 指定名称和位置以文件中导出。然后选择 *** 输入 ***。
```
witadmin exportcommonprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\CommonConfiguration.xml"
```

打开在记事本中的CommonConfiguration文件并将 TaskWorkItems 元素。

例如，对于此类情况，敏捷过程下面的语法显示的模板:

<TaskWorkItems category="Microsoft.TaskCategory">
   <States>
      <State value="New" type="Proposed" />
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
   </States>
</TaskWorkItems>

任务键盘显示新建、***** 活动 *****和 ***** 关闭 *****列标题。

(可选)包括其他类型的工作项，如的bug工作流状态，则必须添加 *** 解决 *** 工作流状态的赋值。

例如，可以更新 <TaskWorkItems> 包含与积压工作项链接的两个任务和bug的metastate分配。在以下语法，Resolved 工作流状态分配给 InProgress metastate。

<TaskWorkItems category="Microsoft.TaskCategory">
   <States>
      <State value="New" type="Proposed" />
      <State value="Active" type="InProgress" />
      <State value="Resolved" type="InProgress" />
      <State value="Closed" type="Complete" />
   </States>
</TaskWorkItems>

重要事项
必须为对应于一个活动工作流状态的 State 组件指定值。有效的工作流状态十分为工作项类型定义了团队项目的任务类别包含的状态。此外，在敏捷组中必须分配一metastate type，这是 Proposed、InProgress和 Complete。有关这些状态中的每一个的说明，请参见工作流状态，metastates，和进程配置。

键入以下命令以导入定义文件:

witadmin importcommonprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\CommonConfiguration.xml"

按F5刷新 Team Web Access 的网页以反映更改。

返回页首

列和列顺序

显示在任务键盘页的列标题对应于工作流状态分配到默认任务类型分配给任务类别。列顺序对应于工作流转换的自然进度，从左到右移动。为默认任务定义的工作流状态在敏捷组中键入任务类必须分配给一个有效的metastate如工作流状态，metastates，和进程配置所述。

不应需要修改列布局。

返回页首

排序积压工作项的顺序。

积压工作项在升序列出基于字段的值分配给该定义的 type="Order" 为CommonConfiguration。此字段控件的积压工作项的顺序条迭代和任务上页。

指定一个不同的字段使用排序积压工作项

从 witadmin的命令提示符窗口，键入并将您的数据的以下命令替换为显示的参数此处，其中 CollectionURL 指定团队项目集合的URL，ProjectName 指定在集合中定义的团队项目的名称，并且，DirectoryPath 指定名称和位置以文件中导出。然后选择 *** 输入 ***。
```
witadmin exportcommonprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\CommonConfiguration.xml"
```
打开在记事本中的CommonConfiguration文件，然后将与 type="Order"的 TypeField 元素。

例如，敏捷的默认指派过程模板是：
```
<TypeField refname="Microsoft.VSTS.Common.StackRank" type="Order" />
```
将值赋给 refname 到要根据排序顺序的字段。

例如，以下语法指定排序按照自定义字段的积压工作项，Fabrikam.Order。
```
<TypeField refname="Fabrikam.Order" type="Order" />
```
重要事项

必须为指定的团队项目中的要求类别定义指定的工作项的默认类型字段的引用名称。

重要事项
必须为指定的团队项目中的要求类别定义指定的工作项的默认类型字段的引用名称。

键入以下命令以导入定义文件:

witadmin importcommonprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\CommonConfiguration.xml"

按F5刷新 Team Web Access 的网页以反映更改。

返回页首

可以在任务键盘页项的数目

出于性能原因，任务键盘默认情况下为总共500个工作项。当您打开任务键盘时，所有工作项加载到缓存。限制工作项的数目可能会更快加载时。通过指定值更改此限制 IterationBacklog 元素的 workItemCountLimit 属性。

从 witadmin的命令提示符窗口，键入并将您的数据的以下命令在此处说明的参数，其中 CollectionURL 指定团队项目集合的URL，ProjectName 指定在集合中定义的团队项目的名称，并且，DirectoryPath 指定名称和位置以文件中导出。然后选择 *** 输入 ***。
```
witadmin exportagileprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\AgileConfiguration.xml"
```
打开在记事本中的AgileConfigurations文件，然后找到 IterationBacklog的一部分。
为 workItemCountLimit 属性指定值。

例如，以下语法添加计数为800。
```
<IterationBacklog workItemCountLimit="800">
. . .
  </IterationBacklog>
```

键入以下命令以导入定义文件:

witadmin importagileprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\AgileConfiguration.xml"

按F5刷新 Team Web Access 的网页以反映更改。

返回页首

请参见

概念

运行迭代

进程配置 XML 元素参考

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

通过

自定义任务板页

工作显示在任务键盘页的项目类型

若要指定任务的类型中显示的工作项

分配metastates到工作项的任务类型的工作流状态

列和列顺序

排序积压工作项的顺序。

指定一个不同的字段使用排序积压工作项

可以在任务键盘页项的数目

请参见

概念

其他资源