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.
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.
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".
Aqui está outro exemplo que usa o nome do nó e o operador In .
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.
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.
Artigos relacionados
- Referência de consulta rápida
- Definir caminhos de área e atribuir a uma equipa
- Definir caminhos de iteração (sprint) e configurar iterações de equipe
- Definir permissões e acesso para acompanhamento de trabalho
API REST
Para interagir programaticamente com consultas, consulte um destes recursos da API REST: