Manual de consulta
Finalidad
Proporciona una construcción de repetición en bucle basada en el
proceso de serie condicional. Puede utilizar el bloque WHILE en el
bloque HTML, el bloque REPORT, el bloque ROW, el bloque IF y el bloque
MACRO_FUNCTION. Los valores de serie de la lista de condiciones se
tratan como numéricos a efectos de comparación si son series que representan
enteros y no tienen ningún espacio en blanco inicial o de cola. Pueden
tener un único signo más (+) o menos (-) inicial.
Sintaxis
>>-%WHILE--| lista de condiciones |---{------------------------->
.---------------------------------.
V |
>--------+---------------------------+--+--%}------------------><
+-llamada de función--------+
+-sentencia de presentación-+
+-bloque if-----------------+
+-sentencia include---------+
+-bloque while--------------+
+-referencia de variable----+
'-serie---------------------'
lista de condiciones
|---(--+-(--lista de condiciones--)----------------------+---)--|
+-lista de condiciones--&&--lista de condiciones--+
+-lista de condiciones--||--lista de condiciones--+
+-!--lista de condiciones-------------------------+
+-| condición |-----------------------------------+
'-| término |-------------------------------------'
condición
|---término--+-<--+---término-----------------------------------|
+->--+
+-<=-+
+->=-+
+-!=-+
'-==-'
término
|---+-nombre_variable-------------------------+-----------------|
+-referencia de variable------------------+
+-llamada de función----------------------+
| .-----------------------------. |
| V | |
'-"----+-serie------------------+--+---"--'
+-referencia de variable-+
'-llamada de función-----'
Valores
- %WHILE
- La palabra clave que especifica el proceso en bucle.
- lista de condiciones
- Compara los valores de condiciones y términos. Las listas de
condiciones pueden conectarse utilizando operadores Booleanos. Una
lista de condiciones puede anidarse dentro de otra lista de
condiciones.
- condición
- Comparación entre dos términos utilizando operadores de
comparación. Una condición IF se trata como comparación numérica si se
cumplen las siguientes condiciones:
- El operador de condición es uno de los operadores siguientes:
<,<=,>,>=,==,!=
- Ambos términos son series que representan números enteros válidos, siendo
un entero válido una serie de dígitos, que van precedidos opcionalmente por un
signo más (+) o menos (-) y ningún otro espacio en blanco.
Si no se cumple una de las dos condiciones, se efectúa una comparación de
serie normal.
- término
- Un nombre de variable, serie, referencia de variables, para una llamada de
función.
- llamada de función
- Invoca uno o más bloques FUNCTION o MACRO_FUNCTION, o funciones
incorporadas con argumentos específicos. Consulte la sintaxis y
ejemplos en el apartado Llamada de función (@).
- sentencia 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.
- 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.
- 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 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.
- 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.
- serie
- Cualquier secuencia de caracteres alfabéticos y numéricos y de
puntuación. Una serie en el término de la lista de condiciones puede
contener cualquier carácter, excepto el carácter de nueva línea.
- nombre de variable
- Nombre que identifica una variable. Consulte el apartado Nombre de variable para obtener información sobre sintaxis.
Contexto
El bloque WHILE puede encontrarse en estos contextos:
- Bloque HTML
- Bloque REPORT
- Bloque ROW
- Bloque MACRO_FUNCTION
- Bloque IF
- Bloque WHILE
Restricciones
El bloque WHILE puede contener estos elementos:
- Bloque Comment
- Bloque IF
- Bloque WHILE
- Series
- Sentencias de presentación
- Llamadas de función
- Referencias de variables
- Sentencias INCLUDE
Ejemplos
Ejemplo 1: Bloque WHILE que genera filas en una tabla
%DEFINE loopCounter = "1"
%HTML(build_table) {
%{ generate table tag and column headings %}
<table border="1">
<tr><th>Item #</th>
<th>Description</th>
</tr>
%WHILE (loopCounter <= "100") {
%{ generate individual rows %}
<tr><td>$(loopCounter)</td>
<td>@getDescription(loopCounter)</td></tr>
%{ increment loop counter %}
@dtw_add(loopCounter, "1", loopCounter)
%}
</table>
%}
[ Principio de página | Página anterior | Página siguiente | Contenido | Índice ]