Tutorial -- Handling Translation Errors

Let's run another translation on "My First Metadata Record". This time choose the output format as "ISO 19115-2."

Translate "My First Metadata Record" to ISO 19115-2

  • Choose "ISO 11915-2" from the Choose Format control
  • Click the Translate button.

Translate Record Window with Warnings
Image 1: Translate Record Window with Warnings

This time things did not go quite so well. A "Translation Warning" panel has popped up along with the expected Result panel. You are being warned that although you have met the requirements for a minimal mdJSON record, there are still one or more additional requirements needed to generate a valid ISO 19115-2 record.

No problem. The message informs us that we are missing a date for the main resource citation. Let's break the message down by parts before we add the date.

Message Level

The message level can be either Error, Warning, or Notice. In general, all message levels will still generate a metadata record. The message's level speaks more to how well the generated metadata record conforms to the requested standard. We will have more to say on this topic when we discuss translation in detail. For now, the best approach is to fill in all missing data identified by either an Error or Warning message.


The message. In this case "citation dates are missing."

Issued From

The "Issued From" indicator tells which mdTranslator module issued the message. This will be one of the mdTranslator readers or writers. In our example the message was issued by the "ISO 19115-2 writer."


A message context is provided to help you find the offending section of your metadata record. For instance, as discussed earlier, Citation is used in many place throughout the metadata record. It would be insufficient to simply say "citation dates are missing". For which citation?

Context tells us the offending citation is the "main resource citation". Which is not surprising since it's the only Citation we have entered so far.

Let's add the missing date.

Enter a main resource citation date.

  • Click the button next to the "My First Metadata Record" in the Primary Sidebar.
  • Click "Citation" on the Fast Scrolling section of the Secondary Sidebar to scroll Citation to the top.
  • Click the Edit button on the Citation Panel Title Bar.
  • On the Dates panel click the Add Date button
  • Add a date
  • Choose a date type
  • Save your edit if "AutoSave" is not "On"

With our citation date entered let's go back and try the translation to ISO one more time ...

Translate "My First Metadata Record" to "ISO 19115-2"

  • Click "Translate" on the Primary Navigation Bar
  • Choose "ISO 11915-2" from the Choose Format control
  • Click the Translate button.

Worked for me! How about you?

With a valid ISO 19115-2 record in the Result preview panel let's export the metadata ISO record so it can be sent to a clearinghouse, repository, or publisher of our choice.

Save the ISO 19115-2 metadata record.

  • Click the Save Result button.
  • Check your computer's "Downloads" folder for the metadata record.
  • Move the file to a safe location on your computer.
  • Rename the file if you like.

The downloaded metadata file will have a filename format of {recordName}_{date}.{ext}. As an example, the file I downloaded was named "My First Metadata Record_20180907.xml".

Extra Credit!

Now there are a lot of missing elements! FGDC CSDGM has more required elements than either mdJSON or ISO. But we don't need to add all those missing elements for this exercise. Let's just move on to "Exporting Records."

Each standard format has its own set of requirements. Getting your record ready for one standard will not guarantee it is ready for another. Thankfully mdTranslator can sort that out for you by pointing out any missing required elements.

results matching ""

    No results matching ""