Definir caminhos de área e atribuir a uma equipe

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019 | TFS 2018

Adicione caminhos de área para dar suporte a equipes e agrupar itens de trabalho com base em produtos, recursos ou áreas de negócios. Depois de definir caminhos de área no nível do projeto, atribua-os a uma equipe na configuração da equipe. Você também pode criar uma hierarquia 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:

• Itens de trabalho de consulta e gráfico com base no Caminho da Área
• Atribuir trabalho a mais de uma equipe
• Trabalhar com equipes de gerenciamento e recursos
• Filtrar uma lista de pendências, consulta, quadro ou plano usando Caminhos de Área

Dica

Você pode definir sua estrutura de caminho de área e atribuir caminhos de área às equipes. Ou você pode adicionar uma equipe e criar o caminho da área com o nome da equipe nesse momento. Se as equipes forem totalmente independentes, crie um conjunto simples de caminhos de área. No entanto, se você quiser criar uma hierarquia de equipes, convém criar uma hierarquia de árvore de caminhos de área. Para saber mais, confira Configurar uma hierarquia de equipes.

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

• Boards> todas as ferramentas
• Lista de pendências> de todas as ferramentas
• Sprints todas as ferramentas>
• Planos de entrega, exibição de calendário de entregas da equipe
• Rollup
• Análise de> todos

• Boards> todas as ferramentas
• Lista de pendências> de todas as ferramentas
• Sprints todas as ferramentas>
• Planos de entrega, exibição de calendário de entregas da equipe

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

Pré-requisitos

• Se você ainda não tiver um projeto, crie um agora.

• Verifique se você é membro do grupo Administradores de Projeto para adicionar um caminho de área no nó raiz ou editar ou excluir qualquer nó filho. Para adquirir essas permissões, consulte Alterar permissões no nível do projeto.

• Tenha uma ou mais das seguintes permissões definidas como Permitir, adicionar, editar e gerenciar caminhos de área em um nó:

  • Criar nós filho
  • Excluir este nó
  • Editar este nó
  • Exibir permissões neste nó

  Por padrão, o usuário que criou o projeto já tem essas permissões definidas. Para obter mais informações, consulte Definir permissões e acesso para acompanhamento de trabalho.

• Verifique se você foi adicionado como administrador de equipe ou membro do grupo Administradores de Projeto para definir caminhos de área de equipe.

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. Cada ferramenta faz referência aos caminhos de área padrão da equipe. A maioria das equipes escolhe um caminho de área e vários caminhos de iteração para dar suporte às atividades de acompanhamento de trabalho. No entanto, para dar suporte a outros cenários, é possível que as equipes escolham vários caminhos de área para aparecer em suas listas de pendências e quadros.

Novos projetos contêm uma única área raiz que corresponde ao nome do projeto. Uma equipe é criada com o mesmo nome de projeto e o caminho da área raiz é atribuído a essa equipe.

Se você não estiver familiarizado com o gerenciamento de projetos e equipes, a sequência mais direta para configurar seu projeto e equipes será a seguinte:

1. Determine o número e os nomes dos caminhos de área aos quais você deseja dar suporte para categorizar seu trabalho. No mínimo, adicione um caminho de área para cada equipe que você definir. Para obter mais informações, examine Sobre áreas e iterações.
2. Determine o número e os nomes das equipes às quais você deseja dar suporte. Para obter mais informações, examine Sobre equipes e ferramentas Agile.
3. Abra Configurações>do projeto Configuração do projeto e defina os caminhos de área para dar suporte às etapas 1 e 2 no nível do projeto. Siga as etapas fornecidas mais adiante neste artigo: Abrir Configurações do Projeto, Configuração do projeto e Adicionar caminhos de área.
4. Defina as equipes necessárias para dar suporte à etapa 2. Para obter mais informações, consulte Adicionar uma equipe, passar de uma equipe padrão para várias equipes.
5. Abra a configuração da equipe e atribua os caminhos de área padrão e adicionais a cada equipe. Siga as etapas fornecidas posteriormente neste artigo: Abrir configurações de equipe e Definir caminhos de área padrão da equipe.
6. Atribua o caminho de área dos itens de trabalho a um caminho de área que você definiu. Use a modificação em massa para modificar vários itens de trabalho ao mesmo tempo.

Observação

Embora você possa atribuir o mesmo caminho de área a mais de uma equipe, isso poderá causar problemas se duas equipes reivindicarem a propriedade sobre o mesmo conjunto de itens de trabalho. Para saber mais, confira Sobre quadros e Kanban, Limitações de exibições de quadro Kanban de várias equipes.

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

• Adicionar nós filho adicionais
• 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

Importante

Para exibir o conteúdo disponível para sua plataforma, selecione a versão correta deste artigo no seletor de versão localizado acima do sumário. O suporte a recursos difere dependendo se você está trabalhando de Azure DevOps Services ou de uma versão local do Azure DevOps Server.
Para saber qual versão local você está usando, consulte Pesquisar sua plataforma e versão do Azure DevOps

Abrir Configurações do Projeto, listar áreas do projeto

Defina áreas e iterações para um projeto naconfiguração do Projeto deQuadros> de Configurações> do Projeto.

Defina as áreas e iterações das páginas trabalho do contexto Configurações do Projeto . No contexto do usuário, abra o contexto de administrador escolhendo Configurações .

Navegador

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

  

1. No portal da Web do projeto, escolha Configurações do projeto.

   

   Se você estiver trabalhando em um contexto de equipe, passe o mouse sobre o Configurações e escolha Configurações do projeto.

   

2. Escolha Trabalho.

CLI do Azure DevOps

Listar caminhos de área do | projeto Adicionar um caminho | de área do projeto Listar caminhos de áreas | de equipe Definir caminhos de área de | equipe Renomear ou mover um caminho | de área do projeto Remover o caminho da á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.
• caminho: 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 os espaços forem usados em um nó, coloque entre 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

Não há suporte para comandos da CLI do Azure DevOps para Azure DevOps Server local.

Adicionar um caminho de área

Apenas uma área é definida, por padrão. Adicione caminhos de área no caminho da área raiz para o projeto ou como um filho a outro caminho de área.

Navegador

• Para adicionar um nó filho, realce o caminho da área e escolha Novo filho. Opcionalmente, você pode selecionar para o caminho da área e escolher Novo filho.

  Insira um nome (255 caracteres ou menos) para o nó. Para obter restrições de nome adicionais, consulte Sobre áreas e iterações, Restrições de nomenclatura.

  

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.

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

Parâmetros

• nome: Obrigatórios. 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 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 voz ao projeto De fibra Fabrikam 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

Não há suporte para comandos da CLI do Azure DevOps para Azure DevOps Server local.

Abrir configurações de equipe, listar caminhos de área da equipe

Você define os padrões de equipe das configurações de 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> deconfiguração> da equipe.

   

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

   

Você abre as configurações de equipe na barra de navegação superior. Selecione a equipe desejada e escolha Configurações de equipe. Para obter mais informações sobre como mudar o foco da equipe, consulte Alternar projeto, repositório, equipe

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ço. 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

Não há suporte para comandos da CLI do Azure DevOps para Azure DevOps Server local.

Abrir as configurações de equipe do perfil da equipe

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

1. Abra uma lista de pendências ou um quadro para uma equipe e escolhaConfigurações de Equipede perfil> de equipe.

   Aqui, abrimos o Quadro 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.

   

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 placas 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 cumulativos de trabalhos realizados em várias equipes ou áreas.

Observação

As equipes podem receber no máximo 300 Caminhos de Área. Para saber mais, confira Acompanhamento de trabalho, processo e limites de projeto.

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

Importante

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

Navegador

1. Abra Áreas para o contexto da equipe.

   Aqui, mostramos as Áreas para a equipe da Fabrikam Fiber.

   

2. Escolha os caminhos de área para estar ativo para cada equipe.

   

   Nesta instância, optamos por ativar os caminhos de subárea para o projeto. A equipe de gerenciamento agora pode acompanhar o progresso em todas as equipes.

   

3. Quando terminar, atualize a página de pendências do produto para a equipe e 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.

   

   

1. Abra Áreas para o contexto da equipe.

   Aqui, mostramos as Áreas para a equipe da Fabrikam Fiber.

   

2. Escolha os caminhos de área para estar ativo para cada equipe.

   

   Nesse caso, optamos por ativar todos os três caminhos de subárea para o projeto. A equipe de gerenciamento agora pode acompanhar o progresso entre as três equipes.

   

3. Quando terminar, atualize a página de pendências do produto para a equipe e 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

• caminho: 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 da á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 voz à equipe de voz do 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

Não há suporte para comandos da CLI do Azure DevOps para Azure DevOps Server local.

Renomear ou mover um caminho de área

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

Navegador

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

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 o az boards area project update comando . Para começar, confira 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.
• 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 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

• caminho: 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

Não há suporte para comandos da CLI do Azure DevOps para Azure DevOps Server local.

Excluir um caminho de área

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

Importante

Excluir caminhos de área ou reconfigurar caminhos de iteração pode causar perda de dados e não pode ser revertido. Por exemplo, gráficos de widget burndown ou burnup, burndown de sprint e gráficos de velocidade para equipes cujos Caminhos de Área são alterados não refletirão os dados corretos. Gráficos de tendências históricos referenciam o Caminho da Área e o Caminho da Iteração , conforme definido em um ponto no passado para cada item de trabalho. Quando um caminho de área ou caminho de iteração é excluído, os dados históricos para ele não podem ser recuperados.

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

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 escolha Excluir caminho.

   

Progresso do gráfico por área

Você pode gerar rapidamente consultas 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.

P & R

P: Preciso atribuir um caminho de área a uma equipe?

R: Não. Você atribui caminhos de área às equipes para que os itens de trabalho atribuídos a esse caminho de área apareçam nas listas de pendências e placas da equipe. Por padrão, todos os itens de trabalho são atribuídos ao caminho da área raiz. Esses itens de trabalho aparecem na equipe padrão definida para o projeto.

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:

• Sobre áreas e iterações
• Adicionar outra equipe
• Definir configurações de equipe e adicionar administradores de equipe
• Ferramentas Agile que dependem de áreas ou iterações
• Consultar 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.

• az boards area (CLI do Azure DevOps)
• Teams (API REST)
• Nós de classificação (API REST)

• Teams (API REST)
• Nós de classificação (API REST)
• Definir o plug-in de classificação (Modelo de Processo)