Compartilhar via

Consulta por campos numéricos

  • Artigo

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Saiba como consultar por campos numéricos com base em esforço, agendamento, pontos de história ou campos de acompanhamento de tempo no Azure Boards e no Azure DevOps.

Os campos numéricos mais comuns acompanham o esforço para itens na categoria Requisitos ou trabalho estimado, restante e concluído para itens na categoria Tarefa. Com 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.

Pré-requisitos

  • Níveis de acesso:
    • Para exibir e executar consultas compartilhadas: membro do Project.
    • Para adicionar e salvar uma consulta compartilhada: pelo menos acesso Básico.
  • Permissões: permissão para Contribuir definida como Permitir para a pasta à qual você deseja adicionar uma consulta. Por padrão, o grupo Colaboradores não tem essa permissão.

Nota

Usuários com acesso Stakeholder para um projeto público têm acesso total aos recursos de consulta, assim como usuários com acesso Básico. Para mais informações, veja Referência rápida de acesso das partes interessadas.

  • Níveis de acesso:
    • Para exibir e executar consultas compartilhadas: membro do Project.
    • Para adicionar e salvar uma consulta compartilhada: pelo menos acesso Básico.
  • Permissões: permissão para Contribuir definida como Permitir para a pasta à qual você deseja adicionar a consulta. Por padrão, o grupo Colaboradores não tem essa permissão.

Usar operadores e macros

Cláusulas de consulta com suporte 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áfico

As dicas a seguir podem ajudá-lo a desenvolver suas consultas:

  • Adicione gráficos somente para consultas de lista simples.
  • Referencie filtros de consulta ou campos exibidos nas 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 clicando no ícone ícone Agrupar Cláusula de Consulta agrupar cláusulas. 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.

Usar filtros

A tabela a seguir mostra filtros úteis para consultas.

Filtro de para

Incluir essas cláusulas de consulta

Histórias de usuário ou bugs

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

Story Points <> (leave Value field blank)

Consultar o número 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 qualquer estado.

Captura de tela de bugs de consulta 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.

Consultar a contagem de bugs por desenvolvedor

Para mostrar Atribuído a e Estado, crie uma consulta de bugs ativos e modifique as opções de coluna. Em seguida, adicione um gráfico dinâmico que exibe as atribuições e o estado.

Captura de tela da caixa de diálogo Configurar gráfico, com as opções atribuído a e estado.

Consultar a 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 estado e o caminho da área.

Captura de tela mostrando a caixa de diálogo Configurar gráfico, com as opções estado e área.

Consultar valores de campo indefinidos

Você pode encontrar itens de trabalho que têm um valor de campo indefinido usando o operador é igual a, =e deixando o valor do campo em branco. Por exemplo, os filtros a seguir listam todos os itens de trabalho do tipo Histórias de Usuário cujo campo Pontos de História 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 pontos de esforço ou story points

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 itens da lista de pendências do produto e bugs quando você trabalha em um processo Scrum. Para obter mais informações, consulte artigos de tipos de item de trabalho e fluxo de trabalho Básico, Agile, Scrumou CMMI.

Consulta para a soma dos story points e seus 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 Story Points e Estado.

Captura de tela mostrando o editor de Consultas, a lista simples, as histórias abertas.

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

Captura de tela mostrando a caixa de diálogo Configurar gráfico, barra empilhada e soma dos story points.

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

Consulta para o gráfico burn up das histórias do usuário para uma iteração

Crie uma consulta que filtre a História de Usuário como o tipo de item de trabalho e no estado Ativo ou Fechado. Para mostrar os story points, modifique as opções da coluna

Captura de tela mostrando editor de Consultas, lista simples, histórias de usuário – 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 e soma dos story points.

Consulta sobre tarefas restantes e concluídas

Com base no processo que seu projeto faz referência, você pode atribuir os campos a seguir a tarefas ou bugs.

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 das suas tarefas e bugs, poderá obter um resumo do trabalho restante com a consulta e o gráfico a seguir. Use o operador In e inclua a tarefa e o bug para incluir todos os bugs que estão sendo acompanhados como tarefas.

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

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

Captura de tela mostrando a caixa de diálogo de configuração do gráfico, o pivô, e a soma do trabalho restante por cada desenvolvedor.

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

Campos usados para estimar e acompanhar o trabalho

A tabela a seguir descreve os campos baseados em atividade e numéricos 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 obter mais informações sobre como esse campo é usado, consulte Planejamento de capacidade. Os valores permitidos são:

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

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

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

Tarefa, Bug4 (Agile e Scrum)

Valor comercial

Uma unidade subjetiva de medida que captura o valor comercial relativo de um item ou recurso de backlog do produto em comparação com outros itens do mesmo tipo. Um item atribuído a um número maior deve ser considerado como tendo mais valor comercial do que um item atribuído a um número menor.

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

Épico, Recurso

Trabalho concluído

A quantidade de trabalho gasto implementando uma tarefa. Você pode especificar o trabalho em horas ou em dias. Não há unidades de tempo inerentes associadas a esse campo.

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

Tarefa, Bug4

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
  • Educação do Usuário
  • Experiência do usuário

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

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

Tarefa, Bug 4 (CMMI)

Esforço

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

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

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

Item da lista de pendências do produto, Bug 4 (Scrum)

Recurso, Épico

Pontos da história

Uma unidade subjetiva de medida 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.

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

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

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

Tamanho

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

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

Nome da referência=Microsoft.VSTS. Agendamento. Tamanho, tipo de dado=duplo

Requisito, Erro 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 há unidades de tempo inerentes associadas a esse campo.

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

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 há unidades de tempo inerentes associadas a esse campo. Esse campo 3 também é usado para calcular o burndown. Ele é atribuído a type="RemainingWork" no arquivo ProcessConfiguration.

Nota

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

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

Tarefa, Bug4

Requer revisão

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

Nome de referência=Microsoft.VSTS.CMMI.RequiresReview, Tipo de dado=String

Tarefa (CMMI)

Exige Teste

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

Nome de referência=Microsoft.VSTS.CMMI.RequiresTest, Data type=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
  • Planeado

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

Tarefa, Bug4 (processo CMMI)

Nota

  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 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 que aparecem para Capacidade nas páginas da lista de pendências do sprint, você deve fazer com que os valores correspondam em todos os projetos ao campo atribuído ao type="Activity".
  3. Para alterar a atribuição de campo ProcessConfiguration (somente local), confira Referência de 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 bugs podem surgir tanto em requisitos quanto em tarefas, os campos utilizados para estimar o esforço nos níveis de requisitos e de tarefas estão incluídos no formulário do item de trabalho.

Próximas etapas

Personalizar sua experiência de acompanhamento de trabalho

REST API

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