Pré-requis

Pour pouvoir faire fonctionner esup-mondossierweb, il est nécessaire d'avoir installé au préalable :

• Un Tomcat avec uPortal et esup-portal-ws : http://sourcesup.cru.fr/projects/esup-portal-ws/

  Attention esup-portal-ws est maintenant intégré dans les dernières versions du package ESUP-Portail. Les instructions données ne sont utiles que pour des anciennes versions du package ESUP-Portail.

  ?Télécharger uportal-ws-server.jar et le copier dans votre hiérarchie uPortal (/uPortal/lib).
  ?Activer Axis en modifiant le fichier/uPortal/webpages/WEB-INF/server-config.wsdd, en y ajoutant le code suivant:

<service name="UportalService" provider="java:RPC">
<parameter name="allowedMethods" value="getUser,getUserAttributes,getGroupById,getGroupByName,getSubGroups,getSubGroupsById,getSubGroupsByName,
getRootGroup,getGroupHierarchyById,getGroupHierarchyByName,getGroupHierarchy,getUserGroups,isUserMemberOfGroup"/>
<parameter name="className" value="org.esupportail.portal.ws.server.UportalService"/>
<parameter name="scope" value="application"/>
</service>

* Le Web Service de l'AMUE :
?déployer apows.war dans Tomcat (qui sera ensuite présent dans webapps/apows).
?renseigner ses paramètres de connexion (jdbcUrl, user et password) à Apogee dans 'persistance-SpringContext.xml' présent dans le répertoire 'apows/WEB-INF/classes'. Attention, pour que la mise à jour de l'adresse étudiant fonctionne, le compte utilisé doit avoir les droits d'update sur la base. Cependant, cette mise à jour peut être désactivée dans le fichier 'properties' de l'application.
?Si besoin est (apows ne se trouvant pas dans le répertoire webapp de Tomcat) ajouter le contexte du WS dans le fichier server.xml du répertoire 'conf' de Tomcat, ex :

<Context path="/apows" docBase="C:/esupdev/esupdev-2.5-esup-2.1.01/uPortal-quick-start/webapps/apows" crossContext="true" reloadable="true"/>

Installation

• Récupérer la distribution de esup-mondossierweb
• Configurer les bases indispensables au fonctionnement l'application. Suivre les étapes suivantes :
  ?Pour un déploiement servlet, créer un fichier 'build-servlet.properties' sur la base du fichier d'exemple 'build-servlet-example.properties'. Ce fichier décrit votre déploiement servlet.
  ?Pour un déploiement portlet, créer un fichier 'build-portlet.properties' sur la base du fichier d'exemple 'build-portlet-example.properties'. Ce fichier décrit votre déploiement portlet.
  

  Remarque :
  Pour l'utilisation de la target 'start', le fichier 'esup-portail.keystore' est disponible dans le répertoire utils/cas du projet esup-mondossierweb

  Attention :
  Pour un déploiement portlet au sein d'Uportal, esup-mondossierweb doit être déployé au même niveau qu' UPortal.

  ?Renseigner les fichiers (du répertoire 'properties') de configuration 'application.properties' et 'log4j.properties' (dans le repertoire logging) sur la base des fichiers *-example.properties. Dans le répertoire 'monDossierWeb' créer le fichier monDossierWeb.xml sur la base du fichier monDossierWeb-exemple.xml et le renseigner.D'autres options sont configurables via les beans Spring (notemment dans dao.xml pour changer le type d'accès a la BD) : leur description se trouve à la fin de la rubrique 'Utilisation'.
  ?Renseigner configUrlServices.properties du répertoire 'webapp/WEB-INF/classes' en donnant les urls d'accès au Web Service de l'Amue.
  ?Pour un déploiement servlet, créer le web-servlet.xml sur la base de web-servlet-example.xml en indiquant les bonnes urls du serveur CAS : urls de logout, login, et serviceValidate.
  ?Lancer la tache Ant '_toServlet' ou '_toPortlet' du build.xml suivant le type de déploiement désiré. Vous pouvez ensuite passer au déploiement.
  

Configuration avancée

• Attention : Avant le lancer l'application, il faut impérativement consulter et modifier si necessaire le fichier monDossierWeb.xml, qui contient un paramétrage de tout ce qui est attributs ldap, Apogée, affichage, édition de pdf etc.
• Par ailleurs, certaines fonctionnalités sont prévues pour être modifiées suivant les besoins et la configuration rencontrés. Cela a été implémenté sous la forme de Beans Spring configurables (voir la partie Les beans interchangeables ici ).
  • Exemple : la récupération du Cod_IND de l'étudiant à partir de son login (étape effectuée à la connexion d'un étudiant sur la portlet).
    • A la base, cette fonctionnalité a été dévelopée par Nancy2 à l'aide d'une table MEL_LOGIN spécifique à Nancy2.
    • Elle est implémentée dans la classe : org.esupportail.mondossierweb.dao.DaoCodeLoginEtudiantImplNancy2.java. Cette classe, qui implémente l'interface IDaoCodeLoginEtudiant, essaye tout d'abord de récupérer la cod_ind dans le ldap (elle va chercher l'attribut "attributLdapEtudiant" configuré dans monDossierWeb.xml) et si cela échoue elle le récupère via une requête SQL sur la table MEL_LOGIN.
    • la requête SQL appelée se trouve dans le fichier properties/dao/ibatis/mapping/Mellogin.xml
    • La classe DaoCodeLoginEtudiantImplNancy2.java est référencée dans le fichier de configuration properties/dao/dao.xml
    • Pour implémenter votre propre solution, vous avez plusieures possibilités:
      • 1 ? Vous pouvez effectuer une requête sur votre base de données qui vous retourne le codInd en fonction du Login. Dans ce cas, vous pouvez très bien ne modifier que la requête "getCodInd" présente dans Mellogin.xml. Cette solution n'est certe pas très propre car vous utiliserez toujours des classes nommées 'Nancy2' pour votre propre solution, mais elle est rapide à mettre en place.A noter qu'avec cette solution vous devrez modifier le fichier Mellogin à chaque nouvelle version de la portlet.
      • 2 ? Vous pouvez récupérer le CodInd dans le ldap mais la façon dont cela est fait dans la classe de nancy2 ne convient pas à fonction configuration. Dans cas, ne modifiez directement que le code de la classe nancy2. Là aussi ça n'est pas la façon la plus propre de faire, mais c'est rapide.
      • 3 ? Votre configuration est plus complexe. Dans ce cas vous devez créer votre propre bean DaoCodeLoginEtudiantImpl qui implémente l'interface IDaoCodeLoginEtudiant. Pour cela ajoutez votre classe dans la package dao (là où se trouve DaoCodeLoginEtudiantImplNancy2.java) et référencez là dans dao.xml à la place de DaoCodeLoginEtudiantImplNancy2. Si vous devez créer de nouvelles requêtes sur la base, vous pouvez compléter un fichier de config iBATIS existant ou créer un nouveau fichier de configuration xml dans properties/dao/ibatis/mapping et le référencer le dans properties/dao/ibatis/ibatis.config.xml. Pour appeler une nouvelle requête iBATIS, vous pouvez l'appeler directement dans votre classe sans passer par le daoService (voir l'appel aux requêtes dans la classe DaoServiceIBatisImpl)

• Ce fonctionnement est le même pour la récupération du login à partir du CodInd (utilisé pour créer les adresses mails à partir des CodInd d'une liste d'étudiant dans la partie 'enseignant' de la portlet) excepté que la classe correspondante DaoLoginCodeEtudiantImplNancy2, va directement chercher dans la table MEL_Login la correspondance. Si vous souhaitez utiliser le ldap ici, inspirez vous du code de DaoCodeLoginEtudiantImplNancy2.

Rappel : La liste de tous les beans interchangeables se trouve ici

• Depuis la version 1.8 vous avez la possibilités d'utiliser des implémentations faites par l'université de Rennes1. Cela permet:
  • L'utilisation du calendrier des examens types Rennes1 (calendrierEtape)
  • L'utilisation du calendrier de rentrée type Rennes1.
  • L'utilisation des habilitations Apogée

• Pour cela il vous faudra :
  • Configurer monDossierWeb.xml : activer les options désirées (les mettre à true) , décommenter le bean basé sur EtudiantAmueR1, décommenter le bean basé sur SecurityHabilitationApogee
  • Configurer specific.xml : Décommenter la déclarations des beans.
  • Il vous faudra également avoir installé le WS de Rennes1.