Data capture with GeneWeb

From GeneWeb
Revision as of 19:05, 30 October 2015 by Henri83 (Talk | contribs) (Supprimer une Famille)

Jump to: navigation, search
150px-Geographylogo svg.png Language: English • français

This page describes in details how to use the person and family forms to enetr your data into a GeneWeb genealogy base through your web browser. If the owner/manager of the base has granted you permission to do so (through a generic or a personal wizard password), the welcome page will offer the possibility to create a new family, and each individual page will propose many personal and family related actions.

Inetrnally, a GeneWab base is structured around persons and families,

  • personal records keep informations specific to an individual (first-name, last_name, dates and locations of birth and death, events, etc ...)
  • family records identify parents and children regrouped into a "family".
  • both records can also link to other persons such as witness, godparents, etc ...

Before creating personal records, it is important to fully understand the notion of homonyms!

All the data entered in a base is captured through a personal or a family update form.

Triggering an update form

If you have understood the section above, you may proceed through:

  • Add a family on the welome page
  • Update an individual on the personal page

Note here that it is not possible to directly "add a person" in GeneWeb. Such addition happens in GeneWeb through three mechanisms:

  • as parents of an existing person, or in a new family
  • as children in a family at creation or modification times
  • as spouse of some existing parent
  • as witness of an event, or relation of a person (godparents, adoptive parents, etc)

When exploring the update forms, you will see that for each person related capture zone, you have the possibility to create or to link:

  • the first case creates a new person bearing the specified first-name last-name. If an homonym exists you will be warned
  • the second case links to an existing person for which you must know the first-name, occurence and last-name. If you mistype any of these informations, and you happen to hit an existing eprson, GeneWeb cannot detect your error!!

At the welcome page, brings you directly to the family update form. See #Update a family

In a personal page, clicking on the "update" button will open a choice page proposing to:

  1. if allowed by the owner/manager of the base (see configuration file):
  2. If the person is married, for each couple you may:
  3. If there are multiple unions, a "invert" button will appear, and if two unions between the same persons appear twice in sequence, a button "Merge" will appear.
  4. In all cases, a last button will propose to add a family with the person pre-recorded as one of the parents:
  5. If there are children associated with this person, a button "Change children last-names" will offer the possibility to change the name for all children without having to do it child by child:

lastly, if the person does not have parents recorded in the base, a button will offer to "Add parents", the last_name of the father being pre-recorded in the appropriate field:


  • all these choices lead you to a form, or ultimately to a confirmation page. Nothing is definitive until you hit the last Ok
  • in all forms, some fields may be pre-recorded. THis is just a convenience, and you are allowed to change that information, but this is valid only for persons being created. For instance, when you add a child into a family, the names and data of the other children appear in the form, but editing these data has no effect at all on the base!!

Some important details

These points are highlighted as they are opportunities for errors!!

Modyfying the first-name or last-name of a child

Example, in the family of "Bob Thomson" and "Alice Barr", a child was wrongly named "Robert" when his first-name really is "Philip".

What should be done:

  • Open the "Person" page page for "Robert Thomson" (assuming occurence is "0"), and then modify the data that needs correction as described in Update a person, then click Ok.

What should NOT be done:

  • Open the "Family" page for Bob or Alice, select "Update family" and change the first name of Robert in this page.
    • This would cut the parents/son relationship between Robert and his parents.
    • This would also create a new person called Philip Thomson, unless a "Philip Thomson" already exists in which case an error will be reported.

Add a child to a family

For instance, in the family of "Bob Thomson" and "Alice Barr", you want to add Hubert as a new child.

What should be done:

  • Case 1: Hubert does not exist: Open the "Family" page for Bob or Alice, select "Update family" and check the mark to create a new a child at the position you think is appropriate (see [[#Update family}}).
  • Case 2: Hubert exists:
    • same as case 1, but link to Hubert rather then creating him.
    • alternative: open the "Person" page of Hubert and select "Add parents", but make sure you link to Bob and Alice rather than create a new Bob and a New Alice which you would have to merge later!!

What should NOT be done:

  • select create when link should be used instead. see the #Create or link? sub-section.

You should now be aware of these two forms "Add family" and "Update family" which have quasi identical looks, but behave slightly differently in a very important way: as their names suggest, "Add family" adds one to the family count in the base while "Modify family" does not. So if you made a mistake while adding a family, do not back track with your browser and edit your mistake! You must proceed and now "Modify" family you just created.

Apart from this "slight" behavioral difference, the two forms offer an identical interface:

Add or Modify a family

Any pre-recorded data in the form can be edited, modified, suppressed. Those actions will not be valid until the Ok button is hit.

Any zone making reference to a person has the three input bars for first-name, occurnece and last-name, and has the important radio button to select "Create" or "Link".

remember that

  • when linking, accents are not necessary
  • additions and corrections for a person to be linked, although doable,, will no be taken into account at Ok time. These additions and corrections must be done through the "Person" page of the existing person.

When creating a child, to a family, you are given the opportunity to specify:

  • sex
  • dates and location for birth and death

Any other personal information must be entered through the "Update person" mechanism.

Any child whose first-name is empty is ignored

Any child whose last-name entry is empty will inherit that of his or her father.

Other updates

  • To add a child, if no child area is available, check one of the "Add a child (n)" at the appropriate place. A new form with additional children area will be shown. None of the previous edits will have been taken into account. This will happen at the last Ok button selection.
  • If the birth dates of the children are known, GeneWeb will sort them in the proper order.
If the dates are not known, you can rearrange the order bu "inverting" adjacent children, or by exchanging their first-names with copy/paste. In this last case, remember to select "Link" rather that "Create" for any child that pre-existed.
  • To suppress a child, blank out his first-name zone.


The validation of changes will happen only when selecting the Ok button. No addition/suppression will have been taken into account before that step.

This validation step may trigger two king of reports:

  • "Addition or modification of a family". You will be shown a short summary of the family (parents, children with some compact dates), and possibly some comments about the family members (missing sex indication, wrong order, ...)
  • Error:
The error page will inform you of its exact nature. You can back-track with the browser, edit a correction and validate again. You can also quit. This leaves the base in the state it was before you started this update.
One typical error is name conflict. At this point you can either back-track and edit appropriately the names and occurence, or create the person.

Suppressing a family

This form is reached from the "Family" section, then "union with xx", then "Suppress family". It contains only the Ok button, for your confirmation. If you do confirm, then all the links between the familymembers will be severed, but no person will be removed from the base. The only data lost will be that relative to the specific union event (marriage/divorce dates and places, and withesses ...).

One potential result of this action is to create "isolated" persons, that is persons belonging to no family (as child, parent or spouse), or no longer witness. These persons will disappear from the base at the next clean action!

One method to detect such persons (but possibly not all), is to click on the last-name of one of the former family members (you can always backtrack with your browser, and "see" those names in your window. The URL links to their personal pages are still valid!!). Clicking of such a last-name will display all its bearers, giving you a chance to spot isolated former children. treating witnesses with the same appraoch is harder.

Modifier une Personne

Vous tomberez sur ce formulaire à partir d'une page personnelle après avoir cliqué sur "Mise à jour", puis "Modifier". Le formulaire sera prérempli de toutes les informations individuelles de cette personne.


Toutes les zones (préremplies ou non) peuvent être remplies, effacées ou modifiées. Quand on a rempli, effacé ou modifié ce qu'on juge nécessaire, il faudra aller en fin de formulaire et valider le formulaire en cliquant sur "Ok".

Un certain nombre de boutons contiennent "Insérer/…" : "Insérer/Surnom", "Insérer/Alias", etc.

Attention : ce n'est pas pour indiquer d'ajouter le surnom ou l'alias, etc, à la personne, mais pour demander un nouveau formulaire avec une place réservée pour un autre surnom, un autre alias, etc.

Ainsi, si vous faites "Ok" après avoir sélectionné un ou plusieurs de ces boutons, un nouveau formulaire plus gros vous sera proposé et aucune modification ne sera faite.

Si, donc, après un "Ok", vous voyez encore un formulaire de modification, c'est que votre modification n'a pas été prise en compte (pas encore), et ce, même si vous avez rempli des tas de zones.

Différents champs

Remarquez bien le sens des différents champs, en particulier l'usage de "nom public", "qualificatif", "alias", etc qui ont chacun des sens bien précis.

  • Prénom et patronyme ont les sens habituels qu'on leur donne. Avec numéro, la personne a une "clé d'accès" unique comme indiqué au début de ce chapitre.
Il est conseillé de mettre le prénom d'usage dans la zone prénom. Les autres prénoms (prénoms complets, autres prénoms possibles, autres orthographes de prénoms, surnoms pour les proches) doivent plutôt aller dans les zones "alias" ou "autre(s) prénom(s)" (voir ci-dessous). Les noms avec numéro des personnes nobles et royales doivent aller plutôt dans la zone "nom public".
Ceci parce que le prénom est comptabilisé dans la liste des prénoms. On peut ainsi savoir quel est le prénom le plus fréquent, voir quelles sont les personnes portant le même prénom, etc. Les autres sortes de prénoms risqueraient là de se trouver en un seul exemplaire et dépareilleraient l'ensemble.
  • Nom public est le nom par lequel la personne est la plus connue. Exemple : "Louis XIV" (son prénom étant "Louis" et son patronyme "de Bourbon").
Les personnes ayant un nom public sont accessibles dans la navigation par ce nom.
S'il y a un nom public, il sera affiché comme titre de sa fiche personnelle, à la place du "prénom patronyme", lesquels sont relégués en plus petit, en dessous.
  • Image est un fichier ".gif", ".jpg" ou ".png" associé à la personne et qui sera affiché dans sa fiche personnelle. Ce peut être une adresse URL (commençant par "http://…") ou juste un nom de fichier, que le système cherchera dans le répertoire "images", sous-répertoire "base" (où "base" est le nom de la base) au moment de l'affichage.
Si vous ne précisez pas de nom de fichier, il y a un nom par défaut.
Ce nom est constitué : du prénom, d'un point, du numéro, d'un autre point, du nom de famille, tout en minuscules, sans accents et tous les caractères qui ne sont pas des lettres sont convertis en caractère souligné ("_").
Exemple, la personne nommée "Anne-Cécile Dupont de Nemours" aura pour nom d’image par défaut :
GeneWeb cherchera un fichier portant ce nom suivi de ".gif", ".jpg" ou ".png" dans le répertoire des images de la base cité ci-dessus.
  • Qualificatif est un sobriquet attaché aux personnes célèbres. Ainsi "le Gros" dans "Louis VI le Gros".
Les personnes sont accessibles par ce qualificatif en lieu et place de leur nom de famille. Ainsi "Louis VI le Gros" est accessible par "Louis VI" (nom public), "Louis VI le Gros", "Louis le Gros", "Louis Capet", etc. Notons que "le Gros" n'est néanmoins pas considéré comme un nom de famille en soi.
Il peut y avoir plusieurs qualificatifs : ainsi "Guillaume le Conquérant" est dit aussi "Guillaume le Bâtard". Il y faudra donc une zone "qualificatif" contenant "le Conquérant" et une autre contenant "le Bâtard". D'où l'utilité de "Insérer/Qualificatif".
S'il y a un qualificatif, le nom public (ou le prénom s'il n'y a pas de nom public) suivi du qualificatif seront affichés comme titre dans sa fiche personnelle, à la place du "prénom patronyme", qui seront relégués en plus petit en dessous.
  • Alias est un nom par lequel la personne est connue mais sans que cela lui tienne lieu de prénom alternatif (comme le "nom public" par exemple).
Ainsi "Aurore Dupin" est connue sous le nom "George Sand". De même, "Anne-Marie d'Orléans", fille de "Philippe Ier" et nièce de "Louis XIV" est dite "Mademoiselle de Valois".
Notons que l'alias forme un tout : il n'est pas question d'accepter des combinaisons telles que "George Dupin" ou "Aurore Sand", "Anne-Marie de Valois" ou "Mademoiselle d'Orléans".
S'il y a un ou plusieurs alias, ils sont affichés en lettres grasses en dessous du titre, mais en plus petit.
  • Prénom alias peut avoir plusieurs usages :
    • Ce peut être les prénoms complets de l'état civil.
    • Ce peut être les petits noms utilisés parmi les proches. Ainsi "Bobby" à la place de "Robert".
    • Ce peut-être un autre prénom ou le même prénom avec une orthographe différente, dans le cas de personnes très anciennes dont on n'est pas sûr du prénom, ou dont le prénom a été écrit différemment selon les sources.
    Il peut y avoir plusieurs "prénom alias".
Les "autres prénoms" peuvent être utilisés en lieu et place du prénom dans les requêtes, mais ne sont pas considérés comme des prénoms en soi, c'est-à-dire qu'ils ne sont pas comptabilisés dans les listes par prénoms.
S'il y a des "autres prénoms", ils sont affichés dans la fiche personnelle, en petites lettres sous le titre.
  • Nom alias peut servir de patronyme alternatif, si on veut mettre une autre version du patronyme, par exemple, avec une autre orthographe. Son usage n'est pas fréquent.
  • Naissance permet d'indiquer dates et lieux de naissance et de baptême. Il ne présente pas de problème particulier.
  • Décès permet d'indiquer les informations sur le décès. Pas de problème particulier à part la notion de "choix automatique" que nous allons expliciter.
Le "choix automatique" est présent quand la sélection du premier menu de la zone "décès" affiche un "-". Il indique qu'on ne sait pas si cette personne est décédée ou non.
Dans ce cas, si vous n'indiquez pas de date ni de lieu de décès, le système choisira pour vous le fait que la personne est décédée ou non en fonction de sa date de naissance : si elle a moins de 80 ans, il décidera "non décédé", entre 81 et 120 ans, il décidera "ne sais pas", et à plus de 120 ans, il décidera "décédé".
Si ce choix automatique ne correspond pas, vous pouvez sélectionner vous-même le bon cas dans ce premier menu, à la place du "-" affiché.
Remarquez que les personnes dont le décès est "ne sais pas" ne verront pas leur âge calculé dans leur page personnelle ni dans les anniversaires. Donc si une personne a entre 80 et 120 ans et n'est pas décédée, sélectionnez "non décédé".
  • Occupation contient la profession. Si vous voulez mettre un titre de noblesse, utilisez plutôt les champs "titre", qui suivent.
  • Titres contient les titres de noblesse. Il peut y en avoir plusieurs. Pour avoir un formulaire avec d'autres places pour les titres, cliquez sur un ou plusieurs "Insérer/Titre", allez en bas du formulaire et faites "Ok".
Les titres sont décomposés en deux parties : le titre lui-même et le lieu. Le titre lui-même contient la dénomination : "comte", "duc", "roi", etc. Le lieu contient le complément : "d'Anjou", "de Bourgogne", "de France", et. etc.
Notez la particule : à l'affichage, on verra une combinaison de la dénomination et du lieu : "comte d'Anjou", "duc de Bourgogne", "roi de France" qui seront des zones cliquables, permettant de voir toutes les personnes de la base ayant ce titre.
Mais la séparation entre ces notions permettra de sélectionner, par exemple tous les "comte", tous les "duc", tous les "roi", et inversement, tous les titres finissant par "d'Anjou", "de Bourgogne", "de France", etc.
Le champ "nom" permet de mettre un nom public associé au titre. Ainsi "Charles Quint" s'appelle "Charles Ier" en tant que "roi d'Espagne", "Charles IV" en tant que "roi de Sicile", etc.
Le champ "N-ième" est utilisé pour les titres dénommés avec leur numéro. Exemple : pour le "3e comte de Warwick", on pourra mettre "3". Ne pas confondre avec "Louis XIV" dont le numéro indique que c'est le 14e "Louis" de la lignée, et non pas le 14e "roi de France".
Le bouton "Titre principal" permet d'indiquer, quand on affiche cette personne de façon simplifiée (dans la page de son épouse, par exemple, ou dans celles de ses enfants), quel titre doit être affiché. Cela n'a d'importance que s'il y en a plusieurs.
Les deux champs suivants donnent les dates de début et de fin de règne.
Pour supprimer un titre, il suffit d'effacer le contenu du premier champ "Titre".
  • Accès permet de préciser l'accès aux informations personnelles. Ceci s'applique aux personnes "actuelles", c'est-à-dire dont les dates (naissance, décès, etc.) sont inférieures à la valeur définie par private_years= (150 ans par défaut dans a.gwf) :
    • Par défaut, les personnes ayant un titre de noblesse ou dont un des parents a un titre de noblesse sont considérées comme des personnes "publiques" et leurs informations personnelles sont toujours affichées.
    • Si on sélectionne "public", les informations personnelles sont toujours affichées, que la personne ait des titres de noblesse ou non.
    • Si on sélectionne "privé", les informations personnelles ne sont pas affichées, même si la personne a des titres de noblesse.
    Pour les "magicien" ou "amis" (contrôlés par mots de passe), les informations personnelles sont toujours affichées.
  • Notes contient les notes sur la personne. À l'affichage, le texte sera affiché en continu, même si vous mettez des sauts de ligne. Pour qu'il y ait un passage à la ligne, mettez "<br>" là où vous voulez des sauts de ligne.
  • Sources permet de noter des informations courtes sur l'origine de vos informations : un nom, un sigle, un titre de livre, un code à vous. Vous saurez ainsi d'où vous tenez vos informations.

Il n'est pas prévu pour des informations longues, style "recopie du document trouvé à la mairie" : il faudra pour cela utiliser plutôt le champ "Notes" ci-dessus.


La validation se fait quand vous faites "Ok". Tant que vous ne l'aurez pas fait, aucun changement n'aura lieu dans la base.

Remarquez bien aussi, comme il est dit plus haut, que si vous avez sélectionné un ou plusieurs "Insérer/…", ce sera juste un nouveau formulaire qui sera proposé et non pas la validation proprement dite.

Quand la validation est vraiment faite, vous devez voir apparaître une nouvelle page, dont le titre va être :

  • Soit : Personne modifiée
Vous devez y voir le nom de la personne sur laquelle vous allez pouvoir cliquer.
Vous y verrez peut-être également des remarques. Elles concernent des incohérences de dates. La modification sera faite tout de même, mais il est préférable de les corriger.
En cliquant sur la personne, vous verrez apparaître sa fiche personnelle. Mais votre mise à jour ne sera pas forcément visible. Les navigateurs Web conservent fréquemment en mémoire les pages déjà vues, et vous donneront probablement l'ancienne version. Faites alors "recharger la page" dans votre navigateur pour voir réellement vos modifications.
  • Soit : Erreur
La page indiquera l'erreur rencontrée. Revenez alors en arrière et corrigez. Vous pouvez aussi abandonner la modification… en ne faisant rien et en vous contentant de vous remettre à naviguer dans la base.
Si l'erreur vous indique que la personne existe déjà, c'est que vous avez modifié le prénom, le patronyme ou le numéro (vous avez parfaitement le droit de le faire), mais que votre nouveau choix entre en conflit avec une autre personne de la base.
Solution : revenez en arrière et changez le numéro. Remarquez que la page d'erreur vous a indiqué le premier numéro libre, donc disponible. Vous pouvez choisir celui-là ou un autre. S'il y a plusieurs personnes ayant ce même nom, leur liste est donnée.

Supprimer une Personne

Vous tomberez sur ce formulaire à partir d'une page personnelle après avoir cliqué sur "Mise à jour", puis "Supprimer".

Le formulaire ne contient que la case "Ok" pour vous permettre de le faire vraiment. Vous pouvez encore vous rétracter.

Si vous faites "Ok", une nouvelle page apparait avec juste le titre "Personne supprimée".

La personne n'est en fait pas tout à fait supprimée. Ses informations personnelles sont simplement effacées (y compris son prénom et son patronyme) ainsi que sa connexion avec ses parents.

Mais il subsiste toujours une "entité personne" reliée à son éventuel conjoint et à ses éventuels enfants.

Envoyer une image

Vous tomberez sur ce formulaire à partir d'une page personnelle après avoir cliqué sur "Mise à jour", puis "Envoyer image", à condition que le propriétaire de la base en ait donné l'autorisation, et que le champ "image" de la personne soit vide.

Il s'agit d'envoyer un fichier "gif", "jpeg" ou "png" qui sera associé à la personne. Si cette personne avait déjà une image, celle que vous enverrez la remplacera.

Note : si le champ "Image" de la personne n'est pas vide, vous n'aurez pas accès à "envoyer image". Si vous voulez le faire, faites "Mise à jour" et "Modifier personne" et effacez le contenu du champ "image".

Supprimer une image

Vous tomberez sur ce formulaire à partir d'une page personnelle après avoir cliqué sur "Mise à jour", puis "Supprimer image", à condition que le propriétaire de la base en ait donné l'autorisation.

Si vous cliquez sur "Ok", l'image associée à la personne est supprimée.

Changer les noms des enfants.

Vous tomberez sur ce formulaire à partir d'une page personnelle après avoir cliqué sur "Mise à jour", puis "Changer noms des enfants".

Tous les enfants de la personne sont affichés. Il est possible de modifier le prénom, le patronyme et le numéro de chaque enfant.

Une facilité intéressante : si on supprime le nom de famille d'un enfant, ça prendra automatiquement celui du parent.

Cela peut être commode pour changer le nom de famille de toute une branche : on change avec "modifier personne" le nom de famille de l'ancêtre. Puis on applique "changer nom des enfants" sur l'ancêtre en supprimant simplement dans ce formulaire les noms de famille de ses enfants, ce qui est une opération rapide. Puis on recommence avec les enfants.

On peut s'en servir aussi pour corriger le prénom d'un enfant d'une famille. Mais si c'est juste pour un enfant, cela peut se faire simplement avec "modifier personne".

Retour à l'accueil de la documentation