下载或上载 Microsoft Project 映射文件 [TFSFieldMapping]

  • 项目

使用 TFSFieldMapping 上载和下载 Microsoft Project 映射文件。 此文件可控制 Microsoft Project 如何将任务发布到已在 Visual Studio Team Foundation Server 2013 中创建的指定团队项目。 例如，你可以修改该文件以支持添加到工作项类型的字段，也可以修改发布和刷新现有字段的方式。

你可以指定将 Team Foundation 中的哪些字段映射到 Microsoft Project 字段。 你还可以通过 PublishOnly 特性控制发布行为，并指定特殊字段（例如上下文字段）。 有关映射文件的完整 XML 语法，请参阅 自定义 Microsoft Project 字段映射文件。 此文件与在过程模板中定义的用于创建团队项目的文件相同。 请参见将 Microsoft Project 字段映射到 Team Foundation 字段

若要访问 TFSFieldMapping 命令行工具，请打开安装了 Project 以及团队资源管理器或 TFS 的“命令提示符”窗口，然后输入：

cd %programfiles%\Common Files\microsoft shared\Team Foundation Server\12.0

备注

即使你使用管理权限登录，也必须打开提升的命令提示符以在运行 Windows Server 2008 的服务器上执行此功能。若要打开提升的命令提示符，请选择“开始”、打开“命令提示符”的上下文菜单，然后选择“以管理员身份运行”。有关详细信息，请参阅 Microsoft 网站。

所需权限

若要使用 TFSFieldMapping 命令，你必须是“Team Foundation Administrators”或“Project Administrators”安全组的成员。 有关详细信息，请参阅Team Foundation Server 权限参考。

TFSFieldMapping upload | download /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile

参数

参数

描述

upload | download

指定是下载还是上载字段映射文件。

/collection:CollectionURL

采用以下格式指定团队项目集合的 URI：http://ServerName:Port/VirtualDirectoryName/CollectionName

如果你未指定使用虚拟目录，必须使用以下格式：

http://ServerName:Port/CollectionName

如果你之前已连接到该服务器，则可以指定该服务器的友好名称（而非 URI）。

/teamproject:ProjectName

指定要修改其映射参数的团队项目的名称。 如果该名称包含空格，则将其包含在引号中。

/mappingfile:MappingFile

指定映射文件的名称和文件路径。

更改工作项字段映射到 Project 的方式

  1. 打开安装了 Project 以及团队资源管理器或 TFS 的“命令提示符”窗口，然后输入：

    cd %programfiles%\Common Files\microsoft shared\Team Foundation Server\12.0

    提示

    要下载映射文件，不需要 Project，但要上载该文件则需要它。

  2. 通过输入以下命令下载映射文件：

    TFSFieldMapping download /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile

    提示

    如果名称包含空格，请将该名称包含在引号中。

  3. 在文本编辑器或 XML 编辑器中打开映射文件。

  4. 采用以下格式添加新映射或编辑现有映射：

    <Mapping WorkItemTrackingFieldReferenceName="System.Id" 
   ProjectField=""
   ProjectName=""
   ProjectUnits=""
   PublishOnly=""
   IfSummaryRefreshOnly=""/>

    例如，若要将其他计划字段添加到使用 Scrum 过程模板创建的团队项目，请添加以下映射：

    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.StartDate" ProjectField="pjTaskStart" PublishOnly="true" />
<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.FinishDate" ProjectField="pjTaskFinish" PublishOnly="true" />
<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.OriginalEstimate" ProjectField="pjTaskBaselineWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" />
<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.CompletedWork" ProjectField="pjTaskActualWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" />

    默认 Scrum 模板仅将“剩余工作”字段映射到 Project。

    备注

    有关 ProjectField 特性的所有 Office Project 字段值的完整列表，请参阅 Microsoft Project 中的字段映射。

  5. （可选）指示是否发布但不刷新该字段。 将 PublishOnly 特性添加到该字段的映射部分，并将该特性设置为 true。 此特性可用于允许团队成员查看字段值，但不能在 Team Foundation 中更改该值。

  6. （可选）指示摘要任务要在 Project 中进行刷新的方式。 添加 fSummaryRefreshOnly="true" 特性以指示当字段行是 Project 中的摘要任务、该摘要任务具有“发布和刷新=是”以及摘要任务包含发布到 TFS 的至少一个子任务时，该字段永远不会发布到工作项数据库，但会从工作项数据库中进行刷新。

  7. 保存并上载该文件：

    TFSFieldMapping upload /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile

请参见

参考

Microsoft Project 中的字段映射

概念

自定义 Microsoft Project 字段映射文件