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 | 小組 | 針對專案定義的所有小組。 如需使用 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 |
資料類型 | 說明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 中的導覽屬性是指向另一個實體之實體的參考屬性。 下表提供導覽屬性的摘要、其引用條件約束，以及它們有效的實體類型。
| 顯示名稱 | 名字 引用條件約束和屬性 |
對實體類型有效 |
|---|---|---|
ChangedOnChangedDateSK, DateSK |
WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot |
|
ClosedOn ClosedDateSK, DateSK |
WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot |
|
CreatedOnCreatedDateSK, DateSK |
WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot |
|
ResolvedOnResolvedDateSK, DateSK |
WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot |
|
StateChangeOnStateChangeDateSK, DateSK |
WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot |
|
InProgressOnInProgressDateSK, DateSK |
WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot |
|
CompletedOnCompletedDateSK, DateSK |
WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot |
|
ChangedOnChangedDateSK, DateSK |
WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot |
|
RevisedOnRevisedDateSK, 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 |
| Teams | Area, BoardLocation, Iteration, WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot |
|
| Tags (標籤) | WorkItem, WorkItemRevision, WorkItemBoardSnapshot |
|
| 計畫 | Project ProjectSK, ProjectSK |
Tag, WorkItemBoardSnapshot, WorkItemLink, WorkItemRevision, WorkItemSnapshot, WorkItemTypeField, |
| 程序 | WorkItemRevision, WorkItem, WorkItemSnapshot |
|
| 修訂 | WorkItem |
|
| 連結 | WorkItem |
|
| 子系 | WorkItem |
|
| 上層 | WorkItem |
|
| 子系 | WorkItem |
|
| WorkItem | WorkItemId |
WorkItemRevision |
預測函式
WorkItem 實體支援下列兩個 函式。 這些函式用於支援選取 [分析] 內建報表和小工具的預測趨勢。
PredictTagsPredict
BoardLocation 和 WorkItemBoardSnapshot
下表所列和描述的屬性會針對下列實體類型定義，除非特別指出。 使用這些欄位，您可以根據小組工作流程看板資料行、泳道或待辦專案層級內的工作專案狀態來篩選工作專案資料。
BoardLocationWorkItemBoardSnapshot
如需查詢實體集的 WorkItemBoardSnapshot 範例，請參閱 累積流程圖 （CF） 範例報表 。
顯示名稱Property name |
資料類型 | 說明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 |
枚舉 | 表示分割資料行位置。 下列是 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 索引鍵。 您可以使用這些屬性，根據區域路徑指派來篩選或報告工作追蹤資料。
| 顯示名稱 | 名稱 | 資料類型 | 說明 |
|---|---|---|---|
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 。 您可以使用這些屬性，根據反復專案路徑指派來篩選或報告工作追蹤資料。
| 顯示名稱 | 名稱 | 資料類型 | 說明 |
|---|---|---|---|
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 實體集。
您可以使用這些屬性，根據待處理專案層級篩選工作追蹤資料
| 顯示名稱 | 名稱 | 資料類型 | 說明 |
|---|---|---|---|
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 。 若要深入瞭解如何使用標籤，請參閱 新增工作專案標籤來分類和篩選清單和麵板 。
您可以使用這些屬性來篩選或報告工作追蹤資料。
| 顯示名稱 | 名稱 | 資料類型 | 說明 |
|---|---|---|---|
| 標記識別項 | TagId |
GUID | 建立標記時指派給標記的唯一識別碼。 |
| 標籤名稱 | TagName |
String | 標記名稱。 |
Teams
下列屬性適用于 Team 實體類型和 Teams 實體集。 與 Team 相關聯的 Surrogate 索引鍵包括 TeamSK 和 ProjectSK 。 您可以使用這些屬性，根據小組指派篩選或報告工作追蹤資料。 如需使用和新增小組的相關資訊，請參閱 關於小組和敏捷式工具 ，以及 建立或新增小組 。
| 顯示名稱 | 名稱 | 資料類型 | 說明 |
|---|---|---|---|
AnalyticsUpdatedDate |
Datetime | 浮水印，指出上次更新分析資料的時間。 | |
| 小組識別碼 | TeamId |
GUID | 建立時指派給小組的唯一識別碼。 |
| 小組名稱 | TeamName |
String | 小組名稱。 |
Teams 實體集的 導覽屬性包括 Projects 、 Areas 和 Iterations 。
WorkItemLinks
下列屬性適用于 WorkItemLinks 實體集。 屬性參考 Surrogate 索引鍵為 WorkItemLinkSK 。
查詢 WorkItemLinks 以報告父/子系、相關、前置/後續專案或其他連結類型。
| 顯示名稱 | 名稱 | 資料類型 | 說明 |
|---|---|---|---|
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 。
| 顯示名稱 | 名稱 | 資料類型 | 說明 |
|---|---|---|---|
| 功能變數名稱 | 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>
相關文章
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應