Configurar un servidor SMTP y personalizar el correo electrónico para alertas y solicitudes de comentarios

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

Nota

Azure DevOps Server anteriormente se denominaba Visual Studio Team Foundation Server.

Para que las alertas y solicitudes de comentarios funcionen, debe configurar un servidor SMTP para Azure DevOps Server, denominado previamente Visual Studio Team Foundation Server (TFS). El servidor SMTP admite las siguientes características:

Requisitos previos

  • Para llevar a cabo estos procedimientos, debe ser miembro del grupo de seguridad Administrators en el servidor de capa de aplicación de Azure DevOps.

Configurar un servidor SMTP

  1. Si no es un administrador de Azure DevOps, póngase en marcha como uno ahora.

  2. Abra la consola de administración de Azure DevOps Server en el menú Inicio . O bien, en un símbolo del sistema, escriba TFSMgmt.exe. Para obtener más información, consulte abrir la consola de administración.

  3. Elija configuración de alertas.

    Abrir alertas de correo electrónico para la capa de aplicación

    Abrir alertas de correo electrónico para la capa de aplicación

  4. Habilite las alertas por correo electrónico y especifique el servidor SMTP y la dirección de correo electrónico que se van a usar para enviar mensajes de correo electrónico.

    Habilitar y configurar el servidor SMTP

    Habilitar y configurar el servidor SMTP

    Si la implementación está configurada para usar SSL, active la segunda casilla y especifique un certificado. Consulte también configuración de HTTPS con capa de sockets seguros (SSL).

    Sugerencia

    • Asegúrese de que el Firewall está configurado para permitir las comunicaciones entre Azure DevOps y el servidor SMTP.
    • El servidor SMTP debe estar configurado para permitir que los remitentes anónimos envíen correo electrónico, o bien debe haber creado una cuenta para usarla específicamente como cuenta de correo electrónico para alertas. Si especifica la cuenta de servicio DevOps de Azure (TFSService), esta cuenta debe ser una cuenta de dominio con permiso para enviar correo electrónico.
    • Si usó una cuenta del sistema (como servicio de red) como cuenta de servicio de Azure DevOps, deje en blanco los campos de usuario y contraseña para la configuración avanzada y asegúrese de que el servidor SMTP está configurado para permitir que los usuarios anónimos envíen correo. Como alternativa, especifique una cuenta de dominio habilitada para correo electrónico para usarla como cuenta de correo electrónico para las alertas. Si no lo hace, no se enviará ninguna notificación por correo electrónico.
  5. Para comprobar la configuración, Abra las notificaciones personales. Puede que sea necesario actualizar el explorador para ver esta opción si acaba de habilitar recientemente un servidor SMTP.

    Abrir configuración de notificación personal

    Abrir alertas individuales

    Cree una alerta y, a continuación, realice una acción que la desencadene.

Personalizar el formato de alertas de correo electrónico

Puede personalizar el formato de las notificaciones por correo electrónico o las alertas a las que se suscriben los miembros del equipo. Estas notificaciones se envían cuando se producen cambios en los elementos de trabajo, las revisiones de código, los archivos de control de código fuente y las compilaciones. Para personalizar su formato, puede modificar los archivos de transformación XSL asociados. Además, los miembros del equipo pueden configurar alertas del proyecto en Team Web Access (TWA) para diversas notificaciones y especificar si desean texto HTML o texto sin formato como formato.

Los archivos de transformación de formato de alerta se almacenan en la siguiente carpeta del servidor de capa de aplicación:

Unidad: \ %ProgramFiles%\Azure DevOps Server 2019 \ aplicación tier\tfsjobagent\transforms\3082

Unidad: \ %ProgramFiles%\team Foundation Server 2018 \ Application tier\tfsjobagent\transforms\3082

Unidad: \ %ProgramFiles%\team Foundation Server 15.0 \ Application tier\tfsjobagent\transforms\3082

Unidad: \ %ProgramFiles%\team Foundation Server 14.0 \ Application tier\tfsjobagent\transforms\3082

Unidad: \ %ProgramFiles%\team Foundation Server 12.0 \ Application tier\tfsjobagent\transforms\3082

Puede usar un editor XML, como Visual Studio, para cambiar cualquiera de los archivos de transformación. La tabla siguiente muestra los dos archivos de transformación usados al enviar notificaciones de correo electrónico para eventos de cambio de elemento de trabajo:

Archivo de transformación Formato
WorkItemChangedEvent.xsl Correo electrónico HTML
WorkItemChangedEvent.plaintextXsl correo electrónico de texto simple

El servicio de evento emplea los archivos .xsl y plaintextXsl para transformar los datos XML de un evento en un mensaje de correo electrónico. Edite el archivo .xsl para obtener un formato diferente para la notificación de correo electrónico. En los mensajes de correo electrónico con formato HTML, el diseño básico de todos los eventos está almacenado en TeamFoundation.xsl. Debería realizar una copia de seguridad de cualquier archivo que desee cambiar y, a continuación, probar sus cambios. Una vez realizados los cambios, TFS usará la transformación modificada la próxima vez que genere una notificación para un evento.

Nota

El contenido de los mensajes que se emiten se genera automáticamente a partir del archivo TeamFoundation.xsl y los archivos xsl WorkItemChangedEvent anteriores. No se recomienda modificar el archivo TeamFoundation.xsl. Si modifica el contenido de este archivo, deberá probar exhaustivamente las modificaciones. Las modificaciones incorrectas de este archivo pueden producir un error de las alertas de correo electrónico de TFS e impedir que pueda ver los elementos de trabajo, los conjuntos de cambios o los archivos de un explorador web.

Para modificar el formato de alerta para cambios en elementos de trabajo

  1. En el servidor de capa de aplicación, abra la carpeta de la versión que está ejecutando, por ejemplo:

    Unidad: \ %ProgramFiles%\Azure DevOps Server 2019 \ aplicación tier\tfsjobagent\transforms\3082

    Unidad: \ %ProgramFiles%\team Foundation Server 2018 \ Application tier\tfsjobagent\transforms\3082

  2. Abra WorkItemChangedEvent. xsl en el Bloc de notas u otro editor de texto.

  3. Edite el archivo para mostrar el mensaje que desea que aparezca en el mensaje de notificación.

    Nota

    Debe realizar los mismos cambios en WorkItemChangedEvent.plaintextXsl para todos los usuarios que hayan solicitado mensajes de texto simple.

  4. Guarde el archivo WorkItemChangedEvent.xsl.