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 nameform field typerequiredMODS elementCollections Portal displaynotes
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 Titletext fieldnorelatedItem[*]/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 Languagetext fieldno

relatedItem[*]/titleInfo[@lang]

(attribute of titleInfo)

N/AEnter 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:

(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:

Related Resource Identifier (utldamsURI)text fieldnorelatedItem[*]/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 fieldnorelatedItem[*]/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 fieldnorelatedItem[*]/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 fieldnorelatedItem[*]/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 fieldnorelatedItem[*]/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 fieldnorelatedItem[*]/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 fieldnorelatedItem[*]/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 URLtext fieldnorelatedItem[*]/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:

  1. (no type attribute)
  2. host
  3. series

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

relatedItem[@type="series"]

displayLabel

value:

  1. (no displayLabel attribute)
  2. Parent work
  3. (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:

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:

relatedItem/titleInfo[@type="uniform" and @displayLabel="Uniform/preferred title" and @authority="viaf" and authorityURI="http://viaf.org/viaf/data"]

authorityURIvalues:

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

Dublin Core fieldMapping conditionMODS elementNotes
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 fieldMapping conditionMODS elementNotes
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 elementMapping conditionSolr DAMSSolr Collections PortalNotes
relatedItem/identifier
mods_relatedItem_identifierN/AAll relatedItem/identifier information is merged into a multivalued Solr field.
relatedItem/titleInfo/title

mods_relatedItem_titleInfo_title

N/AAll relatedItem/titleInfo/title information is merged into a multivalued Solr field.
relatedItem/location/url

mods_relatedItem_location_url

N/AAll 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/AAll 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/AAll 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/AAll 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_seriesN/A
relatedItem[@type="host"]/identifier[@type="utldamsPID"]

mods_relatedItem_identifier_utldamsPID_host

N/A
relatedItem[@type="series"]/identifier[@type="utldamsPID"]
mods_relatedItem_identifier_utldamsPID_seriesN/A
relatedItem[@type="host"]/identifier[@type="utldamsURI"]

mods_relatedItem_identifier_utldamsURI_host

N/A
relatedItem[@type="series"]/identifier[@type="utldamsURI"]
mods_relatedItem_identifier_utldamsURI_seriesN/A
relatedItem[@type="host"]/identifier[@type="pid"]

mods_relatedItem_identifier_pid_host

N/A
relatedItem[@type="series"]/identifier[@type="pid"]
mods_relatedItem_identifier_pid_seriesN/A
relatedItem[@type="host"]/identifier[@type="local"]

mods_relatedItem_identifier_local_host

N/A
relatedItem[@type="series"]/identifier[@type="local"]
mods_relatedItem_identifier_local_seriesN/A
relatedItem[@type="host"]/identifier[@type="oclcSource"]

mods_relatedItem_identifier_oclcSource_host

N/A
relatedItem[@type="series"]/identifier[@type="oclcSource"]
mods_relatedItem_identifier_oclcSource_seriesN/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.

🙋 Click here to create a DAMS service request