Utilisation

• Pour déployer l'application dans le Tomcat configuré dans les fichiers properties (voir 2em point de l'installation) : target 'deploy'

Important :

• Le Tomcat utilisé sera celui configuré dans le fichier 'properties' (créé précédemment) correspondant au déploiement choisi.
• Dans le cas où le Tomcat utilisé pour uportal est différent de celui où est déployé esup-mondossierweb (notamment en servlet), ne pas oublier de faire attention aux ports utilisés par les deux serveurs, de manière à ce qu'il n'y ait pas de conflit.
• Dans le cas d'un déploiement portlet, ne pas oublier de déclarer la portlet dans le contexte de Tomcat pour pouvoir l'ajouter comme canal d'uportal :

<Context path="/esup-mondossierweb" docBase="pathVersTomcat/webapps/esup-mondossierweb" crossContext="true" reloadable="true"/>

• Rappelons que pour un déploiement portlet au sein d'Uportal, esup-mondossierweb doit être déployé au même niveau qu' UPortal.
• Dans le cas d'un déploiement portlet, pensez à ajouter *emptySessionPath="true"*dans la déclaration du ou des 'Connector'' dans le server.xml de Tomcat pour que le téléchargement de fichier (pdf, excel) fonctionne.
• Dans le cas d'un déploiement portlet, voici le 'Portlet Définition ID' à mettre lors de la déclaration de la portlet dans le portail (param portlet-guid du web.xml): esup-mondossierweb.esup-mondossierweb.
• Pensez également à mettre un 'Channel timeout' assez élevé (15000 par ex) car certains rendus sont (à cause de facelets notamment) assez long à s'afficher.
  

Voici un exemple de déclaration :
 

• Vous pouvez à tout moment passer du déploiement servlet à portlet (et vice versa) en utilisant les targets appropriées du build.xml (voir 2em point de l'installation).
• Les fichiers de configuration se trouve dans le répertoire 'properties'. Ils permettent de configurer :
  •  la connexion à Apogée : dao/dao.xml
  • la connexion au ldap : ldap/ldap.xml
  • le logger : logging/ log4j.properties
  • le ws uportal : portal/portal.xml
  • l'email où envoyer les erreurs survenue dans l'application : smtp/smtp.xml
  • les options d'affichage, de paramétrage et le serveur de photo: monDossierWeb/monDossierWeb.xml

Ils sont détaillés ci-dessous

• Lors de l'identification si l'utilisateur est reconnu en tant qu'étudiant, il est dirigé vers la page d'accueil 'étudiant' de l'application. Sinon, s'il est reconnu en tant qu'utilisateur uportal ou en dernier recours en tant qu'utilisateur Apogée, il est redirigé vers la page d'accueil 'enseignant' de l'application. Dans tout autre cas, l'utilisateur est redirigé vers une page d'erreur lui indiquant qu'il n'est pas autorisé à accéder à l'application.
• En déploiement servlet, vous pouvez vous déconnecter en cliquant sur 

Les fichiers de configuration

Voici la liste des options configurables grâce aux fichiers du répertoire 'properties' :

• dao.xml :
  • l'url de la base Apogée via le bean dataSource.
  • le login et le password de connexion à Apogée via le bean dataSource.
  • la récupération du login en fonction du code individu et vice-versa or WS via les beans daoCodeLoginEtudiant et daoLoginCodeEtudiant. Remplace le 'connecteur Apogée'.

• ldap.xml :
  • l'url du ldap via le bean contextSource
  • si besoin est, le userName et le password de connexion au ldap via le bean contextSource.
  • la base du ldap toujours via le bean contextSource. Ex : "dc=univ-nancy2,dc=fr"

• log4j.properties :
  • fichier de configuration typique log4j (sortie des logs, fichier de log etc...)

• portal.xml :
  • l'url du WS uportal (voir partie 1, les pré-requis)
  • les paramètres commençant par 'test' sont utilisés par la méthode 'test'lancée par la tâche ant 'test-portal' pour vérifier que le WS uportal est accessible.

• smtp.xml :
  • l'adresse mail où sont envoyées les erreurs dans le bean smtpInterceptAddress via le bean smtpInterceptAddress.
  • le paramètre testAddress du bean smtpService est utilisé pour tester l'envoie de mail via la tâche ant test-smtp

• monDossierWeb.xml :
  • activation de la partie enseignant
  • activation de la partie étudiant
  • activer le trombinoscope
  • afficher un nombre fixe d'étudiants par page affichée du trombinoscope
  • activer la modification des l'adresses pour l'étudiant
  • l'extension au login pour l'e-mail des étudiants. Ex : @univ-nancy2.fr
  • activation du lien 'nous contacter'
  • l'e-mail du lien 'nous contacter'. Ex : scolarite@univ-nancy2.fr
  • le message d'erreur de connexion
  • le message d'interdiction d'accès
  • le message lors de la visualisation des notes non définitives
  • L'utilisation un dataScroller pour afficher la liste des étudiants et le nombre d'étudiants affichés par page
  • donner la possibilité à l'étudiant de modifier ses adresses.
  • Affichage des inscriptions de l'étudiant.
  • Affichage du calendrier.
  • Affichage des notes de l'étudiant.
  • Activer la génération des notes en pdf pour l'étudiant.
  • Affichage du numéro de place dans le calendrier des examens
  • Message complémentaire concernant le calendrier des examens
  • l'identifiant (login) de l'étudiant pour lequel on souhaite se faire passer pour un test.
  • l'identifiant (login) qui souhaite se faire passer pour l'étudiant si dessus.
  • Configurer le bean Security. (le type ldap d'un étudiant et les groupes uportal autorisés à accéder à l'application) 
  • Configurer le bean Photo. (Empty, Nancy2)

Les beans interchangeables

Certains beans ont été conçus de manière à être facilement remplacés si besoin est. C'est à dire que vous pouvez créer votre propre bean si celui proposé ne convient pas à votre environnement. Il suffit pour cela de créer une nouvelle classe java implémentant l'interface du bean d'origine, puis de modifier la description du bean ('class' et pourquoi pas 'property') dans le fichier XML correspondant.

Ces beans sont les suivants: