This page describes how to use the Draft Metadata Management Tool (dMMT) to perform functions related to Create/Read/Update/Delete/Submit of CMR Collection Metadata Proposals.

Accessing the dMMT

URLs for the Draft Metadata Management Tool 

UAT environment: https://draftmmt.uat.earthdata.nasa.gov/

PROD environment: Coming Soon

Provider Context

To use the dMMT, you must have a "non-NASA User" metadata provider context.   Ensure that your Earthdata Login username for the appropriate environment (UAT, PROD) has been provisioned with the proper permissions to use the tool.  

If you log in to the MMT but have no provider context set, you will see the following page:

If you see this page, you should log out and contact the CMR OPS team at support@earthdata.nasa.gov to become a provisioned user.

Login to the dMMT

Click on 'Login with Earthdata Login', and log in to the dMMT using your Earthdata Login username and password for the appropriate environment (UAT, PROD)

Logout of the dMMT

Click on either your login name or the arrow to the right of your login name in the upper right corner of the dMMT page, and then click on Logout. 

Manage Collection Metadata Records in the CMR

Required Permissions

To create, read, update, delete and submit collection metadata proposals, your username must be provisioned with the proper permissions to use the tool.

Contact the CMR OPS team at support@earthdata.nasa.gov if you are not sure whether your username has the correct permissions.   

Create a collection metadata proposal 

1. On the 'Manage Collection Proposals' dashboard,

 click on 'Create New Record'.  A draft collection proposal record will be created.   

2. Begin filling in metadata fields for your draft collection proposal record.  Use the information icons (blue 'i') to get information about what fields mean and how to format their values.

3. Navigate from form to form using the Previous or Next buttons, or by choosing the next form to edit from the pull-down list at 'Save & Jump To:'.    You may work on forms in any order.  When you move from one form to another, your input from the previous form will be saved in your draft record.

4. Explicitly Save form input (within a session or at the end of a session) with the 'Save' button; Finish editing your draft record using the 'Done' button.  

NOTE:  When you are working with a draft collection proposal record, all 'Save' and 'Done' operations update the draft record in the dMMT database, not in the CMR.  Your draft collection proposal record will not be published into the CMR until you click on the 'Submit for Review' button, in step 8 below, and it has been approved by NASA-CMR personnel.

5. Follow progress of your draft record on the progress panel:

The icons on the progress panel have the following meanings:

6. View an HTML rendering of your collection record on the 'preview panel':

7.  Special NOTES when creating or editing a collection level record:

a. To have the NRT (Near Real Time) badge appear for the collection on the Earthdata Search Client, set Collection Type to 'Near Real Time' on the 'Data Information' form.

b.  On the 'Temporal Extent' form, Ends at Present should be set to False if there is an end date for the collection.

c.  Users are strongly encouraged to provide DOI information for the Collection on the 'Collection Information' form.

8.  When all required fields are complete with no validation errors (red icon) showing on the progress panel, you are ready to submit your collection draft proposal record for review.  Click on the 'Submit for Review' button above the progress panel on the draft proposal record page:

9.   You will then see a green banner indicating that your collection draft proposal record has been successfully submitted for review.   You will also receive an email stating that your record has been submitted and under review. 

dMMT users will also receive an email when your record has been approved and published to the CMR. If your record is rejected, you will receive an email with a rationale for why it was not acceptable for publishing to the CMR.

Find and view published collection records in the CMR

Use the 'Search Collections ' interface in the upper right corner of the dMMT banner on the Manage Collections dashboard:

Find records based on a keyword

Enter a search term (e.g., Short Name, Entry Title, a CMR concept id, a science keyword) in the white 'Enter Search Term' box, and click on 'Search Collections'.  A table of published CMR collection records which match the search term will be presented (sorted by Entry Title).

To view an html representation of the metadata for any collection record in the search results table, click on the Short Name of the collection.

Find all collection records for a provider

Select a provider from the 'Select a Provider' drop-down list, and then click on 'Search Collections'.  A table of all published CMR collection records for the selected provider will be presented (sorted by Entry Title).

To view an html representation of the metadata for any collection record in the search results table, click on the Short Name of the collection.

Update a published collection record in the CMR 

1. Find the collection record using the instructions above (Find and View Collections in the CMR), and click on the Short Name of the collection to view the collection information page.

2. At the top of the collection information page, click on 'Edit Collection Record'.

3. A new draft of this record will be created in the MMT database.   The MMT will display the progress panel (and html representation) for the draft record.

4.  On the progress panel, click on any section to begin editing the draft record.   Use the progress panel and navigation buttons described in Create a collection record in the CMR for my provider to update the metadata in the draft record. 

5. When you have finished editing the draft record, publish it to the CMR by clicking on the Publish Draft button above the progress panel.   This will create a new revision of the collection record in the CMR.   The CMR stores up to 10 revisions of each collection record.  When an 11th revision is created, the first revision is deleted, and so on.   Each revision of a collection record has the same concept id as the original collection record.

Clone and edit a collection record in the CMR for my provider

1. Find the collection record using the instructions above (Find and View Collections in the CMR), and click on the Short Name of the collection to view the collection information page.

2. At the top of the collection information page, click on 'Clone Collection Record'

3. A draft of a clone of this record will be created in the MMT database.   The MMT will display the progress panel (and html representation) for the draft record (the clone). 

Since collection Short Names must be unique, the clone is initiated with a blank short name.   The Entry Title of the clone will be initialized  to '<entry title of the original record' - Cloned'.   You may edit the record to change the default entry title of the clone.

NOTE:   A prompt to enter a new short name for the clone appears in the blue bar, and the progress panel indicates that the Short Name has not yet been filled in.

4.  On the progress panel, click on any section to begin editing the draft record (the clone).  You must enter a new Short Name for the clone.  Use the progress panel and navigation buttons described above (Create a collection record in the CMR for my provider) to update the metadata in the draft record. 

5. When you have finished editing the draft record (the clone), publish it to the CMR by clicking on the Publish Draft button above the progress panel.   The clone will be stored as a new collection record in the CMR, with a different concept id from the original record.

Download XML for a collection record in the CMR

1. Find the collection record using the instructions above (Find and View Collections in the CMR), and click on the Short Name of the collection to view the collection information page.

2. On the Overview tab of the collection information page, click on Metadata Download: 'Available Formats'. 

3. You will see a pop-up window asking you to choose the format in which you would like to download the collection metadata.

4. Click on the format that you would like.   Your browser and local machine will now prompt you through the download process.

Delete a collection record in the CMR for my provider

1. Find the collection record using the instructions above (Find and View Collections in the CMR), and click on the Short Name of the collection to view the collection information page.

2. At the top of the collection information page, click on 'Delete Collection Record'.

3. You will see a pop-up message asking you to confirm the record deletion.

4. Click on Yes to delete the record.   The MMT will then display a 'Collection Deleted Successfully!' message, as well as the revision history for the deleted record.  The CMR will create a final revision for the deleted record, which is called a tombstone.   

5. NOTE that you can immediately restore the deleted record from one of the revisions on this Revision History table by clicking on 'Reinstate', but once you have moved to a new page on the MMT, you will no longer be able to find the deleted record to restore it.  If you restore the record from this table, you will see a new revision history, showing the deletion as one of the revisions:

Revert to a previous revision of a collection record in the CMR for my provider 

1. Find the collection record using the instructions above (Find and View Collections in the CMR), and click on the Short Name of the collection to view the collection information page.

2. At the top of the collection information page, click on 'Revisions (<number of revisions>)'

3. A table of the (up to) 10 most recent revisions of the collection record will be displayed.

4. You may View previous revisions of the record by clicking on the 'View' link next to the Revision Description.   After you determine which revision you want to revert to, click on 'Revert to this Revision' in the Actions column for that revision.  You will see a pop-up message asking you to confirm the action:

5. Click on Yes to revert to the selected previous revision of the record.  The MMT will then display a 'Revision Created Successfully!' message, as well as the new revision history for the record.  If there were n revisions before you reverted to a previous revision, there will now be n+1 revisions, and the n+1st revision will be identical to the previous revision to which you reverted.

Create and Manage Collection Record Templates

Create a collection record template for my provider

1. On the 'Manage Collections' dashboard, in the Create Collection Record panel, click on ‘Manage Templates’.

2. On the provider templates page, click on ‘Create a Collection Template’.  A draft collection record template will be created.  

3. Begin filling in metadata fields for your draft collection record.  Use the information icons (blue 'i') to get information about what fields mean and how to format their values.

4. Navigate from form to form using the Previous or Next buttons, or by choosing the next form to edit from the pull-down list at 'Save & Jump To:'. You may work on forms in any order.  When you move from one form to another, your input from the previous form will be saved in your draft record template. Explicitly Save form input (within a session or at the end of a session) with the 'Save' button. To save your draft record template, select the 'Done' button.  

You will see a green banner indicating that your collection record template has been successfully created. NOTE:  When you are working with a draft collection record template, all 'Save' and 'Done' operations update the draft record template in the MMT database, not in the CMR.  Draft collection record templates can be used to create draft collection records that can then be ingested into the CMR.

5. Follow progress of your draft record template on the progress panel:

The icons on the progress panel have the following meanings:

6. View an HTML rendering of your collection record template on the 'preview panel':

7. Special NOTES when creating or editing a collection level record template:

a. To have the NRT (Near Real Time) badge appear for the collection on the Earthdata Search Client, set Collection Type to 'Near Real Time' on the 'Data Information' form.

b.  On the 'Temporal Extent' form, Ends at Present should be set to False if there is an end date for the collection.

c.  NASA data centers are strongly encouraged to provide DOI information for the Collection on the 'Collection Information' form.

Report problems or get help with dMMT

1. Use the Feedback link at the right of the black 'Tophat' dMMT page header to report problems or get help with the MMT.  
2. Send email to support@earthdata.nasa.gov