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 einer Arbeitsaufgabe von einem Projekt in ein anderes oder zum Ändern des Arbeitsaufgabentyps finden Sie unter Verschieben von Arbeitsaufgaben und Ändern des Arbeitsaufgabentyps.

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 Arbeitsaufgaben finden Sie unter "Massen ändern".

Sie können Arbeitsaufgaben auch in Batch mit einer REST-API löschen 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 Status einer Arbeitsaufgabe in "Entfernt" ändern, entfernen Sie sie effektiv aus einem Backlog oder einer Boardansicht: Produkt-, Portfolio- und Sprint-Backlogs, Boards und Taskboards. Der Zustand Entfernt entspricht dem WorkflowkategoriezustandEntfernt. Wenn Sie benutzerdefinierte Workflowzustände definieren, verhalten sich alle Zustände, die Sie dem Status " Entfernte Workflowkategorie" zuordnen, auf ähnliche Weise. Weitere Informationen finden Sie unter Anpassen des Workflows.

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
  • Kontextmenü der Tafelkarte
  • 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“.

    • Wenn Sie mehrere Arbeitselemente löschen möchten, wählen Sie diese mehrfach aus einem Backlog oder einer Abfrageergebnisliste aus, wählen Sie das  Kontextmenü und dann Löschen aus.

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

    • Wenn Sie eine Arbeitsaufgabe aus Ihrem Board oder Taskboard löschen möchten, wählen Sie das Kontextmenü für die Karte aus, und wählen Sie "Löschen" aus.

      Screenshot des Kontextmenüs der Tafelkarte, wählen Sie

  2. Bestätigen Sie, dass Sie die Elemente löschen möchten.

    Screenshot des Dialogfelds

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 ein Testartefakt löschen, werden alle zugehörigen untergeordneten Elemente, z. B. untergeordnete Testsammlungen, Testpunkte über alle Konfigurationen, Tester, Testergebnisseverlauf und andere zugeordnete Historien ebenfalls gelöscht. Die zugrunde liegende Arbeitsaufgabe für Testfälle wird nicht 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]
  • 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.

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.
  • Bewirkt, dass die Arbeitsaufgabe nicht abgefragt werden kann und in keinem Arbeitsverfolgungsvorgang, Abfrageergebnis oder Bericht 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 die Arbeitsaufgabe aus dem Data Warehouse/Cube, ähnlich wie wenn sie dauerhaft entfernt wurde.

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 Bereich oder den Iterationspfad auf den Stammknoten fest, wenn der vorherige Bereichspfad oder die Iterationspfade gelöscht wurden.

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: