Libraries Locations Section
Applicability: Cranium, Synapse (core versions 0315+)

Entering the location of references and associated documents often requires you to enter a file's complete pathname. This pathname typically includes a folder location that may change over time. Synapse and Cranium use a "library designation" approach to avoid the need to change all the stored pathnames whenever the location of their folder changes.

The Libraries Locations Section is located in the Summary Chapter of most documents. The section contains one large field displaying a table of Library Names and Library Locations.

Instead of entering a full pathname whenever a filename is entered, you enter a Library Name prefix. For example, the following document location may be entered for a reference.

The original, absolute file location.
The relative file location using a Library prefix.

The entry for "Library 05" in the field's table shown above, is used to change the reference's document location:

From: Library Name To: Document Location
Library 05::\MKS 05479.pdf \\IRON\MKS Disk 02\Library 05\MKS 05479.pdf

This conversion is done internally by the application whenever a complete file name is needed.

By using the library mechanism, you can easily change just a few entries if the location of your documents ever changes.

Editing Libraries Locations

Clicking the left mouse button within the Libraries Location field's table control activates the Libraries Locations edit dialog.

Libraries Details Table Control: the dialog's table control displays the current list of library locations. Clicking the left mouse button on a table row selects that table row. Clicking and holding the left mouse button down and then dragging the mouse will select several table rows. Double-clicking the left mouse button on a row selects the row and edits the contents of that row.
Edit Button: pressing the dialog's Edit button activates the Library Location edit dialog. See below for documentation.
Commands Button: pressing the dialog's Commands button or clicking the right mouse button on the table control displays the commands menu. This menu provides standard commands for copying, pasting, and clearing library locations. See the documentation on Common Menu Commands for details.
Sort Button: the dialog's Sort button will be enabled if two or more rows are selected. Pressing the Sort button will activate the Sort Attribute dialog. This dialog enables you to sort library locations in ascending or descending order by location or name.
Add Rows Button: pressing the Add Rows button will add rows to the bottom of the table control.
Editing a Library Location

Pressing the Libraries Locations dialog's Edit button or double-clicking the left mouse button on a row in the dialog's table control activates the Library Location edit dialog. This dialog enables you to enter a name and location as well as supporting information.

Name Control: enter a name for this library's location. This name will be used as the prefix of a relative location. Often a simply name, e.g., Library 01, will be sufficient.
Location Control: enter the full pathname of the library's location, e.g, the computer folder or directory. Note that this location can be on your computer, on an accessible network, or even on an internet site.
Browse Button: pressing the browse button will activate the Select Library Location dialog. This dialog will enable you to select a folder on a local or network drive.
Comments Edit Control: displays and enables editing of the comments associated with this library location. A general description of the library's contents is often helpful.
Date, Phrase, and Set Buttons: the Date button inserts the current date and time into the Comments Control. The Phrase button inserts the current user's 'Personal Phrase' into the Comments Control. The Set Button activates the Set Phrase Dialog which enables you to change your personal phrase.
Data Commands Menu

Clicking the right mouse button within a field's table control activates the field's data commands menu.

The menu's commands enable you to copy, cut and paste values to and from the data control. See Common Menu Commands for documentation on the commands commonly found on command menus.

Example: Enter a Library Name and Location
  1. Open a knowledge base document. (Open a "working" document or create a copy of a document (see here) if you are just experimenting with this functionality.)
  2. Change to the Summary chapter. Scroll to the Libraries Locations Section and click the left mouse button on the large table field.
  3. The Libraries Locations dialog is activated.
  4. Select an empty row and press the Edit button. The Library Location dialog is activated.
  5. Enter the library's name, location and comments. To enter a location you can the type the name in the edit control or use the Browse button. Pressing the Browse button activates the Browse for Folder dialog. Select the library's folder location and press the OK button.
  6. Finally press the OK button to store the library entry to the Libraries Locations dialog.
Related Documentation
Topic Description
Document Location Section the Reference Chapter's location section stores the pathname of an electronic document.
Summary Chapter contains the titles, description, library locations and general notes asssociated with the current document.