通过

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

  • 项目

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

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

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

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

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

定义 WIT

必须在其文件中的 WITD 容器元素中指定每个类型定义。 每个定义还必须遵循 workitemtypedefinition-02.xsd 和 workitemtypedefinition-02.xsd 文件中定义的工作项类型的架构定义。 你可从 Microsoft 网站上的以下页面中下载用于跟踪工作项的架构文件：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 文件夹中自定义或创建类型定义文件。 有关如何定义工作项类型的更多信息，请参见所有 WITD XML 元素引用和自定义工作跟踪对象以支持团队的进程。

指定要上载的 WIT 定义

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

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

以下示例演示如何指定创建以下 WIT 的任务：Bug、问题、共享步骤、任务、测试用例和用户情景。 由于多个 WIT 的定义包含 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\CodeReviewRequest.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\CodeReviewResponse.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Feature.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\FeedbackRequest.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\FeedbackResponse.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) 元素，可指定要定义的类型的名称。有关详细信息，请参阅所有 WITD XML 元素引用。

元素

语法

描述

WORKITEMTYPE

 
<WORKITEMTYPE fileName="WITFilePathName" />

WORKITEMTYPES 的必需子元素。

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

WORKITEMTYPES

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

WorkItemTracking 插件的必需子元素。

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

请参见

参考

导入、导出和管理工作项类型 [witadmin]

概念

所有 WITD XML 元素引用

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

其他资源

定义工作项字段