Feature #9839

Adjust MODS import/export mapping for digital object

Added by Tim Hutchinson over 3 years ago. Updated 12 months ago.

Status:VerifiedStart date:05/12/2016
Priority:MediumDue date:
Assignee:Nick Wilkinson% Done:


Category:XML import / export
Target version:Release 2.5.0
Google Code Legacy ID: Tested version:
Sponsored:No Requires documentation:


Currently, the MODS import/export routines use url/@usage="primary display" to capture the image/digital object location. Based on the mapping I provided :)

I've recently been looking into the <url> element, and it turns out a more appropriate mapping would be:

From the guidelines:
Best practice is that the "primary display" URL is a link to the resource with its contextual material (for example metadata, navigation to the collection homepage). If the primary link to a resource is to a stand-alone version of the resource (such as a JPEG image only), an end user will have no context except for the metadata on the service provider's site. At a minimum, the URL should point to a page that contains the resource and a navigation bar that allows users to reach the collection homepage. It is highly desirable that this page also include the descriptive metadata for the resource.

electronicLocator is identified as a copy-specific form of <location><url>, without its attributes.

Short of this change, for <url>, the guidelines (first link above) recommend using the attribute value "primary" instead of "primary display":

primary display – Indicates that the link is the most appropriate to display for end users.
primary – Added for consistency when usage was defined for several other elements. This value has the same definition as "primary display". The intent is that "primary display" will be depricated in favor of "primary" in a future MODS version. Use of " primary" instead of "primary display" is therefore recommended in this attribute.


#1 Updated by Mike Cantelon about 1 year ago

  • Status changed from New to Code Review
  • Assignee set to Nick Wilkinson

#2 Updated by Nick Wilkinson about 1 year ago

  • Assignee changed from Nick Wilkinson to José Raddaoui Marín

Hi Radda, passing this to you for CR.

#3 Updated by José Raddaoui Marín about 1 year ago

  • Status changed from Code Review to Feedback
  • Assignee changed from José Raddaoui Marín to Mike Cantelon

#4 Updated by Mike Cantelon about 1 year ago

  • Status changed from Feedback to QA/Review
  • Assignee changed from Mike Cantelon to Dan Gillean
  • Target version set to Release 2.5.0

Merged into qa/2.5.x for QA.

#5 Updated by Michelle Curran 12 months ago

  • Status changed from QA/Review to Verified
  • Assignee changed from Dan Gillean to Nick Wilkinson

Verified replacement of'primary display' element with 'electronicLocator' in the MODS import/export mapping for a digital object in local qa/2.5.x environment.

#6 Updated by Dan Gillean 12 months ago

  • Category set to XML import / export

Also available in: Atom PDF