Cómo:
Referencia: |
Puede controlar la consolidación de datos en un firme, con lo que evita saltos de línea en celdas del informe. Al usar salida HTML, la mayoría de los navegadores envolverán, por defecto, los datos alfanuméricos de informe que no quepan en una sola línea de celda.
Esto hace saltar el contenido de la celda a una segunda línea. Un navegador web envuelve los datos de acorde con su configuración algorítimica. Emplee el atributo WRAP si desea suprimir el resumen de datos de un navegador web.
WRAP está en ON para la salida HTML, por defecto, permitiendo que cada navegador defina el ancho de cada columna del informe. En la salida de PDF, PS, DHTML y PPT, WRAP se encuentra establecido en OFF por defecto. En estos formatos de salida posicionados, en que la ubicación de cada elemento del informe está explícitamente definida, WRAP = ON no es un valor válido, aunque puede definir anchos específicos utilizando la opción n.
En la salida de informes PDF o PostScript, puede controlar el espaciado de líneas ajustadas mediante el atributo WRAPGAP.
Cómo ajustar datos en informes PDF que usan la frase OVER
OVER permite presentar un registro de datos individual en múltiples líneas, dentro de un informe. Cuando OVER está definido en una solicitud, el informe pasa por defecto de una presentación en columnas a una basada en filas. Los títulos de los campos aparecen a la izquierda de cada valor, en vez de en la parte superior de cada columna. Esta disposición no se ha diseñado con un tipo de alineación específica, sino con el objeto de permitir la presentación de muchos elementos de datos en un área reducida. En muchos casos, los informes que colocan las columnas unas sobre otras emplean nombres AS en blanco para alinearlas correctamente. Puede usar el atributo WRAP para envolver o ajustar los datos en informes PDF que utilizan OVER; esta técnica funciona bien con los nombres AS en blanco.
Cómo ajustar datos en informes PDF que usan la frase ACROSS
En solicitudes que emplean ACROSS, la salida muestra cada valor del campo ACROSS encima del conjunto de columnas de datos, correspondiente a ese valor ACROSS.
Si el valor ACROSS supera el ancho de sus columnas, puede ajustarlo al ancho de sus columnas subyacentes.
Por defecto, el ancho de cada grupo de valor ACROSS (el valor ACROSS más las columnas de datos de su interior) está basado en la suma de los anchos de las columnas de datos o en el mayor valor ACROSS de ese grupo, dependiendo de cuál sea superior. La acción de ajustar permite que el tamaño de cada ajuste ACROSS se defina en relación al ancho especificado por esta regla, incluidos todos los campos verticales que no se han envuelto o ajustado y las columnas de datos.
El ancho de cada columna ACROSS, en un grupo ACROSS determinado, está definido como la longitud del valor más alto de ese grupo ACROSS. Sólo se emplea un ancho para cada grupo, lo que explica que, en grupos en que los valores sean inferiores al valor más largo, aparezca un espacio más grande en el lado derecho de la celda.
En informes con múltiples campos ACROSS, puede ajustar un campo ACROSS o todos. Cada valor designado queda ajustado al grupo ACROSS definido.
Para controlar el ajuste del texto dentro de un informe, emplee la siguiente sintaxis con una hoja de estilos.
TYPE=type, [subtype,] WRAP=value, $
donde:
- type
- Es el componente de informe que desea cambiar, como REPORT, HEADING o TITLE.
- subtype
- Es cualquier atributo adicional, como COLUMN, ACROSS, ITEM, etc. que necesita para identificar el componente de informe que formatea. Consulte Cómo identificar un componente de informe en una hoja de estilo de WebFOCUS para obtener información sobre cómo especificar diferentes componentes de informe.
- value
- Es uno de los siguientes:
ON activa el ajuste de datos. El valor por defecto para la salida de informes HTML es ON. En la salida de informes PDF, PS, DHTML y PPT, WRAP se encuentra establecido en OFF por defecto. En estos formatos posicionados, en que la ubicación de cada elemento del informe está explícitamente definida, WRAP = ON no es un valor válido, aunque puede definir anchos específicos utilizando la opción n. En informes HTML, WRAP se puede usar en todos los campos. En informes PDF, WRAP se puede usar solo con campos insertados, no con texto.
Nota: Esta propiedad no se admite cuando se está utilizando WRAP con OVER en la salida de informes PDF.
OFF desactiva el ajuste de datos. El valor por defecto para la salida de informes PDF, PS, DHTML y PPT.
n representa un valor numérico específico al que se puede ajustar el ancho de la columna. El valor representa la medida especificada con el parámetro UNITS. Esta propiedad se admite para el ajuste de datos en informes PDF que utilizan la frase OVER.
Note: WRAP=ON y WRAP=n no se admiten con JUSTIFY.
En el ejemplo siguiente, donde WRAP=ON, los datos han quedado resumidos en base a la funcionalidad del navegador web. Tenga en cuenta que como este valor es el predeterminado, no hay necesidad de especificar WRAP=ON en la sintaxis de solicitud de informe.
TABLE FILE GGPRODS PRINT SIZE UNIT_PRICE PACKAGE_TYPE VENDOR_CODE VENDOR_NAME BY PRODUCT_ID BY PRODUCT_DESCRIPTION ON TABLE SET STYLE * TYPE=REPORT, GRID=ON, $ ENDSTYLE END
Nota: El ajuste está determinado por el tamaño de la ventana de su navegador; puede que tenga que reducir su tamaño para ver el ejemplo de ajuste de datos, como se aprecia en la imagen.
Tenga en cuenta que los registros en la columna Vendor Name pasan a una segunda línea.
La siguiente solicitud de informe, con WRAP=OFF, suprime el resumen de datos del navegador web:
TABLE FILE GGPRODS
PRINT SIZE UNIT_PRICE PACKAGE_TYPE
VENDOR_CODE VENDOR_NAME
BY PRODUCT_ID BY PRODUCT_DESCRIPTION
ON TABLE SET STYLE *
TYPE=REPORT, WRAP=OFF, $
TYPE=REPORT, GRID=ON, $
ENDSTYLE
END La salida es:
La siguiente solicitud, emitida frente al origen de datos GGPRODS, coloca la columna VENDOR_NAME en una línea nueva con la frase OVER. Por defecto, la acción de envolver o ajustar los datos queda desactivada y debe especificarse explícitamente en la hoja de estilos:
TABLE FILE GGPRODS PRINT SIZE UNIT_PRICE PACKAGE_TYPE OVER VENDOR_NAME BY PRODUCT_ID BY PRODUCT_DESCRIPTION ON TABLE PCHOLD FORMAT PDF END
La salida parcial aparece en la imagen siguiente.
La siguiente versión de la solicitud activa la acción de ajustar y establece una columna de 1.5 para la columna VENDOR_NAME, que ha quedado colocado en una línea nueva debido a la frase OVER:
TABLE FILE GGPRODS PRINT SIZE UNIT_PRICE PACKAGE_TYPE OVER VENDOR_NAME BY PRODUCT_ID BY PRODUCT_DESCRIPTION ON TABLE PCHOLD FORMAT PDF ON TABLE SET STYLE * TYPE=REPORT, COLUMN=VENDOR_NAME, WRAP=1.5,$ ENDSTYLE END
La salida parcial indica que la columna VENDOR_NAME ha quedado ajustada. Observe como WRAP ON causa que el valor OVER, y no OVER TITLE, quede ajustado:
El ajuste de valores de ACROSS es compatible con los formatos HTML y PDF.
TYPE=ACROSSVALUE, [ACROSS={fieldname|Nn|An}] WRAP={OFF|ON} ,$ donde:
- ACROSS
- Si tiene una solicitud con múltiples campos ACROSS, puede identificar cada campo con el identificador ACROSS. Solamente necesita incluir el identificador ACROSS si desea obtener múltiples campos ACROSS en su solicitud.
- fieldname
- Especifica una fila de clasificación horizontal por su nombre de campo.
- Nn
- Identifica una columna por su posición en el informe. Para determinar este valor, cuente los campos de clasificación vertical (BY), los campos de visualización y los campos ROW-TOTAL de izquierda a derecha, incluyendo los campos NOPRINT.
- An
- Especifica una fila de clasificación horizontal por su posición en la secuenca de filas de clasificación horizontal. Para determinar este valor, cuente los valores de clasificación horizontal (ACROSS). No puede combinarse con una especificación de nombre de campo en la misma hoja de estilos.
- OFF
- Desactiva el ajuste de los valores ACROSS. OFF es el valor predeterminado.
- ON
- Activa el ajuste de los valores ACROSS.
Note: WRAP=ON no se admite con JUSTIFY.
En la siguiente solicitud, emitida frente al origen de datos GGPRODS, VENDOR_NAME es un campo ACROSS:
TABLE FILE GGPRODS HEADING " PRODUCT REPORT" " " PRINT PRODUCT_ID UNIT_PRICE/D5 ACROSS VENDOR_NAME BY SIZE WHERE VENDOR_NAME GT 'B' AND VENDOR_NAME LT 'F' ON TABLE PCHOLD FORMAT PDF ON TABLE SET STYLE * TYPE=REPORT, GRID=OFF, $ TYPE=REPORT, COLUMN=PRODUCT_ID, WIDTH=.25, $ TYPE=REPORT, COLUMN=UNIT_PRICE, WIDTH=.25, $ ENDSTYLE END
Como se explica en la imagen, la salida es demasiado ancha para un panel, ya que algunos de los valores de los campos ACROSS (nombres de proveedores) son superiores a la suma de las columnas de código de producto y precio de unidad situadas debajo.
La siguiente versión de la solicitud envuelve o ajusta los valores ACROSS (TYPE=ACROSSVALUE, WRAP=ON ,$):
TABLE FILE GGPRODS HEADING " PRODUCT REPORT" " " PRINT PRODUCT_ID UNIT_PRICE/D5 ACROSS VENDOR_NAME BY SIZE WHERE VENDOR_NAME GT 'B' AND VENDOR_NAME LT 'F' ON TABLE PCHOLD FORMAT PDF ON TABLE SET STYLE * TYPE=REPORT, GRID=OFF, $ TYPE=REPORT, COLUMN=PRODUCT_ID, WIDTH=.25, $ TYPE=REPORT, COLUMN=UNIT_PRICE, WIDTH=.25, $ TYPE = ACROSSVALUE, WRAP=ON,$ ENDSTYLE END
El informe ahora sí cabe en un panel, como se aprecia en la imagen siguiente.
Cuando los campos OVER se han definido con nombres AS en blanco (el valor del título de la columna está vacío ' '), puede usarlos para construir un informe con varias líneas de datos que aparecen en una cuadrícula alineada.
En este tipo de informe, los títulos de columnas se suelen indicar añadiendo varias líneas correspondientes a los encabezados de página, en vez de usando los títulos predeterminados mostrados a la izquierda de los valores de campos de las columnas. Para mostrar los campos OVER con títulos únicos, aprovechando estas nuevas características de alineación, puede colocar los títulos de las columnas en campos independientes e incluirlos como campos, dentro de una determinada solicitud.
El ejemplo siguiente explica el uso de OVER con nombres AS en blanco y WRAP para construir un informe con varias líneas de datos:
TABLE FILE GGPRODS PRINT PACKAGE_TYPE AS '' SIZE AS '' OVER VENDOR_NAME AS '' BY PRODUCT_ID AS '' BY PRODUCT_DESCRIPTION AS '' ON TABLE SUBHEAD "Gotham Grinds" "Products Details" HEADING " Code <+0>Description<+0>Size <+0>Package" -*" <+0> <+0>Vendor" " <+0>Vendor" ON TABLE PCHOLD FORMAT PDF ON TABLE SET STYLE * TYPE=REPORT, FONT=ARIAL, SIZE=10, SQUEEZE=ON,$ TYPE=REPORT, COLUMN=PACKAGE_TYPE, SQUEEZE=.5 ,$ TYPE=REPORT, COLUMN=VENDOR_NAME, WRAP=1 ,$ TYPE=REPORT, BORDER=ON, $ TYPE=HEADING, LINE=1, ITEM=1, BORDER=ON, $ TYPE=HEADING, LINE=1, ITEM=2, BORDER=ON, POSITION=PRODUCT_DESCRIPTION,$ TYPE=HEADING, LINE=1, ITEM=3, BORDER=ON, POSITION=SIZE ,$ TYPE=HEADING, LINE=1, ITEM=4, BORDER=ON, POSITION=PACKAGE_TYPE, $ TYPE=HEADING, LINE=2, ITEM=1, BORDER=ON, $ TYPE=HEADING, LINE=2, ITEM=2, BORDER=ON, POSITION=PACKAGE_TYPE,$ ENDSTYLE END
El informe muestra que el tipo de paquete y el tamaño se han colocado sobre el nombre del proveedor. El encabezado de página presenta los títulos correspondientes. En el encabezado, el tipo de paquete y el tamaño también se han colocado sobre el título Nombre del proveedor. Observe que los datos del nombre del proveedor han quedado ajustados para mantener la alineación.
El ancho del título y los datos de la columna de cada valor OVER se determina mediante un valor SQUEEZE o WRAP individual. El tamaño del título se ajusta automáticamente al ancho de la columna de datos ajustados. Si el título de la columna es más ancho que el ancho definido para el ajuste de datos, puede definir un título más pequeño o añadir sus propios títulos como campos OVER cuyo tamaño pueda ajustarse de manera independiente.
Los ejemplos siguientes explican cómo construir un informe con OVER y WRAP que tenga títulos de columnas más largos que el tamaño especificado para WRAP.
La siguiente solicitud define dos campos virtuales que contienen los títulos de las columnas de los campos Nombre de producto y Nombre de proveedor. A continuación, imprime cada campo virtual junto a su campo de datos relacionado y asigna un nombre AS en blanco a cada uno. El primer campo virtual y el primer campo de datos quedan colocados sobre el segundo campo virtual y el segundo campo campo de datos:
DEFINE FILE GGPRODS TITLE_PROD/A20 = 'Product Description'; TITLE_VEND/A20 = 'Vendor Name'; END TABLE FILE GGPRODS PRINT TITLE_PROD AS '' PRODUCT_DESCRIPTION AS '' OVER TITLE_VEND AS '' VENDOR_NAME AS '' BY PRODUCT_ID AS '' ON TABLE SUBHEAD "Gotham Grinds" "Products Details" ON TABLE PCHOLD FORMAT PDF ON TABLE SET STYLE * TYPE=REPORT, FONT=ARIAL, SIZE=10, SQUEEZE=ON,$ TYPE=REPORT, COLUMN=TITLE_PROD , SQUEEZE=1.25 ,$ TYPE=REPORT, COLUMN=TITLE_VEND , SQUEEZE=1.25 ,$ TYPE=REPORT, COLUMN=PRODUCT_DESCRIPTION, WRAP=.75 ,$ TYPE=REPORT, COLUMN=VENDOR_NAME, WRAP=.75 ,$ TYPE=REPORT, BORDER=ON, $ ENDSTYLE END
La salida indica que los títulos y los datos están alineados correctamente.
Puede usar el atributo WRAPGAP en una hoja de estilos para controlar el espacio entre líneas ajustadas de la salida de informes PDF o PostScript.
type=component, WRAPGAP={ON|OFF|n}
donde:
- component
- Es el componente con líneas ajustadas.
- ON
- No deja ningún espacio entre las líneas ajustadas. ON equivale a especificar 0.0 para n.
- OFF
- Coloca los datos ajustados en la siguiente línea. OFF es el valor predeterminado.
- n
- Es un número mayor o igual a cero, que especifica cuánto espacio dejar entre las líneas ajustadas (empleando la unidad de medida especificada por el atributo UNITS). Al establecer n en cero no se deja un espacio entre las líneas ajustadas y equivale a activar WRAPGAP.
En la siguiente solicitud, se ha activado el ajuste para la columna ADDRESS_LN3 del informe:
TABLE FILE EMPLOYEE
PRINT ADDRESS_LN3
BY LAST_NAME BY FIRST_NAME
WHERE LAST_NAME LE 'CROSS'
ON TABLE PCHOLD FORMAT PDF
ON TABLE SET PAGE NOPAGE
ON TABLE SET STYLE *
type=report, grid=on, $
type=data, topgap=0.2, bottomgap=0.2, $
type=data, wrapgap=off, $
type=REPORT, column=ADDRESS_LN3, wrap=1.0 ,$
ENDCuando WRAPGAP está desactivado cada línea ajustada queda colocada en la siguiente línea del informe:
Cuando WRAPGAP está activado, las líneas ajustadas quedan colocadas directamente debajo la una de la otra.
Sólo puede especificar WRAPGAP para las columnas que tienen activado el ajuste (atributo WRAP o parámetro activado o un número). Los atributos TOPGAP y BOTTOMGAP especifican el espacio dejado encima y debajo de un componente de informe. Al incrementar los valores de estos atributos hace que la reducción de espacio entre las líneas ajustadas sea más aparente.
