Skip to main content
ExLibris
Ex Libris Knowledge Center

Alma Holdings Harvest for RapidILL

Rapid Holdings for Alma

Uploading your holdings from Alma into Rapid is an automated process using OAI (Open Archives Initiative Protocol for Metadata Harvesting – OAI-PMH). Once it is set up initially, your Rapid holdings are updated automatically on a monthly basis with the latest Alma data. The process includes three main steps:

  1. Getting the OAI Harvesting URL
  2. Configuring OAI integration
  3. Creating a “publishing profile”

OAI Harvesting URL

The OAI Harvesting URL is the link Rapid accesses to harvest the holdings sets you create. You will find this URL when setting the OAI integration profile under “Repository Base URL”. For example: https://na03.alma.exlibrisgroup.com/view/oai/EXLDEV1_INST/request?verb=ListSets

Email us at rapidill-holdings@exlibrisgroup.com to send us the URL. Once this is set up, there is no need send it with future uploads unless something changes.

OAI Integration

Setting up OAI integration requires someone with the General Administrator role in Alma and is a straightforward process. This step allows Rapid to access your holdings report.

What is OAI?

The Open Archives Initiative Protocol for Metadata Harvesting (OAI-PMH) is a low-barrier mechanism for developing and promoting interoperability standards that aim to facilitate the efficient dissemination of content across repositories. Data Providers are repositories that expose structured metadata through OAI-PMH. Service Providers then make OAI-PMH service requests to harvest that metadata. OAI-PMH uses six request types (“verbs”) that are invoked within HTTP. Using this functionality, Alma can publish metadata (as a Data Provider) which can then be harvested by external tools/repositories (Data Harvesters) like RAPID.

Configuration steps in Alma

Step 1: Create the OAI integration profile

To create a new integration profile, click here.

Note: As part of the OAI configuration you can choose whether to open this up to the entire I.P. universe or restrict it to specific lending partners.

If you decide to go with the latter option, use one of the following I.P. addresses:

  • 129.82.29.104
  • 129.82.29.36
  • 129.82.29.59
  • 129.82.29.58
  • 129.82.29.*

Step 2: Create sets

In this step you are defining the set of records to be published to Rapid.

It is recommended that you publish all your inventory, not just the lendable inventory. Rapid uses this to match your patron requests and make sure they are not owned by your institution.

When creating sets in Alma, use the following guidelines:

  • Create a lendable and a non-lendable set for each holdings type (journals or books) and each holdings format (print or electronic).
  • If separate sets based on lendability are not created, Rapid uses the following defaults: 
    • Print journals and print books holdings are set to LendableInternational. 
    • Electronic journals and electronic books are set to LocalOnly. 
  • The set names (SetSpec) need to match the following format: [Type] [Format] [LendableStatus]. For example: Journals Print LendableInternational.

The common values for LendableStatus are: 

  • LendableInternational: You are able to fill lending requests from any other Rapid libraries around the world. This is typically the Lendable value used for print materials that you want to make available in Rapid. 
  • LendableCountry: You are able to fill lending requests only from Rapid libraries in your country. This is typically the Lendable value used for electronic materials. 
  • LocalOnly: You are not able to fill lending requests from other Rapid libraries, however these items are still available to fill your local patrons’ borrowing requests.
Set Type Set Name Condition Comment
Print books – lendable Books Print LendableInternational Physical Titles where Title (Has inventory equals "Yes" AND Material Type equals "Book" AND Tag Suppressed (Title) equals "No" AND Current location equals ((Lendable locations)))  
Print books – not lendable Books Print LocalOnly Physical Titles where Title (Has inventory equals "Yes" AND Material Type equals "Book" AND Tag Suppressed (Title) equals "No" AND Current location equals ((non Lendable locations)))  
ebooks – lendable Books electronic LendableCountry \ LendableInternational Electronic Titles where Title (Has inventory equals "Yes" and Material Type equals "Book" and Tag Suppressed (Title) equals "No") AND collection name equals ((Lendable collections))) If you do not lend eBooks, you can skip this set
ebooks – not lendable Books electronic LocalOnly Electronic Titles where Title (Has inventory equals "Yes" and Material Type equals "Book" and Tag Suppressed (Title) equals "No") AND collection name equals ((Non lendable collections)))  
Print journals – lendable Journals Print LendableInternational Physical Titles where Title (Has inventory equals "Yes" and Material Type equals "Journal" and Tag Suppressed (Title) equals "No") AND Current location equals ((Lendable locations)))  
Print journals – not lendable Journals Print LocalOnly Physical Titles where Title (Has inventory equals "Yes" and Material Type equals "Journal" and Tag Suppressed (Title) equals "No") AND Current location equals ((Non lendable locations)))  
ejournals – lendable Journals electronic Lendable International \ LendableCountry Electronic Titles where Title (Material Type equals "Journal") and Electronic Portfolio (Availability (Electronic Portfolio) equals "Available") AND collection name equals ((Lendable collections)))  
ejournals – not lendable Journals electronic LocalOnly Electronic Titles where Title (Material Type equals "Journal") and Electronic Portfolio (Availability (Electronic Portfolio) equals "Available") AND collection name equals ((Non lendable collections)))  

Step 3: Create publishing profiles for sets

A publishing profile needs to be created for each set from step 2. For instructions on how to create a general publishing profile, click here.

This section contains instructions for the Rapid OAI profile.

Basic information

Field Value
Content Type bibliographic
Scheduling Once a month (e.g. on the 01 of every month)
Publish on Bibliographic level
Output Format MARC 21 Bibliographic
Publishing protocol OAI
Set Spec A unique identifier for the set within the OAI repository’
Set Name The name of the set (e.g. Rapid-ILL-eJournals)

Data enrichment

This step is required to enrich the bib record with the data needed by Rapid. This step adds to the bib record the fields required from your holding record such as location, call number, and dates held.

For Ebooks and eJournals Rapid needs the below subfields
  • Link Resolver Base URL: Your link resolver base URL (e.g. https://na02.primo.exlibrisgroup.com...n=EXLDEV1_INST) 
  • Collection Name (a) - Location 
  • Access URL (u) – used in place of a call number 
  • Coverage Statement (e) –years, volumes, embargo (for journals only)

clipboard_e6b018f3e307ca00bfac17b56639c975e.png

 

 

 

 

 

 

 

 
For Print books and Journals

Holdings settings:

This step adds to the bib record the fields needed from your holding record such as library, Location, call number.

Select the Add Items Information option.

Repeatable field : 954 

  • Current Library (q) and Current Location (r) – location 
  • Call number (t) – call number 
  • Description (m) – years/volumes (for journals only)

clipboard_eb4641a5f03c2becd7619071530351b15.png

Step 4: Schedule publishing profiles

After a publishing profile is created, the job is scheduled to run incrementally once a month.

The first time the job is run, it must be run in full mode. To run in full mode, proceed as follows:

  1. Go to Resource configuration menu -> publishing profiles.
  2. Select the job (search for the “rapid” profiles) and from the row action choose “Republish”.
  3. Select the ‘Rebuild Entire Index’ option Note: you may want to test the ListSets URL to make sure all is created successfully.

Test sample: https://na02.alma.exlibrisgroup.com/...?verb=ListSets 

Email us at rapidill-holdings@exlibrisgroup.com to let us know and we will begin reviewing and processing the data.

  • Was this article helpful?