Comparações de consulta por valor de campo

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

Use operadores de campo de comparação quando quiser filtrar itens de trabalho comparando o valor de um campo com o valor de outro campo. Os usos comuns incluem:

Dica

Você pode usar a IA para ajudar nessa tarefa mais adiante neste artigo ou consulte Ativar a assistência de IA com o Azure DevOps Server MCP para começar.

  • Encontre itens de trabalho em que o criador difira do atribuidor ou do mais próximo.
  • Localize tarefas cuja Estimativa Original seja menor que o Trabalho Concluído.
  • Encontre as tarefas fechadas que foram concluídas antes da Data Alvo.

Pré-requisitos

Categoria Requisitos
Membro do projeto Você deve ser adicionado como membro do projeto.
Níveis de Acesso – Para exibir e executar consultas compartilhadas: você deve ser um membro Project.
- Para adicionar e salvar uma consulta compartilhada: você deve ter pelo menos acesso Básico.
Permissões Verifique se a permissão Contribuir está definida como Permitir para a pasta em que você deseja adicionar uma consulta. Talvez sua organização precise configurar manualmente o grupo Colaboradores para conceder essa permissão.

Observação

Você precisa de um nível de acesso suficiente e permissão do Contribute para salvar consultas compartilhadas. O acesso básico não é suficiente.

Categoria Requisitos
Membro do projeto Você deve ser adicionado como membro do projeto.
Níveis de Acesso – Para exibir e executar consultas compartilhadas: você deve ser um membro Project.
- Para adicionar e salvar uma consulta compartilhada: você deve ter pelo menos acesso Básico.
Permissões Verifique se a permissão Contribuir está definida como Permitir para a pasta em que você deseja adicionar uma consulta. Talvez sua organização precise configurar manualmente o grupo Colaboradores para conceder essa permissão.

Observação

Você precisa de um nível de acesso suficiente e permissão do Contribute para salvar consultas compartilhadas. O acesso básico não é suficiente.

Tipos de dados com suporte

Você pode usar os operadores de comparação — =[Field], , <>[Field]>[Field], , <[Field], >=[Field]– <=[Field] com os seguintes tipos de dados listados. O tipo de dados do campo esquerdo e do campo direito deve corresponder.

  • Booleano (suporta =[Field], <>[Field])
  • Data/Hora
  • Double, Integer
  • GUID
  • Identidade
  • Cadeia de caracteres (excluindo marcas)

Observação

Algumas combinações de tipo de dados/operador são sem sentido (por exemplo, Title >= [Field] ou Assigned To <= [Field]). Valide sua comparação para garantir que ambos os lados usem tipos de dados compatíveis.

Filtros de exemplo

Use essas cláusulas de exemplo como ponto de partida. A sintaxe exata no Editor de Consultas pode variar ligeiramente por cliente; quando estiver em dúvida, crie a cláusula no Editor de Consultas Web e verifique o WIQL salvo.

  • Itens de trabalho fechados por alguém que não seja a pessoa que criou o item de trabalho: [Criado por] <> [Fechado por] E [Estado] = 'Fechado'

  • Tarefas cuja estimativa original é menor que o Trabalho Concluído: [Estimativa Original] < [Trabalho Concluído]

  • Tarefas fechadas concluídas antes da Data de Destino: [Data de Fechamento] <= [Data de Destino] E [Estado] = 'Fechamento'

Campos que dão suporte à comparação de campos

A tabela abaixo lista os campos que dão suporte a consultas de comparação. Nem todos os campos estão disponíveis para cada tipo de item de trabalho ou processo; alguns exigem campos personalizados ou configuração de processo. Veja a observação a seguir para links de personalização.

Observação

Nem todos os campos listados estão presentes em todos os projetos/processos. Você pode adicionar campos personalizados e habilitá-los para comparações. Consulte Adicionar um campo personalizado a um tipo de item de trabalho (processo herdado) ou Adicionar ou modificar um campo (processo XML local).

D–F

H

I

Observação

O suporte à comparação campo a campo é diferente por cliente. O Editor de Consultas web dá suporte à maioria das comparações de campo; comparações complexas (por exemplo, alguns usos de expressões WIQL WAS EVER ou avançadas) exigem a edição direta do WIQL (extensão do Editor WIQL). Quando estiver em dúvida, crie a cláusula no Editor de Consultas da Web e inspecione o WIQL salvo.

Usar IA para consultar comparações de valores de campo

Se você tiver o Azure Boards MCP Server conectado ao seu agente de IA em modo de agente, poderá usar prompts em linguagem natural para encontrar itens de trabalho com base na comparação de campos.

Tarefa Exemplo de prompt
Comparação entre criador e responsável Find work items where Created By is different from Assigned To
Verificar a precisão da estimativa List tasks where Completed Work exceeds Original Estimate
Localizar conclusões antecipadas Show work items that were closed before their target date
Comparar histórico de alterações Find bugs where the person who last changed the item differs from the creator
Detectar trabalho subestimado List tasks in the current sprint for <Contoso> where remaining work is more than double the original estimate
Localizar itens vencidos Show active work items in <Contoso> where the target date is before today
Identificação de incompatibilidades de esforço List user stories in <Contoso> with story points greater than 8 but only 1 child task
Comparar o previsto com o real For completed tasks in the current sprint for <Contoso>, show original estimate vs completed work side by side
Localizar itens de esforço zero List active tasks in the current sprint for <Contoso> where both original estimate and remaining work are zero or empty
Identificar o trabalho auto-atribuído Show work items in <Contoso> where Created By equals Assigned To and state is still New

Observação

O modo de agente e o servidor MCP usam linguagem natural, para que você possa ajustar esses prompts ou fazer perguntas de acompanhamento para refinar os resultados.

API REST

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

Dica

Se você precisar de nomes de referência para WIQL ou REST (por exemplo System.IterationId ou Microsoft.VSTS.Common.Priority), consulte campos de itens de trabalho e atributos.