Manual de consulta
Finalidad
Da formato a la salida de una llamada de función. Puede entrar un
parámetro de nombres de tabla para especificar que el informe va a utilizar
los datos de dicha tabla. En caso contrario, el informe se genera con
la primera tabla de salida que se encuentre en la lista de parámetros de
función, o con los datos de tabla por omisión, en el caso de que no haya
ningún nombre de tabla en la lista.
Sintaxis
>>-%REPORT----+---------------+--{------------------------------>
'-(--nombre--)--'
.----------------------------------.
V |
>--------+----------------------------+--+---+------------+----->
+-serie----------------------+ '-bloque row-'
+-bloque if------------------+
+-referencia de variable-----+
+-llamada de función---------+
+-sentencias de presentación-+
+-sentencia include----------+
'-bloque while---------------'
.----------------------------------.
V |
>--------+----------------------------+--+--%}-----------------><
+-serie----------------------+
+-bloque if------------------+
+-referencia de variable-----+
+-llamada de función---------+
+-sentencias de presentación-+
+-sentencia include----------+
'-bloque while---------------'
Valores
- %REPORT
- Palabra clave para especificar instrucciones de formateo para la salida de
una llamada de función. Puede utilizar información de cabecera y pie de
página para el informe.
- nombre
- Este valor representa un conjunto de resultados o una tabla de
Net.Data. Consulte el apartado sobre el bloque Report en el
manual Guía de administración y programación de Net.Data
para obtener más información.
- serie
- Cualquier secuencia de caracteres alfabéticos y numéricos y de
puntuación.
- bloque if
- El bloque IF. Efectúa el proceso de serie condicional. Los
valores de serie de la lista de condiciones se tratan como numéricos a efectos
de comparación si representan números enteros y no tienen ningún espacio en
blanco inicial o de cola. Pueden tener un signo más (+) o menos (-)
inicial. Consulte la sintaxis y ejemplos en el apartado Bloque IF.
- referencia de variable
- Devuelve el valor de una variable y se especifica con $ y (). Por
ejemplo: si VAR='abc', entonces $(VAR)
devuelve el valor 'abc'. Consulte el apartado Referencia de variables para obtener información de sintaxis.
- llamada de función
- Invoca uno o más bloques FUNCTION o MACRO_FUNCTION, o una función
incorporada de Net.Data con argumentos específicos. Consulte la
sintaxis y ejemplos en el apartado Llamada de función (@).
- sentencias de presentación
- Incluye cualquier carácter alfabético o numérico, así como códigos HTML
que han de formatearse para el navegador del cliente.
- sentencia include
- La sentencia INCLUDE. Lee e incorpora un archivo en la macro de
Net.Data. Consulte la sintaxis y ejemplos en el apartado Sentencia INCLUDE.
- bloque row
- El bloque ROW. Visualiza datos con formato HTML una vez por cada
fila de datos que se devuelve desde una llamada de función. Consulte la
sintaxis y ejemplos en el apartado Bloque ROW.
- bloque while
- El bloque WHILE. Efectúa la repetición en bucle con el proceso de
serie condicional. Consulte la sintaxis y ejemplos en el apartado Bloque WHILE.
Contexto
El bloque REPORT puede encontrarse en estos contextos:
- Bloque o sentencia FUNCTION
Restricciones
El bloque REPORT puede contener estos elementos:
- Bloque Comment
- Bloque IF
- Sentencias INCLUDE
- Bloques ROW
- Bloques WHILE
- Llamadas de función
- Sentencias de presentación
- Series
- Referencias de variables
Ejemplos
Ejemplo 1: Una tabla HTML a dos columnas que muestra una
lista de nombres y ubicaciones
%FUNCTION(DTW_SQL) mytable() {
%REPORT{
<h2>Query Results</h2>
<p>Select a name for details.</p>
<table border="1">
<tr><td>Name</td><td>Location</td></tr>
%ROW{
<tr>
<td>
<a href="/cgi-bin/db2www/name.mac/details?name=$(V1)&loc=$(V2)">$(V1)
</a></td>
<td>$(V2)</td>
</tr>
%}
</table>
%}
La selección de un nombre de la tabla llama al bloque HTML
detalles de la macro de Net.Data name.mac
y le envía los dos valores como parte del URL. En este ejemplo, los
valores pueden utilizarse en name.mac para buscar detalles
adicionales sobre el nombre.
[ Principio de página | Página anterior | Página siguiente | Contenido | Índice ]