自訂 Microsoft Project 欄位對應檔

您可以自訂定義於 Team Foundation 中的工作項目欄位如何對應 Microsoft Project 中的欄位，而且您可以變更特定欄位發行的方式。 Microsoft Project 包含預先定義的欄位，例如 [工作名稱] 和自訂欄位。 當您發行或重新整理 Microsoft Project 中的工作項目資料時，欄位對應會判斷工作項目資料庫中的哪些欄位與 Microsoft Project 中的欄位相符。

如需使用專案和 TFS 追蹤工作的資訊，請參閱使用 Project 建立您的待處理項目和工作。

若要修改 Team 專案的欄位對應，您可以使用 TFSFieldMapping 命令列工具匯出然後匯入 Microsoft Project 對應檔。

Mapping 項目

若要指定工作項目欄位和專案資料行之間的對應，您可以使用 Mapping 項目。

您可以使用下列 XML 語法來指定工作項目類型欄位和 Microsoft Project 欄位之間的對應。 然後使用 Mapping 項目指定欄位的對應。

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

屬性

下表描述可以和 Mapping 項目搭配使用的屬性。

屬性	描述
WorkItemTrackingFieldReferenceName	必要項。 指定工作項目類型中的欄位參考名稱。
ProjectField	必要項。 輸入 Microsoft Project 中的欄位名稱。 在名稱前面加上 "pj"，指定預先定義的欄位名稱，例如 [工作名稱] 資料行的 pjTaskName。 將自訂欄位指定為 pjTaskText，後面接數字，例如 pjTaskText11。
ProjectName	選擇項。 指定要在 Microsoft Project 中顯示為資料行名稱的名稱。 如果您沒有指定這個屬性，會使用工作項目類型的欄位名稱。
ProjectUnits	選擇項。 指定將欄位類型對應至 Microsoft Project 時要使用的單位類型。 您可以指定下列值：pjMinute、pjHour、pjDay、pjWeek 和 pjMonthUnit。 注意事項 您可以只為指定持續時間或其他時間單位的欄位指定 ProjectUnits。
PublishOnly	選擇項。 如果設定為 true，表示欄位會發行至工作項目資料庫，但不是會重新整理。 這個值通常用於不應在 Team Explorer 中更新的導出欄位。 如果設定為 false，表示會發行並重新整理該欄位。 預設值是 false。 在預設的對應檔案中，有兩個欄位的 PublishOnly 屬性設定為 true，這兩個欄位分別是 [開始日期] 和 [完成日期]。
IfSummaryRefreshOnly	選擇項。 如果設定為 true，表示欄位永遠不會發行至工作項目資料庫，但是當下列條件也成立，會從工作項目資料庫重新整理： 欄位的資料列是 Office Project 中的摘要工作。 摘要工作具有設為 Yes 的「發行」和「重新整理」值。 摘要工作包含至少一個繫結至 Team Foundation Server 的子工作。 任何 Microsoft Project 建立的更新或計算，均可以覆寫會從專案計劃中的工作項目資料庫重新整理的值。不過，修改過的值永遠不會儲存到工作項目資料庫。 這個屬性通常用於摘要欄位，所以如果該欄位發行至工作項目資料庫，會導致資料不一致。 如果設定為 false，表示可能會發行並重新整理該欄位。 未指定時預設值為 false。 注意事項 指派給 IfSummaryRefreshOnly 屬性的值，會取代指派給 PublishOnly 的值。如需詳細資訊，請參閱本主題稍後的影響發行和重新整理的欄位。 在預設的對應檔案中，IfSummaryRefreshOnly 屬性會為 [原始評估]、[剩餘工作]，和 [已完成工作] 欄位設定為 true。

下列範例示範如何將含有標題的工作項目類型欄位對應至工作名稱的 Microsoft Project 欄位：

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

下列 XML 語法示範更複雜的範例，關於如何將含有開始日期的工作項目類型欄位，對應至開始日期的 Microsoft Project 欄位。 因為是計算欄位，所以將其指定為發行但不重新整理，以防止 Team Explorer 更新所導入的錯誤。

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

注意事項
最佳做法是，您應該將 Microsoft Project 中的計算欄位對應至 Team Foundation 中的唯讀欄位。這有助於避免混淆，讓小組成員不會嘗試變更計算欄位。

ReservedField 項目

ReservedField 項目用於支援定義於工作之間的階層式連結，而且是選擇性的項目。

如果沒有在對應中指定這個項目，則 Microsoft Project 會使用預設 pjNumber20 欄位。

SyncField 項目

同步處理欄位可讓您控制每項工作的發行和重新整理行為。 當您使用 Team System 任務工作表檢視時，欄位會顯示為具有發行並重新整理標題的資料行。

您必須指定 Microsoft Project 欄位對應檔中的同步處理欄位。 使用下列 XML 語法來指定哪些欄位是同步處理欄位。 若要指定同步處理欄位，請使用 SyncField 項目。 ProjectField 屬性必須設為有效的 Office Project 欄位。

<SyncField ProjectField="" />

下列範例示範如何指定 pjTaskText25 做為同步處理欄位：

<SyncField ProjectField="pjTaskText25" />

如需如何在 Office Project 中使用同步處理欄位的詳細資訊，請參閱 發行或重新整理 Project 中的工作項目 [重新導向]。

ResourceNameSeparator 項目

您可以使用 ResourceNameSeparator 定義要區分字串中的資源名稱的字元。 Team Foundation 使用者和資源會與 Active Directory 目錄服務的使用者同步。 使用者和資源的名稱可能包含分隔符號，例如以逗號來分隔資源的姓氏、名字和中間名縮寫。

這是選擇性項目。 如果對應中未指定這個項目，則 Microsoft Project 會使用下表中所定義的預設對應，分隔資源名稱：

如果您想要指定與上表中所列不同的字元，則您可以使用下列語法定義 ResourceNameSeparator：

<ResourceNameSeparator WorkItemTrackingCharacter="" ProjectCharacter=""/>

下列範例示範 Team Foundation 字元是 "-" 時，如何指定字元 "*" 做為用於 Office Project 中的分隔符號：

<ResourceNameSeparator WorkItemTrackingCharacter="-" ProjectCharacter="*"/>

階層連結類型

當您建立 Microsoft Project 中的摘要工作時，會在摘要工作、父工作和從屬工作或子工作之間，建立樹狀連結。 Office Project 會使用預設 System.LinkTypes.Hierarchy 來建立這些連結。

相依性連結類型

當您建立 Microsoft Project 中工作之間的連結時，會建立工作之間的相依連結。 前置項工作會指派給「前置項」連結，後置項工作會指派給「後置項」連結。 這些是為 System.LinkTypes.Dependency 連結類型定義的預設指定。

影響發行和重新整理的對應屬性

下列的對應欄位和 Microsoft Project 欄位值會決定工作項目的值為已發行或已重新整理：

• 每個工作項目的發行並重新整理值。

• 特定對應欄位的 PublishOnly 屬性值。

• 特定對應欄位的 IfSummaryRefreshOnly 值。

• 做為摘要工作或父工作的工作類別。

  父工作是至少有一個子工作已發行到 Team Foundation Server 的工作。

不是摘要工作的工作項目

下表指出不是摘要工作或父工作的工作項目，是否為已發行或已重新整理 (根據對應欄位屬性和對項目的發行和重新整理值的指派)。

是摘要工作的工作項目

如果符合摘要工作準則，且 IfSummaryRefreshOnly 是 true，其值會取代 PublishOnly 值。 下表指出摘要工作或父工作是否為已發行或已重新整理 (根據對其發行和重新整理值的指派和對應欄位屬性)。

請參閱

概念

連結類型項目參考

加入或變更 Project 欄位對應至 TFS 欄位的方式