Determinar destinatarios de correos electrónicos de notificación

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

Muchos factores determinan los destinatarios de una notificación por correo electrónico cuando un evento coincide con una suscripción. Si no es consciente, estos factores pueden dar lugar a que la bandeja de entrada reciba demasiados o demasiados 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 de los conceptos tratados en este artículo son aplicables a versiones anteriores de Azure DevOps, aunque es posible que la interfaz de usuario haya cambiado.

Suscripciones personales personalizadas

Con la suscripción personal personalizada, 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:

Para 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.

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

Captura de pantalla de la dirección de correo electrónico preferida.

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

Captura de pantalla de la dirección de correo electrónico personalizada.

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. La suscripción está configurada 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

  1. En Configuración de la organización, seleccione Suscriptores> de notificaciones>globales su configuración de Entrega de equipo.>

    Captura de pantalla que muestra la configuración de Entrega en equipo.

  1. Seleccione en la siguiente configuración:
  • 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 entregan a cada miembro del grupo o equipo. Esta configuración suele ser la opción predeterminada. Para obtener más información sobre la opción predeterminada, consulte Expansión del equipo.

  • No entregar: las notificaciones no se entregan de forma predeterminada.

    Captura de pantalla que muestra el cuadro de diálogo Configuración de entrega de equipo.

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

Sugerencia

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

Destinatarios personalizados de la suscripción de grupo y equipo

Los destinatarios de una suscripción personalizada de grupo o equipo se determinan mediante la suscripción. Pero, con determinadas opciones de entrega, la configuración de entrega predeterminada del equipo se usa para determinar el conjunto de destinatarios.

email-team-delivery-options

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, asignado a elementos de trabajo)
  • Preferencia del equipo: los destinatarios están determinados por 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: 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 "activada", ya que la mayoría de los usuarios no quieren recibir una notificación sobre algo que hicieron.

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.
  • Entregar a miembros individuales: consulte la siguiente opción: Miembros de team_.
  • No entregar: no se entrega ningún correo electrónico.

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

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

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

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 uno se incluye en la línea Para: del correo electrónico resultante. Sin embargo, los resultados de esta 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. Estos valores no se pueden cambiar. 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 grupos y equipos para destinatarios de 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. Se trata de un proceso potencialmente recursivo que comienza examinando los miembros directos del equipo.

Solo los miembros que no han optado por no participar en la suscripción se consideran 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
  • "Entregar a la dirección de correo electrónico": la dirección de correo electrónico se agrega a la lista final de destinatarios.
  • "Entregar a miembros individuales": el grupo se expande (como su grupo primario) y se siguen las mismas reglas para evaluar sus miembros.

Escenarios

Echemos un vistazo a algunos escenarios. Usamos los símbolos siguientes para indicar los tipos de miembros:

  • I: usuario individual
  • T: equipo o grupo anidados
  • A: grupo Microsoft Entra habilitado para correo.
Escenario Ejemplo
Un miembro con No entregar preferencias El equipo tiene miembros I1, I2y T1. T1La preferencia de entrega es No entregar. Qué ocurre: solo I1 y I2 recibir notificaciones a través de sus direcciones de correo electrónico preferidas. No se notifica a los miembros de T1 .
Un miembro con la preferencia Entregar a miembros individuales El equipo tiene miembros I1, I2y T1. T1La preferencia de entrega es Entregar a miembros individuales. T1 tiene miembros I2 y I3. Qué ocurre: T1 se expande (debido a su preferencia de entrega) y, por lo tanto I1, I2, y I3 recibe notificaciones a través de sus direcciones de correo electrónico preferidas.
Un grupo anidado El equipo tiene miembros I1, I2y T1. T1 tiene miembros I2, I3y T2. T1La preferencia de entrega es No entregar. T2 tiene miembros I4 y I5. T2La preferencia de entrega es Entregar a miembros individuales. Qué ocurre: porque T1 no se expande (porque su preferencia de entrega es "no entregar"), solo I1 y I2 recibe notificaciones a través de sus direcciones de correo electrónico preferidas.
Un miembro que es un grupo de Microsoft Entra El equipo tiene miembros I1, I2y A1. Qué ocurre: solo I1 y I2 recibir notificaciones a través de sus direcciones de correo electrónico preferidas. Los miembros de A1 no reciben notificaciones, ya que Azure DevOps no expande grupos de AD al entregar notificaciones.