Reportez-vous à la documentation de Mise en oeuvre
Champs
Les champs suivants sont présents dans cet onglet :
| Le code site sert à construire l'URL du site dans le paramétrage : |
|   |
|   |
| 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 : |
Fermer
Présentation
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.
Liste des pools de web services utilisés par le site. Chaque pool contient :
Fermer
Champs
Les champs suivants sont présents dans cet onglet :
Caractéristiques
| 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. |
| 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. |
| Sélectionnez 'Oui' pour basculer le site en maintenance et afficher la 'Page de maintenance'. |
|   |
| Sélectionnez 'Oui' pour activer la gestion des profils XTEND. |
Tableau Informations liées à la langue
| 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. |
|   |
| Code langue du dossier X3. |
|   |
|   |
|   |
|   |
Tableau Pools Web services (*)
| Code du pool de Web services. |
| 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 :
|
| 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 (*)
| Ces e-mails peuvent être utilisés comme paramètres d'action ou pour affichage. |
Fermer
Champs
Les champs suivants sont présents dans cet onglet :
Page par défaut
| 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é. |
| 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é. |
| 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é. |
| 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é. |
| Code de la page de maintenance. Cette page s'affiche automatiquement lorsque le site est en maintenance. |
| 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
|
Outils
| XTEND peut afficher des fonctions utilitaires pour le développeur en bas des pages HTML. |
| 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\ |
| XTEND peut afficher des fonctions utilitaires pour le développeur en bas des pages HTML. |
Tableau Paramètres libres (*)
| Code du paramètre utilisateur. Quatre valeurs sont livrées par défaut : MAILACCOUNT
DEFURLDOC
WORKFLOW
REFMOISPAYE
|
| La valeur des paramètres libres est disponible dans le bloc ASESSION. |
Fermer
Présentation
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 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.
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 :
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
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/">
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).
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.
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 :
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.
Fermer
Champs
Les champs suivants sont présents dans cet onglet :
Divers
| Extension par défaut utilisée pour le mapping de champs 'texte' vers des champs de type 'image'. |
| Extension par défaut utilisée pour le mapping de champs 'texte' vers des champs de type 'pièce jointe' (Attachement). |
Scripts serveur
|
|
Localisation (*)
| 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) :
|
| 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) :
|
| 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 (*)
| Initialise les paramètres avec les valeurs par défaut. |
| Durée pendant laquelle les ressources du projet HTML doivent être considérées comme valides par le navigateur. |
| 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. |
| 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. |
| 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. |
| 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 (*)
| 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. |
| Ce paramètre indique au serveur XTEND s'il doit vérifier les mises à jour des fichiers (timestamp) des pages HTML. |
| Ce paramètre indique au serveur XTEND s'il doit vérifier les mises à jour des fichiers (timestamp) du dictionnaire xml. |
Fermer
Par défaut, les états suivants sont associés à la fonction :
PRTSCR : Impression écran
Mais ceci peut être modifié par paramétrage.
Ce bouton permet de copier la fiche site. |
Permet de choisir le site selectionné comme le site courant.
Permet d'acceder au paramétrage des pools XTEND.
Champs
Les champs suivants sont présents dans cette fenêtre :
| Identifiant du pool de connexion, utilisé pour appeler un web service. |
|   |
| Code de la solution SAFEX3. Il s'agit des codes de la solution et du dossier X3. |
| Code du dossier SAFEX3. Il s'agit des codes de la solution et du dossier X3. |
| Il s'agit de l'identifiant du serveur web. Il permet de différencier les pools de connexions de même nom déclarés sur des serveurs X3 WEB différents. |
Fermer
Champs
Les champs suivants sont présents dans cette fenêtre :
Configuration
| Hostname ou adresse IP du serveur X3 WEB. |
| Port d'écoute du serveur X3 WEB (28880 par défaut). |
| Nom du serveur X3WEB s'il est accessible de l'extérieur. |
| Port du serveur X3WEB s'il est écouté de l'extérieur. |
| Nombre de connexions X3 maximum pour le pool. |
| Nombre de connexions X3 ouvertes au démarrage du pool. |
Utilisateur
| Utilisateur du pool de Web service. |
| Mot de passe du pool de Web service. |
| Langue de connexion du pool de Web service. |
Tableau Alias X3 WAS
| Il s'agit de l'identifiant du pool XTEND. |
|   |
| Vous pouvez utiliser le protocole https pour l'appel de web services. |
| Il s'agit de la durée maximale d'attente (en millisecondes) de la réponse d'une requêteweb service (SOAP). Passé ce délai, le serveur XTEND lève une exception. |
| Par défaut, les login et password sont ceux utilisés par le serveur XTEND :
Pour que les informations soient prises en compte par le serveur XTEND il faut :
|
|   |
|   |
Fermer
Cet outil permet de regénérer les répertoires où sont stockés les fichiers liés aux sites (pages html, ressources, images...).
Cet outil permet de vérifier que les répertoires où sont stockés les fichiers liés aux sites (pages html, ressources, images...) sont bien générés.
Cet outil permet de supprimer les répertoires où sont stockés les fichiers liés aux sites (pages html, ressources, images...).
Certaines ressources doivent être protégées en lecture, c'est à dire qu'elles ne doivent pouvoir être lues que par l'utilisateur XTEND courant.
Pour protéger une ressource en lecture :
Si un autre utilisateur essaie d'ouvrir cette URL, le serveur XTEND renverra une erreur HTTP 404.
Le nom du répertoire protégé est paramétrable via la console xtend.server.data.protectdir.
La protection des ressources ne fonctionne pas si l'accès aux ressources est effectué par Apache (voir localisation sur X3WEB).
Exemple :
Si l'application XTEND génère des rapports (commandes, factures...) à la demande d'un utilisateur, les fichiers .pdf créés doivent être protégés en lecture :
L'accès à tous les fichiers /x_protect/* sera protégé.