通过

向过程模板添加工作项的类型定义

  • 项目

更新：2011 年 4 月

为过程模板定义的工作项类型将为针对产品及其功能的开发的所有跟踪、监视和报告提供基础。 工作项类型为团队项目中将跟踪的工作项定义数据字段、工作流和工作项窗体。 工作项的类型包括 Bug、用户情景和任务。 您可以先自定义类型定义以添加字段、更改工作流或修改工作项窗体。 此外，您可以在过程模板中添加或删除工作项类型。

将多个工作项的过程模板的类型定义指定为 WorkItemTracking 插件中的任务。 需要此任务，因为工作项类型支持跟踪和报告工作。 您在 taskXml 元素中指定要上载的每个类型定义文件。 测试管理、报表和门户的插件依赖工作项的类型定义的成功上载。

重要说明重要事项

Microsoft Solutions Framework (MSF) v5.0 过程模板定义了六个或更多工作项类型。 类别定义、工作项查询和报表中将引用自身定义的类型和字段。 因此，必须先成功完成上载工作项类型的类型定义这一任务，然后才能执行上载类别、工作项查询和报表的任务。

另外，必须先完成上载链接类型的定义文件这一任务，然后再执行上载工作项的类型定义的任务。 有关更多信息，请参见在插件文件中定义任务组和任务的依赖项。

主题内容

  • 定义工作项的类型

  • 指定要上载的工作项的类型定义

  • WORKITEMTYPES 元素参考

在使用过程模板创建团队项目后，可以通过使用 witadmin 命令行工具添加、删除、重命名和更改工作项的类型定义。 有关更多信息，请参见自定义和管理工作项类型 [witadmin]。

定义工作项的类型

必须在其文件中的 WITD 容器元素中指定每个类型定义。 每个定义还必须遵循 workitemtypedefinition-02.xsd 和 workitemtypedefinition-02.xsd 文件中定义的工作项类型的架构定义。 您可以从 Microsoft 网站上的以下页面下载用于跟踪工作项的架构文件：Process Template and Work Item Schemas for Visual Studio Team Foundation（Visual Studio Team Foundation 的过程模板和工作项架构）。

下面的示例演示了定义工作项类型的高级语法结构。

<WITD application="work item type editor" version="1.0">
    <WORKITEMTYPE name="Bug">
        <DESCRIPTION>Bug work items are used to track defects in the code.</DESCRIPTION>
        <GLOBALLISTS> . . . </GLOBALLISTS>
        <FIELDS> . . . </FIELDS>
        <WORKFLOW> . . . </WORKFLOW>
        <FORM> . . . </FORM>
    </WORKITEMTYPE>
</WITD>

可以在 TypeDefinitions 文件夹中自定义或创建类型定义文件。 有关如何定义工作项类型的更多信息，请参见All WITD XML 元素引用和自定义项目跟踪数据、窗体、工作流及其他对象。

返回页首

指定要上载的工作项的类型定义

若要在过程模板中上载工作项的类型定义，请指定 WORKITEMTYPE 元素。 filename 特性是类型定义文件的相对路径。 例如，下面的语法指定将上载 Bug.xml 文件。

<WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\filename.xml"/>

下面的示例演示了如何指定一个任务，以便在 Microsoft Solutions Framework (MSF) for Agile Software Development v5.0 过程模板中创建全部六种工作项类型。 这些类型对应于以下工作项类型：Bug、问题、共享步骤、任务、测试用例和用户情景。 由于多个工作项的类型定义包含 TestedBy 链接类型的筛选器，因此，必须先完成 LinkTypes 任务，然后才能完成 WITs 任务。

<task id="WITs" name="WorkItemType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item types created">
   <dependencies>
      <dependency taskId="LinkTypes" />
   </dependencies>
   <taskXml>
      <WORKITEMTYPES>
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Bug.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Issue.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\SharedStep.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Task.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\TestCase.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\UserStory.xml" />
      </WORKITEMTYPES>
   </taskXml>
</task>

返回页首

WORKITEMTYPES 元素参考

下表介绍用来上载工作项的类型定义的元素。 在 WorkItemTracking 插件文件中的 taskXml 容器元素内指定这些元素。

提示

通过使用 WORKITEMTYPE (WorkItemTracking) 元素，可指定要上载的类型定义文件。 通过使用 WORKITEMTYPE (WITD) 元素，可指定要定义的类型的名称。 有关更多信息，请参见All WITD XML 元素引用。

元素

语法

说明

WORKITEMTYPE

 
<WORKITEMTYPE fileName="WITFilePathName" />

WORKITEMTYPES 的必需子元素。

指定包含要上载的类型定义的文件的路径和名称。

WORKITEMTYPES

 
<WORKITEMTYPES> 
    <WORKITEMTYPE />
 . . .
</WORKITEMTYPES>

WorkItemTracking 插件的必需子元素。

包含 WORKITEMTYPE 元素的集合，其中的每个元素各指定一个要上载的定义文件。

返回页首

请参见

参考

自定义和管理工作项类型 [witadmin]

概念

All WITD XML 元素引用

设计和自定义工作项窗体

其他资源

定义工作项字段

定义和自定义工作项工作流

使用 WorkItemTracking 插件来定义和自定义用于跟踪工作项的对象

修订记录

日期

修订记录

原因

2011 年 4 月

已为每个 WORKITEMTYPES 元素添加了说明。 已删除指向已删除主题的链接。

信息补充。