Version : 21

Balises de transformation

4D fournit un ensemble de balises de transformation qui vous permettent d'insérer des références à des variables ou des expressions 4D, ou d'effectuer différents types de traitement dans un texte source, appelé "template". Ces balises sont interprétées lors de l'exécution du texte source et génèrent un texte de sortie.

Ce principe est notamment utilisé par le serveur Web 4D pour construire des pages web templates.

Ces balises sont généralement insérées comme des commentaires de type HTML () mais une syntaxe alternative compatible xml est disponible pour certaines d'entre elles.

Il est possible de combiner plusieurs types de balises. Par exemple, la structure HTML suivante est tout à fait envisageable :

<HTML>
<BODY>
<!--#4DSCRIPT/PRE_PROCESS-->   (Method call)
<!--#4DIF (myvar=1)-->   (If condition)
   <!--#4DINCLUDE banner1.html-->   (Subpage insertion)
<!--#4DENDIF-->   (End if)
<!--#4DIF (mtvar=2)-->
   <!--#4DINCLUDE banner2.html-->
<!--#4DENDIF-->

<!--#4DLOOP [TABLE]-->   (Loop on the current selection)
<!--#4DIF ([TABLE]ValNum>10)-->   (If [TABLE]ValNum>10)
   <!--#4DINCLUDE subpage.html-->   (Subpage insertion)
<!--#4DELSE-->   (Else)
   <B>Value: <!--#4DTEXT [TABLE]ValNum--></B><br/>   (Field display)
<!--#4DENDIF-->
<!--#4DENDLOOP-->   ](End for)
</BODY>
</HTML>

Principes d'utilisation des balises

Parsing

L'analyse ou le parsing du contenu d'une source de template se fait dans deux contextes :

En utilisant la commande PROCESS 4D TAGS; cette commande accepte un template en entrée, ainsi que des paramètres optionnels et retourne un texte résultant du traitement.
En utilisant le serveur HTTP intégré de 4D : pages de templates envoyées au moyen des commandes WEB SEND FILE (.htm, .html, .shtm, .shtml), WEB SEND BLOB (text/html type BLOB), WEB SEND TEXT , ou appelées en utilisant des URL. Dans ce dernier cas, à des fins d'optimisation, les pages suffixées par ".htm" et ".html" ne sont PAS parsées. Dans ce dernier cas, à des fins d'optimisation, les pages suffixées par ".htm" et ".html" ne sont PAS parsées.

Traitement récursif

Les balises 4D sont interprétées de manière récursive : 4D tente toujours de réinterpréter le résultat d'une transformation et, si une nouvelle transformation a eu lieu, une interprétation supplémentaire est effectuée, et ainsi de suite jusqu'à ce que le produit obtenu ne nécessite plus aucune transformation. Par exemple, étant donné l'énoncé suivant :

<!--#4DHTML [Mail]Letter_type-->

Si le champ texte [Mail]Letter_type contient lui-même une balise, par exemple <! -#4DSCRIPT/m_Gender-->, cette balise sera évaluée récursivement après l'interprétation de la balise 4DHTML.

Ce principe puissant répond à la plupart des besoins liés à la transformation des textes. Notez, cependant, que dans certains cas, cela peut également permettre l'insertion de code malveillant dans le contexte web, ce qui peut être évité.

Identifiants avec tokens

Pour garantir l'évaluation correcte des expressions traitées via les balises, quel que soit le langage ou la version de 4D, il est recommandé d'utiliser la syntaxe tokenisée pour les éléments dont le nom peut varier selon les versions (commandes, tables, champs, constantes). Par exemple, pour insérer la commande Current time, entrez Current time:C178.

Utilisation du "." comme séparateur décimal

4D utilise toujours le caractère point (.) comme séparateur décimal lors de l'évaluation d'une expression numérique utilisant une balise 4D 4DTEXT, 4DHTML, et 4DEVAL. Les paramètres régionaux sont ignorés. Cette fonctionnalité facilite la maintenance du code et la compatibilité entre les langues et les versions de 4D.

4DBASE

Syntaxe : ``

La balise  désigne le répertoire de travail à utiliser par la balise .

Lorsqu'elle est appelée dans une page Web, la balise  modifie tous les appels  ultérieurs sur cette page, jusqu'au prochain , s'il y en a un. Si le dossier  est modifié à partir d'un fichier inclus, il récupère sa valeur originale dans le fichier parent.

Le paramètre folderPath doit contenir un nom de chemin relatif à la page courante et doit se terminer par une barre oblique (/). Le dossier désigné doit être situé à l'intérieur du dossier Web.

Passez le mot-clé "WEBFOLDER" pour rétablir le chemin par défaut (relatif à la page).

Le code suivant, qui doit spécifier un chemin relatif pour chaque appel :

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

... est équivalent à :

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

Par exemple, pour définir un répertoire pour la page d'accueil :

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

Dans le fichier "head.html", le dossier courant est modifié via , sans que cela ne modifie sa valeur dans "Index.html":

/* Head.htm */
/* le répertoire de travail ici est relatif au fichier inclus (FR/ ou US/) */
<!--#4DBASE Styles/-->
<!--#4DINCLUDE main.css-->
<!--#4DINCLUDE product.css-->
<!--#4DBASE Scripts/-->
<!--#4DINCLUDE main.js-->
<!--#4DINCLUDE product.js-->

4DCODE

Syntaxe : ``

La balise 4DCODE permet d'insérer un bloc de code 4D de plusieurs lignes dans un template.

Lorsqu'une séquence  suivante. Le bloc de code lui-même peut contenir des retours chariot, des sauts de ligne ou les deux ; il sera interprété séquentiellement par 4D.

Par exemple, vous pouvez écrire dans un template :

<!--#4DCODE
//Initialisation des paramètres
C_OBJECT:C1216($graphParameters)
OB SET:C1220($graphParameters;"graphType";1)
$graphType:=1
//...votre code ici
If(OB Is defined:C1231($graphParameters;"graphType"))
    $graphType:=OB GET:C1224($graphParameters;"graphType")
    If($graphType=7)
        $nbSeries:=1
        If($nbValues>8)
            DELETE FROM ARRAY:C228 ($yValuesArrPtr{1}->;9;100000)
            $nbValues:=8
        End if
    End if
End if
-->

Voici les caractéristiques de la balise 4DCODE :

La commande TRACE est prise en charge et active le débogueur 4D, vous permettant ainsi de déboguer votre code de template.
Toute erreur affichera le dialogue d'erreur standard qui permet à l'utilisateur d'arrêter l'exécution du code ou d'entrer en mode débogage.
Le texte compris entre  est divisé en lignes acceptant n'importe quelle convention de fin de ligne (cr, lf, ou crlf).
Le texte est tokenisé dans le contexte de la base de données qui a appelé PROCESS 4D TAGS. Ceci est important pour la reconnaissance des méthodes de projet par exemple. La propriété de méthode Disponible via les balises et les URL 4D (4DACTION...) n'est pas prise en compte.
Même si le texte utilise toujours l'anglais-US, il est recommandé d'utiliser la syntaxe token (:Cxxx) pour les noms de commandes et de constantes afin de se prémunir contre d'éventuels problèmes dus à des commandes ou des constantes renommées d'une version de 4D à une autre.

Le fait que les balises 4DCODE puissent appeler n'importe quelle commande du langage 4D ou méthode du projet pourrait être considéré comme un problème de sécurité, en particulier lorsque la base de données est disponible via HTTP. Toutefois, étant donné qu'elle exécute du code côté serveur appelé à partir de vos propres fichiers de modèle, la balise elle-même ne représente pas un problème de sécurité. Dans ce contexte, comme pour tout serveur Web, la sécurité est principalement gérée au niveau des accès distants aux fichiers du serveur.

4DEACH et 4DENDEACH

Syntaxe : `` ``

Le commentaire  permet d'itérer un élément spécifié sur toutes les valeurs de l'expression. L'élément est défini comme une variable dont le type dépend du type de l'expression.

Le commentaire  peut itérer sur trois types d'expression :

les collections : boucle sur chaque élément de la collection,
les entity selections : boucle sur chaque entité,
les objets : boucle sur chaque propriété de l'objet.

Le nombre d'itérations est évalué au démarrage et ne changera pas pendant le traitement. L'ajout ou la suppression d'éléments pendant la boucle est donc déconseillé car il pourra en résulter une redondance ou un manque d'itérations.

``

Cette syntaxe permet d'effectuer une itération sur chaque item de la collection. La partie du code située entre  et  est répétée pour chaque élément de collection.

Le paramètre item est une variable du même type que les éléments de la collection.

La collection ne doit contenir que des éléments de même type, sinon une erreur est renvoyée dès que la variable item se voit attribuer le premier type de valeur non concordant.

Le nombre de boucles est basé sur le nombre d'éléments de la collection. À chaque itération, la variable item est automatiquement remplie avec l'élément correspondant de la collection. Vous devez tenir compte des points suivants :

Si la variable item est de type objet ou collection (c'est-à-dire si expression est une collection d'objets ou de collections), la modification de cette variable modifiera automatiquement l'élément correspondant de la collection (car les objets et les collections partagent les mêmes références). Si la variable est de type scalaire, seule la variable sera modifiée.
La variable item a le même type que le premier élément de la collection. Si un seul élément de la collection n'est pas du même type que la variable, une erreur est générée et la boucle s'arrête.
Si la collection contient des éléments avec une valeur nulle, une erreur est générée si le type de variable élément ne prend pas en charge les valeurs nulles (comme les variables integer).

Exemple avec une collection de valeurs scalaires

getNames renvoie une collection de chaînes de caractères. La méthode a été déclarée comme "disponible via les balises et les URL 4D".

 <table class="table">    

        <tr><th>Name</th></tr>

          <!--#4DEACH $name in getNames-->
        <tr>
            <td><!--#4DTEXT $name--></td>
        </tr>
          <!--#4DENDEACH-->
    </table>

Exemple avec une collection d'objets

getSalesPersons renvoie une collection d'objets.

    <table class="table">    
         <!--#4DCODE
            $salePersons:=getSalesPersons
          -->          
       <tr><th>ID</th><th>Firstname</th><th>Lastname</th></tr>

          <!--#4DEACH $salesPerson in $salePersons-->
        <tr>
            <td><!--#4DTEXT $salesPerson.ID--></td>
            <td><!--#4DTEXT $salesPerson.firstname--></td>
            <td><!--#4DTEXT $salesPerson.lastname--></td>
        </tr>
          <!--#4DENDEACH-->
    </table>

``

Cette syntaxe itère sur chaque entité de l'entitySelection. La partie du code située entre  et  est répétée pour chaque entité de l'entity selection.

Le paramètre entity est une variable objet de la classe entity selection.

Le nombre de boucles est basé sur le nombre d'entities présentes dans l'entity selection. À chaque itération, la variable objet entity est automatiquement remplie avec l'entité correspondante de l'entity selection.

Exemple avec un tableau html

    <table class="table">     

        <tr><th>ID</th><th>Name</th><th>Total purchase</th></tr>

          <!--#4DEACH $customer in ds.Customers.all()-->
        <tr>
            <td><!--#4DTEXT $customer.ID--></td>
            <td><!--#4DTEXT $customer.name--></td>
            <td><center><!--#4DTEXT String($customer.totalPurchase;"$###,##0")--></center></td>
        </tr>
          <!--#4DENDEACH-->
    </table>

Exemple avec `PROCESS 4D TAGS`

var customers : cs.CustomersSelection
var $input; $output : Text

customers:=ds.Customers.all()
$input:="<!--#4DEACH $cust in customers-->"
$input:=$input+"<!--#4DTEXT $cust.name -->"+Char(Carriage return)
$input:=$input+"<!--#4DENDEACH-->"
PROCESS 4D TAGS($input; $output)
TEXT TO DOCUMENT("customers.txt"; $output)

``

Cette syntaxe itère sur chaque property de object. La partie du code située entre  et  est répétée pour chaque propriété de l'objet.

Le paramètre property est une variable texte automatiquement remplie avec le nom de la propriété en cours de traitement.

Les propriétés de l'objet sont itérées en fonction de leur ordre de création. Pendant la boucle, il est possible d'ajouter ou de supprimer des propriétés dans l'objet, sans pour autant modifier le nombre de boucles qui reste basé sur le nombre de propriétés initial de l'objet.

Exemple avec les propriétés d'un objet

getGamers est une méthode projet qui renvoie un objet tel que ("Mary" ; 10 ; "Ann" ; 20 ; "John" ; 40) pour calculer les scores des joueurs.

    <table class="table">    
          <!--#4DCODE
           $gamers:=getGamers
          -->          

        <tr><th>Gamers</th><th>Scores</th></tr>

          <!--#4DEACH $key in $gamers-->
        <tr>
            <td ><!--#4DTEXT $key--></td>
            <td ><!--#4DTEXT $gamers[$key]--></td>
        </tr>
          <!--#4DENDEACH-->
    </table>

4DEVAL

Syntaxe : ``

Syntaxe alternative : `$4DEVAL(expression)`

La balise 4DEVAL vous permet d'évaluer une variable ou une expression 4D. Comme la balise 4DHTML, 4DEVAL n'échappe pas les caractères HTML lorsqu'elle retourne du texte. Cependant, contrairement à 4DHTML ou 4DTEXT, 4DEVAL vous permet d'exécuter n'importe quelle instruction 4D valide, y compris les assignations et les expressions qui ne renvoient aucune valeur.

Par exemple, vous pouvez exécuter :

 $input:="<!--#4DEVAL a:=42-->" //assignation
 $input:=$input+"<!--#4DEVAL a+1-->" //calcul
 PROCESS 4D TAGS($input;$output)
  //$output = "43"

En cas d'erreur d'interprétation, le texte inséré se présentera sous la forme suivante : : ## error # error code.

Pour des raisons de sécurité, il est recommandé d'utiliser la balise 4DTEXT lors du traitement de données introduites depuis l'extérieur de l'application, afin d'éviter l'injection de code malveillant.

4DHTML

Syntaxe : ``

Syntaxe alternative : `$4DHTML(expression)`

Tout comme la balise 4DTEXT, cette balise vous permet d'évaluer une variable 4D ou une expression qui renvoie une valeur, et de l'insérer en tant qu'expression HTML. Contrairement à la balise 4DTEXT, cette balise n'échappe pas les caractères spéciaux HTML (tels que ">").

Par exemple, voici les résultats du traitement de la variable texte 4D myvar avec les balises disponibles :

valeur de myvar	Balises	Résultat
`myvar:="<B>"`	`<!--#4DTEXT myvar-->`	`<B>`
`myvar:="<B>"`	`<!--#4DHTML myvar-->`	`<B>`

En cas d'erreur d'interprétation, le texte inséré sera : ## error # error code.

Pour des raisons de sécurité, il est recommandé d'utiliser la balise 4DTEXT lors du traitement de données introduites depuis l'extérieur de l'application, afin d'éviter l'injection de code malveillant.

4DIF, 4DELSE, 4DELSEIF et 4DENDIF

Syntaxe : `` {`...`} {``} ``

Utilisé avec les commentaires  (optionnel),  (optionnel) et , le commentaire  offre la possibilité d'exécuter des portions de code de manière conditionnelle.

Le paramètre expression peut contenir toute expression 4D valide renvoyant une valeur booléenne. Il doit être indiqué entre parenthèses et respecter les règles syntaxiques de 4D.

Les blocs  ...  peuvent être imbriqués à plusieurs niveaux. Comme dans 4D, chaque  doit correspondre à un .

En cas d'erreur d'interprétation, le texte " : A Boolean expression was expected" est inséré à la place du contenu situé entre  et . De même, s'il n'y a pas autant de  que de , le texte " : 4DENDIF expected" est inséré à la place du contenu situé entre  et .

En utilisant la balise , vous pouvez tester un nombre illimité de conditions. Seul le code qui suit la première condition évaluée à "vrai" est exécuté. Si aucune condition n'est vraie, aucune instruction n'est exécutée (s'il n'y a pas de  final). Vous pouvez utiliser une balise  après le dernier . Si toutes les conditions sont fausses, les instructions qui suivent le  sont exécutées.

Les deux codes suivants sont équivalents.

Code utilisant uniquement 4DELSE :

<!--#4DIF Condition1-->
  /* La condition 1 est vraie*/
<!--#4DELSE-->
    <!--#4DIF Condition2-->
        /* La condition 2 est vraie*/
    <!--#4DELSE-->
        <!--#4DIF Condition3-->
            /* La condition 3 est vraie */
        <!--#4DELSE-->
            /*Aucune des conditions n'est vraie*/
        <!--#4DENDIF-->
    <!--#4DENDIF-->
<!--#4DENDIF-->

Code similaire utilisant la balise 4DELSEIF :

<!--#4DIF Condition1-->
     /* La condition 1 est vraie*/
<!--#4DELSEIF Condition2-->
     /* La condition 2 est vraie*/
<!--#4DELSEIF Condition3-->
    /* La condition 3 est vraie */
<!--#4DELSE-->
    /* Aucune des conditions n'est vraie*/
<!--#4DENDIF-->

Cet exemple de code inséré dans une page HTML statique affiche un libellé différent en fonction du résultat de l'expression vname#"" :

<BODY>
...
<!--#4DIF (vname#"")-->
Noms commençant par <!--#4DTEXT vname-->.
<!--#4DELSE-->
Aucun nom n'a été trouvé.
<!--#4DENDIF-->
...
</BODY>

Cet exemple insère des pages différentes en fonction de l'utilisateur connecté :

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

4DINCLUDE

Syntax: ``

Cette balise est principalement conçue pour inclure une page HTML (désignée par le paramètre path) dans une autre page HTML. Par défaut, seul le corps de la page HTML spécifiée, i.e. le contenu trouvé dans les balises <body> et </body>, est inclus (les balises elles-mêmes ne sont pas incluses). Cela permet d'éviter les conflits liés aux métabalises présentes dans les en-têtes.

Toutefois, si la page HTML spécifiée ne contient pas de balises <body> et </body>, la page entière est incluse. Il vous appartient de vérifier la cohérence des métabalises.

Le commentaire  est très utile pour les tests () ou les boucles (). Il est très pratique d'inclure des bannières en fonction d'un critère ou de manière aléatoire. Lors de l'inclusion, quelle que soit l'extension du nom de fichier, 4D analyse la page appelée et insère le contenu (modifié ou non) dans la page à l'origine de l'appel 4DINCLUDE.

Une page incluse avec le commentaire  est chargée dans le cache du serveur Web de la même manière que les pages appelées via un URL ou envoyées avec la commande WEB SEND FILE.

Dans path, passez le chemin du document à inclure. Attention : Dans le cas d'un appel 4DINCLUDE, le chemin est relatif au document analysé, c'est-à-dire le document "parent". Utilisez la barre oblique (/) comme séparateur de dossier et les deux points (..) pour remonter d'un niveau (syntaxe HTML). Lorsque vous utilisez la balise 4DINCLUDE avec la commande PROCESS 4D TAGS, le dossier par défaut est le dossier du projet.

Vous pouvez modifier le dossier par défaut utilisé par la balise 4DINCLUDE dans la page courante, en utilisant la balise  (voir ci-dessous).

Le nombre de "" dans une page est illimité. Cependant, les appels "" ne peuvent être effectués qu'à un seul niveau. Cela signifie que, par exemple, vous ne pouvez pas insérer  dans le corps de la page mydoc2.html, qui est appelé par  inséré dans mydoc1.html. En outre, 4D vérifie que les inclusions ne sont pas récursives.

En cas d'erreur, le texte inséré est " :The document cannot be opened".

Exemples :

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

4DLOOP et 4DENDLOOP

Syntaxe : `` ``

Ce commentaire permet de répéter une partie du code tant que la condition est remplie. La partie est délimitée par  et .

Les blocs  ...  peuvent être imbriqués. Comme dans 4D, chaque  doit correspondre à un .

Il existe cinq types de conditions :

``

Cette syntaxe crée une boucle pour chaque enregistrement de la sélection courante de la table dans le process courant. La partie du code située entre les deux commentaires est répétée pour chaque enregistrement de la sélection courante.

Lorsque la balise 4DLOOP est utilisée avec une table, les enregistrements sont chargés en mode "Lecture seule".

Le code suivant :

<!--#4DLOOP [People]-->
<!--#4DTEXT [People]Name--> <!--#4DTEXT [People]Surname--><br/>
<!--#4DENDLOOP-->

... pourrait être exprimé en langage 4D de la manière suivante :

 FIRST RECORD([People])
 While(Not(End selection([People])))
    ...
    NEXT RECORD([People])
 End while

``

Cette syntaxe crée une boucle pour chaque élément du tableau. L'indice d'élément courant du tableau est augmenté lorsque chaque portion de code est répétée.

Cette syntaxe ne peut pas être utilisée avec des tableaux à deux dimensions. Dans ce cas, il est préférable de combiner une méthode avec des boucles imbriquées.

L'exemple de code suivant :

<!--#4DLOOP arr_names-->
<!--#4DTEXT arr_names{arr_names}--><br/>
<!--#4DENDLOOP-->

... pourrait être exprimé en langage 4D de la manière suivante :

 For($Elem;1;Size of array(arr_names))
    arr_names:=$Elem
    ...
 End for

``

Cette syntaxe crée une boucle tant que la méthode renvoie True. La méthode prend un paramètre de type entier long. Elle est d'abord appelée avec la valeur 0 pour permettre une étape d'initialisation (si nécessaire) ; elle est ensuite appelée avec les valeurs 1, puis 2, puis 3 et ainsi de suite, tant qu'elle renvoie True.

Pour des raisons de sécurité, dans un process Web, la méthode base On Web Authentication peut être appelée une fois juste avant l'étape d'initialisation (exécution de la méthode avec 0 comme paramètre). Si l'authentification est correcte, l'étape d'initialisation se poursuit.

C_BOOLEAN($0) et C_LONGINT($1) DOIVENT être déclarés dans la méthode à des fins de compilation.

L'exemple de code suivant :

<!--#4DLOOP my_method-->
<!--#4DTEXT var--> <br/>
<!--#4DENDLOOP-->

... pourrait être exprimé en langage 4D de la manière suivante :

 If(AuthenticationWebOK)
    If(my_method(0))
       $counter:=1
       While(my_method($counter))
          ...
          $counter:=$counter+1
       End while
    End if
 End if

La méthode my_method peut être la suivante :

 C_LONGINT($1)
 C_BOOLEAN($0)
 If($1=0) `Initialisation
    $0:=True
 Else
    If($1<50)
       ...
       var:=...
       $0:=True
    Else
       $0:=False `Stops the loop
    End if
 End if

``

Avec cette syntaxe, la balise 4DLOOP crée une boucle tant que l'expression renvoie True. L'expression peut être n'importe quelle expression booléenne valide et doit contenir une partie variable à évaluer dans chaque boucle afin d'éviter les boucles infinies.

Par exemple, le code suivant :

<!--#4DEVAL $i:=0-->
<!--#4DLOOP ($i<4)-->
<!--#4DEVAL $i-->
<!--#4DEVAL $i:=$i+1-->
<!--#4DENDLOOP-->

...donne le résultat suivant :

``

Dans ce cas, la balise 4DLOOP fonctionne comme avec un tableau : elle fait une boucle pour chaque élément du tableau référencé par le pointeur. L'indice de l'élément courant du tableau est augmenté à chaque fois que la portion de code est répétée.

Cette syntaxe est utile lorsque vous passez un pointeur de tableau comme paramètre à la commande PROCESS 4D TAGS.

Voici un exemple :

 ARRAY TEXT($array;2)
 $array{1}:="hello"
 $array{2}:="world"
 $input:="<!--#4DEVAL $1-->"
 $input:=$input+"<!--#4DLOOP $2-->"
 $input:=$input+"<!--#4DEVAL $2->{$2->}--> "
 $input:=$input+"<!--#4DENDLOOP-->"
 PROCESS 4D TAGS($input;$output;"elements = ";->$array)
  // $output = "elements = hello world "

En cas d'erreur d'interprétation, le texte " : description" est inséré à la place du contenu situé entre  et .

Les messages suivants peuvent être affichés :

Type d'expression inattendu (erreur standard) ;
Nom de table incorrect (erreur sur le nom de la table) ;
Un tableau était attendu (la variable n'est pas un tableau ou est un tableau à deux dimensions) ;
La méthode n'existe pas ;
Erreur de syntaxe (lors de l'exécution de la méthode) ;
Erreur d'accès (vous ne disposez pas des privilèges d'accès appropriés pour accéder à la table ou à la méthode).
4DENDLOOP attendu (the  number does not match the ).

4DSCRIPT/

Syntaxe : ``

La balise 4DSCRIPT vous permet d'exécuter des méthodes 4D lors du traitement du template. La présence de la balise  en tant que commentaire HTML lance l'exécution de la méthode MyMethod avec le paramètre Param en tant que chaîne de caractères dans $1.

Si la balise est appelée dans le contexte d'un process Web, lorsque la page est chargée, 4D appelle la méthode base On Web Authentication (si elle existe). Si elle retourne True, 4D exécute la méthode.

La méthode doit retourner du texte dans $0. Si la chaîne commence par le caractère de code 1, elle est considérée comme du HTML (le même principe s'applique à la balise 4DHTML).

Par exemple, supposons que vous insériez le commentaire suivant "Today is " dans un template de page Web. Lors du chargement de la page, 4D appelle la méthode base de données On Web Authentication, puis appelle la méthode MYMETH et transmet la chaîne "/MYPARAM" en tant que paramètre $1. La méthode renvoie le texte en $0 (par exemple "12/31/21") ; l'expression "Today is " devient donc "Today is 12/31/21".

La méthode MYMETH est la suivante :

  //MYMETH
 C_TEXT($0;$1) //Ces paramètres doivent toujours être déclarés
 $0:=String(Current date)

Une méthode appelée par 4DSCRIPT ne doit pas appeler des éléments d'interface (DIALOG, ALERT, etc.).

Comme 4D exécute les méthodes dans leur ordre d'apparition, il est tout à fait possible d'appeler une méthode qui fixe la valeur de plusieurs variables référencées plus loin dans le document, quel que soit le mode utilisé. Vous pouvez insérer autant de commentaires  que vous le souhaitez dans un template.

4DTEXT

Syntaxe : ``

Syntaxe alternative : `$4DTEXT(expression)`

La balise  permet d'insérer une référence à une variable ou à une expression 4D renvoyant une valeur. Par exemple, si vous écrivez (dans une page HTML) :

<P>Welcome to <!--#4DTEXT vtSiteName-->!</P>

La valeur de la variable 4D vtSiteName sera insérée dans la page HTML lorsqu'elle sera envoyée. Cette valeur est insérée sous forme de texte simple, les caractères HTML spéciaux tels que ">" sont automatiquement échappés.

Vous pouvez également insérer des expressions 4D. Vous pouvez par exemple insérer directement le contenu d'un champ (), un élément de tableau () ou une méthode renvoyant une valeur (). La conversion des expressions suit les mêmes règles que celles des variables. De plus, l'expression doit respecter les règles de syntaxe 4D.

Pour des raisons de sécurité, il est recommandé d'utiliser cette balise lors du traitement de données introduites depuis l'extérieur de l'application, afin d'éviter l'insertion de code malveillant.

En cas d'erreur d'évaluation, le texte inséré apparaîtra sous la forme : ## error # error code.

Vous devez utiliser des variables process.
Vous pouvez afficher le contenu d'un champ image. Cependant, il n'est pas possible d'afficher le contenu d'un élément de tableau d'images.
Il est possible d'afficher le contenu d'un champ objet à l'aide d'une formule 4D. Par exemple, vous pouvez écrire .
Vous travaillerez généralement avec des variables de type Texte. Cependant, vous pouvez également utiliser des variables BLOB. Il suffit de générer des BLOB en mode Text without length.

Syntaxe alternative pour 4DTEXT, 4DHTML, 4DEVAL

Plusieurs balises de transformation 4D existantes peuvent être exprimées à l'aide d'une syntaxe fondée sur le symbole $ :

4dtag (expression)

peut être utilisé à la place de

``

Cette syntaxe alternative n'est disponible que pour les balises utilisées pour retourner des valeurs traitées :

4DTEXT
4DHTML
4DEVAL

(Les autres balises, telles que 4DIF ou 4DSCRIPT, doivent être écrites avec la syntaxe régulière).

Par exemple, vous pouvez écrire :

$4DEVAL(UserName)

au lieu de :

<!--#4DEVAL(UserName)-->

Le principal avantage de cette syntaxe est qu'elle vous permet d'écrire des modèles conformes à XML. Certains développeurs 4D ont besoin de créer et de valider des modèles basés sur XML à l'aide d'outils d'analyse syntaxique XML standard. Le caractère "<" n'étant pas valide dans une valeur d'attribut XML, il n'était pas possible d'utiliser la syntaxe "" des balises 4D sans rompre la syntaxe du document. En revanche, le fait d'échapper le caractère "<" empêchera 4D d'interpréter correctement les balises.

Par exemple, le code suivant provoquerait une erreur d'analyse XML en raison du premier caractère "<" dans la valeur de l'attribut :

<line x1="<!--#4DEVAL $x-->" y1="<!--#4DEVAL $graphY1-->"/>

En utilisant la syntaxe $, le code suivant est validé par le parseur :

<line x1="$4DEVAL($x)" y1="$4DEVAL($graphY1)"/>

Notez que $4dtag et <--#4dtag --> ne sont pas strictement équivalents : contrairement à <--#4dtag -->, le traitement de $4dtag n'interprète pas les balises 4D récursivement. Les balises $ sont toujours évaluées une fois et le résultat est considéré comme du texte brut.

Cette différence consiste à empêcher l'injection de code malveillant. Comme expliqué ici, il est fortement recommandé d'utiliser les balises 4DTEXT au lieu des balises 4DHTML lors de la manipulation de texte utilisateur afin de se protéger contre une réinterprétation indésirable des balises : avec 4DTEXT, les caractères spéciaux tels que "<" sont échappés, de sorte que toutes les balises 4D utilisant la syntaxe  perdront leur signification particulière. Cependant, comme 4DTEXT n'échappe pas le symbole $, nous avons décidé de rompre le support de la récursion afin d'empêcher les injections malveillantes utilisant la syntaxe $4dtag (expression).

Les exemples suivants illustrent le résultat du traitement en fonction de la syntaxe et de la balise utilisées :

  // exemple 1
 myName:="<!--#4DHTML QUIT 4D-->" //injection malveillante
 input:="Mon nom est : <!--#4DHTML myName-->"
 PROCESS 4D TAGS(input;output)
  //4D va quitter !

  // exemple 2
 myName:="<!--#4DHTML QUIT 4D-->" //injection malveillante
 input:="Mon nom est : <!--#4DTEXT myName-->"
 PROCESS 4D TAGS(input;output)
  //l'output est "Mon nom est : <!--#4DHTML QUIT 4D-->"

  // exemple 3
 myName:="$4DEVAL(QUIT 4D)" //injection malveillante
 input:="Mon nom est : <!--#4DTEXT myName-->"
 PROCESS 4D TAGS(input;output)
  //output is "My name is : $4DEVAL(QUIT 4D)"

Notez que la syntaxe $4dtag permet de faire correspondre des paires de guillemets ou de parenthèses. Par exemple, supposons que vous ayez besoin d'évaluer la chaîne complexe (fictive) suivante :

String(1) + "\"(hello)\""

Vous pouvez écrire :

 input:="$4DEVAL( String(1)+\"\\\"(hello)\\\"\")"
 PROCESSUS 4D TAGS(input;output)
 -->output est 1"(hello)"

Principes d'utilisation des balises​

Parsing​

Traitement récursif​

Identifiants avec tokens​

Utilisation du "." comme séparateur décimal​

4DBASE​

Syntaxe : ​

4DCODE​

Syntaxe : ​

4DEACH et 4DENDEACH​

Syntaxe :  ​

​

Exemple avec une collection de valeurs scalaires​

Exemple avec une collection d'objets​

​

Exemple avec un tableau html​

Exemple avec PROCESS 4D TAGS​

​

Exemple avec les propriétés d'un objet​

4DEVAL​

Syntaxe : ​

Syntaxe alternative : $4DEVAL(expression)​

4DHTML​

Syntaxe : ​

Syntaxe alternative : $4DHTML(expression)​

4DIF, 4DELSE, 4DELSEIF et 4DENDIF​

Syntaxe :  {...} {} ​

4DINCLUDE​

Syntax: ​

4DLOOP et 4DENDLOOP​

Syntaxe :  ​

​

​

​

​

​

4DSCRIPT/​

Syntaxe : ​

4DTEXT​

Syntaxe : ​

Syntaxe alternative : $4DTEXT(expression)​

Syntaxe alternative pour 4DTEXT, 4DHTML, 4DEVAL​

4dtag (expression)​

​

Principes d'utilisation des balises

Parsing

Traitement récursif

Identifiants avec tokens

Utilisation du "." comme séparateur décimal

4DBASE

Syntaxe : ``

4DCODE

Syntaxe : ``

4DEACH et 4DENDEACH

Syntaxe : `` ``

``

Exemple avec une collection de valeurs scalaires

Exemple avec une collection d'objets

``

Exemple avec un tableau html

Exemple avec `PROCESS 4D TAGS`

``

Exemple avec les propriétés d'un objet

4DEVAL

Syntaxe : ``

Syntaxe alternative : `$4DEVAL(expression)`

4DHTML

Syntaxe : ``

Syntaxe alternative : `$4DHTML(expression)`

4DIF, 4DELSE, 4DELSEIF et 4DENDIF

Syntaxe : `` {`...`} {``} ``

4DINCLUDE

Syntax: ``

4DLOOP et 4DENDLOOP

Syntaxe : `` ``

``

``

``

``

``

4DSCRIPT/

Syntaxe : ``

4DTEXT

Syntaxe : ``

Syntaxe alternative : `$4DTEXT(expression)`

Syntaxe alternative pour 4DTEXT, 4DHTML, 4DEVAL

4dtag (expression)

``