INFORMES CON REPORTS BUILBER

Transcripción

1 INFORMES CON REPORTS BUILBER Versión 1.0 Área de Aplicaciones Especiales y Arquitectura Software

2 Hoja de Control Título Documento de Referencia Responsable Informes con Reports Builder Área de Aplicaciones Especiales y Arquitectura Software Versión 1.0 Fecha Versión 28/01/2013 Registro de Cambios Versión Causa del Cambio Responsable del Cambio Fecha del Cambio Versión inicial del documento que proviene del documento Todo sobre Reports10g Área de Integración y Arquitectura de Aplicaciones Página 2 de 9

3 Índice 1. INTRODUCCIÓN AUDIENCIA OBJETIVO CONOCIMIENTOS PREVIOS DISEÑO DE REPORT SALIDA PDF SALIDA CSV, XLS Y TXT SALIDA XML EJECUCIÓN DE INFORMES DE REPORT BUILDER EJECUCION DE REPORTS POR TIPO VISUALIZACIÓN DE INFORMES FICHERO.INI DE LA APLICACIÓN (ADMINISTRACIÓN) DISTRIBUCIÓN DE TRABAJOS EN DISTINTAS MÁQUINAS EN REPORTS 69 8 COLAS DE EJECUCION... 9 Página 3 de 9

4 1. INTRODUCCIÓN Documentación acerca de la utilización 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 v CONOCIMIENTOS PREVIOS Para un completo entendimiento del documento, el lector deberá tener conocimientos previos sobre las siguientes tecnologías: Oracle Forms Report Builder 2 DISEÑO DE REPORT 2.1 SALIDA PDF En el diseño de reports se ha de tener en cuenta las siguientes consideraciones para que el listado se presente con un tamaño estandar dependiendo de la orientación a elegir: Unidad de medida: Centímetros En las distintas secciones del report [Cabecera, Principal, Cola]: Listado apaisado (orientación Landscape): Ancho: 29.7 cm Altura: 21 cm Listado vertical (orientación 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 construcción 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 Título del Informe, añadirá una línea a continuación con el valor que hemos puesto en éste caso en blanco ya que hemos Página 4 de 9

5 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 Título del Informe, aquí no añadirá ninguna línea depués del título - 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í, saldrán los datos con otro Orden, aunque en el Modelo de Diseño aparezca en el orden correcto 2.- No es necesario crear un Modelo de Diseño. 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 Observación: 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 construcción para salida XML no es necesario crear un Modelo de Diseño, ya que omite todo lo que contenga 3 EJECUCIÓN DE INFORMES DE REPORT BUILDER Se ha establecido un método común para la ejecución y posterior visualización de Informes utilizando la herramienta de Report de Oracle ReportBuilder. Inicialmente hay que distinguir entre los dos tipos de ejecución 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 aplicación mediante la utilización del siguiente parámetro: TipoEjecucion=Web / Windows (con uno de estos dos valores) Página 5 de 9

6 La ejecución se realizará de igual modo independientemente del ámbito en el que nos encontremos mediante la llamada al procedimiento EJECUTAR_REPORT con los siguientes parámetros: EJECUTAR_REPORT ( WReport in varchar2, WDes_Report in varchar2, WParam in varchar2, WCola in varchar2 ); WReport.- Nombre del objeto ReportObject WDes_Report.- breve descripción del informe WParam.- parámetros que se enviarán para la ejecución del report (a nivel de REPORT_OTHER) Por ejemplo aquellos parámetros tipo filtro enviados en tiempo de ejecución. WCola.- nombre de la cola bajo la cual se lanzará el report Las colas han de estar definidas en el fichero.ini de la aplicación como por ejem. Cola1=ReportsServer1 Cola2=ReportsServer2 por defecto (si el valor es NULL) este parámetro tomará siempre el valor de Cola1' Nota: se ha observado que se producen problemas al ejecutar los Report s bajo Web si en el Forms - Parámetros del Informe no se rellena el param. Servidor de Informes con algún valor (el que sea) ya que el Servidor de informes a utilizar, como se explica anteriormente, se recoge del parametro Wcola en la ejecución del Report mediante el procedimiento EJECUTAR_REPORT. 4 EJECUCION DE REPORTS POR TIPO En la librería ICM_PLL está disponible el Procedimiento EJECUTAR_REPORT_TIPO para Forms 10g Parámetros WREPORT: Nombre del objeto ReportObject delimitador) WDES_REPORT: Descripción del Report (max. varchar2(60) ) WPARAM: Otros parámetros de ejecución WCOLA: Nombre de cola (ReportServer) por la que se lanzará el Report WTIPO : Formato del Fichero de Salida. Valores Válidos: CSV (Excel - Texto) XLS (Excel) RTF (Word) TXT (Texto) (Por defecto si no indicamos el delimitador utlizará una tabulación como XML HTML PDF Página 6 de 9

7 WDELIMITER : Sólamente se tiene en cuenta con Tipo TXT, es el separador de campos si va a Nulo por defecto utiliza el tabulador WCELLWRAPPER: Sólamente se tiene en cuenta con Tipo TXT, engloba el valor del campo con el carácter indicado Z_FICH_OUT: Es un parámetro de Salida y devuelve el Nombre del Fichero generado WVISUAL_MENS: Valores Válidos S - Visualiza el Mensaje de Lanzado report a Cola de Impresión N - No visualiza el Mensaje Si se desea se puede omitir en la llamada al procedimiento éste parámetro, Tiene valor por defect S 5 VISUALIZACIÓN DE INFORMES Una vez lanzado el report, para la visualización del informe, hay que distinguir si estamos realizando la ejecución 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 petición (este usuario podrá consultar sus informes y los de los usuarios que pertenezcan al mismo perfil dentro de la aplicación). El tipo de fichero generado en Web es el estándar PDF y con nombre generado automáticamente por el procedimiento como YYYYMMDD_HH24MISS.pdf Para la visualización del mismo se ha creado un form LIS_REP.fmx que permite consultar / borrar / actualizar informes automáticamente de modo autónomo en base al estado actual en el que se encuentren los mismos. El usuario tan sólo podrá visualizar aquellos informes cuyo estado sea finalizado (o probablemente finalizado por una caída de la máquina 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 : Página 7 de 9

8 Windows.- en este tipo de ejecución nada más solicitar la ejecución del informe se procede a realizar una visualización del mismo por pantalla desde donde el usuario decidirá si lo imprime o no. 6 FICHERO.INI DE LA APLICACIÓN En el fichero.ini de la aplicación se incluye configuración específica para Report Builder necesaria para el procedimiento y form mostrados anteriormente [ReportBuilder] ; *** Parámetros válidos solamente para Reports bajo TipoEjecucion=Web ;*** Path en donde se ubicarán los ficheros PDF generados Report_cache=\\cifs04v3002\DESA_WEB\web_reps\ ;*** Path virtual para la localización de los ficheros PDF generados Report_mapping=/web_reps/ ;*** Colas de ejecución de Reports que se corresponderán con los Servidores de Reports existentes Cola1=REPLIGERAD01 ;Cola2=REPMEDIANAD01 ; *** Para realizar impresión directa de Pdf's desde el módulo LIS_REP.fmx Impresion_pdf=/impresionpdf/cgi-bin/ImpresionPDF.exe Página 8 de 9

9 7 (ADMINISTRACIÓN) DISTRIBUCIÓN DE TRABAJOS EN DISTINTAS MÁQUINAS en REPORTS 6 Para la distribución de los servidores de reports en distintas máquinas se configurará a través del fichero: tnsnames.ora del equipo NT en donde se encuentre el FormsServer del siguiente modo: # Servicio sobre la propia máquina ReportServer,ReportServer.world=(ADDRESS=(PROTOCOL=tcp)(HOST=NTICMDES01)(PORT=1949)) # Servicio sobre máquina remota (detecta el servicio en NTICMPRO04 atraves del puerto) # (es necesario llevar los *.rep a la máquina remota NTICMPRO04) ReportServer4,ReportServer4.world=(ADDRESS=(PROTOCOL=tcp)(HOST=NTICMPRO04)(PORT=1949)) y posteriomente modificando simplemente el fichero de.ini de cada aplicación podemos distribuir los reports. Para ejecuciones en la propia máquina: Cola1=ReportServer o bien para ejecuciones en la máquina remota: Cola1=ReportServer4 8 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 ejecución. Para controlar desde producción la carga y balanceo de los distintos Reports utilizarán las colas de lanzamiento que actualmente se definen en el fichero de ini de la aplicación: Cola1=REPLIGERAD01 Cola2=REPMEDIANAD01 Cola3=REPPESADAD01 Cola4= REPESPECIALD01 Para realizar una correcta utilización del sistema paso a detallar las distintas colas que se crearán y el uso de las mismas en función del trabajo a realizar: Cola1.- Listados cortos de ejecución inmediata. Cola2.- Listados grandes de ejecución inmediata. Cola3.- Impresión controlada de trabajos en batch. Cola4.- Otro tipo de trabajos especiales que requieran de especial supervisión. De este modo conseguiremos que los trabajos se ejecuten en las mejores condiciones para todos. Página 9 de 9