JGenea permet de générer des états relatifs aux informations
saisies ou calculées. Ces états peuvent être générés dans plusieurs
formats et cette liste diffère suivant les types d'états mais peut
être étendue.
De manière général, les états peuvent être générés depuis
l'interface graphique ou depuis la console ( avec des possibilités
d'automatisation avec un fichier de paramètres ). Dans la console,
tous les états sont générables avec la commande generer.
Il est également possible de paramétrer l'aspect des états
générés ( sauf pour les documentations relatives à une branche ) via des
fichiers de style. Pour ce faire, des connaissances en XML et XSL sont
nécessaires pour la génération HTML, et en XML et XSL-FO pour la
génération PDF. Lorsque vous voulez faire des générations spécifiques,
il vous suffit de dupliquer le bloc de configuration de l'état en
spécifiant vos fichiers dans les paramètres.
La première partie montre la liste des états pour les registres
par défaut dans la distribution, et la seconde la liste de ces mêmes
états comprenant un état personnalisé avec de nouveaux fichiers de
style.
<etat id="registres-html" type="registres" alias="Liste des registres"
output="html">
<classe>org.jgenea.etats.registres.html.RegistresEtatImpl</classe>
<param nom="template-registres-communes">../conf/templates/
registres.communes.xsl</param>
<param nom="template-registres-commune">../conf/templates/
registres.commune.xsl</param>
<param nom="template-registres-signets">../conf/templates/
registres.signets.xsl</param>
<param nom="template-registres-actes">../conf/templates/
registres.actes.xsl</param>
<param nom="nb-lignes">20</param>
</etat>
<etat id="registres-pdf" type="registres" alias="Liste des registres"
output="pdf">
<classe>org.jgenea.etats.registres.pdf.RegistresEtatImpl</classe>
<param nom="template-registres">../conf/templates/
registres.xslfo</param>
<param nom="debug">oui</param>
<param nom="nb-lignes">20</param>
</etat> |
L'état personnalisé est le dernier des trois et a pour
identifiant "registres-html-perso".
<etat id="registres-html" type="registres" alias="Liste des registres"
output="html">
<classe>org.jgenea.etats.registres.html.RegistresEtatImpl</classe>
<param nom="template-registres-communes">../conf/templates/
registres.communes.xsl</param>
<param nom="template-registres-commune">../conf/templates/
registres.commune.xsl</param>
<param nom="template-registres-signets">../conf/templates/
registres.signets.xsl</param>
<param nom="template-registres-actes">../conf/templates/
registres.actes.xsl</param>
<param nom="nb-lignes">20</param>
</etat>
<etat id="registres-pdf" type="registres" alias="Liste des registres"
output="pdf">
<classe>org.jgenea.etats.registres.pdf.RegistresEtatImpl</classe>
<param nom="template-registres">../conf/templates/
registres.xslfo</param>
<param nom="debug">oui</param>
<param nom="nb-lignes">20</param>
</etat>
<etat id="registres-html-perso" type="registres" alias="Liste des registres"
output="html">
<classe>org.jgenea.etats.registres.html.RegistresEtatImpl</classe>
<param nom="template-registres-communes">../conf/templates/
registres.communes.perso.xsl</param>
<param nom="template-registres-commune">../conf/templates/
registres.commune.perso.xsl</param>
<param nom="template-registres-signets">../conf/templates/
registres.signets.perso.xsl</param>
<param nom="template-registres-actes">../conf/templates/
registres.actes.perso.xsl</param>
<param nom="nb-lignes">20</param>
</etat> |
Note
Il est à noter que les chemins des fichiers de style peuvent
être relatifs par rapport au répertoire de lancement de
l'application ( [JGENEA_INSTALL_DIR]/bin ),
soit absolus.
Note
Pour débuger les fichiers de style, il est utile d'avoir le
fichier XML sur lequel se baser. Pour ce faire, il suffit
d'ajouter le paramètre suivant dans votre état personnalisé:
<param nom="debug">oui</param> |
Dans l'interface graphique, le choix du type de génération se
fait lorsque l'on veut lancer la génération. Dans la console, le
principe est le même sauf que s'il n'y a qu'un seul type,
celui-ci est utilisé par défaut.
Tableau 13.1. Types de générations
| Type d'états | HTML | PDF |
|---|
| Documentations | - | x |
| Arbres | - | x |
| Personnes | x | - |
| Tables | x | - |
| Actes & documents | x | - |
| Recherches | x | - |
| Registres | x | x |
| Signets de registres | x | - |
