通过

定义全局列表

  • 项目

通过使用 Team Foundation Server (TFS) 中的全局列表，可使更新显示在若干个工作项类型 (WIT) 定义中的列表所需的工作最小化。 全局列表是可包括在一个或多个字段和 WIT 定义内的选择列表。 你可定义你添加到团队项目的 WIT 中的全局列表，将其定义为团队项目集合的全局列表或全局工作流中的全局列表。 可通过在一个或多个 GLOBALLIST 元素中包含列表项，在集合的若干个 WIT 中共享列表项。

定义 WIT 时，你可能会发现一些字段共享相同的值。 你可跨若干个 WIT 甚至若干个团队项目频繁共享。 其中的一些值（例如每夜生成的生成号、更改频率），需要管理员在多个位置中频繁更新这些列表。 当列表必须派生自外部系统时，全局列表尤其有用。 例如，假设公司维护一个单独的客户数据库。 当你记录客户发现的 Bug 时，客户名称会输入到自定义 Found By Customer 字段中。

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

备注

没有系统定义的全局列表，也没有在 TFS 提供的默认过程模板中预定义的全局列表。

要求

  • 要导出或列出全局列表，你必须是“项目集合有效用户”组成员，或者你的“查看集合级别信息”权限设置为“允许”。

  • 要定义或编辑全局列表，你必须是“项目管理员”组的成员，或者你的“编辑项目级别权限”设置为“允许”。

  • 若要添加或修改全局列表，请使用 witadmin 命令行工具导入和导出全局列表的定义。 请参阅管理工作项类型的全局列表 [witadmin]。 若要使用全局列表，请将其添加到工作项类型中的 FIELD 定义。 请参阅所有 FIELD XML 元素引用。

添加和管理全局列表

全局列表是 LISTITEM 元素的集合，该集合由所有团队项目在集合中存储并在全局范围使用。 全局列表用于在多种类型的工作项（例如操作系统、发现版本和修复版本）中定义的字段。

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

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

  • 工作项类型定义：创建团队项目后，你可以将希望工作项类型使用的全局列表添加到其定义。

  • 全局工作流定义：创建团队项目后，你可以将希望所有工作项类型使用的全局列表添加到团队项目或集合的全局工作流定义。 有关详细信息，请参阅自定义全局工作流。

语法结构

下表描述 GLOBALLIST 和 LISTITEM 元素。 你可以使用这些元素将向用户显示的值列表枚举为项的选取列表或下拉菜单。

元素

语法

说明

GLOBALLIST

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

有关工作项类型的定义文件的结构和位置或全局工作流的信息，请分别参阅所有 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 元素。

问题解答

问：是否使用数据自动填充所有全局列表？

答：可以。 每次运行版本时都可附加名为 Builds – TeamProjectName 的全局列表。 随着时间的推移，该列表会变得很长。 最佳做法是定期从该列表中删除不使用的项目。

若要了解有关使用此列表的详细信息，请参阅用于支持与测试、生产和版本控制的集成的字段。

请参见

参考

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

概念

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