通过

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

全局列表是选取列表，您可以在其中包括一个或多个字段和工作项类型。使用它们来使更新列表且由多种类型的工作项共享的工作减到最少。由于已为团队项目集合定义了全局列表，这些列表可包括在集合内所有团队项目的工作项类型内。

说明说明

全局列表不得包含项目范围的安全组，因为全局列表与团队项目具有不同的范围。

您可以在其自己的定义文件（工作项类型定义文件或者全局工作流）中定义全局列表。全局列表定义托管为集合定义的全局列表名称。全局列表定义使用 witadmin 命令行工具中的下列命令：

  • destroygloballist：销毁全局列表。

  • exportgloballist：将全局列表导出到 XML 文件或命令提示窗口。它导出一个文件，其中包含所有已经为团队项目集合定义的全局列表。

  • importgloballist：从 XML 文件导入全局列表。如果尝试导入服务器中已存在的全局列表，则会出现一个警告，询问您是否覆盖该服务器中的全局列表。如果尝试导入的全局列表尚不存在，则该命令会创建一个新全局列表。

  • listgloballist：显示服务器上定义的每个全局列表的名称。

请参见定义全局列表和自定义全局工作流。

若要运行 witadmin 命令行工具，请打开已安装 Visual Studio 或 团队资源管理器 的“命令提示”窗口，然后输入：

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

在 64 位 Windows 版本上，将 %programfiles% 替换为 %programfiles(x86)%.

说明说明

进程编辑器是 Visual Studio 的一个增强工具，您可以使用该工具来创建或修改全局列表。此工具不受支持。有关更多信息，请参见 Microsoft 网站上的以下页面：Team Foundation Server Power Tools（Team Foundation Server 增强工具）。

要求

对于定义全局列表处的团队项目集合，您必须具有以下权限集：

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

  • 若要销毁或导入全局列表，您必须是**“Team Foundation Administrators (Team Foundation 管理员)”安全组或“Project Administrators (项目管理员)”**安全组的成员。

请参见Team Foundation Server 权限和Team Foundation Server 默认组、权限和角色。

说明说明

即使您是以管理权限登录的，也必须使用提升的权限打开命令提示符窗口，才能在运行 Windows Server 2008 的服务器上执行此功能。若要使用提升的权限打开命令提示符窗口，请选择“开始”，打开“命令提示符”快捷窗口，然后选择“以管理员身份运行”。有关更多信息，请参见 Microsoft 网站上的以下页面：User Access Control（用户访问控制）。

 
witadmin destroygloballist /collection:CollectionURL /n:GlobalListName [/noprompt] [/force]

witadmin exportgloballist /collection:CollectionURL [/f:FileName] [/e:Encoding] 

witadmin importgloballist /collection:CollectionURL /f:FileName [/e:Encoding]

witadmin listgloballist /collection:CollectionURL

参数

Parameter

描述

/collection:CollectionURL

指定团队项目集合的 URI。URI 的格式为：http://ServerName:Port/VirtualDirectoryName/CollectionName

如果未使用虚拟目录，则 URI 将为以下格式：

http://ServerName:Port/CollectionName。

/n:GlobalListName

要销毁的全局列表的名称。

/f:FileName

要导出或导入的全局列表 XML 定义文件的路径和名称。

说明说明
如果客户端计算机运行的是 Windows Vista，则您可能没有访问某些文件夹的权限。如果尝试将全局列表导出到您没有权限的位置，注册表虚拟化技术将自动重定向导出的文件，并将其保存到虚拟存储区。有关更多信息，请参见 Microsoft 网站的以下页面：Registry Virtualization（注册表虚拟化）和 Common file and registry virtualization issues in Windows Vista（Windows Vista 中常见的文件和注册表虚拟化问题）。若要避免此重定向操作，可以将该文件导出到您拥有权限的位置。

/e:Encoding

.NET Framework 2.0 编码格式的名称。指定的编码将用于导出或导入 XML 数据。例如，/e utf-7 指定 Unicode (UTF-7) 编码。如果省略此参数，则 witadmin 将尝试检测编码，并且如果检测失败，则 witadmin 将使用 UTF-8。

/noprompt

禁用提示进行确认。

/? 或 help

在“命令提示符”窗口中显示有关命令的帮助。

备注

如果全局列表不存在，则导入全局列表时会创建一个列表。如果该列表已经存在，witadmin importgloballist 命令将警告您当前列表将被覆盖。您可以编写自己的程序来更新现有全局列表或使用新数据更新全局列表。

要创建新的全局列表，请从以下代码开始，并按需求进行修改。此示例定义了您可以分配给任务的专业的全局列表。

<?xml version="1.0" encoding="utf-8"?>
<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/globallists">
    <GLOBALLIST name="Disciplines">
        <LISTITEM value="Architecture" />
        <LISTITEM value="Requirements" />
        <LISTITEM value="Development" />
        <LISTITEM value="Release Management" />
        <LISTITEM value="Project Management" />
        <LISTITEM value="Test" />
    </GLOBALLIST>
</gl:GLOBALLISTS>

要将全局列表添加到一个字段，请先导出包含该字段的工作项类型的定义，然后再将其添加到字段定义，如下面的示例所示：

<FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String">
  <HELPTEXT>The discipline to which the task belongs</HELPTEXT>
  <ALLOWEDVALUES>
     <GLOBALLIST name="Disciplines" />
  </ALLOWEDVALUES>
</FIELD>

要查看更改，请导入类型定义并刷新浏览器或客户端缓存。您可能需要关闭引用该字段的所有工作项，然后再重新打开。

有关类型定义的导出和导入的信息，请参见 自定义和管理工作项类型 [witadmin]。

示例

除非另外指定，否则下面的值适用于每个示例：

  • 团队项目集合的 URI：http://AdventureWorksServer:8080/tfs/DefaultCollection

  • 服务器网站端口号：8080

Dd236912.collapse_all(zh-cn,VS.110).gif显示全局列表的名称

下面的示例显示服务器上定义的全局列表。此示例使用默认 UTF-8 编码导出全局列表：

witadmin listgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Dd236912.collapse_all(zh-cn,VS.110).gif导出全局列表的定义

下面的示例导出全局列表：

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml

下面的示例将相同的全局列表导出到相同的服务器，但使用 Unicode (UTF-7) 编码：

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml /e:utf-7

Dd236912.collapse_all(zh-cn,VS.110).gif导入全局列表的定义

下面的示例导入全局列表：

witadmin importgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml

下面的示例将相同的全局列表导入到相同的服务器，但使用 Unicode (UTF-7) 编码：

witadmin importgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml /e utf-7

请参见

概念

定义全局列表

其他资源

自定义全局工作流

witAdmin：自定义和管理用于跟踪工作项的对象