Partilhar via

Consulta por data ou iteração atual

Serviços de DevOps do Azure | 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, @Today) e macros de iteração para sprints de equipe. Para fundamentos de caminho de iteração e restrições de cliente/macro, consulte Consulta por área ou caminho de iteração.

Prerequisites

Category Requirements
Níveis de acesso - Para visualizar e executar consultas compartilhadas: Membro do Projeto.
- Para adicionar e salvar 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

Utilizadores com acesso Stakeholder num projeto público têm acesso total aos recursos de consulta, assim como os utilizadores com acesso Basic. Para obter mais informações, consulte Referência rápida de acesso de partes interessadas.

Category Requirements
Níveis de acesso - Para visualizar e executar consultas compartilhadas: Membro do Projeto.
- Para adicionar e salvar uma consulta partilhada: 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 suportados e macros de data

Use os seguintes operadores e macros para os 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 nota e link para restrições de cliente e comportamento de parâmetro de equipe).

Note

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

Exemplos de datas rápidas (consultas comuns)

  • Itens criados nos últimos 30 dias: captura de tela que mostra a cláusula do 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 do Editor de Consultas para localizar itens alterados em uma data específica.

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

  • Itens fechados dentro de um período de tempo especificado: captura de tela que mostra a cláusula do 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 do 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 do Editor de Consultas para itens cujo status foi atualizado na última semana.

Usando as @CurrentIteration macros (breve guia)

Use @CurrentIteration para direcionar o sprint atual da equipe e @CurrentIteration +/- n para criar uma janela deslizante de sprints (por exemplo, os dois últimos, os atuais 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 essa janela de sprints por n; útil para análises de tendências ou de transição.
  • Como o comportamento da macro e o suporte ao cliente variam, consulte Consulta por área ou caminho de iteração para obter detalhes sobre os parâmetros da equipe, quais clientes avaliam macros e como as macros são armazenadas/expandidas ao salvar consultas.

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

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

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

As macros de início ajudam a criar intervalos de datas relativos 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 não Web pode ser diferente — teste em seu cliente de destino.

Exemplos de consultas:

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 agendados para serem concluídos nos próximos três meses.

Quando usar WIQL diretamente

Utilizar 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, alguns Was Ever usos). A extensão WIQL Editor permite criar essas consultas e salvá-las.

Consulte a sintaxe WIQL (Work Item Query Language) e a extensão de mercado do Editor WIQL para obter exemplos.

Conteúdo relacionado

API REST

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

  • Last updated on