Partilhar via


Usar um índice para consultar dados de referência rápida nos Painéis do Azure e no Azure DevOps

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Use esse índice para acessar rapidamente consultas de exemplo e informações sobre como abrir, definir e trabalhar com consultas. Para saber como usar o Editor de Consultas, consulte Definir uma consulta. Se você achar que suas consultas demoram muito para retornar resultados, consulte Definir uma consulta/Práticas recomendadas.

Consultas de exemplo

Você pode listar itens de trabalho com base nos seguintes critérios...


Palavras-chave, consultas curinga

Consultas baseadas em tags

Consultas de alteração de estado, motivo ou fluxo de trabalho

Consultas baseadas em data e iteração

Consultas de contagem de links e anexos


Tarefas de consultas



Operadores e macros suportados para cada tipo de dados

A tabela a seguir indica os operadores e macros disponíveis para os diferentes tipos de dados de campo. Cada campo está associado a um tipo de dados. Você pode encontrar o tipo de dados listado nas descrições de cada campo, que você pode pesquisar usando o índice de campo Item de trabalho. Os operadores disponíveis para definir uma cláusula de consulta dependem do tipo de dados do campo selecionado. Para obter descrições mais detalhadas de tipos de dados, operadores e macros, consulte Campos de consulta, operadores e macros.

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.

Tipo de dados

Descrição

Operadores e macros suportados

Booleano

Suporta um valor True/False. Exemplos de consulta: consulta por atribuição ou alterações de fluxo de trabalho.

= , <> , =[Field] , <>[Field]

DateTime

Um campo de data no qual você pode especificar uma variável, como @Today ou @Today-1, ou um valor, como 1/1/2012. Introduza datas no Padrão de Data que definiu para o seu perfil pessoal. Consulte Definir preferências pessoais para obter detalhes.

Para obter exemplos de consulta, consulte Consultar por data or@CurrentIteration.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
Macros: @Today, válido com qualquer campo DateTime

Macros adicionais suportadas no Azure DevOps 2019 Update 1 e versões posteriores::
@StartOfDay, @StartOfWeek, @StartOfMonth, e @StartOfYear, válido com qualquer campo DateTime

Duplo

Também conhecido como Decimal e inclui picklistDouble1. Um número real, como 0,2 ou 3,5.

Exemplos de consulta: consulta por campos numéricos.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

GUID

Uma cadeia de caracteres que representa uma ID exclusiva.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

Histórico

Campo formatado personalizado usado para rastrear informações históricas e atribuído apenas ao campo Histórico .

Exemplos de consulta: Histórico e auditoria.

Contém palavras, não contém palavras

HTML

Cadeias de texto que suportam descrições formatadas, como os campos Descrição ou Etapas de reprodução. Esses campos são indexados automaticamente para pesquisa de texto completo quando a pesquisa de texto completo está disponível. Exemplos de consulta: consulta por títulos, IDs e campos rich-text.

Contains Words, Does Not Contain Words, Is Empty2, Is Not Empty2

Identidade

Um campo String que é usado para manter uma identidade de usuário. Exemplos de consulta: consulta por atribuição ou alterações de fluxo de trabalho.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was EverMacros: @me válidas para todos os campos Identidade.

Inteiro

Também inclui picklistInteger1. Um inteiro de 32 bits assinado, como 0, 1, 2, 34.

Exemplos de consulta: consulta por campos numéricos

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

Macros: @Follows, , @MyRecentActivity@RecentMentions, e @RecentProjectActivity, válidas quando usadas com o campo ID.

Texto simples

Cadeias de texto de várias linhas que suportam descrições longas e são automaticamente indexadas para pesquisa de texto completo, quando a pesquisa de texto completo está disponível.
Exemplos de consulta: consulta por títulos, IDs e campos rich-text.

Contains Words, Does Not Contain Words, Is Empty, Is Not Empty

Cadeia

Também inclui picklistString1. Texto curto de linha única que pode conter até 255 caracteres Unicode. Os campos de cadeia de caracteres suportam o campo Título , listas de opções (menus suspensos), contas de usuário, tags e outros campos.

Exemplos de consulta: Consulta por títulos, IDs e campos rich-text e Consulta por valor da lista de opções.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was Ever

Macros: [Any], válido com o campo @ProjectTipo de Item de Trabalho , válido com o campo Projeto de Equipe.

TreePath

Tipo de campo que suporta os campos Caminho da Área e Caminho da Iteração. Você define a estrutura de árvore para um projeto — caminhos de área e caminhos de iteração.

Exemplos de consulta: Consulta por área ou caminho de iteração e Consulta por data ou iteração atual.

Under, Not Under, =, <>, In, Not In

Macros: @TeamAreas3, válidas com o campo Caminho da Área
@CurrentIteratione @CurrentIteration+/- n4 válido com o campo Caminho de Iteração

Nota

  1. Os tipos de dados da lista de opções... são atribuídos apenas a campos personalizados definidos para um processo herdado. O modelo de processo herdado só tem suporte para o Azure DevOps Server 2019 e versões posteriores.
  2. Os operadores e Is Not Empty têm suporte para o Is Empty Azure DevOps Server 2019 RC2 e versões posteriores.
  3. A @TeamAreas macro tem suporte para Azure Boards e Azure DevOps Server 2019 e versões posteriores.
  4. A @CurrentIteration +/- n macro tem suporte para o Azure DevOps Server 2019 e versões posteriores, e somente quando executada a partir do portal da Web.

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.

Captura de tela que mostra as opções suspensas Padrão de Data no painel Hora e Localidade.Captura de tela que mostra as opções suspensas Padrão de Tempo no painel Hora e Localidade.

Captura de tela que mostra o painel Hora e localidade com os campos Padrão de data e Padrão de hora.

Exemplos de consultas para campos selecionados

A tabela a seguir lista campos de consulta comuns e seus tipos de dados para os quais consultas de exemplo são fornecidas. Para determinar o tipo de dados de um campo, consulte Campos e atributos de item de trabalho, Listar atributos de campo.

A

N

C

D-E-F

H-P

R

S

T

V-W

  • Área do valor (String)
  • Tipo de item de trabalho (String)