Partilhar via


Mover itens de trabalho de uma equipe para outra

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

Ao adicionar uma equipe ou reorganizar equipes existentes, você precisa transferir itens de trabalho de uma equipe para outra atualizando seus Caminhos de Área. Cada item de trabalho no Azure DevOps é atribuído a um Caminho de Área, que determina a propriedade da equipe e influencia como os itens de trabalho aparecem em listas de pendências e quadros.

Os itens de trabalho categorizados na categoria Requisitos aparecem em uma lista de pendências da equipe com base em sua atribuição ao Caminho da Área da equipe. Da mesma forma, atribuir outros itens de trabalho à Área de Trabalho de uma equipe oferece suporte a consultas e relatórios com base na responsabilidade da equipe.

Porquê mover itens de trabalho entre equipas

Os cenários comuns para mover itens de trabalho incluem:

  • Reorganização da equipa: quando a sua organização reestrutura equipas ou redistribui responsabilidades
  • Balanceamento de carga de trabalho: redistribuindo itens de trabalho para equilibrar a capacidade entre as equipes
  • Alinhamento de habilidades: Mover itens para equipes com a experiência apropriada
  • Transferência de propriedade de recursos: Transferência de propriedade quando os recursos mudam de mãos
  • Consolidação de projetos: combinando o trabalho de várias equipes em uma única equipe

Pré-requisitos

Categoria Requerimentos
Permissões - Para visualizar, seguir e editar itens de trabalho: Exibir itens de trabalho neste nó e Editar itens de trabalho neste nó permissões definidas como Permitir. Por padrão, o grupo de Colaboradores tem essas permissões. Para obter mais informações, consulte Definir permissões de controle de trabalho.
- Para adicionar tags a itens de trabalho: permissão de nível de projeto para Criar nova definição de tag definida como Permitir. Por padrão, o grupo de Colaboradores tem essa permissão.
Níveis de acesso - Membro do projeto.
- Para adicionar novas tags a itens de trabalho ou para visualizar ou seguir pull requests: Pelo menos acesso Básico.
- Para visualizar ou acompanhar itens de trabalho: Acesso de, pelo menos, Stakeholder. Para obter mais informações, consulte Sobre níveis de acesso.
- Todos os membros do projeto, incluindo os membros do grupo Leitores , podem enviar e-mails contendo itens de trabalho.
Permissões para Caminho de Área Visualizar e Editar itens de trabalho nos nós dos Caminhos de Área. Para obter mais informações, consulte Modificar itens de trabalho em uma área ou um caminho de iteração.
Caminhos de área configurados A equipa-alvo configurou corretamente os Caminhos de Área. Caso contrário, configure os Caminhos de Área necessários antes de transferir itens de trabalho.
Modelo de processo consistente Sua equipe usa um modelo de processo compatível (XML herdado, hospedado ou XML local) para garantir a movimentação perfeita de itens de trabalho.
Itens de trabalho de backup Recomendamos que você faça backup ou exporte itens de trabalho antes de executar movimentações em massa para evitar a perda de dados se ocorrer um erro.
Ferramentas Para usar os comandos da CLI do Azure: CLI do Azure DevOps.
Categoria Requerimentos
Permissões - Para visualizar, seguir e editar itens de trabalho: Exibir itens de trabalho neste nó e Editar itens de trabalho neste nó permissões definidas como Permitir. Por padrão, o grupo de Colaboradores tem essas permissões. Para obter mais informações, consulte Definir permissões de controle de trabalho.
- Para adicionar tags a itens de trabalho: permissão de nível de projeto para Criar nova definição de tag definida como Permitir. Por padrão, o grupo de Colaboradores tem essa permissão.
Níveis de acesso - Membro do projeto.
- Para adicionar novas tags a itens de trabalho ou para visualizar ou seguir pull requests: Pelo menos acesso Básico.
- Para visualizar ou acompanhar itens de trabalho: Acesso de, pelo menos, Stakeholder. Para obter mais informações, consulte Sobre níveis de acesso.
- Todos os membros do projeto, incluindo os membros do grupo Leitores , podem enviar e-mails contendo itens de trabalho.
Permissões para Caminho de Área Exibir e Editar itens de trabalho nos nós Caminho da Área. Para obter mais informações, consulte Modificar itens de trabalho em uma área ou um caminho de iteração.

Mover itens de trabalho usando o portal da Web

A maneira mais eficiente de mover vários itens de trabalho entre equipes é por meio da edição em massa no portal da Web.

Etapa 1: Criar uma consulta para identificar itens de trabalho

Crie uma consulta para localizar todos os itens de trabalho que deseja mover para a nova equipe:

  1. Navegue até Quadros>Consultas>Nova consulta
  2. Defina critérios de consulta para identificar os itens de trabalho, por exemplo:
    • Caminho da área = Caminho da área da equipe atual
    • Tipo de Item de Trabalho = História de Usuário (ou outros tipos relevantes)
    • Estado = Ativo (ou outros estados relevantes)
  3. Execute a consulta para verificar se ela retorna os itens de trabalho corretos
  4. Guardar a consulta para referência futura

Etapa 2: Editar em massa o caminho da área

Para mover itens de trabalho para a nova equipe:

  1. Crie uma consulta de todos os itens de trabalho que você deseja reatribuir.

  2. Selecione vários itens que pertencem a cada equipe e edite em massa o caminho da área.

    Captura de tela do portal da Web, página Consultas, modificação em massa de itens de trabalho selecionados.

  3. Na caixa de diálogo de edição em massa:

    • Selecione Caminho da área na lista suspensa do campo
    • Escolha o caminho da área da equipe alvo
    • Opcionalmente, atualize outros campos, como Atribuído a ou Caminho de iteração
  4. Depois de modificar os itens em massa, salve-os em massa.

    Captura de ecrã de guardar em lote tarefas editadas.

Etapa 3: Verificar a mudança

Depois de salvar, verifique se os itens de trabalho agora aparecem na lista de pendências da equipe de destino:

  1. Navegue até a lista de pendências da equipe de destino
  2. Confirme se os itens de trabalho movidos aparecem na lista de pendências correta
  3. Verifique se o campo Caminho da Área reflete a nova atribuição da equipe

Mover um item de trabalho usando a CLI do Azure

Você pode usar az boards work-item update para mover um único item de trabalho atualizando seu Caminho de Área.

az boards work-item update --id
                           [--area]
                           [--assigned-to]
                           [--description]
                           [--discussion]
                           [--fields]
                           [--iteration]
                           [--open]
                           [--reason]
                           [--state]
                           [--title]

Parâmetros

  • id: Obrigatório. A ID do item de trabalho a ser atualizado.
  • área: Opcional. Caminho absoluto de uma área. Exemplo: --area "\ProjectName\Area\AreaName".
  • atribuído: Opcional. Nome da pessoa a quem o item de trabalho é atribuído, por exemplo, "Jamal".
  • descrição: Opcional. Descrição do item de trabalho.
  • discussão: Opcional. Comentar para adicionar a uma discussão em um item de trabalho.
  • campos: Opcional. Pares "field=value" separados por espaço para campos personalizados que você deseja definir.
  • iteração: Opcional. Caminho absoluto de uma iteração. Exemplo: "\ProjectName\Iteration\IterationName".
  • open: Opcional. Abra o item de trabalho no navegador da Web padrão.
  • motivo: Opcional. Motivo do estado do item de trabalho.
  • estado: Opcional. Estado do item de trabalho, por exemplo, "Ativo".
  • título: Opcional. Título do item de trabalho.

Exemplo

Você só pode mover um item de trabalho de cada vez usando a CLI do Azure DevOps. Neste exemplo, movemos o item de trabalho ID=148 para o caminho da área Fabrikam Fiber\Production Planning.

az boards work-item update --id 148 --area "Fabrikam Fiber\Production Planning" --output yaml

A saída YAML a seguir fornece informações sobre cada um dos campos definidos para o item de trabalho.

fields:
  Microsoft.VSTS.Common.Priority: 2
  Microsoft.VSTS.Common.StackRank: 1500000001.0
  Microsoft.VSTS.Common.StateChangeDate: '2021-11-23T22:26:28.27Z'
  Microsoft.VSTS.Common.ValueArea: Business
  System.AreaPath: Fabrikam Fiber\Production Planning
  System.AssignedTo:
    _links:
      avatar:
        href: https://fabrikamprime.visualstudio.com/_apis/GraphProfile/MemberAvatars/aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    descriptor: aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    displayName: Jamal Hartnett
    id: d291b0c4-a05c-4ea6-8df1-4b41d5f39eff
    imageUrl: https://fabrikamprime.visualstudio.com/_apis/GraphProfile/MemberAvatars/aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    uniqueName: fabrikamfiber4@hotmail.com
    url: https://spsprodeus27.vssps.visualstudio.com/A5d5b8da6-3db7-4829-baf9-1e500c21cc12/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff
  System.BoardColumn: Backlog
  System.ChangedBy:
   _links:
      avatar:
        href: https://fabrikamprime.visualstudio.com/_apis/GraphProfile/MemberAvatars/aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    descriptor: aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    displayName: Jamal Hartnett
    id: d291b0c4-a05c-4ea6-8df1-4b41d5f39eff
    imageUrl: https://fabrikamprime.visualstudio.com/_apis/GraphProfile/MemberAvatars/aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    uniqueName: fabrikamfiber4@hotmail.com
    url: https://spsprodeus27.vssps.visualstudio.com/A5d5b8da6-3db7-4829-baf9-1e500c21cc12/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff
  System.ChangedDate: '2022-05-19T22:58:52.93Z'
  System.CommentCount: 0
  System.CreatedBy:
   _links:
      avatar:
        href: https://fabrikamprime.visualstudio.com/_apis/GraphProfile/MemberAvatars/aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    descriptor: aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    displayName: Jamal Hartnett
    id: d291b0c4-a05c-4ea6-8df1-4b41d5f39eff
    imageUrl: https://fabrikamprime.visualstudio.com/_apis/GraphProfile/MemberAvatars/aad.NDEwY2FkMDQtOWQyOS03NDFlLTk2MmEtNGZlYmU2NGE1NTM4
    uniqueName: fabrikamfiber4@hotmail.com
    url: https://spsprodeus27.vssps.visualstudio.com/A5d5b8da6-3db7-4829-baf9-1e500c21cc12/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff
  System.CreatedDate: '2021-11-23T22:26:28.27Z'
  System.Description: <div>This user story is for documentation purposes.&nbsp; </div>
  System.IterationPath: Fabrikam Fiber\Release 2\Sprint 1
  System.Reason: New
  System.State: New
  System.TeamProject: Fabrikam Fiber
  System.Title: Test the Request feedback functionality
  System.WorkItemType: User Story
  WEF_10182DA5BCCD4CE2A43629FFBD290EF2_Kanban.Column: Backlog
id: 148
relations:
- attributes:
    isLocked: false
    name: Child
  rel: System.LinkTypes.Hierarchy-Forward
  url: https://fabrikamprime.visualstudio.com/854a3f67-9962-43d1-a968-2e5f2eb66c99/_apis/wit/workItems/152
- attributes:
    isLocked: false
    name: Child
  rel: System.LinkTypes.Hierarchy-Forward
  url: https://fabrikamprime.visualstudio.com/854a3f67-9962-43d1-a968-2e5f2eb66c99/_apis/wit/workItems/153
- attributes:
    isLocked: false
    name: Child
  rel: System.LinkTypes.Hierarchy-Forward
  url: https://fabrikamprime.visualstudio.com/854a3f67-9962-43d1-a968-2e5f2eb66c99/_apis/wit/workItems/151
- attributes:
    isLocked: false
    name: Child
  rel: System.LinkTypes.Hierarchy-Forward
  url: https://fabrikamprime.visualstudio.com/854a3f67-9962-43d1-a968-2e5f2eb66c99/_apis/wit/workItems/149
rev: 5
url: https://fabrikamprime.visualstudio.com/854a3f67-9962-43d1-a968-2e5f2eb66c99/_apis/wit/workItems/148

Movimentações em massa com a CLI do Azure

Para mover vários itens de trabalho usando a CLI do Azure, você precisa criar scripts de várias atualizações individuais. Aqui está um exemplo de padrão de script do PowerShell:

# Example: Move multiple work items to a new area path
$workItemIds = @(148, 149, 150, 151)
$newAreaPath = "Fabrikam Fiber\Production Planning"

foreach ($id in $workItemIds) {
    az boards work-item update --id $id --area $newAreaPath
    Write-Host "Moved work item $id to $newAreaPath"
}

Práticas recomendadas para mover itens de trabalho

Considere estas diretrizes ao mover itens de trabalho entre equipes:

Planear a mudança

  • Comunicação: Notificar os membros da equipe afetados antes de mover itens de trabalho
  • Temporização: mova itens durante os limites de sprint para minimizar interrupções
  • Dependências: verifique se há dependências entre itens de trabalho antes de mover
  • Capacidade: Garantir que a equipe alvo tenha capacidade para o trabalho adicional

Durante a migração

  • Processamento em lote: mova itens de trabalho relacionados juntos para manter o contexto
  • Preservar a história: mover os itens preserva a sua história e relacionamentos
  • Atualizar atribuições: considere reatribuir itens de trabalho aos membros da equipe de destino
  • Rever iterações: Atualizar caminhos de iteração se as equipas utilizarem agendas de sprint diferentes

Após a migração

  • Verificar visibilidade: confirme se os itens de trabalho aparecem nas listas de pendências corretas da equipe
  • Atualizar documentação: atualize qualquer documentação da equipe que faça referência a itens movidos
  • Revisar relatórios: verifique se os relatórios e painéis da equipe refletem as alterações
  • Acompanhamento: Garantir que os membros da equipe saibam sobre o trabalho transferido

Solução de problemas e verificação

Depois de mover itens de trabalho de uma equipa para outra, siga estes passos se não conseguir visualizar os itens de trabalho:

Problemas e soluções comuns

Questão Solução
Os itens de trabalho não aparecem na lista de pendências Verifique se os Caminhos de Área correspondem aos caminhos de área configurados da equipa
Erros de permissão durante a movimentação Verifique se você tem permissões de edição para caminhos de área de origem e de destino
Itens de trabalho ausentes do sprint Atualize o caminho de iteração para corresponder ao cronograma de sprint da equipe de destino
Filtros ocultando itens de trabalho Revisar filtros de lista de pendências e configurações de tipo de item de trabalho

Passos de verificação

  • Atualizar: Atualize o quadro ou selecione Mostrar mais itens se os itens de trabalho recém-adicionados não aparecerem.
  • Verificar equipe: verifique se você selecionou a equipe correta para garantir que os itens apareçam na lista de pendências.
  • Verificar Caminho de Área: verifique se os itens de trabalho movidos atribuem o Caminho de Área correto que corresponde à lista de pendências da equipe. Cada equipe tem Caminhos de Área específicos que determinam quais itens de trabalho aparecem em sua lista de pendências. Esta verificação é crucial para garantir a visibilidade da lista de pendências.
  • Verifique Caminho de Iteração: Verifique o Caminho de Iteração para o sprint. A lista de pendências do sprint exibe apenas os itens de trabalho atribuídos ao Caminho de Iteração do sprint selecionado.
  • Verificar tipos e filtros de item de trabalho: revise seus filtros de lista de pendências e verifique se os tipos de item de trabalho têm categorização correta para exibir todos os itens relevantes.

Para obter mais informações, consulte Criar sua lista de pendências.

Considerações para movimentos em grande escala

Ao mover muitos itens de trabalho ou reorganizar várias equipes:

Considerações de planejamento

  • Avaliação de impacto: analise quais relatórios, painéis e consultas serão afetados
  • Gestão da mudança: Desenvolver um plano de comunicação para as partes interessadas afetadas
  • Plano de reversão: prepare um plano para reverter as alterações se surgirem problemas
  • Teste: Teste primeiro o processo de movimentação com um pequeno subconjunto de itens de trabalho

Estratégias de execução

  • Abordagem em fases: mova itens de trabalho em fases, em vez de todos de uma só vez
  • Execução fora do horário comercial: execute grandes movimentos durante períodos de baixa atividade
  • Monitoramento: observe os impactos no desempenho durante operações em massa
  • Validação: Verifique cada fase antes de prosseguir para a próxima

Abordagens alternativas

Movendo equipes em vez de itens de trabalho

Às vezes, é mais eficiente reconfigurar os Caminhos de Área da equipe em vez de mover itens de trabalho individuais:

  • Quando a maioria dos itens de trabalho de uma equipe precisa se mover
  • Quando a reorganização de caminhos de área faz mais sentido do ponto de vista organizacional
  • Quando o volume de itens de trabalho é muito grande

Usando consultas para transições graduais

Crie consultas para fazer a transição gradual de itens de trabalho:

  • Filtrar por data de criação para mover itens mais recentes primeiro
  • Utilize os estados dos itens de trabalho para mover separadamente os itens concluídos.
  • Agrupar por tipo de item de trabalho para transições sistemáticas