Manual de consulta

Bloque WHILE

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:

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:

Restricciones

El bloque WHILE puede contener estos elementos:

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 ]