工作項目結構描述

發行項
08/21/2008

更新：2007 年 11 月

Team System 資料倉儲中的四個「事實資料表」(Fact Table)，將分別列出有關工作項目的資料。下列章節說明每個事實資料表的內容，及其與「維度資料表」(Dimension Table) 之間的關係。這些章節同時說明工作項目結構描述的專屬維度資料表。如需事實資料表與維度資料表的詳細資訊，請參閱事實資料表和維度資料表。

下列為工作項目的事實資料表：

目前工作項目的事實資料表 (dbo.Current Work Item)
工作項目變更集的事實資料表 (dbo.Work Item Changeset)
工作項目記錄的事實資料表 (dbo.Work Item History)
相關工作項目的事實資料表 (dbo.Related Current Work Item)

工作項目的事實資料表會參考下列維度資料表：

工作項目的維度資料表 (dbo.Work Item)
變更集的維度資料表 (dbo.Changeset)
組建的維度資料表 (dbo.Build) (請參閱組建結構描述)
Team 專案的維度資料表 (dbo.Team Project) (請參閱共用維度)
人員的維度資料表 (dbo.Person) (請參閱共用維度)
日期的維度資料表 (dbo.Date) (請參閱共用維度)
區域的維度資料表 (dbo.Area) (請參閱共用維度)
反覆項目的維度資料表 (dbo.Iteration) (請參閱共用維度)

目前工作項目的事實資料表

工作項目實實資料表的結構描述

這項事實資料表會儲存所有工作項目的目前版本。下表描述事實資料表中的資料行。

欄位	描述
__ID	識別資料表中的資料錄之號碼 (內部使用)。
Logical Tracking ID	識別工作項目追蹤倉儲配接器使用的編號，以判斷目前倉儲中的所有工作項目歷程記錄。
__LastUpdatedTime	上一次插入或更新記錄的日期和時間。
__TrackingId	倉儲基礎結構用來追蹤記錄的識別號碼。
Work Item	Work Item 維度資料表的外部索引鍵。
Assigned To	代表「指派給」值之 Person 維度資料表的外部索引鍵。
Changed By	代表 Changed By 值之 Person 維度資料表的外部索引鍵。
Created By	代表 Created by 值之 Person 維度資料表的外部索引鍵。
Area	Area 維度資料表的外部索引鍵。
Iteration	Iteration 維度資料表的外部索引鍵。
Team Project	代表 Team 專案之 Team Project 維度資料表的外部索引鍵。
Date	Date 維度資料表的外部索引鍵。
System_CreatedDate	代表工作項目建立日期之 Date 維度的外部索引鍵。
Microsoft_VSTS_Common_ActivatedDate	代表工作項目上一次啟動日期之 Date 維度的外部索引鍵。
Microsoft_VSTS_Common_ResolvedDate	代表工作項目上一次解析日期之 Date 維度的外部索引鍵。
Microsoft_VSTS_Common_ClosedDate	代表工作項目上一次關閉日期之 Date 維度的外部索引鍵。
Microsoft_VSTS_Test_TestName	以工作碼執行之測試的名稱。
Microsoft_VSTS_Test_TestId	以工作碼執行之測試的 ID 編號。
Microsoft_VSTS_Test_TestPath	以工作碼執行之測試的完整路徑。
Microsoft_VSTS_Build_FoundIn	組建資料表的外部索引鍵，此資料表代表其中有工作項目的組建。在 MSF for Agile Software Development 流程範本中，此值只會提供 Bug 工作項目類型。
Microsoft_VSTS_Build_IntegrationBuild	Build 維度資料表的外部索引鍵，該資料表代表包含已解析此工作項目之程式碼變更的組建。
_Microsoft_VSTS_Scheduling_RemainingWork	完成工作所需的剩餘時數 (估計值)。
_Microsoft_VSTS_Scheduling_CompletedWork	進行此項工作的已使用時數。
_Microsoft_VSTS_Scheduling_BaselineWork	基準計劃的工作時數。
Microsoft_VSTS_Scheduling_StartDate	Date 維度資料表的外部索引鍵，此資料表代表與此工作項目關聯的開始日期。
Microsoft_VSTS_Scheduling_FinishDate	Date 維度資料表的外部索引鍵，此資料表代表與此工作項目關聯的完成日期。

工作項目變更集事實資料表

工作項目變更集結構描述

這份事實資料表會在工作項目與變更集之間建立連結。下表描述事實資料表中的資料行。

欄位	描述
__ID	識別資料表中的資料錄之號碼 (內部使用)。
__LastUpdatedTime	上一次插入或更新記錄的日期和時間。
__TrackingId	倉儲基礎結構用來追蹤記錄的識別號碼。
Work Item	Work Item 事實資料表中的工作項目記錄 ID。
Changeset	Changeset 事實資料表中代表變更集的記錄 ID。
Team Project	儲存連結的 Team 專案。

工作項目記錄事實資料表

工作項目記錄結構描述

這份事實資料表包含所有工作項目的完整記錄。此資料表使用補償性記錄 (Record) 策略，可記錄任何時間點的記錄 (History)。下表描述事實資料表中的資料行。

欄位	描述
__ID	識別資料表中的資料錄之號碼 (內部使用)。
Logical Tracking ID	工作項目追蹤倉儲配接器以判定該倉儲內已存在多少工作項目記錄時所用的識別號碼。
Record Count	1 或 -1。當新的工作項目建立時，就會插入記錄且將記錄計數設定為 1。當工作項目修改時，就會插入兩個記錄。第一個記錄與前一個記錄相同，不同的是其記錄計數為 -1 而不是 1。第二個記錄的記錄計數為 1，而記錄的其餘部分則代表工作項目中的新值。
Revision Count	工作項目的每次修定都會將此值設定為 1。對於記錄計數設定為 -1 的記錄 (代表工作項目發生變更) 而言，此值為 NULL。選取將修訂計數設定為 1 的資料列，會傳回工作項目的所有修訂。
State Change Count	用來顯示活動，例如 Bug 解析率或工作完成率等。當 [狀態] 欄位變更時，狀態變更計數會設定為 1。對於未變更狀態的工作項目修訂，以及記錄計數為 -1 的所有記錄，狀態變更計數則會設定為 NULL。
__LastUpdatedTime	上一次插入或更新記錄的日期和時間。
__TrackingId	倉儲基礎結構用來追蹤記錄的識別號碼。
Work Item	Work Item 維度資料表的外部索引鍵。
Assigned To	代表 Assigned To 值之 Person 維度資料表的外部索引鍵。
Changed By	代表 Changed By 值之 Person 維度資料表的外部索引鍵。
Date	Date 維度資料表的外部索引鍵。這代表工作項目上次變更的日期。
Created By	代表 Created By 值之 Person 維度資料表的外部索引鍵。
Area	Area 維度資料表的外部索引鍵。
Iteration	Iteration 維度資料表的外部索引鍵。
Team Project	Team Project 維度資料表的外部索引鍵。
System_CreatedDate	代表工作項目建立日期之 Date 維度的外部索引鍵。
Microsoft_VSTS_Common_ActivatedDate	代表工作項目上一次啟動日期之 Date 維度的外部索引鍵。
Microsoft_VSTS_Common_ResolvedDate	代表工作項目上一次解析日期之 Date 維度的外部索引鍵。
Microsoft_VSTS_Common_ClosedDate	代表工作項目上一次關閉日期之 Date 維度的外部索引鍵。
Microsoft_VSTS_Test_TestName	以工作碼執行之測試的名稱。
Microsoft_VSTS_Test_TestId	以工作碼執行之測試的 ID 編號。
Microsoft_VSTS_Test_TestPath	以工作碼執行之測試的完整路徑。
Microsoft_VSTS_Build_FoundIn	組建資料表的外部索引鍵，此資料表代表其中有工作項目的組建。在 MSF for Agile Software Development 流程範本中，此值只會提供 Bug 工作項目類型。
Microsoft_VSTS_Build_IntegrationBuild	Build 維度資料表的外部索引鍵，該資料表代表包含已解析此工作項目之程式碼變更的組建。
_Microsoft_VSTS_Scheduling_RemainingWork	完成所選維度之工作所需的剩餘工作時數 (估計值)。
_Microsoft_VSTS_Scheduling_CompletedWork	為所選維度已使用的工作時數。
_Microsoft_VSTS_Scheduling_BaselineWork	基準計劃中所選維度的工作時數。
Microsoft_VSTS_Scheduling_StartDate_Date_ID	Date 維度資料表的外部索引鍵，此資料表代表與此工作項目關聯的開始日期。
Microsoft_VSTS_Scheduling_FinishDate_ID	Date 維度資料表的外部索引鍵，此資料表代表與此工作項目關聯的完成日期。

欄位	描述
Current Work Item_TrackingIDLeft	連結來源的目前工作項目事實資料表之外部索引鍵
Current Work Item_TrackingIDRight	連結目標的目前工作項目事實資料表之外部索引鍵
__LastUpdatedTime	最近插入或更新記錄的日期與時間。

工作項目的維度資料表

這份維度資料表會將不另外儲存於共用維度之工作項目欄位值儲存起來。例如，[狀態] 欄位中的值是儲存在工作項目的維度資料表中，但是 [指派給] 欄位中的值則會儲存在共用人員維度中。下表說明工作項目維度資料表中的資料行。

欄位	描述
__ID	用來識別資料表之記錄的號碼 (內部使用)。
Work Item	識別項，衍生自工作項目 ID 及修訂。
Previous State	上一個工作項目修訂的狀態。
__LastUpdatedTime	上一次插入或更新記錄的日期和時間。
__DimensionMemberActive	維度成員是否已完全填入 (內部使用)。
System_Id	以工作項目在作業系統中的識別方式來代表工作項目 ID。
System_Title	工作項目的標題。
System_State	工作項目的狀態。
System_Rev	工作項目的修訂。
System_Reason	狀態上一次變更的原因。
System_WorkItemType	工作項目的類型 (Bug、工作等等)。
Microsoft_VSTS_Common_Issue	用來標示工作項目顯示在問題報告的值。
Microsoft_VSTS_Common_ActivatedBy	上一次啟動工作項目的人員。
Microsoft_VSTS_Common_ResolvedBy	上一次解析工作項目的人員。
Microsoft_VSTS_Common_ClosedBy	上一次關閉工作項目的人員。
Microsoft_VSTS_Common_Priority	用來判斷哪一項工作要先完成的主觀重要性評比。有效值為 1、2 和 3。
Microsoft_VSTS_Common_Triage	等待分級決定之工作的子狀態 (用於建議的狀態)。有效值為「暫止」(預設值)、「詳細資訊」、「已接收的資訊」、「已分級」。
Microsoft_VSTS_Common_ExitCriteria	用來決定是否應該在專案檢查清單上追蹤此工作項目的旗標。
Microsoft_VSTS_Common_Rank	用於排定工作優先權的堆疊順位。
Microsoft_VSTS_Scheduling_TaskHierarchy	代表所指定工作之 Microsoft Project 內容的字串。