Download PDF

On this page…
About OAI Targets
Manage OAI Field Mapping

If your institution utilizes a web scale discovery or federated search system, we encourage you to expose your Shared Shelf content using an OAI publishing target.

About OAI Targets

The OAI publishing target exposes your Shared Shelf content on our OAI server, which the discovery vendor may query for harvesting. As the project administrator, you select the records that are ready to expose by publishing. Once published, any future updates to the record in Shared Shelf (data or image) are automatically pushed to the OAI server with a ‘last update date’, allowing the vendor to come to the server on a regular basis to pick up any new or changed records. The data output of these records are in XML, in which you may choose to map the fields to Dublin Core, or leave the fields unmapped and thereby use the SSIO (Shared Shelf Input/Output) schema. Mapping to a standard like Dublin Core is typically recommended for working with discovery vendors because it will simplify the harvesting and transformation process.

Establishing an OAI publishing target requires IP address authentication and support assistance. For discovery vendors harvesting content from multiple institutions, the harvester will see all projects from all institutions in the same list when running the query request. Each Shared Shelf project returned in the query request will be indicated by Project ID and Project Name. Your Implementation Manager will provide the list of project IDs and project names that belong to each institution authenticated by that vendor’s IP address, so the vendor may write the harvester accordingly.

To add an OAI publishing target, contact support@sharedshelf.org with the following information:

  • Project name(s)
  • Project ID(s)*
  • Discovery vendor
  • Discovery vendor’s IP address or IP range for the machine(s) accessing the server.

*Project ID can be found in the URL when viewing the project on the cataloging site.

projectid

Manage OAI Field Mapping

Unlike other publishing targets, fields from your Shared Shelf project do not need to be mapped in order to display in an OAI harvest. The harvester pulls the data in XML format to be displayed in the discovery service as decided between you and the vendor. By mapping your fields, you establish the preferred XML data output. If you choose to map your fields, the OAI publishing target uses the Dublin Core schema. When mapping fields to the Dublin Core schema, use of prefixes, displayable, searchable, and required fields is not supported. For more information, check out Map Fields to Targets.