所有 WITD XML 元素引用

项目
11/18/2015

您可以自定义现有工作项类型 (WIT) 或创建 WIT 来满足项目跟踪要求。 WIT 为团队项目中要跟踪的工作项（如 Bug、要求或风险）定义字段、规则、工作流状态和转换。在 Visual Studio Online 或在本地 Team Foundation Server (TFS) 上创建团队项目。

每个 WIT 定义中的根元素为 WITD 元素，必须仅为其定义一个 WORKITEMTYPE 元素。每个 WIT 的名称在一个团队项目中必须是唯一的，并且每个类型名称的长度不得超过 128 个 Unicode 字符。

若要自定义或创建 WIT 定义，您可以修改类型定义 XML 文件。 WIT 的应用范围限定为项目集合中的团队项目。

WITD 语法结构

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

<witd:WITD application="Work item type editor" version="1.0" xmlns:witd="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef">
    <WORKITEMTYPE name="bug" refname="Microsoft.VSTS.WorkItemTypes.Bug">
        <DESCRIPTION> Describes a divergence between required and actual behavior, and tracks the work done to correct the defect and verify the correction.</DESCRIPTION>
        <GLOBALLISTS> . . . </GLOBALLISTS>
        <FIELDS> . . . </FIELDS>
        <WORKFLOW> . . . </WORKFLOW>
        <FORM> . . . </FORM>
    </WORKITEMTYPE>
</witd:WITD>

WITD 子元素

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

元素	描述
WITD	完整的 WIT 定义通过标记 WITD 进行包装。可以将任何名称用作 application 的名称。版本将标识可从一个版本更改为下一个版本的 WIT 架构。使用“1.0”。 `<witd:WITD application="Work item type editor" version="1.0" xmlns:witd="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef"> <WORKITEMTYPE> . . .</WORKITEMTYPE> </witd:WITD>`
WORKITEMTYPE	WIT 名称在特定团队项目中必须是唯一的。在运行时，可以使用此元素指定的名称。例如，该名称可以显示为菜单选项。在这种情况下，用户可以选择“新建工作项”菜单上的“Bug”。 `<WORKITEMTYPE name="WorkItemTypeName" refname="WITReferenceName" > <DESCRIPTION>Text</DESCRIPTION> <GLOBALLISTS> . . .</</GLOBALLISTS> <FIELDS> . . . </FIELDS> <WORKFLOW> . . . </WORKFLOW> <FORM> . . .</</FORM> </WORKITEMTYPE>` 友好名称：此名称将显示在工作项查询的下拉菜单中。友好名称在团队项目中定义的所有 WIT 名称中必须是唯一的。指定一个使用字母数字、下划线和连字符的名称，其长度不超过 128 个 Unicode 字符。引用名称：指定一个使用字母数字、下划线和连字符的名称，其长度不超过 70 个 Unicode 字符。引用名称必须至少包含一个句点 (.)，但不能以句点作为名称的开头或结尾。此外，引用名称不能以数字或下划线开头，而且不能包含多个连续的连字符，例如 (--)。不要指定与保留的系统重叠的名称。 XXX 和 Microsoft。 XXX 命名空间。请参阅工作项跟踪对象的命名约定。
说明	指定说明要定义的工作项类型的字符串。说明应帮助自定义 WIT 的任意用户。备注只能在 XML 定义中查看说明。不能在用户界面的任何位置查看说明，而且说明与字段 System.Definition 无任何关系。 `<DESCRIPTION> DescriptionOfWorkItemType</DESCRIPTION>` 指定说明要定义的工作项类型的文本字符串。
GLOBALLISTS	包含 WIT 使用的全局列表定义。使用全局列表在为团队项目集合定义的多个 WIT 之间共享选取列表。使用全局列表可为跨组协作和简化维护提供支持。 `<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 14.0/Tools/Deploy/ProcessTemplateManagerFiles/1033

WIT 定义文件存储在 WorkItem Tracking\TypeDefinitions 文件夹中。

若要了解如何创建或自定义 WIT，请参阅自定义工作跟踪对象以支持团队的进程。将新的 WIT 添加到过程模板。请参阅向过程模板添加工作项的类型定义。

通过

所有 WITD XML 元素引用

WITD 语法结构

WITD 子元素

过程模板工作项类型

请参见

概念

其他资源

其他资源