Determinar destinatarios de correos electrónicos de notificación

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

Muchos factores determinan los destinatarios de una notificación por correo electrónico cuando un evento coincide con una suscripción. Si no lo sabes, estos factores pueden dar lugar a que tu bandeja de entrada reciba demasiados o muy pocos correos electrónicos. Obtenga información sobre cómo el tipo de suscripción, su configuración de entrega, preferencias de entrega y otros factores determinan el conjunto de destinatarios.

Nota:

Muchos conceptos tratados en este artículo se aplican a versiones anteriores de Azure DevOps, aunque hay cambios en la interfaz de usuario.

Suscripciones personales personalizadas

Con las suscripciones personales personalizadas, los correos electrónicos se entregan a la dirección de correo electrónico preferida del usuario que posee la suscripción o a la dirección de correo electrónico configurada en la suscripción.

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.

Dirección de correo electrónico preferida en una suscripción personal (valor predeterminado)

Captura de pantalla que muestra cómo configurar la dirección de correo electrónico preferida para una suscripción personal.

Dirección de correo electrónico personalizada en una suscripción personal

Captura de pantalla que muestra cómo configurar una dirección de correo electrónico personalizada para una suscripción personal.

Configuración de entrega para equipos y grupos

La configuración de entrega controla el comportamiento de entrega predeterminado cuando el equipo o grupo es el destinatario de una notificación. Cada suscripción se configura con una opción de entrega que examina la configuración de entrega de los destinatarios.

Puede administrar las suscripciones y la configuración de entrega en el nivel de equipo o en el nivel de organización.

Configuración de nivel de organización

En Configuración de la organización, seleccione Notificaciones globales>Suscriptores><Equipo>>Configuración de entrega.

Captura de pantalla que muestra cómo configurar las opciones de entrega del equipo para una organización.

Seleccione entre las siguientes opciones:

  • Entrega a la dirección de correo electrónico: las notificaciones se entregan a una dirección de correo electrónico específica.
  • Entregar a miembros individuales: Las notificaciones se envían a cada miembro del grupo o equipo. Esta configuración suele ser la opción predeterminada. Para obtener más información, consulte Expansión del equipo.
  • No entregar: las notificaciones no se entregan de forma predeterminada.

Captura de pantalla del cuadro de diálogo Configuración de entrega del equipo que muestra las opciones

Si no elige explícitamente la configuración de entrega de un equipo o grupo, la configuración se determina a partir de las opciones de entrega establecidas en el nivel de organización. El valor predeterminado es Entregar a miembros individuales o No entregar.

Sugerencia

El cuadro de diálogo de configuración de entrega no indica si la selección actual se establece o hereda explícitamente.

Destinatarios de suscripciones personalizadas de equipo y grupo

Los destinatarios de una suscripción de grupo o equipo personalizado están determinados por la suscripción. Para determinadas opciones de entrega, la configuración de entrega predeterminada para el equipo se usa para determinar el conjunto de destinatarios.

Captura de pantalla que muestra cómo configurar las opciones de entrega de correo electrónico para una suscripción de grupo o equipo personalizada.

Las siguientes opciones de entrega están disponibles para una suscripción de grupo o equipo:

  • Miembros del equipo por rol: Los destinatarios son miembros del equipo o grupo que tienen uno de los roles seleccionados (por ejemplo, Responsable de elementos de trabajo).
  • Preferencia del equipo: los destinatarios se determinan mediante la configuración de entrega del equipo o grupo (No entregar, dirección de correo electrónico preferida o Miembros del equipo).
  • Dirección de correo electrónico personalizada: el destinatario es la dirección de correo electrónico especificada.
  • Miembros del equipo: los destinatarios son todos los miembros del equipo o grupo, excepto los miembros que han optado por no participar en la suscripción.
  • SOAP: de forma similar a API Management, los destinatarios se especifican agregando sus direcciones de correo electrónico (suscripción) al servicio SOAP.

Nota:

Se respeta la configuración de entrega predeterminada de cada miembro, incluidos los grupos que son miembros del equipo o grupo.

Miembro del equipo por rol

La lista de destinatarios de correo electrónico viene determinada por los miembros que tenían un rol en el evento. Por ejemplo, el usuario asignado al elemento de trabajo tiene el rol Asignado a (nuevo) mientras que la identidad asignada al elemento de trabajo tiene el rol Asignado a (anterior). La lista completa de roles para cada tipo de evento se muestra en los tipos de eventos admitidos.

Captura de pantalla que muestra el rol de opción de entrega del equipo de correo electrónico.

La opción Omitir iniciador , que aparece para la mayoría de los tipos de eventos, controla si el usuario o grupo que inició el evento debe excluirse explícitamente del conjunto de destinatarios. En general, esta opción debe estar habilitada (Activado) porque la mayoría de los usuarios no quieren recibir una notificación sobre sus propias acciones.

Preferencia del equipo

La opción de entrega se toma de la configuración de entrega del equipo y puede ser una de las siguientes opciones:

  • Entrega a la dirección de correo electrónico: el correo electrónico se entrega a la dirección de correo electrónico preferida del equipo.
  • Entrega a miembros individuales: el proceso se describe en la sección siguiente, Miembros de team_.
  • No entregar: Ningún correo electrónico es entregado.

Captura de pantalla que muestra la preferencia de opción de entrega del equipo de correo electrónico.

El valor de configuración de entrega del equipo se muestra después de la etiqueta Dirección y no se puede cambiar.

Dirección de correo electrónico personalizada

Las notificaciones se envían a varias direcciones de correo electrónico personalizadas, que están separadas por punto y coma.

Captura de pantalla que muestra las opciones personalizadas de entrega del equipo de correo electrónico.

Miembros del equipo

La pertenencia al equipo o grupo se expande para determinar los destinatarios del correo electrónico. En el caso simple, un equipo o grupo se expande a una lista de individuos y cada usuario se incluye en la línea Para: del correo electrónico resultante. Sin embargo, los resultados de la expansión pueden ser complicados y se explican con más detalle en la sección de expansión de grupo y equipo .

Captura de pantalla que muestra el nombre de un equipo para la entrega de correo electrónico.

Destinatarios de la suscripción predeterminados

La opción de entrega de una suscripción predeterminada suele ser uno o varios roles. No se pueden cambiar estos valores. Los roles y la opción Omitir iniciador varían en función del tipo de evento. Para obtener más información y una lista de roles disponibles para cada tipo de evento, consulte Tipos de eventos admitidos.

Captura de pantalla que muestra los destinatarios de las suscripciones predeterminadas.

Nota:

La opción Omitir iniciador no está disponible para todos los tipos de eventos.

Expansión de equipos y grupos para los destinatarios del correo electrónico

Cuando un equipo o grupo recibe una notificación y la suscripción o la preferencia de entrega es para todos los miembros, el equipo debe "expandirse" para determinar el conjunto real de destinatarios de correo electrónico. Este proceso es potencialmente recursivo y comienza examinando los miembros directos del equipo.

Solo se tienen en cuenta los miembros que no han optado por no recibir la suscripción para la lista final de destinatarios. Cualquier miembro que sea un usuario individual se agrega a la lista de destinatarios.

Solo permanecen los grupos de Azure DevOps Services. Para cada grupo, se examinan las preferencias de entrega del grupo:

  • No entregar: no se realiza ninguna evaluación adicional en este grupo y se evalúa el siguiente grupo miembro.
  • Enviar a la dirección de correo electrónico: la dirección de correo electrónico se añade a la lista final de destinatarios.
  • Entrega a miembros individuales: el grupo se expande (como su grupo principal) y se siguen las mismas reglas para evaluar sus miembros.

Escenarios

En esta sección se exploran varios escenarios de ejemplo. En los ejemplos siguientes se usan símbolos para indicar los tipos de miembros del equipo:

  • I: usuario individual
  • T: equipo o grupo anidado
  • E: grupo Microsoft Entra habilitado para correo electrónico

El miembro del equipo habilita la opción "No entregar"

Miembros del equipo de ejemplo:

  • El equipo principal tiene tres miembros: usuarios I1 y I2, y equipo anidado T1.
  • El equipo T1 tiene habilitada la opción No entregar .

Solo los usuarios I1 y I2 reciben los mensajes de notificación en su dirección de correo electrónico de contacto preferida. No se notifica a los miembros del equipo T1 anidado.

El miembro del equipo habilita la configuración "Entregar a miembros individuales"

Miembros del equipo de ejemplo:

  • El equipo principal tiene tres miembros: usuarios I1 y I2, y equipo anidado T1.
  • El equipo T1 tiene dos usuarios miembros, I2 y I3.
  • El usuario I2 es miembro del equipo principal y del equipo T1.
  • El equipo T1 tiene habilitada la opción Entregar a miembros individuales .

El equipo T1 se expande para identificar a sus miembros. I1, I2y I3 todos reciben los mensajes de notificación en su dirección de correo electrónico de contacto preferida.

El equipo contiene un grupo anidado

Miembros del equipo de ejemplo:

  • El equipo principal tiene tres miembros: usuarios I1 y I2, y equipo anidado T1.
  • El equipo T1 tiene tres miembros: usuarios I2 y I3, y equipo anidado T2.
  • El equipo T2 tiene dos usuarios miembros, I4 y I5.
  • El usuario I2 es miembro del equipo principal y del equipo T1.
  • El equipo T1 tiene habilitada la opción No entregar .
  • El equipo T2 tiene habilitada la opción Entregar a miembros individuales .

Dado que el equipo T1 ha habilitado la opción No entregar, el equipo no se expande para identificar a sus miembros. Aunque el equipo T2 tiene habilitada la configuración Entregar a miembros individuales , el equipo T2 está anidado en el equipo T1. Las preferencias de entrega "No entregar" para T1 tienen prioridad sobre la configuración realizada por sus miembros. Solo los usuarios I1 y I2 reciben los mensajes de notificación en su dirección de correo electrónico de contacto preferida.

El miembro del equipo es el grupo Microsoft Entra

En este ejemplo, el equipo principal tiene tres miembros: usuarios I1 y I2, y grupo anidado de Microsoft Entra E1.

Solo los usuarios I1 y I2 reciben los mensajes de notificación en su dirección de correo electrónico de contacto preferida, a menos E1 que esté configurado como un grupo de seguridad habilitado para correo electrónico. Si E1 está habilitado por correo electrónico, todos los miembros de E1 también recibirán las notificaciones.

Las notificaciones de Azure DevOps no se expanden a grupos de Microsoft Entra para entregar notificaciones a usuarios individuales. Sin embargo, si usa un grupo de Active Directory (AD) que se clasifica como un grupo de seguridad habilitado para correo electrónico en Azure Portal, las notificaciones se pueden entregar a todos los miembros de ese grupo. Esto significa que si el grupo Entra está configurado como un grupo de seguridad habilitado para correo electrónico, todos los miembros reciben notificaciones según lo previsto.