Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Updated addon with new version.


Name

Version

Author

Description

ALMA NCIP Integration1.0.67Atlas Systems

The Alma NCIP Integration system addon allows for integration between ILLiad and Alma using NCIP. This addon uses NCIP v2 calls to the Alma NCIP responder.

...

Panel
borderColorblack
bgColorwhite
borderStyledashed

Download zip file: AlmaNcipIntegration_v1.0.67.zip

Release Notes

Info
Release notes are available for Alma NCIP Integration System Addon v1.0.5 and later.
  • v1.0.6:
    • NCIP problem responses are now properly parsed by the addon, improving the specificity of logged errors for troubleshooting purposes.
  •  v1.0.5:
    • Fixed an issue introduced in version 1.0.4 that prevented history entries from being added when the addon performed an action on a request.

Configuration

Addon settings are configured in the Manage Addons form.

...

Setting Name

Default Value

Type

Description

LendingEnabled

true

Boolean

Determines whether lending requests are enabled for NCIP Integration.

BorrowingEnabled

true

Boolean

Determines whether borrowing requests are enabled for NCIP Integration.

BorrowingMultiBarcodeEnabled

true

Boolean

Determines whether borrowing requests Barcode fields support Multiple Barcodes.

ErrorQueueBorrowing

NCIP Errors

String

Defines the name of the queue to which borrowing transactions will be routed if there is an error in processing.

ErrorQueueLendingNCIP ErrorsStringDefines the name of the queue to which lending transactions will be routed if there is an error in processing.
BorrowingCheckedInFromLibraryRoutingRequest in ProcessingStringComma separated list of statuses a request is routed to after successfully checking an item in from the lending library and checking the items out to the customer via NCIP.
NCIPResponderURLhttps://na03.alma.exlibrisgroup.com/view/NCIPServletStringURL for the NCIP Server Responder.
ApplicationProfileType

ILL

StringThe mapping for the NCIP ApplicationProfileType. This can be a tag or static value. If you would like a different library type for LibraryUseOnly, use "{Custom:GetApplicationProfileType}".
BorrowingUserIdentifier{TableField:User.Username}StringThe mapping for the NCIP user identifier sent for borrowing requests. This can be a tag or static value.
LendingUserIdentifier{TableField:User.Username}StringThe mapping for the NCIP user identifier sent for lending requests. This can be a tag or static value.
FromAgencyId
StringGeneric From Agency ID string to use in NCIP calls.
ToAgencyId
StringGeneric TO Agency ID string to use in NCIP calls.
RequestIdentifierPrefix{Custom:RequestIdentifier}StringPrefix for RequestIdentifier.
ItemBarcodeField
StringDefines the transaction field in which the item barcode will be stored.
HistoryEntryAcceptItemSuccessNCIP: Temporary Item created ({barcode})StringThe history entry made when the AcceptItem NCIP call is completed successfully. Leave blank for no history entry.
HistoryEntryCheckOutItemSuccessNCIP: Item checked out ({barcode})StringThe history entry made when the CheckOutItem NCIP call is completed successfully. Leave blank for no history entry.
HistoryEntryCheckInItemSuccessNCIP: Item checked in ({barcode})StringThe history entry made when the CheckInItem NCIP call is completed successfully. Leave blank for no history entry.
MultipleBarcodeDelimiter" "StringThe delimiter that is used to separate multiple barcodes.
PickupLocationField{TableField:User.NVTGC}StringThe mapping for the pickup location field.
PickupLocationMappings
StringA comma-delimited list of mappings (i.e., a=b,c=d) which will be used when mapping to PickupLocations from a particular field.

...

Code Block
ERROR AtlasSystems.Scripting.LuaApi.ScriptEnvironmentBase - Script compilation failed for addon Alma NCIP Integration.
ERROR AtlasSystems.Scripting.LuaApi.ScriptEnvironmentBase - Compilation Error: A .NET exception occured in user-code
ERROR AtlasSystems.Scripting.LuaApi.ScriptEnvironmentBase - An attempt was made to load an assembly from a network location which would have caused the assembly to be sandboxed in previous versions of the .NET Framework. This release of the .NET Framework does not enable CAS policy by default, so this load may be dangerous. If this load is not intended to sandbox the assembly, please enable the loadFromRemoteSources switch. See http://go.microsoft.com/fwlink/?LinkId=155569 for more information.
ERROR AtlasSystems.Scripting.LuaApi.SystemScriptEnvironment - An addon script error has occurred in a system script.  The following error message was returned: An addon script (Alma NCIP Integration) could not be loaded due to an error in the script file(s).
Details:A .NET exception occured in user-code

To resolve this issue, please unblock the addon files installed on the local machine following the instructions below:

  1. Open the Windows File Explorer and navigate to the folder where the addon files are installed on the local machine (default location: C:\Program Files (x86)\ILLiad\Addons\AlmaNcipIntegration)
  2. Right-click on the first file and select Properties from the menu
  3. Check the Unblock checkbox at the bottom, if present:
  4. Click OK
  5. Repeat for all files in the addon's folder
  6. Once all files are unblocked, restart the ILLiad Client and attempt to run the addon

...