Compartilhar via

Consulta por data ou iteração atual

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

Este artigo mostra como listar itens de trabalho por criação, alteração, resolução ou datas fechadas e como usar macros de data (por exemplo) @Todaye macros de iteração para sprints de equipe. Para obter conceitos básicos do caminho de iteração e restrições de cliente ou macro, consulte Consultar por área ou caminho de iteração.

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.
Permissions 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 mais informações, veja Referência rápida de acesso das 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.
Permissions 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 de data suportados

Use os seguintes operadores e macros para campos DateTime e Caminho de Iteração no Editor de Consultas.

  • Operadores DateTime: = , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
  • Macros de data: @StartOfDay, , @StartOfWeek, @StartOfMonth, , @StartOfYear@Today
    Você pode combinar +/- n com essas macros (por exemplo, @Today - 7).
  • Macros de iteração: @CurrentIteration e @CurrentIteration +/- n (consulte a seguinte observação e link para restrições de cliente e comportamento de parâmetro de equipe).

Note

As macros de iteração e as restrições do cliente são abordadas detalhadamente na página de iteração: Consulta por área ou caminho de iteração. Se você precisar de consultas para executar em clientes que não são da web ou por meio de REST/WIQL fora da interface do usuário da Web, verifique o suporte à macro em seu ambiente e considere expandir macros para caminhos explícitos.

Exemplos de data rápida (consultas comuns)

  • Itens criados nos últimos 30 dias: captura de tela que mostra a cláusula Editor de Consultas para localizar itens criados nos últimos 30 dias.

  • Itens modificados em uma data específica: captura de tela que mostra a cláusula Editor de Consultas para localizar itens alterados em uma data específica.

  • Itens resolvidos hoje: captura de tela que mostra a cláusula Editor de Consultas para localizar itens resolvidos hoje.

  • Itens fechados em um período de tempo especificado: captura de tela que mostra a cláusula Editor de Consultas para localizar itens fechados dentro de um período de tempo especificado.

  • Itens cuja Data Fechada é nula (não fechada): captura de tela que mostra a cláusula Editor de Consultas para localizar itens cuja Data Fechada está vazia ou nula.

  • Itens cujo status foi alterado na última semana: captura de tela que mostra a cláusula Editor de Consultas para itens cujo status foi atualizado na última semana.

Usando as @CurrentIteration macros (guia curto)

Use @CurrentIteration para focar no sprint atual da equipe e @CurrentIteration +/- n criar uma sequência deslizante de sprints (por exemplo, os dois últimos, o atual e os próximos dois sprints). Pontos importantes:

  • @CurrentIteration retorna itens atribuídos ao sprint atual para o contexto de equipe usado ao executar a consulta.
  • @CurrentIteration +/- n desloca a janela de sprints por n; útil para análises de tendência ou de continuidade.
  • Como o comportamento da macro e o suporte ao cliente variam, consulte Consulta por área ou caminho de iteração para obter detalhes sobre parâmetros de equipe, quais clientes avaliam macros e como as macros são armazenadas/expandidas ao salvar consultas.

Imagens de exemplo (Editor de Consultas do portal da Web):

Captura de tela que mostra o filtro Editor de Consultas usando a macro CurrentIteration com um parâmetro de equipe.

Captura de tela que mostra as cláusulas CurrentIteration plus e minus para uma janela deslizante de sprints.

Tip

Se @CurrentIteration não retornar os resultados esperados, confirme a iteração selecionada da equipe e os intervalos de datas da iteração nas configurações da Equipe.

Macros de data: início do dia/semana/mês/ano

O uso de macros do tipo "Start-of" ajuda a criar intervalos de datas relativas consistentes.

  • @StartOfDay, @StartOfWeek, @StartOfMonth, @StartOfYear – use essas macros com +/- n para criar intervalos como "desde o início da semana" ou "últimos 3 meses".
  • Essas macros são avaliadas pela interface do usuário do portal da Web; seu comportamento em cenários de não web pode ser diferente– teste em seu cliente de destino.

Consultas de exemplo:

Captura de tela que mostra as cláusulas do Editor de Consultas para localizar itens alterados nos últimos 10 dias.

Captura de tela que mostra as cláusulas do Editor de Consultas para recursos programados para serem concluídos nos próximos três meses.

Quando usar o WIQL diretamente

Use WIQL quando:

  • Você precisa de operadores avançados, como WAS EVER para alterações de caminho de iteração.
  • O Editor de Consultas bloqueia ou marca uma cláusula como não suportada (por exemplo, o uso de alguns Was Ever). A extensão editor WIQL permite criar essas consultas e salvá-las.

Consulte a sintaxe WIQL (Linguagem de Consulta de Item de Trabalho) e a extensão do marketplace do Editor WIQL para exemplos.

Conteúdo relacionado

API REST

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

  • Last updated on