Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Este artigo descreve tipos de dados de campo, operadores de consulta e macros de consulta que você usa no Editor de Consultas. Alguns tipos, operadores e macros se aplicam apenas a versões específicas do Azure DevOps.
Para obter exemplos rápidos e tarefas do editor, consulte Consulta de referência rápida e Gerenciar e organizar consultas.
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 Contribuidores 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 Contribuidores não tem essa permissão. |
Valores e tipos de dados do campo de consulta
Você deve especificar um valor que corresponda ao tipo de dados de um campo. A tabela a seguir lista os tipos de dados com suporte:
Observação
Para o Azure Boards (nuvem), o tipo de dados corresponde ao campo mostrado na página Campos de Processo>. Para implantações locais, o tipo de dados corresponde ao type atributo em uma FIELD definição. Consulte os campos de item de trabalho e os atributos de campo para obter detalhes.
Tipo de dados
Descrição
Booleano
Armazena um valor Verdadeiro/Falso.
DateTime ou Date/Time
Use uma variável de data (por exemplo, @Today ou @Today-1) ou uma data explícita como 01/01/2025. Insira as datas no formato definido em seu perfil. Para obter exemplos de consulta, consulte Query by date or @CurrentIteration.
Para consultas WIQL, você também pode especificar datas em UTC. Consulte sintaxe para a linguagem de consulta de item de trabalho (WIQL).
Double ou Decimal
Armazena um número real, como 0.2 ou 3.5. Consulte Consulta por campos numéricos para obter exemplos.
GUID
Armazena uma cadeia de caracteres de identificador exclusiva.
Histórico
Campo formatado personalizado usado para informações históricas (o campo Histórico ). Quando a pesquisa de texto completo está disponível, esse campo é indexado para consultas de texto completo. Consulte Histórico e auditoria.
HTML
Armazena texto formatado (por exemplo, Descrição ou Etapas de Reprodução). Quando a pesquisa de texto completo está disponível, esses campos são indexados. Para consultar campos de rich text, consulte Consultar por títulos, IDs e campos de rich text.
Identidade
Armazena uma cadeia de caracteres de texto curta que identifica uma identidade de usuário.
Inteiro
Armazena um inteiro com sinal de 32 bits (por exemplo, 0, 1, 2, 34).
PlainText ou Campo de texto (várias linhas)
Armazena valores de texto longo (por exemplo, Informações de Início do Aplicativo). Esses campos são indexados para pesquisa de texto completo quando é suportado. Consulte Consulta por títulos, IDs e campos de rich-text.
picklistDouble
Campo personalizado que contém uma lista de seleção de valores decimal.
picklistInteger
Campo personalizado que contém uma lista de seleção de valores inteiros.
picklistString
Campo personalizado que contém uma lista de seleção de valores de texto curto (255 caracteres ou menos).
Cadeia de caracteres ou Campo de texto (linha única)
Armazena texto curto com até 255 caracteres Unicode. As equipes geralmente usam esses campos para listas de seleção ou menus suspensos.
TreePath
Representa uma árvore de ramificação (por exemplo, caminho de área ou caminho de iteração). Escolha um valor de nó válido. Você pode filtrar a igualdade, a desigualdade, "Under" /"Not Under" ou usar os In / Not In operadores para especificar vários valores. Defina estruturas de árvore para um projeto — caminhos de área e caminhos de iteração — e selecione os nós a serem associados às equipes.
Para obter exemplos de consulta, consulte Consulta por área ou caminho de iteração e Consulta por data ou iteração atual.
Observação
Os picklist... tipos se aplicam somente a campos personalizados definidos para um processo herdado.
Padrão de data e hora
O padrão de data e hora inserido para campos DateTime deve corresponder ao selecionado em seu perfil. Para exibir ou alterar sua seleção, consulte Definir preferências do usuário.
Operadores de consulta
Use operadores para definir como um valor de cláusula deve se relacionar com o valor de campo de um item de trabalho. Para tipos de dados de campo, consulte a referência de campos de itens de trabalho. Para obter ajuda para criar consultas, consulte Definir uma consulta.
Operador de consulta
Quando o operador retorna itens de trabalho correspondentes
Tipos de dados aplicáveis
=
Corresponde ao valor da cláusula.
Número (Double/Decimal/GUID/Integer), String, DateTime, TreePath
<>
Não corresponde ao valor da cláusula.
Número, Cadeia de Caracteres, DateTime, TreePath
>
É maior que o valor da cláusula.
Número, String (Cadeia de caracteres), DateTime (Data e hora)
<
É menor que o valor da cláusula.
Número, String (Cadeia de caracteres), DateTime (Data e hora)
>=
É maior ou igual ao valor da cláusula.
Número, String (Cadeia de caracteres), DateTime (Data e hora)
<=
É menor ou igual ao valor da cláusula.
Número, String (Cadeia de caracteres), DateTime (Data e hora)
=[Field]
Corresponde ao valor em outro campo especificado (deve ser o mesmo tipo de dados).
Nome de um campo do mesmo tipo de dados (campos boolianos comparam a igualdade com outros campos).
<>[Campo]
Não corresponde ao valor em outro campo especificado.
Nome de um campo do mesmo tipo de dados.
>[Campo]
É maior que o valor em outro campo especificado.
Nome de um campo do mesmo tipo de dados.
<[Campo]
É menor que o valor em outro campo especificado.
Nome de um campo do mesmo tipo de dados.
>=[Campo]
É maior ou igual ao valor em outro campo especificado.
Nome de um campo do mesmo tipo de dados.
<=[Campo]
É menor ou igual ao valor em outro campo especificado.
Nome de um campo do mesmo tipo de dados.
Contém
Contém uma correspondência de texto exata ou parcial.
String
Não contém
Não contém uma correspondência de texto exata ou parcial.
String
Contém Palavras
Corresponde a uma frase ou palavras exatas (suporta curinga de *). Limite: 100 caracteres. Esse operador usa a indexação de texto completo; consulte a seção De texto completo neste artigo para requisitos de servidor e ordenação.
Campos de texto longo indexados para pesquisa de texto completo (PlainText, HTML, Histórico e Título).
Não Contém Palavras
Exclui itens que contêm a frase ou as palavras especificadas. Limite: 100 caracteres. Use Contains Words em expressões associadas para incluir ou excluir palavras-chave.
Campos de texto indexados para pesquisa de texto completo.
No
Corresponde a qualquer valor em um conjunto delimitado (use o separador de lista regional do sistema operacional, normalmente uma vírgula).
Número, Cadeia de Caracteres, DateTime, TreePath
Está Vazio
Corresponde a itens em que um campo HTML não contém conteúdo (nenhum valor especificado). Compatível com o Azure Boards e o Azure DevOps Server.
HTML
Não Está Vazio
Corresponde a itens em que um campo HTML contém conteúdo. Compatível com o Azure Boards e o Azure DevOps Server.
HTML
Não está em
Exclui valores em um conjunto delimitado (use o separador de lista regional). Compatível com o Azure Boards e o Azure DevOps Server.
Número, Cadeia de Caracteres, DateTime, TreePath
Em Grupo
Corresponde aos valores que são membros de um grupo nomeado (equipe, grupo de segurança ou categoria). Por exemplo, use o grupo Colaboradores ou um grupo de equipe nomeado no padrão [Project Name]\Team Name. Consulte Consulta por atribuição ou alterações de fluxo de trabalho para obter exemplos.
Cadeia de caracteres (corresponde ao nome do grupo ou da equipe) ou tipo de item de trabalho
Observação
Use In Group apenas com campos do tipo String ou tipo de item de trabalho. Você pode usar grupos do Microsoft Entra ID quando sua conta utiliza o Microsoft Entra ID ou grupos do Active Directory para instalações locais. :::column-end:::
Fora do grupo
Exclui membros de um grupo nomeado.
Cadeia de caracteres que corresponde a um grupo de usuários ou categoria de projeto.
Não está em
Exclui itens que são iguais ao nó de árvore especificado ou estão contidos nele.
TreePath
Em
Corresponde a itens iguais ou contidos no nó de árvore especificado.
TreePath
Foi sempre
Corresponde a um valor que um campo manteve em qualquer momento anterior.
Texto, Data e Hora
Observação
Atualmente, o Editor de Consultas não dá suporte Was Ever a campos de data; use WIQL direto para esses casos.
:::column-end:::
Dica
Você pode construir consultas WIQL usando operadores (por exemplo, Was Ever) em outros tipos de dados, como Caminho de Iteração. Veja lista de itens de trabalho removidos de um sprint como exemplo.
Consultar macros e variáveis
Use as seguintes macros para filtrar consultas dinamicamente.
Observação
As macros a seguir só têm suporte no portal da Web: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity e @TeamAreas. As consultas que contêm essas macros não funcionarão quando abertas no Visual Studio/Team Explorer, Microsoft Excel ou Microsoft Project.
Macro
Descrição
[Any]
Use com o Tipo de Item de Trabalho ou o Estado para pesquisar em todos os tipos ou estados. Por exemplo, Work Item Type=[Any] remove a filtragem baseada em tipo.
@CurrentIteration
Use com o Caminho da Iteração para filtrar itens de trabalho no sprint atual com base no contexto atual da equipe. Consulte a consulta por data ou iteração atual para obter exemplos. @CurrentIteration funciona somente quando executado no portal da Web (não em APIs REST ou em algumas operações de cópia/clonagem).
@CurrentIteration +/- n
Use com o Caminho da Iteração para incluir sprints relativos à iteração atual (por exemplo, @CurrentIteration-1 ou @CurrentIteration+2). Com suporte no portal web para Azure Boards e Azure DevOps Server.
@Follows
Use o ID e o In operador para listar itens de trabalho que você acompanha no projeto. Consulte Seguir um item de trabalho ou um pull request. Essa macro funciona somente no portal da Web.
@Me
Use com campos de identidade para filtrar itens vinculados à sua conta (por exemplo, Created By=@Me). Consulte Pesquisar por atribuição, fluxo de trabalho ou mudanças no quadro.
@MyRecentActivity
Use com ID e In para listar os itens de trabalho que você visualizou ou atualizou nos últimos 30 dias. Consulte a página Itens de Trabalho Minha atividade pivô para a mesma lista.
@Project
Use com o Team Project para filtrar itens de trabalho no projeto atual (por exemplo, Team Project=@Project). Consulte Consulta entre projetos.
@RecentMentions
Use com ID e In para listar itens de trabalho onde você é mencionado em Discussões. Consulte a página Itens de Trabalho Mencionada pivot.
@RecentProjectActivity
Use ID e In para listar itens de trabalho atualizados recentemente em diferentes partes do projeto. A macro retorna até 5.000 itens; a janela real depende da atividade do projeto.
@StartOfDay
Use com campos DateTime para filtrar em relação a hoje (por exemplo, Closed Date>=@StartOfDay-7).
@StartOfMonth
Use com campos DateTime para filtrar em relação ao início do mês (por exemplo, Created Date>=@StartOfMonth-3).
@StartOfWeek
Use com campos DateTime para filtrar em relação ao início da semana (por exemplo, Changed Date>=@StartOfWeek-2).
@StartOfYear
Use com campos DateTime para filtrar em relação ao início do ano (por exemplo, Target Date>=@StartOfYear).
@TeamAreas
Use apenas com o Caminho da Área e o = operador para localizar itens atribuídos aos caminhos de área de uma equipe (por exemplo, Area Path=@TeamAreas [Fabrikam Fiber]\Web). Com suporte no portal da web para o Azure DevOps Server.
@Today
Use com campos DateTime para filtrar em relação a hoje (por exemplo, Created Date>=@Today-7). Consulte Consulta por data ou iteração atual.
Pesquisas de texto completo e de palavras parciais
Use Contains or Does Not Contain para pesquisar correspondências exatas ou parciais em campos de texto longo (esses operadores usam o índice de consulta). Use Contém Palavras ou Não Contém Palavras para pesquisar frases exatas ou utilizar um caractere curinga no final (*); esses operadores exigem o índice de texto completo.
Você pode usar o caractere curinga somente no final de uma palavra ou frase parcial. Para obter exemplos, consulte Exemplo de consultas de item de trabalho e Consultar itens de trabalho usando o campo Histórico.
Observação
Nem todas as implantações dão suporte à pesquisa de texto completo. Por exemplo, o SQL Express e algumas configurações de SQL de nuvem não dão suporte à pesquisa de texto completo. Nessas implantações, somente os operadores Contains e Does Not Contain estão visíveis.
O Azure DevOps Server indexa campos de texto longo (PlainText e HTML) e o campo Título para pesquisa de texto completo quando o SQL Server subjacente dá suporte à indexação de texto completo.
A pesquisa de texto completo também requer uma ordenação SQL com um separador de palavras registrado para o idioma que você usa. Se a ordenação do banco de dados de coleção não corresponder a um idioma com suporte, os resultados poderão não corresponder às expectativas; Nesses casos, use Contains ou Não Contém em vez disso.
Para obter mais informações, confira Consultas de pesquisa de texto completo e configurações de ordenação.
Conteúdo relacionado
- Use a referência rápida de consulta
- Aprenda sobre as consultas gerenciadas
- Acessar o índice do campo do item de trabalho
- Entender a sintaxe WIQL
API REST
Para interagir programaticamente com consultas, confira um destes recursos da API REST: