Partage via


Ajouter des balises d’élément de travail pour classer et filtrer des listes et des tableaux

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

Étiquetez des éléments de travail pour filtrer rapidement le journal des travaux en souffrance du produit ou une requête d'élément de travail selon des catégories que vous avez définies. Une étiquette correspond à une expression à un ou deux mots clés que vous définissez et qui prend en charge vos besoins pour filtrer un backlog ou une requête, ou définir une requête.

Les étiquettes sont un meilleur choix pour filtrer les éléments de travail que d’utiliser des chaînes de texte, comme décrit dans Définir une requête/Meilleures pratiques.

Vous pouvez ajouter et modifier des étiquettes à partir du portail web, à partir du plug-in Team Explorer pour Visual Studio. Vous pouvez également ouvrir une requête dans Excel pour modifier des étiquettes en bloc.

Remarque

Les étiquettes sont une ressource partagée associées à un projet, et non à une équipe. Si votre projet contient plusieurs équipes, toutes les équipes procèdent à des ajouts dans le même jeu d’étiquettes et l’utilisent.

Prérequis

  • Accès au projet : être ajouté à un projet.

  • Autorisations :

    • Vos autorisations Afficher vos éléments de travail dans ce nœud et Modifier les éléments de travail dans ce nœud doivent être définies sur Autoriser. Par défaut, le groupe des contributeurs dispose de ces permissions. Pour plus d’informations, consultez Définir les autorisations de suivi du travail.

    • Pour pouvoir ajouter de nouvelles balises à des éléments de travail, vous devez disposer d’un accès de base ou supérieur et avoir défini les autorisations de création de balises sur Autoriser.. Par défaut, ce jeu d’autorisations est défini sur le groupe Contributeurs.

      Remarque

      Les stakeholders ne peuvent pas ajouter de nouvelles étiquettes, même si la permission est explicitement définie, en raison de leur niveau d’accès. Pour plus d’informations, consultez Référence rapide sur l’accès de partie prenante.

  • Envoyer des éléments de travail par e-mail : Tous les membres du projet, y compris ceux du groupe Lecteurs, peuvent envoyer des e-mails contenant des éléments de travail.

  • Les utilisateurs disposant d’un accès Partie prenante pour les projets publics peuvent ajouter de nouvelles étiquettes.
  • Par défaut, tous les contributeurs et les parties prenantes des projets publics se voient accorder des autorisations leur permettant d’ajouter des balises nouvelles et existantes. Les parties prenantes aux projets privés peuvent ajouter des balises déjà définies, mais ne peuvent pas des nouvelles balises. Pour accorder ou restreindre les autorisations de création d’étiquettes, vous devez définir l’autorisationCréer une définition de étiquetteau niveau du projet. Pour plus d’informations, consultez Modifier les autorisations au niveau du projet.

Ajouter des étiquettes à un élément de travail

Les étiquettes doivent comporter 400 caractères ou moins, et ne pas contenir de séparateurs comme , (virgule), ; (point-virgule) ou un autre caractère de mise en forme.

Recommandation : n’utilisez pas le caractère @ dans une balise. Les balises qui commencent par le caractère @ ne peuvent pas être utilisées dans une requête d’élément de travail. Le caractère @ signifie une macro dans une requête et, par conséquent, l’étiquette n’est pas reconnue comme telle.

À partir du portail web, ouvrez un élément de travail et ajoutez une balise. Choisissez Ajouter une étiquette et tapez votre mot clé. Sinon, faites une sélection dans la liste des balises précédemment assignées.

Capture d’écran montrant l’ajout d’une ou de plusieurs balises à un élément de travail.

Pour ajouter plusieurs étiquettes en même temps, séparez-les par une virgule. Les balises sont sensibles à la casse.

Les étiquettes affichées dans la barre d’étiquette sont déjà assignées à l’élément de travail. Pour annuler l’affectation d’une étiquette, choisissez le x sur l’étiquette,Capture d’écran de la suppression d’une balise attribuée à un élément de travail..

Ajouter ou supprimer en bloc des étiquettes

Vous pouvez mettre à jour en bloc des éléments de travail pour ajouter ou supprimer des étiquettes du portail web. Vous modifiez les étiquettes en bloc de la même manière que vous modifiez en bloc d’autres champs à l’aide du portail web. Vous pouvez également utiliser Excel pour ajouter ou supprimer des étiquettes en bloc.

Capture d’écran montrant la boîte de dialogue Modifier des éléments de travail, Ajouter en bloc à plusieurs éléments de travail.

Remarque

La modification en bloc des balises à partir de Visual Studio ou d’autres clients compatibles n’est pas prise en charge.

Interroger des éléments de travail en fonction des étiquettes

Pour interroger des éléments de travail en fonction des étiquettes, ajoutez une clause pour chaque étiquette que vous souhaitez utiliser pour prendre en charge votre requête.

Conseil

Pour comprendre comment les clauses AND/OR sont regroupées, consultez Créer et enregistrer des requêtes managées, Regrouper des clauses. Pour afficher la syntaxe WIQL d’une requête, installez l’extension de l’éditeur de requête WIQL qui vous permettra de voir la version WIQL de n’importe quelle entrée d’éditeur de requête.

Vous pouvez utiliser les opérateurs Contains ou Does Not Contain. Les étiquettes qui commencent par le caractère @ ne peuvent pas être utilisées dans une requête d’élément de travail, car l’éditeur de requête interprète le caractère @ comme une macro. Pour plus d’informations, consultez Créer des requêtes managées.

Par exemple, ici, nous interrogeons tous les éléments de travail étiquetés Web ou Service.

Capture d’écran de l’Éditeur de requête pour interroger sur les étiquettes.

Remarque

Vous ne pouvez pas interroger des éléments de travail auxquels aucune étiquette n’est attachée. Si vous souhaitez voter pour la demande de prise en charge de cette fonctionnalité, vous pouvez le faire sur notre page Developer Community, Être en mesure de rechercher des étiquettes vides.

Afficher les balises dans votre Backlog ou vos résultats de requête

Choisissez Options de colonne pour ajouter le champ Étiquettes au Backlog de produit ou à une requête d’élément de travail. Si l’option n’apparaît pas, choisissez Autres commandes pour la sélectionner dans le menu des options.

Capture d’écran de la Boîte de dialogue d’options de colonne, Ajouter des étiquettes aux colonnes sélectionnées à afficher.

Toutes les étiquettes ajoutées aux éléments de travail répertoriés apparaissent.

Capture d’écran du backlog de produit, Affichage avec la colonne Étiquettes ajoutée.

Filtrer les listes à l’aide d’étiquettes

À partir du portail web, vous pouvez filtrer les backlogs, les tableaux et les résultats des requêtes à l’aide d’étiquettes.

Commencez par choisir Filtrer .

Cochez les cases des étiquettes sur lesquelles vous souhaitez filtrer. Conservez la sélection OR pour exécuter un OR logique pour toutes les étiquettes que vous avez sélectionnées. Vous pouvez également choisir l’option AND pour exécuter un AND logique sur toutes les étiquettes sélectionnées.

Capture d’écran de l’affichage avec la colonne Étiquettes ajoutée.

Supprimer, retirer ou gérer des étiquettes

Vous ne pouvez pas supprimer des étiquettes en utilisant l’interface utilisateur web d’Azure DevOps.

Si vous devez supprimer une étiquette, vous pouvez créer un script ou une application capable d’effectuer une suppression en utilisant l’API REST Azure DevOps ou les bibliothèques de client .NET. Pour obtenir plus d’exemples, consultez Azure-DevOps-Admin-CLI.

Une autre option consiste à installer le Gestionnaire d’étiquettes de la Place de marché, qui ajoute une page Étiquettes sous Tableaux ou Travail pour gérer les étiquettes, y compris les suppressions.

Codage de couleurs des étiquettes sur les tableaux

Pour mettre en évidence les étiquettes sur les cartes de tableau en les codant en couleur. Ces couleurs apparaissent uniquement sur le tableau que vous configurez. Elles n’apparaissent pas dans les backlogs ou les tableaux des tâches. Pour plus d'informations, consultez Personnaliser des cartes, étiquettes avec code couleur.

Capture d’écran de la séquence, Tableaux, Paramètres, boîte de dialogue Couleurs des étiquettes.

Graphique des éléments de travail et regroupement par étiquettes

Vous ne pouvez pas regrouper un graphique basé sur une requête par étiquettes. Toutefois, vous pouvez regrouper un widget Graphique pour éléments de travail par des étiquettes que vous ajoutez à un tableau de bord. Cette fonctionnalité est en version préliminaire publique. Pour l’activer, consultez Gérer ou activer les fonctionnalités et activez Activer le regroupement par étiquettes pour le widget de graphique d’élément de travail sur le tableau de bord.

Pour regrouper un widget Graphique pour éléments de travail par étiquettes, effectuez les mêmes étapes que celles fournies dans Suivre la progression avec des graphiques basés sur des requêtes d’état et de tendance, Ajouter un widget de graphique à un tableau de bord. Assurez-vous que votre requête de liste plate contient des Étiquettes dans la clause de requête ou en tant qu’option de colonne. Ensuite, choisissez Étiquettes pour la sélection Regrouper par. Pour filtrer le graphique de façon à n’afficher que certaines étiquettes, choisissez la case d’option Étiquettes sélectionnées, puis choisissez les étiquettes que vous souhaitez afficher.

Capture d’écran de Graphique par éléments de travail, Configurer, Regrouper par étiquettes.

Limites sur le nombre d’étiquettes

bien qu’aucune limite ne soit véritablement imposée, créer plus de 100 000 étiquettes pour une collection de projets peut nuire aux performances. En outre, le menu déroulant de saisie semi-automatique pour le contrôle d’étiquette affiche un maximum de 200 étiquettes. Quand plus de 200 étiquettes sont définies, commencez à taper un nom pour que le contrôle d’étiquette affiche les étiquettes correspondantes.

Vous ne pouvez pas affecter plus de 100 étiquettes à un élément de travail, ou vous recevrez le message suivant :

TF401243: Failed to save work item because too many new tags were added to the work item.

Enregistrez l’élément de travail avec les étiquettes (100 ou moins) que vous avez ajoutées ; vous pourrez alors ajouter d’autres étiquettes.

Limiter les requêtes à moins de 25 balises. Au-delà de cette quantité, la requête est susceptible de dépasser le délai d’expiration.

Ajouter des étiquettes à la vue de colonne par défaut dans le backlog de produit

Pour ajouter le champ Étiquettes en tant que champ de colonne pour le backlog de produit, vous modifiez le fichier ProcessConfiguration de manière à inclure System.Tags. Pour plus d’informations, consultez les Référence des éléments XML de configuration du processus.

Extension de la Place de marché