Addon:Forms Gramplet

This is a Third-party Addon. The Addon/Plugin system is controlled by the Plugin Manager.

Please use carefully on data that is backed up, and help make it better by reporting any issues to the bug tracker.
Unless otherwise stated on this page, you can download this addon by following these instructions.
Please note that some Addons have prerequisites that need to be installed before they can be used.

Census or Form?

Please note the Forms Gramplet addon is an upgrade released in 2015 to expand the flexibility of the original Census Addons. The Forms Gramplet Addons supersede the Census Addons from Gramps 4.2.X

Forms Gramplet - Shown Undocked from Bottombar Of People Category View

The Forms Gramplet allows users to create and edit structured source data in a single form. It makes the meticulous process of recording all the discrete elements far less fussy and error-prone.

The Forms Gramplet has been enhanced to handle other forms such as birth, marriage and death certificates and parish register entries as well as the originally supported census forms.

Using a Form doesn't mean creating data that can only be accessed with the Form Gramplet. You can stop using the Form Gramplet at any time but still see and edit the data that was entered. The Form gramplet merely streamlines creating Events with the Attributes to separately store elements of data from a structured source. You could do the same process using the standard Gramps editors... it would just involve a lot more steps per Person or Event.

Usage

After adding the Forms Gramplet to the view and configuring your source form.

You can enter data by selecting the gramplets New button to show the form selector and choosing which form type you are entering to see the associated Form Editor.

Forms Gramplet

Before using the Forms Gramplet addon

You need to define the form that describes the information contained within a source.
See: Configuration

Adding the Forms Gramplet

Forms Gramplet - Shown docked In Bottombar Of People Category View for Groupe People

The Forms Gramplet is designed to be added to the bottombar People Category (Grouped or List) view modes of Gramps. (After installation, this gramplet will be available for addition in all these locations: the sidebar/bottombar option for the following views: People, Relationships, Charts, and Geography.)

Select the Forms menu option from the Add a gramplet submenu of the Gramplet selection menus. Accessible by pressing the ∨ (Down Arrowhead button) in the view's sidebar or bottombar.

The blank Forms Gramplet will be shown docked.

Initial Configuration for each source

Before using the forms addons you need to define the form that describes the information contained within a source.

See: Configuration

The Forms Gramplet lists all the events for the active person that can be edited using the form editor. The listing displays the source, date and place of the event together with the role the active person performs in the event.

A new event can be created by clicking the New button at the bottom of the Forms Gramplet which will show you the Select Form selector dialog where you can choose the form to use. Once you select a form you will be taken to the Form Editor.

Forms Gramplet - Shown Undocked from Bottombar Of People Category View

An existing event can be edited either by highlighting a row and clicking the Edit button or by double-clicking on a row to bring up the Form Editor.

If the Forms Gramplet is undocked you can use the Help button to see this page.

Form Selector

Select Form selector - example

The Select Form selector allows the user to select a source that has been associated with a form. The sources are listed grouped by event type.

If the Select Form selector list is empty then you need to define the form that describes the information contained within a source.

See: Configuration

Form Editor

example form

The New Form editor is designed so that most data for an event can be entered into a single form.

Top section of the form

The top section of the form may show

First a citation Reference: should be entered. This should comprise of one or more references that uniquely identify the citation. For example, in the case of a UK census you will need to enter the PRO reference, Piece, Folio and Page.

The Date: of the event can be entered. For a census, the date is populated automatically.

A Place: can be selected in the usual Gramps manner.

The form may have the following three tabs:

Details tab
Headings tab
Gallery tab

Details tab

The "Details" tab provides an area which allows the user to enter data specific to individual people listed in the source. This tab maybe divided into sections. Each section consists of people performing a role in the event.

Person Section

A person section allows information about a single person to be entered. A new person can be created and selected by clicking the + button. A person already in Gramps can be selected by clicking the second button (share). The user is prevented from entering data until a person is selected.

Family Section

A family section allows information about two people belonging to a family to be entered. A new family can be created and selected by clicking the + button. A family already in Gramps can be selected by clicking the second button (share). The user is prevented from entering data until a family is selected.

Multiple Person Section

A multiple person section allows information about multiple people to be entered. A new person can be created and then added to the section by clicking the + button. A person already in Gramps can be added to the section by clicking the second button (share). A person can be removed from the section by clicking the - button. The order of people in the section can be changed by highlighting a row and then using the up ↑ and down ↓ arrow buttons.

Headings tab

The Headings tab provides an area which allows the user to enter data specific to the event listed in the source.

Gallery tab

The Gallery tab provides the ability to add media to the event. This is done in the same way as in the standard Gramps editors.

Configuration

Before using the form addons, you need to define the form that describes the information contained within a source.

To define the form to use you need to edit each Source and add an entry in the "Attributes" tab. The entry must have a key of "Form" and a value which is a Code that uniquely identifies the form to be used eg: UK1841

Translated Gramps

If you are using Gramps in a language other than English, enter the translated version of the key (e.g. In French, "Formulaire" instead of "Form").

While you may have more than one form code associated with a source; only the form for the first entry will be shown

To access the other forms change the order attribute to be the first.

Supported form definitions

To see a full list of the supported Code's for definitions included with the addon that are available, See: Addon:Form Definitions

Writing your own form definitions

To create a form see the

Form Creation page.

Issues

See issues attached to the Forms tag.

Gramps ^β

Addon:Forms Gramplet

Contents

Usage