Page Comparison

{scrollbar}
----

La definición de Reglas de Negocio asociadas a un determinado Data Mart consiste en determinar cuáles son las situaciones que se desean controlar, definiendo una vista apropiada junto a las condiciones que se evaluarán cada vez que se realice el chequeo de las mismas y las acciones que se desean ejecutar.

En esta sección se detallan los pasos necesarios para la definición de una Regla de Negocios. La definición se realiza en el componente *{_}O3 Browser{_}*.

h3. Pasos a seguir para la definición de reglas de negocios

# Ubicar una vista que contenga los datos que se desean controlar con la regla de negocios.
# Seleccionar la opción "Nueva Regla" de la entrada "Nuevo" del menú "Archivo" para visualizar el cuadro de diálogo de definición de Reglas.
# Seleccionar el panel General e ingresar nombre y descripción para la nueva regla.
# Seleccionar el panel Chequeo (Verify) para indicar los elementos para los cuales se desean controlar las condiciones que definen la regla. El contenido de este panel corresponde a las dimensiones, medidas y expresiones calculadas de la vista ubicada en el punto 1. (Ver a continuación _Definiendo los valores para los cuales se evalúan las condiciones de la regla_).
# Seleccionar el panel Condiciones para especificar las condiciones que se deben evaluar.
La sección "Definiendo Condiciones de la regla" detalla dicha definición.
Además, en este mismo panel se definen las acciones asociadas a la regla de negocios, que se ejecutarán cuando existan valores para los cuales la condición no se cumple.
# Presionar el botón "Aplicar" para confirmar las definiciones realizadas sin cerrar el diálogo de definición.
# Utilizar el botón "Guardar" (Ver más abajo _Guardando las reglas_) para salvar la regla y volver al escritorio de O3 Browser.
La siguiente imagen muestra una vista de ejemplo para la definición de reglas. Observar que la vista contiene dimensiones anidadas en las filas.

!worddav382d0d6c41325d64bc30245c5d0551bb.png|height=167,width=528,align=center!

h3. Definiendo los valores para los cuales se evalúan las condiciones de la regla

!worddav634a150c298f78e50cb2957144cfb6cc.png|height=340,width=389,align=right! En el panel correspondiente a la solapa Chequeo, se muestran las dimensiones, medidas y expresiones calculadas correspondientes a la vista con sus respectivos elementos.

En el ejemplo de la vista presentada en la figura anterior, participan tres dimensiones: Fecha (en columnas), Productos y Clientes (en filas).

Los elementos de cada dimensión son presentados en las respectivas secciones del panel. En dicho panel se debe indicar el conjunto de elementos para los cuales se desea evaluar  la regla de negocio.

Más de un elemento puede ser seleccionado, presionando la tecla "control" mientras se eligen con el botón izquierdo del ratón.

La ausencia de elementos seleccionados significa que la evaluación se aplica a todos los elementos.

!worddav634a150c298f78e50cb2957144cfb6cc.png|height=340,width=389,align=center!

Solapa para elegir valores a verificar en una regla con las secciones correspondientes a cada dimensión de la vista.

h3. Definiendo Condiciones de la regla

En el panel correspondiente a la solapa de Condiciones, se definen las condiciones que deben ser evaluadas para los elementos de la vista seleccionados en el panel "Chequeo", visto anteriormente. El cumplimiento o no de estas condiciones determina que se generen las acciones correspondientes asociadas a la regla de negocios.

Las condiciones se definen por medio de expresiones lógicas simples o compuestas. Las expresiones compuestas permiten componer con los operadores lógicos Y ú O varias expresiones simples.

Al finalizar de escribir una condición, 

Además, para una misma regla se pueden definir varias condiciones, pudiendo asociar acciones distintas para cada una de ellas.

En el panel Condiciones se definen también las acciones que se desean ejecutar para los valores que no cumplen la regla de negocio definida.  Por defecto, la no asociación de una acción a la regla determina que los elementos que no cumplen las condiciones establecidas sean coloreados de rojo.

Si una celda no cumple con la condición, se disparará la acción. Si se hace clic en la casilla verificadora que aparece arriba de las condiciones ("La condición describe los elementos que disparan la acción") la acción actuará en forma inversa, es decir que la acción se aplicará a las celdas que sí cumplen la condición.\\

!worddav1b6929e7d377714d0a67dd54588ef91d.png|height=332,width=313,align=center!

Dialogo de definición de condiciones de la Regla

La siguiente tabla describe los elementos que muestra el panel
| "Condiciones" | Esta lista contiene las condiciones definidas en la Regla. Permite seleccionar una previamente definida para poder visualizarla ,modificarla  o eliminarla |
| !worddav569f6b05a2be01e29843661a54209cc3.png|height=20,width=61! | Permite agregar una nueva condición a la definición de la regla |
| !worddavf9910377b237704dab2afa43a868c588.png|height=21,width=61! | Elimina una condición de la lista |
| "Nombre" | Define el nombre de la condición |
| "Descripción" | Asocia una descripción  a la condición |
| "La condición describe..." | Define si la regla dispara las acciones para los valores que cumplen la condición, o si por el contrario, las acciones se disparan para los valores que no la cumplen. |
| !worddav08d77f0afb0dfdd4226758ec1d01f1f0.png|height=31,width=54! | Permite agregar expresiones a la condición.  En caso de tener más de una expresión asociada a la condición, es necesario definir un operador lógico que componga dichas expresiones. La figura anterior muestra un ejemplo en el cual la condición consiste de  dos subexpresiones CELL > 600 y CELL < 1000, vinculadas  por el operador lógico Y (&&). Notar que también se pueden parentizar las expresiones eligiendo las columnas correspondientes al paréntesis. |
| !worddavd6e0e2cd4dd176d77d1bc9551edcf8c6.png|height=30,width=54! | Eliminar  la expresión seleccionada |
| !worddav21ad5188acc035b80afc93eaa995c54f.png|height=23,width=46! | Abrir Acción: asocia una acción existente a la condición actual |
| !worddav081f28011fb8c1a179f0c5d5ecb592ca.png|height=23,width=46! | Nueva Acción:  define una nueva acción y la asocia a la condición actual |
| !worddav5a02b20c82bdee27bcd97d2b2f56ff73.png|height=20,width=70! | Guarda la definición de la regla. Cuando la regla se guarda en el servidor se chequea en el momento de construcción del Data Mart. |
| !worddave12bbd9c9cf7c9170ad374f4ae3b610e.png|height=20,width=65! | Aplica los cambios realizados en la definición de la condición. Los cambios se visualizan en la vista corriente. Esta opción no hace permanente las modificaciones. |
| !worddav22afab8b9ff992046235515f6bc3f6f8.png|height=20,width=73! | Cancela la definición de la regla |
\\

h4. Para definir las condiciones de una regla se deben realizar los siguientes pasos:

# Ir al panel Condiciones.
# Agregar una nueva condición, presionando el  botón "Nuevo", o seleccionar una condición de la lista.  En caso de definir una nueva condición, se debe asociar un nombre.
# Definir  el operador de comparación para la condición actual. El operando izquierdo de este operador corresponde a los elementos seleccionados en la solapa Chequeo. El operando de la derecha corresponde a una expresión cuya definición se detalla en el siguiente punto. Los operadores de comparación disponibles son: distinto, mayor que,  mayor o igual que, menor que, menor o igual que, entre, difiere en.
# Definir la expresión con la cuál se desean comparar los distintos elementos seleccionados en la solapa Chequeo. Se dispone de un lenguaje de expresiones propio  para la definición de las expresiones. El editor de expresiones se muestra al clickear sobre el extremo de la derecha del campo "Expresión", donde se muestran los tres puntos suspensivos.
# Si se desea definir una expresión compuesta, se deben agregar nuevas expresiones para la misma condición y definir el operador lógico que compone las mismas. Si se desea utilizar expresiones con paréntesis, se deben tildar los check box correspondientes al comienzo y final de cada  subexpresión.

Como se indica en el paso 4, las expresiones son definidas utilizando el lenguaje de expresiones de *Ideasoft O3*, utilizado también en la definición de campos virtuales en el componte *O3 Studio* y en las expresiones definidas por el usuario, en el *O3 Browser*.

De esta manera es posible definir expresiones para la evaluación de la regla de negocios haciendo referencia a columnas y/o filas de la vista.

A modo de ejemplo, si se desea definir una condición que compare las ventas del año 2004 con las del año 2003 (Ver Figura 1), de manera tal que aquellos valores del 2004 que no superen en un 25% los valores del 2003 sean coloreados indicando que no cumplen con la regla de negocio, se deben realizado los siguientes pasos:
# Indicar en la solapa Chequeo que el elemento 2004 es el utilizado para evaluar las condiciones de la regla.
# Seleccionar el operador "mayor o igual"
# Definir la expresión que denota los valores con los cuales se desea comparar el año 2004. Dicha expresión debe representar a los valores obtenidos para el año 2003. De acuerdo al lenguaje de expresiones conocido para O3 Browser, dicha expresión es \[ISPRDO3:"2003"\] * 1.25.
# Aplicar los cambios y guardar la regla con el botón correspondiente

h4. Definiendo varias condiciones para una misma regla

Es posible que un usuario quiera definir una regla con distintos niveles de alerta. Por ejemplo si las ventas del 2004 no superan en un 25% los del 2003, las celdas deben colorearse de amarillo, indicando una situación preocupante. Pero si las ventas superan hasta en un 15% las ventas del 2003, entonces la situación es grave, por lo que dichas celdas deben colorearse de rojo.

Para representar la situación ilustrada, se deben definir dos condiciones diferentes, desde el momento que las acciones (coloreo en este caso) forman parte de la definición de la condición.

h4. Orden de las condiciones

Las condiciones definidas para una misma regla se evalúan en el orden en que aparecen en la lista de condiciones.
En el ejemplo mencionado anteriormente, definimos las siguientes condiciones:
A: si las ventas no superan 25% del 2003, coloreamos de amarillo
B: si las ventas no superan 15% del 2003, coloreamos de rojo.
Como los elementos que hacen fallar la condición B, están comprendidos por la condición A, es relevante el orden en que definamos ambas condiciones.  En este ejemplo, la condición B debe ser definida primero.

h3. 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*.

h4. ¿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_)

h4. 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.
\\
h4. 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 !worddava56adaceb954acf98ea9a73a51fc803d.png|height=19,width=23! para abrir el editor correspondiente.
# Luego de indicar la personalización deseada, utilizar el botón de Aceptar para guardar y asociar la acción definida
# Guardar los cambios en la regla

\\ !worddav9504c0ccfea10e96a9c44e08d3b2e027.png|height=349,width=326,align=center!

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.

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

!worddav902b4dcec3daf68c68282af6923d7153.png|height=385,width=361,align=center!

Diálogo de personalización del tipo de acción e-mail

h4. Configuración del servicio de envío de mail

Es necesario configurar el servicio de mail de JBoss donde corre O3 OLAP Service. Para ello se deben seguir los siguientes pasos:
# Editar el archivo de nombre mail-service.xml que se encuentra dentro de la instalación de *Ideasoft O3*, en la siguiente carpeta <O3>\jboss\server\default\deploy\
# Ubicar la sección <configuration>  y asignar  los valores adecuados a las siguientes propiedades:
# mail.pop3.host \-> Nombre o IP del servidor de mail POP3mail.smtp.host \-> Nombre o IP del servidor de mail SMTPmail.from \-> Cuenta de correo que se usará para enviar los mails
# En caso que el servidor requiera autenticación, se debe ingresar el usuario también en los siguientes atributos:
<attributename="User">nobody</attribute> <attribute name="Password">password</attribute>

h4. Ejemplo distribuido en el Cd de instalación de Ideasoft O3

Como se mencionó anteriormente, con el Cd de instalación de Ideasoft O3, 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:

!worddav962202af3469f1cf855abcc70eddfde0.png|height=365,width=274,align=center!

Contenido html del correo electrónico recibido

\\ !worddavf87e05a5683c4550e967e572f06ca3e9.png|height=242,width=388, align=center!

Contenido del archivo adjunto al correo electrónico recibido

h2. Contenido del cuerpo del correo electrónico:
{code}
<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\[ISPRDO3:$count\]'/>
<br>
\#set($count = $count + 1)
\#end
<hr>
<\!-\-
$evaluationMessages
\-->
</body>
</html>
{code}

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

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

!worddav8de6670617e5bf878351615131878014.png|height=445,width=396, align=center!

Diálogo de personalización de Formato

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

h3. Guardando las reglas

Luego de realizados los pasos necesarios para definir las condiciones, acciones, alcance, etc de  una Regla de Negocios, la definición debe ser almacenada. Las reglas se guardan como vistas con condiciones; esto es, que describen la posición del Data Mart en el que han sido definidas y la definición de la regla.

h4. Para guardar una regla asociada a una vista:

# Utilizar el botón "Guardar" o "Guardar Como" del diálogo de definición de Reglas.
# Elegir la opción "Archivos Locales" para guardar la regla localmente en el sistema de archivos ó elegir la opción  "Archivos Remotos" para guardar la regla en el servidor.
# Ingresar un nombre para la Regla
# Presionar el botón Guardar. La regla se guarda y se vuelve al escritorio del O3 Browser.
Es importante destacar que si la regla contiene acciones de envío de correos electrónicos, mensajes SMS o procesos, es necesario que la misma sea guardada en el servidor para que dichas acciones sean ejecutadas.

!worddav92308568aa42dc419b8932ccf147a371.png|height=381,width=479, align=center!

Notificacióin de que la regla definida se cumple exitosamente

h3. Visualizando el cumplimiento de las reglas

Para visualizar el cumplimiento de las reglas definidas se debe ejecutar la regla.  Esta acción aplicará el formato asociado a la misma, haciendo notorios los valores que cumplen (o no cumplen según se haya definido) las condiciones correspondientes.

Es oportuno destacar que las acciones de envío de mails, mensajes SMS, u procesos, se realizan solamente al validar la regla, esto es al actualizar los datos del Data Mart o reiniciar el servidor.

h.3 Para ejecutar una regla es necesario seguir los siguientes pasos:
# Utilizar la opción "Ejecutar Regla"de la entrada "Abrir" del menú "Archivo" para desplegar el dialogo que permite elegir la regla
# Elegir el botón Archivos Locales si la regla esta en el sistema de archivos, o de lo contrario habrá que elegir el botón Archivos Remotos.
# Elegir la regla que se quiere verificar para desplegar la vista correspondiente
Si hay excepciones, haciendo clic en el icono "Mostrar Excepciones", los valores que no cumplen las condiciones definidas para la regla, serán presentados de acuerdo al estilo definido para la condición que falla.
El estado de las reglas definidas, se muestran en la barra de estado del panel de análisis.
A continuación se detalla  la interpretación de los símbolos que pueden presentarse en esta sección:

| !worddav6fb2b53346551e85c9719aba83354ad5.png|height=23,width=23! | Regla sin excepciones, es decir que todos los valores de la consulta cumplen con la regla definida. |
| !worddavc0c3b18ff8d327f51345c9848e6f3970.png|height=20,width=23! | Regla con excepciones. Indica que hay valores que no cumplen la regla definida. Si se hace clic sobre el icono, se resaltarán los valores que no cumplen la regla de acuerdo al estilo asociado a la misma. Notar en la figura que se muestra como ejemplo, que el icono cambia para indicar que estamos resaltando dichos valores. Haciendo clic sobre el icono nuevamente los valores dejan de estar resaltados. |

----
{children}
----
{scrollbar}