Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
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 :
| Action | Description |
|---|---|
| Modifier l’état | Supprimez les éléments de travail de l’affichage sur les backlogs et les tableaux en remplaçant l’État de l’élément de travail par Supprimer ou Couper. L’état disponible est basé sur le workflow affecté au type d’élément de travail. |
| Delete | Supprimez les éléments de travail des backlogs, des tableaux et des requêtes. Les éléments de travail supprimés sont déplacés vers une Corbeille. |
| Restore | Récupérez les éléments de travail supprimés en les restaurant à partir de la Corbeille. |
| Destroy | Supprimez définitivement les éléments de travail, y compris toutes les données du magasin de données de suivi du travail. |
Note
- Vous ne pouvez pas archiver des éléments de travail ou des projets pour l’instant.
- Pour plus d’informations sur la Corbeille Azure Artifacts, consultez Supprimer et récupérer des packages.
Pour déplacer un élément de travail d’un projet vers un autre ou pour modifier le type d’élément de travail, consultez Déplacer des éléments de travail et modifier le type d’élément de travail.
Prerequisites
| Category | Requirements |
|---|---|
| Accès général | - Pour supprimer, supprimer et restaurer des éléments de travail : membre du groupe Contributeurs - Pour supprimer définitivement les éléments de travail : membre du groupe Administrateurs de projet ou accordé l’autorisation requise - Les utilisateurs disposant d’un accès aux parties prenantes peuvent afficher le contenu de la Corbeille , mais ne peuvent pas restaurer ou supprimer définitivement des éléments, quelles que soient les autorisations accordées |
| Modifier l’état en supprimer ou couper |
-
Autorisation De chemin d’accès de zone définie sur Autoriser : modifier les éléments de travail dans ce nœud - Par défaut, les membres du groupe Contributeurs ont cette autorisation |
| Supprimer et restaurer des éléments de travail | - Ensemble d’autorisations au niveau du projet sur Autoriser : Supprimer et restaurer des éléments de travail - Accès de base au moins - Par défaut, les membres du groupe Contributeurs ont cette autorisation |
| Supprimer définitivement ou détruire des éléments de travail | - Ensemble d’autorisations au niveau du projet sur Autoriser : supprimer définitivement les éléments de travail - Par défaut, les membres du groupe Administrateurs de projet disposent de cette autorisation |
| Supprimer ou détruire des éléments de travail à partir de la ligne de commande | - Ensemble d’autorisations au niveau du projet sur Autoriser : supprimer définitivement les éléments de travail - Par défaut, les membres du groupe Administrateurs de projet disposent de cette autorisation |
Pour obtenir un affichage simplifié des autorisations affectées aux groupes intégrés, consultez Autorisations et accès.
Note
Les utilisateurs disposant d’un accès Partie prenante pour un projet public ont un accès complet à toutes les fonctionnalités de suivi du travail, tout comme les utilisateurs disposant d’un accès De base. Pour plus d’informations, consultez Référence rapide sur l’accès de partie prenante.
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 des éléments de travail en bloc.
Vous pouvez également supprimer ou détruire des éléments de travail par lots à l’aide d’une API REST. Pour plus d'informations, consultez Éléments de travail – Supprimer.
Note
Cette fonctionnalité est disponible à partir d’Azure DevOps Server 2022.1.
Supprimer des éléments de travail
En définissant l’état d’un élément de travail sur Supprimé, vous le supprimez effectivement d’une vue de backlog ou de tableau : backlogs de produit, de portefeuille et de 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 workflow personnalisés, tout état que vous mappez à l’état de catégorie de workflow Supprimé se comporte de manière similaire. 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.
Note
L’état Supprimé n’est pas pris en charge avec le processus De base. Il est pris en charge uniquement avec les types d’éléments de travail Agile, Scrum et CMMI. Le processus de base est disponible avec Azure DevOps Services et Azure DevOps Server 2020 et versions ultérieures.
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.
Vous pouvez supprimer les éléments de travail de l'une des manières suivantes :
- Le formulaire d’élément de travail
- La page Éléments de travail du menu
Plus d’actions - Le menu contextuel de la carte du tableau
- Une page de résultats de backlog ou de requête
- REST API
Lancez votre opération de suppression :
Dans le formulaire d’élément de travail, ouvrez l’élément de travail, choisissez
Actions, puis sélectionnez Supprimer.
Pour supprimer plusieurs éléments de travail, sélectionnez-les plusieurs fois dans un backlog ou une liste de résultats de requête, choisissez le menu contextuel
, puis sélectionnez Supprimer.
Pour supprimer un élément de travail de votre tableau ou de votre tableau de tâches, choisissez le menu contextuel
de la carte et sélectionnez Supprimer.
Confirmez que vous souhaitez supprimer les éléments.
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.
Restaurez les éléments de travail supprimés ou supprimez-les définitivement à partir de la Corbeille du portail web.
Sélectionnez Boards>Éléments de travail>Corbeille.
Si vous ne voyez pas l’option Corbeille, choisissez Plus de commandes … et sélectionnez une option dans le menu.
Un nouvel onglet de navigateur s’ouvre avec la requête qui répertorie les éléments de travail ajoutés à la Corbeille.
Sélectionnez les éléments à restaurer, puis choisissez Restaurer.
Si vous le souhaitez, vous pouvez choisir de supprimer définitivement les éléments.
Confirmez votre sélection.
Note
Les artefacts de test tels que les plans de test, les suites de tests et les cas de test sont tous considérés comme des éléments de travail dans Azure DevOps. Toutefois, la méthode utilisée pour supprimer des artefacts de test dans Azure Boards diffère de la méthode de suppression d’éléments de travail non testés. Azure DevOps Services prend en charge un modèle de suppression réversible, où les plans de test et les suites de tests sont dans un état de suppression réversible pendant 14 jours après leur suppression. Bien qu’ils soient dans l’état de suppression réversible, ils peuvent être restaurés.
Supprimer ou détruire des éléments de travail de la ligne de commande
Vous pouvez supprimer ou détruire un élément de travail avec la commande az boards work-item delete . Pour commencer, consultez Démarrage avec l’interface CLI Azure DevOps.
Note
Vous pouvez restaurer des éléments de travail supprimés, mais vous ne pouvez pas restaurer les éléments de travail détruits.
az boards work-item delete --id
[--destroy]
[--org]
[--project]
[--yes]
- id : obligatoire. L'ID de l'élément de travail.
- destroy : facultatif. Supprimez définitivement cet élément de travail.
-
org : URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de
az devops configure -d organization=ORG_URL. Obligatoire en l’absence d’une configuration par défaut ou d’une récupération à l’aide degit config. Exemple :--org https://dev.azure.com/MyOrganizationName/. -
project : nom ou ID du projet. Vous pouvez configurer le projet par défaut en utilisant
az devops configure -d project=NAME_OR_ID. Obligatoire en l’absence d’une configuration par défaut ou d’une récupération à l’aide degit config. - oui : facultatif. Ne demande pas de confirmation.
La commande suivante supprime définitivement le bogue avec l’ID 864 et ne vous invite pas à confirmer.
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
- Rend l’élément de travail non consultable et, par conséquent, il n’apparaît plus dans aucune expérience de suivi du travail, aucun résultat de requête ni aucun 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/du cube comme s’il avait été supprimé de manière permanente.
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 de zone ou d’itération sur le nœud racine si le chemin de 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 :