collid
required
value/format:string

class: all

The unique ID string used for the collection. Usually corresponds to the directory name holding the collection files.

Collids should consist only of letters, numbers and underscores. Collmgr restricts the allowable characters in a collid to just those typically permitted in programming languages. For example, hyphens, *, +, %, etc. are not permitted.

collname
required
value/format:string

class: all

The collection name as it will appear on the cross-collection results lists, in the collection picker (sorted alphabetically), and on the home page for the collection.

contactlink
optional
value/format:string

class: image, text, findaid

For constructing the contact mailto link; contains the content of the HREF attribute of the A element (e.g., "mailto:help@some.edu/")

contacttext
optional
value/format:string

class: image, text, findaid

For constructing the contact mailto link; contains the content of the A element that will appear as the link text (e.g. "Help/").

defaultgroupid
optional
value/format:string

class: all

For assigning a default group to a collection. Causes group templates, etc. to be used for a collection even when a "g" (group) parameter is not on the URL.

Group Id
required
value/format:string

class: all

The unique identifier for a group of collids. Used as the value of the "g" URL parameter.

groupname
required
value/format:string

class: all

The name of the group. The text string provided is displayed as a window title and as the name of the group in lists of groups.

defaultpageview
optional
value/format:string.

class: text

If the collection has page images ('pageimages' field set to '1'), enter one of 'image, 'text' or 'pdf' to control which view of the page the page viewer will offer by default. This field should be left blank if the 'pageimages' field is set to 0 or empty.

defaultpageviewsize
optional
value/format:string.

class: text

This is the default size for display of a page image in pageviewer. Pageviewer uses this size to determine how much to scale an image up or down in size based on possible multiple resolutions stored in page image files. If this field is blank, the global default value (in the IVGlobals package, in lib/ItemView.cfg) is used. Possible values are 'S' for small; 's' for medium or "normal"; and 'l' (lowercase L) for large.

orglink
optional
value/format:string

class: all

For constructing the organization mailto link; contains the content of the HREF attribute of the A element (e.g., "mailtoorginfo@umich.edu/")

orgtext
optional
value/format:string

class: all

For constructing the organization mailto link; contains the content of the A element that will appear as the link text (e.g. "org-info@umich.edu/").

querylanguage
optional
value/format:string

class: image

If using MySQL to search image collections set the value to 'sql' otherwise 'xpat', with 'xpat' being the default.

rendering
required
value/format:string

class: bib

This value configures the default html rendering mechanism for the collection. If set to "perl", the CGI program will use HTML templates and create data results in HTML for output. If set to "xslt", [deprecated] the CGI program will call the XLST engine to render the XML templates and to render XML data results into HTML for output.

languagepriority
optional
value/format:array

class: findaid, image, text

Specifies the language lookup table to be used for strings, messages, etc in the user interface. This field is present in both the Collection and Group configuration pages. The effective language into which XSL will render the interface is based on a priority scheme involving the following configuration variables:

  1. The Collection and Group database "languagepriority" fields which are multi-valued fields whose first value lists the default language followed by the other languages supported for the group or collection, in no particular order.
  2. The Perl global variable @LibGlobals::gLanguageDefaultPriority which is an array of values treated in the same priority fashion as the "languagepriority" fields in the database.
  3. The "lang" URL parameter.

The effective language is determined by the following alogorithm: If there is a "lang" URL parameter, its value determines the effective language. If its value is not configured for the effective collection or group mode the default (first) value configured for the mode is used. If the mode does not have any "languagepriority" field values configured for the mode the global Perl variable @LibGlobals::gLanguageDefaultPriority is consulted. If the requested language is not present in that list the first value is taken as the effective language. This value, L, is used to construct langmap filename by the convention "langmap.L.xml". It is an error if there is not a langmap file by that name in the target fallback directory for the mode (cross-collection or single-collection).

If there is *not* a "lang" URL parameter, the effective language is determined, depending on mode, by the first value in the "languagepriority" fields in the Collection or Group fields, if supplied, else by the first value in the Perl global variable@LibGlobals::gLanguageDefaultPriority.

xlstpifillermodule
required
value/format:string

class: Findaid, Text, Image

The module name (without .pm suffix) of the XsltPIFiller Object (which handles application level or user interface filtering) or the subclass thereof for the collection. Supply one of TextAppXsltPIFiller for the default TextApp behavior or a subclass if one has been written for the collection. Same for FindaidAppXsltPIFiller. BibApp and ImageApp are not configured to use this mechanism yet.

homesite
required
value/format:string

class: text, bib

The URL for the host webserver hosting the middleware for this collection. (e.g. "http//www.hti.umich.edu"). The value "localhost" can be supplied which will resolve to whatever machine the middleware happens to be running on.

Occasionally, the need may be for a URL other than that of the middleware host. For example, the collection may have a home page from another institution to which the user should be directed such as http://historical.library.cornell.edu/math/. These non-local URLs should be flagged by prepending "foreign:" so that the middleware will not append local cgi script names to the URL string.

host
required
value/format:string

class: all

The virtual host name for the machine hosting the collection data and data indexes. This is usually the same host hosting the middleware.

To make the middleware access data on the same machine the middleware itself is running on, the value should agree with the value of the HTTP_HOST environment variable set by a webserver running on that machine. (e.g., "www.hti.umich.edu"). The value "localhost" can also be be supplied which will resolve to whatever machine the middleware happens to be running on. If the value is not "localhost" and is different from the value of the HTTP_HOST environment variable, the middleware will attempt to set up a socket connection to the machine named here to send commands to an XPAT process running on that remote machine. This requires that the XPAT daemon be properly configured on that remote machine.

pageviewhost
optional
value/format:string

class: text

The virtual host name for the machine hosting the page image data files. If no value is supplied pageviewhost defaults to the value in the host field (which is usually the same host as that hosting the middleware). Note that if the value of pageviewhost is different than both the middleware host and the xpat data host then the remote daemon (dlxsd) must be configured to run on the host specified for pageviewhost. This is necessary in order for the pageviewer cgi to send commands to that remote page image data host to run programs (if necessary) to transform, for example, TIFF files to GIF for web display. See also the the explanation for host.

dd
required
value/format: array

class: text, bib, findaid

A list of one or more XPAT dd files for the collection specified as full paths relative to the value in the DLXSROOT environment variable.

locale
optional
value/format:string

class: all

This optional field specifies a IANA standard locale value.

Text, Findaid, Image: These classes have been converted to pure XML support with some legacy support for ISO-8859-* SGML data. If the locale specifies a Unicode UTF-8 encoding (e.g. en_US.UTF-8) the middleware will expect collection data to be Unicode UTF-8 encoded XML. The effect of this setting is:

  • The middleware will use xpatu search engine to search the collection data. This implies that the data was indexed by xpatbldu and xmlrgn/multirgn.
  • The middleware will expect user input to be UTF-8 encoded. The is ensured by charset=utf-8 in the <meta> HTML tag and in the HTTP header.
  • Perl's internal UTF-8 flag is set on Perl string variables to handle multi-byte UTF-8 encoded data at the character level.
If the field is blank, the default is equivalent to entering "en_US.ISO-8859-1". The middleware will expect collection data to be ISO-8859-* encoded SGML. Any non-XML character entity references present in the data should be declared in an entitiesdoctype.chnk file placed in a collection-specific web directory. The effect of this setting is:
  • The middleware will use xpat search engine to search the collection data. This implies that the data was indexed by xpatbld and sgmlrgn/multirgn.
  • The middleware will still expect user input to be UTF-8 encoded. The is ensured by charset=utf-8 in the <meta> HTML tag and in the HTTP header.
  • Data returned from XPAT is transcoded from ISO-8859-* to UTF-8 and SGML singletons are changeed to XML singletons in the output stream.
  • Perl's internal UTF-8 flag is set on Perl string variables to handle multi-byte UTF-8 encoded data at the character level.

BibClass: Currently, BibClass has not been converted to pure XML/XSLT support. If the locale specifies a Unicode UTF-8 encoding (e.g. en_US.UTF-8) the middleware will expect collection data to be Unicode UTF-8 encoded XML. The effect of this setting is:

  • The middleware will use xpatu search engine to search the collection data. This implies that the data was indexed by xpatbldu and xmlrgn/multirgn.
  • The middleware will expect user input to be UTF-8 encoded. The is ensured by charset=utf-8 in the HTTP header. The middleware will change occurrences of charset=ISO-8859-1 (if present in the HTML <meta> tag) to charset=UTF-8 when outputting processed HTML templates.
  • Perl's internal UTF-8 flag is set on Perl string variables to handle multi-byte UTF-8 encoded data at the character level.
If the field is blank, the default is equivalent to entering "en_US.ISO-8859-1". The middleware will expect collection data to be ISO-8859-* encoded SGML. The effect of this setting is:
  • The middleware will use xpat search engine to search the collection data. This implies that the data was indexed by xpatbld and sgmlrgn/multirgn.
  • The middleware will still expect user input to be ISO-8859-* encoded. The is ensured by charset=ISO-8859-1 in the <meta> HTML tag.

Note that all collections must be in a single encoding, either all ISO-8859-* or all Unicode UTF-8 for characters in cross-collection result views to render correctly. Single collection functionality supports either ISO-8859-* or UTF-8 encodings. It is recommended that collection data be UTF-8 encoded for character support over the widest range of alphabets. This is necessarily so for collection data containing characters from multiple alphabets.

map
required
value/format:string

class: all

The location of the TerminologyMapper map file for the collection.

objdir
optional
value/format:string

class: text

The directory where page image files are stored. Only necessary for collections with page images. Typically, /obj relative to DLXSROOT. The pageviewer middleware appends an additional path component based on the IDNO of the text object when accessing a given page. For example, at UM, for the IDNO aas7611.0001.001 the additional path component is /a/a/s/aas7611.0001.001 relative to /obj relative to DLXSROOT giving /l1/obj/a/a/s/aas7611.0001.001/. Images for the individual pages of aas7611.0001.001 reside within this final directory path.

port
optional
value/format:number

class: text, findaid, bib

The access port for the XPAT daemon on the machine identified in host. Only necessary for collections where data and indexes are on a different machine than the middleware (CGI program).

webdir
required
value/format:string

class: all

The directory path relative to the DLXSROOT environment variable for the collection (usually in the form /c/collid). Image Class requires the leading slash.

wwdd
optional
value/format:string

class: text

The location of the XPAT data dictionary for the collection word wheel/word index, if there is one. For example, /idx/c/coll/WW/coll.ww.dd

extendedname
required
value/format:string

class: bib

If a value other than default is supplied for the extendedname, the value will appear on individual search pages (e.g., simple or advanced) above the search input boxes.

minmaxyearend
required
value/format:number

class: bib

The maximum valid year value to be used to check user input for date searches.

minmaxyearinc
optional
value/format:number

class: bib

The year increment value to be used for date searches.

minmaxyearstart
required
value/format:number

class: bib

The minimum valid year value to be used to check user input for date searches.

primaryhref
optional
value/format:string

class: bib

The primarytitle can be presented as a link. If a value other than default appears in the database, the template renders that value as a link. See primarytitle

primarytitle
required
value/format:value/format: string

class: all

The first title (or graphical banner) that appears at the top of the initial web page. Text strings must be preceded by "text:" and graphical banners must be preceded by "graphic:". The template and database permit either a textual title or a graphical banner, but not both. See primaryhref. If the primarytitle is a graphic and not just a string, then the webdir field must be filled in as well.

secondarytitle
required
value/format:string

class: text, bib, findaid

A textual second title, appearing below the primarytitle. If the value default appears, no secondary title is displayed.

briefcollname
required
value/format:string

class: image

A brief version of the collection name. Used for display beneath thumbnail images in results view.

brwsimg
required
value/format:string

class: image

Used to configure the "browse images" link on collection specific index pages. Enter "default" to retrieve all records with images. Leave the field blank to omit the link completely. Enter any single word search term (e.g., "snow") to retrieve sample records that match the term.

brwsrec
required
value/format:string

class: image

Used to configure the "browse records" link on collection specific index pages. Enter "default" to retrieve all records (with or without images). Leave the field blank to omit the link completely. Enter any search term (e.g., "snow") to retrieve sample records that match the term.

data_table
required
value/format:string

class: image

The name of the MySQL table in the DLXS database with the collection's principle data.

media_table
required for MySQL collections
value/format:string

class: image

The name of the MySQL table in the DLXS database with the collection's media file data.

dfltentryflds
required
value/format:default or array

class: image

The list of fields (as abbreviations) to display in entry (full record) views. To display all fields, enter the value "default".

For details about the full range of options, please see the relevant Image Class documentation.

dfltresentryflds
required
value/format:default or array

class: image

The list of fields (as abbreviations) to display in the results view that includes the full record (i.e., thumbfull view). To display all fields, enter the value "default".

For details about the full range of options, please see the relevant Image Class documentation.

dfltsrchflds
required
value/format:array

class: image

The list of fields (as abbreviations) that may be searched. These are the fields that show up in the search form. to display all fields. The value "default" is no longer valid as of DLXS 11. If the ability to search across all fields is desired, include collid_all here.

entrydivs
required
value/format:array

class: image

The entry/record display uses HTML DIVs to provide two different display modes (i.e., "full image" and "description"). The user can flip back and forth between the two display modes. If a collection has records with images and descriptions, you will want to include both, (e.g., full image, on one line, and description, on another ). For a collection that has descriptions but no images, you probably want to only include "description."

entrydivsdefault
required
value/format:string

class: image

The default display mode for the entry/record display. When the record is first displayed, should the "full image" view be shown first, or the "description" view?

entryauth
required for MySQL collections
value/format:string

class: image

Strictly used for Image Class data loading. The entryauth field holds the default item access control value to be included in the media_table record for each item (image or other media file). Set the entryauth field to one of "world", collid (the actual collid), or "no access". Value may be overriden in each data record to restrict access to individual items. More info.

searchable_items
required for MySQL collections
value/format:string

class: image

Strictly used for Image Class data loading.

Controls display of images in search results when a record has multiple images. Values are "detail", "summary", "both". "Both" is the default value. If records only have one image, "summary" and "both" are safe choices. More info.

imgqual
required
value/format: string

class: image

The default size for image display. There are several ways to specify the quality.

examples:
  • h600 -- height no larger than 600 pixels
  • w500 -- width no larger than 600 pixels
  • m800 -- max dimension of image no larger than 800 pixels
  • min -- smallest available
  • max -- largest available
  • mid -- mid-size among available
  • preview -- defined in imageclass.cfg ($gDefaultPreviewImageSize)
  • screen -- defined in imageclass.cfg ($gDefaultScreenImageSize)
  • integer value -- MrSID res value

imgsizemax
optional
value/format:string

class: image

Allows a restriction to be put on the maximum full size image displayed. Definable in terms similar to imgqual. Leave field blank for no restriction. This setting may be overriden for privileged users by listing user IDs in the privileged_users field.

privileged_users
optional
value/format:string

class: image

List user IDs in order to grant unlimited image size access even when the imgsizemax field is being used to restrict access for most users to larger sizes.

range_srchflds (beta)
optional
value/format:string

class: image

(Consider this as beta functionality. Feedback is desired.) List field abbreviations to be targeted in numeric range searches. These will have special representation in the search form. To search multiple fields as if one (e.g., "start date" and "end date"), create a field mapping in field_xcoll_maps and include the xcoll mapping in range_srchflds. Remember, this is a numeric range search, so field values must be numbers in order to get expected results. For example, May 5, 2006 should have a data table field value of 20060505. It is also necessary to map the range_srchflds toto ic_range in field_admin_maps. range_srchflds is where you specify which fields appear in the search form. field_admin_maps is where you specify that the field should be treated as a range when the query is built by the middleware.

For example, if your data records have a field with the abbreviation "year" and it contains 4 digit year values, put year in the range_srchflds Collmgr field, and in field_admin_maps include ic_range:::year.

imgsizemin
optional
value/format:string

class: image

Allows a restriction to be put on the maximum full size image displayed. Definable in terms similar to imgqual. Leave field blank for no restriction.

mediaonly
required
value/format:string

class: image

Controls the presence and default status of the "media only" restriction in the search form. Possible values: on, off, on hidden, off hidden

mediahost
required
value/format:string

class: image

The host server for Image Class media files. The host server must be running DLXS middleware (or at least Image Class). Defaults to global configuration in imageclass.cfg.

numqs
required
value/format:number

class: image

The number of text fields to display in search form.

relviewmenu
required
value/format:string

class: image

Related view menu. Set to "on" to display a pop-up menu in the entry/record view that allows navigation to any of the images associated with the entry/record (the record must have multiple images). Useful as a page-flipping mechanism. e.g.: "off".

relviewmenuinstruct
required
value/format:string

class: image

String of instruction text to precede the related view menu (relviewmenu). e.g.: "default".

relviewmenuprefx
required
value/format:string

class: image

String of text to precede each item in the related view menu (relviewmenu) e.g.: "default."

relviewmenuvals
required
value/format:string

class: image

The SGML ISTRUCT attribute to use for display values in the related view menu (relviewmenu)

e.g.: "default" (same as "CAPTIONS").

In addition to "CAPTIONS", any of the ISTRUCT attribute names are valid (e.g., "FACE").

resfldtrim
required
value/format:number

class: image

Functionality currently disabled due to affects on well-formedness of XML. Maximum character string length for each field in dfltresflds. This is used for trimming long fields down to the specified number of characters when being displayed under thumbnail images. e.g.: "50".

reslistresflds
required
value/format:default or array

class: image

The list of fields (as abbreviations) to display in "captions only " results view. To display all fields, enter the value "default".

resultsviews
required
value/format:array

class: image

The list of results views to be made available to users. Legal values are any combination of: thumbnail, thumbfull, reslist. Order is not important.

resultsviewsdefault
required
value/format:string

class: image

The default result view. Legal values (choose one): thumbnail, thumbfull, reslist

sortflds
required
value/format:array

class: image, text, findaid

Image: The list of field abbreviations that should be provided as options for sorting. Sort fields for multiple collections is configured in the groups database. "none" must always be the first value.

Text: The list of field abbreviations that should be provided as options for sorting. The possible values are "occur", "datea", "dated", "author", "title", "freq" which correspond to the pulldown menu items: "NONE", "date ascending" ,"date descending", "author", "title" and "frequency". The menu items will appear in the order listed in the collmgr field.

Finding Aids: The list of field abbreviations that should be provided as options for sorting. The possible values are "occur", "title", "creator", "freq" which correspond to the pulldown menu items: "NONE", "title", "creator" and "frequency". The menu items will appear in the order listed in the collmgr field.

In single collection mode, the middleware defaults to the first item listed here. If no field abbreviations are specified, the sort selection menu will not appear in the user interface. This makes sense for a collection by a single author with a single publication date where every title is identical or nearly so. For example, "Collected Works of Abraham Lincoln, Vol. 1" published in 1953. If a single field (other than "occur") is supplied the menu will display the single field and that sort will always be done.

In cross-collection mode, these fields are not used. Instead the values in %gSortFields and @gSortFieldsOrder in DLXSROOT/cgi/t/text/textclass.cfg are used and the sort order defaults to the first element of @gSortFieldsOrder (probably 'occur'). Note, for example, when lincoln is part of a cross collection search the sort menu is constructed from @gSortFields which may specify a sort order not specified for the lincoln collection in single-collection mode. In this case, lincoln will sort by author, title, date among the items from the other collections in the search results but only if author, title, date mappings are present in the lincoln.map file. If no mapping for the given sort order exists the item will sort to the end of the list.

field_labels
required
value/format:default or array

class: image

Complete list of all field abbreviations with matching display labels. Must be in the form abbrev:::field label, one per line. Individual field labels may be overriden in any Collmgr field that includes abbreviations, allowing a field label to be changed for the context.. Dots "." are not allowed in the field abbreviation. If using XPAT, and If the SGML uses the dot character in field abbreviations, use underscore here. If there is a field combining all fields, be sure to include it.

Field labels are required, particularly since they are used to determine the legitimacy of a field in certain situations ( sorting, searching ).

field_xcoll_maps
required
value/format:default or array

class: image

For mapping collection specific fields to group or class level fields for cross collection searching. Form is xcoll_abbrev:::collabbrev. Each xcoll_abbrev starts a new line. Multiple collection abbreviations can be listed on a line with a single space between each. Cross collection fields can be arbitrarily added as long as they are added to the group Collmgr record or imageclass.cfg for class level configuration. If using XPAT, the mappings in the SGML must be included here as well. If using MySQL, mappings only need to be here, and nowhere else. If there is a field that combine all fields, map it to ic_all. Every collection specific field in this list requires a full-text index if MySQL is used. More info.

field_load_maps
required
value/format:array

class: image

Strictly used for loading data in to Image Class. The list of fields to be loaded from the source data file. List one fieldname per line. Spaces and forward-slashes should be changed to underscore in this field (no need to change the source data). Each field may be mapped to an alternative or abbreviated name. Form of the mapping is fieldname:::collabbrev. The established convention is to map each field to an abbreviation where the first part is the collid and the second part is an achronym of the imported field name. Once a field is mapped, the abbreviation must be used everywhere the field is referenced. More info.

field_admin_maps
required
value/format:default or array

class: image

Required.

Mappings in field_admin_maps are used for data loading and/or access/middleware. It is essential to be familiar with data loading methods. More info.

For mapping collection specific fields to "administrative" fields. Form is admin_abbrev:::collabbrev. Admin fields are ic_id, ic_fn, ic_vi, ic_all, ic_exact, and ic_range (beta) . Map ic_id to the field in the data_table containing record IDs. Map ic_fn to the field in the data_table containing image/media filenames.ic_exact is only used with MySQL collections, and is optional. ic_exact forces a field to be searched as a an exact phrase, and is intended for searching fields that include data such as IDs that include characters that are usually treated as spaces by MySQL.Map ic_fn to the field(s) containing media file names. Map ic_vi to the field(s) containing media captions. Map ic_all to the fields to be searched as "Anywhere in record". See range_srchflds for help with ic_range.

thumbnailresflds
required
value/format:default or array

class: image

The list of fields (as abbreviations) to display in "thumbnail with captions" results view. To display all fields, enter the value "default".

bibsearch
required
value/format:array

class: text

The regions in which citation searches are conducted (minimally, citation).

divheadrange
required
value/format: number

class: text

A number indicating the deepest level of division encoding present in the collection. Display of heads scoping KWICs and sections will go down to this number. A collection my have divisions more deeply nested than this number but they will not be displayed. For example, specify "4" if the lowest division to display is <DIV4>.

firstpublishedstart
optional
value/format:string

class: text

Indicates whether there are maps for dates of first publication, if available, in the form YYYY where YYYY is the earliest publication date. Derived from markup in the collection. Must be supported by entries in the collection map.

firstpublishedend
optional
value/format:string

class: text

Indicates whether there are maps for dates of first publication, if available, in the form YYYY where YYYY is the latest publication date. Must be supported by entries in the collection map.

firstpublishedinc
optional
value/format:string

class: text

Indicates whether there are maps for dates of first publication, if available, X where X is increment in the number of years between firstpublishedstart and firstpublishedend. Derived from markup in the collection. Must be supported by entries in the collection map.

fisheyethreshold
reserved for future use
value/format:

class: text

Not currently used.

notemaxdivhead
optional
value/format: number

class: text

If collection contains notes this field must have a value greater than 0 otherwise it does not need to be set. This is the number of the most deeply nested division enclosing either a <NOTE> or the target of a <PTR>, e.g. "3" if <DIV3> is the lowest division containing <NOTE> or the target of a <PTR>.

qtytext
required
value/format:number

class: text, findaid

Text: The number of DLPSTEXTCLASS regions in the collection. This is basically the number of text items in the collection.

FindAid: The number of EAD regions in the collection. This is basically the number of entire finding aids in the collection.

regionsearch
required
value/format:array

class: text, bib, findaid

The regions which are retrieved for Boolean searches. These values vary from class to class.

singlegender
optional
value/format:string

class: text

'mappped' indicates that there are maps for specific assigned genders for a single collection, used to create restrictions for searches if available. Otherwise blank. Derived from markup in the collection. Must be supported by entries in the collection map.

singlegenre
optional
value/format:string

class: text

'mapped' indicates that there are maps for specific assigned genres for a single collection, used to create restrictions for searches if available. Otherwise blank. Derived from markup in the collection. Must be supported by entries in the collection map.

singleperiod
optional
value/format:string

class: text

'mapped' indicates that there are maps for specific assigned periods for a single collection, used to create restrictions for searches, if available. Otherwise blank. Derived from markup in the collection. Must be supported by entries in the collection map.

sortthreshold
required
value/format: number

class: text, findaid, image

Number of results above which results obtained from a search are not sorted.(e.g. "1000"). Currently not used in BibClass which is configured globaly in the .cfg files. Note that there is still a global setting for FindaidClass, TextClass and ImageClass in effect from their respective .cfg files when the results are across more than one collection.

subclass
reserved for future use
value/format:

class: text

Not currently used

subclassmodule
required
value/format:string

class: bib, text, findaid

The name of the subclass module (without the '.pm' suffix) that defines the subclass of the TextClass, FindaidClass or BibClass object for the collection.

Many text collections will simply use the value "TextClass" and, likewise, many bib and findaid collections will use the value "BibClass." or "FindaidClass", respectively. For others with a specific subclass, the convention is "collidTC" ("collidBC" for bib) corresponding to the file collidTC.pm or collidBC.pm. Similarly for FindaidClass. These modules are located in the TextClass cgi directory for Text Class or BibClass for Bib Class. (e.g., The subclass should be entered as "TextClass/collidTC"). Similarly for FindaidClass.

 

appmodule
required
value/format:string

class: all

The module name (without .pm suffix) of the Application Object or subclass thereof supporting the basic application functionality for a given class (Text, Image, Bib) of the middleware. Supply one of TextApp, ImageApp or BibApp for the default application behavior or a subclass if one has been written for this collection. (e.g., the subclass should be entered as "TextApp/FooTCApp".) Image Class collections previously configured to use ImageApp/mysqlImageApp must be changed to ImageApp. All Image Class collections should have the value ImageApp.

 

pvappmodule
required
value/format:string

class: text

The module name (without .pm suffix) of the PVApp object or subclass thereof supporting the pageviewer application for this collection. Use "PVApp" unless a subclass has been written for this collection. (e.g., the subclass should be entered as "PVApp/FooPVApp".)

termsearch
required
value/format:array

class: text, bib findaid

The regions in which simple searches are conducted, as they appear in the simple search pull-down menu. Thes vary from class to class.

pageviewmodule
required
value/format: string

class: text

The module name (without .pm suffix) of the PageView object or subclass thereof supporting the database access and image transformation function for the page viewer application for this collection. Use "PageView" unless a subclass has been written for this collection.(e.g., subclass should be entered as "PageView/FooPV".)

wwappmodule
optional
value/format: string

class: text

The module name (without .pm suffix) of the WWApp object or subclass thereof supporting the wordwheel application for this collection. Use "WWApp" unless a subclass has been written for this collection. (e.g., subclass should be entered as "WWApp/FooWWApp".)

pageimages
optional
value/format:string

class: text

Enter 1 if the collection has page images for viewing under page viewer, 0 otherwise.

pageviewselectvalues
optional
value/format:array

class: text

If the collection has page images, enter one or more of 'image, 'text' or 'pdf' to control which viewing formats will be displayed in the page viewer pulldown list.

pdfchunk
optional
value/format:string

class: text

If the collection has pdf, enter the number of image files which are to be bundled into a single pdf file for viewing under page viewer.

encodingtype
required
value/format:string

class: text

The encoding type of documents in the collection. The possible values are "monograph", "serialissue" or "serialarticle". A collection of encoding type "monograph" is structured into one or more documents each of which has a HEADER and a TEXT region. A typical document might be a book by a single author. A collection of encoding type "serialissue" is structured into journals each of which has a HEADER and a TEXT region. Within the TEXT region must occur one or more DIV1 regions representing articles in the given issue of the journal. A collection of encoding type "serialarticle" is a single virtual or born-digital journal structured as a series of articles each of which has a HEADER and a TEXT region.

detailviewtype
required
value/format:string

class: text

The type of the view used to display the detailed results for a single item in the result list. The possible values are "kwic" or "summary". The "kwic" detail view displays bibliographic data for the item followed by a list of Key Words in Context (KWIC). The key word or words are the search terms highlighted in red centered within a context of 100 characters before and after the search term. The "summary" detail view also starts wth the bibliographic data for the item but is followed by a one line summary of the number of hits of the search term within the given item or subregion of the item. For eaxmple, "3 matches of dog in 5 of 20 poems".

detailviewlayout
required
value/format:string

class: text

The layout of DIVs or PAGEs that scopes either the summary or KWIC as selected in the "detailviewtype" field above. The possible values are "breadcrumb" or "outline". The "outline" layout is more or less self-explanitory. Each DIV or PAGE that scopes a KWIC or summary is indented to its proper level as one proceeds down the page. The "breadcrumb" layout is expressed as a path from an upper level DIV down through lower level DIVs all on a single line. For example, 20th Century History>Europe>France followed on the next line by the summary or KWIC display of hits within "France".

printondemand
optional
value/format:string

class: text

Toggles the existence of a "order a reprint" button that can appear on a bibliographic header/T.O.C. display. When field value is "yes" the link appears; if "no" the link does not appear.

hold
optional
value/format:string.

class: all

Used to restrict collections in release from moving to a production machine. When field value is "yes" a collection is prevented from moving to production; when set to "no" the collection is not held. When hold is set to "yes" individual collection rows may not be moved to production.

groupdescr
optional
value/format: string

class: all

A description of the group.

colldescr
optional
value/format: string

class: all

A description of the collection. Not currently used by Image Class.

pvstoredformatprioritymap
optional
value/format: array

class: text

It is possible, within a single collection, that some pages are available in one storage format while others are only available in a different format. This field allows prioritization for these stored formats on the basis of the user's requested view in the Pageviewer application. Settings in this field over-ride the default settings in lib/ItemView.cfg. Each line of the field consists of a user requested view value ("image" or "pdf", configured in the pageviewselectvalues field) separated by an "=" sign followed by a list of image formats in priority order (tif jp2 sid jpg etc.)

An example setting is:

pdf=pdf tif
image=jp2 sid jpg tif

The field works in conjunction with the pvinputoutputmap field to choose the Pageviewer image handler needed to deliver a final format to the browser.

pvinputoutputmap
optional
value/format: array

class: text

This field specifies the mapping for a page image from the stored image format to the format to be delivered to the browser. It selects the handler used to transform from the stored format on disk to format sent to the browser for display. Settings in this field over-ride the default settings in lib/ItemView.cfg. Each line of the field consists of a stored image format such as "jp2", "sid", "jpg", "tif" or "pdf", separated by an "=" sign followed by the desired delivery format.

An example setting is:

sid=jpg
jp2=jpg
tif=gif

This works in conjunction with the pvstoredformatprioritymap field.

optional
value/format: array

class: text

This field specifies the mapping for a page image from the stored image format to the format to be delivered to the browser. It selects the handler used to transform from the stored format on disk to format sent to the browser for display. Settings in this field over-ride the default settings in lib/ItemView.cfg. Each line of the field consists of a stored image format such as "jp2", "sid", "jpg", "tif" or "pdf", separated by an "=" sign followed by the desired delivery format.

An example setting is:

sid=jpg
jp2=jpg
tif=gif

This works in conjunction with the pvstoredformatprioritymap field.

displaynotesinline
optional
value/format: string

class: text

Set this field to "yes" to display <NOTE1> element content inline at the point of reference. Set this field to "no" to put a link to <NOTE1> element content at the point of reference.

browseupdatemodule
optional
value/format: string

class: text, image, findaid

This field specifies the name of the browse update Perl module. The module files are located in DLXSROOT/bin/browse. If a dynamic browse page is to be served this field must have a value. The default behavior is available using one of the values BrowseUpdate/ImageMysqlBU and BrowseUpdate/FindaidBU for ImageClass and FindaidClass, respectively. The TextClass values depend on the encodingtype of the collection. For monograph, serialissue or serialarticle the values are BrowseUpdate/MonographBU, BrowseUpdate/SerialIssueBU and BrowseUpdate/SerialArticleBU, respectively. Newspapers are a specialization of the serialissue encoding type.

This fields works in conjunction with the browsefields, browseable and browsenav fields.

browseable
optional
value/format: string

class: text, image

A "yes" (case-insensitive) value in this field enables the browse tab in the user interface. If a file in the collection-specific web directory for this collection contains a file named "browse.html" that page will be served. This supports static browse pages. If "browse.html" is not present a dynamic browse page will be served based on data from the browse database. When a dynamic browse page is served the browsenav field value is consulted and must be defined.

This fields also works in conjunction with the browsefields field.

browsenav
optional
value/format: number

class: text, image

This field must be defined if dynamic browsing is enabled via the browseable. A value of 0, 1, or 2 should be supplied. A value of 0 creates a single browse page will all items in the collection listed. A value of 1 creates a browse page with an alphabetic "ruler" at the top. A value of 2 creates a browse page with a 2 level alphabetic "ruler" at the top where the first level is the first letter, A-Z and the second level consists of the selected first letter followed by the available second letters from the main entry for the item. The value should be adjusted to provide optimal viewing of the number of items in the collection.

This field also works in conjunction with the browsefields field. It can be selectively over-ridden with a different value for a given field by using special syntax in the browsefields field, which see.

browsefields
optional
value/format: array

class: text, image

This field specifies the fields on which the browse user interface is built. Currently the "title", "subject" and "author" fields are supported in Text Class. Image Class supports all fields. Only field values starting with a letter are currently browseable.

This works in conjunction with the browseable and browsenav fields.

The browsenav field specifies how many levels of an alphabetic ruler are shown. This is a global setting. For some collections, it may be preferable to selectively over-ride this global setting for one our more fields. To over-ride the global browsenav field value for a given item in the "browsefields" field assign a number between 0 and 2 inclusive using either an equal sign (=) or three consecutive colons (:::). For example, to completely turn off the alphabetic ruler for subject browsing use subject=0.

xsltpifillermodule
required
value/format: string

class: text, image, findaid

The name of the subclass of the XsltPIFiller module that defines the PI Filler for the application.

Most TextClass collections will simply use the value "TextAppXsltPIFiller". Similarly for ImageApp and FindaidApp, using the same naming convention. A collection or group of collections may require a specific subclass to be written. Then the convention is (e.g. for TextApp) "TextAppXsltPIFiller/SubclassTextAppXsltPIFiller"where "Subclass" is the specific name you have given to the subclass.

devhost
optional
value/format: string

class: all

The name of the machine hosting the XPAT search engine, data and indexes. If defined here the value takes precedence over the value of host.

containerdepth
required
value/format: number

class: findaid

A number indicating the deepest level of contents list encoding present in the collection, e.g. "4" if the lowest container is <C04>

sponsor
optional
value/format: number

class: all

Sponsor is the name of the organization hosting/publishing the content online. Examples at Michigan are, Digital Library Production Service, Scholoarly Publishing Office, Humanities Text Initiative. Currently used only in the development of a new way to present the list of all collections from all classes where sponsor is a browsing facet/category.

sortpriority
required
value/format: number

class: all

A number indicating the relative priority of this group when sorting the names of the groups for display in the user interface. Numbers should be assigned to all groups to determine their sorting order.

authsystems
required
value/format: array

class: all

One or more values specifying the authentication and authorization system supported for collection-level access for this collection. Possible values are "um" and "athens", currently. At least one of these values must appear. The "um" value indicates default authentication and authorization handling. In this system, the REMOTE_USER, AUTHZD_COLL and PUBLIC_COLL environment variables must be set entirely by an external system and are simply read by the middleware to identify the authenticated user and the authorized and public collection IDs, respectively. To turn off login links in the user interface and to depend entirely on HTTP Basic Auth, set the $LibGlobals::gAuthenticationEnabled in DLXSROOT/lib/LibGlobals.cfg to zero (0).

ignoreon
optional
value/format:array

class: all

The name or names of the virtual hosts you do not want this collection to appear on. The names can be the full name e.g. prod.somewhere.edu or just a part of the name e.g. somewhere.edu or just the token "all" which will ignore the collection or group regardless of host. This is useful if you have a collection or group in the database that is skeletal, i.e. just present to hold values to be read directly from the database for UI purposes. Or perhaps the collection or group is not fully implemented for production use but you want it to appear for development purposes. If you are running the middleware on multiple servers this allows you to hide the collection or group on one or more of your hosts even though the collection or group is listed in the database and, in the case of a collection, authorized in the AUTHZD_COLL environment variable.