Acerca de

Egraficos es una aplicación web para crear graficos y mapas personalizados usando las librerías echarts y leaflet respectivamente.

A parte de poder descargar los gráficos en formatos svg o png, también permite crear widgets que pueden ser incrustados en caulquier servicio web.

Conociendo la necesidad de trabajar con información sensible, los datos inyectados en Egraficos son procesados únicamente en el navegador: no existen operaciones ni almacenamiento de información en el lado del servidor. Es decir, nadie puede ver, tocar o copiar los datos.

Uso

La forma más sencilla de probar la aplicación es accediendo a la url de desarrollo. Aunque si se desea ejecutar localmente puede seguir las instrucciones descritas a continuación en el apartado de instalación.

Instalación

Requisitos

Es necesario tener maven instalado, el resto de componentes, npm y node se instalarán automáticamente.

Configuración

• El fichero application.json, a parte de definir las propiedades de metadata por cliente, permite la configuración relacionada con los mapas:
  • maps.enable: permite habilitar o no la sección de mapas de la aplicación
  • maps.bing_key: propiedad para definir la clave necesaria para usar mapas de bing
  • maps.mapbox_url: url para el uso de mapas mapbox
  • maps.center: propiedad usada para definir donde debe centrarse el mapa por defecto
  • maps.zoom: propiedad usada para definir el zoom inicial del mapa
  • maps.defaultsWMS: permite múltiples valores estableciendo el valor de las siguientes propiedades:
    • maps.defaultsWMS.key: Nombre del WMS
    • maps.defaultsWMS.value: Url del WMS
• Debe modificarse en el fichero application.json en el proyecto de sistemas para adecuar estas propiedades en función del entorno/cliente.

Instrucciones de instalación

El siguiente script descargará todos los módulos necesarios para la compilación del proyecto y a continuación generará en la carpeta build el ejecutable:

mvn clean install

Una vez con todos los módulos descargados podremos ejecutar en local con el siguiente script:

npm start

Si queremos generar el build para producción manualmente:

npm run build:all

Si queremos regenerar el widget:

npm run build:widget

Si queremos regenerar el build para producción sin regenerar el widget:

npm run build

Modificaciones a tener en cuenta en función del entorno

En función del entorno en el que despleguemos la aplicación existen una serie de variables que pueden modificiarse y son aquellas que se incluyen en el fichero public/application.json

Para que el widget funcione correctamente necesitamos definir la propiedad Access-Control-Allow-Origin en la respuesta a las peticiones que se hagan a la aplicación.

Ejemplo en un apache genérico

Incluir la siguiente línea en la definición del directorio dónde se encuentra la aplicación:

<Directory /.../egraficos>
   ...
   Header set Access-Control-Allow-Origin "*"
   ...
</Directory>