Share via


加入至 TFS 以支援資料同步處理的 Project Server 欄位

當您指定某個工作項目類型參與 Visual Studio Team Foundation Server 和 Microsoft Project Server 之間的資料同步處理時,會有超過 25 個欄位加入至該工作項目類型。 其中數個欄位也會加入至工作項目表單,並且出現在 [Project Server] 索引標籤上。 您可以使用這些欄位建置報表或指定尋找工作項目的查詢。 如需詳細資訊,請參閱監視工作項目送出並解決拒絕

通常您是藉由匯出工作項目類型的定義檔、修改該檔案,再將它匯入 Team 專案的方式,在工作項目表單中加入或移除欄位。 不過,針對參與資料同步處理的工作項目類型,您是藉由將欄位對應下載至檔案、進行修改,再將它上載至 Team 專案集合的方式,在 [Project Server] 索引標籤中加入或移除欄位。 如需詳細資訊,請參閱自訂 TFS 與 Project Server 之間的欄位對應

重要

欄位會針對 Team 專案集合加以對應。針對某一種工作項目類型對應的所有欄位,會和參與資料同步處理的所有其他類型工作項目的欄位相同。如需詳細資訊,請參閱指定要同步處理的工作項目類型

預設 Project Server 索引標籤

當您將企業專案與 Team 專案產生關聯時,[Project Server] 索引標籤 (類似下圖所示) 會加入至工作項目表單。 這個索引標籤只會加入至您指定要參與資料同步處理的工作項目類型中。 只有欄位對應檔中 displayTfsField 或 displayTfsMirror 屬性設定為 true 的欄位才會加入。

[Project Server] 索引標籤預設欄位

您可以藉由自訂 Team 專案集合的欄位對應來加入或移除欄位。 如需詳細資訊,請參閱自訂 TFS 與 Project Server 之間的欄位對應TFS 與 Project Server 整合的欄位對應 XML 項目參考

預設 Project Server 欄位

下表說明加入至工作項目類型以支援資料同步處理的每一個欄位。 這些欄位大部分都是唯讀的,而且只供同步處理引擎用來追蹤送出、更新和重新送出作業。 鏡像的欄位會在企業專案對應至 Team 專案,或是對應某種類型的工作項目時加入至 [Project Server] 索引標籤。

注意事項注意事項

下表中列出的欄位會在集合對應至 PWA 執行個體時,從全域工作流程定義檔匯入到 Team 專案集合。如需全域工作流程的詳細資訊,請參閱自訂全域工作流程

欄位

參考名稱和資料型別

描述

Project Server 指派給

Mirror.System.AssignedTo (String)

唯讀。 儲存指派給專案計劃中工作項目之資源的值。

Project Server 已完成工作

Mirror.Microsoft.VSTS.Scheduling.CompletedWork (Double)

唯讀。 儲存指派給專案計劃中對應之工作的 [工作實際工作] 欄位的值。

Project Server 企業專案

Microsoft.Sync.ProjSrv.ProjectName (String)

讀寫或唯讀。 指定其工作將會與工作項目同步之企業專案計劃的名稱。

當您從對應到多個專案計劃的 Team 專案送出新的工作項目時,必須指定要與工作項目同步的計劃。 如果 Team 專案僅對應到一個專案計劃,則此欄位是唯讀的,而且包含對應之專案計劃的名稱。

注意事項注意事項

如果您以服務帳戶群組成員的身分登入,此欄位擁有會以唯讀方式顯示,因為同步處理引擎對此欄位需要特殊的存取權。

Project Server 完成日期

Mirror.Microsoft.VSTS.Scheduling.FinishDate (DateTime)

唯讀。 儲存指派給專案計劃中對應之工作的 [完成日期] 欄位的值。

注意事項注意事項

您可以將 [完成日期] (pjFinishDate) 欄位加入至對應,但是您在 Team Foundation 中設定的任何值都不會傳送到 Project Server。這是當初所設計的限制。[完成日期] 永遠會以企業專案計劃中的值定義。

Project Server 已連結 ([已連結至 Project Server])

Microsoft.Sync.ProjSrv.IsLinkedToProjSrv (String)

唯讀。 指定工作項目目前是否連結至 Project Server 中的工作。 工作項目會在工作發行至 Project Server 之後變成已連結狀態。 有效值為 [是] 和 [否]。

Project Server 上次檢閱狀態 ([上次核准狀態])

Microsoft.Sync.ProjSrv.LastReviewStatus (String)

唯讀。 將專案管理人員最近一次所做核准的狀態指定為 [認可] 或 [已拒絕]。

Project Server 上次檢閱日期 ([上次核准日期])

Microsoft.Sync.ProjSrv.LastReviewedDate (DateTime)

指定專案管理人員最近一次核准工作項目之狀態更新的日期和時間。

Project Server 上次送出狀態

Microsoft.Sync.ProjSrv.LastSubmitStatus (String)

唯讀。 將最近一次送出至 Project Server 的結果儲存成 [成功] 或 [失敗]。

Project Server 上次送出日期

Microsoft.Sync.ProjSrv.LastSubmittedDate (DateTime)

唯讀。 最近一次工作項目儲存時也會對應於最近送出至 Project Server 的版本,儲存日期和時間。

Project Server 原始評估

Mirror.Microsoft.VSTS.Scheduling.OriginalEstimate (Double)

唯讀。 儲存指派給專案計劃中對應之工作的 [基準工作] 欄位的值。

Project Server 剩餘工作

Mirror.Microsoft.VSTS.Scheduling.RemainingWork (Double)

唯讀。 儲存指派給專案計劃中對應之工作的 [工作剩餘工作] 欄位的值。

Project Server 開始日期

Mirror.Microsoft.VSTS.Scheduling.StartDate (DateTime)

唯讀。 儲存針對專案計劃中對應之工作所定義的開始日期。

注意事項注意事項

您可以將 [開始日期] (pjStartDate) 欄位加入至對應,但是您在 Team Foundation 中設定的任何值只會在您第一次送出工作項目時,傳送到 Project Server。這是當初所設計的限制。同步處理引擎絕不會將與日期相關之欄位的更新傳送至 Project Server。[日期] 會以企業專案計劃中的值定義。

Project Server 送出 (必要項)

Microsoft.Sync.ProjSrv.Submit (String)

指定工作項目是否參與資料同步處理。

Project Server 標題

Mirror.System.Title (String)

唯讀。 儲存指派給專案計劃中對應之工作的標題。

專門用來支援同步處理程序的欄位

下表將列出用來支援同步處理程序的唯讀欄位。

注意事項注意事項

以下資訊僅供參考。

欄位

參考名稱和資料型別

Project Server Sync 核准浮水印

Microsoft.Sync.ProjSrv.ApprovalWatermark (String)

Project Server Sync 指派資料

Microsoft.Sync.ProjSrv.AssignmentData (PlainText)

Project Server Sync 中的 Project Server 是摘要

Microsoft.Sync.ProjSrv.IsSummaryInProjSvr (Integer)

Project Server Sync 上次送出的修訂

Microsoft.Sync.ProjSrv.LastSubmittedRevision (Integer)

Project Server Sync 上次同步處理的修訂

Microsoft.Sync.ProjSrv.LastSyncRevision (Integer)

Project Server Sync 上次同步處理類型

Microsoft.Sync.ProjSrv.LastSyncType (Integer)

Project Server Sync 專案 GUID

Microsoft.Sync.ProjSrv.ProjGuid (GUID)

Project Server Sync 佇列旗標

Microsoft.Sync.ProjSrv.QueueFlags (Integer)

Project Server Sync 要求的指派 GUID

Microsoft.Sync.ProjSrv.RequestedAssnGuid (GUID)

Project Server Sync 要求的專案 GUID

Microsoft.Sync.ProjSrv.RequestedProjGuid (GUID)

Project Server Sync 送出標記

Microsoft.Sync.ProjSrv.SubmitTag (String)

Project Server Sync 工作 GUID

Microsoft.Sync.ProjSrv.TaskGuid (GUID)

Project Server Sync 工作修改修訂計數器

Microsoft.Sync.ProjSrv.TaskModifiedRevCounter (Integer)

Project Server 指派資料

下列程式碼範例說明用來儲存 [Project Server Sync 指派資料] 欄位中摘要工作之工作彙總的標記語言。 只有一個 Assignment (摘要工作項目的主要或作用中擁有者) 的 IsPrimary 屬性可以為 true。

注意事項注意事項

以下資訊僅供參考。

<Assignments>
   <Assignment IsPrimary="true" Succeeded="true">
      <Field RefName="System.AssignedTo">Eduard Dell</Field>
      <Field RefName="Microsoft.VSTS.Scheduling.CompletedWork">0.000000</Field>
      <Field RefName="Microsoft.VSTS.Scheduling.RemainingWork">32.000000</Field>
   </Assignment>
   <Assignment IsPrimary="false" Succeeded="true">
      <Field RefName="System.AssignedTo">Sanjay Patel</Field>
      <Field RefName="Microsoft.VSTS.Scheduling.CompletedWork">8.000000</Field>
      <Field RefName="Microsoft.VSTS.Scheduling.RemainingWork">16.000000</Field>
   </Assignment>
</Assignments>

請參閱

概念

TFS 與 Project Server 整合的同步處理程序概觀

指定要同步處理的工作項目類型

TFS 與 Project Server 整合的欄位對應 XML 項目參考

其他資源

自訂 TFS 與 Project Server 之間的欄位對應