Supprimer ou restaurer des éléments de travail dans Azure Boards

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

Les éléments de travail peuvent vivre indéfiniment dans votre magasin de données de suivi du travail. Vous n’avez jamais besoin de les supprimer. Toutefois, vous pouvez configurer un processus de gestion des éléments de travail pour l’une des actions suivantes :

Prérequis

• Les membres du groupe Contributeurs peuvent supprimer et restaurer des éléments de travail.
• Pour supprimer définitivement des éléments de travail, vous devez être membre du groupe Administrateurs de projet ou disposer de l’autorisation requise.
• Les utilisateurs disposant d’un accès de partie prenante peuvent afficher le contenu de la Corbeille, mais ne peuvent pas restaurer ni supprimer définitivement des éléments dans la corbeille, quelles que soient les autorisations qui leur sont accordées.

Pour obtenir un affichage simplifié des autorisations affectées aux groupes intégrés, consultez Autorisations et accès.

Retirer ou supprimer des éléments de travail

Vous pouvez agir sur des éléments de travail individuels ou modifier en bloc plusieurs éléments de travail.

À partir du portail web, vous pouvez sélectionner plusieurs éléments de travail d’une page de résultats de backlog ou de requête. Vous pouvez également effectuer une mise à jour en bloc à l’aide de la fonctionnalité associée. Pour supprimer ou restaurer plusieurs éléments de travail en même temps, consultez Modifier les éléments de travail en bloc.

Vous pouvez également supprimer ou détruire des éléments de travail par lots avec une API REST. Pour plus d'informations, consultez Éléments de travail – Supprimer.

Supprimer des éléments de travail

En modifiant l’état d’un élément de travail en suppression, vous supprimez-le efficacement d’un backlog ou d’une vue de tableau : produits, portefeuille et backlogs sprint, tableaux et tableaux de tâches. L’état Supprimé correspond à l’état de catégorie de workflowSupprimé. Si vous définissez des états de flux de travail personnalisés, tout état que vous mappez à l’état de catégorie de flux de travail supprimé agit de la même façon. Pour obtenir plus d’informations, consultez Personnaliser le workflow.

Pour que les éléments supprimés ne s’affichent pas dans les requêtes, vous devez ajouter une clause qui filtre sur le champ État.

Supprimer des éléments de travail

Les éléments de travail supprimés n’apparaissent pas dans vos backlogs, tableaux ou requêtes. Lorsque vous supprimez un élément, il accède à la Corbeille. Vous pouvez le restaurer à partir de là si vous changez d’avis. Pour supprimer un cas de test, un plan de test ou d’autres types d’éléments de travail liés aux tests, consultez Supprimer des artefacts de test.

Restaurer ou détruire des éléments de travail

Vous ne pouvez pas ouvrir les éléments de travail à partir de la Corbeille. L’option Supprimer définitivement s’affiche uniquement si votre autorisation Supprimer définitivement les éléments de travail au niveau du projet est définie sur Autoriser.

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

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

Supprimer et restaurer des processus

Lorsque vous supprimez un élément de travail, Azure DevOps effectue les actions suivantes :

• Génère une nouvelle révision de l’élément de travail
• Met à jour les champs Modifiée par/Date de modification pour prendre en charge la traçabilité
• Conserve complètement l’élément de travail, y compris toutes les affectations de champs, pièces jointes, balises et liens
• Provoque la non-requête de l’élément de travail et, par conséquent, n’apparaît pas dans une expérience de suivi du travail, un résultat de requête ou un rapport.
• Met à jour correctement des charts. Les charts de CFD, vitesse, burndown et légers sont mis à jour pour supprimer les éléments de travail supprimés
• Supprime les extensions de suivi du travail
• Conserve les données de tendance à l’exception de la dernière valeur
• Supprime l’élément de travail de l’entrepôt de données/cube similaire à celui qui a été supprimé définitivement

Lorsque vous restaurez un élément de travail, Azure DevOps effectue les actions suivantes :

• Provoque une nouvelle révision de l’élément de travail
• Met à jour les champs Modifiée par/Date de modification pour prendre en charge la traçabilité
• Devient interrogeable
• Tous les champs restent inchangés
• L’historique contient deux nouvelles révisions, l’une pour la suppression et l’autre pour la restauration
• réattache les extensions de suivi du travail
• Met à jour correctement des charts. Les charts de CFD, vitesse, burndown et légers sont mis à jour pour inclure les éléments de travail restaurés
• Restaure les données de tendance
• Rajoute l’élément de travail à l’entrepôt de données/cube
• Définit les champs de chemin d’accès à la zone ou à l’itération sur le nœud racine si le chemin d’accès de la zone ou les chemins d’itération précédents ont été supprimés

Utiliser une API REST pour supprimer, restaurer et détruire des éléments de travail

Pour supprimer, restaurer et détruire des éléments de travail par programmation, consultez l’une des ressources d’API REST suivantes :

• Référence sur l’API REST de la Corbeille
• Éléments de travail - Supprimer la référence sur l’API REST

Articles connexes

• Afficher et ajouter des éléments de travail à l’aide de la page Éléments de travail
• Supprimer les artefacts de test
• Définir des autorisations et un accès pour le suivi du travail
• Modifier les autorisations au niveau du projet
• Référence rapide sur l’accès de parties prenante