Click here to show Table of Contents...

Abstract

REPEATABLE MULTILINGUAL

MODS Element name: <relatedItem type="host" displayLabel="Parent work"> or <relatedItem type="series"> or <relatedItem> (no attributes)

Short definition: Information that identifies other resources related to the one being described, excluding information entered for Source collection or Digital collection.

Input guidelines: Enter information that identifies other resources related to the one being described. Identify parent works, series that the asset is a part of, or other general related resources that aren't otherwise captured by Digital Collection or Source Collection fields.

Do not enter information about an asset's parent collection in the DAMS.

Information about the DAMS parent collection of an asset is automatically added upon ingest.

Definition

Information that identifies other resources related to the one being described, excluding information entered for Source collection or Digital collection.

DAMS input form fields

Related Resource

DAMS form field name	form field type	required	MODS element	Collections Portal display	notes
Related Resource Type	dropdown selection (empty/none) parent work series	no	relatedItem Depending on the selected Related Resource Type, the MODS element containing information about the Related Resource will have different attributes: empty/none: relatedItem parent work: relatedItem[@type="host" and @displayLabel="Parent work"] series: relatedItem[@type="series"]	Depending on the selected Related Resource Type, information will be displayed with different labels: empty/none: Related Resource - Other parent work: Related Resource - Host series: Related Resource - Series
Related Resource Title	text field	no	relatedItem[*]/titleInfo/title	Information about Related Resource is concatenated into one field. Depending on the selected Related Resource Type, the information will be displayed with different labels: empty/none: Related Resource - Other parent work: Related Resource - Host series: Related Resource - Series
(Related Resource) Title Language	text field	no	relatedItem[*]/titleInfo[@lang] (attribute of titleInfo)	N/A	Enter ISO-639-2 language code (3 letters). Default is "eng" (English).
(Related Resource) Title Type	dropdown selection (empty/none) translated alternative uniforrm	no	relatedItem[]/titleInfo[@type] (attribute of titleInfo) Depending on the Title Type selection, a displayLabel attribute will be added to the titleInfo element: empty/none: no displayLabel attribute translated: no displayLabel attribute alternative: relatedItem[]/titleInfo[@type="alternative" and @displayLabel="Also known as"] uniform: relatedItem[*]/titleInfo[@type="uniform" and @displayLabel="Uniform/preferred title"]	N/A	When type="uniform", specify which authority was consulted. Options for searching uniform/preferred work titles are: LoC Name Authority File (NAF), also consider using the LoC Linked Data Services search interface Virtual International Authority File (VIAF)
(Related Resource Title) Authority	dropdown selection (empty/none) naf viaf	no	relatedItem[*]/titleInfo[@authority] (attribute of titleInfo)	N/A	When title type="uniform", specify which authority was consulted. Options for searching uniform/preferred work titles are: LoC Name Authority File (NAF), also consider using the LoC Linked Data Services search interface Virtual International Authority File (VIAF)
Related Resource Identifier (utldamsURI)	text field	no	relatedItem[*]/identifier[@type="utldamsURI"]	N/A	Enter fully qualified URI of another asset in the DAMS. Do not enter information about an asset's parent collection in the DAMS. Information about the DAMS parent collection of an asset is automatically added upon ingest.
Related Resource Identifier (utldamsPID)	text field	no	relatedItem[*]/identifier[@type="utldamsPID"]	N/A	Enter PID of another asset in the DAMS. Do not enter information about an asset's parent collection in the DAMS. Information about the DAMS parent collection of an asset is automatically added upon ingest.
Related Resource identifier (URI)	text field	no	relatedItem[*]/identifier[@type="uri"]	Information about Related Resource is concatenated into one field. Depending on the selected Related Resource Type, the information will be displayed with different labels: empty/none: Related Resource - Other parent work: Related Resource - Host series: Related Resource - Series
Related Resource identifier (PID)	text field	no	relatedItem[*]/identifier[@type="pid"]	Information about Related Resource is concatenated into one field. Depending on the selected Related Resource Type, the information will be displayed with different labels: empty/none: Related Resource - Other parent work: Related Resource - Host series: Related Resource - Series
Related Resource identifier (local)	text field	no	relatedItem[*]/identifier[@type="local"]	Information about Related Resource is concatenated into one field. Depending on the selected Related Resource Type, the information will be displayed with different labels: empty/none: Related Resource - Other parent work: Related Resource - Host series: Related Resource - Series
Related Resource identifier (OCLC Source)	text field	no	relatedItem[*]/identifier[@type="oclcSource"]	Information about Related Resource is concatenated into one field. Depending on the selected Related Resource Type, the information will be displayed with different labels: empty/none: Related Resource - Other parent work: Related Resource - Host series: Related Resource - Series	Enter OCLC number referring to a catalog entry describing the original work, e.g. the physical original of a digitized work
Related Resource identifier (OCLC Surrogate)	text field	no	relatedItem[*]/identifier[@type="oclcSurrogate"]	Information about Related Resource is concatenated into one field. Depending on the selected Related Resource Type, the information will be displayed with different labels: empty/none: Related Resource - Other parent work: Related Resource - Host series: Related Resource - Series	Enter OCLC number referring to the catalog entry describing a digital copy of a work (if such a catalog entry exists)
Related Resource URL	text field	no	relatedItem[*]/location/url[@displayLabel="Related resource URL"]	Information about Related Resource is concatenated into one field. Depending on the selected Related Resource Type, the information will be displayed with different labels: empty/none: Related Resource - Other parent work: Related Resource - Host series: Related Resource - Series

MODS Element description

Element <relatedItem>

http://www.loc.gov/standards/mods/userguide/relateditem.html

Guidelines for use

<relatedItem> is a container element for subelements describing a related resource. Use attributes to mark the type of relationship between the main resource described in the MODS metadata and the related resource. The DAMS currently allows to explicitly mark relationships between series and parts of a series, and parent/child relationships (e.g. multi-part monographs). For other kinds of relationship between a resource and related resources, do not add a 'type' attribute.

Attributes

Attribute name

Details

XPath syntax examples

type

value:

(no type attribute)
host
series

relatedItem[@type="host" and @displayLabel="Parent work"]

relatedItem[@type="series"]

displayLabel

value:

(no displayLabel attribute)
Parent work
(no displayLabel attribute)

For DAMS metadata about Related Resource, the attribute value for displayLabel depends on the attribute value for type.

relatedItem[@type="host" and @displayLabel="Parent work"]

relatedItem[@type="series"]

Subelements

For information about a Related Resource, the following subelements of <relatedItem> are used in the DAMS:

titleInfo
location
identifier

Subelement <relatedItem><titleInfo>

Guidelines for use

<titleInfo> is a container element that contains subelements related to title information.

Attributes

Attribute name	Details	XPath syntax examples
lang	values: eng (default) ISO-639-2 language codes Enter ISO-639-2 language code (3 letters).	relatedItem[@type="host" and @displayLabel="Parent work"]/titleInfo[@lang="eng"] relatedItem[@type="series"]/titleInfo[@lang="eng"] relatedItem/titleInfo[@lang="eng"]
type	values: (empty/none) translated alternative uniform	relatedItem[@type="host" and @displayLabel="Parent work"]/titleInfo relatedItem[@type="series"]/titleInfo[@type="alternative" and @displayLabel="Also known as"] relatedItem/titleInfo[@type="uniform" and @displayLabel="Uniform/preferred title"]
displayLabel	Corresponds to the value for type: when type="alternative", use displayLabel="Also known as" when type="uniform", use displayLabel="Uniform/preferred title" otherwise, do not add a displayLabel attribute	relatedItem[@type="host" and @displayLabel="Parent work"]/titleInfo[@type="alternative" and @displayLabel="Also known as"] relatedItem/titleInfo[@type="uniform" and @displayLabel="Uniform/preferred title"] relatedItem[@type="series"]/titleInfo
authority	values: (empty/none) naf viaf When type="uniform", specify which authority was consulted. Options for searching uniform/preferred work titles are: LoC Name Authority File (NAF), also consider using the LoC Linked Data Services search interface Virtual International Authority File (VIAF)	relatedItem/titleInfo[@type="uniform" and @displayLabel="Uniform/preferred title" and @authority="viaf" and authorityURI="http://viaf.org/viaf/data"]
authorityURI	values: (empty/none) http://id.loc.gov/authorities/names http://viaf.org/viaf/data	relatedItem/titleInfo[@type="uniform" and @displayLabel="Uniform/preferred title" and @authority="naf" and authorityURI="http://id.loc.gov/authorities/names"]

Subelements

For information about a Source Collection, the following subelement of <titleInfo> is used in the DAMS:

title

Subelement <relatedItem><titleInfo><title>

Guidelines for use

Title of a parent work, a series that the asset is a part of, or other general related resources that are not otherwise captured by information about Digital Collection or Source Collection.

Attributes

No attributes for <title> are currently implemented in the DAMS.

Subelements

No subelements for <title> are currently implemented in the DAMS.

Subelement <relatedItem><location>

Guidelines for use

<location> is a container element; specific data is recorded in the subelements.

Attributes

No attributes for <location> are currently implemented in the DAMS.

Subelements

For information about a Related Resource, the following subelement of <location> is used in the DAMS:

url

Subelement <relatedItem><location><url>

Guidelines for use

<url> is for an electronic location from which a resource is available. Enter the URL of a a parent work, a series that the asset is a part of, or other general related resources that are not otherwise captured by information about Digital Collection or Source Collection.

Attributes

Attribute name

Details

XPath syntax examples

displayLabel

value:

Related resource URL

relatedItem/location/url[@displayLabel="Related resource URL"]

relatedItem[@type="series"]/location/url[@displayLabel="Related resource URL"]

relatedItem[@type="host" and @displayLabel="Parent work"]/location/url[@displayLabel="Related resource URL"]

Subelements

No subelements for <url>.

Subelement <relatedItem><identifier>

Guidelines for use

Enter identifiers for a Related Resource.

Attributes

Attribute name

Details

XPath syntax examples

type

values:

utldamsURI
utldamsPID
uri
pid
local
oclcSource
oclcSurrogate

relatedItem[@type="host" and @displayLabel="Parent work"]/identifier[@type="uri"]

relatedItem[@type="series"]/identifier[@type="pid"]

relatedItem/identifier[@type="local"]

relatedItem[@type="host" and @displayLabel="Parent work"]/identifier[@type="utldamsURI"]

relatedItem[@type="series"]/identifier[@type="utldamsPID"]

relatedItem/identifier[@type="oclcSource"]

relatedItem/identifier[@type="oclcSurrogate"]

Subelements

No subelements for <identifier>.

XML Examples

<relatedItem type="host" "displayLabel="Parent work">
	<titleInfo type="uniform" lang="eng" authority="naf" authorityURI="http://id.loc.gov/authorities/names">
		<title>Uniform Parent Work Title</title>
	</titleInfo>
	<identifier type="oclcSource>OCLCnumber</identifier>
</relatedItem>

<relatedItem type="series">
	<titleInfo type="translated" lang="eng">
		<title>Translated Series Title</title>
	</titleInfo>
	<identifier type="utldamsPID">utlarch:67c766da-7364-49f8-82a5-443b13f8bd07</identifier>
	<identifier type="utldamsURI">https://dams.lib.utexas.edu/islandora/object/utlarch%3A67c766da-7364-49f8-82a5-443b13f8bd07</identifier>
	<location>
		<url displayLabel="Related resource URL">http://relatedresourceurl.edu</url>
	</location>
</relatedItem>

Mappings

Dublin Core

Depending on the direction of mapping necessary, check

DC to MODS: https://www.loc.gov/standards/mods/dcsimple-mods.html
MODS to DC: http://www.loc.gov/standards/mods/mods-dcsimple.html

Dublin Core field	MODS element	Notes
dc:relation	relatedItem[@type="host" and @displayLabel="Parent work"]	MODS subelements are mapped into single dc:relation element by concatenating the element values, separated by double dashes (--).
dc:relation	relatedItem[@type="series"]	MODS subelements are mapped into single dc:relation element by concatenating the element values, separated by double dashes (--).
dc:relation	relatedItem (no attributes)	MODS subelements are mapped into single dc:relation element by concatenating the element values, separated by double dashes (--).

MARC 21

See http://www.loc.gov/standards/mods/mods-mapping.html#relateditem. The following specific guidelines apply for the DAMS:

MARC 21 field	MODS element	Notes
490	relatedItem[@type="series"]/titleInfo/title	Approximate mapping
830	relatedItem[@type="series"]/titleInfo/title	Approximate mapping Check if MARC field 830 contains information about name/title authority. If a uniform title is used in the MARC record, set the appropriate title type attribute in your MODS data.
772	relatedItem[@type="host" and @displayLabel="Parent work"]/*	Check if MARC field 772 contains information about name/title authority. If a uniform title is used in the MARC record, set the appropriate title type attribute in your MODS data.
773	relatedItem[@type="host" and @displayLabel="Parent work"]/*	Check if MARC field 773 contains information about name/title authority. If a uniform title is used in the MARC record, set the appropriate title type attribute in your MODS data.
590	relatedItem[@type="host" and @displayLabel="Parent work"]/*	Check local note in MARC field 590 for information about Related Resources.
79x	relatedItem[@type="host" and @displayLabel="Parent work"]/*	Check local added entries in MARC fields 790-799 for information about Related Resources.

Solr

In general, all MODS metadata is imported into the DAMS Solr server upon ingest. The ingest process generates Solr fields typically named according to the following schema:

mods_value*_suffix

where

value* can be one or multiple element, subelement or attribute names that allow to distinguish Solr fields
suffix is s, t, ss, ms or mt, which refers to the type of data stored in a Solr field and how it is indexed. The Solr index usually contains multiple copies of each field with the same content, distinguished by their suffix.

The following table shows mappings between MODS elements and Solr fields for those fields that are currently used for display in the Collections portal, or where additional processing happens in Islandora or during the publishing process. Suffixes are ignored, unless relevant for the mapping.

MODS element	Solr DAMS	Solr Collections Portal	Notes
relatedItem/identifier	mods_relatedItem_identifier	N/A	All relatedItem/identifier information is merged into a multivalued Solr field.
relatedItem/titleInfo/title	mods_relatedItem_titleInfo_title	N/A	All relatedItem/titleInfo/title information is merged into a multivalued Solr field.
relatedItem/location/url	mods_relatedItem_location_url	N/A	All relatedItem/location/url information is merged into a multivalued Solr field.
relatedItem[@type="host"]/titleInfo/title	mods_relatedItem_titleInfo_title_host	N/A	All title information for relatedItem elements of type host is merged into a multivalued Solr field. This comprises information about Digital Collections (relatedItem[@type="host" and @displayLabel="Digital collection"]), including system-generated information about the DAMS parent collection.
relatedItem[@type="host" and @displayLabel="Parent work"]/titleInfo/title	mods_relatedItem_titleInfo_parent_work_host	N/A	All title information for relatedItem elements of type host and with displayLabel="Parent work" is merged into a multivalued Solr field.
relatedItem[@type="series"]/titleInfo/title	mods_relatedItem_titleInfo_title_series	N/A	All title information for relatedItem elements of type series is merged into a multivalued Solr field.
relatedItem[not(@type)]/titleInfo/title	mods_relatedItem_titleInfo_resource_title	N/A	All title information for relatedItem elements without type attribute is merged into a multivalued Solr field.
relatedItem[@type="host"]/identifier[@type="uri"]	mods_relatedItem_identifier_uri_host	N/A
relatedItem[@type="series"]/identifier[@type="uri"]	mods_relatedItem_identifier_uri_series	N/A
relatedItem[@type="host"]/identifier[@type="utldamsPID"]	mods_relatedItem_identifier_utldamsPID_host	N/A
relatedItem[@type="series"]/identifier[@type="utldamsPID"]	mods_relatedItem_identifier_utldamsPID_series	N/A
relatedItem[@type="host"]/identifier[@type="utldamsURI"]	mods_relatedItem_identifier_utldamsURI_host	N/A
relatedItem[@type="series"]/identifier[@type="utldamsURI"]	mods_relatedItem_identifier_utldamsURI_series	N/A
relatedItem[@type="host"]/identifier[@type="pid"]	mods_relatedItem_identifier_pid_host	N/A
relatedItem[@type="series"]/identifier[@type="pid"]	mods_relatedItem_identifier_pid_series	N/A
relatedItem[@type="host"]/identifier[@type="local"]	mods_relatedItem_identifier_local_host	N/A
relatedItem[@type="series"]/identifier[@type="local"]	mods_relatedItem_identifier_local_series	N/A
relatedItem[@type="host"]/identifier[@type="oclcSource"]	mods_relatedItem_identifier_oclcSource_host	N/A
relatedItem[@type="series"]/identifier[@type="oclcSource"]	mods_relatedItem_identifier_oclcSource_series	N/A
relatedItem[@type="host"]/identifier[@type="oclcSurrogate"]	mods_relatedItem_identifier_oclcSurrogate_host	N/A
relatedItem[@type="series"]/identifier[@type="oclcSurrogate"]	mods_relatedItem_identifier_oclcSurrogate_series	N/A
relatedItem[@type="host"]/titleInfo[not(@displayLabel="UTLDAMS Digital collection name")]/title	mods_host_related_resource_consolidated	mods_host_related_resource_consolidated	For display in the Collections portal, information from all subelements of relatedItem of type host is merged into a multivalued Solr field. The respective type of information (title, uri, pid, url etc.) is added in parentheses. This includes information about Digital Collections (relatedItem[@type="host" and @displayLabel="Digital collection"]), but not the system-generated information about the DAMS parent collection.
relatedItem[@type="host"]/location/url	mods_host_related_resource_consolidated	mods_host_related_resource_consolidated	For display in the Collections portal, information from all subelements of relatedItem of type host is merged into a multivalued Solr field. The respective type of information (title, uri, pid, url etc.) is added in parentheses. This includes information about Digital Collections (relatedItem[@type="host" and @displayLabel="Digital collection"]), but not the system-generated information about the DAMS parent collection.
relatedItem[@type="host"]/identifier[@type="pid" or @type="uri" or @type="local" or @type="oclcSource" or @type="oclcSurrogate"]	mods_host_related_resource_consolidated	mods_host_related_resource_consolidated	For display in the Collections portal, information from all subelements of relatedItem of type host is merged into a multivalued Solr field. The respective type of information (title, uri, pid, url etc.) is added in parentheses. This includes information about Digital Collections (relatedItem[@type="host" and @displayLabel="Digital collection"]), but not the system-generated information about the DAMS parent collection.
relatedItem[@type="series"]/titleInfo/title	mods_series_related_resource_consolidated	mods_series_related_resource_consolidated	For display in the Collections portal, information from all subelements of relatedItem of type series is merged into a multivalued Solr field. The respective type of information (title, uri, pid, url etc.) is added in parentheses.
relatedItem[@type="series"]/location/url	mods_series_related_resource_consolidated	mods_series_related_resource_consolidated	For display in the Collections portal, information from all subelements of relatedItem of type series is merged into a multivalued Solr field. The respective type of information (title, uri, pid, url etc.) is added in parentheses.
relatedItem[@type="series"]/identifier	mods_series_related_resource_consolidated	mods_series_related_resource_consolidated	For display in the Collections portal, information from all subelements of relatedItem of type series is merged into a multivalued Solr field. The respective type of information (title, uri, pid, url etc.) is added in parentheses.
relatedItem[not(@type)]/titleInfo/title	mods_no_type_related_resource_consolidated	mods_no_type_related_resource_consolidated	For display in the Collections portal, information from all subelements of relatedItem without type attribute is merged into a multivalued Solr field. The respective type of information (title, uri, pid, url etc.) is added in parentheses.
relatedItem[not(@type)]/location/url	mods_no_type_related_resource_consolidated	mods_no_type_related_resource_consolidated	For display in the Collections portal, information from all subelements of relatedItem without type attribute is merged into a multivalued Solr field. The respective type of information (title, uri, pid, url etc.) is added in parentheses.
relatedItem[not(@type)]/identifier	mods_no_type_related_resource_consolidated	mods_no_type_related_resource_consolidated	For display in the Collections portal, information from all subelements of relatedItem without type attribute is merged into a multivalued Solr field. The respective type of information (title, uri, pid, url etc.) is added in parentheses.