Consultar por caminho de iteração ou área

Serviços Azure DevOps | 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.

Dica

Você pode usar a IA para ajudar nessa tarefa mais adiante neste artigo ou consulte Ativar a assistência de IA com o Azure DevOps Server MCP para começar.

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

Prerequisites

Category Requirements
Membro do projeto Você deve ser adicionado como membro do projeto.
Níveis de Acesso – Para exibir e executar consultas compartilhadas: você deve ser um membro Project.
- Para adicionar e salvar uma consulta compartilhada: você deve ter pelo menos acesso Básico.
Permissões Verifique se a permissão Contribuir está definida como Permitir para a pasta em que você deseja adicionar uma consulta. Talvez sua organização precise configurar manualmente o grupo Colaboradores para conceder essa permissão.

Note

Você precisa de um nível de acesso suficiente e permissão do Contribute para salvar consultas compartilhadas. O acesso básico não é suficiente.

Category Requirements
Membro do projeto Você deve ser adicionado como membro do projeto.
Níveis de Acesso – Para exibir e executar consultas compartilhadas: você deve ser um membro Project.
- Para adicionar e salvar uma consulta compartilhada: você deve ter pelo menos acesso Básico.
Permissões Verifique se a permissão Contribuir está definida como Permitir para a pasta em que você deseja adicionar uma consulta. Talvez sua organização precise configurar manualmente o grupo Colaboradores para conceder essa permissão.

Note

Você precisa de um nível de acesso suficiente e permissão do Contribute para salvar consultas compartilhadas. O acesso básico não é suficiente.

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 Azure DevOps avalia macros como @CurrentIteration, @CurrentIteration +/- n e @TeamAreas (Serviços e Servidor). Clientes não Web (Visual Studio/Team Explorer, Excel, Project) e chamadas WIQL/REST diretas exigem caminhos explícitos de área/iteração 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 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 ao 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 produz o mesmo resultado do exemplo anterior.

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

Neste exemplo, o filtro retorna os 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 diferentes á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 em 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 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.

Usar IA para consultar por área ou caminho de iteração

Se você tiver o Azure Boards MCP Server conectado ao seu agente de IA no modo de operação do agente, poderá usar prompts de linguagem natural para encontrar itens de trabalho por área ou caminho de iteração.

Tarefa Exemplo de prompt
Consultar por caminho de área List all active bugs under the area path <Contoso>\\Backend and its children
Localizar itens de iteração atuais Find work items assigned to the current iteration for my team
Verificar iterações passadas Show user stories in past iterations that are not yet closed
Consultar caminhos de áreas filho List all tasks under any child area path of <Contoso>\\Frontend
Comparar a velocidade entre as equipes Show the count of completed user stories per area path for the last 3 sprints in <Contoso>
Localizar itens de transferência List work items that were in the previous sprint for <Contoso> but are still active in the current sprint
Identifique trabalho não planejado Show work items added to the current sprint for <Contoso> after the sprint start date that aren't in any area path under <Contoso\\Planned>
Cobertura do caminho da área de auditoria List all area paths in <Contoso> that have zero active work items assigned
Comparação de sprint entre equipes For each area path under <Contoso>, show the count of active vs completed items in the current sprint
Planejar sprints futuros Show all work items in <Contoso> with iteration path set to a future sprint grouped by area path and priority

Note

O modo de agente e o servidor MCP usam linguagem natural, para que você possa ajustar esses prompts ou fazer perguntas de acompanhamento para refinar os resultados.

Conteúdo relacionado

API REST

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

  • Last updated on