Initialisation
Une fois l'application déployée, il est nécessaire de la configurer. Pour ce faire, un fichier de configuration doit être créé et édité.
- Installation servlet et portlet 1.0
Le fichierWEB-INF/classes/properties/config.sample.propertiesdoit être dupliqué afin de créer le fichierWEB-INF/classes/properties/config.properties.
- Installation portlet 2.0
Le fichierWEB-INF/classes/config.sample.propertiesdoit être dupliqué afin de créer le fichierWEB-INF/classes/config.properties.
Authentification (servlet uniquement)
Par défaut, la méthode d'authentification de l'utilisateur est CAS. Les paramètres suivants doivent être correctement positionnés :
# Adresse du serveur CAS. cas.url=https://cas.univ.fr/cas # Domaine de l'application. cas.serverName=http://ent.univ.fr:8080
Récupération du matricule
Afin de récupérer les frais de missions de l'utilisateur, nous devons récupérer préalablement son matricule. Deux méthodes sont disponibles : LDAP et Sifac.
Le paramètre domain.matricule.bean permet de sélectionner la méthode à utiliser.
Les valeurs possibles sont :
ldapMatriculeService: utilisation de l'annuaire LDAPsifacMatriculeService: utilisation du web service de Sifac
Via l'annuaire LDAP
La récupération du matricule via l'annuaire LDAP suppose qu'un attribut de l'enregistrement de l'utilisateur contienne son matricule.
# Paramètres de connexion. matricule.ldap.url=ldap://ldap.univ.fr:389 matricule.ldap.userDn= matricule.ldap.password= matricule.ldap.base=dc=domain,dc=edu # Paramètres de recherche (optionnel). matricule.ldap.dnSubPath=ou=people matricule.ldap.objectClass=Person matricule.ldap.uidAttribute=uid # Attribut LDAP contenant le matricule. matricule.ldap.matriculeAttribute=
Via le web service de Sifac
Afin de récupérer le matricule via le web service de Sifac, le bloc suivant doit être correctement configuré :
# URL d'accès au web service MATRICULE Sifac. matricule.sifac.endpoint=http://sifac.univ.fr/ZWEB_SERVICE_MATRICULE # Identifiant pour authentification HTTP BASIC. # Laisser vide si pas d'authentification. matricule.sifac.username= matricule.sifac.password=
Web service de Sifac
La configuration du web service de Sifac est indépendante de celle utilisée pour récupérer le matricule de l'utilisateur.
Accès au web service
Afin de récupérer les données du web service de Sifac, le bloc suivant doit être correctement configuré :
# URL d'accès au web service PORTAIL Sifac. mission.sifac.endpoint=http://sifac.univ.fr/ZWEB_SERVICE_PORTAIL # Identifiant pour authentification HTTP BASIC. # Laisser vide si pas d'authentification. mission.sifac.username= mission.sifac.password= # Année de mise en service de l'application Sifac. mission.sifac.firstYear=
Le paramètre mission.sifac.firstYear permet de spécifier la première année civile où l'application Sifac a été mise en place dans l'établissement.
Catégories des frais
Les détails des missions retournés par le web service de Sifac possèdent une catégorie. Toutefois, ce champ peut varier d'un établissement à l'autre. Afin que l'application puisse tout de même identifier la catégorie il est nécessaire de spécifier un dictionnaire. Cette manipulation s'effectue dans le fichier suivant :
- Installation servlet et portlet 1.0
WEB-INF/classes/properties/words.properties
- Installation portlet 2.0
WEB-INF/classes/words.properties
Chaque entrée est de la forme [catégorie]=[liste de mots clés]. La catégorie est propre à l'application tandis que la liste de mots clés est configurable. Cette liste ne tient pas compte de la casse et les mots qui la compose doivent être séparés par un espace. Chaque mot clé correspond à une valeur possible pour le champ CAT_FRAIS_DEPL.
Exemple de configuration :
airplane=vol bank=bank banq bus=bus cash=cash hotel=hotl parking=park restaurant=food retn taxi=taxi train=trn trnp
Par exemple, si le service Sifac retourne trn, l'application va détecter la catégorie train.