Compartilhar via


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.

Mover itens de trabalho em equipes

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

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

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

    Captura de tela do portal da Web, página Consultas, Modificar em massa itens de trabalho selecionados.
  3. Depois de modificar em massa, salve em massa.

    Captura de tela de itens de trabalho editados salvos 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.&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 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.