Partilhar via

Consulta por campos numéricos

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

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

Os campos numéricos comuns monitorizam o esforço para requisitos ou tarefas com trabalho estimado, restante e concluído. Use consultas para listar os itens de trabalho importantes para você e, em seguida, crie gráficos que mostrem 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 guardar uma consulta partilhada: Pelo menos acesso Basic.
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.

Usar operadores e macros

As cláusulas que fazem referência a campos numéricos suportam estes operadores:

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

Desenvolver consultas baseadas em gráficos

Dicas para criar consultas que alimentam gráficos:

  • Adicione gráficos apenas a consultas de lista plana.
  • Faça referência a filtros de consulta ou campos exibidos por meio de opções de coluna.
  • Salve sua consulta antes de adicionar ou modificar um gráfico.
  • Para agrupar cláusulas, selecione-as e use o ícone de cláusulas de grupo; Para desagrupar, selecione a cláusula agrupada.

Para obter mais informações, consulte Usar o editor de consultas para listar e gerenciar consultas, 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 retornam uma contagem de itens correspondentes quando você as executa. O exemplo a seguir mostra uma consulta de lista simples que filtra bugs em qualquer estado.

Captura de tela que mostra uma consulta por bugs em qualquer estado com o resumo da contagem de itens de trabalho.

Os gráficos também incluem uma seleção de Valores para mostrar uma contagem de itens de trabalho.

Consulta para contagem de bugs por desenvolvedor

Crie uma consulta de bugs ativos, inclua as colunas Atribuído a e Estado e, em seguida, adicione um gráfico dinâmico que mostre as atribuições e o estado.

Captura de tela que mostra a caixa de diálogo Configurar gráfico configurada para dinamizar por Atribuído a e Estado.

Consulta para contagem de bugs por estado e área

Usando a mesma consulta de lista plana, inclua Caminho da Área como uma coluna e adicione um gráfico de pivô agrupado por estado e área.

Captura de tela que mostra a caixa de diálogo Configurar gráfico configurada para pivotar por Caminho de Estado e Área.

Consulta de valores de campo indefinidos

Encontre itens de trabalho com um valor de campo indefinido (em branco) usando o operador = "igual" e deixando o Valor em branco. Por exemplo, esta cláusula localiza histórias de usuários cujo campo Pontos de História está em branco.

Screenshot que mostra um filtro onde o valor de Story Points está em branco.

Para localizar itens em que um campo 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

Atribua pontos de história a histórias de usuários ou bugs no processo Agile. Use o Effort para itens de backlog de produtos e bugs no processo Scrum. Para saber mais, consulte Basic, Agile, Scrum ou CMMI.

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

Crie uma consulta que filtre a História do Usuário e adicione Pontos da História e Estado às colunas.

Captura de ecrã que mostra a lista plana do Editor de Consultas para histórias abertas com as colunas de Pontos de História e Estado.

Em seguida, adicione um gráfico de barras empilhado que soma os Story Points.

Captura de ecrã que mostra a caixa de diálogo Configurar Gráfico para um gráfico de barras empilhadas que soma Pontos de História.

Para obter informações sobre fluxogramas cumulativos, consulte Fluxo cumulativo.

Consulta para gráfico de progresso das histórias do utilizador durante uma iteração

Crie uma consulta que filtre a História do Usuário no estado Ativo ou Fechado e inclua Pontos da História nas colunas.

Captura de tela que mostra a lista plana do Editor de consultas para histórias de usuários no estado Ativo ou Fechado.

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

Captura de ecrã que mostra a caixa de diálogo de configuração do gráfico para um gráfico de tendência que soma Pontos de História.

Consultar o trabalho restante e concluído

Dependendo do seu processo, os projetos podem incluir estes campos em 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 estimar trabalho restante para tarefas e bugs, obtenha um resumo com uma consulta que usa o operador In e inclui tanto tarefas quanto bugs para incluir os bugs rastreados como tarefas.

Captura de ecrã que apresenta uma consulta sobre tarefas e bugs para um sprint.

Adicione Trabalho Restante como uma coluna, salve e adicione um gráfico dinâmico para mostrar uma soma de Trabalho Restante por desenvolvedor.

Captura de tela que mostra a caixa de diálogo Configurar gráfico para pivotar por Atribuído a e somar Trabalho Restante.

Para gráficos de burndown do sprint definidos pelo sistema, consulte Burndown do sprint.

Campos utilizados para estimar e controlar o trabalho

Esta tabela descreve campos numéricos e baseados em atividades que você pode usar para acompanhar o trabalho. Para 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

Atividades 1, 2

A atividade necessária para concluir uma tarefa. Para planejamento de capacidade, consulte Planejamento de capacidade. Os valores permitidos incluem:

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

O campo Activity é mapeado para Activity no ficheiro ProcessConfiguration.3

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

Tarefa, Bug4 (Agile e Scrum)

Valor de Negócio

Uma medida subjetiva do valor comercial relativo de um item ou recurso da lista de pendências de um produto. Números mais altos indicam maior valor relativo.

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 gravar o trabalho em horas ou dias; nenhuma unidade de tempo inerente é imposta.

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

Tarefa, Erro4

Disciplina 1, 2

A disciplina atribuída a uma tarefa. Consulte Planejamento de capacidade. Os valores permitidos incluem:

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

O campo Disciplina é mapeado para Activity no ficheiro ProcessConfiguration.3

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

Tarefa, Bug 4 (CMMI)

Esforço

Uma medida subjetiva do tamanho de um bug ou item da lista de pendências do produto. Use o Esforço para calcular a velocidade e previsão da equipe; ele é mapeado para 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 medida subjetiva do tamanho de uma história de usuário. Os Story Points contribuem para a velocidade e previsão da equipe e mapeiam no Effort arquivo ProcessConfiguration.

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

História de Utilizador, Erro 4 (Agile)

Tamanho

Uma medida subjetiva do tamanho do requisito. O tamanho contribui para a velocidade e mapeia para o arquivo ProcessConfiguration Effort.

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

Requisito, Erro 4 (CMMI)

Estimativa original

A quantidade inicial de trabalho estimada para concluir uma tarefa. Expressas em horas ou dias; nenhuma unidade inerente é imposta.

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. Gravado em horas ou dias; não são impostas unidades inerentes. O Trabalho Restante também contribui para queimar e mapear no RemainingWork arquivo ProcessConfiguration.

Observação

Para os Quadros do Azure, o quadro de tarefas exibe "h" (horas) para Trabalho Restante. Para configurar processos XML no local, pode modificar o arquivo ProcessConfiguration para alterar o rótulo (por exemplo, "d" para dias).

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

Tarefa, Erro4

Requer revisão

Indica que a tarefa requer revisão. Valores permitidos: 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. Valores permitidos: 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. Os valores permitidos incluem:

  • 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 os valores da lista de opções: para serviços de nuvem ou um processo herdado, consulte Adicionar e gerenciar campos; para o uso do processo XML local Adicionar ou modificar um campo, personalizar uma lista de opções.
  2. A página Capacidade mostra uma união de todos os valores definidos para o campo entre projetos na coleção de projetos. Para restringir os valores vistos na página Capacidade, faça com que os valores correspondam a todas as equipes que compartilham o campo atribuído ao type="Activity".
  3. Para alterar a atribuição de campo ProcessConfiguration (somente local), consulte Process configuration XML element reference.
  4. Cada equipe configura se os bugs se comportam como requisitos ou tarefas. Como os bugs podem aparecer com qualquer um deles, os campos usados para estimar o esforço em ambos os níveis são incluídos no formulário de item de trabalho.

Próximos passos

Personalize sua experiência de acompanhamento de trabalho

Conteúdo relacionado

API REST

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

  • Last updated on