Partilhar via

Consulta por área ou caminho de iteração

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

Os campos Caminho da Área e Caminho da Iteração aparecem em todos os formulários de item de trabalho para cada tipo de item de trabalho. Você define esses caminhos para seu projeto — caminhos de área e caminhos de iteração — e, em seguida, seleciona aqueles que deseja associar a uma equipe.

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

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 A permissão Contribute definida como Permitir para a pasta à qual o utilizador deseja adicionar uma consulta. Por padrão, o grupo Colaboradores não tem essa permissão.

Note

Os utilizadores com acesso Stakeholder para um projeto público têm acesso total aos recursos de consulta, assim como os utilizadores com acesso Basic. Para obter mais informações, consulte Stakeholder access quick reference.

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 A permissão Contribute definida como Permitir para a pasta à qual o utilizador deseja adicionar uma consulta. Por padrão, o grupo Colaboradores não tem essa permissão.

Note

As seguintes macros só são suportadas a partir do portal Web: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivitye @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 campos Caminho de Área e Caminho de Iteração, você pode usar os seguintes operadores:

Operator Use quando quiser...
= Especificar uma área específica ou caminho de iteração
<> Filtrar uma área específica ou caminho de iteração
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 uma área selecionada ou caminho de iteração
Not Under Excluir itens atribuídos em uma área específica ou caminho de iteração

Você pode usar as macros a seguir ao selecionar o campo Caminho de iteração. Para obter exemplos, consulte os exemplos de consulta nesta página.

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

Note

O portal Web do Azure DevOps avalia macros como @CurrentIteration, @CurrentIteration +/- ne @TeamAreas (Serviços e Servidor). Clientes não Web (Visual Studio/Team Explorer, Excel, Project) e chamadas diretas WIQL/REST exigem caminhos de área/iteração explícitos e não aceitam tokens de macro brutos. Quando você salva uma consulta na interface do usuário da Web, o portal normalmente expande macros para valores concretos no WIQL armazenado — verifique esse comportamento em seu ambiente se precisar usar consultas fora da interface do usuário da Web.

Consultas de percurso de área

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

Captura de ecrã que exibe uma consulta no Caminho da Área para várias áreas.

Nome do nó e consultas baseadas em palavras-chave

Utilize o campo Nome do Nó para filtrar itens de trabalho atribuídos a caminhos de área com base numa palavra-chave, usando o operador Contém. 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 que o exemplo anterior.

Captura de ecrã que mostra uma consulta no Nome do Nó para várias áreas.

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

Captura de tela que mostra uma consulta para vários sprints.

Aqui está outro exemplo que usa o Node Name e o operador In.

Captura de ecrã que mostra uma consulta no Nome do Nó para várias áreas.

Consultas sobre caminhos da área de equipa

Use a macro @TeamAreas para localizar itens atribuídos aos caminhos de área que uma equipe específica usa. Especifique o operador =. O Editor de Consultas solicita que você insira o nome da equipe; Selecione a equipe na lista de sugestões.

Captura de ecrã que mostra uma consulta sobre caminhos de área atribuídos a uma equipa.

Referência do campo de classificação

Nome do campo Description Nome de referência
Caminho da Área Agrupa itens de trabalho em funcionalidades de produto ou áreas de equipa. A área deve ser um nó válido na hierarquia do projeto. System.AreaPath
Caminho de iteração Os itens de trabalho são agrupados 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, caminho de dados=TreePath, tipo reportá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 este problema, defina nomes de caminho com, no máximo, 10 caracteres e não aninhe nós a 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 Regras e avaliação de regras.

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

Nome do campo Description Nome de referência Tipo de dados
ID da área A ID exclusiva da área onde você atribui este item de trabalho. System.AreaId Integer
ID da iteração A ID exclusiva da iteração à qual você atribui este item de trabalho. System.IterationId Integer
Nome do nó O nome do último nó de um caminho de área. Por exemplo, se o caminho da área de projeto for Project\A1\B2\C3, o nome do nó será C3. System.NodeName String

O tipo de relatório padrão é nenhum. O ID de Área e o ID de Iteração têm índices. Nome do nó não está definido. Para saber mais sobre atributos de campo, consulte Campos e atributos de item de trabalho.

Conteúdo relacionado

API REST

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

  • Last updated on