定义可用于同步的工作项类型
您在 Visual Studio Team Foundation Server (TFS) 和 Microsoft Project 服务器之间同步数据前,您必须先配置这两个服务器产品的集成。 作为配置任务的一部分,您必须将企业项目计划与团队项目相关联,而且必须指定要参与同步的工作项的类型。 在进行初始配置和映射后,您可以更改已映射工作项的类型。
可以使用 TfsAdmin ProjectServer 命令行工具中的以下选项来管理参与同步的工作项的类型:
/MapWorkItemTypes:为团队项目定义可参与同步的工作项的类型。 尽管可以映射多种类型,但只有那些提交以供发布的工作项会被同步。
/GetMappedWorkItemTypes:返回配置为参与团队项目同步的工作项类型的列表。
/UnmapWorkItemTypes:从参与团队项目同步中移除工作项类型。
有关如何集成这两个服务器产品的概述,请参见配置 TFS-Project Server 集成。 如何如何将企业项目相与团队项目关联的概述,请参见管理企业项目与团队项目的关联。
若要运行 TfsAdmin ProjectServer 命令行工具,请在安装了 Visual Studio 或团队资源管理器的情况下打开命令提示符窗口,然后输入:
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
在 32 位 Windows 版本上,将 %programfiles(x86)% 替换为 %programfiles%.。
要求
若要使用这些命令,必须将**“管理 Project Server 集成”权限设置为“允许”**。 此外,必须还要向 Team Foundation Server 的服务帐户授予与参与数据同步的 PWA 实例进行交互所需的权限。有关详细信息,请参阅分配权限以支持 TFS-Project Server 集成。
语法
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://ServerName:Port/VirtualDirectoryName/CollectionName 如果不指定虚拟目录,则必须按以下格式指定 URL: http://ServerName:Port/CollectionName |
/teamProject:TeamProjectName |
指定在项目集合中定义的团队项目的名称。 |
/workItemTypes:ListofWorkItemTypes |
以逗号分隔列表的格式指定一个或多个工作项类型的引用名称。 您应该仅指定要在 Project Professional 中跟踪其数据的那些工作项类型。 例如,你可以指定以下工作项类型,以支持形式为 “User Story,Task” 或 “User Story”,Task 的敏捷过程。 逗号后面不能有空格。 |
/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 标志来移除所有将工作项绑定到团队项目的链接。 只有您指定的类型的工作项会从参与同步上被移除。
提示
如果删除这些任务,您可能会希望先将它们复制到另一个计划,以维护它们的记录。
示例
列出已映射的工作项类型
下面的示例检索被配置为参与 AdventureWorksServer 上的 DefaultCollection 中的 Contoso 团队项目的同步的工作项类型。
TfsAdmin ProjectServer /GetMappedWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /teamproject:Contoso
映射团队项目的工作项类型
下面的示例配置用户情景和任务以参与 Contoso 项目的数据同步。
TfsAdmin ProjectServer /MapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ /teamProject:Contoso /workitemtypes:”User Story, Task”
移除团队项目的工作项类型映射
下面的示例从参与 Contoso 项目的数据同步中移除任务。
TfsAdmin ProjectServer /UnmapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ /teamProject:Contoso /workitemtypes:Task
请参见
概念
映射集成组件 [TfsAdmin ProjectServer]