Manual de instalación de Viafirma Documents

Configurar un gráfico

Para añadir un gráfico hay que añadir una subcarpeta en la carpeta documents-home/reports/charts/{codigo_grupo} (en la ruta documents-home/reports/charts/admin contiene los gráficos para administradores, y en la ruta documents-home/reports/charts/common contiene los gráficos comunes a todos los grupos para los usuarios gestores de grupo) que contenga un JSON con el nombre {nombre_chart}.json que contenga los siguientes campos :

{
"code": "{Código del gr�fico}",
"description": "{nombre descriptivo del gráfico}",
"type": "{table/linear/horizontal/barchart/piechart}",
"queryOracle":"query nativa de Oracle",
"queryPostgres":"query nativa de PostgreSQL",
"series":"Fecha;Título;Usuario;Estado",
"seriesQuery" : "select code from vd_group",
"x" : 1,
"y" : 2,
"serie" : 0,
"groupCode" : 0
}
atributo descripción
code Debe coincidir con el nombre del json
type table/linear/horizontal/barchart/piechart son los tipos de gráficos soportados
description nombre descriptivo del gráfico
queryOracle query oracle que genera los datos con los que trabaja el gráfico; opcional si la BBDD es PostgreSQL
queryPostgres query postgreSQL que genera los datos con los que trabaja el gráfico; opcional si la BBDD es Oracle
series Listado de columnas o series para los gráficos; opcional para gráficos de tipo 'piechart'
seriesQuery Query que generara el listado de columnas o series para los gráficos; opcional y alternativo al uso de 'series'
x Indica el campo de la query que se representará en el eje X
y Indica el campo de la query que se representará en el eje Y; es opcional para gráficos de tipo 'table'
serie Indica el campo de la query que representará cada una de las series ; es opcional para gráficos de tipo 'table' o 'piechart'
groupCode Indica el campo de la query que representa el código del grupo o el nombre del grupo; es opcional

Para las querys tenemos disponibles las variables $LASTDAY$,$LASTMONTH$,$LASTYEAR$ (se corresponden con ayer, el mes pasado y el año pasado) y otras variables como: $FIRSTDAYMONTH, $LASTDAYMONTH$, $FIRSTDAYPREVIOUSMONTH$, $LASTDAYPREVIOUSMONTH$, $FIRSTDAYYEAR$, $TODAY$

Los gráficos se generan en la misma carpeta donde está configurado el fichero {nombre_chart}.json en formato CSV.

Los gráficos se actualizarán periodicamente con lo indicado en el CRON configurado en el fichero config.properties. Ej. (Se actualizan cada hora)

chartjob.cron=0 0 0/1 * * ?