The Titles Edition Page

Purpose

This screen is used to list, create, view, update and delete Title records. "Titles" are a kind of metadata belonging to Individual records. They help track the various titles that may have been awarded to the individual in question, be they nobility titles, function titles or academic ones (this list is not exhaustive).

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...

This screen can only be reached through the Individuals Edition Page to which the metadata belongs:

Through any means available, first reach the Individuals Edition Page for the Individual you are interested in (see Navigation Tips for hints on the various ways of doing this).
Switch to Edit mode if this is not already the case.
Then click on the Edit link next to the Titles section.

Of course, you can also reach the Title view screen through a few other ways, such as using search results (see Navigation Tips).

Supported actions

The Titles Edition Page supports the following actions:

List: displays a table listing all existing Title records for the current Individual. 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 Title record.
Insert: creating the new Title record in the database (post Add action).
Edit: modifying an existing Title record through a form populated based on the current database contents.
Update: storing the modified data in the database, updating the appropriate Title record (post Edit action).
View: display the current database contents for the selected Title 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 (as well as all linked metadata records) from the database (post DelCon action).
That action will be recorded: a new entry will be added to the Event Log.

Of these, only List and View are entry points. The former is typically reached from the Individuals Edition Page, while the latter can be reached from search result pages, for instance, or using the "quick jump" feature (Go button) or object refs in comments (e.g. '{T22}').

Fields

Here below are the fields that you can expect to find on the Title 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.
Title*	D	One title for the selected Individual. Titles are stored in a single field.
Title*	F	Free text.
Worn as of	D	Date the title was awarded. Can be left empty if unknown. In view mode and if set, the date will be followed by a letter between parentheses denoting the selected era (see next field). The corresponding Julian Day Number (JDN) representation will be displayed below it.
	F	Hirtius "historical" dates format, based on the ISO one: year in 1 to 5 digits, then month in 2 digits (padded with zero if needed), then day in 2 digits (padded with zero as needed). The date parts have to be separated with '/' (forward slash). Prefix the date with '-' (minus sign) for BCE years. If month and/or day parts are unknown, they can be specified as '00' (for the purpose of JDN computation, zero values are set arbitrarirly to 1). Examples: "2012/10/31", "136/00/00" or "-44/03/15".
	V	The date string is parsed and checked against the above format. Month part should be between 0 and 12, day part between 0 and 31. If day and month parts are provided, day is checked against month length with leap-ness computed based on selected era (see next field). The year part has to be different from zero.
Worn as of era	D	Calendar in which the Worn as of Date field is expressed. Select from list. Unset ('-') by default. Required if Worn as of Date is set.
Nobility title	D	Denotes whether or not this title indicates nobility. Purely informational.
Comment	D	Any comment you might have on the title in question (context of use, historical significance, etc.). This is where you would store the bulk of your research concerned specifically with this title.
Comment	F	Free text. HTML markup allowed. Special formats: '`{D1234}`': quote another Hirtius object using its object prefix and ID. Automatically rendered as a link to that object view page. See Objects and Metadata Types for a list of all prefixes supported by the application. Only objects and lesser objects can be referred to in this way. '`[1234]`': Bibref. Refers to the bibliographical reference with said number, as defined further down the page in the *References* section. Rendered as a link to a named anchor. Only works with bibrefs attached to the current object. '`[S1234]`': Srcref. Refers to the source reference with said number, as defined further down the page in the *Sources* section. Rendered as a link to a named anchor. Only works with srcrefs attached to the current object. Insert these formats in your text without the enclosing quotes. If the object that you refer to doesn't exist (yet) or is not linked to the current object (in the case of Bibref and Srcref), the reference will be rendered in a special style (orange italics) and the associated link will point to that object creation page (where possible).

Controls

In List mode

Title actions

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

object ID: the object ID (left-most column) is a link that opens the Titles Edition Page in view mode for the selected Title.
Edit: opens the Titles Edition Page in edit mode for the selected Title.
Del: opens the Titles Edition Page in delete confirmation mode for the selected Title. You can then confirm to proceed with the deletion or cancel it and return to the list.

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

Add: opens the Titles Edition Page in add mode (displays a blank HTML form to be filled in order to create a new Title record).

Related pages menu

At the bottom of the page, between the Titles list and the page footer, a small secondary menu is located that will give you access to pages related to the task at hand.

Here are the menu entries in question:

Back to Individual edition screen: opens the Individuals Edition Page for the currently selected Individual, in edition mode.
Add a new Individual: opens the Individuals Edition Page in Add mode.

In View mode

Calendar View icon (): Located next to the Worn as of Date field, that icon is a link to the Calendar View for the year in question and drawn for the era in which the date was expressed, giving you a way to identify all other event-like objects in the temporal vicinity of the current one. Owing to the fact that the query is made based on the internal date representation as JDN, all applicable events will be found, irrespective of the calendar in which their own date was expressed.
This icon is only present when the Worn as of Date field is set.
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 known Titles for the currently selected Individual.

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. It is of course perfectly legitimate to click Submit any number of times during a long edition session to avoid loosing unsaved data. When doing so, use the Edit action link next to the name in the list to return to the current Title record and edit it further.
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).
Edit References: This will open the Object - Bib. Ref. Edition Page.
Edit Sources: This will open the Object - Source Ref. Edition Page.
Edit Attachments: This will open the Object - Attached File Edition Page.
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 known Titles for the currently selected Individual.