Referencia de metadatos de fecha, proyecto y usuario del calendario para Azure DevOps Analytics

  • Artículo

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

Los tipos de entidad y los conjuntos de entidades enumerados en la tabla siguiente se pueden usar para filtrar y compilar informes basados en datos de Analytics.

EntitySet EntityType Descripción
Fechas CalendarDate Fechas usadas para filtrar y agrupar otras entidades mediante relaciones.
Proyectos Proyecto Proyectos definidos para una organización (nube) o colección de proyectos (local).
Usuarios User Información de usuario que se usa para expandir o filtrar varias propiedades de elemento de trabajo, por ejemplo , Asignadas a, Creadas por.

Nota:

Se proporcionan descripciones de las entidades, propiedades y tipos enumerados admitidos por el modelo de datos de Analytics. Este es un borrador temprano. Proporcione comentarios sobre las áreas que le gustaría tener más información. Para consultar el modelo de datos, consulte Construcción de consultas de OData para Analytics.

Fechas

Las siguientes propiedades son válidas para el tipo de entidad CalendarDate . La clave suplente asociada a CalendarDate es DateSK. Puede especificar las propiedades de fecha del calendario para filtrar y estructurar informes.

Nombre para mostrar Nombre Tipo de datos Descripción
IsLastDayOfPeriod Enumerated Use para filtrar los datos para determinar si un día finaliza en distintos períodos, como días, semanas, meses o años. Los valores válidos se enumeran a continuación para Period.
Fecha Date DateTime Una fecha de calendario específica.
Nombre del día DayName Cadena Nombre de un día, como lunes, martes, miércoles, etc.
Nombre corto del día DayShortName Cadena Nombre corto asignado a un día, como Mon, Tue, Wed, etc.
Día de la semana DayOfWeek Int32 Número asociado al día dentro de una semana.
Día del mes DayOfMonth Int32 Número asociado al día en un mes.
Día del año DayOfYear Int32 Número asociado al día de un año.
Fecha de inicio de la semana WeekStartingDate DateTime Fecha asociada al inicio de una semana.
Fecha de finalización de la semana WeekEndingDate DateTime Fecha asociada al final de una semana.
Mes Month Cadena El nombre abreviado de un mes y año, por ejemplo, enero de 2022, febrero de 2022, mar 2022, etc.
Nombre del mes MonthName Cadena Nombre de un mes, como enero, febrero, marzo, etc.
Nombre corto del mes MonthShortName Cadena Nombre abreviado de un mes, como Jan, Feb, Mar, etc.
Mes del año MonthOfYear Int32 Número asignado a un mes. Por ejemplo, 1, 2 y 3 correspondientes a enero, febrero y marzo.
YearMonth YearMonth Int32 Número correspondiente al año concatenado y al mes. Por ejemplo, 202201, 202202 y 202203 corresponde a enero, febrero y marzo de 2022.
Year Year Int32 El año, como 2019, 2020, 2021, etc.

De forma predeterminada, todas las tablas de instantáneas se modelan como tablas de hechos de instantáneas diarias. Si consulta un intervalo de tiempo, obtendrá un valor para cada día. Los intervalos de tiempo largos dan lugar a un gran número de registros. Si no necesita una precisión tan alta, puede usar instantáneas semanales o incluso mensuales.

Al agregar datos para una entidad de instantánea, debe incluir o DateSK una DateValue columna en una groupby cláusula, tal como se describe en las directrices de consulta de OData. Para obtener informes de ejemplo que especifican un filtro de fecha, consulte los artículos siguientes:

Miembros de tipo enumerados de punto

Los miembros siguientes se definen para el Period tipo enumerado que puede usar con otras expresiones de filtro para quitar días que no terminen una semana o mes determinado. Haga referencia a uno de estos miembros para especificar un período semanal o mensual para las consultas de tendencia que abarcan un período de tiempo largo. El Period tipo enumerado tiene un único atributo, , IsFlagsque se establece Trueen .

Nombre del miembro Valor Nombre para mostrar
None 0 Ninguno
Day 1 Día
WeekEndingOnSunday 2 Fin de semana el domingo
WeekEndingOnMonday 4 Fin de semana el lunes
WeekEndingOnTuesday 8 Fin de semana el martes
WeekEndingOnWednesday 16 Fin de semana el miércoles
WeekEndingOnThursday 32 Fin de semana el jueves
WeekEndingOnFriday 64 Fin de semana el viernes
WeekEndingOnSaturday 128 Fin de semana el sábado
Month 256 Mes
Quarter 512 Quarter (Trimestre)
Year 1024 Year
All 2047 All

Proyectos

Las siguientes propiedades son válidas para el conjunto de entidades Projects y su clave ProjectSKsuplente . Al generar una consulta con ámbito de organización, puede centrarse en uno o varios proyectos especificando uno o varios nombres de proyecto. Para más información, consulte Consultas con ámbito de proyecto y organización.

Nombre para mostrar Nombre Tipo de datos Descripción
AnalyticsUpdatedDate DateTime Marca de agua que indica la última vez que se actualizaron los datos de Analytics.
Id. de proyecto ProjectId GUID Identificador único asignado a un proyecto cuando se crea.
Nombre del proyecto ProjectName Cadena Nombre asignado a un proyecto cuando se crea.
Visibilidad del proyecto ProjectVisibility Enumerated Indica si el proyecto es público o privado. Los valores válidos se enumeran a continuación para ProjectVisibility.

Las siguientes propiedades de navegación son válidas para el tipo de entidad Project .

Miembros de tipo enumerados projectVisibility

Los miembros siguientes se definen para el ProjectVisibility tipo enumerado. Haga referencia a uno de estos miembros para filtrar por proyectos específicos.

Nombre del miembro Valor Nombre para mostrar
Private 0 Privada
Organization 1 Organización
Public 2 Public

Usuarios

Las siguientes propiedades son válidas para el conjunto de entidades Users y el tipo de entidad User con clave UserSKsuplente .

Nombre para mostrar Nombre Tipo de datos Descripción
AnalyticsUpdatedDate DateTime Marca de agua que indica la última vez que se actualizaron los datos de Analytics.
Correo electrónico del usuario UserEmail Cadena Correo electrónico asociado a una identidad de cuenta de usuario.
Id. de usuario UserId GUID Identificador único asignado a una identidad de cuenta de usuario.
Nombre usuario UserName Cadena Nombre asignado a un usuario cuando se crea la identidad de la cuenta de usuario.
Identificador de usuario de GitHub GitHubUserId Cadena Identificador de usuario de GitHub asociado a la cuenta de usuario.
Tipo de usuario UserType Personalizado Tipo de usuario. Los valores válidos se enumeran a continuación para UserType.

Miembros de tipo enumerados UserType

Los miembros siguientes se definen para el UserType tipo enumerado.

Nombre del miembro Valor Nombre para mostrar
Unknown 0 Desconocida
Unrecognized 1 Desconocida
User 2 Usuario
Organization 3 Organización
Bot 4 Bot