All WITD XML 元素引用

  • 项目

更新：2011 年 1 月

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

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

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

主题内容

  • WITD 语法结构

  • WITD 子元素

  • 过程模板工作项类型

WITD 语法结构

下面的示例演示工作项类型的上层结构。

<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>

在工作项类型定义的最上层，少量 XML 元素出现在 WORKITEMTYPE 标记之间。 开始定义工作项类型时，首先要提供名称和说明。 也可以使用某些标准 XML 标记来包装工作项类型定义。

WITD 子元素

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

元素

说明

WITD

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

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

WORKITEMTYPE

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

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

DESCRIPTION

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

注意注意
只能在 XML 定义中查看说明。不能在用户界面的任何位置查看说明，而且说明与字段 System.Definition 无任何关系。 
<DESCRIPTION> DescriptionOfWorkItemType</DESCRIPTION>

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

GLOBALLISTS

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

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

有关更多信息，请参见定义全局列表。

FIELDS

包含工作项类型使用的字段定义集。 在 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>

有关更多信息，请参见设计和自定义工作项窗体。

过程模板工作项类型

提供了两组过程模板工作项类型定义供您使用，这两组定义对应于为 Microsoft Solutions Framework (MSF) for Agile Software Development v5.0 和 MSF for Capability Maturity Model Integration (CMMI) Software Development v5.0 定义的过程模板工作项类型。 这些文件分别位于以下位置的安装目录中：

  • 驱动器:\Program Files\Microsoft Visual Studio v10.0 Team Foundation Server\Application Tier\Web Services\Deploy\ProcessTemplateManagerFiles\MsfAgile\Template.zip

  • 驱动器:\Program Files\Microsoft Visual Studio v10.0 Team Foundation Server\Application Tier\Web Services\Deploy\ProcessTemplateManagerFiles\MsfFormal\Template.zip

您可以在 Template.zip 文件的 WorkItem Tracking\TypeDefinitions 文件夹中找到工作项类型定义。 例如，MSF for Agile Software Development v5.0 为以下每个工作项类型定义了一个 XML 文件：Bug、问题、共享步骤、任务、测试用例和用户情景。 有关其中每个工作项类型的更多信息，请参见 MSF for Agile Software Development 5.0 版。

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

请参见

概念

设计和自定义工作项窗体

自定义项目跟踪数据、窗体、工作流及其他对象

其他资源

定义工作项字段

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

witAdmin：管理用于跟踪工作项的对象

修订记录

日期

修订记录

原因

2011 年 1 月

添加了有关全局工作流的信息，并移除了有关架构定义的部分。

信息补充。