Consultar por caminho de iteração ou área

  • Artigo

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

Caminho de Área e Caminho de Iteração são dois campos que aparecem no formulário de acompanhamento de trabalho para todos os tipos de item de trabalho. Defina-os para um projeto — caminhos de área e caminhos de iteração — e selecione os que deseja associar a uma equipe.

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

Observação

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.

Operadores e macros com suporte

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

Operador Use quando desejar...
= Especificar um caminho de iteração ou área específico
<> Filtrar um caminho de iteração ou área específico.
In Filtrar um conjunto de caminhos de área ou iteração.
Not In Excluir itens atribuídos a um conjunto de caminhos de área ou iteração.
Under Especificar todos os caminhos em um caminho de área ou iteração selecionado.
Not Under Excluir itens atribuídos em um caminho de área ou iteração específico.

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

Macro Use quando desejar...
@CurrentIteration Especificar a iteração atual associada ao contexto de equipe selecionado.
@CurrentIteration +/- n Filtrar itens com base na atribuição a uma janela deslizante de sprints associada ao contexto de equipe selecionado.
@TeamAreas Filtrar itens com base nos caminhos de área atribuídos a uma equipe específica.

Observação

As macros @CurrentIteration +/- n e @TeamAreas têm suporte do Azure DevOps Server 2019 e de versões posteriores. Essas macros de consulta só têm suporte no 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 optar por filtrar itens de trabalho atribuídos a vários caminhos de área usando o operador In , conforme mostrado no exemplo a seguir.

Consulta de Caminho da Área para várias áreas

Consultas baseadas em nome do nó e palavra-chave

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

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

Consulta de 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 para vários sprints

Aqui está outro exemplo que usa o Nome do Nó e o operador In.

Consulta de 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 inserindo o nome da equipe e escolhendo o valor da equipe que aparece nos critérios de filtro de pesquisa.

Consulta em caminhos de área atribuídos às equipes

Referência de campo de classificação

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

Para cada campo, caminho de dados =TreePath, tipo relatável =Dimension, atributo de índice =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 com, no máximo, 10 caracteres, e não aninhe nós com mais de 14 níveis de profundidade.

Você não pode aplicar a maioria das regras de campo a campos do sistema, como os campos System.AreaPath e System.IterationPath. Para obter mais informações, consulte Regras e avaliação de 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 Data type
ID de área A ID exclusiva da área à qual este item de trabalho é atribuído. System.AreaId Integer
ID da Iteração A ID exclusiva da iteração à qual este item de trabalho é atribuído. System.IterationId Integer
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 reportável padrão é nenhum. A ID da área e a ID da iteração são indexadas, o Nome do Nó não é. Para saber mais sobre atributos de campo, confira Campos e atributos de item de trabalho.

API REST

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