Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022
Analytics 服務會收集所有 Azure Boards 工作追蹤定義和更新活動。 您可以直接在瀏覽器中執行 Analytics 查詢，並使用屬性組合來篩選查詢、彙總資料或建立報表。 如需詳細資訊，請參閱 使用 OData Analytics 定義基本查詢。
本文說明可用來產生工作追蹤 Analytics 報表的大部分屬性。 Analytics 會將所有工作追蹤欄位儲存為屬性，但 HTML/RTF 和歷程記錄欄位除外。 自訂欄位會自動作為自訂資源新增至 Analytics （分析）。
注意
本文提供 Analytics 資料模型所支援的實體、屬性和列舉類型的描述。 若要查詢數據模型，請參閱 建構適用於分析的 OData 查詢。
實體集概觀
當您查詢 Analytics 以取得工作追蹤資料時，請查詢 WorkItems 實體集以產生狀態和匯總報告。 使用 WorkItemSnapshot 實體集來產生趨勢、燃盡和燃盡報表。
使用其他實體類型，例如 區域、 疊代、 專案或 團隊 來篩選資料或選取要報告的屬性。 如需範例報告，請參閱 範例報告和快速參照索引。
注意
若要產生測試執行、測試結果或其他測試資料的狀態和趨勢報告，請查詢 WorkItems 和 WorkItemSnapshot 實體類型，並根據 TestRuns、 TestPoints、 TestResultsDaily、 TestSuite 或 TestPointHistorySnapshot 實體類型進行篩選。 如需詳細資訊，請參閱 測試 Azure DevOps 的元數據參考。
| 實體集 | 實體類型 | 描述 |
|---|---|---|
| 區域 | 適用範圍 | 工作專案 區域路徑，具有依區域階層分組和篩選的屬性。 |
| 日期 | CalendarDate | 用於使用關聯性篩選和分組其他實體的日期。 |
| 反覆運算 | 反覆程序 | 工作專案 反覆專案路徑，具有依反覆專案階層分組和篩選的屬性。 |
| BoardLocations | BoardLocation | 棋盤單元位置，如棋盤欄、泳道和拆分所識別，包括歷史棋盤設置。 如需每個面板欄位的描述，請參閱 工作流程和面板欄位。 |
| 程序 | 處理 | 用來展開或篩選工作專案和工作專案類型的待辦項目資訊。 如需使用 進程 來篩選報表的範例，請參閱 需求追蹤範例報告。 支援 Analytics v2.0 版和更新版本。 |
| 專案 | 計畫 | 針對組織或專案集合定義的所有專案。 |
| Tags (標籤) | 標籤 | 每個專案的所有工作項目標記。 如需使用 標籤 來篩選報表的範例，請參閱 發行燒毀範例報表。 |
| 團隊 | 小組 | 針對項目定義的所有小組。 如需使用 Teams 篩選報表的範例，請參閱 將小組交叉分析篩選器新增至Power BI報表。 |
| 使用者 | 使用者 | 用來展開或篩選各種工作專案屬性的使用者資訊，例如 指派給 或 建立者。 |
| 工作項目看板快照 | 工作項目看板快照 | 複合實體類型，描述每個行事曆日期上每個工作專案的狀態，包括面板位置。 用於產生趨勢報告。 如需範例報表，請參閱 累積流程圖 （CF） 範例報表。 |
| 工作項目連結 | 工作項目連結 | 工作專案之間的連結，例如 Child、 Parent 和 Related。 僅包含連結的最新版本，沒有歷史記錄，也不包含超連結。 |
| 工作項目修訂 | WorkItemRevision | 所有歷史工作專案修訂，包括目前的修訂。 不包含已刪除的工作專案。 |
| WorkItemSnapshot | WorkItemSnapshot | 複合實體類型，描述每個行事曆日期上每個工作專案的狀態。 用於支援趨勢報告。 如需範例報告，請參閱 錯誤趨勢範例報告。 |
| WorkItems | WorkItem | 工作專案的目前狀態。 用來支持狀態報告。 如需範例報表，請參閱 匯總子工作專案值至父範例報表。 |
| 工作項目類型欄位 | WorkItemTypeField | 每個工作專案類型和程式的工作專案屬性。 用來支援建置報表。 |
Snapshots
工作追蹤快照集實體集是 WorkItemSnapshot 和 WorkItemBoardSnapshot。 快照集會每天在同一時間寫入 Analytics，並提供針對當天工作專案定義的值記錄。 您可以使用快照來產生趨勢報告。
根據預設，所有快照資料表都會建模為每日快照事實資料表。 時間範圍的查詢會取得每天的值，而較長的時間範圍會導致大量記錄。 如果您不需要如此高的精度，可以使用每週或每月快照。 如需詳細資訊，請參閱使用 每週或每月快照來處理跨越較長時間的趨勢查詢。
工作項目修訂
每次更新工作項目時，系統都會建立新的修訂版本，並將其記錄在欄位中 System.RevisedDate ，這對於指定歷程記錄篩選器很有用。 您可以透過 和 RevisedDate (DateTime) 屬性來RevisedDateSK (Int32)表示修訂日期。
使用後一個日期代理索引鍵屬性以獲得最佳效能。 此索引鍵會顯示修訂的建立日期，或顯示作用中或未完成修訂的 OData 日期時間 Null 值 "9999-01-01T00:00:00Z" 。 如果您想要自 （含） 以來 {startDate}的所有日期，請將下列篩選器新增至您的查詢： RevisedDateSK eq null or RevisedDateSK gt {startDateSK}。
您可以使用 WorkItemRevisions 實體集來載入指定工作專案的所有修訂。 查詢會傳回您篩選之工作專案的所有歷程記錄工作專案修訂，包括目前的修訂，不包括已刪除的工作專案。
跨實體類型的共用屬性
您可以在 Analytics 檢視中選取的屬性會對應至一般工作追蹤欄位和選取的 Analytics 屬性，例如 週期時間天數 和 前置時間天數。 除非另有指定，否則這些屬性是針對下列實體類型定義的：
- WorkItem
- WorkItemRevision
- WorkItemSnapshot
- 工作項目看板快照
注意
Analytics 服務不會儲存指派 HTML 或 RTF 資料類型的長文字欄位 （例如
Description和History欄位） 的資料，也不會儲存連結或附加檔案計數。 如需預設程式範本中定義的欄位完整清單，請參閱 工作專案欄位索引。 如需資料類型描述，請參閱 查詢欄位、運算子和巨集。下表不包含與 Scrum 和功能成熟度模型整合 （CMMI） 程式特定欄位相關聯的所有屬性。 如需這些欄位的清單，請參閱 用來追蹤 CMMI 工作專案的欄位。
以日期為基礎或以使用者為基礎的屬性與行事曆日期、專案和使用者中繼資料參考中所述的 CalendarDate 和 User 實體集相關聯。
下表列出並說明您可以在 Analytics 檢視中選取的大部分屬性，包括一般工作追蹤欄位和其他 Analytics 屬性。
| 顯示名稱 | 屬性名稱 | 數據類型 | 描述 | 參考名稱 |
|---|---|---|---|---|
| 接受者 | Microsoft_VSTS_CodeReview_AcceptedBy |
UserSK | 回應程式代碼檢閱的人員名稱。 （CMMI 程式） | Microsoft.VSTS.CodeReview.AcceptedBy |
| 接受日期 | AcceptedDate |
Datetime | 人員回應程式代碼檢閱的日期和時間。 （CMMI 程式） | Microsoft.VSTS.CodeReview.AcceptedDate |
| 啟用者 |
ActivatedBy、ActivatedByUserSK |
UserSK | 啟動或重新啟用工作專案的小組成員名稱。 | Microsoft.VSTS.Common.ActivatedBy |
| 啟動日期 | ActivatedDate |
Datetime | 當小組成員啟動或重新啟用 Bug 或工作專案的日期和時間。 | Microsoft.VSTS.CodeReview.ActivatedDate |
| 活動 | Activity |
繩子 | 指派來執行任務的活動或學科類型。 允許的值為：部署、設計、開發、檔、需求和測試。 （敏捷、Scrum 和基本流程） | Microsoft.VSTS.Common.Activity |
AnalyticsUpdatedDate |
日期時間偏移量 | 實體上次更新的資料和時間。 | ||
| 應用程式類型 | 繩子 | 利害關係人提供意見反應的應用程式類型。 預設值為 Web 應用程式、 遠端電腦和 用戶端應用程式。 有效類型會在使用內部部署 XML 程序之專案的程序組態檔中指定。 | Microsoft_VSTS_Feedback_ApplicationType |
|
| 區域路徑 |
AreaPath、AreaSK |
繩子 | 產品特性或團隊區域工作項目分組為。 必須是專案階層中的有效節點。 | System.AreaPath |
| 指派給 |
AssignedTo、AssignedToUserSK |
UserSK | 目前擁有工作專案的小組成員名稱。 | System.AssignedTo |
| 自動化測試標識碼 | AutomatedTestId |
繩子 | 自動化測試案例的測試 ID。 | Microsoft.VSTS.TCM.AutomatedTestId |
| 自動化測試名稱 | AutomatedTestName |
繩子 | 啟動或重新啟用工作專案的小組成員名稱。 | Microsoft.VSTS.TCM.AutomatedTestName |
| 自動化測試記憶體 | AutomatedTestStorage |
繩子 | 包含自動化測試案例之測試的組件。 | Microsoft.VSTS.TCM.AutomatedTestStorage |
| 自動化測試類型 | AutomatedTestType |
繩子 | 自動化測試案例的測試類型。 | Microsoft.VSTS.TCM.AutomatedTestType |
| 自動化狀態 | AutomatedStatus |
繩子 | 測試案例的狀態，其接受的值為「自動化」、「未自動化」或「已規劃」。 | Microsoft.VSTS.TCM.AutomationStatus |
| 待處理專案優先順序 | BacklogPriority |
雙重 | 系統背景進程指派的數字，用來堆疊、排名或追蹤待辦專案或面板上的專案順序。 （Scrum 流程） | Microsoft.VSTS.Common.BacklogPriority |
| 封鎖 | Blocked |
繩子 | 表示無法對工作項目執行進一步的工作。 有效值為 [是 ] 或 [否]。 （CMMI 程式） | Microsoft.VSTS.CMMI.Blocked |
| 商業價值 | BusinessValue |
雙重 | 主觀度量單位，可擷取產品待辦專案或功能與相同類型其他專案相比的相對商務價值。 指派較高編號的品項會被視為比指派較低編號的品項具有更多的商業價值。 | Microsoft.VSTS.Common.BusinessValue |
| 變更者 |
ChangedBy、ChangedByUserSK |
UserSK | 最近修改工作專案的人員名稱。 | System.ChangedBy |
| 已變更日期 | ChangedDate |
Datetime | 修改工作專案的日期和時間。 | System.ChangedDate |
ChangedDateSK |
Int32 | 修改工作專案的日期，以YYYYMMDD表示。 外部工具用來聯結相關實體。 |
||
ChangedOn |
導覽 | 在為組織定義的時區中，修改工作專案日期的實體導覽屬性 Date 。 通常用來參考語句中實體的屬性Dategroupby。 |
||
| 關閉者 |
ClosedBy、ClosedByUserSK |
UserSK | 關閉工作專案的人員名稱。 | Microsoft.VSTS.Common.ClosedBy |
| 關閉日期 |
ClosedDate、 、 ClosedDateSKClosedOn |
Datetime | 關閉工作專案的日期和時間。 | Microsoft.VSTS.Common.ClosedDate |
| 批注計數 | CommentCount |
Int32 | 新增至工作專案的 [討論] 區段的註解數目。 | System.CommentCount |
| 承諾 | Committed |
繩子 | 指出需求是否已在專案中認可。 有效值為 [是 ] 或 [否]。 （CMMI 程式） | Microsoft.VSTS.CMMI.Committed |
CompletedDateSK |
Int32 | Analytics 擷取的導覽屬性日期，可儲存工作專案進入與 [已完成] 狀態類別相關聯的工作流程狀態的時間。 | ||
CompletedOn |
導覽 | Navigational 屬性，以工作專案進入與 Date 狀態類別相關聯的工作流程狀態日期，在為組織定義的時區中。 通常用來參考語句中實體的屬性Dategroupby。 |
||
| 已完成的工作 | CompletedWork |
雙重 | 衡量在任務上花費的工作量。 | Microsoft.VSTS.Scheduling.CompletedWork |
| 建立者 |
CreatedBy、CreatedByUserSK |
UserSK | 建立工作專案的人員名稱。 | Microsoft.VSTS.Common.CreatedBy |
| 建立日期 |
CreatedDate、CreatedDateSK |
Datetime | 工作專案的建立日期，以為組織定義的時區表示。 常用於過濾和顯示。 | Microsoft.VSTS.Common.CreatedDate |
CreatedDateSK |
Int32 | 工作專案的建立日期，以為組織定義的時區表示。YYYYMMDD 外部工具用來聯結相關實體。 |
||
CreatedOn |
導覽 | 在為組織定義的時區中，建立工作專案日期的實體導覽屬性 Date 。 通常用來參考語句中實體的屬性Dategroupby。 |
||
| 週期時間天 | CycleTimeDays |
雙重 | 從第一次進入 「進行中」 或 「已解決 」狀態類別到進入 「已完成」 狀態類別計算的週期時間。 如需詳細資訊，請參閱 前置時間和週期時間小工具。 | |
| 學科 | Discipline |
繩子 | 指派給任務的活動或專業類型。 允許的值為： 分析、 開發、 測試、 使用者教育和 使用者體驗。 （CMMI 程式） | Microsoft.VSTS.Common.Activity |
| 到期日 | DueDate |
Datetime | 要解決的問題或工作專案的預測到期日。 （敏捷式程式） | Microsoft.VSTS.Scheduling.DueDate |
| 努力 | Effort |
雙重 | 產品待辦專案 （Scrum 程式） 或問題 （基本程式） 需要實作的預估工作量。 | Microsoft.VSTS.Scheduling.Effort |
| 完成日期 | FinishDate |
Datetime | 排程指出要完成工作項目的日期和時間。 | Microsoft.VSTS.Scheduling.FinishDate |
| 在 | FoundIn |
繩子 | 產品組建編號，也稱為修訂，其中發現錯誤。 | Microsoft.VSTS.Build.FoundIn |
| InProgress 日期 | InProgressDate |
Datetime | Analytics 儲存日期，擷取工作專案移至屬於 [進行中 ] 狀態類別的狀態的日期時間。 | |
InProgressDateSK |
Int32 | 將工作專案移至屬於 [進行中] 狀態類別的狀態的日期，以為組織定義的時區表示。YYYYMMDD 外部工具用來聯結相關實體。 |
||
| 整合組建 | IntegrationBuild |
繩子 | 包含程式代碼或修正 Bug 的產品組建編號。 | Microsoft.VSTS.Build.IntegrationBuild |
| 目前為 | IsCurrent |
布林值 | 支援篩選資料，以檢視已篩選工作專案集的最新快照集，方法是將值設定為 True。 適用於實體類型 WorkItemRevision、 WorkItemBoardSnapshot 和 BoardLocation。 |
|
| 這是當天的最後一個修訂 | IsLastRevisionOfDay |
布林值 | 表示快照集設定為 True時代表當天的最後一個修訂。 |
|
| 這是期間的最後一個修訂 | IsLastRevisionOfPeriod |
布林值 | 表示快照集設定為 True時，代表期間的最後一個修訂。 |
|
| 問題 | Issue |
繩子 | 表示共用步驟與預期結果相關聯。 允許的值為 [是 ] 和 [否]。 | Microsoft.VSTS.Common.Issue |
| 前置時間天數 | LeadTimeDays |
雙重 | 從建立工作專案或輸入 [建議] 狀態類別到輸入 [已完成] 狀態類別計算的前置時間。 如需詳細資訊，請參閱 前置時間和週期時間小工具。 | |
| 原始估計值 | OriginalEstimate |
雙重 | 衡量完成任務所需的工作量。 | Microsoft.VSTS.Scheduling.OriginalEstimate |
| 父工作項目標識碼 | ParentWorkItemId |
Int32 | 唯一識別碼，可將連結至的工作專案識別為父系。 適用於產生匯總報表。 [父] 欄位適用於實體類型 WorkItemRevision 和 WorkItem。 | System.Parent |
| 優先順序 | Priority |
Int32 | 對與業務相關的錯誤、問題、任務或測試用例的主觀評級。 值包括 1、 2 或 3。 | Microsoft.VSTS.Common.Priority |
| 專案名稱 | ProjectName |
導覽 | 工作專案所屬專案的名稱。 如需詳細資訊，請參閱 專案屬性。 | System.TeamProject |
ProjectSK |
GUID | 指派給工作專案所屬專案的 GUID。 | ||
| 評分 | Reason |
繩子 | 在星級排名系統中，項目從檢閱者那裡收到的星星數（反饋響應）。 該數字存儲在系統中，並寫為 0 - 未評級、 1 - 差、 2 - 一般、 3 - 良好、 4 - 非常好或 5 - 優秀。 適用於 WorkItemRevision 和 WorkItem 實體類型。 | Microsoft.VSTS.Common.Rating |
| 原因 | Reason |
繩子 | 工作專案處於目前狀態的原因。 每個從一個工作流程狀態轉換到另一個工作流程狀態都與對應的原因相關聯。 | System.Reason |
| 剩餘工時 | RemainingWork |
雙重 | 測量完成任務所需的剩餘工作量。 | Microsoft.VSTS.Scheduling.RemainingWork |
| 解決者 |
ResolvedBy、ResolvedByUserSK |
UserSK | 解決錯誤或使用者劇本的團隊成員名稱。 | Microsoft.VSTS.Common.ResolvedBy |
| 已解決日期 | ResolvedDate |
Datetime | 解決錯誤或使用者劇本的日期和時間。 | Microsoft.VSTS.Common.ResolvedDate |
ResolvedDateSK |
Int32 | 解決工作專案的日期，以為組織定義的時區表示。YYYYMMDD 外部工具用來聯結相關實體。 |
||
ResolvedOn |
導覽 | 在為組織定義的時區中，解析工作專案日期的實體導覽屬性 Date 。 通常用來參考語句中實體的屬性Dategroupby。 |
||
| 已解決的原因 | ResolvedReason |
繩子 | 錯誤已解決的原因，例如 已修復。 | Microsoft.VSTS.Common.ResolvedReason |
| 修訂 | Revision |
Int32 | 指派給工作專案歷程修訂的編號。 | System.Rev |
| 修訂日期 | RevisedDate |
Datetime | 修改或更新工作專案的日期和時間。 | |
RevisedDateSK |
Int32 | 修訂工作專案的日期，以為組織定義的時區表示。YYYYMMDD 外部工具用來聯結相關實體。 |
||
RevisedOn |
導覽 | 在為組織定義的時區中，修改工作專案日期的實體導覽屬性 Date 。 通常用來參考語句中實體的屬性Dategroupby。 |
||
| 風險 | Risk |
雙重 | 成功完成工作項目的相對不確定性的主觀評等。 有效值包括 1 - 高、 2 - 中和 3 - 低。 | Microsoft.VSTS.Common.Risk |
| 嚴重性 | Severity |
雙重 | 錯誤、問題或風險對專案影響的主觀評等。 有效值包括 1 - 嚴重、 2 - 高、 3 - 中和 4 - 低。 | Microsoft.VSTS.Common.Severity |
| 大小 | Size |
雙重 | 估計需求需要實作的工作量。 （CMMI 程式） | Microsoft.VSTS.Scheduling.Size |
| 堆疊排名 | StackRank |
雙重 | 系統背景進程指派的數字，用來堆疊、排名或追蹤待辦專案或面板上的專案順序。 （敏捷、Scrum 和基本流程） | Microsoft.VSTS.Common.StackRank |
| 開始日期 | StartDate |
Datetime | 指派給工作專案的日期和時間，讓工作開始。 | Microsoft.VSTS.Scheduling.StartDate |
| 州 (縣/市) | State |
繩子 | 工作專案的目前狀態。 狀態的有效值專屬於每個工作項目類型，以及針對它所做的自定義。 | System.State |
| 狀態類別 | StateCategory |
繩子 | Azure Boards 和選取儀錶板小工具如何處理每個工作流程狀態。 狀態類別包括「建議」、「進行中」、「已解決」、「已移除」及「已完成」。 如需詳細資訊，請參閱 如何使用工作流程狀態和狀態類別。 僅適用於 WorkItemRevision 實體類型。 |
|
| 狀態變更日期 | StateChangeDate |
Datetime | [ 狀態 ] 欄位值變更的日期和時間。 | Microsoft.VSTS.Common.StateChangeDate |
StateChangeSK |
Int32 | 工作專案狀態變更的日期，以為組織定義的時區表示。YYYYMMDD 外部工具用來聯結相關實體。 |
||
StateChangeOn |
導覽 | Navigation 屬性新增至工作專案狀態變更日期的實體， Date 以針對組織定義的時區。 通常用來參考語句中實體的屬性Dategroupby。 |
||
| 故事點 | StoryPoints |
雙重 | 使用者劇本需要實作的工作量估計值，通常彙總為總和。 （敏捷式程式） | Microsoft.VSTS.Scheduling.StoryPoints |
| Tags (標籤) | TagNames |
繩子 | 以分號分隔的標籤清單，指派給一或多個工作專案，以進行篩選或查詢。 | System.Tags |
| 目標日期 | TargetDate |
Datetime | 要解決或完成的問題或其他工作專案的預測到期日。 | Microsoft.VSTS.Scheduling.TargetDate |
| 測試套件類型 | 繩子 | 測試套件的類型。 有效值包括 [查詢型]、[ 需求型] 和 [靜態]。 | Microsoft_VSTS_TCM_TestSuiteType |
|
| 測試套件類型識別碼 | Int64 | 系統指派的號碼，對應於測試套組類別。 僅適用於測試套件。 指派的值為 1 （靜態）、2 （查詢型） 和 3 （需求型）。 | Microsoft_VSTS_TCM_TestSuiteTypeId |
|
| 時間關鍵性 | TimeCriticality |
雙重 | 主觀度量單位，可擷取商務價值如何隨時間遞減。 較高的值表示長篇故事或功能本質上比具有較低值的項目更重要。 | Microsoft.VSTS.Common.TimeCriticality |
| 標題 | Title |
繩子 | 摘要工作專案的簡短描述，可協助小組成員將它與清單中的其他工作專案區分開來。 | System.Title |
| 值區域 | ValueArea |
繩子 | Epic、功能或待辦專案所代表的客戶價值區域。 值包括 Architectural 或 Business。 | Microsoft.VSTS.Common.ValueArea |
| 浮浮水印 | Watermark |
繩子 | 系統管理的欄位，會隨著對工作專案所做的變更而遞增。 適用於 WorkItemRevision 和 WorkItem 實體類型。 | System.Watermark |
| 工作項目識別碼 | WorkItemId |
Int32 | 指派給工作專案的唯一識別碼。 工作專案識別碼在組織或專案集合內的所有專案中都是唯一的。 | System.Id |
WorkItemRevisionSK |
Int32 | 工作專案修訂的分析唯一索引鍵，由外部工具用來聯結相關實體。 | ||
| 工作項目類型 | WorkItemType |
繩子 | 工作項目類型的名稱。 可用的工作專案類型是以專案使用的程式為基礎。 如需詳細資訊，請參閱 關於進程和進程範本。 | System.WorkItemType |
導覽屬性
OData 導覽屬性是指向另一個實體之實體的參考屬性。 下表提供導覽屬性、其參考條件約束，以及它們有效的實體類型的摘要。
| 顯示名稱 | 名稱 | 引用條件約束 | 參照屬性 | 有效的實體類型 |
|---|---|---|---|---|
ChangedOn |
ChangedDateSK |
DateSK |
WorkItemRevision、 WorkItemSnapshot、 WorkItemBoardSnapshot | |
ClosedOn |
ClosedDateSK |
DateSK |
WorkItemRevision、 WorkItemSnapshot、 WorkItemBoardSnapshot | |
CreatedOn |
CreatedDateSK |
DateSK |
WorkItemRevision、 WorkItemSnapshot、 WorkItemBoardSnapshot | |
ResolvedOn |
ResolvedDateSK |
DateSK |
WorkItemRevision、 WorkItem、 WorkItemSnapshot、 WorkItemBoardSnapshot | |
StateChangeOn |
StateChangeDateSK |
DateSK |
WorkItemRevision、 WorkItem、 WorkItemSnapshot、 WorkItemBoardSnapshot | |
InProgressOn |
InProgressDateSK |
DateSK |
WorkItemRevision、 WorkItem、 WorkItemSnapshot、 WorkItemBoardSnapshot | |
CompletedOn |
CompletedDateSK |
DateSK |
WorkItemRevision、 WorkItem、 WorkItemSnapshot、 WorkItemBoardSnapshot | |
ChangedOn |
ChangedDateSK |
DateSK |
WorkItemRevision、 WorkItem、 WorkItemSnapshot、 WorkItemBoardSnapshot | |
RevisedOn |
RevisedDateSK |
DateSK |
WorkItemRevision、 WorkItemSnapshot | |
Date |
DateSK |
DateSK |
WorkItemRevision、 WorkItemSnapshot、 WorkItemBoardSnapshot | |
| 區域 | Area |
AreaSK |
WorkItemRevision、 WorkItem、 WorkItemSnapshot、 WorkItemBoardSnapshot | |
| BoardLocation | WorkItemRevision、 WorkItem、 WorkItemBoardSnapshot | |||
| 反覆運算 | Iteration |
IterationSK |
WorkItemRevision、 WorkItem、 WorkItemSnapshot、 WorkItemBoardSnapshot | |
| 指派給 | AssignedTo |
AssignedToUserSK |
UserSK |
WorkItemRevision、 WorkItem、 WorkItemSnapshot、 WorkItemBoardSnapshot |
| 變更者 | ChangedBy |
ChangedByUserSK |
UserSK |
WorkItemRevision、 WorkItem、 WorkItemSnapshot、 WorkItemBoardSnapshot |
| 建立者 | CreatedBy |
CreatedByUserSK |
UserSK |
WorkItemRevision、 WorkItem、 WorkItemSnapshot、 WorkItemBoardSnapshot |
| 啟用者 | ActivatedBy |
ActivatedByUserSK |
UserSK |
WorkItemRevision、WorkItem、 WorkItemSnapshot、 WorkItemBoardSnapshot |
| 關閉者 | ClosedBy |
ClosedBySK |
UserSK |
WorkItemRevision、 WorkItem、 WorkItemSnapshot、 WorkItemBoardSnapshot |
| ResolvedBy | ResolvedBy |
ResolvedByUserSK |
UserSK |
WorkItemRevision、 WorkItemSnapshot、 WorkItemBoardSnapshot |
| 團隊 | Area、 BoardLocation、 反覆專案、 WorkItemRevision、 WorkItemSnapshot、 WorkItemBoardSnapshot | |||
| Tags (標籤) | WorkItem、 WorkItemRevision、 WorkItemBoardSnapshot | |||
| 計畫 | Project |
ProjectSK |
ProjectSK |
標籤、 WorkItemBoardSnapshot、 WorkItemLink、 WorkItemRevision、 WorkItemSnapshot、 WorkItemTypeField |
| 程序 | WorkItemRevision、 WorkItem、 WorkItemSnapshot | |||
| 修訂 | WorkItem | |||
| 連結 | WorkItem | |||
| 子系 | WorkItem | |||
| 上層 | WorkItem | |||
| 子系 | WorkItem | |||
| 工作項目* | WorkItemId |
WorkItemRevision |
* WorkItem 實體也支援 PredictTags 和 Predict 函式，以支援選取內建 Analytics 報表和小工具的預測趨勢。
BoardLocation 和 WorkItemBoardSnapshot
除非另有說明，否則下表列出並描述針對 BoardLocation 和 WorkItemBoardSnapshot 實體類型定義的屬性。 您可以使用這些欄位，根據小組面板資料行、泳道或待辦專案層級內工作專案的狀態來篩選工作專案數據。 如需查詢 WorkItemBoardSnapshot 實體集的範例，請參閱 累積流程圖 （CFD） 範例報表。
| 顯示名稱 | 屬性名稱 | 數據類型 | 描述 |
|---|---|---|---|
| 面板標識碼 | BoardId |
Guid | 指派給面板的唯一 GUID。 每個小組都會與一或多個面板相關聯。 |
| 面板類別參考名稱 | BoardCategoryReferenceName |
繩子 | 指派給用來填入面板的工作專案類型類別的名稱。 例如，產品待辦專案面板與需求類別相關聯。 如需詳細資訊，請參閱自定義待辦專案或面板（繼承程式）。 |
| 面板名稱 | BoardName |
繩子 | 指派給面板的名稱，例如 劇本、 待辦專案、 功能或 長篇故事。 |
| 面板層級 | BoardLevel |
Int32 | 根據面板在面板階層中的位置指派給面板的編號。 |
| 待辦項目類型 | BacklogType |
繩子 | 待辦專案類型的名稱，例如 [反覆專案]、[需求] 或 [組合]。 |
| 資料行名稱 | ColumnName |
繩子 | 工作專案目前指派給的面板資料行名稱，例如 [作用中]、[ 已關閉]、[ 認可]、[ 完成] 或自定義資料行標籤。 參考名稱： System.BoardColumn |
| 數據行順序 | ColumnOrder |
Int32 | 根據面板內的順序指派給面板欄的編號。 |
| 完成 | Done |
列舉 | 分割欄位置的指示器。 |
| 數據行專案限制 | ColumnItemLimit |
Int32 | 根據其順序指派給 Board 欄的編號。 |
| 面板可見 | IsBoardVisible |
布林值 | 表明團隊是否選擇將棋盤顯示。 |
| 為數據行分割 | IsColumnSplit |
布林值 | 指示欄是否分割為 「執行中 」和 「完成」 欄，如分割 面板上的欄以顯示進行中的工作中所述。 |
| 目前為 | IsCurrent |
布林值 | 當設定為 True時，支援篩選資料以檢視已篩選工作專案的最新快照集的屬性。 |
| 是預設車道 | IsDefaultLane |
布林值 | 表示當設定為 True時，工作專案會指派給預設泳道。 |
| 已完成 | IsDone |
布林值 | 直欄內工作項目的目前指派給 Doing if False 或 Done when True。 只有在為板欄啟用 分割欄 時才有效。 參考名稱： System.BoardColumnDone |
| 車道 ID | LaneId |
Guid | 指派給板泳道的唯一 GUID。 每個團隊都可以在板上添加一條或多條泳道。 如需泳道的詳細資訊，請參閱 在棋盤中使用泳道加速您的團隊工作。 |
| 車道名稱 | LaneName |
繩子 | 指定給棋盤泳道的名稱。 參考名稱： System.BoardLane |
| 車道順序 | LaneOrder |
Int32 | 根據其順序分配給棋盤泳道的編號。 |
*下表列出列舉類型的成員名稱 BoardColumnSplit ，可用來篩選 [執行中 ] 或 [完成 ] 面板欄中的工作專案。
| 成員名稱 | 值 | 顯示名稱 |
|---|---|---|
Doing |
0 | 正在進行 |
Done |
1 | 完成 |
Unknown |
2 | 未知（未分割） |
如需小組面板數據行的詳細資訊，請參閱下列文章：
區域
下列屬性適用於與 [區域路徑] 字段相關聯的 Areas 實體集。 與 Area 包含 AreaSK 和 ProjectSK相關聯的 Surrogate 索引鍵。 您可以使用這些內容，根據區域路徑指派來篩選或報告工作追蹤資料。
| 顯示名稱 | 名稱 | 數據類型 | 描述 |
|---|---|---|---|
AnalyticsUpdatedDate |
Datetime | 浮浮水印，指出上次更新分析數據的時間。 | |
Number |
Int32 | 建立時指派給區域路徑節點的整數值。 | |
| 深度 | Depth |
Int32 | 區域路徑的層級，根據其從根層級的深度。 |
| 區域標識碼 | AreaId |
GUID | 建立時指派給區域路徑的唯一識別碼。 |
| 區域層級 1 至 區域層級 14 |
AreaLevel1 至 AreaLevel14 |
繩子 | 區域路徑的節點層級，最多 14 個巢狀層級。 區域層級 1 一律對應至根節點及專案名稱。 |
| 區域名稱 | AreaName |
繩子 | 在建立時為區域路徑定義的名稱。 |
| 區域路徑 | AreaPath |
繩子 | 從根節點開始的區域路徑的完整路徑。 |
重要
刪除 區域路徑 值或重新配置 疊代路徑 值會導致下列圖表中不可逆轉的資料遺失：
- 燃盡和燃盡小部件圖表
- 衝刺燃盡圖表
- 已變更區域路徑的團隊速度圖表
- 參考每個工作專案時所定義的 區域路徑 和 反覆專案路徑 值的歷史趨勢圖
僅當區域和迭代路徑不再被任何工作專案使用時，您才能刪除它們。 當您刪除這些路徑時，您將無法再擷取其歷程資料。
區域實體類型和區域實體集的導覽屬性包括專案和團隊。
如需 區域路徑的詳細資訊，請參閱下列文章：
反覆項目
下列屬性適用於 [反復專案] 實體集，與 [反復項目路徑] 字段相關聯。 與 反覆項目 相關聯的 Surrogate 索引鍵包括 IterationSK 和 ProjectSK。 您可以使用這些內容，根據疊代路徑指派來篩選或報告工作追蹤資料。
| 顯示名稱 | 名稱 | 數據類型 | 描述 |
|---|---|---|---|
AnalyticsUpdatedDate |
Datetime | 浮浮水印，指出上次更新分析數據的時間。 | |
Number |
Int32 | 建立時指派給疊代路徑節點的整數值。 | |
| 深度 | Depth |
Int32 | 疊代路徑的層級，以根層級的深度為基礎。 |
| 結束日期 | EndDate |
Datetime | 為疊代路徑定義的結束日期。 |
| 是否結束 | IsEnded |
布林值 | 當設定為 True時，表示疊代路徑結束日期是過去的。 |
| 反覆項目標識碼 | IterationId |
GUID | 在建立時指派給疊代路徑的唯一識別碼。 |
| 疊代層級 1 到 疊代層級 14 |
IterationLevel1 至 IterationLevel14 |
繩子 | 疊代路徑的節點層級，最多 14 個巢狀層級。 疊代層級 1 一律對應至根節點及專案名稱。 |
| 反覆項目名稱 | IterationName |
繩子 | 在建立時為疊代路徑定義的名稱。 |
| 反覆項目路徑 | IterationPath |
繩子 | 從根節點開始的完整疊代路徑。 反覆項目必須是項目階層中的有效節點。 參考名稱： System.IterationPath |
| 開始日期 | StartDate |
Datetime | 為疊代路徑定義的開始日期。 |
重要
刪除 區域路徑 值或重新配置 疊代路徑 值會導致下列圖表中不可逆轉的資料遺失：
- 燃盡和燃盡小部件圖表
- 衝刺燃盡圖表
- 已變更區域路徑的團隊速度圖表
- 參考每個工作專案時所定義的 區域路徑 和 反覆專案路徑 值的歷史趨勢圖
僅當區域和迭代路徑不再被任何工作專案使用時，您才能刪除它們。 當您刪除這些路徑時，您將無法再擷取其歷程資料。
反覆專案實體類型和反覆專案實體集的導覽屬性包括專案和團隊。
如需反覆運算路徑的詳細資訊，請參閱下列文章：
程序
下列屬性適用於 Process 實體類型和 Process 實體集。 與進程相關聯的 Surrogate 索引鍵包括 ProcessSK、 和 。ProjectSKTeamSK 使用這些屬性來篩選或報告專案或小組工作專案類型的工作追蹤資料。
注意
v-2.0、v3.0-preview 和 v4.0-preview Analytics 版本支援 Process 實體類型和 Processes 實體集。
您可以使用這些屬性，根據待辦專案層級篩選工作追蹤資料。
| 顯示名稱 | 名稱 | 數據類型 | 描述 |
|---|---|---|---|
AnalyticsUpdatedDate |
Datetime | 浮浮水印，指出上次更新分析數據的時間。 | |
ProjectSK |
GUID | 與程式相關聯的專案索引鍵。 | |
TeamSK |
GUID | 與程式相關聯的小組金鑰。 | |
| 待處理項目類別參考名稱 | BacklogCategoryReferenceName |
繩子 | 指派給與工作專案類型相關聯之待辦專案的類別參考名稱。 範例包括 Microsoft.EpicCategory、 、 Microsoft.FeatureCategoryMicrosoft.RequirementCategory和 Microsoft.TaskCategory。 |
| 待辦項目名稱 | BacklogName |
布林值 | 指派給與工作專案類型相關聯之待辦專案的參考名稱 |
| 待辦項目類型 | BacklogType |
GUID | 建立時指派給待辦專案的唯一識別碼。 |
| 待辦專案層級 | BacklogLevel |
繩子 | 與工作專案類型相關聯的待辦專案層級。 如果工作專案類型未與待辦專案層級相關聯，則會傳回此 null 值。 |
| 工作項目類型 | WorkItemType |
繩子 | 為工作項目類型定義的名稱。 |
| 有待處理專案 | HasBacklog |
繩子 | 指出工作專案類型是否屬於待辦專案。 |
| 為隱藏類型 | IsHiddenType |
布林值 | 指出工作專案類型是否已停用。 |
| 為 Bug 類型 | IsBugType |
布林值 | 指出工作專案類型是否屬於 Bug 類別。 |
| 已刪除 | IsDeleted |
布林值 | 指出是否刪除工作專案類型。 |
如需處理待辦專案和工作專案類型的詳細資訊，請參閱下列文章：
標籤
下列屬性適用於 Tags 實體集。 與 Tag 相關聯的 Surrogate 索引鍵 包含 TagSK 和 ProjectSK。 導覽內容包括 專案 及其參照條件約束 ProjectSK。 如需使用標籤的詳細資訊，請參閱 新增工作專案標籤來分類和篩選清單和面板。
您可以使用這些屬性來篩選或報告工作追蹤資料。
| 顯示名稱 | 名稱 | 數據類型 | 描述 |
|---|---|---|---|
| 標記標識碼 | TagId |
GUID | 建立時指派給標籤的唯一ID。 |
| 標記名稱 | TagName |
繩子 | 標記名稱。 |
團隊
下列屬性適用於 Team 實體類型和 Teams 實體集。 與 Team 相關聯的 Surrogate 索引鍵包括 TeamSK 和 ProjectSK。 您可以使用這些屬性，根據小組指派篩選或報告工作追蹤數據。 如需使用和新增小組的相關信息，請參閱 關於小組和敏捷式工具 ，以及 建立或新增小組。
| 顯示名稱 | 名稱 | 數據類型 | 描述 |
|---|---|---|---|
AnalyticsUpdatedDate |
Datetime | 浮水印，指出上次更新 Analytics 資料的時間。 | |
| 小組標識碼 | TeamId |
GUID | 建立時指派給小組的唯一識別碼。 |
| 小組名稱 | TeamName |
繩子 | 團隊名稱。 |
Teams 實體集的導覽屬性包括 [專案]、[區域] 和 [反覆專案]。
工作項目連結
下列屬性適用於 WorkItemLinks 實體集。 屬性參考 Surrogate 索引鍵為 WorkItemLinkSK。 查詢 WorkItemLinks 以報告父/子、相關、前置任務/後續任務或其他連結類型。
| 顯示名稱 | 名稱 | 數據類型 | 描述 |
|---|---|---|---|
AnalyticsUpdatedDate |
Datetime | 浮水印，指出上次更新 Analytics 資料的時間。 | |
WorkItemLinkSK |
Int32 | 指派給 WorkItemLink 實體的代理索引鍵。 | |
| 建立日期 | CreatedDate |
GUID | 連結的建立日期。 |
| 註解 | Comment |
繩子 | 建立連結時新增的批注。 |
| 已刪除日期 | DeletedDate |
繩子 | 連結刪除日期。 |
| 連結類型識別碼 | LinkTypeId |
Int32 | 指派給目標連結工作專案的識別碼。 |
| 連結類型名稱 | LinkTypeName |
繩子 | 指派給連結類型的易記名稱。 |
| 連結類型參考名稱 | LinkTypeReferenceName |
繩子 | 指派給連結類型的參考名稱。 |
| 連結類型為無迴圈 | LinkTypeIsAcyclic |
布林值 | 表示鏈結類型在設定為 True時允許循環關係。 例如，樹狀結構類型連結會限制迴圈關聯性。 |
| 連結類型為方向 | LinkTypeIsDirectional |
布林值 | 指示鏈路型別是否為定向。 方向連結類型會與正向和反向元件成對定義。 |
| 來源工作項目標識碼 | SourceWorkItemId |
Int32 | 指派給連結來源工作專案的識別碼。 |
| 目標工作項目識別碼 | TargetWorkItemId |
Int32 | 指派給連結目標工作專案的識別碼。 |
WorkItemLink 實體類型的導覽屬性包括 Projects、SourceWorkItem 和 TargetWorkItem。
如需連結和連結類型的詳細資訊，請參閱下列文章：
工作項目類型欄位
下列屬性適用於 WorkItemTypeFields 實體集。 屬性參考索引鍵為 FieldName、 ProjectSK和 WorkItemType。
| 顯示名稱 | 名稱 | 數據類型 | 描述 |
|---|---|---|---|
| 欄位名稱 | FieldName |
繩子 | 系統或建立時指派給欄位的易記名稱。 |
| 欄位參考名稱 | FieldReferenceName |
繩子 | 系統指派給欄位的參考名稱，或在建立自訂欄位時。 |
| 欄位類型 | FieldType |
繩子 | 指派給欄位的數據類型。 |
| 工作項目類型 | WorkItemType |
繩子 | 為其定義欄位的工作專案類型。 |
導覽屬性包括 Project。 如需為項目定義之所有欄位的索引，請參閱 工作專案欄位的欄位描述。 如需詳細資訊，請參閱下列文章：
自訂屬性
自訂欄位會自動作為自訂屬性新增至 Analytics 服務。
Custom_ 或 Custom. 前面加上屬性名稱。 檢查集合的中繼資料，如 查詢中繼資料中所述。 下列範例顯示自訂欄位 Risk Opportunity 的中繼資料語法。
<Property Name="Custom_RiskOpportunity" Type="Edm.Double">
<Annotation Term="Display.DisplayName" String="Risk Opportunity"/>
<Annotation Term="Ref.ReferenceName" String="Custom.RiskOpportunity"/>
<Annotation Term="Display.Description" String="Risk Reduction | Opportunity Enablement Value. Enter a value from 1 to 5. 5 represents high risk reduction or high opportunity enablement."/>
</Property>
自定義工作專案類型和待辦專案類別
自訂工作專案類型的資料會自動新增至 Analytics 服務。 定義自定義工作專案類型和待辦專案層級時，會建立自定義類別，並搭配 Custom_ 或 Custom. 附加至類別 GUID。 例如，自定義類別 （例如 可能會 Custom.49b81c4e-9c4f-4c04-94fd-d660cbf3a000 指派給 Portfolios 待辦專案中的 Portfolio 自定義工作專案類型）。