L'intégration dans les pages HTML est effectuée via les tokens bloc.
Les paragraphes ci-dessous décrivent comment nous avons intégré la gestion dynamique de contenu HTML dans le site ASAMPLE.
Si votre site XTEND a été créé à partir d'une copie du site ASAMPLE les fiches de paramétrages sont déjà créées.
Sinon vous pouvez soit les créer soit les copier une à une à partir du site ASAMPLE avec le bouton d'action X3 'Copie'.
Nous avons créé un document de contenu HTML par page web qui décrit comment la page a été construite.
Dans chaque page nous avons inséré un token bloc ABLKDOCHTML qui sélection le document associé à la page et l'affiche via le token champ TEXTE.
Cette méthode permet de disposer d'une gestion dynamique du contenu des pages HTML en utilisant seulement 1 token bloc et 1 token champ.
Il s'agit de créer une interface de type 'Accès table' qui sera utilisée pour lire les données de la table AYTDOC qui contient les document HTML.
1. Créer la fiche interface
2. Sélectionner la table
3. Enregistrer
4. Générer l'accès après avoir saisi les champs utilisés
5. Enregistrer et valider
6. Générer les champs avec le menu Outils\Création token champs
Type
Accès table
Code table
AYTDOC
Nom de publication
AXTDHTML par défaut mais vous pouvez le modifier
Affichage des messages
Tous
Accès protégé
Non
Générer l'accès
Sélectionner les champs DES, DOCCOD, LAN, TEXTE, CAT.
TEXTE contient le HTML généré par l'éditeur texte riche.
Le bouton 'Générer l'accès' effectue les opérations suivante:
1. Créer l'entité ADOCHTML de type 'Accès données' basée sur l'interface ADOCHTML .
L'entité est utilisée pour stocker les données des requêtes sur la table
2. Associer les champs
S'aider du menu Outils\Aide au remplissage
3. Saisir le champ DOCCOD comme champ clé de l'entité dans le tableau 'Champs (sélection)'.
4. Enregistrer et valider
Type
Accès données
Interface
ADOCHTML code de l'interface
Le token bloc sera inséré dans la page HTML. C'est lui qui déclenchera la requête vers X3 est la lecture des données.
1. Créer un bloc
2. Ajouter les critères de sélections
3. Enregistrer et valider
Pour notre exemple nous avons créer un bloc 'Mono enregistrement' ABLKDOCHTML qui pointe sur l'entité ADOCHTML.
Ce bloc sélectionne un document dont le code DOCCOD est égal au code de la page courante ASESSION.APAGEALIAS et le code langue LAN est égal au code langue courant ASESSION.AUSERLANG (code langue XTEND du projet HTML).
On peut aussi imaginer de créer un bloc 'multi enregistrements' qui sélectionne des documents HTML sur le champ CAT (news, articles...) et affiche le titre. Pour chaque document, on aura créé un lien liste/détail vers le contenu détaillé via un lien dynamique.
L'affichage du document HTML est réalisé en insérant le token bloc dans la page HTML.
L'exemple ci dessous montre les tokens à insérer dans la page HTML pour afficher dynamiquent le document associé à la page HTML pour le site ASAMPLE.
<body>
<form>
<!adx="ABLKDOCHTML">
<div adx="TEXTE">
</div>
<!adx="ABLKDOCHTML">
</form>
</body>
Le bloc ABLKDOCHTML peut être aussi défini comme bloc de fond dans la fiche de paramétrage de la page web ce qui permet de supprimer le token bloc de la page HTML.