Gadget BarChart
- Francisco Javier López Acevedo
Interfaz de usuario: 6.2.0-Xenon
Este Gadget permite representar datos en forma de diagrama de barras.
Para empezar a usar este Gadget, se tendrá que arrastrar la caja «BarChart» desde el listado de Gadgets predefinidos al lienzo del Dashboard.
Una vez añadido, en la parte derecha de la pantalla aparecerán las opciones de configuración del Gadget:
Conforme se vayan rellenando opciones del diagrama, éste se irá actualizando en tiempo real.
Veamos con detalle en qué consiste cada una de estas opciones de configuración.
Configuración
DataSource
En este desplegable se va a seleccionar el DataSource que incluirá los valores que se quieren mostrar en la gráfica.
Para el ejemplo, se va a utilizar el DataSource de «helsinki_datasource», disponible en CloudLab.
Main
Este conjunto de propiedades permiten configurar la información del Gadget. Existen diversas opciones:
Title: será el título del gráfico. Es un campo opcional.
Subtitle: cadena de texto que aparecerá bajo el título, y que puede usarse como pequeña descripción. Es un campo opcional.
Toolbox: este selector permitirá mostrar u ocultar la caja de herramientas asociada al Gadget. Por defecto está activado.
Export to Excel: opción que permite o no exportar los datos del gráfico a un archivo Excel.
Chart Orientation: define si la orientación de representación del gráfico será en vertical u horizontal. Por defecto los datos se muestran de forma vertical.
Chart Theme: permite indicar si se usará un tema claro u oscuro en el diagrama. La leyenda sólo se mostrará si se ha definido un nombre a la serie de datos. Por defecto se usa el tema claro.
Chart Legend: si se desea mostrar u ocultar la leyenda de la gráfica. Por defecto se encuentra visible.
Axis
Este otro conjunto de propiedades van a permitir configurar los ejes de datos del diagrama. Se componen a su vez de dos grupos de opciones:
X Axis
Estas propiedades hacen referencia al eje X (eje de abscisas), entre las que encontramos:
Name: que será el nombre a mostrar en el eje.
Field: el campo del DataSource que contenga la información que se quiere representar en este eje.
Los datos de los años se encuentran en el campo «Helsinki.year».
En caso de querer utilizar internacionalización, se recomienda indicar en el campo «Name» el mismo nombre de la propiedad del campo de los datos (por ejemplo, «year»).
Y Axis
Estas otras propiedades hacen referencia al eje Y (eje de coordenadas). Se podrán añadir tantos ejes de coordenadas como datos se quieran representar.
Para crear un nuevo eje Y, se tendrá que pulsar en el botón de «+». Aparecerán entonces las opciones de configuración del eje, con las siguientes opciones:
ID: este valor, autogenerado, corresponde con el identificador del eje, el cual se utilizará posteriormente para asociar el valor del campo que se quiera mostrar.
Name: que será el nombre a mostrar en el eje. Es un campo opcional.
Position: para indicar si la localización del eje en el diagrama estará a la izquierda o a la derecha. Por defecto aparecerá a la izquierda.
Max Value: opción para indicar el valor máximo que podrá tener el eje. Es un campo opcional.
Min Value: opción para indicar el valor mínimo que podrá tener el eje. Es un campo opcional.
Data
A continuación, se asignará los datos a los ejes Y creados. Para asignar datos, se tendrá que pulsar en el botón de «+». Aparecerán entonces las opciones de configuración de un bloque de datos, con las siguientes opciones:
Serie name: para indicar el nombre que tendrá la serie de datos.
Serie field: aquí se seleccionará el campo del DataSource que se quiere mostrar.
Y Axis ID: se indicará el identificador del eje Y al que asociar los datos.
Stack Id: el identificador de la pila.
Serie color: este selector permitirá elegir el color con el que se representará la serie de datos. Si no se indica ningún color, se asignará uno por defecto.
Average: para mostrar u ocultar el valor medio de la serie de datos. Por defecto no se muestra.
Max and Min marks: para mostrar u ocultar los valores máximos y mínimos de la serie de datos. Por defecto no se muestra.
Zoom
La última sección de configuración permite definir las opciones de zoom, entre las que se encuentran:
Show Zoom: para activar o desactivar el zoom del diagrama. Esto va a permitir acercarse o alejarse de los datos. Por defecto está desactivado.
Show X Zoom: esta opción permite activar o desactivar el zoom sobre el eje X. Por defecto está activado.
X Zoom Type: en caso de hacer zoom sobre el eje X, permite elegir si se quiere hacer dentro del mismo eje, o si se hace desde fuera con una barra de desplazamiento. Por defecto está activada la opción de hacerlo dentro del eje.
Show Y Zoom: esta opción permite activar o desactivar el zoom sobre el eje Y. Por defecto está desactivado.
Y Zoom Type: en caso de hacer zoom sobre el eje Y, permite elegir si se quiere hacer dentro del mismo eje, o si se hace desde fuera con una barra de desplazamiento. Por defecto está activada la opción de hacerlo dentro con la barra de desplazamiento.