eCandidat (esup-opi)

Arborescence des pages

Comparaison des versions

Ancienne version 61

changes.mady.by.user Kevin Hergalant

Sauvegardée le

comparé à

Nouvelle version Actuel

changes.mady.by.user Kevin Hergalant

Sauvegardée le

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.

...

Info

Prérequis : environnement technique mis en place

 


Sommaire

Installation avant la version 2.5.0

...

2.1 Sources

2.1.1 Solution 1 : Installation rapide

...

  • Copier les éléments situés dans le fichier context_samlesample.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_samlesample.xml se trouve :
    • État
      colourBlue
      titleSolution 1
       : dans META-INF/
    • État
      colourBlue
      titleSolution 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
  • Si vous utilisez Pégase  ainsi que ses WebServices, utilisez la valeur "siScolPegaseWSServiceImpl"
  • Si vous n'utilisez
pas
  • ni Apogée,
le
  • ni Pégase, le paramètre doit être placé à siScolDefaultServiceImpl
Resource name="jdbc/dbSiScol"

Déclaration de votre base de données Apogée (pour le requêtage direct sur la base)

A supprimer si vous utilisez Pégase

Resource
Parameter
name="
app
siscol.
url"Url de l'applicationParameter name="cas.url"
default"

Paramètre obligatoire depuis la version 2.4.0 : Indiquez le type de SiScol présent dans votre base de données à la première exécution :

  • Si vous aviez Apogée, indiquez "A"
  • Si vous aviez Pégase, indiquez "P"
  • Ni Pégase, ni Apogée, indiquez "D"
  • Si c'est une installation initiale, indiquez le future SiScol utilisé
Url de votre service d'authentification CAS
Parameter name="
assistance.documentation
app.url"Url de l'application
Parameter name="
assistance
cas.
documentation.
url
.candidat
"Url de votre service d'authentification CAS

Parameter name="

assistance

pegase.

documentation.url.candidat.en

ws.username"
Parameter name="

assistance

pegase.

helpdesk

ws.

url"

password"

Version Pégase : Informations d'authentification de l'utilisateur ayant les droits de réaliser les appels WS sur Pégase
Parameter name="
assistance
pegase.
contact.mail
etablissement"

Informations d'assistance, respectivement :

Version Pégase : Code de l'établissement racine dans Pégase
Parameter name="pegase.opi.path"Version Pégase : Chemin vers un dossier sur le serveur où les fichiers d'OPI seront générés
  • page de documentation pour les gestionnaires,
  • page de documentation pour les candidats,
  • page de documentation pour les candidats en anglais,
  • lien vers le helpdesk de l'établissement pour les gestionnaires,
    • adresse de contact pour l'application

    Parameter name="

    ldap

    assistance.documentation.

    base

    url"

    Parameter name="

    ldap

    assistance.documentation.url.candidat"

    Parameter name="

    ldap

    assistance.

    branche.people"

    documentation.url.candidat.en"

    Parameter name="assistance.helpdesk.url"

    Parameter name="

    ldap

    assistance.contact.

    user

    mail"

    Parameter name="

    ldap

    assistance.contact.

    pwd

    url"

    Informations

    de connexion au ldap

    d'assistance, respectivement :

  • base du ldap (ex : dc=univ,dc=fr)
  • url du ldap et son port  (ex : ldaps://ldap.univ.fr:636)
  • accès à la branche people (ex : ou=people)
  • user du ldap

    • page de documentation pour les gestionnaires,
    • page de documentation pour les candidats,
    • page de documentation pour les candidats en anglais,
    • lien vers le helpdesk de l'établissement pour les gestionnaires,
    • adresse de contact pour l'application
    • url de contact pour l'application
    mot de passe du user

    Parameter name="ldap.

    champs.uid

    base"

    Parameter name="ldap.

    champs.displayName

    url"

    Parameter name="ldap.

    champs

    branche.

    mail

    people"

    Parameter name="ldap.

    champs.sn

    user"

    Parameter name="ldap.

    champs.cn"

    pwd"

    Informations de connexion au ldap, respectivement :

    • base du ldap (ex : dc=univ,dc=fr)
    • url du ldap et son port  (ex : ldaps://ldap.univ.fr:636)
    • accès à la branche people (ex : ou=people)
    • user du ldap
    • mot de passe du user

    Parameter name="ldap.champs.

    supannCivilite

    uid"

    Parameter name="ldap.champs.

    supannEtuId

    displayName"

    Parameter name="ldap.champs.

    givenName"

    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 :

    • login
    • nom d'affichage
    • mail
    • sn
    • cn
    • civilité
    • champs contenant le numéro d'étudiant
    • prénom

     


    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.smtpPort"

    Parameter name="mail.from"

    Parameter name="mail.from.noreply"

    Parameter name="mail.to"

    Paramètres pour l'envoi de mail, respectivement :

    • host smtp
    • port smtp (optionnel, par défaut 25)
    • champs from du mail pour les messages d'envoi d'erreur (log)
    • champs from du mail pour les messages d'envoi aux candidats et gestionnaire
    • champs to du mail pour la réception des messages de log

    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"

    Parameter name="file.cmis.enableVersioning" (nouveau en 2.2.3)

    Paramètres de dématérialisation (solution CMIS), respectivement :

    • url d'accès au webservice de votre ged (ex : https://ged.univ.fr/nuxeo/atom/cmis)
    • repository (ex ; default)
    • user : utilisateur déclaré dans votre ged ayant les droits de création/modification/suppression de documents par web services
    • mot de passe du user
    • identifiant de l'espace de stockage pour les candidats
    • identifiant de l'espace de stockage pour les gestionnaires
    • boolean optionnel permettant d'activer le versioning (version mineure) pour la création de fichiers
    Avertissement

    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 :

    • path du répertoire de stockage pour les candidats (ex :  /home/home-j2ee/tomcat-eCandidat/work/fichiers/candidat/)
    • path du répertoire de stockage pour les gestionnaires (ex :  /home/home-j2ee/tomcat-eCandidat/work/fichiers/gestionnaires/)
    Avertissement

    Attention : si vous renseignez ces informations, vous ne DEVEZ pas renseigner les paramètres de dématérialisation (solution CMIS)

    Attention : lorsque vous déclarez un répertoire, il faut un slash à la fin du path.


    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 :

    • L'url du piwik installé dans votre établissement
    • L'id du projet piwik
    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

    Parameter name="pushTransportMode"

    Paramétrage optionnel qui permet de spécifier le mode de push. 3 valeur possible : websocket, websocket-xhr ou long-polling. Par défaut websocket.

    websocket : toutes les communications passent par une websocket

    websocket-xhr : Websockets dans le sens serveur-->client, XHR dans le sens client–>server

    long-polling : HTTP long polling

    Parameter name="sessionTimeOut"

    Paramètre optionnel qui permet de régler le timeout de session en secondes (par défaut 2700 secondes = 45 minutes).

    Un timeout à -1 implique que la session n'expire jamais.

    Parameter name="logMode"

    Paramétrage optionnel du niveau de log. Par défaut le niveau de log est à info

    3 valeurs possibles :

    • debug : niveau très succinct de log, seules les actions volontairement debugguées (OPI par exemple) seront ajoutées en plus des infos
    • trace : permet de logguer les entrées et les sorties de méthode ainsi que le user ayant lancé cette méthode. Certaines classes ne sont pas tracées (loadBalancing, cache, batch, ...)
    • traceFull : permet de logguer les entrées et les sorties de méthode, le user ayant lancé cette méthode ainsi que les objets renvoyés lors de la sortie. Toutes les classes sont tracées.
    Parameter name="mail.to.fonctionnel"

    Paramétrage optionnel de l'adresse mail permettant de recevoir les messages d'erreur non technique.

    Pour l'instant uniquement utilisé pour recevoir les éventuels messages d'incohérences d'insertion d'OPI

    Parameter name="clamAV.ip"

    Parameter name="clamAV.port"

    Paramétrage optionnel de l'antivirus ClamAV (https://www.clamav.net/) pour le scan des pièces dématérialisées :

    • Ip de ClamAV
    • Port de ClamAV
    Parameter name="enableDeleteFileManuallyBatchDestruct"

    Paramétrage optionnel. Valeur à "true" ou "false". Par défaut à "false"

    Utilisé pour le batch de destruction de dossier.

    S'il y a trop de fichiers à supprimer lors de la destruction des dossiers, il peut être préférable de les supprimer à la main directement sur le serveur de fichier.

    Ce témoin active ou désactive la destruction des fichiers automatiquement :

    true = Les fichiers candidats doivent être supprimés à la main

    false = Les fichiers candidats sont supprimés automatiquement

    Parameter name="enableDeleteRootFolderManuallyBatchDestruct"

    Paramétrage optionnel. Valeur à "true" ou "false". Par défaut à "false"

    Utilisé pour le batch de destruction de dossier.

    Indique si vous souhaitez supprimer le dossier root de la campagne en cours de suppression ({file.filesystem.candidat.path}/Code Campagne/) pour les fichiers candidats à la main.

    true =Le dossier racine de campagne doit être supprimé à la main

    false =Le dossier racine de campagne est supprimé automatiquement

    Parameter name="pdf.signature.keystore.path"

    Parameter name="pdf.signature.pass"

    Paramètres optionnels permettant d'activer l'ajout de signature électronique dans les PDF générés par l'application.

    Si les 2 paramètres sont renseignés, l'application tentera d'ajouter la signature électronique.

    Parameter name="enableExportAutoSizeColumn"Active/Desactive l'autosizing des colonnes pour les exports excel, par defaut true

    Paramètres complémentaires pour un environnement en Load Balancing

    Avertissement

    Attention : ne renseignez surtout pas ces informations si vous ne faites pas de load balancing

    Avertissement

    Attention, dans cette configuration vous devrez avoir :

    • Une instance de l'application dédiée aux gestionnaires. Cette instance ne peut pas être en mode load balancing. Cette instance aura une url propre. Exemple : http://eCandidat-gest.univ.fr
    • Différentes instances de l'application dédiées aux candidats en mode load balancing. Ces instances auront la même url. Exemple : http://eCandidat.univ.fr
    • Lors de chaque nouvelle installation, il est impératif de lancer une première fois l'application "Gestionnaire" en premier
    • Pour les établissement utilisant la dématérialisation en mode "File System", il est nécessaire d'utiliser un répertoire partagé entre toutes les instances de l'application

    ...

    Renseigné à "true" si il s'agit de l'instance gestionnaire.

    Renseigné à "false" si il s'agit d'une instance candidat

    ...

    Identifiant de l'instance, par exemple "1", "2", "3", etc...

    Attention, toutes les instances devront avoir un id différent.

    Préconisation :

    • donner à l'instance gestionnaire l'id "1"
    • donner aux instances candidat les id "2", puis "3", etc.. suivant le nombre de machines en load balancing.

    ...

    Obligatoire pour l'instance gestionnaire. Non utilisé pour l'instances candidat et donc facultative.

    Il s'agit de l'url de l'application côté candidat.

    ...

    Par défaut 600000 (soit 10 minutes).

    Permet de régler (en millisecondes) la fréquence de rafraîchissement des données en cache. Voir : 2. Limitations du mode load-balancing#2.Limitationsdumodeload-balancing-Rafraîchissementdesdonnéesencache

    Si vous modifiez ce paramètre faites attention à ne pas mettre une fréquence de rafraîchissement trop courte ou trop longue.

    Parameter name="enableScanExtension"Active/Desactive la vérification d'extension des fichiers déposés : par défaut true
    Parameter name="externalMessage"

    Paramètre optionnel depuis la version 2.4.0 : ne pas l'ajouter si vous n'en avez pas l'utilité

    Permet de configurer un fichier .properties externe de message

    Parameter name="hideMenu"

    Paramètre optionnel depuis la version 2.4.0 : ne pas l'ajouter si vous n'en avez pas l'utilité

    Permet de masquer certains menus sauf pour les admins (par défaut : aucun menu masqué). Pour connaitre le nom du menu, utiliser l'url du celui ci (ex: scolParametreView,scolDroitMenu)

    Parameter name="hideSiScol"

    Paramètre optionnel depuis la version 2.4.0 : ne pas l'ajouter si vous n'en avez pas l'utilité

    Permet de masquer les éléments de saisie SiScol (par défaut false) : Code OPI dans fenêtre candidature, CGE + liaison Siscol pour la formation, login + CGE pour les gestionnaires, Code Sicol pour les PJ

    Parameter name="odfColonne"

    Paramètre optionnel depuis la version 2.4.0 : ne pas l'ajouter si vous n'en avez pas l'utilité

    Permet de configurer les colonnes visibles et la largeur de celles-ci dans l'offre de formation (par défaut toutes les colonnes affichées)
    Exemple : motCle:200;url:300;date:200;modeCand:100 : affichera les colonnes mot clé de largeur 200px, url 300px, date 200px et mode candidature 100px
    La colonne titre s'affiche toujours. Pour cacher la colonne mot clé et mode candidature, utilisez cette syntaxe : url:300;date:200

    Paramètres complémentaires pour un environnement en Load Balancing

    Avertissement

    Attention : ne renseignez surtout pas ces informations si vous ne faites pas de load balancing


    Avertissement

    Attention, dans cette configuration vous devrez avoir :

    • Une instance de l'application dédiée aux gestionnaires. Cette instance ne peut pas être en mode load balancing. Cette instance aura une url propre. Exemple : http://eCandidat-gest.univ.fr
    • Différentes instances de l'application dédiées aux candidats en mode load balancing. Ces instances auront la même url. Exemple : http://eCandidat.univ.fr
    • Lors de chaque nouvelle installation, il est impératif de lancer une première fois l'application "Gestionnaire" en premier
    • Pour les établissement utilisant la dématérialisation en mode "File System", il est nécessaire d'utiliser un répertoire partagé entre toutes les instances de l'application


    PropriétéDéfinition
    Parameter name="load.balancing.gestionnaire.mode"

    Renseigné à "true" si il s'agit de l'instance gestionnaire.

    Renseigné à "false" si il s'agit d'une instance candidat

    Parameter name="load.balancing.candidat.id.instance"

    Identifiant de l'instance, par exemple "1", "2", "3", etc...

    Attention, toutes les instances devront avoir un id différent.

    Préconisation :

    • donner à l'instance gestionnaire l'id "1"
    • donner aux instances candidat les id "2", puis "3", etc.. suivant le nombre de machines en load balancing.
    Parameter name="load.balancing.candidat.url"

    Obligatoire pour l'instance gestionnaire. Non utilisé pour l'instances candidat et donc facultative.

    Il s'agit de l'url de l'application côté candidat.

    Parameter name="load.balancing.refresh.fixedRate"

    Par défaut 600000 (soit 10 minutes).

    Permet de régler (en millisecondes) la fréquence de rafraîchissement des données en cache. Voir : 2. Limitations du mode load-balancing#2.Limitationsdumodeload-balancing-Rafraîchissementdesdonnéesencache

    Si vous modifiez ce paramètre faites attention à ne pas mettre une fréquence de rafraîchissement trop courte ou trop longue.

    Exemple :

    Instance gestionnaire :

    <Parameter name="load.balancing.gestionnaire.mode" value="true" />
    <Parameter name="load.balancing.candidat.id.instance" value="1" />
    <Parameter name="load.balancing.candidat.url" value="http://eCandidat.univ.fr" />

    Instance candidat 1 :

    <Parameter name="load.balancing.gestionnaire.mode" value="false" />
    <Parameter name="load.balancing.candidat.id.instance" value="2" />

    Instance candidat 2 :

    <Parameter name="load.balancing.gestionnaire.mode" value="false" />
    <Parameter name="load.balancing.candidat.id.instance" value="3" />

    etc....

     

    2.3 Paramétrage des webservices Apogée

    L'application 2.4.0 est livrée avec la version 5.30.50 des Web Services de l'Amue. L'application a été testée avec le patch APOGEE 5.30.52. Nous ne garantissons le fonctionnement de l'application qu'avec ces versions.

    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 :

    • État
      colourBlue
      titleSolution 1
       : dans /WEB-INF/classes/
    • État
      colourBlue
      titleSolution 2
       : dans /src/main/resources/

    Renseigner les url de vos webservices utilisés dans l'application :

    Bloc de code
    languagebash
    themeEclipse
    titleUrl 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
 
# URL du Services Apogee-PJ
pj.urlService=http://wsapogee.univ.fr/services/PJ

# URL des Services Apogee-OPI
pjOpiMetier.urlService=http://wsapogee.univ.fr/services/amue_apo_pjopi
pjOpiMetier.urlService.ssl=https://wsapogee.univ.fr/services/amue_apo_pjopi

# URL du service de vérification d'INES
checkInes.urlService=http://wsines.univ.fr/services/checkine


    Info
    titleInfo

    SI vous avez des erreurs au niveau des dates sur les WebServices, par exemple : "java.sql.SQLDataException: ORA-01843: not a valid month", il faut que vous lanciez vos WS en rajoutant dans le java_opts  -Duser.language=fr -Duser.region=FR sur le lanceur tomcat (/etc/init.d) des ws

    2.4 Paramétrage des webservices Pégase

    Copier le fichier configUrlServicesPegase.sample.properties et renommer le en configUrlServicesPegase.properties puis éditer le. Suivant le choix de la solution dans la partie 2.1 (2. Installation initiale#2.Installationinitiale-2.1Sources), le fichier configUrlServicesPegase.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 :

    Bloc de code
    titleUrl WebServices Pégase
    # Url Authentification
auth.url = https://authn-app.univ.fr/cas/v1/tickets/
 
# Url Ref
ref.url = https://ref.univ.fr/api/v1/ref/
 
# Url Ins
ins.url = https://ins.univ.fr/api/v5/ins/
 
# Url Mof
mof.url = https://mof.univ.fr/api/v1/mof/
 
# Url Cof
cof.url = https://cof.univ.fr/api/cof/v3-draft/
 
# Url Coc
coc.url = https://coc.univ.fr/api/coc/publication/v1/

    2.5 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

    Installation à partir de la version 2.5.0

    2.1 Sources

    2.1.1 Solution 1 : Installation rapide

    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://github.com/EsupPortail/esup-ecandidat/releases

    2.1.2 Solution 2 : Installation personnalisée

    Les étapes spécifiques à cette solution seront notées SOLUTION 2 dans le reste du document.

    2.2 Paramétrage de l'application

    Vous avez deux possibilités pour paramétrer votre application :

    2.2.1 Utilisez les ressources JNDI du serveur tomcat

    • 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 :
      • État
        colourBlue
        titleSolution 1
         : dans META-INF/
      • État
        colourBlue
        titleSolution 2
         : dans /src/main/webapp/META-INF/
    • Renseigner chaque propriété ou laisser les vide si vous n'en avez pas l’utilité

    2.2.2 Utilisez un fichier de properties

    Info
    titleNouveau

    Depuis la version 2.5.0, il est possible d'utiliser un fichier de properties

    Pour utiliser un fichier de properties à la place des ressources JNDI vous devrez obligatoirement indiquer le chemin de ce fichier properties lors du lancement du tomcat comme paramètre "config.location" de la JVM.

    Vous trouverez un exemple de ce fichier properties dans le répertoire configuration : application.sample.properties

    Par exemple :

    • En ligne de commande : -Dconfig.location=/home/eCandidat/fichier/application.properties
    • Dans le fichier env de votre tomcat : set CATALINA_OPTS=%CATALINA_OPTS% -Dconfig.location=/home/eCandidat/fichier/application.properties

    2.2.3 Paramétrage disponible

    2.2.3.1 Configuration des ressources externes
    Ancre
    ressources-externes
    ressources-externes

    PropriétéDéfinition

    external.ressource

    Paramètre optionnel : Vous pouvez déclarer le dossier contenant les ressources externes de votre application (utilisé dans 3. Personnalisation)

    Info

    Les ressources externes sont un dossier qui peut être placé sur le serveur et qui permet de s'affranchir de devoir replacer les contenus personnalisés de l'établissement à chaque installation.

    Les fichiers concernés par les ressources externes sont : 

    • Dossier "front" - le contenu statique : 
      • logo.png
      • favicon.icon
    • Dossier "i18n" - fichier personnalisé de message : 
      • messages.properties
    • Dossier "siscol" - fichiers de configuration des WebServices SiScol : 
      • Fichier de configuration des url Apogée
      • Fichier de configuration des url Pégase
    • Dossier "template" - fichiers de templates : 
      • Dossier candidat
      • Lettre d'admission
      • Lettre de refus
      • Lettres de refus spécifiques par type de diplôme

    Attention, il n'est pas possible d'externaliser le fichier "styles.scss" puisque celui-ci est utilisé à la compilation pour générer le fichier de style de l'application. 

    Le dossier des ressources externes devra avoir cette arborescence : 

    Image Added

    Vous pouvez placer tous les fichiers ou seulement une partie dans chaque dossier.

    2.2.3.2 Configuration des bases de données  

    2.2.3.2.1 Avec les ressources JNDI du serveur tomcat
    PropriétéDéfinition
    jdbc/dbEcandidat

    Déclaration de votre base de données MySql de eCandidat

    Voir context.sample.xml

    jdbc/dbSiScol"

    Déclaration de votre base de données Apogée (pour le requêtage direct sur la base)

    A supprimer si vous utilisez Pégase

    Voir context.sample.xml

    2.2.3.2.2 Avec un fichier properties
    PropriétéDéfinition
    datasource.ecandidat.url
    datasource.ecandidat.username
    datasource.ecandidat.password
    datasource.ecandidat.driver-class-name
    datasource.ecandidat.properties.max-pool-size
    datasource.ecandidat.properties.test-query

    Déclaration de votre base de données MySql de eCandidat

    Voir application.sample.properties

    datasource.apogee.url
    datasource.apogee.username
    datasource.apogee.password
    datasource.apogee.driver-class-name
    datasource.apogee.properties.max-pool-size
    datasource.apogee.properties.test-query

    Déclaration de votre base de données Apogée (pour le requêtage direct sur la base)

    A supprimer si vous utilisez Pégase

    Voir application.sample.properties

    2.2.3.3 Autre paramétrage

    PropriétéDéfinition
    siscol.implementation

    Implémentation du service SiScol à utiliser.

    • Si vous voulez utilisez Apogée ainsi que ses WebServices, laissez celui par défaut : siScolApogeeWSServiceImpl
    • Si vous utilisez Pégase  ainsi que ses WebServices, utilisez la valeur "siScolPegaseWSServiceImpl"
    • Si vous n'utilisez ni Apogée, ni Pégase, le paramètre doit être placé à siScolDefaultServiceImpl
    siscol.default

    Paramètre obligatoire depuis la version 2.4.0 : Indiquez le type de SiScol présent dans votre base de données à la première exécution :

    • Si vous aviez Apogée, indiquez "A"
    • Si vous aviez Pégase, indiquez "P"
    • Ni Pégase, ni Apogée, indiquez "D"
    • Si c'est une installation initiale, indiquez le future SiScol utilisé
    app.urlUrl de l'application
    cas.urlUrl de votre service d'authentification CAS

    pegase.ws.username
    pegase.ws.password

    		Version Pégase : Informations d'authentification de l'utilisateur ayant les droits de réaliser les appels WS sur Pégase
    pegase.etablissementVersion Pégase : Code de l'établissement racine dans Pégase
    pegase.opi.pathVersion Pégase : Chemin vers un dossier sur le serveur où les fichiers d'OPI seront générés

    assistance.documentation.url

    assistance.documentation.url.candidat

    assistance.documentation.url.candidat.en

    assistance.helpdesk.url

    assistance.contact.mail

    assistance.contact.url

    Informations d'assistance, respectivement :

    • page de documentation pour les gestionnaires,
    • page de documentation pour les candidats,
    • page de documentation pour les candidats en anglais,
    • lien vers le helpdesk de l'établissement pour les gestionnaires,
    • adresse de contact pour l'application
    • url de contact pour l'application

    ldap.base

    ldap.url

    ldap.branche.people

    ldap.user

    ldap.pwd

    Informations de connexion au ldap, respectivement :

    • base du ldap (ex : dc=univ,dc=fr)
    • url du ldap et son port  (ex : ldaps://ldap.univ.fr:636)
    • accès à la branche people (ex : ou=people)
    • user du ldap
    • mot de passe du user

    ldap.champs.uid

    ldap.champs.displayName

    ldap.champs.mail

    ldap.champs.sn

    ldap.champs.cn

    ldap.champs.supannCivilite

    ldap.champs.supannEtuId

    ldap.champs.givenName

    Champs utilisés dans le ldap, respectivement :

    • login
    • nom d'affichage
    • mail
    • sn
    • cn
    • civilité
    • champs contenant le numéro d'étudiant
    • prénom


    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.

    admin.techniqueLogin de l'admin technique

    mail.smtpHost

    mail.smtpPort

    mail.from

    mail.from.noreply

    mail.to

    Paramètres pour l'envoi de mail, respectivement :

    • host smtp
    • port smtp (optionnel, par défaut 25)
    • champs from du mail pour les messages d'envoi d'erreur (log)
    • champs from du mail pour les messages d'envoi aux candidats et gestionnaire
    • champs to du mail pour la réception des messages de log

    file.cmis.atompub.url

    file.cmis.repository

    file.cmis.user

    file.cmis.pwd

    file.cmis.candidat.id

    file.cmis.gestionnaire.id

    file.cmis.enableVersioning (nouveau en 2.2.3)

    Paramètres de dématérialisation (solution CMIS), respectivement :

    • url d'accès au webservice de votre ged (ex : https://ged.univ.fr/nuxeo/atom/cmis)
    • repository (ex ; default)
    • user : utilisateur déclaré dans votre ged ayant les droits de création/modification/suppression de documents par web services
    • mot de passe du user
    • identifiant de l'espace de stockage pour les candidats
    • identifiant de l'espace de stockage pour les gestionnaires
    • boolean optionnel permettant d'activer le versioning (version mineure) pour la création de fichiers
    Avertissement

    Attention : si vous renseignez ces informations, vous ne DEVEZ pas renseigner les paramètres de dématérialisation (solution FileSystem)


    file.filesystem.candidat.path

    file.filesystem.gestionnaire.path

    Paramètres de dématérialisation (solution FileSystem), respectivement :

    • path du répertoire de stockage pour les candidats (ex :  /home/home-j2ee/tomcat-eCandidat/work/fichiers/candidat/)
    • path du répertoire de stockage pour les gestionnaires (ex :  /home/home-j2ee/tomcat-eCandidat/work/fichiers/gestionnaires/)
    Avertissement

    Attention : si vous renseignez ces informations, vous ne DEVEZ pas renseigner les paramètres de dématérialisation (solution CMIS)

    Attention : lorsque vous déclarez un répertoire, il faut un slash à la fin du path.


    limesurvey.path

    limesurvey.user

    limesurvey.pass

    Paramètres pour accéder aux webservices LimeSurvey, respectivement :

    batch.fixedRateFréquence de vérification de la table des batchs de l'application (en ms)

    piwikAnalytics.trackerUrl

    piwikAnalytics.siteId

    Paramètres de piwik, optionnel (https://fr.piwik.org/), respectivement :

    • L'url du piwik installé dans votre établissement
    • L'id du projet piwik
    demoModeMode démo. Doit être à false

    enablePush

    		Activation du push. Doit être à true

    pushTransportMode

    Paramétrage optionnel qui permet de spécifier le mode de push. 3 valeur possible : websocket, websocket-xhr ou long-polling. Par défaut websocket.

    websocket : toutes les communications passent par une websocket

    websocket-xhr : Websockets dans le sens serveur-->client, XHR dans le sens client–>server

    long-polling : HTTP long polling

    sessionTimeOut

    Paramètre optionnel qui permet de régler le timeout de session en secondes (par défaut 2700 secondes = 45 minutes).

    Un timeout à -1 implique que la session n'expire jamais.

    logMode

    Paramétrage optionnel du niveau de log. Par défaut le niveau de log est à info

    3 valeurs possibles :

    • debug : niveau très succinct de log, seules les actions volontairement debugguées (OPI par exemple) seront ajoutées en plus des infos
    • trace : permet de logguer les entrées et les sorties de méthode ainsi que le user ayant lancé cette méthode. Certaines classes ne sont pas tracées (loadBalancing, cache, batch, ...)
    • traceFull : permet de logguer les entrées et les sorties de méthode, le user ayant lancé cette méthode ainsi que les objets renvoyés lors de la sortie. Toutes les classes sont tracées.
    mail.to.fonctionnel

    Paramétrage optionnel de l'adresse mail permettant de recevoir les messages d'erreur non technique.

    Pour l'instant uniquement utilisé pour recevoir les éventuels messages d'incohérences d'insertion d'OPI

    clamAV.ip

    clamAV.port

    Paramétrage optionnel de l'antivirus ClamAV (https://www.clamav.net/) pour le scan des pièces dématérialisées :

    • Ip de ClamAV
    • Port de ClamAV
    enableDeleteFileManuallyBatchDestruct

    Paramétrage optionnel. Valeur à "true" ou "false". Par défaut à "false"

    Utilisé pour le batch de destruction de dossier.

    S'il y a trop de fichiers à supprimer lors de la destruction des dossiers, il peut être préférable de les supprimer à la main directement sur le serveur de fichier.

    Ce témoin active ou désactive la destruction des fichiers automatiquement :

    true = Les fichiers candidats doivent être supprimés à la main

    false = Les fichiers candidats sont supprimés automatiquement

    enableDeleteRootFolderManuallyBatchDestruct

    Paramétrage optionnel. Valeur à "true" ou "false". Par défaut à "false"

    Utilisé pour le batch de destruction de dossier.

    Indique si vous souhaitez supprimer le dossier root de la campagne en cours de suppression ({file.filesystem.candidat.path}/Code Campagne/) pour les fichiers candidats à la main.

    true =Le dossier racine de campagne doit être supprimé à la main

    false =Le dossier racine de campagne est supprimé automatiquement

    pdf.signature.keystore.path

    pdf.signature.pass

    Paramètres optionnels permettant d'activer l'ajout de signature électronique dans les PDF générés par l'application.

    Si les 2 paramètres sont renseignés, l'application tentera d'ajouter la signature électronique.

    enableExportAutoSizeColumnActive/Desactive l'autosizing des colonnes pour les exports excel, par defaut true
    enableScanExtensionActive/Desactive la vérification d'extension des fichiers déposés : par défaut true
    externalMessage

    Paramètre optionnel depuis la version 2.4.0 : ne pas l'ajouter si vous n'en avez pas l'utilité

    Permet de configurer un fichier .properties externe de message

    hideMenu

    Paramètre optionnel depuis la version 2.4.0 : ne pas l'ajouter si vous n'en avez pas l'utilité

    Permet de masquer certains menus sauf pour les admins (par défaut : aucun menu masqué). Pour connaitre le nom du menu, utiliser l'url du celui ci (ex: scolParametreView,scolDroitMenu)

    hideSiScol

    Paramètre optionnel depuis la version 2.4.0 : ne pas l'ajouter si vous n'en avez pas l'utilité

    Permet de masquer les éléments de saisie SiScol (par défaut false) : Code OPI dans fenêtre candidature, CGE + liaison Siscol pour la formation, login + CGE pour les gestionnaires, Code Sicol pour les PJ

    odfColonne

    Paramètre optionnel depuis la version 2.4.0 : ne pas l'ajouter si vous n'en avez pas l'utilité

    Permet de configurer les colonnes visibles et la largeur de celles-ci dans l'offre de formation (par défaut toutes les colonnes affichées)
    Exemple : motCle:200;url:300;date:200;modeCand:100 : affichera les colonnes mot clé de largeur 200px, url 300px, date 200px et mode candidature 100px
    La colonne titre s'affiche toujours. Pour cacher la colonne mot clé et mode candidature, utilisez cette syntaxe : url:300;date:200

    2.2.3.4 Paramètres complémentaires pour un environnement en Load Balancing


    Avertissement

    Attention : ne renseignez surtout pas ces informations si vous ne faites pas de load balancing


    Avertissement

    Attention, dans cette configuration vous devrez avoir :

    • Une instance de l'application dédiée aux gestionnaires. Cette instance ne peut pas être en mode load balancing. Cette instance aura une url propre. Exemple : http://eCandidat-gest.univ.fr
    • Différentes instances de l'application dédiées aux candidats en mode load balancing. Ces instances auront la même url. Exemple : http://eCandidat.univ.fr
    • Lors de chaque nouvelle installation, il est impératif de lancer une première fois l'application "Gestionnaire" en premier
    • Pour les établissement utilisant la dématérialisation en mode "File System", il est nécessaire d'utiliser un répertoire partagé entre toutes les instances de l'application


    PropriétéDéfinition
    load.balancing.gestionnaire.mode

    Renseigné à "true" si il s'agit de l'instance gestionnaire.

    Renseigné à "false" si il s'agit d'une instance candidat

    load.balancing.candidat.id.instance

    Identifiant de l'instance, par exemple "1", "2", "3", etc...

    Attention, toutes les instances devront avoir un id différent.

    Préconisation :

    • donner à l'instance gestionnaire l'id "1"
    • donner aux instances candidat les id "2", puis "3", etc.. suivant le nombre de machines en load balancing.
    load.balancing.candidat.url

    Obligatoire pour l'instance gestionnaire. Non utilisé pour l'instances candidat et donc facultative.

    Il s'agit de l'url de l'application côté candidat.

    load.balancing.refresh.fixedRate

    Par défaut 600000 (soit 10 minutes).

    Permet de régler (en millisecondes) la fréquence de rafraîchissement des données en cache. Voir : 2. Limitations du mode load-balancing#2.Limitationsdumodeload-balancing-Rafraîchissementdesdonnéesencache

    Si vous modifiez ce paramètre faites attention à ne pas mettre une fréquence de rafraîchissement trop courte ou trop longue.

    Exemple :

    Instance gestionnaire :

    <Parameter name="load.balancing.gestionnaire.mode" value="true" />
    <Parameter name="load.balancing.candidat.id.instance" value="1" />
    <Parameter name="load.balancing.candidat.url" value="http://eCandidat.univ.fr" />

    Instance candidat 1 :

    <Parameter name="load.balancing.gestionnaire.mode" value="false" />
    <Parameter name="load.balancing.candidat.id.instance" value="2" />

    Instance candidat 2 :

    <Parameter name="load.balancing.gestionnaire.mode" value="false" />
    <Parameter name="load.balancing.candidat.id.instance" value="3" />

    etc....

    2.3 Paramétrage des webservices SiScol

    2.3.1 Paramétrage des webservices Apogée

    Info
    titleAstuce

    Plutôt que de copier ce fichier avant l'installation, vous pouvez le placer directement dans le dossier des ressources externes sur le serveur (voir Ressources externes) et vous affranchir de cette étape pour les futures installations.

    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 :

    Info
    titleUrl 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
      
    # URL du Services Apogee-PJ
    pj.urlService=http://wsapogee.univ.fr/services/PJ
     
    # URL des Services Apogee-OPI
    pjOpiMetier.urlService=http://wsapogee.univ.fr/services/amue_apo_pjopi
    pjOpiMetier.urlService.ssl=https://wsapogee.univ.fr/services/amue_apo_pjopi
     
    # URL du service de vérification d'INES
    checkInes.urlService=http://wsines.univ.fr/services/checkine


    Info

    SI vous avez des erreurs au niveau des dates sur les WebServices, par exemple : "java.sql.SQLDataException: ORA-01843: not a valid month", il faut que vous lanciez vos WS en rajoutant dans le java_opts  -Duser.language=fr -Duser.region=FR sur le lanceur tomcat (/etc/init.d) des ws

    2.3.2 Paramétrage des webservices Pégase

    Info
    titleAstuce

    Plutôt que de copier ce fichier avant l'installation, vous pouvez le placer directement dans le dossier des ressources externes sur le serveur (voir Ressources externes) et vous affranchir de cette étape pour les futures installations.

    Copier le fichier configUrlServicesPegase.sample.properties et renommer le en configUrlServicesPegase.properties puis éditer le. Suivant le choix de la solution dans la partie 2.1 (2. Installation initiale#2.Installationinitiale-2.1Sources), le fichier configUrlServicesPegase.sample.properties se trouve :

    • SOLUTION 1 : dans /WEB-INF/classes/
    • SOLUTION 2 : dans /configuration/siscol/

    Renseigner les url de vos webservices utilisés dans l'application :

    Info
    titleUrl WebServices Pégase

    # Url Authentification
    auth.url = https://authn-app.univ.fr/cas/v1/tickets/
      
    # Url Ref
    ref.url = https://ref.univ.fr/api/v1/ref/
      
    # Url Ins
    ins.url = https://ins.univ.fr/api/v5/ins/
      
    # Url Mof
    mof.url = https://mof.univ.fr/api/v1/mof/
      
    # Url Cof
    cof.url = https://cof.univ.fr/api/cof/v3-draft/
      
    # Url Coc
    coc.url = https://coc.univ.fr/api/coc/publication/v1/

    Exemple :

    Instance gestionnaire :

    <Parameter name="load.balancing.gestionnaire.mode" value="true" />
    <Parameter name="load.balancing.candidat.id.instance" value="1" />
    <Parameter name="load.balancing.candidat.url" value="http://eCandidat.univ.fr" />

    Instance candidat 1 :

    <Parameter name="load.balancing.gestionnaire.mode" value="false" />
    <Parameter name="load.balancing.candidat.id.instance" value="2" />

    Instance candidat 2 :

    <Parameter name="load.balancing.gestionnaire.mode" value="false" />
    <Parameter name="load.balancing.candidat.id.instance" value="3" />

    etc....

    2.3 Paramétrage des webservices Apogée

    L'application 2.3.0 est livrée avec la version 5.20.la des Web Services de l'Amue. L'application a été testée avec le patch APOGEE 5.20.00. Nous ne garantissons le fonctionnement de l'application qu'avec ces versions.

    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 :

    ...

    État
    colourBlue
    titleSolution 2

    ...

    Renseigner les url de vos webservices utilisés dans l'application :

    Bloc de code
    languagebash
    themeEclipse
    titleUrl 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
 
# URL du Services Apogee-PJ
pj.urlService=http://wsapogee.univ.fr/services/PJ

# URL des Services Apogee-OPI
pjOpiMetier.urlService=http://wsapogee.univ.fr/services/amue_apo_pjopi
pjOpiMetier.urlService.ssl=https://wsapogee.univ.fr/services/amue_apo_pjopi

# URL du service de vérification d'INES
checkInes.urlService=http://wsines.univ.fr/services/checkine
    Info
    titleInfo

    SI vous avez des erreurs au niveau des dates sur les WebServices, par exemple : "java.sql.SQLDataException: ORA-01843: not a valid month", il faut que vous lanciez vos WS en rajoutant dans le java_opts  -Duser.language=fr -Duser.region=FR sur le lanceur tomcat (/etc/init.d) des ws

    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