分享方式：

Azure DevOps Analytics 的行事曆日期、專案和使用者元數據參考

  • 文章

Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019

下表所列的實體類型和實體集可用來根據 Analytics 數據篩選和建置報告。

EntitySet EntityType 描述
日期 CalendarDate 用來使用關聯性來篩選和分組其他實體的日期。
專案 計畫 針對組織（雲端）或專案集合（內部部署）定義的專案。
使用者 使用者 用來展開或篩選各種工作專案屬性的用戶資訊，例如 [指派給]、 [建立者]。

注意

提供 Analytics 數據模型所支援的實體、屬性和列舉型別描述。 這是一個早期的草稿。 請提供您想要取得詳細資訊的區域意見反應。 若要查詢數據模型，請參閱 建構適用於分析的 OData 查詢。

日期

下列屬性適用於 CalendarDate 實體類型。 與 CalendarDate 相關聯的 Surrogate 索引鍵是 DateSK。 您可以指定行事曆日期屬性來篩選和結構報表。

顯示名稱 名稱 資料類型 說明
IsLastDayOfPeriod 枚舉 用來篩選數據，以判斷某一天是否在不同的期間完成，例如天、周、月或年。 [期間] 的有效值如下。
日期 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有效。 產生組織範圍查詢時，您可以藉由指定一或多個專案名稱來專注於一或多個專案。 若要深入瞭解，請參閱 專案和組織範圍的查詢。

顯示名稱 名稱 資料類型 說明
AnalyticsUpdatedDate Datetime 浮浮水印，指出上次更新分析數據的時間。
項目標識碼 ProjectId GUID 建立專案時指派給專案的唯一標識符。
專案名稱 ProjectName String 建立專案時指派給項目的名稱。
項目可見性 ProjectVisibility 枚舉 指出專案是否為公用或私用專案。 下列是 ProjectVisibility 的有效值。

下列導覽屬性適用於 Project 實體類型。

ProjectVisibility 列舉型別成員

下列成員是針對 ProjectVisibility 列舉型別所定義。 參考其中一個成員來篩選特定專案。

成員名稱 值 Display name
Private 0 私用
Organization 1 Organization
Public 2 公開

使用者

下列屬性適用於 Users 實體集和具有 Surrogate 索引鍵UserSK的用戶實體類型。

顯示名稱 名稱 資料類型 說明
AnalyticsUpdatedDate Datetime 浮浮水印，指出上次更新分析數據的時間。
用戶電子郵件 UserEmail String 與用戶帳戶身分識別相關聯的電子郵件。
使用者 ID UserId GUID 指派給用戶帳戶身分識別的唯一標識符。
使用者名稱 UserName String 建立用戶帳戶身分識別時指派給用戶的名稱。
GitHub 用戶標識碼 GitHubUserId String 與用戶帳戶相關聯的 GitHub 用戶識別碼。
用戶類型 UserType 自訂 使用者的類型。 下列是 UserType 的有效值。

UserType 列舉類型成員

下列成員是針對 UserType 列舉型別所定義。

成員名稱 值 Display name
Unknown 0 未知
Unrecognized 1 未知
User 2 User
Organization 3 Organization
Bot 4 機器人