Definir caminhos de iteração (sprints) e configurar iterações de equipe

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

Os Caminhos de Iteração, também conhecidos como sprints, atribuem itens de trabalho a intervalos de caixa de tempo específicos. Defina caminhos de iteração no nível do projeto e peça a cada equipe que selecione os caminhos que usa. Os caminhos de iteração são compartilhados entre todas as equipes selecionadas. Você pode criar uma estrutura simples ou hierárquica de caminhos de iteração para dar suporte a versões, subversões e sprints. Se sua equipe não usa sprints para planejar e acompanhar o trabalho, mantenha as atribuições de equipe padrão e utilize listas de pendências e quadros de produtos e portfólios, embora as ferramentas de planejamento de sprint não sejam aplicáveis.

Defina demarcadores de iteração e atribua-os às equipes quando quiser usar as seguintes ferramentas:

• Atribuir itens de trabalho a sprints usando o painel Planejamento
• Itens de trabalho de consulta e gráfico com base no Demarcador da Iteração
• Prever a lista de pendências do produto
• Sprints> todas as ferramentas
• Planos de Entrega, uma exibição de calendário de entregas de equipe
• Gráfico de velocidade e Gráfico de Burndown de Sprint

Dica

Se uma equipe não tiver assinado ou selecionado um caminho de iteração, esse caminho de iteração não aparecerá em uma exibição ou ferramenta de equipe.

Para obter informações sobre restrições de nomenclatura e limites colocados na adição de Caminhos de Iteração, consulte Sobre áreas e iterações, Restrições de nomenclatura.

Dica

Para atualizar rapidamente as datas de iteração, consulte Alterar datas de sprint. No entanto, se você precisar definir os caminhos de iteração e a estrutura de árvore, siga as diretrizes fornecidas neste artigo.

Pré-requisitos

Permissões:

• Para adicionar um caminho de iteração a um projeto, seja membro do grupo Administradores do Projeto. Por padrão, o usuário que criou o projeto tem essas permissões definidas.
• Para adicionar, editar e gerenciar caminhos de iteração em um nó, tenha uma ou mais das seguintes permissões definidas como Permitir para o nó que você deseja gerenciar:
  • Criar nós filho
  • Excluir este nó
  • Editar este nó
  • Exibir permissões para este nó
• Para definir caminhos de iteração da equipe, seja um administrador de equipe ou membro do grupo Administradores do Projeto.

Para obter mais informações sobre como adquirir permissões, consulte Alterar permissões no nível do projeto ou Definir permissões e acesso para acompanhamento de trabalho.

Introdução

Novos projetos começam com um único caminho de área raiz correspondente ao nome do projeto. Adicione outros caminhos de área nessa raiz e use caminhos de iteração predefinidos para acompanhar o trabalho definindo datas.

Se você não estiver familiarizado com o gerenciamento de projetos e equipes, siga estas etapas para configurar seu projeto e equipes:

1. Configurar Azure Boards: examine Configurar e personalizar Azure Boards.
2. Definir caminhos de área e equipes: siga Definir caminhos de área e atribua a uma equipe, garantindo pelo menos um caminho de área por equipe.
3. Defina a duração da iteração: decida sobre a duração da iteração, de preferência consistente entre as equipes. Consulte Sobre áreas e iterações.
4. Escolha a estrutura do sprint: escolha entre um sprint plano ou hierárquico e uma estrutura de liberação.
5. Defina caminhos de iteração.
6. Criar equipes: crie as equipes necessárias com base na etapa 2. Consulte Adicionar uma equipe, passar de uma equipe padrão para várias equipes.
7. Atribuir caminhos de área às equipes: na configuração da equipe, atribua caminhos de área padrão e outros a cada equipe. Siga Definir caminhos de iteração padrão da equipe.
8. Atribuir caminhos de iteração a itens de trabalho: use a modificação em massa para atribuir itens de trabalho a caminhos de iteração para visibilidade em listas de pendências e quadros. Além disso, consulte Atribuir itens de lista de pendências a um sprint.

Conforme necessário, você pode realizar as seguintes tarefas a qualquer momento:

• Adicionar mais nós de iteração filho
• Renomear um caminho de iteração (exceto o caminho raiz)
• Mover um caminho de iteração filho em outro nó
• Excluir um caminho de iteração filho
• Alterar os caminhos de iteração padrão e selecionados atribuídos a uma equipe

Iteração de lista de pendências de equipe versus iteração padrão

Cada equipe tem acesso a várias ferramentas Agile, conforme detalhado em Sobre equipes e ferramentas Agile. Essas ferramentas fazem referência aos caminhos de área padrão da equipe e aos caminhos de iteração ou sprints selecionados. Normalmente, as equipes usam um caminho de área e vários caminhos de iteração para acompanhamento de trabalho, mas você pode usar vários caminhos de área em listas de pendências e quadros para dar suporte a diferentes cenários.

As equipes podem definir uma iteração padrão separada da iteração da lista de pendências. A iteração da lista de pendências determina quais itens aparecem nas listas de pendências e nos quadros da equipe, enquanto a iteração padrão atribui valores a itens de trabalho recém-criados.

Todos os itens de trabalho criados no contexto da equipe são atribuídos automaticamente ao caminho de área padrão da equipe e ao caminho de iteração padrão.

Listar iterações do projeto

Para listar iterações de projeto, execute as seguintes etapas:

Navegador

1. Faça logon no seu projeto https://dev.azure.com/{Your_Organization/Your_Project}.

2. Selecione (1) Configurações do> projeto (2) Configuração do> projeto (3) Iterações.

   

CLI do Azure DevOps

Listar caminhos | de iteração do projeto Adicionar uma iteração | de projeto Listar caminhos | de iteração da equipe Definir caminhos | de iteração de equipe Excluir ou atualizar um caminho de iteração de projeto

Liste as iterações definidas para um projeto usando az boards iteração project list. Para começar, confira Introdução à CLI do Azure DevOps.

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

Parâmetros

• depth: opcional. Profundidade dos nós filho a serem listados. Exemplo: --depth 3.
• path: opcional. Caminho absoluto de uma iteração. \Iteration\ deve seguir após o , que o \ProjectNamedistingue de um caminho de área. Exemplo: --path \ProjectName\Iteration\IterationName. Se espaços forem usados dentro de um nó, coloque aspas duplas, por exemplo,--path "\Fabrikam Fiber\Iteration\Sprint 1". Quando não especificado, lista os caminhos de iteração 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 obter mais informações sobre outras opções de formato de saída, consulte Formatos de saída para comandos da CLI do Azure

az boards iteration project list --depth 3 --project "Fabrikam Fiber" --output table
ID     Identifier                            Name            Path                                           Has Children    Start Date            Finish Date
-----  ------------------------------------  --------------  ---------------------------------------------  --------------  --------------------  --------------------
55290  d77820e9-6bda-4deb-8052-cc519bc12ecc  Fabrikam Fiber  \Fabrikam Fiber\Iteration                      True
55292  5938b25d-7235-499e-815f-4fc19d95d24c  Release 1       \Fabrikam Fiber\Iteration\Release 1            True
55297  c7063041-ff3a-4d7f-bb46-c433c7030d59  Sprint 1        \Fabrikam Fiber\Iteration\Release 1\Sprint 1   False           2019-01-01T00:00:00Z  2019-01-18T00:00:00Z
55298  dd10f1bf-bedd-4c6f-926f-b2abea81bb50  Sprint 2        \Fabrikam Fiber\Iteration\Release 1\Sprint 2   False           2019-01-21T00:00:00Z  2019-02-08T00:00:00Z
55340  862e961a-ac7a-4fcc-9ebc-8afd0c12fed5  Sprint 3        \Fabrikam Fiber\Iteration\Release 1\Sprint 3   False           2019-03-11T00:00:00Z  2019-03-29T00:00:00Z
55341  8548898e-4dfd-4515-9d6e-d476d90033a3  Sprint 4        \Fabrikam Fiber\Iteration\Release 1\Sprint 4   False
55342  d130534c-05dc-434b-a7f3-85689d11c36f  Sprint 5        \Fabrikam Fiber\Iteration\Release 1\Sprint 5   False
55343  738f5c0b-c62b-4ba5-96ab-026e606b0cef  Sprint 6        \Fabrikam Fiber\Iteration\Release 1\Sprint 6   False           2018-07-16T00:00:00Z  2018-08-03T00:00:00Z
55299  a0554e98-b1f1-4230-8500-733c739a0113  Release 2       \Fabrikam Fiber\Iteration\Release 2            False
55300  5c3a5d56-f860-4ebc-8838-7701256c88a4  Release 3       \Fabrikam Fiber\Iteration\Release 3            False
55301  ad722430-042b-4c45-87e5-8d67572d4fc1  Release 4       \Fabrikam Fiber\Iteration\Release 4            False
55364  8b738736-fef6-49f5-be2a-31c86add6589  Future          \Fabrikam Fiber\Iteration\Future               False

Adicionar iterações e definir datas de iteração

Adicione iterações da mesma forma que você adiciona áreas. Para obter mais informações sobre como trabalhar em uma cadência de sprint, consulte Scrum e ferramentas de planejamento de sprint.

Navegador

1. Adicione e modifique iterações de Configurações>do projeto Iterações de configuração>do projeto.

   Para projetos baseados em Scrum, você verá o conjunto de sprints a seguir.

   

2. Para agendar as datas de início e término para cada sprint que suas equipes usam, realce o sprint e escolha Definir datas. Ou selecione Actions (Ações) para o caminho de iteração e escolha Edit (Editar).

   

3. Para selecionar novas datas, escolha o ícone de calendário.

   

4. Ao terminar, você tem um conjunto de sprints agendados - semelhante à imagem a seguir:

   

   Sua próxima etapa é escolher os sprints que cada equipe usa.

CLI do Azure DevOps

Adicionar caminhos de iteração a um projeto usando az boards iteration project create. Para começar, confira Introdução à CLI do Azure DevOps.

az boards iteration project create --name
                                   [--finish-date]
                                   [--path]
                                   [--project]
                                   [--start-date]

Parâmetros

• nome: Obrigatórios. Insira o nome do caminho de iteração.
• data de término: opcional. Data de término da iteração. Exemplo: "--finish-date 2019-06-21".
• path: opcional. Caminho absoluto de uma iteração. Exemplo: \ProjectName\Iteration\IterationName. Quando não especificado, adiciona uma iteração no nível raiz.
• project: opcional. Nome ou ID do projeto. Exemplo: --project "Fabrikam Fiber".
• data de início: opcional. Insira a data de início do caminho de iteração. Exemplo: "2019-06-03". Deve ser anterior à data de término.

Exemplo

Por exemplo, o comando a seguir adiciona o Sprint 36, que começa em 1º de setembro de 2019 e termina em 30 de setembro de 2019 como um caminho de iteração para o projeto padrão no nó raiz.

az boards iteration project create --name "Sprint 36" --start-date 2019-09-01 --finish-date 2019-09-30
{
  "attributes": {
    "finishDate": "2019-09-30T00:00:00Z",
    "startDate": "2019-09-01T00:00:00Z"
  },
  "children": null,
  "hasChildren": false,
  "id": 55411,
  "identifier": "af3ef6a7-6551-451b-8f9f-63af7a60fc55",
  "name": "Sprint 36",
  "path": "\\Fabrikam Fiber\\Iteration\\Sprint 36",
  "structureType": "iteration",
  "url": "https://dev.azure.com/fabrikam/56af920d-393b-4236-9a07-24439ccaa85c/_apis/wit/classificationNodes/Iterations/Sprint%2036"
}

Listar iterações da equipe

Defina 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.

Observação

O Teams pode receber no máximo 300 caminhos de iteração. Para obter mais informações, consulte Acompanhamento de trabalho, processo e limites de projeto.

Navegador

Defina áreas e iterações em Configurações > do projeto Configuração da equipe de quadros>. Navegue rapidamente até ele a partir de uma lista de pendências, quadro ou painel de acompanhamento de trabalho em equipe.

1. Abra uma lista de pendências ou um quadro para uma equipe e escolha Perfil de equipe e, em seguida, Configurações de Equipe.

   Aqui, abrimos o Quadro para a equipe Web e, a partir daí, o perfil da equipe.

   

2. Escolha iterações e áreas.

   

3. Para alternar o contexto da equipe, use o seletor de equipe nas trilhas de navegação.

   

CLI do Azure DevOps

Liste os caminhos de iteração definidos para uma equipe usando az boards area team list. Para começar, confira Introdução à CLI do Azure DevOps.

az boards iteration team list --team
                              [--project]
                              [--timeframe]

Parâmetros

• team: obrigatório. Nome ou ID da equipe.
• project: opcional. Nome ou ID do projeto.
• período de tempo: opcional. Um filtro para o qual as iterações são retornadas com base no tempo relativo. Há suporte apenas para Current .

Exemplo

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 iteration team list  --team "Service Delivery"  --project "Fabrikam Fiber" --output table
ID                                    Name       Start Date                 Finish Date                Time Frame    Path
------------------------------------  ---------  -------------------------  -------------------------  ------------  ---------------------------------
c7063041-ff3a-4d7f-bb46-c433c7030d59  Sprint 1   2019-01-01T00:00:00+00:00  2019-01-18T00:00:00+00:00  past          Fabrikam Fiber\Release 1\Sprint 1
dd10f1bf-bedd-4c6f-926f-b2abea81bb50  Sprint 2   2019-01-21T00:00:00+00:00  2019-02-08T00:00:00+00:00  past          Fabrikam Fiber\Release 1\Sprint 2
862e961a-ac7a-4fcc-9ebc-8afd0c12fed5  Sprint 3   2019-03-11T00:00:00+00:00  2019-03-29T00:00:00+00:00  current       Fabrikam Fiber\Release 1\Sprint 3

Selecione sprints de equipe e defina o caminho de iteração padrão

Defina sprints para o projeto e selecione-os para serem ativos para cada equipe. Atribua a iteração padrão a ser usada ao criar novos itens de trabalho.

Navegador

1. Abra Configurações > do projeto Iterações de configuração > de equipe de quadros > para uma equipe.

   Aqui, navegamos até a Equipe de Fibra da Fabrikam.

   

2. Iteração de lista de pendências. Somente os itens de trabalho atribuídos a uma iteração igual a ou sob essa iteração de lista de pendências aparecem nas listas de pendências e quadros da equipe.

   

   Além disso, todos os itens de trabalho adicionados por meio da lista de pendências ou do quadro de uma equipe recebem a iteração de lista de pendências.

3. Iteração padrão. A iteração padrão define a iteração a ser usada quando você cria um item de trabalho da lista de pendências ou do quadro da equipe. especifique qualquer iteração definida no caminho de iteração da lista de pendências. Para atribuir novos itens de trabalho à iteração atual, especifique @CurrentIteration. A mesma macro usada em consultas para listar itens de trabalho atribuídos à iteração ativa atualmente atribuída à equipe é usada.

   Por exemplo, talvez você queira que todos os novos itens de trabalho sejam adicionados a um caminho de iteração futuro, que você usa para fazer a triagem e atribuir a sprints específicos em intervalos periódicos.

   

   Observação

   Novos itens de trabalho adicionados por meio da página Itens de Trabalho ou do widget Novos Itens de Trabalho em um painel de equipe não fazem referência ao Caminho de Iteração Padrão atribuído à equipe. Em vez disso, novos itens de trabalho recebem o último Caminho de Iteração selecionado pelo usuário. Novos itens de trabalho adicionados por meio da lista de pendências ou do quadro de tarefas sprints de uma equipe sempre recebem o Caminho de Iteração associado ao sprint selecionado.

4. Sprints ativos. Adicione uma iteração para cada lista de pendências de sprint que você deseja ativar para a equipe. Adicione cada sprint, um por um, selecionando-o no menu.

   

   Ao terminar, você deverá ver uma lista de sprints, semelhante à seguinte.

   

   Se você não vir os sprints ou as datas necessárias, adicione ou edite iterações para o projeto, desde que tenha as permissões necessárias. Para obter mais informações, consulte Definir caminhos de iteração (sprint).

5. Para ver as listas de pendências de sprint recém-ativadas, atualize a página de lista de pendências do produto da sua equipe.

CLI do Azure DevOps

Adicione caminhos de iteração, defina o caminho de iteração padrão ou defina o caminho de iteração de lista de pendências para uma equipe usando um dos comandos da CLI do Azure DevOps da equipe de iteração az boards a seguir. Para começar, confira Introdução à CLI do Azure DevOps.

az boards iteration team add --id --team
                             [--project]

az boards iteration team set-default-iteration --team
                                               [--default-iteration-macro]
                                               [--id]
                                               [--project]

az boards iteration team set-backlog-iteration --id --team
                                               [--project]

Parâmetros

• team: obrigatório. Nome ou ID da equipe.
• default-iteration-macro: opcional. Macro de iteração padrão, a única entrada válida é @CurrentIteration.
• id: opcional. Insira a ID de um caminho de iteração. Para determinar a ID, liste os caminhos de iteração usando az boards iteração project list.
• project: opcional. Nome ou ID do projeto. Exemplo: --project "Fabrikam Fiber".

Exemplo

Por exemplo, o comando a seguir adiciona o caminho \Fabrikam Fiber\Iteration\Release 2 à equipe de Entrega de Serviços do projeto Fabrikam Fiber.

az boards iteration team add --id a0554e98-b1f1-4230-8500-733c739a0113 --team "Service Delivery" --project "Fabrikam Fiber"
{
  "attributes": {
    "finishDate": null,
    "startDate": null,
    "timeFrame": "future"
  },
  "id": "a0554e98-b1f1-4230-8500-733c739a0113",
  "name": "Release 2",
  "path": "Fabrikam Fiber\\Release 2",
  "url": "https://dev.azure.com/fabrikam/56af920d-393b-4236-9a07-24439ccaa85c/43e6bd2e-696f-492c-bbf7-9cde9cd420ea/_apis/work/teamsettings/iterations/a0554e98-b1f1-4230-8500-733c739a0113"
}

Renomear ou mover uma iteração

Quando você renomeia uma iteração ou move o nó dentro da hierarquia de árvore, o sistema atualiza automaticamente os itens de trabalho e as consultas que fazem referência aos caminhos existentes.

Navegador

1. Para renomear um caminho de iteração, escolha o menu de contexto do nó e selecione Editar.

   

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

   

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

4. Para excluir um nó, escolha a opção Excluir no menu ações.

   Observação

   Quando você exclui um nó de iteração, o sistema atualiza automaticamente os itens de trabalho existentes com o nó que você insere no prompt de exclusão.

CLI do Azure DevOps

Renomeie, mova ou exclua um caminho de iteração para um projeto, usando os seguintes comandos de projeto de iteração az boards. Para começar, confira Introdução à CLI do Azure DevOps.

Renomear ou mover um caminho de iteração de projeto

Para renomear ou mover um caminho de iteração de projeto, use o az boards area project update comando .

az boards iteration project update --path
                                   [--child-id]
                                   [--finish-date]
                                   [--name]
                                   [--project]
                                   [--start-date]

Parâmetros

• path: obrigatório. Caminho absoluto de uma iteração. Exemplo: \ProjectName\Iteration\IterationName.
• child-id: opcional. Move um caminho de iteração existente e o adiciona como um nó filho para o nome do caminho especificado ou a ID do caminho.
• name: opcional. Novo nome do caminho de iteração.
• project: opcional. Nome ou ID do projeto. Exemplo: --project "Fabrikam Fiber".
• data de término: opcional. Data de término da iteração. Exemplo: "21-06-2019".
• data de início: opcional. Data de início do caminho de iteração. Exemplo: "2019-06-03". Deve ser anterior à data de término.
• sim: opcional. Não solicita confirmação.

Exemplo

Por exemplo, o comando a seguir atualiza as datas de início e término do caminho de iteração do Sprint 3 para o projeto Fabrikam Fiber.

az boards iteration project update --path "\Fabrikam Fiber\Iteration\Release 1\Sprint 3" --finish-date 2019-08-31 --start-date 2019-08-01 --project "Fabrikam Fiber" --output table
ID     Identifier                            Name      Start Date            Finish Date           Path                                          Has Children
-----  ------------------------------------  --------  --------------------  --------------------  --------------------------------------------  --------------
55340  862e961a-ac7a-4fcc-9ebc-8afd0c12fed5  Sprint 3  2019-08-01T00:00:00Z  2019-08-31T00:00:00Z  \Fabrikam Fiber\Iteration\Release 1\Sprint 3  False

Excluir um caminho de iteração

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.

Navegador

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

1. Para excluir um Caminho de Iteração, abra a página Configurações>do projeto configurações>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 de Iteração ao qual reatribuir itens de trabalho e escolha Excluir caminho.

   

CLI do Azure DevOps

Para excluir um caminho de iteração de projeto, use o az boards area project delete comando . Para começar, confira Introdução à CLI do Azure DevOps.

az boards iteration project delete --path
                                   [--project]
                                   [--yes]

Parâmetros

• path: obrigatório. Caminho absoluto de uma iteração. Exemplo: \ProjectName\Iteration\IterationName.
• project: opcional. Nome ou ID do projeto. Exemplo: --project "Fabrikam Fiber".
• sim: opcional. Não solicita confirmação.

Exportar/importar caminhos de iteração

Você não pode exportar ou importar a estrutura de caminhos de árvore para um projeto usar com outro projeto.

Usando a CLI do Azure, você pode usar o az boards iteration comando para listar as iterações definidas para um projeto e, em seguida, adicioná-las a outro projeto. Depois de adicionar as iterações a outro projeto, você pode usar o az boards iteration team comando para adicioná-las a uma equipe e definir o caminho de iteração padrão e de lista de pendências para a equipe.

Você pode usar os Nós de Classificação (API REST) e as Equipes (API REST) para executar ações semelhantes.

Arquivar caminhos de iteração

Depois de um tempo, talvez você queira arquivar caminhos de iteração que foram usados para sprints com um ano ou mais de desatualização. Você pode fazer isso movendo o caminho de iteração em um nó que você rotula como "Arquivo". Todos os itens de trabalho são atualizados com o caminho de iteração movido. Além disso, as equipes podem desativar a seleção dos sprints que já passaram. Todos os dados são mantidos no armazenamento de dados com as novas atribuições de caminho de iteração.

Antes de arquivar as iterações, considere se você capturou todos os relatórios desejados.

Progresso do gráfico por iteração

Você pode gerar rapidamente consultas para exibir o progresso dessas áreas. Por exemplo, você pode visualizar o progresso dos itens de trabalho atribuídos a sprints, conforme mostrado no gráfico de barras empilhadas a seguir.

Artigos relacionados

• Sobre áreas e iterações
• Adicionar outra equipe
• Definir configurações de equipe e adicionar administradores de equipe
• Atribuir itens de lista de pendências a um sprint
• Ferramentas Agile que dependem de áreas ou iterações

Recursos programáticos

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

• Usar a iteração az boards (CLI do Azure DevOps)
• Usar o Teams (API REST)
• Utilizar os nós de classificação (API REST)