Image Class Collmgr/Collection Database

From DLXS Documentation

(Difference between revisions)
Jump to: navigation, search
Current revision (18:46, 31 August 2007) (edit) (undo)
 
Line 1: Line 1:
-
[[DLXS Wiki|Main Page]] > [[Mounting Collections: Class-specific Steps]] > [[Mounting an Image Class Collection]] > Image Class COLLDB (Collection Database Configuration
+
[[DLXS Wiki|Main Page]] > [[Mounting Collections: Class-specific Steps]] > [[Mounting an Image Class Collection]] > Image Class COLLDB (Collection Database) Configuration
<hr>
<hr>

Current revision

Main Page > Mounting Collections: Class-specific Steps > Mounting an Image Class Collection > Image Class COLLDB (Collection Database) Configuration


The COLLDB (collection database) is for configuration of individual collections. Many aspects of how a collection is presented in the interface are controlled by elements in the COLLDB. It is very powerful in that sense, and allows extensive customization to be done without modification of XML/XSL.

The majority of Collmgr Fields are fully documented within Collmgr. This document now only includes extensive information beyond what could be reasonably kept in the Collmgr help document.

[edit] Table of COLLDB Field Definitions

Field Name Description Example
dfltentryflds and dfltresentryflds the list of fields (as abbreviations) to display in entry (full record) views. to display all fields, enter the value "default".

BHL_IT
BHL_TIS
dateconv:on
BHL_DA
dateconv:off
BHL_CR
BHL_WC
BHL_CA
BHL_NO
BHL_SU
BHL_G
BHL_CT
BHL_CC
BHL_LO
BHL_ITNO
BHL_NE
BHL_SS
url:on
idres:on
BHL_EL
url:off
idres:off
BHL_RI
BHL_RE

In colldb, values must be listed 1 per line. However within a processing instruction, values must be delimited by pipes ( "|" ). e.g., MUSART.TI|MUSART.CR|musart.DA

Values are not case sensitive.

There are several options that may be turned on and off to enhance the display of records. The options are specified as another value among abbreviations. When the status of an option is changed, the change is persistent for all subsequent fields, until the status is changed again. The exceptions to this are "sectionlabel" and "urltext", which are specified as often as needed.

The "url" option, for example, causes fields that contain a URL (and nothing but a URL), to be turned into a hyperlink. It can be used in conjunction with the "urltext" option, which allows the link text to be specified. By default the URL itself is used for the link text. e.g.,
MUSART.TI
url:on
urltext:View_Copyright_Statement
MUSART.cp
url:off
MUSART.DA

The "hilite" option causes search terms to be hilited. This option is "on" by default, but if you wanted to turn hiliting off for several consecutive fields, you could. e.g., MUSART.TI
hilite:off
MUSART.DA
MUSART.PG
MUSART.LI
hilite:on
MUSART.TY

The complete list of field options are as follows:

option values default description
label on/off on display name of field before field value
sectionlabel text string*
 empty display a section label before a series of fields. allows a record to split into sections.
url on/off off turn the entire contents of the field in to a link. assumes the field contains a single URL.
urltext text string* empty display the provided string as the text of the "url" option link. if "urltext" is not specified, the URL value is used as the text of the link.
idres on/off off look the value of the field up in the id resolver and display the value. use with "url" and/or "urltext" to turn the value in to a link.
dateconv on/off off

displays some ISO format dates in a more human readable form.

supports YYYYMMDD, YYYYMMDD/YYYYMMDD and maintains any data that might follow the date in the field e.g, (ca.)
hilite on/off on

hilites search terms in the field.

DLXS hiliting supports 3 search fields only (q1 - q3).

keylinks on/off off

turns the field value into a url that will search the collection for that value. by default, each word of the field is made into a separate link. the delimiter used to split the field can be specified by the "delim" option.
idlinks on/off off

assumes the field value is a unique record id and turns it into a link. this is different than idresolver, idlinks can be useful for linking within a collection or to a collection that has related record (entry) ids. by default, each "word" of the field is made into a separate link. the delimiter used to split the field can be specified by the "delim" option.
params url parameters and values string (not a complete URL) empty

used together with keylinks or idlinks to add or modify parameters of the link. for example, the link can be to different collection with params:c=collid. separate multiple params with a semi-colon.
delim 1 or more characters SPACE

used in conjunction with the keylinks option to split the value of a field into smaller parts by the value delim specifies. for example, if a field holds a list of keywords delimited by "; " delim can be set to ";_" to tell the keylinks option how to split the field. (note: use an underscore for SPACE.) e.g., delim:;_

* use underscores for spaces. special characters may not work.

The Processing Instruction "RECORDTABLE" has similar functionality.


Top

Retrieved from "http://webservices.itcs.umich.edu/mediawiki/dlxs13/index.php/Image_Class_Collmgr/Collection_Database"
Personal tools