Element Description

The Related URLs element provides access to resources related to a granule (i.e. an individual data file within a collection/data set). The Related URL should link to a data access point, as well as relevant tools and services. 

Note: This wiki page pertains to Related URLs in granule level metadata. For guidance on Related URLs in collection level metadata, please see the RelatedURLs (Collections) wiki page.

Best Practices

The Related URLs metadata element allows for the linkage of a metadata record to external resources or locations on the web. When used properly, this element allows users to quickly and easily access data, as well as access relevant services and information about the data. While there are many links that could be provided, it is generally recommended that the granule level Related URLs be kept more light-weight. At a minimum, it is recommended that the following URLs be provided in granule metadata:

  • A link to directly access/download the granule data (i.e. the user should not have to navigate through sub-folders or conduct additional search queries to access the data pertinent to the granule).
  • A link to any relevant services provided for the granule (if applicable) such as: Web Map Services (WMS), OPeNDAP, THREDDS, Web Map Tile Services (WMTS), Web Coverage Services (WCS), etc. 

Links to the following resources are highly recommended at the collection level but are considered less important to include in granule metadata. There is certainly no harm in providing links to these resources in granule metadata, but doing so is completely optional and is left to the discretion of the metadata provider:

  • A link to the landing page for the associated parent collection/ dataset
  • A link to the dataset user's guide and/or comparable documentation which provides important information about how to use the data 
  • A link to relevant software packages
  • A link to relevant online data tools
  • A link to relevant PI documentation
  • Read-Me files
  • Data citation policies
  • Algorithm Theoretical Basis Document (ATBD)
  • Any other documentation directly related to the data (examples include: data recipes, micro articles, product quality assessment documentation, important announcements, documentation on data set anomalies, etc.)  

The following sub-elements are included for RelatedUrls at the granule level:

URL: Where the link is provided. 

Type: The URL Type is a keyword which specifies the content of a link. URL Type keywords are maintained in the Keyword Management System (KMS). A list of valid URL Type keywords can be found here: https://gcmd.earthdata.nasa.gov/kms/concepts/concept_scheme/rucontenttype?format=csv Providing a URL Type is required.     

Subtype: The URL Subtype is a keyword which further specifies the content of a link. Together, the URL Type and Subtype keywords create a keyword hierarchy which is used to identify the URL. Providing a Subtype is optional, but should be used when applicable. The URL Subtype keywords are maintained in the Keyword Management System (KMS). A list of valid URL Subtype keywords can be found here: https://gcmd.earthdata.nasa.gov/kms/concepts/concept_scheme/rucontenttype?format=csv Please see the diagram below for details on the relationship between URL Type and URL Subtype keywords. Providing a URL Subtype is optional, but highly recommended if one applies. 

Description: While not required, it is highly recommended that a description be provided for each URL provided in the metadata. The description should be kept brief and explain where the link navigates and the type of information it contains. Descriptions should be unique to the link. While descriptions can be repeated for the same type of URL across different metadata records, it is generally advised that the same description not be repeated within the same metadata record. I.e. the description should be used to further differentiate two URLs with the same URL Type and Subtype. 

Format: The format of the resource. Providing a format is optional, but it is recommended for URLs that link to data. The format must be selected from the GCMD Granule Data Format Keywords list. 

MimeType: The mime type of the resource. Providing a mime type is optional. Mime type values are currently controlled by an enumeration list in the UMM-G schema. 

Size: For URLs that prompt a download of a file to a user's local desktop, this element in combination with the 'Unit' element can be used to specify the size of the resulting download. The 'Size' field should be a numerical value only. 

Unit: For URLs that prompt a download of a file to a user's local desktop, this element in combination with the 'Size' element can be used to specify the size of the resulting download. The unit must be selected from an enumeration list of file size units that include the following options: KB, MB, GB, TB, PB, NA. NA stands for "Not Applicable."

Please see the below diagram for the relationship between URL Type, and Subtype keywords:

Loading...

    

Examples:

URL: https://asdc.larc.nasa.gov/data/FIREX-AQ/TraceGas_AircraftRemoteSensing_DC8_Data_1/FIREXAQ-UCLA-MINIDOAS-5AVG_DC8_20190808_R0.nc 

Type: GET DATA

Subtype: DIRECT DOWNLOAD

Description: Download the granule data file directly to your desktop. Requires Earthdata login. 

Format: netCDF-3

MimeType: application/x-netcdf

Size: 304

SizeUnit: KB


URL: https://opendap.larc.nasa.gov/opendap/FIREX-AQ/TraceGas_AircraftRemoteSensing_DC8_Data_1/FIREXAQ-UCLA-MINIDOAS-5AVG_DC8_20190808_R0.nc

URL Type: USE SERVICE API

URL Subtype: OPENDAP DATA

Description: Access the granule data file via OPeNDAP.  


Element Specification

Related URLs is an optional metadata element at the granule level (Cardinality: 0..*).

ModelElementTypeUsable Valid ValuesConstraintsRequired?CardinalityNotes
UMM-GRelatedUrls/URLStringn/a

1 - 1024 characters

Yes1
UMM-GRelatedUrls/TypeStringGCMD URL Content Type 'Type' KeywordsKMS controlledYes1
UMM-GRelatedUrls/SubtypeStringGCMD URL Content Type 'Subtype' KeywordsKMS controlledNo0..1The Type and Subtype are part of a keyword hierarchy specified in the KMS.
UMM-GRelatedUrls/DescriptionStringn/a1 - 4000 charactersNo0..1It is strongly recommended that a description be provided for each URL.
UMM-GRelatedUrls/FormatStringGCMD Granule Data Format Keywords

KMS controlled

1 - 80 characters

No0..1
UMM-GRelatedUrls/MimeTypeEnumeration

application/json

application/xml

application/x-netcdf

application/x-hdfeos

application/gml+xml

application/vnd.google-earth.kml+xml

image/gif

image/tiff

image/bmp

text/csv

text/xml

application/pdf

application/x-hdf

application/x-hdf5

application/octet-stream

application/vnd.google-earth.kmz

image/jpeg

image/png

image/vnd.collada+xml

text/html

text/plain

application/zip

application/gzip

application/tar

application/tar+gzip

application/tar+zip

application/vnd.opendap.dap4.dmrpp+xml

Not provided

n/aNo0..1
UMM-GRelatedUrls/Sizenumbern/an/aNo0..1The size of the resource. 
UMM-GRelatedUrls/SizeUnitEnumeration

KB

MB

GB

TB

PB

NA

n/aNo0..1The unit of the resource size. 



Metadata Validation and QA/QC

All metadata entering the CMR goes through the below process to ensure metadata quality requirements are met. All records undergo CMR validation before entering the system. The process of QA/QC is slightly different for NASA and non-NASA data providers. Non-NASA providers include interagency and international data providers and are referred to as the International Directory Network (IDN).

Please see the expandable sections below for flowchart details.


  • Manual Review
    • Identify errors, discrepancies or omissions.
    • Confirm that the URLs link to the appropriate web pages.
  • Automated Review
    • Check that the field has been populated.
    • Check that the URL_Type field is populated with a valid value from KMS.
    • Check for potential broken links.
    • Check that the URL is formatted correctly.
    • Check that the field length of Description is not greater than 12,000 characters.
    • Check that the field length of URL is not greater than 1,024 characters.
  • Checks to see that the URL value is a syntactically valid URL.
  • Checks to see if a description is present.
  • Validates that the object types of GET DATA and GET SERVICE are only used with Distribution URLs.

ARC Priority Matrix

Priority CategorizationJustification

Red = High Priority Finding

This element is categorized as highest priority when:

  • No Related URL is provided.
    • No data access URL is provided. 
    • A data access URL is provided, but it doesn't link directly to the described granule. 
  • The URL provided is broken.
  • The URL provided is incorrect/unrelated to the associated data set.
  • The URL Type or Subtype provided does not accurately describe the link (i.e. the link is mislabeled).
  • The URL Type or Subtype provided does not align with the KMS.
    • The Type or Subtype does not exist in the KMS.
    • The Type or Subtype is placed in the incorrect position of the hierarchy (e.g. GET DATA should not be provided in the Subtype field, because it is categorized as a Type keyword in the KMS).
    • There is an invalid Type/Subtype relationship (e.g. Type: GET DATA, Subtype: USER'S GUIDE, is not a valid combination in the KMS).
  • The URL links to an FTP server (this only applies to NASA EOSDIS metadata).

Yellow = Medium Priority Finding

This element is categorized as medium priority when:

  • The 'Description' element is left blank. It is highly recommended that a description be provided for each URL.
  • A recommendation is made to change a valid URL Type or Subtype keyword for purposes of consistency with other similar metadata records.
  • There is a link to an OPeNDAP or THREDDS server provided at the collection level, but no direct link to the service for the granule is provided.

Blue = Low Priority Finding

This element is categorized as low priority when:

  • The 'Description' element is identical for multiple URLs.
  • If a recommendation is made to add a URL to the metadata, there will be accompanying blue recommendations to add the appropriate URLContentType/URLType/Subtype elements.
  • If a URL with Type "USE SERVICE API" is present, but no mime type is provided, a blue recommendation will be made to add a mime type for the service URL. 
  • A URL is provided via http when https is available.
  • If a recommendation is made to add a new "USE SERVICE API" URL to the metadata, there will be an accompanying blue recommendation to add a mime type for the service URL.
  • The URL provided in the metadata re-directs. It is recommended that the most current link always be provided.

Green = No Findings/Issues

The element is provided and follows all applicable criteria specified in the best practices section above.

ARC Automated Checks

ARC uses the pyQuARC library for automated metadata checks. Please see the pyQuARC GitHub for more information. 

Dialect Mappings



ECHO 10

An unlimited amount of OnlineAccessURLs/OnlineResources and/or AssociatedBrowseImageUrls may be listed (Cardinality: 0..*)

UMM-G ElementPathTypeUsable Valid ValuesConstraintsRequired in ECHO10?CardinalityNotes
RelatedUrls/URL/OnlineAccessURLs/OnlineAccessURL/URLString
String length from 1 to 1024Yes1
RelatedUrls/Description/OnlineAccessURLs/OnlineAccessURL/URLDescriptionString
String length from 1 to 4000No0..1
RelatedUrls/URLContentType = DistributionURL





All OnlineAccessURLs are URLContentTypes of DistributionURL
RelatedUrls/Type = GET DATA





All OnlineAccessURLs are Types of GET DATA
RelatedUrls/GetData/MimeType/OnlineAccessURLs/OnlineAccessURL/MimeTypeString
String length from 1 to 50No0..1
RelatedUrls/URL/Collection/OnlineResources/OnlineResource/URLString

String length from 1 to 1024

Yes1
RelatedUrls/Description/Collection/OnlineResources/OnlineResource/DescriptionString
String length from 1 to 4000No0..1

RelatedUrls/URLContentType

RelatedUrls/Type

RelatedUrls/Subtype

/Collection/OnlineResources/OnlineResource/TypeStringAny GCMD URL Content Type Keyword

KMS controlled

String length from 1 to 50

Yes1ECHO 10 only has a single URL Type field (not a Type and Subtype field). Thus, a URL Type may be selected from either the URL Type or Subtype keywords.

RelatedUrls/GetData/MimeType

/Collection/OnlineResources/OnlineResource/MimeTypeStringGCMD Mime Type Keywords

KMS controlled

String length from 1 to 50

No0..1It is recommended that a mime type always be provided for service URLs.
RelatedUrls/URL/Collection/AssociatedBrowseImageUrls/ProviderBrowseUrl/URLString

String length from 1 to 1024

No0..1This element can be used to link to a browse image. Browse images may also be provided as an Online Resource URL. Use of the Associated Browse URL element is discouraged in favor of the Online Resource URL.
RelatedUrls/Description/Collection/AssociatedBrowseImageUrls/ProviderBrowseUrl/DescriptionString
String length from 1 to 4000No0..1A brief explanation/ description of the browse image.

/Collection/AssociatedBrowseImageUrls/ProviderBrowseUrl/FileSizeLong

No0..1

/Collection/AssociatedBrowseImageUrls/ProviderBrowseUrl/MimeTypeString
String length from 1 to 50No0..1
RelatedUrls/URLContentType = VisualizationURL





For all AssociatedBrowseImageUrls translated to UMM the URLContentType is VisualizationURL
RelatedUrls/Type = GET RELATED VISUALIZATION





For all AssociatedBrowseImageUrls translated to UMM the Type is GET RELATED VISUALIZATION


Example Mapping

ECHO 10

<OnlineAccessURLs>
  <OnlineAccessURL>
    <URL>https://daac.ornl.gov/daacdata/actamerica/ACTAMERICA-PICARRO_Ground/</URL>
    <URLDescription>This link allows direct data access via Earthdata login</URLDescription>
  </OnlineAccessURL>
</OnlineAccessURLs>
<OnlineResources>
  <OnlineResource>
    <URL>https://doi.org/10.3334/ORNLDAAC/1568</URL>
    <Description>Access the data set landing page for the collection.</Description>
    <Type>DATA SET LANDING PAGE</Type>
  </OnlineResource>
  <OnlineResource>
    <URL>https://daac.ornl.gov/ACTAMERICA/guides/ACTAMERICA-PICARRO_Ground.html</URL>
    <Description>The guide document contains detailed information about the data set.</Description>
    <Type>USER'S GUIDE</Type>
  </OnlineResource>
  <OnlineResource>
    <URL>https://daac.ornl.gov/graphics/browse/project/act-america_logo.png</URL>
    <Description>Browse Image</Description>
    <Type>GET RELATED VISUALIZATION</Type>
    <MimeType>image/png</MimeType>
  </OnlineResource>
</OnlineResources>
...
<AssociatedBrowseImageUrls>
  <ProviderBrowseUrl>
    <URL>https://s3.amazonaws.com/grfn-static/SENTINEL-1_INSAR_UNWRAPPED_INTERFEROGRAM_AND_COHERENCE_MAP_browse.png</URL>
  </ProviderBrowseUrl>
</AssociatedBrowseImageUrls>

UMM

"RelatedUrls": [
  {
    "Description": "This link allows direct data access via Earthdata login",
    "URLContentType": "DistributionURL",
    "Type": "GET DATA",
    "URL": "https://daac.ornl.gov/daacdata/actamerica/ACTAMERICA-PICARRO_Ground"
  }, {
    "Description": "Access the data set landing page for the collection.",
    "URLContentType": "CollectionURL",
    "Type": "DATA SET LANDING PAGE",
    "URL":  "https://doi.org/10.3334/ORNLDAAC/1568",
  }, {
    "Description": "The guide document contains detailed information about the data set.",
    "URLContentType": "PublicationURL",
    "Type": "VIEW RELATED INFORMATION",
    "Subtype": "USER'S GUIDE",
    "URL":  "https://daac.ornl.gov/ACTAMERICA/guides/ACTAMERICA-PICARRO_Ground.html"
  }, {
    "Description": "Browse Image",
    "URLContentType": "VisualizationURL",
    "Type": "GET RELATED VISUALIZATION",
    "URL":  "https://daac.ornl.gov/graphics/browse/project/act-america_logo.png"
  }, {
    "URLContentType" : "VisualizationURL",
    "Type" : "GET RELATED VISUALIZATION",
    "URL" : "https://s3.amazonaws.com/grfn-static/SENTINEL-1_INSAR_UNWRAPPED_INTERFEROGRAM_AND_COHERENCE_MAP_browse.png"
  } 
]



ISO 19115-2 MENDS

Note: this section still needs to be updated for UMM-G

An unlimited amount of Related URLs may be listed (Cardinality: 0..*)

Note: These ISO paths only apply to CollectionURLs and PublicationURLs. Please see the RelatedURLs (GET DATA) wiki page for ISO guidance specific to data access URLs. Please see the RelatedURLs (USE SERVICE API) wiki page for ISO guidance specific to services. Please see the Data Center wiki page for ISO guidance specific to DataCenterURLs. Please see the Data Contact wiki page for ISO guidance specific to DataCenterURLs.

UMM-C ElementPathTypeNotes
RelatedUrls/URL

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:aggregationInfo/gmd:MD_AggregateInformation/gmd:aggregateDataSetName/ gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:onlineResource/gmd:CI_OnlineResource/gmd:linkage/gmd:URL

String


Where the URL is provided.

Maps to the UMM element "RelatedUrls/URL"

Note: This path only applies to CollectionURLs and PublicationURLs.

RelatedUrls/Description/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/ gmd:aggregationInfo/gmd:MD_AggregateInformation/gmd:aggregateDataSetName/ gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/ gmd:contactInfo/gmd:onlineResource/gmd:CI_OnlineResource/gmd:description/gco:CharacterString="Description: "String

Maps to the UMM element "RelatedUrls/Description"

A brief, unique description of the URL should be provided in this field. It is highly recommended that a description be provided for each URL.

* The character string should always start with the prefix "Description: " in order for CMR to properly parse out the URL description.

RelatedUrls/URLContentType

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/ gmd:aggregationInfo/gmd:MD_AggregateInformation/gmd:aggregateDataSetName/ gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/ gmd:contactInfo/gmd:onlineResource/gmd:CI_OnlineResource/gmd:description/gco:CharacterString="URLContentType: "String

Maps to the UMM element "RelatedUrls/URLContentType"

The URL Content Type is required in UMM and is used to specify how the link will display in the Earthdata Search Client. The URL Content Type must be selected from the following controlled vocabulary options: CollectionURL, PublicationURL, DataCenterURL, DistributionURL, DataContactURL, VisualizationURL. Please see the best practices section (above) on guidance on choosing the correct URL Content Type.

* The character string should always start with the prefix "URLContentType: " in order for CMR to properly parse out the URL Content Type.

RelatedUrls/Type

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/ gmd:aggregationInfo/gmd:MD_AggregateInformation/gmd:aggregateDataSetName/ gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/ gmd:contactInfo/gmd:onlineResource/gmd:CI_OnlineResource/gmd:description/gco:CharacterString="Type: "

String

Maps to the UMM element "RelatedUrls/Type"

Providing a URL Type is required in UMM. Failing to specify a Type in ISO metadata will result in the field being auto-populated by the CMR, which could result in the URL being mislabeled. URL Type is a GCMD controlled vocabulary field and must be selected from keywords in the KMS. Please see the best practices section (above) on guidance on choosing the correct URL Type.

* The character string should always start with the prefix "Type: " in order for CMR to properly parse out the URL Type.

RelatedUrls/Subtype

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:aggregationInfo/ gmd:MD_AggregateInformation/gmd:aggregateDataSetName/ gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/ gmd:contactInfo/gmd:onlineResource/gmd:CI_OnlineResource/gmd:description/gco:CharacterString="Subtype: " String

Maps to the UMM element "RelatedUrls/Subtype"

Providing a URL Subtype is optional, but is encouraged if an appropriate URL Subtype exists. URL Subtype is a GCMD controlled vocabulary field and must be selected from keywords in the KMS. Please see the best practices section (above) on guidance on choosing the correct URL Subtype.

* The character string should always start with with the prefix "Subtype: " in order for CMR to properly parse out the URL Subtype.


Example Mapping

ISO 19115-2 MENDS

<gmi:MI_Metadata>
...
  <gmd:identificationInfo>
  <gmd:MD_DataIdentification>
   <gmd:citation gco:nilReason="missing"/>
   <gmd:abstract gco:nilReason="missing"/>
    <gmd:aggregationInfo>
    <gmd:MD_AggregateInformation>
      <gmd:aggregateDataSetName>
        <gmd:CI_Citation>
        <gmd:title gco:nilReason="missing"/>
        <gmd:date gco:nilReason="missing"/>
          <gmd:citedResponsibleParty>
          <gmd:CI_ResponsibleParty>
            <gmd:contactInfo>
            <gmd:CI_Contact>
              <gmd:onlineResource>
              <gmd:CI_OnlineResource>
                <gmd:linkage>
                  <gmd:URL>https://doi.org/10.3334/ORNLDAAC/1568</gmd:URL>
                </gmd:linkage>
                <gmd:description>
                  <gco:CharacterString>Description: Access the data set landing page for the collection. URLContentType: CollectionURL URLType: DATA SET LANDING PAGE</gco:CharacterString>
                </gmd:description>
              </gmd:CI_OnlineResource>
              </gmd:onlineResource>
            </gmd:CI_Contact>
            </gmd:contactInfo>
           <gmd:role gco:nilReason="missing"/>
          </gmd:CI_ResponsibleParty>
          </gmd:citedResponsibleParty>
          <gmd:citedResponsibleParty>
          <gmd:CI_ResponsibleParty>
            <gmd:contactInfo>
             <gmd:CI_Contact>
              <gmd:onlineResource>
              <gmd:CI_OnlineResource>
                <gmd:linkage>
                  <gmd:URL>https://daac.ornl.gov/ACTAMERICA/guides/ACTAMERICA-PICARRO_Ground.html</gmd:URL>
                </gmd:linkage>
                <gmd:description>
                  <gco:CharacterString>Description: The guide document contains detailed information about the data set. URLContentType: PublicationURL URLType: VIEW RELATED INFORMATION URLSubtype: USER'S GUIDE</gco:CharacterString>
                </gmd:description>
              </gmd:CI_OnlineResource>
              </gmd:onlineResource>
             </gmd:CI_Contact>
            </gmd:contactInfo>
           <gmd:role gco:nilReason="missing"/>
          </gmd:CI_ResponsibleParty>
          </gmd:citedResponsibleParty>
        </gmd:CI_Citation>
      </gmd:aggregateDataSetName>
     <gmd:associationType gco:nilReason="missing"/>
    </gmd:MD_AggregateInformation>
    </gmd:aggregationInfo>
  </gmd:MD_DataIdentification>
  </gmd:identificationInfo>
...
</gmi:MI_Metadata>

UMM

"RelatedUrls": [
  {
    "Description": "Access the data set landing page for the collection.",
    "URLContentType": "CollectionURL",
    "Type": "DATA SET LANDING PAGE",
    "URL":  "https://doi.org/10.3334/ORNLDAAC/1568",
  }, {
    "Description": "The guide document contains detailed information about the data set.",
    "URLContentType": "PublicationURL",
    "Type": "VIEW RELATED INFORMATION",
    "Subtype": "USER'S GUIDE",
    "URL":  "https://daac.ornl.gov/ACTAMERICA/guides/ACTAMERICA-PICARRO_Ground.html"
  }
]



ISO 19115-2 SMAP

Note: this section still needs to be updated for UMM-G

An unlimited amount of Related URLs may be listed (Cardinality: 0..*)

Note: These ISO paths only apply to CollectionURLs and PublicationURLs. Please see the RelatedURLs (GET DATA) wiki page for ISO guidance specific to data access URLs. Please see the RelatedURLs (USE SERVICE API) wiki page for ISO guidance specific to services. Please see the Data Center wiki page for ISO guidance specific to DataCenterURLs. Please see the Data Contact wiki page for ISO guidance specific to DataCenterURLs.

UMM-C ElementPathTypeNotes
RelatedUrls/URL

gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/ gmd:aggregationInfo/gmd:MD_AggregateInformation/gmd:aggregateDataSetName/ gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/ gmd:contactInfo/gmd:onlineResource/gmd:CI_OnlineResource/gmd:linkage/gmd:URL

String


Where the URL is provided.

Maps to the UMM element "RelatedUrls/URL"

Note: This path only applies to CollectionURLs and PublicationURLs.

RelatedUrls/Descriptiongmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/ gmd:aggregationInfo/gmd:MD_AggregateInformation/gmd:aggregateDataSetName/ gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/ gmd:contactInfo/gmd:onlineResource/gmd:CI_OnlineResource/gmd:description/gco:CharacterString="Description:"
String

Maps to the UMM element "RelatedUrls/Description"

It is highly recommended that a description be provided for each URL.

Provide a brief, unique description of the URL in this field. The value must start with the string "Description: " in order for CMR to properly identify the URL description.

RelatedUrls/URLContentType

gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/ gmd:aggregationInfo/gmd:MD_AggregateInformation/gmd:aggregateDataSetName/ gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/ gmd:contactInfo/gmd:onlineResource/gmd:CI_OnlineResource/gmd:description/gco:CharacterString="URLContentType:"String

Maps to the UMM element "RelatedUrls/URLContentType"

The value must start with the string "URLContentType: " in order for CMR to properly identify the URL Content Type.

The URL Content Type is required in UMM and is used to specify how the link will display in the Earthdata Search Client. The URL Content Type must be selected from the following controlled vocabulary options: CollectionURL, PublicationURL, DataCenterURL, DistributionURL, DataContactURL, VisualizationURL. Please see the best practices section (above) on guidance on choosing the correct URL Content Type.

RelatedUrls/Type

gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/ gmd:aggregationInfo/gmd:MD_AggregateInformation/gmd:aggregateDataSetName/ gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/ gmd:contactInfo/gmd:onlineResource/gmd:CI_OnlineResource/gmd:description/gco:CharacterString="Type:"

String

Maps to the UMM element "RelatedUrls/Type."

The value must start with the string "Type: " in order for CMR to properly identify the URL Type.

Providing a URL Type is required in UMM. Failing to specify a Type in ISO metadata will result in the field being auto-populated by the CMR, which could result in the URL being mislabeled. URL Type is a GCMD controlled vocabulary field and must be selected from keywords in the KMS. Please see the best practices section (above) on guidance on choosing the correct URL Type.

RelatedUrls/Subtype

gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/ gmd:aggregationInfo/gmd:MD_AggregateInformation/gmd:aggregateDataSetName/ gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/ gmd:contactInfo/gmd:onlineResource/gmd:CI_OnlineResource/gmd:description/gco:CharacterString="Subtype:
String

Maps to the UMM element "RelatedUrls/Subtype"

The value must start with the string "Subtype: " in order for CMR to properly identify the URL Subtype.

Providing a URL Subtype is optional, but is encouraged if an appropriate URL Subtype exists. URL Subtype is a GCMD controlled vocabulary field and must be selected from keywords in the KMS. Please see the best practices section (above) on guidance on choosing the correct URL Subtype.


Example Mapping

ISO 19115-2 SMAP

<gmd:DS_Series>
<gmd:seriesMetadata>
<gmi:MI_Metadata>
...
  <gmd:identificationInfo>
  <gmd:MD_DataIdentification>
   <gmd:citation gco:nilReason="missing"/>
   <gmd:abstract gco:nilReason="missing"/>
    <gmd:aggregationInfo>
    <gmd:MD_AggregateInformation>
      <gmd:aggregateDataSetName>
        <gmd:CI_Citation>
        <gmd:title gco:nilReason="missing"/>
        <gmd:date gco:nilReason="missing"/>
          <gmd:citedResponsibleParty>
          <gmd:CI_ResponsibleParty>
            <gmd:contactInfo>
            <gmd:CI_Contact>
              <gmd:onlineResource>
              <gmd:CI_OnlineResource>
                <gmd:linkage>
                  <gmd:URL>https://doi.org/10.3334/ORNLDAAC/1568</gmd:URL>
                </gmd:linkage>
                <gmd:description>
                  <gco:CharacterString>Description: Access the data set landing page for the collection. URLContentType: CollectionURL URLType: DATA SET LANDING PAGE</gco:CharacterString>
                </gmd:description>
              </gmd:CI_OnlineResource>
              </gmd:onlineResource>
            </gmd:CI_Contact>
            </gmd:contactInfo>
           <gmd:role gco:nilReason="missing"/>
          </gmd:CI_ResponsibleParty>
          </gmd:citedResponsibleParty>
          <gmd:citedResponsibleParty>
          <gmd:CI_ResponsibleParty>
            <gmd:contactInfo>
             <gmd:CI_Contact>
              <gmd:onlineResource>
              <gmd:CI_OnlineResource>
                <gmd:linkage>
                  <gmd:URL>https://daac.ornl.gov/ACTAMERICA/guides/ACTAMERICA-PICARRO_Ground.html</gmd:URL>
                </gmd:linkage>
                <gmd:description>
                  <gco:CharacterString>Description: The guide document contains detailed information about the data set. URLContentType: PublicationURL URLType: VIEW RELATED INFORMATION URLSubtype: USER'S GUIDE</gco:CharacterString>
                </gmd:description>
              </gmd:CI_OnlineResource>
              </gmd:onlineResource>
             </gmd:CI_Contact>
            </gmd:contactInfo>
           <gmd:role gco:nilReason="missing"/>
          </gmd:CI_ResponsibleParty>
          </gmd:citedResponsibleParty>
        </gmd:CI_Citation>
      </gmd:aggregateDataSetName>
     <gmd:associationType gco:nilReason="missing"/>
    </gmd:MD_AggregateInformation>
    </gmd:aggregationInfo>
  </gmd:MD_DataIdentification>
  </gmd:identificationInfo>
...
</gmi:MI_Metadata> 
</gmd:seriesMetadata>  
</gmd:DS_Series>

UMM

"RelatedUrls": [
  {
    "Description": "Access the data set landing page for the collection.",
    "URLContentType": "CollectionURL",
    "Type": "DATA SET LANDING PAGE",
    "URL":  "https://doi.org/10.3334/ORNLDAAC/1568",
  }, {
    "Description": "The guide document contains detailed information about the data set.",
    "URLContentType": "PublicationURL",
    "Type": "VIEW RELATED INFORMATION",
    "Subtype": "USER'S GUIDE",
    "URL":  "https://daac.ornl.gov/ACTAMERICA/guides/ACTAMERICA-PICARRO_Ground.html"
  }
]



UMM Migration

None

History

UMM Versioning

VersionDateWhat Changed
1.6.4 2021-10-06Removed Format Enums in favor of using KMS. Granule (UMM-G) only.
1.6.32021-05-03Added new Related URL subtypes for use with Extended Metadata.
1.6.22021-04-21Added GET DATA VIA DIRECT ACCESS to the RelatedUrlTypeEnums.
1.6.12020-06-05Added application/vnd.opendap.dap4.dmrpp+xml to the RelatedUrl Mime-Types and added dmrpp to the formats.
1.62019-11-04No updates were made to RelatedUrls in the transition from v1.5 to v1.6.
1.52019-01-30No updates were made to RelatedUrls in the transition from v1.4 to v1.5.
1.42018-08-01Initial creation of UMM-G schema, prior versions only existed as deliverables on paper but were not implemented. 

ARC Documentation

VersionDateWhat ChangedAuthor
1.02022-03-29Recommendations/priority matrix transferred from internal ARC documentation to wiki spaceJeanne' le Roux



  • No labels

Accessibility