管理 Team Foundation Server 与 Project Server 集成的字段映射

可以通过修改字段映射文件来自定义数据 Visual Studio Team Foundation Server 2010 和 Project Server 之间的同步方式。 此文件定义要同步的数据字段以及它们如何同步以支持 Team Foundation Server 和 Project Server 的集成。 可以使用 TFSAdmin ProjectServer 命令行工具中的以下选项来管理此文件：

• /DownloadFieldMappings：下载为团队项目集合定义的字段映射文件。

• /UploadFieldMappings：验证字段映射文件的 XML 语法，并将其上载到集合。 若要验证语法，但不上载该文件中，您可以使用 /validateonly 选项。

有关字段映射文件的内容以及如何对其进行自定义的更多信息，请参见Team Foundation Server 和 Project Server 集成的字段映射 XML 元素参考和自定义 Project Server 和 Team Foundation 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 服务帐户授予与参与数据同步的 Project Web Access 或 Project Web App (PWA) 实例进行交互的必需权限。 有关更多信息，请参见分配权限以支持 Project Server 和 Team Foundation Server 集成。

语法

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 定义文件的路径和文件名。 注意 如果您使用的是 Windows Vista，则可能无权访问某些文件夹。如果尝试将工作项类型导出到您没有权限的位置，注册表虚拟化技术将自动重定向导出的文件，并将其保存到虚拟存储区。若要避免此重定向操作，可以将该文件导出到您拥有权限的位置。有关更多信息，请参见 Microsoft 网站上的以下网页：Registry Virtualization（注册表虚拟化）和 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	覆盖现有的映射文件。 如果要使用不同的映射替换现有的映射，则必须指定此选项。

返回页首

备注

只能将企业自定义字段或内置字段映射到 Project Server。 必须在 Project 元素中指定有效字段的名称。 若要确定内置字段的名称，请移除友好名称中的任何空格，并在结果中加入前缀“pj”。 例如，状态管理器的字段名称是 pjStatusManager，自定义 01 的字段名称是 pjCustom01。 存在有关如何映射内置和自定义字段的限制，并且必须匹字段的数据类型。 有关更多信息，请参见 针对与 Team Foundation Server 的集成映射 Project Server 字段的限制。

当您运行 TFSAdmin ProjectServer 命令时，会显示一条消息，指明正在执行的操作和受影响的对象。 例如，下面的消息表示正在下载字段映射文件：

Download field mappings from Collection0

命令操作完成后，会显示另一条消息。 例如，下载字段映射文件后，将显示以下消息：

You have downloaded field mappings to C:MappingFile. . . Done.

有关上载字段映射的注意事项

当您运行 /UploadFieldMappings 选项时，将发生以下操作：

• 如果没有为团队项目集合定义字段映射，并且未指定 /useDefaultFieldMappings 选项，将会显示一条消息，提示您创建默认字段映射。

• 如果存在字段映射，并且指定了 /useDefaultFieldMappings 选项，将会显示一条消息要求您确认是否要覆盖现有的映射。

• 如果您要覆盖以前上载到集合的字段映射，则必须指定 /force 选项。

• 在上载字段映射文件之前，对其进行验证。 如果有语法错误，或者如果指定了无效的字段，将会显示一条错误消息。

如果字段映射文件已成功上载，就会进行以下更改：

• Team Foundation 中的每个镜像字段都被配置为符合映射字段。

• 对于已经针对集合或团队项目进行了映射的工作项类型，新映射会显示在工作项表单的 Project Server 选项卡上。

重要事项
将字段从 Team Foundation Server 映射到 Project Server 时，请确保该字段与这些字段的数据类型匹配。 否则，当尝试上载字段映射时，可能会出现以下错误： 索引(从零开始)必须大于或等于零，且小于参数列表的大小。 有关更多信息，请参见 数据类型和字段映射标准。

返回页首

示例

下载为团队项目集合定义的字段映射文件

下面的示例将为 AdventureWorksCollection 定义的字段映射下载到 AWMappingFile.xml。

TfsAdmin ProjectServer /DownloadFieldMappings /collection:http://AdventureWorksServer:8080/Collection0/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"

为团队项目集合上载字段映射文件

下面的示例将 AWMappingFile.xml 上载到 AdventureWorksCollection 并覆盖以前定义的字段映射。

TfsAdmin ProjectServer /UploadFieldMappings /collection:http://AdventureWorksServer:8080/Collection0/AdventureWorksCollection /filePath:"C:AWMappingFile.xml" /force

返回页首

请参见

其他资源

配置 Team Foundation Server 与 Project Server 的集成

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

Team Foundation Server 和 Project Server 集成的字段映射 XML 元素参考

针对与 Team Foundation Server 的集成映射 Project Server 字段的限制

管理 Project Server 与 TFSAdmin ProjectServer 的集成