The Event Types Management Page

This screen is used to list, create, view, update and delete Event Type records. "Event Types" appear as choices in a drop-down select control on the Events Edition Page and Families Edition Page and allow the user to qualify the kind of event he's dealing with.

The Project Hirtius application comes with a ready-made list of Source Types, some of them mandated by the GEDCOM format (typically those that affect Individuals), and others that are specific to Project Hirtius, but you are free to modify this list as you see fit -- provided you don't remove the few required entries (see below).

Please note that contrary to most other object management screens, the list and edition features have been implemented in the same screen in this case.

Getting There...

The Event Types management screen is not available straight from the Main Application Menu. To reach it:

From the Main Application Menu (or indeed almost any other Project Hirtius page), click on the "Manage Events" icon in the header ().
Scroll to the bottom of the page. Click on the Event Types link located between the Events List and the page footer. This gets you to the Event Types Management Page.

Supported actions

The Event Types Management Page supports the following actions:

List: displays a table listing all existing Event Type records. This is the default mode when you first reach the page.
Add: the form to fill in and submit in order to create a new Event Type record.
Insert: creating the new Event Type record in the database (post Add action).
Edit: modifying an existing Event Type record through a form populated based on the current database contents.
Update: storing the modified data in the database, updating the appropriate Event Type record (post Edit action).
View: display the current database contents for the selected Event Type record. No form in this case.
DelCon: first step when requesting the deletion of a record -- issues a prompt for confirmation.
Del: the actual removal of the selected record from the database (post DelCon action). Only Event Types that are no longer referenced by any Source records can be deleted.
That action will be recorded: a new entry will be added to the Event Log.

Of these, only List is an entry point (typically reached from the Events List).

Fields

Here below are the fields that you can expect to find on the Event Type Edition Page. The goal here is not to simply duplicate the database layout information. If this is what interests you, please refer to the database creation script or the database itself. The purpose is rather to explain what each field is meant for [D], what format it is expected to follow [F] and what are the conditions for its validity (if applicable) [V].

A star (*) after the name of the field denotes a mandatory field (the star is shown in red with the same meaning in the application user interface).

Object ID*	D	Sequential ID, automatically assigned by the DB during record creation. Displayed read-only once available.
Event Type*	D	Name (short description) for the event type. Make it short, but as explicit as possible.
	F	Free text.
	V	Has to be unique.
Event Code*	D	Mnemonic for the event type. Will appear in lists, search results, etc.
	F	Max. 4 characters.
	V	Has to be unique.
Description	D	Longer description for the event type. Optional.
Description	F	Free text.
Has duration	D	Whether or not events of this kind have duration. If checked, you are expected to provide both a start date and an end date for events of this type.
Has duration	F	Checkbox.
Official GEDCOM code	D	When checked, indicates that this event type is part of the GEDCOM standard. This flag is purely informational at present, but will impact GEDCOM exports when implemented.
Official GEDCOM code	F	Checkbox.
Required	D	When checked, indicates that this event type is an integral part of the Project Hirtius application and can't be removed (because the application code makes explicit use of it). Once set, a confirmation page will be displayed if an attempt is made to remove this flag.
Required	F	Checkbox.

In addition to these, when in 'list' mode, some extra computed columns are displayed:

#:: The number of Event records that currently reference this Event Type.

Controls

In List mode

For each Event Type in the list, the first and last columns of its row contain links that correspond to actions to be performed on the Event Type object.

object ID: the object ID (left-most column) is a link that opens the Event Types Management Page in view mode for the selected Event Type.
Edit: opens the Event Types Management Page in edit mode for the selected Event Type.
Del: opens the Event Types Management Page in delete confirmation mode for the selected Event Type. You can then confirm to proceed with the deletion or cancel it and return to the list. If there are still Event records that reference the selected Event Type, an error is issued and the page doesn't let you proceed with deletion. You should first change the type on said events, then try again. You can use the Advanced Search Page to easily find out which Event records still use this Event Type.
The Del action link is disabled for all Event Types that are flagged as "required" (see above).

In addition to this, a global action is available on the last row (bottom right corner) of the list:

Add: opens the Event Types Management Page in add mode (displays a blank HTML form to be filled in order to create a new Event Type record).

In View mode

Switch to edit mode link: Located at the bottom of the page, just above the footer. Click on this link to edit the current object (switches the view from a R/O rendering of the contents to an HTML form that allows you to modify that contents and submit it afterward).
Back to list link: Located at the bottom of the page, just above the footer. Click on this link to return to the list of defined Event Types.

In Edit mode

Submit button: (Also in "Add" mode). Commits the locally modified HTML form fields contents to the database that stores Project Hirtius data. Use it to save your latest modifications.
Reset button: (Also in "Add" mode). Cancels any un-committed change, and returns all HTML form fields to their initial value (i.e. the one they had when the page was last loaded in the browser). Use this button to revert any erroneous edit you might have done (Beware: this only works on local changes that have not been saved to the database yet, i.e. for which you've not clicked on Submit yet).
Switch to view mode link: Located at the bottom of the page, just above the footer. Click on this link to view the current object (switches from the current HTML form that allows you to modify the object contents and submit it afterward to a R/O rendering of that contents).
Back to list link: Located at the bottom of the page, just above the footer. Click on this link to return to the list of defined Event Types.