Versions Compared

Key

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

Table of Contents
stylecircle

Element Description

The DOI element stores the DOI (Digital Object Identifier) that identifies the collection. The DOI organization that is responsible for creating the DOI is described in the Authority element. The DOI/MissingReason element can be used for datasets that do not have a DOI or which use a different type of persistent identifier. 


Best Practices

Just the DOI string should be provided in the DOI field. The DOI URL should not be stored here; it should be stored as a RelatedURL. The DOI value should start with the directory indicator.

For ESDIS providers:

  • The directory indicator for ESDIS is "10"   
  • If the DOI was registered through ESDIS, the beginning of the DOI string should be "10.5067"
  • The DOI/Authority element value should be "https://doi.org/"
  • A list of DOIs registered through ESDIS can be found here: EOSDIS DOIs Status and Listing
  • DOI is a required metadata element for ESDIS providers. While the majority of ESDIS datasets will have a DOI, there are certain cases where having a DOI is not appropriate. These cases include near real time datasets and datasets that will soon be replaced by a new version. In the case that a DOI is not applicable for a dataset, the DOI/MissingReason element should be used to indicate this; and the DOI/Explanation element should be used to describe why the dataset was not assigned a DOI.  
  • A list of DOIs registered through ESDIS can be found here: EOSDIS DOIs Status and Listing 

DOI Examples:

"10.5067/ISS/CATS/L2O_N-M7.1-V2-01_05KMPRO"

"10.5067/MEASURES/GWELD/GWELDYR.003"

"10.5067/3UGE8WQXZAOK"

Missing DOI Explanation Examples:

"The collection is near real time and only exists for a couple of days, therefore, the collection was not assigned a DOI."

"A new version of this dataset will be released in a month (May 2018). This version will be removed from CMR and the new version will be assigned a DOI."


Element Specification

Choice of:

Version
ModelElementTypeConstraintsRequired?Cardinality
UMM-CDOI/DOIString

? maximum number of characters

Yes1
UMM-CDOI/AuthorityString? maximum number of charactersNo0..1

OR

ModelElementTypeUsable Valid ValuesConstraintsRequired?Cardinality
UMM-CDOI/MissingReasonEnumerationNot Applicable

N/A

Yes1
UMM-CDOI/ExplanationStringN/A? maximum number of charactersNo0..1


ARC Priority Matrix

Priority CategorizationJustification

This element is categorized as highest priority when:

  • The element is not included at all.
  • The element is included but is empty.
  • The dataset has a DOI but the metadata indicates that it does not.
  • The version is incorrect for the associated dataincorrect DOI is listed for the dataset.
  • The DOI listed leads to a broken link.
  • The DOI is provided in the incorrect format (e.g. as a URL rather than just the DOI string).

Not applicable


Not applicable


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


Dialect Mappings

Expand
titleDIF 9

DIF 9 (Note: DIF-9 is being phased out and will no longer be supported after 2018)

Expand
titleDIF 10

DIF 10

SpecificationPathTypeRequired in DIF 10?Notes
DIF 10

/DIF/Entry_ID/Version

String

Yes

Version and Entry_Title must be unique for a provider.

Enumeration Mapping

N/A

Example Mapping

Section
Column
width50%

DIF 10

No Format
<Entry_ID>
  <Version>2.0</Version>
</Entry_ID>
Column
width50%

UMM

No Format
"Version" : "2.0",
Expand
titleECHO 10

ECHO 10

SpecificationPathTypeRequired in ECHO10?Notes
ECHO 10/Collection/VersionIdStringYes


Enumeration Mapping

N/A

Example Mapping

Section
Column
width50%

ECHO 10

No Format
<VersionId>2.0</VersionId>
Column
width50%

UMM

No Format
"Version" : "2.0",



Expand
titleISO 19115-2 MENDS

ISO 19115-2 MENDS

SpecificationPathTypeNotes
ISO 19115-2 MENDS

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:edition/gco:CharacterString


String

This field is not required by the ISO schema, however, it is required in the CMR.

Enumeration/Code List Mapping

N/A

Example Mapping

Section
Column
width50%

ISO 19115-2 MENDS

No Format
<gmi:MI_Metadata>
  <gmd:identificationInfo>
    <gmd:MD_DataIdentification>
      <gmd:citation>
        <gmd:CI_Citation>   
          <gmd:edition>
            <gco:CharacterString>2.0</gco:CharacterString>
          </gmd:edition>
        </gmd:CI_Citation>
      </gmd:citation>
    </gmd:MD_DataIdentification>
  </gmd:identificationInfo>
</gmi:MI_Metadata>
Column
width50%

UMM

No Format
"Version" : "2.0",



Expand
titleISO 19115-2 SMAP

ISO 19115-2 SMAP

SpecificationPathTypeNotes
ISO 19115-2 SMAP



StringThis field is not required by the ISO schema, however, it is required in the CMR.

Enumeration/Code List Mapping

N/A

Example Mapping

Section
Column
width50%

ISO 19115-2 SMAP

No Format
Column
width50%

UMM

No Format
"Version" : "2.0",



UMM Migration

None


Future Mappings

Expand
titleISO 19115-1
SpecificationPathTypeNotes
ISO 19115-1

/mdb:MD_Metadata/mdb:identificationInfo/mri:MD_DataIdentification/mri:citation/cit:CI_Citation/cit:edition/gco:CharacterString

StringThis field is not required by the ISO schema, however, it is required in the CMR.
Section
Column
width50%
No Format
<mdb:MD_Metadata>
  <mdb:identificationInfo>
    <mri:MD_DataIdentification>
      <mri:citation>
        <cit:CI_Citation>   
          <cit:edition>
            <gco:CharacterString>2.0</gco:CharacterString>
          </cit:edition>
        </cit:CI_Citation>
      </mri:citation>
    </mri:MD_DataIdentification>
  </mdb:identificationInfo>
</mdb:MD_Metadata>
Column
width50%
No Format
"Version" : "2.0",

History

UMM Versioning

VersionDateWhat Changed
1.0.0
Initial Release

ARC Documentation

VersionDateWhat ChangedAuthor
1.04/18/18Recommendations/priority matrix transferred from internal ARC documentation to wiki spaceJeanne' le Roux