Producir informes

A database without exporting facilities is of little use. Ghini lets you export your data in table format (open them in your spreadsheet editor of choice), as labels (to be printed or engraved), as html pages or pdf or postscript documents.

The Report Tool

You activate the Report Tool from the main menu: Tools‣Report. The Report Tools acts on a selection, so first select something, then start the Report Tool.

Report on the whole collection.

To produce a report on your whole plant collection, a shortcut would be from the home screen, to click on the Families: in use cell.

If your focus is more on the garden location than on taxonomy and accessions, you would click on the Locations: total cell.

Reports are produced by a report engine, making use of a report template. Ghini relies upon two different report engines (Mako & XSL), and offers several report templates, meant as usable examples.

Choose the report you need, specify parameters if required, and produce the report. Ghini will open the report in the associated application.

Configuring report templates, that’s a task for who installs and configures ghini at your institution. Basically, you create a template name, indicating the report engine and specifying the template. Configured templates are static, once configured you are not expected to alter them. Only the special **scratch** template can be modified on the fly.

The remainder of this page provides technical information and links regarding the formatter engines, and gives hints on writing report templates. Writing templates comes very close to writing a computer program, and that’s beyond the scope of this manual, but we have hints that will definitely be useful to the interested reader.

Uso del formateador de informes Mako

El formateador de informes Mako utiliza su propio idioma de plantilla para generar informes. Puede encontrar más información sobre el Mako y su lenguaje en makotemplates.org

El sistema de plantillas de Mako ya debería estar instalado en su equipo si está instalado Ghini.

Creación de informes con Mako es similar en lo que sería crear una página web desde una plantilla. Es mucho más simple que la Formatter(see below) XSL y debería ser relativamente fácil de crear plantilla para cualquier persona con un poco pero de experiencia de programación.

El generador de la plantilla produce archivos con la misma extensión que la plantilla. Por ejemplo, para generar una página HTML, el nombre de su plantilla debe ser algo como “report.html”. Si la plantilla generará un archivo de valor separado por comas, nombre la plantilla “report.csv”.

La plantilla va a recibir una variable llamada “valores” que contendrán la lista de valores en la búsqueda actual.

El tipo de cada valor en los “valores” será el mismo que el dominio de búsqueda utilizado en la consulta de búsqueda. Para más información sobre dominios de búsqueda ver: ref: “dominios de búsqueda”.

Si la consulta no tiene un dominio de búsqueda, los valores pueden ser de diferente tipo y la plantilla de Mako debe preparan para manejarlas.

Utilizar al formateador de informe XSL

El formateador XSL Informe requiere una XSL para el representador PDF para convertir los datos en un archivo PDF. Apache FOP es un XSL-> representador de PDF gratuito y de código abierto y es recomendado.

Si utiliza Linux, Apache FOP debe ser usando su gestor de paquetes instalable. En Debian/Ubuntu es instalable como “” fop”” en Synaptic o usando el siguiente comando:

apt-get install fop

Instalación de Apache FOP en Windows

Tienes dos opciones para la instalación de FOP en Windows. La forma más sencilla es descargar su instalador `ApacheFOP-0.95-1-setup.exe <http://code.google.com/p/apache-fop-installer/downloads/detail?name=ApacheFOP-0.95-1-setup.exe&can=2&q=#makechanges >`_.

En alternativa, puede descargar el fichero. Tras descomprimir el fichero debe añadir el directorio extraído a su variable de entorno PATH.