Consulta por campos numéricos

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

Saiba como consultar por campos numéricos com base no esforço, agenda, pontos de história ou campos de controle de tempo nos Painéis do Azure e no Azure DevOps.

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

Pré-requisitos

Categoria Requerimentos
Níveis de acesso - Para visualizar e executar consultas compartilhadas: Membro do Projeto.
- Para adicionar e salvar uma consulta compartilhada: Pelo menos acesso básico.
Permissões A permissão Contribute deve estar definida como Permitir para a pasta à qual se pretende adicionar uma consulta. Por padrão, o grupo Colaboradores não tem essa permissão.

Observação

Os utilizadores com acesso Stakeholder para um projeto público têm acesso total às funcionalidades de consulta, assim como os utilizadores com acesso Basic. Para obter mais informações, consulte a referência rápida de acesso para partes interessadas .

Categoria Requerimentos
Níveis de acesso - Para visualizar e executar consultas compartilhadas: Membro do Projeto.
- Para adicionar e salvar uma consulta compartilhada: Pelo menos Basic acesso.
Permissões permissão Contribute definida como Permitir para a pasta à qual você deseja adicionar uma consulta. Por padrão, o grupo Colaboradores não tem essa permissão.

Usar operadores e macros

As cláusulas de consulta suportadas que especificam um campo numérico podem usar os operadores a seguir.

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

Desenvolver consultas baseadas em gráficos

As dicas a seguir podem ajudá-lo a desenvolver suas dúvidas:

  • Adicione gráficos apenas para consultas de lista plana.
  • Faça referência a filtros de consulta ou campos exibidos por meio de opções de coluna.
  • Salve as alterações feitas na consulta antes de adicionar ou modificar um gráfico.
  • Agrupe uma ou mais cláusulas selecionando-as e, em seguida, o ícone Cláusula de Consulta de Grupo ícone de cláusulas de grupo. Para desagrupar, selecione na cláusula agrupada.

Para obter mais informações, consulte Usar o editor de consultas para listar e gerenciar consultas e Gráficos e Adicionar ou modificar um campo.

Utilizar filtros

A tabela a seguir mostra filtros úteis para consultas.

Filtro para

Inclua estas cláusulas de consulta

Histórias de usuários ou bugs

Work Item Type In User Story,Bug

Tarefas ou erros

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ários não estimadas

Story Points <> (leave Value field blank)


Consulta para contagem de itens de trabalho

Todas as consultas mostram uma contagem de itens quando você executa a consulta. Aqui definimos uma consulta de lista plana que filtra bugs em todos os estados.

Captura de ecrã de consulta de bugs em qualquer estado, resumo da contagem de itens de trabalho.

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.

Consulta para contagem de bugs por desenvolvedor

Para mostrar "Atribuído a" e "Estado", crie uma consulta de erros ativa e altere as opções de coluna. Em seguida, adicione um gráfico dinâmico que apresente as tarefas e o estado.

Captura de tela da caixa de diálogo Configurar gráfico, gire por atribuído a e estado.

Consulta para 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 exiba o caminho do estado e da área.

Captura de tela mostrando a caixa de diálogo Configurar gráfico, pivotar por estado e área.

Consulta de valores de campo indefinidos

Você pode encontrar itens de trabalho que têm um valor de campo indefinido usando o operador igual a, =, e deixar o valor do campo em branco. Por exemplo, os filtros a seguir listam todos os itens de trabalho do tipo User Stories cujo campo Story Points está em branco.

Captura de tela mostrando Filtro 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.

Consulta de esforço ou pontos de história

Você pode atribuir Pontos de História a histórias de usuários ou bugs quando trabalha em um processo Agile. Ou, Esforço para itens de backlog de produtos e bugs quando você trabalha em um processo Scrum. Para obter mais informações, consulte Basic, Agile, Scrumou CMMI tipos de item de trabalho e artigos de fluxo de trabalho.

Consulta de soma de pontos de história e seu status

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

Captura de tela mostrando o editor de consultas, lista plana, histórias abertas.

Em seguida, adicione um gráfico de barras empilhadas que totaliza os Story Points.

Captura de tela mostrando a caixa de diálogo Configurar gráfico, barra empilhada, soma dos pontos da história.

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

Consulta para gravar gráfico de histórias de usuário para uma iteração

Crie uma consulta que filtre o User Story como tipo de item de trabalho e no estado Ativo ou Fechado. Para mostrar Pontos da História, modifique as opções de coluna.

Captura de tela mostrando Editor de consultas, lista plana, histórias de usuários - ativas ou fechadas.

Em seguida, adicione um gráfico de tendência de área empilhada que soma os Story Points.

Captura de tela mostrando a caixa de diálogo Configurar gráfico, tendência, soma dos pontos da história.

Consulta de trabalho restante e concluído

Com base no processo que seu projeto referencia, você pode atribuir os seguintes campos a tarefas ou bugs.

Processo Campos disponíveis
Ágil 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 seguir as práticas do Scrum e estimar o Trabalho Restante para as suas tarefas e bugs, pode obter um resumo do trabalho restante com a consulta e o gráfico a seguir. Use o operador In e inclua Tarefa e Erro para incluir quaisquer erros que sejam rastreados como tarefas.

Captura de tela mostrando consulta de tarefas e bugs para *sprint*.

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

Captura de ecrã mostrando a janela de configuração do gráfico, pivô, soma do trabalho restante por desenvolvedor.

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

Campos utilizados para estimar e controlar o trabalho

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

Nome do campo

Descrição

Tipo de item de trabalho


Atividades 1, 2

O tipo de atividade necessária para concluir uma tarefa. Para obter mais informações sobre como esse campo é usado, consulte Capacity planning. Os valores permitidos são:

  • Implantação
  • Desenho
  • Desenvolvimento
  • Documentação
  • Requerimentos
  • Testes

O campo Activity é atribuído a Activity no arquivo ProcessConfiguration.3

Nome de referência=Microsoft.VSTS.Common.Activity, Tipo de dados=String

Tarefa, Bug4 (Agile e Scrum)

Valor de Negócio

Uma unidade de medida subjetiva que captura o valor comercial relativo de um item ou recurso da lista de pendências de um produto em comparação com outros itens do mesmo tipo. Um item ao qual é atribuído um número mais elevado deve ser considerado como tendo mais valor comercial do que um item ao qual é atribuído um número inferior.

Nome de referência=Microsoft.VSTS.Common.BusinessValue, Tipo de dados=Inteiro

Épico, Funcionalidade

Obra Concluída

A quantidade de trabalho gasto na execução de uma tarefa. Você pode especificar o trabalho em horas ou em dias. Não existem unidades de tempo inerentes associadas a este campo.

Nome de referência=Microsoft.VSTS.Scheduling.CompletedWork, Tipo de dados=Duplo

Tarefa, Erro4

Disciplina 1, 2

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

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

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

Nome de referência=Microsoft.VSTS.Common.Discipline, Tipo de dados=String

Tarefa, Bug 4 (CMMI)

Esforço

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

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

Nome de referência=Microsoft.VSTS.Scheduling.Effort, Tipo de dados=Duplo

O Item do Product Backlog, Bug 4 (Scrum)

Funcionalidade, Épico

Pontos da história

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

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

Nome de referência = Microsoft.VSTS. Scheduling.StoryPoints, Tipo de dados = Duplo

História de Utilizador, Erro 4 (Agile)

Tamanho

Uma unidade de medida subjetiva que captura o tamanho de um requisito. Quanto maior o tamanho, mais trabalho é necessário para implementá-lo.

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

Nome de referência = Microsoft.VSTS. Agendamento. Tamanho, Tipo de dados = Duplo

Requisito, Bug 4 (CMMI)

Estimativa original

A quantidade de trabalho necessária para concluir uma tarefa. Você pode especificar o trabalho em horas ou em dias. Não existem unidades de tempo inerentes associadas a este campo.

Nome de referência=Microsoft.VSTS.Scheduling.OriginalEstimate, Tipo de dados=Duplo

Tarefa, Bug 4 (Agile e CMMI)

Trabalho Restante

A quantidade de trabalho que resta para concluir uma tarefa. Você pode especificar o trabalho em horas ou em dias. Não existem unidades de tempo inerentes associadas a este campo. Este campo 3 também é usado para calcular a queima. Ele é atribuído a type="RemainingWork" no arquivo ProcessConfiguration.

Observação

Para os Quadros do Azure, o painel de tarefas sempre mostra "h" para horas relativamente ao Trabalho Restante. Para o TFS, você pode modificar o arquivo ProcessConfiguration para o campo Tipo de trabalho restante para especificar "d" para dias ou outro rótulo preferencial.

Nome de referência=Microsoft.VSTS.Scheduling.RemainingWork, Tipo de dados=Duplo

Tarefa, Erro4

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, Tipo de dados=String

Tarefa (CMMI)

Requer testes

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

Nome de referência=Microsoft.VSTS.CMMI.RequiresTest, Tipo de dados=String

Tarefa (CMMI)

Tipo de Tarefa1

Especifica o tipo de tarefa a ser implementada. Os valores permitidos são:

  • Ação corretiva
  • Ação de mitigação
  • Prevista

Nome de referência=Microsoft.VSTS.CMMI.TaskType, Tipo de dados=String

Tarefa, Bug4 (processo CMMI)

Observação

  1. Para alterar a seleção do 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 opções.
  2. Os valores exibidos na página Capacidade para a Atividade (Agile ou Scrum) ou para a Disciplina (CMMI) refletem uma união de todos os valores definidos para o campo em todos os projetos dentro da instância da coleção de projetos. Portanto, para restringir os valores que aparecem para Capacidade nas páginas do backlog do sprint, deve fazer com que os valores sejam iguais em todos os projetos para o campo atribuído a type="Activity".
  3. Para alterar a atribuição de campo ProcessConfiguration (somente local), consulte Process configuration XML element reference.
  4. Cada equipe pode configurar suas ferramentas Agile para determinar se os bugs são tratados de forma semelhante aos requisitos ou tarefas. Como os bugs podem aparecer em requisitos ou em tarefas, os campos para estimativa de esforço no nível de requisito e no nível de tarefa estão incluídos no formulário de itens de trabalho.

Próximos passos

REST API

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