Développement > Safe X3 WAS > Tokens > Blocs conditionnés 

SEEWARNING Avant de créer votre site , il préférable de lire la documentation :Avant de commencer.


Le token 'Bloc conditionné' permet de gérer un affichage dynamique du contenu des pages HTML en fonction de critères définis par paramétrage.
Par exemple : modifier le contenu d'un menu HTML en fonction du fait que l'utilisateur soit signé ou non.
Pour cela on insère dans la page HTML le token 'Bloc conditionné' comme pour le token Blocs.

Lors de la génération dynamique de la page le moteur XTEND évalue la condition (expression logique) associée au token :

  • Si l'évaluation est vérifiée : les tokens 'fils' du bloc (tokens délimités par le début et la fin du bloc) seront exécutés pour générer le HTML correspondant au bloc.
  • Si la condition n'est pas vérifiée : les tokens 'fils' du bloc seront ignorés et le HTML ne sera pas affiché.

Le principe est le même pour un token qui masque le code HTML au lieu de l'afficher.

Le paramètre HTML 'xnot' indique qu'il faut évaluer l'inverse de la condition : c'est à dire masquer le HTML à la place de l'afficher :

<!--Blocs conditionnés-->
<!adx="ADISPUSERLOGGEDIN">
<!--Code HTML affiché si l'utilisateur est signé'-->
<!adx="ADISPUSERLOGGEDIN">
<!--Blocs conditionnés inverse-->
<!adx="ADISPUSERLOGGEDIN:xnot">
<!--Code HTML affiché si l'utilisateur n'est pas signé'-->
<!adx="ADISPUSERLOGGEDIN">

Pré-requis

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre

Gestion de l'écran

En-tête

Champs

Les champs suivants sont présents dans cet onglet :

Code du bloc conditionné

  • Site (champ FCYLIB)

Site Web courant.

  • Intitulé (champ INTIT)

 

 

Onglet Général

Champs

Les champs suivants sont présents dans cet onglet :

Propriétés

  • champ WA

 

  • Affichage bloc (champ WHNACT)

  • Cochée, cette case permet d'afficher le contenu du token bloc conditionné si la condition est vérifiée.

  • Sinon, le contenu du token bloc conditionné est masqué si la condition est vérifiée.

  • Type de critères (champ WHNTYP)

Type de critère pour la condition d'affichage/masquage.
Les autres paramètres sont en fonction du type de critères choisi :

Formule: la condition est vérifiée si l'évaluation de la formule est vraie.

Bloc vide : la condition est vérifiée si le bloc est vide.

Les tokens standards ci-dessous évaluent le bloc principal (AMAIN) de la page :

  • ADISPMAINEMPTY : Affiche le HTML si le bloc principal AMAIN est vide.
  • AHIDEMAINEMPTY : Masque le HTML si le bloc principal AMAIN est vide.

Le token AHIDEMESSEMPTY masque le code HTML si un message utilisateur a été renvoyé par le web service.

Pagination d'un bloc : la condition est vérifiée si le numéro de la page courante du bloc est égal au paramètre saisi.

Les tokens standards ci-dessous évaluent le bloc principal (AMAIN) de la page.

  • AHIDEMAINFIRSTPAGE : Masque le HTML si le bloc AMAIN est sur la 1ere page.
  • AHIDEMAINLASTPAGE : Masque le HTML si le bloc AMAIN est sur la dernière page.

Lien dynamique utilisé : la condition est vérifiée si le code du token 'lien dynamique' sur lequel l'utilisateur a cliqué pour afficher la page est égal au code saisi.

Page précédente : la condition est vérifiée si le code de la page origine qui précède la page affiché est égal au code de la page web saisi.

Utilisateur signé : la condition est vérifiée si l'utilisateur est signé.

Les tokens ci-dessous sont livrés avec le site ASAMPLE.

  • ADISPUSERLOGGEDIN : Affiche le HTML si l'utilisateur est signé.
  • AHIDEUSERLOGGEDIN : Masque le HTML si l'utilisateur est signé.

Profil : la condition est vérifiée si l'utilisateur est signé et si le profil XTEND de cet utilisateur est égal à l'un des profils de la liste (5 maximum).

Vignette vide : la condition est vérifiée si la vignette courante (Token spécial ASTAMP) est vide.

Les tokens ci-dessous sont livrés avec le site ASAMPLE.

  • ADISPSTAMPEMPTY : Affiche le HTML si l'étiquette est vide.
  • AHIDESTAMPEMPTY : Masque le HTML si l'étiquette est vide.

Ligne sélectionnée : la condition est vérifiée si le bloc a une ligne sélectionnée.

Les tokens standards ci-dessous évaluent le bloc principal (AMAIN) de la page.

  • ADISPMAINSELECT : Affiche le HTML si le bloc principal AMAIN de la page a une ligne sélectionnée.
  • AHIDEMAINSELECT : Masque le HTML si le bloc principal AMAIN de la page a une ligne sélectionnée.

Page courante : la condition est vérifiée si la page affichée est la page courante c'est à dire la même page que celle ou l'utilisateur a cliqué.

Les tokens ci-dessous sont livrés en standard :

  • ADISPSAMEPAGE : Affiche le HTML si c'est la même page qui est affichée.
  • AHIDESAMEPAGE : Masque le HTML si c'est la même page qui est affichée.

Authentification avec ou sans cookies : le token ADISPNOCOOKIES est réservé et affiche le HTML si l'utilisateur a désactivé l'utilisation du cookies JSESSIONID pour l'authentification de la session via le lien dynamique ADLKSWITCHCOOKIES et l'action XTEND ASESSSWITCHCOOKIES.

<!adx="ADISPNOCOOKIES">
<input type="button" value="Authentification avec cookie" adx="ADLKSWITCHCOOKIES">   
<!adx="ADISPNOCOOKIES">
<!adx="ADISPNOCOOKIES:xnot">
<input type="button" value="Authentification sans cookie" adx="ADLKSWITCHCOOKIES">
<!adx="ADISPNOCOOKIES">

Paramètre HTML
Seul le paramètre xnot est accepté pour inverser la condition.
Masquer à la place d'afficher et inversement.

Caractéristiques

Code du bloc si le type de critères est égal à : Bloc vide, pagination d'un bloc, ligne selectionnée.

  • Critère pagination (champ BLCPAG)

Ce champ est saisissable si le type de critères est à "Pagination d'un bloc".

La condition est vérifiée si le numéro de la page courante du bloc est égal au paramètre saisi :

  • Première page : le bloc est positionné sur la première page.

  • Dernière page : le bloc est positionné sur la dernière page.

  • Autre page : le bloc est positionné sur une page autre que la première et dernière page.

Code du lien dynamique si le type de critères est égal à "Dernier lien dynamique utilisé".

Code de la page web si le type de critères est égal à "Page précédente".

Profils site Web

Codes profil XTEND si le type de critères est égal à "profil".

 

Onglet Sélection

Présentation

Formule

La condition est vérifiée si l'évaluation de la formule est vraie.

Le bloc Formule permet de saisir l'expression logique à évaluer.

  • L'opérande N°1 est du type 'MonBloc.MonChamp'.
  • La saisie de la valeur de l'opérande N°2 est identique à celle des critères de sélection ou paramètres des actions.

 

Champs

Les champs suivants sont présents dans cet onglet :

Synthèse formule

  • champ RES50

 

Tableau Formule

  • Et/Ou (champ ANDOR50)

Opérateur logique d'enchainement

  • ( (champ BRKLFTM50)

Parenthèse ouvrante

Code du bloc XTEND pour l'opérande N°1

La valeur de l'opérande N°1 est donnée par le code bloc et le code champ.

 

  • Champ (champ VFIEKEY50)

Code du camp XTEND pour l'opérande N°1.

La valeur de l'opérande N°1 est donnée par le code bloc et le code champ.

  • champ OPE50

Opérateur de comparaison

  • Origine (champ VALTYP50)

  • Constante : valeur fixe saisie dans la colonne suivante.

  • Token champ : valeur d'un champ d'un bloc dont les noms sont saisis dans les colonnes suivantes.

  • Champ web : valeur d'un champ du formulaire HTML dont le nom est saisi dans la colonne suivante.

  • Cste / Attrib. Web (champ VALEUR50)

Valeur de la constante ou nom (attribut 'Name')  du champ web

Code du bloc XTEND pour l'opérande N°2 si type 'champ xtend'.

La valeur de l'opérande N°2 est donnée par le code bloc et le code champ.

 

  • Champ (champ VFIEKEY50A)

Code du token champ pour l'opérande N°2 si type 'champ xtend'.

La valeur de l'opérande N°2 est donnée par le code bloc et le code champ.

  • ) (champ BRKRGTM50)

Parenthèse fermante

 

Etats

Par défaut, les états suivants sont associés à la fonction :

 PRTSCR : Impression écran

Mais ceci peut être modifié par paramétrage.

Boutons spécifiques

Ce bouton permet de mettre à jour le dictionnaire XTEND au format XML.

Le serveur X3WEB prend en compte uniquement le dictionnaire sous ce format.

Il existe un fichier xml par dictionnaire.

Par exemple le fichier ACT.xml correspondant à l'ensemble des actions web pour le site Web courant.

Ce bouton permet de copier un bloc conditionné.

Messages d'erreur

Il n'y a pas de message d'erreur autre que les messages d'erreur génériques.

Tables mises en oeuvre

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre