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:

Ação Descrição
Alterar o estado Remova a exibição de itens de trabalho em listas de pendências e placas alterando o item de trabalho Estado para Remover ou Recortar. O estado disponível para você baseia-se no fluxo de trabalho atribuído ao tipo de item de trabalho.
Delete Remova itens de trabalho de listas de pendências, placas 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.
Destruir Exclua permanentemente itens de trabalho, incluindo todos os dados do armazenamento de dados de acompanhamento de trabalho.

Observação

  • Você não pode arquivar itens de trabalho ou projetos no momento.
  • Para obter informações sobre a Lixeira do Azure Artifacts, confira Excluir e recuperar pacotes.

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

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.

Tarefa

Permissões exigidas


  • Ter a permissão Caminho da Área definida como Permitir: editar itens de trabalho neste nó
  • Por padrão, os membros do grupo Colaboradores tem essa permissão.
  • Ter a permissão no nível do projeto definida como Permitir: excluir e restaurar itens de trabalho
  • Ter acesso Básico ou superior.
  • Por padrão, os membros do grupo Colaboradores tem essa permissão.
  • Ter a permissão no nível do projeto definida como Permitir: excluir permanentemente itens de trabalho
  • Por padrão, os membros do grupo Administradores de Projeto têm essa permissão.
  • Ter a permissão no nível do projeto definida como Permitir: excluir permanentemente itens de trabalho
  • Por padrão, os membros do grupo Administradores de Projeto têm essa permissão.

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

Observação

Os usuários com acesso de Stakeholders para um projeto público têm acesso completo a todos os recursos de acompanhamento de trabalho, assim como os usuários com acesso Básico. Para mais informações, veja Referência rápida de acesso das partes interessadas.

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.

Observação

Esse recurso está disponível a partir do Azure DevOps Server 2022.1.

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.

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

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

Observação

Não há suporte para o estado Removido com o processo Básico. Ele só tem suporte com os tipos de item de trabalho de processo Agile, Scrum e CMMI. O processo Básico está disponível quando você adiciona um projeto ao Azure DevOps Services ou ao Azure DevOps Server 2019 Atualização 1.

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.

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

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

    • No formulário do item de trabalho, abra o item de trabalho, escolha Ações e selecione Excluir.

    Captura de tela do formulário do item de trabalho, menu Ações, escolha Excluir.

    Captura de tela do menu Ações de seleção múltipla da lista de pendências, escolha Excluir.

    • Para excluir um item de trabalho de seu Kanban ou Taskboard, escolha o menu de contexto do cartão e selecione Excluir.

    Captura de tela do menu de contexto do cartão do quadro Kanban, escolha Excluir.

  2. Confirme se deseja excluir os itens.

    Captura de tela da caixa de diálogo Confirmar exclusão.

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.

Restaure os itens de trabalho excluídos ou exclua-os permanentemente da Lixeira do portal da Web.

  1. Selecione Boards>Item de trabalho>Lixeira.

    Captura de tela de Quadros, página Itens de Trabalho, abrir Lixeira.

    Se você não vir a opção Lixeira, escolha Mais comandos... e selecione no menu de opções.

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

  2. Selecione os itens que deseja restaurar e escolha Restaurar.

    Captura de tela de Restaurar itens selecionados.

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

  3. Confirme a seleção.

Observação

Os artefatos de teste excluídos não aparecem na Lixeira e não podem ser restaurados. Quando você exclui um artefato de teste, todos os itens filho associados, como pacotes de teste filho, pontos de teste em todas as configurações, testadores (o item de trabalho de caso de teste subjacente não é excluído), o histórico de resultados do teste e outro histórico associado também são excluídos.

Excluir ou destruir itens de trabalho da linha de comando

Você pode excluir ou destruir um item de trabalho com o comando az boards work-item delete. Para começar, confira Introdução à CLI do Azure DevOps.

Observação

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] 

Parâmetros

  • id: obrigatório. A ID do item de trabalho.
  • destroy: opcional. Exclui permanentemente este item de trabalho.
  • org: a URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado usando git config. Exemplo: --org https://dev.azure.com/MyOrganizationName/.
  • project: nome ou ID do projeto. Você pode configurar o grupo padrão usando az devops configure -d project=NAME_OR_ID. Obrigatório se não estiver configurado como padrão ou selecionado usando git config.
  • yes: opcional. Não solicita confirmação.

Exemplo

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

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: