Gem Version Build Status Dependency Status Code Climate Coverage Status

Exlibris::Aleph offers a set of libraries for interacting with the ExLibris Aleph ILS.


Exlibris::Aleph::Patron provides access to the Aleph Patron REST API.

Example of Exlibris::Aleph::Patron in action

patron = 
    new(patron_id: "S0M31D", rest_url: "http://aleph.institution.edu")
patron.address # Returns a Hash of the of patron's address
patron.loans # Returns an Array of institution Hashes, each containing an Array of the patron's loans for that institution
patron.renew_loans # Renews all loans
patron.renew_loans("ADM5000000001") # Renews loan of item 00000001 in ADM50
patron.place_hold("ADM50", "SBLIB", "00000001", "00000001", {:pickup_location => "SBLIB"}) # Places hold on the specified item for pickup at SBLIB


Provides access to the Aleph Record REST API.

Example of Exlibris::Aleph::Record in action

record = 
    new(bib_library: "ADM50", record_id: "00000001", rest_url: "http://aleph.institution.edu")
record.bib # Returns a MARC::Record with bibliographic metadata
record.holdings # Returns and Array of MARC::Records respresenting the record's holdings
record.items # Returns and Array of Hashes representing the record's items


Exlibris::Aleph can be configured at startup in an initializer.

# Placed this in an initializer.
Exlibris::Aleph.configure { |c|
  c.base_url = "http://aleph.institution.edu"
  c.tab_path = "/mnt/aleph_tab"
  c.adms = ["ADM50", "ADM51"]

It can also read from a yaml file.

# Placed this in an initializer.
Exlibris::Aleph.configure { |c|
  config.load_yaml File.expand_path("#{File.dirname(__FILE__)}/../config/aleph.yml",  __FILE__)


Exlibris::Aleph::TabHelper provides a way to access the various tab settings for patrons, patron_permissions, items, item_permission (both by item status and by item processing status), collections and pickup locations. It also provides convenience methods for common tasks like getting the pickup location for a given combination of item status, item process status and borrower status or getting an item's web text. Support a

Example of Exlibris::Aleph::TabHelper in action

# Placed this in an initializer.
Exlibris::Aleph.configure { |c|
  c.tab_path = "/mnt/aleph_tab"
  c.adms = ["ADM50", "ADM51"]

# Rake task to refresh the config yml files
rake exlibris:aleph:refresh

# Get an instance of TabHelper
helper = Exlibris::Aleph::TabHelper.instance
helper.sub_library_text("SBLIB") # Returns display text for the give code
helper.sub_library_adm("SBLIB") # Returns ADM for the give code
helper.item_pickup_locations({:adm_library_code => "ADM50", :sub_library_code => "SBLIB", :bor_status => "51"}) # Returns the pickup locations for the given parameters
helper.collection_text({:adm_library_code => "ADM50", :sub_library_code => "SBLIB", :collection_code => "MAIN"}) # Returns the collection display text for the give parameters
helper.item_web_text({:adm_library_code => "ADM50", :item_process_status => "Item Process Status"}) # Returns the web text for the given parameters
helper.item_web_text({:adm_library_code => "ADM50", :sub_library_code => "SBLIB", :item_process_status_code => "DP"}) # Returns the web text for the given parameters

Configure irrelevant sub libraries for TabHelper

To configure the gem to ignore sub libraries pulled from Aleph but not relevant to working with permissions call the following setter with an array of sub library Aleph codes.

# Place this in an initializer to replace the current irrelevant sub libraries.
Exlibris::Aleph.configure { |c|
  c.irrelevant_sub_libraries = ["IRRLIB1", "IRRLIB2"]

Rake task

Exlibris::Aleph has a rake task that refreshes the mounted tables. Outside of Rails add require 'exlibris-aleph' to your Rakefile. Inside of Rails it should just work.


Exlibris::Aleph::BorAuth provides access to the BorAuth Aleph XService.

Example of Exlibris::Aleph::BorAuth in action

bor_auth = 
    new("http://aleph.institution.edu", "ADM50", "SBLIB", "N", "S0M31D", "[email protected]")
permissions = bor_auth.permissions # Return a Hash of permissions based on the Exlibris::Aleph::BorAuth instance