Consultar por campos numéricos no Azure Boards e no Azure DevOps

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Como fazer determinar quanto trabalho cada desenvolvedor concluiu na minha equipe? Há uma maneira de resumir o esforço ou os pontos da história para uma iteração?

Os campos numéricos mais comuns acompanham o esforço para itens na categoria Requisitos ou o trabalho estimado, restante e concluído para itens na categoria Tarefa. Com as consultas, você pode listar os itens de trabalho de interesse e definir um gráfico que mostra uma contagem de itens de trabalho ou uma soma de um campo numérico.

Operadores e macros com suporte

Cláusulas de consulta que especificam um campo numérico podem usar os operadores listados abaixo.

  • = , <> , > , < , >= , <=
  • =[Campo], <>[Campo], >[Campo], <[Campo], >=[Campo], =[Campo], <=[Campo]
  • In, Not In
  • Was Ever

Dicas para desenvolver consultas baseadas em gráfico

  • Você só pode adicionar gráficos para consultas de lista simples
  • As opções de gráfico fazem referência a filtros de consulta ou campos exibidos por meio de opções de coluna
  • Salve as alterações feitas em sua consulta antes de adicionar ou modificar um gráfico.
  • Para agrupar uma ou mais cláusulas, selecione-as e, em seguida, escolha o ícone cláusulas de grupo de ícones da Cláusula de Consulta de Grupo . Para desagrupar, selecione na cláusula agrupada.

Para obter mais detalhes sobre como criar consultas e consultas baseadas em gráfico, consulte Usar o editor de consultas para listar e gerenciar consultas e gráficos. Se você quiser adicionar um campo personalizado para rastrear e gerar somas de outros valores numéricos, consulte Adicionar ou modificar um campo.

Filtros úteis

Filtrar para

Incluir essas cláusulas de consulta

Histórias ou bugs do usuário

Work Item Type In User Story,Bug

Tarefas ou bugs

Work Item Type In Task,Bug

Itens ativos ou fechados

State In Active,Closed

Itens na categoria Requisitos

Work Item Type In Group Microsoft.RequirementCategory

Histórias de usuário não estimadas

Story Points <> (leave Value field blank)

Gráficos e consultas de contagem de itens de trabalho

Todas as consultas mostram uma contagem de itens quando você executa a consulta. Aqui, definimos uma consulta de lista simples que filtra bugs em qualquer estado.

A consulta bugs qualquer estado, contagem de itens de trabalho resumo

Além disso, todos os gráficos contêm uma seleção de valores projetada para exibir uma contagem de itens de trabalho dentro do gráfico.

Contagem de bugs por desenvolvedor

Crie uma consulta de bugs ativa e modifique as opções de coluna para mostrar Estado e Atribuição. Em seguida, adicione um gráfico dinâmico que exibe as atribuições e o estado.

Configurar a caixa de diálogo do gráfico, dinâmica por atribuído e estado

Configurar gráfico, contagem de bugs por desenvolvedor, área, gráfico dinâmico

Contagem de bugs por estado e área

Usando a mesma consulta de lista simples que filtra bugs mostrados na seção anterior, você pode mostrar uma contagem com base na área. Modifique as opções de coluna para mostrar o Caminho da Área. Em seguida, adicione um gráfico dinâmico que exibe o estado e o caminho da área.

Configurar a caixa de diálogo do gráfico, dinâmica por estado e área

Configurar gráfico, contagem de bugs por área, estado, gráfico dinâmico

Consultas de valor de campo indefinidas

Você pode encontrar itens de trabalho que têm um valor de campo indefinido usando o operador igual (=) e deixando o valor do campo em branco. Por exemplo, os filtros a seguir listarão todos os itens de trabalho do tipo Histórias de Usuário cujo campo Pontos de História está em branco.

Filtrar com base em entradas em branco

Para listar itens de trabalho com base em um campo que não está em branco, use o operador não (<>) e deixe o Valor em branco.

Gráficos e consultas de ponto de história ou esforço

Você pode atribuir Pontos de História a histórias de usuários ou bugs ao trabalhar em um processo Agile. Ou, esforço para fazer backup de itens e bugs do produto quando você trabalha em um processo de Scrum. Para obter mais informações, consulte os tipos de item de trabalho Básico, Agile, Scrum ou CMMI e artigos de fluxo de trabalho.

Soma de pontos de história e seu status

Crie uma consulta que filtra a História do Usuário como o tipo de item de trabalho e modifique as opções de coluna para mostrar Pontos de História e Estado.

Editor de consultas, lista simples, abrir histórias

Em seguida, adicione um gráfico de barras empilhadas que soma os Pontos de História.

Configurar caixa de diálogo de gráfico, barra empilhada, soma de pontos de história

Configurar gráfico, soma de pontos de história por iteração, gráfico de barras empilhadas.

Para obter informações sobre diagramas de fluxo cumulativo definidos pelo sistema, consulte Fluxo cumulativo.

Burn up chart of user stories for an iteração

Crie uma consulta que filtra o User Story como o tipo de item de trabalho e no estado Ativo ou Fechado. Modifique as opções de coluna para mostrar Pontos de História.

Editor de consultas, lista simples, histórias de usuário – ativas ou fechadas

Em seguida, adicione um gráfico de tendências de área empilhada que soma os Pontos de História.

Configurar caixa de diálogo de gráfico, tendência, soma de pontos de história

Configurar gráfico, soma de pontos de história por iteração, gráfico de barras empilhadas

Consultas e gráficos de trabalho restantes e concluídos

Com base no processo de referências do projeto, você pode atribuir os campos a tarefas ou bugs a seguir.

Processo Campos disponíveis
Agile Estimativa Original, Trabalho Restante, Trabalho Concluído
Scrum Trabalho restante
CMMI Estimativa Original, Trabalho Restante, Trabalho Concluído

Soma do trabalho restante por desenvolvedor

Se você seguir as práticas do Scrum e estimar o Trabalho Restante para suas tarefas e bugs, poderá obter um pacote cumulativo da quantidade de trabalho restante para cada desenvolvedor com a consulta e o gráfico a seguir. Usando o operador In e incluindo Tarefas e Bugs, você inclui todos os bugs que estão sendo rastreados como tarefas.

Consulta de tarefas e bugs para sprint

Adicione o Trabalho Restante como uma opção de coluna à consulta e salve. Para exibir uma soma do trabalho restante, adicione um gráfico dinâmico, conforme mostrado.

Configurar caixa de diálogo de gráfico, dinâmica, soma do trabalho restante por desenvolvedor

Configurar gráfico, soma do trabalho restante por desenvolvedor, área, gráfico dinâmico

Para obter informações sobre gráficos de burndown de sprint definidos pelo sistema, consulte o burndown do Sprint.

Campos usados para estimar e acompanhar o trabalho

A tabela a seguir descreve os campos numéricos e baseados em atividade que você pode usar para acompanhar o trabalho. Para obter informações sobre campos relacionados à data, como Data de Início, Data de Término e Data de Destino, consulte Consulta por data ou iteração atual.

Nome do campo

Descrição

Tipo de item de trabalho


Atividade 1, 2

O tipo de atividade que é necessário para concluir uma tarefa. Para saber mais sobre como esse campo é usado, consulte o planejamento de capacidade. Valores permitidos são:

  • Implantação
  • Design
  • Desenvolvimento
  • Documentação
  • Requisitos
  • Testando

O campo Atividade é atribuído Activity ao arquivo ProcessConfiguration. 3

Nome de referência=Microsoft.VSTS.Common.Activity, Data type=String

Tarefa, Bug4 (Agile e Scrum)

Valor Comercial

Uma unidade de medida subjetiva que registra o valor comercial relativo de um item da lista de pendências de produtos ou recurso em relação a outros itens do mesmo tipo. Um item com um número mais alto deve ser considerado como tendo mais valor comercial do que um item com um número mais baixo.

Reference name=Microsoft.VSTS.Common.BusinessValue, Data type=Integer

Epic, Feature

Trabalho concluído

A quantidade de trabalho gasto na implementação de uma tarefa. É possível especificar o trabalho em horas ou dias. Não há unidades de tempo inerentes associadas a esse campo.

Nome de referência=Microsoft.VSTS.Scheduling.CompletedWork, Data type=Double

Tarefa, Bug4

Disciplina 1, 2

O tipo de atividade ou disciplina que é atribuída a uma tarefa. Para saber mais sobre como esse campo é usado, consulte Planejamento de capacidade. Valores permitidos são:

  • Análise
  • Desenvolvimento
  • Teste
  • Educação do Usuário
  • Experiência de usuário

O campo Disciplina é atribuído Activity ao arquivo ProcessConfiguration. 3

Nome de referência=Microsoft.VSTS.Common.Discipline, Data type=String

Tarefa, Bug 4 (CMMI)

Esforço

Uma unidade de medida subjetiva que captura o tamanho de um bug ou de um item da lista de pendências do produto. Se atribuir mais esforço a um item, você esta indicando que é necessário mais trabalho para implantá-lo.

Esse campo 3 também é usado para calcular a velocidade e a previsão da equipe. Ele é atribuído Effort no arquivo ProcessConfiguration.

Reference name=Microsoft.VSTS.Scheduling.Effort, Data type=Double

Item de Lista de Pendências do Produto, Bug 4 (Scrum)

Recurso, Epic

Pontos da história

Uma unidade de medida subjetiva que captura o tamanho de uma história do usuário. Se atribuir mais pontos a uma história do usuário, você esta indicando que é necessário mais trabalho para implantá-la.

Esse campo 3 também é usado para calcular a velocidade e a previsão da equipe. Ele é atribuído Effort no arquivo ProcessConfiguration.

Nome de referência=Microsoft.VSTS. Scheduling.StoryPoints, Data type=Double

História do Usuário, Bug 4 (Agile)

Tamanho

Uma unidade de medida subjetiva que captura o tamanho de uma requisição. Quanto maior o tamanho, mais trabalho será necessário para implantá-la.

Esse campo3 também é usado para calcular a velocidade e a previsão da equipe. Ele é atribuído Effort no arquivo ProcessConfiguration.

Nome de referência=Microsoft.VSTS. Scheduling.Size, Data type=Double

Requisito, Bug 4 (CMMI)

Estimativa Original

A quantidade necessária de trabalho para concluir uma tarefa. É possível especificar o trabalho em horas ou dias. Não há unidades de tempo inerentes associadas a esse campo.

Nome de referência=Microsoft.VSTS.Scheduling.OriginalEstimate, Data type=Double

Tarefa, Bug 4 (Agile e CMMI)

Trabalho restante

A quantidade de trabalho restante para concluir uma tarefa. É possível especificar o trabalho em horas ou dias. Não há unidades de tempo inerentes associadas a esse campo. Esse campo 3 também é usado para calcular burn down. Ele é atribuído type="RemainingWork" no arquivo ProcessConfiguration.

Observação

Para Azure Boards, o quadro de tarefas sempre mostra "h" por horas em relação ao Trabalho Restante. Para O TFS, você pode modificar o arquivo ProcessConfiguration para o campo Tipo de Trabalho Restante para especificar "d" por dias ou outro rótulo preferencial.

Nome de referência=Microsoft.VSTS.Scheduling.RemainingWork, Data type=Double

Tarefa, Bug4

Requer Revisão

Indica que a tarefa requer revisão. Você pode especificar Sim ou Não (padrão).

Nome de referência=Microsoft.VSTS.CMMI.RequiresReview, Data type=String

Tarefa (CMMI)

Requer teste

Indica que a tarefa requer um teste. Você pode especificar Sim ou Não (padrão).

Nome de referência=Microsoft.VSTS.CMMI.RequiresTest, Data type=String

Tarefa (CMMI)

Tipode Tarefa 1

Especifica o tipo de tarefa a ser implantada. Valores permitidos são:

  • Ação corretiva
  • Ação de Mitigação
  • Planejado

Nome de referência=Microsoft.VSTS.CMMI.TaskType, Data type=String

Tarefa, Bug4 (processo CMMI)

Observação

  1. Para alterar a seleção de menu: para serviços de nuvem ou um processo herdado, consulte Adicionar e gerenciar campos; e para o processo XML local, consulte Adicionar ou modificar um campo, personalizar uma lista de seleção.
  2. Os valores exibidos na página Capacidade para Atividade (Agile ou Scrum) ou Disciplina (CMMI) refletem uma união de todos os valores definidos para o campo em todos os projetos dentro da instância de coleção de projetos. Portanto, para restringir os valores exibidos para Capacidade nas páginas de backlog de sprint, você deve fazer com que os valores correspondam em todos os projetos para o campo atribuído a type="Activity".
  3. Para alterar a atribuição do campo ProcessConfiguration (somente local), consulte a referência do elemento XML de configuração de processo.
  4. Cada equipe pode configurar suas ferramentas Agile para determinar se os bugs são tratados de forma semelhante a requisitos ou tarefas. Como os bugs podem aparecer com requisitos ou tarefas, os campos usados para estimar o esforço no nível de requisito e no nível da tarefa são incluídos no formulário do item de trabalho.

Para obter informações sobre como adicionar campos personalizados, consulte Personalizar sua experiência de acompanhamento de trabalho.

As principais ferramentas que você usa para planejar e acompanhar o trabalho são descritas aqui:

Para obter mais informações sobre como usar itens de trabalho e consultas, consulte:

Rollup de valores numéricos entre tipos de item de trabalho

O acúmulo fornece valores somados de campos selecionados para todos os itens de trabalho filho de um pai. Nativamente, Azure Boards e TFS fornecem um pacote cumulativo de Trabalho Restante para tarefas no quadro de tarefas. Para outros requisitos de rollup, consulte os seguintes artigos:

Quais itens aparecem nas categorias Requisito ou Tarefa?

As atribuições padrão de tipos de item de trabalho para cada categoria são listadas abaixo para cada processo.

Processo Categoria de requisito Categoria da tarefa
Agile História do usuário Tarefa
Scrum Item da lista de pendências do produto Tarefa
CMMI Requisito Tarefa

No entanto, cada equipe pode determinar se o tipo de item de trabalho bug aparece na categoria Requisito ou Tarefa. Veja Mostrar bugs em backlogs e quadros.

Você pode adicionar tipos de item de trabalho personalizados a uma lista de pendências. Para obter detalhes, consulte Adicionar ou modificar um tipo de item de trabalho, Adicionar uma WIT personalizada a um backlog ou quadro.

API REST

Para interagir programaticamente com consultas, consulte um destes recursos da API REST: