0% found this document useful (0 votes)
552 views175 pages

Liber8 Configurations v6

Biblotheca Liber8 v6 Config Manual

Uploaded by

Patrick Duggan
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
552 views175 pages

Liber8 Configurations v6

Biblotheca Liber8 v6 Config Manual

Uploaded by

Patrick Duggan
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 175

liber8™

configurations

version 6

www.bibliotheca.com
liber8™ – configurations, page 2 of 175

Copyrights & Trademarks


Copyright © 2012 Bibliotheca, all rights reserved. Bibliotheca provides this document to customers and prospective customers only. The content of this
document is strictly confidential and may not to be reproduced in any form or transferred by any means, in whole or in part, to any third party without the
explicit and prior written consent of Bibliotheca.

Liber8™, smartadmin™, smartgate™ manager, smartstock™ manager, smartstation™ manager, smartdispenser™ manager, and smartreturn™ manager are
trademarks of Bibliotheca. All external references to these products must be indicated with the Trademark ™ symbol and credited to Bibliotheca.

3M™ Standard Interchange Protocol is the copyright of the 3M Corporation © 1997, 1998, 2005.
Windows is a registered trademark of the Microsoft Corporation in the United States and other countries.

Terms & Conventions


Text boxes containing an orange circle and white “i” contain important information pertaining to
the use or configuration of the product. These may also contain tips or recommendations from
Bibliotheca or Bibliotheca customers.

Text boxes containing a red triangle and exclamation point contain either information critical to
the successful use or configuration of the product, or a warning. It is important to read and
consider the information presented in the hazard text boxes carefully.

Text boxes containing a blue square and question mark contain a definition or explanation of a
specific term or concept that may not be immediately apparent or common knowledge to all
users. The information in these text boxes should assist the reader’s understanding of this
document’s content.

Clickable/Writeable Fields – Bold Text denotes a button, tab, text field, or menu that a user can select or otherwise interact with.
Location/Reference – Italic text denotes the location of a file or folder on a computer, or a specific section within the document or reference to a separate
document

www.bibliotheca.com
liber8™ – configurations, page 3 of 175

Table of Contents

1 SelfCheck.ini.............................................................................................................................................................. 6
1.1 [HOSTCONNECTION] ................................................................................................................................................. 6
1.2 [READER] .................................................................................................................................................................... 15
1.3 [ISILS] ........................................................................................................................................................................... 18
1.4 [PATRON ID] .............................................................................................................................................................. 18
1.5 [CONTROLLER] .......................................................................................................................................................... 23
1.6 [OPTIONS] .................................................................................................................................................................. 25
1.7 [OFFLINE].................................................................................................................................................................... 43
1.8 [RECEIPT PRINTER] ..................................................................................................................................................... 47
1.9 [MESSAGES] ............................................................................................................................................................... 67
1.10 [DATE FORMAT] ..................................................................................................................................................... 68
1.11 [DIAGNOSTIC LOGGING].................................................................................................................................... 71
1.12 [GUI]........................................................................................................................................................................ 72
1.13 [SELF PAYMENT] ..................................................................................................................................................... 73
1.14 [LANGUAGE] ......................................................................................................................................................... 80
1.15 [THEME]................................................................................................................................................................... 82
1.16 [MERGED ACCOUNT] .......................................................................................................................................... 83
1.17 [ADMIN].................................................................................................................................................................. 84
1.18 [HARDWARE] ......................................................................................................................................................... 89
1.19 [CASH PAYMENTS] ................................................................................................................................................ 92
1.20 [CARD PAYMENTS] ............................................................................................................................................... 93
1.21 [E PAYMENTS] ........................................................................................................................................................ 95
1.22 [ECARD PAYMENTS] ............................................................................................................................................. 96
1.23 [RECONCILIATION SERVICES] ............................................................................................................................. 97

www.bibliotheca.com
liber8™ – configurations, page 4 of 175

1.24 [SMART RECEIPTING] ............................................................................................................................................ 97


1.25 [EXTERNAL APPS]................................................................................................................................................... 98
1.26 [NETLOAN] ........................................................................................................................................................... 100
1.27 [MYCOMMUNITY] ............................................................................................................................................... 100
1.28 [PAYMENT WEB SERVICES] ................................................................................................................................. 101
1.29 [PATRON WEB SERVICES] ................................................................................................................................... 102
1.30 [EM KIOSK] ........................................................................................................................................................... 102
1.31 [ICON] .................................................................................................................................................................. 104
1.32 [SORT ORDER] ..................................................................................................................................................... 107
1.33 [SMART DISPENSER] ............................................................................................................................................ 108
1.34 [AV] ....................................................................................................................................................................... 110
1.35 [AUTHORIZENET] .................................................................................................................................................. 112
1.36 [BIBLIOMESSAGING] ........................................................................................................................................... 113
1.37 [AHPM] ................................................................................................................................................................. 114
1.38 [ITEM SALES] ......................................................................................................................................................... 115
1.39 [SMARTLOCKER] .................................................................................................................................................. 115
1.40 [SMARBLADE] ...................................................................................................................................................... 115
1.41 [SS1000] ................................................................................................................................................................ 116
1.42 [SORTING] ............................................................................................................................................................ 119
1.43 [PATRON BLOCKS] .............................................................................................................................................. 121
1.44 [BORROW RULES] ................................................................................................................................................ 122

2 <Language>.ini ..................................................................................................................................................... 124


2.1 [SCREEN TEXT] ......................................................................................................................................................... 124
2.2 [COLUMN HEADERS] .............................................................................................................................................. 131
2.3 [BUTTON TEXT].......................................................................................................................................................... 132
2.4 [POPUP TEXT] ........................................................................................................................................................... 136

www.bibliotheca.com
liber8™ – configurations, page 5 of 175

2.5 [SELF PAYMENT] ...................................................................................................................................................... 142


2.6 [CHIP AND PIN] ....................................................................................................................................................... 145
2.7 [E PAYMENT] ............................................................................................................................................................ 147
2.8 [ECARD] ................................................................................................................................................................... 147
2.9 [MERGED ACCOUNT] ............................................................................................................................................ 148
2.10 [INFORMATION BOX] .......................................................................................................................................... 148
2.11 [EXTERNAL APPS]................................................................................................................................................. 149
2.12 [MESSAGES] ......................................................................................................................................................... 150
2.13 [DISC DISPENSER] ................................................................................................................................................ 150
2.14 [RECEIPT PRINTER] ............................................................................................................................................... 152
2.15 [AV UNLOCKER] .................................................................................................................................................. 161
2.16 [SMARTLOCKER] .................................................................................................................................................. 163
2.17 [SMARTBLADE] ..................................................................................................................................................... 164
2.18 [RECONCILIATION SERVICE] ............................................................................................................................. 165
2.19 [AUDIO] ................................................................................................................................................................ 165
2.20 [PATRON BLOCKS] .............................................................................................................................................. 168

3 Innovative cash device configuration................................................................................................................ 169


3.1 Cash.config............................................................................................................................................................. 169
3.2 SmartController.config .......................................................................................................................................... 170
3.3 SmartHopper.config .............................................................................................................................................. 171
3.4 SmartPayout.config ............................................................................................................................................... 173

Contact Bibliotheca Support ....................................................................................................................................... 175

www.bibliotheca.com
liber8™ – configurations, page 6 of 175

1 SelfCheck.ini
1.1 [HOSTCONNECTION]
The following configurations are stored in the SelfCheck.ini [HOSTCONNECTION] section and relate to the LMS connection and the SIP2 interface.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = Infor Plus
1 = Infor Advance
2 = Dynix Classic, Horizon
3 = Talis, Heritage, All
others Library Management System to
which Liber8 will connect. Note
Host Type List Host LMS 4 = DS Galaxy that only some LMSs have specific 3
5 = Infor Vubis numbers. For all those not listed
6 = Ex-Libris Aleph use value 3.
7 = SirsiDynix Unicorn,
Symphony
8 = Civica Spydus
9 = Ex-Libris Voyager
SIP2 = SIP2 protocol Indicates what protocol will be
ConnectionMode List LMS Protocol SIP2
NCIP = NCIP protocol used for LMS communication
Only valid if
Telnet handshaking login request
LoginRequest String Telnet login request ConnectionType =
to receive from server.
VT100
Only valid if
Telnet handshaking login name to
LoginName String Telnet login name ConnectionType =
send to server.
VT100
Only valid if
Telnet password Telnet handshaking password
PasswordRequest String ConnectionType =
request request to receive from server.
VT100
Only valid if
Telnet handshaking password to
LoginPassword String Telnet password ConnectionType =
send to server.
VT100

www.bibliotheca.com
liber8™ – configurations, page 7 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Only valid if Telnet handshaking optional


Telnet extra message
LoginMOTDRequest String ConnectionType = message prompt to receive from
request
VT100 server.
Only valid if Telnet handshaking optional
Telnet extra message
LoginMOTD String ConnectionType = message prompt reply to send to
response
VT100 server.
Only valid if Telnet handshaking login
Telnet connection
LoginOK String ConnectionType = complete message to receive
established message
VT100 from server.
Send EOT (^D) Determines whether to send
Only valid if
command to Telnet 0 = Don’t send EndOfTransmission (Ctrl+D)
SendEOTOnDisconnect List ConnectionType = 0
host before 1 = Send ^D command command before disconnecting
VT100
disconnection from telnet host.
Unit Name String Name of machine Name of machine.
Location code of site specified by
LocationCode String Location code
LMS.
Library collection Location code of collection
LibraryCollectionCode String
code specified by LMS.
Value sent in SIP2 message to LMS
000 - to determine width of printer. Has
PrinterWidth String Printer Width 040
999 no effect on kiosk receipt printer,
but is required by SIP2 protocol.
TCP/IP address of the SIP2 server. If
IP address of SIP2
HostAddress String Liber8 is unable to connect to this
server
address, it will run in off-line mode.
Liber8 will open the specified port
number to the SIP2 server
specified by the HostAddress
Port used by SIP2 value above. For telnet
Port Integer
server communications, this is normally
port 23. If Liber8 is unable to open
the port, or the server shuts the
port, it will run in off-line mode.

www.bibliotheca.com
liber8™ – configurations, page 8 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Username sent in a SIP2 login


SIPUserName String SIP2 user name message (93). Used to validate
Self Service machine with LMS.
Password sent in a SIP2 login
SIPUserPassword String SIP2 password message (93). Used to validate
Self Service machine with LMS.
Location sent in a SIP2 login
message (93). Used to inform LMS
SIPLocationCode String SIP2 location code
of location of Self Service
machine.
VT100,
Type of connection to VT100 = VT100 SOCKE
ConnectionType List SOCKE Type of connection to LMS.
LMS SIP2 server SOCKET = SOCKET T
T
Number of minutes of inactivity
before a status message is sent to
the SIP2 server. This can be used to
Periodic message to keep a connection open to the
TimeoutReminder Integer 0 - 60 LMS frequency LMS where long periods of 5
(minutes) inactivity would lead to the
connection being terminated. To
disable the sending of reminder
status messages, set this to 0.
Only valid when
TimeoutReminder > 0 Option to reconnect to LMS every
Reconnect n minutes set in TimeoutReminder.
ReconnectOnTimeoutRe 0 = do not reconnect Backup file must not
List periodically if no Reconnecting takes place only 1
minder 1 = try to reconnect be present. LMS not
backup file present when backup file is absent and
disconnected LMS is not disconnected manually.
manually.
Encryption algorithm used for
Algorithm used to
UIDAlgorithm Integer 0-9 encrypting user ids sent in the SIP2 0
send SIP2 user
message 93.
Encryption algorithm used for
Algorithm used to
PWDAlgorithm Integer 0-9 encrypting passwords sent in the 0
send SIP2 password
SIP2 message 93.

www.bibliotheca.com
liber8™ – configurations, page 9 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Defines whether SIP2 login


Send SIP2 login 0 = Do not send message (93) is sent to SIP2 server
SendSIP2Login List 1
message to LMS 1 = Send after connection has been
established.
0 = Only increment if
duplicate SIP2 message Determines the logic used for
Increment sequence
1 = Always increment calculating the sequence number
AutoIncSequenceNo List number in each SIP2 0
2 = Never increment that is appended to each SIP2
message
3 = Only increment if NOT message.`
duplicate
Defines whether SIP2 messages
Validate SIP2 0 = No validation received from the LMS are
ValidateSIP2Messages List 1
messages 1 = Validation validated using the sequence
number and checksum fields.
Defines whether we send the AD
0 = Don’t send AD field if (password) field of the 63
Always send password
SendPasswordCode List empty message for patrons with no 0
code in SIP2 message
1 = Always send AD field passwords (e.g. when liber8
doesn’t prompt for a password).
Defines how many times we try to
DroppedConnectionRetr Number of retries if
Integer 0-9 reconnect to the server if the 0
y connection dropped
connection drops.
Defines how many times we
Number of retries if
PayMessageResend Integer 0-9 resend a pay message when no 1
pay message fails
response is received.
0 = Wait before
Action taken when resending original
ResendImmediatelyOnIn Determines how to act when an
List invalid message request 1
validMessage invalid message is received.
received 1 = Resend original
request immediately

www.bibliotheca.com
liber8™ – configurations, page 10 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Determines whether Liber8


overrides the SIP2 timeout period
Timeout to override and by how many seconds. Set to
OverWriteSIPTimeout Integer 0 - 60 LMS supplied timeout 0 to leave timeout to be 0
(seconds) determined by LMS. Set to positive
integer to override LMS timeout
with that number of seconds.
Determines whether SIP2 SCStatus
message is sent to the LMS after
Send status message each function has been
0 = Do not send completed.
SendStatusAfterFunction List after each function 1
1 = Do send
completed 0 : Don’t send SIP2 SCStatus
message
1 : Do send SIP2 SCStatus message
Defines any extra text to be
Extra text to include in
SCStatusExtraText String added to a SIP2 SC Status
SIP2 status message
message
Determines if an extra field is to be
sent in SIP2 Fee Paid Messages
AA - ZZ, Extra field to be containing amount paid.
PayExtraAmountField String [Empty inserted into SIP2 pay
[blank] - No extra field sent
] messages
[2-char code] - Extra field sent with
this field code
01 = Other/unknown
02 = Administrative
03 = Damage
Fee Type to use when 04 = Overdue
Determines the fee type to be
SIPFeeType List sending SIP2 pay 05 = Processing 06
sent in SIP2 Fee Paid Messages.
messages 06 = Rental
07 = Replacement
08 = Computer Access
09 = Hold Fee
Payment Type to use 00 = Cash Determines the payment type to
SIPPaymentTypeCash List in SIP2 pay message 01 = VISA be sent in SIP2 Fee Paid Messages 00
when cash used 02 = Credit Card for cash payments

www.bibliotheca.com
liber8™ – configurations, page 11 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Payment Type to use Determines the payment type to


00 = Cash be sent in SIP2 Fee Paid Messages
in SIP2 pay message
SIPPaymentTypeCNP List 01 = VISA for chip and pin payments. 02
when Chip and Pin
02 = Credit Card
used
Determines the name of the field
Field for identifying used to identify age-restricted
SIPAgeRestrictionField String CH
age-restricted items items inside the item information
response.
Determines the method of
Self Payment method 0 = SIP2 communicating with the LMS
LMSPaymentMethod List 0
used by LMS 1 = Web Services when retrieving and updating
charge information
AA –
Extra field used for Determines the extra field name
ZZ,
SIPItemNumberField String transmitting numbers where LMS should send book’s IN
[Empty
like ISBN etc. ISBN and/or other numbers
]
Specifies extra field text (field
name and content) to add to Sip2
Extra text to add to login message to enable
SIPVPValue String
SIP2 login message extended information in
subsequent messages for specific
ILS/LMSs

www.bibliotheca.com
liber8™ – configurations, page 12 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

000 = Unknown
001 = English
002 = French
003 = German
004 = Italian
005 = Dutch
006 = Swedish
007 = Finnish
008 = Spanish
009 = Danish
010 = Portuguese
011 = Canadian French
012 = Norwegian
013 = Hebrew
Determines the language setting
Language List Language for SIP2 014 = Japanese 001
for SIP2
015 = Russian
016 = Arabic
017 = Polish
018 = Greek
019 = Chinese
020 = Korean
021 = North American
Spanish
022 = Tamil
023 = Malay
024 = United Kingdom
025 = Icelandic
026 = Flemish
027 = Taiwanese
Determines the currency setting
USD = US Dollars
for SIP2 (N.B. other currencies
CAD = Canadian Dollars
originally defined, e.g. French
Currency List Currency for SIP2 GBP = Pound GBP
Franc, are no longer in circulation
JPY = Japanese Yen
and so not included on the list at
PLN = Polish Zloty
left
Allows override of the Institution Id
InstitutionId String Instituion ID override
returned from the LMS

www.bibliotheca.com
liber8™ – configurations, page 13 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Determines if ‘online status’ flag


Use ‘online status’ flag 0 = Ignore flag
SIP2OnlineStatus List sent by LMS is used to check if LMS 0
from LMS 1 = Use flag
is online.
Determines if ‘checkin ok’ flag
Use ‘checkin ok’ flag 0 = Ignore flag
SIP2CheckinOK List sent by LMS is used to check if 0
from LMS 1 = Use flag
check in is allowed.
Determines if ‘checkout ok’ flag
Use ‘checkout ok’ flag 0 = Ignore flag
SIP2CheckoutOK List sent by LMS is used to check if 0
from LMS 1 = Use flag
check in is allowed.
Determines if ‘offline ok’ flag sent
Use ‘offline ok’ flag 0 = Ignore flag
SIP2OfflineOK List by LMS is used to check if offline 0
from LMS 1 = Use flag
mode is supported.
Specifies the name that is used Memb
SIP name used to
SIPAnnualFeesName String inside the SIP2 message for annual ership
identify annual fees
fees Fees
Specifies whether liber8 will
synchronise the kiosk date and
Synchronise date/time 0 = Do not synchronise time with the LMS server. Note: this
SIPDateTimeSync List 0
with LMS 1 = Do synchronise requires the kiosk Windows user to
have permission to change the
system clock.
Specifies a comma-separated list
Values returned by
of values that may be returned by
SuppressDateValues String date fields to be
the LMS in a date field that should
suppressed
be ignored by Liber8
Decimal separator Specifies decimal separator
SIPDecimalSeparator String .
used in SIP2 messages symbol used in SIP2 messages
0 = UTF8 encoding
(doesn’t affect plain Determines the method of
Indicates method of text) encoding the texts that must be
UnicodeEncoding List encoding of the text 1 = ‘\’ prefixed UCS2 0
decoded to display on screen or
sent by LMS encoding receipt
2 = Codepage

www.bibliotheca.com
liber8™ – configurations, page 14 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Codepage to use
Determines the codepage to use
CodePage String when
when decoding SIP2 string fields.
UnicodeEncoding = 2
SIP2 field mapping list
Allows SIP2 fields to be copied
SIP2FieldMappingFrom< SIP2 fields name to from one field to another to cope
String
n> map from with differences between different
LMS SIP2 implementations.
Allows SIP2 fields to be copied
SIP2 fields name to from one field to another to cope
SIP2FieldMappingTo<n> String
map to with differences between different
LMS SIP2 implementations.
Determines how frequently
Numb attempts are made to reconnect
OfflineReminder 0 - 999 Reconnect frequency 0.5
er to the ILS when running offline.
Measured in minutes.
0 = Minor unit (e.g.
pence) Determines the unit of currency
CurrencyUnit List Currency unit used in charge breakdown values 0
1 = Major unit (e.g. when using PaymentMode 3.
pounds)
Multiplier for charge breakdown
value to ensure value is converted
CurrencyMultiplier Integer Currency multiplier 100
into consistent unit when using
PaymentMode 3.
Specifies the Terminal Password to
SIP2 Terminal
TerminalPassword String use in the AC field of all SIP2
password
request messages that support it.
N = SIP2 standard (Flag =
N when online, flag = Y
when offline) Determines how the SIP2 ‘no
Default no block flag
DefaultNoBlockFlag List Y = When online set No block’ flag is set when running N
when online
Block flag to Y. (No online.
change to offline
processing).

www.bibliotheca.com
liber8™ – configurations, page 15 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Determines which codes in the


Valid charge type SIP2 field ‘fee type’ will be
ChargeTypeCode<n> String 01, 06
codes recognized as rental charges. Any
number of these can be added.

0 = Do not include Determines whether the location


Include location code
IncludeLocationCode List code is sent to the ILS in NCIP 0
in NCIP messages 1 = Include messages.
0 = No parsing (standard
SIP2) Determines how Item Information
1 = TLC CARL.X (barcode data is obtained from the items list
ItemsParsing List Items parsing method 0
only) returned in a Patron Information
2 = TLC CARL.X (full item SIP2 message.
info)

1.2 [READER]
The following configurations are stored in the SelfCheck.ini [READER] section and relate to the RFID reader and the format of data stored on tags.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Number of the serial port that the


Serial barcode
BarcodePort Integer 0 - 99 optical barcode scanner or swipe
scanner port
card reader is attached to.
Length of patron barcode packet.
Serial barcode
Only valid if Used by com port barcode
BarcodePacketLength Integer 0 - 999 scanner packet 14
BarcodePort > 0 scanners to determine packet size
length
to read from com port.
The string value that indicates the
Serial barcode
Only valid if start of barcode. Use ASCII
BarcodeStartString String scanner data start
BarcodePort > 0 characters or hex value prefixed
indicator
with \
The string value that indicates the
Serial barcode
Only valid if end of barcode. Use ASCII
BarcodeEndString String scanner data \0D
BarcodePort > 0 characters or hex value prefixed
termination string
with \

www.bibliotheca.com
liber8™ – configurations, page 16 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

600, 1200, 2400, 4800, 7200,


Only valid if Serial barcode reader COM port
BarcodeBaudRate List Port baud rate 9600, 14400, 19200, 38400, 19200
BarcodePort > 0 baud rate
57600, 115200, 128000
String value required to initialise the
Serial barcode
Only valid if barcode reader (Use ASCII
BarcodeInitString String scanner initialisation
BarcodePort > 0 characters or hex value prefixed
string
with \)
String value required to enable the
Serial barcode
Only valid if barcode reader Use ASCII
BarcodeEnableString String scanner enabling
BarcodePort > 0 characters or hex value prefixed
string
with \
String value required to disable the
Serial barcode
Only valid if barcode reader Use ASCII
BarcodeDisableString String scanner disabling
BarcodePort > 0 characters or hex value prefixed
string
with \
The unique library identifier that
prefixes the data on a tag. This is
Must be 8 hex
Application Code String Application code specified during the TagApply
characters
process. Only tags with this
application code are recognised.
Alternative application codes
Must be 8 hex Alternative application codes that
AltAppCode<n> String Application code
characters will also be accepted.
Determines where the item
Item barcode start
DataStart Integer 1 - 16 barcode begins in the data 1
character
retrieved from the tag.
Determines the length of the item
Item barcode
DataLength Integer 1 - 16 barcode in the data retrieved from 14
length
the tag.

www.bibliotheca.com
liber8™ – configurations, page 17 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

To preserve any
leading or trailing String containing all the characters
spaces, the that can be used in item barcodes.
Valid item barcode 01234
ValidBarcodeChars String values must be If an item barcode contains any
characters 56789
enclosed in other character then an invalid
double quotes, barcode message is displayed.
eg “0123456789 ”
Alternative barcodes
Specifies an alternative barcode
Alternative item prefix to be used if there are <n>
AltBarcodePrefix<n> String
barcode prefix different types of item barcode
used.
Specifies an alternative barcode
Alternative item
start character to be used if there
AltBarcodeStart<n> Integer 1 - 16 barcode start
are <n> different types of item
character
barcode used.
Specifies an alternative barcode
Alternative item length to be used if there are <n>
AltBarcodeLength<n> Integer 1 - 16
barcode length different types of item barcode
used.
Specifies a prefix to be appended
Alternative item
AltBarcodeAddPrefix< to the barcode if there are <n>
String barcode additional
n> different types of item barcode
prefix
used.
Specifies a suffix to be appended
Alternative item
AltBarcodeAddSuffix< to the barcode if there are <n>
String barcode additional
n> different types of item barcode
suffix
used.
The number of
reported RFID core The number of reported RFID core
RFIDCoreErrorCount Integer 1-∞ errors before we errors before we send notification 10
send notification to to smartadmin
smartadmin

www.bibliotheca.com
liber8™ – configurations, page 18 of 175

1.3 [ISILS]
Allows specifying of ISIL values for encodings that use ISIL in place of specifying under the individual Encoding section
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

ISIL list
List of ISILs that will be read and deemed correct. A tag read
Alphanumeric
with an ISIL not listed will be deemed as incorrect. The ISIL
ISIL<n> String including ‘-‘, ‘/’, ISIL numbers
defines the library and is written to the tag by TagApply (or
‘:’
other external software). <n> must be sequential starting at 1

1.4 [PATRON ID]


The following configurations are stored in the SelfCheck.ini [PATRON ID] section and relate to the format of patron library cards.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = No Determines whether the user must


Password
Password Required List 1 = Yes enter a password after scanning 0
required
2 = Yes, Try default Pin first their membership card.
Default Pin Used when Password
DefaultPin String Default Pin number used
number Required = 2
AlphaNumeric = Letters and Determines whether the password
number Only valid when
Password screen screen displays a full alphanumeric Nume
PinChars List Numeric = Numbers only Password Required >
keyboard type on-screen keyboard, a numeric ric
0
None = No keyboard keypad, or no keyboard.
Only valid when
lower = enables lower case Password Required >
key set 0 and PinChars =
upper = enables upper case AlphaNumeric
Determines available key sets used
Password screen key set Use any value
PinCase MVList on the password on-screen lower
case options both = enables lower and separated with ‘|’
keyboard.
upper case key set character
symbols = enables symbols If more than 1 set is
key set available ‘CapsLock’
button will be visible

www.bibliotheca.com
liber8™ – configurations, page 19 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

AlphaNumeric = Letters and Determines whether the patron-id


number screen displays a full alphanumeric
Patron number Numeric = Numbers only Only valid when on-screen keyboard, or a numeric Nume
IDChars List entry screen NumericX = Numbers and the Keyboard Login = 1 keypad or a numeric keypad with ric
keyboard type letter ‘X’ the letter ‘X’ included, or no
None = No keyboard keyboard.
Only valid when
lower = enables lower case IDChars =
key set AlphaNumeric
upper = enables upper case
Patron number Use any value Determines available key sets used
key set
IDCase MVList entry screen separated with ‘|’ on the patron id on-screen lower
both = enables lower and
case options character keyboard.
upper case key set
symbols = enables symbols If more than 1 set is
key set available ‘CapsLock’
button will be visible
Upper = Forces upper case Only valid when
Patron number
Lower = Forces lower case Keyboard Login = 1 Determines the case used of the
IDCase List entry screen Lower
Both = ‘Caps-lock’ key used and IDChars = patron-id on-screen keyboard.
case options
to choose case AlphaNumeric
Prefix for patron
The ID prefix that will automatically
ID when entered Only valid when
IDPrefix String be added to the patron ID when
using on-screen Keyboard Login = 1
using the keyboard login.
keyboard
The number of different patron
Number of
barcode symbologies (methods of
Symbology Count Integer 1 - 99 patron barcode 1
encoding data into barcodes) that
symbologies
may be read.
Symbologies
SymbologyLength_<n Length of patron The number of characters in the nth
Integer 1 - 16 14
> barcode barcode symbology.
Prefix for patron The prefix characters of the nth
SymbologyPrefix_<n> String
barcode barcode symbology.

www.bibliotheca.com
liber8™ – configurations, page 20 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

If the symbology characters read in


are greater than the symbology
Length specified and the IDCode
matches then the symbology is
chopped to the set symbology
Match string for length.
SymbologyIdCode_< forcing
String This is used for reads performed via
n> truncation of
patron barcode a card swipe machine (which
reads 70+ characters) This will keep
the all characters from the first up
to the required length then discard
the rest and then the usual rules
are applied to remaining patron id.
The number of characters into the
Patron barcode string read from the barcode
SymbologyStart_<n> Integer 1 - 16 1
start character where the patron identifier begins
of the nth barcode symbology.
The number of characters to read
Patron barcode from the position specified in
SymbologyChars_<n> Integer 1 - 16 14
length SymbologyStart_[number] of the
nth barcode symbology.
Additional characters to add to
Patron barcode the patron ID. This is used when
SymbologyAddChars
String additional patron barcodes include extra
_<n>
characters characters that are not picked up
by the scanner.
Patron barcode
The position within the patron
SymbologyAddChars additional
Integer 1 - 16 barcode where the additional
Pos_<n> character
characters will be added.
position
The number of milliseconds to wait
Time to wait for
after a symbology match to see if
SymbologyTimeout_< 0- additional
Integer there are any more characters to 0
n> 1000 characters
come for the nth barcode
(milliseconds)
symbology.

www.bibliotheca.com
liber8™ – configurations, page 21 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

? – any character
- – remove
character from this
Allows PatronID to have a mask
SymbologyMask_<n> String PatronID mask position
applied.
@ – only alpha
character
# – only digit
INT – numeric value
HEX – hexadecimal value Determines the format of the
SymbologyEncoding_ PatronID input
List TEL – subtracts 21 from each PatronID as it’s received in INT
<n> format
digit pair for Telepen keyboard buffer.
purposes
Only valid when Determines the direction of the
SymbologyDirection_ PatronID input 0 – standard
List SymbologyEncoding_ bytes in HEX representation on 0
<n> direction 1 – reversed
<n> = HEX PatronID.
Determines if a conversion is
required on patron numbers after
they are scanned in:
Match string to [blank] = No conversion
PatronConversionMa trigger a [match string] = If a match string is
String
tch conversion of present then any patron barcodes
patron barcode that match it will be converted
from hex into decimal. The match
string can include literal
characters, ‘?’, ‘*’ and sets.

Only valid if Determines the extra character


Extra character A, B, C, D, E, F, G, H, I, J, K, L, that appears on the numeric on
NumericKeyboardExtr PinChars = NumericX
List on numeric M, N, O, P, Q, R, S, T, U, V, W, screen keyboard X
aChar or
keyboard login X, Y, Z
IDChars = NumericX

www.bibliotheca.com
liber8™ – configurations, page 22 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Specifies the path (optional) and


filename for a file containing any
conversions that need to be
applied to patron barcodes before
Patron
they are sent to the LMS. The file
PatronConversionFile String conversion
should contain a comma delimited
filename
list with each row consisting of the
patron barcode to match and
then the patron barcode that it
should be converted to.
Login screen 0 = Keyboard not displayed Determines whether the on-screen
KeyboardDefaultStat
List keyboard default keyboard is displayed when 0
e 1 = Keyboard displayed
state entering the login screen
Determines what to do when a
barcode is scanned on the login
screen that does not match any of
the configured patron
symbologies.
0 = If barcode scanned that fails to
0 = Process non-matching match any symbologies, then bring
Ignore non- barcodes
IgnoreNonMatchingB up the standard message ('your
List matching 0
arcodes 1 = Ignore non-matching membership number was not
barcodes
barcodes recognised'), then go back to main
screen.
1 = If barcode scanned that fails to
match any symbologies then
ignore that barcode and clear
input buffer, then continue waiting
for next barcode scan.

www.bibliotheca.com
liber8™ – configurations, page 23 of 175

1.5 [CONTROLLER]
The following configurations are stored in the SelfCheck.ini [CONTROLLER] section and relate to the communications with machine I/O devices (e.g. return bins
and lights).

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = No bins
1 = 1 bin (attached to
Sensor1 if exists)
2 = 1 bin (attached to
Sensor2 if exists)
3 = 2 bins in sortation
Return bin Specifies the setup of the return
BinConfiguration List mode (left is normal, 3
configuration bins.
right is exception)
4 = 2 bins in sortation
mode (left is exception,
right is normal)
5 = 2 bins in auto-swap
mode
Indicates if the
0 – disabled
Sensor1Enabled List sensor 1 is Specifies if the sensor 1 is enabled 1
1 – enabled
enabled
Indicates if the
0 – disabled
Sensor2Enabled List sensor 2 is Specifies if the sensor 2 is enabled 1
1 – enabled
enabled

Bin lock I/O I/O channel that is linked to the


Reserved Channel Integer 0 - 15 channel - door for “exception” items being 2
exceptions returned.
I/O channel that is linked to the
Bin lock I/O
Non Reserved Channel Integer 0 - 15 door for normal items being 1
channel - normal
returned.
Value to send to the IO controller
Lock Bin Value Integer 0-1 Lock bin value 1
to lock a door on a return bin.
Value the bin sensors will send to
Bin Full Value Integer 0-1 Bin full value the IO Controller card when the 1
bin is full.

www.bibliotheca.com
liber8™ – configurations, page 24 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Sensor I/O Determines the channel that sensor


Sensor Channel 1 Integer 0 - 15 1
channel 1 1 is attached to.
Sensor I/O Determines the channel that sensor
Sensor Channel 2 Integer 0 - 15 2
channel 2 2 is attached to.
Specifies the duration in
milliseconds that the bin beam
should be broken in order to signal
Bin Delay Integer 0 - 10000 Bin full delay 0
the bin as full. If BinDelay=0 then
the bin is considered to be full
whenever the beam is broken.
Only valid if
I/O channel for
ChannelBooks Integer 0-8 InterfaceType = Specifies the book light channel. 1
book slot light
Smart
I/O channel for Only valid if
ChannelReceipt Integer 0-8 receipt printer InterfaceType = Specifies the receipt light channel. 2
light Smart
Only valid if
I/O channel for
ChannelCoinOp Integer 0-8 InterfaceType = Specifies the coin-op light channel. 4
coin-op light
Smart
Only valid if
I/O channel for Specifies the chip and pin light
ChannelChipAndPin Integer 0-8 InterfaceType = 3
chip and pin light channel.
Smart
I/O channel for Only valid if
ChannelBinLeft Integer 0-8 left bin lock and InterfaceType = Specifies the left bin light channel. 5
light Smart
I/O channel for Only valid if
ChannelBinRight Integer 0-8 right bin lock and InterfaceType = Specifies the right bin light channel. 6
light Smart
Only valid if
Flash duration Determines the duration (in
FlashTime Integer 0 - 10000 InterfaceType = 1000
(milliseconds) milliseconds) the light flashing lasts.
Smart
Only valid if
0 = No flashing Determines whether the books light
FlashBooks List Flash book light InterfaceType = 1
1 = Flashing flash is enabled or not.
Smart

www.bibliotheca.com
liber8™ – configurations, page 25 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Only valid if
0 = No flashing Determines whether the receipt
FlashReceipt List Flash receipt light InterfaceType = 1
1 = Flashing light flash is enabled or not.
Smart
Only valid if
Flash coin-op 0 = No flashing Determines whether the coin-op
FlashCoinOp List InterfaceType = 1
light 1 = Flashing light flash is enabled or not.
Smart
Only valid if
Flash chip and 0 = No flashing Determines whether the chip and
FlashChipAndPin List InterfaceType = 1
pin light 1 = Flashing pin light flash is enabled or not.
Smart
0 = Book light not Only valid if
Keep book light Determines whether the book’s
BooksAlwaysOn List always on InterfaceType = 1
on all the time light is always on.
1 = Book light always on Smart

1.6 [OPTIONS]
The following configurations are stored in the SelfCheck.ini [OPTIONS] section and relate to the main functionality of Liber8.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = Unavailable
1 = Available as 1st
button Determines the availability and
Show Borrow List Borrow enabled 2 = Available as 2nd position of the function button on 1
button the option screen.
3 = Available as 3rd
button
If Show Status = 0 and
0 = Unavailable
only one of the
1 = Available as 1st
Merged Account
button Determines the availability and
Merged account functions is enabled,
Show Status List 2 = Available as 2nd position of the function button on 2
screen enabled that function will
button the option screen.
appear instead of
3 = Available as 3rd
Account button on
button
main menu

www.bibliotheca.com
liber8™ – configurations, page 26 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = Unavailable
1 = Available as 1st
button Determines the availability and
Show Return List Return enabled 2 = Available as 2nd position of the function button on 3
button the option screen.
3 = Available as 3rd
button
0 = No default action Determines the default action (i.e.
1= 1st button option which of the available buttons is
Default main
DefaultAction List deemed to have been selected) if 0
menu action 2= 2nd button option a patron scans their card on the
3 = 3rd button option main menu screen
Determines the number of seconds
Screen idle
Timeout Seconds Integer 0 - 999 of inactivity before returning to the 60
timeout
start screen
0 = Show failed returns
Method of Determines whether failed returns
Show Not checked in as normal items
List sorting failed are treated as an “exception” or 1
as reserved 1 = Show failed returns
returns “normal” return.
as exception items
Determines if confirmation is
Display rental 0 = Do not prompt requested from the user if a
RentalPrompt List 1
confirmation 1 = Do prompt chargeable item is borrowed or
renewed:
Determines whether an information
screen is displayed on borrow and
renew if charges have been
incurred. This allows users to see
Display rental 0 = Do not display
RentalInfo List any fees associated with a borrow 0
information 1 = Do display
or renew on LMSs that do not
provide the facility to
accept/reject chargeable
transactions.
Determines whether a full screen
Display failure 0 = Do not display
ErrorPrompt List message is displayed to the user if 1
messages 1 = Do display
a borrow or renew fails

www.bibliotheca.com
liber8™ – configurations, page 27 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Determines whether system


AutoRestart after bin Auto restart after 0 = Remain in halted
List resumes operation after a full bin 1
full bin full 1 = Resume operation
has been emptied.
0 = No login required for
Determines whether user has to
return function
Login for Returns List Login for returns present their library card to use the 0
1 = Login required for
Returns screen.
return function
Determines whether the unit halts
Stop when bin 0 = Do not stop
StopOnBinFull List and displays Unit Unavailable 1
full 1 = Stop
message if the Return Bin is full.
Determines whether the unit halts
0 = Do not stop
Stop when no and displays Unit Unavailable
StopOnNoPaper List 1 = Stop 0
paper in printer message if the receipt printer runs
2 = Ask user to continue
out of paper.
Determines whether the unit halts
Stop when
0 = Do not stop and displays Unit Unavailable
StopOnLeftReceipt List receipt left in 0
1 = Stop message if the receipt printer has
printer
an old receipt left in it.
0 = Reject incomplete
Accept Determines whether incomplete
items
Accept all returns List incomplete items should be accepted for 0
1 = Accept incomplete
returned items return.
items
Determines whether incomplete
0 = Do not include returned items appear on the
Include incomplete items return receipt. If this is set to not
IncludeIncompleteRe
List incomplete show incomplete items and only 0
turns
returns on receipt 1 = Include incomplete incomplete items have been
items returned, then no receipt will be
printed.
0 = Do not keep log of
Log returned returned items Determines whether a log file is
Log returned items List 0
items 1 = Keep log of written recording all returned items
returned items
Returns logging Return logging Only valid if Log The file name of the returned items
String
filename filename returned items = 1 log

www.bibliotheca.com
liber8™ – configurations, page 28 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = RFID login not Determines whether logging in with


RFIDLoginEnabled List Allow RFID login allowed an RFID patron card is enabled or 0
1 = RFID login allowed not.
0 = No keyboard login
Determines whether a user can
Allow keyboard option
AllowKeyboardLogin List login using an on-screen keyboard 0
login 1 = Keyboard login
instead of a patron barcode card
option allowed
Determines whether return bin is
Unlock return bin 0 = Do not unlock return
Unlock Chute Door unlocked if return screen has
List if no items bin 0
early detected no items. This is used to
detected 1 = Unlock return bin
allow the return of untagged items.

0 = Do not perform This option determines whether a


check secondary check is performed on
Perform further
1 = Perform further available holds which compares
ReservationLocation location checks
List location check the current location of the item 1
Check on available
with the location of the Self-Service
reservations. 2 = Perform further machine or which verifies that the
circulation status check circulation status is ‘8’
This option determines how
available reservation information is
0 = Available
treated, and is required because
reservations sent as
Available different LMSs send the information
barcodes
AvailableResAsTitle List reservation in different formats. If the LMS sends 0
1 = Available
format available hold items as barcodes
reservations sent as
then set this option to 0. If the LMS
titles
sends available hold items as titles
then set this option to 1.
This option determines how
unavailable reservation information
0 = Unavailable is treated, and is required because
reservations sent as different LMSs send the information
Unavailable
barcodes in different formats. If the LMS sends
UnavailableResAsTitle List reservation 0
1 = Unavailable unavailable hold items as
format
reservations sent as barcodes then set this option to 0.
titles If the LMS sends unavailable hold
items as titles then set this option to
1.

www.bibliotheca.com
liber8™ – configurations, page 29 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

This option determines whether


Removed 0 = Do not remove any
trailing slash characters (‘/’ or ‘\’)
unwanted characters
RemoveTrailingSlash List or the colon (‘:’) are removed from 1
characters from 1 = Remove unwanted
item titles before displaying on the
end of item titles characters
screen or printing on a receipt
Number of seconds to delay start-
Startup delay up of program to allow other
StartUpDelay Integer 0
(seconds) applications or parts of OS to load
first
0 = No check
1 = Check based on
owner and location Specifies type of check to perform
2 = Check if time part to identify Short Term Loan items. If
of due date is 23:59 the check indicates the item is a
Short-Term-Loan 3 = Check if time part Short Term Loan, then the time will
ShortTermLoanCheck List 0
check of due date is 16:00 or be displayed beside the due date
11:00 on all screens and receipts
4 = Check if security (regardless of the date/time
type value is the same formatting settings).
as ShortLoanSecurity
setting
Only valid if
Short-Term-Loan Used to determine string that
ShortTermID String ShortTermLoanCheck
match string indicates a short term loan item.
=1
Determines whether a receipt is
BorrowReceiptOnTim Borrow receipt 0 = No receipt printed
List printed when the relevant screen 1
eout on timeout 1 = Receipt printed
times-out
Determines whether a receipt is
ReturnReceiptOnTim Return receipt on 0 = No receipt printed
List printed when the relevant screen 1
eout timeout 1 = Receipt printed
times-out
Determines whether a receipt is
RenewReceiptOnTim Renew receipt 0 = No receipt printed
List printed when the relevant screen 1
eout on timeout 1 = Receipt printed
times-out
Determines whether a receipt is
PaymentReceiptOnTi Payment receipt 0 = No receipt printed
List printed when the relevant screen 1
meout on timeout 1 = Receipt printed
times-out

www.bibliotheca.com
liber8™ – configurations, page 30 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Determines whether reserved items


Flag reserved 0 = Do not flag reserved
RenewalReservedFla are flagged with a ‘X’ on the
List items on renewal items 1
g renewals screen and are not
screen 1 = Flag reserved items
allowed to be selected
Determines whether the Return
Attention screen is enabled. This
screen is displayed after a return
transaction and shows a
configurable message if any of the
patrons that have returned items
have one or more of the following:
0 = Do not enable
ReturnAttentionEnabl Enable return - Outstanding fees
List screen 1
ed attention screen - Credit
1 = Enable screen
- Overdue items
- Reservations available to pickup
Which individual checks are
performed and which messages
are displayed is controlled by the
following 5 settings.
Include amount Determines whether a check is
owed in return 0 = Do not check done on amount owed when
RACheckDebit List 1
attention 1 = Check deciding whether to bring up the
message check return attention message
Include amount Determines whether a check is
in credit in return 0 = Do not check done on amount in credit when
RACheckCredit List 1
attention 1 = Check deciding whether to bring up the
message check return attention message
Include overdue Determines whether a check is
items in return 0 = Do not check done on overdue items when
RACheckOverdue List 1
attention 1 = Check deciding whether to bring up the
message check return attention message
Include available Determines whether a check is
reservations in 0 = Do not check done on available reservations
RACheckReservation List 1
return attention 1 = Check when deciding whether to bring
message check up the return attention message

www.bibliotheca.com
liber8™ – configurations, page 31 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Determines whether any LMS


Check for LMS
RACheckLMSMessag 0 = Do not check generated screen messages
List generated SIP2 0
e 1 = Check received during the return process
message
are displayed to the patron
Allow incomplete
BorrowAcceptIncom 0 = Do not allow Determines whether incomplete
List items to be 0
plete 1 = Allow items are allowed to be borrowed
borrowed
Determines the maximum number
of borrowed items a patron can
have for full Self Service
functionality to be allowed. If a
patron has more items borrowed
than this value, then the following
Maximum
restrictions will be applied:
MaxBorrowedItems Integer number of 20
borrowed items - Access to ‘Renewal’ facility will
be denied
- Access to ‘My Account’ facility
will be denied
- Only short receipt will be given in
‘Borrow’ screen
Require 0 = Do not require Determines whether confirmation is
Confirm Incomplete confirmation of confirmation required on borrowing incomplete
List 1
Borrow borrowing 1 = Require items (NB. If ErrorPrompt is switched
incomplete items confirmation off then confirmation will not show)
Determines the number of seconds
Tag set detection
TagSetDetectionTime to wait to find a complete tag set
Integer timeout 5
out after an incomplete tag set has
(seconds)
been detected
Allow return of 0 = Do not allow return Determines whether normal items
ReturnAllowNormal List 1
normal items 1 = Allow return will be accepted for return
Allow return of Determines whether short-term-
0 = Do not allow return
ReturnAllowShortTerm List short-term-loan loan items will be accepted for 1
1 = Allow return
items return
ReturnAllowNotOnLo Allow return of 0 = Do not allow return Determines whether not-on-loan
List 1
an not-on-loan items 1 = Allow return items will be accepted for return

www.bibliotheca.com
liber8™ – configurations, page 32 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Retry failed Determines whether to retry failed


0 = Do not retry
SecurityRetryFailed List security removal security removing on borrow 1
1 = Retry
on borrow screen
Prompt user Determines whether the user is
regarding failed 0 = Do not prompt user given prompts on the borrow
SecurityPromptUser List 1
security removal 1 = Prompt user screen relating to failed security
on borrow removal
Print information Determines whether printed
on failed security 0 = Do not print borrow receipts include
SecurityPrintResult List 1
removal on 1 = Print information on any failed security
borrow receipt removing
Some LMSs have a nominal fee
amount for items for technical
Fee amount that reasons where there is no actual
FeeThreshold Currency 0.00 - 999.99 0.00
indicates no fee fee. This setting allows Liber8 to
ignore fees of this amount and
below.
0 = No pay prompt
1 = Pay prompt with
‘Finish’ option. Determines the type of pay prompt
End of
2 = Pay prompt with message that comes up after
PayPrompt List transaction pay 0
‘Pay’ option. borrowing or renewing chargeable
options
3 = Pay prompt with items
‘Finish’ and ‘Pay’
options
0 = No pay prompt
1 = Pay prompt with
‘Continue’ option. Determines the type of pay prompt
Start of
2 = Pay prompt with message that comes up before the
PayPromptStart List transaction pay 0
‘Pay’ option. Borrow/Renew screen appears
options
3 = Pay prompt with when borrowing/renewing items
‘Continue’ and ‘Pay’
options

www.bibliotheca.com
liber8™ – configurations, page 33 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = Pay prompt shown Determines whether the pay


Pay prompt for
PayPrompt_Incurred for total charges prompt message comes up for
List all or incurred 1
ChargesCheck 1 = Pay prompt comes incurred charges only, or for
charges
up for incurred charges. outstanding charges
Determines whether check
performed on the patron barcode
0 = Do not perform length in order to decide if a
PatronBarcodeLengt Length check on
List check returned item needs attention. 1
hCheck patron barcodes
1 = Perform a check Option 0 should be used for patron
barcodes with length less than or
equal to 5 chars
0 = Do not perform a Determines the way the fee is
Two stage two stage borrow. retrieved when
TwoStageBorrow List 0
borrow enabled 1 = Perform a two stage borrowing/renewing a chargeable
borrow. item:
0 – for
Determines whether to use Host
Use of renew Checkout or Renew message for Type
0 = Use Checkout (Talis,
message for SIP2 message to confirm
message (11/12) Plus,
UseRenewCommand List confirming chargeable renewals. If the setting
1 = Use Renew Dynix)
chargeable is missing, different default value is
message (29/30)
renewals determined by Host Type value. 1–
This is for SIP2 connections only. other
wise
Use of renew 0 = Use Checkout Determines whether to use
UseRenewFIrstComm command for message (11/12) Checkout or Renew message for
List 0
and initial renew 1 = Use Renew initial renew request message. This
request message (29/30) is for SIP2 connections only.
0 = Leave personal
Remove personal details in logs Determines whether personal
StripPersonalDetails List 1
details from logs 1 = Remove personal details are stripped from all logs
details from logs
Receipt screen Determines how long the take
ReceiptScreenTimeO
Integer timeout receipt screen is shown for. Time is 4
ut
(seconds) set in seconds.

www.bibliotheca.com
liber8™ – configurations, page 34 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = Do not activate Determines whether to activate


Security action to
Re-enable Security List security the security on the tag, after 1
perform on return
1 = Activate security returning an item
Delay before
showing ‘Finish’ Determines the delay before the
SortFinishButtonDelay Integer button on return finish button on sort screen is 0
sort screen shown. Time is set in seconds
(seconds)
Determines how long the return
Timeout for return
sort screen is shown (in seconds)
SortTimeoutSeconds Integer sort screen 60
before it times out and continues
(seconds)
on to next screen.
0 = Accept rejected
Action when a Determines if the self-service kiosk
RefuseRejectedRetur returns
List return is rejected accepts returns that were originally 0
ns 1= Refuse rejected
by LMS rejected by the LMS
returns
0 = Do not show extra Determines whether extra sort
Sort display when
sort screen screen is shown on return for items
ShowFailedSort List items rejected by 0
1 = Show extra sort that failed to return and should not
LMS
screen be put into either bin
Sets match string for determining
which items can be returned
based on their ‘Permanent
Location’. This string can include
Permanent any literal characters and the ‘*’
location match wild character that will match any
ReturnAllowedMatch String *
string for allowed number of characters. Set this to ‘*’
returns to allow return of any items, set it to
a match string (e.g. ‘BEDFORD*’) to
allow only items with a matching
‘permanent location’ to be
returned.

www.bibliotheca.com
liber8™ – configurations, page 35 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Determines whether ‘Item


Information’ message should be
0 = Send Item Lookup sent after an item is detected on
Disable item
request the borrow screen, before a
BorrowDropItemInfo List lookup for each 0
1 = Do not send Item borrow request is done. Set this to 1
borrowed item
Lookup request if there are connection
performance issues and there is a
requirement to limit network traffic.
Determines whether ‘Item
Information’ message should be
0 = Send Item Lookup sent after an item is detected on
Disable item
request the return screen, before a return
ReturnDropItemInfo List lookup for each 0
1 = Do not send Item request is done. Set this to 1 if there
returned item
Lookup request are connection performance issues
and there is a requirement to limit
network traffic.
0 = No PIN entry is
required
1 = PIN entry is required
Perform age only for the first age- Only valid if Determines if PIN entry is required
AgeRestrictionCheck List 0
restriction check restricted item DropItemInfo =0 for borrowing age-restricted items.
2 = PIN entry is required
for each age-restricted
item
0 = Do not override
Override age Determines if ‘age restriction’
1 = Allow scanning Only valid when
AgeRestrictionOverri verification using verification process can be over-
List admin barcode to AgeRestrictionCheck 0
de administrator ridden by scanning an
override age >0
barcode administrator’s card
verification
0 = Do not display PIN
prompt
Display PIN 1 = Display PIN prompt Only valid if Determines if an informative
DisplayAgeRestriction message for with ‘OK’ button
List AgeRestrictionCheck message appears when an age- 0
Prompt age-restricted
2 = Display PIN prompt >0 restricted item is identified.
items
with ‘OK’ and ‘Cancel’
buttons

www.bibliotheca.com
liber8™ – configurations, page 36 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Determines whether summary


Show summary screen is shown at end of borrow
0 = Do not show
BorrowOverLimitSum of charges that process showing total amount of
List summary 0
mary prevented charges involved in any borrows
1 = Show summary
borrows that failed due to insufficient funds
on user’s account
Determines whether summary
Show summary screen is shown at end of renewal
0 = Do not show
RenewOverLimitSum of charges that process showing total amount of
List summary 0
mary prevented charges involved in any renewals
1 = Show summary
renews that failed due to insufficient funds
on user’s account
1 = Holds – available
reservations,
unavailable holds –
Format of unavailable
Determines how the LMS will send
reservation reservations
ReservationMode List the available and unavailable 1
counts sent by 2 = Holds – all
reservation counts
LMS reservations,
unavailable holds –
unavailable
reservations
Use SIP2 End 0 = Do not send Determines whether a SIP2 ‘End
UseEndPatronSession List Patron Session message Patron Session’ message is sent to 0
message 1 = Send message the LMS at the end of a transaction
Delay after
Only valid when Specifies the delay in milliseconds
PatronSessionEndDel sending SIP2 End
Integer UseEndPatronSession after sending SIP2 End Patron 0
ay Patron Session
=1 Session message to LMS
message
0 = Do not change Determines what happens to
AddSecurityOnBorro Add security on
List security security on items that fail the 1
wFail borrow failures
1 = Add security borrow process
Layout of 2-
Determines the order of buttons on
Button2Layout Integer button confirm 12
all 2-button confirm screens
screens

www.bibliotheca.com
liber8™ – configurations, page 37 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Layout of 3-
Determines the order of buttons on
Button3Layout Integer button confirm 123
all 3-button confirm screens
screens
Display
DisplayBibliographicD 0 – Don’t display Determines whether to display
List bibliographic 0
ata 1 – Display data bibliographic data for the items
data

Return alert sort bins

List of ‘Sort Bin’ values that


represent an item that should be
sorted into the exception bin when
returned, Each entry can be a
Sort bin numbers single value or a range. E.g.:
ReturnAlertSortBin<n> String that represent
ReturnAlertSortBin1 = 5
alerted items
ReturnAlertSortBin2 = 10-12
Would alert returned items if the
sort bin returned by the LMS was 5
or in the range 10 to 12.
Determines the circumstances
under which patron access to the
account option is blocked. The SIP
message returns a patron status
string that may contain ‘Y’ flags. If
the block mask contains a ‘1’ in
Mask for blocking the corresponding position the
AccountPatronBlock
String patron access to patron will be prevented from
Mask
account option logging on (example block mask =
11111111111111 which would block
access if any flag was set to ‘Y’). If
the block mask contains a 0 in the
corresponding position or the
(status string value is not ‘Y’ then
account access is permitted

www.bibliotheca.com
liber8™ – configurations, page 38 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Determines the circumstances


under which patron access to the
borrow option is blocked. The SIP
message returns a patron status
string that may contain ‘Y’ flags. If
the block mask contains a ‘1’ in
Mask for blocking the corresponding position the
BorrowPatronBlockM
String patron access to patron will be prevented from
ask
borrow option logging on (example block mask =
11111111111111 which would block
access if any flag was set to ‘Y’). If
the block mask contains a 0 in the
corresponding position or the
(status string value is not ‘Y’ then
borrow access is permitted
0 – No charge alert on Determines whether or not a
Charge alert on return dialog should be displayed to the
ChargeAlertOnReturn List 0
return 1 – Display charge alert patron if a charge is due on a
on return returned item
0 – Check OK field only
1 – Check RenewalOK
field only
Determines whether to check the
2 – Check OK and
Renew Result OK or RenewalOK fields (or both)
RenewResultMode List RenewalOK fields 0
Mode to indicate if a renewal has been
3 – Check OK or
successful
RenewalOK fields (if
either set then
successful renewal)
Determines whether or not
messages returned from the LMS
DisplayBorrowMessag Display Borrow 0 – Do not display
List on a successful borrow of an item 0
es Messages 1 – Display
should be displayed to the patron
or not.

www.bibliotheca.com
liber8™ – configurations, page 39 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Determines whether or not


messages returned from the LMS
DisplayReturnMessag Display Return 0 – Do not display
List on a successful return of an item 0
es Messages 1 – Display
should be displayed to the patron
or not.
Determines how many items can
Maximum
MaxOfflineBorrowCo be borrowed in a single session
Integer borrows when
unt when the kiosk is running in offline
offline
mode
This allows liber8 to request patron
information in batches of barcodes
to cope with situations where large
numbers of barcodes will be sent
Patron from the LMS. The default is 0 which
PatronInfoBatchSize Integer information means send all associated 0
batch size barcodes at the same time. To
reduce message size, set this
configuration to the number of
barcodes to be sent in each
batch.
Determines how to handle borrow
failures. If set to 1 (default) then will
0 – Do not send second always try to send second borrow
Send second borrow if no charge request regardless of whether there
FeeAckOnCheckoutF
List borrow request 1 – Send second is a charge reported in the borrow 1
ail
on borrow failure borrow regardless of failure response. If set to 0 then will
charge only send second borrow request if
a charge was reported in the
borrow failure response.
Determines whether an extra
Check the LMS 0 – Do not check LMS
check is done on the LMS
CheckLMSBeforeFun connection connection
List connection status before a 0
ction before function 1 – Do check LMS
function (e.g. Borrow, Return) is
start connection
started

www.bibliotheca.com
liber8™ – configurations, page 40 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Check SIP2 field Determines whether an extra


CheckDesensitizeFiel to determine if 0 = Do not check field check is done on SIP2 Desensitize
List 0
d security can be 1 = Check field field to decide whether security
removed can be removed
Check SIP2 field Determines whether an extra
to determine if 0 = Do not check field check is done on SIP2 Resensitize
CheckResensitizeField List 0
security can be 1 = Check field field to decide whether security
added can be added

Sort bin fields

SIP field used for


SortBinField<n> String SIP field used for sorting bin value CL
sorting bin value
0 = Use
ShortLoanSecurity value
for short loan items
RFID security determined by Determined what values should be
SecurityMode List ShortTermLoanCheck 0
mode used for setting item security
1 = Keep existing
security as reported by
RFID core
RFID security Determines the security that is norma
NormalSecurity String
setup - normal applied to normal RFID items l
RFID security Determines the security that is Shortlo
ShortLoanSecurity String
setup – short loan applied to short loan RFID items an
Determines how returned items are
handled. Normal returns (0) are
processed through reading the
0 = Normal returns barcodes from RFID or barcode
scanner. Open returns (1) allow
Type of return 1 = Open returns any items to be returned without
Return Type List 0
processing (smartlocker) reading the barcode – this is used
2 = smartblade for smartlocker return bins.
smartblade returns (2) are used
when attached to a smartblade
system.

www.bibliotheca.com
liber8™ – configurations, page 41 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 – show unknown tags


Ignoring on screen
If enabled any unrecognised tags
IgnoreUnknownTags List unrecognised 1 – don’t show 0
won’t show in the on-screen list
tags unknown tags on
screen
0 – return multiple items
at once If enabled any return items must be
Return items one
Return One By One List placed on the kiosk (and put in the 0
by one 1 – return items one by relevant bin) one at a time
one
0 = Not allowed to be
borrowed Determines whether multi-part sets
Allow borrow of
AllowBorrowMediaPa 1 = Allowed to be tagged with a single tag with part-
List single tag multi- 0
ckTag borrowed (optional index 0 are allowed to be
part sets
warning message borrowed
displayed)
0 = Not allowed to be
returned
Allow return of Determines whether multi-part sets
AllowReturnMediaPa 1 = Allowed to be
List single tag multi- tagged with a tag with part-index 0
ckTag returned (optional
part sets 0 are allowed to be returned
warning message
displayed)
Confirm 0 = Do not display Determines if a warning message is
Confirm Incomplete warning
List incomplete displayed if an incomplete item is 1
Return
returns 1 = Display warning presented for return.
Report on tag 0 = No reporting Specifies whether a report is
MigrationReporting List data model generated of the tag data model 0
migration 1 = Reporting enabled migration progress
Specifies whether overdue returns
0 = No highlighting are highlighted on the return
Flag overdue
FlagOverdueReturns List 1 = Highlighting screen by showing them in a 0
returns on screen
enabled different colour and with an
exclamation mark icon.

www.bibliotheca.com
liber8™ – configurations, page 42 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = Multiple items at Specifies whether the return screen


Return one by once allows multiple items to be
Return One By One List 0
one enabled 1 = One-at-a-time presented at once, or enforces
processing one-at-a-time processing

Show renew all 0 = No renew-all button Specifies whether a ‘Renew All’


BorrowShowRenewAll
List button on borrow 1 = Renew-all button button is shown at the bottom-left 0
Button
screen shown of the borrow screen.

Show renew all 0 = No renew-all button Specifies whether a ‘Renew All’


AccountShowRenew
List button on 1 = Renew-all button button is shown at the bottom-left 0
AllButton
account screen shown of the account detail screen.
0 = Do not show cost Determines whether a cost column
Show cost column
ShowRentalCost List is shown on the Borrow, Renew and 0
columns
1 = Show cost column Return screen tables.

Show reserved 0 = Don’t display date


column Determines whether the ‘reserved
ShowReservationsDat until dates on
List until’ date column is displayed in 0
e reservation 1 = Do display date the reservations screen.
screen column
0 = No return sorting
displayed
1 = Return sorting shown
Return sorting Determines how return sorting
SortScreen List on separate sort 1
mode information is displayed.
screens
2 = Return sorting shown
on return screen
0 = No account button
Show account on return screen Determines whether an account
ReturnShowAccountB
List button on return 1 = Account button button is displayed on the return 0
utton
screen displayed on return screen
screen

www.bibliotheca.com
liber8™ – configurations, page 43 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Specifies the number of items of a


Number of items
patron account that flags the
on account
account as too large to be
LargeAccountCount Integer 0 - 999 considered too 200
allowed into the ‘account’
large for
functionality. The Borrow option will
displaying
still work ok.

0 = Display in single text Specifies whether hold counts in


ReservationMessageF Hold count patron information box are
List 1 = Display in 2 0
ormat display mode displayed in single text or in 2
separate texts separate texts
Determines whether failed security
0 = Ignore security result
Sort failed items on return are put into the
when determining
SortFailedSecurityToE security items on exception bin (overriding any bin
List return bin 0
xceptions return to calculated from ILS information).
exceptions bin 1 = Put failed security
Note: this facility can only be used
items in exception bin
in RFID mode.
Determines how many times to
retry failed security on return:
Failed security
-1 = Keep trying until the
ReturnSecurityRetry Integer -1 - 99 retry attempts on -1
transaction ends
return
0 – 99 = Try this number of times
then give up

1.7 [OFFLINE]
The following configurations are stored in the SelfCheck.ini [OFFLINE] section and relate to offline functionality.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Specifies the duration of a loan


when processed off-line. A value of
Offline loan 0 indicates no offline processing is
Loan Duration Integer 0
duration permitted. In this case the unit will
become unavailable if the
connection to the SIP2 server is lost.

www.bibliotheca.com
liber8™ – configurations, page 44 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = Offline borrow not


Determines if the borrow option is
available
available when the machine is
Offline borrow 1 = Offline borrow Only available if Loan
OfflineBorrow List running in offline mode and also 1
enabled available on left side Duration > 0
specifies the position of the option
2 = Offline borrow
button
available on right side
0 = Offline return not
Determines if the return option is
available
available when the machine is
Offline return 1 = Offline return Only available if Loan
OfflineReturn List running in offline mode and also 2
enabled available on left side Duration > 0
specifies the position of the option
2 = Offline return
button
available on right side
Determines the default action (i.e.
0 = No default action which of the available buttons is
Default offline deemed to have been selected) if
DefaultOfflineAction List 1 = 1st button option 0
menu action a patron scans their card on the
2= 2nd button option main menu screen when in offline
mode

www.bibliotheca.com
liber8™ – configurations, page 45 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

1 = TALIS FTP, all other


LMS standard method
2 = TALIS SIP2 playback,
all other LMS standard
method
3 = Standard copy
using configured
filename
4 = Standard copy
using configured
filename+date/time for Determines the format in which the
uniqueness Only available if Loan
OfflineFileFormat List Offline file format offline transactions will be 1
5 = Run configurable Duration > 0
uploaded to the SIP2 server
script defined in
‘TransferScriptComman
d’ to transfer the file
6 = Always use SIP2
playback
7 = Always use ftp
transfer
8 = Alma proprietary
format file to be copied
manually
Keep offline 0 = Do not keep Determines whether the backup
Only available if Loan
UploadKeepFailures List transactions that transactions file keeps offline transactions that 1
Duration > 0
fail to upload 1 = Keep transactions failed to upload.
Specifies a location to archive the
offline transactions to after they
Offline archive Only available if Loan
UploadArchiveFile String have been uploaded to the LMS. If
location Duration > 0
this setting is left blank then no
archiving will be performed.
Specifies the file where off-line
Offline local Only available if Loan transactions will be stored until they backu
Filename String
filename Duration > 0 can be sent to the server. Can be p.txt
a relative or absolute path.

www.bibliotheca.com
liber8™ – configurations, page 46 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Specifies the TCP/IP address of the


IP address of Only available if Loan remote server that an off-line
RemoteServer String
remote server Duration > 0 transaction file will be transferred
to by FTP.
Specifies the ftp user name to use
ftp upload Only available if Loan when connecting to a remote
Username String
username Duration > 0 server to transfer the off-line
transaction file.
Specifies the ftp password to use
ftp upload Only available if Loan when connecting to a remote
Password String
password Duration > 0 server to transfer the off-line
transaction file.
Specifies the remote directory that
ftp target Only available if Loan
RemoteDirectory String the off-line transaction file should
directory Duration > 0
be transferred to.
Specifies the remote filename that
ftp target Only available if Loan
RemoteFilename String the off-line transaction file should
filename Duration > 0
be transferred to.
Remote agency Only available if Loan Used when creating offline backup
RemoteAgencyCode String
code Duration > 0 filename for GEAC plus.
OffLineAgencyBarco Offline agency Only available if Loan Used when creating offline backup
String
de barcode Duration > 0 file entries for GEAC plus.
0 = No restrictions on
borrowing Determines whether to restrict
RestrictOfflineBorrowi Restrict offline 1 = Restrict borrowing borrowing for RFID items that are
List when offline 0
ng borrowing programmed with a ‘restriction’
2 = Restrict borrowing flag.
when offline and online
Specified script to run to transfer
TransferScriptComma Script to transfer
String the offline backup file to the LMS
nd offline file
when ‘OfflineFileFormat’ is 5.

www.bibliotheca.com
liber8™ – configurations, page 47 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Determines whether offline


Auto upload 0 = Do not auto upload transactions are automatically
AutoLoadOnReconn
List offline file on uploaded when a kiosk can 0
ect 1 = Auto upload
reconnection reconnect to the LMS after a
period of running in offline mode
Determines whether liber8 will
0 = Use configurable calculate its own due date when
Offline due date text borrowing items offline, or if it will
OfflineCalculateDate List 1
method 1 = Use calculated due use configurable text instead of a
date due date on screen and on the
receipt
0 = Must connect to the
ILS before being able to Determines whether the upload
AutoConnectWhenU Auto connect use the ‘upload’ button button on the administration
List 0
pload when upload 1 = Can use the screen can be used even when
‘upload’ button to offline to connect and upload
connect and upload

1.8 [RECEIPT PRINTER]


The following configurations are stored in the SelfCheck.ini [RECEIPT PRINTER] section and relate to the functionality and formatting of printed receipts.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Determines whether or not the


receipt text should be printed in
the currently selected language. If
0 = Do not use current not then the texts are taken from
Use current
language the [RECEIPT PRINTER] section of
UseCurrentLanguage List language for 0
1 = Use current the Selfcheck.ini file (see key
receipt text
language definitions below). Otherwise they
are read from the relevant
language file according to
standard language processing

www.bibliotheca.com
liber8™ – configurations, page 48 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0=Never print receipt.


1=Always print receipt
2=Optional - user
chooses on finish
Print level for screen
3=Optional - user Specifies receipt printing level for
PrintLevelBorrow List borrow 1
chooses on separate borrow transactions
transactions
screen
4=Finish and Receipt
options both on Borrow
screen
0=Never print receipt.
1=Always print receipt
2=Optional - user
chooses on finish
Print level for screen
PrintLevelBorrowOfflin borrow 3=Optional - user Specifies receipt printing level for
List 1
e transactions in chooses on separate borrow transactions in offline mode
offline mode screen
4=Finish and Receipt
options both on Borrow
screen
0=Never print receipt.
1=Always print receipt
2=Optional - user
chooses on finish
Print level for screen
3=Optional - user Specifies receipt printing level for
PrintLevelReturn List return 1
chooses on separate return transactions
transactions
screen
4=Finish and Receipt
options both on Return
screen

www.bibliotheca.com
liber8™ – configurations, page 49 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0=Never print receipt.


1=Always print receipt
2=Optional - user
chooses on finish
Print level for screen
PrintLevelReturnOfflin return 3=Optional - user Specifies receipt printing level for
List 1
e transactions in chooses on separate return transactions in offline mode
offline mode screen
4=Finish and Receipt
options both on Return
screen
0=Never print receipt.
1=Always print receipt
2=Optional - user
chooses on finish
Print level for screen
3=Optional - user Specifies receipt printing level for
PrintLevelRenew List renew 1
chooses on separate renew transactions
transactions
screen
4=Finish and Receipt
options both on Renew
screen
0=Never print receipt.
1=Always print receipt
2=Optional - user
chooses on finish
Print level for screen
3=Optional - user Specifies receipt printing level for
PrintLevelStatus List status 1
chooses on separate status transactions
transactions
screen
4=Finish and Receipt
options both on Status
screen

www.bibliotheca.com
liber8™ – configurations, page 50 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0=Never print receipt.


1=Always print receipt
2=Optional - user
chooses on finish
Print level for screen
PrintLevelReservation 3=Optional - user Specifies receipt printing level for
List reservations 1
s chooses on separate reservations transactions
transactions
screen
4=Finish and Receipt
options both on
Reservation screen
Include ‘Back’
Determines whether the receipt
button on 0 = No ‘Back’ option
ReceiptBackOption List option screen includes a ‘back’ 1
receipt option 1 = ‘Back’ option
button.
screen
The title that will appear at the top Smart
Receipt Title String Receipt title
of every receipt in bold. Library
Specifies the font size to use for the
Font Size Integer 4 - 40 Font size 16
receipt text.
Specifies the number of receipt
Maximum items that will be printed at the
MaxItemsAtNormalSiz number of items point size defined in Font Size. For
Integer 1 - 999 26
e at normal font receipts containing more items, the
size font size will be determined by the
option FontSizeSmall.
Specifies the font size to use for
Reduced font receipts containing more items
FontSizeSmall Integer 4 - 40 8
size than specified in
MaxItemsAtNormalSize.
How to identify Determines whether (masked)
0 = Masked patron ID
NameInsteadOfID List patron at top of Patron ID or Patron Name is used 0
1 = Patron name
receipt at the top of receipts.
Number of Specifies how many lines of header
Header Lines Integer global header text will appear under the title on 0
lines every receipt

www.bibliotheca.com
liber8™ – configurations, page 51 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Header lines
Lines of header text to be printed
Header <n> String Header line
on each receipt.
Show time on 0 = No time printed Determines whether checkout time
Show Time List 0
receipts 1 = Time printed. is printed on receipts
0 = Date on same line
Print title and Determines whether to print the
as title
Date on new line List date on different date on a separate line to the item 0
1 = Date on separate
lines title on receipts
line
The position of the first X character
Start patron id Only valid if
Start Mask Integer used to mask the patron barcode 0
mask NameInsteadOdID = 0
id on receipts
The position of the last X character
End patron id Only valid if
End Mask Integer from the end used to mask the 4
mask NameInsteadOdID = 0
Patron barcode id on receipts
Determines whether ‘Borrow’ and
0 = Receipt lists items
‘Renew’ receipts print all the items
Extended from current session.
LongReceipt List currently on loan, or just the items 1
receipts 1 = Receipt lists all items
that were processed in the current
on loan
session
Column header Defines text used as column Item
Column Head Item String
text for item title header for item title columns Title
Column header Defines text used as column Due
Column Head Date String
text for due date header for due date columns Date
Column Header Defines text used as column Disc
Column Head Disc String
text for disc title header for disc title Title
Column Header
Column Head Defines text used as column Dispen
String text for disc
Dispenser header for disc dispenser ser
dispenser
Column header Defines text used as column
Column Head Availa
String text for header for reservation availability
Available ble
availability columns

www.bibliotheca.com
liber8™ – configurations, page 52 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Column header Defines text used as column


Column Header Pay
String text for charge header for charge description Item
Desc
description columns
Column header Defines text used as column
Column Header Pay
String text for charge header for charge amount Fee
Fee
amount columns
Defines text used as sub-headings
on borrow receipts. Can include Borro
Sub heading for the following codes: wed
Header Borrow String
borrow receipts Items
%d = Include current date
%d %t
%t = Include current time
Discs
Sub heading for
Defines text used as sub-headings to
Header Disc Borrow String disc borrow
on disc borrow receipts collec
receipts
t
Defines text used as sub-headings
on return receipts. Can include the Return
Sub heading for following codes: ed
Header Return String
return receipts Items
%d = Include current date
%d %t
%t = Include current time
Defines text used as sub-headings
on renew receipts. Can include the Rene
Sub heading for following codes: wed
Header Renew String
renew receipts Items
%d = Include current date
%d %t
%t = Include current time
Defines text used as sub-headings
on status receipts. Can include the Acco
Sub heading for following codes: unt
Header Status String
status receipts Status
%d = Include current date
%d %t
%t = Include current time

www.bibliotheca.com
liber8™ – configurations, page 53 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Defines text used as sub-headings


Sub heading for on reservations receipts. Can Reserv
Header Reservations String reservations include the following codes: ations
receipts %d = Include current date %d %t
%t = Include current time
Defines text used as sub-headings
on pay receipts. Can include the Self
Sub heading for following codes: Paym
Header Payment String
pay receipts ent
%d = Include current date
%d %t
%t = Include current time
Defines text used as sub-headings Canc
Sub heading for on payment cancellation receipts. elled
payment Can include the following codes:
Header PayCancel String Paym
cancellation
%d = Include current date ent
receipts
%t = Include current time %d %t

Defines text used as sub-headings


on Comprise SAM payment SAM
Sub heading for receipts. Can include the following charg
Header SAM String SAM payment codes:
receipts e %d
%d = Include current date %t
%t = Include current time
Please
take
this
Payment
Instructional text printed on a receip
Instruct PayCancel String cancellation
payment cancel receipt. t to
instructional text
the
helpd
esk
Number of footer
Number of lines in the footer of
FootBorrowLines Integer lines on borrow 0
borrow receipts.
receipts
Borrow footer lines

www.bibliotheca.com
liber8™ – configurations, page 54 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

FootBorrow <n> String Footer line Text of ‘borrow’ footer lines.


Number of footer
Number of lines in the footer of
FootReturnLines Integer lines on return 0
return receipts.
receipts
Return footer lines
FootReturn <n> String Footer line Text of ‘return’ footer lines.
Number of footer
Number of lines in the footer of
FootRenewLines Integer lines on renew 0
renew receipts.
receipts
Renew footer lines
FootRenew <n> String Footer line Text of ‘renew’ footer lines.
Number of footer
Number of lines in the footer of
FootStatusLines Integer lines on status 0
status receipts.
receipts
Status footer lines
FootStatus <n> String Footer line Text of ‘status’ footer lines.
Number of footer
lines on Number of lines in the footer of
FootReservationsLines Integer 0
reservations reservations receipts.
receipts
Reservations footer lines
FootReservations <n> String Footer line Text of ‘reservations’ footer lines.
Number of footer
Number of lines in the footer of
FootPaymentLines Integer lines on payment 0
payment receipts.
receipts
Payment footer lines
FootPayment <n> String Footer line Text of ‘payment’ footer lines.

www.bibliotheca.com
liber8™ – configurations, page 55 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

When running in hybrid (EM and


RFID) mode, this string will be
appended to the end of a title
Non-RFID item
BarcodeIdentifier string when printed on a receipt for items
flag
that were scanned in through the
barcode scanner as opposed to
read from an RFID tag.
Character to flag The character used on a receipt to
Incomplete Item
String incomplete items indicate the return of an *
Prefix
on receipts incomplete item
Defines text and format of string Amou
informing user of how much they nt
Text and format
AmountDebit String owe. Used on Borrow, Renew, Outsta
of amount owed
Status, Reservations and Pay nding:
receipts %m
Defines text and format of string
Amou
Text and format informing user of how much they
nt in
AmountCredit String of amount in are in credit. Used on Borrow,
Credit:
credit Renew, Status, Reservations and
%m
Pay receipts.
Amou
Defines text and format of string
Text and format nt
AmountPaid String informing user of how much they
of amount paid Paid:
have paid. Used on Pay receipts.
%m
Defines text and format of string Chan
Text and format
informing user of how much ge
AmountChange String of amount of
change they are due. Used on Pay Due:
change due
receipts. %m
Defines text and format of string Chan
Text and format
AmountChangeGive informing user of how much ge
String of amount of
n change they are given back. Used Given:
change given
on Pay receipts %m

www.bibliotheca.com
liber8™ – configurations, page 56 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Amou
Defines text and format of string
Text and format nt
informing user of how much money
AmountTendered String of amount Tende
they have entered. Used on Pay
tendered red:
receipts.
%m
0 = Only print titles
1 = Print barcode then
Print barcodes as Determines whether barcodes are
IncludeBarcodes List title 0
well as titles printed on receipts as well as titles
2 = Print title then
barcode
Include overdue 0 = Do not flag overdue Only valid if Determines whether text is printed
IncludeOverdueFlag List flag on return items IncludeBarcodes not on return receipts to indicate items 0
receipts 1 = Flag overdue items equal to 0 that were overdue
0 = Do not flag not-on-
Include not-on- Determines whether text is printed
IncludeNotOnLoanFl loan items
List loan flag on on return receipts to indicate items 0
ag 1 = Flag not-on-loan
return receipts that were not on loan
items
Text used to flag Text that will be printed alongside
Overd
ReturnTextOverdue String overdue items on overdue items on return receipts if
ue
return receipt IncludeOverdueFlag = 1.
Text that will be printed alongside
Text used to flag Not
ReturnTextNotOnLoa not-on-loan items on return
String not-on-loan items On
n receipts if IncludeNotOnLoanFlag =
on return receipt Loan
1
Normal payment text
Payment receipt Text of normal payment receipt
PayTextNorm<n> String
text free form text lines.
Overpayment text
Payment receipt Text of overpayment receipt free
PayTextOver<n> String
text form text lines.
Failed payment text
Payment receipt Text of failed payment receipt free
PayTextFail<n> String
text form text lines.

www.bibliotheca.com
liber8™ – configurations, page 57 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Show tendered 0 = Do not show


Determines whether tendered
amount on tendered amount
PayShowTendered List amount is printed on payment 1
payment 1 = Show tendered
receipts.
receipts amount
0 = Details, Total,
Order of Tendered (optional),
Determines the order of
information on Paid
PayReceiptOrder List information shown on payment 0
payment 1 = Tendered
receipts
receipts (optional), Paid, Details,
Total
Number of Indicates how many global footer
Footer Lines Integer global footer lines of text will appear below the 0
lines transaction footer
Footer lines
Lines of global footer text to be
Footer <n> String Footer line
printed on each receipt.
Flag for items Prefix printed against items on
that have been borrow receipt indicating items
BorrowNewPrefix String *
processed in that have been borrowed in
current session current session.
*
Description of Indica
Special footer added to borrow
flag for items that tes
receipts if any items have been
BorrowNewFoot String have been items
marked with ‘BorrowNewPrefix’
processed in borro
flag
current session wed
today
Flag for items Prefix printed against items on
BorrowSecPrefix String that had security borrow receipt indicating items !
problems where security was not removed.

www.bibliotheca.com
liber8™ – configurations, page 58 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

!
Indica
Description of
Special footer added to borrow tes
flag for items that
BorrowSecFoot String receipts if any items have been items
had security
marked with ‘BorrowSecPrefix’ flag with
problems
proble
ms
Flag for discs that Prefix printed against items on
BorrowUnqueuedPref
String could not be borrow receipt indicating discs that !
ix
dispensed could not be dispensed
!
Indica
Description of Special footer added to borrow tes
BorrowUnqueuedFoo flag for discs that receipts if any discs have been discs
String
t could not be marked with could
dispensed ‘BorrowUnqueuedPrefix‘ flag not be
retriev
ed
Determines whether to print the
PrintPaymentreceipt Print payment 0 = Do not print
List payment receipt number on 0
Number receipt number 1 = Print
payment receipts
Print amount Determines whether to print the
PrintAmountOnBorro 0 = Do not print
List owed on borrow credit or debit amount on borrow 1
w 1= Print
receipts receipts
Payment receipt
Text used to indicate chip and pin Card
text to indicate
ChipAndPinTxt String payments used on payment Paym
chip and pin
receipts ent:
payment
Payment receipt Text that describes the type of the
ChipAndPinCardNa Card
String text for type of chip and pin card used on
meTxt Type:
card payment receipts
Payment receipt
ChipAndPinCardNoT Text that describes the chip and Card
String text for card
xt pin card number. No:
number

www.bibliotheca.com
liber8™ – configurations, page 59 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Payment receipt
ChipAndPinExpiryDat Text that describes the expiry date Expiry
String text for expiry
eTxt of the chip and pin card Date:
date
Payment receipt
Text that describes the
ChipAndPinAuthCod text for Auth.
String authorisation code of a chip an pin
eTxt authorisation Code:
transaction
code
Payment receipt
ChipAndPinTerminalI Text that describes the terminal ID Termin
String text for terminal
DTxt of the chip and pin device. al ID:
ID
Amou
nt not
Payment receipt
taken
ChipAndPinInstructPa text used on Instructional text printed on failed
String from
yCancel failed chip and chip and pin transactions
bank
pin transactions
accou
nt
Payment receipt Applic
ChipAndPinApplicati Text that describes the Application
String text for ation
onIDTxt ID of a chip and pin transaction.
application ID ID:
Payment receipt Text that describes the merchant
ChipAndPinMerchant Merch
String text for merchant number of a chip and pin
NoTxt ant:
number transaction.
Payment receipt
text for issue Text that describes the issue PAN
ChipAndPinIssueNoTx
String number or PAN number or PAN sequence number Seq
t
sequence of a chip and pin transaction. No:
number
Payment receipt Chan
Instructional text printed on a
InstructChangeDispe text used when ge
String payment cancel receipt when
nsed change Dispen
change is given back.
dispensed sed
Reconciliation Specifies the font size to use for the
RecReportTitleFontSiz
Integer 4 - 40 report title font title and footer of the reconciliation 14
e
size report.

www.bibliotheca.com
liber8™ – configurations, page 60 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Reconciliation Specifies the font size to use for the


RecReportColHeader
Integer 4 - 40 report header column titles of the reconciliation 12
FontSize
font size report.
Reconciliation Specifies the font size to use for
RecReportDetailFont
Integer 4 - 40 report detail font each payment line of the 10
Size
size reconciliation report.
Reconciliation Specifies whether the payment
RecRptDetailFontBol 0 = Normal
List report detail font lines of the reconciliation report are 0
d 1 = Bold
style printed in bold
"C"
Explanatory text printed on the indica
Reconciliation
RecReportCashChan reconciliation report about the tes
String report key for
geKey symbol which is used to indicate cash
cash change
cash change. chang
e
"R"
indica
Explanatory text printed on the
Reconciliation tes
RecReportReceiptCh reconciliation report about the
String report key for receip
angeKey symbol which is used to indicate
receipt change t
receipt change.
chang
e
Paid
by
Text explaining Smart
the remaining e- Text that describes the remaining Card,
EPaymentBalanceTxt String
balance on a e-balance on a smart card. e-
smart-card balan
ce
left:
Name of device that allows
Name of card
CardPrinterName String printing of receipts to printable
printer device
patron cards.

www.bibliotheca.com
liber8™ – configurations, page 61 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

There
was a
proble
m with
your
paym
Payment ent.
Text explaining that a problem
TransactionError String transaction error Please
occurred during payment
text take
your
receip
t to a
memb
er of
staff.
Logo settings
Path to a bitmap Path to a bitmap that can be used
Logo<n> String Only BMP files
file for printing on the receipts.
Required width of the bitmap in
Required width
pixels. If 0 the width of the bitmap is
LogoWidth<n> Integer 0–n of the bitmap in 0
determined by LogoStretch<n>
pixels
value.
left
Horizontal
LogoAlign<n> List center Horizontal alignment of the bitmap left
alignment
right
Indicates 0 = don’t stretch the
Indicates whether to stretch the
whether to bitmap Only valid when
LogoStretch<n> List image to the page width or to use 1
stretch the 1 = stretch bitmap to LogoWidth<n> = 0
actual bitmap width
image the page width
Specify the logo
Choose which one from defined
to be printed at
HeaderLogo List Logo<n> E.g. Logo1 logos to be printed at the top of
the top of the
the receipts.
receipt

www.bibliotheca.com
liber8™ – configurations, page 62 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Specify the logo


Choose which one from defined
to be printed at
FooterLogo List Logo<n> E.g. Logo2 logos to be printed at the top of
the bottom of
the receipts.
the receipt
Text to print on
Text printed in place of a date if Invalid
EmptyDateText String receipt if date is
the date value is invalid Date
invalid
Indicates the minimum receipt
Minimum receipt
MinReceiptLength Integer 0–n length to be printed. Useful when 0
length in mm
receipt can’t reach the output.
Date format for Specifies the date format to be
due dates used when printing due dates on
DateFormat String
printed on receipts. If left blank the system
receipts short date will be used.
Text indicating
Text indicating reserved item is
ReservationAvailable String reserved item is Yes
available
available
Text indicating
ReservationUnavaila Text indicating reserved item is not
String reserved item is No
ble available
not available
When a payment receipt is printed
after paying with a credit card, this
option allows for the credit card
0 = Don’t include credit part of the receipt to either be
card information included in the payment receipt
Include credit 1 = Include credit card generated by liber8 (option 1), be
PrintCardTransaction
List card information information received from the payment 1
Details
on receipt 2 = Receive credit card provider and printed as-is (option
receipt information 2), or be excluded for installations
from provider and print where the payment provider
software prints a credit card
receipt independently of liber8
(option 0).
Column header
Defines text used as column locker
Column Head Locker String text for locker
header for locker number columns #
number

www.bibliotheca.com
liber8™ – configurations, page 63 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Defines text used as sub-headings


on smartlocker receipts. Can colle
Sub-heading for
include the following codes: cted
Header Locker String smartlocker
receipts %d = Include current date items
%d %t
%t = Include current time
items
Section header
Header Locker Defines text to use in the section to
String for items to
Items header for items to collect colle
collect
ct
Paid
by
eCar
ECard balance Defines text to display to show d,
ECardBalanceText String
text ECard balance curre
nt
balan
ce:
Amou
nt not
taken
from
EPaymentInstructP Epayment Text displayed on epayment
String your
ayCancel cancel text receipt when payment cancelled
acco
unt
balan
ce

www.bibliotheca.com
liber8™ – configurations, page 64 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Amou
nt not
taken
from
ECardInstructPayC ECard cancel Text displayed on ecard receipt
String your
ancel text when payment cancelled
eCar
d
balan
ce
“C"
indic
RecReportRefundC Reconciliation Text on reconciliation report that
String ates
hangeKey report refund key shows key of used letters
refun
d
0 = Do not print line
numbers on receipts
Include item Determines whether to print line
ItemsNumberList List 1 = Print line numbers 0
numbers numbers on item lists on receipts
whenever there are lists
of items on receipts
Determines the amount of vertical
space left between each line in an
item list on a receipt. This can be
ItemsLineSpace Number 0-1 Item line spacing
any number between 0 and 1. E.g.
0
0.25 will leave a quarter of a line
space between each item.
0 = Do not print ‘total
number of items’ line. Determines whether a ‘total
Include item
ItemsTotal List number of items’ line is printed at 0
total line 1 = Print ‘total number the bottom of item lists on receipts.
of items’ line

www.bibliotheca.com
liber8™ – configurations, page 65 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Text to use when ‘ItemsTotal’


setting = 1 to format the line
displaying the total number of
items. This should be set to a string
containing any text required along No of
ItemsTotalText String Items total text with ‘%d’ which will be replaced Items:
by the number of items in the list. %d
This setting will be used if there is no
equivalent setting in the language
configuration files.
0 = No charge
breakdown on receipt
1 = Charge breakdown
Determines the type of charge
PaymentBreakdow Payment receipt of remaining charges
List breakdown shown on the payment 0
n breakdown on receipt
receipt.
2 = Charge breakdown
of paid charges on
receipt
ShowReceiptScree Show receipt 0=Do not show screen Determines if ‘printing receipt’
List 1
n printing screen 1=Show screen screen is shown
0 = Do not print media
Include media type on receipts Determines whether the media
IncludeMediaType List 0
type on receipts 1 = Print media type on type is printed on receipts
receipts
Determines whether item costs are
0 = Do not print item
printed on receipts.
Include cost on costs on receipts
IncludeRentalCost List Note: This is independent of the 0
receipts 1 = Print item costs on
total amount owed that is printed
receipts
at the end of a receipt

www.bibliotheca.com
liber8™ – configurations, page 66 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Determines the number of lines to


wrap a title on a receipt before
Maximum
truncating it. Setting this to 0 means
number of lines
MaxTitleLines Integer 0 - 99
to wrap titles
allow to wrap onto as many lines 0
as required. Any number > 0
onto on receipts
specifies the number of lines to
wrap onto before truncating.

www.bibliotheca.com
liber8™ – configurations, page 67 of 175

1.9 [MESSAGES]
The following configurations are stored in the SelfCheck.ini [MESSAGES] section and relate to the free text messages returned by the LMS.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Too
Message to match in borrow many
LMS message for ‘too
PatronMessageItems String response from LMS to indicate ‘too items
many items on loan’
many items on loan’ situation. on
loan
You
have
LMS message for Message to check for in borrow excee
PatronMessageCharges String ‘exceeded charge response to indicate ‘exceeded ded
limit’ charge limit’ situation. your
fine
limit
%s represents the actual screen
message from AF field Formats the way LMS generated
Login screen message  \13 represents line break screen messages are displayed on
LoginMessageFormat String
display format  To disable screen message set the screen when patron login attempt
value to ANY text without %s fails.
parameter
%s represents the actual screen
message from AF field
Borrow screen Formats the way LMS generated
BorrowMessageFormat String message display  \13 represents line break screen messages are displayed
format  To disable screen message set the during borrow process.
value to ANY text without %s
parameter
%s represents the actual screen
message from AF field
Renew screen Formats the way LMS generated
RenewMessageFormat String message display  \13 represents line break screen messages are displayed
format  To disable screen message set the during renew process.
value to ANY text without %s
parameter

www.bibliotheca.com
liber8™ – configurations, page 68 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

%s represents the actual screen


message from AF field
Return screen Formats the way LMS generated
ReturnMessageFormat String message display  \13 represents line break screen messages are displayed
format To disable screen message set the during return process.
value to ANY text without %s
parameter
Messages
LMS message for
Message<n> String Translation for LMS message
translation
%s represents the actual screen
message from AF field Formats the way LMS generated
Patron summary LMS  \13 represents line break screen messages are displayed on
PatronMessageFormat
message format To disable screen message set the patron information summary
value to ANY text without %s screen.
parameter

1.10 [DATE FORMAT]


The following configurations are stored in the SelfCheck.ini [DATE FORMAT] section and relate to the format of dates returned by the LMS.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

The position in the date string of


Day Start Integer 0 - 99 Day start character 1
the day of the month.
Number of characters used to
Day Length Integer 0 - 99 Day length 2
represent the day of the month
The position in the date string of
Month Start Integer 0 - 99 Month start character 4
the month.
Number of characters used to
Month Length Integer 0 - 99 Month length 2
represent the month.
The position in the date string of
Year Start Integer 0 - 99 Year start character 7
the year.
Number of characters used to
Year Length Integer 0 - 99 Year length 4
represent the year.

www.bibliotheca.com
liber8™ – configurations, page 69 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

The position in the date string of


Hour Start Integer 0 - 99 Hour start character 0
the hour.
Number of characters used to
Hour Length Integer 0 - 99 Hour length 0
represent the hour.
The position in the date string of
Minute Start Integer 0 - 99 Minute start character 0
the minute.
Number of characters used to
Minute Length Integer 0 - 99 Minute length 0
represent the minute.
Second start The position in the date string of
Second Start Integer 0 - 99 0
character the second.
Number of characters used to
Second Length Integer 0 - 99 Second length 0
represent the second.
The position in the date string of
AMPM Start Integer 0 - 99 AMPM start character 0
the AMPM indicator.
Number of characters used to
AMPM Length Integer 0 - 99 AMPM length 0
represent the AMPM indicator.
0 = 12 hour Determine whether to operate as a
Clock type List Clock type 1
1 = 24 hour 12 hour or 24 hour clock
dd/m
Display Date Determines the format of date
String Display date format m/yyy
Format strings. E.g.: dd/mm/yyyy
y
Display Time Determines the format of time
String Display time format
Format strings. E.g.: hh:nn
0 = By host-type
Determines how to decode
Date/time decoding 1 = By configurations
ForceFormat List 0-3 date/times sent by LMS through 0
of LMS dates 2 = Built-in conversion
SIP2
3 = Custom format

www.bibliotheca.com
liber8™ – configurations, page 70 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Specifies custom format of


date/time sent in SIP2 messages
from LMS
Only valid d – day, M – month, y – year, h – dd/M
Custom date/time when hour, n – minute, s – second M/yyy
CustomFormat String
format ForceFormat Examples: y
=3 hh:nn
d/M/yyyy,hh:nn = 24/3/2001,12:43
dd/MM/yy hh:nn = 24/03/11 12:43
dd MMM yyyy = 24 Mar 2011
Custom format for date fields in
SIP2 checkout messages.
d – day, M – month, y – year, h –
CheckOutDateFo Custom format for hour, n – minute, s – second
String
rmat checkout messages Examples: d/M/yyyy,hh:nn =
24/3/2001,12:43 dd/MM/yy hh:nn =
24/03/11 12:43 dd MMM yyyy = 24
Mar 2011
Custom format for date fields in
SIP2 item information messages.
d – day, M – month, y – year, h –
ItemInfoDateFor Custom format for hour, n – minute, s – second
String
mat item info messages Examples: d/M/yyyy,hh:nn =
24/3/2001,12:43 dd/MM/yy hh:nn =
24/03/11 12:43 dd MMM yyyy = 24
Mar 2011

www.bibliotheca.com
liber8™ – configurations, page 71 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Determines whether non-date


strings are allowed in SIP2 date
fields.
0 = Non-date strings not allowed in
0 = Non-date strings not allowed in date fields. Any invalid dates will
date fields produce the message ‘Invalid
AllowWordInDate
List Date’ 0
Format 1 = Non-date strings are allowed in
date fields 1 = Non-date strings are allowed. If
the contents of a date field are not
a valid date string, then the
contents will be displayed on-
screen and on the receipt without
change.

1.11 [DIAGNOSTIC LOGGING]


The following configurations are stored in the SelfCheck.ini [DIAGNOSTIC LOGGING] section and relate to the logging of diagnostic information.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Location of log Determines the location of


Location String Diag
files diagnostic log files.
Number of
Determines the number of historic
MaxHistory Integer 1 - 99 historic log files 30
diagnostic log files to be kept.
kept
Maximum size of
Maximum size of diagnostic file
MaxSize Integer 0-∞ single log file 4096
(in kB)
(in kB)
Internal MEI Only valid when
0 = Off Switches on/off the logging in
MEILogging List CF7000 API CoinMechanismPrese 0
1 = On “CF7000 API.dll”
logging nt = 3
Switches on/off detailed logging of
CF7000 wrapper Only valid when all operations and communication
0 = Off
WrapperLogging List DLL detailed CoinMechanismPrese with MEI API. It generates log files 1
1 = On
logging nt = 3 separate from Liber8 diagnostic log
files.

www.bibliotheca.com
liber8™ – configurations, page 72 of 175

1.12 [GUI]
The following configurations are stored in the SelfCheck.ini [GUI] section and relate to the on-screen interface.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Show mouse 0 = Not visible Determines whether mouse


Show Pointer List 0
pointer 1 = Visible pointer is visible
UI application Path to User Interface
UIApplication String ..\UI\Liber8.UI.exe
path application
Port for communications with UI
UIPort Integer UI port 6000
application
Determines whether flag should
Show single 0 = Not visible
ShowSingleFlag List be visible if only one language 1
language flag 1 = Visible
is used
0 = Windows taskbar
not visible Determines whether the
Show Taskbar List Show taskbar Windows taskbar is visible while 0
1 = Windows taskbar liber8 is running or not
visible
Determines which monitor
number the liber8 UI is displayed
on. The monitor numbers used
Monitor number
Monitor Integer 1,2 are the ones displayed in 1
to use
Windows display properties
dialogs. These start from 1 (not
0).

www.bibliotheca.com
liber8™ – configurations, page 73 of 175

1.13 [SELF PAYMENT]


The following configurations are stored in the SelfCheck.ini [SELF PAYMENT] section and relate to the Self Payment functionality.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

1 = Demo database
format
2 = Talis (standard)
format
3 = ExLibris - Aleph
format
4 = Dynix - Horizon
format
5 = Infor - Vubis format
6 = SIRSI-Dynix -
Unicorn/Symphony
format
7 = Talis (individual fee
payment) format
8 = DS - Galaxy format
9 = ISOxford - Heritage Determines format of charge
Self Payment
format information sent by LMS and
PaymentMode List implementation 7
10 = Bibliomondo - payment processing rules
provided by LMS
Concerto format implemented by LMS
11 = Civica – Spydus
format and Innovative –
Millennium format
12 = ExLibris – Voyager
format
13 = Infor Vubis
(individual fee
payment)
14 = Polaris (standard)
15 = VTLS – Virtua
16 = Polaris Ex
(individual fee
payment)
17 = TLC CARL.X

www.bibliotheca.com
liber8™ – configurations, page 74 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Position of Fee This configuration is only valid when


Type in charge 1= Middle of AV field Only valid if PaymentMode = 6 and it
CategoryPosition List 2
breakdown sent 2= End of AV field PaymentMode = 6 determines the position of the fee
by LMS type inside the AV field
Determines how overpayments are
handled.
Note 1: If the coin mechanism can
1 = Send amount owed
give change then change will
to LMS, print credit note
always be given in the form of
2 = Send amount
Overpayment cash if possible. Only if the coin
ChangeMode List entered to LMS, no 1
action. mechanism is not able to give
credit note
change will this setting determine
3 = Send amount owed
how the remaining overpayment is
to LMS , no credit note
handled.
Note 2: If using prepay feature
then this setting must be set to 2.
"SC1"y
Determines the format of the
Format of ymmd
PaymentTranID String transaction ID generated for each
transaction ID dhhnn
payment transaction.
ss
Number of seconds to wait for coin
Coin initialisation mechanism to initialise. If it has not
CoinInitTime Integer 1 - 59 59
time (seconds) initialised after this time, then
payment feature is disabled.
Data grid settings
Start position of Specifies the start position of each
charge column of data in the payment
GridDataStart<n> Integer 1 - 999 1
breakdown data detail message returned by the
field LMS
Specifies the length of each
Length of charge
column of data in the payment
GridDataLength<n> Integer 1 - 999 breakdown data 1
detail message returned by the
field
LMS

www.bibliotheca.com
liber8™ – configurations, page 75 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Format for fee


Format for displaying fee items that
FormatForFees String items that are %m
are debits.
debits
Format for fee
Format for displaying fee items that
FormatForCredits String items that are %m CR
are credits.
credits
Format for total Format for displaying total fees
FormatForTotal String %m
fees outstanding.
1 = Date, Patron,
Amount, Change, LMS
Accept
Payment
2 = Date, Patron, Trans Specifies mode of payment
ReconMode List reconciliation 1
ID, Amount, Success reconciliation report
report format
3 = Date, Patron, Trans
ID, Amount, Success,
Cat
Reconciliation report column settings
Reconciliation Text displayed as heading for each
ReconHead<n> String report column column on payment reconciliation
heading report
Reconciliation
Horizontal position of each column
ReconPos<n> Integer 1 - 999 report column
on payment reconciliation report
position
Fee categories
Fee category
FeeCatCode<n> String Fee category code sent by LMS
code
Short description for fee category
Fee category
FeeCatShort<n> String for displaying in reconciliation
short description
report detail section.
Long description for fee category
Fee category
FeeCatLong<n> String for displaying in reconciliation
long description
report summary section.

www.bibliotheca.com
liber8™ – configurations, page 76 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Category display settings


Category
CategoryFrom<n> String Category used by the LMS.
conversion from
Category Category to be displayed to the
CategoryTo<n> String
conversion to user.
Location to move payment
transaction log entries to once
they have been printed on a
reconciliation report. If this setting is
blank, then the archived
transactions will be stored on the
Archive location
PaymentArchiveLoc local machine in the same
String for reconciliation
ation directory as the live transactions in
logs
a file called SPArchive.log. If this
setting contains a path, then the
archived transactions will be stored
in the given location in a file as
follows: [unit
name][date][time].log.
Determines the maximum number
Reconciliation
of lines to print on each page of
LinesPerPage Integer 1 - 999 report lines per 90
the reconciliation report. Default =
page
90.
Disallowed coins
0.01 = 0.01
0.02 = 0.02 Coin that will not be accepted for
0.05 = 0.05 payment.
0.1 = 0.1
DisallowedCoin<n> List Coin This setting only affects EMP coin
0.2 = 0.2
0.5 = 0.5 mechanisms (used in SmartServe
1=1 kiosks).
2=2

www.bibliotheca.com
liber8™ – configurations, page 77 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

1 – Cash
Payment 2 – Chip and Pin Add lookup values to Indicates what payment methods
PaymentMethod Flags methods 4 – e-Payments 1
use multiple methods the kiosk will accept.
available
8 - ECard
Chip and Pin
ChipAndPinMinimu Minimum amount for a Chip and
Currency 0.00 - 999.99 minimum 0.10
m Pin transaction.
transaction
Chip and Pin Amount in addition to the amount
ChipAndPinAddition
Currency 0.00 - 999.99 additional owed that can be paid in a single 0.00
al
amount Chip and Pin transaction.
Chip and Pin
ChipAndPinMaximu Maximum amount for a Chip and
Currency 0.00 - 999.99 maximum 10.00
m Pin transaction.
transaction
Valid only with coin mechs that
Change required can dispense change.
in hoppers to Minimum amount of change that
ExactChangeLimit Currency 0.00 - 999.99 stop “Exact should exist inside the change 0.00
change only” tubes so that the ‘Use exact
message change’ message doesn’t come
up on the pay screen.
Note 12 = 12p Specifies the amount the user is
NoteOverpaymentA
Integer 0+ overpayment 100 = £1 allowed to overpay by, without the 0
mount
amount 750 = £7.50 note being returned (pence).
0 = Note will not be
Allow £5 note to
accepted Specifies whether £5 notes are
EnableNote1 List be accepted by 1
1 = Note will be accepted by the note acceptor.
kiosk
accepted
0 = Note will not be
Allow £10 note to
accepted Specifies whether £10 notes are
EnableNote2 List be accepted by 1
1 = Note will be accepted by the note acceptor.
kiosk
accepted
0 = Note will not be
Allow £20 note to
accepted Specifies whether £20 notes are
EnableNote3 List be accepted by 0
1 = Note will be accepted by the note acceptor.
kiosk
accepted

www.bibliotheca.com
liber8™ – configurations, page 78 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = Note will not be


Allow £50 note to
accepted Specifies whether £50 notes are
EnableNote4 List be accepted by 0
1 = Note will be accepted by the note acceptor.
kiosk
accepted
0 = Note will not be
Allow note 5 to Specifies whether note
accepted
EnableNote5 List be accepted by denomination 5 notes are 1
1 = Note will be
kiosk accepted by the note acceptor
accepted
0 = Note will not be
Allow note 6 to Specifies whether note
accepted
EnableNote6 List be accepted by denomination 6 notes are 1
1 = Note will be
kiosk accepted by the note acceptor
accepted
1 = 5, 10, 20, 50, 100,
200 Specifies the set of denominations
Denomination
NoteDenominations List 2 = 1, 2, 5, 10, 20, 50 of notes that is supported by the 1
pattern for notes
3 = 10, 20, 50, 100, 200, note acceptor hardware.
1000
Specifies how much money can
be stored in the money box before
Money box limit
MoneyBoxLimit Integer 0 - 999 a warning is generated via 100
(pounds)
SmartAdmin. This limit is defined in
pounds.
Specifies whether extra
Extra 0 = No extra
confirmations are brought up after
confirmations confirmations required
PayConfirmation List the ‘Pay’ button or ‘Cancel’ 1
after Pay or 1 = Extra confirmations
button is pressed on the Pay
Cancel pressed required
Screen
Amount of money that can be
credited to account to be used to
pay future charges. If set to 0.00
0.00 – Pre-payment then prepay feature turned off. If
PrePayLimit Currency 0.00
999.99 amount allowed set to >0.00 then prepay is
switched on. Note that if using
prepay then ‘ChangeMade’
setting must be set to 2.

www.bibliotheca.com
liber8™ – configurations, page 79 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = Ignore Annual Fees


Order of
1 = Pay annual fees first Specifies if annual fees are paid
AnnualFeesMode List Payment for 0
2 = Pay non-annual and in which order
annual fees
fees first
Amount of change in coin recycler
Low change for
LowCoinsLevel Currency that indicates ‘low on change’ 0.0
coins
event.
Amount of change in note recycler
Low change for
LowNotesLevel Currency that indicates ‘low on change’ 0.0
notes
event.
Default coins
Only for Innovative Default coins float level used in
DefaultCoinsFloat Currency float level used in 0.00
payment device admin screen
admin screen
Default notes
Only for Innovative Default coins float level used in
DefaultNotesFloat Currency float level used in 0.00
payment device admin screen
admin screen
Determines whether the option is
given to allow the patron to type in
the amount of cash they will be
Allow partial 0 = Do not give option entering before they start inserting
PartialCashPayment List 0
cash payments 1 = Give option it. This allows patrons to pay off a
lower amount than they owe even
if they don’t have the correct
change.
Determines whether partial card
payment are allowed to be made
0 = Full amount only
Allow partial or if the full amount must be paid
PartialCardPayment List 1 = Partial card off. 1
card payments
payments allowed
Note: This only affects payments by
card.

www.bibliotheca.com
liber8™ – configurations, page 80 of 175

1.14 [LANGUAGE]
The following configurations are stored in the SelfCheck.ini [LANGUAGE] section and relate to the languages offered on the main screen.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = Do not reset to default


Reset to default Determines whether the system is
language
ResetEnabled List language reset to the default language after 1
1 = Reset to default language
automatically a time-out period.
after timeout
Only valid if Specifies the number of seconds
Language reset
ResetTimer Integer 1 - 59 ResetEnabled for the language reset time-out 10
timer (seconds)
=1 period.

www.bibliotheca.com
liber8™ – configurations, page 81 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Language list
Arabic = Arabic
Bengali = Bengali
ChineseSimplified =
ChineseSimplified
ChineseTraditional =
ChineseTraditional
Czech = Czech
Dutch = Dutch
English UK = English
English US = EnglishUS
Farsi = Farsi
French = French
German = German
Gujarati = Gujarati
Hindi = Hindi
Hmong = Hmong
Hungarian = Hungarian
Italian = Italian Specifies the languages that will be
LanguageName_<n> List Language name English
Japanese = Japanese available to kiosk users
KurdishSorani = KurdishSorani
Latvian = Latvian
Lithuanian = Lithuanian
Nepali = Nepali
Polish = Polish
Portuguese = Portuguese
Punjabi = Punjabi
Romanian = Romanian
Russian = Russian
Slovak = Slovak
Somali = Somali
Spanish = Spanish
Tamil = Tamil
Turkish = Turkish
Urdu = Urdu
Vietnamese = Vietnamese
Welsh = Welsh

www.bibliotheca.com
liber8™ – configurations, page 82 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = Audio facility disabled Determines whether the audio


Language audio
LanguageAudio_<n> List facility is enabled or disabled for 0
facility 1 = Audio facility enabled this language

1.15 [THEME]
The following configurations are stored in the SelfCheck.ini [THEME] section and relate to the themes.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Determines the chosen Liber8


Theme String Main theme Blue
theme
Additional themes
Name of sub theme. Sub themes
allow users to switch to another
ThemeSub<n> String Sub theme name
theme using a button on the
options screen of the main theme.
0 = Do not reset to main
Reset to main Determines whether the system is
theme
ResetEnabled List theme reset to the main theme after a 1
1 = Reset to main
automatically time-out period.
theme after timeout
Specifies the number of seconds
Only valid if
ResetTimer Integer 1 - 59 Reset Timeout for the theme reset time-out 10
ResetEnabled = 1
period.

www.bibliotheca.com
liber8™ – configurations, page 83 of 175

1.16 [MERGED ACCOUNT]


The following configurations are stored in the SelfCheck.ini [MERGED ACCOUNT] section and relate to the Merged Account feature that lets users log in once
then get access to multiple functions.

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = Unavailable
1 = Available as 1st
button
Merged Account Determines the availability and
2 = Available as 2nd
- Account position of the function button on
ShowAccount List button 0
function the Merged Account sub-menu
3 = Available as 3rd
availability screen
button
4 = Available as 4th
button
0 = Unavailable
1 = Available as 1st
button
Merged Account Determines the availability and
2 = Available as 2nd
- Reservations position of the function button on
ShowReservations List button 1
function the Merged Account sub-menu
3 = Available as 3rd
availability screen
button
4 = Available as 4th
button
0 = Unavailable
1 = Available as 1st
button
Determines the availability and
Merged Account 2 = Available as 2nd
position of the function button on
ShowRenew List - Renew function button 2
the Merged Account sub-menu
availability 3 = Available as 3rd
screen
button
4 = Available as 4th
button

www.bibliotheca.com
liber8™ – configurations, page 84 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = Unavailable
1 = Available as 1st
button
Determines the availability and
Merged Account 2 = Available as 2nd
position of the function button on
ShowPay List - Pay function button 3
the Merged Account sub-menu
availability 3 = Available as 3rd
screen
button
4 = Available as 4th
button
Determines how long the Merged
Account sub-menu screen is
Timeout for
displayed without any user
TimeoutSubMenu Integer 0 - 999 Merged Account 30
interaction before the user is
sub-menu screen
logged out and the main option
screen is displayed (seconds)
Determines how long the Merged
Account receipt screen is
Timeout for
displayed without any user
TimeoutReceipt Integer 0 - 999 Merged Account 10
interaction before the user is
receipt screen
logged out and the main option
screen is displayed (seconds)

0 = No ‘back’ button Determines whether the renew


ShowRenew Renew summary summary screen includes a ‘back’
List 1 = Display ‘back’ 0
GoBack back button button to allow further items to be
button renewed

1.17 [ADMIN]
The following configurations are stored in the SelfCheck.ini [ADMIN] section and relate to the administration screen.

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

English = English
Administration Name of language to be used for
AdminLanguage List French = French English
screen language all text on administration screens.
Dutch = Dutch

www.bibliotheca.com
liber8™ – configurations, page 85 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Allow ‘transfer Determines whether administration


0 = Option not allowed
AllowTranBackup List backup file’ screen function ‘Transfer Backup 1
1 = Option allowed
option File’ is enabled.
Allow ‘clear Determines whether administration
0 = Option not allowed
AllowClearBackup List backup file’ screen function ‘Clear Backup File’ 1
1 = Option allowed
option is enabled.
Determines whether administration
Allow ‘go online’ 0 = Option not allowed
AllowGoOnline List screen function ‘Go Online/Offline’ 1
option 1 = Option allowed
is enabled.
Allow ‘transfer Determines whether administration
0 = Option not allowed
AllowTranDiag List diagnostic s’ screen function ‘Transfer 1
1 = Option allowed
option Diagnostics’ is enabled.
Determines whether administration
Allow ‘transfer 0 = Option not allowed
AllowTranStats List screen function ‘Transfer Statistics’ 1
statistics’ option 1 = Option allowed
is enabled.
Allow ‘transfer Determines whether administration
0 = Option not allowed
AllowTranStArc List statistics archive’ screen function ‘Transfer Statistics 1
1 = Option allowed
option Archive’ is enabled.
Allow ‘pay Determines whether administration
0 = Option not allowed
AllowPayAdmin List administration’ screen function ‘Pay 1
1 = Option allowed
option Administration’ is enabled.
Allow ‘receipt Determines whether administration
AllowReceiptAdmi 0 = Option not allowed
List administration’ screen function ‘Receipt 1
n 1 = Option allowed
option Administration’ is enabled.
Allow ‘return bin Determines whether administration
0 = Option not allowed
AllowBinAdmin List administration’ screen function ‘Bin Administration’ 1
1 = Option allowed
option is enabled.
Allow ‘function Determines whether administration
AllowFunctionAdmi 0 = Option not allowed
List administration’ screen function ‘Function 1
n 1 = Option allowed
option Administration’ is enabled.
Allow ‘theme Determines whether administration
0 = Option not allowed
AllowThemesAdmin List administration’ screen function ‘Theme 1
1 = Option allowed
option Administration’ is enabled.

www.bibliotheca.com
liber8™ – configurations, page 86 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Determines whether administration


Allow ‘system 0 = Option not allowed
AllowSystemTools List screen function ‘System tools’ is 1
tools’ option 1 = Option allowed
enabled.
Allow Determines whether administration
AllowAuthNetAdmi 0 = Option not allowed
List ‘AuthorizeNet screen function ‘AuthorizeNet 1
n 1 = Option allowed
password’ option password’ is enabled.
Administrator PIN 0 = Disabled Determines if PIN code is required
AdminSecurity List 0
required 1 = Enabled for administrators to log in.
Admin barcode settings
Specifies the barcodes that allow
AdminId_<n> String Barcode access to the administration
screen.
PIN number for Specifies the PIN codes required
AdminPwd_<n> String 0–9 PIN corresponding from administrators to be able to
AdminId_<n> log in.

www.bibliotheca.com
liber8™ – configurations, page 87 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Determines the options available


when logged in with the
corresponding admin id.
The setting consists of a string of 14
Y/N indicators. The option is
enabled if a Y is in the
corresponding position (not case-
sensitive) and disabled for any
other value. By default all options
are enabled. The options are as
follows (n.b. they are in the same
order as the buttons on the admin
screen):
YYYYYY
Administrator 1 – Transfer backup file
AdminOptions_<n> String YYYYYY
access flags 2 – Clear backup file YY
3 – Go online/offline
4 – Transfer diagnostic logs
5 – Transfer statistics logs
6 – Transfer statistics archives
7 – Payment administration
8 – Receipt administration
9 – Return bin administration
10 – Function administration
11 – Themes administration
12 – Shutdown Liber8
13 – Shutdown Windows
14 – System tools
15 – AuthorizeNet password

www.bibliotheca.com
liber8™ – configurations, page 88 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Determines which payment


administrator functions are
available to each administrator
card. The value of this setting is 9 Y
or N characters. A Y in a position
means the related administrator
card has access to that function,
and an N means they do not. The
payment admin functions are as
follows:
Administrator
AdminPaystationD Position 1 = Coin – Reset DV YYYYYY
String payment access
eviceOptions_<n> YYY
flags Position 2 = Coin – Empty DV
Position 3 = Coin – Set float
Position 4 = Coin – Set levels
Position 5 = Coin – Reset levels
Position 6 = Notes – Reset DV
Position 7 = Notes – Empty DV
Position 8 = Notes – Set float
Position 9 = Notes – Refill DV
Date closed list
Specifies the dates the library will
be closed. These dates will be
Only available if Loan skipped when calculating the
DateClosed<n> Date Date closed offline loan duration.
Duration > 0
Dates should have the following
format: dd/mm/yyyy
0 = No email sent Determines if payment
Email 1 = Email sent in column reconciliation reports are emailed
MailReconciliationR
List reconciliation format out in addition to printing and also 0
eport
report 2 = Email sent in csv determines the format of the
format reports in the emails.

www.bibliotheca.com
liber8™ – configurations, page 89 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Email
Comma separated list of email
ReconciliationRepo reconciliation
String addresses to send payment
rtMailIDs report recipient
reconciliation reports to.
list

1.18 [HARDWARE]
The following configurations are stored in the SelfCheck.ini [HARDWARE] section and relate to the physical devices in the kiosk.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

1 = Paragon
2 = smartserve
3 = Paragon 1 bin
5 = Paragon 2 bins
6 = smartserve 1 bin
7 = smartserve 2 bins
8 = Height Adjust Desk
9 = Sortation Desk
11= smartserve 400+pay
12 = smartserve 400
15 = wall-mounted
smartserve
16 = smartserve with
KioskType List Kiosk type swipecard Specifies the type of kiosk 12
66 = smartblade™
70 = smartlocker
100 = smartserve 100
200 = smartserve 200
(legacy)
20001 = smartserve200
20002 = smartserve200
unlock
20003 = smartserve200
left arm
20004 = smartserve200
right arm
260 = smartserve 260
270 = smartserve 270

www.bibliotheca.com
liber8™ – configurations, page 90 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

27001 = smartserve270
left arm
27002 = smartserve270
right arm
300 = smartserve 300
40001 = smartserve400
recycler
40002 = smartserve400
unlock
40003 = smartserve400
recycler unlock
40004 = smartserve400
pay unlock
410 = smartserve410
41001 = smartserve410
pay
41002 = smartserve410
recycler
470 = smartserve470
47001 = smartserve470
unlock
47002 = smartserve470
pay
47003 = smartserve470
pay unlock
47004 = smartserve470
recycler
47005 = smartserve470
recycler unlock
500 = smartserve 500
560 = smartserve 560
570 = smartserve 570
600 = smartserve 600
700 = smartserve 700
1000 = smartserve1000
100001 = smartserve1000
cash
100002 = smartserve1000
card

www.bibliotheca.com
liber8™ – configurations, page 91 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

100003 = smartserve1000
cash card
100050 = smartserve100-
M
1070 = smartserve1070
107001 = smartserve1070
cash
107002 = smartserve1070
card
107003 = smartserve1070
cash card
ARCOM = ARCOM card
GWCB = GW Credit
Board
SMART = Smart Serve IO Specifies which type of controller
InterfaceType List Interface type NONE
Board to use for I/O.
NONE = No I/O attached
SS1000 = smartserve1000
2 = Custom TPTCM112
3 = Star TUP900
4 = Star TSP700II
17 = Star TSP100II
18 = IBM 4610-1 NR Specifies which type of printer is in
PrinterType List Printer type 19 = Fujitsu FP-1000 4
the kiosk
20 = Epson TM-T88V
21 = Zebra TTP2030
57 = Zebra KR203 with low
paper sensor
0 = Do not use Determines whether the kiosk will
Use smartAdmin
SmartAdminEnabled List smartAdmin communicate with the smartAdmin 0
to manage kiosk
1 = Use smartAdmin system or not
0 = No AV unlocking
AV unlocker device attached Specifies if an AV media unlocking
AVUnlockerPresent List 1 = One Time AutoCheck 0
device present device is attached to the kiosk
unlocker attached
2 = Kwik unlocker

www.bibliotheca.com
liber8™ – configurations, page 92 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

attached
3 = One Time slingshot
unlocker attached
4 = One time smartcase
auto unlockere
Only valid if Specifies the serial port number
AV unlocker
AVUnlockerPort Integer 1-99 AVUnlockerPresent > that the AV unlocker is attached 0
serial port
0 to.
0 = No barcode reading
1 = Get barcodes from
Add lookup values to Specifies if the kiosk reads items
RFID reader (RFID Kiosk)
BarcodeReadingMethod Flags Item read mode use multiple methods using RFID tags, a barcode reader 1
2 = Get barcodes from
(e.g. 3 = RFID & EM) (EM kiosks), or both (Hybrid kiosks)
barcode scanner (EM
Kiosk)
Determines the maximum width of
a print line when printing receipts.
0- Printer right This can be used to add a right-
PrinterMaxWidth Integer
9999 hand margin hand margin to all receipts. This
should only be used when using a
Swecoin or Zebra printer.
Determines where each print line
will start when printing receipts. This
0- Printer left hand can be used to add a left-hand
PrinterLeft Integer
9999 margin margin to all receipts. This should
only be used when using a
Swecoin or Zebra printer.

1.19 [CASH PAYMENTS]


CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Should 0 = Don’t use Indicates if the PaymentServices


UsePaymentServices List PaymentServices PaymentServices module be used for cash payment 0
module be used 1 = Use PaymentServices handling

www.bibliotheca.com
liber8™ – configurations, page 93 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = No coin mechanism
present
1 = GW SR5
Type of coin 4 (Innovative) only
2 = WH Munzprufer Berlin Specifies what type of coin
CoinsDevice List mechanism supported if 0
EMP 850 mechanism is attached:
present UsePaymentServices = 1
3 = MEI CF7900
4 = Innovative Smart
Hopper
0 = No note acceptor
attached 2 (Innovative) only
Note acceptor Specifies if a note acceptor is
NotesDevice List 1 = GBA (HR1/ST2) supported if 0
present attached to the unit.
2 = Innovative Smart UsePaymentServices = 1
Payout
Only valid if
Specifies the serial port number
Note acceptor NoteAcceptorPresent =
NoteAcceptorPort Integer 1 - 99 that the note acceptor is 4
serial port 1 and
attached to.
UsePaymentServices = 0
Specifies the module within
Name of
payment services that implements
InstanceName String paymentservices Cash
the cash facilities. This should not
provider for cash
be changed.
Service used to Comprise = Comprise Service used to send money to
ReconciliationService List
add funds add funds external system
Service used to CompriseCash =
Comprise cash logging Service used to send payment
send payment
LoggingService List transaction information to external
transactions to CompriseCard = system
external app Comprise card logging

1.20 [CARD PAYMENTS]


CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Should 0 = Don’t use Indicates if the PaymentServices


UsePaymentServices List PaymentServices PaymentServices module be used for card payment 0
module be used 1 = Use PaymentServices handling

www.bibliotheca.com
liber8™ – configurations, page 94 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = No card provider
1 = CreditCall
2 = YesPay
3 = Capita 3, 5, 6 and 7 only
Card payment Specifies which card payment
CardProvider List 4 = Authorize.NET supported if 0
provider provider is used in the kiosk.
5 = Comprise UsePaymentServices = 1
6 = CCV
7 = CreditCall ChipDNA
0 = No device attached
1 = VeriFone Secura
2 = VeriFone Vx810
Card payment 3 = UIC PP795 SE Specifies if a card payment device
CardDevice List 0
device 4 = OPP-B50 is attached to the kiosk

5 = Ingenico IUC350
6 = Verifone UX300/100
Only Valid if
YesPay ChipAndPinPresent = 2 Specifies the port used to
YesPayConnectionPort Integer 10000
connection port and communicate with YesPay
UsePaymentServices = 0
C:\YES
Only Valid if
EFT\YES
ChipAndPinPresent = 2 Specifies the path to the YesPay
YesPayEVTPath String YesPay EVT path EFTInter
and interface application
face.e
UsePaymentServices = 0
xe
1= Send Cancel requests Only Valid if
Specifies the method we use in
YesPay void 2= Perform web refund ChipAndPinPresent = 2
YesPayVoidMethod Integer order to void an approved YesPay 1
method via Store Manager (used and
card transaction
in Canada) UsePaymentServices = 0
Specifies the module within
Name of
payment services that implements
InstanceName String paymentservices Card
the card facilities. This should not
provider for cards
be changed.
Service used to Comprise = Comprise Service used to send money to
ReconciliationService List
add funds add funds external system

www.bibliotheca.com
liber8™ – configurations, page 95 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Service used to CompriseCash =


Comprise cash logging Service used to send payment
send payment
LoggingService List transaction information to external
transactions to CompriseCard = system
external app Comprise card logging

1.21 [E PAYMENTS]
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = No e-pay provider
E-payment Specifies which e-payment
EPayProvider List 1 = Emos 0
provider provider is used in the kiosk.
2 = Comprise
For Emos e-Payments only http://www.emos.
Location of WSDL
Applies to Specifies the location of the com/emoswebser
EmosWSDLLocation String document for
EPayProvider = 1 WSDL document of the web vice/pharos.asmx
Emos e-payments
service. ?WSDL

Name of web For Emos e-Payments only


Applies to
EmosWebServiceName String service for Emos Specifies the name of the web Pharos
EPayProvider = 1
e-payments service.
Port of web For Emos e-Payments only
Applies to
EmosWebServicePort String service for Emos Specifies the port of the web PharosSoap
EPayProvider = 1
e-payments service.

For Comprise e-Payments only https://dev.compr


Comprise Sam Applies to isetechnologies.c
CompriseServer String Specifies the URL of the Sam
service location EPayProvider = 2 om/scripts/Sam/S
service amProxy.dll
For Comprise e-Payments only
Comprise Sam Applies to
CompriseUserName String Specifies the user name of the
service user name EPayProvider = 2
Comprise Sam service
For Comprise e-Payments only
Comprise Sam Applies to
ComprisePassword String Specifies the Sam service
service password EPayProvider = 2
password

www.bibliotheca.com
liber8™ – configurations, page 96 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Comprise Sam For Comprise e-Payments only


Applies to
CompriseCustomerId String service customer Specifies the Comprise
EPayProvider = 2
id customer identifier
Comprise Sam Applies to For Comprise e-Payments only
CompriseTerminal String
service terminal id EPayProvider = 2 Specifies terminal id
Service used to Comprise = Comprise Service used to send money to
ReconciliationService List
add funds add funds external system
Service used to CompriseCash =
Comprise cash logging Service used to send payment
send payment
LoggingService List transaction information to
transactions to CompriseCard = external system
external app Comprise card logging

1.22 [ECARD PAYMENTS]


CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = Don’t use Indicates if the


Should
PaymentServices PaymentServices module be
UsePaymentServices List PaymentServices 0
1 = Use used for card payment
module be used
PaymentServices handling
1 = Automaten Seitz
ECard device LES-842/Y1 Specifies the ECard hardware
ECardDevice List
used 2 -= Automaten Seitz to be used
MES-865/B1
Instance name of Specifies instance name of
InstanceName String AsmECard
ECard service ECard provider service
Service used to Comprise = Comprise Service used to send money to
ReconciliationService List
add funds add funds external system
Service used to CompriseCash =
Comprise cash logging Service used to send payment
send payment
LoggingService List transaction information to
transactions to CompriseCard = external system
external app Comprise card logging

www.bibliotheca.com
liber8™ – configurations, page 97 of 175

1.23 [RECONCILIATION SERVICES]


CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Name of service that validates


Reconciliation
ValidationService String the Patron ID to be used for
validation service
external applications.

1.24 [SMART RECEIPTING]


The following configurations are stored in the SelfCheck.ini [SMART RECEIPTING] section and relate to printing features.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Add lookup values to


1 – Printer
use multiple methods List of available methods of
ReceiptMethods Flags Receipt method 2 – E-mail 1
(e.g. 3 = Printer & E- generating the receipt
4 – SMS
mail)
Sender e-mail E-mail address of the sender
FromAddress String
address of the receipt
Test e-mail E-mail address used for
TestAddress String
address testing e-mail receipts
%s is a replaced by
receipt title taken from
eReceipt e-mail
SubjectFormat String “Header Borrow”, E-mail subject [smartReceipt] %s
subject
“Header Return” etc.
settings
Host String SMTP server Name or IP of SMTP server
SMTP server Username used to log on to
MailID String
username SMTP server
SMTP server Password used to log on to
MailPassword String
password SMTP server
Determines the port to use
Port for secure
when connecting to a
Port integer email server for
secure email server for
e-receipt
sending an e-receipt

www.bibliotheca.com
liber8™ – configurations, page 98 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = Standard email Sets whether the email


Use secure
server server used for sending e-
UseSSL List email server for 0
1 = Secure email receipts requires a secure
e-receipt
server connection
SmsHost String SMTP server Name or IP of SMTP server
Format of the
Specifies the format of the e-
SmsAddressForma email address %s represents the
String mail address used for %s
t used for sending mobile phone number
sending
SMS receipts
Test mobile Valid mobile phone Mobile phone number to be
TestNumber String
number number used for testing SMS receipts
SMTP server Username used to log on to
SmsUser String
username SMTP server
SMTP server Password used to log on to
SmsPass String
password SMTP server
Determines the port to use
Port for secure
when connecting to a
SMSPort integer email server for
secure email server for
SMS receipt
sending an SMS receipt
0 = Standard email Sets whether the email
Use secure
server server used for sending SMS
SMSUseSSL List email server for 0
1 = Secure email receipts requires a secure
SMS receipt
server connection

1.25 [EXTERNAL APPS]


CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

App settings
Application
AppIndex<n> Integer 0-MAXINT 0 = disabled Position of the application in the list 0
index
External Name of external application that
AppName<n> String application will appear next to application
name icon

www.bibliotheca.com
liber8™ – configurations, page 99 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Image
Valid path to image Represents the image used as the
AppImage<n> String representing the
file application’s icon
aplication
0 – Html (web site URL)
1 – Exe (executable file)
2 – System tool Determines the type of the
AppType<n> List Application type 0
3 – Internal function application
configured in
AppArgs<n>
Valid absolute path to Determines location of the
AppPath<n> String Application path
executable executable
Valid absolute path to Determines location of the working
AppFolder<n> String Working folder
working folder folder for the application
Application Determines command line
AppArgs<n> String
arguments arguments for the application
0 – don’t preload Indicates whether the application
AppPreload<n> List Preloading 1 – preload the app should be preloaded during Liber8 0
when Liber8 starts start-up
AppPreloadArgs Preloading Application’s command line
String
<n> arguments arguments used for preloading
Allow printing 0 – don’t allow Determines if printer can be used
AllowPrint<n> List 0
from application 1 – allow from the application
Determines if the Coin Mech
ReleaseCoinMec Release Coin 0 – don’t release
List device needs to be released for 0
h<n> Mech device 1 – release
the application
Determines if the Note Acceptor
ReleaseNoteAcc Release Note 0 – don’t release
List device needs to be released for 0
eptor<n> Acceptor device 1 – release
the application
Determines if the Chip And Pin
ReleaseChipAnd Release Chip 0 – don’t release
List device needs to be released for 0
Pin<n> And Pin device 1 – release
the application

www.bibliotheca.com
liber8™ – configurations, page 100 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Determines if the RFID device


Release RFID 0 – don’t release
ReleaseRfid<n> List needs to be released for the 0
device 1 – release
application
ShutdownAppPat Shutdown Determines location of the
String
h application path shutdown application
Shutdown Determines command line
ShutdownAppAr
String application arguments for the shutdown
gs
arguments application

1.26 [NETLOAN]
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Reconciliation report column settings


Reconciliation Text displayed as heading for each
ReconHead<n> String report column column on payment reconciliation
heading report
Reconciliation
Horizontal position of each column
ReconPos<n> Integer 1 - 999 report column
on payment reconciliation report
position

1.27 [MYCOMMUNITY]
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Reconciliation report columns settings


Reconciliation Text displayed as heading for each
ReconHead<n> String report column column on payment reconciliation
heading report
Reconciliation
Horizontal position of each column
ReconPos<n> Integer 1 - 999 report column
on payment reconciliation report
position
Fund code list
FundCode<n> String Fund code Fund code uses by myCommunity

www.bibliotheca.com
liber8™ – configurations, page 101 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Short description for Fund code for


FundCodeShort< Fund code short
String displaying in reconciliation report
n> description
detail section.
Long description for Fund code for
FundCodeLong< Fund code long
String displaying in reconciliation report
n> description
summary section.

1.28 [PAYMENT WEB SERVICES]


The following configurations are stored in the SelfCheck.ini [PAYMENT WEB SERVICES] section and relate to the web services used for self payment functionality.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

https://
librarys
erver:4
Location of WSDL
43/iii/p
document for Location of WSDL document for
WSDLLocation String atronio
web payment web payment services
/servic
services
es/Patr
onIO?
wsdl
Service name for PatronI
Service name for web payment
Service String web payment OServi
services
services ce
Port number for
Port number for web payment PatronI
Port String web payment
services O
services
Username for
Username for web payment
LookupUser String web payment
services
services
Password for
Password for web payment
LookupPassword String web payment
services
services

www.bibliotheca.com
liber8™ – configurations, page 102 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Payment initials
used on
Payment initials used on payment
payment
PaymentInitials String messages when using web
messages when
payment services
using web
payment services

1.29 [PATRON WEB SERVICES]


The following configurations are stored in the SelfCheck.ini [PATRON WEB SERVICES] section and relate to the web services used for patron information
functionality.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = Don’t get from web Specifies whether web services


Get email service
GetEmailFromW should be used to get patron email
List address from 0
ebservice 1 = Do get from web address. Used by the LMS/ILS
web services
service Innovative – Millennium.

Get reserved 0 = Don’t get from web Specifies whether web services
GetReservedIte service
item information should be used to get patron
mCountFromWe List 0
from web 1 = Do get from web reservation details. Used by the
bService
services service LMS/ILS Innovative – Millennium.
Patron web URL for the Innovative patron web
Url String
service url service

1.30 [EM KIOSK]


The following configurations are stored in the SelfCheck.ini [EM KIOSK] section and relate to kiosks that do not have an RFID reader (i.e. ReaderPresent = 0)
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = No EM security
1 = Security using PV Defines the EM Desensitizer
EM Desensitizer
EMSecurityMode List Supa hardware hardware used by the self-check 0
Model
2 = Security using Kajing kiosk
K-Style Desensitizer

www.bibliotheca.com
liber8™ – configurations, page 103 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Specifies the virtual serial port


EM security serial Only Valid if Liber8 is using in order to
EMSecurityPort Integer 1 - 99 0
port ReaderPresent = 0 activate/deactivate the EM
security.
Seconds to wait Determines number of seconds
for a security Only Valid if Liber8 waits to receive a security
EMSecAckTimeout Integer 0
acknowledgeme ReaderPresent = 0 acknowledgement from
nt LibActControll.
Mask for item
Sets mask for item barcodes
numbers Only Valid if
EMBarcodeMask String scanned in on borrow and return *
scanned in EM ReaderPresent = 0
screen on EM kiosks
kiosk
Determines whether to act on the
Act on EM 0 = Do not act on EM
Only Valid if EM security when
OfflineActOnEMSecurity List security when in security 0
ReaderPresent = 0 borrowing/returning items in offline
offline mode 1 = Act on EM security
mode.
0 = Do not check Determines whether a check is
Check magnetic
magnetic media flag done on the ‘Magnetic Media’
MagneticMediaCheck List media flag 1
1 = Do check magnetic flag sent by the LMS before using
before using EM
media flag an EM security setting device.
0 – Set security
according to how tag
Security mode is read (EM for EM read,
RFID for RFID read) Determines how Liber8 should
MixedSecurityMode List (when EM 0
attempt to set security for an item
enabled) 1 – Set security for both
EM and RFID
2 – Set EM security only
EM barcode ignore mask list

www.bibliotheca.com
liber8™ – configurations, page 104 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

? – single character
* - any number of
characters
Barcodes to
[<char>] – required List of barcode patterns that filter
ignore in hybrid
character set out unwanted barcodes that may
EMIgnoreMask<n> String mode Borrow
[!<char>] – be scanned when in hybrid mode
and Return
excluded in the Borrow or Return screen.
screens
characters set
[<char1>–<char2>]
– characters range

1.31 [ICON]
The following configurations are stored in the SelfCheck.ini [ICON] section and relate to the Civica Icon webservice which may be enabled to record card
payments
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Icon
Specifies whether or not Icon is
IconEnabled Boolean Enabled/Disable 0
enabled
d
CallingApplicationI Icon calling Icon calling application id
String
d application id (provided by Civica)
AccountReferenc Icon Account
String Icon Account Reference
e Reference
AccountTypeCod Icon Account Icon Account Type Code
String
e Type Code (provided by Civica)
Icon Account Icon Account VAT Code (provided
AccountVATCode String
VAT Code by Civica)
Icon card Icon payment method code
CardPaymentMet
String payment indicating a card payment
hod
method (provided by Civica)
Icon cash Icon payment method code
CashPaymentMet
String payment indicating a cash payment (not
hod
method currently used)

www.bibliotheca.com
liber8™ – configurations, page 105 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Icon address
IconAddrName String Icon address description
description
Icon address
IconAddrBusiness String Icon address business name
business name
Icon address
IconAddrPremise String Icon address premise name
premise name
IconAddrPremiseN Icon address
String Icon address premise number
o premise number
Icon address
IconAddrStreet String Icon address street
street
Icon address
IconAddrArea String Icon address area
area
Icon address
IconAddrTown String Icon address town
town
Icon address
IconAddrCounty String Icon address county
county
IconAddrPostCod Icon address
String Icon address post code
e post code
Icon Network Icon Network User Id (provided by
IconNetworkUserId String
User Id Civica)
GeneralLedgerCo General Ledger
String General Ledger Code
de Code
Merchant
MerchantNumber String Merchant Number
Number
User name required to access Icon
IconUserName String Icon user name
web services
Icon user Password required to access Icon
IconUserPassword String
password web services
Check
AvailabilityService Full URL for check availability
String availability
Addr service (provided by Civica)
service url

www.bibliotheca.com
liber8™ – configurations, page 106 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Check
Check Payme
AvailabilityService String availability Check availability service ntsSyst
service emAva
ilable
Check
Payme
Check
ntsSyst
AvailabilityPort String availability Check availability service port
emAva
service port
ilableS
oap
Full URL for cash payment service
Cash payment
CashServiceAddr String (provided by Civica – not currently
service url
used)
CashP
Cash payment
CashService String Cash payment service aymen
service
t
CashP
Cash payment
CashPort String Cash payment service port aymen
service port
tSoap
Card payment Full URL for card payment service
CardServiceAddr String
service url (provided by Civica)
PostCa
Card payment
CardService String Card payment service rdPay
service
ment
PostCa
Card payment rdPay
CardPort String Card payment service port
service port mentS
oap
yyyy-
The date format as stored in Icon
mm-dd
IconDateFormat String Icon date format and used by Liber8 to pass the
hh.nn.s
transaction date/time
s.zzz

www.bibliotheca.com
liber8™ – configurations, page 107 of 175

1.32 [SORT ORDER]


The following configurations are stored in the SelfCheck.ini [SORT ORDER] section and determine the sort order for the relevant displays or receipts
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 – Unsorted
Account screen 1 – Title
AccountScreen List Account screen display sort order 0
display sort order 2 – Due Date Ascending
3 – Due Date Descending
0 – Unsorted
Renew screen 1 – Title
RenewScreen String Renew screen display sort order 0
display sort order 2 – Due Date Ascending
3 – Due Date Descending
0 – Unsorted
Reservation screen 1 – Title
ReservationScreen Reservation screen display sort order 0
display sort order 2 – Due Date Ascending
3 – Due Date Descending
0 – Unsorted
Borrow receipt sort 1 – Title
BorrowReceipt Borrow receipt sort order 0
order 2 – Due Date Ascending
3 – Due Date Descending
Return receipt sort 0 – Unsorted
ReturnReceipt Return receipt sort order 0
order 1 – Title
0 – Unsorted
Account receipt sort 1 – Title
AccountReceipt Account receipt sort order 0
order 2 – Due Date Ascending
3 – Due Date Descending
0 – Unsorted
Renew receipt sort 1 – Title
RenewReceipt Renew receipt sort order 0
order 2 – Due Date Ascending
3 – Due Date Descending
0 – Unsorted
Reservation receipt 1 – Title
ReservationReceipt Reservation receipt sort order 0
sort order 2 – Due Date Ascending
3 – Due Date Descending

www.bibliotheca.com
liber8™ – configurations, page 108 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 – Unsorted
1 – Description
Payment screen
PaymentScreen 2 – Type Payment screen display sort order 0
display sort order
3 – Amount Ascending
4 – Amount Descending
0 – Unsorted
1 – Description
Payment receipt sort
PaymentReceipt 2 – Type Payment receipt sort order 0
order
3 – Amount Ascending
4 – Amount Descending

1.33 [SMART DISPENSER]


The following configurations are stored in the SelfCheck.ini [SMART DISPENSER] section and determine the settings for interaction with a smart dispenser.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Disc dispense mode:


0 (disabled) indicates no disc
dispensing
1 (remote) indicates the borrow
process of a disc is carried out at this
0 – Disabled kiosk but the discs are dispensed at a
Disc dispense 1 – Remote remote Central Dispensing Unit
Mode List 0
mode 2 – Central Dispensing Unit 2 (central dispensing unit) only
3 – Local dispense of discs where the borrow
process has already been carried out
at a remote kiosk (no other
functionality)
3 (local) normal Liber8 functionality
plus dispensing of discs
Address String Web service URL URL for the itgdiscxpressws web service
Unique identifier of the kiosk for smart
StationId Integer Station Id
dispenser purposes

www.bibliotheca.com
liber8™ – configurations, page 109 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 – Do not display any extra


instructions during the borrow
process
1 – Display pop up screen
showing item title and
BorrowInstructionLe Borrow Instruction
List configured text for first smart Borrow Instruction Level 0
vel Level
dispenser item only
2 – Display pop up screen
showing item title and
configured text for every smart
dispenser item borrowed
Maximum number Maximum number of discs to dispense
DispenseBatchSize Integer 5
of discs to dispense at any one time
0 - if no connection can be
made to smartdispenser web
services then kiosk continues to
operate as if every item is not Action to be taken, when smart
found in smartdispenser dispenser enabled, if unable to
StopOnError List Stop On Error 0
database connect to the smart dispenser web
1 - If no connection can be service
made to smartdispenser web
services then kiosk goes out of
action
Uncollected disc
Column header text for uncollected
ReportColHeader1 String report column 1 Date
disc report column 1.
header.
ReportColHeader2 String Uncollected disc Column header text for uncollected Patron
report column 2 disc report column 2.
header.
ReportColHeader3 String Uncollected disc Column header text for uncollected ItemID
report column 3 disc report column 3.
header.
ReportColHeader4 String Uncollected disc Column header text for uncollected Dispens
report column 4 disc report column 4. er
header.

www.bibliotheca.com
liber8™ – configurations, page 110 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

ReportColPos1 Integer 0- Uncollected disc Column position for uncollected disc 0


9999 report column 1 report column 1.
position.
ReportColPos2 Integer 0- Uncollected disc Column position for uncollected disc 165
9999 report column 2 report column 2.
position.
ReportColPos3 Integer 0- Uncollected disc Column position for uncollected disc 330
9999 report column 3 report column 3.
position.
ReportColPos4 Integer 0- Uncollected disc Column position for uncollected disc 500
9999 report column 4 report column 4.
position.
ReportLinesPerPage Integer 0 - 999 Uncollected disc Number of lines per page of the 10
report lines per uncollected disc report.
page

1.34 [AV]
The following configurations are stored in the SelfCheck.ini [AV] section and determine the settings for detecting and handling AV items
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Determines whether a
0 = Do not display configurable message is displayed
Display messages if
BorrowAVMessageEnabled List any messages at the end of a borrow transaction 0
AV item borrowed
1 = Display messages if borrowed items included any AV
items
Display AV Only valid if Determines if the AV message is
0 = Do not display
BorrowAVOnConfirm List message on Borrow BorrowAVMessageE displayed on the borrow 0
1 = Display
confirm nabled = 1 confirmation screen
Display AV Determines if the AV message is
Only valid if
message on new 0 = Do not display displayed on a new screen shown
BorrowAVOnNewScreen List BorrowAVMessageE 0
screen after borrow 1 = Display after the borrow confirmation
nabled = 1
confirm screen

www.bibliotheca.com
liber8™ – configurations, page 111 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Display AV Determines if the AV message is


Only valid if
message on Borrow 0 = Do not display displayed on the borrow receipt
BorrowAVOnReceipt List BorrowAVMessageE 0
and Pay receipt 1 = Display screen and any subsequent
nabled = 1
screen related pay receipt screens
Check SIP2 Determines whether we check the
0= Do not Check
SIP2MagneticMediaCheck List magnetic media SIP2 magnetic media flag in order 1
1=Check
flag to detect AV items

SIP2 media type list

SIP2 media types


Determines the SIP2 media types
SIP2MediaType<n> String that correspond to
that correspond to AV items
AV items
1 = Full RFID Check Only valid for RFID
2 = Count Check kiosks ( i.e.
3 = RFID Security-only BarcodeReadingMe Defines the unlocking procedure
Unlocking check
UnlockCheck List thod = 1). For for AV items after they have been 2
Procedure mode
4 = RFID Security-only EM/Hybrid kiosks we checked out
check, allow multiple perform Count
tags in range Check
Only valid if Determines how many extra
Additional UnlockCheck=2 or unlocking attempts we have on
ForgivenessFactor integer 0
unlocking attempts UnlockCheck=3 or the top of the number of the items
UnlockCheck=4 to be unlocked

Media format list

MediaFormat string Specifies a media format string in


MediaFormat<n> String that identifies an ISO28560-2 tag data that identifies
AV item an AV item in a locked case.
Specifies a SIP2 field that can be
SIP2 field that
SIP2AVFieldName String checked to determine if an item is
contains AV flag
in a locked case

www.bibliotheca.com
liber8™ – configurations, page 112 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

SIP2 AV field value list


List of strings to search for in
Value that specifies configurable SIP2 field specified in
AV item in ‘SIP2AVFieldName’ that identify an
SIP2AVFieldValue<n> String
configurable SIP2 AV item that needs unlocking.
field Each of these strings can appear
anywhere in the field.
0 = Borrow – Receipt
Order of unlock – Unlock Specifies which order the screens
UnlockBeforeReceipt List and receipt 0
1 = Borrow – Unlock - are shown in.
screens
Receipt

1.35 [AUTHORIZENET]
The following configurations are stored in the SelfCheck.ini [AuthorizeNet] section and determine the settings for detecting and handling AV items
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

URL String URL URL for Authorize.Net card authorization


Login String Login Id Login Id for Authorize.Net
Has to be
encrypted thus
Admin Screen
TransKey String Password Password for Authorize.Net
option should be
used for entering
the key
Market Type configured for Authorize.Net
MarketType String Market Type 2 = Retail 2
account
Device Type configured for Authorize.Net
DeviceType String Device Type 3 = Self Service Terminal 3
account
CPVersion String CP Version Authorize.Net version 1.0
0 = XML
ResponseFormat List Response Format Authorize.Net response format 1
1 = Delimited

www.bibliotheca.com
liber8™ – configurations, page 113 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Delimiter
DelimChar String Authorize.Net response delimiter |
Character
Currency code for non-default currency
Currency String Currency
transaction
Indicates if the request is for testing
0 = Live request
TestRequest List Test Request purposes (if so, test URL needs to be
1 = Test request
configured)
Determines whether the unit name is sent
Send unit name 0 = Do not send
SendUnitNameAsI to the Authorize.net server as the invoice
List as invoice 0
nvoiceNumber 1 = Send number during card payments processed
number
by Authorize.net.

1.36 [BIBLIOMESSAGING]
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Determines whether 1-way messaging system that


Enable 1-way 0 = Disabled alerts staff to problems encountered by patrons is
Enabled List 0
messaging to staff 1 = Enabled enabled or not. Note: this requires a server and client
application to be setup for full functionality.
1-way messaging Determines server IP address to connect to for 1-way
Server String
server IP address messaging system.
1-way massaging Determines server port number to use when
Port String
server port communicating with 1-way messaging system.
1-way messaging Determines username to use when connecting to 1-
User String
username way messaging system
1-way messaging Determines password to use when connecting to 1-
Password String
password way messaging system

www.bibliotheca.com
liber8™ – configurations, page 114 of 175

1.37 [AHPM]
The following settings relate to Advanced Hold Printing Module.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Determines whether Advanced


0 = AHPM disabled
UseAHPM List Use AHPM Hold Printing Module should be 0
1 = AHPM enabled
used
Indicates whether sort bin value
should be used. AHPM will print
Sort bin value ‘|’ separated
UseSortBinValues String the slip when SIP2 message
checking set of values
contains any of configured sort
bin values.
Indicates whether alert type
value should be used. AHPM will
print the slip when SIP2 CheckIn
‘|’ separated
Response contains CV field with
Alert type value set of values
UseAlertTypeValues String any of configured alert type
checking ‘*’ indicates
values. It will only print if Alert
any value
flag is set in the CheckIn
Response. If empty alert type
checks are disabled.
Indicates whether hold queue
length value should be used. If
UseHoldQueueLen Hold queue 0 = Disabled
List enabled AHPM will print the slip 0
gth length checking 1 = Enabled
when CF field of SIP2 64
message is greater than 0.
Specifies the SIP2 field to use for
liber8 to pass the shelf number
SIP2 field for shelf
ShelfNoSIPSource String through to the AHPM system.
number
For use in smartblade mode
only.

www.bibliotheca.com
liber8™ – configurations, page 115 of 175

1.38 [ITEM SALES]


The following configurations are stored in the SelfCheck.ini [ITEM SALES] section and determine the settings for sale of items
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = Do not allow item


Determines whether item sales are
SalesEnabled List Allow item sales sales 0
allowed
1 = Allow item sales
Circulation status The Circulation Status value
SalesCircStatus String denoting a sale returned by SIP2 that denotes an
item item is for sale

1.39 [SMARTLOCKER]
The following configurations are stored in the SelfCheck.ini [SMARTLOCKER] section and determine the settings for smartlocker system
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = Disabled Determines whether Liber8 runs in


Enabled List Smartlocker mode 0
1 = Enabled smartlocker mode

Check for reserved Only valid when Determines if Liber8 should check
0 = Disabled
ReservationCheck List items awaiting [SMARTLOCKER] for the reserved items awaiting 0
1 = Enabled
collection Enabled = 0 collection in the locker system

1.40 [SMARBLADE]
The following configurations are stored in the SelfCheck.ini [SMARTLOCKER] section and determine the settings for smartlocker system
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = Disabled Determines whether Liber8 runs in


Enabled List smartblade mode 0
1 = Enabled smartblade mode

Timeout for
Sets time to wait for detecting first
FirstDetectionTimeout Integer detecting first item 3000
item measured in milliseconds.
in milliseconds

www.bibliotheca.com
liber8™ – configurations, page 116 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Side of the
left = Left side Specifies which side of the kiosk the
SortSide List smartblade
right = Right side smartblade shelving is positioned
shelving
List of shelf numbers returned by
the smartblade system that can be
smartblade hex
HexShelfNumber<n> String translated into friendly names using
shelf number
associated settings in the
<language>.ini files

1.41 [SS1000]
The following configurations are stored in the SelfCheck.ini [SS1000] section and determine the settings for liber8 running on a smartserve1000 kiosk
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

I/O Board com port Specifies the virtual com port used
ComPort Integer 1
number by the SS1000 i/o board

Specifies the colour in


00000
Hex RGB colour for <red><green><blue> hex values
HealthStateNormalRgb 0..FFFF
RGB normal state for status light when kiosk is in
FF
normal state
Specifies the colour in
00000
Hex RGB colour for <red><green><blue> hex values
HealthStateLMSOfflineRgb 0..FFFF
RGB offline state for status light when kiosk is in
FF
offline state
Specifies the colour in
00000
HealthStateBinNearlyFullRg Hex RGB colour for bin <red><green><blue> hex values
0..FFFF
b RGB nearly full state for status light when kiosk is in bin
FF
nearly full state
Specifies the colour in
00000
Hex RGB colour for bin <red><green><blue> hex values
HealthStateBinFullRgb 0..FFFF
RGB full state for status light when kiosk is in bin
FF
full state

www.bibliotheca.com
liber8™ – configurations, page 117 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Specifies the colour in


00000
HealthStatePrinterLowPape Hex RGB colour paper <red><green><blue> hex values
0..FFFF
rRgb RGB low state for status light when kiosk is in
FF
paper low state
Specifies the colour in
00000
HealthStatePrinterNoPaper Hex RGB colour for <red><green><blue> hex values
0..FFFF
Rgb RGB paper out state for status light when kiosk is in
FF
paper out state
Specifies the colour in
00000
HealthStateCashHwErrorRg Hex RGB colour for cash <red><green><blue> hex values
0..FFFF
b RGB h/w error state for status light when kiosk is in cash
FF
h/w error state
Specifies the colour in
00000
HealthStateCardHwErrorRg Hex RGB colour for card <red><green><blue> hex values
0..FFFF
b RGB h/w error state for status light when kiosk is in card
FF
h/w error state
00000 Specifies the colour in
Hex RGB colour for shelf
EdgeRgb 0..FFFF <red><green><blue> hex values
RGB edge
FF for shelf edge light
Specifies the distance in
0–
BinFullValue Integer Bin full distance centimetres that signifies a full
999
return bin
Specifies the distance in
0- Bin nearly full
BinNearlyFullValue Integer centimetres that signifies a nearly
999 distance
full return bin
Arduin
Name of
Specifies smartserve1000 i/o card o
DeviceName String smartserve1000 i/o
device name Leonar
card
do

www.bibliotheca.com
liber8™ – configurations, page 118 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

The book sensors that have to


detect an item before a scanned
barcode will be processed on the
borrow screen. The three bits
correspond to the three sensors, eg
100 means that the first sensor has
to detect an item, 110 means that
000..1 Book sensors the first and sensor have to detect
BorrowBookSensors String 11 or checked on For EM/hybrid mode an item etc. If the value is set to 000
‘ANY’ borrow screen 000 the item will be processed
even if it isn’t detected on any
book sensors.
If the value is set to ANY the item
will be processed if it is detected
on any one of the three book
sensors.
The book sensors that have to
detect an item before a scanned
barcode will be processed on the
return screen. The three bits
correspond to the three sensors, eg
100 means that the first sensor has
to detect an item, 110 means that
Bool sensors the first and sensor have to detect
Binary 000.11
ReturnBookSensors checked on return For EM/hybrid mode an item etc. If the value is set to 000
string 1
screen 000 the item will be processed
even if it isn’t detected on any
book sensors.
If the value is set to ANY the item
will be processed if it is detected
on any one of the three book
sensors.
Number of times to
Number of times to check if an
check if an item is
BookSensorAttempts Integer For EM/hybrid mode item is detected by the 1
detected by the
book sensor
book sensor

www.bibliotheca.com
liber8™ – configurations, page 119 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

BookSensorTimeoutSecond Book sensor


Integer For EM/hybrid mode Book sensor timeout in seconds 30
s timeout in seconds

Specify whether to 0 – don’t show


ShowBorrowInstructions List For EM/hybrid mode Specify whether to show borrow 0
show borrow 1 – show instructions
instructions
Specify whether we
ShowCancelOnBorrowInstr should show 0 – don’t show Specify whether we should show
List Cancel button on For EM/hybrid mode Cancel button on borrow 0
uctions 1 – show
borrow instruction instruction screen
screen

1.42 [SORTING]
The following configurations are stored in the SelfCheck.ini [SORTING] section and determine the settings for returning items sorting
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Sorting settings list Index of sorting setting from Sorting


XBinSortConfig List Exceptions soring
index settings list used to direct
setting index
exception items

Bin value mappings


You can use single
Bin value as sent by value, multiple Bin number/value as the LMS send
BinId<n> String
LMS values or value it in CL field
range, e.g.: 1,3,5-7

Sorting setting Sorting settings list


BinSortConfig<n> List Index of the sorting setting 0
index index

www.bibliotheca.com
liber8™ – configurations, page 120 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Sorting settings list


bin = Bin
shelf = Shelf other and other<n>
trolley = Trolley values require
other = Other (no custom
Return sort device image) SortItemsMessageTy Specifies the device used for
SortType<n> List bin
type other<n> = Custom peOther and returns sorting
(no image) SortItemsMessageTy
none = No peOther<n> phrases
receptacle (no in <language>.ini file
image, no text)
left = Left side
right = Right side
down = Below other and other<n>
other<n> = Custom values require
(no arrow, both custom
Return sort device images visible) SortItemsMessageSi Specifies the arrow direction and
SortSide<n> List left
side both = Undefined deOther and position of graphic
direction (both SortItemsMessageSi
images visible) deOther<n> phrases
none = No side (no in <language>.ini file
arrow, no text, no
images)

www.bibliotheca.com
liber8™ – configurations, page 121 of 175

1.43 [PATRON BLOCKS]


The following configurations are stored in the SelfCheck.ini [PATRON BLOCKS] section and determine the settings for receiving patron block information from the
ILS.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Specifies the field within the Patron


Information Response message
(64) to look for special patron
block codes. If this is blank then
Non-standard SIP2 patron login logic will use standard
SIP2FieldForPatronBlocks String
patron block field SIP2 fields, if it contains a field code
(e.g. PA) then that field will be
checked for the trigger codes
configured in the settings
‘BlockTrigger<n>’.

Patron block triggers


Specifies the list of patron block
codes in the field configured in the
setting ‘SIP2FieldForPatronBlocks’
that will block a patron from
logging in. The message specified
in the associated
BlockTrigger<n> String Patron block trigger ‘BlockMessage<n>’ setting will be
displayed to the patron.
Note: If a blocktrigger value ends
in a ‘*’ then it will match strings that
start with the fixed characters but
have any other characters at the
end.

www.bibliotheca.com
liber8™ – configurations, page 122 of 175

1.44 [BORROW RULES]


The following configurations are stored in the SelfCheck.ini [BORROW RULES] section and determine the settings for defining borrowing rules.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = No borrowing
Borrow rules rules imposed Determines whether any borrowing
Enabled List 0
enabled 1 = Borrowing rules rules are imposed.
imposed
Specifies the SIP2 field within the
Patron Information Response
Patron type SIP2 Message (64 message) that
PatronTypeSIP2Source String
source field contains the patron type to be
used when applying borrowing
rules.
Specifies the SIP2 field within the
Item Information Response
Item type SIP2
ItemTypeSIP2Source String Message (18 message) that
source field
contains the item type to be used
when applying borrowing rules.
Defines the patron prefix to match
against the start of the patron
PatronPrefix String Patron prefix barcode to determine if rules are
to be applied. Whether this prefix is
used or not is defined per rule set.

Rule sets

Defines the patron-type this rule


PType<n> String Patron type
relates to

www.bibliotheca.com
liber8™ – configurations, page 123 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

0 = Matching patron
prefix has no effect Specifies whether matching the
Prefix match allows 1 = Matching patron ‘PatronPrefix’ value will mean any
PrefixAllowAll<n> List 0
all prefix means any items can be borrowed for this
items can be patron-type.
borrowed
Specifies a list of item-types that
cannot be borrowed by this
patron-type if patron does not
Item types to
ITypesToDisallow<n> String match the prefix (or if
disallow
PrefixAllowAll<n> = 0). The list of
item-types should be separated by
the ‘|’ character.

www.bibliotheca.com
liber8™ – configurations, page 124 of 175

2 <Language>.ini
2.1 [SCREEN TEXT]
There is a <Language>.ini file containing the texts for each supported language (e.g. English.ini, Polish.ini etc.). The following configurations are stored in the
<Language>.ini [SCREEN TEXT] section and relate to messages displayed on the function screens.
CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

Text displayed on option screen as main introduction to


Welcome Text 1 Option screen welcome text line 1 Welcome to
system – line 1
Text displayed on option screen as main introduction to
Welcome Text 2 Option screen welcome text line 2 your|library
system – line 2
Start Form Text Option screen instructional text Text displayed on option screen to instruct users Please select an option to begin
BorrowTitle Borrow screen title text Text displayed on borrow screen as title Borrow
Place items to be loaned in the
BorrowInstruction Borrow screen instructional text Text displayed on borrow screen to instruct users
opening below
Borrow None Text displayed on borrow screen if no items have been You have not borrowed any items.
Borrow screen - no items borrowed
Selected presented for borrow Are you finished?
ReturnTitle Return screen title text Text displayed on return screen as title Return
Place items to be returned in the
ReturnInstruction Return screen instructional text Text displayed on return screen to instruct users
opening below
Return None Text displayed on return screen if no items have been You have not returned any items.
Return screen - no items returned
Selected presented for return Are you finished?
Return screen – return items one by Text displayed on return screen if the system is configured to Please place one item in kiosk at a
Return One By One
one expect items to be returned one at a time time
SortTitle Return Sort screen title text Text displayed on return sort screen as title Sort Returns
RenewTitle Renew screen title text Text displayed on renew screen as title Renew
Choose item(s) then press RENEW
RenewInstruction Renew screen instructional text Text displayed on renew screen to instruct users
button
Renew Summary Title Renew summary title Text displayed on renew summary screen as the title Renewal Results
Renew Summary Text displayed on renew summary screen as key for items Items have been successfully
Renew summary key - worked
Green that worked renewed.

www.bibliotheca.com
liber8™ – configurations, page 125 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

Renew Summary Text displayed on renew summary screen as key for items
Renew summary key - failed Items have not been renewed.
Red that failed
Renew Summary Text displayed on renew summary screen as key for items
Renew summary key - not selected Items have not been selected.
Black that were not selected
Renew None You have not selected any items
Renew screen - no items selected Text displayed on renew screen if no items selected to renew
Selected for renewal. Are you finished?
StatusTitle Status screen title text Text displayed on status screen as title Account
StatusInstruction Status screen instructional text Text displayed on status screen to instruct users Account information
ReservationsTitle Reservation screen title text Text displayed on reservation screen as title Reserved Items
ReservationsInstructi You have reserved the following
Reservation screen instructional text Text displayed on reservation screen to instruct users
on items
LoginTitle Login screen title text Text displayed on login screen as title Login
Scan your barcode or press the
LoginInstruction Login screen instructional text Text displayed on login screen to instruct users
'Keyboard' button
PasswordTitle Password screen title text Text displayed on password screen as title Login
Enter your password using the on-
Password Instruction Password screen instructional text Text displayed on password screen to instruct users
screen keyboard
UserPrompt User barcode prompt Text displayed to prompt use for their barcode Membership no:
PasswordPrompt User password prompt Text displayed to prompt user for their password Password:
Amount Due Text Charges owed text Text and formatting used when displaying charges owed Amount Due %m
Amount Credit Text Credit due text Text and formatting used when displaying credit amount. Amount in Credit %m
Borrow Confirm Borrow screen message text for Text used to confirm the borrow action when a charge is charged at %m. Do you want to
Rental Long confirming chargeable items would be incurred. borrow this item?
Borrow Confirm Borrow screen grid text for payment Text displayed next to items where the borrow action was
Refused
Rental Short refused by user cancelled due to the user not accepting a rental fee.
Borrow Confirm Borrow screen message text for This item could not be borrowed.
Text used to inform the user that a borrow action has failed.
Failed Long failed items Please take it to the staff desk.
Borrow Confirm Borrow screen grid text for flagging
Text displayed next to items where the borrow action failed. Go to staff desk
Failed Short failed items
Borrow Confirm Borrow screen message text for Text used to inform the user that the item they are trying to This item is incomplete. Please
Incomplete Long incomplete items borrow has some part(s) missing. take it to the staff desk.

www.bibliotheca.com
liber8™ – configurations, page 126 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

Borrow Confirm Borrow screen grid text for flagging Text displayed next to items where the borrow action failed
Go to staff desk
Incomplete Short incomplete items due to missing parts.
Borrow Confirm Borrow screen message text for ‘too Text used to inform the user that they have too many items You have too many items on loan
TooMany Long many items on loan’ failures borrowed. already.
Borrow Confirm Borrow screen grid text for too many Text displayed next to items where the borrow action failed
Too Many
TooMany Short items on loan failures due to too many items already borrowed.
Borrow Confirm Borrow screen message text for Text used to inform the user that a borrow failed because You cannot borrow this item until
OverLimit Long outstanding charges failures they have exceeded their charge limit. you pay your outstanding fees.
Borrow Confirm Borrow screen grid text for Text displayed next to items where the borrow action failed
Pay Fees
OverLimit Short outstanding charges failures due to exceeding charge limit.
Borrow Confirm Age Borrow screen grid text for items Text displayed next to items if age authentication has failed.
PIN failed
Restriction Short where age authentication has failed. Only used if AgeRestrictionCheck>0 inside the SelfCheck.ini.
is for sale (not for borrowing). It will
Borrow Confirm Buy Borrow screen message text for Text used to confirm the purchase action when a charge
cost %m to buy. Do you want to
Long confirming purchase items would be incurred.
continue with this purchase?
Borrow Confirm Buy Borrow screen grid text for purchase
Text displayed next to items marked for purchase Bought
Short items
Borrow Confirm Buy Borrow screen message text for
Text used to inform user of purchase failures this item could not be bought
Failed Long purchasing failures
AdminPinFailed Password keyboard PIN failed
This item was not allowed to be
Return Confirm Return screen message text for items
Text used to inform the user that a return action has failed. returned. Please take it to the staff
Failed Long that failed
desk.
Return Confirm Return screen message text for Text used to inform the users that the item they are trying to This item is incomplete. Please
Incomplete Long incomplete items return has some part(s) missing. take it to the staff desk.
Text used to inform the users that the item they are trying to This item type cannot be returned
Return Confirm Not Return message text for items that
return cannot be returned at this machine (e.g. if machine is at this kiosk. Please take it to the
Allowed Long are not allowed to be returned
configured to not allow short loan items to be returned). staff desk.
Text used to inform the users that the item they are trying to
Return Confirm Return message text for items that return cannot be returned at this machine because it should This item cannot be returned here.
Location Long are returned at wrong location be returned at a different library. The message can include Please return to: %s
the ‘Permanent Location’ field of the item that was rejected.

www.bibliotheca.com
liber8™ – configurations, page 127 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

Renew Confirm Renew screen message text for Text used to confirm the renewal action when a charge is charged at %m. Do you want to
Rental Long confirming chargeable items would be incurred. renew this item?
Renew Confirm Renew screen grid text for payment Text displayed next to items where the renew action was
Refused
Rental Short refused by user cancelled due to the user not accepting a rental fee
Reservation screen grid text for Text displayed in ‘reservations’ screen to indicate items that
Holds Available Available
available reservations are available.
Reservation screen grid text for Text displayed in ‘reservations’ screen to indicate items that
Holds Unavailable Pending
unavailable reservations are unavailable.
This is the title text to display to the user if the Return bin is
Confirm Return
Return function unavailable title unavailable but Returns option still displayed on the main Return Facility Out of Order
Unavailable Title
screen.
Confirm Return This is the optional text to display to the user if the Return bin This return unit is currently out of
Unavailable Return function unavailable message is unavailable but Returns option still displayed on the main order. Please take your items to
Message screen. the staff desk.
UnitUnavailableNoL Determines text to be displayed if the unit becomes
Kiosk unavailable - no LMS LMS not responding.
MS unavailable due to LMS not being present.
UnitUnavailableBinFul Determines text to be displayed if the unit becomes
Kiosk unavailable - return bin full Full bin(s).
l unavailable due to return bin being full.
UnitUnavailableNoPa Determines text to be displayed if the unit becomes
Kiosk unavailable - no paper Receipt printer out of paper.
per unavailable due to receipt printer being out of paper.
UnitUnavailableLeftR Kiosk unavailable - paper left in Determines text to be displayed if the unit becomes
Old receipt left in printer.
eceipt printer unavailable due to receipt printer having old receipt left in it.
Determines text to be displayed if the unit becomes This station is temporarily
UnitUnavailableBusy Kiosk unavailable - busy
unavailable due to system maintenance. unavailable
Determines text to be displayed if the unit becomes
PrinterError Kiosk unavailable – printer error Printer error.
unavailable due to printer error.
Determines text to be used as summary count for items in
Borrow-Items Text for number of borrow items %d item|2:s|
borrow grid.
Determines text to be used as summary count for items in
Return-Items Text for number of return items %d item|2:s|
return grid.
Determines text to be used as summary count for items in
Pay-Items Text for number of pay items %d item|2:s|
paymants grid.

www.bibliotheca.com
liber8™ – configurations, page 128 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

Determines text to be used as summary count for items in


Renew-Items Text for number of renew items %d item|2:s|
renew grid.
Determines text to be used as summary count for items in
Status-Items Text for number of account items %d item|2:s|
account grid.
Determines text to be used as summary count for items in
Sort-Items Text for number of sort items %d item|2:s|
sort grid.
Determines text to be used as summary count for items in
Reservations-Items Text for number of hold items %d item|2:s|
reservations grid.
There is a matter on your account
Determines text to be displayed on Return Attention screen.
ReturnAttentionText Return attention message text that requires attention. Please go
(See ReturnAttentionEnabled setting for full explanation).
to your 'Account' screen.
Determines text to be displayed when directing items. %0:s
Please put the following
SortItemsMessage Message for returning items represents the value from SortItemsMessageType<type>,
items\13%0:s %1:s
%1:s represents the value from SortItemsMessageSide<side>
SortItemsMessageTy Message for returning items to the Determines text to be displayed together with
in the bin
peBin bin SortItemsMessage. Destination: bin
SortItemsMessageTy Message for returning items to the Determines text to be displayed together with
on the shelf
peShelf shelf SortItemsMessage. Destination: shelf
SortItemsMessageTy Message for returning items to the Determines text to be displayed together with
on the trolley
peTrolley trolley SortItemsMessage. Destination: trolley
SortItemsMessageTy Message for returning items to other Determines text to be displayed together with
peOther location SortItemsMessage. Destination: other
Custom sort types list
SortItemsMessageTy Message for returning items to Determines text to be displayed together with
peOther<n> custom location SortItemsMessage. Destination: other<n>
SortItemsMessageSid Message for returning items to the Determines text to be displayed together with
to the left
eLeft left SortItemsMessage. Direction: left
SortItemsMessageSid Message for returning items to the Determines text to be displayed together with
to the right
eRight right SortItemsMessage. Direction: right
SortItemsMessageSid Determines text to be displayed together with
Message for returning items below below
eDown SortItemsMessage. Direction: down

www.bibliotheca.com
liber8™ – configurations, page 129 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

SortItemsMessageSid Message for returning items to the Determines text to be displayed together with
eOther other direction SortItemsMessage. Direction: other (no arrow)
Custom sort sides list
SortItemsMessageSid Message for returning items to the Determines text to be displayed together with
eOther<n> custom direction SortItemsMessage. Direction: other<n> (no arrow)
MessageForNotRetur Message for items that could not be Determines text to be displayed when displaying items that Please take the following items to
ned returned could not be returned. the staff desk
Items marked with a clock have
Defines customised message to be display by borrow screen
Borrow-Security- Borrow screen security warning not completed the borrow
when user presses Finish button while there are still items that
Warning message process. Please put them back in
have not had security successfully removed.
the opening.
Defines customised message to be display instead of
Borrow-Security- Borrow screen security problem All items have now finished. Please
‘Borrow-Security-Warning’ message above when all security
Cleared cleared message press 'Finish' button.
problems have been cleared
Some items have not been
Defines customised message to be display by borrow screen
Borrow-Security- Borrow screen security confirmation completely processed. Please
when user presses Finish for the second time while there are
Confirm message take items and receipt to staff
still items that have not had security successfully removed.
desk.
Borrow screen unprogrammed tag Defines customised message to be displayed in the borrow
Tag-Fail-Borrow Unknown item detected
message grid when an unprogrammed tag is detected.
Return screen unprogrammed tag Defines customised message to be displayed in the return
Tag-Fail-Return Unknown item detected
message grid when an unprogrammed tag is detected.
Message displayed on the keyboard screen for PIN entry
KeyboardAgeRestric Keyboard message for age when borrowing age-restricted items. Please enter your PIN \13for age
tionPrompt authentication verification
Only used if AgeRestrictionCheck>0 inside the SelfCheck.ini.
Defines customised message to be displayed when the LMS
EmptyDateText Empty date message Invalid Date
doesn’t return a due back date
Borrows have been refused due to
Message displayed at end of borrow transaction if items
BorrowOverLimitSum insufficient funds totalling %m. Go
Borrow over limit summary message failed to borrow due to insufficient funds and the prepay
mary to "Account" - "Make Payment"
option is available
option to add more funds.

www.bibliotheca.com
liber8™ – configurations, page 130 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

Renews have been refused due to


Message displayed at end of renewal transaction if items
RenewOverLimitSum insufficient funds totalling %m. Go
Renew over limit summary message failed to renew due to insufficient funds and the prepay
mary to "Account" - "Make Payment"
option is available
option to add more funds.
Text displayed on password screen as title after admin
AdminSecurityTitle Password screen title text Administrator Login
barcode was entered
AdminSecurityInstruc Text displayed on password screen to instruct users after Enter administrator PIN using the
Password screen instructional text
tion admin barcode was entered on-screen keyboard
AdminSecurityPromp
Administrator password prompt Text displayed to prompt administrators for their password Administrator PIN:
t
Return attention text for outstanding Text displayed on return attention screen if patron has
RATextDebit
debit outstanding debits
Return attention text for outstanding Text displayed on return attention screen if patron has
RATextCredit
credit outstanding credits
Return attention text for overdue Text displayed on return attention screen if patron has
RATextOverdue
items overdue items
Return attention text for reservations Text displayed on return attention screen if patron has
RATextReservation
available for pickup reservations available for pickup
Text displayed on return attention screen that can include
RATextLMSMessage Return attention text returned by LMS LMS generated message. %s in this string will get replaced
with the LMS generated message.
Text in title of patron information box. ‘%s’ can be used as a
InfoTitle Patron information box title your account information
placeholder for the patron name.
ChangeLanguage Change language Text used on main screen change language option change language
ChangeTheme Change appearance Text used on main screen change appearance option change appearance
ChangeSize Change text size Text used on main screen change text size option change text size
SortItemsMessageT Text used on smartblade sorting screen to specify where to
smartblade sorting destination on the shelves
ypeBlade put items

www.bibliotheca.com
liber8™ – configurations, page 131 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

Warning message shown in borrow process if


‘AllowBorrowMediaPackTag’ = 1 and multi-part tag set Media package,
Confirm Borrow Borrow warning for single tag multi- detected with a tag with part-index 0. This message can be
part-set displayed to alert the patron to manually check the number please verify that all %d parts are
Media Pack Tag
of items in the set. If this message is not needed then set this present
configuration to an empty string.
Warning message shown in return process if
‘AllowReturnMediaPackTag’ = 1 and multi-part tag set Media package,
Confirm Return Return warning for single tag multi- detected with a tag with part-index 0. This message can be
part-set displayed to alert the patron to manually check the number please verify that all %d parts are
Media Pack Tag
of items in the set. If this message is not needed then set this present
configuration to an empty string.
Text to display on screen instead of due date when
OfflineDateText Offline due date text performing an offline borrow with setting Offline
‘OfflineCalculateDate’ = 0.
RetrieveChargeIte Text displayed when the charge breakdown information sent <invalid data - problem
Invalid charge breakdown data
mError by the ILS does not conform to the message standards. encountered when retrieving>
Specifies the text to display when running in return one-at-a-
Return One By Please pace one item in kiosk at a
Return one by one warning message time mode, if the patron places more the one item in the
One time
kiosk at a time.

2.2 [COLUMN HEADERS]


CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

Borrow-Title Title of Borrow grid column - item title Determines text to be used as Title column header in Borrow screen. Item Title
Status-Title Title of Status grid column - item title Determines text to be used as Title column header in Status screen. Item Title
Reservations- Title of Reservations grid column - item Determines text to be used as Title column header in Reservations
Item Title
Title title screen.
Renew-Title Title of Renew grid column - item title Determines text to be used as Title column header in Renew screen. Item Title
Return-Title Title of Return grid column - item title Determines text to be used as Title column header in Return screen. Item Title
Sort-Title Title of Sort grid column - item title Determines text to be used as Title column header in Sort screen. Item Title
Borrow-Due Title of Borrow grid column - due date Determines text to be used as Date column header in Borrow screen. due Date

www.bibliotheca.com
liber8™ – configurations, page 132 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

Status-Due Title of Status grid column - due date Determines text to be used as Date column header in Status screen. due Date
Renew-Due Title of Renew grid column - due date Determines text to be used as Date column header in Renew screen. due Date
Reservations- Title of Reservations grid column - Determines text to be used as Status column header in Reservations
Status
Status status screen.
Pay-Index Title of Pay grid column – Index Determines text to be used as Index column header in Pay screen. #
Pay-Date Title of Pay grid column – Date Determines text to be used as Date column header in Pay screen. date
Pay-Title Title of Pay grid column – Item Title Determines text to be used as Title column header in Pay screen. fee Description
Pay-Amount Title of Pay grid column – Amount Determines text to be used as Amount column header in Pay screen. amount
Borrow-
Title of Borrow grid column - cost Column header text for borrow table cost column. cost
Amount
Renew- Title of Renew grid column - cost Column header text for renew table cost column. cost
Amount
Return- Title of Return grid column - cost Column header text for return table cost column. cost
Amount
Reservations- Title of Reservation grid - Reserved Until Specifies the ‘available until’ column heading on the reservation screen available until
Due column
Return-Sort Title of Return grid – sort column Return screen sort column header text. sort

2.3 [BUTTON TEXT]


There is a <Language>.ini file containing the texts for each supported language (e.g. English.ini, Polish.ini etc.). The following configurations are stored in the
<Language>.ini [BUTTON TEXT] section and relate to text displayed on buttons.
CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

Start-Borrow Option screen - Borrow Text used on the start screen borrow button Borrow Items
Start-Return Option screen - Return Text used on the start screen return button Return Items
Start-Status Option screen - Status Text used on the start screen status button Account
Login-OK Login screen – OK Text used on the login screen OK button OK
Login-Cancel Login screen - cancel Text used on the login screen cancel button Cancel
Login-
Login screen - keyboard Text used on the login screen ’keyboard login’ button Keyboard
Keyboard

www.bibliotheca.com
liber8™ – configurations, page 133 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

Popup-OK Message screen - ok Text used on OK button of confirmation and information screens. OK
Popup- Text used on ‘Yes with receipt’ button of confirmation and
Message screen - yes with receipt Yes\13with receipt
YesWith information screens. Only used when optional printing is enabled.
Popup- Text used on ‘Yes without receipt’ button of confirmation and
Message screen - yes without receipt Yes\13without receipt
YesWithout information screens. Only used when optional printing is enabled.
ReceiptOption
Receipt screen – Back option Text used on Back button of receipt screen. No
-Back
Borrow-
Borrow accept screen – yes Text used on Yes button of borrow accept screen Yes
Accept-Yes
Borrow-
Borrow accept screen – no Text used on No button of borrow accept screen No
Accept-No
Borrow-None-
Borrow no items screen – yes Text used on Yes button of borrow no-items screen Yes
Yes
Borrow-None-
Borrow no items screen - no Text used on No button of borrow no-items screen No
No
Borrow-Finish Borrow screen - finish Text used on the borrow screen finish button. Finish
Return-Finish Return screen - finish Text used on the return screen finish button. Finish
Sort-Finish Sort screen - finish Text used on the sort screen finish button. Finish
Renew-
Renew accept screen – yes Text used on Yes button of renew accept screen Yes
Accept-Yes
Renew-
Renew accept screen – no Text used on No button of renew accept screen No
Accept-No
Renew-None-
Renew no items screen – yes Text used on Yes button of renew no-items screen Yes
Yes
Renew-None-
Renew no items screen - no Text used on No button of renew no-items screen No
No
Text used on the renew screen finish button while user is choosing
Renew-Renew Renew screen - renew Renew
items.
Text used on the renew screen finish button after renewal processing
Renew-Finish Renew screen - finish Finish
has happened.
Renew-
Renew screen - cancel Text used on the renew screen cancel button. Cancel
Cancel

www.bibliotheca.com
liber8™ – configurations, page 134 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

Status-Finish Status screen - finish Text used on the status screen finish button. Finish
Reservations-
Reservation screen - finish Text used on the reservations screen finish button. Finish
Finish
Pay-Cancel Pay screen - cancel Text used on the pay screen cancel button. Cancel
Pay-Pay Pay screen - pay Text used on the pay screen pay button. Pay
Text used on the payment method selection screen, ‘Pay by cash’
Pay-Cash Pay screen - cash Cash
button.
Text used on the payment method selection screen, ‘Pay by card’
Pay-Card Pay screen - card Card
button.
Pay-Epay Pay screen - epay Text used on the payment method selection screen, ‘e-Pay’ button. e-pay
Pay-ECard Pay screen - ecard Text used on the payment method selection screen, ‘ECard’ button. eCard
Pay-Cancel-
Pay screen cancel yes button Text used on yes button of pay cancel screen Yes
Yes
Pay-Cancel-
Pay screen cancel no button Text used on no button of pay cancel screen No
No
Pay-Confirm-
Pay screen confirm yes button Text used on yes button of pay confirm screen Yex
Yes
Pay-Confirm-
Pay screen confirm no button Text used on no button of pay confirm screen No
No
PaySelection-
Pay selection screen cancel button Text used on cancel button of pay selection screen Cancel
Cancel
Return-None-
Return no items screen – yes Text used on Yes button of return no-items screen Yes
Yes
Return-None-
Return no items screen - no Text used on No button of return no-items screen No
No
Return-
Return attention - ok Determines button text to be displayed on Return Attention screen. OK
Attention
Continue Pay prompt - continue Text used on the pay prompt screen Continue button. Continue
EnterAmountF
Enter amount - full amount Text used on the enter amount screen Full Amount button. Full Amount
ull
Renew-All Renew screen renew all button Text used on renew all button of renew screen Renew All

www.bibliotheca.com
liber8™ – configurations, page 135 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

Renew-
Renew screen select all button Text used on select all button of renew screen Select All
SelectAll
Return- Text used on additional button on Return Attention screen allowing to
Return attention - Account Go to "Account"
Account go to “Account” screen
Receipt-
Receipt attention – Continue Text used on the Continue button on receipt attention screen. Continue
Continue
Receipt-
Receipt attention – Cancel Text used on the Cancel button on receipt attention screen. Cancel
Cancel
ReceiptMetho
Receipt type – Printer Text used on the button to indicate that Printer receipt is available. Printer
d-Printer
ReceiptMetho
Receipt type – E-mail Text used on the button to indicate that e-mail receipt is available. E-mail
d-Email
ReceiptMetho
Receipt type - SMS Text used on the button to indicate that SMS receipt is available SMS
d-Sms
Borrow-
Borrow pay prompt - pay Text used on pay button of borrow pay prompt screen Pay\13Charges
PayPromptPay
Borrow-
PayPromptCo Borrow pay prompt - continue Text used on continue button of borrow pay prompt screen Continue
ntinue
Renew-
Renew pay prompt - pay Text used on pay button of renew pay prompt screen Pay\13Charges
PayPromptPay
Renew-
PayPromptCo Renew pay prompt - continue Text used on continue button of renew pay prompt screen Continue
ntinue
EnterAmount-
Enter amount – cancel Text used on cancel button of enter amount screen Cancel
Cancel
EnterAmount-
Enter amount – OK Text used on OK button of enter amount screen OK
OK
Cancel Cancel button Text used on cancel button Cancel
EM-Offline-
EM Offline - Continue Text used on continue button when EM kiosk is offline Continue
Continue
AgeRestriction
Age restriction - Continue Text used on continue button on age restriction message screen Continue
-Continue

www.bibliotheca.com
liber8™ – configurations, page 136 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

FinishConfirm-
Finish confirm – yes Text used on yes button of finish confirmation screen Yes
Yes
FinishConfirm-
Finish confirm - no Text used on no button of finish confirmation screen No
No
ReceiptConfir
Receipt confirm – yes Text used on yes button of receipt confirmation screen Yes
m-Yes
ReceiptConfir
Receipt confirm - no Text used on no button of receipt confirmation screen No
m-No
ReceiptRetry-
Receipt retry – yes Text used on yes button of receipt retry screen Yes
Yes
ReceiptRetry-
Receipt retry - no Text used on no button of receipt retry screen No
No
Renew-
Renew summary - back Text to display on ‘back’ button on renew summary screen. go back
GoBack
Pay-
Pay – define amount to pay Text on pay screen ‘define amount to pay’ button. define amount to pay
DefineAmount

2.4 [POPUP TEXT]


There is a <Language>.ini file containing the texts for each supported language (e.g. English.ini, Polish.ini etc.). The following configurations are stored in the
<Language>.ini [POPUP TEXT] section and relate to on-screen messages and warnings displayed to the user.
CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

You may have entered your


RetryPIN Password screen - retry PIN number Text used to instruct user to enter their password again. Personal Identification Number (PIN)
incorrectly. Please try again.
Your library membership number
NoMoreRetri Text used to inform user that they have entered their password
Password screen - PIN number incorrect cannot be verified. Please try at the
es incorrectly too many times, and they cannot logon.
reception desk.
AgeRes- Self Check could not verify your
Text used to inform user that they have no more retries when
NoMoreRetri Age restriction – no more retries age. Please try at the reception
trying to authenticate an age restricted operation
es desk.

www.bibliotheca.com
liber8™ – configurations, page 137 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

UserFinished Text used to ask user whether they have finished the current
Text to confirm if user is finished Have you finished?
Enquiry action.
Self Check does not recognise your
UserNotFou
Login screen - patron number invalid Text used to instruct user that their patron card was not found. membership number. Please try at
nd
the reception desk.
CanNotBorr Text used to instruct user that there is a problem on their There is a query on your ticket.
Login screen - patron account flagged
owItems account. Please contact a member of staff.
You cannot renew this item
UnableToRe Text used to inform user that the item they have requested to
Renew screen - unable to renew because another library user has
new renew cannot be renewed.
reserved it.
NoReservati
Reservation screen - no items Text used to inform user that they have no reservations. You have no reserved items.
ons
DoYouWant
Text to ask if receipt required Text used to ask user if they require a receipt. Do you want a receipt?
AReceipt
NoItemsToR
Renew screen - no items Text used to inform user that they have no items to renew. You have no items to renew.
enew
NoFeesToPa
Pay screen - no fees to pay Text used to inform user that they have no fees to pay. You have no fees to pay.
y
Status-
Message text if too many items already Text used to inform user that too many items on loan when You have too many items on loan
TooManyIte
on loan on status screen attempting to go to status screen. already.
msOnLoan
Renew-
Message text if too many items already Text used to inform user that too many items on loan when You have too many items on loan
TooManyIte
on loan on renew screen attempting to go to renew screen. already.
msOnLoan
ChargeMes Borrow screen - pay prompt after
Text used after Borrow to inform user that they incurred charges. You have incurred some charges
sageBorrow function
ChargeMes Renew screen - pay prompt after
Text used after Renew to inform user that they incurred charges. You have incurred some charges
sageRenew function
ChargeMes
Borrow screen - pay prompt before There is money owing on your
sageBorrow Text used before Borrow to inform user that they owe money.
function account
Start

www.bibliotheca.com
liber8™ – configurations, page 138 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

ChargeMes
Renew screen - pay prompt before There is money owing on your
sageRenew Text used before Renew to inform user that they owe money.
function account
Start
ChargeMes
Borrow screen - pay prompt after There are outstanding charges on
sageBorrow Text used before Borrow to inform user that they owe money.
function your account
Outstanding
ChargeMes
Renew screen - pay prompt after There are outstanding charges on
sageRenew Text used before Renew to inform user that they owe money.
function your account
Outstanding
NoteReturn Message displayed to user when a note has been returned as a Overpayment limit exceeded.
Pay screen - note payment not allowed
ed result of an overpayment. Please use smaller value.
BorrowAVTitl Borrow screen - AV item(s) borrowed
Text used as message title if any AV items were borrowed Notice
e title
BorrowAVM Borrow screen - AV item(s) borrowed Remember to take any locked
Text used as detail of message if any AV items were borrowed
essage message cases to the staff desk
Informative message displayed to user when borrowing an age- This is an age-restricted item. You
AgeRestricti restricted item.
Borrow screen – age restriction message will be asked to enter your PIN for
onPrompt
Only used if AgeRestrictionCheck > 0 inside the SelfCheck.ini authentication.
Text used as message title before borrowing items in offline
EMOfflineBo Borrow Screen – EM security in offline mode.
Offline Mode - Security Notice
rrowTitle mode title Used only for EM kiosks e.g. if ReaderPresent = 0 and
OfflineActOnEMSecurity = 0 inside the SelfCheck.ini
Text used as detail of message before borrowing items in offline
EMOfflineBo mode. Remember to take any borrowed
Borrow Screen – EM security in offline
rrowMessag items to the staff desk, to have the
mode message Used only for EM kiosks e.g. if ReaderPresent = 0 and
e security removed.
OfflineActOnEMSecurity = 0 inside the SelfCheck.ini
You have renewed some overdue
OverdueRe Text used to inform of possible charges incurred due to an
Renew screen - overdue renewed items. You may have incurred some
newed overdue item renewal.
charges.
ReceiptText- Please take your receipt from
Take normal printer receipt Text used to instruct user to take receipt from printer.
Printer below.
ReceiptText-
Email receipt sent Text used to tell user that email receipt has been sent e-Receipt sent to %s.
Email

www.bibliotheca.com
liber8™ – configurations, page 139 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

ReceiptText-
SMS receipt sent Text used to tell user that SMS receipt has been sent SMS receipt sent to %s.
Sms
ReceiptText-
Text used to instruct user that receipt will include charges Outstanding charges are shown on
WithCharge Receipt – includes charges
accrued to date. your receipt.
s
ReceiptText- Text used to instruct user to take change dispensed by the
Receipt – take change Your change is dispensed below.
Change change giver.
ReceiptAtte
Receipt attention title Title of the receipt attention screen. Receipt attention
ntion-Title
ReceiptAtte Receipt attention – e-mail receipt
Text used to inform of e-mail receipt not available. e-Receipt temporarily unavailable.
ntion-Email unavailable
ReceiptAtte Receipt attention – SMS receipt SMS receipt temporarily
Text used to inform of SMS receipt not available.
ntion-Sms unavailable unavailable.
ReceiptTyp
Receipt type – text Text used to instruct user to choose the receipt type. Choose receipt type.
e-Text
ReceiptFaile
Receipt failed message Text used to inform of receipt generation failure. Receipt generation failed.
d-Text
ReceiptFaile
Receipt failed – retry option message Text to instruct user that he can retry. Do you wish to try again?
d-Retry
Borrow- You were charged at %m for this
Borrow rental information Text to inform user of rental charges incurred
RentalInfo item.
ItemWithBar
Item with barcode Text to indicate item when no title available Item with barcode "%s"
code
ReceiptText-
Receipt text - cancelled Text to inform user that receipt has been cancelled Cancelled
Cancelled
Return-
Determines text to be used on return summary confirmation
Summary- Return screen summary message You have returned
screen.
Prompt
Borrow-
Determines text to be used on borrow summary confirmation
Summary- Borrow screen summary message You have borrowed
screen.
Prompt

www.bibliotheca.com
liber8™ – configurations, page 140 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

Return-
Summary- Return summary items Text to show number of items on return summary screen %d item|2:s|
Items
Borrow-
Summary- Borrow summary items Text to show number of items on borrow summary screen %d item|2:s|
Items
Warning message displayed when an attempt is made to borrow
BorrowMax Warning for borrowing too many items Maximum number of items to
more that maximum number of items allowed when kiosk is
Offline when offline borrow reached
running offline.
AnnualFees
Text displayed on a pop up window when membership/annual Membership fees cannot be
PartialPayM Annual fees partial payment text
fees are partially paid partially paid.
sg
Return-
Summary- Summary for borrow or return functions ending with incomplete
Summary of incomplete items %d incomplete item |2:s|
Incomplete- items
Items
ChargePrivil Login failed due to charge privileges Text displayed on login failure message when patron record
egesDenied denied flagged with ‘charge privileges denied’
RenewalPriv
Login failed due to renewal privileges Text displayed on login failure message when patron record
ilegesDenie
denied flagged with ‘renewal privileges denied’
d
RecallPrivilig Login failed due to recall privileges Text displayed on login failure message when patron record
esDenied denied flagged with ‘recall privileges denied’
HoldPrivilige Login failed due to hold privileges Text displayed on login failure message when patron record
sDenied denied flagged with ‘hold privileges denied’
CardReport Text displayed on login failure message when patron record
Login failed due to card reported lost
edLost flagged with ‘card reported lost’
TooManyIte Login failed due to too many items Text displayed on login failure message when patron record
msCharged charged flagged with ‘too many items charged’
TooManyIte Login failed due to too many items Text displayed on login failure message when patron record
msOverdue overdue flagged with ‘too many items overdue’
TooManyRe Text displayed on login failure message when patron record
Login failed due to too many renewals
newals flagged with ‘too many renewals’

www.bibliotheca.com
liber8™ – configurations, page 141 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

TooManyCl
Login failed due to too many claims of Text displayed on login failure message when patron record
aimsOfItems
items returned flagged with ‘too many claims of items returned’
Returned
TooManyIte Text displayed on login failure message when patron record
Login failed due to too many items lost
msLost flagged with ‘too many items lost’
ExcessiveOu
Login failed due to excessive Text displayed on login failure message when patron record
tstandingFin
outstanding fines flagged with ‘excessive outstanding fines’
es
ExcessiveOu
Login failed due to excessive Text displayed on login failure message when patron record
tstandingFe
outstanding fees flagged with ‘excessive outstanding fees’
es
RecallOverd Text displayed on login failure message when patron record
Login failed due to recall overdue
ue flagged with ‘recall overdue’
TooManyIte Login failed due to too many items Text displayed on login failure message when patron record
msBilled billed flagged with ‘too many items billed’
BookSensorIt Text displayed when in hybrid mode on a kiosk that has item
emNotDete Item not detected on hybrid kiosk sensors and a barcode is scanned when no item is detected by
cted the sensors
BookSensor
PlaceItems Book sensors instructions in hybrid mode
OnSensor
BorrowInstru
ctionsMessa Borrow instructions in hybrid mode
ge
BorrowDisab The text displayed on the borrow screen when an item has been
Borrow screen message when disabling Please take this item to a member
leSecurityFai successfully borrowed, but the security on the item could not be
item security has failed of staff to disable security
led disabled

www.bibliotheca.com
liber8™ – configurations, page 142 of 175

2.5 [SELF PAYMENT]


There is a <Language>.ini file containing the texts for each supported language (e.g. English.ini, Polish.ini etc.). The following configurations are stored in the
<Language>.ini [SELF PAYMENT] section and relate to on-screen messages in the Self Payment function.

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

Title Pay screen - title Text displayed as title of self-payment screen. Self Payment
Instruction Pay screen - instruction Text displayed as instruction of self-payment screen. Pay for your items
TotalDue Pay screen - total due Text displayed as description of amount of money owed. Balance due:
TotalCredit Pay screen - total credit amount Text displayed as description of amount of money in credit Credit Amount:
Insert coins into the\13coin slot
below to\13the desired
Message1 Pay screen - start paying Text displayed as instructional message 1.
amount,\13then press
the\13'Pay' button.
You have entered\13enough
Message2 Pay screen - stop paying Text displayed as instructional message 2. coins.\13Now click the\13'pay'
button
The payment was rejected by
Message4 Pay screen - payment rejected Text displayed when payment is rejected by LMS. the LMS.\13 A receipt will be
printed for this amount.
Message5 Pay screen - finished enquiry Text displayed as confirmation of payment. Have you finished paying?
You have not entered any
Message6 Pay screen - no money entered Text title displayed when ‘Pay’ is pressed without entering money.
money.
Click OK to return to self
Message7 Pay screen - click ok Text displayed after other messages to prompt user to click OK.
payment screen.
Pay screen - amount entered
Message8 Text displayed when Pay pressed to confirm amount entered. You have entered %m
confirmation
Message9 Pay screen - cancel confirmation Text detail displayed when ‘Pay’ pressed without entering money. Do you really want to cancel?
Text displayed when LMS rejects payment or refund due, to remind user Please check receipt for refunds
Message10 Pay screen - check receipt
to check receipt for refunds. or non-payments.
No more change available.
ChangePutInt Pay screen – change credited Text displayed when change giver couldn’t dispense money and the
Remaining change amount was
oCredit account change was sent to credit the account.
used to credit your account.

www.bibliotheca.com
liber8™ – configurations, page 143 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

FeeWithNoTitl
Pay screen - fee with no title Text displayed in grid for fee items that have no associated title. [No title associated with this item]
e
TextForCreditIt
Pay screen - text for credit item Text displayed against fee items that are credits. Total Credit Amount
em
TextForExtraIte
Pay screen - text for extra item Text displayed at end of list of fee items. For more details go to staff desk
m
Insert a debit or\13 a credit
PaymentChip Pay screen - instructions for chip Payment screen instructional text when only Chip and Pin payments
card into the\13 chip and pin
AndPin and pin are allowed.
device\13 on your right.
CNP- Message displayed to user explaining that they cannot enter the The amount owed is less than
Pay screen - payment under
PaymentUnde payment screen because the amount they owe is less than the the minimum allowed chip and
minimum
rMinimum minimum allowed Chip and Pin transaction. pin transaction.
Only cash payments are
CNP-
allowed.\13Amount owed is
PaymentCash Pay screen - cash only because Payment screen instructional text when only cash payments are
less than\13Chip and Pin
OnlyUnderMini under minimum allowed because amount owed is less than Chip and Pin minimum.
minimum.\13Please insert coins
mum
into the\13coin slot below.
EPay-
Only cash payments are
PaymentCash Pay screen – insufficient e-pay Payment screen to tell user they have insufficient balance on their e-
allowed. Insufficient balance on
OnlyNoBalanc balance pay account.
e-pay account.
e
PaymentMeth
Pay screen - payment method Please select a payment
odSelectionTe Instructional text displayed in the payment method selection screen.
selection method
xt
NoChangeAv Instructional text displayed in the message box of the pay screen when
Pay screen - no change available NO CHANGE AVAILABLE.
ailableMsg no change are available.
Instructional text displayed in the message box of the pay screen,
ExactChange USE EXACT CHANGE ONLY OR
Pay screen - exact change only when users should use exact change or less because the change giver
Msg LESS.
device might not be able to give all the required change back.
Amount on cash card:\13
PaymentElectr Pay screen - instructions for e-
Payment screen instructional text for EMOS e-payments. %m.\13 Please use the 'Pay'
onic payments
button\13if you wish to pay.
Enter Amount screen - PrePayment Instructions given to user when entering amount to prepay into their
PrePayPrompt Amount to credit account:
instructions account

www.bibliotheca.com
liber8™ – configurations, page 144 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

Money sent to account will be


PrePayInstructi Enter Amount scree - PrePayment Additional message to be displayed when entering amount to prepay used to pay off any outstanding
on informational message into account fees before putting account
into credit.
PressEscrowLe Press and release button next to
Pay Screen – message box info Instruction for users if coin mech error requires using “release button”.
ver coin slot.
AskStaffForHel
Pay Screen – message box info Additional info if an error requires staff attention Ask member of staff for help.
p
CoinJammed Pay Screen – message box info Informs about the jam in coin mech device. Coin jammed.
NoteJammed Pay Screen – message box info Informs about the jam in note acceptor device. Note jammed.
PaymentsUna Text displayed when Liber8 cannot communicate with any payment No payment method is
Pay Screen – Popup message
vailable device after pressing “Pay fees” button. available at the moment.
NotesNotAvail Informs user that note acceptor device is out of order and cannot
Pay Screen – message box info No note payment available.
able accept notes.
Informs user that coin payment is the only one accepted at the
UseCoinsOnly Pay Screen – message box info Please use coins only.
moment.
There was a problem with your
If there was any interruption or error using coin mech user is informed of
PaymentInterr payment. Please select OK and
Pay Screen – Popup message possible discrepancies and this information is then printed on the
upted take your receipt to a member
receipt.
of staff.
FinishOperatio
Pay Screen – message box info Information about on-going manual operation Ongoing manual operation.
n
DeviceOutOfS
Pay Screen – message box info Payment device has stopped working. Device out of order.
ervice
EnterAmountTi
Enter Amount – Title text Enter amount screen title Enter Amount
tle
EnterAmountI Please enter the amount you
Enter Amount – Instruction text Enter amount screen instructional text
nstruction wish to pay
EnterAmountB Amount which will be used to
Enter Amount – message box info Enter amount screen message in information box
oxMessage pay off outstanding fees.
PrePay- The amount you have entered
IncorrectAmo Prepay – Incorrect Payment screen message when invalid amount entered to pre-pay is not within the allowable
unt range. Maximum Value: %m

www.bibliotheca.com
liber8™ – configurations, page 145 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

EPay-
The amount you have entered
IncorrectAmo Epay – Incorrect Payment screen message when invalid amount entered to e-pay
is too high. Maximum Value: %m
unt
EPay- You have insufficient balance
Epay – no balance Payment screen message when insufficient e-pay balance
NoBalance on your e-pay account.
Problem encountered when
RetrieveCharg Pay Screen – Error when retrieving Text displayed on confirmation window if charge information cannot
retrieving charge details. Please
eError patrons charge information be retrieved from the LMS
go to staff desk.
PartialCashPa the amount you
Enter Amount – Incorrect amount Text displayed on enter amount screen when a value that is too high is
y-
entered for defining partial cash entered. The %m placeholder will be replaced with the maximum valid have entered is too high -
IncorrectAmo
payment amount maximum value: %m
unt
Enter Amount – Instruction text define the amount you wish to
DefineAmoun Instruction text on enter amount screen when prompting to define how
when defining partial cash
tToPay much cash to pay. pay
payment
DefinedAmou Pay Screen – Defined amount table
Text at bottom of pay screen table showing defined amount to pay. defined amount to pay:
nt summary text
Pay Screen – Left to pay table Text at bottom of pay screen table showing how much left to pay (if
LeftToPay left to pay:
summary text defined amount to pay has been entered).

2.6 [CHIP AND PIN]


There is a <Language>.ini file containing the texts for each supported language (e.g. English.ini, Polish.ini etc.). The following configurations are stored in the
<Language>.ini [CHIP AND PIN] section and relate to on-screen messages when using the Chip and Pin device.
CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

EnterAmountTo
Chip and pin - instructions Instructional text for Enter Amount screen. Enter amount to pay
Pay
The amount you have entered is
ChipAndPinInc Message displayed to user explaining that the amount they have
Chip and pin - incorrect amount not\13within the allowable
orrectAmount entered is not within the allowable range.
range.\13Minimum Value: %m
ChipAndPinMa
Chip and pin - maximum Text used for maximum value. - Maximum Value: %m
x

www.bibliotheca.com
liber8™ – configurations, page 146 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

ChipAndPinInst Please follow the instructions on the


Chip and pin - use pin pad Text to inform user to follow instructions on the pin pad.
ructions pin pad.
Transaction Failed. Please remove
Message displayed to user explaining that the Chip and Pin your card.\13Amount entered will
ChipAndPinFail Chip and pin - failed
transaction failed and the money was not taken from the account. not be taken from your \13account
and a receipt will be printed.
ChipAndPinSuc Message displayed to user explaining that the payment was
Chip and pin - success The payment was accepted.
cess accepted.
Chip and pin card has been
ChipAndPinNo Message displayed to user when the chip and pin card is removed
Chip and pin - no card removed. \13Payment will be re-
Card from the pin pad too quickly.
started.
The payment was rejected by the
Message displayed to user explaining that the payment was rejected
ChipAndPinLM LMS.\13Amount entered will not be
Chip and pin - LMS rejected by the library system and the money was not taken from the
SReject taken from your account and a
account.
receipt will be printed.
Chip and pin device encountered a
ChipAndPinPro Message displayed to user when there is a problem with the chip
Chip and pin - problem problem. \13Payment will be re-
blem and pin device e.g. transaction failed to begin.
started.
Magnetic stripe card authorizing Status message displayed during magnetic stripe credit card
Authorizing Authorizing. Please wait…
in progress transaction processing to inform the user what is happening
Title displayed on the screen of the chip and pin screen when the
Title Chip and pin on screen title Bibliotheca \13Smart Library
payment provider is Credit Call and the device is VeriFone Secura.
Text displayed on the screen of the chip and pin screen which
InsertCard Chip and pin - insert card text prompts user to insert a card. Valid when the payment provider is Please insert card
Credit Call and the device is VeriFone Secura.
Text displayed on the screen of the chip and pin screen which
Wait Chip and pin - wait text advises user wait. Valid when the payment provider is Credit Call and Please wait \13Do not remove card
the device is VeriFone Secura.
Text displayed on the screen of the chip and pin screen when a
End Chip and pin – end text transaction ends. Valid when the payment provider is Credit Call and Thank you \13Bye
the device is VeriFone Secura.
Text displayed to user when the LMS rejects an approved chip and
ChipAndPinRef The payment failed. Please take
Chip and pin - Refund payment and a card refund is required via StoreManager (YesPay -
und your receipt to the helpdesk.
Canada)

www.bibliotheca.com
liber8™ – configurations, page 147 of 175

2.7 [E PAYMENT]
There is a <Language>.ini file containing the texts for each supported language (e.g. English.ini, Polish.ini etc.). The following configurations are stored in the
<Language>.ini [E PAYMENT] section and relate to on-screen messages when using the e-payment facility.

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

Transaction Failed. \13 There was a


EpaymentFail E-payment - failed Message displayed to user when the e-payment transaction fails.
problem with the e-payment.
The payment was rejected by the
EpaymentLMSRej Message displayed to user when the payment is rejected by the library
E-payment - LMS rejected LMS.\13Amount entered will not be
ect system (user’s e-balance remains the same).
deducted from your e-balance.

2.8 [ECARD]
There is a <Language>.ini file containing the texts for each supported language (e.g. English.ini, Polish.ini etc.). The following configurations are stored in the
<Language>.ini [E PAYMENT] section and relate to on-screen messages when using the e-payment facility.
CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

transaction failed - there was a


ECardFail ECard - failed Message displayed to user when the ecard transaction fails.
problem with the eCard payment.
Please present your eCard to the
ECardInstructions ECard - instructions Instructional text displayed on ECard screen.
reader.
ECard- you have insufficient balance on
ECard – no balance Text displayed on ECard screen in insufficient balance situation.
NoBalance your eCard
the amount you have
ECard-
ECard – incorrect amount Text displayed on ECard screen in incorrect amount entered situation. entered is too high - maximum
IncorrectAmount
value: %m
the payment was rejected by the
LMS - amount entered will not be
ECardLMSReject ECard – LMS rejection Text displayed on ECard screen when LMS rejects payment
deducted from your
card balance

www.bibliotheca.com
liber8™ – configurations, page 148 of 175

2.9 [MERGED ACCOUNT]


There is a <Language>.ini file containing the texts for each supported language (e.g. English.ini, Polish.ini etc.). The following configurations are stored in the
<Language>.ini [MERGED ACCOUNT] section and relate to the Merged Account facility.

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

Merged Account sub-menu


Welcome Message displayed at top of Merged Account sub-menu screen Account
welcome
Title Merged Account sub-menu title Message displayed as title of Merged Account sub-menu screen. Summary of account information
Merged Account sub-menu Message displayed as screen instructions for Merged Account sub-
Instruction Please select an option to continue
screen instructions menu screen
Button-Status Merged Account - Account Text used on the merged account - account button Account
Button-
Merged Account - Reservations Text used on the merged account - reservations button Reserved\13Items
Reservations
Button-Renew Merged Account - Renew Text used on the merged account - renew button Renew\13Items
Button-Pay Merged Account - Pay Text used on the merged account - pay button Pay\13Charges
Button-Finish Merged Account - Finish Text used on the merged account - finish button Finish
Receipt- Merged Account - Receipt -
Text used on merged account - receipt screen account button Account
Account Account
Merged Account - Receipt -
Receipt-Main Text used on merged account - receipt screen main menu button Main Menu
Main
ChooseAccou Merged Account receipt screen Message displayed as screen instructions for Merged Account You can now be returned to your
ntOrMenu instructions receipt screen. account or the main menu.

2.10 [INFORMATION BOX]


There is a <Language>.ini file containing the texts for each supported language (e.g. English.ini, Polish.ini etc.). The following configurations are stored in the
<Language>.ini [INFORMATION BOX] section and relate to the informational boxes that are displayed in the top right and left of merged account and function
screens.
CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

Summary box loaned items Summary box text describing how many loaned items user
Left-Box-Loan You have %d item|2:s| on loan\13
description has

www.bibliotheca.com
liber8™ – configurations, page 149 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

Summary box overdue items Summary box text describing how many overdue items user
Left-Box-Overdue You have %d overdue item|2:s|\13
description has
Summary box reservation items Summary box text describing how many reserved items user You have %0:d available and %1:d
Left-Box-Res
description has for single items. pending reservation|12:s|\13
Left-Box-Res- Summary box reservation items Summary box text describing how many reserved items user You have %0:d available and %1:d
Available description where items are available has for single items where one or more items are available. pending reservation|12:s|\13
Left-Box-Charge- Summary box charge description
Summary box text describing charges owed. Balance due %m
Debit (debit)
Left-Box-Charge- Summary box charge description
Summary box text describing amount in credit. Amount in credit %m
Credit (credit)
Right-Box-SubMenu Instruction box for sub-menu Instruction box text for merged account sub-menu screen Select a function or press 'Finish'
Right-Box-Account Instruction box for account screen Instruction box text for account screen
Right-Box-
Instruction box for reservations screen Instruction box text for reservations screen
Reservations
Right-Box-Renew Instruction box for renew screen Instruction box text for renew screen
Instruction box text for borrow screen (‘%s’ can be used as
Right-Box-Borrow Instruction box for borrow screen
a placeholder for the patron name)
Specifies string to show in the patron information box
containing the patron card expiry date.
Left-Box-CardExpiry Summary box card expiry description
If this string is left blank then the information will not be
displayed.

2.11 [EXTERNAL APPS]


There is a <Language>.ini file containing the texts for each supported language (e.g. English.ini, Polish.ini etc.). The following configurations are stored in the
<Language>.ini [EXTERNAL APPS] section and relate to the external applications that can be started from the main screen.
CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

External-Title External applications – title Title of external application selection screen More Services
External-Text External applications – instruction Instruction for external applications selection screen Select a service to use
External-Close External applications – close Text on button to close an external application Close

www.bibliotheca.com
liber8™ – configurations, page 150 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

External-
External applications – open Text on button to open external application selection screen More Services
Open
External-Print External applications – print Text on button to print information from an external application Print
External-
External applications - failed Text displayed if an external application fails to start %s failed to start.
Failed

2.12 [MESSAGES]
There is a <Language>.ini file containing the texts for each supported language (e.g. English.ini, Polish.ini etc.). The following configurations are stored in the
<Language>.ini [MESSAGES] section and relate to the messages texts that can be returned by the LMS.
CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

Message list
Message<n> String LMS message translation

2.13 [DISC DISPENSER]


There is a <Language>.ini file containing the texts for each supported language (e.g. English.ini, Polish.ini etc.). The following configurations are stored in the
<Language>.ini [DISC DISPENSER] section and specify the texts relevant when the smart dispenser interface is enabled.
CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

Disc borrowed This item must be collected from the


DiscDispenseItem Text to be displayed if BorrowInstructionLevel set to 2 or 3
reminder message disc dispensing unit.
smartdispenser screen
DiscTitle Text displayed in title bar of smartdispenser screen Collect discs
title
Discs have been dispensed. Please
Smartdispenser screen check all dispensers to make sure
DiscsDispensed Text instruction to be displayed on disc borrow screen
instruction you have removed all discs shown
below before pressing ‘Next’.
Smartdispenser screen Text instructions to be displayed when user exits the disc borrow screen
DiscsRemove Have you retrieved ALL your discs?
take disc reminder without having taken all the discs

www.bibliotheca.com
liber8™ – configurations, page 151 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

All of your discs have been


Smartdispenser all discs
DiscsAllDispensed Disc borrow finalization instructions dispensed. Place each disc in its
borrowed
case before leaving. Thank you.
The following %d items must be
collected from the smartdispenser
station. After getting your receipt at
Smartdispenser discs to
DiscsToCollect Instructions for kiosk in remote dispenser mode this station, simply scan your user
collect reminder
card at the smartdispenser station
and follow the prompts to begin disc
dispensing.
DispenserTitle Central Dispensing Unit title text smartdispenser station
Smartdispenser
DispenserInfoTitle Text displayed in title of instruction box in smartdispenser screen Instructions
instruction text title
Smartdispenser login
DispenseLogin Central Dispensing Unit login instructions Please login to collect your discs
message
There are no discs waiting to be
Smartdispenser no discs dispensed for you. You must borrow
NoDiscsWaiting Central Dispensing Unit no discs text the items from another kiosk first.
waiting

DispenserOutOfSer Smartdispenser out of Kiosk not in service – smartdispenser


Text to display when kiosk unable to connect to smart dispenser
vice service problem
This item has been borrowed, but
Smartdispenser queue
DiscNotRetrieved Text to display when disc cannot be queued disc cannot be retrieved. Please go
fail
to staff desk.
Smartdispenser This item cannot be dispensed.
DiscNotDispensed Text to display on error dispensing disc
dispense fail Please go to staff desk.
You have %d discs to collect. These
Smartdispenser discs to Text to display from Account screen, when in Local dispenser mode, if user
DiscsToDispense will be dispensed after you press
dispense reminder has discs to collect
‘OK’.
DiscsToCollectPro Smartdispenser end of Additional text to display on Borrow finalization screen if discs to be Remember to collect your discs from
mpt borrow reminder collected the dispenser.
You have %d discs to collect. Please
DiscsToCollectCD Smartdispenser discs to Text to display from Account screen, when in Remote dispenser mode, if
collect these from the central
U collect from CDU user has discs to collect
dispensing unit.

www.bibliotheca.com
liber8™ – configurations, page 152 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

DiscsDispensedNe Smartdispenser next


Label for Next button on Disc Borrow screen in Local/CDU mode Next
xt button
DiscsRemoveRedis Smartdispenser
Label for Redispense button on Disc Borrow screen Redispense
pense redispense button
DiscsAllDispensedF Smartdispenser all
Label for Finish button at end of Disc Borrow process Finish
inish dispensed
DiscsToCollectFinis Smartdispenser disc to
Label for Finish button on Disc Borrow screen in Remote mode Finish
h collect finish
NoDiscsWaitingFini Smartdispenser no discs
Label for Finish button when no discs to dispense in CDU mode Finish
sh waiting finish
Specifies the text to display on smartdispenser collection screens to show
Smartdispenser disc
DiscCount the number of discs currently being collected and the total number of disc|2:s| %d-%d of %d
collection count
discs in this transaction.
Smartdispenser Text displayed when a collection cannot go ahead due to a there is a problem with the disc
DIspenserProblem
dispensing problem smartdispenser carousel hardware problem or disconnection. dispenser – please go to staff desk

2.14 [RECEIPT PRINTER]


There is a <Language>.ini file containing the texts for each supported language (e.g. English.ini, Polish.ini etc.). The following configurations are stored in the
<Language>.ini [RECEIPT PRINTER] section and specify the texts relevant for printed receipts, overriding the values specified for the same keys in the equivalent
section of the Selfcheck.ini file.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

The title that will appear at the top


Receipt Title String Receipt title
of every receipt in bold.
Specifies how many lines of header
Header Lines Integer Number of global header lines text will appear under the title on 0
every receipt
Header lines
Lines of header text to be printed
Header <n> String Header line
on each receipt.
Defines text used as column
Column Head Item String Column header text for item title
header for item title columns

www.bibliotheca.com
liber8™ – configurations, page 153 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Defines text used as column


Column Head Date String Column header text for due date
header for due date columns
Defines text used as column
Column Head Disc String Column Header text for disc title
header for disc title
Column Header text for disc Defines text used as column
Column Head Dispenser String
dispenser header for disc dispenser
Column Head Purchased Column Header text for Defines text used as column
String
Item purchased item header for purchased item
Defines text used as column
Column Head Price String Column Header text for price
header for price
Defines text used as column
Column header text for
Column Head Available String header for reservation availability
availability
columns
Defines text used as column
Column header text for charge
Column Header Pay Desc String header for charge description
description
columns
Defines text used as column
Column header text for charge
Column Header Pay Fee String header for charge amount
amount
columns
Defines text used as sub-headings
on borrow receipts. Can include
Header Borrow String Sub heading for borrow receipts the following codes:
%d = Include current date
%t = Include current time
Sub heading for disc borrow Defines text used as sub-headings
Header Disc Borrow String
receipts on disc borrow receipts
Sub heading for item purchase Defines text used as sub-headings
Header Purchase String
receipts on item purchase receipts
Defines text used as sub-headings
on return receipts. Can include the
Header Return String Sub heading for return receipts following codes:
%d = Include current date
%t = Include current time

www.bibliotheca.com
liber8™ – configurations, page 154 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Defines text used as sub-headings


on renew receipts. Can include the
Header Renew String Sub heading for renew receipts following codes:
%d = Include current date
%t = Include current time
Defines text used as sub-headings
on status receipts. Can include the
Header Status String Sub heading for status receipts following codes:
%d = Include current date
%t = Include current time
Defines text used as sub-headings
on reservations receipts. Can
Sub heading for reservations include the following codes:
Header Reservations String
receipts
%d = Include current date
%t = Include current time
Defines text used as sub-headings
on pay receipts. Can include the
Header Payment String Sub heading for pay receipts following codes:
%d = Include current date
%t = Include current time
Defines text used as sub-headings
on payment cancellation receipts.
Sub heading for payment Can include the following codes:
Header PayCancel String
cancellation receipts
%d = Include current date
%t = Include current time
Payment cancellation Instructional text printed on a
Instruct PayCancel String
instructional text payment cancel receipt.
Number of footer lines on borrow Number of lines in the footer of
FootBorrowLines Integer 0
receipts borrow receipts.
Borrow footer lines
FootBorrow <n> String Footer line Text of ‘borrow’ footer lines.
Number of footer lines on return Number of lines in the footer of
FootReturnLines Integer 0
receipts return receipts.

www.bibliotheca.com
liber8™ – configurations, page 155 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Return footer lines


FootReturn <n> String Footer line Text of ‘return’ footer lines.
Number of footer lines on renew Number of lines in the footer of
FootRenewLines Integer 0
receipts renew receipts.
Renew footer lines
FootRenew <n> String Footer line Text of ‘renew’ footer lines.
Number of footer lines on status Number of lines in the footer of
FootStatusLines Integer 0
receipts status receipts.
Status footer lines
FootStatus <n> String Footer line Text of ‘status’ footer lines.
Number of footer lines on Number of lines in the footer of
FootReservationsLines Integer 0
reservations receipts reservations receipts.
Reservations footer lines
FootReservations <n> String Footer line Text of ‘reservations’ footer lines.
Number of footer lines on Number of lines in the footer of
FootPaymentLines Integer 0
payment receipts payment receipts.
Payment footer lines
FootPayment <n> String Footer line Text of ‘payment’ footer lines.
The character used on a receipt to
Character to flag incomplete
Incomplete Item Prefix String indicate the return of an
items on receipts
incomplete item
Defines text and format of string
informing user of how much they
AmountDebit String Text and format of amount owed owe. Used on Borrow, Renew,
Status, Reservations and Pay
receipts
Defines text and format of string
informing user of how much they
Text and format of amount in
AmountCredit String are in credit. Used on Borrow,
credit
Renew, Status, Reservations and
Pay receipts.

www.bibliotheca.com
liber8™ – configurations, page 156 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Defines text and format of string


AmountPaid String Text and format of amount paid informing user of how much they
have paid. Used on Pay receipts.
Defines text and format of string
Text and format of amount of informing user of how much
AmountChange String
change due change they are due. Used on Pay
receipts.
Defines text and format of string
Text and format of amount of informing user of how much
AmountChangeGiven String
change given change they are given back. Used
on Pay receipts
Defines text and format of string
Text and format of amount informing user of how much money
AmountTendered String
tendered they have entered. Used on Pay
receipts.
Text that will be printed alongside
Text used to flag overdue items
ReturnTextOverdue String overdue items on return receipts if
on return receipt
IncludeOverdueFlag = 1.
Text that will be printed alongside
Text used to flag not-on-loan not-on-loan items on return
ReturnTextNotOnLoan String
items on return receipt receipts if IncludeNotOnLoanFlag =
1
Payment successful lines
Text of normal payment receipt
PayTextNorm<n> String Payment receipt text
free form text lines.
Payment overpaid lines
Text of overpayment receipt free
PayTextOver<n> String Payment receipt text
form text lines.
Payment failed lines
Text of failed payment receipt free
PayTextFail<n> String Payment receipt text
form text lines.

www.bibliotheca.com
liber8™ – configurations, page 157 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Indicates how many global footer


Footer Lines Integer Number of global footer lines lines of text will appear below the 0
transaction footer
Footer lines
Lines of global footer text to be
Footer <n> String Footer line
printed on each receipt.
Prefix printed against items on
Flag for items that have been borrow receipt indicating items
BorrowNewPrefix String
processed in current session that have been borrowed in
current session.
Special footer added to borrow
Description of flag for items that
receipts if any items have been
BorrowNewFoot String have been processed in current
marked with ‘BorrowNewPrefix’
session
flag
Prefix printed against items on
Flag for items that had security
BorrowSecPrefix String borrow receipt indicating items
problems
where security was not removed.
Special footer added to borrow
Description of flag for items that
BorrowSecFoot String receipts if any items have been
had security problems
marked with ‘BorrowSecPrefix’ flag
Prefix printed against items on
Flag for discs that could not be
BorrowUnqueuedPrefix String borrow receipt indicating discs that
dispensed
could not be dispensed
Special footer added to borrow
Description of flag for discs that receipts if any discs have been
BorrowUnqueuedFoot String
could not be dispensed marked with
‘BorrowUnqueuedPrefix‘ flag
Text used to indicate chip and pin
Payment receipt text to indicate
ChipAndPinTxt String payments used on payment
chip and pin payment
receipts
Text that describes the type of the
Payment receipt text for type of
ChipAndPinCardNameTxt String chip and pin card used on
card
payment receipts

www.bibliotheca.com
liber8™ – configurations, page 158 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Payment receipt text for card Text that describes the chip and
ChipAndPinCardNoTxt String
number pin card number.
Payment receipt text for expiry Text that describes the expiry date
ChipAndPinExpiryDateTxt String
date of the chip and pin card
Text that describes the
Payment receipt text for
ChipAndPinAuthCodeTxt String authorisation code of a chip an pin
authorisation code
transaction
Payment receipt text for terminal Text that describes the terminal ID
ChipAndPinTerminalIDTxt String
ID of the chip and pin device.
ChipAndPinInstructPayCa Payment receipt text used on Instructional text printed on failed
String
ncel failed chip and pin transactions chip and pin transactions
ChipAndPinApplicationIDT Payment receipt text for Text that describes the Application
String
xt application ID ID of a chip and pin transaction.
Text that describes the merchant
ChipAndPinMerchantNoTx Payment receipt text for
String number of a chip and pin
t merchant number
transaction.
Payment receipt text for issue Text that describes the issue
ChipAndPinIssueNoTxt String number or PAN sequence number or PAN sequence number
number of a chip and pin transaction.
Instructional text printed on a
Payment receipt text used when
InstructChangeDispensed String payment cancel receipt when
change dispensed
change is given back.
Text explaining the remaining e- Text that describes the remaining
EPaymentBalanceTxt String
balance on a smart-card e-balance on a smart card.
Text explaining that a problem
TransactionError String Payment transaction error text
occurred during payment
Text to print on receipt if date is Text printed in place of a date if
EmptyDateText String
invalid the date value is invalid
Date format list
Specifies the date format to be
Date format for due dates printed used when printing due dates on
DateFormat<n> String
on receipts receipts. If left blank the system
short date will be used.

www.bibliotheca.com
liber8™ – configurations, page 159 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Text indicating reserved item is Text indicating reserved item is


ReservationAvailable String Yes
available available
Text indicating reserved item is Text indicating reserved item is not
ReservationUnavailable String No
not available available
Column header text for locker Defines text used as column locker
Column Head Locker String
number header for locker number columns #
Defines text used as sub-headings
on smartlocker receipts. Can collec
Sub-heading for smartlocker include the following codes: ted
Header Locker String
receipts items
%d = Include current date
%d %t
%t = Include current time
items
Section header for items to Defines text to use in the section to
Header Locker Items String
collect header for items to collect collec
t
Paid
by
eCard
Defines text used to display ,
ECardBalanceTxt String ECard balance text
balance on ECard screen curren
t
balan
ce:
Amou
nt not
taken
from
EPaymentInstructPayC Text displayed on epayment
String Epayment cancel text your
ancel receipt when payment cancelled
accou
nt
balan
ce

www.bibliotheca.com
liber8™ – configurations, page 160 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Amou
nt not
taken
ECardInstructPayCanc Text displayed on ecard receipt from
String ECard cancel text
el when payment cancelled your
eCard
balan
ce
“C"
RecReportRefundChan Text on reconciliation report that indicat
String Reconciliation report refund key
geKey shows key of used letters es
refund
Text to use when ‘ItemsTotal’
setting = 1 to format the line
displaying the total number of No of
ItemsTotalText String Items total text items. This should be set to a string Items:
containing any text required along %d
with ‘%d’ which will be replaced
by the number of items in the list.
Text to display on the receipt
instead of due date when
OfflineDateText String Receipt offline due date text
performing an offline borrow with
Offline
setting ‘OfflineCalculateDate’ = 0.
Number of extra footer lines to add
OfflineFootBorrowLines Integer Offline due date description lines to offline borrow receipts if the 0
setting ‘OfflineCalculateDate’ = 0.
Text of extra footer lines to add to
OfflineFootBorrow <n> String Offline due date description text offline borrow receipts if the setting
‘OfflineCalculateDate’ = 0.
String to print on receipts to show
the cost associated with an
cost:
Borrow Rental Cost String Cost detail line on receipts individual item. The %m
placeholder in this string gets %m
replaced with the cost.

www.bibliotheca.com
liber8™ – configurations, page 161 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Text to display on account receipt


if there are no items on the
EmptyAccountDetailTe
Empty account details text patron’s account. If this text is
xt blank, then no receipt will be
printed.

2.15 [AV UNLOCKER]


There is a <Language>.ini file containing the texts for each supported language (e.g. English.ini, Polish.ini etc.). The following configurations are stored in the
<Language>.ini [AV UNLOCKER] section and specify the texts relevant when an AV media unlocking device is attached to the kiosk.
CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

AVUnlockTitle AV Unlock screen title text Text displayed on AV Unlock screen as title Unlock AV cases
AVUnlockInstruc AV Unlock screen Place one case at a time inside the
Text displayed on AV Unlock screen to instruct users
tion instructional text unlocking device
AVUnlockInfoBo AV Unlock screen info box
Text displayed on the info box as title Instructions
xTitle title
AVUnlockTitleCo Title of AV Unlock grid Determines text to be used as Title column header in AV Unlock
Title
lumn column - item title screen
AVUnlockStatus Title of AV Unlock grid Determines text to be used as Status column header in AV Unlock
Status
Column column - status screen
AVUnlock_Case Text for number of unlocked Determines text to be used as summary count for unlocked items in
%d case|2:s| unlocked
s items AV Unlock grid.
AV Unlock screen – Finish
AVUnlockFinish Text used on AV Unlock screen Finish button Finish
button
AVUnlockFinishC Determines text to be used when the user click on the ‘Finish’ button You have not unlocked all your
Finish confirmation message
onfirmation and not all AV cases have been tried for unlocking cases
Multiple items have been detected.
AVUnlockMultiIt Multiple items detected Determines text to be used when more than one cases are detected
Please remove all items around the
ems message in the area around the unlocker
vicinity of the unlocking device.
AVUnlockNotBor Determines text to be used when user tries to unlock an item that has This item has not been borrowed in
Not borrowed item message
rowed not been borrowed this session. Please remove the item.

www.bibliotheca.com
liber8™ – configurations, page 162 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

Determines text to be used in the information box of the AV Unlock


AVUnlockFirstIte Prompt for first case to be Please place first locked case inside
screen when the first AV case should be placed inside the unlocking
m unlocked the unlocking device.
device
Determines text to be used in the information box of the AV Unlock
AVUnlockNextIt Prompt for next case to be Please place next locked case inside
screen when the next AV case should be placed inside the unlocking
em unlocked the unlocking device.
device
AVUnlockProces Determines text to be used in the information box of the AV Unlock
Processing message Processing. Please wait.
sing screen when a case is being unlocked
AVUnlockSucce Unlocking successful Determines text to be used in the information box of the AV Unlock
Item unlocked. Please remove item.
ss message screen when a case is successfully unlocked
Determines text to be used in the information box of the AV Unlock Unlocking failed. Please take item to
AVUnlockFailure Unlocking failed message
screen when the unlocking of the case failed. staff desk.
Determines text to be used in the information box of the AV Unlock
You can now press the ‘Finish’
AVUnlockEnd Finish prompt message screen when all cases have been tried for unlocking (regardless of the
button.
result)
AVUnlockSumm AV Unlock Summary screen Take the following item(s) to the
Text displayed on AV Unlock Summary screen as title
aryTitle title text helpdesk to have them unlocked
AVUnlockSumm Title of AV Unlock Summarry Determines text to be used as Title column header in AV Unlock
Item title
aryTitleColumn grid column - item title Summary screen
AVUnlockSumm Text for number of unlocked Determines text to be used as summary count for unlocked items in
%d item|2:s|
ary_Cases items AV Unlock Summary grid.
AVUnlockSumm AV Unlock Summary screen
Text used on AV Unlock Summaryscreen Finish button Finish
aryFinish – Finish button
The unlocking device is currently
unavailable.\13\13Press the 'Finish'
AVUnlockUnava Text used inside the information box when the connection to the COM
Disconnection text button and take the items below to
ilable port of the unlocking device is lost.
the helpdesk to have them
unlocked.
AVUnlockPromp Text used for heading of reminder message that cases must be
Unlock reminder header text Unlock AV Cases
tHeader unlocked.
AVUnlockPromp Text used for detail of reminder message that cases must be You now need to unlock the AV
Unlock reminder detail text
tMessage unlocked. cases

www.bibliotheca.com
liber8™ – configurations, page 163 of 175

2.16 [SMARTLOCKER]
There is a <Language>.ini file containing the texts for each supported language (e.g. English.ini, Polish.ini etc.). The following configurations are stored in the
<Language>.ini [SMARTLOCKER] section and specify the texts relevant when a smartlocker system is being used.

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

Btn-Collect Main screen collect button Text on the main screen ‘collect items’ button collect items
Title Collect screen title Title text for the collect items screen collect items
select individual locker below to
Instructions Collect screen instruction Instruction text for the collect items screen
collect items or open all lockers
InfoTitle Collect screen info box title Information box title text on collect items screen account information
Btn- Collect screen open
Text on button to open selected lockers open selected
OpenSelected selected locker button
Collect screen open all
Btn-OpenAll Text on button to open all lockers open all
lockers button
Collect screen cancel
Btn-Cancel Text on collect screen cancel button Cancel
button
Btn-Finish Collect screen finish button Text on collect screen finish button Finish
Btn-Select Collect screen select button Text on collect screen select button select locker
Collect screen select-all
Btn-SelectAll Text on collect screen select-all button select all
button
Collect screen title column
Col-ItemTitle Text for collect screen title column header item title
header
Collect screen info column
Col-ItemInfo Text for collect screen info column header
header
Col- Collect screen locker
Text for collect screen locker number column header locker #
LockerNumber number column header
the locker number with
ReceiptInstructi
Collect screen open text Collect screen text displayed when lockers have been opened your reserved items is indicated on
onsOpened
the receipt.
ReceiptInstructi Collect screen close locker please close the locker after
Collect screen text to tell patrons to close the lockers
onsClose text collecting items.

www.bibliotheca.com
liber8™ – configurations, page 164 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

ReceiptInstructi some lockers could not


Collect screen locker failure Collect screen text explaining that some lockers failed to open
onsSomeFailed be opened.
FinishConfirmati you have not collected all your
Collect screen reminder Collect screen text to remind patrons to collect all their items
on items
Items Collect screen items Collect screen text to display the number of items %d item|2:s|
SummaryInstruct
Collect screen results Collect screen text for title of results display collection results
ion

NoItems Collect screen no items Collect screen text explaining that there are no items to collect you have no reserved items for
collection
OutOfService Locker system out of service Text displayed if locker system is not working locker system is not responding
ReservationChe Text displayed to remind patrons that they have reservations waiting you have %d item|2:s| available
Reservations waiting text
ck to be collected for collection in reservation lockers.

2.17 [SMARTBLADE]
There is a <Language>.ini file containing the texts for each supported language (e.g. English.ini, Polish.ini etc.). The following configurations are stored in the
<Language>.ini [SMARTBLADE] section and specify the texts relevant when a smartblade system is being used.

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

OutOfService smartblade out of service Text displayed when smartblade system is not working smartblade™ connection failed
Instructions smartblade instructions Instruction text for smartblade place the books on the shelves
OutOfService smartblade out of service Text displayed when smartblade system out of service shelves system not responding
SortItemsMess
smartblade sorting message Instructional text displayed on smartblade sorting screen please place the items %0:s %1:s
age
Btn-Finish smartblade finish button smartblade finish button Receipt
List of friendly names associated with the shelf numbers defined in the
ShelfFriendlyN smartblade shelf friendly
associated settings in the SelfCheck.ini file. These friendly names are
ame<n> name
used on hold slips printed on the configured staff printer.

www.bibliotheca.com
liber8™ – configurations, page 165 of 175

2.18 [RECONCILIATION SERVICE]


There is a <Language>.ini file containing the texts for each supported language (e.g. English.ini, Polish.ini etc.). The following configurations are stored in the
<Language>.ini [RECONCILIATION SERVICE] section and specify the texts used in the Comprise SAM payment screen.

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

Btn-Pay SAM pay button text Text displayed on SAM screen pay button pay
Btn-Cancel SAM cancel button text Text displayed on SAM cancel button cancel
Title SAM screen title Text displayed as title of SAM screen charge SAM account
make payment to charge your SAM
Instructions SAM instruction text Text displayed showing instructions on SAM screen
account
Paying SAM paying text Text displayed to show what will be paid on SAM screen you have entered|%m
InfoTitle SAM information box title Text displayed as title of SAM screen information box SAM account
InfoText SAM information box text Text displayed in SAM screen information box current balance: %m

2.19 [AUDIO]
There is a <Language>.ini file containing the texts for each supported language (e.g. English.ini, Polish.ini etc.). The following configurations are stored in the
<Language>.ini [AUDIO] section and specify the audio facilities for this language.
CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

MainScreenDisplay Main screen: screen displayed Filename of audio file (path optional) or phrase to say
MainScreenBorrowPressed Main screen: borrow button pressed Filename of audio file (path optional) or phrase to say
MainScreenAccountPressed Main screen: account button pressed Filename of audio file (path optional) or phrase to say
MainScreenReturnPressed Main screen: return button pressed Filename of audio file (path optional) or phrase to say
MainScreenLanguageChange Main screen: language changed Filename of audio file (path optional) or phrase to say
MainScreenThemeChange Main screen: theme changed Filename of audio file (path optional) or phrase to say
MainScreenFontSizeChange Main screen: font size changed Filename of audio file (path optional) or phrase to say
MainScreenCollectPressed Main screen: collect items pressed Filename of audio file (path optional) or phrase to say
LoginScreenDisplay Login screen: screen displayed Filename of audio file (path optional) or phrase to say

www.bibliotheca.com
liber8™ – configurations, page 166 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

LoginFailed Login screen: patron login failed Filename of audio file (path optional) or phrase to say
LoginSuccessful Login screen: patron login successful Filename of audio file (path optional) or phrase to say
BorrowScreenDisplay Borrow screen: screen displayed Filename of audio file (path optional) or phrase to say
BorrowScreenItemDetected Borrow screen: item detected Filename of audio file (path optional) or phrase to say
BorrowScreenItemBorrowFailed Borrow screen: item fails to borrow Filename of audio file (path optional) or phrase to say
BorrowScreenItemBorrowWorked Borrow screen: item borrowed successfully Filename of audio file (path optional) or phrase to say
BorrowScreenFinishPressed Borrow screen: finish pressed Filename of audio file (path optional) or phrase to say
AccountSubmenuScreenDisplayed Account menu screen: screen displayed Filename of audio file (path optional) or phrase to say
AccountSubmenuAccountPressed Account menu screen: account button pressed Filename of audio file (path optional) or phrase to say
AccountSubmenuRenewPressed Account menu screen: renew button pressed Filename of audio file (path optional) or phrase to say
AccountSubmenuReservationsPressed Account menu screen: reservation button pressed Filename of audio file (path optional) or phrase to say
AccountSubmenuPayPressed Account menu screen: pay button pressed Filename of audio file (path optional) or phrase to say
AccountSubmenuFinishPressed Account menu screen: finish button pressed Filename of audio file (path optional) or phrase to say
AccountScreenDisplayed Account screen: screen displayed Filename of audio file (path optional) or phrase to say
AccountScreenFinishPressed Account screen: finish button pressed Filename of audio file (path optional) or phrase to say
RenewScreenDisplayed Renew screen: screen displayed Filename of audio file (path optional) or phrase to say
RenewItemSelectedForRenewal Renew screen: item selected for renewal Filename of audio file (path optional) or phrase to say
RenewItemDeselected Renew screen: item deselected for renewal Filename of audio file (path optional) or phrase to say
RenewItemsPressed Renew screen: renew button pressed Filename of audio file (path optional) or phrase to say
RenewAllPressed Renew screen: renew all button pressed Filename of audio file (path optional) or phrase to say
ReservationsScreenDisplayed Reservation screen: screen displayed Filename of audio file (path optional) or phrase to say
ReservationsFinishPressed Reservation screen: finish button pressed Filename of audio file (path optional) or phrase to say
PayScreenDisplayed Pay screen: screen displayed Filename of audio file (path optional) or phrase to say
PayScreenMoneyEntered Pay screen: money entered Filename of audio file (path optional) or phrase to say
PayScreenPayButtonPressed Pay screen: pay button pressed Filename of audio file (path optional) or phrase to say
EnterAmountScreenDisplayed Enter amount screen: screen displayed Filename of audio file (path optional) or phrase to say
EnterAmountScreenOkPressed Enter amount screen: ok pressed Filename of audio file (path optional) or phrase to say
ReturnScreenDisplay Return screen: screen displayed Filename of audio file (path optional) or phrase to say

www.bibliotheca.com
liber8™ – configurations, page 167 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

ReturnScreenItemDetected Return screen: item detected Filename of audio file (path optional) or phrase to say
ReturnScreenItemReturnFailed Return screen: item failed to return Filename of audio file (path optional) or phrase to say
ReturnScreenItemReturnWorked Return screen: item returned successfully Filename of audio file (path optional) or phrase to say
ReturnScreenFinishPressed Return screen: finish button pressed Filename of audio file (path optional) or phrase to say
SortScreenForExceptionsDisplayed Sort screen: screen for exceptions is displayed Filename of audio file (path optional) or phrase to say
SortScreenForExceptionsOkPressed Sort screen: ok button pressed for exceptions Filename of audio file (path optional) or phrase to say
SortScreenForNormalItemsDisplayed Sort screen: screen for normal items is displayed Filename of audio file (path optional) or phrase to say
SortScreenForNormalItemsOkPressed Sort screen: ok button pressed for normal items Filename of audio file (path optional) or phrase to say
FinishConfirmationScreenDisplay Finish confirmation: screen displayed Filename of audio file (path optional) or phrase to say
FinishConfirmationNotFinishPressed Finish confirmation: ‘not finished’ pressed Filename of audio file (path optional) or phrase to say
FinishConfirmationWithReceiptPressed Finish confirmation: ‘finish with receipt’ pressed Filename of audio file (path optional) or phrase to say
FinishConfirmationWithoutReceiptPressed Finish confirmation: ‘finish without receipt’ pressed Filename of audio file (path optional) or phrase to say
FinishConfirmationFinishedPressed Finish confirmation: ‘finish’ pressed Filename of audio file (path optional) or phrase to say
TakeReceiptScreenDisplayed Take receipt: screen displayed Filename of audio file (path optional) or phrase to say
CollectItemSelected smartlocker: item to collect selected Filename of audio file (path optional) or phrase to say
CollectItemDeselected smartlocker: item to collect deselected Filename of audio file (path optional) or phrase to say
OpenSelectedPressed smartlocker: open selected pressed Filename of audio file (path optional) or phrase to say
OpenAllPressed smartlocker: open all pressed Filename of audio file (path optional) or phrase to say
PayTypeScreenDisplayed Pay type: screen displayed Filename of audio file (path optional) or phrase to say
UnlockItemsScreenDisplayed Unlocker screen: screen displayed Filename of audio file (path optional) or phrase to say
UnlockedItems Unlocker screen: item unlocked Filename of audio file (path optional) or phrase to say
UnlockAllItems Unlocker screen: all items unlocked Filename of audio file (path optional) or phrase to say
UnlockFinishPressed Unlocker screen: finish pressed Filename of audio file (path optional) or phrase to say
DiscDispensingScreenDisplayed smartdispenser: screen displayed Filename of audio file (path optional) or phrase to say
DiscDIspensingInfoDisplayed smartdispenser: carousel info displayed Filename of audio file (path optional) or phrase to say
DiscDispensingNextPressed smartdispenser: next pressed Filename of audio file (path optional) or phrase to say
DiscDispensingFinishPressed smartdispenser: finish pressed Filename of audio file (path optional) or phrase to say
DiscDIspensingReviewScreenDisplayed smartdispenser: review screen displayed Filename of audio file (path optional) or phrase to say

www.bibliotheca.com
liber8™ – configurations, page 168 of 175

CONFIGURATION SHORT DESCRIPTION LONG DESCRIPTION DEFAULT

DiscDIspensingRedispensePressed smartdispenser: redispense pressed Filename of audio file (path optional) or phrase to say

2.20 [PATRON BLOCKS]


There is a <Language>.ini file containing the texts for each supported language (e.g. English.ini, Polish.ini etc.). The following configurations are stored in the
<Language>.ini [PATRON BLOCKS] section and specify the patron block messages for this language
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Patron block messages


Message to display to patron when
they are blocked from login due to
the code from the associated
Patron block ‘BlockTrigger<n>’ setting being
BlockMessage<n> String
messager present in the Patron Information
Response message field specified
in the setting
‘SIP2FieldForPatronBlocks’.

www.bibliotheca.com
liber8™ – configurations, page 169 of 175

3 Innovative cash device configuration


3.1 Cash.config
The cash.config file contains general settings for all cash providers.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

rejectPaymentThresh Reject payment


Real -1, 0 - 1 Not used. -1
old threshold
Maximum Absolute value in addition to
maximumOverpaym
Integer 0 – 9999 overpayment amount owed that can be 20
entAmount
amount overpaid. Defined in major units.
False = Pay until Defines method of making
defined amount payments. For cash we always
payUntilStopped List Pay until stopped false
True = Pay without allow payment up until amount
known end owed, so always set this to ‘False’.
Timeout for when a payment
transaction has ended. This is set to
finishPaymentTimeOu Finish payment well above the inactivity timeout
Integer 0 – 999999 180000
t timeout for the self payment screen – so will
never be used. Do not change this
setting.
recordAccountInform Record account True = true
List Not used. true
ation information False = false
Timeout for making initial
Connection
connectionTimeout Integer 0 – 999999 connection to the cash devices. 20000
timeout
Measured in milliseconds.
False = Short error
verboseErrorReportin Verbose error reporting
List Error reporting detail level. false
g reporting True = Verbose error
reporting

www.bibliotheca.com
liber8™ – configurations, page 170 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Timeout for closing connection to


finishConnectionTime Finish connection
Integer 0 – 999999 the cash devices. Measured in 2000
out timeout
milliseconds.
Name of cash device as
deviceIdentifier String Device identifier referenced in selfcheck.ini. Do not Cash
change this setting.
Name of cash devices currently in
use. When paystation mk2 is being
used this should be set to smartp
Devices.deviceName String Device name ‘smartpayment’. ayme
If the TBS9500 device is being used nt
this should be set to
‘Sem9500Controller’.

3.2 SmartController.config
The smartcontroller.config file contains settings for the Innovative controller board that the cash devices connect to.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

comport Integer 0 – 99 COM port COM port number. 16


Baud rate for communicating with
baudRate Integer 0 – 99999 Baud rate 9600
the smartcontroller.
True = coins enabled Determines whether the coin
coinsEnabled List Coins enabled true
False = coins disabled device is enabled or not.
True = notes enabled Determines whether the note
notesEnabled List Notes enabled true
False = notes disabled device is enabled or not.
auditTimeout Integer 0 – 999999 Audit timeout Not used. 8
Timeout for making initial
Connection
connectionTimeout Integer 0 – 999999 connection to the cash devices. 20
timeout
Measured in seconds.
Timeout for making payments.
payoutTimeout Integer 0 – 999999 Payout timeout 70
Measured in seconds.

www.bibliotheca.com
liber8™ – configurations, page 171 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Default timeout. Measured in


defaultTimeout Integer 0 – 999999 Default timeout 15
seconds.
paymentTimerTimeou Payment timer Payment timer timeout. Do not
Integer 0 – 999999 20
t timeout change this setting.
True = If not all change
can be paid, pay as Determines action to take if cash
much as possible. machines do not contain enough
payPartChange List Pay part change true
False = If not all change change to make complete
can be paid, do not change payment.
pay any change.
Name of cash device as
deviceIdentifier String Device identifier referenced in selfcheck.ini. Do not cash
change this setting.

3.3 SmartHopper.config
The smarthopper.config file contains settings for the Innovative coin hopper device.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

comport Integer 0 – 99 COM port COM port number. 16


Internal bus address. Do not
sspAddress Integer 0 – 99 SSP address 16
change this setting.
Baud rate for communicating with
baudRate Integer 0 – 99999 Baud rate 9600
the smarthopper.
Default timeout. Measured in
Timeout Integer 0 – 999999 Timeout 2000
milliseconds.
How frequently to poll the
pollInterval Integer 0 – 999999 Poll interval smarthopper. Measured in 250
milliseconds.
Currency that smarthopper will
Currency List Currency GBP
work with.
Not used. Do not change this
Simulate List Simulate False
setting.

www.bibliotheca.com
liber8™ – configurations, page 172 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Verbose serial False = Short logging


verboseSerialLogging List Serial logging detail level. False
logging True = Verbose logging
Default
defaultCommandTim Default command timeout
Integer 0 – 999999 command 4
eout measured in seconds.
timeout
Timeout for paying out money
payoutTimeout Integer 0 – 999999 Payout timeout (either in change or emptying 600
device). Measured in seconds.
Device identifier. Do not change
deviceIdentifier String Device identifier Coins
this setting.
Not used. Do not change this
Motorspeed Integer 0, 1 Motor speed 0
setting.
0 = Largest first Determines method used to
Paymode List 0, 1 Pay mode 1
1 = Fastest payout payout coins.
Not used. Do not change this
floatlevel Currency -1 – 9999.99 Float level -1
setting.
False = Get individual
denominations per Determines how the
command communication is performed to
quicklevels List Quick levels True
True = Get all retrieve coin levels. Do not change
denominations in one this setting.
command
Coin list coin For each denomination of coin,
Coinlist.coin Integer 1 – 9999
denomination determines the denomination.
Coin list coin True = coin enabled For each denomination of coin,
Coinlist.enabled List True
enabled False = coin disabled determines if the coin is enabled.

Coin list coin to True = store in cashbox For each denomination of coin,
Coinlist.tocashbox List False
cash box False = Store in recycler determines where it is directed to.
Command list List of commands. Do not change
Commandlist.name String
name these settings.

www.bibliotheca.com
liber8™ – configurations, page 173 of 175

3.4 SmartPayout.config
The smartpayout.config file contains settings for the Innovative note recycler device.
CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

comport Integer 0 – 99 COM port COM port number. 16


Internal bus address. Do not
Sspaddress Integer 0 – 99 SSP address 0
change this setting.
Baud rate for communicating with
Baudrate Integer 0 – 99999 Baud rate 9600
the smartpayout.
Default timeout. Measured in
Timeout Integer 0 – 999999 Timeout 2000
milliseconds.
How frequently to poll the
Pollinterval Integer 0 – 999999 Poll interval smartpayout. Measured in 250
milliseconds.
Currency that smartpayout will
Currency List Currency GBP
work with.
Relationship between minor
Multiplier Integer 0 – 9999 Multiplier denomination and major 100
denomination.
Verbose serial False = Short logging
VerboseSerialLogging List Serial logging detail level. False
logging True = Verbose logging
Not used. Do not change this
Simulate List Simulate False
setting.
Timeout for paying out money
PayoutTimeout Integer 0 – 999999 Payout timeout (either in change or emptying 600
device). Measured in seconds.
Pay coin timer Timeout for paying individual note.
PayCoinTimerTimeout Integer 0 – 999999 60
timeout Measured in seconds.
Device identifier. Do not change
DeviceIdentifier String Device identifier Notes
this setting.

www.bibliotheca.com
liber8™ – configurations, page 174 of 175

CONFIGURATION TYPE RANGE SHORT DESCRIPTION LOOKUP RULE LONG DESCRIPTION DEFAULT

Colour of bezel defined in hex


RedGreenBlue format. When set to
BezelRgb Colour Bezel RGB 000000
000000 the default colour will be
used.
Not used. Do not change this
FloatLevel Integer -1 – 9999 Float levels -1
setting.
Determines how the
communication is performed to
QuickLevels List Quick levels True
retrieve coin levels. Do not change
this setting.
For each denomination of note
Stack list note
StackList.note Integer 1 – 9999 determines the note
denomination
denomination.
True = Direct to stacker For each denomination of note
Stack list note
Stacklist.stack List False = Direct to determines where not is directed
stack
recycler to

True = note enabled For each denomination of note


Stack list note
Stacklist.enabled List determines whether note is
enabled False = note disabled enabled or not
Command list List of commands. Do not change
Commandlist.name String
name these settings.

www.bibliotheca.com
liber8™ – configurations, page 175 of 175

Contact Bibliotheca Support


Contact Bibliotheca Support 24/7 around the globe:
Phone Email

+61 (3) 9811 4750 [email protected]

877.207.3127, select option 2 [email protected]

+41 41 726 9950 [email protected]

+49 7121 9264 115 [email protected]

+45 – 7027 1008 [email protected]

877.207.3127, select option 2 [email protected]

+33 (0)1 56 24 11 76 [email protected]

+39 800 011 060 [email protected]

+31 (0)229-505538 [email protected]

+44 (0)161 498 1150 [email protected]

Please be ready with your library’s customer number, case number, any applicable error messages or conditions, and the product version or serial number.

www.bibliotheca.com

You might also like