Microsoft Project 欄位對應檔

更新：2010 年 10 月

您可以自訂針對 Team Foundation 工作項目定義的欄位如何對應至 Microsoft Project 中的欄位，以及變更特定欄位的發行方式。 在 Microsoft Project 欄位對應檔中，您可以定義 Team Foundation 欄位和 Microsoft Project 欄位之間的對應。 Microsoft Project 包含預先定義的欄位 (例如工作名稱) 以及自訂欄位。 當您發行或重新整理 Microsoft Project 中的工作項目資料時，欄位對應就會判斷工作項目資料庫中的哪些欄位是對應到 Microsoft Project 中的欄位。

您在對應檔中指定每個 Team 專案的欄位。 若要擷取對應檔，您必須從 Team 專案中將它下載下來。 在修改檔案之後，您可以將其上載至 Team 專案，讓變更套用至該 Team 專案的所有使用者。 如需如何下載或上載 Microsoft Project 欄位對應檔的詳細資訊，請參閱 下載或上傳 Microsoft Project 欄位對應檔。

本主題內容

• 對應項目

• ReservedField 項目

• SyncField 項目

• ResourceNameSeparator 項目

• 階層式連結類型

• 相依性連結類型

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

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 總管中更新的計算欄位。 如果設定為 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 總管更新所導致的錯誤。

<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 中如何使用同步欄位的詳細資訊，請參閱 發行或重新整理 Office 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 值。 下表指出指派給摘要工作或父工作的 [發行並重新整理] 值以及對應欄位屬性，會如何決定是否發行或重新整理摘要工作或父工作。

回到頁首

請參閱

概念

使用連結類型

其他資源

自訂 Microsoft Project 欄位對應

變更記錄