Compartilhar via


Data do calendário, projeto e referência de metadados do usuário para Azure DevOps Analytics

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

Os tipos de entidade e os conjuntos de entidades listados na tabela a seguir podem ser usados para filtrar e criar relatórios com base nos dados do Analytics.

EntitySet EntityType Descrição
Datas CalendarDate As datas usadas para filtrar e agrupar outras entidades usando relações.
Projetos Projeto Projetos definidos para uma organização (nuvem) ou coleção de projetos (local).
Usuários Usuário Informações do usuário usadas para expandir ou filtrar várias propriedades de item de trabalho, por exemplo , Atribuído a, Criado por.

Observação

Descrições das entidades, propriedades e tipos enumerados compatíveis com o modelo de dados do Analytics são fornecidas. Este é um rascunho antecipado. Forneça comentários sobre as áreas que você gostaria de ter mais informações. Para consultar o modelo de dados, consulte Construir consultas OData para Análise.

Datas

As propriedades a seguir são válidas para o tipo de entidade CalendarDate . A chave substituta associada a CalendarDate é DateSK. Você pode especificar propriedades de data do calendário para filtrar e estruturar relatórios.

Nome de exibição Nome Data type Descrição
IsLastDayOfPeriod Enumerated Use para filtrar dados para determinar se um dia termina em períodos diferentes, como dias, semanas, meses ou anos. Os valores válidos estão listados abaixo para Período.
Data Date Datetime Uma data específica do calendário.
Nome do dia DayName String O nome de um dia, como segunda-feira, terça-feira, quarta-feira e assim por diante.
Nome abreviado do dia DayShortName String O nome abreviado atribuído a um dia, como Seg, Ter, Qua e assim por diante.
Dia da semana DayOfWeek Int32 O número associado ao dia dentro de uma semana.
Dia do mês DayOfMonth Int32 O número associado ao dia dentro de um mês.
Dia do ano DayOfYear Int32 O número associado ao dia de um ano.
Data de início da semana WeekStartingDate Datetime A data associada ao início de uma semana.
Data de término da semana WeekEndingDate Datetime A data associada ao final de uma semana.
Mês Month String O nome abreviado de um mês e ano, por exemplo, janeiro de 2022, fevereiro de 2022, março de 2022 e assim por diante.
Nome do mês MonthName String O nome de um mês, como janeiro, fevereiro, março e assim por diante.
Nome abreviado do mês MonthShortName String O nome abreviado de um mês, como janeiro, fevereiro, março e assim por diante.
Mês do ano MonthOfYear Int32 O número atribuído a um mês. Por exemplo, 1, 2 e 3 correspondentes a janeiro, fevereiro e março.
AnoMês YearMonth Int32 Um número correspondente ao ano e mês concatenados. Por exemplo, 202201, 202202 e 202203 correspondem a janeiro, fevereiro e março de 2022.
Year Year Int32 O ano, como 2019, 2020, 2021 e assim por diante.

Por padrão, todas as tabelas de instantâneo são modeladas como tabelas de fatos de instantâneo diário. Se você consultar um intervalo de tempo, ele obterá um valor para cada dia. Intervalos de tempo longos resultam em um grande número de registros. Se você não precisar de uma precisão tão alta, poderá usar instantâneos semanais ou até mesmo mensais.

Ao agregar dados para uma entidade de instantâneo, você deve incluir a DateSK coluna ou em DateValue uma groupby cláusula, conforme descrito nas diretrizes de consulta OData. Para obter exemplos de relatórios que especificam um filtro de data, consulte os seguintes artigos:

Membros do tipo enumerado de período

Os membros a seguir são definidos para o tipo enumerado Period que você pode usar com outras expressões de filtro para remover dias que não terminam uma determinada semana ou mês. Faça referência a um desses membros para especificar um período semanal ou mensal para consultas de tendência que abrangem um longo período de tempo. O Period tipo enumerado tem um único atributo, IsFlags, que é definido como True.

Nome do membro Valor Nome de exibição
None 0 Nenhum
Day 1 Dia
WeekEndingOnSunday 2 Semana que termina no domingo
WeekEndingOnMonday 4 Semana que termina na segunda-feira
WeekEndingOnTuesday 8 Semana que termina na terça-feira
WeekEndingOnWednesday 16 Semana que termina na quarta-feira
WeekEndingOnThursday 32 Semana que termina na quinta-feira
WeekEndingOnFriday 64 Semana que termina na sexta-feira
WeekEndingOnSaturday 128 Semana que termina no sábado
Month 256 Mês
Quarter 512 Trimestre
Year 1024 Year
All 2047 Tudo

Projetos

As propriedades a seguir são válidas para o conjunto de entidades Projetos e sua chave ProjectSKsubstituta. Ao gerar uma consulta no escopo da organização, você pode se concentrar em um ou mais projetos especificando um ou mais nomes de projeto. Para obter mais informações, consulte Consultas no escopo do projeto e da organização.

Nome de exibição Nome Data type Descrição
AnalyticsUpdatedDate DateTime Marca d'água que indica a última vez em que os dados do Analytics foram atualizados.
ID do projeto ProjectId GUID Identificador exclusivo atribuído a um projeto quando ele é criado.
Nome do Projeto ProjectName String Nome atribuído a um projeto quando ele é criado.
Visibilidade do projeto ProjectVisibility Enumerated Indica se o projeto é público ou privado. Os valores válidos estão listados abaixo para ProjectVisibility.

As propriedades de navegação a seguir são válidas para o tipo de entidade Project .

Membros do tipo enumerado ProjectVisibility

Os membros a seguir são definidos para o ProjectVisibility tipo enumerado. Faça referência a um desses membros para filtrar em projetos específicos.

Nome do membro Valor Nome de exibição
Private 0 Privados
Organization 1 Organização
Public 2 Setor Público

Usuários

As propriedades a seguir são válidas para o conjunto de entidades Usuários e o Tipo de entidade Usuário com chave UserSKsubstituta.

Nome de exibição Nome Data type Descrição
AnalyticsUpdatedDate DateTime Marca d'água que indica a última vez em que os dados do Analytics foram atualizados.
Email do usuário UserEmail String Email associado a uma identidade de conta de usuário.
ID de usuário UserId GUID Identificador exclusivo atribuído a uma identidade de conta de usuário.
Nome de usuário UserName String Nome atribuído a um usuário quando a identidade da conta de usuário é criada.
ID de usuário do GitHub GitHubUserId String ID de usuário do GitHub associada à conta de usuário.
Tipo de Usuário UserType Personalizado O tipo de usuário. Os valores válidos estão listados abaixo para UserType.

Membros de tipo enumerado UserType

Os membros a seguir são definidos para o UserType tipo enumerado.

Nome do membro Valor Nome de exibição
Unknown 0 Não reconhecido
Unrecognized 1 Não reconhecido
User 2 Usuário
Organization 3 Organização
Bot 4 Bot