Object - Source Reference Edition Page

Purpose

This screen will allow you to manage the relationship between any kind of supported fully-fledged object and Source records (for the purpose of quoting from them). These relationships embody the concept of "source reference". The sources exist as objects in their own right, and the references are the properties (as in "metadata") of the relationship. You can create as many relationships per object as needed.

Getting There...

This management page is common to all supported fully-fledged object types. To reach it:

First reach the edition page for the specific object that you are interested in and access it in 'edit' mode (or switch to it once you are there).
Scroll down the object edition page until you see the Sources section.
Click on the Edit action link next to it.

Please note that in the case of Tiddlers, multiple objects can be displayed on the page at the same time, several of them possibly in 'edit' mode. Make sure to click on the Edit action link for the sources that belong to the correct object. The visual rendering of the page should make that clear enough.

Supported actions

The Object - Source Reference Edition Page supports the following actions:

Add: first opens the Source Selector for you to select the target Source, then displays the form to fill in and submit in order to create a new Source Reference record.
Insert: creating the new Source Reference record in the database (post Add action).
Edit: modifying an existing Source Reference record through a form populated based on the current database contents. Please note: only the metadata (properties) of the relationship can be modified this way (e.g. the exact page for the quote), but you can't select a new target source. If this is what you need, delete the current relationship (Unlink, see below), and create a new one.
Update: storing the modified data in the database, updating the appropriate Source Reference record (post Edit action).
View: display the current database contents for the selected Source Reference record. No form in this case.
Unlink: the actual removal of the selected record from the database. This only removes the relationship, it won't touch the linked Source of course. No further confirmation is required.
That action will be recorded: a new entry will be added to the Event Log.

Of these, only Add, Edit, View and Unlink are entry points. They are typically reached from the Object - Source Ref. Edition Page.

Fields

Here below are the fields that you can expect to find on the Object - Source Reference 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 Layout, 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).

Ref ID*	D	Sequential ID, automatically assigned by the DB during record creation. Displayed read-only once available.
Quote reference	D	The exact reference for the quote. Depending on the nature of the source, this may reprensent a folio number, or book, chapter and verse references.
Quote reference	F	Free text.
Comment	D	Any comment you might have on the contents of that reference. Anything you write here will be added at the end of the quote (= like a footnote).
Comment	F	Free text. HTML markup allowed.

Controls

Object name

The first row below the page header displays the name of the object currently being edited. This name will always contain a link (typically the object type prefix letter -- see Objects and Metadata Types -- followed by its ID). Clicking on it will lead you back to that object edition page in 'view' mode.

Link actions

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

Ref ID: the Ref ID (left-most column) is a link that opens the Object - Source Ref. Edition Page in view mode for the selected Source Reference.
Edit: opens the Object - Source Ref. Edition Page in edit mode for the selected Source Reference. Remember: only the properties (metadata) of the link can be modified, not its target.
Unlink: removes the link between the object currently being edited and the selected source. No further confirmation is required.

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

Add: opens the Source Selector in a new window. This allows you to select any Source to form a new relationship with the object currently being edited. In this case, it is perfectly legitimate to link the same source multiple times to the object, as the metadata (such as the quote reference) are likely to differ. When the target source has been selected, you are then prompted to fill in the fields for the quote properties (see above). After you submit those and you close the Source Selector window, please use the Refresh function of your browser ([F5], typically) to make your latest addition visible in the list.

Related pages menu

The exact contents of this menu depends on the type of object currently being edited.

Edit this <object> some more... link: Returns you to the current object record in edit mode. Use this link to further edit the object in question.
Add a new <object> link: Opens the form that allows you to create a new object record of the same type. Usefull when creating multiple records in sequence.