Definiendo acciones
Las acciones permiten definir el comportamiento para alertar sobre condiciones no deseadas de las reglas de negocios.
Los siguientes tipos de acciones pueden ser definidos:
- Definición de formato particular sobre los valores que no cumplen la regla
- Envío de correo electrónico
- Envío de SMS
- Inicio de un proceso predefinido de O3 Process
- Inicio de un proceso arbitrario de O3 Process
Los distintos tipos de acciones pueden ser combinados al momento de asociar una acción a una determinada condición. Quiere decir que podemos asociar más de una acción a una determinada condición. Por defecto, la acción de colorear en rojo los valores que no cumplen la condición es asociada a toda condición.
Las acciones correspondientes a envío de mail, mensaje SMS o el inicio de procesos requieren que tanto la regla como la propia acción definida sean almacenadas remotamente en O3 OLAP Service.
¿En qué momento se controla el cumplimiento de las reglas?
El control sobre el cumplimiento de las reglas de negocio se realiza durante la actualización de los Data Marts. Es decir cuando eventualmente hay datos nuevos en el Data Mart que pueden cambiar la evaluación de las condiciones de las reglas.
Como forma de facilitar el proceso de desarrollo, también es posible forzar la evaluación de las reglas al reiniciar el O3BI Service. En el módulo Administrador del Servidor es posible habilitar / deshabilitar esta posibilidad.
Una vez evaluadas las condiciones, las correspondientes acciones son ejecutadas.
Las acciones que aplican un formato específico para colorear los valores que no cumplen las condiciones establecidas se pueden aplicar también como resultado de "Ejecutar Regla" (explicado bajo el título Visualizando el cumplimiento de las reglas)
Creación y Edición de Acciones
Para crear y/o editar accciones lo debemos hacer en el O3Browser.
La creación y/o edición de O3 Rules se pueden hacer tanto en ambiente desktop con el O3Browser como en ambiente web en el O3Web.
Ambiente Desktop con O3 BROWSER
Para asociar una acción existente a la condición es necesario:
Ir a la pestaña Condiciones de la Definición de la Regla y hacer click sobre el botón de Abrir Acción.
Elegir la acción que se desea asociar. Se puede asociar una acción local (archivos locales) o una acción almacenada en el servidor (archivos remotos, recomendada).
Aceptar para cerrar el diálogo y terminar de asociar la acción.
Guardar la regla para hacer permanentes los cambios.
Para crear una acción y asociarla a la condición se deben seguir los siguientes pasos:
Utilizar el botón "Nueva Acción" para el diálogo que permite crear una nueva acción.
- Utilizar el botón "Nueva Acción" para el diálogo que permite crear una nueva acción.
- Ingresar el Nombre de la acción y opcionalmente la descripción.
- Seleccionar los distintos tipos de acciones que se desean utilizar en la definición. El ejemplo de la figura muestra la selección de una acción de tipo "Indicar con formato"
- Personalizar el tipo de acción elegido, utilizando el botón
para abrir el editor correspondiente. - Luego de indicar la personalización deseada, utilizar el botón de Aceptar para guardar. Se sugiere guardar la acción en el O3Server (Archivos Remotos). En caso contrario bajo el directorio <o3-install>/jboss/server/default/ideasoft-o3/server/istore/actions
- Asociar la acción definida en la regla
- Guardar los cambios en la regla.
Creación de Acciones
Diálogo de creación de acciones
Las siguientes secciones describen cómo personalizar los tipos de acciones disponibles: envío de correo electrónico, envío de SMS y cambio de formato para los valores que no cumplen la regla de negocio.
La personalización de las acciones de tipo "Enviar e-mail" y "Enviar SMS" es necesaria para definir al menos: destinatario del correo, asunto o título, cuerpo del mensaje.
Ejemplos de este tipo de acciones son provistos con la instalación del producto.
Personalizando el envío de e-mail
Primeramente es necesario editar una acción de este tipo. Asumiendo que se ha definido previamente alguna acción de envío de correo electrónico, se debe Editar desde el menú Archivo, Editar, Editar acción.
Luego de seleccionar la acción deseada en el repositorio de archivos remotos, se deben ingresar los siguientes datos:
- Dirección de correo electrónico del destinatario. Más de una dirección pueden ingresarse como una lista separadas por el carácter ";" (punto y coma).
- Direcciones de correo electrónico de otros destinatarios a los que se desea enviar copia del correo.
- Asunto o título del correo
- Ancho y Alto de la imagen que se incluye en el correo electrónico
- Contenido del correo electrónico
Luego de ingresar la información necesaria se debe aceptar con el botón correspondiente.
Configuración del servicio de envío de mail
Es necesario configurar el servicio de mail de JBoss donde corre O3 JBoss Service. Para ello se deben seguir los pasos que se indican en el siguiente documento:
Ejemplo distribuido con el instalador de O3BI
Como se mencionó anteriormente con el instalador de O3BI, se incluye un ejemplo de acción de envío de mail. Dicha acción tiene por nombre Mail.action, y puede ser editada desde el menú Archivo/Editar/Editar Acción, repositorio de archivos remotos.
A continuación se muestra el cuerpo del mensaje que esta acción incluye en el correo electrónico enviado al evaluar la regla de negocio. Dicho contenido es presentado en este manual a modo de ejemplo, pudiendo el usuario definir otro contenido diferente.
Las siguientes figuras muestran el contenido del correo electrónico recibido:
Contenido html del correo electrónico recibido
Contenido del archivo adjunto al correo electrónico recibido.
Cuando en el mail se envía una regla en formato de tabla, la impresión de este mail por defecto no imprime los colores. Detalles de cómo configurar el cliente de correo se pueden entontrar aquí.
Contenido del cuerpo del correo electrónico:
<html>
<head>
$attachments.addJPGAttachments('cubeImages')
<style> $cubeCSS </style>
</head>
<body align='center'>
<h1>Rule Notification</h1>
<h3>Rule: $ruleName</h3>
<h3>Cube: $cubeName</h3>
<br>
#foreach ($html in $cubeHtmls)
$html
<br>
#end
<hr>
#set ($count = 0)
#foreach ($image in $cubeImages)
<img src='cid:cubeImages[$count]'/>
<br>
#set($count = $count + 1)
#end
<hr>
<!--
$evaluationMessages
-->
</body>
</html>
Personalizando el envío de SMS
Para personalizar este tipo de acción es necesario:
- Ingresar los destinatarios del mensaje en el campo "Recipiente SMS"
- Ingresar el mensaje en el cuerpo del mensaje
Personalizando el formato para la acción "Indicar con Formato"
Este tipo de acción permite visualizar los valores que no cumplen la regla, destacándolos con un estilo particular.
La siguiente figura muestra el diálogo que permite personalizar el formato. El diálogo tiene dos solapas que son "Fuente" y "Alineación"
La solapa Fuente tiene elementos que permiten:
- Elegir fuente, tamaño y estilo de la fuente
- Color de la fuente
- Color de fondo
Notar que en la parte inferior del diálogo se presenta un ejemplo de acuerdo con la personalización elegida.
La solapa "Alineación" permite elegir: - Alineación horizontal (izquierda, derecha o centrada)
- Alineación vertical (arriba, entro o abajo)
Luego de finalizar de personalizar el formato se deben aceptar los cambios
Diálogo de personalización de Formato
Inicio de un proceso predefinido de O3 Process
Este comportamiento puede ser modificado al asociar una acción que inicia un proceso predefinido de O3 Process.