Développement >  Safe X3 WAS >  Sites Web >  Sites Web  

Afficher tout Masquer tout

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


Cette fonction permet de paramétrer les sites Web disponibles.

Pré-requis

Codes activité

Les codes activités suivants (classés par type) peuvent avoir une influence sur le comportement de la fonction :

Fonctionnel

  AYT :  Xtend

Dimensionnement

  AYL :  Nb langues pour un site Web

Habilitations

Cette fonction est de type objet. Les opérations de création, modification, et suppression de fiche peuvent être activées ou désactivées pour un utilisateur donné. Des filtres par rôles peuvent également être mis en place sur cette fonction.

Gestion de l'écran

En-tête

Champs

Les champs suivants sont présents dans cet onglet :

  • Intitulé (champ INTIT)

 
  • champ ICOWRK

 
  • Publier le site (champ FCYPUB)

Fermer

 

Onglet Général

Présentation

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 configuration xtend.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.

Fermer

 

Champs

Les champs suivants sont présents dans cet onglet :

Bloc numéro 1

  • Timeout session (mn.) (champ USRTIMOUT)
  • Site en maintenance (champ MCEFLG)
  • Dossier HTML par langue (champ DIRLAN)

 
  • Gestion profils (champ PRFENA)

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 configuration xtend.server.gensetup.deflang.

L'action ASESSSWITCHLANG permet de changer de langue.

  • Défaut (champ LANDEF)

 
  • Format des devises (champ LANFMTCUR)

 
  • Format des entiers (champ LANFMTINT)

 
  • Format des décimaux (champ LANFMTDEC)

 
  • Format des dates (champ LANFMTDAT)

 

Tableau Pools Web services (*)

  • Pool par défaut (champ LNKADSDEF)

Le Pool par défaut permet l'appel des web services du site.
Il peut être surchargé dans la fiche Interfaces.

Il est obligatoire de saisir un pool par défaut et fortement conseillé de vérifier que :

  • l'adresse du serveur de web service est correcte et que le serveur répond bien,
  • le pool de connexion existe et est bien dans l'état démarré.
  • 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.

  • Si cette case est cochée, les appels de web services sont communiqués par un bus interne au serveur X3WEB et les temps sont améliorés.
  • Si cette case n'est pas cochée, les appels des web services se font par le protocole http/SOAP.

Email Web master (*)

  • champ MAICOD

Fermer

 

Onglet Avancé

Champs

Les champs suivants sont présents dans cet onglet :

Page par défaut

  • Image par défaut (champ IMGDEF)

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.
Ce protocole peut être surchargé dans la fiche de paramétrage de la page (par exemple pour le site ASAMPLE nous utilisons HTTP par défaut et HTTPS pour la page de login).

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)
  • Suivi de l'activité (*) (champ LOGMOD)
  • Affichage outils (*) (champ TOOLMOD)

Tableau Paramètres libres (*)

  • Paramètre (champ PAR)
  • Valeur paramètre (champ PARVAL)

Fermer

 

Onglet Technique

Présentation

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).

SEEWARNING 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.

SEEINFO 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 image (champ EXTDEFIMG)
  • Extension pièce jointe (champ EXTDEFPJ)

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 :

  • le serveur X3,
  • ou le serveur X3WEB.

Localisation sur le serveur X3

L'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 :

  • envoie une URL au serveur XTEND qui détermine l'emplacement de la ressource sur le serveur X3 en fonction des paramètres X3SOL/X3FOLDER/XTENDSITE de l'URL.
  • effectue ensuite une lecture de la ressource sur le serveur X3,
  • et renvoie les données (et la durée d'expiration) au navigateur.
Localisation en local du serveur X3WEB

En local du serveur X3WEB, la racine du répertoire X3_PUB est localisée sous :  \WebData\LOCAL\X3SOLUTION\X3_PUB\.
WebData est le répertoire 'Data' défini lors de l'installation du serveur X3WEB.

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.
/data/local (défaut) indique que c'est une servlet XTEND qui effectue la lecture des ressources.

Si vous voulez déléguer l'accès aux ressources au serveur Apache (optimisation) :

  • modifiez la valeur,
  • créez un alias de même nom dans httpd.conf.
  • X_FILES (*) (champ LOCFIL)

Définissez l'emplacement des répertoires X_FILES (X3_PUB/X3FOLDER/X_TEND/X_FILES) sur :

  • le serveur X3,
  • ou le serveur X3WEB.

Localisation sur le serveur X3

L'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 :

  • envoie une URL au serveur XTEND qui détermine l'emplacement de la ressource sur le serveur X3 en fonction des paramètres X3SOL/X3FOLDER/XTENDSITE de l'URL.
  • effectue ensuite une lecture de la ressource sur le serveur X3,
  • et renvoie les données (et la durée d'expiration) au navigateur.
Localisation en local du serveur X3WEB

En local du serveur X3WEB, la racine du répertoire X3_PUB est localisée sous :  \WebData\LOCAL\X3SOLUTION\X3_PUB\.
WebData est le répertoire 'Data' défini lors de l'installation du serveur X3WEB.

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.
/data/local (défaut) indique que c'est une servlet XTEND qui effectue la lecture des ressources.

Si vous voulez déléguer l'accès aux ressources au serveur Apache (optimisation) :

  • modifiez la valeur,
  • créez un alias de même nom dans httpd.conf.
  • Flash (*) (champ LOCFLA)

Définissez l'emplacement des répertoires qui contient les composants FLASH(/X3_PUB/X3_ROOT/X3CLI/XBLOCK/FLASH) sur :

  • le serveur X3,
  • ou le serveur X3WEB.

Localisation sur le serveur X3

L'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 :

  • envoie une URL au serveur XTEND qui détermine l'emplacement de la ressource sur le serveur X3 en fonction des paramètres X3SOL/X3FOLDER/XTENDSITE de l'URL.
  • effectue ensuite une lecture de la ressource sur le serveur X3,
  • et renvoie les données (et la durée d'expiration) au navigateur.
Localisation en local du serveur X3WEB

En local du serveur X3WEB, la racine du répertoire X3_PUB est localisée sous :  \WebData\LOCAL\X3SOLUTION\X3_PUB\.
WebData est le répertoire 'Data' défini lors de l'installation du serveur X3WEB.

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.
/data/local (défaut) indique que c'est une servlet XTEND qui effectue la lecture des ressources.

Si vous voulez déléguer l'accès aux ressources au serveur Apache (optimisation) :

  • modifiez la valeur,
  • créez un alias de même nom dans httpd.conf.

HTTP cache expires (*)

  • Valeurs par défaut (*) (champ HCEDEF)
  • Design HTML (*) (champ HCEHTM)
  • X_FILES (*) (champ HCEFIL)
  • X_TEND (*) (champ HCEXTD)
  • X_FILEAPP (*) (champ HCEAPP)
  • Flash (*) (champ HCEFLA)

Vérifier mise à jour (*)

  • Valeurs par défaut (*) (champ CTSDEF)
  • Pages HTML (*) (champ CTSHTM)
  • Dictionnaire Web (*) (champ CTSDIC)

Fermer

 

Sites prédéfinis en liste gauche

ATEMPLATE : est un site qui ne contient que les paramètres obligatoires pour assurer le bon fonctionnement d'XTEND.
Aucune interface ni page HTML ne sont livrées avec ce site.
Il peut être utilisé comme site de référence pour la création de nouveaux sites.
Il est livré dans tous les dossiers pour tous les produits SAFEX3.

ASAMPLE : contient les tokens XTEND standards et un projet HTML avec des pages d'exemple (accueil, à propos, login, contact, erreur....).
Il peut être utilisé comme site de référence pour la création de nouveaux sites.
C'est un exemple SAFE X3 livrét dans le dossier de demonstration pour tous les produits.

ASHOP : est un exemple de boutique en ligne livré uniquement sur le produit Sage ERP X3 dans le dossier démonstration.

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 la fiche site.

Barre de menu

Outils / Ce site comme site courant

Permet de choisir le site selectionné comme le site courant.

Outils / Pool de Web Services

Permet d'acceder au paramétrage des pools XTEND.

En-tête

Champs

Les champs suivants sont présents dans cette fenêtre :

  • Alias du pool (champ POOLALIAS)

Identifiant du pool de connexion.
  • Intitulé (champ INTITPOOL)

 
  • Solution (champ SOLUTION)

Code de la solution SAFEX3.

Il s'agit des codes de la solution et du dossier X3.
Ces codes sont utilisé par XTEND pour sélectionner les informations de login en fonction du pool.

Code du dossier SAFEX3.

Il s'agit des codes de la solution et du dossier X3.
Ces codes sont utilisé par XTEND pour sélectionner les informations de login en fonction du pool.
  • Alias serveur Web (champ SWEBALIAS)

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

Description

Champs

Les champs suivants sont présents dans cette fenêtre :

Configuration

  • Serveur Web (champ SERWEB)

Hostname ou adresse IP du serveur X3 WEB.
  • Port (champ PORTWEB)

Port d'écoute du serveur X3 WEB (28880 par défaut).
  • Adresse externe (champ SADDEXT)

Nom du serveur X3WEB s'il est accessible de l'extérieur.

  • Port externe (champ PORTWEBEXT)

Port du serveur X3WEB s'il est écouté de l'extérieur.

  • Nombre max entrées (champ MAXENTRY)

Nombre de connexion X3 maximum pour le pool.
  • Nombre d'entrées (champ NBENTRY)

Nombre de connexions X3 ouvertes au démarrage du pool.

Utilisateur

Utilisateur du pool de Web service.

  • Mot de passe (champ USRMDP)

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.
Les pools XTEND sont uniquement référencés par leur code dans les fiches de paramétrage XTEND (Interface et Sites), ce qui permet au développeur de décider sur quel serveur les web services seront éxécutés, sans avoir à modifier le paramétrage des applications XTEND.
  • Intitulé (champ POODES)

 
  • Connexion sécurisée (champ POOSEC)

Vous pouvez utiliser le protocole https pour l'appel de web services.
  • Time-out (champ POOTIMOUT)

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.
  • Utilisateur (champ POOUSER)

Par défaut, les login et password sont ceux utilisés par le serveur XTEND :

  • pour les utilisateurs anonymes,
  • ou si aucune information de login n'est fournie par le sous-programme de login XTEND.

Pour que les informations soient prises en compte par le serveur XTEND il faut :

  • valider la fiche 'pool web services'
  • forcer le rechargement du dictionnaire XTEND :
    • valider la fiche de paramétrage du site web,
    • ou tout autre fiche de paramétrage de site,
    • ou valider le site complet.
  • Mot de passe (champ POOPWD)

 

 

Fermer

Outils / Mise à jour de l'arborescence

Cet outil permet de regénérer les répertoires où sont stockés les fichiers liés aux sites (pages html, ressources, images...).

Outils / Vérification de l'arborescence

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.

Outils / Suppression de l'arborescence

Cet outil permet de supprimer les répertoires où sont stockés les fichiers liés aux sites (pages html, ressources, images...).

Protection

Répertoire protégé

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 :

  • stockez-la sous un répertoire de nom x_protect.
  • XTEND va génèrer une URL d'accès codée qui ne pourra être traitée que par la session utilisateur.

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 :

  • Créez un répertoire par utilisateur /x_protect/USERCODE/ sous X_FILEAPP qui contiendra les rapports.

L'accès à tous les fichiers /x_protect/* sera protégé.

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

Les tables suivantes sont mises en oeuvre par la fonction :

Table

Intitulé Table

ATEXTRA [AXX]

Textes à traduire

AYTFCY [AYS]

Sites Web