Versions Compared

Key

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


NameAlma Barcode Lookup Addon
Version1.1.0.1
AuthorAtlas Systems, Inc.
DescriptionAn addon that takes an item barcode, performs an item search against the Alma API, and imports its results.

...

Download

Panel

AlmaBarcodeLookup-1.1.0.zip

Configuration

Addon settings are configured in the Manage Addons form.

...

Below are the default data mappings from the API response to Ares, Aeon, and ILLiad and the default location of the barcodes for each product. These data mappings can be changed in the DataMapping.lua file.

Warning
titleCaution

Be sure to backup the DataMappings.lua file before making modifications Incorrectly configured mappings may cause the addon to stop functioning correctly. 

Default Barcode Fields

Product DataMappingLocation
DataMapping.BarcodeFieldMapping["Ares"] Item.ItemBarcode
DataMapping.BarcodeFieldMapping["ILLiad"]Transaction.ItemNumber
DataMapping.BarcodeFieldMapping["Aeon"]Transaction.ItemNumber

Field Mappings

Mapping NameUsed to identify the mapping. The Fields to Import setting lists the Mapping Names for the addon to import.
Import Field

The Ares, Aeon, or ILLiad field the API response item maps to.

The first value is the table the field maps to and the second value is the desired column in the specified table.

Object TypeObject type is the name of the response type from the API response.
Object MappingThe XML node name of the data you wish to import.

...

Mapping NameImport FieldObject TypeObject Mapping
CallNumberItem.Callnumberitemcall_number
ISXNItem.ISXNitemissn
ISXNItem.ISXNitemisbn
TitleItem.Titleitemtitle
AuthorItem.Authoritemautho
EditionItem.Editionitemcomplete_edition
PlaceItem.PubPlaceitemplace_of_publication
PagesItem.PagesCountitempages
PublisherItem.Publisheritempublisher_const

...

Mapping NameImport FieldObject TypeObject Mapping
CallNumberTransaction.CallNumberitemcall_number
ISXNTransaction.ItemISxNitemissn
ISXNTransaction.ItemISxNitemisbn
TitleTransaction.ItemTitleitemtitle
AuthorTransaction.ItemAuthoritemautho
EditionTransaction.ItemEditionitemcomplete_edition
PlaceTransaction.ItemPlaceitemplace_of_publication
PagesTransaction.ItemPlaceitempages
PublisherTransaction.ItemPublisheritempublisher_const

...

config.xmlThe addon configuration file.
DataMapping.luaThe data mapping file contains mappings for the items that do not typically change from site to site.
AlmaLookup.luaHandles the Alma-specific lookup logic
Main.luaThe Main.lua is the main file for the addon. It handles the initialization of the addon.
AlmaApi.luaThe AlmaApi file is used to make API calls against the Alma API
Utility.luaThe Utility file is used for common lua functions
LookupUtility.luaHandles generic lookup logic that can be used between services
WebClient.luaUsed for making web client requests.

...