Overview

Batch Builder by default requests public delivery service URNs for deliverable files of still image objects, document objects and text objects. For PDS document objects a public delivery URN is requested for the object itself rather than for a particular file within the object. For opaque objects no public delivery URNs are requested.

File URN authority path and URN resource name pattern value can be entered in the required settings panel for each object or in the object template required setting panel (in which case the settings will propagate to all objects created from the template).


 

Required settings panel – NRS section

Additionally, for PDS Document Objects, Object URN Resource Name Pattern value can be entered in the required settings panel for each object or in the object template required setting panel (in which case the settings will propagate to all objects created from the template).

Required settings panel – PDS object NRS section

Assigning File URN Resource Name Patterns

 The resource name component of the URN must be unique relative to the authority path. Batch Builder can generate all or part of the resource name automatically using mask fields that will be replaced with actual values by the system (shown in the table below). 

Resource names can be composed of alpha-numeric characters (upper and lower case, although all NRS comparisons are case-insensitive) and the following punctuation characters:

     ( ) + , - = @ ; $ _ ! * ' . :

Batch Builder will use {n} as the default resource name mask field ({n} resolves to a unique number). However, Batch Builder supports additional resource name patterns that are described below.

Here are examples of URN masks and the resulting resource name:

urn-3:dig:{n}   -->   urn-3:dig:75 

urn-3:FAL:{yyyy}{n}   ->   urn-3:FAL:1999-76 

urn-3:HCL-DIG:{yyyy}{mo}{dd}   -->   urn-3:HCL-DIG:20000103 (unique only for one file on any given day) 

urn-3:HCL-DIG:{yyyy}{mo}{dd}{n}   -->   urn-3:HCL-DIG:200001032 (always unique)

Using URNs

Each URN assigned by NRS has the form:

   urn-3:{authorityPath}:{resourceName}   
   urn-3:RAD.SCHL:1081404

where "urn-3" is the Harvard namespace identifier, {authorityPath} is the NRS authority path corresponding to the organizational unit responsible for the URN, and {resourceName} is the unique identifier for the digital file. 

To make a URN actionable (usable in a browser) for DRS 2 objects, you must append it to an NRS URL (http://nrs.harvard.edu/). The full working URL for the example URN above would be: 

http://nrs.harvard.edu/urn-3:HUL.Guest:152824 

New URNs are passed to the NRS name resolution server for activation. A URN requested during DRS2 batch deposit should become active within 15 minutes of successful batch deposit.