Multiple resolution guide

There are a few steps involved in coordinating and implementing Multiple Resolution:

1. Establish permissions

You’ll need to let us know what organizations and content will be involved in your multiple resolution project and we’ll adjust permissions as needed.

If you are implementing multiple resolution without a secondary depositor or intend to supply the secondary URLs yourself, you can skip this step - you are by default enabled to register multiple resolution URLs for your own content.

Multiple resolution typically involves two (or more) members involved in a co-hosting agreement. For the purposes of multiple resolution, the primary depositor is the member responsible for the prefix of the multiple resolution content being registered. The secondary depositor has been authorized by the content owner to also host content and assign additional URLs (called ‘secondary URLs’) to DOIs. We’ll always defer to the primary depositor’s instructions regarding changes to a metadata record including all assigned URLs.

The primary depositor must notify us of the intention to implement multiple resolution for their metadata records, as well as all titles and/or prefixes involved. The secondary depositor may coordinate multiple resolution activity with permission from the primary depositor.

Primary depositors can create metadata records and deposit primary and secondary URLs. Secondary depositors may only register secondary URLs for existing records. The secondary depositor will be assigned a new system account to be used for multiple resolution deposits only.

2. Create an interim page template

When multiple URLs are registered for your content your links will resolve to an interim page. We host the page but encourage you to provide a custom template. If you do not provide a template your content will resolve to a plain but functional default page.

The template is an HTML page and operates on a simple text replacement process. The interim page supports the directives below (they can appear anywhere in the template HTML file):

  • <!–doi–> will be replaced by the DOI being resolved
  • <!–metadata–> will be replaced with metadata from the registered metadata record for the DOI. This data is presented as HTML table rows and data cells
  • <!–link–> will be replaced by the URL of one MR target (multiple uses of this directive will iterate through the available MR secondary targets)
  • <!–link-prime–> will be replaced by the primary URL which is the URL initially included in the metadata record (presumably the primary content owner’s URL)
  • <!–link label=“XYZ123”–> will be replaced by the URL of the multiple resolution target deposited with the specified label. Labels used in <!–link label=“XYZ123”–> must match the label supplied in secondary URL deposits.

Marked-up examples are available in our technical documentation. When your interim template is ready, send it to us and we’ll check it in. Be sure to include all image and .css files as well as your HTML template.

3. Unlock your DOIs

You must enable each metadata record for multiple resolution by sending us an ‘unlock’ flag for each DOI. This can be included in your Content Registration files or sent separately as a resource-only deposit. Examples and instructions are available in our documentation.

4. Register your secondary URLs

Secondary URLs are usually added to an existing metadata record using a resource-only deposit. The secondary URL registration file contains the DOI(s) being updated, the secondary URL, and a label. The label must correspond to the label provided in the interim page template - if the label values do not match, the URL won’t be pulled into the template. The label value is case-sensitive and must be a minimum of 6 characters (no spaces).

Examples and submission instructions are available in our documentation.

Need more information? See our documentation, or contact us for help.

Page owner: Patricia   |   Last updated 2017-January-04