Azure Boards 分析的元數據參考
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Analytics 服務會收集透過 Azure Boards 定義和更新的所有工作追蹤活動。 分析會將所有工作追蹤欄位儲存為屬性，但 HTML/RTF 和 [歷程記錄] 欄位除外。 自定義欄位的自訂屬性會自動新增至 Analytics。
本文說明您可用來產生用於工作追蹤的分析報告的大部分屬性。 您可以使用屬性的組合來篩選查詢、匯總數據或建置報表。 您可以直接在瀏覽器中執行這些查詢。 如需詳細資訊，請參閱 使用 OData Analytics 定義基本查詢。 如果您不熟悉工作追蹤和 Azure Boards，建議您檢閱下列文章：
注意
提供 Analytics 數據模型所支援的實體、屬性和列舉型別描述。 這是一個早期的草稿。 請提供您想要取得詳細資訊的區域意見反應。 若要查詢數據模型，請參閱 建構適用於分析的 OData 查詢。
實體集概觀
查詢分析以取得工作追蹤數據時，請使用下列其中一個實體類型或實體集。
- 產生狀態和匯總報告的查詢
WorkItems - 查詢
WorkItemSnapshot以產生趨勢、燒毀和燒毀報告
使用其他實體類型，例如 Area、 Iteration、 Project、 Team或其他實體來篩選數據，或選取要報告的屬性。 如需範例報表的摘要，請參閱 範例報表和快速參考索引。
注意
若要針對測試特定工作專案類型產生狀態和趨勢報告，請根據工作專案類型查詢 WorkItems 和 WorkItemSnapshot 實體類型和篩選。 如需測試回合、測試結果或其他測試數據的資訊，請查詢 TestRuns、TestPoints、 TestResultsDailyTestSuite 或 TestPointHistorySnapshot 實體類型。 如需詳細資訊，請參閱 測試 Azure DevOps 的元數據參考。
EntitySet |
EntityType |
描述 |
|---|---|---|
| 區域 | 適用範圍 | 工作專案 區域路徑，具有依區域階層分組和篩選的屬性。 |
| 日期 | CalendarDate | 用來使用關聯性來篩選和分組其他實體的日期。 |
| 反覆運算 | 反覆程序 | 工作專案 反覆運算路徑，具有依反覆運算階層分組和篩選的屬性。 |
| BoardLocations | BoardLocation | 面板數據格位置，如板柱、泳道和分割所識別，包括歷史板設定。 如需每個面板欄位的描述，請參閱 工作流程和面板欄位。 |
| 程序 | 處理 | 用來展開或篩選工作專案和工作專案類型的待辦項目資訊。 如需使用 進程 來篩選報表的範例，請參閱 需求追蹤範例報告。 支援 Analytics v2.0 版和更新版本。 |
| 專案 | 計畫 | 針對組織（雲端）或專案集合（內部部署）定義的所有專案。 |
| Tags (標籤) | 標籤 | 每個專案的所有工作項目標記。 如需使用 標籤 來篩選報表的範例，請參閱 發行燒毀範例報表。 |
| 團隊 | 小組 | 針對項目定義的所有小組。 如需使用 Teams 篩選報表的範例，請參閱 將小組交叉分析篩選器新增至Power BI報表。 |
| 使用者 | 使用者 | 用來展開或篩選各種工作專案屬性的用戶資訊，例如 [指派給]、 [建立者]。 |
| WorkItemBoardSnapshot | WorkItemBoardSnapshot | （綜合）每個行事曆日期上每個工作項目的狀態，包括用來產生趨勢報表的面板位置。 如需範例報表，請參閱 累積流程圖 （CF） 範例報表。 |
| WorkItemLinks | WorkItemLink | 工作項目之間的連結，例如 Child、 Parent 和 Related。 只包含連結的最新修訂，沒有歷程記錄。 未包含超連結。 |
| WorkItemRevisions | WorkItemRevision | 所有歷史工作專案修訂，包括目前的修訂。 不包含已刪除的工作專案。 |
| WorkItemSnapshot | WorkItemSnapshot | （綜合）每個行事曆日期上每個工作專案的狀態，用來支援趨勢報告。 如需範例報告，請參閱 錯誤趨勢範例報告。 |
| WorkItems | WorkItem | 工作專案的目前狀態。 用來支持狀態報告。 如需範例報表，請參閱 匯總子工作專案值至父範例報表。 |
| WorkItemTypeFields | WorkItemTypeField | 每個工作專案類型和進程的工作項目屬性。 用來支援建置報表。 |
關於快照集
有兩個工作追蹤快照集實體集： WorkItemSnapshot 和 WorkItemBoardSnapshot。
快照集會提供每天為工作項目定義的值記錄。 記錄會每天同時寫入分析一次。 當您想要產生趨勢報表時，請使用快照集。 根據預設，所有快照集數據表都會模型化為每日快照集事實數據表。 如果您查詢某個時間範圍，則會取得每天的值。 較長的時間範圍會導致大量的記錄。 如果您不需要如此高精確度，您可以使用每周或甚至每月快照集。
如需詳細資訊，請參閱 OData 查詢指導方針、針對跨越很長一段時間的趨勢查詢使用每周或每月快照集。
關於工作專案修訂
每次更新工作專案時，系統都會建立新的修訂，並在欄位中記錄此動作 System.RevisedDate ，這讓指定歷程記錄篩選很有用。 修訂日期會以 RevisedDate （DateTime） 和 RevisedDateSK （Int32） 屬性表示。 為了獲得最佳效能，請使用后一個日期代理索引鍵。 它代表建立修訂的日期，或是作用中或不完整修訂的 Null。
如果您想要包含之後 {startDate} 的所有日期，請將下列篩選新增至您的查詢。
RevisedDateSK eq null or RevisedDateSK gt {startDateSK}
您可以使用 WorkItemRevisions 實體集來載入指定工作專案的所有修訂。 此查詢會針對您篩選的工作專案，傳回所有歷程記錄工作專案修訂，包括目前的修訂。 它不包含已刪除的工作專案。
跨數個實體類型的共享屬性
您可以在 [分析] 檢視中選取的屬性會對應至一般工作追蹤字段，然後選取 [分析屬性]，例如 [週期時間天數] 和 [潛在客戶時間日]。 下表列出和描述的這些屬性大多是針對下列實體類型所定義，除非另有指定。
WorkItemWorkItemRevisionWorkItemSnapshotWorkItemBoardSnapshot
注意
分析服務不會針對指派 HTML 或 RTF 數據類型的長文字欄位儲存任何數據。 這包括 [描述] 和 [歷程記錄] 字段。 分析不會儲存連結或附加的檔案計數。 如需默認進程範本中定義的完整欄位清單，請參閱 工作專案欄位索引。 如需每個數據類型的描述，請參閱 查詢欄位、運算符和巨集。
下表並未包含與 Scrum 和 CMMI 進程特定欄位相關聯的所有屬性。 如需這些欄位的清單，請參閱 進程範本中使用的預設和工作專案欄位的欄位描述、用來追蹤 CMMI 工作專案的欄位。
許多屬性都是以日期為基礎或以用戶為基礎。 這些屬性會與 CalendarDate 和 User 實體集相關聯，如行事曆日期、專案和使用者元數據參考中所述。
顯示名稱Property name |
Data type | 說明Reference name |
|---|---|---|
接受者Microsoft_VSTS_CodeReview_AcceptedBy |
UserSK | 回應程式代碼檢閱的人員名稱。 （CMMI 程式）Microsoft.VSTS.CodeReview.AcceptedBy |
接受日期AcceptedDate |
Datetime | 人員回應程式代碼檢閱的日期和時間。 （CMMI 程式）Microsoft.VSTS.CodeReview.AcceptedDate |
啟用者ActivatedByActivatedByUserSK |
UserSK | 啟動或重新啟用工作專案的小組成員名稱。Microsoft.VSTS.Common.ActivatedBy |
啟動日期ActivatedDate |
Datetime | 當小組成員啟動或重新啟用 Bug 或工作專案的日期和時間。Microsoft.VSTS.CodeReview.ActivatedDate |
ActivityActivity |
String | 執行工作所需的活動類型。Microsoft.VSTS.Common.Activity指派給工作的活動或專業領域類型。 允許的值為：部署、設計、開發、檔、需求和測試。 （敏捷式、Scrum 和基本程式） Microsoft.VSTS.Common.Activity |
AnalyticsUpdatedDate |
DateTimeOffset | 上次更新實體的數據與時間。 |
| 應用程式類型 | String | 項目關係人會提供意見反應的應用程式類型。 預設值為 Web 應用程式、 遠端電腦和 用戶端應用程式。 有效的類型會在進程組態檔中指定，以供使用內部部署 XML 進程的專案使用。 Microsoft_VSTS_Feedback_ApplicationType |
區域路徑AreaPathAreaSK |
String | 將工作專案分組至產品功能或小組區域。 區域必須是專案階層中的有效節點。System.AreaPath |
指派給 AssignedToAssignedToUserSK |
UserSK | 目前擁有工作專案的小組成員名稱。System.AssignedTo |
自動化測試標識碼 AutomatedTestId |
String | 自動化測試案例的測試標識碼。Microsoft.VSTS.TCM.AutomatedTestId |
自動化測試名稱 AutomatedTestName |
String | 啟動或重新啟用工作專案的小組成員名稱。Microsoft.VSTS.TCM.AutomatedTestName |
自動化測試記憶體AutomatedTestStorage |
String | 包含自動化測試案例之測試的元件。Microsoft.VSTS.TCM.AutomatedTestStorage |
自動化測試類型AutomatedTestType |
String | 自動化測試案例的測試類型。Microsoft.VSTS.TCM.AutomatedTestType |
自動化狀態AutomatedStatus |
String | 具有下列已接受值的測試案例狀態：自動化、非自動化或已規劃。 Microsoft.VSTS.TCM.AutomationStatus |
待處理專案優先順序BacklogPriority |
雙重 | 系統背景進程指派的數位，用來堆疊待辦專案或面板上的專案順序或追蹤順序。 （Scrum 程式） Microsoft.VSTS.Common.BacklogPriority |
封鎖Blocked |
String | 表示無法對工作項目執行任何進一步的工作。 有效值為 [是 ] 或 [否]。 （CMMI 程式）Microsoft.VSTS.CMMI.Blocked |
商業價值BusinessValue |
雙重 | 相較於相同類型的其他專案，可擷取產品待辦專案或功能的相對商業價值測量單位。 指派較高數位的項目應該視為具有比指派較低數位的專案更多的商業價值。 Microsoft.VSTS.Common.BusinessValue |
變更者ChangedByChangedByUserSK |
UserSK | 最近修改工作項目的人員名稱。System.ChangedBy |
已變更日期ChangedDate |
Datetime | 修改工作專案的日期和時間。System.ChangedDate |
ChangedDateSK |
Int32 | 修改工作專案的日期，如 YYYYMMDD 為組織定義的時區表示。 外部工具用來聯結相關實體。 |
ChangedOn |
導覽 | 在為組織定義的時區中，修改工作專案日期的實體導覽屬性 Date 。 通常用來參考語句中實體的屬性Dategroupby。 |
關閉者ClosedByClosedByUserSK |
UserSK | 關閉工作項目的人員名稱。 Microsoft.VSTS.Common.ClosedBy |
關閉日期ClosedDateClosedDateSKClosedOn |
Datetime | 關閉工作專案的日期和時間。Microsoft.VSTS.Common.ClosedDate |
批注計數CommentCount |
Int32 | 新增至 工作專案 [討論 ] 區段的批注數目。System.CommentCount |
承諾Committed |
String | 指出專案中是否認可需求。 有效值為 [是 ] 或 [否]。 （CMMI 程式）Microsoft.VSTS.CMMI.Committed |
CompletedDateSK |
Int32 | Analytics 所擷取的導覽屬性日期，儲存工作專案進入與已完成工作流程狀態類別相關聯的工作流程狀態時。 |
CompletedOn |
導覽 | 工作專案在為組織定義的時區中，輸入與已完成工作流程狀態類別相關聯之工作流程狀態類別的實體導覽屬性Date。 通常用來參考語句中實體的屬性Dategroupby。 |
已完成的工作CompletedWork |
雙重 | 工作所花費工時量的量值。Microsoft.VSTS.Scheduling.CompletedWork |
建立者CreatedByCreatedByUserSK |
UserSK | 建立工作項目的人員名稱。 Microsoft.VSTS.Common.CreatedBy |
建立日期CreatedDateCreatedDateSK |
Datetime | 建立工作專案的日期，以為組織定義的時區表示。 通常用於篩選和顯示。 Microsoft.VSTS.Common.CreatedDate |
CreatedDateSK |
Int32 | 建立工作專案的日期，如 YYYYMMDD 為組織定義的時區表示。 外部工具用來聯結相關實體。 |
CreatedOn |
導覽 | 在為組織定義的時區中，建立工作專案日期的實體導覽屬性 Date 。 通常用來參考語句中實體的屬性Dategroupby。 |
週期時間天CycleTimeDays |
雙重 | 週期時間是從第一次輸入 [進行 中] 或 [已解析 ] 狀態類別到輸入 已完成 狀態類別所計算。 如需詳細資訊，請參閱 前置時間和週期時間小工具。 |
學科Discipline |
String | 指派給工作的活動或專業領域類型。 允許的值為： Analysis*、 Development、 Test、 User Education 和 User Experience。 （CMMI 程式） Microsoft.VSTS.Common.Activity |
到期日DueDate |
Datetime | 將解決問題或工作項目的預測到期日。 （敏捷式程式）Microsoft.VSTS.Scheduling.DueDate |
努力Effort |
雙重 | 產品待辦專案（Scrum 程式）或問題（基本程式）需要實作的工作量估計。 Microsoft.VSTS.Scheduling.Effort |
完成日期FinishDate |
Datetime | 排程指出工作專案將完成的日期和時間。Microsoft.VSTS.Scheduling.FinishDate |
在FoundIn |
String | 產品組建編號，也稱為修訂，在其中找到 Bug。Microsoft.VSTS.Build.FoundIn |
InProgress 日期 InProgressDate |
Datetime | 分析儲存的日期，會擷取工作專案移至屬於 [進行中] 狀態類別的 [狀態] 時日期時間。 |
InProgressDateSK |
Int32 | 工作專案的日期已移至屬於 [進行中] 狀態類別的 State，如YYYYMMDD為組織定義的時區所示。 外部工具用來聯結相關實體。 |
整合組建IntegrationBuild |
String | 包含程式代碼或修正 Bug 的產品組建編號。Microsoft.VSTS.Build.IntegrationBuild |
目前為IsCurrent |
布林值 | 支援藉由將 值設定為 True，篩選數據以檢視已篩選工作專案集的最新快照集。這些實體類型有效： WorkItemRevision、 WorkItemBoardSnapshot和 BoardLocation。 |
這是當天的最後一個修訂IsLastRevisionOfDay |
布林值 | 表示快照集表示設定 True為 時當天的最後一個修訂。 |
這是期間的最後一個修訂IsLastRevisionOfPeriod |
布林值 | 表示快照集表示設定 True為 時期間的最後一個修訂。 |
問題Issue |
String | 表示共用步驟與預期的結果相關聯。 允許的值為 [是 ] 和 [否]。 Microsoft.VSTS.Common.Issue |
前置時間天數LeadTimeDays |
雙重 | 前置時間是從工作專案建立或輸入 建議 狀態類別到輸入 已完成 狀態類別目錄來計算。 如需詳細資訊，請參閱 前置時間和週期時間小工具。 |
原始估計值OriginalEstimate |
雙重 | 完成工作所需的工作量量值。 Microsoft.VSTS.Scheduling.OriginalEstimate |
父工作項目標識碼 ParentWorkItemId |
Int32 | 唯一標識符，識別連結至 的工作專案做為父代。 適用於產生匯總報表。 [ 父 ] 字段可從 Azure DevOps Server 2020 和更新版本取得。 這些實體類型有效： WorkItemRevision 和 WorkItem。 System.Parent |
優先順序Priority |
Int32 | 與業務相關的 Bug、問題、工作或測試案例的主觀評等。 值包括： - 1、 2 或 3。 Microsoft.VSTS.Common.Priority |
專案名稱ProjectName |
導覽 | 工作專案所屬的項目名稱。 如需詳細資訊，請參閱 行事曆日期、專案和使用者元數據參考、Project 屬性。System.TeamProject |
ProjectSK |
GUID | 指派給工作專案所屬專案的 GUID。 |
評分 Reason |
String | 專案在星型排名系統中從檢閱者收到的星號數目。 （意見反應）數字會儲存在系統中，並寫入如下：-0 - 未分級，1 - 可憐，2 - 公平，3 - 良好，4 - 非常好，5 - 優秀。 這些實體類型有效： WorkItemRevision 和 WorkItem。Microsoft.VSTS.Common.Rating |
原因 Reason |
String | 工作項目處於目前狀態的原因。 每個從一個工作流程狀態轉換到另一個工作流程狀態都與對應的原因相關聯。 System.Reason |
剩餘工時 RemainingWork |
雙重 | 要完成工作的工作量量值。Microsoft.VSTS.Scheduling.RemainingWork |
解決者 ResolvedBy ResolvedByUserSK |
UserSK | 已解決 Bug 或使用者劇本的小組成員名稱。Microsoft.VSTS.Common.ResolvedBy |
已解決日期 ResolvedDate |
Datetime | Bug 或使用者劇本解決的日期和時間。 Microsoft.VSTS.Common.ResolvedDate |
ResolvedDateSK |
Int32 | 工作項目的解決日期，如 YYYYMMDD 為組織定義的時區表示。 外部工具用來聯結相關實體。 |
ResolvedOn |
導覽 | 在為組織定義的時區中，解析工作專案日期的實體導覽屬性 Date 。 通常用來參考語句中實體的屬性Dategroupby。 |
已解決的原因ResolvedReason |
String | 已解決 Bug 的原因（例如已修正）。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 |
String | 工作專案的目前狀態。 狀態的有效值專屬於每個工作項目類型，以及針對它所做的自定義。System.State |
狀態類別 StateCategory |
String | 狀態類別會決定 Azure Boards 和選取儀錶板小工具處理每個工作流程狀態的方式。 使用中的狀態類別包括：建議、進行中、已解決、已移除和已完成。 如需詳細資訊，請參閱 如何使用工作流程狀態和狀態類別。 僅適用於 WorkItemRevision 實體類型。 |
狀態變更日期 StateChangeDate |
Datetime | State 欄位值變更的日期和時間。 Microsoft.VSTS.Common.StateChangeDate |
StateChangeSK |
Int32 | 工作專案的狀態已變更的日期，如 YYYYMMDD 為組織定義的時區表示。 外部工具用來聯結相關實體。 |
StateChangeOn |
導覽 | 在為組織定義的時區中，工作專案狀態已變更日期的實體導覽屬性 Date 。 通常用來參考語句中實體的屬性Dategroupby。 |
故事點 StoryPoints |
雙重 | 用戶劇本 （Agile process） 需要實作的工作量估計值，通常匯總為總和。 Microsoft.VSTS.Scheduling.StoryPoints |
Tags (標籤)TagNames |
String | 針對篩選或查詢的目的，分號分隔指派給一或多個工作專案的標記清單。System.Tags |
目標日期 TargetDate |
Datetime | 預測的到期日，問題或其他工作項目將解決或完成。Microsoft.VSTS.Scheduling.TargetDate |
| 測試套件類型 | String | 指定測試套件的類型。 有效值包括： 查詢型、 需求型和 靜態。Microsoft_VSTS_TCM_TestSuiteType |
| 測試套件類型識別碼 | Int64 | 系統指派的數字，對應至測試套件類別，且僅適用於測試套件。 指派的值包括：1（靜態）、2（查詢型）和 3（需求型）。Microsoft_VSTS_TCM_TestSuiteTypeId |
時間關鍵性 TimeCriticality |
雙重 | 測量的主觀單位，可擷取企業價值隨時間減少的方式。 較高的值表示 epic 或 功能本質上比值較低的專案更具時間關鍵性。 Microsoft.VSTS.Common.TimeCriticality |
標題 Title |
String | 簡短描述，摘要說明工作項目是什麼，並協助小組成員將它與清單中的其他工作專案區別開來。 System.Title |
值區域 ValueArea |
String | 由 Epic、功能或待辦專案尋址的客戶價值區域。 值包括： 架構 或 商務。Microsoft.VSTS.Common.ValueArea |
浮浮水印Watermark |
String | 系統管理的欄位，會隨著對工作專案所做的變更而遞增。 這些實體類型有效： WorkItemRevision 和 WorkItem。System.Watermark |
工作項目識別碼WorkItemId |
Int32 | 指派給工作專案的唯一標識符。 工作專案標識碼在所有專案及組織或專案集合內都是唯一的。System.Id |
WorkItemRevisionSK |
Int32 | 外部工具用來聯結相關實體之工作專案修訂的分析唯一索引鍵。 |
工作項目類型 WorkItemType |
String | 工作項目類型的名稱。 工作專案類型是根據您建立專案時所使用的程式來定義。 如需詳細資訊，請參閱 關於進程和進程範本。 System.WorkItemType |
導覽屬性
OData 中的導覽屬性是指向另一個實體之實體的參考屬性。 下表提供導覽屬性的摘要、其引用條件約束，以及它們有效的實體類型。
| Display name | 名字 引用條件約束和屬性 |
對實體類型有效 |
|---|---|---|
ChangedOnChangedDateSK, DateSK |
WorkItemRevision、 、 WorkItemSnapshotWorkItemBoardSnapshot |
|
ClosedOn ClosedDateSK, DateSK |
WorkItemRevision、 、 WorkItemSnapshotWorkItemBoardSnapshot |
|
CreatedOnCreatedDateSK, DateSK |
WorkItemRevision、 、 WorkItemSnapshotWorkItemBoardSnapshot |
|
ResolvedOnResolvedDateSK, DateSK |
WorkItemRevision、 、 WorkItem、 WorkItemSnapshotWorkItemBoardSnapshot |
|
StateChangeOnStateChangeDateSK, DateSK |
WorkItemRevision、 、 WorkItem、 WorkItemSnapshotWorkItemBoardSnapshot |
|
InProgressOnInProgressDateSK, DateSK |
WorkItemRevision、 、 WorkItem、 WorkItemSnapshotWorkItemBoardSnapshot |
|
CompletedOnCompletedDateSK, DateSK |
WorkItemRevision、 、 WorkItem、 WorkItemSnapshotWorkItemBoardSnapshot |
|
ChangedOnChangedDateSK, DateSK |
WorkItemRevision、 、 WorkItem、 WorkItemSnapshotWorkItemBoardSnapshot |
|
RevisedOnRevisedDateSK, DateSK |
WorkItemRevision, WorkItemSnapshot |
|
Date DateSK, DateSK |
WorkItemRevision、 、 WorkItemSnapshotWorkItemBoardSnapshot |
|
| 區域 | Area AreaSK |
WorkItemRevision、 、 WorkItem、 WorkItemSnapshotWorkItemBoardSnapshot |
| BoardLocation | WorkItemRevision、 、 WorkItemWorkItemBoardSnapshot |
|
| 反覆運算 | Iteration IterationSK |
WorkItemRevision、 、 WorkItem、 WorkItemSnapshotWorkItemBoardSnapshot |
| 指派給 | AssignedTo AssignedToUserSK, UserSK |
WorkItemRevision、 、 WorkItem、 WorkItemSnapshotWorkItemBoardSnapshot |
| 變更者 | ChangedBy ChangedByUserSK, UserSK |
WorkItemRevision、 、 WorkItem、 WorkItemSnapshotWorkItemBoardSnapshot |
| 建立者 | CreatedBy CreatedByUserSK, UserSK |
WorkItemRevision、 、 WorkItem、 WorkItemSnapshotWorkItemBoardSnapshot |
| 啟用者 | ActivatedBy ActivatedByUserSK, UserSK |
WorkItemRevision、WorkItem、、 WorkItemSnapshotWorkItemBoardSnapshot |
| 關閉者 | ClosedBy ClosedBySK, UserSK |
WorkItemRevision、 、 WorkItem、 WorkItemSnapshotWorkItemBoardSnapshot |
| ResolvedBy | ResolvedBy ResolvedByUserSK, UserSK |
WorkItemRevision、 、 WorkItemSnapshotWorkItemBoardSnapshot |
| 團隊 | Area、、BoardLocationIteration、WorkItemRevision、、WorkItemSnapshot、WorkItemBoardSnapshot |
|
| Tags (標籤) | WorkItem、 、 WorkItemRevisionWorkItemBoardSnapshot |
|
| 計畫 | Project ProjectSK, ProjectSK |
Tag、WorkItemBoardSnapshot、、WorkItemRevisionWorkItemLink、WorkItemSnapshot、、、 WorkItemTypeField |
| 程序 | WorkItemRevision、 、 WorkItemWorkItemSnapshot |
|
| 修訂 | WorkItem |
|
| 連結 | WorkItem |
|
| 子系 | WorkItem |
|
| 上層 | WorkItem |
|
| 子系 | WorkItem |
|
| WorkItem | WorkItemId |
WorkItemRevision |
預測函式
WorkItem 實體支援下列兩個函式。 這些函式用於支持選取 [分析] 內建報表和小工具的預測趨勢。
PredictTagsPredict
BoardLocation 和 WorkItemBoardSnapshot
下表所列和描述的屬性會針對下列實體類型定義，除非特別指出。 使用這些欄位，您可以根據小組面板數據行、泳道或待辦專案層級內的工作專案狀態來篩選工作項目數據。
BoardLocationWorkItemBoardSnapshot
如需查詢實體集的 WorkItemBoardSnapshot 範例，請參閱 累積流程圖 （CF） 範例報表。
顯示名稱Property name |
Data type | 說明Reference name |
|---|---|---|
面板標識碼 BoardId |
Guid | 指派給面板的唯一 GUID。 每個小組都會與一或多個面板相關聯。 |
面板類別參考名稱BoardCategoryReferenceName |
String | 指派給用來填入面板之工作專案類型類別的名稱。 例如，產品待辦專案面板與需求類別相關聯。 如需詳細資訊，請參閱自定義待辦專案或面板（繼承程式）。 |
面板名稱 BoardName |
String | 指派給面板的名稱。 例如，劇本、待辦專案、功能和 Epic。 |
面板層級BoardLevel |
Int32 | 指派給面板的數字，根據它位於面板階層中的位置。 |
待辦項目類型 BacklogType |
String | 待辦專案類型的名稱。 例如，反覆專案、需求或組合。 |
資料行名稱ColumnName |
String | 目前指派工作專案之面板數據行的名稱，例如 Active、 Closed、 Committed、 Done 或其他自定義數據行標籤。 System.BoardColumn |
數據行順序ColumnOrder |
Int32 | 在面板內的序列中，指派給面板數據行的數位。 |
完成 Done |
Enumerated | 表示分割數據行位置。 下列是 BoardColumnSplit 的有效值。 |
數據行專案限制ColumnItemLimit |
Int32 | 依順序指派給面板數據行的數位。 |
面板可見 IsBoardVisible |
布林值 | 指出小組是否已選擇讓面板可見。 |
為數據行分割IsColumnSplit |
布林值 | 指出數據行是否已分割成 [執行 ] 和 [完成 ] 資料行，如面板上的分割數據行中所述 ，以顯示進行中的工作。 |
目前為 IsCurrent |
布林值 | 屬性，支援篩選數據，藉由將 值設定為 True，以檢視已篩選工作專案集的最新快照集。 |
是預設車道 IsDefaultLane |
布林值 | 屬性，表示工作專案已指派給預設泳道 （True） 或不是 （False）。 |
已完成 IsDone |
布林值 | 目前的工作專案指派至 數據行內的 [執行 ] 或 [False] 或 [True ]。 只有在面板數據行啟用分割數據行時才指派。 System.BoardColumnDone |
Lane Id LaneId |
Guid | 指派給板泳道的唯一 GUID。 每個球隊都可以將一或多個泳道新增至面板。 如需泳道的詳細資訊，請參閱 在棋盤中使用泳道加速您的團隊工作。 |
車道名稱LaneName |
String | 指派給板泳道的名稱。System.BoardLane |
車道順序LaneOrder |
Int32 | 根據其序列指派給板泳道的數位。 |
BoardColumnSplit 列舉成員
下表列出列舉型別的成員名稱BoardColumnSplit，可用來篩選 [執行] 或 [完成] 面板數據行中的工作專案。
| 成員名稱 | 值 | Display name |
|---|---|---|
Doing |
0 | 正在進行 |
Done |
1 | 完成 |
Unknown |
2 | 未知（未分割） |
如需小組面板數據行的詳細資訊，請參閱下列文章：
區域
下列屬性適用於與 [區域路徑] 字段相關聯的 Areas 實體集。 與 Area 包含 AreaSK 和 ProjectSK相關聯的 Surrogate 索引鍵。 您可以使用這些屬性，根據區域路徑指派來篩選或報告工作追蹤數據。
| 顯示名稱 | 名稱 | Data type | 說明 |
|---|---|---|---|
AnalyticsUpdatedDate |
Datetime | 浮浮水印，指出上次更新分析數據的時間。 | |
Number |
Int32 | 建立區域路徑節點時指派給區域的整數值。 | |
| 深度 | Depth |
Int32 | 區域路徑根據根層級的深度定義所在的層級。 |
| 區域標識碼 | AreaId |
GUID | 建立區域路徑時指派給區域路徑的唯一標識碼。 |
| 區域層級 1 到 區域層級 14 |
AreaLevel1 通過AreaLevel14 |
String | 與區域路徑節點層級相關聯的名稱。 最多支援14個巢狀層級。 例如，區域層級 1 一律會對應至根節點和項目名稱。 |
| 區域名稱 | AreaName |
String | 建立區域路徑時所定義的名稱。 |
| 區域路徑 | AreaPath |
String | 從根節點開始的區域路徑完整路徑。 |
重要
- 刪除區域路徑或重新設定反覆項目路徑會導致無法復原的數據遺失。 例如，具有已變更 區域路徑 之小組的衝刺燒毀和速度圖表不會顯示精確的數據。 歷史趨勢圖會參考 區域路徑 和 反覆專案路徑 ，因為它們是在每次工作專案定義時所定義的。 刪除之後，您無法擷取這些路徑的歷程記錄數據。
- 您只能刪除任何工作專案不再使用的區域和反覆項目路徑。
區域實體類型和 Areas 實體集的導覽屬性包括 Project 和 Teams。
如需區域路徑的詳細資訊，請參閱下列文章：
反覆項目
下列屬性適用於 [反復專案] 實體集，與 [反復項目路徑] 字段相關聯。 與 反覆項目 相關聯的 Surrogate 索引鍵包括 IterationSK 和 ProjectSK。 您可以使用這些屬性，根據反覆項目路徑指派來篩選或報告工作追蹤數據。
| 顯示名稱 | 名稱 | Data type | 說明 |
|---|---|---|---|
AnalyticsUpdatedDate |
Datetime | 浮浮水印，指出上次更新分析數據的時間。 | |
Number |
Int32 | 建立反覆運算路徑節點時，指派給反覆運算路徑節點的整數值。 | |
| 深度 | Depth |
Int32 | 根據從根層級的深度定義反覆專案路徑的層級。 |
| 結束日期 | EndDate |
Datetime | 針對反覆項目路徑定義的結束日期。 |
| IsEnded | IsEnded |
布林值 | 當設定為 True 時，表示反覆專案路徑結束日期是過去。 |
| 反覆項目標識碼 | IterationId |
GUID | 建立反覆運算路徑時，指派給反覆運算路徑的唯一標識符。 |
| 反覆專案層級 1 到 反覆項目層級 14 |
IterationLevel1 通過IterationLevel14 |
String | 與反覆運算路徑節點層級相關聯的名稱。 最多支援14個巢狀層級。 例如，反覆專案層級 1 一律會對應至根節點和項目名稱。 |
| 反覆項目名稱 | IterationName |
String | 建立反覆運算路徑時所定義的名稱。 |
| 反覆項目路徑 | IterationPath |
String | 從根節點開始之反覆項目路徑的完整路徑。 反覆項目必須是項目階層中的有效節點。 System.IterationPath |
| 開始日期 | StartDate |
Datetime | 針對反覆項目路徑定義的開始日期。 |
重要
- 刪除區域路徑或重新設定反覆項目路徑會導致無法復原的數據遺失。 例如，具有已變更 區域路徑 之小組的衝刺燒毀和速度圖表不會顯示精確的數據。 歷史趨勢圖會參考 區域路徑 和 反覆專案路徑 ，因為它們是在每次工作專案定義時所定義的。 刪除之後，您無法擷取這些路徑的歷程記錄數據。
- 您只能刪除任何工作專案不再使用的區域和反覆項目路徑。
反覆運算實體類型和反覆運算實體集的導覽屬性包括 Project 和 Teams。
如需反覆運算路徑的詳細資訊，請參閱下列文章：
程序
下列屬性適用於 Process 實體類型和 Process 實體集。 與進程相關聯的 Surrogate 索引鍵包括 ProcessSK、 和 。TeamSKProjectSK 您可以使用這些屬性，根據專案或小組所使用的工作專案類型篩選或報告工作追蹤數據。
注意
v-2.0、v3.0-preview 和 v4.0-preview 版本的 Analytics 支援 Process 實體類型和 Process 實體集。
您可以使用這些屬性，根據待處理專案層級篩選工作追蹤數據
| 顯示名稱 | 名稱 | Data type | 說明 |
|---|---|---|---|
AnalyticsUpdatedDate |
Datetime | 浮浮水印，指出上次更新分析數據的時間。 | |
ProjectSK |
GUID | 與程式相關聯的專案索引鍵。 | |
TeamSK |
GUID | 與程式相關聯的小組金鑰。 | |
| 待處理項目類別參考名稱 | BacklogCategoryReferenceName |
String | 指派給與工作項目類型相關聯之待辦專案的類別參考名稱。 範例包括 Microsoft.EpicCategory、、Microsoft.RequirementCategoryMicrosoft.FeatureCategory、 Microsoft.TaskCategory。 |
| 待辦項目名稱 | BacklogName |
布林值 | 指派給與工作項目類型相關聯待辦項目的參考名稱 |
| 待辦項目類型 | BacklogType |
GUID | 建立反覆運算路徑時，指派給反覆運算路徑的唯一標識符。 |
| 待辦專案層級 | BacklogLevel |
String | 指定與工作項目類型相關聯的待辦專案層級。 如果工作項目類型與待辦專案層級沒有關聯，傳回的值會是 null。 |
| 工作項目類型 | WorkItemType |
String | 為工作項目類型定義的名稱。 |
| 有待處理專案 | HasBacklog |
String | 指出工作專案類型是否屬於待辦專案。 |
| 為隱藏類型 | IsHiddenType |
布林值 | 指出工作項目類型是否已停用。 |
| 為 Bug 類型 | IsBugType |
布林值 | 指出工作項目類型是否屬於 Bug 類別。 |
| 已刪除 | IsDeleted |
布林值 | 指出工作項目類型是否已刪除。 |
如需處理待辦專案和工作專案類型的詳細資訊，請參閱下列文章：
自訂工作項目類型和自定義待辦項目類別
自定義工作項目類型的數據會自動新增至 Analytics 服務。
定義自定義工作項目類型和待辦專案層級時，會建立自定義類別。 Custom_ 會前面加上類別 GUID。 例如，針對 包含公事包待辦專案的公 事包自定義工作項目類型，GUID 會指派給自訂類別，例如 Custom.49b81c4e-9c4f-4c04-94fd-d660cbf3a000。
標籤
下列屬性適用於 Tags 實體集。 與 Tag 相關聯的 Surrogate 索引鍵 包含 TagSK 和 ProjectSK。 導覽屬性包括 Project 及其引用條件約束 ProjectSK。 如需使用標籤的詳細資訊，請參閱 新增工作專案標籤來分類和篩選清單和面板。
您可以使用這些屬性來篩選或報告工作追蹤資料。
| 顯示名稱 | 名稱 | Data type | 說明 |
|---|---|---|---|
| 標記標識碼 | TagId |
GUID | 建立標記時指派給標記的唯一標識符。 |
| 標記名稱 | TagName |
String | 標記名稱。 |
Teams
下列屬性適用於 Team 實體類型和 Teams 實體集。 與 Team 相關聯的 Surrogate 索引鍵包括 TeamSK 和 ProjectSK。 您可以使用這些屬性，根據小組指派篩選或報告工作追蹤數據。 如需使用和新增小組的相關信息，請參閱 關於小組和敏捷式工具 ，以及 建立或新增小組。
| 顯示名稱 | 名稱 | Data type | 說明 |
|---|---|---|---|
AnalyticsUpdatedDate |
Datetime | 浮浮水印，指出上次更新分析數據的時間。 | |
| 小組標識碼 | TeamId |
GUID | 建立時指派給小組的唯一標識符。 |
| 小組名稱 | TeamName |
String | 小組名稱。 |
Teams 實體集的導覽屬性包括 Projects、Areas和 Iterations。
WorkItemLinks
下列屬性適用於 WorkItemLinks 實體集。 屬性參考 Surrogate 索引鍵為 WorkItemLinkSK。
查詢 WorkItemLinks 以報告父/子系、相關、前置/後續專案或其他連結類型。
| 顯示名稱 | 名稱 | Data type | 說明 |
|---|---|---|---|
AnalyticsUpdatedDate |
Datetime | 浮浮水印，指出上次更新分析數據的時間。 | |
WorkItemLinkSK |
Int32 | 指派給實體的 WorkItemLink Surrogate 索引鍵。 |
|
| 建立日期 | CreatedDate |
GUID | 建立連結的日期。 |
| 註解 | Comment |
String | 建立連結時新增的批注。 |
| 已刪除日期 | DeletedDate |
String | 刪除連結的日期。 |
| 連結類型識別碼 | LinkTypeId |
Int32 | 指派給連結目標工作項目的標識碼。 |
| 連結類型名稱 | LinkTypeName |
String | 指派給連結類型的易記名稱。 |
| 連結類型參考名稱 | LinkTypeReferenceName |
String | 指派給連結類型的參考名稱。 |
| 連結類型為無迴圈 | LinkTypeIsAcyclic |
布林值 | 鏈接類型屬性的值，指出當值設定為 True 時，連結類型允許迴圈關聯性。 例如，樹狀結構類型連結會限制迴圈關聯性。 |
| 連結類型為方向 | LinkTypeIsDirectional |
布林值 | 表示連結類型為方向的連結類型屬性值。 方向連結類型會與正向和反向元件成對定義。 |
| 來源工作項目標識碼 | SourceWorkItemId |
Int32 | 指派給連結來源工作項目的標識碼。 |
| 目標工作項目識別碼 | TargetWorkItemId |
Int32 | 指派給連結目標工作項目的標識碼。 |
WorkItemLink 實體類型的導覽屬性包括 Projects、 SourceWorkItem和 TargetWorkItem。
如需連結和連結類型的詳細資訊，請參閱下列文章：
WorkItemTypeFields
下列屬性適用於 WorkItemTypeFields 實體集。 屬性參考索引鍵為 FieldName、 ProjectSK和 WorkItemType。
| 顯示名稱 | 名稱 | Data type | 說明 |
|---|---|---|---|
| 欄位名稱 | FieldName |
String | 系統或建立欄位時指派給欄位的易記名稱。 |
| 欄位參考名稱 | FieldReferenceName |
String | 系統指派給欄位的參考名稱，或建立自定義欄位時。 |
| 欄位類型 | FieldType |
String | 指派給欄位的數據類型。 |
| 工作項目類型 | WorkItemType |
String | 定義欄位的工作項目類型名稱。 |
導覽屬性包括 Project。
如需為項目定義之所有欄位的索引，請參閱 工作專案欄位的欄位描述。 如需詳細資訊，請參閱下列文章：
自訂屬性
自定義欄位會自動新增至 Analytics 服務做為自訂屬性。 Custom_ 或 Custom. 前面加上屬性名稱。 檢查集合的元數據，如建構分析的 OData 查詢、URL 元件以查詢元數據中所述。 下列範例提供自定義欄位 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>