2.2.1. Esquemas
Para definir una fuente de datos de tipo vista O3 o MDX es necesario haber definido previamente un esquema de O3. El esquema permite la conexión a O3 BI a partir del servidor, puerto y usuario especificado, de manera de tomar datos de las vistas para el cálculo de los indicadores. Existirá un único esquema por instalación de O3 BI, de manera que un mismo esquema es utilizado por todas aquellas fuentes de datos que se alimenten de cualquiera de las vistas y de cualquiera de los cubos de la instalación. Por otro lado, el esquema generado es aplicable a cualquiera de las fuentes de datos existentes en la Metadata del dominio correspondiente e independientemente de la estructura que se haya construido.
Para dar de alta un nuevo esquema O3, seguir los pasos descriptos en el apartado anterior sobre alta de artefactos, seleccionando la opción O3 Esquema de la lista desplegable. Una vez abierto el modo edición del nuevo esquema, es necesario definir los siguientes atributos:
Campo | Descripción |
|
|---|---|---|
Etiqueta: | Nombre mostrable del O3 Esquema | |
Id: | Denominación interna del O3 Esquema | |
Autentificación: | Asume que el usuario autenticado en O3BP&A será el que se utilice para autenticarse en O3BI. En este caso, no es necesario indicar usuario y password en los campos a continuación | |
Usuario y Contraseña | Solo si no se selecciona la opción anterior | |
Conexión segura: | Solo si se tiene O3 configurado para https | |
Host | Nombre o ip del servidor donde se encuentra la instalación de O3 BI. | |
Puerto JDBC | Puerto que atiende consultas desde BIRT. Se puede cambiar en la property o3.tcp.port en el archivo GServer_custom.properties. | |
Puerto WEB | Puerto que atiende consultas de O3. Si la instalación se encuentra configurada en ports-default es 8080, ports-01 es 8180 y así sucesivamente | |
Opciones avanzadas | Las 3 primeras: MDX url, VIEW url y REST url son de uso interno de la aplicación, se recomienda dejarlas en sus valores por default. La última, O3Portal url es la requerida para acceder al O3 Portal, por lo que si se modifica el host se debe cambiar el valor aquí para que la url apunte al mismo host. |
2.2.2. Fuentes de datos
Para dar de alta una nueva fuente de datos, seguir los pasos descriptos en el apartado anterior sobre alta de artefactos, seleccionando la opción Fuente de Datos de la lista desplegable. Una vez abierto el modo edición de la nueva fuente es necesario definir el tipo de fuente a partir de una de las pestañas del panel. Los tipos de fuente posibles son: Constante, Consulta SQL, Consulta MDX, Consulta Vista O3 y Tabla Constantes.
Una vez generada la fuente, es posible utilizarla desde cualquier indicador del dominio, ya sea como parte de un tablero o en un indicador independiente.
i) Constante
Es utilizada en los casos en que el valor o la meta del indicador es una constante. Puede resultar útil, por ejemplo, cuando se trata de indicadores con metas relativas (porcentajes) las cuales se desea mantener fijas. Considerar que si la constante es modificada en algún momento del tiempo entonces esta modificación se aplicaría al cálculo del indicador tanto para los períodos futuros como para los pasados, pudiendo llegar a afectar los estados anteriores del indicador.
ii) Consulta SQL
Este tipo de fuente de datos no permite realizar una consulta SQL, sino que dada una tabla ubicada en una base de datos, permite obtener de ella los valores para el indicador/meta. Para ello es necesario seguir los siguientes pasos:
- Crear el DataSource: es necesario crear un DataSource para establecer la comunicación con la base de datos a utilizar. Dicho archivo debe almacenarse preferentemente bajo el directorio <o3bpa>/jboss/standalone/deployments.
- Definir driver a utilizar: descargar el driver de la base de datos correspondiente y almacenarlo bajo el directorio <o3bpa>/jboss/server/default/lib.
- Crear el DB Esquema: dentro de Metadata, crear un nuevo artefacto DB Esquema siguiendo los pasos descriptos en el apartado sobre alta de artefactos y seleccionando la opción DB Esquema de la lista desplegable. El formulario de solicitud de datos cargar la información requerida en los campos Nombre, Id y Fuente de datos. En el último caso se debe ingresar lo siguiente: java:/<jndi-name del DataSource>
- Crear la Fuente de Datos: dentro de Metadata, crear un nuevo artefacto Fuente de Datos siguiendo los pasos descriptos en el apartado sobre alta de artefactos y seleccionando la opción Fuente de Datos. En la vista edición de la nueva fuente ingresar Nombre e Id. Seleccionar la pestaña Consulta SQL del panel y cargar los datos requeridos:
Campo | Descripción |
|---|---|
Esquema | Id. del DB esquema anteriormente creado (punto3) |
Tabla | Nombre de la tabla de la base de datos a la cual se realiza la conexión, la tabla de referencia junto con los campos a usar. |
iii) Consulta MDX
Para definir una nueva fuente de datos como consulta MDX es necesario haber definido previamente un O3 Esquema. Al momento de definir la fuente es necesario que esté levantado el jboss de la instalación de O3 correspondiente. Posteriormente es necesario seguir los siguientes pasos:
- Indicar el nombre del esquema de O3 y del cubo a consultar
- Elegir la dimensión que se desea sea considerada como fecha para calcular la evolución histórica del indicador.
- Indicar los niveles de la fecha y la frecuencia a la que corresponden (ejemplo: Año - anual, etc.) Con esta acción se indica la frecuencia deseada para el cálculo del indicador. (Por ejemplo: puede ser que una dimensión fecha llegue hasta el nivel día, pero el usuario desea calcular un indicador mensual)
El lugar para indicar qué medida será tomada en cuenta para el cálculo de un indicador es el propio indicador, en su solapa de cálculo de valor.
iv) Consulta vista O3
Consideración 1: Esquema de O3
Para definir una fuente de datos como consulta vista O3 es necesario haber definido previamente un O3 Esquema. A partir de esta fuente se puede hacer referencia a cualquier vista que haya sido grabada previamente en el servidor de O3. Al momento de definir la fuente es necesario que esté levantado el jboss de la instalación de O3 correspondiente.
Consideración 2: Formato de la vista de O3
La vista de O3 que ha de ser generada y guardada para ser tomada luego como fuente de datos debe cumplir con las siguientes condiciones:
- La dimensión fecha debe estar en la primer columna, abierta según la frecuencia de cálculo del indicador.
- En las restantes columnas deben figurar los nombres de las medidas a considerar como valores o metas para uno o más indicadores.
Un ejemplo puede verse en Cuadro 2.4. Considerar que la vista generada puede contener elementos correspondientes a un solo nivel, como en el caso de ejemplo, o elementos anidados de varios niveles de una misma dimensión.
Cuadro 2.4. Formato de Vista O3 |
|---|
|
A continuación se describen los pasos a seguir para definir una consulta a vista O3 como fuente de datos:
- Dar de alta una nueva fuente de datos.
- En el modo edición ingresar Nombre e Id.
- Seleccionar la pestaña Consulta Vista O3 y cargar los campos requeridos de acuerdo al siguiente criterio:
- Seleccionar el Esquema O3 correspondiente. Observar que el campo Vista se actualiza para mostrar las vistas del servidor indicado por el esquema.
- Elegir la vista correspondiente.
- Elegir la dimensión que se desea sea considerada como fecha para calcular la evolución histórica del indicador.
- Indicar los niveles de la fecha y la frecuencia a la que corresponden (ejemplo: Año - anual, etc.) Con esta acción se indica la frecuencia deseada para el cálculo del indicador. Por ejemplo: puede que una dimensión fecha llegue hasta el nivel día, pero se desee calcular un indicador mensual.
Cuadro 2.5. Alta fuente de datos |
|---|
|
Una misma fuente de datos puede ser utilizada para varios indicadores.
v) Tabla de constantes
Esta opción es similar a la opción de Constante, pero en este caso la constante puede variar en función de uno o más atributos.
- En el cuadrante superior indicar el nombre de los campos por los que habrá de desglosarse el dato.
- En el cuadrante inferior aparecerán los campos creados, pudiendo cargar valores para cada uno de ellos.
2.2.3. Visualización
Los indicadores que integran los tableros se caracterizan por adoptar cierto estado una vez calculado, dependiendo del valor, meta y criterio de tolerancia definido en la metadata del indicador. Este estado se visualiza en el sistema en forma de semáforo con diferentes colores, tradicionalmente el clásico de tres colores: verde, amarillo y rojo.
El sistema sugiere dos visualizadores por defecto: semáforo simple 4 colores y semáforo simple 5 colores.
Para crear un nuevo visualizador, seguir los pasos descriptos en el apartado sobre alta de artefactos, seleccionando la opción Visualización de la lista desplegable. Una vez abierto el modo edición del nuevo visualizador ingresar la información requerida sobre Nombre e Id. Para la definición del nuevo visualizador es posible tomar como base cualquiera de los dos semáforos por defecto del sistema. Una vez seleccionado el deseado , la tabla Items de Visualización despliega las diferentes opciones de configuración. Es posible personalizar la cantidad de items habilitados, los colores de cada uno de ellos así como la imágen que adoptará (círculo, rombo o triángulo),
En el ejemplo del Cuadro 2.6, se trata de un semáforo tradicional de tres colores.
Cuadro 2.6. Nuevo Visualizador |
|---|
|
2.2.4. Calendario
Por defecto se asume que el calendario usado para la definición de cada uno de los elementos es el civil (Enero - Diciembre), aunque dependiendo de la fecha de cierre de la organización o de alguna otra consideración, es posible definir distintos calendarios con distinta fecha de inicio. Esta posibilidad implica una modificación a modo informativo dentro del sistema, no afectando en nada el cálculo del tablero.
Para crear un nuevo calendario, seguir los pasos descriptos en el apartado sobre alta de artefactos, seleccionando la opción Calendario de la lista desplegable. Una vez abierto el modo edición del nuevo calendario ingresar la información requerida sobre Nombre, Id. y Descripción. Observar que el campo Mes Inicial permite seleccionar el mes inicio del calendario y luego los cuatro campos del área Presentación del Período indican el formato de visualización de las fechas en el tablero.