Agregar dados de acompanhamento de trabalho usando o Analytics

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

Você pode agregar dados de acompanhamento de trabalho usando o Analytics com o OData de duas maneiras: usar $count para totais simples ou usar a extensão de agregação OData $apply para retornar resultados agrupados, filtrados e computados como JSON.

Este artigo baseia-se em Construir consultas OData para Análise e Definir consultas básicas usando o OData Analytics. Os exemplos se concentram nos dados do item de trabalho, mas os mesmos princípios se aplicam a outros conjuntos de entidades. Para consultas de contagem simples, consulte Obter uma contagem de itens.

Pré-requisitos

Sobre a extensão de agregação $apply

O OData fornece uma extensão de agregação que apresenta a palavra-chave $apply para agrupar, filtrar e calcular valores agregados em seus dados de acompanhamento de trabalho. As seções a seguir mostram como usar $apply com aggregate, groupbye filtercompute. Para obter a especificação completa, consulte a Extensão OData para Agregação de Dados.

Agregar dados usando $apply

Acrescente o $apply token à URL de consulta para disparar agregações. A sintaxe básica é:

/{entitySetName}?$apply=aggregate({columnToAggregate} with {aggregationType} as {newColumnName})

Os exemplos a seguir mostram operações comuns aggregate .

Devolva a soma de todo o trabalho restante

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $apply=aggregate(RemainingWork with sum as SumOfRemainingWork)

Retornar o último identificador de item de trabalho

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $apply=aggregate(WorkItemId with max as MaxWorkItemId)

Agrupar resultados usando groupby

A groupby cláusula funciona como SQL GROUP BY – ela divide os resultados agregados por uma ou mais propriedades.

Contar itens de trabalho por tipo

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $apply=groupby((WorkItemType), aggregate($count as Count))

Retorna um resultado como:

{
  "value": [
    { "WorkItemType": "Bug", "Count": 3 },
    { "WorkItemType": "Product Backlog Item", "Count": 13 }
  ]
}

Agrupar por várias propriedades

Adicione mais propriedades dentro dos groupby parênteses para criar divisões mais refinadas:

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $apply=groupby((WorkItemType, State), aggregate($count as Count))

Retorna uma linha para cada combinação exclusiva de tipo e estado (por exemplo, Bug/Ativo, Bug/Confirmado, Item de Pendência do Produto/Ativo).

Agrupar em várias entidades

Você pode agrupar entre entidades relacionadas usando propriedades de navegação. Por exemplo, para contar áreas por projeto:

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/Areas?
  $apply=groupby((Project/ProjectName), aggregate($count as Count))

Filtrar resultados agregados

Use filter() dentro $apply para restringir dados antes ou depois da agregação. Encadeia vários filtros usando / (pipe) e coloque o filtro mais seletivo primeiro para melhor desempenho.

https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/WorkItems?
  $apply=
    filter(Iteration/IterationName eq 'Sprint 89')/
    filter(WorkItemType eq 'User Story')/
    groupby((State), aggregate($count as Count))

Agregar vários campos em uma única chamada

Liste vários campos dentro de uma única aggregate cláusula, separados por vírgulas, para evitar viagens de ida e volta extras.

/WorkItems?$apply=aggregate(CompletedWork with sum as SumOfCompletedWork, RemainingWork with sum as SumOfRemainingWork)

Retorna:

{
  "value": [
    { "SumOfCompletedWork": 1525841.29, "SumOfRemainingWork": 73842.39 }
  ]
}

Calcule propriedades calculadas

Direcione os resultados agregados para compute() para derivar novos valores usando expressões aritméticas (div, add, sub, mul). O exemplo a seguir calcula o percentual de trabalho concluído:

/WorkItems?$apply=aggregate(CompletedWork with sum as SumOfCompletedWork, RemainingWork with sum as SumOfRemainingWork)/compute(SumOfCompletedWork div (SumOfCompletedWork add SumOfRemainingWork) as DonePercentage)

Retorna:

{
  "value": [
    { "DonePercentage": 0.9676, "SumOfCompletedWork": 1514698.34, "SumOfRemainingWork": 50715.95 }
  ]
}

Criar uma consulta de diagrama de fluxo cumulativo

A consulta a seguir combina filter, groupbye aggregate em relação à WorkItemBoardSnapshot entidade definida para produzir dados para um diagrama de fluxo cumulativo no Power BI ou excel.

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}/WorkItemBoardSnapshot?
  $apply=
    filter(DateValue gt 2015-07-16Z and DateValue le 2015-08-16Z)/
    filter(BoardName eq 'Stories' and Team/TeamName eq '{teamName}')/
    groupby((DateValue, ColumnName), aggregate(Count with sum as Count))
  &$orderby=DateValue

Essa consulta filtra por um intervalo de datas e uma equipe e um quadro específicos, agrupa por data e coluna do quadro e retorna uma contagem por grupo. Retorna:

{
  "value": [
    { "DateValue": "2015-07-16T00:00:00-07:00", "ColumnName": "Completed", "Count": 324 },
    { "DateValue": "2015-07-16T00:00:00-07:00", "ColumnName": "In Progress", "Count": 5 }
  ]
}

Próxima etapa

Conteúdo relacionado

• Definir consultas básicas usando o OData Analytics
• Construir consultas OData para Análise
• Consultar dados de tendência
• Diretrizes de consulta do OData Analytics
• Extensão OData para Agregação de Dados Versão 4.0