Compartilhar via


Usar um índice para consultar dados de referência rápida no Azure Boards 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, confira 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 critérios a seguir...


Palavras-chave, consultas curinga

Consultas baseadas em marca

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 consulta



Operadores e macros com suporte para cada tipo de dados

A tabela a seguir indica os operadores e as macros disponíveis para os diferentes tipos de dados de campo. Cada campo é 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 do 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, confira Campos de consulta, operadores e macros.

Observação

As macros a seguir só têm suporte no portal da 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.

Data type

Descrição

Operadores e macros com suporte

Booliano

Dá suporte a um valor True/False. Exemplos de consulta: consultar 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. Insira datas no Padrão de Data definido para seu perfil pessoal. Confira Definir preferências pessoais para obter detalhes.

Para obter exemplos de consulta, confira Consulta 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 com suporte no Azure DevOps 2019 Atualização 1 e versões posteriores::
@StartOfDay, @StartOfWeek, @StartOfMonth e @StartOfYear, válido com qualquer campo DateTime

Double

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

Exemplos de consulta: consultar 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 acompanhar informações históricas e atribuído somente ao campo Histórico.

Exemplos de consulta: histórico e auditoria.

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

HTML

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

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

Identidade

Um campo Cadeia de caracteres que é usado para manter uma identidade de usuário. Exemplos de consulta: consultar 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álido para todos os campos de identidade.

Inteiro

Também inclui picklistInteger1. Um número inteiro de 32 bits com sinal, como 0, 1, 2 ou 34.

Exemplos de consulta: consultar 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.

PlainText

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

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

Cadeia de caracteres

Também inclui picklistString1. Texto de linha única curto que contém até 255 caracteres Unicode. Os campos de cadeia de caracteres dão suporte ao campo Título, listas de seleção (menus suspensos), contas de usuário, Marcas e outros campos.

Exemplos de consulta: consultar por títulos, IDs e campos de rich text e Consultar por valor de lista de seleção.

= , <> , > , < , >= , <= , =[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 Tipo de Item de Trabalho@Project, válido com o campo Projeto de Equipe.

TreePath

Tipo de campo que dá suporte aos campos Caminho da Área e Caminho de Iteração. Você define a estrutura de árvore para um projeto – caminhos de área e caminhos de iteração.

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

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

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

Observação

  1. Os tipos de dados lista de seleção... 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 Is Empty e Is Not Empty têm suporte para o Azure DevOps Server RC2 de 2019 e versões posteriores.
  3. A macro @TeamAreas tem suporte para o Azure Boards e o Azure DevOps Server 2019 e versões posteriores.
  4. A macro @CurrentIteration +/- n tem suporte para o Azure DevOps Server 2019 e versões posteriores e somente quando executada no portal da Web.

Padrão de data e hora

O padrão de data e hora inserido para campos DateTime deve corresponder ao selecionado em seu perfil. Para exibir ou alterar sua seleção, consulte Definir preferências do usuário.

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

Exemplo de consultas para campos selecionados

A tabela a seguir lista campos de consulta comuns e seu tipo de dados para os quais as consultas de exemplo são fornecidas. Para determinar o tipo de dados de um campo, confira Campos e atributos de item de trabalho, Atributos de campo de lista.

Um

B

C

D-E-F

H-P

R

S

T

V-W