Mover itens de trabalho de uma equipe para outra

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

Introdução

Quando você adiciona uma equipe ou reorganiza equipes existentes, talvez seja necessário 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 são exibidos em listas de pendências e quadros.

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

Pré-requisitos

• Acesso ao projeto: Seja um membro do projeto.

• Permissões:

  • Para exibir, seguir e editar itens de trabalho, tenha as permissões Exibir itens de trabalho neste nó e Editar itens de trabalho neste nó 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, tenha a permissão Criar nova definição de tag no nível do projeto definida como Permitir. Por padrão, o grupo de Colaboradores tem essa permissão.

• Níveis de acesso:

  • Para adicionar novas tags a itens de trabalho ou para exibir ou seguir solicitações pull, tenha pelo menos acesso básico .
  • Para visualizar ou acompanhar itens de trabalho, tenha pelo menos acesso de partes interessadas . Para obter mais informações, consulte Sobre níveis de acesso.
  • Todos os membros do projeto, incluindo os do grupo Leitores , podem enviar e-mails contendo itens de trabalho.

  Nota

  • Forneça acesso às partes interessadas aos membros que desejam contribuir para a discussão e o progresso da revisão. Normalmente, são membros que não contribuem para o código, mas querem visualizar itens de trabalho, listas de pendências, quadros e painéis.
  • Os participantes não podem adicionar novas tags, mesmo que a permissão esteja explicitamente definida, devido ao seu nível de acesso. Para obter mais informações, veja Referência rápida sobre o acesso de Interveniente.

• Permissões de caminho de área: tenha permissões para exibir e editar itens de trabalho nos nós Caminho de área . Para obter mais informações, consulte Modificar itens de trabalho em uma área ou caminho de iteração.
• Caminhos de área configurados: certifique-se de que a equipe de destino tenha seus Caminhos de Área configurados corretamente. Caso contrário, configure os Caminhos de Área necessários antes de transferir itens de trabalho.
• Modelo de processo consistente: as equipes devem usar um modelo de processo compatível (XML herdado, hospedado ou XML local) para garantir a movimentação perfeita de itens de trabalho.
• Backup de itens de trabalho: 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 houver um erro.
• Ferramentas: Para usar os comandos da CLI do Azure, instale a CLI do Azure conforme descrito em Introdução à CLI do Azure DevOps.

Mover itens de trabalho em equipas

Para mover itens de trabalho sob uma equipe, execute as seguintes etapas:

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.

   

3. Depois de modificar em massa, salve em massa.

   

Mover um item de trabalho usando a CLI do Azure

Você pode usar a atualização de item de trabalho az boards 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: --path \ProjectName\Area\AreaName.
• atribuído: Opcional. Nome da pessoa a quem o item de trabalho é atribuído a 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 sob 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

Verificar a lista de pendências da sua equipa

Depois de mover itens de trabalho de uma equipe para outra, verifique a lista de pendências da equipe para garantir que os itens apareçam. Para obter mais informações, consulte Criar sua lista de pendências.

Se você encontrar algum problema, revise Configurar as listas de pendências e quadros do seu projeto.

Artigos relacionados

• Criar ou adicionar uma equipa
• Saiba mais sobre equipes e ferramentas ágeis