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

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

Les éléments de travail peuvent rester dans votre entrepôt de données de suivi du travail indéfiniment. 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 :

Conseil / Astuce

Vous pouvez utiliser l’IA pour faciliter cette tâche plus loin dans cet article, ou voir Enable AI assistance avec Azure DevOps MCP Server pour commencer.

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.
Supprimer 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.
Restaurer 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 Delete 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 disposer de 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
Remplacer l’état par Supprimer ou Couper - Autorisation de chemin 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 - Autorisation au niveau du projet définie sur Autoriser : Supprimer et restaurer des éléments de travail
- Au moins un accès de base
- Par défaut, les membres du groupe Contributeurs ont cette autorisation
Supprimer ou détruire définitivement des éléments de travail - Autorisation au niveau du projet réglée sur Autoriser : Supprimer définitivement les éléments de travail
- Par défaut, les membres du groupe Project Administrateurs disposent de cette autorisation
Supprimer ou détruire des éléments de travail à partir de la ligne de commande - Autorisation au niveau du projet réglée sur Autoriser : Supprimer définitivement les éléments de travail
- Par défaut, les membres du groupe Project Administrateurs 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 de Azure DevOps Server 2022.1.

Supprimer des éléments de travail

Lorsque vous modifiez l'état d’un élément de travail en Supprimé, vous le retirez effectivement d’un backlog ou d'une vue de tableau : backlogs de produits, de portefeuilles et de sprints, 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.

Capture d’écran du formulaire d’élément de travail, Modifier l’état sur Supprimé.

Pour empêcher l’affichage d’éléments supprimés dans les requêtes, ajoutez 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. Les éléments restent dans la Corbeille jusqu’à ce que vous les restaurez ou les supprimez définitivement. 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
  1. 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.

      Capture d’écran du formulaire d’élément de travail, menu Actions, choisissez 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.

      Capture d’écran du menu Actions à sélection multiple du backlog, choisissez 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.

      Capture d’écran du menu contextuel de la carte du tableau, choisissez Supprimer.

  2. Confirmez que vous souhaitez supprimer les éléments.

    Capture d’écran de la boîte de dialogue Confirmer la suppression.

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

Vous ne pouvez pas ouvrir les éléments de travail à partir de la Corbeille. La Corbeille ne supprime jamais automatiquement les éléments. Ils restent dans la Corbeille jusqu’à ce que vous les restaurez ou les supprimez définitivement. L’option Supprimer définitivement est disponible uniquement si votre autorisation de suppression définitive des é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.

  1. Sélectionnez Boards>Éléments de travail>Corbeille.

    Capture d’écran des tableaux, page Éléments de travail, Corbeille ouverte.

    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.

  2. Sélectionnez les éléments à restaurer, puis choisissez Restaurer.

    Capture d’écran de Restaurer les éléments sélectionnés.

    Si vous le souhaitez, vous pouvez choisir de supprimer définitivement les éléments.

  3. 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 celle pour supprimer des éléments de travail non test. 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. Tant qu’ils sont en état de suppression réversible, vous pouvez les restaurer.

Supprimer ou détruire des éléments de travail de la ligne de commande

Utilisez la commande az boards work-item delete pour supprimer ou détruire un élément de travail. Pour commencer, consultez Commencez avec Azure DevOps CLI.

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. Configurez l’organisation par défaut à l’aide de az devops configure -d organization=ORG_URL. Si vous ne configurez pas l’organisation par défaut ou si git config elle ne récupère pas d’organisation, vous devez spécifier ce paramètre. Exemple : --org https://dev.azure.com/MyOrganizationName/.
  • project : nom ou ID du project. Configurer le projet par défaut en utilisant az devops configure -d project=NAME_OR_ID. Si vous ne configurez pas le projet par défaut ou si git config ne détecte pas de projet, vous devez spécifier ce paramètre.
  • 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é par/Date de modification pour prendre en charge la traçabilité.
  • Préserve intégralement l'élément de travail, y compris toutes les attributions de champs, pièces jointes, balises et liens.
  • Rend l’élément de travail non interrogeable, de sorte qu’il n’apparaît pas dans une expérience de suivi de travail, un résultat de requête ou un rapport.
  • Met à jour correctement des charts. Les graphiques CFD, de vitesse, de burndown et les graphiques légers sont mis à jour afin de retirer 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 comme s'il avait été supprimé définitivement.

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

  • Crée une nouvelle révision de l’élément de travail.
  • Met à jour les champs Modifié par/Date de modification pour prendre en charge la traçabilité.
  • Rend l’élément de travail interrogeable.
  • Conserve tous les champs inchangés.
  • Ajoute deux nouvelles révisions à l’historique, une pour la suppression et une pour la restauration.
  • Rattache les extensions de suivi du travail.
  • Met à jour correctement des charts. Les graphiques CFD, de vitesse, de burndown et les graphiques légers sont mis à jour afin d’inclure les éléments de travail restaurés.
  • Restaure les données de tendance.
  • Ajoute à nouveau 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 :

Utiliser l’IA pour rechercher des éléments de travail à supprimer

Si vous connectez le Azure Boards MCP Server à votre agent IA en mode agent, vous pouvez utiliser des invites en langage naturel pour rechercher et mettre à jour des éléments de travail avant de les supprimer ou de les supprimer.

Tâche Exemple d’invite
Changer l'état en Supprimé Change the state of work items #101, #102, and #103 to Removed
Rechercher des éléments dans l’état Supprimé List all work items in the Removed state in area path <Contoso>\\OldFeature
Rechercher des éléments obsolètes à nettoyer Show me all work items in the 'New' state that haven't been updated in the last 90 days
Identifier les éléments fermés List all work items closed more than a year ago in the <Contoso> project
Rechercher un travail abandonné List active work items in <Contoso> assigned to people who are no longer on the team
Identifier des doublons potentiels Show bugs in <Contoso> with the same title or very similar titles
Rechercher des éléments sans activité List work items in <Contoso> that never had a state change and were created more than 60 days ago
Aperçu de l’impact de la suppression Show all child work items linked to user story <1234> so I can review before removing it
Modification de l’état en bloc Set all user stories in area path <Contoso\\DeprecatedModule> to the Removed state
Auditer les éléments supprimés List all work items in <Contoso> that were moved to the Removed state in the last 30 days and show who changed them

Note

Le mode agent et le serveur MCP utilisent le langage naturel. Vous pouvez donc ajuster ces invites ou poser des questions de suivi pour affiner les résultats. Le serveur MCP peut mettre à jour les états des éléments de travail, mais ne peut pas supprimer, restaurer ou détruire des éléments de travail.