Page History

Table of Contents

style	circle

Element Description

The Provider Dates element presents dates associated with changes made to the granule in the database where it is stored. The provider dates include the date the granule was created, inserted or updated in its database, and the date the granule metadata will be deleted from the CMR.

Best Practices

There are 2 sub-elements which comprise Provider Dates. This includes the Date, which is the date that an event associated with the granule occurred; and the Provider Date Type, which specifies the type of event. The Provider Date Type must be selected from the following controlled vocabulary options:

Create: This signifies the date that the granule file was created. The create date should always be in the past. This date should also be identical to the date provided in the DataGranule/ProductionDateTime field.
Insert: The date the granule file was entered into the database. The insert date should always be in the past.
Update: The date the granule file was last updated. The update date should always be in the past.
Delete: The date that the granule metadata record should be deleted from the CMR. By this logic, the delete date should always be in the future - however, this is not enforced by the schema.

The Date should be provided in a date-time format, and comply with the ISO 8601 Standard, which is an International Standard for the representation of dates and times. Typically, the date is provided in YYYY-MM-DD format and the time is provided in Coordinated Universal Time (UTC).

At least 1 Provider Date is required. If only 1 Provider Date is supplied, then it is highly recommended that the Create Date be provided. This element can be repeated up to 4 times to include each of the different Provider Date Types (Create, Insert, Update, Delete). The same type cannot be repeated (i.e. there can only be 1 Update Date, 1 Insert Date, etc.). Both the Date and Type sub-elements must be provided for each.

Examples:

Type: "Insert"

Date: "2016-12-23T13:46:12Z"

Type: "Update"

Date: "2018-11-13T22:23:00Z"

Element Specification

At least 1 Provider Date is required (Cardinality 1..4). For each Provider Date, the Date and Type must be provided.

Model

Element

Type

Constraints

Required?

Cardinality

Notes

UMM-G

ProviderDates/Type

Enumeration

Create

Insert

Update

Delete

Yes

1..4

At least 1 provider date type is required with it being suggested that "Create" is provided.

UMM-G

ProviderDates/Date

Date-Time

N/A

Yes

1..4

The provider date must also be given for each provider type provided.

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

Lucidchart

rich-viewer	false

autofit	true
name	Copy of Wiki Page Metadata Evaluation Workflow-1939-51df84
width	1102
pages-to-display
id	98e5dc28-3252-4209-953f-66f1378e1cf4
align	Left
height	299

Please see the expandable sections below for flowchart details.

Expand

title	CMR Validation

<>

Expand

title	ARC Metadata QA/QC

ARC Priority Matrix

Priority Categorization	Justification
	This element is categorized as highest priority when: The Provider Dates are not provided. The Provider Dates are incorrect for the granule.
	Not Applicable
	Not Applicable
	The element is provided and follows all applicable criteria specified in the best practices section above.

ARC Automated Rules

TBD

Dialect Mappings

Expand

title	ECHO 10

ECHO 10

The Provider Dates element is required for ECHO 10 (Cardinality 1). The Insert Time and Last Update sub-elements must be provided while Delete Time is optional.

UMM-G Element

ECHO 10 Path

Type

Constraints

Required in ECHO10?

Cardinality

Notes

ProviderDates/Type = Insert

ProviderDates/Date

InsertTime

DateTime

N/A

Yes

1

InsertTime and LastUpate are required for ECHO 10 while Delete Time is not.

ProviderDates/Type = Update

ProviderDates/Date

LastUpdate

DateTime

N/A

Yes

1

ProviderDates/Type = Delete

ProviderDates/Date

DeleteTime

DateTime

N/A

N0

0..1

Example Mapping

Section

Column

width	50%

ECHO 10

No Format
<InsertTime>2016-12-23T13:46:12Z</InsertTime> <LastUpdate>2019-04-23T04:50:00Z</LastUpdate> <DeleteTime>2050-01-10T00:00:00Z</DeleteTime>

Column

width	50%

UMM

No Format
"ProviderDates": [ { "Date": "2016-12-23T13:46:12Z", "Type": "Insert" }, { "Date": "2019-04-23T04:50:00Z", "Type": "Update" }, { "Date": "2050-01-10T00:00:00Z", "Type": "Delete" } ],

Expand

title	ISO 19115-2 MENDS

ISO 19115-2 MENDS

The ISO path where Provider Dates information should be provided is optional in ISO 19115-2 MENDS, however it is required by the UMM-G (Cardinality 1..4).

UMM-G Element

ISO Path

Type

Notes

ProviderDates/Type = Create

ProviderDates/Date

(CMR write only)

/gmi:MI_Metadata/datestamp (write only) use Create date if it exists otherwise use Update date if it exists, otherwise use current date.

(CMR read & write)

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:date/gmd:CI_Date/gmd:date/gco:DateTime {the actual create time}
/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:date/gmd:CI_Date/gmd:dateType/gmd:CI_DateTypeCode

codeList= "https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#CI_DateTypeCode" codeListValue="creation" = creation

DateTime

Codelist

ProviderDates/Type = Insert

ProviderDates/Date

(CMR read & write)

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:date/gmd:CI_Date/gmd:date/gco:DateTime {the actual insert time}
/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:date/gmd:CI_Date/gmd:dateType/gmd:CI_DateTypeCode codeList= "https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#CI_DateTypeCode" codeListValue="insertion" = insertion

DateTime

Codelist

ProviderDates/Type = Update

ProviderDates/Date

(CMR write only)

/gmi:MI_Metadata/datestamp (write only) use Create date if it exists otherwise use Update date if it exists, otherwise use current date.

(CMR read & write)

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:date/gmd:CI_Date/gmd:date/gco:DateTime {the actual update time}
/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:date/gmd:CI_Date/gmd:dateType/gmd:CI_DateTypeCode codeList= "https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#CI_DateTypeCode" codeListValue="revision" = revision

DateTime

Codelist

ProviderDates/Type = Delete

ProviderDates/Date

(CMR read & write)

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:date/gmd:CI_Date/gmd:date/gco:DateTime {the actual delete time}
/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:date/gmd:CI_Date/gmd:dateType/gmd:CI_DateTypeCode codeList= "https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#CI_DateTypeCode" codeListValue="deletion" = deletion

DateTime

Codelist

Example Mapping

Section

Column

width	50%

ISO 19115-2 MENDS

No Format

The below example is for the CMR read & write paths only
<gmi:MI_Metadata>
  <gmd:identificationInfo>
    <gmd:MD_DataIdentification>
      <gmd:citation>
        <gmd:CI_Citation>
          <gmd:date>
            <gmd:CI_Date>
              <gmd:date>
                <gco:DateTime>2005-05-04T08:30:00Z</gco:DateTime>
              </gmd:date>
              <gmd:dateType>
                <gmd:CI_DateTypeCode codeList= "https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#CI_DateTypeCode" codeListValue="creation">creation</gmd:CI_DateTypeCode
              </gmd:dateType>
            </gmd:CI_Date>
          </gmd:date>
          <gmd:date>
            <gmd:CI_Date>
              <gmd:date>
                <gco:DateTime>2005-05-12T12:00:00Z</gco:DateTime>
              </gmd:date>
              <gmd:dateType>
                <gmd:CI_DateTypeCode codeList= "https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#CI_DateTypeCode" codeListValue="insertion">insertion</gmd:CI_DateTypeCode
              </gmd:dateType>
            </gmd:CI_Date>
          </gmd:date>
          <gmd:date>
            <gmd:CI_Date>
              <gmd:date>
                <gco:DateTime>2016-12-23T13:46:12Z</gco:DateTime>
              </gmd:date>
              <gmd:dateType>
                <gmd:CI_DateTypeCode codeList= "https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#CI_DateTypeCode" codeListValue="revision">revision</gmd:CI_DateTypeCode
              </gmd:dateType>
            </gmd:CI_Date>
          </gmd:date>
        </gmd:CI_Citation>
      </gmd:citation>
    </gmd:MD_DataIdentification>
  </gmd:identificationInfo>
</gmi:MI_Metadata>

Column

width	50%

UMM

No Format
"ProviderDates": [ { "Date": "2005-05-04T08:30:00Z", "Type": "Create" }, { "Date": "2005-05-12T12:00:00Z", "Type": "Insert" }, { "Date": "2016-12-23T13:46:12Z", "Type": "Update" } ],

Expand

title	ISO 19115-2 SMAP

ISO 19115-2 SMAP

The Provider Dates element currently only maps to ISO 19115-2 SMAP for the following Provider Date types: Insert and Update.

UMM-G Element

ISO Path

Type

Notes

ProviderDates/Type = Insert

ProviderDates/Date

/gmd:DS_Series/gmd:composedOf/gmd:DS_DataSet/gmd:has/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:date/gmd:CI_Date/gmd:date/gco:DateTime {the insert time}

where

/gmd:DS_Series/gmd:composedOf/gmd:DS_DataSet/gmd:has/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:title/gco:CharacterString = InsertTime

Date-Time

String

Provide the string 'InsertTime' in the gmd:title field so that CMR can properly identify and parse out the Insert Time.

ProviderDates/Type = Update

ProviderDates/Date

/gmd:DS_Series/gmd:composedOf/gmd:DS_DataSet/gmd:has/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:date/gmd:CI_Date/gmd:date/gco:DateTime {the update time}

where

/gmd:DS_Series/gmd:composedOf/gmd:DS_DataSet/gmd:has/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:title/gco:CharacterString = UpdateTime

Date-Time

String

Provide the string 'UpdateTime' in the gmd:title field so that CMR can properly identify and parse out the Update Time.

Example Mapping

Section

Column

width	50%

ISO 19115-2 SMAP

No Format

<gmd:DS_Series>
  <gmd:composedOf>
    <gmd:DS_DataSet>
      <gmd:has>
        <gmi:MI_Metadata>
          <gmd:identificationInfo>
            <gmd:MD_DataIdentification>
              <gmd:citation>
                <gmd:CI_Citation>
                  <gmd:date>
                    <gmd:CI_Date>
                      <gmd:date>
                        <gco:DateTime>2005-05-12T12:00:00Z</gco:DateTime>
                      </gmd:date>
                    </gmd:CI_Date>
                  </gmd:date>
                  <gmd:title>
                    <gco:CharacterString>InsertTime</gco:CharacterString>
                  </gmd:title>
                </gmd:CI_Citation>
              </gmd:citation>
              <gmd:citation>
                <gmd:CI_Citation>
                  <gmd:date>
                    <gmd:CI_Date>
                      <gmd:date>
                        <gco:DateTime>2016-12-23T13:46:12Z</gco:DateTime>
                      </gmd:date>
                    </gmd:CI_Date>
                  </gmd:date>
                  <gmd:title>
                    <gco:CharacterString>UpdateTime</gco:CharacterString>
                  </gmd:title>
                </gmd:CI_Citation>
              </gmd:citation>
            </gmd:MD_DataIdentification>
          </gmd:identificationInfo>
        </gmi:MI_Metadata>
      </gmd:has>
    </gmd:DS_DataSet>
  </gmd:composedOf>
</gmd:DS_Series>

Column

width	50%

UMM

No Format
"ProviderDates": [ { "Date": "2005-05-12T12:00:00Z", "Type": "Insert" }, { "Date": "2016-12-23T13:46:12Z", "Type": "Update" } ],

UMM Migration

UMM Version 1.4.0	Translation Direction	UMM Version 1.5.0

History

UMM Versioning

Version	Date	What Changed
1.6.0	11/4/2019	No changes were made for Provider Dates during the transition from version 1.5.0 to 1.6.0.
1.5.0	01/30/2019	No changes were made for Provider Dates during the transition from version 1.4.0 to 1.5.0.
1.4.0	08/01/2018

ARC Documentation

Version	Date	What Changed	Author
1.0	02/15/2019	Recommendations/priority matrix transferred from internal ARC documentation to wiki space	Camille Woods Jeanne' le Roux

Page tree

Versions Compared

Old Version 18

New Version 19

Key

Element Description

Best Practices

Element Specification

Metadata Validation and QA/QC

Dialect Mappings

ECHO 10

ISO 19115-2 MENDS

ISO 19115-2 SMAP

UMM Migration

History

UMM Versioning

ARC Documentation