Azure DevOps Analytics 的日历日期、项目和用户元数据参考

  • 项目

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

下表中列出的实体类型和实体集可用于根据 Analytics 数据筛选和生成报表。

EntitySet EntityType 说明
日期 CalendarDate 用于使用关系筛选和分组其他实体的日期。
项目 项目 为组织（云）或项目集合（本地）定义的项目。
用户 用户 用于展开或筛选各种工作项属性的用户信息，例如 “分配到”和 “创建者”。

注意

提供了分析数据模型支持的实体、属性和枚举类型的说明。 这是一个早期的草案。 请提供有关希望获取详细信息的区域的反馈。 若要查询数据模型，请参阅 为 Analytics 构造 OData 查询。

日期

以下属性对 CalendarDate 实体类型有效。 与 CalendarDate 关联的代理键为 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，对应于 1 月、2 月和 3 月。
YearMonth YearMonth Int32 对应于串联年份和月份的数字。 例如，202201、202202和202203对应于 2022 年 1 月、2 月和 3 月。
Year Year Int32 年份，如 2019、2020、2021 等。

默认情况下，所有快照表都建模为每日快照事实数据表。 如果查询某个时间范围，它将获取每天的值。 较长的时间范围会导致大量记录。 如果不需要如此高的精度，可以使用每周甚至每月快照。

聚合快照实体的数据时，应按照 DateSK OData 查询指南中所述在子句中包含groupby或列DateValue。 有关指定日期筛选器的示例报表，请参阅以下文章：

句点枚举类型成员

为枚举类型定义了 Period 以下成员，这些枚举类型可用于其他筛选表达式，以删除未完成给定的一周或月份的天数。 引用其中一个成员，指定跨长时间段的趋势查询的每周或每月周期。 枚举 Period 类型具有一个属性， IsFlags该属性设置为 True。

成员名称 值 显示名称
None 0 无
Day 1 日期
WeekEndingOnSunday 2 星期末（星期日）
WeekEndingOnMonday 4 周结束于星期一
WeekEndingOnTuesday 8 周末星期二
WeekEndingOnWednesday 16 周末星期三
WeekEndingOnThursday 32 周结束于星期四
WeekEndingOnFriday 64 周结束于星期五
WeekEndingOnSaturday 128 周结束于星期六
Month 256 月份
Quarter 512 Quarter
Year 1024 年
All 2047 All

项目

以下属性对 Projects 实体集及其代理键 ProjectSK有效。 生成组织范围的查询时，可以通过指定一个或多个项目名称来专注于一个或多个项目。 若要了解详细信息，请参阅 Project 和组织范围的查询。

显示名称 名称 数据类型 描述
AnalyticsUpdatedDate DateTime 指示上次更新 Analytics 数据的水印。
项目 ID ProjectId GUID 创建项目时分配给项目的唯一标识符。
项目名称 ProjectName 字符串 创建项目时分配给项目的名称。
项目可见性 ProjectVisibility Enumerated 指示项目是公共项目还是专用项目。 下面列出了 ProjectVisibility 的有效值。

以下导航属性对 Project 实体类型有效。

ProjectVisibility 枚举类型成员

为枚举类型定义了 ProjectVisibility 以下成员。 引用其中一个成员来筛选特定项目。

成员名称 值 显示名称
Private 0 Private
Organization 1 组织
Public 2 开放

用户

以下属性对用户实体集和具有代理项键UserSK的用户实体类型有效。

显示名称 名称 数据类型 描述
AnalyticsUpdatedDate DateTime 指示上次更新 Analytics 数据的水印。
用户电子邮件地址 UserEmail 字符串 与用户帐户标识关联的电子邮件。
用户 ID UserId GUID 分配给用户帐户标识的唯一标识符。
用户名 UserName 字符串 创建用户帐户标识时分配给用户的名称。
GitHub 用户 ID GitHubUserId 字符串 与用户帐户关联的 GitHub 用户 ID。
用户类型 UserType 自定义 用户的类型。 下面列出了 UserType 的有效值。

UserType 枚举类型成员

为枚举类型定义了 UserType 以下成员。

成员名称 值 显示名称
Unknown 0 未知
Unrecognized 1 未知
User 2 用户
Organization 3 组织
Bot 4 聊天机器人