所有 WITD XML 元素参考

项目
02/21/2013

您可以自定义现有工作项类型或创建工作项类型，以满足您的项目跟踪要求。工作项类型为团队项目中要跟踪的某项工作（如 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、问题、共享步骤、任务、测试用例和用户情景。有关其中每个工作项类型的更多信息，请参见适用于 Visual Studio ALM 的敏捷过程模板。

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