Reportes

Kustodela permite la personalización de los reportes. Todos los reportes se emiten en formato Microsoft Excel 2007 o superior, pero las plantillas se pueden modificar para emitir el reporte en el formato que se necesite. Estas plantillas se encuentran en la carpeta Templates donde quedó instalada la aplicación.

Diseño de reportes

Para modificar una plantilla de reporte abra el archivo con Microsoft Excel 2007 o superior. Todas las plantillas contienen una hoja Design que define donde se escribe la información que se extrae de la base de datos. La base de datos está formada por tablas que contienen registros y cada registro está formado por campos que contienen los valores que se muestran los reportes. Al editar esta hoja se modifica el resultado de los reportes. Al momento de emitir un reporte, Kustodela lee la hoja Design para llenar el resto de las hojas con la información de la base de datos.

Existen dos tipos de reportes:

  • Conformado por una lista de registros.
  • Conformado por un registro combinado con una o varias listas de registros de una tabla relacionada.

Adicionalmente todas las plantillas de reportes tienen una hoja Fields, en la que se especifican los campos disponibles que se pueden usar en la hoja Design para conformar el reporte.

Reporte de una lista de registros

Este tipo de reporte está conformado por una lista de registros en forma de tabla con encabezados. La hoja Design debe contener:

  • en la celda B1 el número de fila que contiene el encabezado,
  • en la columna A, a partir de la fila 3, el nombre de la hoja donde se escribe el valor de los registros,
  • en la columna B, a partir de la fila 3, la letra de columna donde se escribe el valor de los registros,
  • en la columna C, a partir de la fila 3, el nombre del campo que contiene el valor (ver hoja Fields para saber que campos están disponibles en el reporte en específico),
  • en la columna D, a partir de la fila 3, el encabezado de la columna de datos.
  • en la última celda de la columna A debe ir la palabra "End".

Ejemplo: Reporte de quejas. Plantilla: tmpReportUsers.xlsx.

Reporte de un registro combinado con una lista de registros

Este tipo de reporte está formado por área libre donde estarán los campos del registro principal y una lista de registros en forma de tabla con encabezado. La hoja Design debe contener

  • en la columna A, a partir de la fila 2, el nombre de la hoja donde se escribe el valor del registro principal,
  • en la columna B, a partir de la fila 2, la celda donde se escribe el valor del registro principal,
  • en la columna C, a partir de la fila 2, el nombre del campo que contiene el valor (ver hoja Fields para saber que campos están disponibles en el reporte en específico),
  • en la última celda de la columna A debe ir la palabra "End",
  • en la celda F1 el número de fila que contiene el encabezado de la lista de registros relacionados,
  • en la columna E, a partir de la fila 3, el nombre de la hoja donde se escribe el valor de los registros relacionados,
  • en la columna F, a partir de la fila 3, la letra de columna donde se escribe el valor de los registros relacionados,
  • en la columna C, a partir de la fila 3, el nombre del campo que contiene el valor de los registros relacionados (ver hoja Fields para saber que campos están disponibles en el reporte en específico),
  • en la columna D, a partir de la fila 3, el encabezado de la columna de datos de los registros relacionados,
  • en la última celda de la columna E debe ir la palabra "End".

Ejemplo: Reporte de una queja. Plantilla: tmpReportEmployee.xlsx.

Si el reporte muestra varias listas con registros relacionados, se puede continuar luego de la palabra "End" en la columna E, de la misma forma que para la primera lista de registros relacionados.

Si al modificar la hoja Design se desea incluir un campo personalizado, tener en cuenta que los nombres de los campos personalizados empiezan con el caracter '_', y que el nombre completo del campo se debe especificar con el formato {nombre de entidad}_{nombre del campo}. Por ejemplo, si para la entidad Users se tiene el campo personalizado _BirthDate, se debe especificar en la hoja Design como: Users__BirthDate.

La siguiente lista muestra los reportes con su plantilla modificable.

  • Admin
    • Usuarios: Muestra un reporte con los usuarios de la aplicación.
      • Plantilla: tmpReportUsers.xlsx
    • Puestos: Muestra un reporte con la información de los puestos de la aplicación.
      • Plantilla: tmpReportPositions.xlsx
    • Departamentos: Muestra un reporte con la información de los departamentos de la aplicación.
      • Plantilla: tmpReportDepartments.xlsx
    • Empleados: Muestra un reporte con la información de los empleados de la aplicación.
      • Plantilla: tmpReportEmployees.xlsx