Prérequis : MDWP -1- Environnement technique |
L'installation s'effectue à partir de l'application packagée sous la forme d'un fichier .war
Si vous ne disposez pas de ce package, vous pouvez au choix :
Pour générer le war, il faut avoir préalablement récupéré le code source de l'application.
git clone https://github.com/EsupPortail/esup-mdw-pegase.git |
mvn clean package -P production |
La configuration de l'application est à renseigner dans le fichier WEB-INF/classes/application.properties.
Pour cela il est nécessaire de créer et compléter un fichier application.properties sur le modèle de WEB-INF/classes/application-sample.properties. Toute la configuration de l'application est expliquée dans ce fichier.
A partir de la version 1.5 (release de novembre 2022) le paramétrage applicatif se fait en 2 temps :
Créer et compléter un fichier WEB-INF/classes/application.properties sur le modèle de WEB-INF/classes/application-sample.properties. Toute la configuration de l'application est expliquée dans ce fichier.
Tout utilisateur connecté en tant qu'admin (logins à renseigner dans application.properties, voir paragraphe ci-dessus) a accès à la vue "Configuration" depuis le menu contextuel accessible dans le coin supérieur droit.
Cette vue permet de finaliser la configuration de l'application. Le paramétrage y est découpé en domaines techniques :
Pour modifier le paramétrage d'un domaine, il est nécessaire de cliquer sur le bouton "Éditer" situé en bas du bloc correspondant.
Une fois les différents champs renseignés, cliquer sur "Enregistrer" (ou "Annuler" pour revenir aux valeurs précédentes).
Ces modifications ont un effet immédiat sur l'instance applicative en cours d'utilisation par l'utilisateur connecté.
Dans le cas d'une architecture multi-instances (plusieurs Tomcat hébergeant chacun une instance de MDW) il est nécessaire, pour certains domaines techniques, de pousser la configuration sur les autres instances via le bouton "Synchroniser la configuration". Dans un délais maximum de 5 secondes toutes les instances de MDW synchroniseront leur configuration du domaine technique concerné.
Dans certains cas il peut être pratique de valider préalablement sa modification sur la session en cours avant de forcer la synchronisation globale du paramétrage.
A cette fin, la configuration de certains domaines peut être testée via un bouton dédié.
Le bouton "Tester APIs" permet, par exemple, de valider l'appel à chacune des APIs Pégase utilisée par MDW.
La quasi totalité des libellés affichés par MonDossierWeb (à l'exception de ceux provenant directement de Pégase) sont modifiables via : /WEB-INF/classes/i18n/messages.properties.
Il suffit d'y ajouter le ou les libellés de messages-default.properties que l'on souhaite surcharger en indiquant la valeur souhaitée.
Cette configuration est à effectuer avant le démarrage du Tomcat.
Le fichier messages.properties étant packagé dans chaque release, il sera nécessaire de récupérer votre fichier messages lors de chaque nouvelle installation.