Consulta por data ou iteração atual nos Painéis do Azure

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

Neste artigo, saiba como listar itens de trabalho com base em quando foram criados, fechados, resolvidos ou alterados. Você pode especificar uma data ou usar uma macro suportada. Use a @Today macro e especifique um número de dias para mais ou para menos para datas relativas. Para consultas que listam itens de trabalho com base em sua atribuição ao sprint atual de uma equipe, use @CurrentIteration.

Por exemplo, localize itens de trabalho que foram modificados nos últimos três dias com a consulta a seguir.

Operadores e macros suportados

As cláusulas de consulta que especificam um campo DateTime ou o campo Caminho de Iteração podem usar os operadores e macros listados na tabela a seguir.

Notas:

1. As macros , @StartOfWeek, @StartOfMonthe @StartOfYear são suportadas para o @StartOfDayAzure DevOps Server 2019.1 e versões posteriores. Eles só são suportados quando executados a partir do portal da Web.
2. A @CurrentIteration +/- n macro tem suporte para o Azure DevOps Server 2019 e versões posteriores. Só é suportado quando executado a partir do portal 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.

Restrições do cliente sobre o uso das @CurrentIteration macros

Você pode usar a @CurrentIteration macro em uma consulta dos seguintes clientes:

• Portal da Web que se conecta aos Painéis do Azure
• Visual Studio 2019 ou versões posteriores conectadas aos Painéis do Azure
• A API REST

Você pode usar a @CurrentIteration +/- n macro em uma consulta no Azure Boards, no Azure DevOps Server 2019 e em versões posteriores, e com uma API REST que inclui a equipe como parâmetro. Um exemplo é @CurrentIteration('[Project]\Team').

Um erro ocorre se você abrir uma consulta que contém a @CurrentIteration macro em versões anteriores do Visual Studio, ou do Microsoft Excel ou Microsoft Project. Além disso, você não pode usar a macro ao copiar ou clonar conjuntos de testes e casos de teste, definir alertas ou com APIs REST.

Consultas baseadas em data

Filtre os itens de trabalho pela data em que foram alterados ou por um período de tempo específico. Limite o âmbito da sua consulta. Essa abordagem pode ajudar no desempenho retornando apenas resultados que se ajustem ao intervalo de datas incluído. Se você é novo na criação de consultas, consulte Definir uma consulta de item de trabalho.

Nem todos os campos são válidos para todos os tipos de item de trabalho. Ir para campos de data para o conjunto de campos que você pode incluir em consultas e os tipos de item de trabalho aos quais eles se aplicam.

Criar consultas para a iteração atual da sua equipe

Se sua equipe segue processos Scrum, você agenda o trabalho para ser concluído em sprints. Você pode acompanhar o progresso de requisitos, bugs e outros trabalhos a serem concluídos no sprint atual usando a @CurrentIteration macro. Para obter mais informações, consulte Gerenciar cronogramas de sprint.

A consulta localiza qualquer item atribuído a um sprint que corresponda ao caminho de iteração atual para a equipe. Por exemplo, se uma equipe estiver no Sprint 5, a consulta retornará os itens atribuídos ao Sprint 5. Mais tarde, quando a equipe estiver trabalhando no Sprint 6, a mesma consulta retornará itens atribuídos ao Sprint 6.

Listar itens de trabalho movidos para fora de um sprint

Liste itens de trabalho que foram definidos para um sprint, mas posteriormente movidos para fora usando uma consulta com uma cláusula que contém o Was Ever operador para o campo Caminho de Iteração . Você só pode construir essa consulta usando a sintaxe WIQL. Edite a sintaxe WIQL no Editor de Consultas instalando a extensão WIQL Editor Marketplace.

Por exemplo, as seguintes consultas de sintaxe para itens de trabalho atendem aos seguintes critérios:

• Definido no projeto atual.
• O tipo de item de trabalho é igual a User Story ou Bug.
• Os itens de trabalho estão sob o Caminho de Área da equipe Web de Fibra da Fabrikam.
• Os itens de trabalho não estão em um Closedestado , Completed, Cutou Resolved .
• Não no caminho de iteração atual para a equipe da Web de fibra da Fabrikam.
• Foram atribuídos ao caminho de iteração atual para a equipe da Web de fibra da Fabrikam.
• Agora são atribuídos à iteração atual +1 para a equipe da Web de fibra da Fabrikam.
• Foram alterados nos últimos 30 dias (a duração do sprint).

SELECT
    [System.Id],
    [System.WorkItemType],
    [System.AssignedTo],
    [System.Title],
    [System.State],
    [System.Tags],
    [System.IterationPath],
    [System.AreaPath]
FROM workitems
WHERE
    [System.TeamProject] = @project
    AND [System.WorkItemType] IN ('User Story', 'Bug')
    AND [System.AreaPath] UNDER 'FabrikamFiber\Web'
    AND NOT [System.State] IN ('Completed', 'Closed', 'Cut', 'Resolved')
    AND NOT [System.IterationPath] = @currentIteration('[FabrikamFiber]\Web <id:cdf5e823-1179-4503-9fb1-a45e2c1bc6d4>')
    AND (
        EVER (
            [System.IterationPath] = @currentIteration('[FabrikamFiber]\Web <id:cdf5e823-1179-4503-9fb1-a45e2c1bc6d4>')
        )
        AND [System.IterationPath] = @currentIteration('[FabrikamFiber]\Web <id:cdf5e823-1179-4503-9fb1-a45e2c1bc6d4>') + 1
        AND [System.ChangedDate] >= @today - 30
    )
ORDER BY [System.Id]

O modo de exibição Editor de Consultas da sintaxe aparece conforme mostrado.

Listar itens de trabalho adicionados a um sprint após a data de início

Para listar itens de trabalho recém-criados adicionados a um sprint após sua data de início, use uma consulta semelhante à mostrada na imagem a seguir. Essa consulta funciona filtrando itens de trabalho atribuídos ao sprint atual, mas que foram criados após o início da data do sprint. Use a cláusula created Date = @Today - 28.

Para obter outras opções para consultar alterações no escopo da sprint, consulte Alteração do escopo da sprint.

Campos Data e Caminho de Iteração

Use campos Data para filtrar suas consultas. Alguns desses campos são preenchidos com informações à medida que um item de trabalho progride de um estado para outro. Vários desses campos não aparecem no formulário de item de trabalho, mas são rastreados para os tipos de item de trabalho listados na tabela a seguir.

Notas:

1. Consulte também Consulta por atribuição ou alterações de fluxo de trabalho.

2. Para que esses campos sejam definidos para um tipo de item de trabalho, eles devem ser incluídos na WORKFLOW seção da definição de tipo de item de trabalho. Por exemplo, essa sintaxe é incluída na definição durante a FIELDS transição para um Resolved estado.

   <FIELD refname="Microsoft.VSTS.Common.ResolvedDate" />  
      <SERVERDEFAULT from="clock"  />  
   </FIELD >  
   

3. Os valores de Data de Início e Data de Término são calculados se você criar um plano de projeto no Project e, em seguida, sincronizar esse plano com as tarefas armazenadas nos Painéis do Azure. Esses campos podem não aparecer no formulário de item de trabalho, mas são calculados para os itens da lista de pendências e as tarefas vinculadas aos itens da lista de pendências. Você pode exibir seus valores somente leitura nos resultados de uma consulta ou do Excel.

   Importante

   A integração com o Microsoft Project e o TFSFieldMapping comando não são suportados para:

   • Visual Studio 2019 e Azure DevOps Office Integration 2019.
   • Azure DevOps Server 2019 e versões posteriores, incluindo os Serviços de DevOps do Azure.

   O suporte total para integração com o Microsoft Excel é mantido, permitindo a importação em massa e atualização de itens de trabalho. As alternativas ao uso do Microsoft Project incluem:

   • Planos de Entrega
   • Extensões do Marketplace como o Project Connect ou o gráfico GANTT

Artigos relacionados

• Consulta por alterações na atribuição ou no fluxo de trabalho
• Definir caminhos de iteração (sprint) e configurar iterações de equipe
• Definir uma consulta de item de trabalho nos Painéis do Azure
• Campos de consulta, operadores e macros
• Campos e atributos do item de trabalho
• Sintaxe WIQL (Work Item Query Language)

API REST

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

• Referência da API REST dos Serviços de DevOps do Azure
• Consultas
• Linguagem de consulta de item de trabalho
• Buscar itens de trabalho com consultas programaticamente