Eliminare gli artefatti di test in Azure Boards

servizi Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Gli artefatti di test, ad esempio piani di test, gruppi di test e test case, sono tutti elementi di lavoro in Azure DevOps. L'eliminazione è permanente in Azure DevOps Server ma recuperabile nei servizi di Azure DevOps. Comprendere le opzioni di eliminazione e ripristino consente di eliminare in modo sicuro.

Tip

È possibile usare l'intelligenza artificiale per facilitare questa attività più avanti in questo articolo, oppure vedere Abilitare l'assistenza AI con Azure DevOps MCP Server per iniziare.

Comprendere il comportamento dell'eliminazione

Il comportamento di eliminazione è diverso tra Azure DevOps Services e Azure DevOps Server. Comprendere in che modo ogni piattaforma gestisce l'eliminazione e quali opzioni di ripristino sono disponibili consente di eliminare con sicurezza.

Modello di eliminazione dei servizi Azure DevOps

Azure DevOps Services supporta un modello di eliminazione temporanea. Quando si eliminano piani di test o suite di test, questi entrano in un periodo di ripristino di 14 giorni prima dell'eliminazione permanente.

Cosa accade quando si eliminano gli artefatti di test

  1. Rimuovere dall'archivio dati TCM

    • L'artefatto di test eliminato viene rimosso dall'archivio dati Gestione test case (TCM).
    • L'elemento di lavoro sottostante associato all'artefatto di test viene eliminato.

  2. Eliminare elementi figli

    • Un'operazione in background avvia l'eliminazione di tutti gli elementi figlio sia dall'archivio dati TCM che dagli elementi di lavoro associati.
    • Questo processo potrebbe richiedere alcuni minuti, a seconda del numero di elementi da eliminare.

  3. Eliminazione temporanea

    • Tutte le informazioni nell'archivio dati di rilevamento degli elementi di lavoro e nell'archivio dati TCM vengono inserite nello stato di eliminazione temporanea ed è possibile ripristinarlo entro 14 giorni.

  4. Eliminazione permanente

    • Non è possibile riattivare o ripristinare i dati eliminati in alcuna circostanza.

Per ripristinare un piano di test o una suite di test eliminati durante la fase di eliminazione temporanea di 14 giorni:

  1. Eseguire l'API List per ottenere il piano di test/ e la suite di test che si intende ripristinare.
  2. Se l'API List restituisce una risposta con il piano di test o la suite di test da ripristinare, eseguire l'API PATCH per Piano di test/Suite di test per ripristinarli.
  3. Se l'API Elenco non restituisce il piano di test o il gruppo di test da ripristinare, viene eliminato definitivamente dal sistema e non può essere ripristinato.

Ripristinare un piano o un gruppo di test eliminato

Durante la fase di eliminazione temporanea di 14 giorni, è possibile ripristinare pacchetti e piani di test eliminati:

  1. Esegui l'API List per ottenere il Test Plan/Test Suite che vuoi ripristinare.
  2. Se l'API List restituisce una risposta con il piano di test o la suite di test da ripristinare, eseguire l'API PATCH per Piano di test/Suite di test per ripristinarli.
  3. Se l'API Elenco non restituisce il piano di test o il gruppo di prodotti da ripristinare, viene eliminato definitivamente e non può essere ripristinato.

Limitazioni importanti

  • Dopo l'eliminazione, i piani di test e le suite di test rimangono in uno stato di eliminazione temporanea per 14 giorni. Dopo questo periodo, vengono eliminati definitivamente e non possono essere ripristinati.
  • Quando si ripristina un piano di test o una suite di test, vengono ripristinati anche tutti gli artefatti secondari (suite di test, casi di test).
  • Il ripristino delle esecuzioni di test associate a piani di test e suite di test non è supportato.
  • I test case eliminati tramite API o metodi non portali vengono eliminati definitivamente e non possono essere ripristinati.

modello di eliminazione di Azure DevOps Server

Importante

Eliminazione permanente e irreversibile: Azure DevOps Server supporta solo l'eliminazione permanente di elementi di test, inclusi piani di test, gruppi di test, test case, passaggi condivisi e parametri condivisi. Gli artefatti eliminati non possono essere ripristinati e vengono rimossi anche tutti gli elementi associati, come i risultati dei test. Inoltre, non è supportata l'eliminazione in blocco degli artefatti di test.

Eseguire il backup di tutte le informazioni necessarie prima di eliminare gli artefatti di test, perché questa azione non può essere annullata.

Cosa accade quando si eliminano gli artefatti di test

  1. Rimuovere dall'archivio dati TCM:

    • L'artefatto di test eliminato viene rimosso dall'archivio dati Gestione test case (TCM).
    • L'elemento di lavoro sottostante associato all'artefatto di test viene eliminato.

  2. Elimina elementi figli:

    • Un'operazione in background avvia l'eliminazione di tutti gli elementi figlio sia dall'archivio dati TCM che dagli elementi di lavoro associati.
    • Questo processo potrebbe richiedere alcuni minuti, a seconda del numero di elementi da eliminare.

  3. Eliminazione permanente:

    • Il processo elimina definitivamente tutte le informazioni nell'archivio dati di rilevamento degli elementi di lavoro e nell'archivio dati TCM.
    • Non è possibile riattivare o ripristinare i dati eliminati in alcuna circostanza.

Prerequisiti

Categoria Requisiti
Livelli di accesso Basic + Test Plans o Visual Studio Enterprise per gestire o eliminare artefatti di test. Gli utenti con accesso basic possono eliminare solo test case orfani (test case non collegati a un piano di test o a un gruppo di test).
Autorizzazioni : esecuzioni di test Membro del gruppo Project Administrators oppure dell'autorizzazione a livello di progetto Elimina esecuzioni di test impostata su Consenti.
Autorizzazioni — piani di test e suite Membro del gruppo Amministratori del progetto oppure con l'autorizzazione a livello di nodo del percorso dell'area Gestisci piani di test o Gestisci suite di test impostata su Consenti.

Nota

Se non sei un amministratore del progetto, sono necessarie sia l'autorizzazione Elimina esecuzioni di test a livello di progetto sia le autorizzazioni applicabili a livello di nodo di Area Path.

Tip

Non sei sicuro di avere le autorizzazioni appropriate? Vedere la sezione Verificare le autorizzazioni di eliminazione .

Tipi di elementi di lavoro che supportano l'esperienza di test

L'immagine seguente illustra il set di tipi di elemento di lavoro che supportano l'esperienza di test e funzionano con Microsoft Test Manager. Questi tipi di elemento di lavoro vengono collegati insieme usando i tipi di collegamento visualizzati.

Screenshot che mostra i tipi di elementi di lavoro per la gestione dei test.

Dal portale Web o da Microsoft Test Manager è possibile visualizzare i test case definiti per un gruppo di test e quali gruppi di test sono definiti per un piano di test. Tuttavia, questi oggetti non sono connessi tra loro tramite tipi di collegamento. Per le definizioni di ogni campo utilizzato in questi tipi di elementi di lavoro, vedere Query basate sui campi di integrazione di build e test.

Eliminare gli artefatti di test

Warning

L'eliminazione degli artefatti di test è permanente e non può essere annullata. In Azure DevOps Services sono disponibili 14 giorni per ripristinare i piani di test eliminati e i gruppi di test. In Azure DevOps Server, l'eliminazione è immediata e permanente. Verificare attentamente la selezione prima di confermare l'eliminazione.

Eliminare un test case

  1. Vai al caso di test che vuoi eliminare.
  2. Selezionare Elimina definitivamente dal menu azioni.
  3. Confermare l'eliminazione nella finestra di dialogo visualizzata.

Eliminare il test case e gli artefatti di test associati dal modulo web.

Nota

L'opzione Elimina definitivamente è disponibile solo se si dispone delle autorizzazioni e del livello di accesso necessari.

Eliminare un gruppo di test

  1. Vai alla suite di test che vuoi eliminare.
  2. Selezionare Elimina definitivamente dal menu azioni.
  3. Confermare l'eliminazione nella finestra di dialogo visualizzata.

Confermare l'eliminazione della finestra di dialogo degli artefatti di test.

Eliminare un piano di test

Opzione A: Elimina dalla visualizzazione del piano di test

  1. Vai al piano di test che vuoi eliminare.
  2. Selezionare Elimina definitivamente dal menu azioni.
  3. Confermare l'eliminazione nella finestra di dialogo visualizzata.

Opzione B: Eliminare dall'hub Test Plans

  1. Aprire Piani di test.
  2. Trovare il piano di test da eliminare nell'elenco.
  3. Fare clic con il pulsante destro del mouse sul piano di test oppure selezionare l'icona del menu ··· accanto al piano.
  4. Seleziona Elimina.
  5. Conferma l'eliminazione.

Screenshot della pagina Piani di test, eliminare un piano di test.

Eliminare i passaggi condivisi o i parametri condivisi

  1. Aprire il passaggio condiviso o il parametro condiviso da eliminare.
  2. Selezionare Mostra riferimenti per visualizzare tutti i test case che si collegano a questo elemento.
  3. Per ogni test case, aprirlo e rimuovere il collegamento al passaggio o al parametro condiviso.
  4. Dopo aver rimosso tutti i riferimenti, tornare al passaggio o al parametro condiviso e selezionare Elimina definitivamente.
  5. Conferma l'eliminazione.

Nota

Se l'opzione Elimina definitivamente è disabilitata, verificare di aver rimosso tutti i riferimenti. Il sistema blocca l'eliminazione dei passaggi condivisi o dei parametri a cui fanno ancora riferimento i test case.

Screenshot che mostra l'eliminazione dei passaggi condivisi dal modulo.

Verificare le autorizzazioni di eliminazione

Prima di tentare di eliminare gli artefatti di test, verificare di avere le autorizzazioni necessarie:

  1. Passare aAutorizzazioni> progetto.
  2. Cerca il tuo account utente o team.
  3. Verificare che le autorizzazioni seguenti siano impostate su Consenti:
    • Eliminare le esecuzioni di test (per eliminare i risultati dei test)
    • Gestire piani di test o Gestire gruppi di test (per l'eliminazione di piani di test e gruppi)
  4. Verificare che il livello di accesso sia Basic + Test Plans o superiore.
  5. Se le autorizzazioni non sono corrette, contattare l'amministratore del progetto.

Per altre informazioni, vedere Gestire le autorizzazioni degli artefatti di test.

Risolvere i problemi relativi all'eliminazione dell'artefatto di test

L'opzione "Elimina definitivamente" non viene visualizzata

Possibili cause:

  • Il livello di accesso è inferiore a Basic + Test Plans.
  • Non si dispone delle autorizzazioni necessarie per questo artefatto.
  • Non si dispone delle autorizzazioni per il percorso dell'area in questa posizione.

Risoluzione:

  1. Controllare il livello di accesso: passare aSicurezza> per visualizzare il livello di accesso corrente.
  2. Verificare le autorizzazioni: vedere Verificare le autorizzazioni di eliminazione.
  3. Se non si è un amministratore del progetto, chiedere all'amministratore di assegnare le autorizzazioni necessarie.

L'eliminazione è lenta o timeout

Possibili cause:

  • L'artefatto di test contiene molti elementi secondari (casi di test, suite di test, risultati dei test).
  • Un processo in background sta ancora elaborando l'operazione di eliminazione.
  • Problemi relativi alla connettività di rete

Risoluzione:

  • L'eliminazione di grandi quantità può richiedere alcuni minuti. Attendere che il processo in background venga completato.
  • Aggiornare la pagina dopo alcuni minuti per verificare l'eliminazione.
  • Controllare la connettività di rete e riprovare.

L'elemento viene ancora visualizzato dopo l'eliminazione (Azure DevOps Services)

Possibile causa:

  • L'artefatto è in stato di eliminazione temporanea (finestra di ripristino di 14 giorni).

Risoluzione:

  • In Azure DevOps Services i piani di test eliminati e i gruppi di test rimangono visibili in alcune visualizzazioni durante la finestra di ripristino di 14 giorni.
  • L'artefatto viene eliminato definitivamente dopo 14 giorni.
  • Per ripristinare l'artefatto durante questa finestra, vedere Ripristinare un piano o un gruppo di test eliminato (nella sezione introduttiva precedente).

Non è possibile eliminare i passaggi o i parametri condivisi

Possibile causa:

  • Il passaggio o il parametro condiviso contiene ancora riferimenti dai test case.

Risoluzione:

  1. Aprire il passaggio o il parametro condiviso.
  2. Selezionare Mostra riferimenti per visualizzare tutti i test case collegati.
  3. Aprire ogni test case e rimuovere il link.
  4. Riprovare a eliminare.

Per altre informazioni, vedere Eliminare i passaggi condivisi o i parametri condivisi precedenti.

Eliminare gli artefatti di test tramite l'API REST

È anche possibile eliminare gli artefatti di test a livello di codice usando l'API REST Azure DevOps. Questo metodo è utile per l'automazione, l'eliminazione in blocco o l'integrazione con le pipeline CI/CD.

Eliminare un test case

DELETE https://dev.azure.com/{organization}/{project}/_apis/test/testcase/{testCaseId}?api-version=7.1
Authentication: Basic [PAT or OAuth token]

Eliminare un gruppo di test

DELETE https://dev.azure.com/{organization}/{project}/_apis/test/plans/{planId}/suites/{suiteId}?api-version=7.1
Authentication: Basic [PAT or OAuth token]

Eliminare un piano di test

DELETE https://dev.azure.com/{organization}/{project}/_apis/test/plans/{planId}?api-version=7.1
Authentication: Basic [PAT or OAuth token]

Nota

  • Sostituire {organization}, {project}, {planId}{suiteId}, e {testCaseId} con i valori effettivi.
  • Usare la versione 7.1 dell'API o versioni successive. Controlla la gestione delle versioni dell'API REST per le versioni correnti.
  • In Azure DevOps Services è possibile ripristinare gli artefatti eliminati tramite l'API durante la finestra di eliminazione temporanea di 14 giorni.
  • In Azure DevOps Server l'eliminazione tramite l'API è permanente.
  • Eseguire l'autenticazione usando un token di accesso personale (PAT) o un token OAuth.

Per informazioni complete sull'API, vedi la documentazione di riferimento dell'API del cestino del piano di test.

Usare l'intelligenza artificiale per eliminare gli artefatti di test

Se si configura il server MCP Azure DevOps per l'organizzazione, è possibile usarlo per trovare ed eliminare artefatti di test su larga scala usando il linguaggio naturale. Questo metodo è particolarmente utile per le eliminazioni in blocco o le query complesse difficili da eseguire manualmente.

Ecco alcuni modelli comuni per le query in linguaggio naturale:

Attività Richiesta di esempio
Eliminare un piano di test Delete test plan <TestPlanName> in project <Contoso>
Trovare gli artefatti di test precedenti List all test plans in project <Contoso> that aren't updated in the last 6 months
Rimuovere i gruppi di test abbandonati Find all test suites in project <Contoso> that have no test runs in the last 90 days and delete them
Trovare test case duplicati Identify duplicate test cases in test suite <SuiteName> that have the same title and steps
Elimina in blocco i casi di test per tag Delete all test cases marked with tag "deprecated" in project <Contoso>
Rimuovere i passaggi condivisi orfani Find shared steps in project <Contoso> that aren't referenced by any test cases
Verificare l'impatto dell'eliminazione Before I delete test plan <TestPlanName>, show me how many test cases, test suites, and test runs are associated with it
Eliminare i risultati dei test precedenti Delete all test results older than 1 year from test plan <TestPlanName>
Pianificare la pulizia degli artefatti What test artifacts in project <Contoso> can I safely delete to clean up the test data

Nota

La modalità agente e il server MCP usano il linguaggio naturale, quindi è possibile modificare queste richieste o porre domande di completamento per perfezionare i risultati. In Azure DevOps Server, l'eliminazione dell'artefatto di test è permanente e non può essere ripristinata, quindi verificare attentamente la selezione.

Contenuti correlati

  • Last updated on