Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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.
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
Inicie a operação de exclusão:
No formulário de item de trabalho, abra o item de trabalho, escolha
Ações e selecione Excluir.
Para excluir vários itens de trabalho, selecione-os várias vezes em uma lista de pendências ou de resultados de consulta, escolha o menu de
contexto e selecione Excluir.
Para excluir um item de trabalho do seu quadro ou quadro de tarefas, escolha o menu de
contexto do cartão e selecione Excluir.
Confirme que deseja excluir os itens.
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
Selecione Quadros>Itens de Trabalho>Reciclagem.
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.
Selecione os itens que deseja restaurar e, em seguida, escolha Restaurar.
Opcionalmente, você pode optar por excluir permanentemente os itens.
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 segit confignã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 segit confignã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.