Nombre del manual TODO SOBRE REPORTS 10G
TODO SOBRE REPORTS 10G
JUNIO 2006
rea de Integracin y Arquitectura de Aplicaciones Pgina: 1
Direccin de Anlisis y Mantenimiento de Aplicaciones y Desarrollos Institucionales
Subdireccin General de Desarrollo, Tecnologa e Infraestructuras
Nombre del manual TODO SOBRE REPORTS 10G
1 TABLA DE CONTENIDO
1 TABLA DE CONTENIDO..............................................................................2
2 APARTADO LANZAMIENTO Y VISUALIZACIN DE INFORMES CON
REPORT BUILDER..............................................................................................3
3 VISUALIZACIN DE INFORMES................................................................4
4 FICHERO .INI DE LA APLICACIN............................................................6
5 (ADMINISTRACIN) DISTRIBUCIN DE TRABAJOS EN DISTINTAS
MQUINAS..........................................................................................................7
6 PROCEDIMIENTO DE LANZAMIENTO DE REPORTS CON ELECCIN
DEL FORMATO DEL FICHERO DE SALIDA EJECUTAR_REPORT_TIPO......8
6.1 Parmetros:..................................................................................................8
6.2 En la construccin del Report para Salidas con tipo CSV, XLS y TXT.....8
6.3 En la construccin del Report para salida XML........................................9
7 COLAS DE LANZAMIENTO DE REPORTS DESDE FORMS 10G..........10
8 DISEO DE REPORT CON SALIDA EN PDF...........................................11
9 SEGUIMIENTO DE LA EJECUCIN DE INFORMES REPORTBUILDER
EN WEB..............................................................................................................12
rea de Integracin y Arquitectura de Aplicaciones Pgina: 2
Direccin de Anlisis y Mantenimiento de Aplicaciones y Desarrollos Institucionales
Subdireccin General de Desarrollo, Tecnologa e Infraestructuras
Nombre del manual TODO SOBRE REPORTS 10G
2 APARTADO LANZAMIENTO Y VISUALIZACIN DE
INFORMES CON REPORT BUILDER
Se ha establecido un mtodo comn para la ejecucin y posterior visualizacin
de Informes utilizando la herramienta de Report de Oracle ReportBuilder.
Inicialmente hay que distinguir entre los dos tipos de ejecucin bajo los cuales
actualmente pueden correr nuestras aplicaciones:
- Web
- Cliente/Servidor Windows (solo para Formsv6i)
y que debe quedar correctamente establecido en el fichero de .ini de la
aplicacin mediante la utilizacin del siguiente parmetro:
TipoEjecucion=Web / Windows (con uno de estos dos valores)
Ejecucin de informes .-
se realizar de igual modo independientemente del mbito en el que nos
encontremos mediante la llamada al procedimiento EJECUTAR_REPORT con
los siguientes parmetros:
EJECUTAR_REPORT ( WReport in varchar2, WDes_Report in
varchar2,
WParam in varchar2, WCola in varchar2 );
WReport .- Nombre del objeto ReportObject
WDes_Report.- breve descripcin del informe
WParam.- parmetros que se enviarn para la ejecucin del report (a
nivel de REPORT_OTHER)
Por ejemplo aquellos parmetros tipo filtro enviados en tiempo de
ejecucin.
WCola .- nombre de la cola bajo la cual se lanzar el report
Las colas han de estar definidas en el fichero .ini de la aplicacin
como por ejem.
Cola1=ReportsServer1
Cola2=ReportsServer2
por defecto (si el valor es NULL) este parmetro tomar siempre
el valor de Cola1'
Nota: se ha observado que se producen problemas al ejecutar los Reports
bajo Web si en el Forms -Parmetros del Informe no se rellena el param.
Servidor de Informes con algn valor (el que sea) ya que el Servidor de
informes a utilizar, como se explica anteriormente, se recoge del parametro
Wcola en la ejecucin del Report mediante el procedimiento
EJECUTAR_REPORT.
rea de Integracin y Arquitectura de Aplicaciones Pgina: 3
Direccin de Anlisis y Mantenimiento de Aplicaciones y Desarrollos Institucionales
Subdireccin General de Desarrollo, Tecnologa e Infraestructuras
Nombre del manual TODO SOBRE REPORTS 10G
3 VISUALIZACIN DE INFORMES
Una vez lanzado el report, para la visualizacin del informe, hay que distinguir
si estamos realizando la ejecucin en entorno Web o Windows.
Web.-
el report que acabamos de lanzar queda registrado en la tabla
F60_REPORTS para el usuario que ha realizado la peticin (este
usuario podr consultar sus informes y los de los usuarios que
pertenezcan al mismo perfil dentro de la aplicacin).
El tipo de fichero generado en Web es el estndar PDF y con nombre
generado automticamente por el procedimiento como
YYYYMMDD_HH24MISS.pdf
Para la visualizacin del mismo se ha creado un form LIS_REP.fmx que
permite consultar / borrar / actualizar informes automticamente de
modo autnomo en base al estado actual en el que se encuentren los
mismos.
El usuario tan slo podr visualizar aquellos informes cuyo estado sea
finalizado (o probablemente finalizado por una cada de la mquina etc..)
para lo cual se dispone de un campo Estado del Informe en el que se
especifica si se encuentra encolado, finalizado, probablemente
finalizado, en error etc.
Pantalla LIS_REP.fmx :
rea de Integracin y Arquitectura de Aplicaciones Pgina: 4
Direccin de Anlisis y Mantenimiento de Aplicaciones y Desarrollos Institucionales
Subdireccin General de Desarrollo, Tecnologa e Infraestructuras
Nombre del manual TODO SOBRE REPORTS 10G
Windows.-
en este tipo de ejecucin nada ms solicitar la ejecucin del informe se
procede a realizar una visualizacin del mismo por pantalla desde donde
el usuario decidir si lo imprime o no.
rea de Integracin y Arquitectura de Aplicaciones Pgina: 5
Direccin de Anlisis y Mantenimiento de Aplicaciones y Desarrollos Institucionales
Subdireccin General de Desarrollo, Tecnologa e Infraestructuras
Nombre del manual TODO SOBRE REPORTS 10G
4 FICHERO .INI DE LA APLICACIN
Para utilizar lo anteriormente comentado es necesario que el fichero de .ini de
la aplicacin contenga los siguientes parmetros:
;*** Tipo de ejecucin de la aplicacin, posibles valores Web / Windows
TipoEjecucion=Web
;*** Path en donde se ubicarn los ficheros PDF generados
Report_cache=d:\icm\web\web_reps\
;*** Path virtual para la localizacin de los ficheros PDF generados
Report_mapping=http://nticmdes01/web_reps/
;*** Colas de ejecucin de Reports que se correspondern con los
Servidores de Reports existentes
Cola1=REPLIGERAD01
Cola2=REPMEDIANAD01
En cuanto al procedimiento de ejecucin de reports EJECUTAR_REPORT
como al form de visualizacin de los mismos LIS_REP.fmx se encuentran
disponibles en:
Proc: EJECUTAR_REPORT ICM_PLL.pll salvada en base de datos.
Form: LIS_REP.fmx Mdulo salvado en base de datos.
para poderlos copiar en vuestros directorios y probar las distintas opciones
implementadas.
5 (ADMINISTRACIN) DISTRIBUCIN DE TRABAJOS EN
DISTINTAS MQUINAS
rea de Integracin y Arquitectura de Aplicaciones Pgina: 6
Direccin de Anlisis y Mantenimiento de Aplicaciones y Desarrollos Institucionales
Subdireccin General de Desarrollo, Tecnologa e Infraestructuras
Nombre del manual TODO SOBRE REPORTS 10G
Para la distribucin de los servidores de reports en distintas mquinas se
configurar atraves del fichero:
tnsnames.ora del equipo NT en donde se encuentre el FormsServer del
siguiente modo:
# Servicio sobre la propia mquina
ReportServer,ReportServer.world=(ADDRESS=(PROTOCOL=tcp)
(HOST=NTICMDES01)(PORT=1949))
# Servicio sobre mquina remota (detecta el servicio en NTICMPRO04 atraves
del puerto)
# (es necesario llevar los *.rep a la mquina remota NTICMPRO04)
ReportServer4,ReportServer4.world=(ADDRESS=(PROTOCOL=tcp)
(HOST=NTICMPRO04)(PORT=1949))
y posteriomente modificando simplemente el fichero de .ini de cada aplicacin
podemos distribuir los reports.
Para ejecuciones en la propia mquina:
Cola1=ReportServer
o bien para ejecuciones en la mquina remota:
Cola1=ReportServer4
rea de Integracin y Arquitectura de Aplicaciones Pgina: 7
Direccin de Anlisis y Mantenimiento de Aplicaciones y Desarrollos Institucionales
Subdireccin General de Desarrollo, Tecnologa e Infraestructuras
Nombre del manual TODO SOBRE REPORTS 10G
6 PROCEDIMIENTO DE LANZAMIENTO DE REPORTS CON
ELECCIN DEL FORMATO DEL FICHERO DE SALIDA
EJECUTAR_REPORT_TIPO
En la librera ICM_PLL est disponible el Procedimiento
EJECUTAR_REPORT_TIPO para Forms 10g
6.1 Parmetros:
WREPORT: Nombre del objeto ReportObject
WDES_REPORT: Descripcin del Report (max. varchar2(60) )
WPARAM: Otros parmetros de ejecucin
WCOLA: Nombre de cola (ReportServer) por la que se lanzar el Report
WTIPO : Formato del Fichero de Salida. Valores Vlidos:
CSV (Excel - Texto)
XLS (Excel)
RTF (Word)
TXT (Texto) (Por defecto si no indicamos el delimitador utlizar
una tabulacin como delimitador)
XML
HTML
PDF
WDELIMITER : Slamente se tiene en cuenta con Tipo TXT , es el
separador de campos si va a Nulo por defecto utiliza el tabulador
WCELLWRAPPER: Slamente se tiene en cuenta con Tipo TXT, engloba
el valor del campo con el carcter indicado
Z_FICH_OUT: Es un parmetro de Salida y devuelve el Nombre del
Fichero generado
WVISUAL_MENS: Valores Vlidos
S - Visualiza el Mensaje de Lanzado report a Cola de
Impresin
N - No visualiza el Mensaje
Si se desea se puede omitir en la llamada al procedimiento ste
parmetro, Tiene valor por defect S
6.2 En la construccin del Report para Salidas con tipo CSV,
XLS y TXT
1.- Crear en el Modelo de Datos los Objetos Sql en orden a como tienen que
salir en el informe, es decir:
- Primero un Objeto Sql cuyo grupo podemos nombrar como TITULO,
con lo siguiente: SELECT NULL FROM DUAL , en el campo Null en las
propiedad Etiqueta XML indicaremos el Ttulo del Informe, aadir una lnea a
rea de Integracin y Arquitectura de Aplicaciones Pgina: 8
Direccin de Anlisis y Mantenimiento de Aplicaciones y Desarrollos Institucionales
Subdireccin General de Desarrollo, Tecnologa e Infraestructuras
Nombre del manual TODO SOBRE REPORTS 10G
continuacin con el valor que hemos puesto en ste caso en blanco ya que
hemos puesto Null, si se quiere se puede poner otro valor SELECT 'A' FROM
DUAL WHERE ROWNUM=0 en el campo A en la propiedad Etiqueta XML
indicaremos el Ttulo del Informe, aqu no aadir ninguna lnea depus del
ttulo
- Segundo un Objeto Sql con la Select de Datos Necesarios
- Sucesisvos Objetos Sql con la Select de Datos Necesarios
Con sto conseguimos que en el Informe resultante los datos aparezcan en el
orden que hemos definido.
Si no lo hacemos as, saldrn los datos con otro Orden, aunque en el Modelo
de Diseo aparezca en el orden correcto
2.- No es necesario crear un Modelo de Diseo. ya que omite todo lo que
contenga
Para indicar el Nombre de los campos en el Informe , tendremos que ir al
Modelo de Datos posicionarnos en las propiedades del campo y en la
Propiedad Etiqueta XML indicaremos el Nombre de Campo que queramos
3.- Tanto a nivel de campo de Modelo de Datos como de Grupo podemos
utlizar la propiedad Excluir de Xml a Si para no visualizar los campos de un
objeto Sql
Observacin: En el mantenimiento del Report hay que tener en cuenta que al
borrar o crear nuevos objetos sql puede variar el Orden de los datos.
6.3 En la construccin del Report para salida XML
No es necesario crear un Modelo de Diseo, ya que omite todo lo que contenga
rea de Integracin y Arquitectura de Aplicaciones Pgina: 9
Direccin de Anlisis y Mantenimiento de Aplicaciones y Desarrollos Institucionales
Subdireccin General de Desarrollo, Tecnologa e Infraestructuras
Nombre del manual TODO SOBRE REPORTS 10G
7 COLAS DE LANZAMIENTO DE REPORTS DESDE FORMS
10G
Debido a la variedad de Reports que se pueden ejecutar sobre un servidor de
Reports -ReportServer- bajo Web se ha de tener en cuenta desde la fase de
desarrollo los recursos que se van a utilizar para su posterior ejecucin.
Para controlar desde produccin la carga y balanceo de los distintos Reports
utilizarn las colas de lanzamiento que actualmente se definen en el fichero de
ini de la aplicacin:
Cola1=REPLIGERAD01
Cola2=REPMEDIANAD01
Cola3=REPPESADAD01
Cola4= REPESPECIALD01
Para realizar una correcta utilizacin del sistema paso a detallar las distintas
colas que se crearn y el uso de las mismas en funcin del trabajo a realizar:
Cola1.- Listados cortos de ejecucin inmediata.
Cola2.- Listados grandes de ejecucin inmediata.
Cola3.- Impresin controlada de trabajos en batch.
Cola4.- Otro tipo de trabajos especiales que requieran de especial
supervisin.
De este modo conseguiremos que los trabajos se ejecuten en las mejores
condiciones para todos.
rea de Integracin y Arquitectura de Aplicaciones Pgina: 10
Direccin de Anlisis y Mantenimiento de Aplicaciones y Desarrollos Institucionales
Subdireccin General de Desarrollo, Tecnologa e Infraestructuras
Nombre del manual TODO SOBRE REPORTS 10G
8 DISEO DE REPORT CON SALIDA EN PDF
En el diseo de reports se ha de tener en cuenta las siguientes
consideraciones para que el listado se presente con un tamao estandar
dependiendo de la orientacin a elegir:
Unidad de medida: Centmetros
En las distintas secciones del report [Cabecera, Principal, Cola]:
Listado apaisado (orientacin Landscape):
Ancho: 29.7 cm
Altura: 21 cm
Listado vertical (orientacin Portrait):
Ancho: 21 cm
Altura: 29.7 cm
Como visor estandar de PDF's se aconseja utilizar el Acrobat v4.05c (en
adelante)
rea de Integracin y Arquitectura de Aplicaciones Pgina: 11
Direccin de Anlisis y Mantenimiento de Aplicaciones y Desarrollos Institucionales
Subdireccin General de Desarrollo, Tecnologa e Infraestructuras
Nombre del manual TODO SOBRE REPORTS 10G
9 SEGUIMIENTO DE LA EJECUCIN DE INFORMES
REPORTBUILDER EN WEB
Mediante esta utilidad se permite visualizar el resultado de la ejecucin de
informes bajo ReportBuilder en Web, como ya sabis hasta ahora cuando
necesitabais conocer el log de la ejecucin de alguno de estos nos llamabais y
nosotros conectndonos va consola os comentbamos el resultado, hasta
ahora este era el nico modo de obtener esta informacin de log ya que el
servidor de report almacena esta informacin en memoria y tan slo es
accesible desde el mdulo de Oracle Reports Queue Manager va conexin a
la consola de la mquina donde este corriendo el citado servidor.
Pues bien ahora con el siguiente servlet ubicado en la URL:
http://icmweb01/reportlog
se posibilita la obtencin de los logs de cualquier ejecucin de informes
lanzada en el servidor de desarrollo, la informacin que podemos consultar es
muy valiosa ya que por supuesto adems del error que se halla podido producir
tendremos acceso a horas de entrada en cola, de ejecucin, de fin, tambin
podemos verificar los parmetros que se pasan al informe etc.
Inicialmente se presenta una pantalla en la que podemos filtrar por distintos
criterios:
- Base de datos
- Aplicacin
- Fechas de ejecucin (desde-hasta)
Actualmente el mbito de consulta de este servlet es para las peticiones
realizadas al servidor de reports de desarrollo, ms adelante esta utilidad se
pondr disponible para los servidores de produccin.
rea de Integracin y Arquitectura de Aplicaciones Pgina: 12
Direccin de Anlisis y Mantenimiento de Aplicaciones y Desarrollos Institucionales
Subdireccin General de Desarrollo, Tecnologa e Infraestructuras
Nombre del manual TODO SOBRE REPORTS 10G
Una vez establecidos los criterios de bsqueda, obtenemos una lista de los
informes ejecutados con las caractersticas de los mismos.
rea de Integracin y Arquitectura de Aplicaciones Pgina: 13
Direccin de Anlisis y Mantenimiento de Aplicaciones y Desarrollos Institucionales
Subdireccin General de Desarrollo, Tecnologa e Infraestructuras
Nombre del manual TODO SOBRE REPORTS 10G
aparecen en otro color aquellos informes que han finalizado en error
Podemos acceder a ver un informe en concreto ms a detalle mediante el
enlace sobre el icono existen para cada uno de ellos.
rea de Integracin y Arquitectura de Aplicaciones Pgina: 14
Direccin de Anlisis y Mantenimiento de Aplicaciones y Desarrollos Institucionales
Subdireccin General de Desarrollo, Tecnologa e Infraestructuras
