Configuration des rapports imprimables

1. Téléchargement de studio et installation

1. Prendre la version 6.17.0 finale : https://community.jaspersoft.com/community-download
2. Télécharger et installer.

2. Créer un rapport plus détaillé de vos schémas

Dans cette documentation, nous démontrons comment créer un rapport sur un schéma. Dans l'optique de cette démonstration, nous allons créer un rapport sur une tâche qui se nomme «Consultation» incluant des documents et des dossiers qui doivent être consultés par un utilisateur. Ce rapport inclura la tâche, son identifiant et titre, la date de création et la liste des dossiers et documents.

2.1 Créer la tâche de consultation

1. Dans Constellio, créer une tâche assignée à un utilisateur;
2. Ajouter des dossiers liés et des documents liés.

2.2 Chercher un XML pour les tests basés sur la tâche

1. Allez chercher un XML pour avoir les attributs qui seront sur votre rapport.
   1. Aller dans « Pilotage »;
   2. Aller dans la gestion des imprimables;
   3. Ouvrir la gestion des rapports;
   4. Ouvrir l'onglet des tâches;
   5. Sélectionner XML pour création des rapports;
   6. Rechercher la tâche de consultation test que vous avez créée dans la section précédente et fait « Sélectionner »;
   7. Appuyer sur « Enregistrer ».
2. Un fichier XML sera téléchargé sur votre poste. Vous pouvez regarder le contenu de votre XML avec un logiciel comme « Notepad++ » ou simplement avec un navigateur.

3. Créer le projet de votre étiquette sur JasperSoft studio

1. Ouvrir JasperSoft studio;
2. Faire Fichier -> Nouveau -> Jasper Report;
3. Dans les choix « templates », prendre « Blank Letter ». Cliquer « Prochain »;
4. Choisissez le nom de votre fichier jrxml et l'emplacement du projet dans votre workspace. Cliquer « Prochain »;
5. Créer un nouvel adapteur (donnez un nom significatif comme Task Adapter);
   1. Dans la fenêtre de création de l'adapteur, prendre XML document et cliquer « Suivant »;
   2. Donner un nom, choisir l'endroit le fichier créé en XML dans le chapitre précédent se trouve et choisir l'option « expression Xpath »;
   3. Cliquer « Finir ».
6. Descendre l'arbre et choisir « UserTask »(double clique). Cliquer « Prochain ». (Ou finir si vous voulez les éléments du XML soit accessible et vous n'avez aucun besoin de l'ordre des documents pour générer l'imprimable);
7. Cliquer « Finir ».

4. La forme du projet de rapport

Dans le design, on peut voir le projet séparer en plusieurs sections.

Sections	Description	Image
Titre	Pour ceux qui veulent une page titre.
En-tête de page	Elle sera affiché en haut de la page à chaque page.
Détail 1	Section du détail. Vous pouvez faire d'autres sections, il est conseillé de faire des sections séparées pour éviter des problèmes.
Pied de page	Ce qui s'affiche tout le temps aux pieds de la page (Numéro de page, signature, date d'impression, etc.)
Résumé	Ce que vous voulez afficher en tout dernier (un résumé, conclusion, etc.)
Pied de colonne/En-tête de colonne	Pour les rapports qui n'est qu'une grande table (pas dans le cas de l'exemple présent).

5. Les éléments du rapport base

1. En premier, veuillez encadrer la zone d'affichage de vos champs de métadonnée. Utilisez l'élément de cadre de la palette. L'encadrer permettra de limiter les bordures et de mettre les bordures. Vous pouvez mettre des expressions d'affichage aussi;
2. Les métadonnées sont dans votre liste « champs » dans le Outline. Il existe par contre des métadonnées de références qui sont plus bas dans la hiérarchie de la tâche.
   Par exemple, il se peut qu'il y ait un utilisateur assigné en lien avec la tâche. Donc <assignee> aura un tag à l'intérieur <User>.
   Si vous voulez la métadonnée username, « Créez un champ » dans la liste de champs du Outline (clique droit -> Créer champs) et vous mettez dans la description du champ son chemin XML (./assinee/User/username) et le champ saura ou la valeur se trouve à l'impression.
   (Attention! Le chemin peut-être différent, référez-vous au XML pour savoir où il se trouve).
3. Vous pouvez drag and drop vos champs dans le rapport, ou créer le champ à partir de la palette « Champ de texte ».
   Pour des titres ou étiquettes qui ne changent pas, vous pouvez utiliser « Texte statique ».
   Certains champs que vous allez utiliser peuvent contenir rien. (Exemple : dossier sans date de fermeture, le champ date de fermeture sera « null »). Dans ce cas-ci, au lieu d'avoir un champ avec la valeur « $F{date} » mettre le suivant :  
   $F{date} !=null && !$F{date}.equals("null") ? $F{date}: ""
4. N'oubliez pas de faire enregistrer (Ctrl+S) et sauvegarder votre projet;
5. Vous pouvez regarder le résultat avec prévisualiser.

6. Créer une table

1. Dans la palette, prendre la table, et créer la table dans votre bande de détail. Il est recommandé d'avoir une bande séparée;
2. Prendre une table avec un nouveau dataset et créer un ensemble de données vide;
3. Laisser la connexion au dernier choix. Appuyer sur « Finish the wizard »;
4. Une fois terminé, il y aura une table de base. Vous pouvez ouvrir un onglet de la table et de ses éléments en double cliquant dessus;
5. Vous allez avoir plusieurs sections :
   1. Pour faire une table minimale, je vais enlever les pieds de table, l'en-tête de table et les pieds de colonne. Vous pouvez ajouter une colonne par un clique-droit sur l'en-tête et prendre l'option ajouter une colonne;
   2. Vous pouvez changer le style par clique-droit de la table et prendre l'option « change table style »;
   3. Ajuster les largeurs des colonnes comme vous le souhaitez. Ajouter « Une cellule de colonne » et aller dans la propriété de « cell » et mettre la largeur. Vous pouvez insérer les étiquettes des colonnes;
   4. Pour avoir les éléments de métadonnées des dossiers de la tâche, il faut changer le dataset de la table. Simplement retourner sur le projet du rapport et cliquer sur la table une fois; Dans Dataset, on change pour JRDatasource et insérer la ligne suivante :
      ((net.sf.jasperreports.engine.data.JRXmlDataSource)$P{REPORT_DATA_SOURCE})
      .subDataSource("//linkedDocuments/Document")
   5. « //linkedDocuments/Document » est le lien vers l'objet traité dans la table. Pour les documents liés d'une tâche, ce serait ce chemin. Vérifier dans le XML le chemin pour les autres listes de schémas que vous souhaitez; 
   6. Vous pouvez créer vos champs manuellement, simplement aller dans la liste de champs de la table et ajouter manuellement (clique-droit et créer champs). Suivre le format de cette prochaine image pour que le champ accède à la valeur;
   7. Prévisualiser vous donne un avant-goût du résultat. Aussi, vous pouvez exporter un PDF ou un word;

7. Ajouter une pagination

1. Dans les « composites Éléments », prenez l'élément « Numéro de page ». Vous pouvez simplement le glisser dans le pied de page;

8. Mettre une image

1. Prendre dans la palette un élément d'image;
2. Cliquer et faire la grandeur et largeur avec la souris dans le design. Prenez l'option « No image »;
3. Aller dans propriété et mettre la ligne suivante dans l'expression de l'image.

net.sf.jasperreports.engine.util.JRImageLoader.getInstance(new SimpleJasperReportsContext()).loadAwtImageFromBytes(javax.xml.bind.DatatypeConverter.parseBase64Binary("VOTRE BASE64 ICI"))

8.1 Aller chercher la base64 de l'image

1. Si vous avez votre image, allez sur le site suivant :https://www.base64-image.de/
   Si vous avez un meilleur site pour convertir une image en base64, faites comme bon vous semble. Prenez un PNG ou un JPEG, sinon il y aura des problèmes d'affichage.
2. Glisser l'image et appuyer sur « show code » lorsque la conversion est complète. Copier-coller le code Base64 en enlevant les éléments avant la première virgule;
3. Appuyer sur « copy to clipboard » pour copier;
   Vous pouvez enlever la partie à enlever seulement après l'avoir copié-collé ailleurs.
4. Coller la base64 dans la partie entre guillemets où vous venez juste de supprimer avant la virgule.
5. Vous pouvez vérifier qu'il fonctionne avec « prévisualiser »;

8.2 Fichier Jasper

1. Aller dans Projet -> Build All;
2. Un fichier jasper sera créé dans votre dossier de travail des étiquettes choisi au début du projet (ou se trouve le fichier du projet .jrxml);
3. Dans Constellio, retourner à la gestion des rapports et cliquer « Ajouter un modèle de rapport »;
4. Remplir les champs et ajouter le fichier Jasper;
5. Appuyer « enregistrer ».

Vous pourriez imprimer les rapports des tâches maintenant.