Sites Web
Utilisez cette fonction pour paramétrer les sites Web disponibles.
Avant de créer votre site, consultez la documentation Avant de commencer XTEND.
Pré-requis
Reportez-vous à la documentation de Mise en oeuvre
Gestion de l'écran
En-tête
Code site (champ FCYCOD) |
Le code site sert à construire l'URL du site dans le paramétrage : |
Intitulé (champ INTIT) |
champ ICOWRK |
Publier le site (champ FCYPUB) |
Cochez cette case pour publier le site sur tous les serveurs X3WEB sur lesquels est publié le dossier courant. Le site sera accessible via l'URL : |
Onglet Général
Langues
Le tableau 'Informations liées à la langue' permet de définir les langues disponibles pour le site.
A chaque langue du site est associé un ensemble de pages HTML que l'on appelera "projet HTML". Ce tableau permet de saisir les paramètres par défaut qui seront appliqués à chaque langue. Le code langue utilisateur est précisé dans l'URL via le paramètre LANG (&LANG=FRA). Il indique la langue du projet HTML.
Si ce paramètre n'est pas présent, XTEND choisit le paramètre présent dans la console de configurationxtend.server.gensetup.deflang.
L'action ASESSSWITCHLANG permet de changer de langue.
Pools de web services
Liste des pools de web services utilisés par le site. Chaque pool contient :
- l'adresse du serveur de web service,
- et l'alias du 'pool de connexion' à utiliser pour appeler un web service.
Caractéristiques
Code activité (champ CODACT) |
Ce champ permet de protéger le site par un code activité spécifique. Les sites livrés ont un code commençant par la lettre A, et sont mis à jour par patch. |
Timeout session (mn.) (champ USRTIMOUT) |
Ce champ indique la durée d'inactivité maximale en minutes pour un utilisateur signé avant déconnexion automatique de la session par le serveur XTEND. |
Site en maintenance (champ MCEFLG) |
Sélectionnez 'Oui' pour basculer le site en maintenance et afficher la 'Page de maintenance'. |
Dossier HTML par langue (champ DIRLAN) |
Gestion profils (champ PRFENA) |
Sélectionnez 'Oui' pour activer la gestion des profils XTEND. |
Tableau Informations liées à la langue
Langue Web (champ LANCOD) |
Un projet HTML est toujours associé à une langue. Le code langue utilisateur est précisé dans l'URL via le paramètre LANG (&LANG=FRA). Si ce paramètre n'est pas présent, XTEND choisit le paramètre de configurationxtend.server.gensetup.deflang. L'action ASESSSWITCHLANG permet de changer de langue. |
Défaut (champ LANDEF) |
Langue dossier (champ LANADS) |
Code langue du dossier X3. |
Format des devises (champ LANFMTCUR) |
Format des entiers (champ LANFMTINT) |
Format des décimaux (champ LANFMTDEC) |
Format des dates (champ LANFMTDAT) |
Tableau Pools services web (*)
Pool (champ LNKADS) |
Code du pool de Web services. |
Pool par défaut (champ LNKADSDEF) |
Le Pool par défaut permet l'appel des web services du site. Il est obligatoire de saisir un pool par défaut et fortement conseillé de vérifier que :
|
Bus interne (champ LNKBUSINT) |
Ce champ permet d'optimiser la communication entre les serveurs Xtend et le serveur de web services lorsque les deux applications sont hébergées sur le même serveur X3WEB.
|
Email Web master (*)
Email (champ MAICOD) |
Ces e-mails peuvent être utilisés comme paramètres d'action ou pour affichage. |
Onglet Avancé
Page par défaut
Page d'accueil (champ PAGSTR) |
Code de la page d'accueil. Cette page s'affiche automatiquement si aucune page ou lien dynamique n'est précisé dans l'URL. La page AHOME s'affiche par défaut si ce champ n'est pas renseigné. |
Page identification (champ PAGLOG) |
Code de la page de login. Cette page sera affichée automatiquement si un utilisateur non signé essaie d'accéder à une page protégée. La page ALOGIN s'affiche par défaut si ce champ n'est pas renseigné. |
Page d'erreur (champ PAGERR) |
Code de la page d'erreur. Cette page sera affichée automatiquement si une erreur (exception hors erreurs applicatives X3) se produit sur le serveur XTEND. La page AERROR s'affiche par défaut si ce champ n'est pas renseingé. |
Page reconnexion (champ PAGRECNX) |
Code de la page de reconnexion. Cette page s'affiche automatiquement si le serveur retrouve une session utilisateur suite à la fermeture du navigateur pour informer l'utilisateur que sa session a été restaurée. XTEND affichera la dernière page consultée par l'utilisateur si ce champ n'est pas renseigné. |
Page maintenance (champ PAGMCE) |
Code de la page de maintenance. Cette page s'affiche automatiquement lorsque le site est en maintenance. |
Image par défaut (champ IMGDEF) |
Image à afficher lorsqu'un champ de type image image est vide. L'image xtdNoImage.jpg s'affiche par défaut si ce champ n'est pas renseigné, et si celle-ci est présente dans le répertoire des pages HTML. |
Protocole
Protocole (*) (champ PRODEF) |
Le paramètre Protocole permet de définir le protocole par défaut (HTTP ou HTTPS) utilisé pour afficher les pages du site. Les numéros des ports HTTP et HTTPS sont donnés par les paramètres de configuration : xtend.server.gensetup.http.defhttpport et xtend.server.gensetup.http.defhttpsport. |
Outils
Affichage rapport (*) (champ BRWDEG) |
XTEND peut afficher des fonctions utilitaires pour le développeur en bas des pages HTML. |
Suivi de l'activité (*) (champ LOGMOD) |
Ce champ permet d'activer ou de désactiver le suivi de l'activité des utilisateurs pour le site. Le suivi peut être activé sur les éléments suivants :
Les fichiers de log sont stockés dans le répertoire \WebData\SERVERSLOGS\WAXTENDSERVER\ACTIVITY\ |
Affichage outils (*) (champ TOOLMOD) |
XTEND peut afficher des fonctions utilitaires pour le développeur en bas des pages HTML. |
Tableau Paramètres libres (*)
Paramètre (champ PAR) |
Code du paramètre utilisateur. |
Valeur paramètre (champ PARVAL) |
La valeur des paramètres libres est disponible dans le bloc ASESSION. |
Onglet Technique
Localisation
Les répertoires 'racine' permettent de stocker des fichiers XTEND. Les ressources (fichiers, images...) de ces répertoires sont accessibles par le navigateur via des tokens 'image' ou 'pièces jointes'.
- Design HTML : Répertoire du projet HTML qui tient compte de la langue utilisateur
- X_FILES : Répertoire qui est propre au dossier X3 est qui est localisé sous X3_PUB/X3FOLDER/X_TEND/X_FILES
- X_FILEAPP : Répertoire qui est propre au dossier X3 est qui est localisé sous X3_PUB/X3FOLDER/X_TEND/X_FILAPP
Il est utilisé pour stoker des fichiers issus de traitements batch comme des rapports générés par le serveur d'impression
- X_TEND : Répertoire utilisé pour stocker des fichiers communs à tous les dossiers
Par exemple des images produits, des documents commerciaux...
Il est localisé sous X3_PUB/X_TEND/
Design HTML et X_FILES peuvent être localisés sur le serveur X3 (défaut) ou sur le serveur X3WEB
X_FILEAPP et X_TEND sont toujours localisés sur le serveur X3.
Http cache expires
Le protocole HTTP propose des instructions (Http Headers) qui permettent de gérer le stockage des ressources (images, pdf...) dans la mémoire cache (caching) du navigateur.
C'est l'application serveur qui décide, au travers de ces instructions, la date d'expiration (non validité) de la ressources.
Cette date définit la durée pendant laquelle ces ressources doivent être considérée comme valides par le navigateur. Passé cette date, la ressource sera redemandée au serveur (rafraichie).
Un bon contrôle de la gestion du cache permet optimiser le temps d'affichage des pages.
Les paramètres Design HTML, X_FILEAPP, X_FILES, X_TEND, Flash permettent de définir la date d'expiration des ressources de ces répertoires :
- Jamais
Signifie que la ressource n'expire jamais et quelle sera conservée par le navigateur tant que l'utilisateur n'efface pas le cache. - Toujours
Signifie que la ressource n'est pas stockée dans la cache du navigateur et quelle sera transférée sur le à chaque affichage de la page. - 1mn, 15mn...7jours
Indique la durée de validité de la ressource sur le navigateur.
Url d'accès aux ressources
La durée de validité est générée par XTEND dans l'URL de la ressource :
/xtend/data/exp(86400,65799)/remote/SOLPAIE/PAIE/X_TEND/X_HTML/FDBTEST/FRA/IMG/img1.jpg
- 86400 est la durée de validité,
- 65799 est un index qui permet de forcer le rafraichissement de la ressource via une URL d'administration.
Pour surcharger la durée de validité de la ressource par rapport à celle définie par défaut il faut utiliser le paramètre ?exp=secondes dans l'URL :
<img src="xtend/data/exp(86400,65799)/remote/SOLPAIE/PAIE/X_TEND/X_HTML/FDBTEST/FRA/IMG/img1.jpg?exp=30/">
- La durée de validité passe à 30 seconde au lieu de 86400
Lorsque le répertoire qui contient la ressource est localisé en local du serveur X3WEB, la gestion du cache est déléguée aux tags META de la page et au serveur Apache (httpd.conf).
Déterminer la durée de 'fraîcheur' d'une ressource
Il est important de se poser la question pour chaque type de ressource utilisée par le site.
Par exemple toutes les ressources qui constituent la page HTML statique et qui peuvent avoir une taille non négligeable (images, css, JavaScript), ne sont jamais modifiées (sur le site de production) et ont donc une durée de fraicheur illimitée.
Si on paramètre XTEND pour que les ressources du dossier Design HTML aient une durée de validité d'une semaine, le navigateur ne les chargera qu'une seule fois par semaine.
Seules les donnés dynamiques transitent par le réseau lors de l'affichage d'une page.
Forcer le rafraichissement des ressources
XTEND permet au webmaster de forcer le rafraichissement (effacer le cache), sur tous les navigateurs, de toutes les ressources d'un site qui ont une durée de validité via l'url ci-dessous.
http://host:port/xtend/svc/X3SOL/X3FLDR/XTDSITE/admin/browser/clear
Cette fonction présente un intérêt :
- en mode développement
- lorsque le webmaster effectue une mise à jour de son site.
Vérifier la mise à jour
Ces paramètres indiquent au serveur XTEND s'il doit vérifier les mises à jour des fichiers (timestamp) du dictionnaire xml et de la page HTML avant l'affichage pour prendre en compte les modifications.
Par défaut, les paramètres 'Page Html' et 'Dictionnaire web' sont cochés ce qui signifie que le moteur effectue la vérification pour chaque requête.
Cette vérification peut prendre de 5 à 100ms en fonction de la configuration réseau.
La vérification des mises à jour est obligatoire en mode développement car on modifie sans cesse le page HTML ou le dictionnaire.
En mode production, le site HTML et le dictionnaire ne sont jamais modifiés et il est conseillé de décocher ces paramètres.
La case à cocher 'Valeurs par défaut' met à jour les paramètres 'Page Html' et 'Dictionnaire web' avec leurs valeurs par défaut.
L'url suivante permet de forcer le rechargement du dictionnaire quelque soit la valeur des paramètres.
http://hostname:port/xtend/svc/SolutionX3/DossierX3/SiteXtend/admin/reposit/reload.
Divers
Extension image (champ EXTDEFIMG) |
Extension par défaut utilisée pour le mapping de champs 'texte' vers des champs de type 'image'. |
Extension pièce jointe (champ EXTDEFPJ) |
Extension par défaut utilisée pour le mapping de champs 'texte' vers des champs de type 'pièce jointe' (Attachement). |
Scripts serveur
Répertoire racine (champ SCTROO) |
Chemin relatif (champ SCTSUBREP) |
Localisation (*)
Design HTML (*) (champ LOCHTM) |
Définissez l'emplacement du répertoire qui contient le projet HTML sur :
Localisation sur le serveur X3L'accès aux ressources situées sur le serveur X3 est effectué par le serveur XTEND (Servlet spécialisée) qui se comporte comme un proxy. Le navigateur :
Localisation en local du serveur X3WEBEn local du serveur X3WEB, la racine du répertoire X3_PUB est localisée sous : \WebData\LOCAL\X3SOLUTION\X3_PUB\. Les répertoires 'Design HTML' et X_FILES sont à copier sous cette racine en respectant la sous-arborecsence lorsqu'on est en mode 'Serveur X3WEB'. Le paramètre de configuration xtend.server.data.localpath=/data/local permet définir le type de traitement serveur qui sera sollicité pour accéder aux ressources en mode local. Si vous voulez déléguer l'accès aux ressources au serveur Apache (optimisation) :
|
X_FILES (*) (champ LOCFIL) |
Définissez l'emplacement des répertoires X_FILES (X3_PUB/X3FOLDER/X_TEND/X_FILES) sur :
Localisation sur le serveur X3L'accès aux ressources situées sur le serveur X3 est effectué par le serveur XTEND (Servlet spécialisée) qui se comporte comme un proxy. Le navigateur :
Localisation en local du serveur X3WEBEn local du serveur X3WEB, la racine du répertoire X3_PUB est localisée sous : \WebData\LOCAL\X3SOLUTION\X3_PUB\. Les répertoires 'Design HTML' et X_FILES sont à copier sous cette racine en respectant la sous-arborecsence lorsqu'on est en mode 'Serveur X3WEB'. Le paramètre de configuration xtend.server.data.localpath=/data/local permet définir le type de traitement serveur qui sera sollicité pour accéder aux ressources en mode local. Si vous voulez déléguer l'accès aux ressources au serveur Apache (optimisation) :
|
Flash (*) (champ LOCFLA) |
Définissez l'emplacement des répertoires qui contient les composants FLASH(/X3_PUB/X3_ROOT/X3CLI/XBLOCK/FLASH) sur :
Localisation sur le serveur X3L'accès aux ressources situées sur le serveur X3 est effectué par le serveur XTEND (Servlet spécialisée) qui se comporte comme un proxy. Le navigateur :
Localisation en local du serveur X3WEBEn local du serveur X3WEB, la racine du répertoire X3_PUB est localisée sous : \WebData\LOCAL\X3SOLUTION\X3_PUB\. Les répertoires 'Design HTML' et X_FILES sont à copier sous cette racine en respectant la sous-arborecsence lorsqu'on est en mode 'Serveur X3WEB'. Le paramètre de configuration xtend.server.data.localpath=/data/local permet définir le type de traitement serveur qui sera sollicité pour accéder aux ressources en mode local. Si vous voulez déléguer l'accès aux ressources au serveur Apache (optimisation) :
|
HTTP cache expires (*)
Valeurs par défaut (*) (champ HCEDEF) |
Initialise les paramètres avec les valeurs par défaut. |
Design HTML (*) (champ HCEHTM) |
Durée pendant laquelle les ressources du projet HTML doivent être considérées comme valides par le navigateur. |
X_FILES (*) (champ HCEFIL) |
Durée pendant laquelle les ressources du répertoire X_FILES (X3_PUB/X3FOLDER/X_TEND/X_FILES) doivent être considérées comme valides par le navigateur. |
X_TEND (*) (champ HCEXTD) |
Durée pendant laquelle les ressources du répertoire X_TEND (X3_PUB/X_TEND/) doivent être considérées comme valides par le navigateur. |
X_FILEAPP (*) (champ HCEAPP) |
Durée pendant laquelle les ressources du répertoire X_FILAPP(X3_PUB/X3FOLDER/X_TEND/X_FILAPP) doivent être considérées comme valides par le navigateur. |
Flash (*) (champ HCEFLA) |
Durée pendant laquelle les ressources des composants FLASH (/X3_PUB/X3_ROOT/X3CLI/XBLOCK/FLASH) doivent être considérées comme valides par le navigateur. |
Vérifier mise à jour (*)
Valeurs par défaut (*) (champ CTSDEF) |
Cette case à cocher permet de mettre à jour les paramètres 'Page Html' et 'Dictionnaire web' avec leurs valeurs par défaut. L'url suivante permet de forcer le rechargement du dictionnaire quelque soit la valeur des paramètres. |
Pages HTML (*) (champ CTSHTM) |
Ce paramètre indique au serveur XTEND s'il doit vérifier les mises à jour des fichiers (timestamp) des pages HTML. |
Dictionnaire Web (*) (champ CTSDIC) |
Ce paramètre indique au serveur XTEND s'il doit vérifier les mises à jour des fichiers (timestamp) du dictionnaire xml. |
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
Copie |
Ce bouton permet de copier la fiche site. |
Barre de menus
Permet de choisir le site selectionné comme le site courant. |
Permet d'acceder au paramétrage des pools XTEND. En-tête
DescriptionConfiguration
Utilisateur
Tableau Alias X3 WAS
|
Cet outil permet de regénérer les répertoires où sont stockés les fichiers liés aux sites (pages html, ressources, images, etc.). |
Cet outil permet de vérifier que les répertoires où sont stockés les fichiers liés aux sites (pages html, ressources, images, etc.) sont bien générés. |