Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Serviços de DevOps do Azure | 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 aplicam-se apenas a versões específicas do Azure DevOps.
Para obter exemplos rápidos e tarefas do editor, consulte Referência rápida de consulta e Gerenciar e organizar consultas.
Pré-requisitos
| Categoria | Requerimentos |
|---|---|
| Níveis de acesso | - Para visualizar e executar consultas compartilhadas: Membro do Projeto. - Para adicionar e guardar uma consulta partilhada: É necessário ter, no mínimo, acesso básico. |
| Permissões |
A permissão Contribute está definida como Permitir para a pasta à qual se deseja adicionar uma consulta. Por padrão, o grupo Colaboradores |
Nota
Utilizadores com acesso Stakeholder a um projeto público têm acesso total a todas as funcionalidades de consulta, tal como os utilizadores com acesso Basic. Para obter mais informações, consulte Referência rápida de acesso para partes interessadas.
| Categoria | Requerimentos |
|---|---|
| Níveis de acesso | - Para visualizar e executar consultas compartilhadas: Membro do Projeto. - Para adicionar e salvar uma consulta partilhada: Pelo menos acesso Básico . |
| Permissões |
A permissão Contribute está definida como Permitir para a pasta à qual se deseja adicionar uma consulta. Por padrão, o grupo Colaboradores |
Tipos de dados e valores do campo de consulta
Você deve especificar um valor que corresponda ao tipo de dados para um campo. A tabela abaixo lista os tipos de dados suportados:
Nota
Para Azure Boards (cloud), 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 Campos de item de trabalho e atributos de campo para obter detalhes.
Tipo de dados
Descrição
Booleano
Armazena um valor Verdadeiro/Falso.
Data/ Hora ou Data/Hora
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 padrão definido no 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 da linguagem de consulta de itens de trabalho (WIQL).
Duplo 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 string de identificador único.
Histórico
Campo formatado personalizado usado para informações históricas (o campo Histórico ). Quando a pesquisa de texto completo está disponível, este 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 rich-text, consulte Consulta por títulos, IDs e campos rich-text.
Identidade
Armazena uma cadeia de caracteres de texto curta que identifica uma identidade de usuário.
Inteiro
Armazena um inteiro de 32 bits assinado (por exemplo, 0, 1, 2, 34).
Campo Texto Simples ou Texto (várias linhas)
Armazena valores de texto longos (por exemplo, Informações de início do aplicativo). Estes campos são indexados para pesquisa de texto completo se suportado. Consulte Consulta por títulos, IDs e campos rich-text.
picklistDuplo
Campo personalizado que contém uma lista de opções de valores decimais.
picklistInteger
Campo personalizado que contém uma lista de opções de valores inteiros.
picklistString
Campo personalizado que contém uma lista de opções de valores de texto curto (255 caracteres ou menos).
Campo String ou Text (linha única)
Armazena texto curto até 255 caracteres Unicode. As equipes geralmente usam esses campos para listas de opções ou menus suspensos.
TreePath
Representa uma árvore de ramificação (por exemplo, Caminho da Área ou Caminho da Iteração). Escolha um valor de nó válido. Você pode filtrar por igualdade, desigualdade, "Sob" / "Não Abaixo" 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 exemplos de consulta, consulte Consulta por área ou caminho de iteração e Consulta por data ou iteração atual.
Nota
Os picklist... tipos só se aplicam a campos personalizados definidos para um processo herdado.
Padrão de data e hora
O padrão de data e hora que você insere para os campos DateTime deve corresponder ao que você selecionou através do seu perfil. Para ver ou alterar a sua seleção, consulte Definir preferências do utilizador.
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 Referência de campo de item de trabalho. Para obter ajuda na criação de 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 (Duplo/Decimal/GUID/Inteiro), String, DateTime, TreePath
<>
Não corresponde ao valor da cláusula.
Número, String, DateTime, TreePath
>
É maior do que o valor da cláusula.
Número, String, DateTime
<
É menor do que o valor da cláusula.
Número, String, DateTime
>=
É maior ou igual ao valor da cláusula.
Número, String, DateTime
<=
É menor ou igual ao valor da cláusula.
Número, String, DateTime
=[Campo]
Corresponde ao valor em outro campo especificado (deve ser do mesmo tipo de dados).
Nome de um campo do mesmo tipo de dados (campos booleanos 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.
Cordão
Não contém
Não contém uma correspondência de texto exata ou parcial.
Cordão
Contém palavras
Corresponde a uma frase ou palavras exatas (suporta o uso de um curinga no final *). Limite: 100 caracteres. Este operador usa indexação de texto completo; consulte a seção Texto completo neste artigo para obter os requisitos de servidor e agrupamento.
Campos de texto longo indexados para pesquisa de texto completo (Texto Simples, HTML, Histórico e Título).
Não contém palavras
Exclui itens que contêm a frase ou palavras especificadas. Limite: 100 caracteres. Utilize cláusulas complementares com Contains Words para incluir ou excluir palavras-chave.
Campos de texto indexados para pesquisa de texto completo.
In
Corresponde a qualquer valor em um conjunto delimitado (use o separador de lista regional do sistema operacional, normalmente uma vírgula).
Número, String, DateTime, TreePath
Está vazio
Corresponde a itens em que um campo HTML não contém conteúdo (nenhum valor especificado). Com suporte para Azure Boards e Azure DevOps Server.
HTML
Não está vazio
Corresponde a itens em que um campo HTML contém conteúdo. Com suporte para Azure Boards e Azure DevOps Server.
HTML
Não está em
Exclui valores em um conjunto delimitado (use o separador de lista regional). Com suporte para Azure Boards e Azure DevOps Server.
Número, String, DateTime, TreePath
No Grupo
Corresponde a 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.
String (corresponde ao nome do grupo ou da equipe) ou Tipo de Item de Trabalho
Nota
Use Em Grupo somente com campos do tipo "String" ou Tipo de Item de Trabalho. Você pode usar grupos do Microsoft Entra ID quando a sua conta utiliza o Microsoft Entra ID ou grupos do Active Directory para ambientes locais. :::fim-da-coluna:::
Não no grupo
Exclui membros de um grupo nomeado.
Cadeia de caracteres que corresponde a um grupo de usuários ou categoria de projeto.
Não sob
Exclui itens iguais ou contidos no nó de árvore especificado.
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.
String, DateTime (Cadeia de caracteres, Data e Hora)
Nota
Atualmente, o Editor de Consultas não suporta Was Ever campos de data, use WIQL direto para esses casos.
:::fim-da-coluna:::
Gorjeta
Você pode construir consultas WIQL que usam operadores, Was Ever por exemplo, para outros tipos de dados como Caminho de Iteração. Consulte Listar itens de trabalho removidos de um sprint para ver um exemplo.
Consultar macros e variáveis
Utilize as macros seguintes para filtrar consultas dinamicamente.
Nota
As seguintes macros só são suportadas a partir do portal 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
[Qualquer]
Use com Tipo de Item de Trabalho ou 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 de Iteração para filtrar itens de trabalho no sprint atual com base no contexto da equipe atual. Consulte Consulta por data ou iteração atual para obter exemplos. @CurrentIteration funciona somente quando executado a partir do portal da Web (não em APIs REST ou algumas operações de cópia/clone).
@CurrentIteration +/- n
Use com o caminho de iteração para incluir sprints relativos à iteração atual (por exemplo, @CurrentIteration-1 ou @CurrentIteration+2). Com suporte no portal da Web para Azure Boards e Azure DevOps Server.
@Follows
Use com ID e o In operador para listar os itens de trabalho que você segue no projeto. Veja como seguir um item de trabalho ou pull request. Esta macro funciona apenas a partir do portal web.
@Me
Use com campos de identidade para filtrar itens vinculados à sua conta (por exemplo, Created By=@Me). Consulte Consulta por atribuição, fluxo de trabalho ou alterações no quadro.
@MyRecentActivity
Utilize com ID e In para listar os itens de trabalho que visualizou ou atualizou nos últimos cerca de 30 dias. Consulte a página Itens de Trabalho no separador A minha atividade com a mesma lista.
@Project
Use com Team Project para filtrar itens de trabalho no projeto atual (por exemplo, Team Project=@Project). Consulte Consulta entre projetos.
@RecentMentions
Usa com ID e In para listar itens de trabalho onde tu és mencionado nas Discussões. Consulte a página Itens de Trabalho Pivô mencionado .
@RecentProjectActivity
Use ID e In para listar itens de trabalho recentemente atualizados em todo o 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 Caminho da Área e o operador = para localizar itens atribuídos aos caminhos de área de uma equipa (por exemplo, Area Path=@TeamAreas [Fabrikam Fiber]\Web). Com suporte no portal da Web do 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 Contém ou Não Contém 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 usar um curinga à direita (*); 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 Exemplos de consultas de item de trabalho e Consulta de itens de trabalho usando o campo Histórico.
Nota
Nem todas as implantações oferecem suporte à pesquisa de texto completo. Por exemplo, o SQL Express e algumas configurações de SQL na nuvem não oferecem suporte à pesquisa de texto completo. Nessas implantações, apenas os operadores Contém e Não Contém são visíveis.
O Azure DevOps Server indexa campos de texto longo (Texto Simples 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 um agrupamento SQL com um separador de palavras registrado para o idioma que você usa. Se o agrupamento do banco de dados de coleta não corresponder a um idioma suportado, os resultados podem não corresponder às expectativas; nesses casos, use Contém ou Não Contém .
Para obter mais informações, consulte Consultas de pesquisa de texto completo e configurações de agrupamento.
Conteúdo relacionado
- Usar a referência rápida da consulta
- Saiba mais sobre consultas gerenciadas
- Acessar o índice do campo de item de trabalho
- Compreender a sintaxe WIQL
API REST
Para interagir programaticamente com consultas, consulte um destes recursos da API REST: