Page Comparison

* 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 realizan en el *O3 Browser* y son almacenadas localmente donde se ejecuta el componente *O3 Browser*.

Para definir consultas detalladas asociadas a los datamarts publicados en el servidor, se almacenarán las mismas en el *O3 Server*.

h1. {anchor:_Ref92704082}Conexión a la base 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 drivers JDBC, los archivos correspondientes al controlador deben estar ubicados en la carpeta <O3_HOME>/classes/jdbc, donde <O3_HOME> es el directorio de instalación de *IdeaSoft O3

{*}*™ Performance Suite*.

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

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*.\\ !O3Query-EditarConexiones.png|align=center!
 
\\

Donde indicaremos si utilizaremos las conexiones locales o del O3 Server.\\ !O3Query-EditarConexiones-Abrir.png|align=center!
 
\\

Indicando alguna de las conexiones del panel de la izquierda, accedemos a la definición de la conexiónLa siguiente figura muestra la ventana de definición de la conexión.\\ !O3Query-EditarConexiones-PanelConexion.png|align=center!

\\


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

| *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 también [O3PS: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".

h1. Especificando de la consulta

Las consultas realizadas a la base de datos para obtener información más detallada que el contenido en el modelo multidimensional se definen a partir de tablas o vistas existentes en el DBMS. Las vistas se utilizan en aquellos casos en que la consulta involucre campos de más de una tabla.
La configuración de los elementos de la consulta consiste en:
* Identificar la consulta con un nombre apropiado
* Asociar el nombre de la tabla o vista sobre la cual se realiza la consulta
* Definir los campos de la consulta que se desean visualizar como columnas en el panel de Drill Through.
* Definir los campos que se desean utilizar como filtros en la consulta, permitiendo al usuario restringir el resultado de la misma a los valores expresados en éstos.  En la sección Definiendo Filtros se detalla la definición de los mismos.

\\
El menú Herramientas de *O3 Browser* contiene la funcionalidad del Drill Through con las opciones para definir una nueva consulta y editar una consulta existente, además de definir conexiones a la base de datos.
La siguiente figura muestra el diálogo que permite configurar una consulta a la base de datos:
!worddav7590edd3faaa40446676bc20c1ccb2f9.png|height=296,width=555!
{anchor:_Ref92879487}Figura 5: Configuración de una Consulta
La ventana de configuración de las consultas presenta dos paneles:
* Panel de definiciones (panel izquierdo)
* Panel de propiedades (panel derecho)

El panel de definiciones contiene un primer nodo con la etiqueta "Drill Through" cuyas propiedades definen la consulta a la base de datos.
Los filtros se agregan al nodo de etiqueta "Filtros" del panel de definiciones. Sus atributos se definen en el panel de propiedades y se describen más adelante en esta sección.
La siguiente sección describe las propiedades de configuración de la consulta.

h1. {anchor:_Ref92772768}Definiendo la consulta

Las propiedades de la consulta definen el conjunto de registros que se deben mostrar al momento de solicitar la consulta detallada en *O3 Browser*, así como los campos que interesan mostrar como resultado de la misma.
Para definir una consulta se debe completar la siguiente información:
* *Nombre:* Es un nombre arbitrario para la consulta
* *Esquema:* Es la conexión a la base de datos que se necesita utilizar para acceder a los datos. Se debe seleccionar de la lista de conexiones disponibles. Las conexiones disponibles son aquellas definidas previamente. (Ver Conexión a la base de datos ).
* *Nombre de la Tabla:* Es el nombre de la tabla o vista de la base de datos sobre la que se realiza la consulta.
* *Generar Formulario:* Esta opción es de uso interno y por lo tanto no es modificable.
* *Cubo:* Es el cubo al cuál estará asociada la consulta detallada. Es importante seleccionar el cubo para permitir definir filtros asociados a dimensiones del cubo. El botón que se encuentra a la derecha permite seleccionar un cubo del sistema de archivos. La asociación reflejada en este panel se realiza únicamente con el objetivo de expresar la relación existente entre los filtros de la consulta y las dimensiones del cubo.
* *Campos disponibles:* Definen los campos que se desean mostrar en la consulta detallada. Para ello se deben especificar los siguientes datos:
* Nombre: es el nombre del campo definido en la propia base de datos. No se puede modificar.
* Alias: es la etiqueta del campo en el panel de la consulta detallada.
* Tipo: es el tipo de dato del campo.
* *Botón Autollenado:* Define automáticamente los "Campos disponibles" a partir de la consulta especificada, es decir que define como campos disponibles todos aquellos campos presentes en la tabla o vista definida anteriormente.
* *Botón Agregar Campo:* Permite agregar manualmente un campo. Para ello deben definirse los 3 datos descriptos anteriormente.
* *Botón Borrar Campo:* Elimina el campo seleccionado. En caso de no haber seleccionado ningún campo, se elimina el último.
* *Botón Guardar:* Guarda los cambios realizados en la configuración de la consulta, tanto en las propiedades como en los filtros. Las definiciones se guardan en un archivo XML.
* *Botón Guardar Como:* Es igual que el botón Guardar pero permite ingresar un nombre distinto para el archivo.

Para crear una nueva consulta se deben seguir los siguientes pasos:
# Ir a menú Herramientas y abrir la opción Drill Through \-> Nuevo Drill Through.
# Definir las propiedades de la consulta. Esto es completar cada uno de los campos descriptos anteriormente.
# Guardar las propiedades con el botón "Guardar" o  "Guardar Como"

Si se desea modificar una consulta definida previamente, es necesario que la conexión a la base de datos utilizada por la consulta esté disponible.
Para modificar una consulta ya existente se deben seguir los siguientes pasos:
# Ir a menú Herramientas y abrir la opción Drill Through \-> Editar Drill Through.
# Elegir a través del diálogo de apertura, la consulta deseada.
# Modificar las propiedades deseadas de la consulta.
# Salvar los cambios con el botón "Guardar" o "Guardar Como"

h1. {anchor:_Ref92772786}Definiendo filtros

Los filtros de la consulta son condiciones que se imponen sobre determinados campos de para restringir el conjunto de resultado de la consulta.
En general los campos definidos como filtros se relacionan con dimensiones del modelo multidimensional para poder sincronizar las consultas realizadas en el cubo con el resultado detallado de la consulta a la base de datos.  En este caso, se asocia el filtro a un determinado nivel de la dimensión del modelo multidimensional. A medida que se navega en el cubo, la consulta detallada se actualiza aplicando restricciones sobre los mismos valores filtrados en el cubo de O3.
Sin embargo pueden definirse filtros que no estén relacionados con dimensiones, lo que permite restringir el resultado de la consulta a la base de datos desde el propio panel de la consulta. Esto puede ser de utilidad para agregar algún dato no incluido en el modelo multidimensional que sea relevante en aquellos casos que se analice en detalle la información.

h2. {anchor:_Ref92788751}Definiendo las propiedades de los Filtros

La siguiente figura muestra el panel de definición de un filtro.
\\  !worddav9b43dc6105f42032d23a21b3c0222a94.png|height=279,width=472!
Figura 6: Panel de propiedades de los Filtros
Un filtro queda definido por los siguientes campos:
* *Nombre del Campo*: Es un nombre arbitrario para el Filtro
* *Etiqueta del Argumento*: Es la etiqueta que se muestra al usuario como descripción del Filtro en la Consulta
* *Nombre del Argumento*: identifica internamente el filtro. Tiene como restricción de que no puede contener espacios en blanco.
* *Tipo del Argumento*: Es el tipo de dato de la colección de valores posibles para el filtro. Por ejemplo, un filtro que contiene como valores los años, se debe definir el tipo Entero.
* *Dimensión y Nivel*: Permiten elegir la dimensión y el nivel de la misma con los cuales se sincroniza el filtro. Esta relación permite pasarle al filtro el valor del elemento de la dimensión seleccionado cuando se navega en el cubo. La dimensión que se desea asociar se debe elegir de la lista de dimensiones que se ofrecen como ayuda del campo. Para ello es necesario haber indicado el cubo para el cual se define la consulta detallada en el panel de propiedades de la consulta (Ver la sección Definiendo la consulta ).
* *Condición*: Es una expresión que expresa la condición que se aplica al campo de la base de datos para restringir el conjunto de resultado. La sintaxis depende del DBMS utilizado. El valor  asignado al campo es representado con un signo de interrogación. El mismo es sustituido con el valor del filtro al ejecutar la consulta.  Por ejemplo la condición utilizada para definir el año como filtro, a partir de un campo de tipo fecha de la base de datos es: year(OrderDate) = ?  El ejemplo presentado asume que la función year(date) que recibe una fecha y devuelve un entero que representa el año de la misma, es ofrecido por el DBMS utilizado..
* *Ayuda*: Permite asociar al filtro la lista de valores posibles y desplegarlos como ayuda del campo en el panel de la consulta detallada. Para ello se debe definir una consulta a la base de datos que obtenga la clave y descripción del filtro.
* *Esquema de Ayuda*: Indica la conexión de base de batos que se debe utilizar para la consulta definida como ayuda del filtro. La misma se elige de la lista de conexiones definidas previamente.

Los cambios realizados en la definición de los filtros deben salvarse. Para ello se debe  utilizar el botón "Guardar" del panel de propiedades de la consulta.
Para facilitar la definición de los filtros se dispone de  las siguientes operaciones:
* Agregar un nuevo Filtro
* Eliminar un filtro existente
* Cambiar de posición un Filtro
* Modificar un filtro existente

Para agregar un nuevo filtro es necesario:
# Hacer clic con el botón derecho del ratón sobre el nodo "Filtros" que aparece en la Figura 5: Configuración de una Consulta para desplegar el menú de Filtros
# Elegir la opción "Nuevo Filtro" de la entrada "Agregar"  de dicho menú.
# Elegir el filtro agregado con el botón izquierdo del ratón y definir sus propiedades (Ver Definiendo las propiedades de los Filtros).
# Confirmar los cambios con el botón "Guardar" ubicado en el panel de propiedades de la consulta (Ver  Definiendo la consulta  ).

\\
Para eliminar un filtro es necesario:
# Hacer clic con el botón derecho del ratón sobre el Filtro que se desea eliminar para desplegar el menú de operaciones sobre el filtro
# Elegir la opción "Borrar" de dicho menú para eliminar el filtro elegido
# Confirmar los cambios con el botón "Guardar" ubicado en el panel de propiedades de la consulta (Ver  Definiendo la consulta  ).

El orden en el que se presentan los filtros en el panel de la consulta detallada queda determinado por la posición de los mismos en el panel de definiciones. Es posible reubicar un filtro con las opciones "Subir" y "Bajar" del menú desplegado con el botón derecho del ratón.
Para mover un filtro una posición se debe:
# Hacer clic con el botón derecho del ratón sobre el Filtro que se desea mover para desplegar el menú de operaciones sobre el filtro
# Elegir la opción "Subir" o "Bajar" de dicho menú para mover el filtro. Esta operación se debe repetir tantas veces como posiciones se desee mover.
# Confirmar los cambios con el botón "Guardar" ubicado en el panel de propiedades de la consulta (Ver  Definiendo la consulta  ).

Para modificar las propiedades de un filtro es necesario:
# Seleccionar el Filtro que desea modificarse con el botón izquierdo del ratón. De esta forma aparecen sus propiedades en el panel de propiedades.
# Modificar las  propiedades que se deseen cambiar (Ver Definiendo las propiedades de los Filtros).
# Confirmar los cambios con el botón "Guardar" ubicado en el panel de propiedades de la consulta (Ver  Definiendo la consulta  ).

----
{children}

----
{scrollbar}