Data capture with GeneWeb

From GeneWeb
Revision as of 20:14, 30 October 2015 by Henri83 (Talk | contribs)

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.

Updating a person ===

This form will appear after selecting "Update" on the personal page of a person, then "Modify person".

All the data known about this person will be pre-recorded in the form, and can be edited or suppressed.

Clicking the Ok button at the end of the form is the only way to record permanently any changes.

Several fields propose a tick-mark next to labels such as "Insert alias", "Insert nickname", etc .... Ticking these marks does not instruct GeneWeb to perform the alias or nickname insertion, but is a request for a new "larger" form obtained when hitting the Ok button. None of the changes will have been recorded yet.

description of the various fields

Read carefully the meaning of each of these fields as they are not treated in the same fashion in the various reports proposed by GeneWeb.

  • First-name and last-name have their usual meaning. Coupled with the occurence number, this constitutes a unique identifier for the person, which can be replaced by an equivalent (internal to GeneWeb and non stable across save/restore) numerical number.
One should enter the "usual" first-name in the first-name zone, and report all other first-names, public first-names in the appropriate zone described below.
This will render effective the maintenance of a first-names list in the base, showing which first-name is most frequent, all bearers of the same first-name, etc.
  • Public name is the name by which a person is usually known. Kings, actors and celebrities fall in this category. For instance "Louis the XIV th", while having "Louis as first name" has "de Bourbon" as last-name.
Public names are a valid search criteria for a person, and is displayed first as title on the personal page, the first-name last-name being positioned below.
  • Image refers to a .gif, .jpg or .png file associated with the person, that will be display at the head of its personal page. It can be a URL ("http;//servername/folder/filename.jpg"), or a simple file that the gwd server will search for in the bases/images/base folder.
If no filename is provided, gwd will search for a file names last_name.occurence.last_name with any of the extensions above. In the filename construction invoqued, all accents will be removed, uppercase letter lowered and any blank or non alphanumerical character will be replaced by an underscore _.
For instance, the person named Anne-Cécile Dupont de Nemours will use anne_cecile.0.dupont_de_nemours as filename.
  • Nickname is a public name typically attached to some well known persons. For instance "Louis VI le Gros".
A person having a nickname can be searched using "first-name nickname" combination rather than "First-name Last-name". For instance again, "Louis VI" (his public name) is reachable as "Louis le Gros", "Louis VI le Gros", "Louis Capet", etc. Note that "Le Gros" is not considered as a last-name and is not shown in the last-names list.
A person may have several nicknames. "William the Conqueror" is also known as "William the Bastard", hence the necessity allow for multiple nicknames capture zones
Is a nickname exists, the public-name (or the first-name if there is no public-name) will be displayed first as title on the eprsonal page, the first-name last-name being shown below.
  • Alias is a name under which a person is known, without that being an alternate first-name. For instance, "Aurore Dupin" is known as "Georges Sand". Similarly "Anne-Marie d'Orléans", daughter of "Philippe Ier" et niece of "Louis XIV" is known as "Mademoiselle de Valois".
An alias is a whole and is not broken into first and last. So "Aurore Sand" and "Georges Dupin" are not valid search criteria for "Georges Sand" or "Aurore Dupin", neither is "Mademoiselle d'Orleans.
If there exist multiple aliases, they are displayed in smaller bold face below the title.
  • First-name alias may have several uses:
    • It can be the list of your first-names recorder with the authorities.
    • It can be a familiar nickname used by friends and family as "Bobby" instead of "Robert"
    • It can be an alternate first-name with varying spelling or hypothesis as extracted from anciens documents
There can be multiple first-name aliases
When present, they are displayed in smaller typeface below the title
  • Name alias is a placeholder for alternative last-names when spelling is not stable for instance.. Usage is not frequent.
  • Birth and baptism records date and place of those events. No specific problem.
  • Death records death information. No issue again except for the "automatic choice" explained below:
The death zone offers a pull-down menu whose first option is -. This value means "unknown". Based on this, provided you do not supply a date of death, GeneWeb will record "alive" for persons younger than 80 years, "unknown" for persons aged between 80 and 120 years, and "dead" for persons older that 120 years. You can always select yourself manually the option which you prefer.
Persons whose death status is "unknown" will not have an age computed on their personal pages.

  • 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