Información general sobre el estallido de informes

Cuando la función de estallido divide un informe individual en múltiples archivos HTML, cada archivo contiene toda la información solicitada para un valor específico del campo de clasificación. Al proporcionar acceso directo a diferentes secciones de su informe, esta técnica le permite:

Nota: Cuando divida informes en Developer Studio, debe ejecutar la solicitud de forma remota contra un servidor de WebFOCUS.

Sintaxis: Cómo Dividir informes en múltiples archivos HTML

ON sortfield PCSEND LOCATION dir [AS burstname] FORMAT HTML

donde:

sortfield

Especifica el campo de clasificación a partir de qué tipo de división ocurra. Cada campo dividido contiene una salida de informe para un solo tipo de grupo de clasificación.

Puede dividir informes a partir del valor del primer campo de clasificación solamente. No puede hacer de estallido informes sobre la base del valor de campos de clasificación subsiguientes.

Puede dividir un informe en un máximo de 10,000 archivos separados. En consecuencia, puede dividir un informe sólo si el número de valores individuales del primer campo de clasificación no pasa de los 10,000.

PCSEND

Inicia la división. Puede utilizar sólo un comando PCSEND en una solicitud.

dir

Especifica la ubicación en el servidor web en que se almacenan el archivo de índice HTML y los archivos de informe. El parámetro LOCATION es obligatorio y debe especificar un directorio desde el cual el servidor web lea los archivos HTML. No hay uno predeterminado.

En plataformas UNIX, Windows y OpenMVS, el valor del directorio debe especificar una ruta de directorio completamente calificada.

Nota para usuarios de z/OS Web390: en plataformas z/OS, el valor de directorio debe especificar el nombre de directorio de un PDS asignado. No se proporciona asignación dinámica de conjuntos de datos. El PDS queda asignado a un ddname distinto al Web390 estándar WWWHTM. El ddname alternativo debe ser WWWxxx, donde xxx son tres caracteres alfanuméricos cualquiera. El servidor web Web390 requiere una entrada en su tabla mime para reconocer el PDS asignado como uno con salida HTML.

Si el parámetro LOCATION especifica un directorio inválido o especifica un directorio al que no se puede escribir, se devuelve un mensaje de error.

burstname

Especifica el nombre del archivo de índice HTML, que contiene una lista de hipervínculos con los archivos de informe HTML divididos. Los hipervínculos con los archivos de informes HTML divididos se numeran del 0 al 9999. Si no se especifica un nombre de archivo para el archivo del índice HTML, HOLD es el nombre predeterminado.

Cada archivo del índice HTML usa los primeros cuatro caracteres del nombre del archivo del índice, seguido por cifras entre 0000 y 9999.

Nota: La solicitud de informe puede contener campos de visualización con valores no disponibles. La solicitud de informe también puede contener campos NOPRINT. Para obtener información detallada, consulte Cómo manejar registros con valores de campo no disponibles.

Referencia: Reglas para encabezados y pies de índices e informes divididos

Para incluir un encabezado o pie en la página de índice HTML, utilice los comandos:
```
ON TABLE SUBHEAD
```
y
```
ON TABLE SUBFOOT
```
Estos encabezados y pies pueden contener campos insertados. El encabezado o pie no está incluido en las páginas de salida de informe HTML. El estilo predeterminado se aplica a la página del índice HTML.
Para incluir un encabezado o pie estándar en todas las páginas de salida de informe HTML, utilice los siguientes comandos:
```
HEADING
```
y
```
FOOTING
```
Estos encabezados y pies pueden contener campos insertados. El estilo predeterminado se aplica a la página del índice HTML.
Para incluir un encabezado o pie estándar que cambie cada vez que lo haga el campo de clasificación, utilice los siguientes comandos:
```
ON sortfield SUBHEAD
```
y
```
ON sortfield SUBFOOT
```
Estos subencabezados y subpies pueden contener campos insertados, tales como el campo de clasificación utilizado en el comando PCSEND. El estilo predeterminado se aplica a la página del índice HTML.

Para más detalles sobre encabezados y pies de informe, consulte Cómo usar encabezados, pies, títulos y etiquetas.

Principio de página

Ejemplo: Cómo dividir un informe

El siguiente procedimiento de informe crea un archivo de salida de informe HTML para cada valor REGION diferente en el origen de datos GGSALES. Los archivos de salida de informes reciben los nombres de test0000.html, test0001.html, test0002.html y así sucesivamente. La página de índice HTML recibe el nombre de test.html y contiene un hiperenlace por cada valor de datos de REGION. El directorio que seleccione depende de dónde se encuentre WebFOCUS instalado. En este ejemplo, la página de índice se almacena en el directorio e:\ibi\WebFOCUS435\temp.

TABLE FILE GGSALES
HEADING
"Regional Report"
SUM UNITS AND DOLLARS
BY REGION BY STCD BY CATEGORY
ON TABLE SET PAGE NOPAGE
ON TABLE SUBHEAD
"Year-end Sales:"
"Regional Summary by Store"
ON REGION PCSEND LOCATION E:\IBI\WebFOCUS435\temp AS TEST FORMAT HTML
END

Después de ejecutar esta solicitud, no se devuelve ninguna salida de informe, pero el mensaje que aparece a continuación muestra si la solicitud se completó:

The bursted files were successfully created.

Se crean archivos HTML por separado para cada valor del gran campo de clasificación REGION y se almacenan en el lugar especificado en la solicitud.

Le sigue la página de índice HTML creada por el procedimiento:

Si selecciona el hipervínculo Midwest aparece el siguiente informe HTML:

Regional Report
Region	Store ID	Category	Unit Sales	Dollar Sales
Midwest	R1019	Coffee	113253	1393610
		Food	107615	1351523
		Gifts	78869	969845
	R1020	Coffee	109581	1398779
		Food	118068	1522847
		Gifts	79932	1002775
	R1250	Coffee	109943	1386124
		Food	115731	1463901
		Gifts	72053	911261

Fíjese que los encabezados especificados en el comando ON TABLE SUBHEAD se muestran en la página de índice HTML. Consulte Reglas para encabezados y pies de índices e informes divididos.