Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Wiki Markup
{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

...

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)

Info

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

...

.

Image Added

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).



Image Added

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.

Image Added

  • 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 

...

  • Image Added 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.

Image Modified






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

Image ModifiedPrimeramente 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

(advertencia) 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:

Image Modified

Contenido html del correo electrónico recibido


Image Modified

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:

Code Block
<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

Image Modified

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.

...



Child pages (Children Display)


Wiki Markup
{scrollbar}