Agregue dados de acompanhamento de trabalho utilizando o Analytics.

Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022

Pode agregar dados de acompanhamento de trabalho usando Analytics com OData de duas formas: usar $count para totais simples, ou usar a extensão de agregação OData $apply para devolver resultados agrupados, filtrados e calculados como JSON.

Este artigo baseia-se em Construir consultas OData para Análise e Definir consultas básicas usando OData Analytics. Os exemplos focam-se em dados de itens de trabalho, mas os mesmos princípios aplicam-se a outros conjuntos de entidades. Para consultas simples de contagem, veja 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 introduz a $apply palavra-chave para agrupar, filtrar e calcular valores agregados sobre os seus dados de acompanhamento de trabalho. As secções seguintes mostram como usar $apply com aggregate, groupby, filter, e compute. Para a especificação completa, veja Extensão OData para Agregação de Dados.

Agregar dados usando $apply

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

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

Os exemplos seguintes mostram operações comuns aggregate .

Devolver 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 identificador do último item de trabalho

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

Resultados de grupo usando groupby

A groupby cláusula funciona como SQL GROUP BY — decompõe 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))

Devolve um resultado como:

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

Agrupar por múltiplas propriedades

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

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

Devolve uma linha para cada combinação única de tipo e estado (por exemplo, Bug/Ativo, Bug/Comprometido, Item da Lista de Produtos Pendentes/Ativo).

Agrupar através de entidades

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

Utilize filter() dentro de $apply para restringir os dados antes ou depois da agregação. Encadeia vários filtros usando / (pipe) e coloca primeiro o filtro mais seletivo 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 múltiplos campos numa única chamada

Liste vários campos dentro de uma única aggregate oração, separados por vírgulas, para evitar viagens de ida e volta extra.

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

Devoluções:

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

Calcular propriedades calculadas

Transfira os resultados agregados para compute() para derivar novos valores usando expressões aritméticas (div, add, sub, mul). O exemplo seguinte calcula a percentagem 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)

Devoluções:

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

Construir uma consulta de diagrama de fluxo cumulativo

A consulta seguinte combina filter, groupby, e aggregate contra o WorkItemBoardSnapshot conjunto de entidades para produzir dados para um diagrama de fluxo cumulativo em 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

Esta consulta filtra para um intervalo de datas e um quadro e equipa específicos, agrupa por data e coluna do quadro, e devolve uma contagem por grupo. Devoluções:

{
  "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óximo passo

Conteúdo relacionado

• Definir consultas básicas usando o OData Analytics
• Construa consultas OData para a Analítica
• Consultar dados de tendência
• Diretrizes de consulta do OData Analytics
• Extensão OData para a Agregação de Dados Versão 4.0