Versions Compared

Old Version 8

changes.mady.by.user Federico Gonzalez (Unlicensed)

Saved on

compared with

New Version Current

changes.mady.by.user Nicolás Palombo

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin

...

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

...

Wiki Markup
{scrollbar}
Page Tree
rootTutorial O3 Report

...

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

    O3 Data Set

  7. Ingrese la siguiente consulta MDX en la especificación del Data Set
    Code Block
    sql
    sql
    
SELECT {[Vendedores].[Vendedor].members} ON COLUMNS

...

  1. FROM [Vinos]

...

  1.  Note
    Para más detalles sobre la definición de un Data Set consultar la sección 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:
  1. Acepte los cambios del editor del Data Set
  2. Complete los datos del parámetro con la nueva información: 
     Data Set: 
     Conjunto de datos al cual está asociado el parámetro. 
     En nuestro caso usaremos el conjunto de datos Vendedores 
     Select value column: 
...
  1.  Campo del Data Set que contiene la clave del parámetro. 
     En nuestro caso usaremos unique_name 
     Select display text: 
...
  1.  Campo del Data Set que contiene la etiqueta del parámetro a mostrar al usuario 
     En nuestro caso label 
    La pantalla deberá quedar de la siguiente manera: 
                     Image Removed
...
  1. Finalmente el editor debería mostrar lo siguiente 
     Image Added
  2. Presione el botón OK para concluir la creación del Parámetro. Este aparecerá en la ventana Data Explorer bajo Report Parmeters.
En este punto es posible ejecutar el reporte para ver cómo se muestra una ventana donde se solicita el valor del parámetro de entre una lista de opciones que son obtenidas del cubo de O3 Image Added


Utilizando el Parámetro 
...
en la consulta
Una vez definido el parámetro en un nuevo Data Set con la siguiente información:
    Name: Venta de vinos por vendedor
     Data Source: O3 MDX View
     Data Set Type: O3 Data Set 
Como query ingrese la siguiente consulta en MDX:es necesario utilizarlo en la consulta para que filtre la misma y devuelva únicamente el Vendedor seleccionado por el usuario.
Para ello modificaremos el Conjunto de Datos (Data Set) definido en la sección Especificando los datos a utilizar.
  1. Desde el Data Explorer, hacer doble click sobre el Conjunto de Datos Ventas MDX.
  2. Modificar la consulta MDX para que contenga lo siguiente 
     Code Block
    sql
    sql
    
SELECT
	{
...
  1. [Measures].[Litros Vendidos], [Measures].[Venta Neta]} ON COLUMNS
	,
...
  1. CROSSJOIN({[Vendedores].[Vendedor].?}, {[Vinos].[Vino].members}) ON ROWS
FROM [Vinos
...
  1. ]

...
titleNota
...
  1.  Notar el signo de interrogación 
...
En su Data Explorer deberá aparecer "Venta de vinos por vendedor" bajo Data Sets.
Siga los siguientes pasos:
    1. Haga doble click sobre Venta de vinos por vendedor aparecerá la siguiente pantalla:
             Image Removed
    2. Haga click en Parameters,  su pantalla cambiará por la siguiente:
              Image Removed
    3. Haga click en New. Aparecerá una pantalla similar a la siguiente:
                                                    Image Removed
      Completelá con los siguientes datos:
               Name: param1
               Data Type: String
               Direction: Input
               Default Value: N/A
               Linked To Report Parameter: Vendedor
...
 Name: 
  1. en la sección correspondiente a las filas. Este signo marca el lugar donde se sustituirá el valor del parámetro cuando se ejecute la consulta.
  2. Seleccione Parameters en el editor del Data Set
  3. Agregue un nuevo parámetro con el botón New...
  4. Configure el parámetro de acuerdo a lo siguiente 
     Name: 
     El nombre del parámetro 
     En nuestro caso 
...
  1.  Vendedor 
     Data Type: 
     Tipo del 
...
  1. parámetro  
     En 
...
  1. nuesto caso no requiere modificación 
     Direction: 
     Dirección del parámetro (Entrada o Salida) 
     En nuestro caso usaremos input 
     Default Value: 
     Valor que tendrá el parámetro por defecto 
     En nuestro caso N/A 
     Linked To Report Parameter: 
     Parámetro al cual está asociado 
     En nuestro caso Vendedor 
    4. Seleccione OK, aparecerá la siguiente pantalla: 
               Image Removed
     5. Presione el botón OK.
 Probando lo realizado
Para probar lo realizado cree una tabla con la información de Ventas de vinos por vendedor como se explica en Diseñando la forma del reporte
Seleccione Preview y aparecerá la siguiente pantalla:
                      Image Removed
Seleccione el vendedor del cual quiera ver los litros vendidos para cada vino y haga click en OK, aparecerá el detalle de los litros vendidos para cada vino del vendedor que seleccionó.
Por ejemplo si elige "Federico Moreira" como parámetro el reporte mostrará:
 Vino  
 Litros Vendidos 
 Cabernet Sauvignon, Merlot 
 4500 
 Cabernet, Tannat, Merlot 
 0 
 Chenin, Gewurzt 
 2250 
 ... 
 ... 
 Ugni Blanco 
 0 
...
  1.  Image Added
  2. Finalmente resta ejecutar el reporte para ver cómo se filtran los datos para mostrar únicamente las ventas del Vendedor seleccionado 
     
     Wiki Markup
    {scrollbar}