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 |
字符串 | 月份和年份的缩写名称，例如 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 |
Int32 | 年份，如 2019、2020、2021 等。 |
默认情况下，所有快照表都建模为 每日快照事实 数据表。 如果查询某个时间范围，它将获取每天的值。 较长的时间范围会导致大量记录。 如果不需要如此高的精度，可以使用每周甚至每月快照。
聚合快照实体的数据时，应按照 DateSK OData 查询指南中所述在子句中包含groupby或列DateValue。 有关指定日期筛选器的示例报表，请参阅以下文章：
- 查询趋势数据
- 使用 OData Analytics 定义基本查询
- 计算现有 Analytics 视图的状态时间
- Bug 趋势示例报告
- 潜在顾客时间和周期时间示例报告
- 管道传递率趋势示例报告
- 管道任务工期趋势示例报告
句点枚举类型成员
为枚举类型定义了 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 | 季度 |
Year |
1024 | 年份 |
All |
2047 | All |
项目
以下属性对 Projects 实体集及其代理键 ProjectSK有效。 生成组织范围的查询时，可以通过指定一个或多个项目名称来专注于一个或多个项目。 有关详细信息，请参阅 Project 和组织范围的查询。
| 显示名称 | 名称 | 数据类型 | 描述 |
|---|---|---|---|
AnalyticsUpdatedDate |
DateTime | 指示上次更新 Analytics 数据的水印。 | |
| 项目 ID | ProjectId |
GUID | 创建项目时分配给项目的唯一标识符。 |
| 项目名称 | ProjectName |
字符串 | 创建项目时分配给项目的名称。 |
| 项目可见性 | ProjectVisibility |
Enumerated | 指示项目是公共项目还是专用项目。 下面列出了 ProjectVisibility 的有效值。 |
导航属性
以下导航属性对 Project 实体类型有效。
ProjectVisibility 枚举类型成员
为枚举类型定义了 ProjectVisibility 以下成员。 引用其中一个成员来筛选特定项目。
| 成员名称 | 值 | 显示名称 |
|---|---|---|
Private |
0 | 专用 |
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 | 聊天机器人 |