May 19, 2017 2:54:59 PM Laurent Payen avatar   154    

Utilisation du plugin appointment

Le plugin appointment permet de gérer les rendez-vous à l'aide de formulaires auxquels les utilisateurs peuvent accéder à partir d'un front office.

Sur le back office, il est possible de définir les semaines type et spécifiques (jours ouvrables, jours fériés, créneaux, plages horaires spécifiques ... ) ainsi que de nombreuses règles de gestion pour postuler au rendez-vous (délai minimum, nombre de places réservables ...).

Ce plugin, couplé au module worfkflow, permet de gérer l'état des rendez-vous (rappel par mail ou sms, annulation ...)


Conditions préalables

Le plugin appointment peut s'exécuter sur un environnement avec un serveur Tomcat (min 8.0.38) , java 8, maven (au moins 3.3.9), et un instance mysql .

Inclusion du plugin

Vous devez créer un site avec un pom.xml qui inclut le rendez-vous de plugin.

Vous pouvez trouver un exemple sur https://github.com/lutece-secteur-public/gru-plugin-appointment/blob/2.0.0/src/site/example_pom.xml

Une fois que vous avez fait cela, vous devrez obtenir toutes les dépendances de maven et créer le site en exécutant ces deux lignes de commande sur le répertoire de l'espace de travail du site:

mvn lutece:clean lutece:site-assembly

Une fois la compilation réussie, vous aurez un site-rendezvous-integration-XXX.war créé sur le répertoire cible et un répertoire nommé site-rendezvous-integration-XXX.

Vous devrez aller dans le répertoire /WEB-INF/conf et éditer le fichier db.properties pour mettre le droit de connexion/mot de passe pour accéder à l'instance mysql.

Pour créer le schéma lutece, vous devrez exécuter le script ant situé dans site-rendez-vous-XXX/WEB-INF/sql, en exécutant dans une invite shell la commande: ant

Pour exécuter l'application, mettez simplement le site-rendezvous-integration-XXX.war dans le répertoire webapps de tomcat.

Les sources de la version en cours du plugin Appointment sont disponibles à l'adresse suivante : https://github.com/lutece-secteur-public/gru-plugin-appointment/tree/2.0.0

Le plugin peut être déclaré comme une dépendance d'un site Lutèce dans son pom.xml grâce au code suivant :

<dependency>
  <groupId>fr.paris.lutece.plugins</groupId>
  <artifactId>plugin-appointment</artifactId>
  <version>2.0.0-SNAPSHOT</version>
  <type>lutece-plugin</type>
</dependency>
<dependency>
  <groupId>fr.paris.lutece.plugins</groupId>
  <artifactId>module-workflow-appointment</artifactId>
  <version>2.0.0-SNAPSHOT</version>
  <type>lutece-plugin</type>
</dependency>

Pour les développeurs, un readme complet a été créé, décrivant toutes les étapes pour installer le plugin, déployer le site et créer de nouveaux développements, ajouter de nouvelles fonctionnalités, activer le mode debug ... https://github.com/lutece-secteur-public/gru-plugin-appointment/blob/2.0.0/README.md

Utilisation du plugin

Accès au back office

Http: url_du_site/jsp/admin/AdminLogin.jsp

Accès au front office

Http: url_du_site/jsp/site/Portal.jsp?page=appointment&view=getViewFormList