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

L'étiquetage des éléments de travail vous permet de 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.

Notes

Les étiquettes sont une ressource partagée ; elles sont 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

• Vous devez être ajouté à un projet.
• Pour afficher ou modifier des éléments de travail, vous devez régler vos autorisations Afficher les éléments de travail dans ce nœud. et Modifier les éléments de travail dans ce nœud sur Autoriser. Cette autorisation est définie par défaut pour le groupe Contributeurs. Pour plus d'informations, consultez Définir les autorisations et l'accès pour le suivi du travail.
• Pour pouvoir ajouter de nouvelles étiquettes à 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 d’étiquettes sur Autoriser. Par défaut, ce jeu d’autorisations est défini sur le groupe Contributeurs. Même si l’autorisation est définie explicitement pour une partie prenante, celle-ci n’a pas l’autorisation d’ajouter de nouvelles étiquettes, car c’est interdit par son niveau d’accès. Pour plus d’informations, consultez Référence rapide sur l’accès de partie prenante.
• Tous les membres du projet, même les membres du groupe Lecteurs, peuvent envoyer des e-mails contenant des éléments de travail.

Remarque

Les utilisateurs disposant d’un accès Partie prenante pour les projets publics sont autorisés à ajouter de nouvelles étiquettes.

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.

Conseil

Nous vous recommandons de ne pas utiliser le caractère @ dans une étiquette. 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.

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

Notes

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

Notes

La modification en bloc des étiquettes à 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

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 en savoir plus sur les requêtes, consultez Créer des requêtes managées.

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

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.

Notes

La possibilité d’interroger des éléments de travail qui n’ont pas d’étiquettes associées n’est pas une fonctionnalité prise en charge. 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.

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

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.

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

Vous pouvez mettre en évidence des étiquettes sur les cartes de tableau Kanban en les codant en couleur. Ces couleurs apparaissent uniquement sur le tableau Kanban 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.

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

Notes

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.

Articles connexes

• Utiliser l’éditeur de requêtes pour lister et gérer les requêtes
• Afficher les étiquettes sur les cartes
• Modifier en bloc des éléments de travail à partir du portail web
• Modifier en bloc des éléments de travail à partir d’Excel

Extension de la Place de marché

• Gestionnaire d’étiquettes de la Place de marché

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.