Discuter:Genj - Rapports - Fiches Individuelles-Familiales

Un article de Arvernes Wiki.


Sommaire

Installation I°) Téléchargement de ReportGedart.zip

Charger ce fichier [1] ici "Rapport de création de fiches de renseignements".
Décompressez le fichier dans votre répertoire GenJ.
qui peut être typiquement "C:\ProgrammeFiles\genJ"
ou "C:/Programme Files\genJ\genealogyJ\"
ou ""volumeX":\genJ\
c'est le répertoire contenant par défaut le fichier run.bat de lancement.
Important
Si le rapport Fiche de renseignements n'apparaît pas dans la section "En Développement" du menu des Rapports de GenJ, essayez de mettre à jour votre version java, en récupérant sur le site de Java pour la version "Linux" et ici pour la version "Windows".

Installation II°) Création d'arborescence (dans /gedart)

1°) Sous Windows, (avec le run.bat généré par défaut), le répertoire des paramètres de GenJ est C:\Documents and Settings\votre_nom\Application Data\GenJ}}.

a) dans C:\Documents and Settings\votre_nom\Application Data\GenJ 

créer un repertoire "/gedart"
dans "/gedart" créer le répertoire "/templates"
dans "/templates", créer les répertoires,
     "/Findivid/",
     "/Ffamiliale/",
     "/Tabeau5G/",     
     "/Fpatronym/",
     "/zouli/"

b) Dans C:\Program Files\GenealogyJ\report\gedart\}} copier les 9 fichiers ayant l'extension .vm, 

    famSheet.vm,
    indexSheet.vm,
    index.vm,
    indiSheet.vm,
    startDoc.vm,
    TOC.vm,
    endDoc.vm,
    report.vm,
    sumSheet.vm

c) Coller ces 9 fichiers dans chaque répertoire final créé en a) 

 exempleC:\Documents and Settings\votre_nom\Application Data\GenJ/gedart/templates/Findivid/


Installation III°) Importation des modèle choisis parmi les propositions

      d1°) Fiche individuelle :
     :*indiSheet_island.zip - v.1.06 (archive au format zip) [2]

      d2°) Fiche familiale :

      d3°) Tableau d'arbre d'ascendance :

Copier et dézipper le modèle qui vous convient dans le répertoire final correspondant créé en a) Répondre "oui" chaque fois qu'il est demandé d'écraser la fiche "indiSheet.vm" ou "famSheet.vm" ou...


Exploitation I°)

sur un écran éditeur, menu rapports choix: fiche de renseignements onglet: Option, choix du modèle (patro , indiv, arbre...) 

       valider en cliquant nimporte où.
       fermer

revenir sur écran éditeur, menu rapports, choix: fiche de renseignements onglet résultat:

autre possibilité: Pour voir l'état obtenu, cherchez votre fiche où vous l'avez sauvegardée, "mes documents/..." ou "sortie des états/..." puis clic droit ouvrir avec votre logiciel Internet explorer ou Firefox ou autre...





à compléter ce 2°) windows serait mieux placé en 1°)
2°)Sous windows, si le fichier de démarrage de GenJ a été modifié (le fichier :run.bat), en ajoutant le paramètre -Duser.home=.,
le répertoire des paramètres de GenJ, est :"volumeX":\GenealogyJ\.genj\.
cette config devrait etre préférée ou systématique:

en cas de problème, les logiciels installés ou windows sont préservés: (pas d'intervention dans \Doc & Settings\)


Fin temporaire d'un premier essai de simplification.




déplacement provisoires de pages à simplifier ou repositionner en sous rubriques:

La Philosophie de ce rapport

Cette version est une réécriture complète du "Rapport Fiches Individuelles et Familiales". Le point de départ de cette refonte est que ce type de fiches doit pouvoir être facilement adapté à chaque cas particulier. J'ai donc pris la décision de fournir à l'utilisateur un moyen de créer ses fiches avec les informations qu'il souhaite et selon sa mise en page préférée. Il était évidemment hors de question que cette possibilité passe par une programmation comme sur les rapports actuels. Ce rapport s'appuie donc sur un système de modèle que l'utilisateur pourra changer à sa guise.

Afin de valider le concept, la version actuelle propose une fiche détaillée individuelle avec la plupart des informations (sauf les sources pour le moment) contenues dans le fichier gedcom. On retrouve donc les informations personnelles, état civil, parents, familles, conjoints, enfants, événements, personnes associées (parrains, marraines, témoins, ...) .

Le format de sortie est uniquement html pour l'instant.

Le rapport n'a pour le moment qu'une seule option: Inclure les principaux événements même vides Elle permet, si elle est activée, de ne pas cacher les éléments s'il sont vides.

Enfin, pour les curieux le modèle est le fichier indiSheet.vm

Ce rapport se lance soit à partir d'une sélection d'individus (par clic droit) soit sur le gedcom complet à partir de la fenêtre des rapports. Dans ce cas, l'affichage n'est pas automatique et vous devrez lancer votre navigateur web sur le fichier généré.

Enfin, pour installer ce rapport, il vous suffit de récupérer l'archive ci-dessus et de dé-zipper son contenu dans le répertoire d'installation de GenJ.


Des modèles de fiches

Comme ce rapport nous permet de présenter nos fiches individuelles et familiales comme on le veut (on peut rajouter des informations, changer la présentation, etc.), il peut être intéressant d'échanger entre nous les modèles que nous aurions pu faire.

Si vous avez fait une ou plusieurs fiches, et acceptez de partager votre réalisation avec les autres utilisateurs de GenJ, il vous suffit de m'envoyer un fichier zip que vous appelerez "indiSheet_votre_prénom.zip" ou "famSheet_votre_prénom.zip" (votre prénom est bien sûr à remplacer par votre propre prénom - ex: indiSheet_marcel.zip ou famSheet_marcel.zip) et dans lequel vous mettrez le fichier indiSheet.vm ou/et famSheet.vm.

Voilà les fichiers actuellement disponibles :

1°) Fiche individuelle :

2°) Fiche familiale :

3°) Tableau d'arbre d'ascendance :


Maintenant vous pouvez créer autant de modèles de fiches que vous le souhaitez. Pour créer un modèle personnel, if suffit de créer dans le répertoire .genj/gedart/templates un dossier portant le nom de votre modèle (par exemple .genj/gedart/templates/mon-modèle) et de placer dans ce dossier un fichier index.vm. C'est ce fichier qui servira à créer la sortie des données pour ce rapport. Vous pouvez vous inspirer des fichier *.vm fournis dans ce rapport pour créer les vôtres.

Des exemples de sortie

Vous pouvez voir sur les exemples ci-aprés, ce que l'on peut faire à l'aide de ce rapport.

Ces exemples sont basés sur des modèles que je me suis créés à partir des modèles que j'ai mis à votre disposition ci-dessus (fiches individuelle et familiale).

Ce sont des exemples concrets, donc tirés de ma propre généalogie. Il pourrait y avoir d'autres informations d'affichées sur ces sorties comme par exemple des choses sur l'inhumation, le baptême, un éventuel divorce, un contrat de mariage, des notes générales sur la personne, tous les remariages, etc, etc, mais les individus ou couples sur lesquels j'ai lancé le rapport n'avaient pas de telles informations dans leurs enregistrements.

Un lieu de débat et d'échange d'idées

Une page a été créée pour rassembler vos demandes, remarques, souhaits concernant ce rapport. Du travail doit être fait sur ce rapport comme l'a annoncé Daniel André son auteur, il est important que vous mettiez à profit cet espace pour donner votre opinion quelqu'elle soit. Elle sera prise en considération comme celle de chacun d'entre vous et une synthèse sera effectuée par Daniel pour son travail futur.

Page de synthèse des souhaits sur ce rapport

Petite FAQ sur ce rapport

Historique de ce rapport

Ce rapport est né par l'évolution du rapport ToDO (tâches à faire) que j'ai écrit il y a quelques temps et qui permet en outre de sortir des fiches individuelles et familiales sur les personnes ayant des tâches à faire afin, par exemple, de faciliter le travail aux Archives Départementales. Ce rapport est utilisé par plusieurs personnes et comporte un certain nombre de défauts:

  • tout d'abord il ne permet d'afficher les fiches que des personnes pour lesquelles il existe un TODO,
  • Ensuite il manque un certain nombre d'informations, et pas toujours les même selon les utilisateurs,
  • La façon de produire le fichier de sortie est assez rigide interdisant par exemple une présentation utilisant les < div > et les feuilles de style.

J'ai donc essayé de construire un rapport permettant de sortir les fiches individuelles et familiales que l'utilisateur souhaitait, en essayant d'adopter des choix permettant la plus grande liberté pour l'utilisateur. Je pense y être arrivé et c'est certainement déroutant compte tenu du manque d'information que vous avez.

Philosophie de ce rapport

Avec GenJ il existe une possibilité de réaliser des rapports car cela a été prévu comme cela par son concepteur et c'est l'une des principales raisons qui m'a fait adopter ce logiciel. Je cherchais en effet un logiciel pouvant tourner aussi bien sous linux que sous windows et qui permettait de réaliser ses propres rapports car je n'avait pas trouvé ce que je cherchais dans les outils que je connaissais. N'ayant pas du tout accroché sur LifeLines, je suis parti avec GenJ.

Cette possibilité de réaliser ses propres rapports est fantastique et est utilisée par un certain nombre de personnes que vous connaissez. Cependant le public concerné est un public de programmeurs car il est nécessaire d'écrire ces rapports en Java. L'utilisateur n'ayant aucune compétence ou connaissance ne peut rien faire sinon demander à une bonne âme de coder tel ou tel rapport ou bien modifier tel aspect (ajout d'information, présentation, ...). Je trouve cela dommage!

J'ai donc retravaillé mon rapport TODO en essayant de régler les problèmes que j'ai déjà évoqués pour aboutir à ce rapport qui est encore en développement mais dans un état parfaitement utilisable. Le nom interne de ce rapport est gedart.

Je ne vois pas le rapport dans la fenêtre des Rapports

Si le rapport Fiche de renseignements n'apparaît pas dans la section "En Développement" du menu des Rapports de GenJ, vous devez tout d'abord vérifier que ce rapport a été correctement installé:

  1. Déterminez le répertoire d'installation de GenJ (généralement GenealogyJ). C'est le répertoire contenant le fichier de lancement de GenJ (run.bat ou run.sh)
  2. Ensuite dans ce répertoire il doit y avoir un sous-répertoire "report";
  3. Dans ce sous-répertoire "report" il doit y avoir un sous-répertoire "gedart" dans lequel vous devez avoir tous les fichiers du rapport dont un fichier qui s'appelle "ReportGedart.class";
  4. Si ce n'est pas le cas, reprenez l'installation du rapport

Ensuite, vous devez redémarrer GenJ pour que le rapport soit reconnu.

Si, malgré tous cela, vous ne voyez pas le rapport 'Fiches de renseignements', commencez par vérifier votre installation de java.

Pour cela, allez voir ce que je mets sur la vérification de votre installation, dans les FAQ - j'ai la bonne version de java, mais ça ne marche pas

Comment fonctionne ce rapport?

Ce rapport est composé de deux parties:

  • une partie codée complètement en java et dont le rôle est de préparer les données que le rapport va devoir exploiter afin de fournir le résultat,
  • une partie présentation qui va permettre de générer le fichier voulu. Cette partie est appelée modèle et est destinée à pouvoir être modifiée par un utilisateur non programmeur afin qu'il puisse personnaliser ses sorties.

Que puis-je faire avec ces modèles?

Ce rapport a été conçu afin de ne mettre aucune (ou au moins le moins possible) limitation sur la sortie des informations dans le fichier de sortie résultat. Par exemple, bien que la version de modèle fournie avec le rapport serve à fournir un fichier html, un modèle peut très bien servir à créer un fichier texte, rtf ou csv.

Qui peut créer ou modifier un modèle

Tout le monde!

Comme je le disais plus haut, la conception du rapport gedart a été pensée de telle sorte que la création et la modification des modèles soit accessible à un plus grand nombre d'utilisateurs. Cependant il est nécessaire de comprendre un certain formalisme et être capable de modifier, par exemple, des fichiers de type html à l'aide d'un éditeur de texte. Il est évident que ces manipulations, même si elles ne sont pas très complexes seront difficiles pour certains utilisateurs plus néophyte. Nous essaierons cependant de rendre de plus en plus accessibles ces modèles.

Où les modèles sont-ils placés?

ATTENTION, on parle ici des modèles, pas du rapport lui-même.

Les modèles sont des sous-répertoires du répertoire répertoire_des_paramètres_de_genj/gedart/templates. Assurez-vous que ce dernier répertoire existe et créez le au besoin. Le nom de ce sous répertoire sera le nom de votre modèle. Ensuite, dans ce répertoire il doit y avoir un fichier index.vm. Si ce fichier n'existe pas, ce sous-répertoire ne sera pas reconnu comme modèle et ne sera pas présenté dans la liste des choix proposés dans les options du rapport. Pour cela, vous pouvez copier les fichiers .vm présents dans le répertoire du rapport.


Vous ne DEVEZ PAS avoir de sous-répertoire sous le répertoire "island".

Vous voulez mettre d'autres modèles? Facile, le processus ci-dessus doit être suivi. Vu que l'on a déjà fait la plupart des sous-répertoires, il ne nous reste que deux étapes à refaire, à savoir :

  • la création du sous-répertoire portant le nom du modèle (vous vous souvenez que tout à l'heure vous avez fait un sous-répertoire "island", et bien maintenant si votre nouveau modèle, s'appelle "chridan", et bien vous allez faire un sous-répertoire de "templates" qui s'appellera "chridan". Vous aurez donc quelque chose comme ça : C:\Documents and Settings\votre_nom\Application Data\GenJ\gedart\templates\chridan\
  • la copie de tous les fichiers .vm du répertoire du rapport, vers le nouveau sous-répertoire nouvellement créé "chridan".


2°) Sous Linux, lorsque l'on parle ici du répertoire .genj (donc répertoire dont le nom commence par un point), il s'agit du répertoire qui contient tous les paramètres de GenJ, donc tous les fichiers du genre genj.properties, genj-report.properties, genj.log, etc... Ce n'est pas votre répertoire racine de GenJ.

Si vous n'arrivez pas à repérer ce répertoire des paramètres, regardez ci-aprés, je vous explique comment faire pour le trouver.

Installation des modèles de fiches sous Windows :

Une expérience en direct live par notre ami phi31

L'installation des différents modèles, suppose dans un premier temps que l'on sache où sont situés les fichiers de configuration de GenJ sous Windows. En effet, les fichiers contenant les modèles doivent se placer et être décompactés à partir de ce répertoire des paramètres.

Donc question : Il nous faut trouver où GenJ positionne ses fichiers de configuration sous Windows.

Si vous ne savez pas où cela peut être, ou/et si vous n'avez pas activé l'option de GenJ qui vous permet de le déterminer, il faut commencer par là.

Ouvrez le menu "Visualisations", tout en bas, vous choisissez "Options", s'ouvre alors le menu des options de GenJ.

Regardez 7ème ligne
Regardez 7ème ligne

Dans la première partie de ce menu, cherchez une ligne qui s'appelle "Répertoire des paramètres de GenJ (user.home.genj)". Cliquez sur le petit bouton avec trois points, à droite en face de cette ligne. Il va falloir identifier/remplir cette case avec le chemin de l'explorateur Windows .

Vous pouvez simplement d'entrée taper dans le champ adéquat : 

"C:\WINDOWS\explorer.exe"

... et faire la recherche comme ci-dessous si cela ne fonctionne pas !

Vous devez pour cela vous promener dans l'arborescence pour trouver l'exécutable de votre choix, en le recherchant comme ci-dessous :

Commencer par "Menu Démarrer"
Commencer par "Menu Démarrer"

Donc avec votre souris, vous cliquez sur le bouton "Démarrer" (c'est celui qui vous sert pour arrêter votre session Windows (éteindre votre ordinateur)).

Puis dans le menu déroulant qui s'ouvre, vous allez sur la ligne "Exécuter".

Vous confirmez en cliquant sur cette ligne.

Puis faire "Executer"
Puis faire "Executer"

Il s'ouvre une fenêtre dans laquelle apparaît un champ.

Il est possible que ce champ soit déjà rempli avec une commande, genre "regedit", ou autre chose. Vous devez mettre dans cette ligne "Ouvrir", la commande "cmd"

Vous confirmez par un clic sur "OK".

Ouverture d'un Terminal - le répertoire vous est indiqué
Ouverture d'un Terminal - le répertoire vous est indiqué

Dans la fenêtre qui s'ouvre, vous devez taper plusieurs commandes : 

cd \ 
cd windows
dir explorer.exe

(n'oubliez pas l'espace entre "cd" et "\" dans la première commande)

Là vous devriez voir quelque chose qui s'affiche qui ressemble à la capture d'écran ci-contre.

Si tel est le cas, cela veut dire que votre exécutable "explorer.exe", se trouve bien sous "C:\WINDOWS\explorer.exe"


Une fenêtre s'ouvre vous présentant tous les fichiers de configuration de GenJ. Leur emplacement est indiqué dans le champ "dossier" ( en haut à l'intérieur de la barre "bleue" - selon votre présentation). Notez le bien, c'est là que va se positionner l'arborescence nécessaire à l'installation des fiches.

Cette manipulation, vous n'avez à la faire qu'une fois.

résultat sous XP
résultat sous XP


Installation des modèles de fiches sous Linux :

L'installation sous Linux ressemble terriblement à l'installation sous Windows.

Là encore, il va falloir trouver où GenJ positionne ses fichiers de configuration sous Linux.

Si vous n'avez pas d'idée où cela peut être, ou/et si vous n'avez pas activé l'option de GenJ qui vous permet de le déterminer, il faut commencer par là.

Vous ouvrez le menu "Visualisations", tout en bas, vous choisissez "Options". Il s'ouvre devant vous le menu des options de GenJ.

Dans la première partie de ce menu, vous trouverez une ligne qui s'appelle "Répertoire des paramètres de GenJ (user.home.genj)". Cliquez sur le petit bouton avec trois points, en face de cette ligne. Il va s'ouvrir la fenêtre dont la capture d'écran est ci-dessous :

Vous pouvez vous promener dans l'arborescence pour trouver l'exécutable de votre choix, mais vous pouvez aussi tout simplement taper dans le champ adéquat "/usr/bin/konqueror". Oh miracle de l'informatique, crac boum hue, une fenêtre s'ouvre vous présentant tous les fichiers de configuration de GenJ. Leur emplacement est indiqué dans le champ "Emplacement" de Konqueror. Notez le bien, c'est là que va se positionner l'arborescence nécessaire à l'installation des fiches.

Bon, ça c'est pour KDE, mais comme quelqu'un me l'a gentillement fait remarquer, il existe aussi des gens sous Gnome. Et donc pour satisfaire à la population sous cet environnement graphique, à la place de Konqueror, vous pouvez mettre /usr/bin/gnome-open

Cette manip que vous avez faite, vous n'avez à la faire qu'une fois. Maintenant, vous êtes tranquille.

Nous en sommes à deux minutes de la fin de la configuration, ne vous impatientez pas, c'est bientôt fini, le plus dur est fait. Image:Smiley clin oeil.png

Maintenant, vous avez le choix :

  • Ou bien vous êtes un adepte de la ligne de commande, et là je n'ai pratiquement rien à dire, vous en savez autant que moi. Il vous suffit de mettre le fichier .zip contenant le modèle dans le répertoire de vos paramètres, et de lancer sa décompression du genre "unzip indiSheet_chridan.zip". Tout va aller se mettre où il faut.
  • ou bien vous faites un glisser/déposer par interface graphique interposée, et vous mettez le fichier contenant le modèle dans ce répertoire des paramètres. Là vous lancez sa décompression avec votre outil adéquat préféré, et vous être "up and running".

Elle est pas belle la vie !!!!

Vous allez pouvoir profiter de ce superbe rapport et des fiches que les G.U.S. [4] ont fait pour vous.

Comment fonctionne ce système de modèles?

Un modèle est donc un répertoire contenant un fichier index.vm. Le fichier index.vm est fondamental et son rôle est justement, comme décrit plus haut, d'effectuer le lien entre la logique de préparation des données effectuée par le rapport et la présentation des données effectuée par le modèle.

Exemples de modèles

Le premier exemple est le modèle fourni avec le rapport. Attention toutefois, ce modèle est assez complexe à comprendre! pour pouvoir créer votre premier modèle à partir des fichiers fournis avec le rapport il suffit de créer un répertoire .genj/gedart/templates/monmodele et de mettre dans ce répertoire tous les fichier *.vm du répertoire GenealogyJ/report/gedart. ensuite, après un rechargement éventuel du rapport, vous aurez un autre choix (monmodele) dans les options du rapport. Vous pouvez alors modifier le modèle monmodel à votre guise.

Quelle est la syntaxe des modèles?

Les modèles utilisent un moteur de génération de fichier appelé velocity dont la documentation est disponible ici.

Quelles sont les informations généalogiques utilisables par un modèle?

Les informations disponibles sont principalement tous les individus et/ou les familles sur lesquelles le rapport a été lancé.

Plus d'informations à venir, consultez les exemples fournis en attendant.

Notes

  1. ↑ le copier le dans le répertoire racine de GenJ et dézippez le.
  2. ↑ 2,0 2,1 2,2 2,3 Fait par Island
  3. ↑ 3,0 3,1 3,2 3,3 3,4 3,5 3,6 3,7 3,8 3,9 Fait par Daniel Durand
  4. ↑ Erreur de citation 8 ; No text given.
Récupérée de « http://www.arvernes.com/wiki/index.php/Discuter:Genj_-_Rapports_-_Fiches_Individuelles-Familiales »