P.v. supa Libcabinet User manual

Libcabinet manual

Libcabinet manual 2

Table of Contents

........................................................................................................................7

About

........................................................................................................................8

Important information

.................................................................................................................................................. 8Do not overfill

.................................................................................................................................................. 8Tag placement

.................................................................................................................................................. 8Material considerations

.................................................................................................................................................. 8SIP connection

.................................................................................................................................................. 8Theft prevention

........................................................................................................................9

Getting started

.................................................................................................................................................. 9Set up connection to SIP server

.................................................................................................................................................. 9Start the software

.................................................................................................................................................. 9Enter maintenance mode

.................................................................................................................................................. 10Open the door

.................................................................................................................................................. 10Fill the cabinet

.................................................................................................................................................. 10Disable security

.................................................................................................................................................. 10Close the door

.................................................................................................................................................. 11Return to normal mode

........................................................................................................................12

Configuring settings

.................................................................................................................................................. 12Maintenance mode

.................................................................................................................................................. 12Changing the on-screen and receipt texts and languages

........................................................................................................................13

Shutting down

........................................................................................................................14

Modes of operation

.................................................................................................................................................. 14Patron mode

.................................................................................................................................................. 15Maintenance mode

....................................................................................................................................................................................... 15Entering maintenance mode

....................................................................................................................................................................................... 15Disabling the alarms

....................................................................................................................................................................................... 15Inventory

....................................................................................................................................................................................... 16Statistics

....................................................................................................................................................................................... 16Out of use mode

........................................................................................................................18

Notifications

.................................................................................................................................................. 18Messages sent to Message board / Dashboard

.................................................................................................................................................. 18Messages that can also be sent as email

Libcabinet manual 3

........................................................................................................................20

Settings reference

.................................................................................................................................................. 20Global settings

....................................................................................................................................................................................... 20Admin ...................................................................................................................................................................... 20Admin cards

...................................................................................................................................................................... 20Shutdown cards

....................................................................................................................................................................................... 20Authentication

...................................................................................................................................................................... 20Auto ok on max digits

...................................................................................................................................................................... 20Barcode end key

...................................................................................................................................................................... 21Barcode filter

...................................................................................................................................................................... 21Barcode removed text

...................................................................................................................................................................... 21Max fail count before exit

...................................................................................................................................................................... 21Max patron code length

...................................................................................................................................................................... 21Max PINcode length

...................................................................................................................................................................... 21Min patron code length

...................................................................................................................................................................... 21Min PIN code length

...................................................................................................................................................................... 21Patron card reader type

...................................................................................................................................................................... 22Patron comport reader parameters

...................................................................................................................................................................... 22Patron dialog type

...................................................................................................................................................................... 22PINcode authentication type

...................................................................................................................................................................... 22PINcode type

...................................................................................................................................................................... 22Show buttons in PIN code dialog

...................................................................................................................................................................... 22Show library card characters

....................................................................................................................................................................................... 22Data models ...................................................................................................................................................................... 23AFI activate value

...................................................................................................................................................................... 23AFI deactivate value

...................................................................................................................................................................... 23Danish: Check CRC

...................................................................................................................................................................... 23Dutch: Use barcode as primary item id source

...................................................................................................................................................................... 23Empty block byte

...................................................................................................................................................................... 23Empty block count

...................................................................................................................................................................... 23Empty tag mask

...................................................................................................................................................................... 23ISO28560-2: Maximum item id length

...................................................................................................................................................................... 23ISO28560-2: Minimum item id length

...................................................................................................................................................................... 23Models to use

....................................................................................................................................................................................... 24Device: Shelf ...................................................................................................................................................................... 24Block count

....................................................................................................................................................................................... 24Email connection info

...................................................................................................................................................................... 24Port

...................................................................................................................................................................... 24Server

...................................................................................................................................................................... 24SMTP password

...................................................................................................................................................................... 24SMTP user

...................................................................................................................................................................... 24Use authentication

...................................................................................................................................................................... 24Use SSL

....................................................................................................................................................................................... 25Functions ...................................................................................................................................................................... 25Remind patron to take patron card

...................................................................................................................................................................... 25Remind patron to take the receipt

...................................................................................................................................................................... 25Show farewell at end ofsession

....................................................................................................................................................................................... 25Languages ...................................................................................................................................................................... 25Default culture

...................................................................................................................................................................... 25Language list

....................................................................................................................................................................................... 25Offline ...................................................................................................................................................................... 25Allow checkin/checkout when offline

...................................................................................................................................................................... 25Due date for checkout

Libcabinet manual 4

....................................................................................................................................................................................... 26QR Code ...................................................................................................................................................................... 26Mobile login service address

...................................................................................................................................................................... 26Mobile login service port

...................................................................................................................................................................... 26Mobile login web site address

....................................................................................................................................................................................... 26Receipt ...................................................................................................................................................................... 26Can use readingroom due date

...................................................................................................................................................................... 26Check in print mode

...................................................................................................................................................................... 26Check out print mode

...................................................................................................................................................................... 26Due date style

...................................................................................................................................................................... 27Footer print font

...................................................................................................................................................................... 27Footer print font size

...................................................................................................................................................................... 27Header print font

...................................................................................................................................................................... 27Header print font size

...................................................................................................................................................................... 27Hold slip print data

...................................................................................................................................................................... 27Print data

...................................................................................................................................................................... 28Text print font

...................................................................................................................................................................... 28Text print font size

...................................................................................................................................................................... 28Use email receipt

...................................................................................................................................................................... 28Use single receipt for checkin+checkout

....................................................................................................................................................................................... 28Scripting ...................................................................................................................................................................... 28Send reader id to patron script

...................................................................................................................................................................... 29Use script for item identifiers

...................................................................................................................................................................... 29Use script for patron code

....................................................................................................................................................................................... 29SIP ...................................................................................................................................................................... 29Code page for receiving

...................................................................................................................................................................... 29Code page for sending

...................................................................................................................................................................... 29Due date culture

...................................................................................................................................................................... 29Ignore supported messages

...................................................................................................................................................................... 29Library service supports item information (17)

...................................................................................................................................................................... 30Library type

...................................................................................................................................................................... 30Max print line width

...................................................................................................................................................................... 30Protocol version

...................................................................................................................................................................... 30Starting sequence number

...................................................................................................................................................................... 30Use BL and CQfields for patron authentication

...................................................................................................................................................................... 30Use error handling

...................................................................................................................................................................... 30Use Fee Acknowledge in Checkout

...................................................................................................................................................................... 30Use NoBlock in Checkout

...................................................................................................................................................................... 30Use sip message 63

...................................................................................................................................................................... 30Use time in check-in return date

....................................................................................................................................................................................... 31Statistics ...................................................................................................................................................................... 31Interval (in days) for the statistics report

....................................................................................................................................................................................... 31Timers ...................................................................................................................................................................... 31AC refresh time in minutes

...................................................................................................................................................................... 31Door alert timeout (minutes)

...................................................................................................................................................................... 31Door reminder timeout (seconds)

...................................................................................................................................................................... 31Error show time in seconds

...................................................................................................................................................................... 31Idle timeout for check inventory (min)

...................................................................................................................................................................... 31Idle timeout foroffline sync (sec)

...................................................................................................................................................................... 31Idle timeout in seconds

...................................................................................................................................................................... 32Info show time in seconds

...................................................................................................................................................................... 32Receipt prompt show time in seconds

...................................................................................................................................................................... 32Receipt reminder show time in seconds

...................................................................................................................................................................... 32Session end info show time in seconds

...................................................................................................................................................................... 32Sip received timeout in seconds

Libcabinet manual 5

....................................................................................................................................................................................... 32User interface...................................................................................................................................................................... 32AFmessage type in UI

...................................................................................................................................................................... 32Default currency

...................................................................................................................................................................... 32Hide flagin language selection

...................................................................................................................................................................... 32Maximum number ofmaintenance messages

...................................................................................................................................................................... 33Show door reminder

.................................................................................................................................................. 33Local settings

....................................................................................................................................................................................... 33Admin ...................................................................................................................................................................... 33Admin password

...................................................................................................................................................................... 33Admin password timeout

....................................................................................................................................................................................... 33Device: Shelf ...................................................................................................................................................................... 33Antennas to use

...................................................................................................................................................................... 34Auto reconnect

...................................................................................................................................................................... 34COMport

...................................................................................................................................................................... 34Reader IP address

...................................................................................................................................................................... 34Reader IP port

...................................................................................................................................................................... 34Shelfreader type

...................................................................................................................................................................... 34Use reader over network

....................................................................................................................................................................................... 34Inventory ...................................................................................................................................................................... 34Item checkout limit

...................................................................................................................................................................... 34Item title query check interval (seconds)

...................................................................................................................................................................... 34Logadded and removed items

...................................................................................................................................................................... 34Number ofinventory attempts before failing

...................................................................................................................................................................... 35Reader busy wait interval (milliseconds)

...................................................................................................................................................................... 35Show checked out by default

...................................................................................................................................................................... 35Timeout for inventory reload (seconds)

...................................................................................................................................................................... 35Timeout for session inventory (seconds)

....................................................................................................................................................................................... 35Language files

...................................................................................................................................................................... 35Language texts

....................................................................................................................................................................................... 35Lock ...................................................................................................................................................................... 35Device number for lock IO card

...................................................................................................................................................................... 35IOcard command for lock open

...................................................................................................................................................................... 35IO card port for lock sensor

...................................................................................................................................................................... 35IOcard retries on read/write failure

...................................................................................................................................................................... 36IOcard status code for door closed

...................................................................................................................................................................... 36IO card status code for lock closed

...................................................................................................................................................................... 36IO card status code for lock open

...................................................................................................................................................................... 36Lock closed recheck interval (milliseconds)

...................................................................................................................................................................... 36Lock IO card status check interval (milliseconds)

...................................................................................................................................................................... 36Lock IO card write wait interval (milliseconds)

...................................................................................................................................................................... 36Lock open status check interval (milliseconds)

...................................................................................................................................................................... 36Lock reopen retry interval (milliseconds)

...................................................................................................................................................................... 36Monitor lock status, ignore door status

...................................................................................................................................................................... 36Notification interval for lock errors (seconds)

...................................................................................................................................................................... 36Use legacy driver for IOcard

...................................................................................................................................................................... 37What to do ifIOcard freezes

....................................................................................................................................................................................... 37Log ...................................................................................................................................................................... 37Hide sensitive info

...................................................................................................................................................................... 37Number ofhours to run debuglogging

...................................................................................................................................................................... 37Save log

....................................................................................................................................................................................... 37Notifications ...................................................................................................................................................................... 37High inventory level threshold for email alert

...................................................................................................................................................................... 37Low inventorylevel threshold for email alert

Libcabinet manual 6

...................................................................................................................................................................... 38Recipients ofemail notifications

...................................................................................................................................................................... 38Send email notifications about

...................................................................................................................................................................... 39Sender address for email notifications

....................................................................................................................................................................................... 39Pictures ...................................................................................................................................................................... 39Card image in authentication page

...................................................................................................................................................................... 39Card image in start page

...................................................................................................................................................................... 39Company logo

...................................................................................................................................................................... 39Email receipt image

...................................................................................................................................................................... 39Farewell image

...................................................................................................................................................................... 39Library logo

...................................................................................................................................................................... 39Receipt image

...................................................................................................................................................................... 39Remove card image

....................................................................................................................................................................................... 40QR Code ...................................................................................................................................................................... 40Library name

...................................................................................................................................................................... 40Use QR code

....................................................................................................................................................................................... 40Receipt ...................................................................................................................................................................... 40Hold slip printer name

...................................................................................................................................................................... 40Print hold slips for hold items

...................................................................................................................................................................... 40Print transfer slips for transfer items

...................................................................................................................................................................... 40Receipt printer mode

...................................................................................................................................................................... 40Receipt printer name

...................................................................................................................................................................... 41Transfer slip printer name

....................................................................................................................................................................................... 41SIP ...................................................................................................................................................................... 41Login location code

...................................................................................................................................................................... 41Login user id

...................................................................................................................................................................... 41Login user password

...................................................................................................................................................................... 41Server ip address

...................................................................................................................................................................... 41Server port

...................................................................................................................................................................... 41Terminal password

...................................................................................................................................................................... 41Use ACS login

....................................................................................................................................................................................... 41Sorting rules ...................................................................................................................................................................... 41Rule

....................................................................................................................................................................................... 42User interface...................................................................................................................................................................... 42Mouse cursor visible

...................................................................................................................................................................... 42Start-button visible

........................................................................................................................43

Troubleshooting

.................................................................................................................................................. 43Tag read errors in Messageboard

........................................................................................................................44

Language codes

Libcabinet manual 7

About

Libcabinet is a self-contained, automatic library module for lending and returning books either

inside a library, or outside, in a remote location. It has a simple user interface software for

patrons to use. This manual contains information for the use of the software.

This document is updated on: May 23rd 2016

Libcabinet version: 2.1.5956

Libcabinet

Libcabinet manual 8

Important information

There are some important things to understand before using Libcabinet, to ensure it works as

designed.

Do not overfill

The RFID reading shelves can read books from shelves only if placed correctly. If you fill the

cabinet up all the way, patrons returning books may place them creatively, which can lead to

items not being recognized.

Tag placement

As with any RFID tagged material, items in Libcabinet should have tags secured to books in

different positions. If all tags are placed in exactly the same position in each book, they will

interfere with each other, causing incorrect reading.

We recommend tags to be placed in at least three different positions on the inside of the back

cover of each item.

Material considerations

Do not fill the cabinet with too many CD’s or DVD’s without testing the reading thoroughly. The

CD and DVD disks contain metal in the material itself, which makes the RFID reading much more

difficult than from books. Depending on the quality and positioning of tags in disks, the number of

disks that the cabinet can read varies.

SIP connection

The cabinet needs a SIP connection to work. If you wish to place the device outside your library,

you need to make sure your firewall allows the connection from the cabinet to your SIP server.

The cabinet does not work in offline mode. If a SIP connection is lost during a patron session, the

patron is allowed to finish the session and items checked out / returned will be recorded locally.

This local cache of items is the automatically updated to the library system once the connection is

restored.

No new sessions are allowed when there is no SIP connection available, because patron identities

cannot be verified.

Theft prevention

Because the content of the cabinet is only read when the patron closes the door, items taken out

of the cabinet can no longer be written to. Thus, the security bit in the tags needs to be turned off

before the cabinet is used. The cabinet will also disable security bits of returned items

automatically. The cabinet is not intended to be fully theft-proof.

Libcabinet manual 9

Getting started

To start using the system, you need to set up some basic settings and fill the cabinet with items.

This chapter has a short introduction on getting started with Libcabinet.

Set up connection to SIP server

The device must be connected to your SIP server before it can be used. Patron cards are validated

from the library system using a SIP connection, and item information is also retrieved using the SIP

connection.

A network cable connector can be found from the bottom of the rear panel of the cabinet.

SIP connection settings can be found from Management Utility section SIP under device settings.

Start the software

Start the Libcabinet software by double-clicking the icon on the screen. The software may also be

configured to start automatically, in which case you do not need to start it up separately.

Enter maintenance mode

When the software is running in normal patron mode, you can enter the Maintenance mode by

touching the four corners of the screen in configured order. The default configuration is 1234

which means a ”U” shape: start by touching the top left corner first, then bottom left, then bottom

right and last the top right corner. This should now enable the maintenance mode; if it doesn’t,

please wait a few seconds before attempting again, so that the device will clear it’s internal

buffer from the previous attempt.

The screen should look like this:

Libcabinet manual 10

Maintenance mode, page 1

Maintenance mode, page 2

More information about Maintenance mode is available in section Maintenance mode .

Open the door

In Maintenance mode, press the Open door button to open the cabinet door.

Fill the cabinet

Fill up the cabinet with whatever material you wish to have available for patrons. Do not fill the

cabinet all the way! Remember that patrons may return items to the cabinet – it must have some

space available.

Disable security

Select Deactivate alarms from the maintenance menu, to disable all alarms of all items. This may

take some time to complete, depending on the number of items in the cabinet.

When you are removing items from the cabinet, you may also set the security of all items through

the maintenance menu. Note, that this will set set security to all items, so you must run the

Deactivate alarms function again if any items remain in the cabinet afterwards.

Close the door

When security has been disabled, close the door.

15

Libcabinet manual 11

Return to normal mode

Press Return to normal mode to close the maintenance interface. The cabinet is now ready to

use.

Main screen

Libcabinet manual 12

Configuring settings

All settings for Libcabinet are configured using Management Utility, a software from P.V. Supa.

Management Utility is delivered with Libcabinet and can be used directly on the Libcabinet

computer, or from another computer connected to the same network.

There is a separate user manual available from Management Utility. This document explains what

the Libcabinet settings do, not how to use Management Utility.

Maintenance mode

The device contains a specific Maintenance mode. It allows access to some information, such as

inventory and statistics, but not to any settings.

Changing the on-screen and receipt texts and languages

All on-screen texts and receipt texts can be altered freely, and languages can be configured as

needed. Texts are modified with a specific tool, Language Editor, which is supplied with the

Libcabinet.

Language Editor is used to modify language files, which are stored in the database. Both

Language Editor and Libcabinet software use Master Controller service to access these files. A

single file of translations can be used by multiple cabinets.

Any changes made to the texts will only take effect after the next restart of the Libcabinet

software.

A separate manual on how to use Language editor is available.

Libcabinet manual 13

Shutting down

To shut down the cabinet, the software and the computer must be shut down first – never just

unplug the device when the computer is running, as it may cause damage to the computer!

Shut down by entering the Maintenance mode first. Then, from the maintenance view, select

Power down to shut the device down.

Alternatively you can use Management Utility from another computer to shut down the cabinet,

and also start it up again. Starting the computer remotely requires that the network supports

Wake On Lan packets.

Libcabinet manual 14

Modes of operation

The software has two modes of operation: Patron mode and Maintenance mode. In normal use,

the software remains always in Patron mode. Maintenance mode is used to carry out specific

tasks, such as enabling or disabling the alarm on tags, or shutting down the software.

Patron mode

Patron mode is the default mode in which the device is normally used. In Patron mode, the device

can be used to perform loans and returns by patrons. The cabinet door is shut, and can only be

opened by inserting a valid patron card and pin code. Once the patron has completed his activity,

he closes the door and is presented a receipt.

Main screen for patron mode

Patron mode in session

Libcabinet manual 15

Maintenance mode

In Maintenance mode, librarians can control the cabinet and perform various options, such as

opening the door, disabling the alarm on all tags and so on.

Maintenance mode, page 1

Maintenance mode, page 2

Entering maintenance mode

When the software is running in normal patron mode, you can enter the Maintenance mode by

touching the four corners of the screen in configured order. The default configuration is 1234

which means a ”U” shape: start by touching the top left corner first, then bottom left, then bottom

right and last the top right corner. This should now enable the maintenance mode; if it doesn’t,

please wait a few seconds before attempting again, so that the device will clear its internal buffer

from the previous attempt.

Disabling the alarms

All tags must have their alarms disabled, before the cabinet is used by patrons. The cabinet

performs an inventory after the door has been closed, and any books the patron has loaned are

now outside the cabinet, and thus the security bit can no longer be set. For that reason, the

security bit must be disabled from all items inside the cabinet.

Inventory

You can run a full inventory on all items in the cabinet. This can be done for example before

leaving the cabinet for patrons to use, or to verify that all items can be correctly recognised by the

readers.

Libcabinet manual 16

Note that the inventory takes some time to complete, as it requires that for each item, the SIP

server is queried for the item information.

Runningfull inventory - prompt

Statistics

From the maintenance menu, a simple statistics report can be printed out. This report only has the

number of items checked in and out per day, over a configured number of days.

More comprehensive reports can be created with the Supa Reporter tool.

Out of use mode

This option allows the device to be placed in ”Out of use” mode. It will display a message on

screen, and not allow patrons to use it. This can be used for example if there is a problem with

the SIP server connection, or the printer has run out of paper.

Libcabinet manual 17

Out ofuse mode enabled

Libcabinet manual 18

Notifications

The cabinet can send notifications through email and/or to Message board or Dahsboard

applications. Email notifications require some configuration (see Email connection info ).

Message board / Dashboard require a network connection through Master controller, but no other

configuration.

Note that repeated email messages with similar content may be caught by spam filters; the

sender name of emails in each cabinet should be added to a whitelist of email servers / clients, to

prevent messages from being tagged as spam.

This section describes how and when notifications are sent.

Messages sent to Message board / Dashboard

The following notifications are only sent to Message board / Dashboard applications.

·Application has been started

·Application is being closed

·Receipt printer status returns to OK after a failure (paper out or error)

·Library service connection (SIP) is restored after a failure

·Library service is disconnected during a session, and offline is allowed (in Offline settings)

·Shelf reader is reconnected after a connection failure

·Shelf reader has a data read failure while reading tags

·Door and / or lock status can not be read due to an IO card reader error

·And RFID patron card is detected in session inventory

All of these are situations that typically do not require staff attention, with the exception of the

door / lock status failure if it persists or happens frequently.

Messages that can also be sent as email

The following list defines messages that can be sent as emails in addition to being sent to

Message board / Dashboard. The first list of messages will always be sent as emails, if the email

settings have been configured:

·Inventory changes (added and/or removed items) noticed in "check inventory", which is run when

door is closed after it has been opened without logging in, or when application has been idle for a

number of minutes stated in setting Idle timeout for check inventory (min)

·When number of items in the cabinet is less than the threshold stated in setting Low inventory level

threshold for email alert after an inventory

·When number of items in the cabinet exceeds the threshold level stated in setting High inventory

level threshold for email alert after an inventory.

The next list of messages will be sent as emails if email settings have been configured, and the

24

25

31

37

Libcabinet manual 19

messages have been selected from Send email notifications about setting dropdown list (flag

name in "double quotes"):

·Library service is disconnected ("Critical errors")

·Library service is disconnected during a session ("Critical errors")

·Session inventory fails (retry count is specified in setting Number of inventory attempts before

failing ("Critical errors")

·Shelf reader is disconnected ("Critical errors")

·When door has been opened without logging in or from maintenance mode (practically a break-

in) ("Door has been left open")

·When lock is closed while door is still open and door was not opened by a patron logging in or

an administrator from maintenance mode (practically a break-in) ("Door has been left open")

·When door has been open (during a session or in maintenance mode) for a number of minutes

stated in setting Door alert timeout (minutes) (this message is resent every time the timer

elapses until the door is closed) ("Door has been left open")

·When door is closed after an alert has been sent for keeping it open for too long ("Door has

been left open")

·An empty tag is encountered in session inventory ("Empty tags")

·When library service rejects a check-in ("Failed check-ins")

·When library service rejects a checkout ("Failed checkouts")

·When a hold item is checked in ("Hold items")

·When a set item is checked in with one or more parts missing ("Incomplete sets")

·When a set item with one or more parts missing is checked out ("Incomplete sets")

·When the number of items checked out in one session is larger than the threshold stated in

setting Item checkout limit ("Large checkouts")

·Receipt printer is offline, out of paper etc. ("Printer errors")

·A tag read/decode error (invalid tag/corrupt data/unknown data model) is encountered in

session inventory ("Tag read errors")

·When a transfer item is checked in ("Tag read errors")

38

34

31

34

Libcabinet manual 20

Settings reference

This section contains information about all settings related to Libcabinet software, as found

through Management Utility.

Global settings

These settings apply to all Libcabinets connected to the same Master Controller, in the same

settings group.

Admin

Settings related to administration tasks on the cabinet.

Admin cards

Admin cards are used to enter Maintenance mode in the software. These can be any patron

cards or special cards with any ID. Store the ID in this setting - when the device reads a card with

this ID, the software goes to Maintenance mode.

Multiple cards can be used, separate the values with comma (,) character, for example

12345,23456,34567

Shutdown cards

Shutdown cards are used to shut down the cabinet. These can be any patron cards or special

cards with any ID. Store the ID in this setting - when the device reads a card with this ID, the shuts

down.

Multiple cards can be used, separate the values with comma (,) character, for example

12345,23456,34567

Authentication

These settings are related to how patrons are authenticated when using Libcabinet.

Auto ok on max digits

If enabled, the pin code screen (or physical pin pad) will automatically press enter when a

maximum length of pin code is entered. If disabled, the user must press enter or OK to accept the

pin code.

Maximum length of pin code is set in Authentication -> Max pin code length setting.

Barcode end key

End key (character) from barcode reader, to indicate Librid that the barcode has been read

completely. This is configured in the barcode reader’s configuration.

15

21

P.V. Supa Libcabinet User manual

Popular Storage manuals by other brands