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

Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022

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

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

注意

本文提供 Analytics 資料模型所支援的實體、屬性和列舉類型的描述。若要查詢數據模型，請參閱建構適用於分析的 OData 查詢。

日期

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

顯示名稱	名稱	資料類型	說明
	`IsLastDayOfPeriod`	Enumerated	用來篩選數據，以判斷某一天是否在不同的期間完成，例如天、周、月或年。 [期間] 的有效值如下。
日期	`Date`	Datetime	特定的行事曆日期。
日名稱	`DayName`	字串	一天的名稱，例如星期一、星期二、星期三等等。
日短名稱	`DayShortName`	字串	指派給一天的簡短名稱，例如 Mon、Tue、Wed 等等。
一周中的一天	`DayOfWeek`	Int32	與一周內日期相關聯的數位。
月日	`DayOfMonth`	Int32	與一個月內日期相關聯的數位。
一年中的第幾天	`DayOfYear`	Int32	與一年日期相關聯的數位。
周開始日期	`WeekStartingDate`	Datetime	與一周開始相關聯的日期。
周結束日期	`WeekEndingDate`	Datetime	與一周結束相關聯的日期。
Month	`Month`	字串	月份和年份的縮寫名稱，例如 2022 年 1 月、2022 年 2 月、2022 年 3 月等等。
月份名稱	`MonthName`	字串	月份的名稱，例如 1 月、2 月、3 月等等。
月份簡短名稱	`MonthShortName`	字串	月份的縮寫名稱，例如 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 子句中包含 DateValue 或 groupby 列，如 OData 查詢指導方針中所述。如需指定日期篩選的範例報表，請參閱下列文章：

下列成員是針對 Period 列舉型別所定義，您可以搭配其他篩選表達式使用，以移除未完成指定周或月份的天數。請參考這些成員之一，指定長時間趨勢查詢的每周或每月期間。列舉 Period 型別具有單一屬性， IsFlags其設定為 True。

下列屬性適用於 Projects 實體集及其代理鍵 ProjectSK。產生組織範圍查詢時，您可以藉由指定一或多個專案名稱來專注於一或多個專案。如需詳細資訊，請參閱專案和組織範圍的查詢。

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

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

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

下列屬性適用於 Users 實體集和實體類型。

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

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

此頁面對您有幫助嗎？