Справочник по метаданным календаря, проекта и пользователя для Azure DevOps Analytics

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Типы сущностей и наборы сущностей, перечисленные в следующей таблице, можно использовать для фильтрации и создания отчетов на основе данных аналитики.

EntitySet ТипСущности Описание
Даты CalendarDate Даты, используемые для фильтрации и группировки других сущностей с помощью связей.
Проекты Проект Проекты, определенные для организации (облака) или коллекции проектов (локальная среда).
Пользователи Пользователь Сведения о пользователе, которые используются для расширения или фильтрации различных свойств рабочего элемента, например "Назначено" и "Создано".

Примечание.

В этой статье содержатся описания сущностей, свойств и перечисленных типов, поддерживаемых моделью данных Аналитики. Сведения о запросе модели данных см. в разделе "Создание запросов OData для аналитики".

Даты

Следующие свойства допустимы для типа сущности CalendarDate . Суррогатный ключ, связанный с CalendarDate , имеет значение DateSK. Можно указать свойства даты календаря для фильтрации и структуры отчетов.

Отображаемое имя Имя Тип данных Description
IsLastDayOfPeriod Перечислено Используется для фильтрации данных, чтобы определить, заканчивается ли день в различных периодах, таких как дни, недели, месяцы или годы. Допустимые значения перечислены ниже в течение периода.
Дата Date Дата/время Определенная дата календаря.
Имя дня DayName Строка Имя дня, например понедельник, вторник, среда и т. д.
Короткое имя дня DayShortName Строка Короткое имя, присвоенное дню, например Пн, Вт, Ср и т. д.
День недели DayOfWeek Int32 Число, связанное с днем в течение недели.
День месяца DayOfMonth Int32 Число, связанное с днем в течение месяца.
День года DayOfYear Int32 Число, связанное с днем года.
Дата начала недели WeekStartingDate Дата/время Дата, связанная с началом недели.
Дата окончания недели WeekEndingDate Дата/время Дата, связанная с окончанием недели.
Month Month Строка Сокращенное название месяца и года, например, январь 2022 года, февраль 2022 года, мар 2022 и т. д.
Имя месяца MonthName Строка Имя месяца, например январь, февраль, март и т. д.
Короткое имя месяца MonthShortName Строка Сокращенное название месяца, например Ян, Февраль, Мар и т. д.
Месяц года MonthOfYear Int32 Номер, назначенный месяцу. Например, 1, 2 и 3, соответствующие январю, февралю и марту.
YearMonth YearMonth Int32 Число, соответствующее объединяемому году и месяцу. Например, 202201, 202202 и 202203 соответствуют январю, февралю и марту 2022 года.
Year Year Int32 Год, например 2019, 2020, 2021 и т. д.

По умолчанию все таблицы моментальных снимков структурируются как ежедневные таблицы фактов моментального снимка. Если вы запрашиваете диапазон времени, оно будет получать значение для каждого дня. Длительные диапазоны времени приводят к большому количеству записей. Если вам не нужна такая высокая точность, можно использовать еженедельные или даже ежемесячные снапшоты.

При агрегации данных для сущности моментального снимка следует включить DateSK или DateValue столбец в groupby предложение, как описано в рекомендациях по запросам OData. Например, отчеты, указывающие фильтр дат, см. в следующих статьях:

Элементы перечислимого типа периодов

Следующие члены определены для Period перечисленного типа, который можно использовать с другими выражениями для фильтрации, чтобы удалить дни, не завершающие заданную неделю или месяц. Обратитесь к одному из этих членов, чтобы указать еженедельный или ежемесячный период для запросов тренда, охватывающих длительный период времени. Перечислимый Period тип имеет один атрибут, IsFlagsдля которого задано значение True.

Имя участника Значение Отображаемое имя
None 0 None
Day 1 день
WeekEndingOnSunday 2 Неделя заканчивается в воскресенье
WeekEndingOnMonday 4 Неделя заканчивается в понедельник
WeekEndingOnTuesday 8 Неделя заканчивается во вторник
WeekEndingOnWednesday 16 Неделя заканчивается в среду
WeekEndingOnThursday 32 Неделя заканчивается в четверг
WeekEndingOnFriday 64 Неделя заканчивается в пятницу
WeekEndingOnSaturday 128 Неделя заканчивается в субботу
Month 256 месяц
Quarter 512 Квартал
Year 1024 Год
All 2047 Все

Проекты

Следующие свойства допустимы для набора сущностей Projects и его суррогатного ключа ProjectSK. При создании запроса в области организации можно сосредоточиться на одном или нескольких проектах, указав одно или несколько имен проектов. Дополнительные сведения см. в разделе "Запросы в области проекта и организации".

Отображаемое имя Имя Тип данных Description
AnalyticsUpdatedDate Дата/время Подложка, указывающая время последнего обновления данных Аналитики.
Идентификатор проекта ProjectId GUID (Глобально уникальный идентификатор) Уникальный идентификатор, назначенный проекту при его создании.
Имя проекта ProjectName Строка Имя, назначенное проекту при его создании.
Видимость проекта ProjectVisibility Перечислено Указывает, является ли проект общедоступным или частным. Допустимые значения перечислены ниже для ProjectVisibility.

Следующие свойства навигации допустимы для типа сущности Project .

Элементы перечисленного типа ProjectVisibility

Определены следующие члены для перечисленного типа ProjectVisibility. Используйте одного из этих участников, чтобы фильтровать по определённым проектам.

Имя участника Значение Отображаемое имя
Private 0 Частный
Organization 1 Организация
Public 2 Общедоступный

Пользователи

Следующие свойства допустимы для набора сущностей Users и типа сущности User с суррогатным ключом UserSK.

Отображаемое имя Имя Тип данных Description
AnalyticsUpdatedDate Дата/время Подложка, указывающая время последнего обновления данных Аналитики.
Электронная почта пользователя UserEmail Строка Электронная почта, связанная с учетной записью пользователя.
ИД пользователя UserId GUID (Глобально уникальный идентификатор) Уникальный идентификатор, назначенный учетной записи пользователя.
Имя пользователя UserName Строка Имя, назначенное пользователю при создании идентификатора учетной записи пользователя.
Идентификатор пользователя GitHub GitHubUserId Строка Идентификатор пользователя GitHub, связанный с учетной записью пользователя.
Тип пользователя UserType Настраиваемый Тип пользователя. Допустимые значения перечислены ниже для UserType.

Члены перечисленного типа UserType

Определены следующие члены для перечисленного типа UserType.

Имя участника Значение Отображаемое имя
Unknown 0 Непризнанный
Unrecognized 1 Непризнанный
User 2 Пользователь
Organization 3 Организация
Bot 4 Бот
  • Last updated on