Entfernen, Löschen oder Wiederherstellen von Arbeitselementen in Azure Boards

  • Artikel

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

Arbeitselemente können für immer in Ihrem Datenspeicher für die Arbeitsnachverfolgung gespeichert werden. Sie müssen sie nie löschen. Möglicherweise möchten Sie jedoch einen Prozess zur Verwaltung der Arbeitselemente für eine der folgenden Aktionen einrichten:

Aktion Beschreibung
Status ändern Arbeitselemente aus der Anzeige in Backlogs und Boards entfernen, indem Sie den Status der Arbeitselemente in Entfernen oder Ausschneiden ändern. Der für Sie verfügbare Zustand basiert auf dem Workflow, der dem Arbeitselementtyp zugewiesen ist.
Delete Entfernen Sie Arbeitselemente aus Backlogs, Boards und Abfragen. Gelöschte Arbeitselemente werden in einen Papierkorb verschoben.
Wiederherstellen Stellen Sie gelöschte Arbeitselemente wieder her, indem Sie sie aus dem Papierkorb wiederherstellen.
Zerstören Löschen Sie Arbeitsaufgaben endgültig, einschließlich aller Daten aus dem Datenspeicher für die Arbeitsnachverfolgung.

Hinweis

Informationen zum Verschieben eines Arbeitselements aus einem Projekt in ein anderes oder zum Ändern des Arbeitselementtyps finden Sie unter Verschieben von Arbeitselementen, Ändern des Arbeitselementtyps.

Voraussetzungen

  • Mitglieder der Gruppe Mitwirkende können Arbeitselemente entfernen, löschen und wiederherstellen.
  • Zum endgültigen Löschen von Arbeitselementen müssen Sie Mitglied der Gruppe Projektadministratoren sein oder die erforderliche Berechtigung erhalten.
  • Benutzer mit Projektbeteiligten-Zugriff können den Inhalt des Papierkorbs anzeigen, aber keine Elemente im Papierkorb wiederherstellen oder endgültig löschen, unabhängig von den Berechtigungen, die ihnen gewährt wurden.

Aufgabe

Erforderliche Berechtigung(en)

Zustand in Entfernen oder Ausschneiden ändern

  • Legen Sie die Berechtigung Bereichspfad auf Zulassen fest: Arbeitselemente in diesem Knoten bearbeiten
  • Mitglieder der Gruppe Mitwirkende besitzen diese Berechtigung standardmäßig.

Arbeitselemente löschen und
Arbeitselemente wiederherstellen

  • Legen Sie die Berechtigung auf Projektebene auf Zulassen fest: Arbeitselemente löschen und wiederherstellen
  • Verfügen über Basic-Zugriff oder höher.
  • Mitglieder der Gruppe Mitwirkende besitzen diese Berechtigung standardmäßig.

Arbeitselemente endgültig löschen oder zerstören

  • Legen Sie die Berechtigung auf Projektebene auf Zulassen fest: Arbeitselemente endgültig löschen
  • Mitglieder der Gruppe Projektadministratoren besitzen diese Berechtigung standardmäßig.

Arbeitselemente über die Befehlszeile löschen oder zerstören

  • Legen Sie die Berechtigung auf Projektebene auf Zulassen fest: Arbeitselemente endgültig löschen
  • Mitglieder der Gruppe Projektadministratoren besitzen diese Berechtigung standardmäßig.

Eine vereinfachte Ansicht der Berechtigungen, die integrierten Gruppen zugewiesen sind, finden Sie unter Berechtigungen und Zugriff.

Hinweis

Benutzer mit Projektbeteiligten-Zugriff für ein öffentliches Projekt besitzen ebenso wie Benutzer mit Basic-Zugriff Vollzugriff auf alle Features für die Arbeitsnachverfolgung. Weitere Informationen finden Sie unter Kurzreferenz zu Beteiligtenzugriff.

Entfernen oder Löschen von Arbeitselementen

Sie können einzelne Arbeitselemente bearbeiten oder mehrere Arbeitselemente massenweise ändern.

Im Webportal können Sie mehrere Arbeitselemente aus einem Backlog oder einer Seite mit Abfrageergebnissen auswählen. Sie können auch eine Massenaktualisierung durchführen, indem Sie das zugehörige Feature verwenden. Informationen zum gleichzeitigen Löschen oder Wiederherstellen mehrerer Arbeitselemente finden Sie unter Massenbearbeitung von Arbeitselementen.

Sie können Arbeitsaufgaben auch in Batch mit einer REST-API löschen und/oder zerstören. Weitere Informationen finden Sie unter Arbeitsaufgaben – Löschen.

Hinweis

Diese Funktion ist ab Azure DevOps Server 2022.1 verfügbar.

Entfernen von Arbeitselementen

Indem Sie den Zustand eines Arbeitselements in Entfernt ändern, entfernen Sie dieses effektiv aus einem Backlog oder einer Boardansicht (Product, Portfolio und Sprint Backlogs, Kanban-Board und Taskboards). Der Zustand Entfernt entspricht dem WorkflowkategoriezustandEntfernt. Wenn Sie benutzerdefinierte Workflowstatus definieren, verhält sich jeder Status, den Sie dem Workflowkategoriestatus Entfernt zuordnen, auf ähnliche Weise.

Screenshot des Arbeitselementformulars, Zustand in „Entfernt“ ändern.

Damit entfernte Elemente nicht in Abfragen angezeigt werden, müssen Sie eine Klausel hinzufügen, die nach dem Feld Zustand filtert.

Hinweis

Der Zustand Entfernt wird mit dem Basic-Prozess nicht unterstützt. Er wird nur mit den Arbeitselementtypen der Agile-, Scrum- und CMMI-Prozesse unterstützt. Der Basic-Prozess ist verfügbar, wenn Sie Azure DevOps Services oder Azure DevOps Server 2019 Update 1 ein Projekt hinzufügen.

Löschen von Arbeitselementen

Gelöschte Arbeitselemente werden in Ihren Backlogs, Boards oder Abfragen nicht angezeigt. Wenn Sie ein Element löschen, wird es in den Papierkorb verschoben. Sie können es von dort aus wiederherstellen, wenn Sie Ihre Meinung ändern. Informationen zum Löschen eines Testfalls, Testplans oder anderer testbezogener Arbeitselementtypen finden Sie unter Löschen von Testartefakten.

Sie können Arbeitselemente auf eine der folgenden Weisen löschen:

  • Das Arbeitselementformular
  • Die Seite Arbeitsaufgaben, Menü Weitere Aktionen
  • Die Karte „Kanban-Board“, Kontextmenü
  • Ein Backlog oder eine Seite mit Abfrageergebnissen
  • REST-API

  1. Initiieren des Löschvorgangs:

    • Öffnen Sie im Arbeitselementformular das Arbeitselement, wählen Sie Aktionen und dann Löschen aus.

    Screenshot des Arbeitselementformulars, Menü „Aktionen“, Auswählen von „Löschen“.

    Screenshot des Menüs „Aktionen“ bei Mehrfachauswahl im Backlog, Auswählen von „Löschen“.

    • Um ein Arbeitselement aus Ihrem Kanban- oder Taskboard zu löschen, wählen Sie das Kontextmenü für die Karte und dann Löschen aus.

    Screenshot des Kontextmenüs der Karte „Kanban-Board“, Auswählen von „Löschen“.

  2. Bestätigen Sie, dass Sie das/die Elemente(e) löschen möchten.

    Bildschirmausschnitt des Dialogs „Löschen bestätigen“.

Wiederherstellen oder Zerstören von Arbeitselementen

Arbeitsaufgaben können nicht aus dem Papierkorb geöffnet werden. Es wird nur die Option Endgültig löschen angezeigt, wenn Ihre Berechtigung Arbeitselemente endgültig löschen auf Projektebene auf Zulassen festgelegt ist.

Stellen Sie gelöschte Arbeitselemente wieder her, oder löschen sie endgültig über den Papierkorb des Webportals.

  1. Wählen Sie Boards>Arbeitsaufgaben>Papierkorb aus.

    Screenshot von Boards, Seite „Arbeitselemente“, „Papierkorb öffnen“.

    Wenn die Option Papierkorb nicht angezeigt wird, wählen Sie Weitere Befehle... aus, und wählen Sie ihn im Menü der Optionen aus.

    Eine neue Browserregisterkarte wird mit der Abfrage geöffnet, die Arbeitselemente auflistet, die dem Papierkorb hinzugefügt wurden.

  2. Wählen Sie die wiederherzustellenden Elemente aus, und wählen Sie dann Wiederherstellen aus.

    Screenshot des Wiederherstellens ausgewählter Elemente.

    Optional können Sie auswählen, die Elemente endgültig zu löschen.

  3. Bestätigen Sie Ihre Auswahl.

Hinweis

Gelöschte Testartefakte werden nicht im Papierkorb angezeigt und können nicht wiederhergestellt werden. Wenn Sie Testartefakte löschen, werden alle seine zugehörigen untergeordneten Elemente wie untergeordnete Testsammlungen, Testpunkte für alle Konfigurationen, Tester (das zugrunde liegende Testfall-Arbeitselement wird nicht gelöscht), der Testergebnisverlauf und andere zugeordnete Verläufe gelöscht.

Arbeitselemente über die Befehlszeile löschen oder zerstören

Sie können ein Arbeitselement mit dem Befehl az boards work-item delete löschen oder zerstören. Informationen zu den ersten Schritten finden Sie unter Erste Schritte mit Azure DevOps CLI.

Hinweis

Sie können gelöschte Arbeitsaufgaben wiederherstellen, aber Sie können keine zerstörten Arbeitsaufgaben wiederherstellen.

az boards work-item delete --id
                           [--destroy]
                           [--org]
                           [--project]
                           [--yes]

Parameter

  • id: Erforderlich. Die ID des Arbeitselements.
  • destroy: optional. Dieses Arbeitselement endgültig löschen.
  • org: Azure DevOps-Organisations-URL. Sie können die Standard-organization mit az devops configure -d organization=ORG_URLkonfigurieren. Erforderlich, wenn nicht als Standard konfiguriert oder mit git configverwendet wird. Beispiel: --org https://dev.azure.com/MyOrganizationName/.
  • project: Name oder ID des Projekts. Sie können das Standardprojekt mit az devops configure -d project=NAME_OR_IDkonfigurieren. Erforderlich, wenn nicht als Standard konfiguriert oder mithilfe von git config übernommen.
  • yes: Optional. Nicht zur Bestätigung auffordern.

Beispiel

Der folgende Befehl löscht den Fehler mit der ID 864 endgültig und fordert Sie nicht zur Bestätigung auf.

az boards work-item delete --id 864 --destroy --yes

Lösch- und Wiederherstellungsprozesse

Wenn Sie eine Arbeitsaufgabe löschen, führt Azure DevOps die folgenden Aktionen aus:

  • Generiert eine neue Revision des Arbeitselements.
  • Aktualisiert die Felder Geändert von/Änderungsdatum zur Unterstützung der Nachverfolgbarkeit.
  • Behält das Arbeitselement vollständig bei, einschließlich aller Feldzuweisungen, Anlagen, Tags und Links.
  • Versetzt das Arbeitselement in einen nicht abfragbaren Zustand, weshalb es in keiner Umgebung für die Arbeitsnachverfolgung, keinem Abfrageergebnis und keinem Bericht mehr angezeigt wird.
  • Aktualisiert Diagramme richtig. Die CFD-, Geschwindigkeits- (Velocity), Burndown- und schlanke (Lightweight) Diagramme werden aktualisiert, indem gelöschte Arbeitselemente entfernt werden.
  • Entfernt Erweiterungen für die Arbeitsnachverfolgung.
  • Behält Trenddaten mit Ausnahme des aktuellen Werts bei.
  • Entfernt das Arbeitselement aus dem Data Warehouse/Cube, ähnlich wie bei einer endgültigen Entfernung.

Wenn Sie eine Arbeitsaufgabe wiederherstellen, führt Azure DevOps die folgenden Aktionen aus:

  • Löst die Erstellung einer neuen Revision des Arbeitselements aus.
  • Aktualisiert die Felder Geändert von/Änderungsdatum zur Unterstützung der Nachverfolgbarkeit.
  • Wird abfragbar.
  • Alle Felder bleiben unverändert.
  • Der Verlauf enthält zwei neue Revisionen, eine zum Löschen und eine für die Wiederherstellung.
  • Erweiterungen für die Arbeitsnachverfolgung werden erneut angefügt.
  • Aktualisiert Diagramme richtig. Die CFD-, Geschwindigkeits- (Velocity), Burndown- und schlanke (Lightweight) Diagramme werden aktualisiert, indem wiederhergestellte Arbeitselemente wieder eingeschlossen werden.
  • Stellt Trenddaten wieder her.
  • Fügt das Arbeitselement wieder dem Data Warehouse/Cube hinzu.
  • Legt die Felder für den Bereichs- bzw. Iterationspfad auf den Stammknoten fest, wenn der vorherige Bereichs- oder Iterationspfad gelöscht wurde.

Verwendet eine REST-API zum Löschen, Wiederherstellen und Zerstören von Arbeitselementen.

Informationen zum programmgesteuerten Löschen, Wiederherstellen und Zerstören von Arbeitselementen finden Sie in einer der folgenden REST-API-Ressourcen: