Partilhar via

Consulta por títulos, IDs e campos rich-text

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

Filtre itens de trabalho por palavras-chave, IDs ou campos de texto vazios usando campos de texto de linha única (String), texto de várias linhas (PlainText) e rich-text (HTML). Se as consultas demorarem muito para retornar, consulte Criar uma consulta, Práticas recomendadas.

Tip

Pode usar IA para ajudar nesta tarefa mais adiante neste artigo, ou consultar Enable AI assistance with Azure DevOps MCP Server para começar.

Prerequisites

Category Requirements
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 Permissão de contribuição definida como Permitir para a pasta à qual você deseja adicionar uma consulta. Por padrão, o grupo de Colaboradores não tem essa permissão.

Note

Os usuários com acesso de partes interessadas para um projeto público têm acesso total aos recursos de consulta, assim como os usuários com acesso Básico . Para obter mais informações, consulte Referência rápida sobre o acesso das partes interessadas.

Category Requirements
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 de contribuição definida como Permitir para a pasta à qual você deseja adicionar uma consulta. Por padrão, o grupo de Colaboradores não tem essa permissão.

Operadores e macros suportados

Use os operadores e macros listados para campos de texto e texto rico.

Tipo de dados

Operadores e macros suportados

Texto enriquecido (HTML)
Cadeias de texto de várias linhas (PlainText)

Contains Words, Does Not Contain Words, Is Empty1, Is Not Empty1

Texto único (String)

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was Ever
Macros: [Any] válidas com o campo Tipo de Item de Trabalho e @Project2, válidas com o campo Projeto de Equipe .

ID

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
Macros: @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity válidos com o campo ID e os operadores In e Not In.
@Project 2, válido com o campo Projeto de Equipe .

Campos de Estado e Tipos de Itens de Trabalho

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was Ever
Macros: [Any] válidas com ambos os campos.

Note

  1. Os operadores Is Empty e Is Not Empty são suportados para Azure DevOps Server 2020 e versões posteriores.
  2. O padrão do sistema é filtrar com base no projeto atual. Para obter mais informações, veja Consultas entre projetos.

Uso Contains Words para correspondências de cadeia de caracteres

Quando quiser filtrar uma correspondência de cadeia de caracteres, prefira usar o operador Contains Words em vez de Contains. Contains Words usa o índice de texto completo e normalmente é mais rápido. As cadeias de texto são limitadas a 100 caracteres.

O Contains operador executa uma verificação de tabela; é mais lento e consome mais recursos da CPU, o que pode afetar os seus limites de taxa.

Note

O Contains Words operador usa a indexação de pesquisa de texto completo SQL. Quando um novo valor é guardado num campo de texto longo, SQL Server:

  • Divide a frase em palavras
  • Remove palavras de parada comuns (por exemplo, "a" ou "is")
  • Converte palavras no seu radical comum (por exemplo, correndo → correr)
  • Armazena as palavras-chave resultantes em um índice

Consultas que usam Contains Words para pesquisar no índice, fornecendo resultados mais rápidos para campos de texto longo. Para obter mais informações e requisitos de servidor/agrupamento, consulte Campos de consulta, operadores, valores e variáveis - Texto completo e pesquisas parciais de palavras.

Consulta de palavra-chave ou frase com curingas

Use Contains ou Contains Words para localizar itens que correspondam parcial ou exatamente a palavras ou frases.

Captura de tela que mostra o editor de uma consulta de lista simples usada para filtrar palavras-chave.

Escolha Contains ou Does Not Contain para pesquisar correspondências exatas ou parciais. Escolha Contains Words ou Does Not Contain Words para usar o índice de texto completo e o caractere curinga *.

Por exemplo, Contains Words com inform* corresponde inform, information e informational.

Captura de ecrã que mostra o uso de um curinga com o operador Contém Palavras.

Tip

Para entender como AND/OR as cláusulas são agrupadas, consulte Cláusulas de grupo. Para visualizar a sintaxe WIQL de uma consulta, instale a extensão do editor de consultas WIQL, que permite ver a versão WIQL de qualquer entrada do editor de consultas.

Consulta de palavras específicas e não outras

Use Contains Words e Does Not Contain Words para incluir palavras ou frases exatas e excluir outras. Combine esses operadores e use * para correspondência de curinga.

O exemplo a seguir mostra um filtro que inclui o trabalho "Phase", mas exclui "Phasor".

Captura de ecrã que mostra o Query Editor incluindo e excluindo palavras exatas.

Note

Certas palavras SQL reservadas, como WHERE, THENe AND, não retornam resultados quando usadas como termos de pesquisa autônomos com Contains Words ou Does Not Contain Words.

Consultas sobre campos com valor indefinido

Encontre itens de trabalho com um valor de campo indefinido (em branco) usando o operador = "igual" e deixando o Valor em branco. Por exemplo, os filtros a seguir listam todas as tarefas cujo campo Atividade está em branco.

Captura de ecrã que mostra um filtro onde o valor Activity está em branco.

Para localizar itens em que um campo não está em branco, use o operador <> "não" e deixe o Valor em branco.

Consultas de campo HTML vazias ou não vazias

Use Is Empty ou Is Not Empty com um campo HTML para listar itens de trabalho com campos rich-text vazios ou não vazios. Você não especifica um valor para esses operadores.

Captura de tela que mostra a filtragem por campos HTML não vazios.

Filtrar por caracteres especiais

Fuja de caracteres especiais, como / ou - com uma barra invertida, ao filtrar URLs ou frases.

  • Filtrar para um URL:

    • Consulta: Title ~ "https:\/\/example.com\/path-to-resource"
    • Resultados: Retorna itens de trabalho com a URL exata.

  • Filtrar uma frase com um traço:

    • Consulta: Title ~ "feature-update\-2023"
    • Resultados: Retorna itens de trabalho que contêm a frase exata com traços.

Note

Não é possível consultar itens de trabalho que não tenham nenhuma tag anexada. Para votar positivamente neste pedido de funcionalidade, visite Developer Community: Poder procurar etiquetas vazias.

Consultas baseadas em categorias

Para filtrar por categoria, use o In Group operador . O exemplo abaixo retorna itens no projeto atual atribuídos ao membro da equipe e na categoria Bug.

Captura de tela que mostra uma cláusula que localiza itens de trabalho por categoria.

Quais itens aparecem nas categorias Requisito ou Tarefa?

Atribuições de tipo de item de trabalho padrão para cada processo:

Process Categoria de requisitos Categoria de tarefa
Básico Issue Task
Agile História de usuário Task
Scrum Item da lista de pendências do produto, bug Task
CMMI Requirement Task

As equipas podem escolher se o tipo de item de trabalho "Bug" aparece na categoria de Requisito ou de Tarefa. Consulte Mostrar bugs em listas de pendências e quadros. Para adicionar tipos de item de trabalho personalizados a uma lista de pendências, consulte Adicionar ou modificar um tipo de item de trabalho.

Consulta de itens de trabalho que você está seguindo

Use a @Follows macro com o campo ID e o In operador para listar os itens de trabalho que você segue, entre projetos, se necessário.

Captura de ecrã que mostra o Editor de Consultas na cláusula de consulta @Follows com ID

Consulta de atividade recente de trabalho

Use estas macros para listar itens com base na atividade recente:

  • @MyRecentActivity: Itens que você visualizou ou modificou recentemente.
  • @RecentMentions: Itens com um @mention para você nos últimos 30 dias.
  • @RecentProjectActivity: Itens recentemente criados ou modificados em seu projeto.

Use o campo ID com In ou Not In.

Captura de ecrã que mostra o Editor de Consultas com ID na consulta da macro @MyRecentActivity

Campos comuns para a maioria dos tipos de item de trabalho

Esta tabela descreve campos comuns usados em consultas. O ID identifica exclusivamente um item de trabalho. Use Título para distinguir itens do mesmo tipo. Descrição e outros campos rich-text fornecem informações detalhadas de implementação. Após a criação, você pode modificar todos os campos, exceto ID; o sistema atribui a ID quando o item de trabalho é criado.

Note

O sistema indexa campos de texto longo do tipo PlainText e HTML para pesquisa de texto completo, incluindo Title, Description, e Steps to Repro. Para detalhes e requisitos de servidor/colação aplicáveis ao Azure DevOps local, veja Campos de consulta, operadores, valores e variáveis - Pesquisas de palavras em texto completo e parciais.

Nome do campo

Descrição

Tipo de item de trabalho

Critérios de aceitação 1

Uma descrição dos critérios que devem ser atendidos antes que o bug ou o item da lista de pendências do produto possa ser fechado.

Antes do início do trabalho, registre critérios de aceitação claros para que a equipe e os clientes compartilhem expectativas. Os critérios de aceitação ajudam a definir os testes de aceitação e a confirmar se o item está completo.

Nome de referência=Microsoft.VSTS.Common.AcceptanceCriteria, Tipo de dados=HTML

Bug, Épico, Funcionalidade, Item do backlog do produto (Scrum)

Descrição 1, 2

Use este campo para fornecer informações detalhadas sobre um item de trabalho.

Nome de referência=System.Description, Tipo de dados=HTML

All

ID

O identificador exclusivo atribuído a um item de trabalho. IDs são únicos em todos os projetos dentro de uma coleção de projetos.

Nome de referência=System.Id, Tipo de dados=Inteiro

All

Etapas de reprodução (ou etapas para reproduzir) 1

Etapas necessárias para reproduzir um comportamento inesperado. Capture detalhes suficientes para que outras pessoas possam reproduzir e validar correções.

Nome de referência=Microsoft.VSTS.TCM.ReproSteps, Tipo de dados=HTML

Bug

Resolution

Descreve como um impedimento foi resolvido.

Nome de referência=Microsoft.VSTS.Common.Resolution, Tipo de dados=HTML

Impedimento (Scrum)

Informações do sistema1

Informações sobre software e configuração do sistema relevantes para o bug ou feedback.

Nome de referência=Microsoft.VSTS.TCM.SystemInfo, Tipo de dados=HTML

Bug, Solicitação de revisão de código, Solicitação de feedback

Projeto de Equipa

O projeto que possui o item de trabalho. Adicione este campo a uma consulta para filtrar por um ou mais projetos. Para obter detalhes, consulte Consulta entre projetos.

Nome de referência=System.TeamProject, Tipo de dados=String

All

Title

Uma breve descrição que resume o item de trabalho e ajuda os membros da equipe a distingui-lo dos outros.

Nome de referência=System.Title, Tipo de dados=String

All

Tipo de Item de Trabalho

O nome do tipo de item de trabalho, definido pelo processo usado quando o projeto foi criado. Para obter mais informações, consulte Sobre processos e modelos de processo e Adicionar ou modificar um tipo de item de trabalho.

Para filtrar por atribuição de categoria, use os operadores In Group e Not In Group e selecione uma categoria no menu suspenso.

Nome de referência=System.WorkItemType, Tipo de dados=String

All

Use IA para consultar por título, ID ou descrição

Se tiver o Azure Boards MCP Server ligado ao seu agente de IA em modo agente, pode usar prompts em linguagem natural para encontrar itens de trabalho por palavras-chave, IDs ou conteúdo textual.

Task Exemplo de prompt
Pesquisar por palavra-chave Find all work items with 'performance' in the title
Descrições de pesquisa List bugs where the description contains 'null reference exception'
Encontrar campos vazios Show user stories with empty acceptance criteria
Consulta por faixa de IDs Find work items with IDs between 5000 and 5100
Encontre títulos semelhantes List work items in <Contoso> with titles containing "login", "sign in", or "authentication"
Qualidade da descrição da auditoria List active user stories in <Contoso> where the description is shorter than 50 characters
Passos de pesquisa de reprodução Find bugs in <Contoso> whose repro steps mention "intermittent" or "random"
Encontre padrões de nomeação List work items in <Contoso> whose title starts with "[SPIKE]" or "[POC]"
Identificar potenciais duplicados Show pairs of active bugs in <Contoso> that have similar titles
Analisar itens incompletos List user stories in the current sprint for <Contoso> where either the title contains "TBD" or the description is empty

Note

O modo Agente e o Servidor MCP usam linguagem natural, por isso pode ajustar estes prompts ou fazer perguntas de seguimento para refinar os resultados.

Conteúdo relacionado

API REST

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

  • Last updated on