Microsoft Project 字段映射文件

更新：2007 年 11 月

Microsoft Project 字段映射文件定义 Team Foundation 字段与 Microsoft Project 字段之间的字段映射。与 Microsoft Excel 不同，Microsoft Project 使用有限的字段集合（包括“任务名”这样的预定义字段和自定义字段）。当用户在 Microsoft Project 文件中发布或刷新工作项数据时，字段映射可用于确定工作项数据库中的哪些字段与 Microsoft Project 中的字段匹配。

字段映射文件是按每个团队项目来指定的。要获得字段映射文件，必须从团队项目下载。进行更改之后，将该文件上载到团队项目；所做的更改将应用于该团队项目的所有用户。有关如何下载或上载 Microsoft Project 字段映射文件的更多信息，请参见如何：下载或上载 Microsoft Project 字段映射文件。

字段映射

要指定工作项字段与项目列之间的映射，请使用 Mapping 元素。

使用以下 XML 语法指定工作项类型字段与 Microsoft Project 字段之间的映射。Mapping 元素用于指定字段映射。

<Mapping WorkItemTrackingFieldReferenceName="" 
         ProjectField=""
         ProjectName=""
         ProjectUnits=""
         PublishOnly=""/>

Mapping 属性

下表介绍可用于 Mapping 元素的属性。

属性	说明
WorkItemTrackingFieldReferenceName	必需。指定工作项类型字段的引用名称。
ProjectField	必需。指定 Microsoft Project 字段的名称。通过在名称前添加“pj”前缀来指定预定义的字段名称，例如指定 pjTaskName 作为“任务名”列的名称。将自定义字段指定为 pjTaskText 并在后面跟一个数字，例如 pjTaskText11。
ProjectName	可选元素。指定将作为列名称显示给用户的名称。如果未指定该属性，将使用工作项类型字段名称。
ProjectUnits	可选元素。指定将字段类型映射到 Microsoft Project 时使用的单位类型。有效值为 pjMinute、pjHour、pjDay、pjWeek 和 pjMonthUnit。
PublishOnly	可选元素。如果设置为 true，字段则指示将发布到工作项数据库，但不刷新。该值通常用于不应当在 团队资源管理器 中更新的计算字段。如果设置为 no，则表示字段会发布并刷新。如果不指定，则默认值为 no。

下面的示例演示如何将包含标题的工作项类型字段映射到任务名称的 Microsoft Project 字段：

<Mapping WorkItemTrackingFieldReferenceName="System.Title" 
         ProjectField="pjTaskName"/>

下面的 XML 语法演示一个更复杂的示例，该示例说明如何将具有开始日期的工作项类型字段映射到开始日期的 Microsoft Project 字段。由于该字段是计算字段，因此它被指定为发布但不刷新，以避免由于 团队资源管理器 更新而带来的错误。

<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.StartDate" ProjectField="pjTaskStart" PublishOnly="true"/>

说明：
最好的做法是将 Microsoft Project 中的计算字段映射到 Team Foundation 中的只读字段。这有助于避免混乱，使团队成员不会尝试更改计算字段。

上下文字段

上下文字段是一个工作项类型字段，显示有关任务与摘要任务的层次结构关系的信息。上下文字段显示在团队资源管理器中，这样不使用 Microsoft Project 的用户也能查看某个子任务属于哪些摘要任务。

如果某个任务是子任务，则上下文字段将包含该任务及其摘要任务的文本名称。例如，如果任务“制定测试计划”是“计划任务”的子任务，则上下文字段应显示“计划任务”>“制定测试计划”。如果某个任务属于多个摘要任务，则上下文字段将列出所有这些摘要任务，直到达到最大字符数限制。

使用以下 XML 语法可以指定哪个工作项类型字段为上下文字段。ContextField 元素用于指定上下文字段。必须将 WorkItemTrackingFieldReferenceName 属性设置为现有工作项类型字段的有效引用名称。

<ContextField WorkItemTrackingFieldReferenceName="" />

下面的示例演示如何将 Microsoft.VSTS.Scheduling.TaskHierarchy 指定为上下文字段。

<ContextField WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.TaskHierarchy" />

链接和附件字段

链接和附件字段是只读字段，指示任务是否有链接和附件。此字段显示“是”或“否”，具体取决于是否有链接和附件。当您使用“Team System 任务单”视图时，此字段显示为带有标题“链接和附件”的列。

使用下面的 XML 语法指定哪个 Microsoft Project 字段应显示链接和附件信息。LinksField 元素用于指定链接字段。ProjectField 属性必须设置为有效的 Microsoft Project 字段。在 Microsoft Project 字段映射文件中指定链接字段是可选的。

<LinksField ProjectField="" />

下面的示例演示如何将 pjTaskText26 指定为链接和附件字段：

<LinksField ProjectField="pjTaskText26" />

同步字段

使用同步字段可以控制每个任务的发布和刷新行为。当您使用“Team System 任务单”视图时，此字段显示为带有标题“发布并刷新”的列。有关如何在 Microsoft Project 中使用同步字段的更多信息，请参见如何：在 Microsoft Project 中启用或禁用工作项发布。

您必须在 Microsoft Project 字段映射文件中指定同步字段。使用下面的 XML 语法指定哪个字段是同步字段。SyncField 元素用于指定同步字段。ProjectField 属性必须设置为有效的 Microsoft Project 字段。

<SyncField ProjectField="" />

下面的示例演示如何将 pjTaskText25 指定为同步字段：

<SyncField ProjectField="pjTaskText25" />

请参见

其他资源

自定义 Microsoft Project 字段映射