所有 WITD XML 元素引用

您可以自定义现有工作项类型 (WIT) 或创建 WIT 来满足项目跟踪要求。 WIT 为团队项目中要跟踪的工作项(如 Bug、要求或风险)定义规则、字段、状态和转换。

WIT 不能为空。 每个 WIT 定义中的根元素为 WITD 元素,必须仅为其定义一个 WORKITEMTYPE 元素。 每个 WIT 的名称在一个团队项目中必须是唯一的,并且每个类型名称的长度不得多于 254 个 Unicode 字符。 有关详细信息,请参阅工作项跟踪对象的命名约定

若要自定义或创建 WIT 定义,您可以修改类型定义 XML 文件。 维护和管理每个团队项目的工作项类型定义。

WITD 语法结构

下面的示例演示 WIT 定义的高级结构。

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

在 WIT 定义的最高层,少量 XML 元素会出现在 WORKITEMTYPE 标记之间。 通过提供名称和说明来开始定义 WIT。 也可以使用某些标准 XML 标记来包装 WIT 定义。

WITD 子元素

下表对上面示例中使用的结构元素进行说明:

元素

描述

WITD

完整的 WIT 定义通过标记 WITD 进行包装。 可以将任何名称用作 application 的名称。 version 确定从一个发布更改为下一个发布的工作项类型的架构。 使用“1.0”。

<WITD application="Work item type editor" version="1.0 [1]">
   <WORKITEMTYPE> . . .</WORKITEMTYPE>
</WITD>

WORKITEMTYPE

WIT 名称在特定团队项目中必须是唯一的。 在运行时,可以使用此元素指定的名称。 例如,该名称可以显示为菜单选项。 在这种情况下,用户可以选择“新建工作项”菜单上的“Bug”

<WORKITEMTYPE name="WorkItemTypeName">
    <DESCRIPTION>Text</DESCRIPTION>
    <GLOBALLISTS> . . .</</GLOBALLISTS>
    <FIELDS> . . . </FIELDS>
    <WORKFLOW> . . . </WORKFLOW>
    <FORM> . . .</</FORM>
</WORKITEMTYPE>

DESCRIPTION

指定说明要定义的工作项类型的字符串。 说明应帮助自定义 WIT 的任意用户。

备注

只能在 XML 定义中查看说明。不能在用户界面的任何位置查看说明,而且说明与字段 System.Definition 无任何关系。

<DESCRIPTION> DescriptionOfWorkItemType</DESCRIPTION>

指定说明要定义的工作项类型的文本字符串。

GLOBALLISTS

包含工作项类型使用的全局列表定义。 可以使用全局列表在团队项目集合的多个工作项类型之间共享列表项。 使用全局列表可为简化维护和跨组协作提供支持。

<GLOBALLIST name="globalListName">
    <LISTITEM> . . . </LISTITEM>
</GLOBALLIST>

有关详细信息,请参阅定义全局列表

FIELDS

包含 WIT 使用的字段定义集。 在 FIELDS 元素内,定义要用于跟踪工作项类型的数据的所有字段。 这包括将用于运行查询和生成报表的字段。

<FIELDS>
   <FIELD> . . . </FIELD>
</FIELDS>

有关详细信息,请参阅定义和修改工作项字段

WORKFLOW

包含用于定义工作流的 STATE 和 TRANSITION 元素集。 工作流是指从一种状态到另一种状态的一组有效转换,以及与每个转换关联的特定条件。

<WORKFLOW>
   <STATES> . . . </STATES>
   <TRANSITIONS> . . . </TRANSITIONS>
</WORKFLOW>

有关详细信息,请参阅更改工作项类型的工作流

FORM

包含 LAYOUT、CONTROL、GROUP、TAB、TABGROUP、SPLITTER 和其他元素,这些元素定义窗体上显示的字段和控件以及这些元素在窗体上的显示情况。

<FORM>
   <Layout> . . . </Layout>
</FORM>

有关详细信息,请参阅设计工作项窗体

过程模板工作项类型

TFS 提供三个默认过程模板。 这些文件位于以下目录中:

%programfiles%/Microsoft Team Foundation Server 12.0/Tools/Deploy/ProcessTemplateManagerFiles/1033

您可以在 WorkItem Tracking\TypeDefinitions 文件夹中找到工作项类型定义。 有关详细信息,请参阅使用团队项目内容,选择过程指南

可以在 TypeDefinitions 文件夹中自定义或创建类型定义文件。 随后可以将新的工作项类型导入单个项目,也可以将其添加到过程模板并将修改后的模板上载到 Team Foundation Server。 有关详细信息,请参阅向过程模板添加工作项的类型定义

请参见

概念

自定义工作跟踪对象以支持团队的进程

其他资源

witAdmin:自定义和管理用于跟踪工作的对象