Partilhar via

Mover itens de trabalho de uma equipe para outra

  • Artigo

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

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

  • 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:

    • Seja um membro do projeto.
    • 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.
    • Por padrão, todos os Colaboradores e Partes Interessadas em projetos públicos podem adicionar tags novas e existentes. Em projetos privados, as partes interessadas só podem adicionar tags existentes. Para controlar a capacidade de criar novas tags, defina a permissão Criar definição de tag no nível do projeto. Para obter mais informações, consulte Alterar permissões no nível do projeto.

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.
  • permissões do Caminho de Área: Visualizar e editar itens de trabalho nos nós de 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.

  • 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:

    • Seja membro do projeto.
    • 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.
    • Por padrão, todos os Colaboradores e Partes Interessadas em projetos públicos podem adicionar tags novas e existentes. Em projetos privados, as partes interessadas só podem adicionar tags existentes. Para controlar a capacidade de criar novas tags, defina a permissão para Criar definição de tag no nível do projeto. Para obter mais informações, consulte Alterar permissões no nível do projeto.

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.

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.

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

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

Captura de ecrã de Guardar itens de trabalho editados 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 visibilidade

Depois de mover itens de trabalho de uma equipe para outra, execute as seguintes ações se não vir os itens de trabalho:

  • Atualizar: Atualize o quadro ou selecione Mostrar mais itens se os itens de trabalho recém-adicionados não aparecerem.
  • Verificarda equipe: Verifique se você selecionou a equipe certa para garantir que os itens apareçam na lista de pendências.
  • Verificar Caminho de Área: Verifique se os itens de trabalho movidos estã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. Esta ação é crucial para garantir a visibilidade do backlog.
  • Verificar 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 os tipos e filtros de item de trabalho: Revise seus filtros de lista de pendências e se os tipos de item de trabalho estão categorizados corretamente para garantir que todos os itens relevantes sejam exibidos.

Para obter mais informações, consulte Configurar as listas de pendências e quadros do seu projeto.