管理 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 选项。
.gif "说明") 说明 |
|---|
用于将 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 定义文件的路径和文件名。 说明
如果您使用的是 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 选项卡上。
.gif "重要说明") 重要事项 |
|---|
将字段从 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 的集成