Compartilhar via

Consultar por caminho de iteração ou área

Azure DevOps Services | 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. Defina esses caminhos para seu projeto, caminhos de área e caminhos de iteração, e selecione os que deseja associar a uma equipe.

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

Prerequisites

Category Requirements
Níveis de acesso – Para exibir e executar consultas compartilhadas: membro do projeto.
– Para adicionar e salvar uma consulta compartilhada: no mínimo, acesso Básico.
Permissions Permissão Contribuir definida como Permitir para a pasta à qual você deseja adicionar uma consulta. Por padrão, o grupo Contribuidores não tem essa permissão.

Note

Os usuários com acesso de Stakeholders para um projeto público têm acesso completo aos recursos de consultas, assim como os usuários com acesso Básico. Para mais informações, veja Referência rápida de acesso das partes interessadas.

Category Requirements
Níveis de acesso – Para exibir e executar consultas compartilhadas: membro do projeto.
- Para adicionar e salvar uma consulta compartilhada: é necessário pelo menos acesso básico .
Permissions Permissão Contribuir definida como Permitir para a pasta à qual você deseja adicionar uma consulta. Por padrão, o grupo Contribuidores não tem essa permissão.

Note

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 da Área e Caminho da Iteração, você pode usar os seguintes operadores:

Operator Use quando desejar...
= Especificar um caminho de iteração ou área específico
<> Filtrar uma área ou caminho de iteração específico
In Filtrar um grupo de caminhos de área ou de 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 ou caminho de iteração selecionado
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 da Iteração. Para obter exemplos, consulte os exemplos de consulta nesta página.

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

Note

O portal da 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 WIQL/REST diretas 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 você precisar usar consultas fora da interface do usuário da Web.

Consultas de caminho 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 tela que mostra uma consulta de Caminho da Área para diferentes á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 uma 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 produz o mesmo resultado do exemplo anterior.

Captura de tela 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 último nó contém a palavra "Azure".

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

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

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

Consultas de caminho de área da equipe

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 sugerida.

Captura de tela que mostra uma consulta em caminhos de área atribuídos a uma equipe.

Referência de campo de classificação

Nome do campo Description Nome da referência
Caminho da á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 da 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 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 definido para um projeto. Você pode usar esses campos para filtrar consultas e criar relatórios.

Nome do campo Description Nome da referência Tipo de dado
ID da área A ID exclusiva da área em que você atribui este item de trabalho. System.AreaId Integer
ID da iteração A ID exclusiva da iteração em que 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 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 têm índices. O nome do nó não está definido. Para saber mais sobre os atributos dos campos, veja Campos de item de trabalho e atributos.

Conteúdo relacionado

API REST

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

  • Last updated on