Definir os percursos de área e atribuí-los a uma equipa

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

Adicione caminhos de área para organizar equipes e agrupar itens de trabalho por produto, recurso ou áreas de negócios. A atribuição de caminhos de área às equipes garante que os itens de trabalho sob esses caminhos apareçam nas listas de pendências e quadros da respetiva equipe. Por padrão, todos os itens de trabalho são atribuídos ao caminho da área raiz e aparecem na equipe padrão do projeto.

Depois de definir caminhos de área no nível do projeto, atribua-os às equipes dentro da configuração da equipe. Você também pode criar uma estrutura hierárquica de percursos de área para suportar subáreas, com até 14 níveis de profundidade.

Para executar as seguintes tarefas, você deve definir caminhos de área:

Tip

Pode definir a sua estrutura de percursos de área e atribuir percursos de área às equipas. Você também pode adicionar uma equipe e criar o caminho da área com o nome da equipe ao mesmo tempo. Se as equipes forem totalmente independentes, crie um conjunto plano de caminhos de área. Para criar uma hierarquia de equipas, crie uma estrutura em árvore dos percursos de área. Para obter mais informações, consulte Configurar uma hierarquia de equipes.

Para usar as seguintes ferramentas, as equipas devem inscrever-se nos percursos de área.

Para entender como o sistema usa caminhos de área, consulte Sobre caminhos de área e iteração.

Prerequisites

Category	Requirements
Permissions	- Para definir a área de equipa ou os caminhos de iteração: administrador de equipa ou um membro do grupo Administradores de Projeto. Por padrão, o usuário que criou o projeto tem essas permissões. - Para adicionar um caminho de área sob o nó raiz ou editar ou excluir qualquer nó filho: Membro do grupo Administradores de Projeto. - Para adicionar, editar e gerenciar caminhos de área sob um nó: Uma ou mais das seguintes permissões definidas como Permitir: - Criar subnós - Excluir este nó - Editar este nó - Visualizar permissões neste nó

Introdução

Cada equipe tem acesso a várias ferramentas ágeis, conforme descrito em Sobre equipes e ferramentas ágeis. Essas ferramentas fazem referência aos caminhos de área padrão da equipe. A maioria das equipes usa um caminho de área e vários caminhos de iteração para acompanhamento de trabalho, mas as equipes também podem usar vários caminhos de área nas suas listas de pendências e quadros de tarefas para dar suporte a diferentes cenários.

Novos projetos incluem uma única área raiz correspondente ao nome do projeto e uma equipe padrão com o mesmo nome atribuído a esse caminho de área raiz.

Se você é novo no gerenciamento de projetos e equipes, siga estas etapas para configurar seu projeto e equipes:

Definir percursos de área: Determine o número e os nomes dos percursos de área necessários para categorizar o seu trabalho. Adicione pelo menos um caminho de área por equipe. Para obter mais informações, consulte Sobre áreas e iterações.
Definir equipas: Decida o número e os nomes das equipas necessárias. Para obter mais informações, consulte Sobre equipes e ferramentas ágeis.
Configurar caminhos de áreas: Vá para Definições do projeto>Configuração do projeto>Áreas e defina os caminhos de áreas para o seu projeto. Siga as etapas em Adicionar os caminhos de área.
Criar equipas: Crie as equipas necessárias com base no passo 2. Para obter mais informações, consulte Adicionar uma equipe, mover de uma equipe padrão para várias equipes.
Atribuir caminhos de área às equipes: na configuração da equipe, atribua os caminhos padrão e outros caminhos de área a cada equipe. Execute as etapas em Definir caminhos de área padrão da equipe.
Atribuir caminhos de área a itens de trabalho: atribua itens de trabalho aos caminhos de área definidos usando modificar em massa para atualizar vários itens de uma só vez.

Note

Atribuir o mesmo caminho de área a várias equipas de trabalho poderá causar conflitos sobre a propriedade dos itens de trabalho e pode levar a comportamentos inesperados nos quadros das equipas. Para obter mais informações, consulte Limitações de vistas de quadro multi-equipa.

Conforme necessário, você pode executar as seguintes ações a qualquer momento:

Adicionar outros nós filho
Renomear um caminho de área (exceto o caminho de área raiz)
Mover um nó filho para outro nó
Excluir um nó filho
Renomear uma equipe
Alterar as atribuições de caminho de área feitas a uma equipe

Listar áreas do projeto

Para listar áreas do projeto, execute as seguintes etapas:

Browser
CLI do Azure DevOps

No seu portal da Web, selecione (1) Configurações> do projeto (2) Configuração do> projeto (3) Áreas.

A captura de tela mostra seleções, configurações do projeto, configuração do projeto.

Pode listar caminhos de área definidos para um projeto usando o comando az boards area project list . Para começar com a CLI, veja Começar com Azure DevOps CLI.

az boards area project list [--depth]
                            [--path]
                            [--project]

Parameters

profundidade: Opcional. Profundidade dos nós crianças a serem listados. Exemplo: --depth 3. Na ausência de especificação, apenas os caminhos de área de nível superior são retornados.
caminho: Opcional. Caminho absoluto de uma área. \Area\ deve seguir após o \ProjectName, que distingue este caminho de um caminho de iteração. Por exemplo, --path \ProjectName\Area\AreaName. Se os espaços forem usados dentro de um nó, coloque-os entre aspas duplas, por exemplo, --path "\Fabrikam Fiber\Area\Service Delivery\Performance". Quando não especificado, lista os caminhos de área a partir do nível raiz.
projeto: Opcional. Nome ou ID do projeto. Exemplo: --project "Fabrikam Fiber".

Example

Por exemplo, o comando a seguir lista os percursos de área até uma profundidade de 3 para o projeto Fabrikam Fiber. Para outras opções de formato de saída, consulte Formatos de saída para comandos da CLI do Azure.

az boards area project list --depth 3 --project 'Fabrikam Fiber' --output table
ID     Identifier                            Name                Path                                                Has Children
-----  ------------------------------------  ------------------  --------------------------------------------------  --------------
55302  91d8644a-e430-4fd0-aa95-742ea98770a3  Fabrikam Fiber      \Fabrikam Fiber\Area                                True
55373  26be05fd-e68a-4fcb-833f-497f6bee45f2  Service Delivery    \Fabrikam Fiber\Area\Service Delivery               True
55303  637dc203-0549-4415-9663-b6358ac27d21  Internet            \Fabrikam Fiber\Area\Service Delivery\Internet      False
55306  3f2067f9-684f-4121-8004-4a4745198b39  Voice               \Fabrikam Fiber\Area\Service Delivery\Voice         False
55372  4afc9ede-db1d-4703-8be6-95899b99be44  Email               \Fabrikam Fiber\Area\Service Delivery\Email         False
55381  f96d4738-c67e-42d0-bd4e-99f6b3fdeb22  Service Status      \Fabrikam Fiber\Area\Service Delivery\Service S...  False
55384  3a0c1189-6454-4ccd-9354-d72b653b7f74  TV                  \Fabrikam Fiber\Area\Service Delivery\TV            False
55380  4ea27e90-248c-41a0-8d11-eace6c9fd90e  Account Management  \Fabrikam Fiber\Area\Account Management             True
55382  4235f40d-753b-49dd-868f-82372065ec83  Shopping Cart       \Fabrikam Fiber\Area\Account Management\Shoppin...  False
55383  49d34650-6c65-446c-aff6-79edd3a21a75  Customer Profile    \Fabrikam Fiber\Area\Account Management\Custome...  False

Os comandos da CLI do Azure DevOps não são suportados para o Servidor de DevOps do Azure.

Adicionar um caminho de área

Apenas uma área raiz é definida por padrão. Adicione novos caminhos de área e caminhos de subárea sob o caminho de área raiz do projeto, ou como subárea de outro caminho de área ou equipa. Novos caminhos de área são adicionados ao nó raiz por padrão.

A captura de tela mostra Áreas, padrões definidos para o projeto.

Você também pode adicionar novos caminhos de área e subcaminhos a uma equipe. Para mais informações, consulte Configurar caminhos de área da equipa.

Browser
CLI do Azure DevOps

Para adicionar um novo caminho de área, execute as seguintes etapas:

Realce o caminho da área e, em seguida, escolha Novo filho. Alternativamente, pode selecionar um caminho de área e escolher Novo, ou selecionar o item do menu Novo no topo da lista de áreas.
Digite um nome (255 caracteres ou menos) para o nó. Para obter mais restrições de nome, consulte Sobre áreas e iterações, Restrições de nomenclatura.
Selecione Salvar e fechar

Todas as novas áreas são adicionadas como um nó filho ao caminho da área raiz.

Para adicionar um caminho de área filho, execute os seguintes passos:

Realce o caminho da área e, em seguida, escolha Novo filho. Alternativamente, pode selecionar o caminho da área e escolher Nova criança ou selecionar Nova criança no menu no topo da lista de áreas.
Digite um nome (255 caracteres ou menos) para o nó. Para obter mais restrições de nome, consulte Sobre áreas e iterações, Restrições de nomenclatura.
Selecione Salvar e fechar

Você também pode adicionar caminhos de área a uma equipa na página Configuração da Equipa>Áreas.

Você pode adicionar caminhos de área a um projeto usando az boards area project create. Para começar, consulte Introdução à CLI do Azure DevOps.

Se você especificar o --path parâmetro, o novo caminho de área será adicionado como um nó filho ao caminho especificado. Se você não especificar o --path parâmetro, o novo caminho de área será adicionado como um nó filho ao nó raiz.

az boards area project create --name
                              [--path]
                              [--project]

Parameters

nome: Obrigatório. Nome do caminho da área.
caminho: Opcional. Caminho absoluto de uma área. Exemplo: --path \ProjectName\Area\AreaName. Quando não especificado, adiciona uma área no nível da raiz.
projeto: Opcional. Nome ou ID do projeto. Exemplo: --project "Fabrikam Fiber".

Exemplo: formato JSON

Por exemplo, com o comando a seguir, adiciona-se o caminho da área "Voice" ao projeto Fabrikam Fiber no nó raiz.

az boards area project create --name Voice --project "Fabrikam Fiber"
{
  "attributes": null,
  "children": null,
  "hasChildren": false,
  "id": 55412,
  "identifier": "b00f86a2-3d49-4ad2-af01-da2537947baa",
  "name": "Voice",
  "path": "\\Fabrikam Fiber\\Area\\Voice",
  "structureType": "area",
  "url": "https://dev.azure.com/fabrikam/56af920d-393b-4236-9a07-24439ccaa85c/_apis/wit/classificationNodes/Areas/Voice"
}

Exemplo: formato de tabela

E, aqui está o mesmo comando com o formato de saída da tabela.

az boards area project create --name Voice --project "Fabrikam Fiber" --output table
ID     Identifier                            Name    Path                         Has Children
-----  ------------------------------------  ------  ---------------------------  --------------
55413  3c16691b-160c-4498-ab42-aa77b7f354fc  Voice  \Fabrikam Fiber\Area\Voice  False

Os comandos da CLI do Azure DevOps não são suportados para o Servidor de DevOps do Azure.

Listar caminhos da área da equipe

Você define os padrões da equipe nas configurações da equipe. Se tu não és um administrador de equipa, solicita ser adicionado. Somente os administradores de equipe ou projeto podem alterar as configurações da equipe.

Browser
CLI do Azure DevOps

Abra o seu projeto e, em seguida, selecione Definições do projeto>Configuração de equipa>Áreas.
Se você precisar mudar o contexto da equipe, use o seletor de equipe dentro da trilha de navegação.

Você pode listar os caminhos de área definidos para uma equipe usando az boards area team list. Para começar, consulte Introdução à CLI do Azure DevOps.

az boards area team list --team
                         [--project]

Parameters

equipa: Obrigatório. Nome ou ID da equipa.
projeto: Opcional. Nome ou ID do projeto. Exemplo: --project "Fabrikam Fiber".

Por exemplo, o comando a seguir lista os caminhos de área para a equipe de Prestação de Serviços. Para outras opções de formato de saída, consulte Formatos de saída para comandos da CLI do Azure

az boards area team list --team "Service Delivery" --project "Fabrikam Fiber" --output table
Area                             Include sub areas    Is Default
-------------------------------  -------------------  ------------
Fabrikam Fiber\Service Delivery  True                 True

Os comandos da CLI do Azure DevOps não são suportados para o Servidor de DevOps do Azure.

Abrir as definições da equipa a partir do perfil da equipa

Você define tanto as áreas quanto as iterações a partir de Configurações do Projeto > configuração da equipe. Você pode navegar rapidamente até ele a partir de uma lista de pendências, quadro ou painel de controle de trabalho em equipe.

Abra uma lista de pendências ou um quadro para uma equipa e escolha Perfil da equipa>Definições da equipa.

Aqui abrimos o Board para a equipe Fabrikam Fiber e a partir daí o perfil da equipe.
Escolha Iterações e áreas.
Se você precisar mudar o contexto da equipe, use o seletor de equipe dentro da trilha de navegação.

Definir caminhos de área de equipe

Todos os itens de trabalho atribuídos a um caminho de área de equipe aparecem nas listas de pendências e quadros dessa equipe. Você pode selecionar um ou mais caminhos de área e, opcionalmente, incluir seus caminhos de subárea. Opte por incluir caminhos de subáreas quando quiser suportar vistas agregadas do trabalho realizado em diversas equipes ou áreas.

Note

Pode ser atribuído um máximo de 300 Caminhos de Área às equipas para uma organização e desempenho eficientes do trabalho. Para mais informações sobre limites, consulte Acompanhamento de trabalho, limites de processos e projetos.

O caminho da área padrão determina o caminho da área padrão atribuído aos itens de trabalho criados a partir do contexto da equipe.

Important

Itens de trabalho que aparecem no quadro de mais do que uma equipa podem produzir resultados inesperados de consultas. Como cada equipa pode personalizar as suas colunas e corredores de piscina, os valores dos itens de trabalho podem variar entre diferentes quadros de equipa. Para evitar este problema, mantenha a propriedade única dos itens de trabalho, atribuindo-os a caminhos específicos das áreas da equipa.

Browser
CLI do Azure DevOps

Você pode selecionar caminhos de área existentes ou criar novos caminhos de área ou subcaminhos nas definições da equipa.

Selecione Definições do projeto>Configuração da equipa>Áreas.
Selecione a equipa que deseja configurar na lista pendente na parte superior da página.

Aqui, apresentamos as Áreas da equipa de Fibra da Fabrikam.
Escolha um ou mais caminhos de área para serem ativos para a equipa.

Neste caso, decidimos ativar os percursos da subárea para o projeto. A equipe de gerenciamento agora pode acompanhar o progresso em todas as equipes.
Assim que terminar, atualize a página da lista de pendências do produto para a equipa e verá os itens de trabalho atribuídos a essa equipa. Adicione o percurso da área às colunas exibidas para visualizar as atribuições feitas aos itens de trabalho.

Você pode definir o caminho de área padrão para uma equipe ou adicionar um caminho de área, usando az boards area team add. Para começar, consulte Introdução à CLI do Azure DevOps.

az boards area team add --path  --team
                        [--include-sub-areas {false, true}]
                        [--project]
                        [--set-as-default]

Parameters

caminho: Obrigatório. Caminho absoluto de uma área. Exemplo: --path \ProjectName\AreaName.
equipa: Obrigatório. Nome ou ID da equipa.
include-sub-areas: Opcional. Inclua subnós do trajeto da área. Valores aceites: falso, verdadeiro.
projeto: Opcional. Nome ou ID do projeto. Exemplo: --project "Fabrikam Fiber".
set-as-default: Opcional. Especifique como o caminho de área padrão para a equipa. Padrão: False.

Example

Por exemplo, o comando a seguir adiciona o caminho da área de voz à equipe de voz para o projeto Fabrikam Fibra, o define como padrão e inclui subáreas.

az boards area team add --path "\Fabrikam Fiber\Voice" --team Voice --project "Fabrikam Fiber" --include-sub-areas --set-as-default --include-sub-areas true --output table
Area                                   Include sub areas    Is Default
-------------------------------------  -------------------  ------------
Fabrikam Fiber\Service Delivery\Voice  False                False
Fabrikam Fiber\Voice                   True                 True

Os comandos da CLI do Azure DevOps não são suportados para o Servidor de DevOps do Azure.

Renomear ou mover um caminho de área

O sistema atualiza automaticamente itens de trabalho e consultas que fazem referência ao caminho da área atualizada. Cada Area Path está associado a um GUID único.

Browser
CLI do Azure DevOps

Para renomear um Caminho de Área, abra a página Definições do projeto>Configuração do projeto>Áreas no portal da web.
Escolha o menu de contexto do nó e selecione Editar.
Na caixa de diálogo que se abre, introduza o novo nome.
Para mover o nó dentro da hierarquia, altere a propriedade Localização.

Note

Ao renomear ou alterar o campo Local de um nó, o sistema atualiza automaticamente os itens de trabalho existentes que fazem referência à Área de Caminho.

Renomear ou mover um caminho de área de um projeto

Você pode renomear ou mover um caminho de área para um projeto, usando az boards area project update o comando. Para começar, consulte Introdução à CLI do Azure DevOps.

az boards area project update --path
                              [--child-id]
                              [--name]
                              [--project]

caminho: Obrigatório. Caminho absoluto de uma área. Exemplo: --path \ProjectName\AreaName.
child-id: Opcional. Move um caminho de área existente e o adiciona como um nó filho para o nome ou ID do caminho especificado.
nome: Opcional. Especifica o novo nome do caminho da área.
projeto: Opcional. Nome ou ID do projeto. Exemplo: --project "Fabrikam Fiber".

Example

Por exemplo, o seguinte comando renomeia o caminho da área Voice para Voice e Web para o projeto Fabrikam Fiber.

az boards area project update --path "\Fabrikam Fiber\Area\Voice" --name "Voice and Web" --project "Fabrikam Fiber" --output table
ID     Identifier                            Name           Path                                Has Children
-----  ------------------------------------  -------------  ----------------------------------  --------------
55412  b00f86a2-3d49-4ad2-af01-da2537947baa  Voice and Web  \Fabrikam Fiber\Area\Voice and Web  False

Remover um caminho de área de uma equipe

Para remover um caminho de área de uma equipe, use az boards area team remove.

az boards area team remove --path
                           --team
                           [--project]

Parameters

caminho: Obrigatório. Caminho absoluto de uma área. Exemplo: --path \ProjectName\AreaName.
equipa: Obrigatório. Nome ou ID da equipa.
projeto: Opcional. Nome ou ID do projeto. Exemplo: --project "Fabrikam Fiber".

Example

Por exemplo, o comando a seguir remove o caminho da área \Service Delivery\Voice da equipe de Voz do projeto Fabrikam Fibra.

az boards area team remove --path "\Fabrikam Fiber\Service Delivery\Voice" --team Voice --project "Fabrikam Fiber" --output table

Os comandos da CLI do Azure DevOps não são suportados para o Servidor de DevOps do Azure.

Excluir um caminho de área

Ao excluir um Caminho de Área, você deve fornecer um Caminho de Área a ser usado para atualizar os itens de trabalho atribuídos ao Caminho de Área que deseja excluir.

Important

A exclusão de valores de Caminho de Área ou a reconfiguração de valores de Caminho de Iteração causa perda irreversível de dados nos seguintes gráficos:

Gráficos de "Burndown" e "Burn Up" de widgets
Gráficos de Burndown do Sprint
Gráficos de velocidade para equipas com percursos de área alterados
Gráficos de tendência históricos que fazem referência aos valores de Caminho de Área e Caminho de Iteração , conforme definido no momento para cada item de trabalho

Você pode excluir caminhos de área e iteração somente quando eles não forem mais usados por nenhum item de trabalho. Ao excluir esses caminhos, não é mais possível recuperar seus dados históricos.

Para excluir um Caminho de Área, abra a página Definições do projeto>Configuração do projeto>Áreas no portal da Web.
Escolha o menu de contexto do nó e selecione Apagar ou Remover.
Na caixa de diálogo que se abre, selecione o Caminho da Área ao qual reatribuir itens de trabalho, e depois escolha Excluir caminho.

Progresso do gráfico por área

Você pode gerar consultas rapidamente para exibir o progresso com base em um caminho de área. Por exemplo, visualize o progresso dos itens de trabalho atribuídos ao caminho de área de cada equipe, conforme mostrado no gráfico de barras empilhadas a seguir. Escolha "Nome do Nó" para obter o nó folha do caminho da área.

A captura de tela mostra o gráfico de barras empilhadas por área e estado.

Próximos passos

Definir caminhos de iteração ou sprints

Como pode observar, os caminhos de área desempenham um papel importante no suporte a ferramentas Agile, equipas e gestão de tarefas. Saiba mais sobre como trabalhar com esses campos nos seguintes artigos:

Recursos programáticos

Caminhos de área e caminhos de iteração também são referidos como Nós de Classificação.

Utilize a área dos boards az (CLI do Azure DevOps).
Use o Teams (API REST) para gerenciar configurações de equipe.
Utilize os nós de classificação (API REST) para organizar classificações de item de trabalho.

Use o Teams (API REST) para gerenciar configurações de equipe.
Utilize os nós de classificação (API REST) para organizar classificações de item de trabalho.
Configure o processo definindo o plug-in de classificação (Modelo de Processo).

Feedback

Esta página foi útil?

Last updated on 2025-12-22

Partilhar via

Definir os percursos de área e atribuí-los a uma equipa

Prerequisites

Introdução

Listar áreas do projeto

Adicionar um caminho de área

Listar caminhos da área da equipe

Abrir as definições da equipa a partir do perfil da equipa

Definir caminhos de área de equipe

Renomear ou mover um caminho de área

Excluir um caminho de área

Progresso do gráfico por área

Próximos passos

Conteúdo relacionado

Recursos programáticos

Feedback

Recursos adicionais