Partilhar via


Consulta por área ou caminho de iteração

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

O Caminho da Área e o Caminho da Iteração são dois campos que aparecem no formulário de acompanhamento de trabalho para todos os tipos de item de trabalho. Você os define para um projeto — caminhos de área e caminhos de iteração — e, em seguida, seleciona aqueles que deseja associar a uma equipe.

Para entender melhor como trabalhar com caminhos de área e iteração, consulte Sobre equipes e ferramentas ágeis.

Nota

As seguintes macros só são suportadas a partir do portal 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.

Operadores e macros suportados

Ao criar consultas e especificar os campos Caminho da Área e Caminho da Iteração, você pode usar os seguintes operadores:

Operador Use quando quiser...
= Especificar uma área específica ou caminho de iteração
<> Filtre uma área específica ou caminho de iteração.
In Filtre um conjunto de caminhos de área ou iteração.
Not In Exclua itens atribuídos a um conjunto de caminhos de área ou iteração.
Under Especifique todos os caminhos em uma área de seleção ou caminho de iteração.
Not Under Excluir itens atribuídos em uma área específica ou caminho de iteração.

Junto com esses operadores, você pode usar as macros a seguir ao selecionar o caminho de iteração. Para obter exemplos, consulte Consulta por data ou iteração atual.

Macro Use quando quiser...
@CurrentIteration Especifique a iteração atual associada ao contexto da equipe selecionada.
@CurrentIteration +/- n Filtre itens com base na atribuição a uma janela deslizante de sprints associados ao contexto da equipe selecionada.
@TeamAreas Filtre itens com base no(s) caminho(s) de área atribuído(s) a uma equipe específica.

Nota

As macros e @TeamAreas têm suporte para o @CurrentIteration +/- n Azure DevOps Server 2019 e versões posteriores. Essas macros só são suportadas a partir do portal da Web. As consultas que contêm essas macros não funcionarão quando abertas no Visual Studio/Team Explorer, Microsoft Excel ou Microsoft Project.

Consultas de caminho de área

Você pode especificar para filtrar itens de trabalho atribuídos a vários caminhos de área usando o operador In , conforme mostrado no exemplo a seguir.

Consulta no caminho da área para várias áreas

Nome do nó e consultas baseadas em palavras-chave

Use o campo Nome do nó para filtrar itens de trabalho atribuídos a caminhos de área com base em uma palavra-chave usando o operador Contém . O Nome do Nó especifica o último nó de um Caminho de Área, que corresponde ao último nó na hierarquia da árvore.

A consulta a seguir produz o mesmo resultado do exemplo anterior.

Consulta no nome do nó para várias áreas

Neste exemplo, o filtro retorna todos os itens de trabalho atribuídos a um caminho de área cujo último nó contém a palavra "Azure".

Consulta de vários sprints

Aqui está outro exemplo que usa o nome do nó e o operador In .

Consulta no nome do nó para várias áreas

Consultas de caminho de área da equipe

Use a macro @TeamAreas para localizar rapidamente os itens atribuídos aos caminhos de área atribuídos a uma equipe específica. Especifique o = operador. O Editor de Consultas solicita automaticamente que você insira o nome da equipe. Você pode adicioná-lo digitando o nome da equipe e escolhendo o valor da equipe que aparece nos critérios do filtro de pesquisa.

Consulta sobre caminhos de área atribuídos a uma equipe

Referência do campo de classificação

Nome do campo Descrição Nome de referência
Caminho da Área Agrupa itens de trabalho em recursos de produto ou áreas de equipe. A área deve ser um nó válido na hierarquia do projeto. System.AreaPath
Caminho de iteração Agrupa itens de trabalho por sprints nomeados ou períodos de tempo. A iteração deve ser um nó válido na hierarquia do projeto. System.IterationPath

Para cada campo, data path=TreePath, reportable type=Dimension, index attribute=True.

Se você definir um nome de caminho com mais de 256 caracteres, não poderá especificá-lo no Microsoft Project. Para evitar esse problema, defina nomes de caminho de no máximo 10 caracteres e não aninhar nós com mais de 14 níveis de profundidade.

Não é possível aplicar a maioria das regras de campo aos campos do sistema, como os campos System.AreaPath e System.IterationPath. Para obter mais informações, consulte Avaliação de regras e regras.

Os campos a seguir não aparecem em formulários de item de trabalho, mas são rastreados para cada tipo de item de trabalho. Esses campos fornecem um valor numérico para cada valor de classificação definido para um projeto. Você pode usar esses campos para filtrar consultas e criar relatórios.

Nome do campo Descrição Nome de referência Tipo de dados
ID da área A ID exclusiva da área à qual este item de trabalho é atribuído. System.AreaId Número inteiro
ID da iteração A ID exclusiva da iteração à qual este item de trabalho é atribuído. System.IterationId Número inteiro
Nome do Nó O nome do último nó de um caminho de área. Por exemplo, se o caminho da área for Project\A1\B2\C3, o nome do nó será C3. System.NodeName String

O tipo relatável padrão é nenhum. ID de área e ID de iteração são indexados, Nome do nó não. Para saber mais sobre atributos de campo, consulte Campos e atributos de item de trabalho.

API REST

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