Compartilhar via


Mover itens de trabalho de uma equipe para outra

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Ao adicionar uma equipe ou reorganizar as equipes existentes, você precisará transferir itens de trabalho de uma equipe para outra atualizando seus Caminhos de Área. Cada item de trabalho em 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 de Requisitos aparecem no backlog da equipe com base na sua atribuição para a Área de Trabalho da equipe. Da mesma forma, atribuir outros itens de trabalho ao Caminho de Área de uma equipe fornece suporte às consultas e aos relatórios com base na propriedade da equipe.

Por que mover itens de trabalho entre equipes

Cenários comuns para mover itens de trabalho incluem:

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

Pré-requisitos

Categoria Requisitos
Permissões - Para exibir, seguir e editar itens de trabalho: as permissões para Exibir itens de trabalho neste nó e Editar itens de trabalho neste nó devem estar definidas como Permitir. Por padrão, o grupo Colaboradores tem essas permissões. Para obter mais informações, consulte Definir permissões de acompanhamento de trabalho.
- Para adicionar marcações aos itens de trabalho: a permissão no nível do projeto Criar nova definição de etiqueta deve estar definida como Permitir. Por padrão, o grupo Colaboradores tem essa permissão.
Níveis de Acesso - Membro do projeto.
- Para adicionar novas marcações a itens de trabalho ou para exibir ou seguir solicitações de pull: é preciso pelo menos acesso Básico.
– Para exibir ou seguir itens de trabalho: no mínimo, acesso de Stakeholder. Para obter mais informações, consulte Sobre os níveis de acesso.
- Todos os membros do projeto, incluindo membros do grupo Leitores , podem enviar emails contendo itens de trabalho.
Permissões do Caminho de área Exibir e Editar itens de trabalho nos nós de Caminho de Área. Para obter mais informações, consulte Modificar itens de trabalho em um caminho da área ou de iteração.
Caminhos de área configurados A equipe de destino 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 (Herdado, XML hospedado ou XML local) para garantir a movimentação perfeita de itens de trabalho.
Itens de trabalho em back-up 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 comandos da CLI do Azure: CLI do Azure DevOps.
Categoria Requisitos
Permissões - Para exibir, seguir e editar itens de trabalho: as permissões para Exibir itens de trabalho neste nó e Editar itens de trabalho neste nó devem estar definidas como Permitir. Por padrão, o grupo Colaboradores tem essas permissões. Para obter mais informações, consulte Definir permissões de acompanhamento de trabalho.
- Para adicionar marcações aos itens de trabalho: a permissão no nível do projeto Criar nova definição de etiqueta deve estar definida como Permitir. Por padrão, o grupo Colaboradores tem essa permissão.
Níveis de Acesso - Membro do projeto.
- Para adicionar novas marcações a itens de trabalho ou para exibir ou seguir solicitações de pull: é preciso pelo menos acesso Básico.
– Para exibir ou seguir itens de trabalho: no mínimo, acesso de Stakeholder. Para obter mais informações, consulte Sobre os níveis de acesso.
- Todos os membros do projeto, incluindo membros do grupo Leitores , podem enviar emails contendo itens de trabalho.
Permissões do Caminho de área Exibir e Editar itens de trabalho nos nós de Caminho de área. Para obter mais informações, consulte Modificar itens de trabalho em um caminho da área ou de iteração.

Mover itens de trabalho usando o portal 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 você deseja mover para a nova equipe:

  1. Navegar até Boards>Consultas>Nova consulta
  2. Defina critérios de consulta para identificar os itens de trabalho, por exemplo:
    • Caminho da Área = Caminho da área do grupo atual
    • Tipo de Item de Trabalho = História do Usuário (ou outros tipos relevantes)
    • State = Active (ou outros estados relevantes)
  3. Execute a consulta para verificar se ela retorna os itens de trabalho corretos
  4. Salvar 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, Modificar em massa itens de trabalho selecionados.

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

    • Selecionar Caminho da Área na lista suspensa do campo
    • Escolher o caminho de área da equipe de destino
    • Opcionalmente, atualize outros campos, como Atribuído a ou Caminho de Iteração
  4. Depois de modificar os itens em lote, salve-os em lote.

    Captura de tela de itens de trabalho editados salvos em massa.

Etapa 3: Verificar a movimentação

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

  1. Navegue até o backlog 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 o 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.
  • area: opcional. Caminho absoluto de uma área. Exemplo: --area "\ProjectName\Area\AreaName".
  • atribuído a: 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. Comente 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\Iteração\NomeDaIteracao".
  • abrir: Optional. Abra o item de trabalho no navegador da Web padrão.
  • motivo: opcional. Motivo para o 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 por vez usando a CLI do Azure DevOps. Neste exemplo, movemos o item de trabalho com ID=148 no caminho de á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 no 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 um script de várias atualizações individuais. Veja 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 as equipes:

Planejando a movimentação

  • Comunicação: notificar os membros da equipe afetados antes de mover itens de trabalho
  • Tempo: mover itens durante os limites de sprint para minimizar a interrupção
  • Dependências: verifique se há dependências entre itens de trabalho antes de mover
  • Capacidade: verifique se a equipe de destino tem capacidade para o trabalho adicional

Durante a mudança

  • Processamento em lote: Mover itens de trabalho relacionados para manter o contexto
  • Preservar o histórico: ao mover itens, mantém-se o histórico e os relacionamentos
  • Atualizar atribuições: considere reatribuir itens de trabalho aos membros da equipe alvo
  • Examinar iterações: Atualizar caminhos de iteração se as equipes usarem agendas de sprint diferentes

Depois de mudar

  • Verificar visibilidade: confirmar que os itens de trabalho aparecem nas listas de pendências corretas da equipe
  • Documentação de atualização: atualizar qualquer documentação da equipe que faça referência a itens movidos
  • Examinar 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 equipe para outra, siga estas etapas se não conseguir ver os itens de trabalho:

Problemas comuns e soluções

Questão Solução
Os itens de trabalho não aparecem na lista de pendências Verifique se o caminho de área corresponde aos caminhos configurados pela equipe
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 Atualizar o Caminho da Iteração para corresponder ao cronograma de sprint da equipe-alvo
Filtros ocultando itens de trabalho Examinar os filtros de lista de pendências e as configurações de tipo de item de trabalho

Etapas de verificação

  • Atualizar: atualize o painel ou selecione Mostrar mais itens se os itens de trabalho recém-adicionados não forem exibidos.
  • Verificação de equipe: verifique se você selecionou a equipe correta para garantir que os itens apareçam no backlog.
  • Verificar Caminho da Área: verifique se os itens de trabalho movidos são atribuídos ao 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. Essa verificação é crucial para garantir a visibilidade no backlog.
  • Verificar o Caminho de Iteração: verifique o Caminho de Iteração para o sprint. A lista de pendências de sprint exibe apenas os itens de trabalho atribuídos ao caminho de iteração do sprint selecionado.
  • Verifique os tipos e filtros de item de trabalho: examine os filtros de lista de pendências e verifique se os tipos de item de trabalho têm a categorização correta para exibir todos os itens relevantes.

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

Considerações sobre movimentações em larga escala

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

Considerações de planeamento

  • Avaliação de impacto: analisar quais relatórios, dashboards e consultas serão afetados
  • Gerenciamento de alterações: desenvolver um plano de comunicação para os stakeholders afetados
  • Plano de reversão: preparar um plano para reverter as alterações se surgirem problemas
  • Teste: teste o processo de movimentação com um pequeno subconjunto de itens de trabalho primeiro

Estratégias de execução

  • Abordagem em fases: mover itens de trabalho em fases em vez de tudo de uma vez
  • Execução fora do horário: executar grandes movimentações durante períodos de baixa atividade
  • Monitoramento: Observe os impactos no desempenho durante operações em massa
  • Validação: verificar cada fase antes de prosseguir para a próxima

Abordagens alternativas

Movendo equipes em vez de itens de trabalho

Às vezes, é mais eficiente reconfigurar caminhos de área de equipe em vez de mover itens de trabalho individuais:

  • Quando a maioria dos itens de trabalho de uma equipe precisa se mover
  • Quando reorganizar caminhos de área faz mais sentido organizacionalmente
  • 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
  • Usar estados de item de trabalho para mover separadamente itens concluídos
  • Agrupar por tipo de item de trabalho para transições sistemáticas