Module ODT pour Play framework

Ce module est destiné à permettre un rendu de documents ODT à partir d’un template ODT et de données provenant d’un contrôleur Play.

Démarrer avec ce plugin

1. Si ce n’est pas déjà fait, récupérez et installez une version récente de Play framework, depuis le site du projet,
ou directement à partir du dépot de sources sur GitHub.

2. Installez le module odt :

cd $PLAY_HOME/modules
mkdir odt
git clone git://github.com/bcourtine/play--odt.git .

3. Tester l’application de démonstration du module :

cd $PLAY_HOME/modules/samples-and-tests/demoodt
play run

A l’adresse localhost:9000/, on trouve la page d’accueil de Play.
Pour tester le module et obtenir un document ODT, il faut se rendre sur la page localhost:9000/Application/demo.
Il est possible de spécifier le paramètre “numDossier” dans la requête, qui sera pris en compte dans la génération du document final :
localhost:9000/Application/demo?numDossier=12345

6. Développer une application utilisant le module ODT :

Créer un nouveau projet

play new myOdtApp

Activer le module dans le fichier conf/application.conf du projet :

module.odt=${play.path}/modules/odt

Récupérer les sources du projet

Vous pouvez cloner le projet depuis Github :

git clone git://github.com/bcourtine/play--odt.git

Remonter des bugs ou des demandes d’évolution

Les bugs et les demandes d’évolution du module sont à soumettre sur GitHub.

Limitations actuelles du module et évolutions prévues :

• Le module permet d’utiliser des paramètres objets et les syntaxes correspondantes, comme dans les templates de Play (personne.nom, personne.prenom, etc.),
  mais uniquement pour les paramètres simples (String, Integer, etc.) : la syntaxe personne.fils.nom ne fonctionne pas si fils est lui-même une Personne.
• Le module ne gère pas les exceptions de rendu (si un des éléments du template n’est pas passé en paramètre, par exemple). Il faut donc veiller en amont,
  dans le contrôleur, que tous les paramètres du template sont bien renseignés.
• Evolution future de ce module en “plugin Play”.