Funciones adicionales del manejador de informes de EGL

EGL tiene varias funciones ReportLib que aumentan la capacidad del manejador de informes. El archivo de diseño de JasperReport puede invocar un método Java predefinido adicional, getDataSource().

JasperReports distingue entre tres tipos de entidades que el motor de informes evalúa durante la ejecución:

Puede invocar cualquiera de las funciones de ReportLib de las secciones que siguen desde el manejador de informes. La función getDataSource(), que no pertenece a ReportLib, debe invocarse desde el código fuente del archivo de diseño XML.

Función para obtener parámetros de informe

Función Finalidad
getReportParameter (parámetro String in) Devuelve el valor del parámetro especificado del informe que se está cumplimentando. El valor devuelto es de tipo ANY.

Funciones para establecer y obtener variables de informe

Estas funciones proporcionan acceso durante la ejecución a variables utilizadas por el informe.

Función Finalidad
getReportVariableValue (variable String in) Devuelve el valor de la variable especificada del informe que se está cumplimentando. El valor devuelto es de tipo ANY.
setReportVariableValue (variable String in, valor Any in) Asigna el valor a la variable especificada.

Función para obtener valores de campo

Función Finalidad
getFieldValue (nombreCampo String in) Devuelve el valor del campo especificado para la fila que se está procesando actualmente. El valor devuelto es de tipo ANY.

Funciones para almacenar o recuperar datos para subinformes

Un subinforme es un informe que se llama desde otro informe. Para pasar datos de informe a un subinforme, el manejador de informes guarda primero la información mediante la función addReportData(). El motor de JasperReports puede recuperar estos datos por medio de getDataSource(), que se describe más adelante en este tema. Para recuperar datos guardados anteriormente dentro del manejador de informes, utilice la función equivalente getReportData().

Función Finalidad
addReportData (rd ReportData in, dataID String in) Asocia datos (almacenados en una variable de tipo ReportData) con el nombre dataID.
getReportData (dataID String in) Recupera datos que el usuario ha almacenado anteriormente bajo dataID mediante addReportData(). getReportData() devuelve un valor de tipo ReportData.

Métodos Java disponibles para el archivo de diseño de informes

Para acceder a los datos que va a pasar a un subinforme, llame al método getDataSource() de la biblioteca de informes de EGL desde el archivo de diseño de informe XML.

Función Finalidad
getDataSource (dataID String in)

Dentro de un archivo de diseño de informe, recupera datos que el usuario ha almacenado anteriormente bajo dataID cuando ha invocado addReportData() en el manejador de informes.

getDataSource() devuelve datos en formato interno. Debe convertir temporalmente el valor de retorno como JRDataSource para que el subinforme pueda utilizar esos datos.

Para ver ejemplos sobre cómo utilizar las funciones descritas en este tema, consulte el apartado Crear un manejador de informes de EGL.

Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.