Definiendo Acciones

Unknown macro: {scrollbar}

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 O3 OLAP 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)

Para asociar una acción existente a la condición es necesario:

Utilizar el botón "Abrir Acción" para abrir el diálogo que permite elegir una acción existente.
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).
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.
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 bajo el directorio <o3-install>/jboss/server/default/ideasoft-o3/server/istore/actions
Asociar la acción definida
Guardar los cambios en la regla.

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.

Unknown macro: {scrollbar}

Definiendo Acciones