O3 Control Dashlets

Control Dashlets

Los control dashlets permiten filtrar contenido de vistas (gráficas y tablas) mediante la selección de elementos de una dimensión en un cubo. Cumplen la misma funcionalidad que los control portlets de la versión 5. Tienen una nueva presentación pero el funcionamiento es básicamente el mismo. Tiene compatibilidad hacia atrás con los view portlets (portlets html).

Definición del Control

A continuación se listan los datos básicos que el Control necesita para ser definido.

ParámetroExplicación
Sincronizador

Nombre que servirá de referencia para el Control.

El View Dashlet sobre el cual queremos sincronizar, debe referenciar éste nombre en la pestaña Avanzado en el campo Sincronizador.

Modo

Existen 3 modos de definir el Control y las opciones son las siguientes:

  • búsqueda: permite que el usuario busque entre las vistas o cubos existentes.
  • elemento: permite la selección de elementos de una dimensión.
  • parámetros: permite que el usuario le pase parmámetros a una vista. Esto requiere que la vista esté configurada para eso.

Dependiendo del Modo seleccionado, la definición continúa de la siguiente manera:

Modo Búsqueda

En el control definimos el nombre y seleccionamos modo búsqueda.

Datos adicionales:

  • Habilitar modo de etiquetas
  • Definir búsqueda en..

Habilitar modo de etiquetas: ésto último permite ver el resultado de la búsqueda en forma de Lista o como Etiquetas, donde se seleccionará la vista a ser sincronizada con el View Dashlet.

Definir búsqueda en.. : Por último debemos definir si queremos modificar las búsquedas unicamente desde la edición del control, desde la vista del control o en ambas modalidades.


A continuación se presenta un ejemplo, donde se habilitó etiquetas y se controla la búsqueda tanto desde la edición del control como en la vista.

Se filtro la búsqueda para visualizar todos los cubos y vistas existentes.

En el listado resultante el usuario puede seleccionar cada uno de los cubos y vistas los cuales se visualizan en el View Dashlet de sincronización.


Modo Elemento

En el control definimos el nombre y seleccionamos modo elemento.

Datos adicionales:

  • Dirección
  • Visualización
  • Sincronizar con el servidor
  • Alineación de etiquetas
  • Cubo
  • Dimensión

Dirección: Dirección en que visualizaremos la Dimensiones, Horizontal o Vertical.

Visualización: Forma en que se presentan los valores de las dimensiones: Lista desplegable (combo), Lista (todos los valores presentados como lista) o Botones (tipo radiobuttons).

Sincronizar con el servidor: Se debe activar esta opción solamente si se desea sincronizar Portlets con Dashlets.

Alineación de etiquetas:  Forma en que se alinearán las etiquetas que referencian las dimensiones: Izquierda, Centro o Derecha.

Cubo: Listado de cubos disponibles.

Dimensión: Tabla donde se agregan y eliminan las Dimensiones sobre las que queremos filtrar la vista.

Al posicionarnos en cada Dimensión, se nos permite Explorar Hijos o Explorar Nivel.

Al Explorar Hijos: al costado seleccionamos los hijos de quien queremos explorar.

Al Explorar Nivel: al costado seleccionamos el nivel a explorar.

Una vez definido sobre lo que vamos a explorar, el Comportamiento selección simple nos permite definir si quiero ver el nivel sobre el que estamos posicionados o si queremos explorar los hijos de éstos ultimos, cuando utilizamos selección simple.

En caso de seleccionar Permitir selección múltimple, se explora unicamente el nivel en el que estamos posicionados.


A continuación se presenta un ejemplo donde se habilitó selección múltiple.

Modo Elemento Avanzado

En el control definimos el nombre y seleccionamos modo elemento.

Datos adicionales:

  • Dirección
  • Visualización
  • Cubo
  • Dimensión

Dirección: Dirección en que visualizaremos la Dimensiones, Horizontal o Vertical.

Visualización: Forma en que se presentan los valores de las dimensiones: Árbol completo (Selector de toda la jerarquia de la dimensión), Combo anidados (combos con distintos niveles de la jerarquia que se sincruonizan).

Cubo: Listado de cubos disponibles.

Dimensión: Tabla donde se agregan y eliminan las Dimensiones sobre las que queremos filtrar la vista.

Al posicionarnos en cada Dimensión, se nos permite Explorar Hijos o Explorar Nivel.

Al Explorar Hijos: al costado seleccionamos los hijos de quien queremos explorar.

Al Explorar Nivel: al costado seleccionamos el nivel a explorar.

Una vez definido sobre lo que vamos a explorar, el Comportamiento selección simple nos permite definir si quiero ver el nivel sobre el que estamos posicionados o si queremos explorar los hijos de éstos ultimos, cuando utilizamos selección simple.

En caso de seleccionar Permitir selección múltimple, se explora unicamente el nivel en el que estamos posicionados.

Si selecciono la opción de Combo anidados, debo seleccionar la cantidad de niveles de la jerarquía que deseo desplegar. 

Modo Parámetro

En el control definimos el nombre y seleccionamos modo parametro.

La vista que se encuentre sincronizada debe tener los mismos nombres de parametro que definimos en dicho control con los mismos tipos.

Entonces, lo que permite el control es que al cambiar los valores de los parametros, las vistas que los contienen se recalculen de acuerdo a los nuevos valores.

Datos adicionales:

  • Refrescar automáticamente
  • Cantidad de columnas
  • Tabla de parámetros

Refrescar automáticamente: Seleccionamos esta opción en caso de querer que se actualice cada vez que el valor cambie.

Cantidad de columnas: Disposición en columas de los parametros creados.

Tabla de parámetros: El usuario ingrega cada uno de los parametros que desea controlar teniendo en cuenta que debe ser de mismo nombre y tipo definidos en la vista.

A continuación se presenta un ejemplo donde el parametro IPC impacta sobre la columna SumaIPC de la vista.

Ejemplo de Procedimiento para utilizar View/Control Dashlet con Parámetros

  1. Armar una Vista en el portal
  2. Agregar uno o varios parámetros de acuerdo a la siguiente imagen
  3. Agregarle a la vista una columna global con una expresion calculada haciendo referencia al parámetro ingresado anteriormente
  4. Guardar la vista
  5. En el eportal Insertar y Configurar un nuevo Control Dashlet que actue como sincronizador
  6. Insertar y Configurar un nuevo View Dashlet que haga referencia a este sincronizador y a la vista creada en el paso 1.
  7. Agregar otro Control Dashlet y configurarlo en modo parametro para que pueda recibir parametros de acuerdo a la siguiente imagen
  8. Ahora cuando ingresamos un parametro y actualizamos este va a reflejar los cambios en el view dashlet.