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

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

El control @mention permite agregar rápidamente un usuario o grupo a un elemento de trabajo o a una discusión de solicitud de incorporación de cambios. Con el selector de personas del control @mention , puede seleccionar un miembro o grupo del proyecto en la lista de búsqueda y reciben un correo electrónico que les notifica su comentario.

En el caso de las organizaciones que administran sus usuarios y grupos mediante el identificador de Microsoft Entra, los selectores de personas admiten la búsqueda de todos los usuarios y grupos agregados a microsoft Entra ID, no solo los usuarios y grupos agregados al proyecto. Para limitar el conjunto a los miembros y grupos del proyecto, consulte Administrar la organización, Limitar la búsqueda y la selección de identidades.

Nota

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

Si su organización usa el edtitor HTML existente, agregue el código html siguiente: <div><a href="#" data-vss-mention="version:2.0,{user id}">@John Doe</a> Testing mentioning</div>

Si su organización usa el nuevo edtitor de Markdown para los comentarios, puede usar el código siguiente: @<UserID>

El control @mention permite agregar rápidamente un usuario a un elemento de trabajo o a una discusión de solicitudes de incorporación de cambios. Con el selector de personas del control @mention , puede seleccionar un miembro del proyecto en la lista de búsqueda y recibir un correo electrónico que les notifique su comentario.

En el caso de las organizaciones que administran sus usuarios mediante Active Directory, los selectores de personas proporcionan compatibilidad con la búsqueda de todos los usuarios agregados a Active Directory, no solo los usuarios agregados al proyecto.

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

  • Discusión de un elemento de trabajo o cualquier campo de texto enriquecido
  • Discusión de una solicitud de incorporación de cambios
  • Comentarios sobre confirmación de cambios
  • Conjunto de cambios o comentarios de conjunto de cambios
  • Discusión de un elemento de trabajo
  • Discusión de una solicitud de incorporación de cambios
  • Comentarios sobre confirmación de cambios
  • Conjunto de cambios o comentarios de conjunto de cambios

Nota

Para los Azure DevOps Server locales, configure un servidor SMTP para los miembros del equipo para ver la opción Notificaciones del menú de su organización o perfil de usuario y recibir notificaciones.

Selección de búsqueda de identidades

Cuando deje un comentario de código en una solicitud de incorporación de cambios, escriba @ para desencadenar el selector de personas de @mention . En el selector de personas, verá una lista de usuarios que ha mencionado recientemente. Para realizar una búsqueda de directorios, elija un nombre o escriba 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, escriba el nombre de usuario o el alias hasta que haya encontrado una coincidencia.

Captura de pantalla del selector de personas

También puede usar menciones de grupo. Escriba el nombre de un equipo o un grupo de seguridad, elija Buscar y, a continuación, seleccione entre las opciones enumeradas.

Para @mention un usuario que nunca ha seleccionado anteriormente, continúe trabajando para escribir el nombre completo para realizar la búsqueda en el directorio completo.

Los nombres de los usuarios mencionados aparecen en texto azul. Elija el nombre del vínculo @mention para abrir la información de contacto del usuario. La información de contacto 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 o pegue @mention usuarios de un comentario anterior. Aunque el formato resultante es idéntico a una mención especificada correctamente, no se registra como una mención verdadera ni envía una notificación por correo electrónico.

Después de completar la selección y la entrada de texto, el usuario de @mention recibe un correo electrónico en el que se le avisa sobre la mención.

Captura de pantalla de Email enviada en Outlook.

Use el control @mention en discusiones de solicitudes de incorporación de cambios, confirmar comentarios, comentarios del conjunto de cambios y comentarios de conjunto de cambios.

Identidades limitadas en la selección de búsqueda

En general, los selectores de personas buscan y seleccionan cualquier usuario o grupo agregado al identificador de Microsoft Entra de una organización.

En el caso de las organizaciones que administran sus usuarios y grupos mediante el identificador de Microsoft Entra, los selectores de personas proporcionan soporte técnico para buscar usuarios y grupos agregados al identificador de Microsoft Entra. En el caso de las organizaciones que quieran limitar la búsqueda y selección solo a los usuarios y grupos agregados a un proyecto específico, pueden hacerlo habilitando la característica Limitar la visibilidad del usuario y la colaboración a proyectos específicos en versión preliminar para su organización.

Importante

  • 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 invitados que son miembros del grupo limitado con acceso predeterminado en microsoft Entra ID, no pueden buscar usuarios con el selector de personas. Cuando la característica de vista previa está desactivada para la organización o cuando los usuarios invitados no son miembros del grupo limitado, los usuarios invitados pueden buscar en todos los usuarios de Microsoft Entra, según lo previsto.

Cuando la característica Limitar la visibilidad y colaboración del usuario a proyectos específicos de una organización está habilitada, la lista de identidades que puede seleccionar en un selector de personas está limitada de una de las siguientes maneras:

  • Los usuarios agregados al grupo Usuarios con ámbito de proyecto solo pueden seleccionar entre una lista de identidades que contiene usuarios y grupos agregados explícitamente al proyecto al que están conectados.
  • Si todos los miembros del proyecto se agregan al grupo Usuarios con ámbito de proyecto, los selectores de personas se limitan 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

Cuando la característica Limitar la visibilidad del usuario y la colaboración a proyectos específicos está habilitada para la organización, los usuarios con ámbito de proyecto no pueden buscar usuarios que se agregaron a la organización a través de la pertenencia a grupos de Microsoft Entra, en lugar de a través de una invitación de usuario explícita. Se trata de un comportamiento inesperado y se está trabajando en una resolución. Para resolver este problema de forma automática, deshabilite la característica Limitar la visibilidad del usuario y la colaboración a proyectos específicos en versión preliminar para la organización.