通过

管理可用于同步的工作项类型

  • 项目

在可以同步。Visual Studio Team Foundation Server 2012 和 Microsoft Project 服务器之间之前，必须配置两个服务器产品的集成。 作为配置任务的一部分，您必须将企业项目计划与团队项目相关联，而且必须指定要参与同步的工作项的类型。 在进行初始配置和映射后，您可以更改已映射工作项的类型。

可以使用 TfsAdmin ProjectServer 命令行工具中的以下选项来管理参与同步的工作项的类型：

  • /MapWorkItemTypes：为团队项目定义可参与同步的工作项的类型。 尽管可以映射多种类型，但只有那些提交以供发布的工作项会被同步。

  • /GetMappedWorkItemTypes：返回配置为参与团队项目同步的工作项类型的列表。

  • /UnmapWorkItemTypes：从参与团队项目同步中移除工作项类型。

有关如何集成这两个服务器产品的概述，请参见配置 Team Foundation Server 与 Project Server 的集成。 如何如何将企业项目相与团队项目关联的概述，请参见管理企业项目与团队项目的关联。

若要使用 TfsAdmin ProjectServer 命令行工具，请打开 Visual Studio 或 团队资源管理器 安装的命令提示符窗口并 enter:

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

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

必需的权限

若要使用这些命令，必须将**“管理 Project Server 集成”权限设置为“允许”**。 此外，必须还要向 Team Foundation Server 的服务帐户授予与参与数据同步的 PWA 实例进行交互所需的权限。 有关更多信息，请参见分配权限以支持 Project Server 和 Team Foundation Server 集成。

备注

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

语法

TfsAdmin ProjectServer /GetMappedWorkItemTypes /collection:tpcUrl teamProject:TeamProjectName

TfsAdmin ProjectServer /MapWorkItemTypes /collection:tcpUrl /teamProject:TeamProjectName /workItemTypes:ListOfWorkItemTypes [/skipUIChanges]

TfsAdmin ProjectServer /UnmapWorkItemTypes /collection:tpcUrl /teamProject:TeamProjectName /workItemTypes:ListOfWorkItemTypes [/force]

参数

Parameter

描述

/collection:tpcUrl

指定团队项目集合的统一资源定位器 (URL)。 可以按以下格式指定 URL：

http://服务器名称:端口/虚拟目录名称/集合名称

如果不指定虚拟目录，则必须按以下格式指定 URL：

http://服务器名称:端口/集合名称

/teamProject:TeamProjectName

指定在项目集合中定义的团队项目的名称。

/workItemTypes:ListofWorkItemTypes

以逗号分隔列表的格式指定一个或多个工作项类型的引用名称。 您应该仅指定要在 Project Professional 中跟踪其数据的那些工作项类型。 例如，可以指定以下工作项类型，以支持形式为 "用户情景,任务" 或 "用户情景",任务的敏捷过程。 逗号后面不能有空格。

/skipUIChanges

指定工作项表单中的 Project Server 选项卡不应针对您指定的类型进行更改。 您应将此标志，如果自定义受影响的类型的 Project Server 选项或 MapWorkItemTypes 命令无法完成。 您可以手动更新类型定义。 有关更多信息，请参见向工作项类型的定义添加的 XML 元素。

/force

移除所有将您指定的工作项类型绑定到 Project 任务的链接。 如果您使用此选项，那么即使当前正在对参与数据同步的一个或多个工作项类型进行同步，也可以将其移除。

/? 或 help

显示有关此命令的信息。

返回页首

备注

当您运行命令时，会显示一条消息，指明正在什么对象上执行什么操作。 例如，下面的消息说明正在配置用户情景和任务以参与数据同步。

Configuring synchronization for the following work item types for team project ProjA: User Story, Task. . .

完成此命令后，会出现另一条消息。 例如，下面的消息表示已成功地配置了用户情景和任务。

You have successfully configured the following work item types for team project ProjA: User Story, Task.

除配置可以参与同步的工作项类型外，/MapWorkItemTypes 命令还执行以下操作：

  • 将您指定的工作项类型添加到要参与数据同步的类型集中。 也就是说，该命令不会不取消映射任何现有的映射类型。

  • 将**“Project Server”**选项卡添加到您指定的工作项类型的窗体中。

    如果已针对您指定的工作项类型定义了 Project Server 选项卡，该类型将被忽略，而且不会对该类型的工作项的窗体进行任何更改。

如果您尝试针对还未与企业项目计划相关联的团队项目映射工作项类型，将会显示一个错误。 只能针对已配置为参与同步团队项目映射工作项类型。 有关更多信息，请参见管理企业项目与团队项目的关联。

如果您移除工作项类型的映射，则会从您取消映射的团队项目所对应的类型的表单中移除 Project Server 选项卡。

在取消映射团队项目的工作项类型之前，应该先删除企业项目计划中的任务，以便移除它们和 Team Foundation 中的工作项之间的所有关联。 在删除后从企业项目计划的任务，您必须发布并等待同步完成。 或者，也可以指定 /force 标志来移除所有将工作项绑定到团队项目的链接。 只有您指定的类型的工作项会从参与同步上被移除。

提示

如果删除这些任务，您可能会希望先将它们复制到另一个计划，以维护它们的记录。

返回页首

示例

Gg412655.collapse_all(zh-cn,VS.110).gif列出已映射的工作项类型

下面的示例检索的工作项类型在 AdventureWorksServer 的"配置为参与 Contoso 团队项目的同步。

TfsAdmin ProjectServer /GetMappedWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /teamproject:Contoso

Gg412655.collapse_all(zh-cn,VS.110).gif映射团队项目的工作项类型

下面的示例配置用户情景和任务以参与 Contoso 项目的数据同步。

TfsAdmin ProjectServer /MapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ /teamProject:Contoso /workitemtypes:”User Story, Task”

Gg412655.collapse_all(zh-cn,VS.110).gif移除团队项目的工作项类型映射

下面的示例从参与 Contoso 项目的数据同步中移除任务。

TfsAdmin ProjectServer /UnmapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ /teamProject:Contoso /workitemtypes:Task

返回页首

请参见

概念

指定可以同步的工作项类型

管理 Project Server 与 TfsAdmin ProjectServer 的集成

其他资源

自定义 Project Server 和 Team Foundation Server 之间的字段映射