You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

Element Description

Choice of:

DOI/DOI: The DOI element stores the DOI (Digital Object Identifier) that identifies the collection.

DOI/Authority: The DOI organization that is responsible for creating the DOI is described in the Authority element.

or

DOI/MissingReason: This element stores the fact that a DOI is not applicable for a record. 

DOI/Explanation: This element describes the reason the DOI is not applicable.


Best Practices

Just the DOI string should be provided in the DOI/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/"
  • 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 

Examples:

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

DOI/Authority: "https://doi.org/"


DOI/DOI: "10.5067/MEASURES/GWELD/GWELDYR.003"

DOI/Authority: "https://doi.org/"


or


DOI/MissingReason: "Not Applicable"

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


DOI/MissingReason: "Not Applicable"

DOI/Explanation: "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:

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 incorrect 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).
  • The DOI/Explanation includes spelling or grammatical errors.

This element is categorized as medium priority when:

  • The DOI/MissingReason option is used but no DOI/Explanation is provided.

This element is categorized as low priority when:

  • A DOI is provided but the DOI/Authority element is not provided.

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


Dialect Mappings

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

DIF 10

SpecificationPathTypeUsable Valid ValuesConstraintsRequired in DIF 10?CardinalityNotes
DIF 10

/DIF/Dataset_Citation/Persistent_Identifier/Type

Enumeration

DOI

ARK

n/a

Yes

1

Only DOI will map to CMR. ARK will not map. This element does not directly map to a UMM element - choosing 'DOI' indicates to CMR that the Identifier and Authority elements should be mapped.

DIF 10/DIF/Dataset_Citation/Persistent_Identifier/IdentifierStringn/a

1 minimum number of characters

80 maximum number of characters

Yes1n/a
DIF 10/DIF/Dataset_Citation/Persistent_Identifier/AuthorityStringn/a

1 minimum number of characters

80 maximum number of characters

No0..1For ESDIS providers, recommend providing "https://doi.org/" as the DOI authority.

or

SpecificationPathTypeUsable Valid ValuesConstraintsRequired in DIF 10?CardinalityNotes
DIF 10

/DIF/Dataset_Citation/Persistent_Identifier/MissingReason

Enumeration

Not Applicable

n/a

Yes

1

Use this option if a dataset does not have a persistent identifier.

DIF 10/DIF/Dataset_Citation/Persistent_Identifier/ExplanationStringn/a

?

No0..1While not required, it is highly recommended to provide an explanation for why a persistent identifier is not applicable for a dataset.


Enumeration Mapping

N/A

Example Mapping

DIF 10

<Dataset_Citation>
 ...
  <Persistent_Identifier>
    <Type>DOI</Type>
    <Identifier>10.5067/IAGYM8Q26QRE</Identifier>
    <Authority>https://doi.org/</Authority>
  </Persistent_Identifier>
</Dataset_Citation>


or


<Dataset_Citation>
 ...
  <Persistent_Identifier>
    <MissingReason>Not Applicable</MissingReason>
    <Explanation>The collection is near real time and only exists for a couple of days, therefore, the collection was not assigned a DOI.</Explanation>
  </Persistent_Identifier>
</Dataset_Citation>

UMM

"DOI": {
  "DOI" : "10.5067/IAGYM8Q26QRE",
  "Authority" : "https://doi.org/"
},


or


"DOI": {
  "MissingReason" : "Not Applicable",
  "MissingExplanation" : "The collection is near real time and only exists for a couple of days, therefore, the collection was not assigned a DOI."
},

ECHO 10

SpecificationPathTypeRequired in ECHO10?Notes
ECHO 10/Collection/VersionIdStringYes


Enumeration Mapping

N/A

Example Mapping

ECHO 10

<VersionId>2.0</VersionId>

UMM

"Version" : "2.0",



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

ISO 19115-2 MENDS

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

UMM

"Version" : "2.0",



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

ISO 19115-2 SMAP

UMM

"Version" : "2.0",



UMM Migration

None


Future Mappings

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.
<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>
"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



  • No labels