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

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

É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 balise correspond à une ou deux expressions de mot clé que vous définissez. Une balise prend en charge vos besoins pour filtrer un backlog ou une requête, ou définir une requête.

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

Les balises sont un meilleur choix pour filtrer les éléments de travail que pour utiliser des chaînes de texte, comme décrit dans Définir une requête d’élément de travail. 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.

Note

Les noms des balises des éléments de travail et des demandes de tirage (PR), également appelés étiquettes, partagent le même pool au sein d’une organisation ou d’une collection de projets. La limite combinée est de 150 000 noms d’étiquettes uniques. Pour plus d’informations, consultez Suivi du travail, processus et limites de projet etÉtiquettes de demande de tirage.

Tip

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.

Prerequisites

Category Requirements
Permissions Pour afficher, suivre et modifier les éléments de travail :
- Afficher les éléments de travail dans ce nœud (Autoriser)
- Modifier les éléments de travail dans ce nœud (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 ajouter de nouvelles balises :
- Autorisation Créer une définition de balise au niveau du projet (Autoriser)
Par défaut, le groupe Contributeurs dispose de cette autorisation.
Niveaux d’accès - Membre du projet

Pour ajouter de nouvelles balises ou suivre des pull requests : Au moins Basic

Pour afficher ou suivre les éléments de travail : Au moins Stakeholder

Pour envoyer des e-mails avec des éléments de travail : doit être membre du groupe Contributeurs

Note

  • Attribuez l’accès des parties prenantes aux membres qui souhaitent passer en revue la progression et discuter des éléments de travail, mais qui ne contribuent pas au code. Ils peuvent afficher des éléments de travail, des backlogs, des tableaux et des tableaux de bord.
  • Par défaut, les contributeurs et les parties prenantes dans les projets publics peuvent ajouter des balises nouvelles et existantes. Dans les projets privés, seuls les contributeurs peuvent ajouter de nouvelles balises. Pour modifier les autorisations de création de balise, définissez l’autorisation Créer une définition de balise au niveau du projet. Pour plus d’informations, consultez Modifier les autorisations au niveau du projet.

Note

  • Attribuez l’accès des parties prenantes aux membres qui souhaitent passer en revue la progression et discuter des éléments de travail, mais qui ne contribuent pas au code. Ils peuvent afficher des éléments de travail, des backlogs, des tableaux et des tableaux de bord.

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 balise, choisissez le x sur la balise.

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 les éléments de travail, avec la valeur balises à ajouter.

Note

Boards ne prend pas en charge la modification des balises par lots à partir de Visual Studio ou d'autres clients.

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.

Tip

Pour comprendre comment AND/OR les clauses sont regroupées, consultez les clauses Group. Pour afficher la syntaxe WIQL d’une requête, installez l’extension de l’éditeur de requête WIQL, ce qui vous permet de voir la version WIQL de toute entrée de l’éditeur de requête.

Vous pouvez utiliser les opérateurs Contains ou Does Not Contain. Les balises 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 en tant que macro. Pour plus d’informations, veuillez consulter la section Définir une requête d’élément de travail.

Par exemple, voici une requête pour tous les éléments de travail marqués comme étant soit Web, soit Service.

Screenshot affiche le Éditeur de requête avec une requête sur tags.

Note

Vous ne pouvez pas interroger des éléments de travail auxquels aucune étiquette n’est attachée. Si vous souhaitez soutenir la demande de prise en charge de cette fonctionnalité, vous pouvez le faire sur notre page de la communauté des développeurs, Être capable de rechercher des balises 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 montrant la boîte de dialogue Options de colonne, avec l’option Balises.

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

Capture d’écran montrant le backlog produit dans lequel vous pouvez voir la colonne Balises.

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.

Sélectionnez les balises 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 montrant le backlog produit filtré par balises.

Supprimer, retirer ou gérer des étiquettes

Vous ne pouvez pas supprimer des balises à l'aide de l'interface utilisateur web Azure DevOps.

Si vous devez supprimer une balise, créez un script ou une application capable de supprimer à l’aide de l'< API REST Azure DevOps/c0> ou des bibliothèques clientes .NET. Pour 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 Affecter des couleurs de balise.

Capture d’écran montrant la page Couleurs des balises pour définir les couleurs des balises.

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 Ajouter un graphique à un tableau de bord. Vérifiez que votre requête de liste plate contient des balises 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 montrant Graphique par éléments de travail configurés pour regrouper par balises.

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 la colonne pour l'arriéré de produit, modifiez le fichier ProcessConfiguration afin d’inclure System.Tags Pour plus d’informations, consultez la référence d'élément XML de la configuration du processus.

Utiliser l’IA pour interroger et gérer des balises d’élément de travail

Si vous disposez du Azure Boards MCP Server connecté à votre agent IA en mode agent, vous pouvez utiliser des invites en langage naturel pour rechercher et mettre à jour des éléments de travail basés sur des balises.

Tâche Exemple d’invite
Rechercher des éléments marqués Find all active work items tagged with "security" in my project
Ajouter des balises en bloc Add the tag "tech-debt" to all active bugs in the current sprint
Rechercher des éléments non étiquetés List work items with no tags assigned in the <Contoso> area path
Interroger par plusieurs balises Find user stories tagged with both "performance" and "P1"
Répertorier toutes les balises en cours d’utilisation Show all distinct tags used on work items in project <Contoso> sorted by usage count
Nettoyer les balises obsolètes List tags in <Contoso> that are used on fewer than 2 work items
Remplacer une balise Find all work items in <Contoso> tagged "wontfix" and replace that tag with "by-design"
Étiqueter par critères Add tag "needs-review" to all user stories in <Contoso> that were resolved in the last week but have no linked pull request
Analyser les modèles d’étiquettes Show the count of active work items per tag in area path <Contoso\\Frontend>
Rechercher des incohérences de balises List work items in <Contoso> tagged "sprint-goal" that aren't assigned to the current sprint

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.

Contenu connexe

Extension de la Place de marché

  • Last updated on