Prérequis : environnement technique mis en place
2.1 Sources
2.1.1 Solution 1 : Installation rapide
La personnalisation de l'application n'est pas prévue pour cette installation (personnalisation fine du css, utilisation de beans java propres, etc..). Les étapes spécifiques à cette solution seront notées SOLUTION 1 dans le reste du document.
- Récupérer le war de la dernière version de monDossierWeb V3 sur https://sourcesup.renater.fr/projects/esup-dossieretu/ (onglet Fichiers)
2.1.2 Solution 2 : Installation personnalisée
La personnalisation de l'application est prévue pour cette installation (personnalisation fine du css, utilisation de beans java propres, etc..). Les étapes spécifiques à cette solution seront notées SOLUTION 2 dans le reste du document.
- Récupérer le zip de la dernière version de monDossierWeb V3 sur https://sourcesup.renater.fr/projects/esup-dossieretu/ (onglet Fichiers)
- Dézipper l'archive dans un dossier puis passer au paramétrage de l'application
2.2 Paramétrage des ressources JNDI
- Copier les éléments situés dans le fichier context.sample.xml dans la déclaration des variables JNDI de votre serveur Tomcat (par exemple server.xml). Suivant le choix de la solution dans la partie 2.1, le fichier context.sample.xml se trouve :
- SOLUTION 1 : dans META-INF/
- SOLUTION 2 : dans /src/main/webapp/META-INF/
- Renseigner chaque propriété ou les laisser les vide si vous n'en avez pas l’utilité
Propriété | Définition |
---|---|
Resource name="jdbc/dbMdw" | Déclaration de votre base de données MySql de monDossierWeb |
Resource name="jdbc/dbApogee" | Déclaration de votre base de données Apogée (pour le requêtage direct sur la base) |
Parameter name="app.url" | Url de l'application |
Parameter name="cas.url" | Url de votre service d'authentification CAS |
Parameter name="ldap.url" Parameter name="ldap.userDn" Parameter name="ldap.password" | Informations de connexion au ldap, respectivement :
|
Parameter name="uportal.ws" Parameter name="uportal.groupes.autorises" | Configuration de l'authentification des enseignants via les groupes uPortal de l'ENT
|
Parameter name="loginApogee" | Configuration de l'authentification des enseignants via la table UTILISATEUR d'Apogée
|
Parameter name="attributGroupeLdap" Parameter name="listeGroupesLdap" | Configuration de l'authentification des enseignants via des groupes LDAP
|
Parameter name="attributLdapEtudiant" Parameter name="typeEtudiantLdap" Parameter name="attributLdapCodEtu"
| Configuration de l'authentification des étudiants
|
Parameter name="sourceResultats" | Source des résultats lors de l'appel aux Web Services Apogée pour récupérer les notes et résultats
|
Parameter name="productionMode" | Mode production. Doit être à true |
Parameter name="enablePush" Parameter name="webSocketPush" Parameter name="showLoadingIndicator" | Configuration du Push :
|
Parameter name="mail.smtpHost" Parameter name="mail.from" Parameter name="mail.to" Parameter name="mail.startDisabling" Parameter name="mail.stopDisabling" | Paramètres pour l'envoi des mails d'erreur, respectivement :
|
Parameter name="param.elasticsearch.url" Parameter name="param.elasticsearch.port" Parameter name="param.elasticsearch.cluster" Parameter name="param.elasticsearch.index" Parameter name="param.elasticsearch.index.champrecherche" | Configuration de la connexion a ElasticSearch
|
Parameter name="param.apogee.mail.annuaire" Parameter name="emailConverter.implementation" | Configuration de la récupération du mail de l'étudiant
|
Parameter name="codetuFromLogin.implementation" Parameter name="loginFromCodetu.implementation"
| Configuration de la récupération des identifiants Apogée d'un étudiant
|
Parameter name="serveurphoto.implementation" | Configuration de la récupération des photos
|
Parameter name="google.analytics.account"
Parameter name="piwik.tracker.url" Parameter name="piwik.site.id" | Configuration de la plateforme web analytics (facultatif). Google Analytics ou Piwik. Paramètres de Google Analytics, optionnel respectivement :
Paramètres de piwik, optionnel (https://fr.piwik.org/), respectivement :
|
2.3 Paramétrage des webservices Apogée
Copier le fichier configUrlServices.sample.properties et renommer le en configUrlServices.properties puis éditer le suivant le choix de la solution dans la partie 2.1, le fichier configUrlServices.sample.properties se trouve :
- SOLUTION 1 : dans /WEB-INF/classes/
- SOLUTION 2 : dans /src/main/resources/
Renseigner les url de vos webservices utilisés dans l'application :
# WebServices Dossier Etudiant administratifMetier.urlService=https://wsapogee.univ.fr/services/AdministratifMetier etudiantMetier.urlService=https://wsapogee.univ.fr/services/EtudiantMetier pedagogiqueMetier.urlService=https://wsapogee.univ.fr/services/PedagogiqueMetier geographieMetier.urlService=https://wsapogee.univ.fr/services/GeographieMetier # Web Services Référentiel offreFormationMetier.urlService=https://wsapogee.univ.fr/services/OffreFormationMetier # WebServices Dossier Etudiant administratifMetier.urlService.ssl=https://wsapogee.univ.fr/services/AdministratifMetier etudiantMetier.urlService.ssl=https://wsapogee.univ.fr/services/EtudiantMetier pedagogiqueMetier.urlService.ssl=https://wsapogee.univ.fr/services/PedagogiqueMetier geographieMetier.urlService.ssl=https://wsapogee.univ.fr/services/GeographieMetier # Web Services Référentiel offreFormationMetier.urlService.ssl=https://wsapogee.univ.fr/services/OffreFormationMetier #SSL WS_SSL_MODE=false; WS_KEY_STORE_PATH=C:/client_keystore WS_CERTIF_STORE_PATH=C:/client_keystore WS_KEY_PASS=password WS_KEY_TYPE=jks
2.4 Base de données
La base de données (qui doit être préalablement créée vide) est automatiquement alimentée au démarrage de l'application.