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 fichier WEB-INF/classes/properties/config.sample.properties doit être dupliqué afin de créer le fichier WEB-INF/classes/properties/config.properties.

• Installation portlet 2.0
  Le fichier WEB-INF/classes/config.sample.properties doit être dupliqué afin de créer le fichier WEB-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 LDAP
• sifacMatriculeService : 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

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.