管理可用于同步的工作项类型
在 Visual Studio Team Foundation Server 2010 和 Microsoft Project Server 2007 或 Project Server 2010 之间同步数据以前，必须先配置这两个服务器产品的集成。 作为配置任务的一部分，您必须将企业项目计划与团队项目相关联，而且必须指定要参与同步的工作项的类型。 在进行初始配置和映射后，您可以更改已映射工作项的类型。
可以使用 TFSAdmin ProjectServer 命令行工具中的以下选项来管理参与同步的工作项的类型：
/MapWorkItemTypes：为团队项目定义可参与同步的工作项的类型。 尽管可以映射多种类型，但只有那些提交以供发布的工作项会被同步。
/GetMappedWorkItemTypes：返回配置为参与团队项目同步的工作项类型的列表。
/UnmapWorkItemTypes：从参与团队项目同步中移除工作项类型。
有关如何集成这两个服务器产品的概述，请参见配置 Team Foundation Server 与 Project Server 的集成。 如何如何将企业项目相与团队项目关联的概述，请参见管理企业项目与团队项目的关联。
若要使用 TFSAdmin ProjectServer 命令行工具，您需要在任何运行 团队资源管理器 和 Visual Studio Team Foundation Server 2010 Service Pack 1 的计算机上打开命令提示符窗口。可以从以下目录中运行此工具：驱动器:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE。 对于 64 位计算机，该工具位于驱动器:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE 中。
所需权限
若要使用这些命令，必须将**“管理 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 选项卡，则应包含此标志。 |
/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 标志来移除所有将工作项绑定到团队项目的链接。 只有您指定的类型的工作项会从参与同步上被移除。
提示
如果删除这些任务，您可能会希望先将它们复制到另一个计划，以维护它们的记录。
返回页首
示例
列出已映射的工作项类型
下面的示例检索被配置为参与 AdventureWorksServer 上的 Collection0 中的 Contoso 团队项目的同步的工作项类型。
TfsAdmin ProjectServer /GetMappedWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/Collection0 /teamproject:Contoso
映射团队项目的工作项类型
下面的示例配置用户情景和任务以参与 Contoso 项目的数据同步。
TfsAdmin ProjectServer /MapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/Collection0/ /teamproject:Contoso /workitemtypes:”User Story, Task”
移除团队项目的工作项类型映射
下面的示例从参与 Contoso 项目的数据同步中移除任务。
TfsAdmin ProjectServer /UnmapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/Collection0/ /teamproject:Contoso /workitemtypes:Task
返回页首