Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...


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

Code Block
languagexml
collapsetrue
<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</mods:title>
	</titleInfo>
	<identifier type="oclcSource>OCLCnumber</identifier>
</relatedItem>

<relatedItem type="series">
	<titleInfo type="translated" lang="eng">
		<title>Translated Series Title</mods: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

Multiexcerpt
MultiExcerptNamemarc-related-item

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.