Versions Compared

Key

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

...

URLs for the Metadata Management Tool 

SIT environment:      https://mmt.sit.earthdata.nasa.gov

UAT environment:    https://mmt.uat.earthdata.nasa.govPROD environment

PROD environment:    https://mmt.earthdata.nasa.gov

...

To use the MMT, you must have a CMR metadata provider context.   Ensure that, for each of your providers, your Earthdata Login username for the appropriate environment (SIT, UAT, PROD) is a member of a group (normally the Administrator group for the provider) that has both 'Provider Context' and 'Provider Object ACLs' permissions.  See See Manage 'Provider Object Permissions' for a user group.

...

If you see this page, you should log out and contact your provider Administrator or the CMR OPS team at at support@earthdata.nasa.gov to become a member of a provider group.

...

See your provider Administrator if you are not sure whether your username has the correct permissions for these operations.   The provider Administrator should refer to the the Manage 'Provider Object Permissions' for a user group section  section below to assign these permissions.

...

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

Image Modified



The icons on the progress panel have the following meanings:

...

A table of all CMR collection records for the selected provider will be presented (sorted by Entry Title).

Image Modified

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.

...

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

...

2.  Select the new value for the Field to Update from the controlled vocabulary (for Find & Replace, Find & Update, Add to Existing, and Clear All & Replace).   For example:

Image RemovedImage Added

or

Preview your Bulk Update, and submit it.

...

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


Image Added

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:

Image Added

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.



Image Added

Associate a Variable with one or more Collections for my provider

  1. Find the variable record using the instructions above (Find and view variable records in the CMR), and click on the Name of the variable in the search results table to view the variable display page.
  2. At the top of the variable display page, click on 'Manage Collection Associations.



Image Added

3. On the Collection Associations page, all collections already associated with this variable will be displayed in a table:
Image Added
4. To add new collection associations, click on the 'Add Collection Associations' button.
5. A Collection Association Search page will be displayed.   Choose a Search Field from the pull-down selections, and enter a Search Term (value) for that Search Field.   Note that wildcard searches are supported for some search fields.  (The text below the search field will tell you if wildcard searches are supported for that field.)
Image Added

6. A table of collections matching the collection search criteria will be displayed.  Any collections in the search results that are already associated with the variable will be present in the table but grayed out.   Click on the checkbox beside each collection that you wish to associate with the variable (or click the checkbox in the table header to select all collections in the table), and click on Submit below the collection search results table.   All selected collections will be associated with the variable.


Image Added

7.   A Collection Associations results page will be displayed, showing all collections now associated with the Variable.   This includes any prior associations plus the associations just completed.Image Added

NOTE:   Because the collection / variable association operation is asynchronous, the results page may be displayed before all associations have completed.   You may need to click on the 'refresh the page' link to see the final results of the collection association.

Image Added


Disassociate a Variable with one or more Collections for my provider

  1. Find the variable record using the instructions above (Find and view variable records in the CMR), and click on the Name of the variable in the search results table to view the variable display page.
  2. At the top of the variable display page, click on 'Manage Collection Associations;

    Image Added

  3. On the Collection Associations page, all collections already associated with this variable will be displayed in a table:
    Image Added
     

  4. Click the checkbox beside each collection whose association to this variable you wish to delete (or click the checkbox at the top of the table to select all collections in the table).
  5. Click on 'Delete Selected Associations'.  
  6. A Collection Association results page will be displayed, showing all collections still associated with the variable.   
    Image Added

NOTE:   Because the collection / variable disassociation operation is asynchronous, the results page may be displayed before all disassociations have completed.   You may need to click on the 'refresh the page' link to see the final results of the collection disassociation.

Image Added

Find which Collections are associated with a Variable 


  1. Find the variable record using the instructions above (Find and view variable records in the CMR), and click on the Name of the variable in the search results table to view the variable display page.
  2. At the top of the variable display page, click on 'Manage Collection Associations;

    Image Added

  3. On the Collection Associations page, all collections already associated with this variable will be displayed in a table:

Image Added

Manage Service Metadata for my provider


Required Permissions

To create, update, or delete service metadata records in the CMR, or to associate / disassociate services with collections,  your login user id must be a member of a group with Provider Object Permissions which include Ingest Operations Read and Update.

See your provider Administrator if you are not sure whether your user id has the correct permissions for these operations.   The provider Administrator should refer to the "Manage 'Provider Object Permissions' for a user group" section below to assign these permissions.

Create a service record in the CMR for my provider

1. On the 'Manage Services' dashboard,

Image Added 

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

Image Added

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

Image Added

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.

Image Added


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.  

Image Added

NOTE:  When you are working with a draft service record, all 'Save' and 'Done' operations update the draft record in the MMT database, not in the CMR, i.e., DRAFT records are not stored in the CMR.   Your draft service record will not be ingested into the CMR until you click on the 'Publish Service Draft' button in step 7 below.

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

Image Added

The icons on the progress panel have the following meanings:

Image Added

6. View a HTML rendering of your service record on the 'preview panel':

Image Added


7. When all Required fields are complete with no validation errors (red icon) showing on the progress panel, you are ready to Publish your record to the CMR.

Click on the 'Publish Service Draft' button above the Progress Panel on the draft record page:

Image Added

8.   You will see a green banner indicating that your service record has been successfully published to the CMR.   You will also receive an email stating that your record has been published, and providing the 'concept id' (CMR identifier) for the published record.   You may use that concept id to search for your record on the MMT.

Find and view service records in the CMR

Use the 'Search Services ' interface in the upper right corner of the MMT banner:

Image Added

Find records based on a keyword

Enter a search term (e.g., Short Name, Entry Title, a CMR concept id, a service keyword).

in the white 'Enter Search Term' box, and click on 'Search Services'.

A table of CMR service records which match the search term will be presented (sorted by Name).


Image Added

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


Find all service records for a provider

Image Added

Select a provider from the 'Select a Provider' drop-down list, and then click on 'Search Services'.

A table of all CMR service records for the selected provider will be presented (sorted by Name).

Image Added

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

Update a service record in the CMR for my provider

  1. Find the service record using the instructions above (Find and view service records in the CMR), and click on the Name of the service in the search results table to view the service display page.
  2. At the top of the service display page, click on 'Edit Service Record'


Image Added

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.

 Image Added


4.  On the progress panel, click on any section to begin editing the draft record.   Use the progress panel and navigation buttons described above (Create a service 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 Service Draft' button above the progress panel.   This will create a new revision of the service record in the CMR.   The CMR stores up to 10 revisions of each service record.  When an 11th revision is created, the first revision is deleted, and so on.   Each revision of a service record has the same concept id as the original service record.

Image Added


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


1. Find the service record using the instructions above (Find and View Service in the CMR), and click on the Name of the service to view the service page.

2. At the top of the service page, click on 'Clone Service Record'

 Image Added

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 service Names must be unique within a provider, the clone is initiated with a blank 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 Name and Long Name for the clone appears in the blue bar, and the progress panel indicates that the Name and Long Name have not yet been filled in.

Image Added

4.  On the progress panel, click on any section to begin editing the draft record (the clone).  You must enter a new Name and Long Name for the clone.  Use the progress panel and navigation buttons described above (Create a service 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 Service Draft button above the progress panel.   The clone will be stored as a new service record in the CMR, with a different concept id from the original record.



Download JSON for a service record in the CMR

1. Find the service record using the instructions above (Find and View Service in the CMR), and click on the Name of the service to view the service page.

2. At the top of the service page, click on 'Download JSON'

 Image Added

3.  Your browser and local machine will now prompt you through the download process, and a JSON version of the service record will be downloaded to your local machine.

Delete a service record in the CMR for my provider

  1. Find the service record using the instructions above (Find and View Services in the CMR), and click on the Name of the service to view the service page.
  2. At the top of the service page, click on 'Delete Service Record'

Image Added

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

Image Added

4. Click on Yes to delete the service record.   The MMT will then display a 'Service Deleted Successfully!' message.


Image Added


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

1. Find the service record using the instructions above (Find and View Services in the CMR), and click on the Name of the service to view the service page.

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

 Image Added

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

Image RemovedImage Added

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.

...

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


Image RemovedImage Added

Associate a

...

Service with one or more Collections for my provider

  1. Find the variable the service record using the instructions above (Find and view variable service records in the CMR), and click on the Name of the variable the service in the search results table to view the variable display the service display page.
  2. At the top of the variable display the service display page, click on 'Manage Collection Associations'.


Image RemovedImage Added

3. On the Collection Associations page, all collections already associated with this variable service will be displayed in a table:
Image RemovedImage Added
4. To add new collection associations, click on the 'Add Collection Associations' button.
5. A Collection Association Search page will be displayed.   Choose a Search Field from the pull-down selections, and enter a Search Term (value) for that Search Field.   Note that wildcard searches are supported for some search fields.  (The text below the search field will tell you if wildcard searches are supported for that field.)
Image RemovedImage Added

6. A table of collections matching the collection search criteria will be displayed.  Any collections in the search results that are already associated with the variable service will be present in the table but grayed out.   Click on the checkbox beside each collection that you wish to associate with the variable service (or click the checkbox in the table header to select all collections in the table), and click on Submit below the collection search results table.   All selected collections will be associated with the variableservice.

Image RemovedImage Added

7.   A Collection Associations results page will be displayed, showing all collections now associated with the Variableservice.   This includes any prior associations plus the associations just completed.Image RemovedImage Added

NOTE:   Because the collection / variable service association operation is asynchronous, the results page may be displayed before all associations have completed.   You may need to click on the 'refresh the page' link to see the final results of the collection association.


Disassociate a

...

Service with one or more Collections for my provider

  1. Find the variable the service record using the instructions above (Find and view variable service records in the CMR), and click on the Name of the variable the service in the search results table to view the variable display the service display page.
  2. At the top of the variable display the service display page, click on 'Manage Collection Associations';

    Image RemovedImage Added

  3. On the Collection Associations page, all collections already associated with this variable service will be displayed in a table:
    Image RemovedImage Added
     

  4. Click the checkbox beside each collection whose association to this variable service you wish to delete (or click the checkbox at the top of the table to select all collections in the table).
  5. Click on 'Delete Selected Associations'.  
  6. A Collection Association results page will be displayed, showing all collections still associated with the variableservice.      
    Image RemovedImage Added

NOTE:   Because the collection / variable service disassociation operation is asynchronous, the results page may be displayed before all disassociations have completed.   You may need to click on the 'refresh the page' link to see the final results of the collection disassociation.

Find which Collections are associated with a

...

Service 


  1. Find the variable the service record using the instructions above (Find and view variable service records in the CMR), and click on the Name of the variable the service in the search results table to view the variable display the service display page.
  2. At the top of the variable display the service display page, click on 'Manage Collection Associations';

    Image RemovedImage Added

  3. On the Collection Associations page, all collections already associated with this variable service will be displayed in a table:

Image RemovedImage Added

Produce a Holdings Report for my provider 

...

 2. The Order Policies for your provider will be displayed.

3. Click  Click on 'Test Endpoint Connection'.   The MMT will test the endpoint that you have entered under Routing Location, and display a pop-up message indicating whether the endpoint connection was successful or not.

...

2.  Search for Orders for your provider either by: a) entering an Order GUID and an Order GUID and clicking on the Submit button below the Order GUID; or b) entering a combination of order state, user ID, and dateand date/time filters and filters and clicking on the Submit button below the datethe date/time filters.

3. The MMT will display a table of orders for your provider which satisfy the search criteria.

...

  1. Find service entries for your provider using the instructions for 'View Service Entries for my provider 'above.
  2. Click on the 'Edit' action in the row for the Service Entry you wish to edit, or click on the name of the Service Entry you wish to edit, and then click on the Edit button on the Service Entry display page.   NOTE:  Providers are responsible for maintaining Service Entries of Type = Service Implementation.   Service Entries of Type = Service Interface are system-controlled.
  3. The Edit page for the Service Entry will be displayed.      
  4. Edit the fields you wish to change, and click on Submit to save the changes.  
  5. The MMT will display a status message which indicates the success or failure of your service entry update.

...

  1. Find service options for your provider using the instructions for 'Find a Service Option' above.
  2. Click on the 'Delete' action in the row for the Service Option you wish to delete, or click on the name of the Service Option you wish to delete, and then click on the Delete button on the Service Option display page.
  3. You will be prompted to confirm the deletion of the service option.   Click Yes to delete, or click No to avoid the deletion. 

Assign a Service Option to Collections

...

  1. Find service option assignments to specific collections using the instructions for 'View existing Service Option to Collection Assignments' above.
  2. On the display table of Service Option to Collection Assignments, click the checkbox beside any Service Option to Collection Assignments that you wish to delete, and then click on 'Delete Selected Assignments' at the bottom of the table:
  3. You will be prompted to confirm the deletion of the order option assignments.   Click Yes to delete, or click No to avoid the deletion. 

Manage Data Quality Summaries for my provider

...

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

...