定义全局列表
使用全局在 Team Foundation Server (tfs)，则列表可以最小化需要更新工作项列表共享的多个类型的工作。全局列表是可包含在一个或多个工作项类型和字段中的选取列表。可以在您添加到团队项目的工作项类型列表中，作为全局列出为团队项目集合，或全局工作流中。通过将列表项包括在一个或多个 GLOBALLIST 元素中，可以在集合的多个工作项类型之间共享这些列表项。
在定义工作项类型时，您可能会发现一些字段共享一些相同的值。您可能经常在多个工作项类型甚至多个团队项目之间进行共享。其中一些值可能会经常发生更改，例如夜间生成的生成号（要求管理员经常在许多位置上更新这些列表）。必须从外部系统派生列表时，全局列表尤其有用。例如，假设一个公司要维护独立的客户数据库。当记录客户发现的 Bug 时，将客户名称输入到自定义 Found By Customer 字段中。
可以将集合的全局列表作为可以列出、导入、导出和删除的 XML 文件进行管理。每个全局列表的名称最长可为 254 个 Unicode 字符，并且在一个集合中必须是唯一的。
.gif "说明") 说明 |
|---|
没有系统定义的全局列表，也不预定义的全局在该默认值列表处理 TFS 提供的模板。 |
主题内容
添加和管理全局列表
定义全局列表的语法结构
添加到工作项类型定义或全局工作流的全局列表的语法结构
为集合维护的全局列表的语法结构
| 说明 |
|---|
添加或修改全局列表，使用 witadmin 命令行工具导入，并且导出全局定义的列表。请参见 管理工作项类型的全局列表 [witadmin]。若要使用全局列表，将它添加到工作项类型中的 FIELD 定义。请参见 All FIELD XML 元素引用。 |
添加和管理全局列表
全局列表是一组 LISTITEM 元素，这些元素由集合中的所有团队项目以全局方式进行存储和使用。全局列表对于在多个工作项类型中定义的字段很有用，如“操作系统”、“发现版本”和“修复版本”。
使用以下方法之一，可以定义全局列表及其列表项：
过程模板:可以在工作项的定义列表输入过程模板。使用该模板创建的每个团队项目有权访问全局列表。
团队项目集合：可以导出、修改、删除和导入为团队项目集合定义的全局列表。集合中的所有团队项目都可使用这些全局列表。
工作项类型定义:在创建团队项目之后，您可将全局列表添加要对工作项类型可用的到其定义。
全局工作流定义:在创建团队项目之后，您可将全局列表添加要对所有工作项类型可用的到团队项目或集合的全局工作流定义。有关更多信息，请参见自定义全局工作流。
返回页首
定义全局列表的语法结构
下表对 GLOBALLIST 和 LISTITEM 元素进行了说明。可以使用这些元素来枚举值的列表，该列表对用户显示为项目的选取列表或下拉菜单。
元素 |
语法 |
描述 |
|---|---|---|
GLOBALIST |
|
定义一组为集合存储的并可由集合中的所有团队项目使用的 LISTITEM 元素。 globalListName：包含 1 至 255 个字符的文本字符串。 GLOBALLIST 是 GLOBALLISTS 元素的必需子元素，并且是 ALLOWEDVALUES、SUGGESTEDVALUES 和 PROHIBITEDVALUES 元素的可选子元素。有关更多信息，请参见定义选取列表。 |
LISTITEM |
|
定义一个有效列表值。 说明
全局列表不能包含项目范围的组，因为全局列表的范围不是项目。
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 元素。
返回页首