管理 Team Foundation Server 与 Project Server 集成的字段映射
您可以自定义同步。Visual Studio Team Foundation Server 2012 与 Microsoft Project Server 之间的数据映射文件中如何通过修改字段。 此文件定义要同步的数据字段以及它们如何同步以支持 Team Foundation Server 和 Project Server 的集成。 可以使用 TfsAdmin ProjectServer 命令行工具中的以下选项来管理此文件：
/DownloadFieldMappings：下载为团队项目集合定义的字段映射文件。
/UploadFieldMappings：验证字段映射文件的 XML 语法，并将其上载到集合。 若要验证语法，但不上载该文件中，您可以使用 /validateonly 选项。
备注
用于将 Team Foundation Server 与 Project Server 集成的字段映射文件不同于 Microsoft Project 的字段映射文件。有关如何下载或上载第二个文件的信息，请参见下载或上载 Microsoft Project 映射文件 [TFSFieldMapping]。
有关字段映射文件的内容以及如何对其进行自定义的更多信息，请参见Team Foundation Server 和 Project Server 集成的字段映射 XML 元素参考和自定义 Project Server 和 Team Foundation 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 服务帐户授予与参与数据同步的 Project Web Access 或 Project Web App (PWA) 实例进行交互的必需权限。 有关更多信息，请参见分配权限以支持 Project Server 和 Team Foundation Server 集成。
备注
即使您是以管理权限登录的，也必须使用提升的权限打开命令提示符窗口，才能在运行 Windows Server 2008 的服务器上执行此功能。若要使用提升的权限打开命令提示符窗口，请选择“开始”，打开“命令提示符”的快捷菜单，然后选择“以管理员身份运行”。有关更多信息，请参见 Microsoft 网站上的以下页面：用户帐户控制。
语法
TfsAdmin ProjectServer /DownloadFieldMappings /collection:tpcUrl /filepath:mappingFile [/encoding:encoding]
TfsAdmin ProjectServer /UploadFieldMappings /collection:tpcUrl /filePath:mappingFile [/encoding:encoding] [/validateOnly] [/useDefaultFieldMappings] [/force]
参数
Parameter |
描述 |
|---|---|
/collection:tpcURL |
指定团队项目集合的统一资源定位器 (URL)。 可以按以下格式指定 URL： http://服务器名称:端口/虚拟目录名称/集合名称 如果不指定虚拟目录，则必须按以下格式指定 URI： http://服务器名称:端口/集合名称 |
/filePath:mappingFile |
指定包含字段映射的 XML 定义文件的路径和文件名。 .gif "说明") 说明
如果您使用的是 Windows Vista，则可能无权访问某些文件夹。如果尝试将工作项类型导出到您没有权限的位置，注册表虚拟化技术将自动重定向导出的文件，并将其保存到虚拟存储区。若要避免此重定向操作，可以将该文件导出到您拥有权限的位置。有关更多信息，请参见 Microsoft 网站的以下页面：Registry Virtualization（注册表虚拟化）和 Common file and registry virtualization issues in Windows Vista（Windows Vista 中常见的文件和注册表虚拟化问题）。
|
/encoding:encoding |
指定 .NET Framework 2.0 的编码格式的名称。 该命令将导出或导入您指定的编码格式的 XML 数据。 例如，/e:utf-7 指定 Unicode (UTF-7) 编码。 如果不指定此参数，该命令将会尝试检测编码，并且如果检测失败，将使用 UTF-8。 |
/validateOnly |
验证映射文件，但不上载它。 |
/useDefaultFieldMappings |
上载默认字段映射，而不是自定义映射文件。 有关更多信息，请参见Team Foundation Server 和 Project Server 集成的字段映射 XML 元素参考。 |
/force |
覆盖现有的映射文件。 您必须指定该选项，如果指定 /useDefaultFieldMappings 开关，当您在不同的映射时替换现有映射。 |
返回页首
备注
只能将企业自定义字段或内置字段映射到 Project Server。 必须在 Project 元素中指定有效字段的名称。 若要确定内置字段的名称，请移除友好名称中的任何空格，并在结果中加入前缀“pj”。 例如，状态管理器的字段名称是 pjStatusManager，自定义 01 的字段名称是 pjCustom01。 存在有关如何映射内置和自定义字段的限制，并且必须匹字段的数据类型。 有关更多信息，请参见针对与 Team Foundation Server 的集成映射 Project Server 字段的限制。
当您运行 TFSAdmin ProjectServer 命令时，会显示一条消息，指明正在执行的操作和受影响的对象。 例如，下面的消息表示正在下载字段映射文件：
Download field mappings from DefaultCollection
命令操作完成后，会显示另一条消息。 例如，下载字段映射文件后，将显示以下消息：
You have downloaded field mappings to C:MappingFile. . . Done.
.gif "Gg412643.collapse_all(zh-cn,VS.110).gif")
有关上载字段映射的注意事项
如果字段映射文件已成功上载，就会进行以下更改：
Team Foundation 中的每个镜像字段都被配置为符合映射字段。
对于已经针对集合或团队项目进行了映射的工作项类型，新映射会显示在工作项表单的 Project Server 选项卡上。
重要
将字段从 Team Foundation Server 映射到 Project Server 时，请确保该字段与这些字段的数据类型匹配。否则，当尝试上载字段映射时，可能会出现以下错误：
索引(从零开始)必须大于或等于零，且小于参数列表的大小。
有关更多信息，请参见Data Types and Field Mapping Criteria。
返回页首
示例
下载为团队项目集合定义的字段映射文件
下面的示例将为 AdventureWorksCollection 定义的字段映射下载到 AWMappingFile.xml。
TfsAdmin ProjectServer /DownloadFieldMappings /collection:http://AdventureWorksServer:8080/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"
为团队项目集合上载字段映射文件
为 AdventureWorksCollection 下面的示例上载 AWMappingFile.xml。
TfsAdmin ProjectServer /UploadFieldMappings /collection:http://AdventureWorksServer:8080/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"
返回页首
请参见
任务
配置 Team Foundation Server 与 Project Server 的集成
概念
Team Foundation Server 和 Project Server 集成的字段映射 XML 元素参考
针对与 Team Foundation Server 的集成映射 Project Server 字段的限制
管理 Project Server 与 TfsAdmin ProjectServer 的集成