4D Doc Center : Etiquetas HTML 4D

4D v13.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 WEB SEND 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.

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,
4DBASE, para modificar la carpeta por defecto utilizada por la etiqueta 4DINCLUDE,
4DIF, 4DELSE, 4DELSEIF 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 WEB SEND FILE (.htm, .html, .shtm, .shtml) o SEND HTML BLOB (blob de tipo texto/html) o WEB SEND 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.

Internamente, el analizador trabaja con las cadenas UTF-16, pero los datos a analizar pueden haber sido codificados de manera diferente. Cuando las etiquetas contienen texto (por ejemplo, 4DHTML), 4D convierte los datos cuando es necesario dependiendo de su origen y de la información disponible (charset). A continuación están los casos donde 4D analiza las etiquetas contenidas en las páginas HTML, como también las conversiones efectuadas:

Acción	Análisis del contenido de las páginas enviadas	Conjunto de caracteres utilizado para el análisis de las etiquetas
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”	Uso del charset pasado como parámetro del encabezado "Content-Type" de la página. Si no hay, busca una etiqueta META-HTTP EQUIV con un charset. De lo contrario, utiliza el conjunto de caracteres por defecto del servidor HTTP
Comando WEB SEND FILE	X	Uso del charset pasado como parámetro del encabezado "Content-Type" de la página. Si no hay, busca una etiqueta META-HTTP EQUIV con un charset. De lo contrario, utiliza el conjunto de caracteres por defecto del servidor HTTP
Comando WEB SEND TEXT	X	No es necesaria la conversión
Comando SEND HTML BLOB	X, si el BLOB es de tipo “text/html”	Uso del charset pasado como parámetro del encabezado "Content-Type" de la respuesta. De lo contrario, utilice el conjunto de caracteres por defecto para el servidor HTTP
Inclusión por la etiqueta <!--4DINCLUDE -->	X	Uso del charset pasado como parámetro del encabezado "Content-Type" de la página. Si no hay, busca una etiqueta META-HTTP EQUIV con un charset. De lo contrario, utiliza el conjunto de caracteres por defecto del servidor HTTP
Comando PROCESS 4D TAGS	X	Datos texto: no conversión. Datos BLOB: conversión automática del conjunto de caracteres Mac-Roman por compatibilidad

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, son posibles otros comentarios HTML tales como .

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 (myvar=1)-->   (Condición If)
   <!--#4DINCLUDE banner1.html-->   (Inserción de una subpágina)
<!--#4DENDIF-->   (Fin de if)
<!--#4DIF (myvar=2)-->
   <!--#4DINCLUDE banner2.html-->
<!--#4DENDIF-->

<!--#4DLOOP [TABLE]-->   (bucle en la selección actual)
<!--#4DIF ([TABLE]ValNum>10)-->   (If [TABLE]ValNum>10)
   <!--#4DINCLUDE subpage.html-->   (inclusión de una sub página)
<!--#4DELSE-->   (Else)
   <B>Value: <!--#4DTEXT [TABLE]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 NombreVar 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 Seguridad de las conexiones.

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 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 Seguridad de las conexiones.

El análisis de los contenidos de la página se realiza con WEB SEND FILE (.htm, .html, .shtm, .shtml) o se llama SEND HTML BLOB (blob de tipo texto/html).
Recuerde que en modo no contextual, el análisis también se hace cuando un URL apunta a un archivo que tiene una extensión “.shtm” o “.shtml” (por ejemplo http://www.server.com/dir/page.shtm).

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 WEB SEND 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).

Notas:

cuando utiliza la etiqueta 4DINCLUDE con el comando PROCESS 4D TAGS, la carpeta por defecto es la carpeta que contiene el archivo de estructura de la base.
Puede modificar la carpeta por defecto utilizada por la etiqueta 4DINCLUDE en la página actual, utilizando la etiqueta  (ver a continuación).

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-->

4DBASE

Sintaxis:

La etiqueta  designa un directorio de trabajo que será utilizado por la etiqueta .
Cuando se llama en una página web, la etiqueta  modifica todas las llamadas  posteriores en esta página, hasta la próxima , si la hay. Si la carpeta  se modifica desde un archivo incluido, recupera su valor original desde el archivo padre.

El parámetro rutaCarpeta debe contener una ruta de acceso relativa a la página actual y debe terminar con una barra oblicua (/). La carpeta designada debe ubicarse al interior de la carpeta web.
Pase la palabra clave WEBFOLDER para restablecer la ruta por defecto (relativa a la página).

Por lo tanto el siguiente código, debe especificar una ruta relativa a cada llamada:

<!--#4DINCLUDE subpage.html--> 
<!--#4DINCLUDE folder/subpage1.html-->
<!--#4DINCLUDE folder/subpage2.html-->
<!--#4DINCLUDE folder/subpage3.html-->
<!--#4DINCLUDE ../folder/subpage.html-->

... puede escribirse utilizando la etiqueta :

<!--#4DINCLUDE subpage.html--> 
<!--#4DBASE folder/-->
<!--#4DINCLUDE subpage1.html-->
<!--#4DINCLUDE subpage2.html-->
<!--#4DINCLUDE subpage3.html-->
<!--#4DBASE ../folder/-->
<!--#4DINCLUDE subpage.html-->
<!--#4DBASE WEBFOLDER-->

Ejemplo

Definición de un directorio para la página de inicio utilizando la etiqueta :

/* Index.html */
<!--#4DIF LangFR=True-->
    <!--#4DBASE FR/-->
<!--#4DELSE-->
    <!--#4DBASE US/-->
<!--#4DENDIF-->
<!--#4DINCLUDE head.html-->
<!--#4DINCLUDE body.html-->
<!--#4DINCLUDE footer.html-->

En el archivo head.html, la carpeta actual se modifica vía , sin que cambie su valor en Index.html:

/* Head.htm */
/* el directorio de trabajo aquí es relativo al archivo incluido (FR/ o US/) */
<!--#4DBASE Styles/-->
<!--#4DINCLUDE main.css-->
<!--#4DINCLUDE product.css-->
<!--#4DBASE Scripts/-->
<!--#4DINCLUDE main.js-->
<!--#4DINCLUDE product.js-->

4DIF, 4DELSE, 4DELSEIF y 4DENDIF

Sintaxis:  {...} {}

Utilizado con los comentarios  (opcional),  (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 .

Utilizando la etiqueta , puede probar un número ilimitado de condiciones. Sólo se ejecuta el código que sigue la primera condición evaluada como True. Si ninguna condición es verdadera, no se ejecuta ninguna instrucción (si no hay  final).
Puede utilizar una etiqueta  después de la última . Si todas las condiciones son falsas, las instrucciones siguientes a  se ejecutan.

Los siguientes dos códigos son equivalentes.

Código utilizando únicamente 4DELSE:

<!--#4DIF Condition1-->
  /* Condition1 es true*/
<!--#4DELSE-->
    <!--#4DIF Condition2-->
        /* Condition2 es true*/
    <!--#4DELSE-->
        <!--#4DIF Condition3-->
            /* Condition3 es true */
        <!--#4DELSE-->
            /*Ninguna de las condiciones es verdadera*/
        <!--#4DENDIF-->
    <!--#4DENDIF-->
<!--#4DENDIF-->

Código similar utilizando la etiqueta 4DELSEIF:

<!--#4DIF Condition1-->
     /* Condition1 es true*/
<!--#4DELSEIF Condition2-->
     /* Condition2 es true*/
<!--#4DELSEIF Condition3-->
    /* Condition3 es true */
<!--#4DELSE-->
    /* Ninguna de las condiciones es verdadera*/
<!--#4DENDIF-->

Ejemplo 1

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>

Ejemplo 2

Este ejemplo inserta páginas diferentes en función del usuario conectado:

<!--#4DIF LoggedIn=False-->
    <!--#4DINCLUDE Login.htm -->
<!--#4DELSEIF User="Admin" -->
    <!--#4DINCLUDE AdminPanel.htm -->
<!--#4DELSEIF User="Manager" -->
    <!--#4DINCLUDE SalesDashboard.htm -->
<!--#4DELSE-->
    <!--#4DINCLUDE ItemList.htm -->
<!--#4DENDIF-->

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 ).