Une fois l'application déployée, il est nécessaire de la configurer. Pour ce faire, le fichier WEB-INF/classes/properties/config.sample.properties doit être dupliqué afin de créer le fichier WEB-INF/classes/properties/config.properties. C'est dans ce dernier que la configuration doit s'effectuer.

Catalogue esup-uniform

Chaque établissement possède une modélisation différente sous Uniform. Il est donc nécessaire de configurer correctement chacune des parties développées ci-après afin que la récupération des données soit correcte.

Accès au web service

Le paramètre uniform.ws.url permet d'indiquer l'emplacement du web service esup-uniform. Ce dernier doit être accessible sans identification nécessaire.

Paramètres de recherche

Afin d'établir la correspondance des champs du formulaire de recherche avec les critères du web service esup-uniform, le paramètres suivants doivent être ajustés :

# Mots clés, généralement l'intitulé de la formation
uniform.parameter.query=__intitule_pt_AND

# Matière (information, mathématique, etc)
uniform.parameter.subject=__matiere

# Type de diplôme (licence, master, etc)
uniform.parameter.diploma=__diplome

# Domaine (D.E.G., S.H.S., etc)
uniform.parameter.domain=__domaine

Les valeurs doivent être au format attendu par esup-uniform (cf documentation).

Interprétation des constantes

Le web service d'esup-uniform fournit une extension aux données CDM-fr renvoyées. L'application lit le contenu de cette extension afin d'associer à chaque code, un libellé utilisé pour l'affichage. L'emplacement des constantes est paramétré comme suit :

# Types de diplômes
uniform.constants.diplomaXPath=/CDM/properties/infoBlock/extension/uniform/constantes/typeDiplome/data/value[@lang="fr-FR"]

# Domaines
uniform.constants.domainXPath=/CDM/properties/infoBlock/extension/uniform/constantes/domaineDiplome/data/value[@lang="fr-FR"]

# Matières
uniform.constants.subjectXPath=/CDM/properties/infoBlock/extension/uniform/constantes/matiereDiplome/data/value[@lang="fr-FR"]

Ces constantes sont des expressions XPath permettant d'atteindre les constantes de l'extension d'esup-uniform.

Interprétation des données

Le moteur de recherche interprète les données CDM-fr du web service afin de proposer un affichage des résultats. La correspondance des données est effectuée via des expressions XPath en accord avec le schéma CDM-fr. Ces relations (notamment celles relatives aux attributs codeSet) peuvent être modifiées depuis les propriétés uniform.mapper.program.*.

Base de données

L'application requiert une base de données afin de sauvegarder les comptes utilisateurs et leur panier. Trois connecteurs sont fournis : MySQL, PostgreSQL, HyperSQL.

hibernate.connection.driver_class=com.mysql.jdbc.Driver
hibernate.connection.url=jdbc:mysql://mysql.univ.fr/ofm
hibernate.connection.username=esup
hibernate.connection.password=

Le compte utilisateur doit posséder tous les droits sur la base de données. Les tables sont crées automatiquement par l'application.

Scripts automatiques (cronscripts)

Les scripts automatiques fournis par l'application permettent la suppression des données utilisateurs expirées. Les paramètres suivants doivent être ajustés :

# Durée en jours à partir de laquelle l'utilisateur est considéré
# comme inactif
batch.accountInactivityPeriod=100

# Durée en jours à partir de laquelle le panier de l'utilisateur est
# considéré comme périmé
batch.cartExpirationPeriod=30

L'exécution des scripts est ordonnée lors de l'appel de pages spécifiques avec la méthode HTTP DELETE.

Il est possible d'exécuter de telles requêtes grâce à curl :

# Suppression des paniers expirés
curl -X DELETE [http://domain.edu/batch/deleteexpiredcarts]

# Suppression des comptes inactifs
curl -X DELETE [http://domain.edu/batch/deleteinactiveaccounts]

Il est possible d'automatiser l'exécution via l'ajout de commandes dans crontab.