Remover, excluir ou restaurar itens de trabalho no Azure Boards

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Os itens de trabalho podem permanecer em seu banco de dados de acompanhamento de trabalho para sempre. 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:

Para mover o item de trabalho de um projeto para outro ou alterar o tipo de item de trabalho, confira Mover itens de trabalho e alterar o tipo de item de trabalho.

Prerequisites

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

Quando você altera o estado de um item de trabalho para Removido, você o remove efetivamente de uma visualização de lista de pendências ou quadro: listas de pendências de produto, portfólio e sprint, quadros e Quadro 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 obter mais informações, consulte Personalizar o fluxo de trabalho.

Para impedir que itens removidos sejam exibidos em consultas, adicione uma cláusula que filtra no 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. Os itens permanecem na Lixeira até você restaurá-los ou excluí-los permanentemente. 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. A Lixeira nunca exclui automaticamente os itens. Eles permanecem na Lixeira até você restaurá-los ou excluí-los permanentemente. A opção De exclusão permanente estará disponível somente 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ê excluir um item de trabalho, Azure DevOps executa as seguintes ações:

• Gera uma nova revisão do item de trabalho.
• Atualiza os campos Alterado por/Data de Alteração para dar suporte à rastreabilidade.
• Preserva completamente o item de trabalho, incluindo todas as atribuições de campo, anexos, tags e links.
• Torna o item de trabalho não consultável, portanto, ele não aparece em nenhuma experiência de rastreamento de trabalho, resultado de consulta ou relatório.
• Atualiza os gráficos corretamente. Os gráficos CFD, velocity, burndown e lightweight são atualizados para remover itens de trabalho excluídos.
• Remove extensões de acompanhamento de trabalho.
• Preserva dados de tendência, exceto pelo valor mais recente.
• Remove o item de trabalho do data warehouse/cubo como se tivesse sido removido permanentemente.

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

• Cria uma nova revisão do item de trabalho.
• Atualiza os campos Alterado Por/Data de Alteração para dar suporte à rastreabilidade.
• Torna o item de trabalho consultável.
• Mantém todos os campos inalterados.
• Adiciona duas novas revisões ao histórico, uma para exclusão e outra para restauração.
• Reanexa extensões de acompanhamento de trabalho.
• Atualiza os gráficos corretamente. Os gráficos CFD, velocity, burndown e lightweight são atualizados para incluir os itens de trabalho restaurados.
• Restaura dados de tendência.
• Adiciona o item de trabalho de volta ao data warehouse/cubo.
• Configura os campos de caminho de área ou de iteração para o nó raiz se o caminho da área anterior 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

Usar a IA para localizar itens de trabalho para remover

Se você conectar o servidor MCP Azure Boards ao agente de IA no modo de agente, poderá usar prompts de linguagem natural para localizar e atualizar itens de trabalho antes de removê-los ou excluí-los.

Conteúdo relacionado

• 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