Manual de consulta

Bloque REPORT

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:

Restricciones

El bloque REPORT puede contener estos elementos:

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 ]