管理 TFS-Project Server 集成的字段映射
您可以自定义如何通过修改字段映射文件同步在 Visual Studio Team Foundation Server (TFS) 和 Microsoft 项目服务器之间的数据。 此文件定义要同步的数据字段以及它们如何同步以支持 TFS 和 Project Server 的集成。 可以使用 TfsAdmin ProjectServer 命令行工具中的以下选项来管理此文件：
/DownloadFieldMappings：下载为团队项目集合定义的字段映射文件。
/UploadFieldMappings：验证字段映射文件的 XML 语法，并将其上载到集合。 若要验证语法，但不上载该文件中，您可以使用 /validateonly 选项。
备注
用于将 Team Foundation Server 与 Project Server 集成的字段映射文件不同于 Microsoft Project 的字段映射文件。有关如何下载或上载第二个文件的信息，请参见下载或上载 Microsoft Project 映射文件 [TFSFieldMapping]。
有关字段映射文件的内容以及如何对其进行自定义的更多信息，请参见TFS-Project Server 集成的字段映射 XML 元素引用和自定义 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 服务帐户授予与参与数据同步的 Project Web Access 或 Project Web App (PWA) 实例进行交互的必需权限。 有关详细信息，请参阅分配权限以支持 TFS-Project 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://ServerName:Port/VirtualDirectoryName/CollectionName 如果不指定虚拟目录，则必须按以下格式指定 URI： http://ServerName:Port/CollectionName |
/filePath:mappingFile |
指定包含字段映射的 XML 定义文件的路径和文件名。 备注 如果您使用的是 Windows Vista，则可能无权访问某些文件夹。如果尝试将工作项类型导出到您没有权限的位置，注册表虚拟化技术将自动重定向导出的文件，并将其保存到虚拟存储区。若要避免此重定向操作，可以将该文件导出到您拥有权限的位置。有关详细信息，请参见 Microsoft 网站的以下页面：Registry Virtualization（注册表虚拟化）and 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 |
上载默认字段映射，而不是自定义映射文件。 有关详细信息，请参阅TFS-Project Server 集成的字段映射 XML 元素引用。 |
/force |
覆盖现有的映射文件。 当您用不同的映射替换这些已存在的映射时，如果您要指定 /useDefaultFieldMappings 交换机，则必须指定此选项。 |
备注
只能将企业自定义字段或内置字段映射到 Project Server。 必须在 Project 元素中指定有效字段的名称。 若要确定内置字段的名称，请移除友好名称中的任何空格，并在结果中加入前缀“pj”。 例如，状态管理器的字段名称是 pjStatusManager，自定义 01 的字段名称是 pjCustom01。 存在有关如何映射内置和自定义字段的限制，并且必须匹字段的数据类型。 有关详细信息，请参阅对在 TFS-Project Server 集成中映射 Project Server 字段的限制。
当您运行 TFSAdmin ProjectServer 命令时，会显示一条消息，指明正在执行的操作和受影响的对象。 例如，下面的消息表示正在下载字段映射文件：
Download field mappings from DefaultCollection
命令操作完成后，会显示另一条消息。 例如，下载字段映射文件后，将显示以下消息：
You have downloaded field mappings to C:MappingFile. . . Done.
请注意上传字段映射。
如果字段映射文件已成功上载，就会进行以下更改：
Team Foundation 中的每个镜像字段都被配置为符合映射字段。
对于已经针对集合或团队项目进行了映射的工作项类型，新映射会显示在工作项表单的 Project Server 选项卡上。
重要
将字段从 Team Foundation Server 映射到 Project Server 时，请确保该字段与这些字段的数据类型匹配。否则，当尝试上载字段映射时，可能会出现以下错误：
索引(从零开始)必须大于或等于零，且小于参数列表的大小。
有关详细信息，请参见数据类型和字段映射标准。
示例
下载为团队项目集合定义的字段映射文件
下面的示例将为 AdventureWorksCollection 定义的字段映射下载到 AWMappingFile.xml。
TfsAdmin ProjectServer /DownloadFieldMappings /collection:http://AdventureWorksServer:8080/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"
为团队项目集合上传字段映射文件
下面的示例上传 AWMappingFile.xml 给 AdventureWorksCollection。
TfsAdmin ProjectServer /UploadFieldMappings /collection:http://AdventureWorksServer:8080/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"
请参见
任务
概念
TFS-Project Server 集成的字段映射 XML 元素引用
对在 TFS-Project Server 集成中映射 Project Server 字段的限制
映射集成组件 [TfsAdmin ProjectServer]