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

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

...

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

placé à true, la connexion va s'effectuer via une pool de connexion JNDI (installée sur le tomcat)

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 :

Bloc de code

<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 :

• 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 :

...

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

• 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

...

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

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 Permettre l'extraction des formulaires complémentaires

...

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

...