Compartir a través de


Use @mentions en elementos de trabajo y solicitudes de incorporación de cambios

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

El control @mention le ayuda a agregar rápidamente un usuario o grupo a un elemento de trabajo o discusión de solicitudes de incorporación de cambios. El selector de personas se usa en el control @mention para seleccionar un miembro o grupo del proyecto en la lista de búsqueda. El usuario o grupo mencionado recibe una notificación por correo electrónico sobre su comentario.

Para las organizaciones que administran sus usuarios y grupos con Microsoft Entra ID, los selectores de personas admiten la búsqueda de todos los usuarios y grupos dentro de Microsoft Entra ID. Puede buscar usuarios y grupos además de los usuarios agregados a su proyecto. Para obtener más información, consulte Limitación de la visibilidad de usuarios para proyectos y más.

Nota

Puede publicar un @mention a través de la API. Para obtener el identificador de usuario de Azure DevOps, consulte Obtención del identificador de usuario de Azure DevOps.

  • Si su organización usa el editor HTML existente, agregue el código HTML siguiente:
    <div><a href="#" data-vss-mention="version:2.0,{userID}">@John Doe</a> Testing mentioning</div>
    
  • Si su organización usa el nuevo editor de Markdown para comentarios, use el código siguiente:
    @<userID>
    

El control @mention ayuda a agregar rápidamente un usuario a un elemento de trabajo o a una discusión de solicitudes de incorporación de cambios. El selector de personas se usa en el control @mention para seleccionar un miembro del proyecto en la lista de búsqueda. El usuario mencionado recibe una notificación por correo electrónico sobre su comentario.

Para las organizaciones que administran a sus usuarios mediante Active Directory, los selectores de personas admiten la búsqueda de todos los usuarios dentro de Active Directory, no solo los usuarios agregados a su proyecto.

Puede usar el control @mention para iniciar o continuar una discusión en las siguientes áreas:

  • Discusiones de elementos de trabajo o campos de texto con formato enriquecido
  • Discusiones sobre solicitudes de incorporación de cambios
  • Comentarios sobre confirmación de cambios
  • Conjunto de cambios o comentarios de conjunto de cambios

Nota

En el caso de Azure DevOps Server local, configure un servidor SMTP para que los miembros del equipo puedan ver la opción Notificaciones del menú de su organización o perfil de usuario y recibir notificaciones.

Requisitos previos

Categoría Requisitos
Acceso al proyecto Miembro del proyecto.

Utilice la búsqueda y selección de identidades

  1. Introduzca @ en un comentario de código en una solicitud de incorporación de cambios para activar el selector de personas mediante @mención.
  2. Vea la lista de usuarios que ha mencionado recientemente.
  3. Realice una búsqueda en el directorio seleccionando un nombre de la lista o introduciendo el nombre del usuario que está buscando.

Advertencia

Si tiene permiso para invitar a los usuarios a la organización, independientemente de si la directiva Restringir invitaciones está deshabilitada, puede @mention un usuario que no forma parte de su organización. Esta acción invita a ese usuario a su organización. Para obtener más información, vea Restringir nuevas invitaciones de usuario de administradores de proyectos y equipos.

Para filtrar la lista, introduzca el nombre de usuario o alias hasta que encuentre una coincidencia.

Captura de pantalla del selector de personas.

Azure DevOps muestra nombres de usuarios mencionados en texto azul. Elija el nombre del vínculo de @mention para abrir la información de contacto del usuario, que proporciona más contexto para por qué se agregaron a la conversación.

Captura de pantalla de la sección de discusión con la mención hecha.

Nota

No copie y pegue los usuarios @mención de un comentario anterior. Aunque el formato podría ser idéntico a una mención especificada correctamente, no se registra como una mención verdadera y no envía una notificación por correo electrónico.

Cuando complete la selección y la entrada de texto, el usuario de @mention recibe una alerta por correo electrónico sobre la mención.

Captura de pantalla del correo electrónico enviado en Outlook.

Puede usar el control @mention en discusiones de solicitudes de incorporación de cambios, comentarios de confirmación, comentarios de changeset y comentarios de shelveset.

Sugerencia

Dado que Azure DevOps no proporciona una macro directa @CreatedBy , puede usar la @Me macro en combinación con el campo "Creado por" para filtrar los elementos de trabajo creados por usted. Por ejemplo, para etiquetar al creador de elementos con descripciones en blanco, ejecute una consulta para identificar dichos elementos y, a continuación, etiquete manualmente los creadores en la sección de comentarios de cada elemento de trabajo, pidiéndoles que actualicen la descripción.

Comprender las identidades limitadas en la selección de búsqueda

Los selectores de personas suelen buscar y seleccionar cualquier usuario o grupo agregado a Microsoft Entra ID de una organización.

Para las organizaciones que usan el identificador de Entra de Microsoft para administrar usuarios y grupos, los selectores de personas admiten la búsqueda de todos los usuarios y grupos dentro del directorio. Para limitar la búsqueda y selección solo a los usuarios y grupos agregados a un proyecto específico, habilite la función Limitar la visibilidad y colaboración de los usuarios a proyectos específicos para su organización.

Al habilitar la característica Limitar la visibilidad y la colaboración del usuario a proyectos específicos de una organización, el sistema limita la lista de identidades que puede seleccionar de un selector de personas de las maneras siguientes:

  • Los usuarios agregados al grupo Usuarios con ámbito de proyecto solo pueden seleccionar elementos de una lista de identidades que contenga usuarios y grupos agregados explícitamente al proyecto al que están conectados.
  • Si agrega todos los miembros del proyecto al grupo Usuarios deProject-Scoped , los selectores de personas limitan las selecciones solo a los usuarios y grupos agregados al proyecto. Todos los miembros del proyecto solo pueden seleccionar identidades que coincidan con usuarios y grupos agregados explícitamente al proyecto al que están conectados.

Advertencia

Tenga en cuenta las siguientes limitaciones al usar esta característica en vista previa (GB):

  • Las características de visibilidad limitadas descritas en esta sección solo se aplican a las interacciones a través del portal web. Con las API REST o azure devops los comandos de la CLI, los miembros del proyecto pueden acceder a los datos restringidos.
  • Los usuarios del grupo limitado solo pueden seleccionar usuarios que se agregan explícitamente a Azure DevOps y no aquellos que tienen acceso a través de la pertenencia a grupos de Microsoft Entra.
  • Los usuarios invitados que sean miembros del grupo restringido con acceso predeterminado en Microsoft Entra ID no pueden buscar usuarios con el selector de personas.