FAQ – Etats Jasper - Questions /Réponses
1. JASPER REPORT
- Qu'est-ce que JasperReport ? Jasper Report est un outil Open source de Business Intelligence développé par la communauté Jasper. L'outil est constitué d'une bibliothèque et d'un outil graphique de conception de rapports (développés en technologie Java). Pour développer des états, vous avez besoin de télécharger uniquement iReport (le designer). La bibliothèque Jasper est intégrée à Coriolis (WEB). Les deux outils sont en libre téléchargement sur le site de la communauté. L'outil étant en constante évolution, nous pouvons garantir aujourd'hui la compatibilité de Coriolis avec la version 2.0.1 de iReport. Pour un poste de développement d'état Linux, il n'existe pas d'exécutable d'installation, il suffit uniquement de suivre les indications du READ-ME de l'archive. Les éditions peuvent être développées, testées sur n'importe quel poste de travail (peu importe le système d'exploitation). Elles pourront par la suite être intégrées à Coriolis, par une copie sur le serveur de production. Lien de téléchargement : http://www.jasperforge.org/index.php?option=com_content&task=section&id=16&Itemid=277 - Compatibilité des éditions ? Dans un premier temps les éditions Jaspers ne sont versions d'Oracle, supérieures ou égales à 9. - L'outil est–il documenté ? La bibliothèque Jasper ainsi que l'outil d'édition iReport sont documentés par leurs concepteurs. La documentation assez poussée à comme caractéristique d'être rédigée en anglais, d'être bien illustrée mais d'être payante. Un complément de documentation est fourni par Coriolis. Il traite : - la phase d'installation de l'outil, - les bonnes pratiques pour obtenir des états performants (par rapport à la base de données Coriolis), - l'intégration à Coriolis…. Coriolis propose une formation de deux jours pour vous permettre au client de prendre en main l'outil d'édition et d'intégrer ses éditions à Coriolis. Programme de la formation : - présentation et prise en main de l'outil du designer de rapports Jasper, - intégration d'états à l'outil d'édition Coriolis, - création d'éditions personnalisées (Bon de commande, Ordre de service...) compatibles qu'avec les
2. JASPER REPORT / Intégration à Coriolis
– Déploiement des états Jasper Pour chaque état, le club des utilisateurs Coriolis va émettre ses besoins et ses améliorations à apporter aux états. Par conséquence, les états jasper seront déployés au fil de l'eau. Les états Jasper seront compatibles à partir de la v4.2. Il est cependant possible pour un client de développer ou faire développer des états jasper spécifiques dans une autre version de Coriolis WEB. L'avantage de Jasper réside en son implémentation SQL d'accès aux données et à ses facilités graphiques. Pour différencier un état Jasper et un état développer avec l'ancien système, il suffit d'observer la fenêtre de génération de l'état :
Jasper Ancien système
– Traitement des erreurs et retours clients Lors d'une erreur d'exécution d'un rapport Jasper, l'écran d'erreur suivant s'affiche.
L'erreur peut provenir de plusieurs cas de figures : - Perte de session utilisateur (time out), - Non renseignement des coordonnées de la base de données dans le login/admin, - cas (jeu d'essai) non prévu dans le rapport et qui fait planter le traitement Jasper, - fichiers images ou rapports (sous rapports) manquants ou erronés, - …
Une console d'erreur est intégrée à l'outil de reporting. Il suffit juste de cliquer sur le bouton "Console". Pour voir les messages d'erreurs, qui la plupart du temps permettent au développeur d'état d'identifier la / ou les causes de l'erreur.
Merci de remonter le contenu de la console d'erreur lors de l'émission de FLIP
– Procédure d'installation spécifique à l'utilisation des rapports Jasper Il est nécessaire de préciser les coordonnées d'accès à la source de données : configuration des pilotes JDBC dans le login/admin de sa web application. On renseigne le paramétrage d'accès à la base de données Oracle. Les champs à renseigner sont : DRIVER JDBC : oracle.jdbc.driver.OracleDriver (copier la chaine avec le respect des majuscules, minuscules), URLJDBC : jdbc:oracle:thin:@adresse_serveur:port:nom_base
Exemple : Si votre base de données Oracle : - est hébergé sur la machine ayant l'adresse IP : 129.184.161.21 (attention l'adresse IP de la machine hébergeant Oracle peut être différente de la machine hébergeant Tomcat), - a comme port d'écoute (listener Oracle) :1521 (1521 est le port standard d'écoute Oracle, mais il est possible de le déterminer à l'installation d'Oracle), Le dernier paramètre est le SID Oracle. Il s'agit de la base Oracle qui héberge votre instance Coriolis : dans notre exemple : MABASEORACLE. jdbc:oracle:thin:@129.184.161.21:1521:MABASEORACLE Login JDBC : identifiant de l'utilisateur Oracle (coriolis par défaut) Pass : identifiant de l'utilisateur Oracle (coriolis par défaut)
Le login /admin de votre poste est accessible lorsque votre serveur Tomcat est lancé et à l'adresse suivante : http//votreserveur:8080/nomdevotreapplicationweb/login/admin (Onglet serveur).
– Déploiement d'états spécifiques Un répertoire de conservation de la configuration existe déjà, il contient une partie de de votre configuration spécifique Coriolis. Le répertoire en question se nomme "${NOMDECONTEXTEWEB}_BD" et se situe généralement à la racine, du HOME_USER_TOMCAT (user LINUX/UNIX qui lance tomcat). La partie "${NOMDECONTEXTEWEB}" doit être remplacé par le nom du contexte WEB, de votre application TomCat. Nous allons définir, un nouveau répertoire, qui se nommera "RapportSpecifique". Ce répertoire comprendra un sous dossier du nom de la version Coriolis (ex : 420 pour la version 4.2 de coriolis) et qui contiendra tout le contenu spécifique. Il sera situé dans le répertoire CORIOLIS_BD.
Version 4.0.1 de Coriolis : {HOME_USER_TOMCAT}/${NOMDECONTEXTEWEB}_BD/RapportSpecifique/401/ Version 4.1 de Coriolis : {HOME_USER_TOMCAT}/${NOMDECONTEXTEWEB}_BD/RapportSpecifique/410/ Version 4.2 de Coriolis : {HOME_USER_TOMCAT}/${NOMDECONTEXTEWEB}_BD/RapportSpecifique/420/
Et il suffit de copier les fichiers suivants : - La liste des fichiers jasper (extension du fichier .jasper), - Ainsi que les images dans un sous dossier images "images/"
Copier le répertoire RapportSpecifique contenu dans ${HOME_USER_TOMCAT}/${NOMDECONTEXTEWEB}_BD/.
le
dossier
livraison
:
SI vous n'êtes pas en version 420, vous devez renommer le sous répertoire de RapportSpecifique en fonction de votre version.
Vous devez redémarrer votre serveur Tomcat pour la prise en compte des modifications
– Comment personnaliser le logo de ma collectivité Certains états comportent le logo de la collectivité. Par défaut, un carré tricolore s'affiche ou le logo bull. Il est possible de remplacer l'image en question par le logo de votre collectivité. Dans ce cas là, cette procédure est considérée comme du contenu spécifique et doit être géré de la même façon qu'au point 2.4. Pour déterminer votre répertoire de configuration, il faut vous reporter au point 2.4. En V4.2, le chemin de votre répertoire de configuration doit être de la forme.
${HOME_USER_TOMCAT}/${NOMDECONTEXTEWEB}_BD/RapportSpecifique/420/ ${HOME_USER_TOMCAT} est une variable d'environnement de Tomcat ${NOMDECONTEXTEWEB} est le nom du contexte WEB Coriolis
Si "RapportSpecifique/420/" n'existe pas vous devez le créer. Ensuite, il est nécessaire de créer un répertoire nommé "images" dans le répertoire : ${HOME_USER_TOMCAT}/${NOMDECONTEXTEWEB}_BD/RapportSpecifique/420/. Enfin, copier l'image de votre logo au format jpg, dans le répertoire d'images précédemment créé. L'image doit avoir le nom suivant : logocoll.jpg. Il est impératif de respecter la casse des noms de fichiers précédemment cités.
Vous devez redémarrer votre serveur Tomcat pour la prise en compte des modifications