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.

Authentification

Par défaut, la méthode d'authentification de l'utilisateur est CAS. Les paramètres suivants doivent être correctement positionnés :

# Adresse de l'application CAS
cas.url=https://sso-cas.domain.edu/cas

# Where the application is
# Adresse de l'application esup-sifacmiss2
cas.serverName=http://domain.edu:8080

Annuaire LDAP

Afin de se connecter à l'annuaire LDAP et récupérer les informations des utilisateurs, les paramètres suivants doivent être positionnés correctement :

# Adresse des annuaires LDAP
ldap.url=ldap://ldap.domain.edu:389
ldap.alternateUrl=ldap://ldap.domain.edu:389

# Identifiants de connexion
ldap.userDn=
ldap.password=
ldap.base=dc=domain,dc=edu

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 :

matriculeByLdap : utilisation de l'annuaire LDAP
matriculeBySifac : utilisation du web service de SIFAC

Via l'annuaire LDAP

L'annuaire LDAP doit préalablement être configuré.

La récupération du matricule via l'annuaire LDAP suppose qu'un attribut de l'enregistrement de l'utilisateur contienne son matricule. Le positionnement de ce champ s'effectue via la propriété domain.matricule.ldap.attribute. Ce champ doit aussi être renseigné à la fin de la propriété ldap.userAttributes.

domain.matricule.ldap.attribute=sifacAttribute
ldap.userAttributes=displayName,sn,givenName,sifacAttribute

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

domain.matricule.sifac.ws.url=[http://.../ZWEB_SERVICE_MATRICULE]

Si l'accès au web service requiert une authentification, les identifiants sont hérités de la configuration du service SIFAC.

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

sifac.ws.url=[http://.../ZWEB_SERVICE_PORTAIL]

Si l'accès au web service requiert une authentification, les paramètres suivants doivent être configurés. Dans le cas contraire, ils sont optionnels.

sifac.ws.login=
sifac.ws.password=

Configuration

Le paramètre sifac.mandant permet de spécifier la valeur MANDANT lors de l'appel au web service.
Le paramètre 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 WEB-INF/classes/properties/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.

Affichage

Il est possible de configurer les liens qui seront affichés dans le menu depuis la configuration.

Page « aide »

Le contenu de la page « aide » peut être modifié depuis la clé i18n HELP.TEXT.SUMMARY. Pour des modifications plus importantes, il peut être nécessaire d'éditer le fichier stylesheets/desktop/help.xhtml.

La page « aide » peut être désactivée depuis la configuration :

view.displayHelpLink=false

Page « à propos »

Le contenu de la page « à propos » peut être modifié depuis les clés i18n ABOUT.TEXT. Pour des modifications plus importantes, il peut être nécessaire d'éditer le fichier stylesheets/desktop/about.xhtml.

La page « à propos » peut être désactivée depuis la configuration :

view.displayAboutLink=false

Lien « application hors du portail »

L'affichage de ce lien peut être désactivé depuis la configuration :

view.displayServletLink=false

Lien « voir en mode mobile »