4D Doc Center : Etiquetas HTML 4D

4D v12.4

Etiquetas HTML 4D

El servidor web 4D le ofrece diferentes etiquetas HTML específicas para 4D, permitiendo insertar referencias a las expresiones o variables 4D o diferentes tipos de procesos, en páginas HTML enviadas por el servidor Web 4D, por ejemplo con la ayuda de los comandos SEND HTML FILE y SEND HTML BLOB. Estas páginas se llaman páginas semidinámicas.

Estas etiquetas se insertan como comentarios HTML ( en código HTML). La mayoría de los editores HTML ofrecen funciones que facilitan la inserción de comentarios en las páginas estáticas.

Las siguientes etiquetas HTML 4D están disponibles:

4DTEXT, para insertar las variables y expresiones 4D,
4DHTML, para insertar el código HTML,
4DSCRIPT, para ejecutar un método 4D,
4DINCLUDE, para incluir una página dentro de otra,
4DIF, 4DELSE y 4DENDIF, para insertar las condiciones en el código HTML,
4DLOOP y 4DENDLOOP, para insertar bucles en el código HTML.

Etiquetas HTML 4D

El análisis del contenido de las páginas semidinámicas enviadas por 4D se efectúa en el momento de la llamada a los comandos SEND HTML FILE (.htm, .html, .shtm, .shtml) o SEND HTML BLOB (blob de tipo texto/html) o SEND HTML TEXT, como también cuando se envían páginas llamadas utilizando URLs. En este último caso, por razones de optimización las páginas que tienen el sufijo ".htm" y "html" NO se analizan.
Para forzar el análisis de páginas HTML en este caso, debe añadir el sufijo ".shtm" o ".shtml" (por ejemplo, http://www.server.com/dir/page.shtm). Un ejemplo de uso de este tipo de página se presenta en la descripción del comando WEB CACHE STATISTICS.

A continuación se presentan los casos en los cuales 4D analiza las etiquetas contenidas en las páginas HTML enviadas a los navegadores web:

Condiciones de envío	Análisis del contenido de las páginas enviadas
Extensiones de las páginas (caso general):
.htm, .html, .shtm, .shtml (páginas HTML)	X
.xml, .xsl (páginas XML)	X
.wml (páginas WML)	X
Páginas llamadas vía URLs	X, excepto páginas con extensiones “.htm” o “.html”
Comando SEND HTML FILE	X
Comando SEND HTML TEXT	X
Comando SEND HTML BLOB (si el BLOB es de tipo “text/html”)	X
Inclusión por la etiqueta <!--4DINCLUDE -->	X

Para ser procesado por 4D, un comentario HTML debe tener el siguiente formato . Por favor tenga en cuanta que algunos editores HTML añaden automáticamente otra información dentro del comentario; esto puede provocar errores de análisis.

Sin embargo, otros comentarios HTML tales como  son posibles.

Si un comentario , el siguiente mensaje “ esperado” se insertará y el análisis se interrumpirá en este nivel (la página se enviará para indicar el error).

Es posible mezclar diferentes tipos de comentarios. Por ejemplo, es posible la siguiente estructura HTML:

<HTML>
...
<BODY>
<!--#4DSCRIPT/PRE_PROCESS-->   (Llamada del método)
<!--#4DIF (mivar=1)-->   (Condición If)
   <!--#4DINCLUDE banner1.html-->   (Inserción de una subpágina)
<!--#4DENDIF-->   (Fin de if)
<!--#4DIF (mivar=2)-->
   <!--#4DINCLUDE banner2.html-->
<!--#4DENDIF-->

<!--#4DLOOP [TABLA]-->   (bucle en la selección actual)
<!--#4DIF ([TABLA]ValNum>10)-->   (If [TABLE]ValNum>10)
   <!--#4DINCLUDE subpagina.html-->   (inclusión de una sub página)
<!--#4DELSE-->   (Else)
   <B>Value: <!--#4DTEXT
 [TABLA]ValNum--></B><BR>
      (Visualización de un campo)
<!--#4DENDIF-->
<!--#4DENDLOOP-->   (Fin del bucle)
</BODY>
</HTML>

4DTEXT

Sintaxis:  o

La etiqueta  le permite insertar una referencia a una variable o a una expresión 4D en cualquier parte de una página HTML. Por ejemplo, si escribe:

<P>Bienvenido a<!--#4DTEXT vtNombreSitio-->!</P>

El valor de la variable 4D vtNomSite se insertará en la página HTML en el momento de su envío. Puede insertar una variable de texto 4D en el código HTML. Este valor se inserta en forma de texto simple.

También puede insertar las expresiones 4D (no sólo las variables) en los comentarios HTML 4D con la etiqueta 4DTEXT. Puede insertar directamente el contenido de un campo () o un elemento de array (por ejemplo ) o un método que devuelve un valor ().

La conversión de la expresión sigue las mismas reglas que la conversión de una variable. Además, la expresión debe cumplir con las reglas de sintaxis de 4D.

Nota: la ejecución de un método 4D con 4DTEXT depende del valor del atributo “Disponible vía las etiquetas HTML y URLs 4D (4DACTION...)” definido en las propiedades del método. Para mayor información, consulte la sección .

Aunque una expresión puede contener directamente las llamadas a funciones 4D, no es recomendable por razones de localización. Por ejemplo, , aunque es interpretado correctamente con un 4D en inglés no será entendido por una versión francesa. Lo mismo aplica a los números reales (el separador decimal puede variar de un país a otro). En ambos casos, es preferible afectar una variable por programación.

En caso de error de evaluación, el texto insertado será de la forma “ : ## error # error code”.

Notas:

Debe utilizar las variables proceso.
Es posible mostrar el contenido de un campo imagen. Por el contrario no es posible mostrar el contenido de un elemento de array imagen.
Como el HTML es una aplicación orientada al procesamiento de texto, por lo general usted trabajará con variables de texto. Sin embargo, puede utilizar las variables BLOB. Sólo necesita generar los BLOBs en modo Texto sin longitud.

Nota de compatibilidad: esta etiqueta más especializada remplaza la etiqueta genérica 4DVAR a partir de la versión 12.2 de 4D. La etiqueta 4DVAR aún es soportada y funciona como en las versiones anteriores. Sin embargo, no se recomienda utilizar la etiqueta 4DTEXT para insertar el texto.

4DHTML

Sintaxis:  o 

Esta etiqueta permite evaluar una variable o una expresión 4D e insertarla en una página como una expresión HTML. A diferencia de la etiqueta 4DTEXT, esta etiqueta convierte los caracteres a código HTML.

Por ejemplo, estos son los resultados de la inserción de la variable texto 4D mivar con las etiquetas disponibles:

Valor mivar	Etiquetas	Inserción en la página web
mivar:="<B>"	<!--#4DTEXT mivar-->	<B><B>
mivar:="<B>"	<!--#4DHTML mivar-->	<B>

En el caso de un error de evaluación, el texto insertado será de la forma “ : ## error # error code”.

Nota: la ejecución de un método 4D con 4DHTML depende del valor del atributo “Disponible vía las etiquetas HTML y URLs 4D (4DACTION...)” definido en las propiedades del método. Para mayor información consulte la sección Seguridad de las conexiones .

Nota: la variable texto debe expresarse utilizando el mapa de caracteres ISO Latin-1 (para mayor información, consulte la descripción del comando Mac to ISO).

Nota de compatibilidad: esta etiqueta remplaza la etiqueta 4DHTMLVAR a partir de la versión 12.2 de 4D. La etiqueta 4DHTMLVAR aún es soportada pero para una mejor legibilidad del código, se recomienda utilizar la etiqueta 4DHTML para insertar código HTML.

4DSCRIPT/

Sintaxis: 

La etiqueta 4DSCRIPT le permite ejecutar métodos 4D en el momento del envío de páginas HTML estáticas. La presencia de la etiqueta  en una página estática como un comentario HTML provoca la ejecución del método MiMetodo con el parámetro MiParam como cadena en $1. Cuando se carga la página de inicio, 4D llama al Método de base On Web Authentication (si existe). Si devuelve True, 4D ejecuta el método.

El método devuelve texto en $0. Si la cadena comienza con el carácter de código 1, se considera como HTML (el mismo principio que para las variables).

Nota: la ejecución de un método con 4DSCRIPT depende del valor del atributo “Disponible vía las etiquetas HTML y URLs 4D (4DACTION...)” definido en las propiedades del método. Para mayor información, consulte la sección .

Por ejemplo, inserte el siguiente comentario “Hoy es” en una página estática. Cuando se carga la página, 4D llama al Método de base On Web Authentication (si existe), luego llama al método MIMET y pasa la cadena “/MIPARAM” como parámetro $1.
El método devuelve texto en $0 (por ejemplo “12/31/03”); la expresión “Hoy es <!--#4DSCRIPT/MIMETH/MIPARAM––>” se convierte en “Hoy es 12/31/03”.

El código del método MIMET es:

 C_TEXT($0) `Este parámetro siempre debe declararse

 C_TEXT($1) `Este parámetro siempre debe ser declararse

 $0:=String(Current date)

Nota: un método llamado por 4DSCRIPT no debe llamar elementos de interfaz (DIALOG, ALERT...).

Como 4D ejecuta los métodos en su orden de aparición, es muy posible llamar a un método que define el valor de muchas variables que están referenciadas más adelante en el documento, cualquiera que sea el modo que esté utilizando.

Nota: puede insertar tantos comentarios  como quiera en una página estática.

4DINCLUDE

Sintaxis:

Este comentario permite incluir, en una página HTML, otra página HTML (indicado por el parámetro ruta). Por defecto sólo se incluye el cuerpo de la página HTML especificada, es decir el contenido entre las etiquetas <body> y </body> (las etiquetas mismas no se incluyen). Esto le permite evitar conflictos relacionados con las etiquetas presentes en los encabezados. Sin embargo si la página HTML especificada no contiene etiquetas <body></body>, se incluye la página completa. Usted debe verificar la consistencia de las etiquetas.

El comentario  es muy útil en combinación con las pruebas () o los bucles (). Es muy conveniente incluir etiquetas en función de un criterio o de manera aleatoria.
Al momento de la inclusión, sin importar la extensión del nombre del archivo, 4D analiza la página llamada y luego inserta los contenidos (modificados o no) en la página que origina la llamada 4DINCLUDE.

La ubicación en la caché web de una página incluida con el comentario  responde a las mismas reglas que las páginas llamadas vía un URL o enviadas con el comando SEND HTML FILE.

Pase en ruta, la ruta de acceso al documento a incluir. Advertencia: en el caso de la etiqueta 4DINCLUDE, la ruta de acceso es relativa al documento en curso de análisis, es decir el documento “padre”. Utilice el carácter barra oblicua (/) como separador de carpetas y los dos puntos (..) para subir un nivel (sintaxis HTML).

Nota: cuando utiliza la etiqueta 4DINCLUDE con el comando PROCESS HTML TAGS, la carpeta por defecto es la carpeta que contiene el archivo de estructura de la base.

El número de  dentro de una página es ilimitado. Sin embargo, las llamadas a  sólo pueden realizarse a un nivel. Esto significa que, por ejemplo, no puede insertar el comentario  en el cuerpo de la página midoc2.html, llamada por  insertado en midoc1.html.
Además, 4D verifica que las inclusiones no sean recursivas.

En caso de error, el texto insertado es de la forma " :No se puede abrir el documento".

Ejemplos

<<!--#4DINCLUDE subpagina.html--> 
<!--#4DINCLUDE carpeta/subpagina.html--> 
<!--#4DINCLUDE ../carpeta/subpagina.html-->

4DIF, 4DELSE y 4DENDIF

Sintaxis:   

Utilizado con los comentarios  (opcional) y , el comentario  ofrece la posibilidad de ejecutar código HTML de manera condicional.

El parámetro expresion puede contener toda expresión 4D válida devolviendo un valor booleano. Debe estar entre paréntesis y cumplir con las reglas de sintaxis de 4D.

Los bloques  ...  pueden estar anidados en varios niveles. Como en 4D, cada  debe tener un  correspondiente.

En caso de un error de interpretación, el texto “: Se esperaba una expresión booleana” se inserta en lugar del contenido situado entre  y .

De la misma forma, si no hay tantos  como , el texto “: 4DENDIF esperado” se inserta en lugar de los contenidos ubicados entre  y .

Ejemplo

Este ejemplo de código insertado en una página HTML estática muestra una etiqueta diferente de acuerdo al resultado de la expresión vnom#"":

<BODY>
...
<!--#4DIF (vnom#"")-->
Nombres que comienzan por <!--#4DTEXT vnom-->.
<!--#4DELSE-->
No se ha encontrado ningún nombre.
<!--#4DENDIF-->
...
</BODY>

4DLOOP y 4DENDLOOP

Sintaxis:  

Este comentario permite la repetición de una parte de código HTML siempre y cuando se cumpla la condición. La porción está delimitada por  y .

Los bloques  ...  pueden estar imbricados. Como en 4D, cada  debe tener un  correspondiente.

Hay tres tipos de condiciones:

Esta sintaxis realiza un bucle para cada registro desde la selección actual de la tabla en el proceso en actual. La porción de código HTML ubicada entre los dos comentarios se repite para cada registro de la selección actual.

Nota: cuando la etiqueta 4DLOOP se utiliza con una tabla, los registros se cargan en modo sólo lectura.

El siguiente código HTML:

<!--#4DLOOP [Personas]-->
<!--#4DTEXT [Personas]Nombre--> <!--#4DVAR [Personas]Apellido-><BR>
<!--#4DENDLOOP-->

... puede traducirse en lenguaje 4D como:

 FIRST RECORD([Personas])

 While(Not(End selection([Personas])))

    ...

    NEXT RECORD([Personas])

 End while

Esta sintaxis efectúa in bucle para cada elemento del array. El elemento actual del array se incrementa cuando se repite la porción de código HTML.

Nota: esta sintaxis no puede utilizarse con arrays de dos dimensiones. En este caso, es mejor combinar un método con bucles anidados.

El siguiente ejemplo de código HTML:

<!--#4DLOOP arr_nombres-->
<!--#4DTEXT arr_nombres{arr_nombres}--><BR>
<!--#4DENDLOOP-->

... puede traducirse en lenguaje 4D como:

 For($Elem;1;Size of array(arr_nombres))

    arr_nombres:=$Elem

    ...

 End for

Esta sintaxis efectúa un bucle mientras el método devuelva True. El método admite un parámetro de tipo Entero largo. Primero se llama con el valor 0 para permitir una fase de inicialización (si es necesaria); luego se llama con los valores 1, 2, 3, ... mientras devuelva True.

Por razones de seguridad, el Método de base On Web Authentication puede llamarse, sólo una sola vez, antes de la fase de inicialización (ejecución del método con 0 como parámetro). Si se confirma la autenticación, se lleva a cabo la fase de inicialización.

Advertencia: C_BOOLEAN($0) y C_LONGINT($1) DEBEN declararse dentro del método por motivos de compilación.

El ejemplo de código HTML siguiente:

<!--#4DLOOP mi_metodo-->
<!--#4DTEXT var--> <BR>
<!--#4DENDLOOP-->

... puede traducirse en código 4D como:

 If(AuthenticationWebOK)

    If(mi_metodo(0))

       $contador:=1

       While(mi_metodo($contador))

          ...

          $contador:=$contador+1

       End while

    End if

 End if

El método mi_metodo puede ser de esta forma:

 C_LONGINT($1)

 C_BOOLEAN($0)

 If($1=0)

  `Inicialización

    $0:=True

 Else

    If($1<50)

       ...

       var:=...

       $0:=True

    Else

       $0:=False `Detiene el bucle

    End if

 End if

En caso de un error de interpretación, el texto “: Descripción” se inserta en lugar del contenido ubicado entre  y .

Puede aparecer uno de los siguientes mensajes:
- No se esperaba una expresión de este tipo (error estándar)
- Nombre de tabla incorrecto (error en el nombre de la tabla)
- Se esperaba un array (la variable no es un array o es un array de dos dimensiones)
- El método no existe
- Error de sintaxis (cuando el método se ejecuta)
- Error de acceso (no tiene los privilegios de acceso apropiados para acceder a la tabla o al método)
- 4DENDLOOP esperado (el número de  no corresponde con ).