La personnalisation n'est possible que pour SOLUTION 2 (voir 2. Installation initiale).
Si vous avez opté pour SOLUTION 1, passez directement à la partie 4. Déploiement.
Tous les fichiers de personnalisation sont renommés en xxx.sample.extension de manière à ne pas les écraser lors des mises à jour de l'application.
3.1 Charte graphique
Changement des couleurs |
|
---|---|
Changement de la taille de police moyenne de l'application |
|
3.2 Messages
Pour modifier les messages prévus par défaut, il suffit de les redéfinir dans des fichiers .properties.
Dans le répertoires resources/i18n vous trouverez 2 fichiers à renommer :
- messages.sample.properties à renommer en messages.properties => pour surcharger les messages 'standards' affichés par l'application
- vaadin-messages.sample.properties à renommer en vaadin-messages.properties => pour surcharger les messages des composants vaadin (ex : "Votre session a expiré" ou "Connexion perdue, tentative de reconnexion..."
Les fichiers messages.properties et vaadin-messages.properties sont optionnels et ne doivent contenir donc que les messages à modifier.
3.3 Requêtes SQL
Comme dans la version précédente de MonDossierWeb, certaines requêtes SQL sont modifiables pour permettre une plus grande flexibilité.
Les requêtes que l'on peut surcharger sont les suivantes :
Nom dans apogeeRequest.xml | Rôle | Remarques |
---|---|---|
calendrierExamen | Récupération des examens programmés pour un étudiant. Paramètres :
| La requête fournie avec l'application est axée sur une règle de gestion spécifique à l'Université de Lorraine. Vous aurez probablement besoin de modifier cette requête. |
mailFromLogin | Récupération du mail de l'étudiant à partir de son login. Paramètres :
| La requête fournie avec l'application utilise une table spécifique à l'Université de Lorraine stockant ces informations dans Apogée : ANNU_MEL_LOGIN. Requête non utilisée de base par l'application. Dans un soucis de migration depuis la version précédente de monDossierWeb, elle est cependant prévue pour des universités qui voudraient implémenter un bean ayant besoin de récupérer le mail à partir du login. |
loginFromCodEtu | Récupération du login de l'étudiant à partir de son code étudiant. Paramètres :
| La requête fournie avec l'application utilise une table spécifique à l'Université de Lorraine stockant ces informations dans Apogée : ANNU_MEL_LOGIN. Requête utilisée par le bean : LoginCodeEtudiantConverterImplUnivLorraine |
mailFromCodEtu | Récupération du mail de l'étudiant à partir de son code étudiant. Paramètres :
| La requête fournie avec l'application utilise une table spécifique à l'Université de Lorraine stockant ces informations dans Apogée : ANNU_MEL_LOGIN. Requête utilisée par le bean : EmailConverterImplUnivLorraine |
3.4 Beans interchangeables
Comme dans la version précédente de MonDossierWeb, certains beans java sont interchangeables pour permettre une plus grande flexibilité.
Vous pouvez créer votre propre bean si ceux proposés ne conviennent pas à votre environnement. Il suffit pour cela de créer une nouvelle classe java implémentant l'interface du bean d'origine, puis de modifier la classe à instancier dans le fichier context.xml (voir les paramètre de type 'Interface' ici).
Ces beans sont les suivants:
identifiant | rôle | interface à implémenter | package | implémentations fournies |
serveurphoto | récupération des photos des étudiants | IPhoto | fr.univlorraine.mondossierweb.photo |
|
codetuFromLogin | récupération du cod_etu à partir du login d'un étudiant. | CodeEtudiantLoginConverterInterface | fr.univlorraine.mondossierweb.converters |
|
loginFromCodetu | récupération du login à partir du codetu d'un étudiant | LoginCodeEtudiantConverterInterface | fr.univlorraine.mondossierweb.converters |
|
emailConverter | création du mail à partir du login étudiant | EmailConverterInterface | fr.univlorraine.mondossierweb.converters |
|
Comme indiquer ci-dessus, les récupérations du login et du mail en fonction du cod_etu et se font, de base, à partir du LDAP via les implémentations :
- codetuFromLoginLdapImpl
- emailConverterLdapImpl
Mais les implémentations propres à l'université de Lorraine (utilisant une table MEL_LOGIN dans Apogée) sont disponibles via les implémentations :
- loginFromCodetuUnivLorraineImpl
- emailConverterUnivLorraineImpl
A noter que pour la récupération du mail il existe également une implémentation 'basic' qui concatène le login étudiant avec le paramètre applicatif 'extensionMailEtudiant' (voir Configuration). Cela se fait via l'implémentation:
- emailConverterBasicImpl
3.5 ElasticSearch
L'implémentation d'ElasticSearch au sein de monDossierWeb dépend de la version d'ElasticSearch installée.
Pour changer la version utilisée et passer en v2 :
- Editer le fichier pom.xml :
- modifier la version de l'artefact mdw-tools de 1.x.y en 2.x.y puis re-déployer l'application (voir doc Déploiement)