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
Artefactos de teste como planos de teste, suites de testes e casos de teste são todos itens de trabalho no Azure DevOps. Eliminá-los é permanente no Azure DevOps Server, mas recuperável no Azure DevOps Services. Compreender o processo de eliminação e as opções de recuperação ajuda-o a eliminar em segurança.
Sugestão
Pode usar IA para ajudar nesta tarefa mais adiante neste artigo, ou consultar Habilitar assistência de IA com Azure DevOps MCP Server para começar.
Compreender o comportamento de eliminação
O comportamento de eliminação difere entre Azure DevOps Services e Azure DevOps Server. Compreender como cada plataforma lida com a eliminação e que opções de recuperação estão disponíveis ajuda-o a eliminar com confiança.
Modelo de eliminação do Azure DevOps Services
O Azure DevOps Services suporta um modelo de soft deletion. Quando apaga planos de teste ou conjuntos de testes, eles entram numa janela de recuperação de 14 dias antes da eliminação permanente.
O que acontece quando apagas artefactos de teste
Remover do armazenamento de dados TCM
- O artefato de teste excluído é removido do armazenamento de dados Test Case Management (TCM).
- 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, dependendo do número de artefatos que estão sendo excluídos.
Supressão suave
- Toda a informação tanto no armazenamento de dados de rastreamento de itens de trabalho como no armazenamento de dados TCM é colocada em estado de eliminação suave, podendo restaurá-la dentro de 14 dias.
Supressão permanente
- Não podes reativar ou restaurar dados apagados em circunstância alguma.
Para restaurar um plano de testes ou conjunto de testes eliminado durante a fase de eliminação suave de 14 dias:
- Execute a API List para OBTER o Test Plan/Test Suite que você pretende restaurar.
- Se a API List devolver uma resposta que inclua o plano de testes ou o conjunto de testes a restaurar, execute a API PATCH para Plano de Testes/Conjunto de Testes para os restaurar.
- Se a API da Lista não devolver o plano de testes ou o conjunto de testes que queres restaurar, é eliminado permanentemente do sistema e não pode ser restaurado.
Restaurar um plano ou conjunto de testes eliminado
Durante a fase de eliminação suave de 14 dias, pode restaurar planos e conjuntos de testes apagados:
- Execute a API List para obter o Plano de Teste/Conjunto de Testes que pretende restaurar.
- Se a API List devolver uma resposta que inclua o plano de teste ou o conjunto a restaurar, execute a API PATCH para Plano de Teste/Conjunto de Testes para os restaurar.
- Se a API da Lista não devolver o plano de testes ou a suite que queres restaurar, é eliminado permanentemente e não pode ser recuperado.
Limitações importantes
- Após a eliminação, os planos de teste e os conjuntos de testes ficam em estado de eliminação suave durante 14 dias. Depois deste período, são eliminados permanentemente e não podem ser restaurados.
- Quando um plano ou conjunto de testes é restaurado, todos os artefactos filhos (conjuntos de testes, casos de teste) também são restaurados.
- Restaurar execuções de teste associadas a planos e suites de testes não é suportado.
- Casos de teste eliminados por APIs ou métodos não portais são eliminados permanentemente e não podem ser restaurados.
Modelo de eliminação do Azure DevOps Server
Importante
Eliminação Permanente e Irreversível: O Azure DevOps Server suporta apenas a eliminação permanente de artefactos de teste, incluindo planos de teste, conjuntos de testes, casos de teste, passos partilhados e parâmetros partilhados. Os artefatos excluídos não podem ser restaurados e todos os itens filho associados, como resultados dos testes, também são removidos. Além disso, a eliminação em massa de artefactos de teste não é suportada.
Faça backup de qualquer informação necessária antes de apagar artefactos de teste, pois esta ação não pode ser desfeita.
O que acontece quando apagas artefactos de teste
Remover do armazenamento de dados TCM:
- O artefato de teste excluído é removido do armazenamento de dados Test Case Management (TCM).
- 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, dependendo do número de artefatos que estão sendo excluídos.
Supressão permanente:
- O processo elimina permanentemente toda a informação tanto no armazenamento de dados de rastreio de itens de trabalho como no armazenamento de dados TCM.
- Não podes reativar ou restaurar dados apagados em circunstância alguma.
Pré-requisitos
| Categoria | Requerimentos |
|---|---|
| Níveis de acesso | Basic + Test Plans ou Visual Studio Enterprise para gerir ou eliminar artefactos de teste. Os utilizadores com acesso Básico só podem eliminar casos de teste órfãos (casos de teste não ligados a nenhum plano ou conjunto de testes). |
| Permissões — execuções de teste | Membro do grupo Project Administrators ou com a permissão Delete test runs ao nível do projeto definida como Permitir. |
| Permissões — planos e conjuntos de testes | Membro do grupo Project Administrators ou com a permissão ao nível do nó do Caminho de Área Gerir planos de teste ou Gerir conjuntos de testes definida como Permitir. |
Nota
Se não for administrador do projeto, precisa tanto da permissão Eliminar execuções de teste ao nível do projeto como das permissões aplicáveis ao nível do nó do Caminho da Área.
Sugestão
Não tem a certeza se tem as permissões corretas? Consulte a secção Verificar permissões de eliminação .
Tipos de item de trabalho que suportam a experiência de teste
A imagem a seguir ilustra o conjunto de tipos de item de trabalho que oferecem suporte à experiência de teste e funcionam com o Microsoft Test Manager. Esses tipos de item de trabalho são ligados usando os tipos de ligação mostrados.
No portal da Web ou no Microsoft Test Manager, você pode exibir quais casos de teste são definidos para um conjunto de testes e quais pacotes de teste são definidos para um plano de teste. No entanto, 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, consulte Consulta baseada em campos de integração de compilação e teste.
Excluir artefatos de teste
Warning
A eliminação de artefactos de teste é permanente e não pode ser anulada. No Azure DevOps Services, tem 14 dias para restaurar os Planos de Teste e Suites de Testes apagados. No Azure DevOps Server, a eliminação é imediata e permanente. Verifique cuidadosamente a sua seleção antes de confirmar a eliminação.
Eliminar um caso de teste
- Aceda ao caso de teste que pretende eliminar.
- Selecione Eliminar Permanentemente no menu de ações.
- Confirma a eliminação no diálogo que aparece.
Nota
A opção de Eliminar Permanentemente está disponível apenas se tiver as permissões e o nível de acesso necessários.
Eliminar um conjunto de testes
- Vai ao conjunto de testes que queres eliminar.
- Selecione Eliminar Permanentemente no menu de ações.
- Confirma a eliminação no diálogo que aparece.
Eliminar um plano de teste
Opção A: Eliminar da vista do plano de teste
- Vai ao plano de teste que queres apagar.
- Selecione Eliminar Permanentemente no menu de ações.
- Confirma a eliminação no diálogo que aparece.
Opção B: Apagar do hub de Planos de Teste
- Abra Planos de Teste.
- Encontre o plano de teste que quer eliminar na lista.
- Clique com o botão direito no plano do teste (ou selecione o ícone ··· menu ao lado do plano).
- Selecione Eliminar.
- Confirme a exclusão.
Eliminar passos ou parâmetros partilhados
- Abra o passo partilhado ou o parâmetro partilhado que quer eliminar.
- Selecione Mostrar referências para ver todos os casos de teste que ligam a este item.
- Para cada caso de teste, abre-o e remove o link para o passo ou parâmetro partilhado.
- Depois de remover todas as referências, volte ao passo ou parâmetro partilhado e selecione Eliminar permanentemente.
- Confirme a exclusão.
Nota
Se a opção de Apagar Permanentemente estiver desativada, verifique se removeu todas as referências. O sistema bloqueia a eliminação de passos ou parâmetros partilhados que os casos de teste ainda referenciam.
Verificar permissões de eliminação
Antes de tentar eliminar artefactos de teste, verifique se tem as permissões necessárias:
- Vá para Configurações do Projeto>Permissões.
- Procure a sua conta de utilizador ou equipa.
- Verifique se as seguintes permissões estão definidas como Permitir:
- Eliminar execuções de teste (para apagar resultados de teste)
- Gerir planos de teste ou Gerir conjuntos de testes (para apagar planos e suítes de testes)
- Verifique se o seu nível de acesso é Básico + Planos de Teste ou superior.
- Se as permissões não estiverem corretas, contacte o administrador do seu projeto.
Para mais informações, consulte Gerenciar permissões de artefactos de teste.
Resolver problemas de eliminação de artefactos de teste
A opção "Apagar permanentemente" não aparece
Causas possíveis:
- O seu nível de acesso é inferior a Básico + Planos de Teste.
- Não tens as permissões necessárias para este artefacto.
- Não tens permissões de Caminho de Área para este local.
Solução:
- Verifique o seu nível de acesso: Vá a Segurança do Perfil> para ver o seu nível de acesso atual.
- Verifique as suas permissões: Veja Verificar permissões de eliminação.
- Se não for administrador de projetos, peça ao seu administrador para atribuir as permissões necessárias.
A eliminação é lenta ou com tempo limite
Causas possíveis:
- O artefacto de teste tem muitos itens subordinados (casos de teste, conjuntos de testes, resultados de teste).
- Um trabalho em segundo plano ainda está a processar a eliminação.
- Problemas de conectividade de rede
Solução:
- As deleções grandes podem demorar vários minutos. Reserve tempo para que o trabalho de fundo seja concluído.
- Atualize a página após esperar alguns minutos para verificar a eliminação.
- Verifique a sua conectividade de rede e tente novamente.
O artefacto continua a aparecer depois de ser eliminado (Azure DevOps Services)
Possível causa:
- O artefacto está em estado de eliminação suave (janela de recuperação de 14 dias).
Solução:
- No Azure DevOps Services, os Planos de Teste e Suites de Testes eliminados permanecem visíveis em algumas vistas durante a janela de recuperação de 14 dias.
- O artefacto é eliminado permanentemente após 14 dias.
- Para restaurar o artefacto durante esta janela, consulte Restaurar um plano ou conjunto de teste eliminado (na secção introdutória acima).
Não é possível apagar passos ou parâmetros partilhados
Possível causa:
- O passo ou parâmetro partilhado ainda tem referências de casos de teste.
Solução:
- Abra o passo ou parâmetro partilhado.
- Selecione Mostrar referências para ver todos os casos de teste ligados.
- Abra cada caso de teste e remova o link.
- Tenta eliminar novamente.
Para mais informações, consulte Eliminar passos partilhados ou parâmetros partilhados acima.
Eliminar artefactos de teste via API REST
Também pode eliminar artefactos de teste de forma programática usando a API REST do Azure DevOps. Este método é útil para automação, eliminação em lote ou integração com pipelines de CI/CD.
Eliminar 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]
Eliminar 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]
Eliminar 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]
Nota
- Substitua
{organization},{project},{planId},{suiteId}, , e{testCaseId}por valores reais. - Use a versão
7.1da API ou posterior. Consulte o controlo de versões da API REST para conhecer as versões atuais. - No Azure DevOps Services, pode restaurar artefactos eliminados através da API durante a janela de soft delete de 14 dias.
- No Azure DevOps Server, a eliminação através da API é permanente.
- Autentique usando um Token de Acesso Pessoal (PAT) ou token OAuth.
Para detalhes completos da API, consulte a referência da API de reciclagem do Plano de Teste.
Usar IA para eliminar artefactos de teste
Se configurar o Azure DevOps MCP Server para a sua organização, pode usá-lo para encontrar e eliminar artefactos de teste em grande escala, usando linguagem natural. Este método é especialmente útil para eliminações em massa ou consultas complexas que são difíceis de realizar manualmente.
Aqui estão padrões comuns para consultas em linguagem natural:
| Tarefa | Exemplo de prompt |
|---|---|
| Eliminar um plano de teste | Delete test plan <TestPlanName> in project <Contoso> |
| Encontre antigos artefactos de teste | 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 |
| Encontrar casos de teste duplicados | Identify duplicate test cases in test suite <SuiteName> that have the same title and steps |
| Eliminar em massa casos de teste por etiqueta | Delete all test cases marked with tag "deprecated" in project <Contoso> |
| Remover passos partilhados órfãos | Find shared steps in project <Contoso> that aren't referenced by any test cases |
| Verificar o impacto da eliminação | Before I delete test plan <TestPlanName>, show me how many test cases, test suites, and test runs are associated with it |
| Apagar os resultados antigos dos testes | Delete all test results older than 1 year from test plan <TestPlanName> |
| Planear a limpeza de artefactos | What test artifacts in project <Contoso> can I safely delete to clean up the test data |
Nota
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. No Azure DevOps Server, a eliminação de artefactos de teste é permanente e não pode ser restaurada, por isso verifique cuidadosamente a sua seleção.