Partilhar via

Consulta por comparações de valores de campo

Serviços de DevOps do Azure | 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. Os usos comuns incluem:

  • Encontre itens de trabalho em que o criador difere do cessionário ou do mais próximo.
  • Encontre tarefas cuja Estimativa Original seja menor que o Trabalho Concluído.
  • Encontre tarefas encerradas concluídas antes da Data Alvo.

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 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.

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 Referência rápida de acesso a 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 Acesso básico.
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.

Tipos de dados suportados

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
  • Duplo, Inteiro
  • GUID
  • Identidade
  • String (excluindo Tags)

Observação

Algumas combinações de tipo de dados/operador são absurdas (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 amostra

Use estas cláusulas de exemplo como ponto de partida. A sintaxe exata no Editor de Consultas pode variar ligeiramente de acordo com o cliente; em caso de dúvida, construa a cláusula no Editor de Consultas da 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 é inferior ao Trabalho Concluído: [Estimativa Original] < [Trabalho Concluído]

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

Campos que suportam a comparação de campos

A tabela abaixo lista os campos que suportam consultas de comparação. Nem todos os campos estão disponíveis para cada processo ou tipo de item de trabalho; alguns requerem campos personalizados ou configuração de processos. Consulte a nota a seguir para obter 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).

A

B

C

D–F

H

I

J–N

O–Q

R

S

T

U–W

Observação

O suporte à comparação campo a campo difere de acordo com o cliente. O Editor de Consultas Web suporta a maioria das comparações de campo; comparações complexas (por exemplo, alguns usos de `WAS EVER` ou expressões WIQL avançadas) requerem a edição direta do WIQL, utilizando a extensão WIQL Editor. Em caso de dúvida, crie a cláusula no Editor de Consultas da Web e inspecione o WIQL salvo.

Conteúdo relacionado

API REST

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

Sugestão

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

  • Last updated on