Definiendo Conexiones

Unknown macro: {scrollbar}

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 drivers JDBC, se deben seguir los pasos indicados aquí con anterioridad.

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

Hay dos maneras de definir las conexiones para la utilización de O3Query:

para ambiente desktop, que generalmente es para desarrollar las consultas
y para ambiente Web, que es el que utilizaremos para analizar nuestra información a traves del o3web.

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.

Donde indicaremos si utilizaremos las conexiones locales o del O3 Server.

Indicando alguna de las conexiones del panel de la izquierda, accedemos a la definición de la conexión

La siguiente figura muestra la ventana de definición de la conexión.

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.
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 trabajar con una conexión guardada remotamente, se debe primero generar la misma conexion en forma local, para seguir definiendo el O3 Query.

Campo	ODBC	JDBC
Nombre	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
Clave	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	jdbc:odbc:<DATASOURCE>. Donde DATASOURCE es la Fuente ODBC creada.	URL a la base de datos deseada. Depende del controlador utilizado y figura en su documentación

Puede consultar la documentación de Drivers jdbc más utilizados para poder generar la conexión que necesita.

Además de agregar una nueva conexión en el panel de conexiones, es posible: modificar una conexión existente y 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".

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

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.

connections.xml para el cubo de Vinos

<?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 datasources 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 nombrs <IdentificaciónalaBasedeDatos>-ds.xml .

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

Ejemplo de Archivo de Conexión a Fuente de Datos de Vinos - Vinos-ds.xml

<?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>

Puede consultar la documentación de Drivers jdbc más utilizados para poder generar la conexión que necesita.

También se recomienda leer la siguiente documentación sobre conexiones a distintas base de datos

Unknown macro: {scrollbar}