...

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

Table des matières

Configuration de l'accès aux feuilles de style CSS

 mediaPath.servlet=/esup-opiR1/media

Dans le fichier default.properties, ce paramètre est définit à /esup-opiR1/media. Il définit le chemin absolu d'accès aux feuilles de style CSS.

Selon si votre accès diffère, il faut rajouter cette ligne dans le fichier config.properties, par exemple :

• pour l'url : http://localhost:8080/ --> mediaPath.servlet=/media
• pour l'url : http://localhost:8080/ecandidat/ --> mediaPath.servlet=/ecandidat/media

Configuration d'hibernate

Configuration en JDBC

...

Si vous vous connectez à votre base via un pool de connexion JNDI, il faut configurer les données de cette manière avec JDBC, configurez les données ci-dessous :

Bloc de code
hibernate.useJndi=true

...

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)

Bloc de code
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 :

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 MySQL (version 5 ou supérieure), utiliser org.hibernate.dialect.MySQL5InnoDBDialect
• pour Oracle, utiliser org.hibernate.dialect.Oracle10gDialect

Bloc de code
hibernate.connection.jdbc.url

Il s'agit de l'url à laquelle se trouvent les fichiers de la base de données

Bloc de code
hibernate.connection.jdbc.username

Le nom d'utilisateur à fournir pour que l'application puisse se connecter à la base de données

Bloc de code
hibernate.connection.jdbc.password

Le mot de passe associé au nom d'utilisateur précité

Bloc de code
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

<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"
        removeAbandonedusername="true{db_user}" removeAbandonedTimeoutpassword="60{db_password}" logAbandoned="true"/>
</Context>

pour la propriété driverClassName :

• pour mySQL, utiliser com.mysql.jdbc.Driver
• pour Oracle, utiliser oracle.jdbc.OracleDriver

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 :

...

        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 :

• pour mySQL, utiliser com.mysql.jdbc.Driver
• pour Oracle, utiliser oracle.jdbc.OracleDriver

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 de votre établissement tel qu'il est connu dans Apogee.

init.typEtbUniv=00

Il s'agit du code du type d'établissement "Université" tel que défini dans Apogée.

Vous pouvez le trouver dans la partie Référentiel, menu Etablissement / Environnement / Type d'établissement.

Par défaut, le code pour le type d'établissement "Université" est 00.

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

Ce paramètre  s'il est à true permet d'ajouter un Responsable de commission (nom, adressse mail et téléphone) lors de l' ajout ou de la modification d'une commission.

Ces données sont ensuite affichées lorsque l'étudiant consulte le détail d'une formation depuis sa page d'accueil.

init.allViewPJ=true

Booléen à renseigner selon :

• true : les gestionnaires voient toutes les pièces justificative
• false pour les afficher par droit

init.dateBackDefault=21/06/2010

Date de retour de dossier par défaut.

init.prefixCodCalCmi=C

Préfixe du code par défaut.

init.prefixLibCalCmi=Calendrier de

Préfixe du libellé par défaut.

...

Récupération d'informations depuis Apogée

...

ldap.attributes=cn,displayName,mail,sn,givenName,eduPersonPrincipalName

ldap.searchDisplayedAttributes=cn,displayName,employeeType,department

...

Configuration de la connexion au serveur SMTP

smtp.host

Le nom de l'hôte ou l'adresse IP du serveur SMTP utilisé pour l'envoi des e-mails

...

Le nom à afficher dans le champ « pour : » des e-mails interceptés (complètement optionnel)

...

Configuration du module de 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/ )

...

/candidatures/media/xml-xsl/ )

Configuration des services utilisant Orbeon

L'application embarque une application Orbeon pour la gestion de formulaires dynamiques. L'application crée, lit et supprime ces formulaires en se connectant directement à Orbeon par les paramètres suivants :

orbeon.url

L'URL de l'application Orbeon. Il suffit de saisir le nom de votre application. Cette URL sera suffixé dans l'application des paramètres permettant l'accès aux formulaires d'Orbeon

orbeon.username

...

init.orbeon.uri=xmldb:exist://localhost/esup-opiR1/exist/xmlrpc

Permettre Celui-ci permet de définir le chemin de la base exist dédiée à Orbeon , c'est utilisé par l'application pour accéder aux données Orbeon lors de l'extraction des formulaires complémentaires

...

Configuration de la génération d'URL

urlGeneration.bean

...

urlGeneration.servletLoginUrl=http://example.domain.edu/stylesheets/cas/accueil.faces/accueil.faces

Propriété non utilisée. Ne pas en tenir compte.

urlGeneration.servletGuestUrl

Propriété non utilisée par les développeurs. Ne pas en tenir compte.

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.servletGuestUrluportalGuestUrl

Propriété utilisée Propriétés utilisées par les développeurs. Ne pas en tenir compte.

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

Propriétés utilisées par les développeurs. Ne pas en tenir compte.

Partie web-services ESUP

remote.flushCache.servers

La fonctionnalité de vidage du cache des webservices n'étant pas opérationnelle depuis l'application, ne pas prendre en compte.

Voici la liste des paramètres à configurer pour connecter l'application avec les webservices esup-ws-si :

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=Europe/Paris

Définit la propriété timezone à travers l'application.

Partie Logging

log.level=ERROR

Définit le niveau de log (ERROR, INFO ou DEBUG) qui sera écrit.

log.output=logfile

Définit le moyen d'écriture des logs (stdout pour la console, logfile pour un fichier décrit ci-après)

log.file=/data/logs/ecandidat

Définit l'endroit de stockage des fichiers de logs

Partie cache

cache.path=/data/cache/ecandidat

espace sur lequel sera sauvegardé le cache en cas de dépassement du cache en mémoire vive

Partie IAWeb

confirmation.IAWeb.addressIAPrimo=http://_url_site_web_ia_primo_/extern_authent.jsf

URL donnant l'accès au

confirmation.IAWeb.addressIAReinss=http://_url_site_web_ia_/etapes/identification.do

Partie calendrier de candidatures

Configuration de la connexion aux webservices ESUP-WS-SI

remote.flushCache.servers

La fonctionnalité de vidage du cache des webservices n'étant pas opérationnelle depuis l'application, ne pas prendre en compte.

Voici la liste des paramètres à configurer pour connecter l'application avec les webservices esup-ws-si :

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

Configuration du fuseau horaire

timezone=Europe/Paris

Définit la propriété timezone à travers l'application.

Configuration du Logging de l'application

log.level=ERROR

Définit le niveau de log (ERROR, INFO ou DEBUG) qui sera écrit.

log.output=logfile

Définit le moyen d'écriture des logs (stdout pour la console, logfile pour un fichier décrit ci-après)

log.file=/data/logs/ecandidat

Définit l'endroit de stockage des fichiers de logs

Configuration de la gestion du cache

cache.path=/data/cache/ecandidat

espace sur lequel sera sauvegardé le cache en cas de dépassement du cache en mémoire vive

Configuration des URL des IAWeb

Lorsque le candidat confirme son vœu, on l'invite à accéder au site d'inscription administratif.
Plusieurs cas sont alors possible :

• soit l'inscription administrative par le web est ouverte pour l'étape
  • le candidat fait sa première inscription à l'établissement et on lui donne un accès direct à l'IA primo via son numéro de dossier OPI et sa date de naissance.
  • le candidat se réinscrit dans l'établissement. Il passe par l'ENT puis accède à son onglet d'Inscription Administrative par le web.
  • le candidat était inscrit dans l'établissement mais est en interruption d'étude et ne peut donc pas accéder à son ENT. On lui donne un accès direct via son code étudiant et sa date de naissance au site d'Inscription Administrative par le web.
• soit l'inscription administrative par le web est fermée. Dans ce cas, on propose soit de se rendre directement au service de scolarité, soit d'utiliser le module de prise de rendez vous s'il a été configuré.

confirmation.IAWeb.addressIAPrimo=http://_url_site_web_ia_primo_/extern_authent.jsf

URL donnant l'accès direct à l'IA primo. L'URL sera suffixée par l'application des paramètres identifiants le candidat par son numéro de dossier OPI et sa date de naissance.

confirmation.IAWeb.addressIAReinss=http://_url_site_web_ia_/etapes/identification.do

URL donnant l'accès direct au site d'Inscription Administrative par le web. L'URL sera suffixée par l'application des paramètres identifiants le candidat par son numéro d'étudiant et sa date de naissance.

Cette URL est utilisé uniquement dans le cas où l'étudiant est détecté en interruption d'études. Dans l'autre cas, il se verra proposer l'accès à son ENT.

Configuration de l'accès à un calendrier de candidatures externe

URL.CalendrierDeCandidature

URL affichée si renseignée dans la page "Consulter les formations", page accessible depuis la page d'Accueil.URL.CalendrierDeCandidature