Löschen von Testartefakten in Azure Boards

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Testartefakte wie Testpläne, Testsammlungen und Testfälle sind alle Arbeitsaufgaben in Azure DevOps. Das Löschen ist in Azure DevOps Server dauerhaft, kann aber in Azure DevOps Services wiederhergestellt werden. Das Verständnis der Löschvorgangs- und Wiederherstellungsoptionen hilft Ihnen beim sicheren Löschen.

Tip

Sie können KI verwenden, um Ihnen bei dieser Aufgabe zu helfen später in diesem Artikel oder sehen Sie sich an, wie Sie die KI-Unterstützung bei Azure DevOps MCP Server aktivieren, um loszulegen.

Löschverhalten verstehen

Das Löschverhalten unterscheidet sich zwischen Azure DevOps Services und Azure DevOps Server. Das Verständnis, wie jede Plattform Löschvorgänge verarbeitet und welche Wiederherstellungsoptionen verfügbar sind, hilft Ihnen beim Löschen mit Vertrauen.

Azure DevOps Services-Löschmodell

Azure DevOps Services unterstützt ein Modell für das vorläufige Löschen. Wenn Sie Testpläne oder Testsammlungen löschen, geben sie vor dem endgültigen Löschen ein 14-tägiges Wiederherstellungsfenster ein.

Was geschieht, wenn Sie Testartefakte löschen

  1. Aus TCM-Datenspeicher entfernen

    • Das gelöschte Testartefakt wird aus dem Datenspeicher von Test Case Management (TCM) entfernt.
    • Das zugrunde liegende Arbeitselement, das mit dem Testartefakt verbunden ist, wird gelöscht.

  2. Löschen untergeordneter Elemente

    • Ein Hintergrundauftrag initiiert die Löschung aller untergeordneten Elemente aus dem TCM-Datenspeicher und den zugrunde liegenden Arbeitselementen.
    • Dieser Vorgang kann je nach Anzahl der zu löschenden Artefakte einige Minuten in Anspruch nehmen.

  3. Soft Delete

    • Alle Informationen sowohl im Datenspeicher für die Nachverfolgung von Arbeitsaufgaben als auch im TCM-Datenspeicher werden in den Status "Vorläufiges Löschen" versetzt, und Sie können sie innerhalb von 14 Tagen wiederherstellen.

  4. Dauerhafte Löschung

    • Sie können gelöschte Daten unter keinen Umständen reaktivieren oder wiederherstellen.

So stellen Sie einen gelöschten Testplan oder eine Testsuite während der 14-tägigen Phase des vorläufigen Löschens wieder her:

  1. Führen Sie die Listen-API aus, um den Testplan/ und die Testsuite, die Sie wiederherstellen möchten, abzurufen.
  2. Wenn die List-API eine Antwort mit dem wiederherzustellenden Testplan oder der wiederherzustellenden Testsuite zurückgibt, rufen Sie zum Wiederherstellen die PATCH-API für Test Plan/Test Suite auf.
  3. Wenn die Listen-API den Testplan oder die Testsuite, die Sie wiederherstellen möchten, nicht zurückgibt, wird sie endgültig aus dem System gelöscht und kann nicht wiederhergestellt werden.

Wiederherstellen eines gelöschten Testplans oder einer gelöschten Suite

Während der 14-tägigen Phase des vorläufigen Löschens können Sie gelöschte Testpläne und Suites wiederherstellen:

  1. Rufen Sie die List-API auf, um den Testplan/Testsuiten per GET abzurufen, den Sie wiederherstellen möchten.
  2. Wenn die Listen-API eine Antwort mit dem Testplan oder der Wiederherstellungssuite zurückgibt, führen Sie die PATCH-API für Testplan/Test Suite aus, um sie wiederherzustellen.
  3. Wenn die Listen-API den Testplan oder die Suite, den Sie wiederherstellen möchten, nicht zurückgibt, wird sie endgültig gelöscht und kann nicht wiederhergestellt werden.

Wichtige Einschränkungen

  • Nach dem Löschen befinden sich Testpläne und Testsuiten 14 Tage lang in einem soft-delete Status. Nach diesem Zeitraum werden sie endgültig gelöscht und können nicht wiederhergestellt werden.
  • Wenn Sie einen Testplan oder eine Suite wiederherstellen, werden auch alle untergeordneten Artefakte (Testsuiten, Testfälle) wiederhergestellt.
  • Das Wiederherstellen von Testläufen im Zusammenhang mit Testplänen und Suites wird nicht unterstützt.
  • Testfälle, die über APIs oder nicht portalbezogene Methoden gelöscht werden, werden endgültig gelöscht und können nicht wiederhergestellt werden.

Azure DevOps Server Löschmodell

Wichtig

Permanente und unumkehrbare Löschung: Azure DevOps Server unterstützt nur die dauerhafte Löschung von Testartefakten, einschließlich Testplänen, Testsammlungen, Testfällen, freigegebenen Schritten und freigegebenen Parametern. Gelöschte Artefakte können nicht wiederhergestellt werden, und alle zugehörigen untergeordneten Objekte, wie z. B. Testergebnisse, werden ebenfalls entfernt. Darüber hinaus wird das Massenlöschen von Testartefakten nicht unterstützt.

Sichern Sie alle erforderlichen Informationen vor dem Löschen von Testartefakten, da diese Aktion nicht rückgängig gemacht werden kann.

Was geschieht, wenn Sie Testartefakte löschen

  1. Löschen aus dem TCM Datenspeicher:

    • Das gelöschte Testartefakt wird aus dem Datenspeicher von Test Case Management (TCM) entfernt.
    • Das zugrunde liegende Arbeitselement, das mit dem Testartefakt verbunden ist, wird gelöscht.

  2. Löschen von untergeordneten Elementen:

    • Ein Hintergrundauftrag initiiert die Löschung aller untergeordneten Elemente aus dem TCM-Datenspeicher und den zugrunde liegenden Arbeitselementen.
    • Dieser Vorgang kann je nach Anzahl der zu löschenden Artefakte einige Minuten in Anspruch nehmen.

  3. Permanente Löschung:

    • Der Prozess löscht alle Informationen sowohl im Datenspeicher für die Nachverfolgung von Arbeitsaufgaben als auch im TCM-Datenspeicher dauerhaft.
    • Sie können gelöschte Daten unter keinen Umständen reaktivieren oder wiederherstellen.

Voraussetzungen

Kategorie Anforderungen
Zugriffsebenen Basic + Testpläne oder Visual Studio Enterprise zum Verwalten oder Löschen von Testartefakten. Benutzer mit Standardzugriff können nur verwaiste Testfälle löschen (Testfälle, die nicht mit einem Testplan oder einer Suite verknüpft sind).
Berechtigungen – Testläufe Mitglied der Gruppe Projektadministratoren oder die auf Projektebene festgelegte Berechtigung Testausführungen löschen auf Zulassen.
Berechtigungen – Testen von Plänen und Suites Mitglied der Gruppe Projektadministratorendministrators oder die Berechtigung Testpläne verwalten oder Testsuites verwalten auf Ebene des Bereichspfadknotens auf Zulassen festgelegt.

Hinweis

Wenn Sie kein Projektadministrator sind, benötigen Sie sowohl die Berechtigung Testläufe löschen auf Projektebene als auch die entsprechenden Berechtigungen auf Knotenebene des Bereichspfads.

Tip

Sie sind nicht sicher, ob Sie über die richtigen Berechtigungen verfügen? Weitere Informationen finden Sie im Abschnitt "Löschberechtigungen überprüfen" .

Arbeitselementtypen, die die Testumgebung unterstützen

Die folgende Abbildung veranschaulicht die Arbeitselementtypen, die die Testumgebung unterstützen und mit Microsoft Test Manager funktionieren. Diese Arbeitselementtypen werden mithilfe der gezeigten Linktypen miteinander verknüpft.

Ein Screenshot zeigt die Arbeitselementtypen der Testverwaltung.

Im Webportal oder mir Microsoft Test Manager können Sie anzeigen, welche Testfälle für eine Testsammlung definiert sind und welche Testsammlungen für einen Testplan definiert sind. Diese Objekte sind jedoch nicht miteinander durch Linktypen verknüpft. Definitionen der einzelnen Felder, die in diesen Arbeitselementtypen verwendet werden, finden Sie unter Auf Build- und Testintegrationsfeldern basierende Abfrage.

Testartefakte löschen

Warning

Das Löschen von Testartefakten ist dauerhaft und kann nicht rückgängig gemacht werden. In Azure DevOps Services haben Sie 14 Tage Zeit, gelöschte Testpläne und Testsuiten wiederherzustellen. In Azure DevOps Server ist die Löschung sofort und dauerhaft. Überprüfen Sie Ihre Auswahl sorgfältig, bevor Sie den Löschvorgang bestätigen.

Löschen eines Testfalls

  1. Wechseln Sie zu dem Testfall, den Sie löschen möchten.
  2. Wählen Sie im Menü "Aktionen " die Option "Endgültig löschen " aus.
  3. Bestätigen Sie den Löschvorgang im angezeigten Dialogfeld.

Löschen eines Testfalls und zugehöriger Testartefakte aus dem Webformular

Hinweis

Die Option zum endgültigen Löschen ist nur verfügbar, wenn Sie über die erforderlichen Berechtigungen und Zugriffsebene verfügen.

Löschen einer Testsuite

  1. Wechseln Sie zu der Testsuite, die Sie löschen möchten.
  2. Wählen Sie im Menü "Aktionen " die Option "Endgültig löschen " aus.
  3. Bestätigen Sie den Löschvorgang im angezeigten Dialogfeld.

Dialogfeld zum Bestätigen des Löschvorgangs für Testartefakte

Löschen eines Testplans

Option A: Aus testplanansicht löschen

  1. Wechseln Sie zu dem Testplan, den Sie löschen möchten.
  2. Wählen Sie im Menü "Aktionen " die Option "Endgültig löschen " aus.
  3. Bestätigen Sie den Löschvorgang im angezeigten Dialogfeld.

Option B: Aus dem Hub "Testpläne löschen"

  1. Öffnen Sie Testpläne.
  2. Suchen Sie den Testplan, den Sie in der Liste löschen möchten.
  3. Klicken Sie mit der rechten Maustaste auf den Testplan (oder wählen Sie das Menüsymbol ··· neben dem Plan aus).
  4. Klicken Sie auf Löschen.
  5. Bestätigen Sie den Löschvorgang.

Screenshot: Test Plans-Seite – Löschen eines Testplans

Geteilte Schritte oder geteilte Parameter löschen

  1. Öffnen Sie den freigegebenen Schritt oder den freigegebenen Parameter, den Sie löschen möchten.
  2. Wählen Sie "Verweise anzeigen " aus, um alle Testfälle anzuzeigen, die mit diesem Element verknüpft sind.
  3. Öffnen Sie ihn für jeden Testfall, und entfernen Sie den Link zum freigegebenen Schritt oder Parameter.
  4. Nachdem Sie alle Verweise entfernt haben, kehren Sie zum freigegebenen Schritt oder Parameter zurück, und wählen Sie "Endgültig löschen" aus.
  5. Bestätigen Sie den Löschvorgang.

Hinweis

Wenn die Option " Endgültig löschen " deaktiviert ist, vergewissern Sie sich, dass Sie alle Verweise entfernt haben. Das System blockiert das Löschen freigegebener Schritte oder Parameter, auf die Testfälle weiterhin verweisen.

Screenshot: Löschen gemeinsamer Schritte aus dem Formular

Überprüfen von Löschberechtigungen

Bevor Sie versuchen, Testartefakte zu löschen, stellen Sie sicher, dass Sie über die erforderlichen Berechtigungen verfügen:

  1. Wechseln Sie zu Projekteinstellungen>Berechtigungen.
  2. Suchen Sie nach Ihrem Benutzerkonto oder Team.
  3. Überprüfen Sie, ob die folgenden Berechtigungen auf "Zulassen" festgelegt sind:
    • Löschen von Testläufen (zum Löschen von Testergebnissen)
    • Verwalten von Testplänen oder Verwalten von Testsuiten (zum Löschen von Testplänen und Suites)
  4. Überprüfen Sie, ob Ihre Zugriffsebene "Basic+ Test Plans" oder höher ist.
  5. Wenn Berechtigungen nicht korrekt sind, wenden Sie sich an den Projektadministrator.

Weitere Informationen finden Sie unter Verwalten von Berechtigungen für Testartefakte.

Probleme beim Löschen von Testartefakten beheben

Die Option "Endgültig löschen" wird nicht angezeigt.

Mögliche Ursachen:

  • Ihre Zugriffsebene ist niedriger als "Basic + Test Plans".
  • Sie verfügen nicht über die erforderlichen Berechtigungen für dieses Artefakt.
  • Sie besitzen keine Bereichspfadberechtigungen für diesen Standort.

Auflösung:

  1. Überprüfen Sie Ihre Zugriffsebene: Wechseln Sie zu Profilsicherheit>, um Ihre aktuelle Zugriffsebene anzuzeigen.
  2. Überprüfen Sie Ihre Berechtigungen: Siehe Überprüfen der Löschberechtigungen.
  3. Wenn Sie kein Projektadministrator sind, bitten Sie Ihren Administrator, die erforderlichen Berechtigungen zuzuweisen.

Das Löschen ist langsam oder führt zu einer Zeitüberschreitung.

Mögliche Ursachen:

  • Das Testartefakt hat viele untergeordnete Elemente (Testfälle, Testsuiten, Testergebnisse).
  • Die Löschung wird noch von einem Hintergrundprozess verarbeitet.
  • Probleme mit der Netzwerkkonnektivität

Auflösung:

  • Große Löschungen können mehrere Minuten dauern. Warten Sie, bis der Hintergrundauftrag abgeschlossen ist.
  • Aktualisieren Sie die Seite nach einigen Minuten, um den Löschvorgang zu überprüfen.
  • Überprüfen Sie Die Netzwerkkonnektivität, und versuchen Sie es erneut.

Artefakt wird nach dem Löschen weiterhin angezeigt (Azure DevOps Dienste)

Mögliche Ursache:

  • Das Artefakt befindet sich im Zustand "Vorläufiges Löschen" (14-Tage-Wiederherstellungsfenster).

Auflösung:

  • In Azure DevOps Services bleiben gelöschte Testpläne und Testsuiten während des 14-tägigen Wiederherstellungsfensters in einigen Ansichten sichtbar.
  • Das Artefakt wird nach 14 Tagen endgültig gelöscht.
  • Informationen zum Wiederherstellen des Artefakts während dieses Fensters finden Sie unter Wiederherstellen eines gelöschten Testplans oder einer gelöschten Suite (im Abschnitt "Einführung oben").

Freigegebene Schritte oder Parameter lassen sich nicht löschen.

Mögliche Ursache:

  • Der freigegebene Schritt oder Parameter enthält weiterhin Verweise aus Testfällen.

Auflösung:

  1. Öffnen Sie den geteilten Schritt oder Parameter.
  2. Wählen Sie "Verweise anzeigen " aus, um alle verknüpften Testfälle anzuzeigen.
  3. Öffnen Sie jeden Testfall, und entfernen Sie den Link.
  4. Versuchen Sie erneut, den Löschvorgang auszuführen.

Weitere Informationen finden Sie unter Löschen freigegebener Schritte oder freigegebener Parameter weiter oben.

Löschen von Testartefakten über DIE REST-API

Sie können Testartefakte auch programmgesteuert löschen, indem Sie die Azure DevOps REST-API verwenden. Diese Methode ist nützlich für Automatisierung, Massenlöschung oder Integration in CI/CD-Pipelines.

Löschen eines Testfalls

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

Löschen einer Testsuite

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

Löschen eines Testplans

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

Hinweis

  • Ersetzen Sie {organization}, {project}, {planId}, {suiteId} und {testCaseId} durch tatsächliche Werte.
  • Verwenden Sie die API-Version 7.1 oder höher. Überprüfen Sie die REST-API-Versionsverwaltung für aktuelle Versionen.
  • In Azure DevOps Services können Sie gelöschte Artefakte über die API während des 14-tägigen Fensters für vorläufiges Löschen wiederherstellen.
  • In Azure DevOps Server ist das Löschen über die API dauerhaft.
  • Authentifizieren Sie sich mit einem PERSÖNLICHEn Zugriffstoken (PERSONAL Access Token, PAT) oder OAuth-Token.

Vollständige API-Details finden Sie in der API-Referenz zum Testplan-Papierkorb.

Verwenden von KI zum Löschen von Testartefakten

Wenn Sie den Azure DevOps MCP-Server für Ihre Organisation konfigurieren, können Sie ihn verwenden, um Testartefakte mit natürlicher Sprache zu finden und zu löschen. Diese Methode ist besonders nützlich für Massenlöschvorgänge oder komplexe Abfragen, die manuell nur schwer ausgeführt werden können.

Im Folgenden finden Sie allgemeine Muster für Abfragen in natürlicher Sprache:

Aufgabe Beispielaufforderung
Löschen eines Testplans Delete test plan <TestPlanName> in project <Contoso>
Suchen alter Testartefakte List all test plans in project <Contoso> that aren't updated in the last 6 months
Entfernen verlassener Testsuiten Find all test suites in project <Contoso> that have no test runs in the last 90 days and delete them
Suchen nach duplizierten Testfällen Identify duplicate test cases in test suite <SuiteName> that have the same title and steps
Mehrere Testfälle anhand von Tags löschen Delete all test cases marked with tag "deprecated" in project <Contoso>
Verwaiste freigegebene Schritte entfernen Find shared steps in project <Contoso> that aren't referenced by any test cases
Auswirkungen des Löschens überprüfen Before I delete test plan <TestPlanName>, show me how many test cases, test suites, and test runs are associated with it
Alte Testergebnisse löschen Delete all test results older than 1 year from test plan <TestPlanName>
Planen der Artefaktbereinigung What test artifacts in project <Contoso> can I safely delete to clean up the test data

Hinweis

Der Agentmodus und der MCP-Server verwenden natürliche Sprache, sodass Sie diese Eingabeaufforderungen anpassen oder Nachverfolgungsfragen stellen können, um die Ergebnisse zu verfeinern. In Azure DevOps Server ist das Löschen von Testartefakten dauerhaft und kann nicht wiederhergestellt werden, daher überprüfen Sie Ihre Auswahl sorgfältig.

Verwandte Inhalte

  • Last updated on