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

  • Статья

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

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

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

Примечание.

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

Даты

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

Отображаемое имя Имя Тип данных Description
IsLastDayOfPeriod Enumerated Используется для фильтрации данных, чтобы определить, заканчивается ли день в различных периодах, таких как дни, недели, месяцы или годы. Допустимые значения перечислены ниже в течение периода.
Дата Date Дата/время Определенная дата календаря.
Имя дня DayName Строка Имя дня, например понедельник, вторник, среда и т. д.
Короткое имя дня DayShortName Строка Короткое имя, назначенное деньу, например Mon, Tue, Wed и т. д.
День недели 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 и т. д.

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

При агрегации данных для сущности моментального снимка следует включить DateSKDateValue столбец в 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 Year
All 2047 Все

Проекты

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

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

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

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

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

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

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

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

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

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

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

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