03. Diseño de dashboards

Introducción

La definición de los dashboards se realiza en el fichero /opt/ozona/obsidian/config/dashboard.views.ini, al que se puede acceder desde la consola de modelado de Obsidian.


Menú Configuración -> sección “Configuration” -> Configuration files -> Obsidian Dashboard.Views


La definición de los dashboards se hace de forma jerárquica:

  • Definición de dashboards, referenciando a las vistas o secciones del dashboard
  • Definición de vistas, referenciando a los grupos de componentes que lo componen (si aplica)
  • Definición de los grupos de componentes, referenciando a los componentes que lo componen


Por ejemplo, la definición de un nuevo dashboard llamado Prueba, que tenga dos vistas, se haría así:

[Prueba]
	vista1=y
	vista2=y


Aunque es un fichero de texto, el editor cuenta con un analizador léxico y una gramática que asegura que toda referencia a un elemento está correctamente definida, que no existen parámetros incorrectos, etc. El analizador se ejecuta cada vez que se graba el fichero. Por ejemplo, en el caso anterior, referenciando dos vistas que aún no existen, indica las líneas donde se han detectado errores.



La definición de cada una de las vistas variará en función de sus características. Vamos a utilizar como ejemplo dos de las más habituales: una vista de servicios y una vista de mapas isométricos.

[Prueba]
	vista1=y
	vista2=y

[vista1]
	type=services
	name=SERVICIOS
	
[vista2]
	type=map
	name=MAPA
	img=samplej.svg
	mapID=1
	mapType=4

El dashboard mostraría las siguientes secciones:


Las vistas pueden agruparse en menús, por ejemplo:

[Prueba]
    grupo1=y
        vista1=y
        vista2=y

[vista1]
	type=services
	name=SERVICIOS
	
[vista2]
	type=map
	name=MAPA
	img=samplej.svg
	mapID=1
	mapType=4 

[grupo1]
	type=group
	name=GRUPO
	items=2

De esta manera, el menú se transforma de la siguiente forma:


Una vista de servicios se define con el tipo "services" y su único parámetro obligatorio es el nombre. Más información sobre las vistas de servicios.

Una vista de tipo mapa se define con el tipo "map" y sus parámetros obligatorios son:

  • nombre
  • imagen (referencia a la imagen vectorial SVG que se utilizará para el mapa isométrico. Es posible añadir otro tipo de imágenes, pero no se podrá interactuar con ellas)
  • mapID, para hacer referencia al conjunto de mapeos entre objetos de la imagen y elementos del modelado de servicios. Puede ser utilizado el mimos ID en más de un mapa, reutilizando los mapeos
  • mapType, indicando qué dimension de los elementos del modelado se quiere representar:
    • 1: Disponibilidad
    • 2: Capacidad
    • 3: Service Desk
    • 4: Peor de los eventos
    • 5: Peor de las dimensiones (disponibilidad, capacidad, service desk)
    • 6: Nivel de servicio

Las imágenes samplei.svg y samplej.svg se incluyen de forma predeterminada en Obsidian como ejemplo.

Las imágenes pueden cargarse desde la consola de modelado, desde la opción Menú Configuración -> sección “Operation” -> Advanced -> Upload Dashboard Images. También pueden generarse con alguno de los editores de mapas isométricos de Obsidian:

  • /obsidian/svg (servidores en producción)


Al exportar la imagen al dashboard, (primer icono de la barra negra tras la casilla del nombre), el mapa pasa a estar ya disponible en el dashboard


[vista2]
	type=map
	name=MAPA
	img=ejemplo.svg
	mapID=2
	mapType=4



El nuevo dashboard estará automáticamente disponible en la URL /obsidian/dashboard/?view=prueba. Por ejemplo, si se está utilizando una MV Vagrant, la URL sería http://localhost:8080/obsidian/dashboard/?view=prueba.


Debe recordarse que, para poder acceder a este nuevo dashboard, habrá que asignar permisos en la sección de perfiles de la consola. Como puede comprobarse, el dashboard Prueba está inhabilitado y es necesario habilitarlo haciendo doble click en él para cada uno de los perfiles que deban tener acceso.