JODReports - Mini How to

Después de hacer pruebas con JODReports nos hemos quedado bastante asombrados de lo sencillo que es utilizar documentos ODT como plantillas para generar documentos desde java de forma que con JOOConvertes luego pasamos a pdf, en principio hemos probado casi de todo:

Sustituir variables.
Iteraciones sobre listas de objetos.
Evaluar condiciones para mostrar ciertas partes de código.
Incluir imágenes.
Exportar a pdf.
...

Nos surge un pequeño problema cuando tenemos que anexar documentos pdf dentro del informe generado, esto lo seguiremos con itext, así pues, creo que hemos dado con una solución que optimizará muy mucho el desarrollo de cartas, documentos, informes... en nuestros sistemas.

Os dejo un mini "How to" que me ha pasado un compañero:

1. Requisitos mínimos
Java Runtime Enviroment 5.0 o superior.
Tomcat 4.1 o superior.
Librería jodreports_2.3.0
(Debe ser añadida sólo como libería del proyecto y no como librería de tomcat)
OpenOffice para realizar las plantillas.

2. Sustitución de variablesPara sustituir variables en nuestra plantilla odt, nos bastará con las siguientes líneas de código, utilizando el Map para introducir los valores de sustitución de las variables definidas en nuestras plantillas.

DocumentTemplateFactory documentTemplateFactory =
new DocumentTemplateFactory();
DocumentTemplate template =
documentTemplateFactory.getTemplate(new File(ruta_fisica_plantilla/nombreFichero.odt));
Map data = new HashMap();
data.put("nombre_variable", "valor_variable");
// añadir todas las variables a cambiar
// ...
template.createDocument(data,
new FileOutputStream(ruta_fisica_fichero_guardar//nombreFichero-final.odt));

Las variables se introducirán en la plantilla con la siguiente sintaxis.
${nombre_variable}

3. Rellenar una tabla
Para insertar registros sobre una tabla, nos bastará con el código anterior, con la salvedad de que en lugar de insertar un valor a la variable, se le asignará un list.

La forma de introducir las variables en la plantilla será la siguiente:

3.1. Insertaremos una tabla en nuestra plantilla, con 2 filas si tenemos cabecera o 1 si no la tenemos.
3.2. En la primera fila, posterior a nuestra cabecera si existe, insertaremos las nombres de variables que necesitemos y queramos mostrar en cada celda.
3.3. Cerraremos nuestra plantilla
3.4. Abriremos el documento odt con winrar y extraemos el fichero content.xml para realizar unas pequeñas modificaciones.
3.5. Buscamos la tabla en el fichero content.xml y en antes de definir el table-row donde se encuentran las variables definidas por nosotros, añadimos las siguiente sentencia:
[#list nombre_list_varable as variable]3.6 Cuando acaba la definición del table-row, cerramos nuestra sentencia list, con:
[/#list]
3.7. Aplicarmos los cambios y sustituimos el content.xml del odt, por el que hemos modificado.

4. Sustituir imágenes
Para sustituir imágenes en nuestra plantilla odt, debemos definir un ImageSource en nuestra clase y añadirlo a nuestro map de sustitución con el nombre de la variable definida en nuestra plantilla. Un ImageSource se puede definir de las siguientes maneras:
ImageSource imagen =
new RenderedImageSource(ImageIO.read(new File(ruta_fisica_imagen)));
ImageSource imagen =
new FileImageSource(ruta_fisica_imagen);
ImageSource imagen =
new ClasspathImageSource(ruta_fisica_imagen);

Una vez insertada una imagen en nuestra plantilla (para luego ser sustituida), debemos editar su nombre por: jooscript.image(nombre_variable)

5. Sentencia if / if-elseEstas nos permitirán sobre todo mostrar o ocultar texto de la plantilla en función de determinadas condiciones. La sintaxis es la siguiente:

[#if valor1 = valor2]
bloque de informacion
[#/if]
[#if valor1 = valor2]bloque de informacion
[#else]bloque de información
[#/if]

Saludos reportiaaaaaaaaaaaanos !!

Texto del mini how to: Roger Moore

Actualización del 13 de Mayo de 2013

Os dejamos un nuevo tutorial avanzado con insercción de imágenes dinámicas, tablas....

JODReports - Tutorial práctico