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 (couleurs, logos, 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 eCandidat V2 sur https://sourcesup.renater.fr/projects/ecandidat/ (onglet Fichiers)
2.1.2 Solution 2 : Installation personnalisée
La personnalisation de l'application est prévue pour cette installation (couleurs, logos, 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 eCandidat V2 sur https://sourcesup.renater.fr/projects/ecandidat/ (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_samle.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_samle.xml se trouve :
- SOLUTION 1 : dans META-INF/
- SOLUTION 2 : dans /src/main/webapp/META-INF/
- Renseigner chaque propriété ou laisser les vide si vous n'en avez pas l’utilité
| Propriété | Définition |
|---|---|
| Resource name="jdbc/dbEcandidat" | Déclaration de votre base de données MySql de eCandidat |
| Parameter name="siscol.implementation" | Implémentation du service SiScol à utiliser. Si vous voulez utilisez Apogée ainsi que ses WebServices, laissez celui par défaut : siScolApogeeWSServiceImpl |
| Resource name="jdbc/dbSiScol" | 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="assistance.documentation.url" Parameter name="assistance.documentation.url.candidat" Parameter name="assistance.documentation.url.candidat.en" Parameter name="assistance.helpdesk.url" Parameter name="assistance.contact.mail" | Informations d'assistance, respectivement :
|
Parameter name="ldap.base" Parameter name="ldap.url" Parameter name="ldap.branche.people" Parameter name="ldap.user" Parameter name="ldap.pwd" | Informations de connexion au ldap, respectivement :
|
Parameter name="ldap.champs.uid" Parameter name="ldap.champs.displayName" Parameter name="ldap.champs.mail" Parameter name="ldap.champs.sn" Parameter name="ldap.champs.cn" Parameter name="ldap.champs.supannCivilite" Parameter name="ldap.champs.supannEtuId" Parameter name="ldap.champs.givenName" | Champs utilisés dans le ldap, respectivement :
|
| Parameter name="ldap.filtre.personnel" | Filtre ldap de recherche de personnel (pour les gestionnaires ou membres de commission) Exemple : (eduPersonAffiliation=employee) ou !(eduPersonAffiliation=student) Attention à bien placer les parenthèses comme dans les deux exemples ci-dessus. |
| Parameter name="admin.technique" | Login de l'admin technique |
Parameter name="mail.smtpHost" Parameter name="mail.from" Parameter name="mail.from.noreply" Parameter name="mail.to" | Paramètres pour l'envoi de mail, respectivement :
|
Parameter name="file.cmis.atompub.url" Parameter name="file.cmis.repository" Parameter name="file.cmis.user" Parameter name="file.cmis.pwd" Parameter name="file.cmis.candidat.id" Parameter name="file.cmis.gestionnaire.id" | Paramètres de dématérialisation (solution CMIS), respectivement :
Attention : si vous renseignez ces informations, vous ne DEVEZ pas renseigner les paramètres de dématérialisation (solution FileSystem) |
Parameter name="file.filesystem.candidat.path" Parameter name="file.filesystem.gestionnaire.path" | Paramètres de dématérialisation (solution FileSystem), respectivement :
Attention : si vous renseignez ces informations, vous ne DEVEZ pas renseigner les paramètres de dématérialisation (solution CMIS) |
Parameter name="limesurvey.path" Parameter name="limesurvey.user" Parameter name="limesurvey.pass" | Paramètres pour accéder aux webservices LimeSurvey, respectivement :
|
| Parameter name="batch.fixedRate" | Fréquence de vérification de la table des batchs de l'application (en ms) |
Parameter name="piwikAnalytics.trackerUrl" Parameter name="piwikAnalytics.siteId" | Paramètres de piwik, optionnel (https://fr.piwik.org/), respectivement :
|
| Parameter name="demoMode" | Mode démo. Doit être à false |
| Parameter name="productionMode" | Mode production. Doit être à true |
| Parameter name="enablePush" | Activation du push. Doit être à true |
2.3 Paramétrage des webservices Apogée
L'application est livrée avec la bibliothèque gouv.education.apogee.apo-webservicesclient version 4.60.lbe.
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 :
Url WebServices Apogée
# WebServices Dossier Etudiant etudiantMetier.urlService=https://wsapogee.univ.fr/services/amue_apo_update_etudiant etudiantMetier.urlService.ssl=https://wsapogee.univ.fr/services/amue_apo_update_etudiant pedagogiqueMetier.urlService=https://wsapogee.univ.fr/services/amue_apo_pedagogique pedagogiqueMetier.urlService.ssl=https://wsapogee.univ.fr/services/amue_apo_pedagogique # URL des Services Apogee-OPI opiMetier.urlService=https://wsapogee.univ.fr/services/amue_opi opiMetier.urlService.ssl=https://wsapogee.univ.fr/services/amue_opi
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