Qu'est qu'un token XTEND

Un token XTEND est un élément de texte qu'on ajoute dans une page HTML pour rendre le contenu dynamique.

Le token peut être inséré dans la page de deux manières différentes:

  • soit comme un attribut d'un tag HTML
      <td adx="monChamp"></td>
  • soit comme délimiteur d'une partie du HTML
      <!adx="monBlocConditionné">...Html...<!adx="monBlocConditionné">

A chaque token est associé une fiche de paramétrage dans le dictionnaire XTEND qui permet de contrôler son comportement.

Par exemple:

  • un token de type champ inséré dans un tag <td> va remplacer le contenu de la cellule par la valeur du champs dont le format est donnée par la fiche de paramétrage
  • un token de type 'bloc conditionné' va masquer ou cacher la partie de HTML qu'il délimite en fonction d'une règle définie dans la fiche de paramétrage

Exemple:

<!adx="ADISPUSERLOGGEDIN">
<!--Ce bloc est affiché si l'utilisateur est connecté'-->
 <!--AUSERCODE est un token de type 'champ'-->
 Vous êtes connecté avec le code utilisateur <b adx="AUSERCODE"></b><br>
 <!--ADLKLOGOUT est un token de type 'lien dynamique'-->
 Pour vous déconnecter cliquer <a adx="ADLKLOGOUT">ici</a>              
<!adx="ADISPUSERLOGGEDIN">        

Syntaxe des tokens

Syntaxe de base

adx="myElement"

Vous pouvez utiliser indifféremment les minuscules et les majuscules :

ADX="myelement", Adx="MYELEMENT", aDx="MyElEmEnT",…

Vous ne devez pas insérer d'espaces:

adx ="aaa", adx= "aaa", adx=" aaa " sont interdits

Expression d’une provenance

adx="B1.MyField"

B1 appelé bloc de référence

Cette syntaxe permet d’exprimer la provenance d’une information.

Pour cela, elle utilise le point comme séparateur.

Dans l’exemple, MyField est une donnée qui provient du Bloc B1.

Cette syntaxe est décrite plus précisément dans la documentation des Tokens champs.

adx="B1(i).MyField"

Cette expression permet d'adresser le champ MyField de la ieme ligne du bloc (i commence à 1)

adx="B1.MyTokenLink"

Cette expression permet de déclencher le token MyTokenLink en passant comme paramètre de l'action les données du bloc de référence B1. MyTokenLink peut désigner par exemple une action de pagination.

Ajout de paramètres HTML

adx="myElement:param1=val1&param2=val2&param3"

Les paramètres HTML sont ajoutés dans la page HTML et viennent modifier le comportement standard du token.

Vous pouvez ajouter des paramètres:

  • en les séparant du code de l’élément par le caractère deux-points
  • en les séparant entre-eux par le caractère &
  • en saisissant Nom du paramètre = valeur du paramètre

Cette syntaxe est décrite plus précisément dans la documentation des Tokens champs.

Exemples:

Modification du format d'une date:

<span adx="ATODAY:xformat=Dz:DD[ ]MMMMMMMMMM[ ]YYYY"></span>

Affichage de libellés:

 Si nous définissons le champ LIBMENULOCAL de type 'menu local' avec l'option 'libellé le code ci-desous permet d'afficher le au texte N°1 du menu local.

<span adx="LIBMENULOCAL:xcaption=1"></span>

Utilisation dans un tag <select>:

Le code ci-dessous montre comment:

  • appeler le lien dynamique MyLink sur l'événement onChange
  • remplir les options avec le contenu du champ MyMenuLocal
  • sélectionner automatiquement l'option qui correspond à la valeur de MyField

<select name="MYNAME" adx="MyField:xonchange=MyLink&xfill=MyMenuLocal">...</select>

Tokens champ menu local ou avec liste de valeur

L'ajout de _DESCR au code du token permet de sélectionner la description (libellé) associé à la valeur du token.

<!-- Affiche le libellé-->
<b adx="MyMenuLocal_descr"></b>
<!-- Affiche la valeur (index)-->
<b adx="MyMenuLocal"></b>

Les types de token

Voici la liste des différents types de tokens qui sont proposés par XTEND:

Token champ
Représentent les valeurs de vos champs de données

Token lien
Déclenche une action utilisateur comme un débranchement et/ou une action web et/ou une sélection

Token bloc
Effectue un 'accès aux données' (requête) avec itération sur les entités (enregistrements) lues '

Token bloc conditionnné
Gère l'affichage de blocs de code HTML en fonction de règles prédéfinies

Token spécial
Tokens particuliers dont le comportement n'est pas paramétrable

Token page
Un code page peut être inséré dans un tag <a adx="MyPage"></a> pour effectuer un débranchement vers la page sans avoir à créer un token lien dynamique.