Definiendo Acciones

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.

Asociar una Acción Existente en Ambiente Desktop con O3 BROWSER

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.

Asociar una Acción Existente en Ambiente Web

En la última ventana del cuadro de diálogo de la Creación/Edición de una Regla, elegir en la pestaña desplegable de Acción, la acción a asociar

Guardar la regla para hacer permanentes los cambios

Crear una Acción

Cómo se ha mencionado anteriormente las Acciones se puede Crear y/o Editar con el O3Browser (Ambiente Desktop)

Las mismas pueden ser generadas desde el cuadro de diálogo de Creación/Edición de una Regla o desde el Menú.

Desde el cuadro de diálogo de la configuración de una Regla, utilizar el botón "Nueva Acción" que permite crear una nueva acción.

Desde el Menú del O3 Browser ir a Archivo — Nuevo — 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

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 y cambio de formato para los valores considerados en las condiciones definidas para la regla de negocio.
La personalización de la acción del tipo "Enviar e-mail" es necesaria para definir al menos: destinatario del correo, asunto o título, cuerpo del mensaje.
Ejemplo de este tipo de acción es provisto con la instalación del producto. La acción se llama Mail.action

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. Recordar que hay un ejemplo proporcionado con la instalación que se llama Mail.action.

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. En la imagen adjunta se observa el parámetro ($ruleName), en el cual ingresará entre los paréntesis el nombre de la Regla como se grabó en el O3Server. Los paréntesis no son obligatorios para llamar a parámetro.
Ancho y Alto de la imagen que se incluye en el correo electrónico. Se puede omitir que se envíe un archivo tipo imagen con el correo eliminando las líneas del tag <head>
Contenido del correo electrónico. Sobre las líneas del script html se puede ingresar el texto que se desee. Tener en cuenta que si se escriben caractéres especiales y/o con tildes se deben usar los caracteres HTML

Luego de ingresar la información necesaria se debe aceptar con el botón ACEPTAR.

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 Como configurar el servicio de email de JBoss

Personalizando Indicar con Formato

En el cuadro de diálogo de Indicar un Formato se puede configurar la Fuente y la Alineación.

Para la Fuente se indica

Tipo de Fuente
Estilo de Fuente
Tamaño de la Fuente
Color de la Fuente
Color de Fondo de la celda.

En Alineación

Alineación Horizontal
Alineación Vertical

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.

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>