Parametrización Simple (Parámetros Dinámicos)

...

Parametrizando el Reporte

Con frecuencia los reportes requieren cierto grado de parametrización para que el propio usuario pueda filtrar la información que se despliega, restringiendo así el análisis a subconjuntos de la información.

En esta sección se describe como agregar un parámetro simple a un reporte paso a paso, utilizando un ejemplo sencillo con datos que provienen del cubo Vinos distribuido con el producto.

El ejemplo terminado puede consultarse aquí.

Creando un parámetro dinámico

Para poder definir un parámetro dinámico es necesario primero haber creado un conjunto de datos (Data Set).

Primero cree una fuente de  datos (Data Source) de tipo O3 Data Source, que contenga la siguiente información:

    * Name O3 MDX View
    * Host: localHost
    * user: user
    * password: user
    * Query Type: MDX Query 

Luego cree un conjunto de datos (Data Set)  que contenga la siguiente información:

    * Name: Vendedores
    * Data Source: O3 MDX View
    * Data Set Type: O3 Data Set
    * Query La siguiente expresion en MDX:al reporte que permita desplegar los datos de un único vendedor sin que esto afecte la estructura del reporte.

Creando un nuevo parámetro

1. Desde el panel Data Explorer presionar el botón derecho del mouse sobre el elemento Report Parameters
2. Crear un nuevo parámetro
   Image Added
   Esta acción abre el editor de parámetros
3. Indique los siguientes datos del parámetro

   Name:	El nombre del parámetro En nuestro caso Vendedor
   Data type:	Tipo de dato del parámetro En nuestro caso String
   Display Type:	Forma de mostrar los datos En nuestro caso List Box

4. La selección de la forma en que se despliegan los datos como List Box despliega un conjunto de opciones adicionales propias de esta forma de visualización.
   La lista desplegable (list box) podrá contener opciones estáticas o dinámicas.
   El caso estático permite al diseñador del reporte indicar de forma estática la lista de elementos que se incluirán en la lista.
   El caso dinámico permite al diseñador definir una consulta que cargue la lista con datos almacenados, por ejemplo, en un cubo de O3
5. Indique el tipo de lista dinámica
   Image Added
   Este tipo de parámetro requiere de la existencia de un Conjunto de Datos (Data Set) desde donde se tomarán los valores para cargar la lista.
6. Utilizando el botón Create New... cree un nuevo Conjunto de datos como se indica a continuación:

   Name	Vendedores
   Data Source	O3 Local MDX
   Data Set Type

7. Ingrese la siguiente consulta MDX en la especificación del Data Set

   Code Block
   sql sql
   SELECT {[Vendedores].[Vendedor].members} ON COLUMNS FROM [Vinos]

Este Data Set se puede crear siguiendo los pasos que aparecen en el siguiente link Especificando los datos a utilizar

Una vez realizado el Data Set el la vista Data Explorer (Explorador de datos) de su eclipse deberá aparecer de la siguiente manera:

                                         Image Removed

Creando el Parámetro

Para crear el parámetro deberá seguir los siguientes pasos:

1. Seleccione la opción New Parameter que se despliega al realizar click derecho sobre Report Parameters. Esto despliega la pantalla siguiente: 
   Image Removed
2. Complete la pantalla con los siguientes datos:

   Name:	El nombre del parámetro En nuestro caso Vendedor
   Data type:	Tipo de dato del parámetro. En nuestro caso usaremos String
   Display Type:	Forma de mostrar los datos En nuestro caso List Box

   La pantalla cambiará por la siguiente: 
   Image Removed
    
3. Seleccione la opción Dynamic señalado por la flecha roja. La pantalla volverá a cambiar por la siguiente: 
   Image Removed

   Note
   Para más detalles sobre la definición de un Data Set consultar la sección Especificando los datos a utilizar

   ---------------------------------------------

1. Complete la pantalla con los siguientes datos:

   Data Set:	Conjunto de datos al cual está asociado el parámetro. En nuestro caso usaremos el conjunto de datos Vendedores
   Select value column:	Valor que tendrá el parámetro. En nuestro caso usaremos unique_name
   Select display text:	Texto a mostrar en el repotye En nuestro caso label

2.     La pantalla deberá quedar de la siguiente manera: 
   
3. Presione el botón OK para concluir la creación del Parámetro. Este aparecerá en la ventana Data Explorer bajo Report Parmeters.

...