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

  • Artigo

Serviços de DevOps do Azure | 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 Google Analytics.

Conjunto de Entidades Tipo de entidade Description
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).
Utilizadores Utilizador Informações do usuário que são usadas para expandir ou filtrar várias propriedades de item de trabalho, por exemplo , Atribuído a, Criado por.

Nota

São fornecidas descrições das entidades, propriedades e tipos enumerados suportados pelo modelo de dados do Google Analytics. Este é um rascunho inicial. Por favor, 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 Analytics.

Dates

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 a apresentar Nome Tipo de dados 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.
Date Date DateTime Uma data de calendário específica.
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 curto 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 fim de semana WeekEndingDate DateTime A data associada ao final de uma semana.
Month 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 curto do mês MonthShortName String O nome abreviado de um mês, como jan, fev, Mar 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 corresponde 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. Longos intervalos de tempo resultam em um grande número de registros. Se você não precisa de uma precisão tão alta, pode usar instantâneos semanais ou até mensais.

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

Membros do tipo enumerados do 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, , IsFlagsque é definido como True.

Nome do membro valor Display name
None 0 None
Day 5 Day
WeekEndingOnSunday 2 Fim de semana no domingo
WeekEndingOnMonday 4 Fim de semana na segunda-feira
WeekEndingOnTuesday 8 Semana que termina na terça-feira
WeekEndingOnWednesday 16 Fim de semana na quarta-feira
WeekEndingOnThursday 32 Fim de semana na quinta-feira
WeekEndingOnFriday 64 Fim de semana na sexta-feira
WeekEndingOnSaturday 128 Fim de semana no sábado
Month 256 Month
Quarter 512 Trimestre
Year 1024 Year
All 2047 Todas as

Projetos

As propriedades a seguir são válidas para o conjunto de entidades Projects e sua chave ProjectSKsubstituta. Ao gerar uma consulta com escopo da organização, você pode se concentrar em um ou mais projetos especificando um ou mais Nomes de Projeto. Para saber mais, consulte Consultas de escopo do projeto e da organização.

Nome a apresentar Nome Tipo de dados Descrição
AnalyticsUpdatedDate DateTime Marca d'água que indica a última vez que os dados do Google 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 projetos específicos.

Nome do membro valor Display name
Private 0 Privado
Organization 5 Organization
Public 2 Pública

Utilizadores

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

Nome a apresentar Nome Tipo de dados Descrição
AnalyticsUpdatedDate DateTime Marca d'água que indica a última vez que os dados do Google Analytics foram atualizados.
E-mail do usuário UserEmail String E-mail associado a uma identidade de conta de utilizador.
ID do Utilizador UserId GUID Identificador exclusivo atribuído a uma identidade de conta de usuário.
Nome de Utilizador 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 associado à conta de usuário.
Tipo de Utilizador UserType Personalizar O tipo de usuário. Os valores válidos estão listados abaixo para UserType.

Membros de tipo enumerados UserType

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

Nome do membro valor Display name
Unknown 0 Não reconhecido
Unrecognized 5 Não reconhecido
User 2 Utilizador
Organization 3 Organization
Bot 4 Bot