Definiendo Conexiones
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 portal
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 |
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.
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.
<?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.
<?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>