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

For instructions on how 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, it is required to set all of the following I.P. addresses:

  • 10.29.93.88
  • 10.29.93.89
  • 10.100.3.147
  • 10.100.3.148
  • 10.29.93.187

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. To make this process simple, we created out of the box templates for each publishing profile. These template publishing profiles are available in the Community Zone. To localize the profiles and activate them in your institution, follow the following steps:

  1. Navigate to Resource Configuration Menu > Publishing Profiles.
  2. Click Community and search for profiles matching the description EXL profile for Rapid ILL.
  3. Do the following for each of the profiles:
    1. Create a local copy of each profile using the Copy row action.
    2. In the Publishing Profile Details details page, do the following:
      • In the Profile Details tab, assign the relevant set you defined in step 2 to the publishing profile.
      • For electronic inventory profiles, in addition to the sets, in the Data Enrichment tab, update the Link Resolver Base URL field to your own link resolver base URL.
    3. Set the scheduling parameter to run the publishing job according to your preferred schedule, and confirm that the profile is active.

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?
//Feedback