Skip to content

Update Metadata for Existing Objects

Mark Bussey edited this page Dec 29, 2017 · 22 revisions

MIRA supports the export and re-import of metadata to allow metadata normalization using external tools. A single file format is used for Metadata Export, Metadata Import, and Batch Object Import. The file format is described in detail on the MIRA XML Import Export Format page and a complete list of valid metadata terms can be found in the MIRA Metadata Profile

Step One: Export XML for Existing Records

To start the process, follow the instructions to select works and Export Existing Metadata.

Step Two: Update the XML

Using the tools of your choice, edit the metadata export file created in Step One. The export and import functions use the same file format. You can add, modify, or delete any predicates listed in the MIRA Metadata Profile.

Any predicate listed as being multivalued may have zero or more entries in the import record. Any predicate listed as being single valued will only read the first value in the import record, even if there are multiple entries for that predicate in the record. Modifying the content of a metadata field will cause that value to be changed on re-import. Deleting an existing field from the exported file will cause that value to be deleted on re-import.

A valid import file will require the proper overall structure with at least <tufts:id>, <dc:title>, <tufts:displays_in>, and <tufts:visibility> defined for each record. In addition, the ID must match the ID of an existing work in the repository or the importer will report an error.

Step Three: Import Updated XML

When you are satisfied with your modifications, import the updated XML manifest via the Raw Metadata Batch Replacement page. You will need to log into the MIRA application and navigate to the admin dashboard. The feature is called, "Import Metadata" and can be found in the left-hand column of tasks under the heading "Import/Export." Click on Import Metadata.

Import Button

From this point on the process is very similar to New Object Import except that you will not be attaching files. From the Raw Metadata Batch Replacement page, select the updated XML file for upload.

Raw Metadata Batch Replacement

While the batch is being processed you can view progress on the Batches page. The page may not load with your import at the top of the queue. Use the ID sort order filter to force the most recent import (hopefully, yours) to the top of the list.

In Progress Raw Metadata Batch Replacement

When the status reads 'Complete,' click on the item ID to go to the Batch status page. This view will give you a queue of all the records that were updated. From here you can go into each record to confirm the update was successful.

Completed Raw Metadata Batch Replacement

Clone this wiki locally