Entfernen, Löschen oder Wiederherstellen von Arbeitselementen in Azure Boards
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
- Arbeitsaufgaben oder Projekte können zurzeit nicht archiviert werden.
- Informationen zum Azure Artifacts-Papierkorb finden Sie unter Löschen und Wiederherstellen von Paketen.
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)
- Legen Sie die Berechtigung Bereichspfad auf Zulassen fest: Arbeitselemente in diesem Knoten bearbeiten
- Mitglieder der Gruppe Mitwirkende besitzen diese Berechtigung standardmäßig.
- 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.
- Legen Sie die Berechtigung auf Projektebene auf Zulassen fest: Arbeitselemente endgültig löschen
- Mitglieder der Gruppe Projektadministratoren besitzen diese Berechtigung standardmäßig.
- 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.
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
Initiieren des Löschvorgangs:
- Öffnen Sie im Arbeitselementformular das Arbeitselement, wählen Sie
Aktionen und dann Löschen aus.
- 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.
- 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.
- Öffnen Sie im Arbeitselementformular das Arbeitselement, wählen Sie
Bestätigen Sie, dass Sie das/die Elemente(e) löschen möchten.
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.
Wählen Sie Boards>Arbeitsaufgaben>Papierkorb aus.
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.
Wählen Sie die wiederherzustellenden Elemente aus, und wählen Sie dann Wiederherstellen aus.
Optional können Sie auswählen, die Elemente endgültig zu löschen.
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_URL
konfigurieren. Erforderlich, wenn nicht als Standard konfiguriert oder mitgit config
verwendet 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_ID
konfigurieren. Erforderlich, wenn nicht als Standard konfiguriert oder mithilfe vongit 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: