Element Description

This element stores the DOI (Digital Object Identifier) that identifies the data collection. A DOI is a persistent identifier that is used to uniquely identify objects including datasets and documents.

This element also includes the option to provide information on the authority that registers the DOI. 


Best Practices

For the DOI concept, there are two options for providing information. These options are:

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

DOI/CollectionDOI/Authority: The DOI organization that is responsible for creating the DOI

or

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

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

For CollectionDOI/DOI and CollectionDOI/Authority

CollectionDOI/DOI:

    • When providing information in the CollectionDOI/DOI field, only the DOI string should be provided.  The string value should begin with the directory indicator.
    • The DOI URL should not be stored in the DOI element but should instead be provided as a RelatedURL.
    • For ESDIS providers specifically:
      • 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. Please see the CollectionDOI/MissingReason and CollectionDOI/Explanation section for more information.
      • More details on the ESDIS DOI process can be found here: ESDIS DOI Process
      • A list of DOIs registered through ESDIS can be found here: EOSDIS DOIs Status and Listing
      • The directory indicator for ESDIS is "10." Therefore, if the DOI was registered through ESDIS, the beginning of the DOI string should be "10.5067". 

CollectionDOI/Authority:

    • For ESDIS providers specifically:
      • The CollectionDOI/Authority element value should be "https://doi.org/"

Examples:

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

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


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

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


For CollectionDOI/MissingReason and CollectionDOI/Explanation

CollectionDOI/MissingReason:

    • This element should only be used for specific cases where assigning a DOI to a dataset is not appropriate. These cases include near real time datasets, provisional datasets and datasets that will soon be replaced by a new version.
    • This element is controlled by the enumeration value "Not Applicable." For translation purposes a value of "Unknown" is provided for data sets that do not have a DOI or a MissingReason set.

CollectionDOI/Explanation:

    • This element should be used to describe why a dataset was not assigned a DOI.

Examples:

CollectionDOI/MissingReason: "Not Applicable"

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


CollectionDOI/MissingReason: "Not Applicable"

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


AssociatedDOIs also exist so that data providers can add DOIs from either parent or other associated collections.  This allows users to cite a group of data products. The DOI and Authority should be treated the same as for the CollectionDOI mentioned above.

Element Specification

Choice of:

ModelElementTypeConstraintsRequired?Cardinality
UMM-CDOI/CollectionDOI/DOIString

1024 maximum characters

Yes1
UMM-CDOI/CollectionDOI/AuthorityString80 maximum charactersNo0..1

or

ModelElementTypeUsable Valid ValuesConstraintsRequired?Cardinality
UMM-CDOI/CollectionDOI/MissingReasonEnumerationNot Applicable

n/a

Yes1
UMM-CDOI/CollectionDOI/ExplanationStringn/a1024 maximum charactersNo0..1

Note: only 1 DOI or DOI/MissingReason may be provided (Cardinality: 1)


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
    • Verify that the DOI resolves to the appropriate web page.
  • Automated Review
    • Check that the field length is not greater than 1,024 characters.
    • Check that the DOI is resolvable.
    • Check that the DOI syntax is valid.
  • The DOI must start with two digits followed by a period (.) followed by 4 digits followed by an optional period with optional digits. After the digits the DOI value must be followed by a slash (/) followed by alphanumeric characters.
  • The DOI must be at least 1 character and at most 1024 characters in length.

ARC Priority Matrix

Priority CategorizationJustification

Red = High Priority Finding

This element is categorized as highest priority when:

  • No DOI is provided (either a DOI or "Not Applicable").
  • 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.

Yellow = Medium Priority Finding

This element is categorized as medium priority when:

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

Blue = Low Priority Finding

This element is categorized as low priority when:

  • A DOI is provided but the DOI/CollectionDOI/Authority element is not 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

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

DIF 10

Only 1 Persistent Identifier may be provided (Cardinality: 1)

 Choice of:

UMM-C ElementDIF 10 PathTypeUsable Valid ValuesConstraintsRequired in DIF 10?CardinalityNotes

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.

DOI/DOIDataset_Citation/Persistent_Identifier/IdentifierStringn/a

1 - 80 characters

Yes1n/a
DOI/AuthorityDataset_Citation/Persistent_Identifier/AuthorityStringn/a

1 - 80 characters


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

 or

UMM-C ElementDIF 10 PathTypeUsable Valid ValuesConstraintsRequired in DIF 10?CardinalityNotes
DOI/MissingReason

Dataset_Citation/Persistent_Identifier/MissingReason

Enumeration

Not Applicable

n/a

Yes

1

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

DOI/ExplanationDataset_Citation/Persistent_Identifier/ExplanationStringn/a

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

DIF 10

Translation

Direction

UMM
Not ApplicableNot Applicable


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

Only 1 DOI may be provided (Cardinality: 1)

 Choice of:

UMM-C ElementECHO 10 PathTypeConstraintsRequired in ECHO10?CardinalityNotes
DOI/DOI/Collection/DOI/DOIString

1 - 1024 characters

No0..1n/a
DOI/Authority/Collection/DOI/AuthorityString

1 - 80 characters

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

 or

UMM-C ElementECHO 10 PathTypeUsable Valid ValuesConstraintsRequired in ECHO10?CardinalityNotes
DOI/MissingReason/Collection/DOI/MissingReasonEnumerationNot Applicable

n/a

No0..1Use this option if a dataset does not have a DOI.
DOI/Explanation/Collection/DOI/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

ECHO 10

Translation

Direction

UMM
Not ApplicableNot Applicable


Example Mapping

ECHO 10

<DOI>
  <DOI>10.5067/IAGYM8Q26QRE</DOI>
  <Authority>https://doi.org/</Authority>
</DOI>

or

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

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



ISO 19115-2 MENDS

Only 1 DOI will be translated to CMR (Cardinality: 1)

 Choice of:

UMM-C Element

ISO 19115-2 MENDS Path

TypeNotes
DOI/DOI

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/

gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:code/gco:CharacterString

String


Where the DOI string is provided.

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/

gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:codeSpace/gco:CharacterString = gov.nasa.esdis.umm.doi

StringThe value of "gov.nasa.esdis.umm.doi" should be provided here so that CMR can properly parse out the DOI.

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/

gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:description/gco:CharacterString contains DOI

StringThe value must contain the string "DOI" so that CMR can properly identify and translate the DOI.
DOI/Authority

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/

gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:authority/gmd:CI_Citation/gmd:title - empty element

String

Leave this element empty.

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/

gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:authority/gmd:CI_Citation/gmd:date - empty element

StringLeave this element empty.

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/

gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:authority/gmd:CI_Citation/ gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:organisationName/gco:CharacterString 

StringProvide the authority here. For ESDIS providers, recommend listing "https://doi.org" as the DOI authority.

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/

gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:authority/gmd:CI_Citation/ gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:role/gmd:CI_RoleCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#CI_RoleCode" codeListValue="" = authority

CodelistChoose the "authority" codelist value so that CMR can properly identify the DOI/Authority element. This codelist value does not directly map to a UMM element - choosing 'authority' indicates to CMR that the Authority element should be mapped.

 or

UMM-C Element

ISO 19115-2 MENDS Path

TypeNotes
DOI/MissingReason



/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/

gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:code nilReason="inapplicable"

Code


This indicates that the DOI is "Not Applicable".

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/

gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:codeSpace/gco:CharacterString = gov.nasa.esdis.umm.doi

StringThe value of "gov.nasa.esdis.umm.doi" should be provided here so that CMR can properly parse out the DOI information.

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/

gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:description/gco:CharacterString contains DOI

StringThe value must contain the string "DOI" so that CMR can properly identify and translate the DOI information.
DOI/Explanation

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/

gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:description/gco:CharacterString contains Explanation:


String

If the dataset does not have a DOI, it is highly recommended to provide an explanation why here. The value must contain the string "Explanation:" so that CMR can properly parse out the text.

Enumeration/Code List Mapping

ISO MENDS

Translation

Direction

UMM
inapplicableNot Applicable

Example Mapping

ISO 19115-2 MENDS

<gmi:MI_Metadata>
  ...
  <gmd:identificationInfo>
	<gmd:MD_DataIdentification>
	  <gmd:citation>
	    <gmd:CI_Citation>
          ...
          <gmd:identifier>
            <gmd:MD_Identifier>
              <gmd:authority>
                <gmd:CI_Citation>
                  <gmd:title/>
                  <gmd:date/>
                  <gmd:citedResponsibleParty>
                    <gmd:CI_ResponsibleParty>
                      <gmd:organisationName>
                        <gco:CharacterString>https://doi.org/</gco:CharacterString>
                      </gmd:organisationName>
                      <gmd:role>
                        <gmd:CI_RoleCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#CI_RoleCode" codeListValue="authority">authority</gmd:CI_RoleCode>
                      </gmd:role>
                    </gmd:CI_ResponsibleParty>
                  </gmd:citedResponsibleParty>
                </gmd:CI_Citation>
            </gmd:authority>
            <gmd:code>
              <gco:CharacterString>10.5067/IAGYM8Q26QRE</gco:CharacterString>
            </gmd:code>
            <gmd:codeSpace>
              <gco:CharacterString>gov.nasa.esdis.umm.doi</gco:CharacterString>
            </gmd:codeSpace>
            <gmd:description>
              <gco:CharacterString>A Digital Object Identifier (DOI)</gco:CharacterString>
            </gmd:description>
          </gmd:MD_Identifier>
        </gmd:identifier>
        ...
 
or

<gmi:MI_Metadata>
  ...
  <gmd:identificationInfo>
	<gmd:MD_DataIdentification>
	  <gmd:citation>
	    <gmd:CI_Citation>
          ...
          <gmd:identifier>
            <gmd:MD_Identifier>
              <gmd:code gco:nilReason="inapplicable"/>
              <gmd:codeSpace>
                <gco:CharacterString>gov.nasa.esdis.umm.doi</gco:CharacterString>
              </gmd:codeSpace>
              <gmd:description>
                <gco:CharacterString>DOI Explanation: The collection is near real time and only exists for a couple of days, therefore, the collection was not assigned a DOI.</gco:CharacterString>
              </gmd:description>
            </gmd:MD_Identifier>
          </gmd:identifier>
          ...

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

ISO 19115-2 SMAP

Only 1 DOI will be translated to CMR (Cardinality: 1)

 Choice of:

UMM-C Element

ISO 19115-2 SMAP Path

TypeNotes
DOI/DOI

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/

gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:code/gco:CharacterString

String


Where the DOI string is provided.

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/

gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:codeSpace/gco:CharacterString = gov.nasa.esdis.umm.doi

StringThe value of "gov.nasa.esdis.umm.doi" should be provided here so that CMR can properly parse out the DOI.

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/

gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:description/gco:CharacterString contains DOI

StringThe value must contain the string "DOI" so that CMR can properly identify and translate the DOI.
DOI/Authority

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/

gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:authority/gmd:CI_Citation/gmd:title - empty element

String

Leave this element empty.

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/

gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:authority/gmd:CI_Citation/gmd:date - empty element

StringLeave this element empty.

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification

/gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:authority/gmd:CI_Citation/ gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:organisationName/gco:CharacterString 

StringProvide the authority here. For ESDIS providers, recommend listing "https://doi.org" as the DOI authority.

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/

gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:authority/gmd:CI_Citation/ gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:role/gmd:CI_RoleCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#CI_RoleCode" codeListValue="" = authority

CodelistChoose the "authority" codelist value so that CMR can properly identify the DOI/Authority element. This codelist value does not directly map to a UMM element - choosing 'authority' indicates to CMR that the Authority element should be mapped.

 or

UMM-C Element

ISO 19115-2 SMAP Path

TypeNotes
DOI/MissingReason





/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/

gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:code nilReason="inapplicable"

Code


This indicates that the DOI is "Not Applicable".

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/

gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:codeSpace/gco:CharacterString = gov.nasa.esdis.umm.doi

StringThe value of "gov.nasa.esdis.umm.doi" should be provided here so that CMR can properly parse out the DOI information.

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/

]gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:description/gco:CharacterString contains DOI

StringThe value must contain the string "DOI" so that CMR can properly identify and translate the DOI information.
DOI/MissingReason

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/

gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:description/gco:CharacterString contains Explanation:

String

If the dataset does not have a DOI, it is highly recommended to provide an explanation why here. The value must contain the string "Explanation:" so that CMR can properly parse out the text.


Enumeration/Code List Mapping

ISO SMAP

Translation

Direction

UMM
inapplicableNot Applicable


Example Mapping

ISO 19115-2 SMAP

<gmd:DS_Series>
 <gmd:seriesMetadata>
  <gmi:MI_Metadata>
    ...
	<gmd:identificationInfo>
	  <gmd:MD_DataIdentification>
		<gmd:citation>
		  <gmd:CI_Citation>
          ...
            <gmd:identifier>
              <gmd:MD_Identifier>
                <gmd:authority>
                  <gmd:CI_Citation>
                    <gmd:title/>
                    <gmd:date/>
                    <gmd:citedResponsibleParty>
                      <gmd:CI_ResponsibleParty>
                        <gmd:organisationName>
                          <gco:CharacterString>https://doi.org/</gco:CharacterString>
                        </gmd:organisationName>
                        <gmd:role>
                          <gmd:CI_RoleCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#CI_RoleCode" codeListValue="">authority</gmd:CI_RoleCode>
                        </gmd:role>
                      </gmd:CI_ResponsibleParty>
                    </gmd:citedResponsibleParty>
                  </gmd:CI_Citation>
              </gmd:authority>
              <gmd:code>
                <gco:CharacterString>10.5067/IAGYM8Q26QRE</gco:CharacterString>
              </gmd:code>
              <gmd:codeSpace>
                <gco:CharacterString>gov.nasa.esdis.umm.doi</gco:CharacterString>
              </gmd:codeSpace>
              <gmd:description>
                <gco:CharacterString>A Digital Object Identifier (DOI)</gco:CharacterString>
              </gmd:description>
            </gmd:MD_Identifier>
          </gmd:identifier>
          ...
 
or

<gmd:DS_Series>
 <gmd:seriesMetadata>
  <gmi:MI_Metadata>
    ...
	<gmd:identificationInfo>
	  <gmd:MD_DataIdentification>
		<gmd:citation>
		  <gmd:CI_Citation>
            ...
            <gmd:identifier>
              <gmd:MD_Identifier>
                <gmd:code gco:nilReason="inapplicable"/>
                <gmd:codeSpace>
                  <gco:CharacterString>gov.nasa.esdis.umm.doi</gco:CharacterString>
                </gmd:codeSpace>
                <gmd:description>
                  <gco:CharacterString>DOI Explanation: The collection is near real time and only exists for a couple of days, therefore, the collection was not assigned a DOI.</gco:CharacterString>
                </gmd:description>
              </gmd:MD_Identifier>
            </gmd:identifier>
            ...

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

UMM Migration

None

Future Mappings

ISO 19115-1

Only 1 DOI will be translated to CMR (Cardinality: 1)

 Choice of:

UMM-C Element

ISO 19115-1 Path

TypeNotes
DOI/DOI



/mdb:MD_Metadata/mdb:identificationInfo/mri:MD_DataIdentification/mri:citation/cit:CI_Citation/

cit:identifier/mcc:MD_Identifier/mcc:code/gco:CharacterString

StringWhere the DOI string is provided.

/mdb:MD_Metadata/mdb:identificationInfo/mri:MD_DataIdentification/mri:citation/cit:CI_Citation/

cit:identifier/mcc:MD_Identifier/mcc:codeSpace = gov.nasa.esdis.umm.doi

StringThe value of "gov.nasa.esdis.umm.doi" should be provided here so that CMR can properly parse out the DOI.

/mdb:MD_Metadata/mdb:identificationInfo/mri:MD_DataIdentification/mri:citation/cit:CI_Citation/

cit:identifier/mcc:MD_Identifier/mcc:description/gco:CharacterString contains DOI

StringLeave this element empty.
DOI/Authority



/mdb:MD_Metadata/mdb:identificationInfo/mri:MD_DataIdentification/mri:citation/cit:CI_Citation/

cit:identifier/mcc:MD_Identifier/mcc:authority/cit:CI_Citation/cit:title - empty element

StringProvide the authority here. For ESDIS providers, recommend listing "https://doi.org" as the DOI authority.

/mdb:MD_Metadata/mdb:identificationInfo/mri:MD_DataIdentification/mri:citation/cit:CI_Citation/

cit:identifier/mcc:MD_Identifier/mcc:authority/cit:CI_Citation/cit:citedResponsibleParty/

cit:CI_Responsibility/cit:party/cit:CI_Organization/cit:name/gco:CharacterString

StringProvide the authority here. For ESDIS providers, recommend listing "https://doi.org" as the DOI authority.

/mdb:MD_Metadata/mdb:identificationInfo/mri:MD_DataIdentification/mri:citation/cit:CI_Citation/

cit:identifier/mcc:MD_Identifier/mcc:authority/cit:CI_Citation/cit:citedResponsibleParty/cit:CI_Responsibility/cit:role/cit:roleCode codeList="http://standards.iso.org/iso/19115/resources/Codelist/cat/codelists.xml#CI_RoleCode" codeListValue="" value = authority

CodelistChoose the "authority" codelist value so that CMR can properly identify the DOI/Authority element. This codelist value does not directly map to a UMM element - choosing 'authority' indicates to CMR that the Authority element should be mapped.

 or

UMM-C Element

ISO 19115-1 Path

TypeNotes
DOI/MissingReason








/mdb:MD_Metadata/mdb:identificationInfo/mri:MD_DataIdentification/mri:citation/cit:CI_Citation/


cit:identifier/mcc:MD_Identifier/mcc:code nilReason="inapplicable"

Code


This indicates that the DOI is "Not Applicable".

/mdb:MD_Metadata/mdb:identificationInfo/mri:MD_DataIdentification/mri:citation/cit:CI_Citation/

cit:identifier/mcc:MD_Identifier/mcc:codeSpace = gov.nasa.esdis.umm.doi

StringThe value of "gov.nasa.esdis.umm.doi" should be provided here so that CMR can properly parse out the DOI information.

/mdb:MD_Metadata/mdb:identificationInfo/mri:MD_DataIdentification/mri:citation/cit:CI_Citation/

cit:identifier/mcc:MD_Identifier/mcc:description/gco:CharacterString contains DOI

StringThe value must contain the string "DOI" so that CMR can properly identify and translate the DOI information.
DOI/MissingReason


/mdb:MD_Metadata/mdb:identificationInfo/mri:MD_DataIdentification/mri:citation/cit:CI_Citation/

cit:identifier/mcc:MD_Identifier/mcc:description/gco:CharacterString

contains Explanation:

String

If the dataset does not have a DOI, it is highly recommended to provide an explanation why here. The value must contain the string "Explanation:" so that CMR can properly parse out the text.


Enumeration/Code List Mapping

ISO 19115-1

Translation

Direction

UMM
inapplicableNot Applicable

Example Mapping

ISO 19115-1

<mdb:MD_Metadata>
  ...
  <mdb:identificationInfo>
    <mri:MD_DataIdentification>
      <mri:citation>
        <cit:CI_Citation>  
          ... 
          <cit:identifier>
             <mcc:MD_Identifier>
                <mcc:authority>
                   <cit:CI_Citation>
                      <cit:title/>
                      <cit:citedResponsibleParty>
                         <cit:CI_Responsibility>
                            <cit:role>
                               <cit:roleCode codeList="http://standards.iso.org/iso/19115/resources/Codelist/cat/codelists.xml#CI_RoleCode" codeListValue="CI_RoleCode_author">author</cit:roleCode>
                            </cit:role>
                            <cit:party>
                               <cit:CI_Organisation>
                                  <cit:name>
                                     <gco:CharacterString>https://doi.org/</gco:CharacterString>
                                  </cit:name>
                               </cit:CI_Organisation>
                            </cit:party>
                         </cit:CI_Responsibility>
                      </cit:citedResponsibleParty>
                   </cit:CI_Citation>
                </mcc:authority>
                <mcc:code>
                   <gco:CharacterString>10.5067/IAGYM8Q26QRE</gco:CharacterString>
                </mcc:code>
                <mcc:codeSpace>
                   <gco:CharacterString>gov.nasa.esdis.umm.doi</gco:CharacterString>
                </mcc:codeSpace>
                <mcc:description>
                   <gco:CharacterString>A Digital Object Identifier (DOI)</gco:CharacterString>
                </mcc:description>
             </mcc:MD_Identifier>
          </cit:identifier>
          ...
or

<mdb:MD_Metadata>
  ...
  <mdb:identificationInfo>
    <mri:MD_DataIdentification>
      <mri:citation>
        <cit:CI_Citation>  
          ... 
          <cit:identifier>
             <mcc:MD_Identifier>
                <mcc:code gco:nilReason="inapplicable"/>
                <mcc:codeSpace>
                   <gco:CharacterString>gov.nasa.esdis.umm.doi</gco:CharacterString>
                </mcc:codeSpace>
                <mcc:description>
                   <gco:CharacterString>DOI Explanation: The collection is near real time and only exists for a couple of days, therefore, the collection was not assigned a DOI.</gco:CharacterString>
                </mcc:description>
             </mcc:MD_Identifier>
          </cit:identifier>
          ...

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



History

UMM Versioning

VersionDateWhat Changed
1.15.512/3/2020No changes were made for DOI during the transition from version 1.15.4 to 1.15.5
1.15.49/18/2020No changes were made for DOI during the transition from version 1.15.3 to 1.15.4
1.15.37/1/2020No changes were made for DOI during the transition from version 1.15.2 to 1.15.3
1.15.25/20/2020No changes were made for DOI during the transition from version 1.15.1 to 1.15.2
1.15.13/25/2020No changes were made for DOI during the transition from version 1.15.0 to 1.15.1
1.15.02/26/2020No changes were made for DOI during the transition from version 1.14.0 to 1.15.0
1.14.010/21/2019No changes were made for DOI during the transition from version 1.13.0 to 1.14.0
1.13.004/11/2019No changes were made for DOI during the transition from version 1.12.0 to 1.13.0
1.12.001/22/2019No changes were made for DOI during the transition from version 1.11.0 to 1.12.0.
1.11.011/28/2018No changes were made for DOI during the transition from version 1.10.0 to 1.11.0.
1.10.005/02/2018During the transition from version 1.9.0 to 1.10.0, the sub elements 'MissingReason' and 'Explanation' were added to inform users why a collection is exempt from having a DOI assigned to it.

ARC Documentation

VersionDateWhat ChangedAuthor
2.06/18/2021ARC Priority Matrix updated to include DOI/Missing Reason option. 
1.004/30/18Recommendations/priority matrix transferred from internal ARC documentation to wiki space