Cómo: |
El comando -INCLUDE permite insertar un procedimiento de informe (FEX) o un archivo de hoja de estilos (STY) en otro procedimiento de informe (FEX). Para más información sobre cómo crear solicitudes de informe y archivos de hojas de estilos, consulte el manual Cómo crear informes con el lenguaje WebFOCUS.
Cuando se crea un procedimiento en la ruta de carpetas de contenido del repositorio, se crea, a su vez, una ruta y una referencia de nombre de archivo únicas, basadas en la carpeta en que se ha creado el informe y el nombre y tipo especificados para el archivo. Fíjese que existen reglas a la hora de nombrar archivos que reemplazan a la mayoría de los caracteres alfanuméricos y modifican el nombre del archivo cuando sea necesario.
La ruta completa es el valor especificado al hacer referencia a un procedimiento de informe o archivo de hoja de estilos, en un comando -INCLUDE. Para obtener la información completa de la ruta IBFS, incluido el nombre del archivo, seleccione el informe y pulse la opción Propiedades.
Nota: Los procedimientos de informes de WebFOCUS 7.x, migrados con comandos -INCLUDE y codificados en las referencias internas del repositorio de Managed Reporting 7.x, son compatibles con WebFOCUS 8. Esto es posible debido a que las referencias internas de WebFOCUS 7.x se migran con la información de propiedades de un elemento (por ejemplo, un informe o archivo de hoja de estilos). Debe hacer referencia a los elementos creados en WebFOCUS 8, por medio de su ruta IBFS completa.
La imagen siguiente muestra el cuadro de diálogo Propiedades de un procedimiento de informe (FEX) con la ruta completa.
El siguiente código explica cómo incorporar un procedimiento de informe (FEX) utilizando la ruta IBFS con el comando -INCLUDE.
Nota: En ediciones anteriores a WebFOCUS 8, los procedimientos o archivos de hoja de estilos situados en un servidor de informes, se incorporaban a un procedimiento de Managed Reporting por medio del comando -MRNOEDIT, anterior al comando -INCLUDE. El comando -MRNOEDIT -INCLUDE es compatible con WebFOCUS 8.
-INCLUDE IBFS:/path/filename
donde:
Es la ruta completa, incluido el nombre del archivo, del procedimiento de informe (FEX) o filename.sty del archivo de hoja de estilos. La extensión del archivo es opcional cuando el procedimiento de informe (FEX) aparece citado.
Para incorporar un procedimiento en un servidor de informes, mediante -MRNOEDIT e -INCLUDE, introduzca lo siguiente:
-MRNOEDIT -INCLUDE appname/filename.ext
donde:
Es la ruta del directorio de aplicaciones, en el servidor de informes, en que está situado el procedimiento de informe (FEX) o el archivo de hoja de estilos (STY). Si no aparece especificado, el archivo debe estar en la ruta de aplicaciones del Servidor de informes.
Es el nombre del procedimiento situado en el servidor de informes. La extensión del archivo es opcional cuando el procedimiento de informe (FEX) aparece citado. Especifique la extensión de STY para incorporar un archivo de hoja de estilos.
Para incorporar un procedimiento situado en un directorio de aplicaciones perteneciente a un servidor de informes, mediante la ruta IBFS de WebFOCUS, introduzca:
-INCLUDE IBFS://EDA/nodename/appname/filename.ext
donde:
Es el nodo del servidor de informes definido en la configuración del Cliente WebFOCUS. La ruta IBFS://EDA/ especifica que el procedimiento o archivo de hoja de estilos está situado en un servidor de informes. El procesamiento de Managed Reporting elimina IBFS://EDA/nodename de la solicitud a la hora de enviarla al Servidor de informes, puesto que el procesamiento de éste utiliza su ruta de aplicaciones para localizar el procedimiento o archivo de hoja de estilos.
Es el directorio de aplicaciones, en el servidor de informes, en que está situado el procedimiento de informe o el archivo de hoja de estilos. Si no aparece especificado, el archivo debe estar en la ruta de aplicaciones del Servidor de informes.
Es el nombre del procedimiento o el archivo de hoja de estilos situado en el Servidor de informes. La extensión del archivo es opcional cuando el procedimiento de informe (FEX) aparece citado. Especifique la extensión de STY para incorporar un archivo de hoja de estilos.
Una de las mejores prácticas para desarrollo de aplicaciones en WebFOCUS 8, consiste en centralizar el estilo de los informes y la configuración del entorno, como los JOIN o los DEFINE, almacenándolos en un dominio común y definiendo permisos de seguridad para que los usuarios puedan leerlos y ejecutarlos, pero no editarlos ni cambiarlos. Sin embargo, es posible que las aplicaciones heredadas (legacy) requieran referencias a procedimientos de informe y archivos de hoja de estilos situados en un directorio de aplicaciones del Servidor de informes. La información de esta sección está dedicada a las aplicaciones heredadas que han sido migradas.
El siguiente ejemple indica cómo incorporar un procedimiento de servidor de informes o un archivo de hoja de estilos a un procedimiento de Managed Reporting, mediante los comandos -MRNOEDIT e -INCLUDE.
El procedimiento salesrptsetup, que incluye los siguientes comandos para la creación de un campo utilizado frecuentemente en los informes de ventas de productos, está situado en el directorio /ibi/apps/ibisamp del Servidor de informes.
DEFINE FILE GGSALES PROFIT/D12.3= DOLLARS - BUDDOLLARS; INVENTORY/D12 = UNITS - BUDUNITS; END
La hoja de estilos salesrptstyle.sty, que contiene los siguientes comandos de estilo, está situada en el Servidor de informes, en el directorio /ibi/apps/ibisamp.
TYPE=REPORT,COLOR=NAVY,FONT='ARIAL',SIZE=9,GRID=OFF,$ TYPE=HEADING,LINE=1,STYLE=BOLD,SIZE=12,JUSTIFY=CENTER,$ TYPE=TITLE,BACKCOLOR=RGB(45 111 205),COLOR=WHITE,STYLE=UNDERLINE+BOLD, $ TYPE=DATA,BACKCOLOR=(WHITE RGB(235 235 255)),$ TYPE=SUBTOTAL,BACKCOLOR=RGB(163 200 236),STYLE=BOLD,$
El procedimiento de Managed Reporting incorpora el procedimiento salesrptsetup y la hoja de estilos salesrptstyle, situados en el Servidor de informes.
-MRNOEDIT -INCLUDE ibisamp/salesrptsetup TABLE FILE GGSALES "Regional Inventory and Profit Report" SUM BUDUNITS UNITS INVENTORY AS 'Inventory' BUDDOLLARS DOLLARS PROFIT AS 'Profit' BY REGION BY CATEGORY -MRNOEDIT -INCLUDE ibisamp/salesrptstyle.sty END
Desde el Servidor de informes, ReportCaster es capaz de recibir un solo conjunto de respuestas, como un informe, diagrama o archivo HTML, por cada tarea de una programación. Por tanto, sólo debe se debe crear un único conjunto de respuestas al utilizar -INCLUDE para incorporar un procedimiento programado con ReportCaster. Si necesita distribuir varios informes en un solo documento, emplee la característica Informe compuesto. Para más información, consulte el manual Cómo crear informes con el lenguaje WebFOCUS.
| WebFOCUS |