Cómo usar el miniservidor

Referencia: Requisitos de configuración del miniservidor de WebFOCUS

Su servidor Web debe ser compatible y tener activada la función de miniservidor. A continuación le mostramos los tipos válidos de compatibilidad de miniservidor:

Servidor Web compatible con miniservidor nativo (por ejemplo, iPlanet™ o WebSphere®).
Servidor Web con complemento de motor de miniservidor (por ejemplo, ServletExec™ o JRun™).
Servidor de aplicaciones Web (por ejemplo, WebSphere, WebLogic® o SilverStream®).

Sintaxis: Cómo Llamar al miniservidor desde un hipervínculo

<A HREF="/alias/WFServlet?IBIF_ex=procedure[&var=value[&var=value]...]"> 
text</A>

donde:

alias

Apunta al directorio en que está situado el Miniservidor de WebFOCUS. El servidor Web utiliza un alias para asignar un nombre lógico a un directorio físico. El alias por defecto de es ibi_apps. Se establece durante la instalación y configuración de WebFOCUS.

Para invocar el Miniservidor de WebFOCUS desde otro servidor Web, especifique un URL completamente cualificado:

http://web_server/ibi_apps/WFServlet...

procedure

Es el nombre del procedimiento que se va a ejecutar.

var=value

Es una variable y su correspondiente valor. La llamada puede incluir variables de entorno HTTP y de aplicaciones pasadas al procedimiento.

Puede pasar más de una pareja variable-valor, sin incluir un espacio entre ellas. Emplee el carácter de ampersand (&) como delimitador para separar cada pareja variable-valor.

Si el valor contiene un espacio insertado, sustitúyalo por el signo más (+) o por los caracteres %20.

text

Es el texto de la página de inicio que funciona como el hipervínculo que ejecuta el procedimiento.

Nota: La longitud máxima del URL puede ser de 4K o 4,096 bytes. El número de parámetros es ilimitado, aunque su longitud total no puede exceder los 4K.

Principio de página

Ejemplo: Cómo llamar al miniservidor desde un hipervínculo

Este ejemplo crea una página de inicio con cuatro hipervínculos. Cada hipervínculo llama al miniservidor para que pase:

Es el nombre de un procedimiento que se va a ejecutar.
Dos valores requeridos por el procedimiento.

Nota: Para más información acerca de dónde almacenar los archivos creados en este ejemplo, consulte Cómo definir y asignar archivos de WebFOCUS.

Cree un procedimiento llamado CSALES. Genera un informe dinámico que muestra la ventas totales en unidades y dólares de una categoría y región.

Procedimiento: CSALES.FEX

TABLE FILE GGSALES
HEADING
"&CATEGORY Sales for &RGN Region"
SUM UNITS AND DOLLARS
WHERE (CATEGORY EQ '&CATEGORY') AND (REGION EQ '&RGN');
ON TABLE SET PAGE-NUM OFF
ON TABLE SET STYLE *
TYPE=REPORT, GRID=OFF,$
ENDSTYLE
END

Cree una página de inicio llamada CSALES. Cada instancia del código A HREF invoca el Miniservidor de WebFOCUS y le pasa el nombre del procedimiento, CSALES. Además, cada instancia pasa el valor Café para CATEGORY, y un valor para RGN (Medio Oeste, Noroeste, Sureste u Oeste). Los hipervínculos de la página de inicio indican al usuario que introduzca la región de interés.

Página de inicio: CSALES.HTM

<HTML>
<HEAD>
<TITLE> WebFOCUS Report </TITLE>
</HEAD>
<BODY>
<H4 ALIGN=CENTER>Coffee Sales by Region</H4>
<HR>
<P><FONT SIZE=+2></FONT><BR>
<FONT SIZE=+1>Select a region:</FONT>
</P>
<UL TYPE=SQUARE>
<LI>

<A HREF="/ibi_apps/WFServlet?IBIF_ex=csales&CATEGORY=
Coffee&RGN=Midwest">Midwest</A>

<LI>

<A HREF="/ibi_apps/WFServlet?IBIF_ex=csales&CATEGORY=
Coffee&RGN=Northeast">Northeast</A>

<LI>

<A HREF="/ibi_apps/WFServlet?IBIF_ex=csales&CATEGORY=
Coffee&RGN=Southeast">Southeast</A>

<LI>

<A HREF="/ibi_apps/WFServlet?IBIF_ex=csales&CATEGORY=
Coffee&RGN=West">West</A>

</UL>
</BODY>
</HTML>

Ejecute la página de inicio en su navegador. Tendrá un aspecto similar a éste:
Pulse el hipervínculo Medio Oeste para recibir el informe:

Sintaxis: Cómo Llamar al miniservidor desde un formulario

<FORM ACTION="/ibi_apps/WFServlet" METHOD="get">
<INPUT NAME="IBIF_ex" VALUE="procedure" TYPE="hidden">
   .
   .
   .
</FORM>

donde:

procedure: Es el nombre del procedimiento que se va a ejecutar. La llamada puede incluir variables de entorno HTTP y de aplicaciones pasadas al procedimiento.

Referencia: Convenciones de creación de formularios

Para iniciar y terminar un formulario, use la etiqueta HTML <FORM.
Para especificar el nombre del procedimiento que se va a ejecutar, use la etiqueta HTML <INPUT.
Incluya los controles necesarios en el formulario, como cuadros de texto, casillas o listas desplegables.
Incluya un botón de Enviar para ejecutar el miniservidor y pasar los valores obtenidos en el formulario al procedimiento.

Principio de página

Ejemplo: Cómo llamar al miniservidor desde un formulario

En este ejemplo se ha creado una página de inicio con un formulario que invoca al miniservidor para que pase:

Es el nombre de un procedimiento que se va a ejecutar.
Dos valores requeridos por el procedimiento. El formulario indica al usuario que introduzca el primer valor con un cuadro de texto de una línea, y un segundo valor con botones radio.

Nota: Para más información acerca de dónde almacenar los archivos creados en este ejemplo, consulte Cómo definir y asignar archivos de WebFOCUS.

Si no lo ha hecho en el ejemplo anterior, cree un procedimiento llamado CSALES. Genera un informe dinámico que muestra la ventas totales en unidades y dólares de una categoría y región solicitadas por el usuario.
Procedimiento: CSALES.FEX
```
TABLE FILE GGSALES
HEADING
"&CATEGORY Sales for &RGN Region"
SUM UNITS AND DOLLARS
WHERE (CATEGORY EQ '&CATEGORY') AND (REGION EQ '&RGN');
ON TABLE SET PAGE-NUM OFF
ON TABLE SET STYLE *
TYPE=REPORT, GRID=OFF,$
ENDSTYLE
END
```

Cree una página de inicio llamada SALES.HTM. Contiene un procedimiento que invoca al miniservidor para que pase el nombre del procedimiento, CSALES. El cuadro de texto de una línea indica al usuario que introduzca un valor para CATEGORY, mientras que los botones de radio solicitan valores para RGN.

El formulario también incluye un botón de envío (Ejecutar informe) y un botón de restablecimiento (Borrar formulario). Para indicar a un usuario que rellene un formulario, debe incluir un botón de envío.

Página de inicio: SALES.HTM

<HTML>
<HEAD>
<TITLE> WebFOCUS Report </TITLE>
</HEAD>
<BODY>
<H4 ALIGN=CENTER>Sales Report by Category and Region</H4>
<HR>

<FORM ACTION="/ibi_apps/WFServlet" METHOD="get">
<INPUT NAME="IBIF_ex" VALUE="csales" TYPE="hidden">
<P ALIGN=LEFT NOWRAP><PRE>
<B>Enter category: </B><INPUT NAME="CATEGORY" TYPE="text" SIZE="6">
</PRE></P>
<P><PRE><B>Select region: </B>
<INPUT NAME="RGN" TYPE=RADIO VALUE=Midwest>Midwest
<INPUT NAME="RGN" TYPE=RADIO VALUE=Northeast>Northeast
<INPUT NAME="RGN" TYPE=RADIO VALUE=Southeast>Southeast
<INPUT NAME="RGN" TYPE=RADIO VALUE=West>West
</PRE></P>
<P>
<INPUT NAME="submit" TYPE=SUBMIT VALUE="Run Report"> 
<INPUT NAME="reset" TYPE=RESET VALUE="Clear Form">
</P>
</FORM>

</BODY>
</HTML>

Ejecute la página de inicio en su navegador. Tendrá un aspecto similar a éste:
En el cuadro de texto de una línea, introduzca:
```
Coffee
```
Seleccione el botón de radio Sureste.
Pulse Ejecutar para recibir el informe.