wiki:PortletEDT

La portlet EDT

TOC?

Description

La portlet EDT est un client pour  l'application de gestion d'emplois du temps développée par Bruno Gasnier. Elle affiche l'emploi du temps de la personne connectée à l'ENT.

Fonctionnalités

  • Le seul emploi du temps affiché est celui de la personne connectée à l'ENT ;
  • Affichage de l'emploi du temps de la journée ;
  • Affichage de l'emploi du temps de la semaine ;
  • Affichage de l'emploi du temps du mois ;
  • Navigation possible dans le temps.

D'autres possibilités exploitables

  • Affichage des jours fériés et des vacances ;
  • Colorisation des évènements dans l'emploi du temps.

Captures d'écran

Ces captures présentent la portlet EDT dans le portail ESUP.

Le modèle métier

Modèle (export PNG)

Une classe implémentant l'interface ScheduleLoader se charge de récupérer les emplois du temps en fonction d'une instance de ScheduleCommand. Cette structure de classe est une sorte de dérivé du pattern  Command : on paramètre un appel de fonction avec une instance de la classe ScheduleCommand, mais l'implémentation de la méthode active est laissée à la charge des classes qui implémentent ScheduleLoader.

Le nom de l'utilisateur utilisé par la portlet pour récupérer les emplois du temps est fourni par le système d'authentification du portail. L'application EDT doit alors être capable d'identifier des utilisateurs avec des logins du type pgentile (pour Pierre Gentile).

Installation

Note : pour installer la portlet, vous aurez besoin de Maven 2.0. Si vous souhaitez réaliser une installation sur ESUP Portail, vous aurez également besoin de Ant en version 1.7.

Étapes génériques

  1. Récupérer les sources à partir du serveur Subversion.
  2. Créer une archive WAR avec la commande mvn package. Si le portail requiert une méthode spécifique de packaging de l'application, suivre cette procédure au lieu d'utiliser la commande Maven.
  3. Déployer la portlet sur le conteneur d'applications par l'interface d'administration.
  4. Installer le filtre MyFaces sur le portail.
  5. Ajouter la portlet dans le portail.

Étapes sur ESUP Portail

Il faut tout d'abord récupérer les sources de la portlet à partir du serveur Subversion.

A la racine des sources de la portlet EDT, il y a deux fichiers : build.xml, le script Ant d'installation, et deployment.properties, le fichier de configuration. Ce dernier contient les propriétés suivantes, que vous devez renseigner :

maven.executable=mvn
tomcat.path=/home/ent/tomcat
esup.distrib.path=/home/ent/esup-distrib
  • maven.executable : le nom de l'exécutable de Maven. C'est mvn.bat sous Windows, mvn sinon ;
  • tomcat.path : le chemin du dossier du serveur Tomcat ;
  • esup.distrib.path : le chemin vers la distribution d'ESUP Portail.

Il faut ensuite exécuter la tâche Ant d'installation de la portlet sur ESUP :

ant esup.install

Nous avons ensuite besoin de redéployer le portail sur le serveur Tomcat :

ant esup.deploy

Puis après, nous devons déployer la portlet sur Tomcat :

ant deployPortletApp -DportletApp=lib/portlets/edt-portlet.war

Il faut enfin ajouter la portlet sur notre portail, à travers l'interface d'administration d'ESUP. Dans le gestionnaire de canaux, sélectionnez le type Portlet. Vous devrez également renseigner le Portlet Definition ID ; sa valeur est edt-portlet.edt-portlet.

Technologies utilisées

Tests

Tests fonctionnels

Test fonctionnel Passé ?
En mode journée, les boutons précédent / suivant affichent l'emploi du temps du jour précédent / suivant. oui
En mode semaine, les boutons précédent / suivant affichent l'emploi du temps de la semaine précédente. / suivante oui
En mode mois, les boutons précédent / suivant affichent l'emploi du temps du mois précédent / suivant. oui
Lorsqu'on clique sur la date du jour, on est redirigé vers l'emploi du temps du jour (tout en conservant le mode sélectionné). oui
On peut changer la vue en mode jour / mois / semaine grâce aux liens en bas de la portlet. oui
La tooltip du détail des cours s'affiche au survol d'un cours. oui
Les cours affichés correspondent bien à ceux disponible sur EDT, pour un utilisateur donné. non, le web service n'est pas encore disponible.

Tests d'intégration

La portlet a été intégré dans les environnement Pluto et ESUP sans problème particulier, dès lors que l'on respecte rigoureusement la procédure d'installation.

Attachments