Utiliser @mentions dans les éléments de travail et les demandes de tirage

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

Le contrôle @mention vous permet d’ajouter rapidement un utilisateur ou un groupe à une discussion sur un élément de travail ou une pull request. Vous utilisez le sélecteur de personnes dans le contrôle @mention pour sélectionner un membre ou un groupe de projet dans la liste de recherche. L’utilisateur ou le groupe mentionné reçoit une notification par email concernant votre commentaire.

Pour les organisations qui gèrent leurs utilisateurs et groupes à l’aide de l’ID Microsoft Entra, les sélecteurs de personnes prennent en charge la recherche dans tous les utilisateurs et groupes dans l’ID Microsoft Entra. Vous pouvez rechercher des utilisateurs et des groupes au-delà de ceux ajoutés à votre projet. Pour plus d'informations, voir Limiter la visibilité des utilisateurs pour les projets et autres.

Note

Vous pouvez publier un @mention via une API. Pour obtenir l’ID utilisateur Azure DevOps, consultez Obtenir l’ID d’utilisateur Azure DevOps.

• Si votre organisation utilise l’éditeur HTML existant, ajoutez le code HTML suivant :

  <div><a href="#" data-vss-mention="version:2.0,{userID}">@John Doe</a> Testing mentioning</div>
  

• Si votre organisation utilise le nouvel éditeur Markdown pour les commentaires, utilisez le code suivant :

  @<userID>
  

Vous pouvez utiliser le contrôle @mention pour démarrer ou poursuivre une discussion dans les domaines suivants :

• Discussions sur les éléments de travail ou tout champ de texte enrichi
• Discussions sur les demandes de tirage
• Commentaires de commit
• Commentaires changeset ou shelveset

Prérequis

Catégorie	Spécifications
Accès au projet	Membre du projet.

Utiliser la recherche d'identité et la fonction de sélection

1. Entrez @ dans un commentaire de code d'une demande de tirage pour déclencher le sélecteur de personnes @mention.
2. Affichez la liste des utilisateurs que vous avez récemment mentionnés.
3. Recherchez dans le répertoire en sélectionnant un nom dans la liste ou en entrant le nom de l’utilisateur que vous recherchez.

Warning

Si vous êtes autorisé à inviter des utilisateurs dans l’organisation, que la stratégie Restreindre les invitations soit désactivée ou non, vous pouvez @mentionner un utilisateur qui ne fait pas partie de votre organisation. Cette action invite cet utilisateur dans votre organisation. Pour plus d’informations, consultez la section Restreindre les invitations des administrateurs de projet et d’équipe aux nouveaux utilisateurs.

Pour filtrer la liste, entrez le nom d’utilisateur ou l’alias jusqu’à ce que vous trouviez une correspondance.

Azure DevOps affiche les noms des utilisateurs mentionnés en texte bleu. Choisissez le nom du lien @mention pour ouvrir les informations de contact de l’utilisateur, afin de comprendre pourquoi il/elle a été ajouté(e) à la conversation.

Note

Ne copiez-collez pas les utilisateurs @mention d’un commentaire précédent. Bien que la mise en forme puisse être identique à une mention correctement entrée, elle ne s’inscrit pas en tant que mention vraie et n’envoie pas de notification par e-mail.

Lorsque vous terminez votre sélection et votre entrée de texte, votre @mention utilisateur reçoit un e-mail qui les avertit de la mention.

Vous pouvez utiliser le contrôle @mention dans les discussions de pull request, les commentaires de validation, les commentaires de l’ensemble de modifications et les commentaires de shelveset.

Conseil

Étant donné qu’Azure DevOps ne fournit pas de macro directe @CreatedBy , vous pouvez utiliser la macro en combinaison avec le @Me champ « Créé par » pour filtrer les éléments de travail créés par vous. Par exemple, pour baliser le créateur d’éléments avec des descriptions vides, exécutez une requête pour identifier ces éléments, puis étiquetez manuellement les créateurs dans la section commentaires de chaque élément de travail, en leur demandant de mettre à jour la description.

Comprendre les identités limitées dans la sélection de recherche

Les sélecteurs de personnes recherchent et sélectionnent généralement n’importe quel utilisateur ou groupe ajouté à l’ID Microsoft Entra d’une organisation.

Pour les organisations qui utilisent l’ID Microsoft Entra pour gérer les utilisateurs et les groupes, les sélecteurs de personnes prennent en charge la recherche dans tous les utilisateurs et groupes dans l’annuaire. Pour limiter la recherche et la sélection aux seuls utilisateurs et groupes ajoutés à un projet spécifique, activez la fonctionnalité en préversion Limiter la visibilité et la collaboration des utilisateurs à certains projets pour votre organisation.

Lorsque vous activez la fonctionnalité en préversion Limiter la visibilité et la collaboration des utilisateurs à des projets spécifiques pour une organisation, le système limite la liste des identités que vous pouvez sélectionner à partir d’un sélecteur d'utilisateurs de la manière suivante :

• Les utilisateurs ajoutés au groupe Utilisateurs affectés à un projet ne peuvent effectuer leur sélectionner qu’à partir d’une liste d’identités contenant des utilisateurs et groupes explicitement ajoutés au projet auquel ils sont connectés.
• Si vous ajoutez tous les membres du projet au groupe utilisateursProject-Scoped , les sélecteurs de personnes limitent les sélections aux seuls utilisateurs et groupes ajoutés au projet. Tous les membres du projet peuvent uniquement sélectionner des identités qui correspondent aux utilisateurs et groupes explicitement ajoutés au projet auquel ils sont connectés.

Warning

Tenez compte des limitations suivantes lors de l’utilisation de cette fonctionnalité en préversion :

• Les fonctionnalités de visibilité limitée décrites dans cette section s’appliquent uniquement aux interactions au moyen du portail web. Avec les API REST ou les commandes CLI azure devops, les membres du projet peuvent accéder aux données dont l’accès est restreint.
• Les utilisateurs du groupe limité peuvent uniquement sélectionner les utilisateurs qui sont explicitement ajoutés à Azure DevOps et non les utilisateurs qui ont accès via l’appartenance au groupe Microsoft Entra.
• Les utilisateurs invités et membres du groupe limité avec un accès par défaut dans Microsoft Entra ID ne peuvent pas rechercher d’utilisateurs avec le sélecteur de personne.

Contenu connexe

• Contrôles de formulaire d’élément de travail
• Requêtes de tirage