对在 TFS-Project Server 集成中映射 Project Server 字段的限制

当您添加字段来参与 Visual Studio Team Foundation Server (TFS) and Microsoft Project Server之间的数据同步时,请确保没有映射受限的字段。 可以通过自定义团队项目集合的字段映射来映射字段。 可以映射 Project 中的内置字段和自定义字段。 这些字段中有一些只能映射到状态队列,而另一些只能映射到TFS。 通常,应将资源级信息(pjResource* 字段)从 Team Foundation Server 映射到 Project Server 的 tfsToTarget 元素中,并仅将任务级信息(pjTask*fields 字段)从 Project Server 映射到TFS targetToTfs中的元素。 有关详细信息,请参阅TFS-Project Server 集成的字段映射 XML 元素引用

还必须根据本主题中描述的标准,匹配内置和自定义的映射字段的数据类型。 有关内置字段的更多信息,请参见可用字段引用.

主题内容

  • 对度量单位和重命名的限制

  • 任务名称和工作项标题字段

  • 只能映射到状态队列的字段

  • 只能从 Project Server 映射到 Team Foundation 的字段

  • 禁止映射的字段

  • 数据类型和字段映射标准

对度量单位和重命名的限制

以下限制适用于参与数据同步的字段的映射:

  • 无法自定义映射字段的单位。 例如,在将 pjResourceAssignmentUnits 添加到字段映射时,会使用百分比作为单位添加它,并且您无法更改该度量值。

  • 虽然可以将**“完成日期”**(pjFinishDate) 字段添加到映射,但在 Team Foundation 中设置的任何值都不会发送到 Project Server。 此限制是设计使然。 项目经理必须在企业项目计划中设置“完成日期”。

  • 如果重命名 Project 中的 ActiveTfsAssignment(TFS) 字段并尝试发布企业项目计划,则将出现**“验证解决方法”**对话框。 若要解决此问题,您必须将该字段重命名为其原始名称。

任务名称和工作项标题字段

仅将项目**“名称”** (pjTaskName) 字段从 Project Server 映射至 Team Foundation 和状态队列。 此字段映射至 Team Foundation 中的“标题”(System.Title) 字段。 任何其他字段都无法同时映射到 Team Foundation Server 和状态队列。 这一双向映射允许企业项目计划和团队计划中的更改双向流动。

以下字段映射代码演示了这种映射:

<field tfsName="System.Title" tfsMirrorName="Mirror.System.Title" displayTfsField="false" displayTfsMirror="false" onConflict="PSWin">
   <tfsToTarget>
      <target provider="ProjectServerStatusQueue" name="pjTaskName" />
   </tfsToTarget>
   <targetToTfs>
      <target provider="ProjectServerPublished" name="pjTaskName" />
   </targetToTfs>
</field>

可映射到状态队列的字段

可以将以下与资源相关的字段从 Project Server 映射到状态队列。 可以在tfsToTarget 元素中将这些字段添加到字段映射,以将状态更新发送给 Project Server。

  • pjResourceActualFinish

  • pjResourceActualOvertimeWork

  • pjResourceActualStart

  • pjResourceActualWork

  • pjResourceAssignmentUnits

  • pjResourceConfirmed

  • pjResourceFinish

  • pjResourceOvertimeWork

  • pjResourcePercentWorkComplete

  • pjResourceRegularWork

  • pjResourceRemainingOvertimeWork

  • pjResourceRemainingWork

  • pjResourceStart

  • pjResourceUpdatesNeeded

  • pjResourceWork

在下面的示例中,Project Server 资源工作字段映射到状态队列目标的 Team Foundation 中的 MSFT.MappedTopjResourceWork 字段。

<field tfsName="MSFT.MappedTopjResourceWork" tfsMirrorName="Mirror.MSFT.MappedTopjResourceWork" displayTfsField="true" displayTfsMirror="true">
   <tfsToTarget>
       <target provider="ProjectServerStatusQueue" name="pjResourceWork" />
   </tfsToTarget>
</field>

还可以组合资源特定字段和任务特定字段的映射以形成完整的映射。 在下面的示例中,在 targetToTfs 元素中映射 pjTaskWork 字段,以提供完整的往返过程映射。

<field tfsName="MSFT.MappedTopjResourceWork" tfsMirrorName="Mirror.MSFT.MappedTopjResourceWork" displayTfsField="true" displayTfsMirror="true">
   <tfsToTarget>
       <target provider="ProjectServerStatusQueue" name="pjResourceWork" />
   </tfsToTarget>
   <targetToTfs>
       <target provider=" ProjectServerPublished" name="pjTaskWork"/>
   </targetToTfs>
</field>

只能从 Project Server 映射到 Team Foundation 的字段

可以将以下任务特定字段从 Project Server 映射到 Team Foundation Server。 还可以组合任务特定字段和资源特定字段的映射以形成完整的映射。

  • pjTaskActualCost

  • pjTaskActualDuration

  • pjTaskActualFinish

  • pjTaskActualOvertimeCost

  • pjTaskActualOvertimeWork

  • pjTaskActualStart

  • pjTaskActualWork

  • pjTaskACWP

  • pjTaskBCWP

  • pjTaskBCWS

       

  • pjTaskBudgetCost

  • pjTaskBudgetWork

  • pjTaskCost

  • pjTaskCPI

  • pjTaskCreated

  • pjTaskCV

  • pjTaskCVPercent

  • pjTaskDeadline

  • pjTaskDuration

  • pjTaskDuration1

  • pjTaskDurationVariance

  • pjTaskEAC

  • pjTaskEarlyFinish

  • pjTaskEarlyStart

  • pjTaskExternalTask

  • pjTaskFinish

  • pjTaskFinishVariance

  • pjTaskFixedCost

  • pjTaskFreeSlack

  • pjTaskHyperlink

       

  • pjTaskHyperlinkAddress

  • pjTaskHyperlinkSubAddress

  • pjTaskIgnoreResourceCalendar

  • pjTaskLateFinish

  • pjTaskLateStart

  • pjTaskOverallocated

  • pjTaskOvertimeCost

  • pjTaskOvertimeWork

  • pjTaskPercentComplete

  • pjTaskPercentWorkComplete

  • pjTaskPhysicalPercentComplete

  • pjTaskPriority

  • pjTaskRecurring

  • pjTaskRegularWork

  • pjTaskRemainingCost

  • pjTaskRemainingOvertimeCost

  • pjTaskRemainingOvertimeWork

  • pjTaskRemainingWork

  • pjTaskSPI

  • pjTaskStart

       

  • pjTaskStartVariance

  • pjTaskSummary

  • pjTaskSV

  • pjTaskSVPercent

  • pjTaskTCPI

  • pjTaskTotalSlack

  • pjTaskVAC

  • pjTaskWork

  • pjTaskWorkVariance

  • pjTaskBaselineCost

  • pjTaskBaselineWork

  • pjTaskBaselineBudgetCost

  • pjTaskBaselineBudgetWork

  • pjTaskBaselineDuration

  • pjTaskBaselineStart

  • pjTaskBaselineFinish

       

  • pjTaskBaseline1Cost

  • pjTaskBaseline1Work

  • pjTaskBaseline1BudgetCost

  • pjTaskBaseline1BudgetWork

  • pjTaskBaseline1Duration

  • pjTaskBaseline1Start

  • pjTaskBaseline1Finish

       . . . 

  • pjTaskBaseline10Cost

  • pjTaskBaseline10Work

  • pjTaskBaseline10BudgetCost

  • pjTaskBaseline10BudgetWork

  • pjTaskBaseline10Duration

  • pjTaskBaseline10Start

  • pjTaskBaseline10Finish

在下面的示例中,Project Server 资源工作字段映射到 Team Foundation Server 目标的 Team Foundation 中的 MSFT.MappedTopjTaskBaseline1Start 字段。

<field tfsName="MSFT.MappedTopjTaskBaseline1Start" tfsMirrorName="Mirror.MSFT.MappedTopjTaskBaseline1Start" displayTfsField="true" displayTfsMirror="true">
   <targetToTfs>
       <target provider="ProjectServerPublished" name="pjTaskBaseline1Start" />
   </targetToTfs>
</field>

禁止映射的字段

禁止映射以下 Project Server 字段。 不要将这些字段添加到 Team Foundation 和 Project Server 之间的字段映射中。

  • pjResourceID

  • pjResourceNotes

  • pjTaskCalendar

  • pjTaskCalendarGUID

  • pjTaskCommitmentFinish

  • pjTaskCommitmentGuid

  • pjTaskCommitmentStart

  • pjTaskCommitmentType

  • pjTaskConfirmed

  • pjTaskConstraintDate

  • pjTaskConstraintType

  • pjTaskContact

  • pjTaskCritical

  • pjTaskDelay

  • pjTaskHyperlinkScreenTip

  • pjTaskID

  • pjTaskLevelCanSplit

  • pjTaskLevelDelay

  • pjTaskNotes

  • pjTaskParentTask

  • pjTaskPreleveledFinish

  • pjTaskPreleveledStart

  • pjTaskProject

  • pjTaskResume

  • pjTaskRollup

  • pjTaskStartSlack

  • pjTaskStop

  • pjTaskSubproject

  • pjTaskSubprojectReadOnly

  • pjTaskSuccessors

  • pjTaskUniqueID

  • pjTaskWBS

数据类型和字段映射标准

在将字段从 Team Foundation Server 映射到 Project Server 时,请确保根据下表中介绍的标准,将 Project Server 字段的数据类型与为 Team Foundation 字段定义的数据类型相匹配。 除了本主题中前面列出的内置字段外,还可以创建自定义企业任务类型字段并映射这些字段以支持任一方向或两个方向的同步。 对于自定义字段,请确保按照表第三列中的指示匹配字段的数据类型。 有关详细信息,请参阅 创建查找表和企业定制字段.

备注

工作和任务持续时间的单位用小时指定。无法自定义单位。

Team Foundation Server

Project Server 内置字段

Project Server 自定义企业字段

DateTime

日期

日期

Double

工作、成本、持续时间、计数、百分比

数量、成本、持续时间

Integer

计数、百分比

数字

字符串

Text

Text

TreePath

Text

Text

请参见

概念

TFS-Project Server 集成的字段映射 XML 元素引用

其他资源

自定义 TFS 与 Project Server 之间的字段映射