Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Page Properties


Document status

Status
titleDRAFT

Area coveredSystems, Resource Sharing
Lead Author
Co-authors

Ian Chan (Unlicensed), Christian Ward Jeremy Shellhase (Unlicensed), Dawnell Ricciardi, Danny Soares


...

FieldDataNotes
User Identifier type

Primary Identifier or

Other Defined Identifier in Alma

Recommending the Primary Identifier since this will be used for other services and third party

integrations within Alma. However this can be another designated identifer defined identifier in the user record.

Request pushing methodOpen URL
URL templateCampus specific Open URL
Default library ownerResource Sharing Library or Temp Location
Request Item - Bibliographic record ID typeOCLC Number
Request Item - Default locationLending Resource Sharing Request
Check-Out Item - Default locationBorrowing Resource Sharing Request
Check-Out Item - Default item policyCampus defined policy
Accept Item - Default location

Resource Sharing Library

If you have elected to use the Resource Sharing Library then you must configure both the Open Hours and Terms of Use tables for that library.

...

In order to integrate Illiad with Alma, the add-on must be installed in every Illiad client that will be processing borrowing and lending requests. The client configuration is provided by VCU on GitHub and will need to be modified to look for the lending partner setup in Alma. Our settings are as follows: 


Installing the Add-On

(This These install instructions assume you already have an installation of the ILLiad Client installed on a Microsoft Windows operating system. No info on Mac installationsworkstation.)

Create a new folder in your local machine's ILLiad\Addons directory (usually C:\Program Files (x86)\ILLiad\Addons\) and name it Alma-NCIP

Copy the three files - Config.xmlIDS_NCIP_Client.lua, and sublibraries.txt to the newly created directory.

You should manually modify the Config.xml file with the same information used in the plug-in interface. The screenshot below identifies these fields that need to be changed:

Field NameDataNote
NCIP_Responder_URLhttps://[your-Alma-Instance].alma.exlibrisgroup.com/view/NCIPServletApproximately located in Line 12 of the config.xml file

acceptItem_from_uniqueAgency_value

Institutional Alma CodeApproximately located in Line 15 of the config.xml file

ApplicationProfileType

e.g.

...

, ILLIADApproximately located in Line 18 of the config.xml file
  1. Line 12 - NCIP_Responder_URL, enter 
  2. acceptItem_from_uniqueAgency_value
  3. ApplicationProfileType


Image Added


Alternate Instructions for alternate

Now, modify the following settings within the Illiad systems plug-in interface.

Field NameDataNote
NCIP_Responder_URLhttps://[your-Alma-Instance].alma.exlibrisgroup.com/view/NCIPServlet

Where Your-Alma-Instance can be determined by clicking on the HELP option in Alma's upper right corner. (e.g.na01,na03)

acceptItem_from_uniqueAgency_valueInstitutional Alma CodeSupplied by ExLibris during migration. For a list of Institution Codes please click here.
ApplicationProfileTypee.g., ILLIADThis is you your institutions Resource Sharing Partner code from Alma
BorrowingAcceptItemFailQueueUse defaultThis designates the name of the queue a Borrowing Transaction will be moved to if the BorrowingAcceptItem function fails
BorrowingCheckInItemFailQueueUse defaultThis designates the name of the queue a Borrowing Transaction will be moved to if the BorrowingCheckInItem function fails
LendingCheckOutItemFailQueueUse defaultThis designates the name of the queue a Lending Transaction will be moved to if the CheckOutItem function fails
LendingCheckInItemFailQueueUse defaultThis designates the name of the queue a Lending Transaction will be moved to if the CheckInItem function fails
EnablePatronBorrowingReturns
When this setting is enabled, patron returns will go through ILLiad and a message is sent to Alma. When this setting is disabled, patron returns will go through ILLiad and will need to also be returned through Alma
Use_Prefixes
Determines whether or not you want to change prefixes of a transaction based on specific criteria
Prefix_for_LibraryUseOnlyYesThis setting allows you to change the prefix of a transaction that is marked LibraryUseOnly
Prefix_for_RenewablesAllowedYes

This setting allows you to change the prefix of a transaction that is marked RenewalsAllowed

Prefix_for_LibraryUseOnly_and_RenewablesAllowedYesThis setting allows you to change the prefix of a transaction that is marked both LibraryUseOnly and RenewalsAllowed

...

Then make sure the plug-in is activated in the ILLiad client. This is not automatic.

You may also need to manually modify the Config.xml file with the same information from the plug-in interface. The screenshot below identifies these fields that need to be changed:

  1. NCIP_Responder_URL
  2. acceptItem_from_uniqueAgency_value
  3. ApplicationProfileType

Image Removed





 After all edits have been made to the file, restart Illiad and register the Add-on (see the documentation on activating an Add-On).

...