Introduction


LUNA 7 is compliant with OAI-PMH (Open Archives Initiative Protocol for Metadata Harvesting). To make use of this feature you will need to prepare your collections. 

 

Testing your collection


In the following tests, replace localhost with your LUNA server name and port number.
This first request asks the server to "Identify" itself and returns the repository name and admin email. 
Request: http://localhost:8181/luna/servlet/oai?verb=Identify 
Result:
 

Next, you are asking the system to list all the records "ListIdentifiers" and their unique identifiers. insight63icm~4~4~21~100073 is an example of an identifier. It's made up of the InstitutionID~CollectionID~uniqueCollectionID~ObjectID~MediaID 
Request: http://localhost:8181/luna/servlet/oai?verb=ListIdentifiers&metadataPrefix=oai_dc&set=insight63icm~4~4 
Result:
 
The next request will list the first 50 records using "ListRecords". This will return the content in the form of a URL. 
Request: http://localhost:8181/luna/servlet/oai?verb=ListRecords&metadataPrefix=oai_dc&set=insight63icm~4~4 
Result:
 
If these tests are returning results then your collection is ready to provide access to an OAI harvester. 
You can also test your repository at the OAI Repository Explorer 
To submit your content to a harvester just submit your Base URL. 
http://localhost:8181/luna/servlet/oai

 


Optional Addition of Image URL can be added to the OAI-PMH result


If you would like to allow the harvesting of Image URL's, just follow these instructions. 
In the Application Configuration section of the LUNA Administrator, you can add the Attribute "oaiAdditionalIdentifiers". 

(for showing just URL to detail view)
detailview 
(for showing URL to detail view, and size 2 URL)
detailview,size2 
You can add the following

Insight Size

Dimensions

size0

– up to 96 pixels on the long side (Small Thumbnail in LUNA)

size1

– up to 192 pixels on the long side (Medium Thumbnail in LUNA)

size2

– up to 384 pixels on the long side (Large Thumbnail in LUNA)

size3

– up to 768 pixels on the long side

size4

– up to 1536 pixels on the long side


Ordering

Instructions for ordering.

In the case where you have multiple fields mapped to the same field in Dublin Core, you may also specify the order these fields are displayed in the response:

Identify the collection you are affecting

Attribute: oaiOrderedStandardName0

Value: LUNA~9~1

 

Attribute: oaiOrderedStandardFields0

Value: full_title,author,short_title

Attribute: oaiOrderedDCField0

Value: title

In the example above, you are specifying the order of fields for the collection with ID: LUNA~9~1. LUNA is configured so that the fields mapped to "title" in Dublin Core display the values as follows: full_title, author, short title. If there are any other fields besides these three mapped to "title" in this collection, they will come last.

The values for oaiOrderedStandardFields0 and oaiOrderedDCField0 are case-insensitive, oaiOrderedStandardFields0 should be a comma-delimited list of internal field names. Any spaces before or after the comma(s) will be trimmed.