通过

自定义工作项类型的类别

  • 项目

可以使用以下 witadmin 命令管理为团队项目定义的工作项类型的类别：

  • exportcategories：导出运行 Team Foundation Server 的服务器上定义的类别的 XML 定义。

  • importcategories：将工作项类型 XML 定义文件导入运行 Team Foundation Server 的服务器上的团队项目。 

    如果具有相同名称的某个类别已经存在，则此命令会覆盖现有的定义。如果工作项类型尚不存在，则此命令将创建一个新类别。

若要运行 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 Server 权限和Team Foundation Server 默认组、权限和角色。

说明说明

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

 
witadmin exportcategories /collection:CollectionURL /p:Project [/f:FileName] [/e:Encoding] 

witadmin importcategories /collection:CollectionURL /p:Project /f:FileName [/e:Encoding]

参数

Parameter

说明

/collection:CollectionURL

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

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

http://ServerName:Port/CollectionName。

/p:Project

类别从其导出或类别导入至的团队项目的名称。

/f:FileName

包含要导出或导入的类别的 XML 定义文件的路径和文件名称。如果省略此参数，则在使用 exportcategories 命令时，该命令将列出命令提示符窗口中的类别。

/e:Encoding

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

/? 或 help

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

备注

如果这些类别尚不存在，则导入类别文件时会创建这些类别。如果类别已经存在，witadmin importcategories 命令将警告您当前列表将被覆盖。您可以编写自己的程序来更新现有类别集或使用新数据更新类别。

重要说明重要事项

对类别所做的更改会影响流程配置。请参见 使用进程配置自定义积压工作和板页。

有关类别 XML 文件结构的信息，请参见类别定义架构参考。

示例

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

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

  • 项目名称：AdventureWorks

  • 输入或输出文件的名称：myCategories.xml

  • 默认编码：UTF-8

Dd273721.collapse_all(zh-cn,VS.110).gif列出工作项类型类别

下面的命令列出了为 AdventureWorks 项目定义的工作项类型类别。

witadmin exportcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks

Dd273721.collapse_all(zh-cn,VS.110).gif导出工作项类型类别

下面的命令将为 AdventureWorks 项目定义的工作项类型类别导出到 myCategories XML 文件。

witadmin exportcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml

Dd273721.collapse_all(zh-cn,VS.110).gif导入工作项类型类别

下面的示例将类别从 myCategories XML 文件导入到 AdventureWorks 项目。

witadmin importcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml

请参见

概念

使用进程配置自定义积压工作和板页

其他资源

定义类别以分组工作项类型

工作项类型类别元素参考

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