Related Resource
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
| no | relatedItem Depending on the selected Related Resource Type, the MODS element containing information about the Related Resource will have different attributes:
| Depending on the selected Related Resource Type, information will be displayed with different labels:
|
|
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:
|
|
(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
| no | relatedItem[*]/titleInfo[@type] (attribute of titleInfo) Depending on the Title Type selection, a displayLabel attribute will be added to the titleInfo element:
| N/A | When type="uniform", specify which authority was consulted. Options for searching uniform/preferred work titles are: |
(Related Resource Title) Authority | dropdown selection
| 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 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:
|
|
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:
|
|
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:
|
|
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:
| 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:
| 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:
|
|
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:
| relatedItem[@type="host" and @displayLabel="Parent work"] relatedItem[@type="series"] |
displayLabel | value:
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:
| 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:
| 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:
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"] |
authorityURI | values: | 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:
| 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:
| 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
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 | Mapping condition | 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
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 | Mapping condition | 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. |