Compartilhar via

Consultar por títulos, IDs e campos de rich-text

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

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

Tip

Você pode usar a IA para ajudar nessa tarefa mais adiante neste artigo ou consulte Ativar a assistência de IA com o Azure DevOps Server MCP para começar.

Prerequisites

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

Note

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 obter mais informações, consulte a referência rápida de acesso para partes interessadas .

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

Operadores e macros com suporte

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

Tipo de dados

Operadores e macros com suporte

Texto avançado (HTML)
Cadeias de texto multilinha (PlainText)

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

Texto único (cadeia de caracteres)

= , <> , > , < , >= , <= , =[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álido com o campo ID e In operadores Not In.
@Project 2, válido com o campo Projeto de Equipe .

Campos Estado e Tipo de Item 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 para ambos os campos.

Note

  1. Os operadores Is Empty e Is Not Empty têm suporte para versões Azure DevOps Server 2020 e posteriores.
  2. O sistema usa como padrão a filtragem com base no projeto atual. Para obter mais informações, confira Consultar diversos projetos.

Usar Contains Words para correspondências de cadeia de caracteres

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

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

Note

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

  • Divide a frase em palavras
  • Remove palavras-vazias comuns (por exemplo, "a" ou "é")
  • Converte palavras em seu radical comum (por exemplo, executando → execut)
  • Armazena as palavras-chave resultantes em um índice

Consultas que usam Contains Words pesquisam o índice, dando resultados mais rápidos para campos de texto longo. Para obter mais informações e requisitos de servidor/ordenação, consulte campos de consulta, operadores, valores e variáveis – pesquisa de texto completo e de palavras parciais.

Consulta de palavra-chave ou frase com caracteres curinga

Use Contains ou Contains Words localize 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 buscar correspondências exatas ou parciais. Escolha Contains Words ou Does Not Contain Words para utilizar o índice de texto completo e o caractere curinga *.

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

Captura de tela que mostra o uso de um curinga com o operador Contains Words.

Tip

Para entender como as cláusulas AND/OR são agrupadas, consulte Cláusulas de grupo. Para exibir 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.

Consultar 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 estes operadores e use * para correspondência de curinga.

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

Captura de tela que mostra o Editor de Consultas incluindo e excluindo palavras exatas.

Note

Determinadas 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 de valor de campo indefinidas

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

Captura de tela que mostra um filtro em que o valor da atividade 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 de 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

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

  • Filtrar uma 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

Você não pode consultar itens de trabalho que não tenham tags. Para votar a favor dessa solicitação de recurso, visite Developer Community: Ser capaz de pesquisar por tags vazias.

Consultas baseadas em categoria

Para filtrar por categoria, use o In Group operador. O exemplo a seguir retorna itens no projeto atual atribuído 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 requisito Categoria de tarefa
Básico Issue Task
Agile História do usuário Task
Scrum Item da lista de pendências do produto, Bug Task
CMMI Requirement Task

As equipes podem escolher se o tipo de item de trabalho Bug aparece na categoria Requisito ou Tarefa. Confira 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.

Consultar os 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 em projetos, se necessário.

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

Consulta para atividades recentes do item de trabalho

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

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

Use o campo ID com In ou Not In.

Screenshot que mostra o Query Editor com ID na macro de consulta @MyRecentActivity

Campos comuns para a maioria dos tipos de item de trabalho

Esta tabela descreve campos comuns usados em consultas. A ID identifica exclusivamente um item de trabalho. Use o Título para distinguir itens do mesmo tipo. A descrição e outros campos de rich-text fornecem informações detalhadas de implementação. Após a criação, você pode modificar todos os campos, exceto a 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, Descriptione Steps to Repro. Para obter detalhes e requisitos de servidor/ordenação aplicáveis ao Azure DevOps no local, consulte Consulta de campos, operadores, valores e variáveis - pesquisas de texto completo e de palavras parciais.

Nome do campo

Description

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 de lista de pendências do produto possa ser fechado.

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

Nome da referência=Microsoft.VSTS.Common.AcceptanceCriteria, Data type=HTML

Bug, Épico, Recurso, Item da Lista de Pendências do Produto (Scrum)

Descrição 1, 2

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

Reference name=System.Description, Data type=HTML

All

ID

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

Nome de referência=System.Id, Tipo de dado=Integer

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 da referência=Microsoft.VSTS.TCM.ReproSteps, Data type=HTML

Bug

Resolution

Descreve como um impedimento foi solucionado.

Nome da referência=Microsoft.VSTS.Common.Resolution, Data type=HTML

Impedimento (Scrum)

Informações do Sistema1

Informações sobre o software e a configuração do sistema relevantes para o bug ou comentários.

Nome da referência=Microsoft.VSTS.TCM.SystemInfo, Data type=HTML

Bug, Solicitação de Revisão de Código, Solicitação de Comentários

Projeto de equipe

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

Reference name=System.TeamProject, Data type=String

All

Title

Uma breve descrição que resume o item de trabalho e ajuda os membros da equipe a diferenciá-lo de outras pessoas.

Reference name=System.Title, Data type=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, confira 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.

Reference name=System.WorkItemType, Data type=String

All

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

Se você tiver o Azure Boards MCP Server conectado ao seu agente de IA no modo de operação do agente, poderá usar comandos de linguagem natural para localizar 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'
Localizar campos vazios Show user stories with empty acceptance criteria
Consulta por intervalo de ID Find work items with IDs between 5000 and 5100
Localizar 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
Procurar etapas de reprodução Find bugs in <Contoso> whose repro steps mention "intermittent" or "random"
Localizar padrões de nomenclatura List work items in <Contoso> whose title starts with "[SPIKE]" or "[POC]"
Identificar possíveis duplicatas Show pairs of active bugs in <Contoso> that have similar titles
Examinar 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 de agente e o servidor MCP usam linguagem natural, para que você possa ajustar esses prompts ou fazer perguntas de acompanhamento para refinar os resultados.

Conteúdo relacionado

API REST

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

  • Last updated on