Table des matières
----
Configuration d'hibernate
Configuration en JDBC
Si vous vous connectez à votre base avec JDBC, configurez les données ci-dessous :
hibernate.connection.driver_class
C'est la classe hibernate pour communiquer avec la base de données
- pour mySQL (par défaut), utiliser com.mysql.jdbc.Driver
- pour Oracle, utiliser oracle.jdbc.OracleDriver (choisir le pilote pour la base appropriée)
hibernate.dialect
Le dialecte à utiliser pour interroger la base de données (InnoDB ou autres)
- pour MySQL (par défaut), utiliser org.hibernate.dialect.MySQLInnoDBDialect
- pour Oracle, utiliser org.hibernate.dialect.Oracle10gDialect
hibernate.connection.jdbc.url
Il s'agit de l'url à laquelle se trouvent les fichiers de la base de données
hibernate.connection.jdbc.username
Le nom d'utilisateur à fournir pour que l'application puisse se connecter à la base de données
hibernate.connection.jdbc.password
Le mot de passe associé au nom d'utilisateur précité
hibernate.useJndi=false
placé à false car il s'agit d'une connexion directe JDBC
Configuration en JNDI
Si vous vous connectez à votre base via un pool de connexion JNDI, il faut configurer les données de cette manière :
hibernate.useJndi=true
placé à true, la connexion va s'effectuer via une pool de connexion JNDI (installée sur le tomcat)
hibernate.connection.jndi.datasource=jdbc/opi
Il s'agit de l'url de la source de données employée par JNDI. (par exemple jdbc/opi)
Il faut configurer le fichier server.xml de votre tomcat pour définir la ressource JDNI et les paramètres de connexion à la base dans le contexte de votre application :
<Context path="/candidatures" docBase="{chemin absolu de l'application}" reloadable="false" debug="0"> <Resource name="jdbc/opi" auth="Container" type="javax.sql.DataSource" username="{db_user}" password="{db_password}" driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://{hôte de la base}:{port}/{nom de la base}" validationQuery="SELECT 1 FROM dual" maxActive="100" maxIdle="10" maxWait="10000" removeAbandoned="true" removeAbandonedTimeout="60" logAbandoned="true"/> </Context>
pour la propriété driverClassName, se référer à la configuration JDBC hibernate.connection.driver_class
Configuration de l'authentification
cas.url
Tout simplement l'URL du CAS à employer pour s'authentifier. Attention cependant à ne pas laisser traîner de slash à la fin de l'URL.
Configuration de la gestion d'exceptions
exceptionHandling.logLevel
Le niveau de logging (une valeur parmi TRACE, DEBUG, INFO, WARN, ERROR ou FATAL) :
- TRACE note absolument tout ce qui se passe dans l'application
- DEBUG note toutes les informations nécessaires au débuggage
- INFO note l'essentiel de l'activité de l'application
- WARN note uniquement les erreurs et avertissements
- ERROR ne note que les erreurs
- FATAL ne note que les erreurs critiques
exceptionHandling.email
Il s'agit de l'adresse e-mail à laquelle les rapports d'exceptions seront envoyés (donc de préférence l'adresse de la personne chargée d'entretenir l'application).
Configuration des données d'initialisation
Configurations globales de l'application
init.firstAdministratorId
L'identifiant LDAP du premier administrateur de l'application. Il s'agit de son login de connexion. Celui-ci est ensuite récupéré dans LDAP lors de la tâche ant init-data et sert à établir les informations nécessaires à la création du premier administrateur.
init.codEtbInt
Il s'agit du code établissement tel qu'il est connu dans Apogee.
init.codDacEtr
Le code diplôme autre cursus (DAC) employé dans Apogee pour identifier les cursus des étudiants étrangers
init.codStudent.regex=e([0-9]{7})
Substitution du premier caractère du code étudiant par « e » pour conformité avec les caractéristiques du login étudiant de l'établissement : « e »+7 dernier caractères du code étudiant Apogée
init.codStudent.pattern=2\$1
Ajouter s'il n'y est pas (demandé à l'initialisation) --->substitution du « e » contenu dans le login par le caractère « 2 » pour compléter le code étudiant. Cet argument est utilisé lors de l'appel de l'application de type ent; après authentification via le cas étudiant
init.onlyTerminaux
Booléen à renseigner selon :
- true si l'on veut uniquement récupérer le dernier diplôme en date des candidats
- false si l'on veut récupérer l'intégralité de leurs diplômes
init.obtentionDip
Booléen à renseigner selon :
- true si l'on ne prend en compte que les diplômes obtenus
- false si l'on prend aussi en compte le niveau avéré
init.context
le contexte interne à l'application (utilisé pour générer des urls eg. Faq et contact)
init.opiWebService.bean
Nom de bean à renseigner pour le déversement de données dans Apogée
- opiWebService, si l'on veut avoir un déversement des données dans Apogee
- voidOpiWebService, si l'on ne souhaite pas déverser les données dans Apogee.
init.cmi.manager=false
Le nom du responsable de commission est visible par les candidats
init.allViewPJ=true
Booléen à renseigner selon :
- true : les gestionnaires voient toutes les pièces justificative
- false pour les afficher par droit
Récupération d'informations depuis Apogée
init.recupCursus=true
Booléen à renseigner selon :
- true, on récupère les cursus des étudiants de l'établissement depuis Apogée lors de la création du dossier
- false sinon
init.recupBac=true
Booléen à renseigner selon :
- true, on récupère les baccalauréats des étudiants de l'établissement depuis Apogée lors de la création du dossier
- false sinon
init.recupInfos=true
Booléen à renseigner selon :
- true, on récupère les informations personnelles depuis Apogée lors de la création du dossier
- false sinon
Configuration des tâches planifiées
cron.archiveTask=0 30 0 * * ?
Valeur configuration l'exécution de la tâche cron d'archivage par le module Quartz (par défaut tous les jours à 0h30)
Pour voir la syntaxe : http://wiki.opensymphony.com/display/QRTZ1/CronTriggers+Tutorial
Pour ne pas les lancer, mettre 0 en dernier (* * * * * ? 0)
Configuration de la connexion au LDAP
L'application se base sur l'annuaire LDAP pour récupérer des informations lors de la création de gestionnaires et membre de commissions
ldap.url
L'URL du serveur LDAP : ldaps://ldap.univ-ubs.fr:xxx
ldap.userName
Le nom d'utilisateur employé pour se connecter à LDAP =cn=candidature,ou=admin,dc=univ-ubs,dc=fr
ldap.password
Le mot de passe associé au nom d'utilisateur
ldap.base
La base de recherche de LDAP : ldap.base=dc=univ-ubs,dc=fr
ldap.dnSubPath=ou=people
ldap.uidAttribute=uid
ldap.displayNameAttribute=displayName
ldap.emailAttribute=mail
ldap.searchAttribute=cn
ldap.eduPersonPrincipalNameAttribute=eduPersonPrincipalName
ldap.prenomAttribute=givenName
ldap.filterPers=objectClass=person
ldap.nomUsuelAttribute=sn
ldap.attributes=cn,displayName,mail,sn,givenName,eduPersonPrincipalName
ldap.searchDisplayedAttributes=cn,displayName,employeeType,department
Partie SMTP
smtp.host
Le nom de l'hôte ou l'adresse IP du serveur SMTP utilisé pour l'envoi des e-mails
smtp.port
Le port employé par ledit serveur SMTP
smtp.user
Le nom d'utilisateur à employer pour se connecter au serveur SMTP. Laisser vide pour une connexion anonyme.
smtp.password
Le mot de passe à employer pour se connecter au serveur SMTP. Laisser vide pour une connexion anonyme.
smtp.interceptAll
true en test, false en production. Définit s'il faut intercepter tous les e-mails envoyés ou non
smtp.fromEmail
L'adresse e-mail apparaissant dans le champ « De : » des e-mails envoyés par l'application. Fonctionne très bien même si l'adresse n'existe pas
smtp.fromName
Le nom apparaissant dans le champ « De : » des e-mails envoyés par l'application.
smtp.interceptEmail
l'adresse e-mail vers laquelle rediriger les e-mails interceptés (de préférence celle de la personne chargée de mettre le programme en place)
smtp.interceptName
Le nom à afficher dans le champ « pour : » des e-mails interceptés (complètement optionnel)
Partie génération de PDF
xsl_xml.path
L'emplacement des fichiers xml et xsl utilisés pour générer les fichiers PDF (/var/lib/tomcat/candidatures/webapps/candidatures/media/xml-xsl/ )
Partie Orbeon
orbeon.url
L'URL de l'application Orbeon
orbeon.username
Nom d'utilisateur à fournir pour utiliser orbeon
orbeon.password
Mot de passe à fournir pour utiliser orbeon
init.orbeon.uri=xmldb:exist://localhost/esup-opiR1/exist/xmlrpc
Permettre l'extraction des formulaires complémentaires
Partie génération d'URL
urlGeneration.bean
Le bean à utiliser pour générer les URLs.
ServletUrlGenerator pour un déploiement en servlet
uportalUrlGenerator pour un déploiement en portlet
urlGeneration.casLoginUrl
L'URL de login du serveur CAS
à priori, il suffit de remplacer « cas.domain.edu » par l'URL réelle du cas
urlGeneration.servletLoginUrl
L'URL de login pour les utilisateurs authentifiés par CAS. À priori, il suffit de remplacer « exemple.domain.edu » par l'URL d'accès à l'application
urlGeneration.servletGuestUrl
L'URL de login pour les utilisateurs authentifiés par e-mail. À priori, il suffit de remplacer « exemple.domain.edu » par l'URL d'accès à l'application
urlGeneration.uportalFunctionnalName
urlGeneration.uportalLoginUrl
urlGeneration.uportalGuestUrl
Partie web-services ESUP
remote.flushCache.servers
remote.referentiel.url
_url_webservices_esup_ws_si_.fr/xfire/ReadReferentiel?WSDL
remote.enseignement.url
_url_webservices_esup_ws_si_/xfire/ReadEnseignement?WSDL
remote.insertLaisserPasser.url
_url_webservices_esup_ws_si_/xfire/InsertLaisserPasser?WSDL
remote.etudiant.url
_url_webservices_esup_ws_si_/xfire/ReadEtudiant?WSDL
Partie fuseau horaire
timezone
Partie Logging
log.level
log.output
log.file
Partie cache
cache.path
espace sur lequel sera sauvegardé le cache en cas de dépassement du cache en mémoire vive
Partie IAWeb
confirmation.IAWeb.addressIAPrimo
confirmation.IAWeb.addressIAReins
Partie calendrier de candidatures
URL.CalendrierDeCandidature
Pour JNDI :
Copier le fichier webapp/WEB_INF/lib/mysql-connector-java-3.1.12-bin.jar dans le répertoire lib du moteur du tomcat (chez nous en l'occurrence /var/lib/tomcat/tomcat6base/tomcat-6.0.24/lib/)
Dans config.properties :
passer hibernate.useJndi à true
définir le nom de la datasource à utiliser (chez nous : jdbc/opi)