JMagallanes

Sobre Sourcefiles y repositorios

LPara guardar información referente a usuarios, reportes y otros datos de la aplicación, se utiliza una estructura de directorios dividida en dos grandes ramas: Sourcefiles y Repositorios.

Dentro de Sourcefiles se deberán ubicar todos los archivos que genere y modifique el usuario o administrador para crear y utilizar reportes. Existen 6 directorios:

Reportdefitions: contiene los XML correspondientes a ReportDefinitions para los reportes
Reportsourcedefinitions: contiene los XML correspondientes a ReportSourceDefinitions para los reportes
Reportviews: contiene los XML correspondientes a ReportViews para los reportes.
Reportlayouts: contiene los XML correspondientes a ReportLayouts para los reportes (estos xml pueden ser generados con IReport o algún otro editor que genere layouts para JasperReports).
Datasources: este directorio está destinado a guardar los orígenes de datos como planillas Excel o archivos Xml de datos. Estos archivos pueden obtenerse de cualquier sector, pero por una cuestión de organización es conveniente utilizar este directorio.
Schemas: este directorio contiene los esquemas XSD para todos los tipos de archivo xml de reportes. No debe agregarse ningún archivo, pero es útil para validar los XML generados contra los esquemas, si se tiene alguna herramienta que lo permita.

Por otra parte, en los repositorios se guardará una “copia registrada” de los archivos correspondientes a los reportes. Para el uso de la aplicación los únicos reportes existentes serán los que estén en estos directorios registrados. Además existen otros directorios donde se guarda información específica de la aplicación.

Los directorios de información adicional son:

images: contiene las imágenes de la aplicación
languages: contiene los distintos lenguajes que se pueden utilizar cambiando la configuración
usersrepository: este directorio contiene información referida a los usuarios. Específicamente tiene los archivos de usuarios, datos de usuarios, roles y log de actividad de usuarios. Estos archivos pueden ubicarse en cualquier lugar cambiando apropiadamente la configuración, pero se agrupan en este directorio para mayor facilidad administrativa.

Los directorios con información sobre los reportes son:

Reportdefinitionrepository: guarda una “copia registrada” de cada report definition del directorio de sourcefiles
Reportsourcedefinitionrepository: guarda una “copia registrada” de cada report source definition del directorio de sourcefiles
Reportviewrepository: guarda una “copia registrada” de cada report view del directorio de sourcefiles
Reportsourcerepository: este directorio guarda un “cache” del origen de datos, siempre que el reporte tenga seteada esa opción. Obtiene todos los datos según lo especifique el RSD y los filtra con los prefiltros dados. El resultado lo guarda en un archivo serializado o como texto plano en un archivo separado por comas.
Microreportrepository: repositorio donde se guardan cubos ya generados para trabajarlos off-line. Existe un tipo de Drill Down MicroReport, que toma el reporte a ejecutar como drilldown de este repositorio (seleccionandolo si coincide en ID y parámetros).

Registrar y Vaciar:

Dentro del menú principal de la aplicación (Operaciones) hay dos ítems, vaciar y registrar, que están involucrados en el manejo del repositorio. La opción de vaciar, elimina todo lo existente en el repositorio, es decir, no queda ningún reporte disponible y también se limpiará el combo box de selección de reportes. Por otro lado, al Registrar, se recorren los directorios de los sourcefile “registrando” una copia de los archivos encontrados en el repositorio, siempre y cuando cumplan con la validación del esquema. De esta manera todos los reportes disponibles (los del repositorio) ya estarán validados.

Todos estos directorios pueden ser modificados en su ubicación haciendo los cambios apropiados en el archivo de configuración.