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

Para crear un informe, realice los tres procesos descritos a continuación: EGL no requiere la realización de estas tareas en un orden determinado (con las excepciones descritas en los párrafos dedicados a "Interrelaciones de código entre el manejador de informes y el código fuente XML" del paso 2 que figura más adelante). Si desea utilizar un manejador de informes, puede crearlo antes de crear un archivo de diseño JasperReports o puede crear un manejador de informes y el código fuente XML para el archivo de diseño simultáneamente.

No puede generar un informe si no tiene un archivo de diseño JasperReports compilado y el código para controlar el informe.

Utilice las funciones ReportLib de EGL para escribir código de invocación de informes en el proyecto EGL. Puede utilizar el asistente Componente de programa EGL al crear código de invocación de informes.

Para crear y rellenar un informe después de crear un archivo de diseño de código fuente 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 (si ha creado uno) y a partir del controlador de informes de EGL. (EGL compila automáticamente el archivo de diseño XML en un archivo .jasper cada vez que se guarda. Puede obligar a EGL a recompilar el archivo de diseño XML seleccionando Proyecto > Borrar).

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

A medida que se ejecuta el programa EGL, el programa JasperReports utilizado por EGL rellena primero y luego almacena un archivo .jrprint. Este archivo utiliza un formato de archivo intermedio que, a continuación, el programa exportará al formato de informe final (.pdf, .html, .xml, .txt o .csv).

El programa JasperReports guarda el informe rellenado en la ubicación especificada por reportDestinationFileName en el código de invocación de informes. El programa puede reutilizar un archivo .jrprint para varias exportaciones emparejando las ubicaciones de archivo adecuadas con funciones exportReport() en el código del controlador de informes. Por ejemplo, el código siguiente crea un informe en formato .pdf:
myReport.ReportExportFile = "C:\\temp\\my_report.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 ejecutar el controlador de informes.

Conceptos relacionados
Visión general de los informes de EGL

Tareas relacionadas
Crear un manejador de informes de EGL
Crear el archivo de diseño de informe
Exportar informes
Generar archivos para un informe y ejecutarlo
Utilizar plantillas de informe
Utilizar las plantillas EGL con la ayuda de contenido
Escribir código para controlar un informe

Consulta relacionada
Biblioteca ReportLib de EGL
Manejador de informes de EGL

Archivo de diseño JasperReports

Cree o importe un archivo de diseño JasperReports (extensión jasper). Para crear el archivo de diseño, compile un archivo fuente XML que especifique la información de diseño del informe. Puede crear este archivo fuente de dos formas:
  • Utilice una herramienta de diseño JasperReports de terceros (como por ejemplo JasperAssistant o iReport).
  • Utilice un editor de texto para escribir información de diseño XML de Jasper en un archivo de texto nuevo.

El archivo fuente XML debe tener la extensión .jrxml. Asegúrese de que el documento de diseño XML esté en el mismo paquete EGL que contendrá los archivos de código del controlador de informes y el manejador de informes de EGL (si utiliza uno).

El entorno de ejecución de EGL compilará automáticamente un archivo fuente XML válido en un archivo de diseño JasperReports cada vez que guarde el código fuente en disco (suponiendo que tenga el compilador javac en la vía de acceso de ejecución). Si no crea un archivo .jrxml nuevo, debe importar un archivo .jasper que se haya compilado con anterioridad.

Controlador de informes

Manejador de informes opcional

Si desea utilizar un manejador de informes que proporcione la lógica para manejar eventos durante la confección del informe, puede crear uno de cualquiera de las formas siguientes:
  • Utilice el asistente de manejador de informes de EGL para especificar información para el manejador de informes.
  • Cree un archivo fuente EGL nuevo e inserte un manejador mediante la plantilla de manejador de informes o especifique manualmente el código del manejador.
Interrelaciones de código entre el manejador de informes y el código fuente 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, debe modificar el archivo .jrxml y guardarlo. Si necesita volver a compilar el archivo .jasper después de hacer cambios en un manejador de informes, debe forzar una recompilación seleccionando Proyecto > Borrar.
Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.