Partager via

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

  • Article

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 :

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.
Restauration Récupérez les éléments de travail supprimés en les restaurant à partir de la Corbeille.
Détruire Supprimez définitivement les éléments de travail, y compris toutes les données du magasin de données de suivi du travail.

Remarque

  • 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.

Prérequis

  • Autorisations :
    • Pour supprimer, supprimer et restaurer des éléments de travail, il s’agit d’un membre du groupe Contributeurs .
    • Pour supprimer définitivement les éléments de travail, être membre du groupe Administrateurs de projet ou accorder 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.

Tâche

Autorisations requises

Remplacer l’état par Supprimer ou Couper

  • Avoir l’autorisation Chemin de zone définie sur Autoriser : Modifier les éléments de travail dans ce nœud
  • Les membres du groupe Contributeurs disposent de cette autorisation.

Supprimer des éléments de travail
Restaurer des éléments de travail

  • Avoir l’autorisation au niveau du projet définie sur Autoriser : Supprimer et restaurer des éléments de travail
  • Disposer d’un accès De base ou supérieur.
  • Les membres du groupe Contributeurs disposent de cette autorisation.

Supprimer ou détruire définitivement des éléments de travail

  • Avoir l’autorisation au niveau du projet définie sur Autoriser : Supprimer définitivement des éléments de travail
  • Par défaut, les membres du groupe Administrateurs de projet disposent de cette autorisation.

::: moniker-end

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

  • Avoir l’autorisation au niveau du projet définie sur Autoriser : Supprimer définitivement des é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.

Notes

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 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.

Remarque

Cette fonctionnalité est disponible à partir d’Azure DevOps Server 2022.1.

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.

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

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.

Notes

L’état Supprimé n’est pas pris en charge avec le processus De base. Il est uniquement pris en charge avec les types d’éléments de travail de processus Agile, Scrum et CMMI. Le processus de base est disponible lorsque vous ajoutez un projet à Azure DevOps Services ou Azure DevOps Server 2019 Mise à jour 1.

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
  • Menu contextuel de la carte de bord
  • 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, puis sélectionnez Supprimer.

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

  2. Vérifiez 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. 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.

  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.

Remarque

Les artefacts de test supprimés n’apparaissent pas dans la Corbeille et ne peuvent pas être restaurés. Lorsque vous supprimez un artefact de test, tous ses éléments enfants associés, tels que les suites de tests enfants, les points de test sur toutes les configurations, les testeurs, l’historique des résultats des tests et d’autres historiques associés sont également supprimés. L’élément de travail de cas de test sous-jacent n’est pas supprimé.

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.

Remarque

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.
  • détruire : 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 de git config. Exemple : --org https://dev.azure.com/MyOrganizationName/.
  • projet : 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 de git 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
  • 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 :