Microsoft cambió el formato y la estructura del libro en Excel 2007. El nuevo archivo .xlsx es una compilación binaria de un grupo de archivos xml. La generación de este nuevo formato de archivos, mediante WebFOCUS, es un proceso de dos pasos que consiste en generar los archivos xml que contienen la salida de informe y comprimir los documentos xml en un formato .xlsx binario. El Servidor de informes se encarga de llevar a cabo el proceso de generación de xml. El proceso de compresión puede ser realizado por el cliente (Miniservidor de WebFOCUS) o por el servidor (JSCOM3):

• Miniservidor de WebFOCUS. El Cliente WebFOCUS efectúa el proceso de compresión dentro del servidor de aplicaciones. Esto puede realizarse dentro del cliente local, o mediante un cliente remoto. El método de miniservidor es el que se emplea por defecto con cada cliente WebFOCUS; el cliente por defecto apunta hacia sí mismo.
• JSCOM3. La capa java del Servidor de informes lleva a cabo el proceso de compresión. Puede usar esta opción en entornos seguros, ya que no requiere acceso de URL a un cliente remoto.

Para designar el método y ubicación de la compresión, establezca EXCELSERVRURL en un URL (para el miniservidor de WebFOCUS) o en un espacio en blanco (para JSCOM3). Puede establecer este valor para un procedimiento específico o para todo el entorno:

• Para un procedimiento. Emita el comando SET EXCELSERVURL dentro del procedimiento.
• Para el entorno completo. Modifique la variable IBIF_excelservurl, en la Consola de administración de WebFOCUS, seleccionando:

  Configuración/Propiedades del cliente/General/IBIF_excelservurl

  Para más información acerca de cómo acceder a la Consola de administración de WebFOCUS y establecer la variable IBIF_excelservurl, consulte el manual Seguridad y administración de WebFOCUS.

El valor asignado a EXCELSERVURL determina si es el miniservidor de WebFOCUS el que lleva a cabo la operación de compresión, o JSCOM3.

• Especificar el miniservidor. Para especificar el uso del miniservidor de WebFOCUS, establezca el parámetro EXCELSERVURL, o IBIF_variable, en el URL de una configuración de cliente WebFOCUS 7.7.02 o posterior. Por ejemplo,

  En un procedimiento:

  SET EXCELSERVURL = http://servername:8080/ibi_apps									

  En la Consola de administración de WebFOCUS:

  IBIF_excelservurl = http://servername:8080/ibi_apps									

• Especificar JSCOM3. Para especificar el uso de JSCOM3 en el servidor de informes actual, deje EXCELSERVURL en blanco o en una cadena vacía.

  En un procedimiento:

  SET EXCELSERVURL = ''

  En la Consola de administración de WebFOCUS:

  IBIF_excelservurl = ''

Cada cliente WebFOCUS incluye por defecto la siguiente definición de URL, apuntando hacia sí misma:

&URL_PROTOCOL://&SERVER_NAME:&SERVER_PORT&IBIF_webapp

Puede especificar que el informe se guarde en un libro de Excel 2007/2010, aparezca en el navegador o se abra en la aplicación Excel 2007/2010.

ON TABLE {PCHOLD|HOLD} AS name FORMAT EXL07

donde:

PCHOLD

Muestra el libro generado en el navegador o en la aplicación Excel 2007/2010, según la configuración de su escritorio. Para más información, consulte Cómo ver libros de Excel en el navegador en lugar de la aplicación Excel.

HOLD

Guarda el libro con una extensión .xlsx de la ubicación designada.

nombre

Especifica un nombre de archivo para el libro generado.

Nota: El nombre AS sólo se usa con PCHOLD cuando la opción Guardar informe se ha establecido en YES, para la extensión de archivos .xlsx, en las Propiedades de redireccionamiento del Cliente WebFOCUS. Al abrir un informe en el navegador, los usuarios recibirán un aviso que indica que abran o guarden la salida del informe con el nombre de archivo designado. En informes abiertos con la aplicación Excel 2007/2010, el libro generado mantiene el nombre AS designado. Para más información, consulte el manual Seguridad y administración de WebFOCUS.

Puede actualizar Excel 2000 y 2003 para que lean los libros de Excel 2007 y 2010, mediante el Paquete de compatibilidad de Microsoft Office, disponible en el Centro de descarga de Microsoft (http://www.microsoft.com/downloads/en/default.aspx). Al abrir un archivo con la extensión .xlsx (libro de Excel 2007/2010), el Paquete de compatibilidad de Microsoft Office realiza la conversión necesaria para que Excel 2000/2003 pueda leer y abrirlo.

Además del Paquete de compatibilidad de Microsoft Office, es importante activar la opción Guardar como de las propiedades de redireccionamiento del Cliente WebFOCUS, para que Excel 2000/2003 pueda abrir la salida de informes de Excel 2007/2010 sin que los usuarios tengan que guardarla en su equipo, con la extensión de archivo .xlsx. La opción Guardar como de las propiedades de redireccionamiento configuran el modo en que el Cliente WebFOCUS envía cada tipo de archivo de salida de informe al equipo del usuario. Puede configurar esta opción de las siguientes maneras:

• Opción Guardar como desactivada (NO). La propiedad de redireccionamiento del Cliente WebFOCUS Guardar como está desactivada por defecto. Cuando la opción Guardar como está desactivada, el Cliente WebFOCUS envía la salida del informe a los equipos de los usuarios en la memoria, con la asociación de aplicación especificada para el formato del informe, en el archivo de configuración Propiedades de redireccionamiento del Cliente WF (mime.wfs).

  La asociación de aplicación para Excel 2007/2010 es:

  application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

  Los equipos de usuario que no tengan instalado Excel 2007/2010, no reconocerán la asociación de aplicación de Excel 2007/2010 y aparecerá el siguiente mensaje:

  

  Los usuarios de Excel 2000/2003 pueden seleccionar Guardar e introducir un nombre de archivo con la extensión .xlsx, para guardar la salida de informes en su equipo. Ahora, los usuarios podrán abrir el archivo .xlsx directamente desde Excel 2000/2003.

• Opción Guardar como activada (YES). Cuando la opción de redireccionamiento de WebFOCUS Guardar como está activada, el Cliente WebFOCUS envía la salida de informes al usuario como un archivo con la extensión especificada en el archivo de configuración de Propiedades de redireccionamiento del Cliente WebFOCUS (mime.wfs).

  Tras recibir el informe, Windows presenta el aviso Descarga de archivo, preguntando al usuario si desea abrir o guardar el archivo con el tipo de aplicación identificado. Como puede observar en la siguiente imagen, el aviso Descarga de archivo muestra el nombre junto con la extensión de archivo .xlsx para la salida de informe, reconocida como un archivo de tipo Excel 2007/2010.

  

  Nota: El aviso de descarga aparece para todos los usuarios, incluidos los que tienen Excel 2007/2010 instalado en su equipo.

  Si el usuario de Excel 2000/2003 decide abrir el archivo, el Paquete de compatibilidad de Microsoft Office reconocerá la extensión de archivo .xslx y realizará la conversión necesaria para que Excel 2000/2003 pueda leer el libro de Excel 2007/2010.

  Si el usuario de Excel 2007/2010 decide abrir el archivo, Excel 2007/2010 reconocerá la extensión de archivo .xslx y leerá el libro de Excel 2007/2010.

Para más información sobre las Propiedades de redireccionamiento del Cliente WebFOCUS, consulte la Guía de seguridad y administración de WebFOCUS.

Cada formato de WebFOCUS se traduce a un formato numérico de Excel. El valor numérico aparece para la celda seleccionada en la barra de fórmulas de Excel. Dentro de la celda, aparece el valor con la máscara de formato aplicada.

Los formatos de WebFOCUS de los siguientes tipos de datos quedan traducidos a las máscaras de formato de Excel 2007/2010, que son compatibles con todas las opciones de edición del libro resultante:

• Tipos de datos: E, F, D , I, P.
• Opción de edición Coma (C).
• Supresión de ceros (S).
• Cero inicial (L).
• Símbolo de divisa variable (M).

  Nota: Excel no es compatible, de forma automática, con la colocación de símbolos de divisa y otros formatos sólo en la primera fila de datos. Aunque se pueden definir otros formatos por celda, si el usuario clasifica los datos, el primer formato se desplaza junto con la primera fila, según el valor de clasificación. Por tanto, los símbolos de divisa fija se presentan en cada fila de datos, de un modo similar al de los símbolos variables:

• Supresión de comas (c).
• Signo menos de lado derecho (-).
• Crédito negativo (CR).
• Corchete negativo (B).
• Símbolo de divisa fija extendida (!d, !e, !l, !y).
• Símbolo de divisa variable extendida (!D, !E, !L, !Y).
• Porcentaje (%).

En el siguiente ejemplo, el campo DOLLARS tiene asignado distintos formatos numéricos para demostrar la variedad de opciones disponibles. Los títulos de las columnas se han modificado para mostrar las opciones de formato de WebFOCUS que hemos aplicado.

TABLE FILE GGSALES
SUM DOLLARS/D12.2 AS 'D12.2'
    DOLLARS/D12C  AS 'D12C'
    DOLLARS/D12CM AS 'D12CM'
BY REGION
BY CATEGORY
ON TABLE PCHOLD FORMAT EXL07
ON TABLE SET BYDISPLAY ON
END

En el libro resultante, observe como la celda C2, que contiene el valor DOLLAR de Midwest Coffee, presenta el valor con el formato D12.2 de WebFOCUS, con la coma y dos posiciones decimales. En la barra de fórmulas, el valor aparece sin ningún formato. Examine el valor de DOLLAR de cada fila, para comprobar que el valor mostrado en la barra de fórmulas no haya sufrido cambios; los únicos que cambian son los valores presentados en cada celda.

Además, tenga en cuenta que, cuando SET BYDISPLAY ON, los valores del campo BY se repiten en cada fila de la hoja de cálculo. Esto crea filas de datos completamente cualificadas, que pueden utilizarse con clasificaciones de datos, filtros y funciones de tabla diferentes, en Excel, sin perder información importante. Esta configuración es las más idónea para todas las hojas de cálculo:

El siguiente ejemplo usa el formato Dólar fijo (N), además de varias opciones de formato combinadas. Cada opción de formato de WebFOCUS queda traducida a la máscara de formato correspondiente de Excel 20007/2010, y aplicada al valor de la celda:

TABLE FILE GGSALES
SUM BUDDOLLARS/D12N
    DOLLARS/D12M
COMPUTE OVERBUDGET/D12BMc=BUDDOLLARS-DOLLARS; AS 'Over Budget'
BY REGION
BY CATEGORY
ON TABLE PCHOLD FORMAT EXL07
ON TABLE SET BYDISPLAY ON
END

Observe como el formato numérico fijo, definido para la columna BUDDOLLARS (Columna C), presenta el símbolo de moneda local en una posición fija, dentro de cada celda, independientemente del tamaño del valor de datos. En la barra de fórmulas, los valores del campo calculado Por encima de presupuesto se pasan como valor negativo, cuando corresponda. En las celdas, el estilo con corchetes se aplica a los valores negativos como parte de la máscara de formato personalizada de Excel 2007/2010:

Nota: Excel no es compatible, de forma automática, con la colocación de símbolos de divisa y otros formatos sólo en la primera fila de datos. Aunque se pueden definir otros formatos por celda, si el usuario clasifica los datos, el primer formato se desplaza junto con la primera fila, según el valor de clasificación. Por tanto, los símbolos de divisa fija se presentan en cada fila de datos, de un modo similar al de los símbolos variables.

Los encabezados y pies se pasan a Excel como una sola cadena de caracteres, por defecto. No se puede colocar marcadores de posición en cada línea. Los campos numéricos y fechas pasados en encabezados y pies, quedan pasados, a su vez, como cadenas de texto, dentro del contenido total del encabezado o pie.

Para mostrar campos numéricos y fechas como valores numéricos o de fecha, en los encabezados y pies, emplee HEADALIGN=BODY en la hoja de estilos, para definir cada elemento del encabezado como celda individual. Cada celda que contenga valores numéricos o de fecha, queda pasada como el valor correspondiente, con la máscara de formato asociada. Para información sobre el atributo HEADALIGN, consulte Cómo alinear un elemento de ´encabezado o pie en un informe HTML, EXL07, EXL2K o PDF.

Nota: Los ajustes de la notación decimal continental (CDN por sus siglas en inglés) del cuerpo del informe, se activan mediante los ajustes regionales del escritorio cliente. En los encabezados y pies en que no se haya especificado HEADALIGN, los valores numéricos se convierten en encabezados de texto, con los ajustes de CDN definidos por el procedimiento, ya que la aplicación no tiene acceso a los valores de texto insertados. En los escenarios de HEADALIGN en que los elementos del encabezado estén colocados en celdas individuales, parecidas a la tabla de datos, el Servidor de informes no aplica los ajustes de CDN y se restauran los ajustes regionales originales del escritorio.

En las columnas de datos, todos los formatos de divisa se traducen utilizando las máscaras de formatos de Excel 2007/2010, que emplean las reglas de puntuación definidas en la configuración regional del escritorio.

En los idiomas que usan la notación decimal continental, las definiciones de divisa designan el uso de una coma como separador decimal y el de un punto, como separador de millares, así que D12.2CM puede presentar el valor como $ 9.999,99, en lugar del valor en inglés (EE UU) de $ 9,999.99. En encabezados y pies, puede designar que la puntuación se convierta a la notación decimal continental, mediante el comando SET CDN=ON. Con esta configuración, los datos insertados en las cadenas de texto de encabezado o pie, aparecen con el formato de puntuación convertida. Especifique HEADALIGN=BODY para delinear los elementos como celdas individuales y mantener el formato numérico del campo, que sigue las mismas reglas que los datos de informe, en las columnas de datos.

La mayoría de las fechas traducidas o inteligentes pueden enviarse a Excel 2007/2010 como valores de fecha estándar con máscaras de formato, permitiendo que Excel las utilice en funciones, fórmulas y secuencias de clasificación.

La siguiente solicitud, emitida frente al origen de datos GGSALES, crea la fecha Enero 1, 2010 y la convierte en cuatro formatos de fecha con texto traducido:

DEFINE FILE GGSALES
NEWDATE/MDYY = '01/01/2010';
WRMtrDY/WRMtrDY = NEWDATE;
wDMTY/wDMTY= NEWDATE;
wrDMTRY/wrDMTRY= NEWDATE;
wrYMtrD/wrYMtrD= NEWDATE;
END
TABLE FILE GGSALES
SUM DATE NOPRINT
NEWDATE WRMtrDY wDMTY wrDMTRY wrYMtrD
ON TABLE PCHOLD FORMAT EXL07
END

La siguiente tabla indica cómo deben aparecer las fechas:

Los formatos de fecha que no especifican un valor de día explícito están definidos como el valor de fecha del primer día del mes. Por tanto, el valor colocado en la celda puede ser distinto del valor de componente de fecha en el campo de origen de datos, lo que puede generar resultados inesperados cuando se emplea para cálculos de clasificación o fechas en una fórmula Excel.

La tabla siguiente muestra cómo quedan representados los formatos de fechas WebFOCUS en EXL07. La tabla muestra cómo se retiene el valor en la celda y el modo en que se genera la visualización mediante la máscara de formato correspondiente al formato de fecha de WebFOCUS.

DATEFLD/MDYY = '01/02/2010'

La siguiente solicitud, basada en el origen de datos GGSALES, crea la fecha Enero 2, 2010 y la pasa a Excel 2007/2010 con los formatos MDYY, DMYY, MY y MTDY:

DEFINE FILE GGSALES
NEWDATE/MDYY = '01/02/2010';
END
TABLE FILE GGSALES
SUM DATE NOPRINT
NEWDATE AS 'MDYY' NEWDATE/DMYY AS 'DMYY' NEWDATE/MY AS 'MY' 
        NEWDATE/MTY AS 'MTY' NEWDATE/MTDY AS 'MTDY'
ON TABLE PCHOLD FORMAT EXL07 
END

Las columnas D y E presentan valores de datos reales, con máscaras de formato. En Excel 2007/2010, aparecen con una combinación de mayúsculas y minúsculas. Puesto que el formato MTY no tiene un componente de fecha, el valor de fecha almacenado es el primero de Enero 2010 (1/1/2010), no el segundo de Enero 2010 (1/2/2010):

Las fechas con formato de componente individual (por ejemplo, D, Y, M, W) se pasan a Excel como valores numéricos que pueden utilizarse como parámetros de funciones de fechas Excel. Los valores se pasan en el formato general y Excel los reconoce como números.

La siguiente solicitud, basada en el origen de datos GGSALES, crea la fecha Enero 1, 2010 y extrae componentes de fechas numéricos para, posteriormente, pasarlos a Excel 2007/2010:

DEFINE FILE GGSALES
NEWDATE/MDYY = '01/01/2010';
D/D= NEWDATE;
Y/Y = NEWDATE;
W/W=NEWDATE;
w/w=NEWDATE;
M/M = NEWDATE;
YY/YY = NEWDATE;
END
TABLE FILE GGSALES
SUM DATE NOPRINT
NEWDATE D Y W w M YY
ON TABLE PCHOLD FORMAT EXL07 
END

La salida es:

Los formatos que contienen un componente Trimestre siempre se pasan a Excel como cadenas de texto, ya que Excel no los admite.

La siguiente solicitud, emitida frente al origen de datos GGSALES, crea la fecha January 1, 2010 y la convierte en formatos de fecha que contienen un componente Trimestre:

DEFINE FILE GGSALES
NEWDATE/MDYY = '01/01/2010';
Q/Q= NEWDATE;
QY/QY = NEWDATE;
YBQ/YBQ=NEWDATE;
END
TABLE FILE GGSALES
SUM DATE NOPRINT
NEWDATE Q QY YBQ
ON TABLE PCHOLD FORMAT EXL07 
END

En Excel 2007 y 2010, las celdas que contienen fechas con componentes de Trimestre, tienen el formato General. Para verlas, abra el cuadro de diálogo Formato de celdas.

La salida es:

Los formatos de fecha que no contienen la información suficiente para presentar un resultado de fecha válido, en Excel, no quedan traducidos en un valor, incluidos los formatos que no contienen información sobre el año o mes. Las fechas se envían a Excel en forma de texto. Ante la ausencia de información completa, el año se establece en el año actual por defecto; el valor enviado será incorrecto si se ha pasado este tipo de formato como valor de fecha. Los formatos siguientes no se envían como valores:

• MT, MTR, Mt, Mtr
• W, w, WR, wr

Al pasar formatos de fecha a Excel 2007/2010 con máscaras de formato, todos los nombres de mes y día presentan una combinación de mayúsculas y minúsculas, independientemente de lo especificado en el formato de WebFOCUS. Sin embargo, puesto que estos valores siempre se envían en forma de texto, se aplica el uso de mayúsculas y minúsculas definido en el formato WebFOCUS, en la celda resultante.

La siguiente solicitud, emitida frente al origen de datos GGSALES, crea la fecha Enero 1, 2010 y la convierte en formatos de fecha definidos como el nombre del mes o día:

DEFINE FILE GGSALES
NEWDATE/MDYY = '01/01/2010';
MT/MT= NEWDATE;
MTR/MTR= NEWDATE;
Mtr/Mtr = NEWDATE;
WR/WR = NEWDATE;
wr/wr = NEWDATE;
END
TABLE FILE GGSALES
SUM DATE NOPRINT
NEWDATE MT MTR Mtr WR wr
ON TABLE PCHOLD FORMAT EXL07 
END

En Excel 2007 y 2010, las celdas que contienen los días aparecen en el formato General. Para verlas, abra el cuadro de diálogo Formato de celdas.

La salida es:

[TYPE=REPORT,] XLSXPAGESETS={ON|OFF} [,PAGESIZE={pagesize|LETTER}]
 [,ORIENTATION={PORTRAIT|LANDSCAPE}] [,TOPMARGIN=n] [,BOTTOMMARGIN=m],$

donde:

XLSPAGESETS={ON|OFF}

ON aplica la configuración de página definida en la solicitud de WebFOCUS, a la configuración de página de la hoja de cálculo de Excel. OFF mantiene la configuración por defecto de las páginas, definida en el libro estándar de Excel. OFF es el valor predeterminado.

n

Establecer el margen superior de la hoja de cálculo en las unidades identificadas por el parámetro UNITS (pulgadas por defecto). El valor predeterminado es .25.

m

Establece el margen inferior de la hoja de cálculo en las unidades identificadas por el parámetro UNITS (pulgadas por defecto). El valor predeterminado es .25.

pagesize

Es uno de los valores de PAGESIZE compatibles con las hojas de estilos de WebFOCUS, como se explica en Cómo seleccionar el tamaño, la orientación y el color de la página. El tamaño por defecto es LETTER.

PORTRAIT|LANDSCAPE

PORTRAIT muestra el informe en la dimensión más estrecha de una página vertical, resultando en una página más larga que ancha. PORTRAIT es el valor predeterminado.

LANDSCAPE muestra el informe en la dimensión más ancha de una página horizontal, resultando en una página más ancha que larga.

TYPE={PAGEHEADER|PAGEFOOTER},OBJECT=IMAGE,
 IMAGE=imagename, JUSTIFY={LEFT|CENTER|RIGHT} 
 [,DISPLAYON={FIRST|NOT-FIRST}] [,SIZE=(w								h)],$

donde:

PAGEHEADER

Coloca la imagen en el encabezado de la hoja de cálculo.

PAGEFOOTER

Coloca la imagen en el pie de la hoja de cálculo.

imagename

Es el nombre de un archivo de imagen válido, que se va a colocar en el encabezado o en el pie. La imagen debe estar situada en la ruta de aplicación definida. Los tipos de imagen compatibles son GIF y JPEG.

JUSTIFY={LEFT|CENTER|RIGHT}

Identifica el área del encabezado o pie que contiene la imagen y la justificación, o la posición dentro del área definida.

DISPLAYON

Determina si la imagen queda colocada sólo en la primera página, o en todas excepto la primera. Omita este atributo para colocar la imagen en todas las páginas.

Los valores válidos son:

FIRST coloca la imagen sólo en la primera página.

NOT-FIRST coloca la imagen en todas las páginas excepto la primera.

SIZE=(w h)

Es el tamaño de la imagen. De forma predeterminada, la imagen se añade en su tamaño original.

w es el ancho de la imagen, en la unidad de medida especificada en el parámetro UNITS.

h es la altura de la imagen, en la unidad de medida especificada en el parámetro UNITS.

La siguiente solicitud, basada en el origen de datos GGSALES, coloca la imagen ibi_logo.gif en el área izquierda del encabezado de la primera página, y en el área derecha del resto de las páginas de la hoja de cálculo resultante. Coloca la imagen webfocus1.gif en el área central del pie de cada página:

TABLE FILE GGSALES
SUM DOLLARS UNITS BUDDOLLARS BUDUNITS 
BY REGION
BY ST
BY CATEGORY
BY PRODUCT
ON TABLE SET BYDISPLAY ON
ON TABLE PCHOLD FORMAT EXL07 
ON TABLE SET STYLE *
FONT=ARIAL,SIZE=12,
XLSXPAGESETS=ON,TOPMARGIN=1,BOTTOMMARGIN=1,ORIENTATION=LANDSCAPE,
PAGESIZE=LETTER,$
TYPE=TITLE, COLOR=WHITE, BACKCOLOR=GREY,$
TYPE=PAGEHEADER, OBJECT=IMAGE, JUSTIFY=LEFT, IMAGE=IBI_LOGO.GIF, DISPLAYON=FIRST,$
TYPE=PAGEHEADER, OBJECT=IMAGE, JUSTIFY=RIGHT, IMAGE=IBI_LOGO.GIF,  DISPLAYON=NOT-FIRST,$
TYPE=PAGEFOOTER, OBJECT=IMAGE, JUSTIFY=CENTER, IMAGE=webfocus1.gif, $
END

La primera página de la salida presenta la imagen ibilogo.gif en el área izquierda del encabezado, y webfocus1.gif, en el área central del pie.

La segunda página de la salida presenta la imagen ibilogo.gif en el área derecha del encabezado, y webfocus1.gif, en el área central del pie.

• El tamaño de los encabezados y pies en Excel no se ajusta automáticamente en base al contenido de las áreas. Defina los márgenes de página, utilizando la configuración correspondiente, para establecer el espacio necesario para las imágenes en cada página del informe.
• El ajuste del tamaño basado en la altura y ancho especificados, no es proporcional. El ajuste del tamaño puede distorsionar la imagen.
• Los campos de imágenes BLOB no son compatibles con esta edición.

Puede colocar imágenes de marca de agua en los encabezados de Excel, para que aparezcan en todas las páginas imprimidas de la hoja de cálculo generada.

Excel coloca las imágenes en la página, empezando por el encabezado, de izquierda a derecha, y siguiendo por el pie, también de izquierda derecha. Puede que las imágenes de mayor tamaño se superpongan a las imágenes anteriores en el orden de presentación del encabezado. En los informes que incluyan un logo en el área izquierda y una marca de agua centrada en la página, la imagen de fondo de la marca debe ser transparente para que no se solape con la imagen del logo.

En Excel, las imágenes se colocan en la primera página. A continuación, se coloca el resto del contenido de la hoja de cálculo encima de la imagen. Los textos de las celdas y los estilos, como el color de fondo o los objetos de dibujo, se colocan encima de las imágenes. Excel es compatible con la transparencia en dibujos de objetos e imágenes, pero no en el color de fondo de las celdas. BACKCOLOR hace que se cubran las imágenes de la página.

La siguiente solicitud, basada en el origen de datos GGSALES, emplea la imagen internaluseonly.gif como marca de agua, para que aparezca en el fondo de todas las páginas de la hoja de cálculo. Aunque la imagen aparece en el área central del encabezado, es lo suficientemente grande como para ocupar toda la página. El fondo es transparente, así que no cubre las imágenes de logo situadas en la parte izquierda del encabezado y en el centro del pie:

TABLE FILE GGSALES
SUM DOLLARS UNITS BUDDOLLARS BUDUNITS 
BY REGION
BY ST
BY CATEGORY
BY PRODUCT
ON TABLE SET BYDISPLAY ON
ON TABLE PCHOLD FORMAT EXL07 
ON TABLE SET STYLE *
XLSXPAGESETS=ON,
TOPMARGIN=1,BOTTOMMARGIN=1,LEFTMARGIN=1, RIGHTMARGIN=1, ORIENTATION=LANDSCAPE,PAGESIZE=LETTER,$
TYPE=PAGEHEADER, OBJECT=IMAGE, JUSTIFY=LEFT, IMAGE=IBI_LOGO.GIF, DISPLAYON=FIRST, $
TYPE=PAGEHEADER, OBJECT=IMAGE, JUSTIFY=CENTER, IMAGE=INTERNALUSEONLY.GIF, $
TYPE=PAGEFOOTER, OBJECT=IMAGE, JUSTIFY=RIGHT, IMAGE=WEBFOCUS1.GIF, $
END

La primera página de la hoja de cálculo generada muestra la imagen de la marca de agua por debajo de los datos. Esta imagen aparece en todas las páginas de la hoja de cálculo.

El redireccionamiento está desactivado por defecto para la extensión de archivos .xlsx, ya que permite la ejecución de drill-downs, independientemente de que el equipo del usuario esté configurado para abrir Excel en el navegador, o como una aplicación fuera de éste.

Para más información sobre el redireccionamiento del Cliente WebFOCUS y los informes de drill-down de Excel, consulte Redireccionamiento e informes drill-down de Excel.

Para permitir el uso de más tipos de archivos de plantilla, se ha mejorado el atributo de nombre de archivo de plantilla, que ahora incluye la extensión. Si no se ha especificado una extensión en el nombre de la plantilla, se utiliza la extensión de archivo por defecto, XLTX.

ON TABLE PCHOLD FORMAT EXL07 TEMPLATE template_name SHEETNUMBER n							

donde:

template_name

Es el nombre de la plantilla de Excel (libro), incluidos el nombre del archivo y la extensión, que reside en la ruta de búsqueda del directorio de aplicaciones del Servidor de informes de WebFOCUS. Por ejemplo, IPOLICY.XLTX, PRINTSHEETS.XLTM o DASHBOARD.XLSM. Si no se ha proporcionado la extensión, se utiliza .XLTX.

n

El número de la hoja de cálculo de Excel que se va a reemplazar en el archivo de plantilla (libro).

La plantilla de libro empleada por el procedimiento de WebFOCUS, debe incluir hojas de cálculo válidas.

• La hoja actualizada debe existir en el libro, ya que WebFOCUS está reemplazando la hoja de cálculo, no insertándola. Si la hoja designada no existe, el procedimiento dará lugar a un error.
• En cualquier archivo de plantilla, una (como mínimo) de las hojas del libro debe tener una celda con un valor válido (espacio en blanco u otro cualquiera). Para reemplazar una hoja de cálculo de una plantilla que sólo contenga hojas en blanco, sustituya una celda de cualquier hoja por un espacio, y guarde la acción. Esto creará copias de las hojas de cálculo, para que WebFOCUS acceda a ellas y las actualice.

Añada el atributo ROWOVERFLOW a su hoja de estilos de WebFOCUS

TYPE=REPORT, ROWOVERFLOW={ON|OFF|PBON}, [ROWLIMIT={n|MAX}...

donde:

ON

Activa las hojas de cálculo con desbordamiento.

OFF

Desactiva las hojas de cálculo con desbordamiento. OFF es el valor predeterminado.

PBON

Inserta saltos de página de WebFOCUS que muestran el encabezado y pie de página y los títulos de columnas, en los lugares correspondientes, dentro de las filas de la hoja de cálculo. Esta opción no hace que se abra una nueva hoja de cálculo al detectarse un salto de página de WebFOCUS.

ROWLIMIT=n

Establece el valor de destino del número de filas que se va a incluir en una hoja de cálculo, en n filas. El valor por defecto es LINES (75, por defecto).

ROWLIMIT=MAX

En la salida de EXL07, establece el valor de destino del número de filas que se va a incluir en una hoja de cálculo, en 1,048,000 filas.

Este atributo funciona con todos los formatos de salida Excel. En los demás tipos de salida, se ignora el atributo ROWOVERFLOW de hoja de estilos, sin que el flujo de datos se vea afectado.

• El encabezado del informe queda colocado una sola vez al principio de la primera hoja. El pie del informe queda colocado una sola vez en la parte inferior de la última hoja de desbordamiento.
• A menos que esté utilizando la propiedad PBON, los encabezados y los títulos de columnas de la hoja de cálculo, aparecen repetidos en la parte superior del original, y en cada una de las hojas con desbordamiento, posteriores. Los pies de de hoja de cálculo quedan colocados en la parte inferior de la hoja de cálculo original y de cada hoja de desbordamiento posterior. Los valores de datos aparecen en la fila de datos superior de cada hoja de desbordamiento como si se tratase de una página nueva estándar.
• Los totales de línea del informe aparecen en la parte inferior de la última página de desbordamiento, justo encima de los pies de tabla y de la última página.
• Los subencabezados, subpies y líneas de subtotal aparecen de modo normal dentro del flujo de datos. No se da ningún trato especial a la retención de agrupamientos en una hoja determinada.
• Si ROWOVERFLOW=PBON, los encabezados y pies de página, y los títulos de las columnas, aparecen dentro de la hoja de cálculo, cuando ocurre un salto de página causado por WebFOCUS.
• En la salida EXL07, si el atributo ROWOVERFLOW aparece especificado en la hoja de estilos y ROWLIMIT es superior a 1MB, aparece el siguiente mensaje y no se genera ningún archivo de salida:

  (FOC3338) The row limit for EXCEL XLSX worksheets is 1048576.

• Los tipos de salida que incluyen referencias a fórmulas (EXL2K PIVOT y EXL2K FORMULA), no son compatibles, ya que estas referencias no se actualizan automáticamente para reflejar su posición en las nuevas hojas de cálculo con desbordamiento.
• El recurso Hoja de cálculo de desbordamiento sólo es aplicable a las filas; no a las columnas. Si la nueva hoja de cálculo supera el límite de 16,384 columnas de Excel 2007/2010, no se genera automáticamente una hoja de cálculo nueva.
• En EXL07, ROWOVERFLOW es compatible con los informes BYTOC.
• Puesto que los rangos con nombre no pueden ejecutarse en varias hojas de estilos, el uso de la frase IN-RANGES, que define los rangos con nombre en el libro resultante, no es compatible con el recurso ROWOVERFLOW. Si existen de forma conjunta en la misma solicitud, ROWOVERFLOW tiene prioridad y se ignora la frase IN-RANGES.

La siguiente solicitud genera salida de informe EXL07 con hojas de cálculo de desbordamiento. El atributo ROWOVERFLOW=ON de la hoja de estilos, activa la característica de desbordamiento. Sin este atributo, se hubiese generado una hoja de cálculo en lugar de tres.

TABLE FILE GGSALES
-* ****Report Heading****
ON TABLE SUBHEAD
"SALES BY REGION, CATEGORY, AND PRODUCT"
" "
-* ****Worksheet Heading****
HEADING
"SALES REPORT WORKSHEET <TABPAGENO"
" "
-* ****Worksheet Footing****
FOOTING
" "
"END OF WORKSHEET <TABPAGENO"
PRINT DOLLARS UNITS BUDDOLLARS BUDUNITS
BY REGION
BY CATEGORY
BY PRODUCT
BY DATE

-* ****Subfoot****
ON REGION SUBFOOT
" "
" End of Region <REGION"
" "
-* ****Subhead****
ON REGION SUBFOOT
" "
" End of Region <REGION"
" "
-* ****Report Footing****
ON TABLE SUBFOOT
" "
"END OF REPORT"
ON TABLE PCHOLD FORMAT EXL07
ON TABLE SET STYLE *
TYPE=REPORT, TITLETEXT=EXLOVER, ROWOVERFLOW=ON, ROWLIMIT=2000,$
ENDSTYLE
END

El encabezado del informe sólo aparece en la primera hoja de cálculo, el encabezado de página y títulos de columnas, en cada hoja de estilo, y el subencabezado y subpie, siempre que el valor del campo de clasificación asociado cambie. La imagen siguiente muestra la parte superior de la primera hoja de cálculo, con el encabezado de informe, encabezado de página, títulos de columnas y el primer subencabezado.

Tenga en cuenta que el atributo TITLETEXT de la hoja de estilos especificó el nombre EXLOVER y que se han generado tres hojas de cálculo llamadas EXLOVER1, EXLOVER2 y EXLOVER3. Si no hubiese un atributo TITLETEXT, las hojas se denominarían SHEET1, SHEET2 y SHEET3.

El pie de la hoja de cálculo aparece al final de cada hoja de cálculo, mientras que el pie del informe lo hace en la parte inferior de la última hoja de cálculo. La imagen siguiente muestra el final de la última hoja de cálculo, mostrando el último subpie, pie de página y pie de informe.

La siguiente solicitud genera salida de informe EXL07 con hojas de cálculo de desbordamiento. El atributo ROWOVERFLOW=PBON de la hoja de estilos, activa la característica de desbordamiento, mientras que ROWLIMIT=250 establece el número máximo de filas por hoja de cálculo en 250, aproximadamente. Sin la presencia de este atributo, se hubiese generado una hoja de cálculo. La frase de clasificación PRODUCT especifica un salto de página.

TABLE FILE GGSALES
-* ****Report Heading****
ON TABLE SUBHEAD
"SALES BY REGION, CATEGORY, AND PRODUCT"
" "
PRINT DOLLARS UNITS BUDDOLLARS BUDUNITS
BY REGION 
BY HIGHEST CATEGORY 
BY PRODUCT PAGE-BREAK
BY DATE
WHERE DATE GE '19971001'
-* ****Page Heading****
HEADING
" Product: <PRODUCT in Category: <CATEGORY for Region: <REGION"
-* ****Page Footing****
FOOTING
" "
-* ****Report Footing****
ON TABLE SUBFOOT
" "
"END OF REPORT"
ON TABLE SET BYDISPLAY ON
ON TABLE PCHOLD FORMAT EXL07
ON TABLE SET STYLE *
INCLUDE=endeflt,TITLETEXT=EXLOVER, ROWOVERFLOW=PBON, ROWLIMIT=250,
$
ENDSTYLE
END

El encabezado del informe sólo aparece en la primera hoja de cálculo, el encabezado y el pie de página y los títulos de las columnas, en cada hoja de cálculo y en cada salto de página de WebFOCUS (cada vez que se cambia de producto), mientras que el subencabezado y el subpie aparecen siempre que el campo de clasificación asociado cambia de valor. La siguiente imagen muestra la parte superior de la primera hoja de cálculo.

La sintaxis es idéntica a la de informes de tabla de contenido HTML, con la excepción de que EXL07 sólo admite un campo BY, mientras que HTML admite varios.

ON TABLE {HOLD|PCHOLD} FORMAT EXL07 BYTOC

Dado que sólo se permite un nivel de tabla de contenido para informes EXL07, el número opcional a continuación de la palabra clave BYTOC sólo puede ser 1.

Como con HTML, la sintaxis SET COMPOUND, que precede al comando TABLE, también se puede utilizar para especificar que se genere una tabla de contenido:

SET COMPOUND=BYTOC

Dado que los informes TOC genera hojas de cálculo según el valor del primer campo BY del informe, éste debe incluir al menos un campo BY. El campo dividido puede ser un campo NOPRINT.

La característica BYTOC no es compatible con el formato EXL07 TEMPLATE.

• Los nombres de pestaña de hoja de cálculo son los valores de campo BY que corresponden a los datos en la hoja de cálculo actual. Se ignorará si el usuario especifica la palabra clave TITLETEXT en la hoja de estilos.
• Excel limita la longitud de títulos de hoja de estilos a 31 caracteres. No se pueden utilizar los caracteres especiales a continuación: ':', '?', '*' y '/'.
• Si quiere utilizar un campo de fecha como campo BY, incluya el carácter - en lugar de /. El símbolo "-" es válido en un título de pestaña de Excel. Sin embargo, si emplea el carácter / , WebFOCUS lo substituirá por el carácter -.

La siguiente solicitud, basada en el origen de datos GGSALES, crea pestañas independientes según lo especificado por el campo de clasificación REGION:

TABLE FILE GGSALES
SUM UNITS/D12C DOLLARS/D12CM
BY REGION NOPRINT
BY CATEGORY
BY PRODUCT
HEADING
"<REGION Region Sales"
ON TABLE PCHOLD FORMAT EXL07
ON TABLE SET BYDISPLAY ON
ON TABLE SET COMPOUND BYTOC
ON TABLE SET STYLE *
TYPE=REPORT, FONT=ARIAL,SIZE=9,$
TYPE=HEADING, SIZE=12,$
TYPE=TITLE, BACKCOLOR=GREY,COLOR=WHITE, $
ENDSTYLE
END

La salida es:

Para identificar valores nulos en los informes de EXL2K, emplee

ON TABLE SET NODATA character_string							

ON TABLE SET EMPTYCELLS [ON|OFF]

donde:

character_string

Es la serie de caracteres que aparece en las celdas del informe para cada campo con un valor nulo procedente de la base de datos. El número máximo de caracteres es de 11. Si el número de caracteres en la serie es mayor que la longitud del campo de salida, los caracteres adicionales no se mostrarán. Si utiliza caracteres especiales, la cadena debe estar entre comillas simples. SET EMPTYCELLS OFF también tendrá que estar especificado para que el comando SET NODATA sea reconocido.

ON

Indica que los espacios en blanco aparecen en las celdas del informe en cada campo con valores nulos procedentes de la base de datos. ON es el valor predeterminado.

OFF

Indica que se mostrarán ceros, o la serie de caracteres especificada con el comando SET NODATA, en las celdas del informe en cada campo con valores nulos procedentes de la base de datos. Debe especificar OFF al usar SET NODATA.

La sintaxis a continuación utiliza el comportamiento por defecto de ON TABLE SET EMPTYCELLS ON, que está indicado en el procesamiento de fondo:

TABLE FILE CAR
   SUM SALES BY COUNTRY ACROSS SEATS
   ON TABLE PCHOLD FORMAT EXL2K
END

La salida a continuación indica que los espacios en blanco aparecen en las celdas del informe en cada campo con valores nulos procedentes de la base de datos.

La siguiente sintaxis utiliza el comando SET NODATA:

TABLE FILE CAR
   SUM SALES BY COUNTRY ACROSS SEATS
   ON TABLE SET NODATA 'n/a'
   ON TABLE SET EMPTYCELLS OFF
   ON TABLE PCHOLD FORMAT EXL2K
END

Nota: Si no añade SET EMPTYCELLS OFF, el comando SET NODATA será ignorado.

La salida a continuación muestra 'n/a' en las celdas del informe en cada campo con valores nulos procedentes de la base de datos.

La sintaxis a continuación desactiva la configuración por defecto de SET EMPTYCELLS y no utiliza SET NODATA, lo que hace imposible diferenciar entre valores nulos y valores de cero:

TABLE FILE CAR
   SUM SALES BY COUNTRY ACROSS SEATS
   ON TABLE SET EMPTYCELLS OFF
   ON TABLE PCHOLD FORMAT EXL2K
END

La salida a continuación muestra ceros en las celdas del informe para cada campo con valores nulos procedentes de la base de datos o para campos con valor cero.

No se admiten los siguientes formatos en EXL2K. Se traducen al formato Excel General y pueden producir resultados impredecibles:

• Cualquier formato de dólar fijo (N).
• Múltiples opciones de formato. Solamente se admiten opciones de formato único cuando se usa FORMAT EXL2K. Por ejemplo, se admiten los formatos I9C y I9B pero no el I9BC.

Se aplica lo siguiente a los encabezados y pies con campos numéricos insertados:

• Si se inserta un campo numérico en un encabezado, subencabezado, pie o subpie de un de EXL2K, el campo numérico aparece en el formato general de Excel (texto). Para mostrar un campo numérico en el formato de número Excel, establezca HEADALIGN=BODY en la hoja de estilos.

  Nota: Los ajustes de la notación decimal continental (CDN por sus siglas en inglés) del cuerpo del informe, se activan mediante los ajustes regionales del escritorio cliente. En los encabezados y pies en que no se haya especificado HEADALIGN, los valores numéricos se convierten en encabezados de texto, con los ajustes de CDN definidos por el procedimiento, ya que la aplicación no tiene acceso a los valores de texto insertados. En los escenarios de HEADALIGN en que los elementos del encabezado estén colocados en celdas individuales, parecidas a la tabla de datos, el Servidor de informes no aplica los ajustes de CDN y se restauran los ajustes regionales originales del escritorio.

No se admiten los siguientes formatos en EXL2K. Se traducen al formato Excel General y pueden producir resultados impredecibles:

• YY, Y, M, D, JUL y I2MT.
• Cualquier formato de fecha con una Q (trimestre).
• Cualquier formato de fecha con decimal empaquetado (P).
• Cualquier formato de fecha alfanumérico (A).

Para utilizar "-" como separador entre el mes, el día y el año en Excel 2000/2003, debe cambiar el separador de fechas predeterminado de Windows. Esto se encuentra en Opciones regionales en el panel de control.

Algunas de las fechas traducidas pueden enviarse a Excel 2000/2003 como valores de fecha estándar con máscaras de formato, permitiendo que Excel las utilice en funciones, fórmulas y secuencias de clasificación. El comando SET EXL2KTXTDATE le permite especificar que las fechas traducidas deben enviarse como valores de fecha con máscaras de formato en lugar de valores de texto.

SET EXL2KTXTDATE = {TEXT|VALUE}

SET EXL2KTXTDATE=TEXT
DEFINE FILE GGSALES
NEWDATE/MDYY = '01/01/2010';
WRMtrDY/WRMtrDY = NEWDATE;
wDMTY/wDMTY= NEWDATE;
wrDMTRY/wrDMTRY= NEWDATE;
wrYMtrD/wrYMtrD= NEWDATE;
END
TABLE FILE GGSALES
SUM DATE NOPRINT
NEWDATE WRMtrDY wDMTY wrDMTRY wrYMtrD
ON TABLE PCHOLD FORMAT EXL2K
END

Los formatos de fecha que no especifican un valor de día explícito están definidos como el valor de fecha del primer día del mes. Por tanto, el valor colocado en la celda puede ser distinto del valor de componente de fecha en el campo de origen de datos, lo que puede generar resultados inesperados cuando se emplea para cálculos de clasificación o fechas en una fórmula Excel.

La siguiente tabla muestra cómo quedan representados los formatos de fechas de WebFOCUS en la salida de informe de EXL2K. La tabla muestra cómo se retiene el valor en la celda y el modo en que se genera la visualización, mediante la máscara de formato correspondiente al formato de fecha de WebFOCUS.

DATEFLD/MDYY = '01/02/2010'

La siguiente solicitud, basada en el origen de datos GGSALES, crea la fecha Enero 2, 2003 y la pasa a Excel 2000/2010 con los formatos MDYY, DMYY, MY y MTDY:

SET EXL2KTXTDATE=TEXT
DEFINE FILE GGSALES
NEWDATE/MDYY = '01/02/2010';
END
TABLE FILE GGSALES
SUM DATE NOPRINT
NEWDATE AS 'MDYY' NEWDATE/DMYY AS 'DMYY' NEWDATE/MY
        AS 'MY' NEWDATE/MTY AS 'MTY' NEWDATE/MTDY AS 'MTDY'
ON TABLE PCHOLD FORMAT EXL2K 
END

Cuando EXL2KTXTDATE=TEXT, las columnas D y E tienen valores de texto, no de fechas. Los valores aparecen en mayúsculas, de acorde a lo especificado por los formatos WebFOCUS (MTY y MTDY):

Cuando EXL2KTXTDATE=VALUE, las columnas D y E presentan valores de datos reales con máscaras de formatos. En Excel 2000, aparecen con una combinación de mayúsculas y minúsculas. Puesto que el formato MTY no tiene un componente de fecha, el valor de fecha almacenado es el primero de Enero 2010 (1/1/2010), no el segundo de Enero 2010 (1/2/2010):

Las fechas con formato de componente individual (por ejemplo, D, Y, M, W) se pasan a Excel 2000/2003 como valores numéricos que pueden utilizarse como parámetros de funciones de fecha de Excel. Los valores se pasan con un formato de texto general y Excel 2000/2003 los reconoce como números. Estos valores se pasan a Excel en el mismo formato, independientemente de la configuración de EXL2KTXTDATE.

La siguiente solicitud, basada en el origen de datos GGSALES, crea la fecha Enero 1, 2003 y extrae componentes de fechas numéricos para, posteriormente, pasarlos a Excel 2000/2010:

SET EXL2KTXTDATE=VALUE
DEFINE FILE GGSALES
NEWDATE/MDYY = '01/01/2010';
D/D= NEWDATE;
Y/Y = NEWDATE;
W/W=NEWDATE;
w/w=NEWDATE;
M/M = NEWDATE;
YY/YY = NEWDATE;
END
TABLE FILE GGSALES
SUM DATE NOPRINT
NEWDATE D Y W w M YY
ON TABLE PCHOLD FORMAT EXL2K 
END

Con SET EXL2KTXTDATE=VALUE, la salida es:

Los formatos que contienen un componente Trimestre siempre se pasan a Excel como cadenas de texto, ya que Excel no los admite.

La siguiente solicitud, emitida frente al origen de datos GGSALES, crea la fecha January 1, 2010 y la convierte en formatos de fecha que contienen un componente Trimestre:

SET EXL2KTXTDATE=VALUE
DEFINE FILE GGSALES
NEWDATE/MDYY = '01/01/2010';
Q/Q= NEWDATE;
QY/QY = NEWDATE;
YBQ/YBQ=NEWDATE;
END
TABLE FILE GGSALES
SUM DATE NOPRINT
NEWDATE Q QY YBQ
ON TABLE PCHOLD FORMAT EXL2K 
END

Incluso con SET EXL2KTXTDATE=VALUE en la salida de informe de EXL2K, las celdas que contienen fechas con componentes de trimestre tienen el formato General. Para verlas, abra el cuadro de diálogo Formato de celdas.

La salida es:

Los formatos de fecha que no contienen información suficiente para presentar el resultado válido de fecha en Excel no quedan traducidos en un valor, incluidos los formatos que no contienen información sobre el año o mes. Estas fechas siguen enviándose a Excel 2000/2003 como texto, independientemente de la propiedad SET EXL2KTXTDATE. Ante la ausencia de información completa, el año se establece en el año actual por defecto; el valor enviado será incorrecto si se ha pasado este tipo de formato como valor de fecha. Los formatos siguientes no se envían como valores:

• MT, MTR, Mt, Mtr
• W, w, WR, wr

Tenga en cuenta que, como estos valores siempre se envían en forma de texto, se aplica el uso de mayúsculas y minúsculas definido en el formato WebFOCUS, a la celda resultante.

La siguiente solicitud, emitida frente al origen de datos GGSALES, crea la fecha Enero 1, 2010 y la convierte en formatos de fecha definidos como el nombre del mes o día:

SET EXL2KTXTDATE=VALUE
DEFINE FILE GGSALES
NEWDATE/MDYY = '01/01/2010';
MT/MT= NEWDATE;
MTR/MTR= NEWDATE;
Mtr/Mtr = NEWDATE;
WR/WR = NEWDATE;
wr/wr = NEWDATE;
END
TABLE FILE GGSALES
SUM DATE NOPRINT
NEWDATE MT MTR Mtr WR wr
ON TABLE PCHOLD FORMAT EXL2K 
END

En Excel 2000/2003, las celdas que contienen los días tienen el formato General. Para verlas, abra el cuadro de diálogo Formato de celdas.

La salida es:

TYPE=REPORT, [COLUMN=column,] WRAP=value, $

donde:

column

Designa una columna particular a la cual aplicarle los criterios de ajuste. Si COLUMN no se incluye en la declaración, todo el informe será envuelto.

value

Es uno de los siguientes:

ON

Activa la función de ajuste de datos. ON es el valor predeterminado. Con este ajuste, el cliente determina el ancho de la columna (Excel). Los datos quedan envueltos si se excede el ancho de la columna y la altura de la fila se extiende hasta la altura de los datos envueltos.

OFF

Desactiva el ajuste de datos. Los datos no se ajustarán en cualquier celda en la columna.

n

Representa un valor numérico específico al que se puede establecer el ancho de la columna. El valor representa la medida especificada con el parámetro UNITS (la pulgada es la unidad predeterminada).

Este ajuste implica ON. Sin embargo, el ancho de columna está establecido en el ancho especificado, a menos que los datos sean más anchos que la columna. En este caso, los datos quedarán resumidos.

TYPE=REPORT, [COLUMN=column,] SQUEEZE={ON|OFF|n}, $

donde:

column

Identifica una columna particular. Si COLUMN no se incluye en la declaración, la propiedad por defecto SQUEEZE se aplicará al informe completo.

n

Representa un valor numérico específico al que se puede establecer el ancho de la columna. El valor representa la medida especificada con el parámetro UNITS (la pulgada es la unidad predeterminada).

Ésta es la configuración de SQUEEZE más utilizada en los informes de EXL2K.

Nota:

• Las opciones ON/OFF para SQUEEZE no significan nada para EXL2K, y ambas resultan en el comportamiento por defecto.
• SQUEEZE = n desactiva la función de ajuste de datos. Si un valor de datos es más ancho del ancho especificado para la columna, queda oculto. Puede ajustar el ancho de columna en Excel después de generar la hoja de cálculo.
• SQUEEZE no es compatible con columnas creadas con la frase OVER o con TABLEF.

El ejemplo siguiente muestra cómo activar y desactivar la función de ajuste de datos en una columna y cómo establecer al ancho de columna para una columna en particular. UNITS en este ejemplo está ajustada en pulgadas (la unidad predeterminada).

  DEFINE FILE CAR
  MYDATE/MDY='10/22/60';
  RCD/D14.3=RETAIL_COST;
  VERYLONG/A80='Subtract dealer cost from retail cost to calculate
  profit.';
  END

   TABLE FILE CAR
   PRINT MYDATE RCD 
   VERYLONG AS 'Default' VERYLONG AS 'WRAP=OFF'
   VERYLONG AS 'WRAP=4.1' VERYLONG AS 'WRAP=2'
   VERYLONG AS 'SQUEEZE=2' SALES   BY COUNTRY
   ON TABLE PCHOLD FORMAT EXL2K
   ON TABLE SET STYLE *
   TYPE=DATA, COLUMN=MYDATE, JUSTIFY=CENTER, $ 
1. TYPE=REPORT, COLUMN=VERYLONG(2), WRAP=OFF, $
2. TYPE=REPORT, COLUMN=VERYLONG(3), WRAP=4.1, $
3. TYPE=REPORT, COLUMN=VERYLONG(4), WRAP=2, $
4. TYPE=REPORT, COLUMN=VERYLONG(5), SQUEEZE=2, $ 
   END

donde:

1. Identifica la columna titulada "WRAP=OFF" y desactiva la función de ajuste de datos en esa columna.
2. Identifica la columna titulada "WRAP=4.1" y establece el ancho de columna a 4,1 pulgadas, al tiempo que activa la función de ajuste de datos en esa columna.
3. Identifica la columna titulada "WRAP=2" y establece el ancho de columna a 2 pulgadas, al tiempo que activa la función de ajuste de datos en esa columna.
4. Identifica la columna titulada "SQUEEZE=2" y establece el ancho de columna a 4,1 pulgadas, al tiempo que desactiva función de ajuste de datos en esa columna.

Nota: La columna titulada "Default" muestra el ancho de columna predeterminado y el comportamiento del ajuste.

El resultado es más ancho que la página, por lo que se muestra en dos secciones. La salida que sigue muestra las columnas "Default", "WRAP=OFF" y "WRAP=4.1":

La salida que sigue muestra las columnas "WRAP=2" y "SQUEEZE=2":

Para habilitar el bloqueo, emplee los atributos siguientes:

TYPE=REPORT, PROTECTED={ON|OFF}, [LOCKED={ON|OFF}],$

donde:

TYPE=REPORT, PROTECTED=ON

Es necesario para activar el bloqueo de hojas de cálculo. PROTECTED=OFF es el atributo predefinido. Si se omite el atributo LOCKED=OFF, se bloquea la hoja de cálculo completa.

LOCKED=ON

Bloquea toda la hoja de cálculo. ON es el valor predeterminado.

LOCKED=OFF

Desbloquea toda la hoja de cálculo, pero permite bloquear o desbloquear determinadas celdas o grupos de celdas.

Una vez que haya incluido la siguiente declaración en su hoja de cálculo, puede especificar el atributo LOCKED para determinadas celdas o grupos de celdas:

TYPE=REPORT, PROTECTED=ON, LOCKED=OFF,$

Para bloquear partes específicas de una hoja de cálculo, añada el atributo LOCKED=ON a la declaración de hoja de estilos, para las celdas que desee bloquear.

TYPE=type, [ COLUMN=columnspec ] ,LOCKED={ON|OFF},$

donde:

type

Es el tipo de elemento que describe las celdas que se van a bloquear.

columnspec

Es una especificación válida de columna.

La siguiente solicitud bloquea todo el libro, ya que las declaraciones de hoja de estilos incluyen esta declaración:

TYPE=REPORT, PROTECTED=ON, $

La solicitud es:

TABLE FILE CAR
HEADING
"Profit By Car "
" "
SUM RETAIL_COST AND DEALER_COST AND
COMPUTE PROFIT/D12.2 = RETAIL_COST - DEALER_COST;
BY CAR
ON TABLE SET PAGE-NUM OFF
ON TABLE PCHOLD AS EXLFORM1 FORMAT EXL2K
ON TABLE SET STYLE *
TYPE=REPORT, COLOR=BLUE, BACKCOLOR=SILVER, SIZE=9,$
TYPE=REPORT, PROTECTED=ON,            $
TYPE=HEADING, STYLE=BOLD, SIZE=14, $
TYPE=TITLE, STYLE=BOLD, SIZE=11,$
ENDSTYLE                                          
END

No puede editar ningún valor de la hoja de cálculo. Cualquier intento de realizar un cambio hace que aparezca un mensaje indicando que la hoja está protegida:

La siguiente solicitud bloquea la segunda columna (RETAIL_COST), ya que las declaraciones de la hoja de estilo incluyen estas declaraciones:

TYPE=REPORT, PROTECTED=ON, LOCKED=OFF, $
TYPE=DATA, COLUMN=2, LOCKED=ON,$

La solicitud es:

TABLE FILE CAR
HEADING
"Profit By Car "
" "
SUM RETAIL_COST AND DEALER_COST AND
COMPUTE PROFIT/D12.2 = RETAIL_COST - DEALER_COST;
BY CAR
ON TABLE SET PAGE-NUM OFF
ON TABLE PCHOLD AS EXLFORM2 FORMAT EXL2K
ON TABLE SET STYLE *
TYPE=REPORT, COLOR=BLUE, BACKCOLOR=SILVER, SIZE=9,$
TYPE=REPORT, PROTECTED=ON, LOCKED=OFF,$
TYPE=HEADING, STYLE=BOLD, SIZE=14, $
TYPE=TITLE, STYLE=BOLD, SIZE=11,$
TYPE=DATA, COLUMN=2, LOCKED=ON,$
ENDSTYLE
END

No se puede editar ningún valor de la columna 2, aunque si los de las otras columnas. Cualquier intento de editar un valor de la columna 2 hace que aparezca un mensaje indicando que las celdas están protegidas:

Añada la siguiente sintaxis a su solicitud para aprovechar las fórmulas de Excel en su libro:

ON TABLE {PCHOLD|HOLD}  FORMAT EXL2K FORMULA

donde:

PCHOLD

Muestra la salida en un libro de EXL2K.

HOLD

Guarda la salida para reutilizarla en una hoja de cálculo de Excel 2000/2003. Para obtener información detallada, consulte Cómo guardar y reutilizar su salida de informes.

El siguiente ejemplo muestra cómo se traduce un total de columna en una solicitud de informe a una fórmula de Excel cuando se usa el formato EXL2K FORMULA. Observe cómo se mantiene el formato del total de columna (TYPE=GRANDTOTAL) en el libro de Excel 2000/2003.

Si selecciona el total en el informe, la ecuación =SUM(B4:B10) se muestra en la barra de la fórmula, representando el total de la columna como una suma de rangos de celdas.

TABLE FILE SHORT
HEADING
"Projected Return By Region"
" "
SUM PROJECTED_RETURN AS 'RETURN'
BY REGION AS 'REGION'
ON TABLE COLUMN-TOTAL
ON TABLE SET STYLE *
TYPE=REPORT, COLOR=BLUE, BACKCOLOR=SILVER, SIZE=9,$
TYPE=HEADING, STYLE=BOLD, SIZE=14, $
TYPE=TITLE, STYLE=BOLD+UNDERLINE, SIZE=10,$
TYPE=GRANDTOTAL, STYLE=BOLD, $
ENDSTYLE
ON TABLE PCHOLD FORMAT EXL2K FORMULA
END

La salida es:

Puede traducir cualquier total (subtotal, total de fila o total de columna) a una fórmula de Excel. Para obtener información relacionada, consulte Soporte de traducción para FORMAT EXL2K FORMULA .

Esta solicitud calcula totales de devoluciones y balances en todos los continentes. Los totales de fila se representan como sumas de rangos celdas.

TABLE FILE SHORT
HEADING
"Projected Return Across Continent"
" "
SUM PROJECTED_RETURN AS 'RETURN' AND BALANCE AS 'BALANCE'
ACROSS CONTINENT AS 'CONTINENT'
BY REGION AS 'REGION'
ON CONTINENT ROW-TOTAL AS 'TOTAL'
ON TABLE COLUMN-TOTAL AS 'TOTAL'
ON TABLE SET STYLE *
TYPE=REPORT, COLOR=BLUE, BACKCOLOR=SILVER, SIZE=9,$
TYPE=HEADING, STYLE=BOLD, SIZE=14, $
TYPE=TITLE, STYLE=BOLD, SIZE=11,$
TYPE=SUBTOTAL,STYLE=BOLD, $
TYPE=GRANDTOTAL,STYLE=BOLD,SIZE=11,$
TYPE=ACROSSTITLE,STYLE=BOLD,SIZE=11,JUSTIFY=LEFT,$
TYPE=ACROSSVALUE,STYLE=BOLD,SIZE=10,JUSTIFY=CENTER,$
ENDSTYLE
ON TABLE PCHOLD FORMAT EXL2K FORMULA 
END

La salida siguiente destaca la fórmula que calcula el total de fila en la celda I12=C12+E12+G12:

Esta solicitud totaliza las columnas correspondientes a costo de venta al detalle y costo del distribuidor y calcula el valor de un campo llamado PROFIT sustrayendo el costo del distribuidor del costo de venta al detalle.

La fórmula para los valores calculados se genera traduciendo la forma interna de la expresión de WebFOCUS (COMPUTE PROFIT/D12.2 = RC - DC;) a una fórmula de Excel. En este ejemplo, las fórmulas aparecen en celdas B14, C14 y D14.

Todos los campos citados en el cálculo deben aparecer en el informe para poder crear un fórmula válida, mediante las referencias a celdas; de lo contrario, puede que se cree con valores que no pertenezcan al informe. Si los campos empleados en el cálculo no están presentes en el informe y se efectúa un cálculo posterior, la fórmula creada para el nuevo cálculo será incorrecta.

TABLE FILE CAR
ON TABLE SET PAGE-NUM OFF
SUM RC AND DC AND
COMPUTE PROFIT/D12.2 = RC - DC;
BY CAR
HEADING
"Profit By Car"
" "
ON TABLE COLUMN-TOTAL
ON TABLE PCHOLD FORMAT EXL2K FORMULA
ON TABLE SET STYLE *
TYPE=REPORT, COLOR=BLUE, BACKCOLOR=SILVER, SIZE=9,$
TYPE=HEADING, STYLE=BOLD, SIZE=14, $
TYPE=TITLE, STYLE=BOLD, SIZE=11,$
TYPE=GRANDTOTAL, STYLE=BOLD, SIZE=11,$
ENDSTYLE
END

La siguiente salida resalta la fórmula que calcula el total de columnas de PROFIT: D14=SUM(D4:D13).

El siguiente ejemplo explica cómo se traducen las funciones a informes de Excel 2000/2000. La función IMOD divide ACCTNUMBER entre 1000 y devuelve el resto a LAST3_ACCT. La fórmula de Excel corresponde a esto, =TRUNC((MOD($C3,(1000)))). Cuando la respuesta devuelta por una ecuación se está colocando en un campo de número entero, se utiliza TRUNC para evitar el uso de decimales:

TABLE FILE EMPLOYEE
PRINT ACCTNUMBER AS 'Account Number' AND COMPUTE
LAST3_ACCT/I3L = IMOD(ACCTNUMBER, 1000, LAST3_ACCT);
BY LAST_NAME AS 'Last Name' 
BY FIRST_NAME AS 'First Name'
WHERE (ACCTNUMBER NE 000000000) AND (DEPARTMENT EQ 'MIS');
ON TABLE PCHOLD FORMAT EXL2K FORMULA
ON TABLE SET STYLE *
TYPE=TITLE, SIZE=12, STYLE=BOLD, $
END

La salida es:

Si su informe contiene un valor calculado (generado por un comando COMPUTE o RECOMPUTE), deben aparecer en el informe todos los campos a los que éste haga referencia, para que las referencias a las celdas puedan incluirse en la fórmula. Si una de las columnas citadas no aparece en el libro, se insertará el valor de datos en la fórmula en lugar de la referencia a la celda. En el caso de un valor recalculado, es posible que el valor utilizado sea incorrecto y provenga del último registro detallado del salto de clasificación.

La siguiente solicitud obtiene la diferencia (DIFF) restando los dólares presupuestados a las ventas en dólares. El campo de dólares presupuestados empleado en la expresión no se incluye en el comando SUM. El valor de DIFF se vuelve a calcular en el nivel de región:

TABLE FILE GGSALES
HEADING
"Profit By Region"
" "
SUM DOLLARS 
COMPUTE DIFF/I9=DOLLARS - BUDDOLLARS;
BY REGION
BY CATEGORY
ON REGION RECOMPUTE
ON TABLE PCHOLD FORMAT EXL2K FORMULA
END

La salida muestra que la fórmula está restando un valor de datos que no aparece en la hoja de cálculo. En realidad se trata del valor de BUDDOLLARS de la fila anterior:

Si cambia el comando SUM por lo siguiente, la fórmula puede recalcularse correctamente:

SUM DOLLARS BUDDOLLARS

La fórmula generada con el nuevo comando SUM contiene referencias a las celdas de los dos campos utilizados en el cálculo:

Este tema describe el soporte de traducción de FORMAT EXL2K FORMULA. El uso de características de WebFOCUS que no sean compatibles, puede producir resultados inesperados.

• Se admiten todos los operadores estándar, que incluyen operadores aritméticos, operadores relacionales, operadores de cadenas, IF/THEN/ELSE y operadores lógicos. Sin embargo, la notación de columnas no es compatible.

  No se admite el uso de los operadores IS-PRESENT, IS-MISSING, IS-FROM, FROM, NOT-FROM, IS-MORE-THAN, IS---LESS-THAN, CONTAINS y OMITS.

  Las expresiones condicionales (IF-THEN-ELSE) y las lógicas no admiten los operadores lógicos AND y OR.

• Se admiten las siguientes funciones:

  ABS, ARGLEN, ATODBL, BYTVAL, CHARGET, CTRAN, DMOD, DOWK, DOWK, DOWKL, EXP, FMOD, HEXBYT, HHMMSS, IMOD, LCWORD, LOCASE, LOG, MAX, MIN, OVRLAY, POSIT, RDUNIF, SQRT, SUBSTR, TODAY, UPCASE. La función EDIT está permitida en la conversión de formatos (variante de un argumento). No se admite a la hora de editar cadenas.

  No se recomienda el uso de las funciones CTRFLD, LJUST y RJUST para justificar datos en columnas de Excel. Para utilizar las fuentes proporcionales de Excel, es más apropiado el atributo de hoja de estilos JUSTIFY.

  Tenga cuidado al usar funciones que emplean valores decimales como argumento (BYTVAL, CTRAN, HEXBYT). Los resultados pueden variar en función de si el entorno operativo es EBCDIC o ASCII.

• EXL2K FORMULA no es compatible con los siguientes comandos y frases de WebFOCUS:
  • DEFINE.
  • OVER.
  • FOR.
  • NOPRINT.
  • Múltiples comandos de visualización (PRINT, LIST, SUM y COUNT).
  • Atributo de hoja de estilos SEQUENCE.
  • RECAP.
  • SET HIDENULLACRS.
  • SET SUBTOTALS = ABOVE.
  • LAST.
• Si su informe contiene un valor calculado (generado por un comando COMPUTE o RECOMPUTE), deben aparecer en el informe todos los campos a los que éste haga referencia, para que la referencia a una celda pueda incluirse en la fórmula. Si la columna citada no aparece en el libro, se insertará el valor de datos en la fórmula en lugar de la referencia a la celda.
• La propiedad recomendada es BYDISPLAY ON. De lo contrario, el valor del campo de clasificación no estará disponible para nuevos cálculos en todas las filas.
• Si la expresión requiere más de 1024 caracteres, WebFOCUS coloca el valor en la celda, no en la fórmula.
• El estilo condicional se basa en los valores contenidos en un informe de origen. Si modifica los valores de la hoja de cálculo y vuelve a calcular las fórmulas, el estilo no reflejará la información actualizada.

La salida de EXL2K FORMULA es compatible con los operadores de prefijo utilizados en las líneas de resumen, generadas por los comandos WebFOCUS, como SUBTOTAL o RECOMPUTE. Cuando existe una fórmula correspondiente en Excel, estos operadores de prefijo quedan traducidos a su fórmula equivalente de resumen en Excel. Los resultados de los operadores de prefijo utilizados directamente en base a los datos recuperados, siguen pasándose a Excel como valores, no como fórmulas.

La siguiente tabla identifica los operadores de prefijo compatibles con EXL2K FORMULA, cuando se utilizan en líneas de resumen, y la fórmula equivalente de Excel, colocada en la hoja de cálculo generada.

En la siguiente solicitud, basada en el origen de datos GGSALES, el comando RECOMPUTE del campo de clasificación REGION calcula el máximo del campo agregado DOLLARS, y el mínimo del campo agregado BUDDOLLARS:

TABLE FILE GGSALES
SUM UNITS DOLLARS BUDDOLLARS
AND COMPUTE DIFF/I10= DOLLARS-BUDDOLLARS;
BY REGION
BY CATEGORY
WHERE CATEGORY EQ 'Food' OR 'Coffee'
WHERE REGION EQ 'West' OR 'Midwest'
ON REGION RECOMPUTE MAX. DOLLARS MIN. BUDDOLLARS DIFF
ON TABLE PCHOLD FORMAT EXL2K FORMULA
END

En la salida, la celda que representa el campo recalculado DOLLARS de la región Midwest se ha generado como la siguiente fórmula:

=MIN(E2:E3)

En la siguiente solicitud, basada en el origen de datos GGSALES, los operadores de prefijo CNT., AVE. y PCT. se utilizan en el comando de visualización SUM:

TABLE FILE GGSALES
SUM UNITS
CNT.UNITS
AVE.UNITS
PCT.UNITS
BY REGION 
BY ST 
ON TABLE PCHOLD FORMAT EXL2K FORMULA
END

La salida indica que los operadores de prefijo no se han pasado a Excel como fórmulas, sino como valores de datos.

La barra de herramientas de la Tabla dinámica podría no mostrarse automáticamente cuando se crea una tabla dinámica. Para mostrar la barra de herramientas de la Tabla dinámica, utilice el procedimiento siguiente:

1. Pulse sobre Visualizar en la barra de herramientas de Excel.
2. Destaque las barras de herramientas.
3. Pulse sobre Tabla dinámica.

   Excel 2000/2003 incluye la barra de herramientas de la tabla dinámica, que lista los campos disponibles para ser arrastrados hasta el cuerpo del informe de tabla dinámica. Debe seleccionar una celda de la tabla dinámica para que la barra de herramientas muestre todos los campos.

La tabla dinámica se genera con el comando PRINT en combinación con las frases BY, ACROSS, PAGEFIELDS y CACHEFIELDS. Contiene todas las opciones utilizadas para diseñar y dar formato al informe, así como campos especificados en la solicitud PIVOT. Se pueden arrastrar los campos al informe desde la barra de herramientas. El gráfico a continuación muestra la salida de la tabla dinámica con los elementos principales indicados.

La siguiente tabla de resumen muestra los elementos de la tabla dinámica y la sintaxis FOCUS asociada a ellos.

La tabla que sigue resume los elementos de la sintaxis TABLE admitidos en EXL2K PIVOT. Los efectos de cada comando sobre su solicitud Tabla dinámica están listados junto con su uso obligatorio.

A continuación se muestran variaciones de sintaxis que puede utilizar para habilitar FORMAT EXL2K PIVOT.

• Para ver la salida inmediatamente en Excel 2000/2003:

  ON TABLE PCHOLD FORMAT EXL2K PIVOT

• Para guardar salida en disco y visualizarla más tarde

  ON TABLE HOLD FORMAT EXL2K PIVOT AS mypivot									

  donde:

  mypivot

  Es el nombre que le asigna al archivo HOLD.

  Se generan dos archivos con esta sintaxis:

  • MYPIVOT.XHT es el archivo principal que se muestra en el navegador o ventana de Excel.
  • MYPIVO$.XML es el archivo de caché de tabla dinámica.

Cuando cree solicitudes para salida de la tabla dinámica, debe tomar en cuenta lo siguiente:

• Las solicitudes deben usar el comando de visualización PRINT. Esto resulta necesario para extraer todos los datos (es decir, cada registro individual) en el archivo caché de tabla dinámica. El campo que está después del comando PRINT se asigna como el archivo de datos de la tabla dinámica y debe ser numérico.

  Tenga en cuenta que EXL2K PIVOT no admite los comandos SUM y COUNT. No obstante, puede utilizar este comportamiento nativo de la tabla dinámica en Excel a continuación de que los datos hayan salido a una tabla dinámica de Excel.

• Un campo utilizado en una tabla dinámica no puede enumerarse más de una vez en la solicitud de informe. Cada campo puede aparecer en una sola función en una solicitud FORMAT EXL2K PIVOT. Por ejemplo, un campo de página no se puede mostrar simultáneamente como columna y como campo de fila.
• El estilo se basa en el estado inicial de su informe y se retiene solamente de manera limitada cuando pivotea la salida.
• Los campos NODATA se mostrarán como celdas en blanco en la tabla dinámica.
• Campos de texto y campos de marcas de tiempo puede que no se utilicen en Tablas dinámicas de Excel. Además, compruebe que no hay ningún dato no disponible en ningún campo.
• Puede incluir columna, fila, gran total y subtotales en una tabla dinámica. Si no hay ningún total especificado en la solicitud, Excel 2000/2003 no presentará totales.
• Las tablas dinámicas de Excel no permiten el uso de bordes.

El siguiente ejemplo muestra cómo generar una tabla dinámica:

TABLE FILE CAR
HEADING
"CAR File PivotTable"
"Sum of Sales by Car Across Model"
PRINT SALES
BY CAR
ACROSS MODEL
ON TABLE COLUMN-TOTAL
ON TABLE SET STYLE *
TYPE=HEADING, LINE=1, FONT='ARIAL', COLOR=PURPLE, SIZE=16, STYLE=BOLD,$
TYPE=HEADING, LINE=2, FONT='ARIAL', COLOR=PURPLE, SIZE=12, STYLE=BOLD,$
TYPE=DATA, FONT='ARIAL', COLOR=PURPLE,$
TYPE=GRANDTOTAL, FONT='ARIAL', COLOR=PURPLE, SIZE=16, STYLE=BOLD,$
ENDSTYLE 
ON TABLE PCHOLD AS CARPIVOT FORMAT EXL2K PIVOT
PAGEFIELDS COUNTRY
CACHEFIELDS RETAIL_COST TYPEEND

El comando ON TABLE PCHOLD FORMAT EXL2K PIVOT muestra la tabla dinámica en Excel 2000/2003. Todos los campos (incluyendo campos PRINT, BY, ACROSS, PAGEFIELDS y CACHEFIELDS) aparecen en la barra de herramientas.

Los campos designados como CACHEFIELDS deben colocarse inmediatamente después de la palabra clave PIVOT, en la sintaxis ON TABLE PCHOLD FORMAT EXL2K PIVOT, o después de una frase PAGEFIELDS. Un campo especificado como CACHEFIELD no se puede utilizar en ningún otro lugar en la solicitud. Para concluir una lista de CACHEFIELDS se necesitan las mismas palabras clave que se utilizan para concluir una solicitud de informe normal, como END u otra frase ON.

El siguiente ejemplo muestra cómo especificar CACHEFIELDS, para rellenar la barra de herramientas de la tabla dinámica.

TABLE FILE CAR
HEADING
"My PivotTable"
PRINT SALES 
BY COUNTRY BY CAR
ON COUNTRY SUB-TOTAL
ON TABLE SET STYLE *
TYPE=DATA, COLUMN=COUNTRY, COLOR=RED, $
type=heading,color=blue,style=bold, size=14, $
ENDSTYLE 
ON TABLE PCHOLD FORMAT EXL2K PIVOT
CACHEFIELDS MODEL TYPEEND

La salida es:

Los formatos EXL2K y EXL2K FORMULA son los únicos formatos compatibles; las plantillas de Excel solo funcionarán con Excel 2002 y versiones posteriores.

Los siguientes formatos no se admiten con plantillas Excel: EXL2K PIVOT, informes EXL2K BYTOC, EXL97, EXCEL e informes Excel compuestos.

En el formato EXL2K TEMPLATE, WEBARCHIVE siempre se está activado.

El comando PCHOLD devuelve un archivo .xmh, que queda convertido en un .mht por parte del nivel intermedio. HOLD genera un archivo .xht.

Para crear un informe utilizando una plantilla de Excel, especifique lo siguiente:

ON TABLE PCHOLD FORMAT EXL2K TEMPLATE template_name SHEETNUMBER #							

donde:

template_name

El nombre de archivo de la plantilla Excel (libro) que se encuentra en el Servidor de informes de WebFOCUS.

#

El número de la hoja de cálculo de Excel que se va a reemplazar en la plantilla (libro).

Para crear rangos con nombre de Excel, utilice

TYPE=type, IN-RANGES=rangename, $

donde:

type

Identifica el componente del informe de WebFOCUS que se va a incluir en el rango. Por lo general, ambos elementos a continuación se utilizan juntos:

DATA añade el elemento DATA del informe al rango con nombre (excluye el encabezado, el pie de página y los títulos de las columnas).

TITLE añade el elemento TITLE del informe al rango con nombre (incluye todos los títulos de las columnas).

Nota: Se puede añadir múltiples elementos al mismo rango con nombre.

rangename

Es el nombre asignado a la salida del libro de Excel que está siendo creado por su aplicación, y al que harán referencia otras aplicaciones de WebFOCUS.

Este ejemplo crea un informe en un libro de un archivo Excel. El código específico a los rangos con nombre de Excel aparece en negrita con la sintaxis a continuación.

TABLE FILE GGSALES
PRINT
     PRODUCT
     DATE
     UNITS
BY REGION
BY DOLLARS
ON TABLE SET PAGE-NUM OFF
ON TABLE SET BYDISPLAY ON
ON TABLE NOTOTAL
ON TABLE PCHOLD FORMAT EXL2K
ON TABLE SET STYLE *
     UNITS=IN, SQUEEZE=ON, ORIENTATION=PORTRAIT, $
TYPE=REPORT, FONT='ARIAL', SIZE=9, COLOR='BLACK', BACKCOLOR='NONE',
STYLE=NORMAL, $ 
TYPE=DATA, IN-RANGES='RegionalSales', $
TYPE=TITLE, STYLE=BOLD, IN-RANGES='RegionalSales', $ENDSTYLE
END

La salida de Excel es:

El nombre asignado a este intervalo con nombre de Excel es RegionalSales. Si se añaden más filas de datos o si se insertan más columnas de datos, el intervalo se ampliará para incluir los datos nuevos y los existentes.

• La zona de datos Excel asociada a un rango con nombre debe estar seguida y no puede tener espacios entre los datos. Algunos ejemplos de componente de un informe que contienen espacios en los datos que no pueden formar parte de un rango con nombre incluyen SUBHEAD y SUBFOOT.
• Se recomienda que utilice ON TABLE SET BYDISPLAY ON. Eso activa la opción para mostrar valores de clasificación repetidos, que genera una salida continua sin espacios entre los datos.
• Un libro no puede tener dos hojas de cálculo con el mismo nombre de rango.
• Al crear informes compuestos de Excel (con múltiples solicitudes TABLE con salida al mismo libro de Excel) cada informe debe tener un nombre único de intervalo almacenado al nivel del libro.

Los rangos con nombre de Excel están soportados para los siguientes formatos Excel:

EXL2K, EXL2K FORMULA, EXL2K TEMPLATE

Los rangos con nombre de Excel no están soportados para los siguientes formatos Excel:

EXL2K BYTOC, EXCEL PIVOT

Los rangos con nombre de Excel no están soportados para usar con sintaxis de informe que genere datos discontinuos o que utilice referencias a columnas que abarquen múltiples columnas, incluyendo:

ACROSSCOLUMN, RECAP, RECOMPUTE, SUBHEAD, SUBFOOT, SUBTOTAL, SUB-TOTAL

La sintaxis es idéntica a la de informes de tabla de contenido HTML, con la excepción de que EXL2K sólo admite un campo BY, mientras que HTML admite varios.

ON TABLE {HOLD|PCHOLD} FORMAT EXL2K BYTOC

Dado que sólo se permite un nivel de tabla de contenido para informes EXL2K, el número opcional a continuación de la palabra clave BYTOC sólo puede ser 1.

Como con HTML, la sintaxis SET COMPOUND, que precede al comando TABLE, también se puede utilizar para especificar que se genere una tabla de contenido:

SET COMPOUND=BYTOC

Dado que un informe de tabla de contenido se divide en hojas de cálculo de acuerdo al valor del primer campo BY en el informe, el informe debe contener al menos un campo BY. El campo dividido puede ser un campo NOPRINT.

• No se puede incluir un informe de tabla de contenido en un informe compuesto.
• Un informe de tabla de contenido no puede ser un informe de tabla dinámica.
• No se puede generar un informe TOC en base a una solicitud multiverbo.

Nota: FORMULA no se admite con división.

La siguiente solicitud, basada en el origen de datos GGSALES, crea pestañas independientes según lo especificado por el campo de clasificación REGION:

TABLE FILE GGSALES
SUM UNITS/D12C DOLLARS/D12CM
BY REGION NOPRINT
BY CATEGORY
BY PRODUCT
HEADING
"<REGION Region Sales"
ON TABLE PCHOLD FORMAT EXL2K
ON TABLE SET BYDISPLAY ON
ON TABLE SET COMPOUND BYTOC
ON TABLE SET STYLE *
TYPE=REPORT, FONT=ARIAL,SIZE=9,$
TYPE=HEADING, SIZE=12,$
TYPE=TITLE, BACKCOLOR=GREY,COLOR=WHITE, $
ENDSTYLE
END

La salida es:

• Los nombres de pestaña de hoja de cálculo son los valores de campo BY que corresponden a los datos en la hoja de cálculo actual. Se ignorará si el usuario especifica la palabra clave TITLETEXT en la hoja de estilos.
• Excel limita la longitud de títulos de hoja de estilos a 31 caracteres. No se pueden utilizar los caracteres especiales a continuación: ':', '?', '*' y '/'.
• Si desea utilizar campos de fecha como el campo BY estallado, puede incluir el símbolo - en vez del símbolo /. El símbolo "-" es válido en un título de pestaña de Excel. Sin embargo, si emplea el carácter / , WebFOCUS lo substituirá por el carácter -.

La opción BYTOC del formato EXL2K de WebFOCUS, genera un libro que incluye una hoja de cálculo individual por cada campo de clasificación primario (BY), en el informe. Cada hoja es nombrada con el valor del campo de clasificación primario, para identificar los datos incluidos en la misma.

Excel requiere que cada hoja tenga un nombre único. Excel no distingue las mayúsculas de las minúsculas; es decir que considera idénticos dos valores que contengan los mismos caracteres, aunque el uso de las mayúsculas y minúsculas no sea el mismo. Por ejemplo, Excel trata los valores COFFEE y Coffee como si fueran iguales y, por tanto, no pueden utilizarse como los nombres de dos hojas de cálculo diferentes.

En cambio, el procesamiento de clasificación de WebFOCUS distingue por defecto el uso de mayúsculas y minúsculas en los campos de clasificación (BY). En los informes BYTOC de Excel, WebFOCUS genera hojas con nombres por cada valor de la clave de clasificación primaria (BY), en base al uso de mayúsculas y minúsculas. Con respecto a los valores de clasificación que sólo difieren en cuanto a su uso de mayúsculas y minúsculas, la hoja inicial es la que recibe el valor de clasificación, mientras que Excel tendrá dificultadas con cualquier hoja posterior, generada con el mismo nombre. El nombre de la segunda hoja aparece como Recovered_Sheet1, en lugar del valor que Excel considera como duplicado.

En el siguiente ejemplo, WebFOCUS va a generar hojas de cálculo independientes para los valores Coffee y COFFEE. La hoja de cálculo inicial se llama COFFEE, sin embargo, en la hoja de cálculo posterior, que representa el valor Coffee, Excel no podrá usar el valor como nombre de la hoja y, por tanto, mostrará el valor recuperado.

DEFINE FILE GGSALES
SHOWCAT/A15=IF PRODUCT EQ 'Espresso' THEN 'COFFEE' ELSE CATEGORY;
END
TABLE FILE GGSALES
BY SHOWCAT 
BY PRODUCT
ON TABLE SET PAGE-NUM OFF
ON TABLE PCHOLD FORMAT EXL2K
ON TABLE SET COMPOUND 'BYTOC 1'
END

En la salida, la segunda pestaña presenta el nombre Recovered_Sheet1 en vez del valor que distingue mayúsculas de minúsculas, Coffee:

DEFINE FILE GGSALES
SHOWCAT/A15=IF PRODUCT EQ 'Espresso' THEN 'COFFEE' ELSE CATEGORY;
END
TABLE FILE GGSALES
PRINT SHOWCAT NOPRINT
COMPUTE CNTR/I2 = IF SHOWCAT EQ LAST SHOWCAT THEN LAST CNTR ELSE CNTR + 1; NOPRINT
BY TOTAL COMPUTE SHOWCAT2/A20 = EDIT(CNTR) | '-' | SHOWCAT; NOPRINT
BY SHOWCAT 
BY PRODUCT
ON TABLE SET PAGE-NUM OFF
ON TABLE PCHOLD FORMAT EXL2K
ON TABLE SET COMPOUND BYTOC
ON TABLE SET STYLE *
GRID=OFF, $
ENDSTYLE
END

Añada el atributo ROWOVERFLOW a su hoja de estilos de WebFOCUS

TYPE=REPORT, ROWOVERFLOW={ON|OFF|PBON}, [ROWLIMIT={n|MAX}...

donde:

ON

Activa las hojas de cálculo con desbordamiento.

OFF

Desactiva las hojas de cálculo con desbordamiento. OFF es el valor predeterminado.

PBON

Inserta saltos de página de WebFOCUS que muestran el encabezado y pie de página, y los títulos de columnas, en los lugares correspondientes, dentro de las filas de la hoja de cálculo. Esta opción no hace que se abra una nueva hoja de cálculo al detectarse un salto de página de WebFOCUS.

ROWLIMIT=n

Establece el valor de destino del número de filas que se va a incluir en una hoja de cálculo, en n filas. El valor por defecto es LINES (75, por defecto).

ROWLIMIT=MAX

En la salida de EXL2K, establece el valor de destino del número de filas incluido en una hoja de cálculo, en 65.000.

Este atributo sólo funciona con la salida de EXL2K o EXL07. En los demás tipos de salida, se ignora el atributo ROWOVERFLOW de hoja de estilos, sin que el flujo de datos se vea afectado.

• El encabezado del informe queda colocado una sola vez al principio de la primera hoja. El pie del informe queda colocado una sola vez en la parte inferior de la última hoja de desbordamiento.
• A menos que esté utilizando la propiedad PBON, los encabezados y los títulos de columnas de la hoja de cálculo, aparecen repetidos en la parte superior del original, y en cada una de las hojas con desbordamiento, posteriores. Los pies de de hoja de cálculo quedan colocados en la parte inferior de la hoja de cálculo original y de cada hoja de desbordamiento posterior. Los valores de datos aparecen en la fila de datos superior de cada hoja de desbordamiento como si se tratase de una página nueva estándar.
• Los totales de línea del informe aparecen en la parte inferior de la última página de desbordamiento, justo encima de los pies de tabla y de la última página.
• Los subencabezados, subpies y líneas de subtotal aparecen de modo normal dentro del flujo de datos. No se da ningún trato especial a la retención de agrupamientos en una hoja determinada.
• Si ROWOVERFLOW=PBON, los encabezados y pies de página y los títulos de las columnas aparecen dentro de la hoja de cálculo, cuando ocurre un salto de página causado por un comando de WebFOCUS.
• En la salida EXL2K, si el atributo ROWOVERFLOW aparece especificado en la hoja de estilos y SET LINES es superior a 65K, aparece el siguiente mensaje y no se genera ningún archivo de salida:

  (FOC3313) The line number limit per EXCEL 2003 worksheet is 65536.

• No se admiten los tipos de salida que contienen referencias de fórmulas (EXL2K PIVOT y EXL2K FORMULA). Las referencias de fórmula no se actualizan automáticamente para reflejar su colocación en hojas de cálculo nuevas.
• El recurso Hoja de cálculo de desbordamiento sólo es aplicable a las filas; no a las columnas. Si el informe supera el límite de 256 columnas de Excel 2003, no se genera automáticamente una hoja de cálculo nueva.
• ROWOVERFLOW se admite en informes de diseño compuesto y BYTOC.
• Puesto que los rangos con nombre de Excel no se pueden ejecutar en varias hojas de estilos, la frase IN-RANGES, que define los rangos con nombre en el libro resultante, no es compatible con el recurso ROWOVERFLOW. Si existen de forma conjunta en la misma solicitud, ROWOVERFLOW tiene prioridad y se ignora la frase IN-RANGES.

La siguiente solicitud genera salida de informe EXL2K con hojas de cálculo de desbordamiento. El comando SET LINES establece el número máximo de filas de cada hoja de cálculo en 2000, aproximadamente, mientras que el atributo ROWOVERFLOW=ON de la hoja de estilos activa el recurso de desbordamiento. Sin este atributo, se hubiese generado una hoja de cálculo en lugar de tres:

TABLE FILE GGSALES
-* ****Report Heading****
ON TABLE SUBHEAD
"SALES BY REGION, CATEGORY, AND PRODUCT"
" "
-* ****Worksheet Heading****
HEADING
"SALES REPORT WORKSHEET <TABPAGENO"
" "
-* ****Worksheet Footing****
FOOTING
" "
"END OF WORKSHEET <TABPAGENO"

PRINT DOLLARS UNITS BUDDOLLARS BUDUNITS
BY REGION
BY CATEGORY
BY PRODUCT
BY DATE
-* ****Subfoot****
ON REGION SUBFOOT
" "
" End of Region <REGION"
" "
-* ****Subhead****
ON CATEGORY SUBHEAD
" "
" Category <CATEGORY for Region <REGION"
" "
-* ****Report Footing****
ON TABLE SUBFOOT
" "
"END OF REPORT"
ON TABLE SET LINES 2000
ON TABLE PCHOLD FORMAT EXL2K
ON TABLE SET STYLE *
TYPE=REPORT, TITLETEXT=EXLOVER, ROWOVERFLOW=ON,$
ENDSTYLE
END

El encabezado del informe sólo aparece en la primera hoja de cálculo, el encabezado de página y títulos de columnas, en cada hoja de estilo, y el subencabezado y subpie, siempre que el valor del campo de clasificación asociado cambie. La imagen siguiente muestra la parte superior de la primera hoja de cálculo, con el encabezado de informe, encabezado de página, títulos de columnas y el primer subencabezado:

Tenga en cuenta que el atributo TITLETEXT de la hoja de estilos especificó el nombre EXLOVER y que se han generado tres hojas de cálculo llamadas EXLOVER1, EXLOVER2 y EXLOVER3. Si no hubiese un atributo TITLETEXT, las hojas se denominarían SHEET1, SHEET2 y SHEET3.

El pie de la hoja de cálculo aparece al final de cada hoja de cálculo, mientras que el pie del informe lo hace en la parte inferior de la última hoja de cálculo. La imagen siguiente muestra el final de la última hoja de cálculo, mostrando el último subpie, pie de página y pie de informe:

La siguiente solicitud genera salida de informe EXL2K con hojas de cálculo de desbordamiento. El atributo ROWOVERFLOW=PBON de la hoja de estilos, activa la característica de desbordamiento, mientras que ROWLIMIT=250 establece el número máximo de filas por hoja de cálculo en 250, aproximadamente. Sin la presencia de este atributo, se hubiese generado una hoja de cálculo. La frase de clasificación PRODUCT especifica un salto de página.

TABLE FILE GGSALES
-* ****Report Heading****
ON TABLE SUBHEAD
"SALES BY REGION, CATEGORY, AND PRODUCT"
" "
PRINT DOLLARS UNITS BUDDOLLARS BUDUNITS
BY REGION 
BY HIGHEST CATEGORY 
BY PRODUCT PAGE-BREAK
BY DATE
WHERE DATE GE '19971001'
-* ****Page Heading****
HEADING
" Product: <PRODUCT in Category: <CATEGORY for Region: <REGION"
-* ****Page Footing****
FOOTING
" "
-* ****Report Footing****
ON TABLE SUBFOOT
" "
"END OF REPORT"
ON TABLE SET BYDISPLAY ON
ON TABLE PCHOLD FORMAT EXL2K
ON TABLE SET STYLE *
INCLUDE=endeflt,TITLETEXT=EXLOVER, ROWOVERFLOW=PBON, ROWLIMIT=250,
$
ENDSTYLE
END

El encabezado del informe sólo aparece en la primera hoja de cálculo, el encabezado y el pie de página y los títulos de las columnas, en cada hoja de cálculo y en cada salto de página de WebFOCUS (cada vez que se cambia de producto), mientras que el subencabezado y el subpie aparecen siempre que el campo de clasificación asociado cambia de valor. La siguiente imagen muestra la parte superior de la primera hoja de cálculo.

Para un hipervínculo drilldown a un FOCEXEC:

TYPE=type, [subtype], FOCEXEC=fex[(parameters ...)], [TARGET=frame,]
 [ALT='tooltip_text',] $

Para un hipervínculo drilldown a un URL:

TYPE=type, [subtype], URL=url[(parameters ...)], [TARGET=frame,] [ALT='tooltip_text',] $

donde:

type

Identifica el componente del informe que usted seleccione en el navegador web para ejecutar el vínculo. El atributo TYPE y su valor deben aparecer al principio de la declaración.

subtype

Se refiere a algunos atributos adicionales, tales como COLUMN, LINE, o ITEM, necesarios para identificar el componente del informe que usted formatea.

fex

Identifica el nombre de archivo del procedimiento enlazado para ejecutarlo cuando seleccione el componente del informe.

url

Identifica cualquier URL válida, incluyendo un URL que especifique un programa de miniservidor de WebFOCUS o el nombre de una columna de informe encerrada entre paréntesis cuyo valor sea un URL válido al cual pueda viajar el vínculo.

parámetros

Valores pasados al informe o URL.

marco

Identifica el marco de destino en la página web en que se muestra la salida del vínculo jerarquizado.

tooltip_text

Es el texto informativo que aparece al pasar el cursor sobre el hipervínculo.

Las opciones JAVASCRIPT e IMAGE de drilldown no se admiten con el formato EXL2K.

La siguiente solicitud de informe resume las ventas del producto y clasifica los datos por región, estado y código de tienda. El código de tienda también aparece en los subpies, que presentan vínculos a informes detallados sobre las ventas de dicho establecimiento (por producto o fecha). Cada línea en el pie de página contiene dos objetos de texto y un campo insertado.

TABLE FILE GGSALES
HEADING
"Sales Report"
SUM DOLLARS/I08M
BY REGION BY ST BY STCD
ON STCD SUBFOOT
"View Store <STCD Sales By Product"
" "
"View Store <STCD Sales By Date"
ON TABLE PCHOLD FORMAT EXL2K
ON REGION PAGE-BREAK
ON TABLE SET PAGE-NUM OFF
ON TABLE SET STYLE *
TYPE=HEADING, SIZE=12, STYLE=BOLD, $
TYPE=SUBFOOT, LINE=1, OBJECT=TEXT, ITEM=2, 
FOCEXEC=PRDSALES(STOREID=STCD), ALT='Product Sales',$
TYPE=SUBFOOT, LINE=3, OBJECT=TEXT, ITEM=2, 
FOCEXEC=HSTSALES(STOREID=STCD),ALT='Sales History', $
ENDSTYLE
END

Cuando se usan declaraciones de hoja de estilos, la frase del pie de página Ventas por producto se enlaza con un segundo procedimiento denominado PRDSALES y le pasa el valor de STCD que aparece en el pie de página. La frase del pie de página Sales By Date enlaza con un procedimiento denominado HSTSALES y le pasa el valor de STCD que aparece en el pie de página. Los atributos ALT, en las declaraciones de hoja de estilos de hipervínculos, proporcionan mensajes informativos.

Informe PRDSALES vinculado:

TABLE FILE GGSALES
SUM UNITS
BY STCD
BY PRODUCT
WHERE STCD = '&STOREID'
ON TABLE SET PAGE-NUM OFF
ON TABLE PCHOLD FORMAT EXL2K
ON TABLE SET STYLE *
TYPE=REPORT, GRID=OFF, $
ENDSTYLE
END

Informe HSTSALES vinculado:

TABLE FILE GGSALES
SUM UNITS
BY STCD
BY DATE
WHERE STCD = '&STOREID'
ON TABLE SET PAGE-NUM OFF
ON TABLE PCHOLD FORMAT EXL2K
ON TABLE SET STYLE *
TYPE=REPORT, GRID=OFF, $
ENDSTYLE
END

A esto le sigue la primera página de salida del informe principal. Si pasa el cursor sobre el vínculo Ventas por fecha, aparece el texto informativo Historial de ventas:

Además del método descrito en el ejemplo Cómo insertar un informe de WebFOCUS en un libro de Excel 2000/2003, puede utilizar otras técnicas para aprovechar todas las ventajas de Web Query en su hoja de cálculo. Por ejemplo, si cuenta con una hoja de cálculo con muchos elementos predefinidos, puede que tenga que ejecutar la consulta en una hoja independiente para ver cuánto espacio va a necesitar, antes de añadirla al 'área de trabajo' principal de la hoja de cálculo. Es buena idea utilizar una hoja de cálculo particular para su consulta y hacer que todo lo demás se refiera a los datos por la vía de fórmulas de otra hoja de cálculo.

Otro método consiste en incluir todo en la misma hoja de cálculo. El resto de los elementos circundantes de la hoja de cálculo deberían volver a colocarse automáticamente, cuando vuelvan los datos, aunque es recomendable dejar un área de búfer alrededor de la consultar, para que haya espacio suficiente para la salida de informe.

El procedimiento para construir un archivo IQY es el siguiente

								Type_of_query     [CR]Version_of_query  [CR]URL               [CR]
{POST|GET} parameters   [CR]

donde:

Type_of_query

Es web. Y como web es un valor opcional, ésta es una entrada opcional.

Version_of_query

Es la versión actual del software de consulta web. 1 es el valor predeterminado. Esta entrada es opcional.

URL

Es una entrada requerida que apunta al servidor de WebFOCUS. Es preciso construir el URL como una llamada al Servlet de WebFOCUS y se necesita que contenga cualquier parámetro que haya que pasar.

parámetros POST

Es el método recomendado para recuperar grandes cantidades de datos y devolverlas como líneas de texto independientes. Por ejemplo:

http://WFserver/ibi_apps/WFServlet[CR]
PARAM1=value & PARAM2=value										

parámetros GET

Es el método preferido de recuperación de pequeñas cantidades de datos y de adjuntar los datos al URL. Por ejemplo:

http://server/ibi_apps/WFServlet?PARAM1=value&PARAM2=value										

[CR]

Designa los retornos de carro requeridos.

Paso 1: Cree el informe de WebFOCUS

Cree y guarde el siguiente informe de WebFOCUS con estilo aplicado como webq97. Inserte este informe en una hoja de cálculo de Excel 97. (Para dar estilo y ejecutar su solicitud de manera apropiada en Excel 97, asegúrese de que las hojas de estilo en cascada estén desactivadas; SET HTMLCSS=OFF es el valor predeterminado.)

Los números que aparecen a la izquierda de cada línea de código corresponden a anotaciones que siguen a la solicitud.

								1.  TABLE FILE CENTORD 
2.  SUM LINEPRICE AS 'Sales' 
3.  BY YEAR AS 'Year' 
4.  BY PRODCAT AS 'Category' 
5.  BY PRODNAME AS 'Product' 
6.  WHERE YEAR EQ '&YEAR'; 
7.  ON TABLE SET BYDISPLAY ON 
8.  ON TABLE PCHOLD FORMAT HTML 
9.  ON TABLE SET PAGE-NUM TOP 
10. ON TABLE SET STYLE * 
11. TYPE=REPORT, FONT=ARIAL, SIZE=10, GRID=OFF, BACKCOLOR=YELLOW, $ 
12. TYPE=TITLE, SIZE=11, STYLE=BOLD, $ 
13. TYPE=DATA, COLOR=RED, WHEN=LINEPRICE LT 15000000, $ 
14. TYPE=DATA, COLUMN=PRODCAT, FOCEXEC=webq2(PRODCAT=N1), $ 
15. ENDSTYLE 
16. END

La línea 1 identifica el origen de datos CENTORD, que contiene datos de ventas de Century Corporation.

Las líneas 2-5 definen los requisitos de visualización y clasificación del informe.

La línea 6 especifica los criterios de selección mediante una variable &YEAR.

La línea 7 establece BYDISPLAY en ON. Este ajuste garantiza que se alimenten con los datos los valores de clasificación repetidos en el informe.

De forma predeterminada, los valores de clasificación repetidos en las columnas verticales (o campos BY) se suprimen en un informe de WebFOCUS, dejando espacios en blanco en el informe. Este no es el comportamiento ideal en informes Excel, que están diseñados para funcionar con datos repetidos en cada fila correspondiente. Una columna o fila en blanco puede producir resultados distorsionados cuando clasifica datos.

La línea 8 define el formato de salida como HTML.

Importante: El informe debe estar en formato HTML, no en EXL97. Esto es así porque Microsoft Query importa páginas HTML completamente formateadas o tablas HTML individuales a una hoja de cálculo. Si ejecuta una solicitud EXL97 desde una consulta, no llegará dato alguno a la hoja de cálculo.

La línea 9 desactiva la numeración de páginas y elimina cualquier línea adicional generada encima de los títulos de columna.

Las líneas 10-15 especifican atributos de estilo para el informe, tales como color de fondo, estilo condicional, un ''drill-down'' a otro procedimiento, así como estilo misceláneo designado. El estilo, incluyendo el "drill-down", pasa íntegro a Excel.

Paso 2: Cree un archivo de consulta Web (IQY)

Abra un editor de texto y cree el siguiente archivo de consulta web

								1.  WEB 
2.  1 
3.  http://WFserver/ibi_apps/WFServlet?IBIF_ex=webq97
       &YEAR=["YEAR","Select Year"]

donde:

La línea 1 la identifica como una consulta web.

La línea 2 identifica la versión actual de Microsoft Query.

La línea 3 es una solicitud típica de WebFOCUS con el método GET. El nombre del procedimiento es webq97. La línea URL pasa un parámetro de YEAR al procedimiento. Se le pedirá al usuario que proporcione un valor para YEAR. El pase de parámetros es, por supuesto, opcional. En el ejemplo anterior, el parámetro es dinámico, aunque los parámetros también pueden ser estáticos. Es decir, no se puede modificar en el archivo IQY.

Fíjese que se requieren retornos de carro entre líneas en este archivo.

Después de haber construido la consulta, guarde su documento con una extensión .iqy en el directorio de Consultas, bajo Microsoft Office. Por ejemplo,

								<drive>:\Program Files\Microsoft Office\Queries\webq97.iqy

Ahora que el archivo IQY está listo, puede crear la hoja de cálculo e insertar la consulta.

Paso 3: Inserte la consulta en una hoja de cálculo de Excel 97

Este ejemplo comienza con una hoja de cálculo en blanco, inserta la consulta y después añade las campanas de alerta.

1. Abra una hoja de cálculo en blanco. Del menú de datos, seleccione Obtener datos externos y luego, Ejecutar consulta Web. Se abre el cuadro de diálogo de ejecución de consulta.
2. Sitúe el archivo IQY, webq97.icy, y pulse el botón Obtener datos. Se abre el cuadro de diálogo de ejecución de consulta.

   

3. Especifique dónde irán los datos en su hoja de cálculo. Puede elegir un rango en la hoja de cálculo actual o puede colocar los datos en una nueva hoja de cálculo. En este caso, especifique el rango especificado:

   

   No es necesario establecer el rango cuando se trata de una hoja de cálculo en blanco, sin embargo, puede que desee mostrar la salida de datos en una nueva hoja de cálculo y usar referencias a fórmulas para trabajar con los datos.

4. Pulse el botón Propiedades en el cuadro de diálogo Devolver datos externos. Se abre el cuadro de diálogos Propiedades de rango de datos externos. Ponga nombre a la consulta y establezca su comportamiento. Por ejemplo, indicar que la consulta se actualice automáticamente cada vez que se abra la hoja de cálculo. (Fíjese que también puede establecer propiedades después de la ejecución inicial.)

   

   Pulse Aceptar.

5. Pulse el botón Parámetros en el cuadro de diálogo Devolver datos externos para definir el comportamiento de cualquier parámetro que pueda haber en la consulta. Puede avisar al usuario, establecer un valor estático o utilizar un valor de una celda en la hoja de cálculo. En este ejemplo, avisará al usuario en referencia a YEAR.

   Introduzca el valor 1999.

   

6. Después de seleccionar el rango y establecer todas las propiedades de consulta, pulse Aceptar.

   La consulta ejecuta e importa los datos. Aparece el siguiente mensaje en la hoja de cálculo:

   webq97: Getting Data...

   Los datos aparecen en la hoja de cálculo:

   

7. Ahora que los datos han sido insertados en la hoja de cálculo, puede añadir características tales como fórmulas, imágenes, plantillas, macros, etc.

   

Ahora puede guardar esta hoja de cálculo localmente en su ordenador, guardarla en una unidad de red compartida en que múltiples usuarios puedan tener acceso a la información, o implementarla en su aplicación web. Consulte Cómo implementar una hoja de cálculo con una consulta Web de WebFOCUS.