Initialisation

Une fois l'application déployée, il est nécessaire de la configurer. Pour ce faire, le 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 positionnés :

Bloc de code
nonejsnone js
# WhereAdresse thedu SSOserveur CAS is. cas.url=https://sso-cas.domainuniv.edufr/cas # WhereDomaine thede l'application is. cas.serverName=http://domainent.univ.edufr: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 :

ldap.url=ldap://ldap.domain.edu:389
ldap.alternateUrl=ldap://ldap.domain.edu:389
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 disponibles : LDAP et SIFAC Sifac.

Le paramètre domain.matricule.bean permet de sélectionner la méthode à utiliser.
Les valeurs possibles sont sont :

• matriculeByLdap ldapMatriculeService : utilisation de l'annuaire LDAP
• matriculeBySifac sifacMatriculeService : utilisation du webservice web service de SIFACSifac

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

# 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 SIFACSifac, le bloc suivant doit être correctement configuré configuré :

Bloc de code
nonejs none js
# URL d'accès au web service MATRICULE Sifac. domain.matricule.sifac.ws.urlendpoint=[http://sifac.univ..fr/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.

# Identifiant pour authentification HTTP BASIC. # Laisser vide si pas d'authentification. matricule.sifac.username= matricule.sifac.password=

Web service de Sifac

...

Remarque
La configuration du webservice web service de SIFAC Sifac est indépendante de celle utilisée pour récupérer le matricule de l'utilisateur.

Accès au webserviceweb service

Afin de récupérer les données du web service de SIFACSifac, le bloc suivant doit être correctement configuré configuré :

# URL d'accès au web service PORTAIL Sifac.
mission.sifac.endpoint=sifac.ws.url=[http://sifac.univ..fr/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.

# 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.

...