Remover, excluir ou restaurar itens de trabalho no Azure Boards

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

Os itens de trabalho podem permanecer para sempre em seu armazenamento de dados de acompanhamento de trabalho. Você nunca precisa excluí-los. No entanto, talvez você queira configurar um processo de gerenciamento de itens de trabalho para uma das seguintes ações:

Pré-requisitos

• Os membros do grupo Colaboradores podem remover, excluir e restaurar itens de trabalho.
• Para excluir permanentemente os itens de trabalho, você deve ser membro do grupo Administradores de Projeto ou receber a permissão necessária.
• Os usuários com acesso Stakeholder podem exibir o conteúdo da Lixeira, mas não podem restaurar ou excluir permanentemente itens da lixeira, independentemente das permissões concedidas.

Para obter uma exibição simplificada das permissões atribuídas a grupos internos, confira Permissões e acesso.

Remover ou excluir vários itens de trabalho

Você pode agir em itens de trabalho individuais ou modificar vários itens de trabalho em massa.

No portal da Web, você pode selecionar vários itens de trabalho em uma lista de pendências ou na página de resultados da consulta. Você também pode fazer uma atualização em massa usando o recurso associado. Para excluir ou restaurar vários itens de trabalho ao mesmo tempo, confira Modificar itens de trabalho em massa.

Você também pode excluir e/ou destruir itens de trabalho em lote com uma API REST. Para obter mais informações, confira Itens de trabalho – excluir.

Remover itens de trabalho

Ao alterar o Estado de um item de trabalho para Removido, você o remove efetivamente da lista de pendências ou exibição de quadro (lista de pendências do produto, portfólio e sprint, quadro Kanban e Quadros de Tarefas). O estado Removido corresponde ao estado da categoria de fluxo de trabalho Removido. Se você definir estados de fluxo de trabalho personalizados, qualquer estado mapeado para o estado de categoria de fluxo de trabalho Removido atuará de maneira semelhante.

Para fazer com que os itens removidos não apareçam em consultas, você deve adicionar uma cláusula filtrando o campo Estado.

Excluir itens de trabalho

Os itens de trabalho excluídos não aparecem em suas listas de pendências, quadros ou consultas. Quando você exclui um item, ele vai para a Lixeira. Você pode restaurá-lo a partir daí se mudar de ideia. Para excluir um caso de teste, um plano de teste ou outros tipos de item de trabalho relacionados ao teste, confira Excluir artefatos de teste.

Restaurar ou destruir itens de trabalho

Não é possível abrir itens de trabalho na Lixeira. Você só verá a Excluir permanentemente a opção se sua permissão de nível de projeto Excluir permanentemente itens de trabalho estiver definida como Permitir.

az boards work-item delete --id
                           [--destroy]
                           [--org]
                           [--project]
                           [--yes] 

az boards work-item delete --id 864 --destroy --yes

Processos de exclusão e restauração

Quando você exclui um item de trabalho, o Azure DevOps executa as seguintes ações:

• Gera uma nova revisão do item de trabalho
• Atualiza os campos Data Alterada/Alterado por para dar suporte à rastreabilidade
• Preserva completamente o item de trabalho, incluindo todas as atribuições de campo, anexos, marcas e links
• Faz com que o item de trabalho se torne inconsequente e, como tal, não apareça em nenhuma experiência de acompanhamento de trabalho, resultado da consulta ou relatório
• Atualiza os gráficos corretamente. Os gráficos CFD, de velocidade, de burndown e leve são atualizados para remover os itens de trabalho excluídos
• Remover extensões de acompanhamento de trabalho
• Preservar os dados de tendência, exceto pelo valor mais recente
• Remove o item de trabalho do data warehouse/cubo como se fosse removido permanentemente.

Quando você restaura um item de trabalho, o Azure DevOps executa as seguintes ações:

• Causa uma nova revisão do item de trabalho
• Atualiza os campos Data Alterada/Alterado por para dar suporte à rastreabilidade
• Torna-se consultável
• Todos os campos permanecem inalterados
• O histórico contém duas novas revisões, uma para exclusão e outra para restauração
• Anexa novamente as extensões de acompanhamento de trabalho
• Atualiza os gráficos corretamente. Os gráficos CFD, de velocidade, de burndown e leve são atualizados para incluir os itens de trabalho restaurados
• Restaura os dados de tendência
• Adiciona o item de trabalho de volta ao data warehouse/cubo
• Define os campos de caminho de área ou iteração para o nó raiz se o caminho da área ou os caminhos de iteração anteriores foram excluídos.

Usar uma API REST para excluir, restaurar e destruir itens de trabalho

Para excluir, restaurar e destruir itens de trabalho programaticamente, confira um dos seguintes recursos da API REST:

• Referência da API REST da lixeira
• Itens de Trabalho – Excluir Referência da API REST

Artigos relacionados

• Exibir e adicionar itens de trabalho usando a página Itens de Trabalho
• Excluir artefatos de teste
• Definir permissões e acesso para acompanhamento de trabalho
• Alterar permissões no nível do projeto
• Referência rápida de acesso de stakeholders