Azure DevOps Analytics 的行事曆日期、專案和使用者元數據參考
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
下表所列的實體類型和實體集可用來根據 Analytics 數據篩選和建置報告。
| EntitySet | EntityType | 描述 |
|---|---|---|
| 日期 | CalendarDate | 用來使用關聯性來篩選和分組其他實體的日期。 |
| 專案 | 計畫 | 針對組織（雲端）或專案集合（內部部署）定義的專案。 |
| 使用者 | 使用者 | 用來展開或篩選各種工作專案屬性的用戶資訊，例如 [指派給]、 [建立者]。 |
注意
提供 Analytics 數據模型所支援的實體、屬性和列舉型別描述。 這是一個早期的草稿。 請提供您想要取得詳細資訊的區域意見反應。 若要查詢數據模型，請參閱 建構適用於分析的 OData 查詢。
日期
下列屬性適用於 CalendarDate 實體類型。 與 CalendarDate 相關聯的 Surrogate 索引鍵是 DateSK。 您可以指定行事曆日期屬性來篩選和結構報表。
| 顯示名稱 | 名稱 | Data type | 說明 |
|---|---|---|---|
IsLastDayOfPeriod |
Enumerated | 用來篩選數據，以判斷某一天是否在不同的期間完成，例如天、周、月或年。 [期間] 的有效值如下。 | |
| 日期 | Date |
Datetime | 特定的行事曆日期。 |
| 日名稱 | DayName |
String | 一天的名稱，例如星期一、星期二、星期三等等。 |
| 日短名稱 | DayShortName |
String | 指派給一天的簡短名稱，例如 Mon、Tue、Wed 等等。 |
| 一周中的一天 | DayOfWeek |
Int32 | 與一周內日期相關聯的數位。 |
| 月日 | DayOfMonth |
Int32 | 與一個月內日期相關聯的數位。 |
| 年中的日 | DayOfYear |
Int32 | 與一年日期相關聯的數位。 |
| 周開始日期 | WeekStartingDate |
Datetime | 與一周開始相關聯的日期。 |
| 周結束日期 | WeekEndingDate |
Datetime | 與一周結束相關聯的日期。 |
| Month | Month |
String | 月份和年份的縮寫名稱，例如 2022 年 1 月、2022 年 2 月、2022 年 3 月等等。 |
| 月份名稱 | MonthName |
String | 月份的名稱，例如 1 月、2 月、3 月等等。 |
| 月份簡短名稱 | MonthShortName |
String | 月份的縮寫名稱，例如 Jan、Feb、Mar 等等。 |
| 年月 | MonthOfYear |
Int32 | 指派給月份的數位。 例如，對應至 1、2 和 3 月、3 月和 3 月的 1、2 和 3。 |
| YearMonth | YearMonth |
Int32 | 對應到串連年份和月份的數位。 例如，202201、202202和202203對應至 2022 年 1 月、2 月和 3 月。 |
| Year | Year |
Int32 | 年份，例如 2019 年、2020 年、2021 年等。 |
根據預設，所有快照集數據表都會模型化為 每日快照集事實 數據表。 如果您查詢某個時間範圍，則會取得每天的值。 較長的時間範圍會導致大量的記錄。 如果您不需要如此高精確度，您可以使用每周或甚至每月快照集。
當您匯總快照集實體的數據時，您應該在 DateSK 子句中包含 groupby 或 數據DateValue行，如 OData 查詢指導方針中所述。 如需指定日期篩選的範例報表，請參閱下列文章：
期間列舉型別成員
下列成員是針對 Period 列舉型別所定義，您可以搭配其他篩選表達式使用，以移除未完成指定周或月份的天數。 參考其中一個成員，以指定跨越很長一段時間的趨勢查詢每周或每月期間。 列舉 Period 型別具有單一屬性 ， IsFlags其設定為 True。
| 成員名稱 | 值 | Display name |
|---|---|---|
None |
0 | 無 |
Day |
1 | Day |
WeekEndingOnSunday |
2 | 星期結束於星期日 |
WeekEndingOnMonday |
4 | 週末星期一 |
WeekEndingOnTuesday |
8 | 週末星期二 |
WeekEndingOnWednesday |
16 | 週末星期三 |
WeekEndingOnThursday |
32 | 週末星期四 |
WeekEndingOnFriday |
64 | 週末星期五 |
WeekEndingOnSaturday |
128 | 週末星期六 |
Month |
256 | Month |
Quarter |
512 | 季 |
Year |
1024 | Year |
All |
2047 | 全部 |
專案
下列屬性對 Projects 實體集及其 Surrogate 索引鍵 ProjectSK有效。 產生組織範圍查詢時，您可以藉由指定一或多個專案名稱來專注於一或多個專案。 如需詳細資訊，請參閱 專案和組織範圍的查詢。
| 顯示名稱 | 名稱 | Data type | 說明 |
|---|---|---|---|
AnalyticsUpdatedDate |
Datetime | 浮浮水印，指出上次更新分析數據的時間。 | |
| 項目標識碼 | ProjectId |
GUID | 建立專案時指派給專案的唯一標識符。 |
| 專案名稱 | ProjectName |
String | 建立專案時指派給項目的名稱。 |
| 項目可見性 | ProjectVisibility |
Enumerated | 指出專案是否為公用或私用專案。 下列是 ProjectVisibility 的有效值。 |
導覽屬性
下列導覽屬性適用於 Project 實體類型。
ProjectVisibility 列舉型別成員
下列成員是針對 ProjectVisibility 列舉型別所定義。 參考其中一個成員來篩選特定專案。
| 成員名稱 | 值 | Display name |
|---|---|---|
Private |
0 | 私用 |
Organization |
1 | Organization |
Public |
2 | 公開 |
使用者
下列屬性適用於 Users 實體集和具有 Surrogate 索引鍵UserSK的用戶實體類型。
UserType 列舉類型成員
下列成員是針對 UserType 列舉型別所定義。
| 成員名稱 | 值 | Display name |
|---|---|---|
Unknown |
0 | 未知 |
Unrecognized |
1 | 未知 |
User |
2 | User |
Organization |
3 | Organization |
Bot |
4 | 機器人 |