Skip to main content
ExLibris

Knowledge Assistant

BETA
Back
RapidILL

 

Ex Libris Knowledge Center
  1. Search site
    Go back to previous article
    1. Sign in
      • Sign in
      • Forgot password
  1. Home
  2. RapidILL
  3. Knowledge Articles
  4. Possible Alma OAI Errors

Possible Alma OAI Errors

  1. Last updated
  2. Save as PDF
  3. Share
    1. Share
    2. Tweet
    3. Share
No headers
  • Product: RapidILL

 

The following errors may be returned in the OAI response. The below examples relate to a sample base URL http://il-urm08.corp.exlibrisgroup.c...1_INST/request?.
Replace the base URL with your Alma instance’s URL when doing your testing.

  • "OAI Repository definition doesnt exist for this Institution"
    This means that the Alma institution for which the OAI response has been requested (EXLDEV1_INST on il-urm08.corp.exlibrisgroup.com in this example) does not have an OAI integration profile.
    Use the General Configuration>External Systems>Integration Profiles menu to create an OAI integration profile
     
  • "OAI Repository is not active for this Institution"
    You have not activated the OAI integration profile –
    clipboard_efb257a114300791fed0162181545ca1f.png
     
  • "Problem with url - institution code is missing"
    The URL does not have an institution code. For example,
    http://il-urm08.corp.exlibrisgroup.com/view/oai/request?
    Instead of
    http://il-urm08.corp.exlibrisgroup.com/view/oai/EXLDEV1_INST/request?
     
  • “Unauthorized access to the OAI services – please contact the system administrator for assistance”
    The OAI integration profile must be defined with allowed IPs –
    clipboard_e820129133edf74a75540fff32fa190d1.png
    You may restrict the IPs to those required to Rapid ILL to harvest your data, as listed in Step 1 of the ‘Alma Holdings Harvest for RapidILL’ document, all allow access to any harvester, as shown below –
    clipboard_ecc27a8459e76f203f1b40d9fadee9063.png
     
  • “The repository does not support sets”
    This may be a response to a ListSets request, such as http://il-urm08.corp.exlibrisgroup.com/view/oai/EXLDEV1_INST/request?verb=ListSets.
    This means that you have not defined a publishing profile with an OAI output –
    clipboard_e3b644d502ba8cbaf20564708ce6e77ea.png
     
  • See Step 3 of the ‘Alma Holdings Harvest for RapidILL’ document for details about creating the Rapid ILL required publishing profiles.
     
  • “The request is missing required arguments.”
    The URL is not complete. For example, sending a URL such as
    http://il-urm08.corp.exlibrisgroup.com: /view/oai/EXLDEV1_INST/request?verb=ListIdentifier

    will result in this error because the Set and MetadataPrefix parameters are missing –
    http://il-urm08.corp.exlibrisgroup.com: /view/oai/EXLDEV1_INST/request?verb=ListIdentifiers&set=OAI&metadataPrefix=marc21
     
  • “No Publishing profile exists for given set and metadataPrefix”
    The set names that can be included in the “set” parameter of the (e.g. http://il-urm08.corp.exlibrisgroup.com: /view/oai/EXLDEV1_INST/request?verb=ListIdentifiers&set=OAI&metadataPrefix=marc21) URL are only the sets that you have defined in your OAI publishing profiles.
    clipboard_e1ca7788a4543e36eb93e48ba0f981480.png
    In this example, the error will be triggered unless the URL is such as
    http://il-urm08.corp.exlibrisgroup.com:1801/view/oai/EXLDEV1_INST/request?verb=ListIdentifiers&set=ALL_SPEC&metadataPrefix=marc21
     
  • “The combination of the values of the from, until, set and metadataPrefix arguments results in an empty list.”
    Or
    “Identifier does not exist in repository.”

    The URL retrieved an empty set. This may be because a specific record was requested but it is not part of the set, or the search criteria that was defined in the URL found no results.

    If you were expecting the URL to retrieve results, it may be that you set requires republishing, i.e. that  the publishing profile has not run and is therefore not updated with a change that you may have expected to already be published.
     
  • “The value of identifier is illegal in this repository.”
    This will typically be the result of a GetRecord request that is using a non valid identifier.
    The record identifier is the record MMS  ID, prefixed by the schema, the  delimiter and the repository identifier.
    clipboard_e37e1cb98c1ab946e14d6c44bd13fc4c7.png
    For example -
    http://il-urm08.corp.exlibrisgroup.com/view/oai/EXLDEV1_INST/request?verb=GetRecord&identifier=oai:urm_publish:9912932700121&metadataPrefix=marc21
    is an invalid URL that will trigger this error in the above captured OAI integration profile.
    The correct URL should be
    http://il-urm08.corp.exlibrisgroup.com/view/oai/EXLDEV1_INST/request?verb=GetRecord&identifier=oai:alma.EXLDEV1_INST:9912932700121&metadataPrefix=marc21
     
  • The metadata format identified by the value metadataPrefix is not supported by the repository.
    This indicates an error in the metadataPrefix element of the URL. The allowed metadata prefix is defined on your publishing profile.
    clipboard_e2d79f16e66ee66f71638263acec67cc1.png
    The metadata prefix must also be allowed on the  output format that you have selected for the OAI integration profile -
    clipboard_e73570fbc406f7c71be423e4c0fabffc1.png
    clipboard_e47bd983bc90bec39c1d71157e3d694ad.png
     
  • “The value of identifier is illegal in this repository.”
    The identifier that  was supplied in the URL is not of a valid form. Typically, there is an error in the {schema+delimiter+repository identifier+delimiter+[MMS ID]} form, for example
    http://il-urm08.corp.exlibrisgroup.com:1801/view/oai/EXLDEV1_INST/request?verb=GetRecord&identifier=oai:alma.EXLDEV1_INST9912932700121&metadataPrefix=marc21
    instead of
    http://il-urm08.corp.exlibrisgroup.com:1801/view/oai/EXLDEV1_INST/request?verb=GetRecord&identifier=oai:alma.EXLDEV1_INST:9912932700121&metadataPrefix=marc21

     

  • Article last edited: 28-Sep-2020
View article in the Exlibris Knowledge Center
  1. Back to top
    • Personal information in RapidILL
    • Prevent multiple requests from a same borrowing library within a short period of time
  • Was this article helpful?

Recommended articles

  1. Article type
    How-To
    Content Type
    Knowledge Article
    Language
    English
    Product
    RapidILL
  2. Tags
    This page has no tags.
  1. © Copyright 2025 Ex Libris Knowledge Center
  2. Powered by CXone Expert ®
  • Term of Use
  • Privacy Policy
  • Contact Us
2025 Ex Libris. All rights reserved