INFORMES CON

REPORTS BUILBER
Versin 1.0

rea de Aplicaciones Especiales y Arquitectura

Software

Informes con Report Builder

Manual del desarrollador
Hoja de Control

Ttulo

Informes con Reports Builder

Documento de Referencia
Responsable

rea de Aplicaciones Especiales y Arquitectura Software

Versin

1.0

Fecha Versin

28/01/2013

Registro de Cambios
Versin
1.0

Causa del Cambio

Versin inicial del documento
que proviene del documento
Todo sobre Reports10g

Responsable del Cambio

rea de Integracin y Arquitectura
de Aplicaciones

1.1

Pgina 2 de 9

Fecha del Cambio

Informes con Report Builder

Manual del desarrollador

ndice

1.

INTRODUCCIN ...................................................................................................................................................4
1.1
1.2

AUDIENCIA OBJETIVO .................................................................................................................................4

CONOCIMIENTOS PREVIOS ........................................................................................................................4

DISEO DE REPORT ...........................................................................................................................................4

2.1

SALIDA PDF .......................................................................................................................................................4

2.2

SALIDA CSV, XLS Y TXT ................................................................................................................................4

2.3

SALIDA XML .....................................................................................................................................................5

EJECUCIN DE INFORMES DE REPORT BUILDER ...................................................................................5

EJECUCION DE REPORTS POR TIPO .............................................................................................................6

VISUALIZACIN DE INFORMES .....................................................................................................................7

FICHERO .INI DE LA APLICACIN.................................................................................................................8

(ADMINISTRACIN) DISTRIBUCIN DE TRABAJOS EN DISTINTAS MQUINAS EN REPORTS 69

COLAS DE EJECUCION ......................................................................................................................................9

Pgina 3 de 9

Informes con Report Builder

Manual del desarrollador
1. INTRODUCCIN
Documentacin acerca de la utilizacin de Report Builder en las aplicaciones de la Comunidad de Madrid.

1.1

AUDIENCIA OBJETIVO

Este documento va dirigido a jefes de proyecto, analistas y desarrolladores de proyectos que utilicen Forms
v6 o Forms v10.

1.2

CONOCIMIENTOS PREVIOS

Para un completo entendimiento del documento, el lector deber tener conocimientos previos sobre las
siguientes tecnologas:
Oracle Forms
Report Builder

2
2.1

DISEO DE REPORT
SALIDA 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)
2.2

SALIDA CSV, XLS y TXT

En la construccin de reports para salida csv, xls y txt hay que:

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 continuacin con el valor que hemos puesto en ste caso en blanco ya que hemos

Pgina 4 de 9

Informes con Report Builder

Manual del desarrollador
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.

2.3

SALIDA XML

En la construccin para salida XML no es necesario crear un Modelo de Diseo, ya que omite todo lo que
contenga

EJECUCIN DE INFORMES DE 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)

Pgina 5 de 9

Informes con Report Builder

Manual del desarrollador

La ejecucin 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.

EJECUCION DE REPORTS POR TIPO

En la librera ICM_PLL est disponible el Procedimiento EJECUTAR_REPORT_TIPO para Forms 10g

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

Pgina 6 de 9

Informes con Report Builder

Manual del desarrollador
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

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 :

Pgina 7 de 9

Informes con Report Builder

Manual del desarrollador

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.

FICHERO .INI DE LA APLICACIN

En el fichero .ini de la aplicacin se incluye configuracin especfica para Report Builder necesaria para el
procedimiento y form mostrados anteriormente

[ReportBuilder]
; *** Parmetros vlidos solamente para Reports bajo TipoEjecucion=Web
;*** Path en donde se ubicarn los ficheros PDF generados
Report_cache=\\cifs04v3002\DESA_WEB\web_reps\
;*** Path virtual para la localizacin de los ficheros PDF generados
Report_mapping=/web_reps/
;*** Colas de ejecucin de Reports que se correspondern con los Servidores de Reports existentes
Cola1=REPLIGERAD01
;Cola2=REPMEDIANAD01
; *** Para realizar impresin directa de Pdf's desde el mdulo LIS_REP.fmx
Impresion_pdf=/impresionpdf/cgi-bin/ImpresionPDF.exe

Pgina 8 de 9

Informes con Report Builder

Manual del desarrollador

(ADMINISTRACIN) DISTRIBUCIN DE TRABAJOS EN DISTINTAS MQUINAS en REPORTS 6

Para la distribucin de los servidores de reports en distintas mquinas se configurar a travs 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

COLAS DE EJECUCION

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.

Pgina 9 de 9