Compartilhar via

Comparações de consulta por valor de campo

Azure DevOps Services | 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:

  • Encontre itens de trabalho em que o criador difere do atribuídor 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
Níveis de Acesso – Para exibir e executar consultas compartilhadas: membro do projeto .
– Para adicionar e salvar uma consulta compartilhada: no mínimo, acesso Básico.
Permissões Permissão 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.

Observação

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

Categoria Requisitos
Níveis de Acesso – Para exibir e executar consultas compartilhadas: membro do projeto .
– Para adicionar e salvar uma consulta compartilhada: no mínimo, acesso Básico.
Permissões Permissão 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.

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, Inteiro
  • 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 Fechada] <= [Data de Destino] E [Estado] = 'Fechado'

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

Um

B

C

D–F

H

I

J–N

O–Q

R

S

T

U–W

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 WAS EVER ou expressões WIQL 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 web e inspecione o WIQL salvo.

Conteúdo relacionado

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.

  • Last updated on