Visión general del proceso de creación de informes de EGL

En este tema se proporciona una visión general de los procesos para crear y generar un informe para un proyecto EGL. Encontrará más detalles acerca de estos procesos en los temas de ayuda de las tareas de informes de EGL.

Para crear un informe, puede completar los tres procesos descritos a continuación. Dos de estos procesos, la creación de un diseño XML y la escritura de código para controlar un informe, son obligatorios. Un tercer proceso, la creación de un manejador de informes, es opcional. No es necesario que realice estos procesos en el orden descrito. Por ejemplo, si desea un manejador de informes, puede crearlo antes de crear un documento de diseño XML o pueden trabajar simultáneamente en la creación de un documento de diseño y un manejador de informes, con las excepciones descritas en los párrafos de "Interrelaciones de código entre el manejador de informes y el documento de diseño XML" del paso 2.

No puede generar un informe si no tiene un documento de diseño XML ni el código para controlar el informe.

Los tres procesos que hay que realizar para crear un informe son:
  1. Crear un documento de diseño XML para especificar información de diseño para el informe. Puede crear este documento de cualquiera de las formas siguientes:
    • Utilizando una herramienta de diseño de JasperReport de terceros (como por ejemplo Jasper Assistant o iReports).
    • Utilizando un editor de texto para escribir información de diseño XML de Jasper en un archivo de texto nuevo.

    El documento de diseño XML debe tener una extensión .jrxml. Si el archivo creado no tiene esta extensión, redenomínelo como archivo .jrxml. Además, asegúrese de que el documento de diseño XML esté en el mismo paquete EGL que contendrá el manejador de informes EGL y los archivos de código de invocación de informe.

    El archivo .jrxml creado se compilará en un archivo .jasper. Si no crea un archivo .jrxml nuevo, debe importar un archivo .jasper que se haya compilado con anterioridad.

  2. Si desea utilizar un manejador de informes que proporciona la lógica para manejar sucesos durante la confección del informe, puede crear un manejador de informes de cualquiera de las formas siguientes:
    • Utilizando el asistente de manejador de informes de EGL para especificar información para el manejador de informes.
    • Creando un archivo fuente EGL nuevo e insertando un manejador mediante la plantilla de manejador de informes o especificando manualmente el código del manejador.
    Interrelaciones de código entre el manejador de informes y el documento de diseño XML. En el archivo .jrxml, puede especificar la scriptletClass que hace referencia al archivo de manejador de informes generado por el manejador de informes de EGL. Tenga en cuenta lo siguiente:
    • Si el archivo .jrxml utiliza código Java generado por un manejador de informes, debe generar el manejador de informes antes de crear el archivo .jrxml.
    • Si cambia un manejador de informes, debe volver a compilar el archivo .jrxml.
    • Si necesita resolver cualesquiera errores de compilación en el archivo .jrxml o desea volver a compilar el archivo .jasper después de hacer cambios en un manejador de informes, debe modificar el archivo .jrxml y guardarlo.
  3. Utilice las funciones de biblioteca de informes de EGL para escribir código de invocación de informe en el proyecto EGL. Puede utilizar el asistente Componente de programa EGL al crear código de invocación de informes.

Importante: debe dar nombres de archivo al manejador de informes y al código de invocación de informe que san distintos del nombre del documento de diseño XML. Si no lo hace, al compilar el archivo de diseño se sobreescribirá el código Java. Para evitar problemas, llame a los manejadores de informes reportName_handler.egl y a los documentos de diseño XML reportName_XML.jrxml. Por ejemplo, puede llamar al informe abc_handler.egl y a los documentos de diseño abc_XML.jrxml. También debe asegurarse de que el archivo de diseño XML tenga un nombre exclusivo de forma que no entre en conflicto con ninguno de los archivos de programa EGL.

Para construir y generar un informes después de crear un documento de diseño XML, un manejador de informes si desea utilizar uno y código de invocación de informe, debe realizar los procesos siguientes:
  1. Construya el proyecto EGL seleccionando Proyecto > Construir todo.

    EGL genera automáticamente código Java a partir manejador de informes EGL y compila el documento de diseño XML (el archivo .jrxml) en un archivo .jasper.

  2. Ejecute el programa EGL que tiene el código de invocación de informe.

Una vez ejecutado el programa EGL, el programa JasperReports utilizado por EGL guarda automáticamente el informe generado en la ubicación especificada por reportDestinationFileName en el código de invocación de informes.

El programa JasperReports que genera el informe también genera y almacena un archivo .jprint que es un formato de archivo intermedio que se exporta al formato de informe final (.pdf, .html, .xml, .txt o .csv).

El programa puede reutilizar un .jprint para varias exportaciones.

La función exportReport() del código de invocación de informes hace que EGL exporte el informe en el formato especificado. Por ejemplo, el código siguientes hace que EGL exporte un informe en formato .pdf:
 reportLib.exportReport(myReport, ExportFormat.pdf);

EGL no renueva automáticamente informes exportados. Si cambia el diseño del informe o si los datos cambian, deberá volver a confeccionar y a exportar el informe.

Nota: Si suprime un informe de EGL, deberá eliminar todas las referencias al informe.

Conceptos relacionados
Visión general del informe EGL

Tareas relacionadas
Añadir un documento de diseño a un paquete
Utilizar plantillas de informe
Crear un manejador de informes de EGL
Crear manualmente un manejador de informes de EGL
Escribir código para controlar un informe
Ejecutar un informe
Exportar informes
Utilizar la ayuda de contenido en EGL

Consulta relacionada
Biblioteca de informes de EGL
Orígenes de datos
Manejador de informes de EGL

Condiciones de uso | Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.