通过

定义全局列表

  • 项目

更新：2011 年 1 月

使用全局列表，可以将更新由多种工作项类型共享的列表所需的工作减到最少。 全局列表是可包含在一个或多个工作项类型和字段中的选取列表。 可以将添加到团队项目或过程模板的工作项类型中的全局列表定义为团队项目集合或全局工作流中的全局列表。 通过将列表项包括在一个或多个 GLOBALLIST 元素中，可以在集合的多个工作项类型之间共享这些列表项。

提示

在定义全局工作流之前，必须在应用层服务器上启用该功能。 因此，服务器必须运行支持该功能的 Visual Studio Team Foundation Server 版本，例如 Team Foundation Server 2010 Service Pack 1 (SP1)。 可以从 Microsoft 网站上的以下页面下载 Service Pack：Visual Studio Team Foundation Server 2010 Service Pack 1 Beta。 有关更多信息，请参见自定义全局工作流。

在定义工作项类型时，您可能会发现一些字段共享一些相同的值。 您可能经常在多个工作项类型甚至多个团队项目之间进行共享。 其中一些值可能会经常发生更改，例如夜间生成的内部版本号（要求管理员经常在许多位置上更新这些列表）。 必须从外部系统派生列表时，全局列表尤其有用。 例如，假设一个公司要维护独立的客户数据库。 当记录客户发现的 Bug 时，将客户名称输入到自定义 Found By Customer 字段中。

可以将集合的全局列表作为可以列出、导入、导出和删除的 XML 文件进行管理。 每个全局列表的名称最长可为 254 个 Unicode 字符，并且在一个集合中必须是唯一的。

提示

在 Microsoft Solutions Framework (MSF) 过程模板中不存在系统定义的全局列表，也不存在预定义的全局列表。

主题内容

  • 添加和管理全局列表

  • 定义全局列表的语法结构

  • 添加到工作项类型定义或全局工作流的全局列表的语法结构

  • 为集合维护的全局列表的语法结构

添加和管理全局列表

全局列表是一组 LISTITEM 元素，这些元素由集合中的所有团队项目以全局方式进行存储和使用。 全局列表对于在多个工作项类型中定义的字段很有用，如“操作系统”、“发现版本”和“修复版本”。

使用以下方法之一，可以定义全局列表及其列表项：

  • 过程模板：为过程模板定义全局列表。 使用该模板创建的每个团队项目有权访问全局列表。

  • 团队项目集合：可以导出、修改、删除和导入为团队项目集合定义的全局列表。 集合中的所有团队项目都可使用这些全局列表。

  • 工作项类型定义：可以将需要对工作项类型可用的全局列表添加到其定义中。

  • 全局工作流定义：可以将需要对所有工作项类型可用的全局列表添加到团队项目或集合的全局工作流定义中。 有关更多信息，请参见自定义全局工作流。

返回页首

定义全局列表的语法结构

下表对 GLOBALLIST 和 LISTITEM 元素进行了说明。 可以使用这些元素来枚举值的列表，该列表对用户显示为项目的选取列表或下拉菜单。

元素

语法

说明

GLOBALIST

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

定义一组为集合存储的并可由集合中的所有团队项目使用的 LISTITEM 元素。

globalListName：包含 1 至 255 个字符的文本字符串。

GLOBALLIST 是 GLOBALLISTS 元素的必需子元素，并且是 ALLOWEDVALUES、SUGGESTEDVALUES 和 PROHIBITEDVALUES 元素的可选子元素。 有关更多信息，请参见定义选取列表。

LISTITEM

 
<LISTITEM value="Name" />

定义一个有效列表值。

注意注意
全局列表不能包含项目范围的组，因为全局列表的范围不是项目。

LISTITEM 是 GLOBALLIST 的必需子元素，并且是 ALLOWEDVALUES、SUGGESTEDVALUES 和 PROHIBITEDVALUES 元素的可选子元素。

返回页首

添加到工作项类型定义或全局工作流的全局列表的语法结构

通过添加下面的语法，可以在工作项类型或全局工作流的 XML 定义文件中定义全局列表：

<GLOBALLISTS>
    <GLOBALLIST name="name of global list">
        <LISTITEM value="List item 1" />
        <LISTITEM value="List item 2" />
        <LISTITEM value="List item 3" />
        <LISTITEM value="List item 4" />
        . . .
        <LISTITEM value="List item n" />
    </GLOBALLIST>
</GLOBALLISTS>

使用下面的语法，可以在工作项类型的 XML 定义文件中引用全局列表：

<GLOBALLISTS>
   <GLOBALLIST name=" name of global list 1" />
   <GLOBALLIST name=" name of global list 2" />
   . . .
   <GLOBALLIST name=" name of global list n" />
</GLOBALLISTS>

有关工作项类型或全局工作流的定义文件的结构和位置信息，请分别参见All WITD XML 元素引用或全局工作流 XML 元素引用。

返回页首

为项目集合维护的全局列表的语法结构

若要将全局列表添加到项目集合，可以使用 witadmin importgloballist 命令导入下面的语法：

<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/globallists">
    <GLOBALLIST name="NameOfGlobalList">
        <LISTITEM value="ListItem1" />
        <LISTITEM value="ListItem2" />
        <LISTITEM value="ListItem3" />
        <LISTITEM value="ListItem4" />
        . . .
        <LISTITEM value="ListItemN" />
    </GLOBALLIST>
</gl:GLOBALLISTS>

全局列表不能为空。 每个 GLOBALLIST 元素必须至少定义一个 LISTITEM 元素。

返回页首

请参见

任务

添加、使用和管理全局列表

参考

管理工作项类型的全局列表 [witadmin]

概念

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

定义和使用列表、选取列表以及全局列表

其他资源

自定义全局工作流

修订记录

日期

修订记录

原因

2011 年 1 月

更新内容以包括可用于定义全局列表（包括全局工作流）的所有四种方法。 移除了架构定义部分。

信息补充。