Skip to main content
Ex Libris Knowledge Center

Rapid OAI Holdings - Step 3: Creating Publishing Profiles

This page contains the last of three steps in the documentation for setting up the RapidILL OAI Holdings process. An overview of the process in its entirety can be found here.

If a significant portion of your physical titles do not have items, please see: Holdings Without Items documentation.

Using Out of the Box Publishing Profiles

A publishing profile needs to be created for each set created in Step 2. We strongly recommend using the out of the box publishing profiles, as they are pre-configured with the proper Set Spec and Item/Inventory Enrichment.

These template publishing profiles are available in the Community Zone. To localize the profiles and activate them in your institution, follow these steps:

  1. Navigate to Resources > Publishing > Publishing Profiles.

  2. Go to the Community tab and search for  “EXL” in the description. (The search is case-sensitive. Be sure to use capital letters - EXL, not exl.) You’ll find the 12 publishing profiles published by Alma University.

  3. For each of the profiles:

    1. Create a local copy of each relevant profile using the Copy row action.

    2. In the Publishing Profile Details page:

      1. In Publishing Parameters section, set Status to active.

      2. Set the scheduling parameter to execute the publishing job to run weekly per your preferred schedule.

      3. In the Content section, select the appropriate set name you defined when creating the sets.

    3. Save the profile.

Using Other Publishing Profiles

We strongly recommend using the out of the box publishing profiles, as they are pre-configured with the proper Set Spec and Item/Inventory Enrichment. However, if you don’t wish to use the out of the box publishing profile, please make sure these guidelines are followed in addition to those mentioned in the previous section:

  1. Content Type = Bibliographic.
  2. The Set Spec field should be filled in the following template:
    Rapid_[branch if relevant]_[Holding Type]_[Holding Format]_[Lendable Status]
    Example: Rapid_ILLUV_Books_Print_LendableInternational
    The appropriate lendable status (LendableInternational / LendableCountry / LocalOnly) must be included in the Set Spec exactly. Rapid looks for this string to determine the lendable status of a set.
  3. Publish on = Bibliographic level.
  4. Publishing Protocol = OAI.
  5. The Data Enrichment tab should be filled as such:
    Holdings Format Enrichment Screenshot
    Print Under the Physical Items Enrichment section, check “Add Items Information”.


    Repeatable field = 954

    Description subfield = m

    Current library subfield = q

    Current location subfield = r

    Call number subfield = t
    Electronic Under the Electronic Inventory Enrichment section, check “Add Electronic Portfolio Information”.


    Repeatable field = 949

    Access URL subfield = u

    Link Resolver Base URL – see below.

    Coverage Statement subfield = e

    Collection Name subfield = a
    You may add other enrichments using other letters, but they are not needed for RapidILL holdings.

Additional Configuration Needed for Electronic Publishing Profiles

For electronic inventory profiles, in the Data Enrichment tab, find the Link Resolver Base URL field. This field will need to be filled differently for Primo and PrimoVE customers:

 Do not change other values in the data enrichment tab. They are important for proper mapping in RapidILL.

Publishing for the First Time

After a publishing profile is created, the job is scheduled to run incrementally once a week (only the changes are published each time). 

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 Alma Configuration > Resources > Publishing > Publishing Profiles.
  2. Under the institution tab, search for the “RapidILL” profiles. Make sure the Publishing Profile Type is set to All.
  3. Select Republish from the row action.
  4. Select the Rebuild Entire Index option and click Run Now.
    9_Republish profile after scheduling.png
    Republish profile after scheduling

Testing Your Sets

This step isn't mandatory, but many customers find it helpful. Performing this test requires that your OAI integration profile (see Step 1: Creating the OAI Integration Profile) allows access to your IP.

Test your sets by building a ListSets URL. This helps you to make sure your sets were created successfully.

You should see a list of all sets Alma is publishing through OAI.

To test a specific set, you can use another link:

You should be able to see the first 200 records or so. It’s important to check that they have the 954 (print) or 949 (electronic) fields.

Additional OAI Setup Options

While the above instructions cover most institution's needs, there have been a few repeated cases that may be useful during setup. 

Starting the RapidILL Holdings Process

When you have finished scheduling publishing profiles, please let the RapidILL team know by creating a ticket. We will then configure RapidILL accordingly and process the data. Follow up on your holdings by checking the Holding Status Page.

Entries are only displayed after data has been updated into RapidILL.

  • Was this article helpful?