Historique de la page

...

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

  Volet
  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

  Volet
  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. Dans le répertoire properties/dao/ibatis/mapping créer le fichier Mellogin.xml sur la base du fichier Mellogin_example.xml et le renseigner en indiquant les requêtes qui vous permettent de récupérer le codind d'un étudiant à partir de son login et inversement dans Apogée. D'autres options sont configurables via les beans Spring : 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.
  

...

• 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 l'installation de l'application vous devez renseigner le fichier Mellogin.xml en indiquant la requête qui vous permet de récupérer cet info dans Apogée. Mais une requête dans Apogée peut ne pas être une solution pour vous. Pour cela il faut créer son propre bean qui remplacera le bean de base : DaoCodeLoginEtudiantImplBasic
    • Cette base, cette fonctionnalité a été dévelopée utilisée par Nancy2 à l'aide d'une table MEL_LOGIN spécifique à Nancy2.. En effet, nous essayons d'abord de récupérer l'information dans le ldap avant d'exécuter une requête dans Apogée.
    • Cette fonctionnalité 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 bien sur dans le fichier properties/dao/ibatis/mapping/Mellogin.xml que nous avons configuré pour nos besoins.
    • La classe DaoCodeLoginEtudiantImplNancy2.java est référencée indiquée dans le fichier de configuration properties/dao/dao.xml application.properties, à la place de DaoCodeLoginEtudiantImplBasic.
    • 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 à votre 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.
      • n'avez qu'à indiquer la bonne requête dans Mellogin.xml comme indiqué dans la partie 'Installation'.
      •  
      • 2 3 ? Votre configuration est plus complexe. Dans ce cas vous devez créer votre propre bean DaoCodeLoginEtudiantImpl DaoCodeLoginEtudiantImplUniversité 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 daoapplication.xml properties à la place de DaoCodeLoginEtudiantImplNancy2 DaoCodeLoginEtudiantImplBasic. Si vous devez créer de nouvelles requêtes sur la base, vous pouvez compléter un le 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)(Mellogin.xml). Vous pouvez bien sur vous inspirer de la classe DaoCodeLoginEtudiantImplNancy2 pour implémenter votre solution.

• 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.Pour la récupération du login en fonction du codInd (et du codInd en fonction du login), l'implémentation de Rennes1 est également présente dans la distribution. Cette implémentation pourrait vous convenir ou vous servir d'exemple également. Ce sont les classes se terminant en 'ImplRennes1'qu'il n'éxiste pas de classe équivalente pour Nancy2. En effet, nous utilisons la classe Basic et la requête qui va bien dans Mellogin.xml.

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

...