Compartilhar via

Usar um índice para consultar dados de referência rápida

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

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

Consultas baseadas em identidade

Contagem de itens de trabalho e consultas de campo numérico

Consultas de histórico, discussão e alteração de revisão

Consultas de foco da equipe

Criar e testar consultas de campo

Other

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.

Note

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.

Tipo de dado

Description

Operadores e macros com suporte

Boolean

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

History

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 indexam automaticamente a 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 Empty2, Is Not Empty2

Identity

Um campo string que contém 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 Ever Macros: @me válido para todos os campos de identidade.

Integer

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 EmptyIs Not Empty

String

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, =, <>, , InNot In

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

Note

  1. O sistema atribui a lista de seleção... tipos de dados somente a campos personalizados definidos para um processo herdado. O modelo de processo herdado dá suporte ao Azure DevOps Services e ao Azure DevOps Server 2020 e versões posteriores.
  2. O Azure DevOps Services e o Azure DevOps Server 2020 e versões posteriores dão suporte aos operadores Is Empty e Is Not Empty.
  3. O Azure DevOps Services e o Azure DevOps Server 2020 e versões posteriores dão suporte à @TeamAreas macro.
  4. O Azure DevOps Services e o Azure DevOps Server 2020 e versões posteriores dão suporte à @CurrentIteration +/- n macro e somente quando você a executa 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.

A

B

C

D-E-F

H-P

R

S

T

V-W

Conteúdo relacionado

  • Last updated on