Arquitectura General

Una de las principales cuestiones con Arai-Reportes era tener una arquitectura sencilla, que pudiera ser extendida de la manera mas simple posible.

Por eso la librería se divide en 2 partes basicas:

  • Endpoints
  • Clientes de backend

Arquitectura

Consideraciones minimas

Debido a que estaremos interfaceando por medio de una API Rest, es natural pensar que los reportes se encuentran en otra maquina, container o ambiente y eso influye en la forma en la cual construimos los mismos.

Es necesario entonces, tomar algunos recaudos al momento de generar el esqueleto del reporte, por ejemplo:

  • No incluir consultas SQL en el reporte
  • Los assets (imagenes u otros archivos) que use un reporte deben estar en el servidor de reportes
  • Enviar los datos al momento de generar el reporte o en un pedido previo

Tambien hay que tener en cuenta que

  • La instalación o actualización de reportes y sus recursos, se debe hacer al momento de instalar el sistema
  • Hay que minimizar la creación de reportes dinámicamente, lleva tiempo y pedidos extra a la API

Endpoints

Son la cara visible hacia los sistemas y aquellos por los cuales se realizará la interaccion con los reportes.

  • /carpetas: Este recurso nos permite obtener la carpeta inicial para nuestro proyecto y crear, verificar o borrar carpetas existentes.

  • /archivos: Este recurso nos permite subir distintos tipos de archivos al servidor, los cuales seran utilizados como assets por los reportes, por ejemplo una hoja de estilos, subreportes, archivos a incrustar, etc. Asi mismo tambien podemos obtener una lista o eliminarlos.

  • /imagenes: Este recurso similar al anterior nos permite hacer un tratamiento particular para operar sobre las imagenes.

  • /reportes: Este recurso concentra la mayor parte de la atencion, ya que permite crear, listar y eliminar reportes.. como asi tambien obtener un archivo de salida para el mismo en un formato especificado.

Clientes de backend

Los clientes de backend intentan desconectar a los Endpoints de los Servidores de Reportes, los cuales pueden ser accedidos segun el caso.

Cada cliente de backend deberá implementar la interfase clienteImpresionInterface, en caso de que algun metodo no existiera simplemente deberá devolver el valor vacio para el tipo apropiado, o bien lanzar una excepción para evitar la continuidad de la ejecución.

Por el momento se encuentra implementado:

  • cliente Jasper, el cual abarca las versiones JasperServer-CE entre las versiones 6.3 y 7.1.
← Instalación RápidaConfiguración →