Ejemplo: Habilitar notificaciones de correo electrónico

Las plantillas de adaptador se pueden configurar para enviar notificaciones por correo electrónico usuarios que producen un cambio en la aplicación externa. El siguiente ejemplo muestra cómo configurar dos tipos de notificación:

Los siguientes procedimientos hacen referencia a elementos de la plantilla ClearCaseByDate. Cualquier plantilla de adaptador puede utilizar sus elementos para habilitar notificaciones.

Notificación a todos los usuarios que registraron archivos para la compilación actual

Puede utilizar el mandato <adduser> para compilar de forma dinámica el grupo de usuarios que registraron código para ser compilado y, a continuación, utilizar el mandato <notify> para enviar notificaciones a ese grupo.

La plantilla ClearCaseByDate consulta ClearCase para obtener una vista de todos los cambios entre dos indicaciones de fecha y hora. Las indicaciones de fecha y hora predeterminadas sirven para conocer la última la ejecución del adaptador y la ejecución de adaptador actual. En pocas palabras, esto se traduce en una lista de todos los cambios desde la última compilación para tenerlos en cuenta para la compilación actual.

Asunción: todos los nombres de usuario de la vista son conocidos por el servidor SMTP que usted utiliza para llevar a cabo las notificaciones por esos nombres. Esto significa que los nombres de usuario de ClearCase necesitan coincidir con los nombres de usuario de correo electrónico.

Para habilitar esta notificación:

  1. Abra la plantilla de adaptador ClearCaseByDate en un editor de XML.
  2. Localice y edite <adduser> para crear un grupo de usuarios tal como sigue:
    <adduser group="MyChangers" user="$4">
    El parámetro posicional $4 se refiere al campo de nombre de usuario que se muestra en la vista ClearCase generada por la plantilla ClearCaseByDate.
  3. Configure la notificación para enviar correo electrónico a este grupo. La siguiente configuración envía correo electrónico tanto si el proyecto falla como si tiene éxito. En algunos entornos puede que prefiera enviar notificaciones solamente cuando la compilación falle.
    <!-- Establecer notificaciones para cuando la compilación concluye ->
    		<onproject result="fail">
    			<notify group="MyChangers" subject="Build $BF_TAG ($CurDate)
    Failed." message="${Changing}${Changes}"/>
    		</onproject>
    		<onproject result="pass">
    			<notify group="MyChangers" subject="Build $BF_TAG ($CurDate)
    Passed." message="${Changing}${Changes}"/>
    		</onproject>

  4. Guarde la plantilla de adaptador.

Cuando el adaptador se ejecuta, el grupo MyChangers se compila a partir de los nombres de usuario de la vista. La notificación por correo electrónico se envía a ese grupo cuando concluye el proyecto de compilación.

Notificación a todos los usuarios que pertenecen a un grupo de acceso de Build Forge

En este ejemplo quiere enviar una notificación a todos los miembros de un grupo de acceso de Build Forge. Para este ejemplo se utiliza la plantilla de adaptador ClearCaseByDate. Asunción: todos los nombres de usuario en Build Forge corresponden a nombres de usuario de direcciones de correo electrónico en el servidor SMTP.

  1. Abra la plantilla de adaptador ClearCaseByDate en un editor de XML.
  2. Localice y edite <adduser> para crear un grupo de usuarios desde un grupo de acceso de Build Forge, tal como se indica:
    <adduser group="Developer_Access_Group" user="Developer">
  3. Configure la notificación para enviar correo electrónico a este grupo. La siguiente configuración envía correo electrónico tanto si el proyecto falla como si tiene éxito. En algunos entornos puede que prefiera enviar notificaciones solamente cuando la compilación falle.
    <!-- Establecer notificaciones para cuando la compilación concluye ->
    		<onproject result="fail">
    			<notify group="Developer_Access_Group" 
             subject="Build $BF_TAG ($CurDate) Failed." message="${Changing}${Changes}"/>
    		</onproject>
    		<onproject result="pass">
    			<notify group="Developer_Access_Group" 
             subject="Build $BF_TAG ($CurDate) Passed." message="${Changing}${Changes}"/>
    		</onproject>

  4. Guarde la plantilla de adaptador.

Cuando el adaptador se ejecuta, el grupo Developer_Access_Group se compila a partir de los nombres de usuario que pertenecen al grupo de acceso Developers. La notificación por correo electrónico se envía a ese grupo cuando concluye el proyecto de compilación.

Importante: Si la directiva <notify> falla (por ejemplo, si el usuario al que se dirige el correo electrónico no existe), el .xml falla así como todas las siguientes notificaciones posteriores.

Comentarios