Partilhar via

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

Serviços de DevOps do Azure | 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.

Prerequisites

Category Requirements
Níveis de acesso - Para visualizar e executar consultas compartilhadas: Membro do Projeto.
- Para adicionar e guardar uma consulta compartilhada: Pelo menos acesso básico .
Permissions permissão Contribute 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 utilizadores com acesso Stakeholder para um projeto público têm acesso total às funcionalidades de consulta, assim como os utilizadores com acesso Basic. Para obter mais informações, consulte Acesso dos intervenientes - referência rápida.

Category Requirements
Níveis de acesso - Para visualizar e executar consultas compartilhadas: Membro do Projeto.
- Para adicionar e salvar uma consulta compartilhada: É necessário pelo menos acesso básico.
Permissions permissão Contribute 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 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 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 com ambos os campos.

Note

  1. Os operadores Is Empty e Is Not Empty têm suporte para o 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 é salvo em um campo de texto longo, o 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 tela que mostra o Editor de Consultas 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 de valor de campo 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 essa solicitação de recurso, visite Comunidade de desenvolvedores: ser capaz de pesquisar tags 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 com ID na cláusula de consulta @Follows

Consulta de atividade recente de item 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 a consulta de macro ID In @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 obter detalhes e requisitos de servidor/agrupamento aplicáveis ao Azure DevOps local, consulte Campos de consulta, operadores, valores e variáveis - Texto completo e pesquisas parciais de palavras.

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

Conteúdo relacionado

API REST

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

  • Last updated on