Mover itens de trabalho de uma equipe para outra
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Introdução
Ao adicionar uma equipe ou reorganizar 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 da Área da equipe. Da mesma forma, atribuir outros itens de trabalho ao Caminho da Área de uma equipe dá 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, defina as permissões Exibir itens de trabalho neste nó e Editar itens de trabalho neste nó 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 marcas a itens de trabalho, defina a permissão Criar nova definição de marca no nível do projeto como Permitir. Por padrão, o grupo Colaboradores tem essa permissão.
Níveis de acesso:
- Para adicionar novas marcas a itens de trabalho ou para exibir ou seguir solicitações de pull, tenha pelo menos acesso básico .
- Para exibir ou seguir itens de trabalho, tenha pelo menos acesso ao Stakeholder . Saiba mais em Sobre nível de acesso.
- Todos os membros do projeto, incluindo os do grupo Leitores , podem enviar emails contendo itens de trabalho.
Observação
- Forneça acesso das partes interessadas aos membros que desejam contribuir para a discussão e revisar o progresso. Normalmente, eles são membros que não contribuem para o código, mas querem exibir itens de trabalho, listas de pendências, quadros e painéis.
- As partes interessadas não podem adicionar novas tags, mesmo que a permissão seja definida explicitamente, devido ao seu nível de acesso. Para mais informações, veja Referência rápida de acesso das partes interessadas.
- Permissões de Caminho de Área: Ter 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 (Herdado, XML Hospedado ou XML Local) para garantir a movimentação contínua de itens de trabalho.
- Fazer 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 comandos da CLI do Azure, instale a CLI do Azure conforme descrito em Introdução à CLI do Azure DevOps.
Acesso ao projeto: seja um membro do projeto.
Permissões:
- Para exibir, seguir e editar itens de trabalho, defina as permissões Exibir itens de trabalho neste nó e Editar itens de trabalho neste nó 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 marcas a itens de trabalho, defina a permissão Criar nova definição de marca no nível do projeto como Permitir. Por padrão, o grupo Colaboradores tem essa permissão.
Níveis de acesso:
- Para adicionar novas marcas a itens de trabalho ou para exibir ou seguir solicitações de pull, tenha pelo menos acesso básico .
- Para exibir ou seguir itens de trabalho, tenha pelo menos acesso ao Stakeholder . Saiba mais em Sobre nível de acesso.
- Todos os membros do projeto, incluindo os do grupo Leitores , podem enviar emails contendo itens de trabalho.
Observação
- Forneça acesso das partes interessadas aos membros que desejam contribuir para a discussão e revisar o progresso. Normalmente, eles são membros que não contribuem para o código, mas querem exibir itens de trabalho, listas de pendências, quadros e painéis.
- As partes interessadas não podem adicionar novas tags, mesmo que a permissão seja definida explicitamente, devido ao seu nível de acesso. Para mais informações, veja Referência rápida de acesso das partes interessadas.
- Permissões de Caminho de Área: Ter 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.
Mover itens de trabalho em equipes
Para mover itens de trabalho em uma equipe, execute as seguintes etapas:
Crie uma consulta de todos os itens de trabalho que você deseja reatribuir.
Selecione vários destes itens, que pertencem a cada equipe, e edite em massa o caminho de área.
Depois de modificar em massa, salve em massa.
Mover um item de trabalho usando a CLI do Azure
Você pode usar a atualização do 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 a: opcional. Nome da pessoa à qual o item de trabalho é atribuído a Jamal.
- description: 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\IterationName.
- abrir: opcional. 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 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. </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 equipe
Depois de mover os itens de trabalho de uma equipe para outra, verifique a lista de pendências da equipe para garantir que os itens sejam exibidos. Para obter mais informações, consulte Criar sua lista de pendências.
Se você encontrar problemas, examine Configurar listas de pendências e quadros do projeto.