Page Comparison

El procedimiento de definición de consultas detalladas a la base de datos requiere realizar los siguientes pasos:

Definición de la conexión a la base de datos.
Especificación de los datos que se desean obtener de la base de datos como resultado de la consulta y su relación con las dimensiones del datamart.
Definición del archivo de configuración requerido para asociar el datamart con la o las consultas definidas.

Estas definiciones se desarrollan en ambiente desktop con el O3 Browser y son almacenadas en primera instancia localmente donde se ejecuta el componente O3 Browser, para luego ser publicadas en el servidor y ser consultadas en la web.

Definiendo Conexiones a Bases de Datos

La configuración a la base de datos depende del DBMS y del driver utilizado, es decir si se utiliza un manejador de tipo ODBC ó JDBC.

Para las conexiones que utilicen ODBC se debe definir la correspondiente fuente de datos del sistema desde el panel de control de Windows.

Para las conexiones que utilicen drivers JDBC, se deben realizar en primera instancia, modificaciones en la instalación de O3BI y de acuerdo a la Base de Datos. Estas modificaciones se indican en documento aparte, ya que luego no hay que realizarlas nuevamente.

Las definiciones de conexiones a Bases de Datos son distintas para el uso local/desarrollo como para el uso por la web (Ambiente de Producción)

Definición Conexiones en Ambiente Desktop

Las conexiones se definen a través de la opción "Editar Conexiones de Bases de Datos" de la entrada "Edición" del menú "Archivo" de O3 Browser.

Luego elegir Desde Repositorio Local, no elegir Desde Repositorio Remoto porque se destruye el archivo de configuración para el ambiente web.

En el Panel de la Izquierda se observan las Conexiones Definidas y a la derecha su configuración.

Con la instalación vienen definidas tres conexiones de ejemplo.

Para definir una nueva conexión a la base de datos se deben seguir los siguientes pasos:

Seleccionar con el botón derecho del ratón la etiqueta "Conexiones" para desplegar el menú.
Elegir la opción "Nueva Conexión" de la entrada "Agregar" del menú.
Seleccionar la nueva conexión para desplegar el panel derecho y completar sus propiedades.

Campo	JDBC	ODBC (en desuso)
Nombre	Es el nombre dado a la conexión. Se referencia desde la definición de la consulta.	Es el nombre dado a la conexión. Se referencia desde la definición de la consulta.
Usuario	Usuario con permisos de consulta sobre la base de datos	Usuario con permisos de consulta sobre la base de datos
Clave	Clave del usuario con permisos de consulta sobre la base de datos	Clave del usuario con permisos de consulta sobre la base de datos
Controlador	sun.jdbc.odbc.JdbcOdbcDriver	Clase del controlador. La misma es especificada en la documentación del controlador utilizado. (Ver Drivers JDBC más utilizados)
Tipo de Driver	SQL	SQL
URL	URL a la base de datos deseada. Depende del controlador utilizado y figura en su documentación	jdbc:odbc:<DATASOURCE>. Donde DATASOURCE es la Fuente ODBC creada.

Probar la conexión a la base de datos, presionando el botón "Verificar".
El mensaje "Conexión realizada" indica que la conexión ha sido definida exitosamente.
Guardar los cambios con el botón "Grabar".

Info
Estas configuraciones quedan guardadas en el archivo <O3>\config\query\edf\config\connections.xml

Además de agregar una nueva conexión en el panel de conexiones, es posible: modificar una conexión existente y/o eliminar una conexión.

Si se desea modificar una conexión existente se debe:

Seleccionar la conexión que se desea modificar.
Modificar las propiedades de la conexión
Probar la conexión a la base de datos, presionando el botón "Verificar".
El mensaje "Conexión realizada" indica que la conexión ha sido definida exitosamente.
Guardar los cambios con el botón "Grabar".

Si se desea eliminar una conexión existente se debe:

Seleccionar con el botón derecho del ratón la conexión que se desea eliminar para abrir el menú.
Elegir la opción "Borrar".
Guardar los cambios con el botón "Grabar".

Definición de Conexiones en el O3BI Server (Ambiente Web)

Esta configuración la debemos realizar en la instalación del Servidor de O3BI, y en forma manual.

En Ambiente Web las conexiones definidas por el panel del O3Browser no nos sirven, debemos desarrollar datasource para ello.

Estos datasource los vamos a definir editando el archivo connections.xml que se encuentra en <O3>\server\istore\query\config

El siguiente es un ejemplo para definir el datasource para el Cubo de Vinos.

Code Block

<?xml version="1.0" encoding="UTF-8"?>
<connectionMapping xmlns="connectionMapping" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.isoft.com.uy/schemas/edf/ConnectionMapping.xsd">
     <dataSource nameJNDI="java:jboss/datasources/Vinos-ds" schema="Vinos"/>
</connectionMapping>

Prestar atención que se hace referencia a un datasource llamado Vinos-ds, para ello debemos crear un archivo en <O3>\jboss\standalone\deployments, donde definimos la conección con la fuente de datos, con el nombre <IdentificaciónalaBasedeDatos>-ds.xml .

Y también se hace referencia a un schema (Vinos), que es la consulta definida.

Code Block

<?xml version="1.0" encoding="UTF-8"?>
<datasources>
    <datasource jndi-name="java:jboss/datasources/Vinos-ds"
        pool-name="Vinos-ds" enabled="true" jta="true" use-java-context="true"
        use-ccm="true">
        <connection-url>
            jdbc:derby:c:/ideasoft/o3bi/files/data/Vinos
        </connection-url>
        <driver>
            derby
        </driver>
        <security>
            <user-name>sa</user-name>
            <password>sa</password>
        </security>
    </datasource>
</datasources>

Versions Compared

Old Version 7

New Version 8

Key

Definiendo Conexiones a Bases de Datos

Definición Conexiones en Ambiente Desktop

Definición de Conexiones en el O3BI Server (Ambiente Web)