Definir caminhos de área e atribuir a uma equipe

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

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 a equipes garante que os itens de trabalho nesses caminhos apareçam nas listas de pendências e nos quadros da respectiva equipe. Por padrão, todos os itens de trabalho são designados 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 caminhos de área para dar suporte a subáreas, com até 14 níveis de profundidade.

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

• Consultar e mapear itens de trabalho com base no Demarcador da Área
• Atribuir trabalho a mais de uma equipe
• Trabalhar com equipes de gerenciamento e de recursos
• Filtrar uma lista de pendências, uma consulta, uma placa ou um plano usando demarcadores de área

Dica

Você pode definir sua estrutura de demarcador de área e atribuir demarcadores de área às equipes. Ou você pode adicionar uma equipe e criar o demarcador da área com o nome da equipe naquele momento. Se as equipes forem totalmente independentes, crie um conjunto simples de demarcadores de área. No entanto, se você quiser criar uma hierarquia de equipes, você desejará criar uma hierarquia de árvore de demarcadores de área. Para obter mais informações, consulte Configurar uma hierarquia de equipes.

Para usar as seguintes ferramentas, as equipes devem assinar demarcadores de área:

• Boards> todas as ferramentas
• Listas de pendências> todas as ferramentas
• Sprints> todas as ferramentas
• Planos de entrega
• Pacote cumulativo de atualizações
• Análise> tudo

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

Pré-requisitos

Permissões:

• Para configurar caminhos da área da equipe, seja um administrador de equipe ou um membro do grupo Administradores do Projeto . Por padrão, o usuário que criou o projeto tem essas permissões.
• Para adicionar um caminho de área no nó raiz ou editar ou excluir qualquer nó filho, seja membro do grupo Administradores do projeto.
• Para adicionar, editar e gerenciar caminhos de área em um nó, tenha uma ou mais das seguintes permissões definidas como Permitir:
  • Criar nós filho
  • Excluir este nó
  • Editar este nó
  • Exibir permissões neste nó

Para obter mais informações, consulte Definir permissões e acesso para acompanhamento de trabalho.

Para restrições de nomenclatura em caminhos de área, consulte Sobre áreas e iterações, Restrições de nomenclatura.

Introdução

Cada equipe tem acesso a várias ferramentas Agile, conforme descrito em Sobre equipes e ferramentas Agile. 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 em suas listas de pendências e quadros 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ê não estiver familiarizado com o gerenciamento de projetos e equipes, siga estas etapas para configurar seu projeto e equipes:

1. Definir caminhos de área: determine o número e os nomes dos caminhos de área necessários para categorizar seu trabalho. Adicione pelo menos um caminho de área por equipe. Para obter mais informações, consulte Sobre áreas e iterações.
2. Definir equipes: Decida o número e os nomes das equipes necessárias. Para obter mais informações, confira Sobre equipes e ferramentas Agile.
3. Configurar caminhos de área: Vá para Configurações do>projeto Configuração>do projeto Áreas e defina os caminhos de área para seu projeto. Siga as etapas em Adicionar caminhos de área.
4. Criar equipes: crie as equipes necessárias com base na etapa 2. Para obter mais informações, consulte Adicionar uma equipe, passar de uma equipe padrão para várias equipes.
5. Atribuir caminhos de área às equipes: na configuração da equipe, atribua o padrão e outros caminhos de área a cada equipe. Execute as etapas em Definir caminhos de área padrão da equipe.
6. Atribuir caminhos de área a itens de trabalho: Atribua itens de trabalho aos caminhos de área definidos usando a modificação em massa para atualizar vários itens de uma só vez.

Observação

Atribuir o mesmo caminho de área a várias equipes pode causar conflitos sobre a propriedade do item de trabalho. Para obter mais informações, consulte Limitações de exibições de quadro de várias equipes.

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

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

Listar áreas do projeto

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

Navegador

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

CLI do Azure DevOps

Listar caminhos | de área do projeto Adicionar um caminho | de área de projeto Listar caminhos | de áreas de equipe Definir caminhos | de área de equipe Renomear ou mover um caminho | de área de projeto Remover caminho de área de uma equipe

Você pode listar os caminhos de área definidos para um projeto usando az boards area project list. Para começar, confira Introdução à CLI do Azure DevOps.

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

Parâmetros

• depth: opcional. Profundidade dos nós filho a serem listados. Exemplo: --depth 3. Quando não especificado, somente os caminhos de área de nível superior são retornados.
• path: opcional. Caminho absoluto de uma área. \Area\ deve seguir após o \ProjectName, que distingue esse caminho de um caminho de iteração. Por exemplo, --path \ProjectName\Area\AreaName. Se espaços forem usados dentro de um nó, coloque aspas duplas, por exemplo, --path "\Fabrikam Fiber\Area\Service Delivery\Performance". Quando não especificado, lista os caminhos de área do nível raiz.
• project: opcional. Nome ou ID do projeto. Exemplo: --project "Fabrikam Fiber".

Exemplo

Por exemplo, o comando a seguir lista os caminhos de área para 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

Adicionar um caminho de área

Apenas uma área raiz é definida por padrão. Adicione caminhos de área novos e filhos no caminho da área raiz do projeto ou como filho em outro caminho de área ou equipe. Novos caminhos de área são adicionados ao nó raiz por padrão.

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

Navegador

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

1. Realce o caminho da área e escolha Novo filho. Opcionalmente, você pode selecionar um caminho de área e escolher Novo ou selecionar o item de menu Novo na parte superior da lista de área.

2. Insira 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.

   

3. 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 as seguintes etapas:

1. Realce o caminho da área e escolha Novo filho. Opcionalmente, você pode selecionar o caminho da área e escolher Novo filho ou selecionar Novo filho no menu na parte superior da lista de área.

2. Insira 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.

   

3. Selecione Salvar e Fechar

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

CLI do Azure DevOps

Você pode adicionar caminhos de área a um projeto usando az boards area project create. Para começar, confira 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]

Parâmetros

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

Exemplo: formato JSON

Por exemplo, o comando a seguir adiciona o caminho da área de voz 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

Listar caminhos da área da equipe

Você define os padrões da equipe nas configurações da equipe. Se você não for um administrador de equipe, será adicionado como um. Somente administradores de equipe ou projeto podem alterar as configurações da equipe.

Navegador

1. Abra seu projeto e selecione Configurações do>projeto Áreas de configuração>da equipe.

   

2. Se você precisar alternar o contexto da equipe, use o seletor de equipe dentro das trilhas.

   

CLI do Azure DevOps

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

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

Parâmetros

• team: obrigatório. Nome ou ID da equipe.
• project: 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 Entrega 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

Abrir as configurações da equipe no perfil da equipe

Você define áreas e iterações na configuração da equipe de configurações > do projeto. Você pode navegar rapidamente até ele de uma lista de pendências, quadro ou painel de acompanhamento de trabalho em equipe.

1. Abra uma lista de pendências ou quadro para uma equipe e escolha Perfil> da equipe Configurações da equipe.

   Aqui abrimos o Board para a equipe da Fabrikam Fiber e, a partir daí, o perfil da equipe.

   

2. Escolha iterações e áreas.

   

3. Se você precisar alternar o contexto da equipe, use o seletor de equipe dentro das trilhas.

   

Configurar caminhos da área da equipe

Todos os itens de trabalho designados a um caminho da área da 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. Escolha incluir caminhos de subárea quando quiser dar suporte a exibições de rollup do trabalho realizado em várias equipes ou áreas.

Observação

As equipes podem receber no máximo 300 caminhos de área. Para obter mais informações, consulte Acompanhamento de trabalho, processo e limites de projeto.

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

Importante

Os itens de trabalho que aparecem em mais de um quadro de uma equipe podem gerar resultados de consulta que não atendem às suas expectativas. Como cada equipe pode personalizar as colunas e raias do quadro, os valores atribuídos aos itens de trabalho que aparecem em quadros diferentes podem não ser os mesmos. A principal solução alternativa para esse problema é manter a propriedade única dos itens de trabalho por caminho de área de equipe.

Navegador

Você pode selecionar caminhos de área existentes ou criar caminhos de área novos ou filhos nas configurações da equipe.

1. Selecione Configurações do>projeto Áreas de configuração>da equipe.

2. Selecione a equipe que deseja configurar na lista suspensa na parte superior da página.

   Aqui, mostramos as áreas para a equipe de fibra da Fabrikam.

   

3. Escolha um ou mais caminhos de área para serem ativos para a equipe.

   

   Neste caso, optamos por ativar os caminhos de subárea para o projeto. A equipe de gerenciamento agora pode acompanhar o progresso de todas as equipes.

   

4. Quando terminar, atualize a página de lista de pendências do produto para a equipe e você verá esses itens de trabalho atribuídos à equipe. Adicione o caminho da área às colunas mostradas para ver as atribuições feitas aos itens de trabalho.

   

   

CLI do Azure DevOps

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, confira Introdução à CLI do Azure DevOps.

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

Parâmetros

• path: obrigatório. Caminho absoluto de uma área. Exemplo: --path \ProjectName\AreaName.
• team: obrigatório. Nome ou ID da equipe.
• include-sub-areas: opcional. Inclua nós filho do caminho de área. Valores aceitos: false, true.
• project: opcional. Nome ou ID do projeto. Exemplo: --project "Fabrikam Fiber".
• set-as-default: opcional. Especifique como o caminho de área padrão para a equipe. Padrão: false.

Exemplo

Por exemplo, o comando a seguir adiciona o caminho da área de voz à equipe de voz para o projeto Fabrikam Fiber, define-o como o padrão e para incluir 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

Renomear ou mover um caminho de área

O sistema atualiza automaticamente os itens de trabalho e as consultas que fazem referência ao caminho da área atualizado. Cada Caminho de Área está associado a um GUID exclusivo.

Navegador

1. Para renomear um Caminho de Área, abra o portal da Web Configurações do projeto Página>Áreas de configuração>do projeto.

2. Escolha o menu de contexto do nó e selecione Editar.

   

3. Na caixa de diálogo que é aberta, insira o novo nome.

   

4. Para mover o nó dentro da hierarquia, altere o campo Local .

   Observação

   Quando você renomeia ou altera o campo Local de um nó, o sistema atualiza automaticamente os itens de trabalho existentes que fazem referência ao Caminho da Área.

CLI do Azure DevOps

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 command. Para começar, confira Introdução à CLI do Azure DevOps.

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

• path: 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.
• name: opcional. Especifica o novo nome do caminho da área.
• project: opcional. Nome ou ID do projeto. Exemplo: --project "Fabrikam Fiber".

Exemplo

Por exemplo, o comando a seguir renomeia o caminho da área de Voz para Voz 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]

Parâmetros

• path: obrigatório. Caminho absoluto de uma área. Exemplo: --path \ProjectName\AreaName.
• team: obrigatório. Nome ou ID da equipe.
• project: opcional. Nome ou ID do projeto. Exemplo: --project "Fabrikam Fiber".

Exemplo

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

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

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.

Importante

• A exclusão de caminhos de área ou a reconfiguração de caminhos de iteração causam perda irreversível de dados. Por exemplo, gráficos de widget de burndown e burnup, burndown de sprint e gráficos de velocidade para equipes com Caminhos de Área alterados não exibirão dados precisos. Os gráficos de tendências históricas fazem referência ao Caminho da Área e ao Caminho da Iteração conforme foram definidos no momento para cada item de trabalho. Depois de excluídos, você não poderá recuperar dados históricos para esses caminhos.
• Você só pode excluir caminhos de área e iteração que não são mais usados por nenhum item de trabalho.

1. Para excluir um Caminho de Área, abra o portal da Web Configurações do projeto Página>Áreas de configuração>do projeto.

2. Escolha o menu de contexto do nó e selecione Excluir ou Remover.

3. Na caixa de diálogo que é aberta, selecione o Caminho da Área para reatribuir itens de trabalho e, em seguida, 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 da á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.

Próximas etapas

Definir caminhos de iteração ou sprints

Artigos relacionados

Como você pode ver, os caminhos de área desempenham um papel importante no suporte a ferramentas Agile, equipes e gerenciamento de itens de trabalho. Saiba mais sobre como trabalhar com esses campos nos seguintes artigos:

• Saiba mais sobre áreas e iterações
• Adicionar outra equipe
• Definir configurações de equipe e adicionar administradores de equipe
• Use ferramentas ágeis que dependem de áreas ou iterações
• Consulta por área ou caminho de iteração
• Definir permissões e acesso para acompanhamento de trabalho

Recursos programáticos

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

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