Cómo crear un informe compuesto PDF con vínculos drill through

Referencia: Comparación de drill through y drill down

Con drill down puede construir un informe de resumen en el que se muestran datos detallados al pulsar un hipervínculo. Los drill down se implementan de forma dinámica. Al pulsar un hipervínculo, el informe nuevo se ejecuta. El informe detallado muestra por lo regular solo los datos detallados para un campo particular del informe de resumen.

Por el contrario, los informes drill through son estáticos. Drill Through crea un documento PDF que contiene el informe de resumen y el detallado. El informe detallado contiene todos los datos detallados de los campos designados en el informe de resumen. Pulse sobre los hipervínculos de drill through para navegar por el archivo PDF. No se ejecuta ningún informe adicional. Puede guardar el archivo PDF en el disco o distribuirlo con ReportCaster. Cuando se abre con Adobe Reader, conserva toda su funcionalidad Drill Through.

El drill through ofrece flexibilidad en la forma en que se muestran los informes y en la ubicación de los hipervínculos:

Los hipervínculos de drill through pueden aparecer en encabezados, subencabezados o filas de datos.
Los informes se pueden formatear con una hoja de estilos de WebFOCUS.
Puede indicar un hipervínculo por su color, fuente, subrayado y demás características.
Puede mezclar libremente hipervínculos convencionales de drill down e hipervínculos de drill through en el mismo informe.
El archivo PDF creado con drill down podría contener más de dos informes.

Referencia: Cómo utilizarlos con otras características

Se puede utilizar drill through junto con otras características de WebFOCUS:

Los informes compuestos que tengan informes de drill through enlazados podrían tener también informes no relacionados antes o después de los informes de drill through. Por ejemplo, se puede añadir al paquete del informe compuesto un informe PDF que contenga gráficos insertados.
Puede añadir hipervínculos de drill down y URL a un informe PDF que contenga hipervínculos de drill through.
Dado que los informes de drill through son informes estándar de PDF empaquetados en un solo archivo PDF, puede distribuirlos con ReportCaster.
Se pueden presentar informes con sintaxis DRILLTHROUGH en todos los demás formatos de salida con estilo: HTML, PostScript, EXL2K y cualquier otro. En estos formatos se ignora la sintaxis DRILLTHROUGH. Resulta útil, por ejemplo, generar una versión PostScript de un informe drill through que ha sido formateado de forma idéntica a la versión PDF, pero que se puede enviar directamente a una impresora PostScript mediante ReportCaster o comandos de sistema operativo.
"Drill through" automatiza el proceso de navegación de manera rápida y fácil yendo de información general a información específica que se encuentra en informes relacionados empaquetados en un solo informe compuesto en PDF. La sintaxis drill through establece hipervínculos que lo llevan desde un elemento en un informe de resumen al elemento correspondiente en un informe detallado.

Procedimiento: Cómo Crear un drill through en un informe de diseño compuesto PDF

Para crear un drill through en un informe de diseño compuesto PDF:

Cree un informe de resumen con un hipervínculo DRILLTHROUGH.
Cree el informe de detalles con valores de clasificación que coincidan con los valores de campo del hipervínculo.
Cree el informe de diseño compuesto con diseños de páginas para cada informe de componente y defina un atributo DRILLMAP dentro del informe de llamada para especificar los destinos de los hipervínculos de drill through.

Procedimiento: Cómo Crear un informe compuesto de PDF con drill through

Para crear un informe compuesto de PDF con drill through:

Cree el informe de resumen.
Cree el informe detallado.
Conecte los informes mediante hipervínculos.
Fusione los informes de resumen y detallado en un informe compuesto de PDF.

Sintaxis: Cómo Especificar hipervínculos con drill through

TYPE=type, [element,] [styling_attributes,]
     DRILLTHROUGH={DOWN|FIRST}(link_fields) , $

donde:

type

Es uno de los siguientes tipos de hoja de estilos:

DATA
HEADING
FOOTING
SUBHEAD
SUBFOOT
SUBTOTAL
RECAP

element

Es uno o más de los elementos de identificación permitidos en una hoja de estilos de WebFOCUS y en un informe de drill through. Un elemento puede describir tanto una columna específica (por ejemplo, COLUMN=PRODUCT) como un elemento de un encabezado (por ejemplo, LINE=2, OBJECT=field, ITEM=3).

styling_attributes

Especifican, de manera opcional, el aspecto del hipervínculo (por ejemplo, COLOR=RED, STYLE=BOLD).

DOWN

Enlaza con el próximo informe (es decir, el siguiente).

FIRST

Enlaza con el primer informe de drill through en la secuencia.

link_fields

Especifica vínculos de parejas de campos delimitados por espacios en blanco con el siguiente formato:

T1=S1 T2=S2 T3=S3...

T1, T2 y T3 representan las referencias de columna en el informe de destino (vinculado), mientras que S1, S2 y S3 representan las referencias de columna en el informe de origen (actual). Pueden existir más de tres parejas.

Una referencia de columna puede ser el nombre de un campo o cualquiera de los símbolos válidos en la sintaxis de hojas de estilos WebFOCUS (por ejemplo, Bn, Cn, Pn, Nn, An, nombre de campo suscrito, etc).

El orden de la sintaxis es parecido al de la sintaxis de drill down, en la que las parejas de parámetros especifican la referencia de columna en el informe actual (origen), situado a la derecha, y el nombre de la variable de Dialogue Manager, en el procedimiento de drill down (destino) de la izquierda.

Si la referencia de columna del informe de destino es idéntica a la del informe de origen, puede usar una referencia de columna única, por ejemplo, COUNTRY en vez de COUNTRY=COUNTRY.

Principio de página

Ejemplo: Especificar hipervínculos de drill through

La siguiente declaración de hoja de estilos coloca un hipervínculo en cada línea de DATA del campo PRODUCT, especifica que los campos vinculados al próximo informe son CATEGORY y PRODUCT, especifica la acción DOWN para que, al pulsar el hipervínculo, vaya al lugar del próximo informe que tenga los valores correspondientes a los campos del vínculo, y usa el aspecto predefinido del los hipervínculos (texto azul, subrayado). Dado que los campos de destino en el informe detallado tiene nombres idénticos en el informe de resumen, puede utilizar la notación CATEGORY en lugar de CATEGORY=CATEGORY.

TYPE=DATA, COLUMN=PRODUCT, DRILLTHROUGH=DOWN(CATEGORY PRODUCT), $

Sintaxis: Cómo Especificar los informes de diseño compuesto relacionados mediante hipervínculos

El informe de destino está especificado en el atributo DRILLMAP de la declaración COMPONENT del informe de llamada.

DRILLMAP=((L1 targetreport))

donde:

L1: Es el identificador de vínculo.
targetreport: Es el nombre del componente del destino del hipervínculo.

Nota: El doble paréntesis alrededor de DRILLMAP es obligatorio.

Principio de página

Ejemplo: Ejemplos de declaraciones de componente con atributos DRILLMAP

La siguiente declaración COMPONENT de REPORT1 indica un atributo DRILLMAP que apunta REPORT2:

COMPONENT='REPORT1', TEXT='REPORT1', TOC-LEVEL=2, 
DRILLMAP=((L1 REPORT2)), POSITION=(0.750 1.083), DIMENSION=(7.000 3.167),
METADATA='Z-INDEX: 100; LEFT: 0.75in; OVERFLOW: auto; WIDTH: 7in;
POSITION: absolute; TOP: 1.083in; HEIGHT: 3.167in', $

La siguiente declaración COMPONENT de REPORT2 indica un atributo DRILLMAP que apunta REPORT1:

COMPONENT='REPORT2', TEXT='REPORT2', TOC-LEVEL=2, 
DRILLMAP=((L1 REPORT1)), POSITION=(0.500 0.667), DIMENSION=(7.417 7.000),
METADATA='Z-INDEX: 100; LEFT: 0.5in; OVERFLOW: auto; WIDTH: 7.417in;
POSITION: absolute; TOP: 0.667in; HEIGHT: 7in', $

Referencia: Notas de uso de drill through

Sólo se puede especificar un comportamiento de drill through por informe.
El campo designado para contener el comportamiento de drill through también debe estar incluido en el informe de destino.
El informe de origen que contenga el vínculo de drill through debe crearse (por el servidor de informes) antes que el informe de destino. El orden de los informes es tarea del usuario.
Los vínculos dinámicos de drill through sólo se generan para la salida PDF. Se pueden presentar informes con sintaxis DRILLTHROUGH en todos los demás formatos de salida con estilo: HTML, PostScript, EXL2K y cualquier otro. En estos formatos se ignora la sintaxis DRILLTHROUGH. Resulta útil, por ejemplo, generar una versión PostScript de un informe drill through que ha sido formateado de forma idéntica a la versión PDF, pero que se puede enviar directamente a una impresora PostScript mediante ReportCaster o comandos de sistema operativo.
El drill through sólo se admite en informes (TABLE).

Ejemplos de informes compuestos de drill through PDF

Referencia:

Los ejemplos siguientes explican cómo usar la sintaxis de drill through para crear un informe compuesto con un informe de resumen y detalles y navegar por ellos.

Principio de página

Ejemplo: Cómo crear un informe de resumen (Paso 1)

La sintaxis siguiente resulta en un ejemplo de informe de resumen:

TABLE FILE GGSALES
SUM UNITS DOLLARS BY CATEGORY BY PRODUCT
ON TABLE PCHOLD FORMAT PDF
END

La salida es:

Principio de página

Ejemplo: Cómo crear un informe detallado (Paso 2)

La sintaxis que sigue genera un informe detallado para muestra:

La primera página de salida es:

SET SQUEEZE=ON
TABLE FILE GGSALES
SUM UNITS BUDUNITS DOLLARS
BY CATEGORY NOPRINT BY PRODUCT NOPRINT
ON CATEGORY PAGE-BREAK
HEADING CENTER
"Category: <CATEGORY"
" "
ON PRODUCT SUBHEAD
"**** Product: <PRODUCT"
ON PRODUCT SUBFOOT
" "
"<25 **** Return to Summary ****"
ON PRODUCT PAGE-BREAK
BY REGION BY CITY
ON TABLE PCHOLD FORMAT PDF
ON TABLE SET STYLE *
TYPE=SUBFOOT, LINE=2, ITEM=1, DRILLTHROUGH=FIRST(CATEGORY PRODUCT),
COLOR=RED, $
END

Principio de página

Ejemplo: Cómo conectar los informes con hipervínculos (Paso 3)

Este ejemplo muestra lo siguiente:

Al colocar un hipervínculo de drill through en un elemento de salto de clasificación, asegúrese de que el salto de clasificación se encuentra, como mínimo, al nivel del ultimo campo de clasificación que participa en el drill through. Por ejemplo, en el segundo informe, el hipervínculo de drill through se encuentra en el subencabezado asociado a PRODUCT y no en el encabezado (con salto de clasificación) asociado a CATEGORY.
Aunque el código podría inferir un valor de PRODUCT para el encabezado CATEGORY (puede verificarlo insertando el campo <PRODUCT> en el encabezado), se trata siempre del valor del primer PRODUCT en esa CATEGORY. Normalmente, se debe crear un hipervínculo de drill through para cada valor de PRODUCT en cada CATEGORY.

No es necesario colocar el hipervínculo en un elemento insertado. Es igual de efectivo colocarlo en un elemento de texto. Cualquier elemento de este subpie se encuentra asociado a los mismos valores de CATEGORY y PRODUCT. Del mismo modo, puede colocar un hipervínculo en cualquier campo de una línea DATA. Los valores de los campos del vínculo asociado son idénticos. También los hipervínculos de drill down tradicionales funcionan de esta manera.

El informe de resumen:

Coloca un hipervínculo en el campo PRODUCT en cada línea DATA.
Especifica que los campos que hay que vincular a el próximo informe son CATEGORY y PRODUCT. Dado que los campos de destino en el informe detallado tiene nombres idénticos en el informe de resumen, puede utilizar la notación CATEGORY en lugar de CATEGORY=CATEGORY.
Especifica la acción DOWN, de manera que pulsar un hipervínculo le transporta a la parte del próximo informe que tiene los valores correspondientes de los dos campos.
Utiliza el aspecto predeterminado para los hipervínculos. Este aspecto es azul con texto subrayado.

El informe de resumen es:

TABLE FILE GGSALES
SUM UNITS DOLLARS BY CATEGORY BY PRODUCT
ON TABLE PCHOLD FORMAT PDF
ON TABLE SET STYLE *
TYPE=DATA, COLUMN=PRODUCT, DRILLTHROUGH=DOWN(CATEGORY PRODUCT), $
ENDSTYLE
END

El informe de detalles:

Coloca un hipervínculo en el subpie asociado al campo enlazado PRODUCT. Dado que CATEGORY es un campo BY de nivel superior, cada subencabezado PRODUCT se asocia también con un valor único de CATEGORY.
Coloca un hipervínculo en el primer elemento de la segunda línea del subpie, el texto Volver a resumen.
Especifica la acción FIRST, de manera que pulsar el hipervínculo le lleva directamente a la línea en el primer informe (el de resumen) que contiene los mismos valores de los dos campos enlazados CATEGORY y PRODUCT.
Utiliza el atributo COLOR para mostrar el hipervínculo en rojo con texto subrayado.

El informe de detalles es:

SET SQUEEZE=ON
TABLE FILE GGSALES
SUM UNITS BUDUNITS DOLLARS
BY CATEGORY NOPRINT BY PRODUCT NOPRINT
ON CATEGORY PAGE-BREAK
HEADING CENTER
"Category: <CATEGORY"
" "
ON PRODUCT SUBHEAD
"**** Product: <PRODUCT"
ON PRODUCT SUBFOOT
" "
"<25 **** Return to Summary ****"
ON PRODUCT PAGE-BREAK
BY REGION BY CITY
ON TABLE PCHOLD FORMAT PDF
ON TABLE SET STYLE *
TYPE=SUBFOOT, LINE=2, ITEM=1, DRILLTHROUGH=FIRST(CATEGORY PRODUCT),
COLOR=RED, $
END

El siguiente paso es el único que es diferente para la creación de un informe de diseño compuesto o un informe compuesto heredado.

Principio de página

Ejemplo: Crear el informe de diseño compuesto (paso 4)

Efectúe esta versión del paso 4, si va a crear un informe de diseño compuesto.

Para crear el informe de diseño compuesto:

Añada una segunda declaración COMPOUND LAYOUT y SECTION al principio del procedimiento:
Añada las declaraciones PAGELAYOUT Y COMPONENT a ambos informes. Añada atributos DRILLMAP a las declaraciones COMPONENT.
Añada comandos SET COMPONENT y los dos informes.
Termine el procedimiento con un comando COMPUND END:

SET HTMLARCHIVE=ON
COMPOUND LAYOUT PCHOLD FORMAT PDF
UNITS=IN, $
SECTION=section1, LAYOUT=ON, METADATA='0.5^0.5^0.5^0.5', MERGE=OFF,
   ORIENTATION=PORTRAIT, PAGESIZE=Letter,  $
PAGELAYOUT=1, NAME='Page layout 1', text='Page layout 1', TOC-LEVEL=1,
   BOTTOMMARGIN=0.5, TOPMARGIN=0.5, METADATA='BOTTOMMARGIN=0.5,
   TOPMARGIN=0.5,LEFTMARGIN=0,RIGHTMARGIN=0, $
COMPONENT='REPORT1', TEXT='REPORT1', TOC-LEVEL=2,
DRILLMAP=((L1 REPORT2)), POSITION=(0.750 1.083), DIMENSION=(7.000 3.167),
   METADATA='Z-INDEX: 100; LEFT: 0.75in; OVERFLOW: auto; WIDTH: 7in;
   POSITION: absolute; TOP: 1.083in; HEIGHT: 3.167in', $
PAGELAYOUT=2, NAME='Page layout 2', text='Page layout 2', TOC-LEVEL=1,
   BOTTOMMARGIN=0.5, TOPMARGIN=0.5, METADATA='BOTTOMMARGIN=0.5,
   TOPMARGIN=0.5,LEFTMARGIN=0,RIGHTMARGIN=0, $
COMPONENT='REPORT2', TEXT='REPORT2', TOC-LEVEL=2,
DRILLMAP=((L1 REPORT1)), POSITION=(0.500 0.667), DIMENSION=(7.417 7.000),
   METADATA='Z-INDEX: 100; LEFT: 0.5in; OVERFLOW: auto; WIDTH: 7.417in;
   POSITION: absolute; TOP: 0.667in; HEIGHT: 7in', $
END

-* Add Report1 code and SET COMPONENT command
SET COMPONENT='REPORT1'
TABLE FILE GGSALES
SUM UNITS DOLLARS BY CATEGORY BY PRODUCT
ON TABLE PCHOLD FORMAT PDF
ON TABLE SET STYLE *
TYPE=DATA, COLUMN=PRODUCT, DRILLTHROUGH=DOWN(CATEGORY PRODUCT), $
ENDSTYLE
END

-* Add report2 code and SET COMPONENT command
SET COMPONENT='REPORT2'
SET SQUEEZE=ON
TABLE FILE GGSALES
SUM UNITS BUDUNITS DOLLARS
BY CATEGORY NOPRINT BY PRODUCT NOPRINT
ON CATEGORY PAGE-BREAK
HEADING CENTER
"Category: <CATEGORY"
" "
ON PRODUCT SUBHEAD
"**** Product: <PRODUCT"
ON PRODUCT SUBFOOT
" "
"<25 **** Return to Summary ****"
ON PRODUCT PAGE-BREAK
BY REGION BY CITY
ON TABLE PCHOLD FORMAT PDF
ON TABLE SET STYLE *
TYPE=SUBFOOT, LINE=2, ITEM=1, DRILLTHROUGH=FIRST(CATEGORY PRODUCT),
COLOR=RED, $
END
COMPOUND END

Principio de página

Ejemplo: Cómo combinar informes de resumen y de detalle en un solo informe compuesto de PDF (Paso 4)

Efectúe esta versión del paso 4, si va a crear un informe compuesto heredado.

El siguiente paso es el de combinar los informes en un sólo informe compuesto PDF. Puede:

Codificar las opciones OPEN y CLOSE en el comando [PC]HOLD FORMAT PDF.
Codificar las opciones OPEN y CLOSE en el comando SET COMPOUND antes de la sintaxis del componente de informe.

"Drill through" no admite la opción NOBREAK, que muestra informes compuestos sin la intervención de saltos de página.

Este ejemplo utiliza las opciones OPEN y CLOSE en el comando PCHOLD FORMAT PDF.

TABLE FILE GGSALES
SUM UNITS DOLLARS BY CATEGORY BY PRODUCT
ON TABLE PCHOLD FORMAT PDF OPEN
ON TABLE SET STYLE *
TYPE=DATA, COLUMN=PRODUCT, DRILLTHROUGH=DOWN(CATEGORY PRODUCT), $
ENDSTYLE
END

SET SQUEEZE=ON
TABLE FILE GGSALES
SUM UNITS BUDUNITS DOLLARS
BY CATEGORY NOPRINT BY PRODUCT NOPRINT
ON CATEGORY PAGE-BREAK
HEADING CENTER
"Category: <CATEGORY"
" "
ON PRODUCT SUBHEAD
"**** Product: <PRODUCT"
ON PRODUCT SUBFOOT
" "
"<25 **** Return to Summary ****"
ON PRODUCT PAGE-BREAK
BY REGION BY CITY
ON TABLE PCHOLD FORMAT PDF CLOSE
ON TABLE SET STYLE *
TYPE=SUBFOOT, LINE=2, ITEM=1, DRILLTHROUGH=FIRST(CATEGORY PRODUCT),
COLOR=RED, $
END

Principio de página

Ejemplo: Ejecutar el informe de drill through (paso 5)

Ejecute el informe compuesto. La primera página de salida presenta el informe de resumen con los hipervínculos de los productos individuales, subrayados y de color azul.

Pulse el hipervínculo Croissant de la categoría Alimentos. Así salta a la información detallada. En el informe de detalles, el hipervínculo para volver al informe de resumen es de color rojo y está subrayado.

Pulse el hipervínculo Volver a resumen para volver a la primera página (informe de resumen).

Principio de página

Referencia: Guías para vínculos de FIRST

Tenga en cuenta estas indicaciones:

El conjunto de campos de vínculo utilizados con FIRST debe corresponder con el conjunto de campos de vínculo utilizados con DOWN en el primer informe.
La acción de un hipervínculo FIRST en el último informe debe regresar a la línea correspondiente en el primer informe. El conjunto de vínculos escogido debe identificar de manera particular a esa línea del primer informe.
El hipervínculo DOWN en la línea del primer informe debe identificar a esa línea del primer informe de manera particular para localizar la línea correspondiente en el informe detallado. El conjunto de vínculos correspondiente a DOWN en el primer informe y el vínculo FIRST en el último informe son iguales, toda vez que ambos deben identificar de manera particular una línea en el primer informe.

Principio de página

Referencia: Reglas para hipervínculos drill through

Los informes enlazados con drill through deben apegarse a ciertas normas para garantizar que los hipervínculos entre estos funcionen correctamente. A continuación se listan conceptos clave:

Informe original. El informe desde el que crea el vínculo. El informe de origen contiene los hipervínculos al informe de destino.
Informe de destino. El informe al cual se enlaza.
Campo de vínculo. Uno de un conjunto de campos correspondientes del mismo tipo de datos que existen en el informe de origen y en el de destino. Los campos de vínculo ubican la posición en el informe de destino a los cuales viaja un hipervínculo en el informe de origen.

La terminología original y la de destino hacen referencia a cada pareja de informes enlazados. Por ejemplo, si existen tres informes enlazados con drill through, el segundo informe es por lo general el informe de destino del primer informe y el informe de origen del tercer informe.

Para procesar un informe como drill through, debe identificar los campos enlazados en el informe de origen que guarden relación con el informe de destino:

Elija campos de vínculo significativos cuyos valores coincidan con el informe de origen y el de destino. Por ejemplo, si un campo en el informe de origen contiene un número de pieza y un campo en el informe de destino contiene un número de identificación personal, los valores de campo no se corresponderán y, por esto, no se podrán construir hipervínculos.
Especifique tantos campos de vínculo como sea necesario para localizar correctamente la posición en el informe de destino que corresponda a los campos enlazados en el informe de origen. Por ejemplo, si el informe de origen se clasifica por STATE (estado) y CITY (ciudad), habrá problemas si especifica CITY como el campo de vínculo y en diferentes estados existen ciudades con el mismo nombre.
Los campos de vínculo del informe de origen y del de destino deben tener el mismo formato interno (real): el tipo de datos detenidos y la longitud interna deben ser idénticos. Las opciones de formato, como el número de dígitos mostrados y la supresión de comas, podrían diferir. Por ejemplo, un campo A20 debe vincularse a otro campo A20. Ahora bien, un campo I6C puede vincularse a un campo I8, pues internamente ambos son campos de cuatro dígitos.
Los campos de vínculo deben ser campos de clasificación u objetos verbales tanto en los informes originales como en los de destino. Puede incluir un campo NOPRINT (que no se muestra), que resulta útil para construir un informe en que un campo se encuentre insertado en el texto del encabezado.
El diseño de un informe drill through es muy similar al de un informe drill down. La selección de campos de vínculo para un informe drill through es similar a la de campos de parámetros en un informe drill down. De la misma forma, la sintaxis de un drill through es muy similar a la de un drill down.
Dado que los informes drill through se enlazan mediante valores correspondientes de campos enlazados, los hipervínculos deben aparecer en elementos de informe relacionados con un valor particular de un campo enlazado. Sin embargo, los hipervínculos no tienen que aparecer en ningún vínculo.
No todos los tipos de línea son apropiados para colocar un hipervínculo de drill through. Por ejemplo, si se presenta un salto de página en un campo BY que es también un vínculo drill through, cada encabezado de página se relaciona claramente con un valor en ese campo. Ahora bien, si se presenta un salto de página por causa de un desborde de página, evite colocar un vínculo drill through en un encabezado. De la misma forma, los subencabezados, subpies, subtotales y recapitulaciones se relacionan solamente con los valores de campos BY particulares.