Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Serviços Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022
Artefatos de teste, como planos de teste, conjuntos de testes e casos de teste, são todos itens de trabalho em Azure DevOps. A exclusão deles é permanente no Azure DevOps Server, mas é possível recuperá-los no Azure DevOps Services. Entender o processo de exclusão e as opções de recuperação ajuda você a excluir com segurança.
Tip
Você pode usar a IA para ajudar nessa tarefa mais adiante neste artigo ou consulte Ativar a assistência de IA com o Azure DevOps Server MCP para começar.
Entender o comportamento de exclusão
O comportamento de exclusão difere entre Azure DevOps Services e Azure DevOps Server. Entender como cada plataforma lida com a exclusão e quais opções de recuperação estão disponíveis ajuda você a excluir com confiança.
Modelo de exclusão dos Serviços Azure DevOps
Azure DevOps Services dá suporte a um modelo de exclusão reversível. Quando você exclui planos de teste ou conjuntos de testes, eles entram em uma janela de recuperação de 14 dias antes da exclusão permanente.
O que acontece quando você exclui artefatos de teste
Remover do armazenamento de dados TCM
- O artefato de teste excluído é removido do armazenamento de dados TCM (Gerenciamento de Caso de Teste).
- O item de trabalho subjacente associado ao artefato de teste é excluído.
Excluir itens filhos
- Um trabalho em segundo plano inicia a exclusão de todos os itens filho do armazenamento de dados TCM e dos itens de trabalho subjacentes.
- Esse processo pode levar alguns minutos, de acordo com o número de artefatos que estão sendo excluídos.
Exclusão temporária
- Todas as informações no armazenamento de dados de acompanhamento de item de trabalho e no armazenamento de dados do TCM ficam no status de exclusão temporária e podem ser restauradas dentro de 14 dias.
Exclusão permanente
- Você não pode reativar ou restaurar dados excluídos em nenhuma circunstância.
Para restaurar um plano de teste excluído ou um conjunto de testes durante a fase de exclusão temporária de 14 dias:
- Execute a API de Listagem para obter o Plano de Teste/Suíte de Testes que você pretende restaurar.
- Se a API de listas retornar uma resposta com o plano de teste ou o conjunto de testes para restaurar, execute a API PATCH para Plano de teste/Conjunto de testes para restaurá-los.
- Se a API de Lista não retornar o plano de teste ou o conjunto de testes que você deseja restaurar, ele será excluído permanentemente do sistema e não poderá ser restaurado.
Restaurar um plano ou um pacote de teste excluído
Durante a fase de exclusão temporária de 14 dias, você pode restaurar planos de teste e conjuntos excluídos:
- Execute a API List para obter o Plano de Teste/Conjunto de Testes que você deseja restaurar.
- Se a API List retornar uma resposta com o plano de teste ou a suíte a ser restaurada, execute a API PATCH de Test Plan/Test Suite para restaurá-los.
- Se a API de Lista não retornar o plano de teste ou o pacote que você deseja restaurar, ele será excluído permanentemente e não poderá ser recuperado.
Limitações importantes
- Após a exclusão, os planos de teste e os conjuntos de teste ficam em estado de exclusão reversível por 14 dias. Após esse período, eles são excluídos permanentemente e não podem ser restaurados.
- Quando um plano de teste ou conjunto de testes é restaurado, todos os artefatos filhos (conjuntos de testes, casos de teste) também são restaurados.
- Não há suporte para restaurar execuções de teste associadas a planos de teste e pacotes.
- Os casos de teste excluídos por meio de APIs ou métodos não portal são excluídos permanentemente e não podem ser restaurados.
Modelo de exclusão do Azure DevOps Server
Importante
Exclusão permanente e irreversível: Azure DevOps Server dá suporte apenas à exclusão permanente de artefatos de teste, incluindo planos de teste, conjuntos de testes, casos de teste, etapas compartilhadas e parâmetros compartilhados. Os artefatos excluídos não podem ser restaurados e todos os itens filhos associados, como resultados de teste, também são removidos. Além disso, não há suporte para a exclusão em massa de artefatos de teste.
Faça backup de todas as informações necessárias antes de excluir artefatos de teste, pois essa ação não pode ser desfeita.
O que acontece quando você exclui artefatos de teste
Remover do armazenamento de dados TCM:
- O artefato de teste excluído é removido do armazenamento de dados TCM (Gerenciamento de Caso de Teste).
- O item de trabalho subjacente associado ao artefato de teste é excluído.
Excluir itens filhos:
- Um trabalho em segundo plano inicia a exclusão de todos os itens filho do armazenamento de dados TCM e dos itens de trabalho subjacentes.
- Esse processo pode levar alguns minutos, de acordo com o número de artefatos que estão sendo excluídos.
Exclusão permanente:
- O processo exclui permanentemente todas as informações em ambos os armazenamentos de dados: o de rastreamento de itens de trabalho e o do TCM.
- Você não pode reativar ou restaurar dados excluídos em nenhuma circunstância.
Pré-requisitos
| Categoria | Requisitos |
|---|---|
| Níveis de acesso | Basic + Test Plans ou Visual Studio Enterprise para gerenciar ou excluir artefatos de teste. Os usuários com acesso Básico só podem excluir casos de teste órfãos (casos de teste não vinculados a nenhum plano de teste ou pacote). |
| Permissões – execuções de teste | Membro do grupo Administradores do Projeto ou com a permissão Excluir execuções de teste no nível do projeto definida como Permitir. |
| Permissões – planos de teste e pacotes | Membro do grupo Administradores de Projeto ou com permissão no nível de nó do Caminho da Área Gerenciar planos de teste ou Gerenciar conjuntos de testes definida como Permitir. |
Observação
Se você não for administrador do projeto, precisará tanto da permissão Excluir execuções de teste, no nível de projeto, quanto das permissões aplicáveis no nível de nó do Caminho da Área.
Tip
Não tem certeza se tem as permissões certas? Consulte a seção Verificar permissões de exclusão .
WIT (Tipos de item de trabalho) que dão suporte à experiência de teste
A imagem a seguir ilustra o conjunto de tipos de item de trabalho que dão suporte à experiência de teste e funcionam com o Microsoft Test Manager. Esses tipos de item de trabalho são vinculados juntos usando os tipos de link mostrados.
Usando o portal da Web ou o Microsoft Test Manager, é possível visualizar que casos de teste estão definidos para um conjunto de testes, e quais conjuntos de testes estão definidos para um plano de teste. Porém, esses objetos não estão conectados uns aos outros por meio de tipos de link. Para obter definições de cada campo usado nesses tipos de item de trabalho, confira Consulta com base em campos de integração de build e teste.
Excluir artefatos de teste
Warning
A exclusão de artefatos de teste é permanente e não pode ser desfeita. No Azure DevOps Services, você tem 14 dias para restaurar planos de teste e pacotes de teste excluídos. Em Azure DevOps Server, a exclusão é imediata e permanente. Verifique sua seleção cuidadosamente antes de confirmar a exclusão.
Excluir um caso de teste
- Vá para o caso de teste que você deseja excluir.
- Selecione Excluir permanentemente no menu ações.
- Confirme a exclusão na caixa de diálogo exibida.
Observação
A opção De exclusão permanente só estará disponível se você tiver as permissões e o nível de acesso necessários.
Excluir um conjunto de testes
- Vá para o pacote de testes que você deseja excluir.
- Selecione Excluir permanentemente no menu ações.
- Confirme a exclusão na caixa de diálogo exibida.
Excluir um plano de teste
Opção A: Excluir da visualização do plano de teste
- Vá para o plano de teste que você deseja excluir.
- Selecione Excluir permanentemente no menu ações.
- Confirme a exclusão na caixa de diálogo exibida.
Opção B: Excluir do hub de Planos de Teste
- Abra Planos de Teste.
- Localize o plano de teste que você deseja excluir na lista.
- Clique com o botão direito do mouse no plano de teste (ou selecione o ícone do menu ··· ao lado do plano).
- Selecione Excluir.
- Confirme a exclusão.
Excluir etapas compartilhadas ou parâmetros compartilhados
- Abra a etapa compartilhada ou o parâmetro compartilhado que você deseja excluir.
- Selecione Mostrar referências para exibir todos os casos de teste que vinculam a este item.
- Para cada caso de teste, abra-o e remova o link para a etapa ou parâmetro compartilhado.
- Depois de remover todas as referências, retorne à etapa ou parâmetro compartilhado e selecione Excluir permanentemente.
- Confirme a exclusão.
Observação
Se a opção De exclusão permanente estiver desabilitada, verifique se você removeu todas as referências. O sistema bloqueia a exclusão de etapas ou parâmetros compartilhados que os casos de teste ainda fazem referência.
Verificar permissões de exclusão
Antes de tentar excluir artefatos de teste, verifique se você tem as permissões necessárias:
- Vá para Configurações do projeto>Permissões.
- Pesquise sua conta de usuário ou equipe.
- Verifique se as seguintes permissões estão definidas como Permitir:
- Excluir execuções de teste (para excluir resultados de teste)
- Gerenciar planos de teste ou gerenciar pacotes de teste (para excluir planos de teste e pacotes)
- Verifique se o nível de acesso é Básico + Planos de Teste ou superior.
- Se as permissões não estiverem corretas, contate o administrador do projeto.
Para obter mais informações, consulte Gerenciar permissões de artefatos de teste.
Solucionar problemas na exclusão de artefatos de teste
A opção "Excluir permanentemente" não aparece
Causas possíveis::
- Seu nível de acesso é menor que Basic + Test Plans.
- Você não tem as permissões necessárias para este artefato.
- Você não tem permissões de Area Path para esse local.
Solução:
- Verifique seu nível de acesso: Vá para Perfil>Segurança para ver seu nível de acesso atual.
- Verifique suas permissões: consulte Verificar permissões de exclusão.
- Se você não for um administrador de projeto, peça ao administrador para atribuir as permissões necessárias.
A exclusão é lenta ou expira
Causas possíveis::
- O artefato de teste tem muitos itens filhos (casos de teste, conjuntos de testes, resultados de teste).
- Uma tarefa em segundo plano ainda está processando a exclusão.
- Problemas de conectividade de rede
Solução:
- Exclusões grandes podem levar mais tempo. Dê tempo para que o trabalho em segundo plano seja concluído.
- Atualize a página depois de aguardar alguns minutos para verificar a exclusão.
- Verifique a conectividade de rede e tente novamente.
O artefato ainda aparece após a exclusão (Azure DevOps Services)
Possível causa:
- O artefato está em estado de exclusão temporária (janela de recuperação de 14 dias).
Solução:
- Nos Serviços Azure DevOps, planos de teste excluídos e Conjuntos de Testes permanecem visíveis em alguns modos de exibição durante a janela de recuperação de 14 dias.
- O artefato é excluído permanentemente após 14 dias.
- Para restaurar o artefato durante esta janela, consulte Restaurar um plano de teste excluído ou uma suíte (na seção de introdução acima).
Não é possível excluir etapas ou parâmetros compartilhados
Possível causa:
- A etapa ou parâmetro compartilhado ainda tem referências de casos de teste.
Solução:
- Abra a etapa ou o parâmetro compartilhado.
- Selecione Mostrar referências para exibir todos os casos de teste vinculados.
- Abra cada caso de teste e remova o link.
- Tente excluir novamente.
Para obter mais informações, consulte Excluir etapas compartilhadas ou parâmetros compartilhados acima.
Excluir artefatos de teste por meio da API REST
Você também pode excluir artefatos de teste programaticamente usando a API REST Azure DevOps. Esse método é útil para automação, exclusão em massa ou integração com pipelines de CI/CD.
Excluir um caso de teste
DELETE https://dev.azure.com/{organization}/{project}/_apis/test/testcase/{testCaseId}?api-version=7.1
Authentication: Basic [PAT or OAuth token]
Excluir um conjunto de testes
DELETE https://dev.azure.com/{organization}/{project}/_apis/test/plans/{planId}/suites/{suiteId}?api-version=7.1
Authentication: Basic [PAT or OAuth token]
Excluir um plano de teste
DELETE https://dev.azure.com/{organization}/{project}/_apis/test/plans/{planId}?api-version=7.1
Authentication: Basic [PAT or OAuth token]
Observação
- Substitua
{organization},{project},{planId},{suiteId}e{testCaseId}com valores reais. - Use a versão
7.1da API ou posterior. Verifique o versionamento da API REST para ver as versões atuais. - No Azure DevOps Services, você pode restaurar artefatos excluídos por meio da API durante a janela de exclusão temporária de 14 dias.
- Em Azure DevOps Server, a exclusão por meio da API é permanente.
- Autentique usando um TOKEN de Acesso Pessoal (PAT) ou token OAuth.
Para obter todos os detalhes da API, consulte a referência da API da lixeira do Plano de Teste.
Usar a IA para excluir artefatos de teste
Se você configurar o servidor MCP Azure DevOps para sua organização, poderá usá-lo para localizar e excluir artefatos de teste em escala usando linguagem natural. Esse método é especialmente útil para exclusões em massa ou consultas complexas que são difíceis de executar manualmente.
Aqui estão padrões comuns para consultas em linguagem natural:
| Tarefa | Prompt de exemplo |
|---|---|
| Excluir um plano de teste | Delete test plan <TestPlanName> in project <Contoso> |
| Localizar artefatos de teste antigos | List all test plans in project <Contoso> that aren't updated in the last 6 months |
| Remover conjuntos de testes abandonados | Find all test suites in project <Contoso> that have no test runs in the last 90 days and delete them |
| Localizar casos de teste duplicados | Identify duplicate test cases in test suite <SuiteName> that have the same title and steps |
| Excluir casos de teste em massa por tag | Delete all test cases marked with tag "deprecated" in project <Contoso> |
| Remover etapas compartilhadas órfãs | Find shared steps in project <Contoso> that aren't referenced by any test cases |
| Verificar o impacto da exclusão | Before I delete test plan <TestPlanName>, show me how many test cases, test suites, and test runs are associated with it |
| Excluir resultados antigos do teste | Delete all test results older than 1 year from test plan <TestPlanName> |
| Planejar a limpeza de artefatos | What test artifacts in project <Contoso> can I safely delete to clean up the test data |
Observação
O modo de agente e o servidor MCP usam linguagem natural, para que você possa ajustar esses prompts ou fazer perguntas de acompanhamento para refinar os resultados. Em Azure DevOps Server, a exclusão do artefato de teste é permanente e não pode ser restaurada, portanto, verifique sua seleção com cuidado.