Partilhar via


Remover, eliminar ou restaurar itens de trabalho no Azure Boards

Azure DevOps Serviços | Azure DevOps Server | Azure DevOps Server 2022

Os itens de trabalho podem ficar para sempre no seu repositório de dados de acompanhamento de trabalho. Você nunca precisa excluí-los. No entanto, convém configurar um processo de gerenciamento de item de trabalho para uma das seguintes ações:

Sugestão

Pode usar IA para ajudar nesta tarefa mais adiante neste artigo, ou consultar Enable AI assistance with Azure DevOps MCP Server para começar.

Action Description
Alterar estado Remova os itens de trabalho das listas de pendências e quadros alterando o estado do item de trabalho para Remover ou Recortar. O estado disponível para você é baseado no fluxo de trabalho atribuído ao tipo de item de trabalho.
Eliminar Remova itens de trabalho de listas de pendências, quadros e consultas. Os itens de trabalho excluídos são movidos para uma Lixeira.
Restaurar Recupere itens de trabalho excluídos restaurando-os da Lixeira.
Destroy Exclua permanentemente itens de trabalho, incluindo todos os dados do repositório de dados de rastreamento de trabalho.

Note

  • Não é possível arquivar itens de trabalho ou projetos no momento.
  • Para obter informações sobre a Reciclagem de Artefatos do Azure, consulte Delete and recover packages.

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

Prerequisites

Category Requirements
Acesso Geral - Para remover, excluir e restaurar itens de trabalho: Membro do grupo de Colaboradores
- Para eliminar permanentemente os itens de trabalho: Membro do grupo Administradores de Projeto ou com a permissão necessária.
- Os usuários com acesso de partes interessadas podem visualizar o conteúdo da Lixeira , mas não podem restaurar ou excluir permanentemente itens, independentemente das permissões concedidas
Alterar o estado para Remover ou Cortar - Permissão Caminho da Área definida como Permitir: Editar itens de trabalho neste nó
- Por padrão, os membros do grupo de Colaboradores têm essa permissão
Excluir e restaurar itens de trabalho - Conjunto de permissões ao nível de Projeto para Permitir: Eliminar e restaurar itens de trabalho
- Pelo menos Acesso básico
- Por padrão, os membros do grupo de Colaboradores têm essa permissão
Apagar ou destruir permanentemente os itens de trabalho - Conjunto de permissões a nível de projeto para Allow: Eliminar permanentemente itens de trabalho
- Por padrão, os membros do grupo Administradores do Projeto têm esta permissão
Apagar ou destruir itens de trabalho da linha de comandos - Conjunto de permissões ao nível do projeto para Allow: Eliminar permanentemente itens de trabalho
- Por defeito, os membros do grupo Administradores de Projeto têm esta permissão

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

Note

Os usuários com acesso de partes interessadas para um projeto público têm acesso total a todos os recursos de rastreamento de trabalho, assim como os usuários com acesso básico . Para obter mais informações, consulte Referência rápida sobre o acesso das partes interessadas.

Remover ou excluir vários itens de trabalho

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

No portal web, pode selecionar vários itens de trabalho de uma página de resultados de pendências ou consultas. 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, consulte 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, consulte Itens de trabalho - excluir.

Note

Esta funcionalidade está disponível a partir do Azure DevOps Server 2022.1.

Remover itens de trabalho

Quando mudas o Estado de um item de trabalho para Removido, efetivamente removes-no de uma vista de backlog ou quadro: atrasos de produto, portefólio e sprint, quadros e quadros de tarefas. O estado Removido corresponde ao estado da categoria de fluxo de trabalho Removido . Se definir estados personalizados de fluxo de trabalho, qualquer estado que você mapear para o estado da categoria de fluxo de trabalho Removido atuará de forma semelhante. Para obter mais informações, consulte Personalizar o fluxo de trabalho.

Captura de ecrã do formulário de item de trabalho, Alterar Estado para Removido.

Para evitar que itens removidos apareçam nas consultas, adicione uma cláusula que filtre no campo Estado .

Note

O estado Removido não é suportado com o processo Básico . Só é suportado com os tipos de itens de trabalho dos processos Agile, Scrum e CMMI. O processo Basic está disponível com Azure DevOps Services e Azure DevOps Server 2020 e versões posteriores.

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 no Contentor de Reciclagem até serem restaurados ou eliminados permanentemente. Para excluir um caso de teste, plano de teste ou outros tipos de item de trabalho relacionados ao teste, consulte Excluir artefatos de teste.

Você pode excluir itens de trabalho de uma das seguintes maneiras:

  • O formulário de item de trabalho
  • A página Itens de Trabalho menu Mais Ações
  • O menu de contexto do cartão do tabuleiro
  • Uma página de resultados de lista de pendências ou consulta
  • API REST
  1. Inicie a operação de exclusão:

  2. Confirme que deseja excluir os itens.

    Captura de ecrã da caixa de diálogo Confirmar eliminação.

Restaurar ou destruir itens de trabalho

Não é possível abrir itens de trabalho a partir da Caixa de Reciclagem. O Contentor de Reciclagem nunca apaga automaticamente os artigos. Ficam no Contentor de Reciclagem até os restaurares ou apagares permanentemente. A opção Eliminar permanentemente está disponível apenas se a sua permissão de Eliminar permanentemente itens de trabalho ao nível do projeto estiver definida como Permitir.

Restaure itens de trabalho removidos ou apague-os permanentemente da Lixeira do portal da Web.

  1. Selecione Quadros>Itens de Trabalho>Reciclagem.

    Captura de ecrã da página Painéis, Itens de Trabalho, Abrir Caixote do Lixo.

    Se não vir a opção Lixeira, escolha Mais comandos... e selecione uma opção do menu.

    Uma nova guia do navegador é aberta com a consulta que lista os itens de trabalho adicionados à Lixeira.

  2. Selecione os itens que deseja restaurar e, em seguida, escolha Restaurar.

    Captura de ecrã de Restaurar itens selecionados.

    Opcionalmente, você pode optar por excluir permanentemente os itens.

  3. Confirme a sua seleção.

Note

Artefactos de teste como planos de teste, conjuntos de testes e casos de teste são todos considerados itens de trabalho no Azure DevOps. No entanto, o método usado para Eliminar artefactos de teste em Azure Boards difere do método para eliminar itens de trabalho não testados. O Azure DevOps Services suporta um modelo de eliminação suave, onde os Planos de Teste e os Conjuntos de Testes ficam em estado de eliminação suave durante 14 dias após serem eliminados. Enquanto estão no estado de soft delete, podes restaurá-los.

Excluir ou destruir itens de trabalho da linha de comando

Usa o comando work-item delete do az boards para eliminar ou destruir um item de trabalho. Para começar, veja Comece com Azure DevOps CLI.

Note

Você pode restaurar itens de trabalho excluídos , mas não pode restaurar itens de trabalho destruídos .

az boards work-item delete --id
                           [--destroy]
                           [--org]
                           [--project]
                           [--yes] 
  • id: Obrigatório. A ID do item de trabalho.
  • destruir: Opcional. Exclua permanentemente este item de trabalho.
  • org: URL da organização Azure DevOps. Configure a organização por defeito usando az devops configure -d organization=ORG_URL. Se não configurar a organização por defeito ou se git config não selecionar uma organização, vai precisar de especificar este parâmetro. Exemplo: --org https://dev.azure.com/MyOrganizationName/.
  • projeto: Nome ou ID do projeto. Configure o projeto predefinido usando az devops configure -d project=NAME_OR_ID. Se não configurar o projeto padrão ou se git config não detetar um projeto, precisa de especificar este parâmetro.
  • Sim: Opcional. Não solicite confirmação.

O comando a seguir exclui permanentemente o bug com o ID 864 e não solicita a confirmação.

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

Excluir e restaurar processos

Quando apagas 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 suportar a rastreabilidade.
  • Preserva completamente o item de trabalho, incluindo todas as atribuições de campo, anexos, etiquetas e links.
  • Torna o item de trabalho não consultável, por isso não aparece em nenhuma experiência de acompanhamento de trabalho, resultado de consulta ou relatório.
  • Atualiza os gráficos corretamente. Os gráficos CFD, de velocidade, de burndown e simplificados são atualizados para remover itens de trabalho eliminados.
  • Remova as extensões de rastreamento de trabalho.
  • Preserva dados de tendência, exceto o valor mais recente.
  • Remove o item de trabalho do armazém/cubo de dados, de forma semelhante a se fosse removido permanentemente.

Quando restaura um item de trabalho, Azure DevOps realiza as seguintes ações:

  • Cria uma nova revisão do item de trabalho.
  • Atualiza os campos Alterado Por/Data de Alteração para suportar a rastreabilidade.
  • Torna o item de trabalho consultável.
  • Mantém todos os campos inalterados.
  • Adiciona duas novas revisões ao histórico, uma para eliminação e outra para restauro.
  • Reanexa extensões de rastreamento de trabalho.
  • Atualiza os gráficos corretamente. Os gráficos CFD, velocidade, burndown e leves são atualizados para incluir os itens de trabalho restaurados.
  • Restaura dados de tendência.
  • Adiciona o item de trabalho de volta ao armazém/cubo de dados.
  • Configura os campos de caminho de área ou de iteração para o nó raiz se o caminho de área anterior ou os caminhos de iteração forem eliminados.

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

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

Usa IA para encontrar itens de trabalho para remover

Se ligares o Azure Boards MCP Server ao teu agente de IA em modo agente, podes usar prompts em linguagem natural para encontrar e atualizar itens de trabalho antes de os remover ou apagar.

Tarefa Exemplo de prompt
Alterar estado para Removido Change the state of work items #101, #102, and #103 to Removed
Encontrar itens no estado Removido List all work items in the Removed state in area path <Contoso>\\OldFeature
Encontra objetos velhos para limpar Show me all work items in the 'New' state that haven't been updated in the last 90 days
Identificar itens encerrados List all work items closed more than a year ago in the <Contoso> project
Encontre trabalho abandonado List active work items in <Contoso> assigned to people who are no longer on the team
Identificar candidatos duplicados Show bugs in <Contoso> with the same title or very similar titles
Encontre itens sem atividade List work items in <Contoso> that never had a state change and were created more than 60 days ago
Impacto da remoção de pré-visualização Show all child work items linked to user story <1234> so I can review before removing it
Mudança de estado em massa Set all user stories in area path <Contoso\\DeprecatedModule> to the Removed state
Itens removidos pela auditoria List all work items in <Contoso> that were moved to the Removed state in the last 30 days and show who changed them

Note

O modo Agente e o Servidor MCP usam linguagem natural, por isso pode ajustar estes prompts ou fazer perguntas de seguimento para refinar os resultados. O Servidor MCP pode atualizar os estados dos itens de trabalho, mas não pode eliminar, restaurar ou destruir itens de trabalho.