Manual de consulta

Sentencia INCLUDE

Finalidad

Lee e incorpora un archivo en la macro de Net.Data en la que se ha especificado la sentencia.

Net.Data examina los directorios especificados en la sentencia INCLUDE_PATH del archivo de inicialización para buscar el archivo de inclusión.

Puede utilizar archivos include del mismo modo que en la mayoría de los lenguajes de alto nivel. Pueden insertar cabeceras y pies de página comunes, definir conjuntos de variables comunes o incorporar una biblioteca de subrutinas común de definiciones de bloque FUNCTION en una macro de Net.Data.

Net.Data ejecuta una sentencia INCLUDE sólo una vez al procesar la macro e inserta el contenido del archivo incluido en la ubicación de la sentencia INCLUDE de la macro. Las referencias de variables en el nombre del archivo incluido se resuelven la primera vez que se ejecuta la sentencia INCLUDE y no cuando va a ejecutarse el contenido del archivo incluido.

Cuando una sentencia INCLUDE está en un bloque ROW o WHILE, Net.Data no ejecuta repetidamente la sentencia INCLUDE. Net.Data ejecuta la sentencia INCLUDE la primera vez que ejecuta el bloque ROW o WHILE, incorpora el contenido del archivo incluido en el bloque y después ejecuta repetidamente el bloque ROW o WHILE con el contenido del archivo incluido.

Sugerencia para la autorización Asegúrese de que el ID de usuario con el que se ejecuta Net.Data tenga derechos de acceso para los archivos a los que hace referencia cualquier sentencia INCLUDE. Consulte la sección sobre la especificación de derechos de acceso del servidor Web para archivos Net.Data en el capítulo de configuración del manual Guía de administración y programación de Net.Data para obtener más información.

Sintaxis

                  .-----------------------------.
                  V                             |
>>-%INCLUDE----"----+-serie------------------+--+---"----------><
                    '-referencia de variable-'
 

Valores

%INCLUDE
Palabra clave que indica que un archivo ha de leerse e incorporarse a la macro de Net.Data.

nombre
Serie numérica o alfabética que comienza por un carácter alfabético o un subrayado y que contiene cualquier combinación de caracteres alfabéticos, numéricos, de subrayado o de punto.

serie
Cualquier secuencia de caracteres alfabéticos y numéricos y de puntuación, excepto el carácter de nueva línea.

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.

Contexto

La sentencia INCLUDE puede encontrarse en estos contextos:

Restricciones

La sentencia INCLUDE puede contener estos elementos:

No se permiten llamadas de función en la serie.

Puede anidar un máximo de diez bloques INCLUDE.

Ejemplos

Ejemplo 1: Una sentencia INCLUDE en un bloque HTML

%HTML(start){
%INCLUDE "header.hti"
...
%}

Ejemplo 2: Una sentencia INCLUDE en un bloque REPORT

%REPORT {
  %INCLUDE "report_header.txt"
      %ROW {
    %INCLUDE "row_include.txt"
  %}
  %INCLUDE "report_footer.txt"
%}

Ejemplo 3: Referencias de variables en una sentencia INCLUDE

%define REMOTE_USER = %ENVVAR
%include "$(REMOTE_USER).hti"
 


[ Principio de página | Página anterior | Página siguiente | Contenido | Índice ]