The Alternate Names Edition Page

Purpose

This screen is used to list, create, view, update and delete Alternate Name records. "Alternate names" are a kind of metadata belonging to Individual records. They help track the multiple variations in a person's name that may occur in the documentation (such as different spelling or the name being translated in Latin, for instance). You can also use this screen to record completely different names being used to identify the same person (such as pen names).

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 Alternate Names section.

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

Supported actions

The Alternate Names Edition Page supports the following actions:

List: displays a table listing all existing Alternate Name 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 Alternate Name record.
Insert: creating the new Alternate Name record in the database (post Add action).
Edit: modifying an existing Alternate Name record through a form populated based on the current database contents.
Update: storing the modified data in the database, updating the appropriate Alternate Name record (post Edit action).
View: display the current database contents for the selected Alternate Name 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. '{N10}').

Fields

Here below are the fields that you can expect to find on the Alternate Name 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.
Altername Full Name*	D	One alternate name for the selected Individual. Alternate names are stored in a single field (not split in separate name component) so you should enter the full name here (keeping in mind that the full name may well consist of a single word, e.g. "Molière").
Altername Full Name*	F	Free text.
Name Type	D	Type of alternate name (e.g. alternate spelling, translation, pen name, etc.). Select from list. Available alternate name types are managed from the Alternate Name Types Management Page.
Comment	D	Any comment you might have on the alternate name in question (context of use, historical significance, etc.). This is where you would store the bulk of your research concerned specifically with this name.
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

Alternate Name actions

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

object ID: the object ID (left-most column) is a link that opens the Alternate Names Edition Page in view mode for the selected Alternate Name.
Edit: opens the Alternate Names Edition Page in edit mode for the selected Alternate Name.
Del: opens the Alternate Names Edition Page in delete confirmation mode for the selected Alternate Name. 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 Alternate Names Edition Page in add mode (displays a blank HTML form to be filled in order to create a new Alternate Name record).

Related pages menu

At the bottom of the page, between the Alternate Names 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

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 Alternate Names 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 Alternate Name 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 Alternate Names for the currently selected Individual.