G-LBIS1066EN.

027

Bibliotheca quickConnect™ selfCheck

installation and support guide v2.7
 Copyrights & Trademarks
Copyright © Bibliotheca 1999-2023, all rights reserved. The Bibliotheca name and device is a registered
trademark of Bibliotheca.

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.

All product names presented with the TM symbol within this document are trademarks of Bibliotheca and may
not be used without the express written permission. Windows is a registered trademark of the Microsoft
Corporation in the United States and other countries.

Terms & Conventions

Text boxes containing a green 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 circle with a white 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 circle 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.

2 Bibliotheca.com
 Table Of Contents

1 Tools and equipment 8

1.1 Tools required 8

1.2 Equipment 8

2 Overview 9

3 Install quickConnect™ selfCheck on a new kiosk 10

4 Upgrade an MP9 PC running Windows 7 to Windows 10 11

4.1 Create a bootable thumb drive with the image 11

4.2 Check the current BIOS version on the computer 12

4.3 Apply the Windows 10 Image 14

5 Re-installing on a replacement PC 16

6 Upgrade from liber8™ to quickConnect™ selfCheck on a Nexcom PC 20

6.1 Pre-installation 20

6.2 Installation 20

6.3 Additional Notes 22

6.3.1 Slow start-up time 22

6.3.2 Uninstalling liber8™ for disk space 22

6.3.3 Anti-Virus scans 22

7 Upgrade from liber8™ to quickConnect™ selfCheck on an MP9 PC 23

7.1 Pre-installation 23

7.2 Installation 23

8 Upgrade selfCheck 4.72.005.0 to quickConnect™ selfCheck 25

8.1 Pre-requisites 25

9 Downgrade from quickConnect™ selfCheck v1.79 and later to earlier version 35

10 Install and test devices 36

10.1 Fujitsu FP-1000 printer 36

10.1.1 Install the Fujitsu FP-1000 printer 36

10.1.2 Configure and test the Fujitsu FP-1000 printer. 36

10.1.3 Configuring Fujitsu FP-1000 printer page length 37

10.2 Masung EP802-TMP Printer 43

10.2.1 Install Masung EP802-TMP Printer 43

10.2.2 Configure and test the Masung EP802-TMP Printer 43

3 Bibliotheca.com
 10.2.3 Windows Printer Configurations 43

10.3 Star C-Print 3 Printer 43

10.3.1 Star C-Print 3 Printer Driver Installation 44

10.3.2 Star C-Print 3 Printer Windows Settings 47

10.3.3 Star C-Print 3 Printer quickConnect Configuration 48

10.4 Datalogic Gryphon GFS4170 bar code scanner 49

10.4.1 Datalogic GFS4170 barcode scanner firmware 50

10.4.1.1 Firmware update for Legacy Systems 50

10.4.1.2 Firmware verification 53

10.4.1.2.1 Keyboard wedge mode 53

10.4.1.2.2 USB-COM mode 54

10.4.2 Configure and test the scanner 56

10.5 RFID Reader 59

10.5.1 RFID Reader Tag Format Security 60

10.5.1.1 Custom security 61

10.5.2 Support for multiple AFI values 65

10.6 L-Coil Electro Magnetic (EM) Security Device 66

10.6.1 Multiple-Book Detection (MBD) Calibration 66

10.6.1.1 Introduction 66

10.6.1.1.1 Sensor calibration 67

10.6.1.2 Tools required 67

10.7 ID TECH magnetic card reader 68

10.8 Unlockers 69

10.9 Kiosk indicator lights (SmartServe 1000 IO Board) 70

10.10 Innovative Technology Cash Box 71

10.10.1 Configuring how change is issued 71

10.10.2 Staff notifications 74

11 Install Card Payment solutions 77

12 Pharos 78

12.1 Pharos processor settings 78

12.2 Additional Services 79

12.2.1 Enable the creation of guest passes 81

4 Bibliotheca.com
 12.2.2 Enable Donations 82

12.2.3 Pharos E-Payment Payment Transaction Messages 82

12.2.3.1 Failed Send Attempts 82

13 Setup OneCard Solutions e-payment and authentication (optional) 83

14 MobilePay (Denmark only) 84

15 Additional configuration steps 86

15.1 Family member cards 86

15.1.1 Setting up family member cards 86

15.2 Patron log in and returns 89

15.3 Dispense largest notes as change first 90

15.4 Dispense unknown coins out the front when emptying 91

15.5 Charge payment requests and the ILS / LMS 92

15.6 Configure a barcode card as an Admin card 93

15.7 Database privacy 94

15.7.1 None 95

15.7.2 RepeatableHash 96

15.7.3 Obfuscated 96

15.8 Email Innovative payment reconciliation reports 97

15.9 Enable cloudLibrary pop-up messages 100

15.10 Comprise Report for payments 102

15.11 Comprise SAM Payment Account Reload 105

15.12 OCLC 107

15.12.1 Set alert on previously borrowed items 107

15.12.2 Conditional item messages on failure 108

15.12.3 HTTP for OCLC 110

15.13 Configure LDAP servers 111

15.14 Split patron ID and Date Of Issue from the library card number to use in SIP2 113

15.15 Allow full titles to be displayed on receipts 114

15.16 Include Patron ID and expiration date on every receipt 116

15.17 Configure Payments for Colombian Pesos 117

16 Additional System Manager Tasks 118

17 Set a library user password 119

5 Bibliotheca.com
 18 Detect cased items based on tag data or alternative SIP data 120

18.1 Option to ignore block flags 120

19 Enable a language neutral Welcome screen 123

19.1 Add a new language after initial installation 127

20 Request additional item information from the LMS / ILS 129

20.1 Add optional ISIL check when reading tags 130

20.2 Configuring ABC protocol for ILS communication 131

20.3 Connecting to an ILS using LCF protocol 132

21 NCIP configurations 135

22 AFI Password Protection 137

23 Text to Speech 138

23.1 Installing Text to Speech 138

23.2 Configuring Text to Speech 139

23.2.1 Overriding a Default Text to Speech Phrase 141

23.3 Text-to-Speech resource strings 143

23.3.1 List of Views 143

23.3.2 List of Commands 145

23.3.3 List of Pop-ups 148

24 Add patron name and ID to the display 155

25 Show account balance on borrow screen 156

26 Enable Events with Shared Services 158

27 Integration with Netloan 160

27.1 Pre-requisites 160

27.2 Enabling the third party application 160

27.3 Enable the tile on screen and add a custom icon image 161

27.4 Change the text on the tile 163

27.5 Enabling Keyboard Wedge barcode mode 164

27.6 Disable the Default (Datalogic) scanner 165

27.7 Enable Keyboard Wedge Scanner 166

27.8 Stop quickConnect attempting to log in 166

27.9 Low Change 166

28 Integration with ICAM 167

6 Bibliotheca.com
 28.1 Pre-requisites 167

28.2 Enabling the third party application 167

28.3 Enable the tile on screen and add a custom icon image 168

28.4 Change the text on the tile 169

28.5 Remove the Windows Taskbar 170

29 Session synchronisation with Patron card 171

30 Option to check patron blocks before directing patron to pay 172

31 Add optional payment validity check before allowing payment 173

32 Return trolley reader (Nordic region) 174

33 Appendix A: Tag Data Formats 176

34 Appendix B: Advanced Hold Printing Module 180

34.1 Configuring the Advanced Hold Printing Module (AHPM) 180

34.2 Accessing the Advanced Hold Printing Module 182

34.3 Change the printer to be used 182

34.4 Change the design of the hold ticket 183

34.4.1 Left column 184

34.4.2 Centre column 184

34.4.2.1 Field Data Source 185

34.4.2.2 Field Formatting 186

34.4.2.3 Advanced Data Source Parsing 187

34.4.3 Right column 188

34.4.4 Other Controls 189

34.5 Load Configuration Settings 190

34.6 Print sample holds ticket 190

35 Appendix C: Special character buttons on standard keyboards 191

36 Appendix D - Setup Gen 1 Payment station (MEI & GBA) - Legacy 195

37 Contact Bibliotheca Support 200

7 Bibliotheca.com
 1 Tools and equipment
1.1 Tools required
The installation of quickConnect™ selfCheck does not require any tools.

1.2 Equipment
To complete the installation, you will need a laptop or PC (with a keyboard and mouse) and a thumb drive.

To test the installation, you will require a sample of patron and user cards, a selection of RFID, EM or barcode
library items (depending on the technology / technologies used on the kiosk), and any additional items to test
other components such as the DVD unlocker and smartcard reader.

8 Bibliotheca.com
 2 Overview
This section provides an overview of the installation process. Details for each installation step are provided in
subsequent sections of this guide.

1. Install and connect components. See the appropriate hardware guide for the type of system you are
installing.
2. Determine the type of installation you will perform.
l Install new kiosk - See "Install quickConnect™ selfCheck on a new kiosk" on the next page.
l Upgrade an existing installation on an MP9 PC to Windows 10 - See "Upgrade an MP9 PC
running Windows 7 to Windows 10" on page 11.
l Replace defective hardware - See "Re-installing on a replacement PC" on page 16.
l Upgrade liber8 to quickConnect™ selfCheck on a Nexcom PC - See "Upgrade from liber8™ to
quickConnect™ selfCheck on a Nexcom PC" on page 20.
l Upgrade liber8 to quickConnect™ selfCheck on an MP9 PC - See "Upgrade from liber8™ to
quickConnect™ selfCheck on an MP9 PC" on page 23.
l Upgrade a Phoenix installation - See "Upgrade selfCheck 4.72.005.0 to quickConnect™
selfCheck" on page 25.
3. Install and test devices. See "Install and test devices" on page 36
4. Complete any additional required steps. See "Additional configuration steps" on page 86.
5. Complete System Manager configuration. See "Additional System Manager Tasks" on page 118.
6. Set a library user password. See "Set a library user password" on page 119.

9 Bibliotheca.com
 3 Install quickConnect™ selfCheck on a new kiosk
This section describes how to install quickConnect™ selfCheck on a new kiosk.

Complete the following steps.

1. Create a thumb drive with the most recent version of the quickConnect™ selfCheck installation files.

To create a thumb drive for installation of quickConnect™ selfCheck, a dedicated 2 Gb thumb drive is
recommended. Create the thumb drive BEFORE travelling to the installation site.

If you need to create a thumb drive, complete the following steps. Note that you must have administrator
privileges on the PC.
l Access the Product Zone, then download the most recent version of quickConnect™ selfCheck.

If you do not have access to the Product Zone, contact Bibliotheca Support to obtain the most
recent version of quickConnect™ selfCheck.
l Once the download is complete, unzip the files.
l Copy all folders and files from QuickConnect Setup Files to the thumb drive.
2. Install the new kiosk hardware.
3. Contact Bibliotheca Support to obtain a license file. The license file must be installed before features can
be enabled in quickConnect™.

See the quickConnect™ selfCheck System Manager User Guide for more information.
4. New kiosks have quickConnect™ selfCheck installed by default. Check the version number. You can find
the version number using the System Manager About tab.

The software version of quickConnect™ selfCheck installed on the kiosk will probably be out-of-date. If it
is, remove the existing quickConnect™ software using Add/Remove Programs, then use the installation
files on the thumb drive you created to install the most recent version.

10 Bibliotheca.com
 4 Upgrade an MP9 PC running Windows 7 to Windows 10
This section describes how to upgrade an existing installation of quickConnect™ selfCheck running on an MP9
PC and Windows 7, to Windows 10.

Complete the following steps.

4.1 Create a bootable thumb drive with the image

1. Create a bootable thumb drive containing the Windows 10 quickConnect™ selfCheck image.

A dedicated 32 Gb thumb drive is recommended for image application. Following the steps below
erases all data contained on the thumb drive.
a. Insert the thumb drive into a PC you have administrator access to.
b. From the Start menu, navigate to All Programs, then Accessories.
c. Right-click Command Prompt, then and select Run as administrator.
d. Enter Diskpart on the command prompt line,
e. Enter List Disk, then note the disk number assigned to the thumb drive.
f. Enter Sel disk <x> where <x> is the disk number noted in the previous step.
g. Enter Clean, then wait for the process to finish. This removes any hidden partitions or data that
may be on the drive.
h. Enter Create part pri to create a new primary partition on the thumb drive.
i. Enter Format fs=NTFS quick to format the new partition.
j. Enter Assign to assign a drive letter to the thumb drive. You may notice a Windows message
asking what to do with the new drive. If so, cancel the message dialog.
k. Enter Active to flag the drive as an active, bootable device.
l. Enter Exit to exit the diskpart utility.
m. Enter Exit to exit the command prompt.

2. Obtain the image files from Product Zone.

a. Navigate to Product Zone > Software Library > Bibliotheca Computer Images.
b. Open the ReadMe.txt file in the Bibliotheca Computer Images folder and copy the NextCloud
password.

c. Return to Product Zone> Software Library > Bibliotheca Computer Images, then click
NextCloudLink.url.

Note: The NextCloud link expires every 3 months. If the link does not work, contact the
Bibliotheca QA department to have the link refreshed.
d. Select HP.
e. Select MP9.
f. Select selfCheck.

11 Bibliotheca.com
 g. Select Win10LTSC2019.

h. Select the quickConnect image file.

Note: The file name will vary depending upon how recently the image was updated, but it will look
something like 20201202_HPMP9_Win10642019_qC.

i. Click Download All Files to download all 3 files.

Note: The file names will vary depending upon how recently the image was updated, but will look
something like the following examples.
l 20201202_HPMP9_Win10642019_qC.7z.001
l 20201202_HPMP9_Win10642019_qC.7z.002
l 20201202_HPMP9_Win10642019_qC.7z.003

3. Obtain a copy of the 7-zip application from:

https://www.7-zip.org/

4. Use 7-zip to extract the files from the downloaded .zip file.

Note: The zip file is automatically split into separate files for ease of uploading/downloading. When
using 7-zip to extract the files, it automatically combines the files before it decompresses them.
Extracting the files separately is not necessary or recommended.
5. After the files are extracted, copy the resulting folder structure to the thumb drive.
6. Properly eject the thumb-drive.

4.2 Check the current BIOS version on the computer

1. Open the Start Menu and type System Information.

2. Click the System Information icon in the Start Menu.

3. Locate and verify the BIOS version.

Note: The imaging process will not succeed if the computer BIOS is not equal to or newer than the
following versions: MP9 G2 “N21 Ver. 02.35” or MP9 G4 “Q22 Ver. 02.02.04”

4. Update the BIOS.

a. Navigate to the \BIOS\HP\HP MP9 <G2 or G4> Retail System folder on the image thumb drive.
b. Run the HPBIOSUPDREC64.exe.
c. Click Next to run the update.
d. Select Proceed without creating a partition, then click Next.

12 Bibliotheca.com
 e. Click Next again.

f. Click Next to acknowledge the warning.

13 Bibliotheca.com
 The application load the files and reboots several times to flash the BIOS into RAM.

The Update process presents dialogs which can be left to automatically select the default
answers. When finished the computer will reboot to the Desktop.

4.3 Apply the Windows 10 Image

1. Attach a keyboard to the computer.

2. Insert the thumb drive into a USB port.

3. Reboot the computer into the bios Startup Menu.

a. If the computer is already powered on, select Restart from the system menu, otherwise press the
power button.
b. Observe the USB devices and begin repeatedly pressing the <Esc> key once power is identified.
A once-per-second key press is all that is needed until the menu appears. The Keyboard power
can be identified if there is an observable LED for the Num Lock button. The Thumb drive power
can also be observed if it contains an LED. If no LEDs are available, begin pressing the <Esc>
key as soon as the computer monitor goes blank on a reboot.
c. Reboot the computer until the Start Up menu appears.

4. Select the Boot Menu option from the Startup Menu by using the up/down arrow keys to highlight Boot
Menu (F9), then press Enter or F9.

5. Use the up/down arrow keys to select UEFI USB DISK, then click Enter.

14 Bibliotheca.com
 The system boots from the USB drive and applies the BIOS settings and the Windows 10 image.

6. When the process is complete, remove the thumb drive, then press any key to continue.

Note: If any errors appear during the BIOS configuration process, note the error, the computer model,
and the BIOS version, then contact Bibliotheca Support for assistance.

7. The process reboots the computer when a key is pressed. In some instances the bios setting changes
may cause the system to produce a confirmation screen, where you will need to enter a 4-digit code (it is
displayed on screen). Follow the instructions and enter the code.

15 Bibliotheca.com
 5 Re-installing on a replacement PC
If a system fails and the only solution is to replace the PC, complete the following steps.

1. Obtain a bootable thumb drive with which to image the new PC. Complete the step BEFORE travelling
to the installation site. To create a bootable thumb drive for PC imaging, a dedicated 32 Gb thumb drive
is recommended.

If you need to create the bootable thumb drive, complete the following steps.

a. Insert the thumb drive into a PC USB port. You must have administrator priviledges on the PC.

b. Open the taskbar Start menu, then navigate to All Programs > Accessories.
c. Right click Command Prompt, then select Run as administrator.

d. When the command prompt appears, enter Diskpart.

e. When the Diskpart prompt appears, enter List Disk. Note the identifier assigned to the thumb
drive.

f. Enter Sel disk <x> (where <x> is the identifier assigned to the thumb drive).

g. Enter Clean. This removes all partitions (including hidden partitions) and data on the thumb drive.

h. After the clean function completes, enter Create part pri. This creates a new primary partition.

i. Format the new partition by entering Format fs=NTFS quick.

j. Assign a drive letter to the thumb drive by entering Assign. A dialog window may appear asking
what to do with the new drive. Cancel that dialog window.

k. Flag the drive as an active bootable device by entering Active.

l. Enter Exit to exit the diskpart utility.
m. Enter Exit to exit the command prompt.

n. Open a windows file explorer session and navigate to the root of the thumb drive.

o. Open another windows file explorer session and navigate to the Bootable ThumbDrive Files
folder (https://nextcloud.myBibliotheca.com/index.php/s/idAjPR3HwA8AnLe - Password: Biblio_
001)

p. Highlight all of the files and folders within the imaging utility folder. Right click and drag the group
into the thumb drive explorer session and select “Copy here” in the menu popup. These are the
files that are used to boot the computer into a WindowsPE environment.
2. Remove the defective PC.
3. Install the new PC.
4. Apply the installation image to the PC.

Complete the following steps.

a. If you are applying the installation image to a Nexcom PC, run the Productkey application to
obtain the Windows 7 Key (25 digit key) prior to applying the image. Without this key the process
will fail on a Nexcom PC.

16 Bibliotheca.com
 b. A replacement PC should have the OS installed. However, if a PC without an image is sent out,
complete this step.

Boot the PC. During the boot process, hold down the Esc key to access the PC BIOS settings.
l Ensure that the PC hard drive is the first boot device under the boot options. Uncheck all
options except USB Storage Boot (ensure that you remove any checkmark from UEFI
Boot Order).
l Configure the system to auto-boot after a power failure by setting After Power Loss to
Power On.
l Save your changes, then exit the BIOS settings.
c. Restart the PC. During the reboot, repeatedly press the F9 key until you hear an audible beep.
The Boot Menu appears.
d. Select the thumb-dirve as the boot device, then wait for the WindowsPE (appears as a command
prompt) to open the Acronis application.

The Acronis UI appears.

e. Select Recovery.
f. Select Browse for backup.
g. Locate the image file on the thumb-drive, select it, then click Ok. The recovery file name may vary
based on the image version, however, it will always feature a .tib extension.
h. Right-click the image, then select Recover. The following window appears.

17 Bibliotheca.com
 i. Click Next. Leave Recovery Method set to Recover whole disks and partitions.
j. Set Select the items to recover to Disk 1, then click Next.
k. Set Select destination of Disk 1 by selecting the desired hard drive, then click Next.
l. A True Image warning appears. Click Ok.
m. Click Proceed.
n. Select Shut down the computer when the operation is completed, then allow the process to
complete.
o. After the process has finished, remove the thumb-drive from the PC. Do NOT leave the thumb
drive in the USB slot. If it is not removed, the PC will attempt to boot from the thumb-drive.
p. Reboot the PC.

During reboot, the required devices and settings for the PC are installed. Note that the PC will
restart multiple times.
q. If installing on a Nexcom PC, you will be asked to input the Windows 7 Key (25 digit key) you
previously obtained.
r. When setup is complete, a window appears where you are asked to enter a PC name. Bibliotheca
suggests naming the PC "bib_serial number", where serial number is the serial number of the PC
(obtained from the rear of the PC or in the accompanying documentation). However, any name
the library would like can be entered.

Click Next after you enter the requested information.

s. Apply a licence file using System Manager (the license file must be created by Bibliotheca
support).
t. Configure all desired System Manager configurations (Appearance, Payment, Patron and Item ID
filters and validators etc.).

18 Bibliotheca.com
 If a user is challenged with a login password, the imaging process was not successful. If this
occurs, the PC must be re-imaged.

5. If you are installing a selfCheck™ 1000 or hybrid selfCheck™ 1000, enable the Windows setting for a
rotated screen.
a. Right click the desktop, then select Graphics Options from the menu.
b. Select Rotation.
c. Select Rotate to 270 Degrees.

19 Bibliotheca.com
 6 Upgrade from liber8™ to quickConnect™ selfCheck on a Nexcom
PC
6.1 Pre-installation
Before you begin the installation process, install Google Chrome and make it the default browser. This will
accelerate the configuration process using System Manager.

6.2 Installation
This section describes how to upgrade an existing liber8™ installation to a quickConnect™ selfCheck kiosk
featuring a Nexcom PC.

Complete the following steps.

1. Prior to beginning the installation process, empty all money from the kiosk. A full cash reconciliation
MUST be conducted prior to installation and the kiosk must not contain any funds.
2. Upload any pending offline transactions.
3. Enable Internet Information Services, Media Player and .NET.

Internet Information Services are enabled by default on the HP MP9 PC, but not on the Nexcom PC.
a. Select the Start menu, then select Control Panel, then Programs and Features.
b. Select Turn Windows features on or off.
c. Enable Internet Information Services, Media Player and .NET.
d. Click Ok.
4. Rename folder C:\ Program Files \ Bibliotheca \ Liber8 to Legacy liber8.
5. Remove liber8™ (optional),

a. Access Add/Remove Programs.

b. Select liber8, then click Uninstall and follow the prompts to delete liber8™ from the PC.

6. Remove all instances of SQL.

a. Access Add/Remove Programs.
b. Select SQL, then click Uninstall and follow the prompts to delete SQL from the PC. Repeat this
process for each instance of SQL.
c. Reboot the PC.

20 Bibliotheca.com
 7. Remove all unused files and directories.

8. Remove Smart Admin Client.

a. Access Add/Remove Programs.
b. Select Smart Admin Client, then click Uninstall and follow the promptes to delete Smart Admin
Client from the PC.
9. Run Clean up hard drive. This removes old hard drive images, and can make up to 25gb of space
available again.
10. Run the Productkey application to obtain the Windows 7 Key (25 digit key) prior to applying the image.
Without this key, the process will fail.
11. Install quickConnect™ selfCheck.
a. Access Sharepoint and download the latest version of quickConnect™ selfCheck.
b. Once the download is complete, open the folder and extract the compressed files to the desktop.
c. Start SelfCheckDriverInstall.

An installation wizard appears. Follow the prompts to install the quickConnect™ selfCheck
drivers.

When the driver installations are complete, restart the PC.

d. Start SelfCheckInstall.

An installation wizard appears. Follow the prompts to install quickConnect™ selfCheck.

When the installation is complete, restart the PC.

e. You will be asked to input the Windows 7 Key (25 digit key) you previously obtained.

f. When setup is complete, a window appears where you are asked to enter a PC name. Bibliotheca
suggests naming the PC "bib_serial number", where serial number is the serial number of the PC
(obtained from the rear of the PC or in the accompanying documentation). However, any name
the library would like can be entered.
g. Click Next after you enter the requested information.
12. After installation is complete, quickConnect™ selfCheck will automatically start whenever the PC boots
up.

Access the PC desktop by scanning an admin card and closing quickConnect™ selfCheck.

A liber8™ admin card may not work. If your admin card does not work, use Alt F4 to close quickConnect™
selfCheck.
13. Configure quickConnect™ selfCheck as you would for a new installation, as described in this installation
guide

The SelfCheck.ini file, located in Legacy liber8, contains configuration information.

21 Bibliotheca.com
 6.3 Additional Notes
6.3.1 Slow start-up time
quickConnect™ selfCheck version 1.66 or later includes a start-up animation which requires increased
processing power to render. Consequently, some Nexcom PCs experience long start-up times.

If the start-up time is unacceptable, it can be reduced by removing the start-up animation.

Complete the following steps.

1. On the affected PC, navigate to C:\Program Files\Bibliotheca\selfCheck QCI\bin\Assets\Videos\

2. Rename the following files by placing an “x” at the end of each filename.

Existing Filename Updated Filename

Bibliotheca_splash.wmv Bibliotheca_splashx.wmv

Bibliotheca_splash_portrait.wmv Bibliotheca_splash_portraitx.wmv

3. Subsequent start-ups for quickConnect™ will show the product version details and progress bar at the
bottom of the screen, but will not show the start-up animation.

6.3.2 Uninstalling liber8™ for disk space

There is no requirement to uninstall existing liber8™ software. However, doing so frees up several GB of space
on the hard drive.

6.3.3 Anti-Virus scans

Anti-virus scans affect the speed and performance of the software and PC during the scanning process.

You may notice that the first transaction (such as a check in or checkout) that is attempted on the kiosk after it is
turned on will take slightly longer to complete, due to an anti-virus scan. The delay should be minimal, adding
only a few extra seconds to the process.

22 Bibliotheca.com
 7 Upgrade from liber8™ to quickConnect™ selfCheck on an MP9
PC
This section describes how to upgrade an existing liber8™ installation to a quickConnect™ selfCheck kiosk
featuring an MP9 PC.

7.1 Pre-installation
Before you begin the installation process, enable Windows features for Internet Information Services:

1. From the Start menu, select Control Panel.

2. Select Programs and Features.
3. Enable Internet Information Services.

7.2 Installation
Complete the following steps.

1. Create a thumb drive with the most recent version of the quickConnect™ selfCheck installation files.
Note that you must have administrator privileges on the PC.

To create a thumb drive for installation of quickConnect™ selfCheck, a dedicated 2 Gb thumb drive is
recommended. Create the thumb drive before travelling to the installation site.

a. Access the Product Zone, then download the most recent version of quickConnect™ selfCheck.

If you do not have access to the Product Zone, contact Bibliotheca Support to obtain the most
recent version of quickConnect™ selfCheck.

b. Once the download is complete, unzip the files.

c. Copy all folders and files from QuickConnect Setup Files to the thumb drive.
2. Prior to beginning the installation process, empty all money from the kiosk.

A full cash reconciliation MUST be conducted prior to installation and the kiosk must not contain any
funds.
3. Upload any pending offline transactions.
4. If Google Chrome is not already the default web browser, download it and set it as the default browser.

Performance issues have been noted when using Internet Explorer to configure quickConnect™
selfCheck.
5. Remove liber8™ from the Startup menu.

If liber8™ is not removed, the kiosk will automatically restart twice during the installation process.
a. On the kiosk desktop, navigate to C:/User /(User name) / App Data / Roaming / Microsoft /
Windows / Start Menu / Programs.
b. Delete liber8™ from the folder.

23 Bibliotheca.com
 c. Navigate to C:/User /All Users / App Data / Roaming / Microsoft / Windows / Start Menu /
Programs. If liber8™ appears in this folder, delete it.
6. Install the new kiosk hardware.
7. Check the quickConnect™ selfCheck version number. You can find the version number using the
System Manager About tab.
8. If the version number is not the most recent version, use the install files on the thumb drive to update the
installation to the most recent version.

24 Bibliotheca.com
 8 Upgrade selfCheck 4.72.005.0 to quickConnect™ selfCheck
This section describes how to upgrade a selfCheck version 4.72.005.0 installation to quickConnect™
selfCheck.

8.1 Pre-requisites
When you need to minimise the quickConnect™ selfCheck interface, rick-click on the right hand side of the
screen, then select Minimize from the menu that appears.

Complete the following steps before beginning.

1. Acquire a quickConnect™ selfCheck license file.

2. Ensure that the existing selfCheck installation is at version 4.72.005.0.

If an earlier version is installed, you must upgrade the installation to this version.
3. If the selfCheck system is installed on a Windows Vista system, obtain the Ithaca printer driver for
selfCheck 4.7 and copy it to a thumb drive.
4. Run SaveState.

SaveState saves configuration settings and the last 12 months of statistics data from the existing
selfCheck installation to a zip file. It harvests data from the Assets and Config folders, located in:
l C:\ProgramData\3M Library Systems\3M SelfCheck\ (Windows 7 and Windows Vista)
l C:\Documents and Settings\All Users\3M\3M Library Systems\3M SelfCheck (Windows XP)
The .zip file is stored in C:\_Migration\SaveState or in a user specified location.

SaveState can be run either via the executable, or remotely via the command line.

To run the application from the command line, complete the following steps.
a. Open a command line prompt.
l On Windows Vista and Windows 7 machines, run the command line prompt as an
administrator. Press the Windows key, type Command, right-click the command
prompt, then select Run as Administrator.
b. Navigate to the directory where the 3MSaveState.exe file resides.
c. Run 3MSaveState.exe using the following syntax.
l /type – Specifies where data will be saved (local or ftp – Required)
l /spath – Source path (Optional – if not specified, defaults to configuration directory
path)
l /dpath – Destination path (Optional – if not specified, defaults to C:\_
Migration\SaveState)
l /filename – File name (Optional – if not specified, defaults to latest modified .lic file
name)
l /help – Lists command details

25 Bibliotheca.com
 Once SaveState is running, the main SaveState interface appears. The Source, Destination and
FileName fields populate with default values. Normally, you will not need to change default values.

Click Save to generate a .zip file using the specified Source file(s).

Once the process completes, click Ok.

5. Backup the existing selfCheck installation.

If the selfCheck installation is NOT managed by Command Center, complete the following steps.
a. Plug in a thumb drive and create a backup folder on it using the serial number of the existing
selfCheck installation as the folder name.
b. Access System Manager as the advanced user.
c. At the bottom of the screen, click Export Settings, choose Save as, then save settings to the
backup folder.
d. Stop the selfCheck software.
e. Stop the SQLEXPRESS service.
i. Enter WINDOWS + R to display the command prompt.
ii. Enter services.msc, then click Ok.
iii. Locate and stop SQL Server (SQLEXPRESS).

If you see a notice about stopping the Update Agent, click Yes.
iv. Browse to one of the following:
l Windows Vista: C:\Program Files\Microsoft SQL Server\MSSQL.1\MSSQL\Data
l Windows 7: C:\Program Files (x86)\Microsoft SQL Server\MSSQL.1\MSSQL\Data
l Windows XP: C:\Program Files\Microsoft SQL Server\MSSQL.1\MSSQL\Data

And copy these files to the backup folder.

26 Bibliotheca.com
 l BLData.mdf
l BLData_Log.ldf
l Library.mdf
l Library_Log.ldf
l NCIPScheme.mdf
l NCIPScheme_Log.ldf
v. Re-start the SQLEXPRESS service by doing the following.
a. Enter WINDOWS + R to display the command prompt.
b. Enter services.msc then click OK.
c. Locate and start the SQL Server (SQLEXPRESS).

If the selfCheck installation IS managed by Command Center, complete the following steps.
a. Plug in a thumb drive and create a backup folder on it using the serial number of the existing
selfCheck installation as the folder name.
b. Access System Manager as the advanced user.
c. Select the Support tab.
d. Click Export Settings, choose Save as, then save settings to the backup folder.
6. Save tag data format settings.

Complete this procedure only if:

l The system uses RFID.
l quickConnect™ selfCheck will be installed on a different system than the previous selfCheck 4.7
system.

It is extremely important that tag formats and versions used on the new quickConnect™ selfCheck
system be the same as the formats and versions used on the 4.7 system.

See "Appendix A: Tag Data Formats" on page 176 for detailed information regarding tag formats.
a. Shut down the selfCheck software.
b. Create a Notepad text file.
c. Access and record tag format information by completing the following steps.
i. Click Start, then enter HwDiagnostics in the search box.

ii. When selfCheck Diagnostics application appears, select RFID Reader, then click Tag
Manager Config.

iii. Click Configure Tag Data Formats.

iv. Click Status.

v. Select and copy the TDF Status information into the Notepad text file.

27 Bibliotheca.com
 vi. Save the Notepad file to the thumb drive.
d. Exit the HwDiagnostics application.
e. Locate the TDFMConfiguration.xml file in C:\Program Files \3M\Common\TagManager and copy
it to the thumb drive.
f. Scan the Tag Manager folder to identify “secondary files”. These are files needed to support
custom formats. You can identify a secondary file by its nearly identical name to a .tdi file, the only
difference being the file name extension. (In the example, Custom_STL.tdi has a secondary file
with an xml extension, though secondary files may have other extensions as well.)

g. Copy every secondary file and its parent .tdi file to the thumb drive.
7. Uninstall the old selfCheck system software.

Complete this step only if quickConnect™ selfCheck will be installed on the same computer as the
previous version of SelfCheck software. (This means it is limited to Windows Vista, Windows 7 and
Windows 10 systems, and will never apply to Windows XP systems, which do not support
quickConnect™ selfCheck.)

28 Bibliotheca.com
 a. Uninstall the selfCheck 4.7 installation using the Programs and Features utility in the Control
Panel. Uninstall both the selfCheck systems software and the Automatic Updates software.
b. Delete folder C:\ProgramData\3M.
c. Delete the following directory.
l Windows 7 and 10 systems: C:\Program Files (x86)\3M Library Systems.

l Windows Vista systems: C:\Program Files\3M Library Systems.

d. Restart the system.
8. Check the display adapter driver.

Complete this step only if both of the following are true.

l quickConnect™ selfCheck will be installed on the same Vista computer as the previous version of
the selfCheck software.
l The system is an HP 5700 with an integrated Intel graphics card.
a. Check the graphics card driver version.
i. Open the Device Manager, then select Display Adapters.
ii. Right-click the display adapter, then select Properties.
iii. Select Details.
iv. Open Properties, then double click the Driver Assembly Version.
v. Ensure that the driver version is newer than version 7.14.
b. If required, update the driver.
i. Copy the new driver from your thumb drive.
ii. Double click the sp41523.exe executable file and respond to the prompts.
iii. When prompted, restart the PC.
9. If required, uninstall the Ithaca printer.

Complete this procedure only if quickConnect™ selfCheck will be installed on the same system as
the previous selfCheck software.
I. Ensure that the Ithaca printer is not the default printer.
a. On Windows 7, open the Control Panel, select Hardware and Sound, then select View
Devices and Printers.

On Windows Vista, click Start, then Settings, then Printers.

b. Ensure that the Ithaca printer is not the default printer. The default printer is designated by
a check mark.
c. If the Ithaca printer is the default printer, temporarily choose another printer by right
clicking on its icon and choosing Set as default printer. You can use the Generic XPS
Document Writer or another printer for this purpose.

29 Bibliotheca.com
 Note: If there are no generic printers to temporarily assign as the default printer, complete the
following steps.
i. From Devices and Printers, click Add a Printer, then Add a Local Printer.
ii. Choose Use an Existing Port, select a port, then click Next.
iii. Select Generic as the Manufacturer, then select Generic/Text only as the printer.
iv. Click Next.
v. Choose Use the driver that is currently installed, then click Next.
vi. Use the default printer name, then click Next.
vii. Choose Do not share this printer, then click Next.
viii. Click Finish.
II. Uninstall the Ithaca print driver.
a. Open the Control Panel.
l On Windows 7, select Programs, then Programs and Features.
l On Windows Vista, select Programs and Features.
b. If it is present, right click on IthacaSetup and choose Uninstall. If prompted, restart the PC.
c. From the Control Panel:
l On Windows 7, select Administrative Tools, then Print Management, then
Custom Filters, then All Printers.
l On Windows Vista, double click Ithaca USB Manager. Select the Ithaca printer,
then select Remove All.
d. Right click the Ithaca printer (if present), then select Delete or Remove All and respond to
any prompts.
III. On Windows Vista only, remove the ITherm280 printer (if present).
a. Open the Control Panel, then select Printers.
b. If the ITherm280 printer icon is present, right click it, select Delete, then click Yes at the
prompt.
c. Right click on the Printer's window background, select Server Properties, then select the
Drivers tab.
d. Select Itherm280 from the list, then click Remove.
e. If prompted select Remove Driver and driver package.
f. Respond to the prompts.
g. Exit the Control Panel.
10. Install the most recent version of quickConnect™ selfCheck device drivers and software using the
procedues described in "Install quickConnect™ selfCheck on a new kiosk" on page 10.

30 Bibliotheca.com
 a. Check the screen resolution.
l Windows 7 – Right click on the desktop, then select Screen Resolution.
l Windows 10 - Right click on the dektop, Choose Intel Graphics settings, then select
Display.
l Windows Vista – Right click on the desktop, choose Graphics Properties, then select
Display Settings.
b. If required, change the resolution based on the monitor in use.
l 19” (16:9) monitors (newer) – 1440 x 900
l 15 – 17” (4:3) monitors (older) – 1024 x 768
11. Restore tag data format settings.

Complete this procedure only if quickConnect™ selfCheck is being installed on a different system
than the previous version of selfCheck, and this is an RFID system.

Note: You must install the same formats and versions as on the previous system.

To restore tag formats and versions used on the previous system, complete the following steps.
a. Navigate to the folder containing the TagManager files.
l Windows 7 & 10: C:\Program Files (x86)\3M\Common\TagManager
l Vista: C:\Program Files\3M\Common\TagManager
b. Rename file TDFMConfiguration.xml to TDFMConfiguration.xml.org.
c. Copy the TDFMConfiguration.xml file you saved to the thumbdrive during the backup procedure,
to the folder.
d. Copy any secondary and tdi parent files saved during the backup procedure.
e. Ensure that the new system has the same tag format and versions as the old system.
i. Open the Notepad file you used to store tag format information from the old selfCheck
system.
ii. Start the selfCheck Technician Tool.
iii. Select RFID Reader.
iv. Click Test.
v. Click Tag Formats.
vi. Click Status.
vii. Compare the contents from the Notepad file with TDF Status on your screen.

31 Bibliotheca.com
 viii. If they are the same, exit this procedure. If they are different, continue with this procedure
to install the correct formats.
f. Locate the correct tag formats and versions using the information on your thumb drive and
provided in "Appendix A: Tag Data Formats" on page 176.
g. To install a format, click the Setup.exe file for each of the formats and follow the prompts.

32 Bibliotheca.com
 12. Run SelfCheck Transformer.

SelfCheck Transformer allows you to transfer saved data to a SQL Compact database (XML file) on the
new user's Windows 7, Windows 10 or Windows Vista machine.

When Transformer is run, the configuration file and the statistics database for the existing selfCheck
installation on the target machine are overwritten.
a. Start the selfCheck Transformer software.

To start selfCheck Transformer from the Start menu:

i. Click Start, select Programs, then 3M Library Systems, then Migrate old 3M SelfCheck
data.

To start selfCheck Transformer from a command line:

i. Open a command line prompt using administrator privileges.
ii. Navigate to the directory where the SelfCheck.transformer.exe file resides.
l 32 bit systems – C:\Program Files\3M Library Systems\3M SelfCheck QCI\bin
l 64 bit systems—C:\Program Files (x86)\3M Library Systems\3M SelfCheck QCI\bin
iii. Run SelfCheck.transformer.exe using one of the following syntax.
l SelfCheck Transformer.exe /[Transform Option] /[Path Option]
l SelfCheck Transformer.exe /[Restore Option] /[Path Option]
l SelfCheck Transformer.exe /[Help Option] /[Path Option]
Options

[Path Option]

/s – Auto selection of .zip file (using transformer_path.xml for input and output directories).

/Path= - Use Path to select .zip file (for input .zip file).

[Transform Option]

/All – Transform both database and configuration.

/Database—Transform database only.

/Config - Transform configuration only.

[Help Option]

/Help or /?– Show help screen.

After selfCheck Transformer starts, the main menu appears.

33 Bibliotheca.com
 b. Ensure that Input File points to the SaveState zip file location.
c. Click Transform.

After Transformer has finished, view the status of each included item by clicking Detailed
Configuration, then scrolling through the list.

An Exit Code appears, with a numerical value, under Events. Exit Code definitions include:
l 0 – No errors detected during transfer.
l 1 – Error occurred while attempting to transfer the statistics database. Either the database
could not be located, or the file was corrupt.
l 2 – Error occurred while attempting to transfer the configuration. Either a required file could
not be located, or a file was corrupt.

View details regarding errors in the log file available in the directory specified under Logging.

34 Bibliotheca.com
 9 Downgrade from quickConnect™ selfCheck v1.79 and later to
earlier version
If quickConnect™ selfCheck v1.79 or later is installed on a kiosk and you are required to
downgrade to an earlier version of the software, you must uninstall the version of Tag
Manager as well as the quickConnect™ selfCheck software before attempting to install
the earlier software version.

This is because the version of Tag Manager (v3.35.005.0) released with quickConnect™
selfCheck v1.79 is incompatible with earlier versions of the software.

35 Bibliotheca.com
 10 Install and test devices
Install and test quickConnect™ selfCheck devices included in the installation.

10.1 Fujitsu FP-1000 printer

10.1.1 Install the Fujitsu FP-1000 printer
If the installation features a Fujitsu FP-1000 printer, complete the following steps.

1. Use Windows file explorer to navigate to C:\Program Files (x86)\Bibliotheca\Drivers\Fujitsu FP-1000

Printer Driver\Data\Installer\.
2. Locate and run FP-Installer.exe.

3. Select English from the language drop-down, then click Ok.

4. Click Install.

5. Accept the terms, then click Next.

6. When the Connect printer window appears, click Ok.

7. The Select Items to Install screen appears. Select USB-USB001 for Interface/Port Number.

8. Under Software to Install, scroll down to Utility and Manuals and ensure that it is NOT selected.
9. Click Install.

10. When the Windows Security windows appears, select Install.

11. When the installation is complete, click Finish.

12. Select Restart now.

10.1.2 Configure and test the Fujitsu FP-1000 printer.

1. Run the SelfCheck Tech Tool application.
2. Select Fujitsu FP-1000 Printer.

36 Bibliotheca.com
 3. Select Role, then click ... (ellipsis).
4. Select PrintReceipt and PrintReport, then Ok.
5. Select WindowsPrinterName then click ... (ellipsis).
6. Select FIT FP-1000 Raster, then click Ok.
7. Click Save Changes.
8. Click Test.
9. Click Print Receipt.
10. Ensure that a receipt has printed, then close the Test window.
11. Close the selfCheck TechTool application.

10.1.3 Configuring Fujitsu FP-1000 printer page length

To configure the page length settings for a Fujitsu FP-1000 printer, complete the following steps.

1. Locate the printer control option page on your PC.

l Vista - Printers
l Win 7 - Devices and Printers.
l Win 10 - Devices and Printers
2. Ensure that the Fujitsu FP-1000 printer is set as the default system printer. If it is not, right-click on its
icon and check Set as default printer.

3. Right-click on the printer icon and select printer properties.

l Vista - Properties
l Win 7 - Printer properties
l Win 10 - Printer properties

37 Bibliotheca.com
 4. Select the Custom Paper tab.

The following screen appears

5. Check Create a New Paper (1).

6. Enter a custom name in Paper Name (2).
7. Enter 2039.9 in Paper Height (3).
8. Click Save (4).
9. Click Apply.
10. Click Ok (5).

11. Right-click on the printer icon, then select Printing preferences.

12. Select the desired custom Paper Size (it will display with the name you entered in Paper Name).

38 Bibliotheca.com
 13. Keep the default values for all other settings (shown in the following example).

14. Click Paper Cut and Paper Feed here for Vista and Win 7. To configure Paper Cut and Paper Feed
settings for Win 10, use the instructions that follow this process.

15. Ensure that Start of Document > Paper Cut is set to Off.
16. Ensure that End of Page > Paper Cut is set to Off.

39 Bibliotheca.com
 17. Ensure that End of Document > Paper Cut is set to On (Partial Cut).
18. Click Ok to exit the Paper Cut and Paper Feed window.
19. Click Ok to exit the Printing Preferences window.

For Windows 10 kiosks, you will also need to complete the following steps to ensure that paper receipts are not
cut off early when the receipt lists a lot of items:

1. Go to Control Panel > Devices and Printers, right-click on the FP-1000 printer and select Printer
properties,
2. Go to the Advanced tab and click the Printing Defaults button

40 Bibliotheca.com
 3. In the Paper Size drop down menu, select MaxLength,

4. Select Paper Cut and Paper Feed,

41 Bibliotheca.com
 l Ensure that Start of Document > Paper Cut is set to Off.
l Ensure that End of Page > Paper Cut is set to Off.
l Ensure that End of Document > Paper Cut is set to On (Partial Cut).

5. Click OK to close all the dialogs, and then try printing again.

42 Bibliotheca.com
 10.2 Masung EP802-TMP Printer
10.2.1 Install Masung EP802-TMP Printer
Install Masung driver from U:\Global - Products\Drivers\Printers\Masung and follow the installation wizard.

10.2.2 Configure and test the Masung EP802-TMP Printer

1. Run the SelfCheck Tech Tool application.
2. Select Masung Printer.
3. Select Role, then click ... (ellipsis).
4. Select PrintReceipt and PrintReport, then Ok.
5. Select WindowsPrinterName then click ... (ellipsis).
6. Select w80, then click Ok.
7. Select ReportLowPaperWarning and enter True to report on low paper (default) or False to disable the
warning.
8. Click Save Changes.
9. Click Test.
10. Click Print Receipt.
11. Ensure that a receipt has printed, then close the Test window.
12. Close the selfCheck TechTool application.

10.2.3 Windows Printer Configurations

1. Locate the printer control option page on your PC.
l Win 7 - Devices and Printers.
l Win 10 - Devices and Printers
2. Ensure that the w80 printer is set as the default system printer. If it is not, right-click on its icon and check
Set as default printer.
3. Select Printer Properties > Device Settings.
4. Set the Page Cut Mode to No Cut. Long receipts will be printed in full instead of on multiple slips of
paper.
5. Set Print End Blank to Off to stop the receipts printing longer than required.
6. Click OK to close all the dialogs, and then try printing again

10.3 Star C-Print 3 Printer

New selfCheck units ship with a Star C-Print 3 printer installed. These units already have the required driver
software installed.

43 Bibliotheca.com
 If an older model printer installed in an existing selfCheck kiosk fails, it must be replaced with a new Star C-
Print 3 printer.

A retrofit kit is available in Netsuite (SCK329015-000). This kit includes a Star C-Print 3 printer, a new door, and
the required mounting bracket.

10.3.1 Star C-Print 3 Printer Driver Installation

If you need to install the required Star C-Print 3 printer driver, complete the following steps.

1. Download the v2.2.1 Star C Printer Driver zipped folder from the Self Service section of the Sharepoint
Product Zone Software Library.
2. Extract the driver folder from the zip file.
3. Ensure that the Star C-Print 3 printer is not plugged into the PC.

4. Run Setup.exe (from the v2.2.1 Star C Printer Driver folder).

44 Bibliotheca.com
 The installation Wizard Welcome screen appears.

5. Click Next.

The License Agreement screen appears.

6. Select I accept the terms in the License Agreement, then click Next.

45 Bibliotheca.com
 The Setup Type screen appears.

7. Click Typical.

The Ready To Install screen appears.

8. Click Install.

The installation Wizard installs the driver.

9. When the driver installation is complete, the Completed screen appears. Click Finish to exit the driver
installation Wizard.

10. Connect the Star C-Print 3 printer to the PC.

The PC will automatically locate the Star C-Print 3 printer driver.

46 Bibliotheca.com
 10.3.2 Star C-Print 3 Printer Windows Settings
Complete the following steps to complete the Windows installation.

1. Access the Windows Control Panel.

2. Select Devices and Printers.
3. Select the Star C-Print 3 printer as the system default printer.

Note: You do not need to configure the printer Receipt Length (this was required for the Fujitsu FP-1000
printer, but is not necessary for the Star C-Print 3 printer).

47 Bibliotheca.com
 10.3.3 Star C-Print 3 Printer quickConnect Configuration
Complete the following steps to configure the Star C-Print 3 printer in quickConnect.

1. Open the selfCheck quickConnect Technician Tool.

2. Select the Star mC Print3 printer.

3. Enable the following settings for Role.

l PrintReceipt
l PrintReport
4. Select Star MCP31 as the Windows Printer Name.
5. Select True for ReportLowPaperWarning.

6. Click Save Changes and exit the Technician Tool.

48 Bibliotheca.com
 10.4 Datalogic Gryphon GFS4170 bar code scanner
If the installation includes a Datalogic Gryphon GFS4170 bar code scanner, and the scanner has not been pre-
programmed, complete the following steps to configure the scanner.

1. Scan the following barcode. When you scan the bar code, the reader should emit a beeping sound and
the green light should flash.

2. Disconnect the scanner from the PC, then reconnect the scanner. The green light flashes, the reader
beeps and the amber light illuminates.
3. Wait a few seconds, then scan the following bar code.

4. Press the blue button to scan the following bar code.

5. Press the blue button to scan the following bar code.

49 Bibliotheca.com
 6. Wait a few seconds, then test the scanner.

A. When using the scanner in USB-COM mode, the scanner will not write to Notepad.
B. Scan each bar code from the preceding steps using a serial monitor such as PUTTY, Serial
Device Tester, or the quickConnect™ selfCheck Tech Tool.
C. Ensure the following.
l The red bar code reader beam is on.
l Each scan is indicated with a beep from the scanner.

10.4.1 Datalogic GFS4170 barcode scanner firmware

Datalogic GFS4170 barcode scanner firmware version R96-9582/12/03/2010 is fully supported by
quickConnect.

If the installation is upgrading a legacy system, the scanners will require a firmware update. See the next
section for instructions.

10.4.1.1 Firmware update for Legacy Systems

If the firmware for the scanner needs to be updated, complete the following steps.

1. Install and run Datalogic Aladdin. The following screen appears.

l On some systems, Datalogic Aladdin may not run due to issues involving Java. In these cases,
download Aladdin onto a laptop, then connect the scanner to the laptop.

50 Bibliotheca.com
 Download Datalogic Aladdin using the following link.

http://www.datalogic.com/eng/support-services/automatic-data-
capture/downloads/software-utilities-sw-2.html?search_prod=167

2. Connect the barcode scanner.

3. Select Device Autodetection.

4. Select Search For One Device. The software should detect the GFS4170 scanner.

5. Select Firmware Upgrade from the Tools menu.

51 Bibliotheca.com
 6. When the following window appears, select Load firmware file.

7. Select firmware file 610009007.dfw, then click Open.

8. Details about the firmware and device version appear. Select Firmware Upgrade with USB Cable.

52 Bibliotheca.com
 9. Datalogic Aladdin will ask you to reset the device manually.

l Remove power from the scanner by unplugging the power cord, then reapply power while
keeping the blue button depressed.
l The application will begin updating the firmware.

10. Once the update is complete, if the Wait End Operation bar remains active for more than another 60
seconds, click the red button next to the bar to end the process.

11. Close the Firmware Update window, then close Aladdin.

10.4.1.2 Firmware verification

10.4.1.2.1 Keyboard wedge mode

If the scanner is in keyboard wedge mode, open Notepad and scan the following barcode.

53 Bibliotheca.com
 10.4.1.2.2 USB-COM mode

If the scanner is in USB-COM mode, use Putty.

Download Putty using the following link.

http://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html

Install the software, then complete the following steps.

1. Connect the barcode scanner to the PC.

2. Open Device Manager, then open Ports (COM & LPT).

3. Locate USB Serial Device (COMx) (where "x" is the assigned COM port).

4. Run the Putty application.

54 Bibliotheca.com
 5. Under Session, select Serial, then enter the assigned COM port in Serial Line.

6. Click Open.

7. Scan the following barcode to update the firmware.

55 Bibliotheca.com
 10.4.2 Configure and test the scanner
Configure and test the barcode scanner.

Use System Manager to configure the role for the scanner, such as for item IDs, customer IDs, etc.

1. Ensure that the barcode scanner is configured in USB-COM mode.

2. Locate the COM port the barcode scanner is connected to:
l From the Start menu, select Control Panel, then Device Manager.
l Expand Ports (COM & LPT).
l The port will be listed as Serial Port for Barcode Scanner (COMx) where x is the COM port
number.
3. Run the SelfCheck Tech Tool application.
4. Select Datalogic Barcode Scanner.

5. Select Role, then click ... (ellipsis).

6. Enable any required features among Identify Patron Account, Identify Library Item, and Identify
Administrator User, then click Ok.
7. Select PortName, then click the drop down list.
8. Select the port number you previously identified.
9. Ensure that you remove the existing value for NewLine (it should be blank).
10. Set DevicePnPName to Serial Port for Barcode Scanner (COMx).
11. Click Save Changes.
12. Click Test.

56 Bibliotheca.com
 13. Select Initialize, then click Start under Scan Line. Current Status should indicate Ok.
14. Click Setup Barcode Symbologies.
15. Configure the barcode symbologies the library requires.
a. Remove selections the library does not use. This will improve scanner performance.
b. Choose Validate the checksum digit if the symbology uses a checksum.

c. Choose Output start/stop characters (Codabar) only if the circulation system requires this.

d. Configure either a fixed length or a variable length symbology.

l Fixed Length

Complete the following steps.

i. Enable Use fixed symbol length(s).

i. Specify barcode length in Minimum length or fixed length 1. If there are two
barcode lengths used in the library for this symbology, specify the length of the
second in Maximum length or fixed length 2. Otherwise, set both length fields to
the same value.
l Variable length

Complete the following steps.

i. Ensure that Use fixed symbol length(s) is NOT enabled.
ii. Set Minimum length or fixed length 1 and Maximum length or fixed length 2 to
the length of the shortest and longest barcodes of this symbology used at the
library.

57 Bibliotheca.com
 16. Click Save.

17. Test each configured barcode by completing the following steps.

l Click Start.

The scan line appears.

l Place a barcode (i.e., the provided patron card or Admin card) on the scan line and ensure that
the result shown in Barcode is the expected result.
l Repeat these steps for each symbology configured.
18. After you have tested all configured barcodes, click Shutdown, then exit the Test dialog box.

58 Bibliotheca.com
 10.5 RFID Reader
Complete the following steps to configure the RFID reader.

See "Appendix A: Tag Data Formats" on page 176 for detailed information regarding tag data formats.

Use System Manager to configure how the device will be used.

1. Start the SelfCheck Tech Tool application.

2. Select RFID Reader.

3. Select Role, then click ... (ellipsis).

4. Enable IdentifyLibraryItem, ChangeLibraryItemSecurity and IdentifyAdministratorUser, then click Ok.

5. Select ReaderType, then choose Feig from the drop-down menu.

l On Legacy systems, ReaderType is MMM.

6. Select ConnectionMethod, then choose USB_FEUSB from the drop-down menu.

l On Legacy systems, ConnectionMethod is Serial.
7. Click Save Changes.
8. Click Test.
9. Click Initialize.

10. Place an item under the kiosk reader and check that the barcode of the item is displayed in the left-hand
bottom window.

If the RFID tag is not read, see "RFID Reader Tag Format Security" on the next page.
11. Click Shutdown, then close the Test window.

59 Bibliotheca.com
 10.5.1 RFID Reader Tag Format Security
Many sites use standard tag format security methods built into the RFID reader configuration. These methods
can be selected from the drop-down list in the RFID reader configuration. They are shown in the following table,
along with the values used to indicate tag unsecure and secure states.

Security Method AFI Unsecure AFI Secure

3M security (version 2) 0xC2 0xDA

Danish AFI proposal 0x9D 0x9E

EAS --- ---

ISO AFI 0xC2 0x07

EAS with ISO AFI * 0xC2 ---

3M security (version 1) 0xD7 0xDA

* The EAS with ISO AFI method does not set the AFI to a secure value when a tag is programmed or an item
checked in. It only sets the unsecure value when an item is checked out.

60 Bibliotheca.com
 10.5.1.1 Custom security
Use the following procedure to configure a custom security method for RFID reader tag formats.

Complete the following steps.

1. Obtain the following information.

l Security method used at the site. The security method must be one of the following:
l AFI
l EAS and AFI
l Hexadecimal numbers used to indicate the unsecure and secure states of RFID tags.

1. Start the Windows calculator, then select Programmer from the drop-down menu.

2. Select Hex as the number system.

61 Bibliotheca.com
 3. Enter one of the following numbers on the calculator.
l For AFI, enter 1.
l For EAS and AFI, enter 3.

4. Enter the number for the unsecure value. Enter it as a 2 digit number (example: 07 for 7). In the
example, this is 91 (the number Bibliotheca Tag Data Format / DM11 & DM12 use for unsecure).

62 Bibliotheca.com
 5. Enter the number for the secure value. Enter it as a 2 digit number. In the example, this is 92 (the
number Bibliotheca Tag Data Format / DM11 & DM12 use for secure).

6. Convert the number to decimal by selecting Dec.

63 Bibliotheca.com
 7. Open the selfCheck Tech Tool, select RFID Reader, click Test, then click Tag Formats.
l The Configure Tag Formats window appears. Note that this window may vary in appearance from
the example shown below.

8. Enter the decimal value in Custom.

9. Click Ok to save the configuration.

64 Bibliotheca.com
 10.5.2 Support for multiple AFI values
This feature allows a library to manage multiple AFI values so that they can create specific collections that can
be borrowed and used within the library but cannot be taken out of a specific area (or library building).

To support multiple AFI values:

1. Open selfCheck™ configurator.

2. Select RFIDSecurityCategory, and then select Modify.
3. Set the Enabled setting to true.
4. Under UnsecureValueMapping, set the SecurityCategory value to a value returned by the LMS / ILS,
and the DeviceValue to either 0 for the default AFI unsecure value or -2 for the optional unsecure value.
5. Save the changes.
6. Open the selfCheck Tech Tool.
7. Select RFID Reader.
8. Click on the Test button and then click on Tag Format.
9. From the drop down menu, select SecurityMethod#2.
10. Select the Custom button.
11. Check the AFI checkbox and enter a Hexadecimal value for the optional Unsecure value.
l This is the value that will be used when -2 is sent as the device value.

12. Select OK.

13. Select Save.

65 Bibliotheca.com
 10.6 L-Coil Electro Magnetic (EM) Security Device
If the installation features an EM sensitizer, complete the following steps to configure and test the L-Coil
Magnetic (EM) Security device.

1. Run the SelfCheck Tech Tool application on the kiosk.

2. Select L-Coil EM Security Device.

3. Select Role, then click ... (ellipsis).

4. Enable ChangeLibraryItemSecurity, then click Ok.

5. Select DevicePnPName, then enter 3M Library Systems M6310 SelfCheck Coil Driver.
6. Click Save Changes.
7. Click Test.

8. Click Initialize.

9. Select Thump. Ensure that the EM sensitizer emits an audible "thump".

10. Click Shutdown, then close the Test window.

10.6.1 Multiple-Book Detection (MBD) Calibration

Bibliotheca hybrid selfCheck™ component systems with multiple book detection (MBD) require MBD
calibration.

10.6.1.1 Introduction
To prevent library patrons from checking out a single item while turning off security on multiple items, hybrid
selfCheck™ component systems must detect if more than one item is in the V-Cradle during checkout. An
individual sensor cannot perform this task. An array of sensors, each monitoring a small area within the V-
Cradle, work in conjunction with the system software to detect and report the presence of multiple security
strips.

Multiple items are assumed to be in the V-Cradle whenever a security strip is detected by 3 or more sensors,
provided that the sensors are also non-adjacent.

An exception to MBD rules involves the bottom two sensors on each side of the V-Cradle.
The sensors on one side are so close to the sensors on the other that a single strip could
easily be detected by all four. Consequently, these fours sensors will never trigger an
MBD state unless a sensor above the bottom four is also involved.

In the following example, only the instances represented by the columns marked Yes with a red background
would report the presence of multiple items.

66 Bibliotheca.com
 3 or more sensors? No Yes Yes Yes No

Non-adjacent sensors? No Yes No Yes No

10.6.1.1.1 Sensor calibration

Calibration is required to ensure that each sensor can detect a strip within the area it monitors, but is not so
sensitive that it detects strips in areas monitored by other sensors.

The ideal is a system that triggers an MBD state each time there are multiple strips in the V-Cradle, but never
when only a single strip is present. However, this is not always achievable. A patron placing a single item in the
V-cradle at a steep angle can set off non-adjacent sensors. Two very thin items held together might be
detected by only a single sensor, or only adjacent sensors. Additionally, some strips are more sensitive than
others, which means a system might not work in all instances.

Careful calibration will minimize—but not eliminate—these issues. The library has to determine the tradeoff
between an overly sensitive system and one that sometimes misses a true MBD condition.

10.6.1.2 Tools required

Tools required for calibration include:
l The MBD calibration utility (discussed below)
l Items from the library for verification purposes
l The MBD calibration kit, which consists of the following items:
o An MBD calibration template, used to identify sensor location and positioning sensitized strips
during calibration.
o A normal sensitivity strip
o A high sensitivity strip
o A calibration template (not shown) for a four-board V-Cradle

67 Bibliotheca.com
 10.7 ID TECH magnetic card reader
If the installation includes an ID TECH magnetic card reader, use the following procedure to configure the
device.

Use System Manager to configure the role for the card reader, such as to identify
patrons, for payments, etc.

Complete the following steps.

1. Start the Technician Tool.

2. Select ID TECH Magnetic Card Reader.

3. If required, configure a COM port (PortName). Do NOT test the reader with an active credit card.
l Click Save.
l Click Test.

4. Click Initialize, then click Start.

5. Run a card through the reader and ensure that correct card data appears in Card Data.

6. When the card reader is working properly, click Shutdown, then exit the Test dialog box.

68 Bibliotheca.com
 10.8 Unlockers
If the installation features a disc unlocker, complete the following steps to configure and test the unlocker. Use
System Manager to configure how the device will be used.

1. Locate the COM port the unlocker is connected to:

l From the Start Menu, select Control Panel, then Device Manager.
l Expand Ports (COM & LPT).
l Complete this step only for an integrated 1230 unlocker. Stand alone unlockers do not use this.
l The port will be listed as USB Serial Port (COMx), where x is the COM port number.
l If there are 2 devices with this description, but with different numbers, then one will be for
an Innovative cash device and the other is for the unlocker. The COM port used by the
case device can be identified by locating it in PIPs.
l Ignore the cash device number. The remaining device number is for the unlocker.
2. Run the SelfCheck Tech Tool application.

3. Select the type of unlocker being installed ( SmartCase 550 Unlocker, Disc Media Unlocker K-Series,
or Integrated Disc Media Unlocker.
4. Select Role, then click ... (ellipsis).

5. Enable UnlockCase, then click Ok.

6. Enter the COM port used by the unlocker in PortName.

7. Enter the COM port used by the unlocker in DevicePnPName.

8. Click Save Changes.
9. Click Test.
10. Select Initialize.
11. Click Start.

12. Insert a case into the unlocker, then select Unlock.

13. Ensure that the device emits an audible "click" and that the case has been unlocked.
14. Click Stop.
15. Click Shutdown, then close the Test window.

16. Close the selfCheck TechTool application.

69 Bibliotheca.com
 10.9 Kiosk indicator lights (SmartServe 1000 IO Board)
If the selfCheck 1000 or hybrid selfCheck 1000 installation features kiosk indicator lights, complete the
following steps to configure and test the indicator lights.

1. Ensure that the IO Board is connected to the PC port.

2. Start the SelfCheck Tech Tool application.

3. Select SmartServe 1000 i/o board.

4. Select Role, then click ... (ellipsis).

5. Enable ControlLights, then click Ok.

6. Select DevicePnPName, then click ... (ellipsis).
7. Select Arduino Leonardo (COMx), where x is the COM port number, then click Ok

To locate the Arduino Leonardo COM Port:

l From the Start Menu, select Control Panel, then Device Manager.
l Expand Ports (COM & LPT).
l The port will be listed as Arduino Leonardo (COMx), where x is the COM port number.
8. Click Save Changes.
9. Click Test.
10. Select Initialize.

11. Enable Printer light, then ensure that the printer light illuminates in blue.

12. If the kiosk contains cash devices, complete the following steps:
l Enable Cash light, then ensure that the cash device light illuminates in blue.
l Enable Change light, then ensure that the change tray light illuminates in blue.

13. If the kiosk contains an unlocker, complete the following steps:

l Use the status light color picker to choose white.
l Enable Status light, then ensure that the status light illuminates in white.

14. Use the shelf light colour picker to choose white, then enable Shelf light and ensure that the shelf light
illuminates in white.

15. De-select all checkboxes to turn off all lights.

16. Click Shutdown, then close the Test window.
17. Close the selfCheck TechTool application.

70 Bibliotheca.com
 10.10 Innovative Technology Cash Box
If the installation features an Innovative Technology Cash Box payment device, complete the following steps to
configure and test the device. Use System Manager to configure the currency, denominations used. and float
levels.

1. Start PIPS.
l From the Start menu, select Programs.
l Select ITL PIPS.
l Select Launch PIPS x, where x is the software version number.
l Click Start-up.

2. PIPS should start and locate the Smart Payout and Smart Hopper devices, with relevant COM port
numbers.
3. Run the SelfCheck Tech Tool application.

4. Select Innovative Technology Cash Box.

5. Select Role, then click ... (ellipsis).

6. Enable Accept Payment, then click Ok.

7. Enter the COM port used by the smart hopper in CoinAcceptorSerialPort.

8. Enter the COM port used by the smart dispenser in NoteRecyclerSerialPort.

9. Select CoinAcceptorDevicePnPName, then click ... (ellipsis).

10. Select USB Serial Port (COMx), then click Ok.

11. Select NoteRecyclerDevicePnPName, then click ... (ellipsis).

12. Select USB Serial Port (COMx), then click Ok.

13. Click Save Changes.
14. Click Test.
15. Select Initialize.

16. Select Start Load Change.

17. Enable Smart hopper loads the change (if available) and Notes recycler loads notes.
18. If the library will use a legacy 3M note acceptor, set NoteAcceptorIsSmartpayoutNotNV11 to False,
otherwise leave the default True selected.
19. Click Shutdown, then close the Test window.
20. Close the selfCheck TechTool application.

10.10.1 Configuring how change is issued

The Innovative Cashbox can be configured to dispense change for a transaction using the largest notes
possible before smaller notes.

Complete the following steps.

71 Bibliotheca.com
 1. Start selfcheck configurator.
2. Expand InnovativeTechnologyCashBox.
3. The display expands to show the InnovativeTechnologyCashBox options.

4. Select HopperUsesGreedyMode, then click Modify (or just double-click HopperUsesGreedyMode.

72 Bibliotheca.com
 5. Use the pull-down icon on the right side of the display to set HopperUsesGreedyMode to True.

6. After the value is set to True, click Ok.

l The hopper will attempt to issue the largest denomination(s) possible while issuing change.

7. Repeat the preceding process for NoteRecyclerUsersGreedyMode.

8. Click Save.

73 Bibliotheca.com
 10.10.2 Staff notifications
To configure the Innovative cash box payment reconciliation (paydown) function to email Z Reports to
appropriate library staff, complete the following steps.

1. Start selfcheck configurator.

2. Expand EmailCashBoxZReportProcessor.
3. The display expands to show the EmailCashBoxZReportProcessor options.

4. Select AllowEmail, then click Modify (or just double-click AllowEmail).

5. Use the pull-down icon on the right side of the display to set AllowEmail to True.
6. Enter the target email address next to ToAddress.

74 Bibliotheca.com
 7. Select Subjects, then click the ellipsis next to (Collection).

8. The following screen appears.

9. Click Add. A new item with Key and Value settings appears.
10. Enter the language code for the installation in Key (e.g. ‘en-US’ for US English).

75 Bibliotheca.com
 11. Enter an email subject line in Value (e.g. Kiosk Z-Report).

12. Click Ok.

13. Click Ok.
14. Click Save.

76 Bibliotheca.com
 11 Install Card Payment solutions
The installation and configuration processes for card payment solutions differ depending on the card device
and payment provider.

Please refer to the Card payment options for quickConnect™ installation guide for further instructions.

77 Bibliotheca.com
 12 Pharos
Ensure that Electronic Payment is enabled in System Manager.

12.1 Pharos processor settings

To configure the Pharos processor settings:

1. Open up C:\Program Files (x86)\Bibliotheca\SelfCheck QCI\bin\SelfCheck.Configurator. exe

2. In the PharosTransactionProcessor section, configure the following settings:
l CashierAccount - Specifies the Pharos account that credits or debits the customer account
whenever a transaction is processed.
l CreditPurse - Specifies the Pharos customer account type. Default values include:
o User Pays
o Technology Grants
o Tuition Fees
l TerminalName - Specifies the terminal name. Leave blank to use the machine name.
l EDIServiceURL - Specifies the Client URL.
l Password - Specifies the EDI service password.
l BillingOption - Set to Advance
l TransactionCodes:
o add: PaymentMethod = Cash, TransactionType = Donation, TransactionCode = DONC
o add: PaymentMethod = CreditCard, TransactionType = Donation, TransactionCode =
DONCC
o add: PaymentMethod = Electronic, TransactionType = Donation, TransactionCode =
DONABC

3. Save the changes.

4. Restart the quickConnect™ selfCheck application.

78 Bibliotheca.com
 12.2 Additional Services
In quickConnect™ selfCheck, additional services can be enabled for Pharos users. These include creating
guest passes and making donations. The additional services can be accessed from the main selection screen
via a dedicated button. By default, the button is called "Additional Services" but can be configured.

To enable additional services:

1. Open up C:\ Program Files (x86)\Bibliotheca\SelfCheck QCI\bin\SelfCheck.Configurator. exe.

2. In the Selection Screen section, select the elipsis (...) at the end of the SelectionButtons field.

3. Select the AdditionalServicesCommand option from the Members (left) column.

4. Set the IsEnabled value to True.

79 Bibliotheca.com
 5. Save the changes.
6. Restart the quickConnect™ selfCheck application.

To add a custom image for the Additional Services button:

1. Place the required image in the C:\ProgramData\Bibliotheca\selfCheck qCi\Content\ Assets\bklyn

folder.
2. Open up C:\ Program Files (x86)\Bibliotheca\SelfCheck QCI\bin\ SelfCheck.Configurator. exe
3. In the Selection Screen section, configure the AdditionalServicesButtonImageUri1 setting to
C:\ProgramData\Bibliotheca\selfCheck qCi\Content\Assets\bklyn\(file name).
4. Save the changes.
5. Restart the quickConnect™ selfCheck application.

80 Bibliotheca.com
 12.2.1 Enable the creation of guest passes
The Pharos system allows guest pass access that is valid for a single day only. Guest user access can be
created using quickConnect™ selfCheck, including the creation of fee payment and the printing of a receipt with
the guest pass barcode and PIN.

A customer specific Pharos user account can be used as creation fee recipient in the GuestFeesAccount
setting.

To configure the creation of guest passes using Pharos:

1. Open up C:\Program Files (x86)\Bibliotheca\SelfCheck QCI\bin\SelfCheck.Configurator. exe.

2. In the Guest Account section, configure the following settings:
l EnableGuestAccess - Set to True to enable guest access.
l MaximumAccountBalance - Set to the maximum fee amount that the user can have on the
account.
l GuestUserGroups - You can add multiple guest user groups.
l Group - The Group value must correspond to a group that has been created in the Pharos
system.
l Display name - The Display name value determines how the group will be displayed on
screen. This could be a localised name.
l CreationFee - Set the amount that the guest has to pay in order to create a guest pass.
l GuestFeesAccount - Set the name of the account that guest fees will be sent to.

3. In the GuestId section.

l Format - The format that the Guest ID will be presented in (for example, "Prefix, DateTime:
yyMMddHH, Index: 00;;#}").
l Prefix - The prefix that is added at the start of a guest ID (for example, for a guest user the prefix
could be set to "GU".

4. Save the changes.

5. Restart the quickConnect™ selfCheck application.

81 Bibliotheca.com
 12.2.2 Enable Donations
quickConnect™ selfCheck allows Pharos system users to make donations.

To configure donations:

1. Open up C:\Program Files (x86)\Bibliotheca\SelfCheck QCI\bin\SelfCheck.Configurator. exe

2. In the Donations section, configure the following settings:
l EnableDonations - Set the value to true to enable the donations option.
l MaximumDonationAmount - Set the maximum amount that a patron can donate in a single
transaction.
l PredefinedAmounts - Set the amounts that will be displayed as quick payment options on the
screen. Different amounts should be seperated by a "," (comma) delimiter.

3. Save the changes.

4. Restart the quickConnect™ selfCheck application.

12.2.3 Pharos E-Payment Payment Transaction Messages

Payment transaction messages are queued into a file stored locally on the kiosk PC prior to being sent to
Pharos for processing.

Messages generated are queued into the following directory/file.

C:\P ROGRAM D ATA \ BIBLIOTHECA \S ELF C HECK QCI\C ONTENT \R EPORTING B UFFER \*. NEW

12.2.3.1 Failed Send Attempts

Pharos payment transaction messages that fail to send properly are stored in the following directory/file.

C:\P ROGRAM D ATA \ BIBLIOTHECA \S ELF C HECK QCI\C ONTENT \R EPORTING B UFFER \*. FAILED

Note: Messages that fail to send properly are retried periodically.

82 Bibliotheca.com
 13 Setup OneCard Solutions e-payment and authentication
(optional)
1. Using the Configurator, in Authentication, set:
l ExternalAuthenticationType: OneCardSolutions

2. Using Configurator, in Electronic, set:

l EnableElectronicPayment: true
l AccountIdSource: UseRawPatronId
l IsPinRequired: false
l SelectedElectronicProcessorId: OneCardSolutions
l PaymentAccountReloading: disabled
l UseProcessorTransactionIdAsPaymentId: true

3. Using Configurator, in OCSTransactionProcessor, set:

l ApplicationId: leave blank for testing, set to value supplied by OneCard Solutions to commission
on site
l DeviceId: leave blank for testing, set to value supplied by OneCard Solutions to commission on
site
l ClientKey: leave blank for testing, set to value supplied by OneCard Solutions to commission on
site. Enter as 16 pairs of hex characters. These can be separated using commas or spaces to
make it easier.

4. Using Configurator, in Circulation, set:

l SendPaymentTransactionId: true

5. Using Configurator, in System, set:

l LocalName: Set the two letter culture code for locale. For example, for Ireland, set IE.
l DefaultCurrencyCode: Set the currency code for the default currency used. For example, for
Euro, set EUR, and for British Pound, set GBP.

83 Bibliotheca.com
 14 MobilePay (Denmark only)
Patrons can use a MobilePay app on their phone to pay fines and fees.

Complete the following steps to set up MobilePay configurations in System Manager.

1. Sign in to quickConnect™ System Manager on the kiosk.

2. Go to Payment > All and enable Credit Card only.
3. Save your changes.
4. Select Payment, then Credit Card.
5. Set Credit Card Processor to MobilePay.
6. Save your changes.

Complete the following steps to set up MobilePay configurations in Configurator.

1. Open the Configurator application on the kiosk.

2. Select MobilePay.
3. Set the following configurations:
l MerchantVatNumber = As provided by the provider.

Note: If this installation is an upgrade from an existing v8 installation, and the value is not known,
it can be automatically retrieved from the server (for a limited time) by entering the MerchantID
and LocationID.
l MerchantId = As provided by the provider.
l LocationId = As provided by the provider.
l PosId = The ID for the kiosk.

Note: Leave this field blank. It will be populated automatically. If this installation is an upgrade
from an existing v8 installation, reset this value to blank.
l PosName = The name of the kiosk.
l PosUnitId = Kiosk POS identifier. This value must be unique for the merchant.
l PaymentLabelFormat = Free text sent to MobilePay.

Note: This value can be used to provide a paying patron ID {UserId}.

l Restrictions = If required by the library, restrictions can be enabled for credit card or debit card
usage.
l ServerUri = https://api.mobilepay.dk (or as provided)
l AuthenticationUri = https://api.mobilepay.dk/integrator-authentication (or as provided)
l EnableVerboseTransactionLogging = False. Set this value to True for inital MobilePay
installation/upgrade. Once the feature is confirmed as working, set it to False.

84 Bibliotheca.com
 4. Click Save.
5. Go to the CreditcardFinancialTransactionReceipt section and set the ShowCardHolderName value to
Off.
6. Click Save.
7. Add the following under Style/CustomResources.
l ResourceKey = QrCodeBackgroundUri
l ValueString = pack://siteoforigin:,,,/Assets/Images/MobilePayQrCode.png
l ValueType = System.Uri
8. Click Save.

mobilePay uses the credit card workflow, so you also need to change the custom text
that appears on the screen.

85 Bibliotheca.com
 15 Additional configuration steps
This section describes configuration steps that, depending upon the features being installed at the site, may
need to be performed using selfCheck Configurator.

The following topics are discussed in the sections that follow.

l Family member cards
l Patron log ins
l Charge payment requests and the ILS/LMS
l Set up a new Admin card
l Obfuscation of patron IDs

15.1 Family member cards

If supported by your library, quickConnect™ selfCheck can accept family member authorization cards.

Family member cards are cards that allow pre-defined family members to access a family account to check out
or check in items from the library.

When a session is initiated using a family member card, the Select Family Member window appears, where
the family member selects the appropriate Name from the list presented.

Once the appropriate family member is selected, the transaction continues.

15.1.1 Setting up family member cards

In order for family member cards to function, the required configurations must be completed.

86 Bibliotheca.com
 1. Start selfCheck configurator.
2. Select Authentication, then highlight IsFamilyLoginEnabled.

You may need to expand the Authentication view.

3. Click Modify.

87 Bibliotheca.com
 4. Using the pull-down menu, set IsFamilyLoginEnabled to True.

5. Click OK.
6. Click Save.

If you need to configure your SIP server to work with this feature, refer to your ILS / LMS
documentation.

88 Bibliotheca.com
 15.2 Patron log in and returns
To configure item check in to required the patron to log in prior to returning the item, complete the following
steps.

1. Start selfcheck configurator.

2. Expand Checkin. The Checkin display expands to show the Checkin options.

3. Select IsPatronLoginRequired, then click Modify (or just double-click IsPatronLoginRequired).

4. Use the pull-down icon on the right side of the display to set IsPatronLoginRequired to True.

5. After the value is set to True, click Ok.

6. Click Save.

89 Bibliotheca.com
 15.3 Dispense largest notes as change first
To configure the Innovative cash box to dispense change for a transaction using the largest notes possible
before smaller notes, complete the following steps.

1. Start selfcheck configurator.

2. Expand InnovativeTechnologyCashBox.
3. The display expands to show the InnovativeTechnologyCashBox options.

4. Select HopperUsesGreedyMode, then click Modify (or just double-click HopperUses GreedyMode.
5. Use the pull-down icon on the right side of the display to set HopperUsesGreedyMode to True.

6. After the value is set to True, click Ok. The hopper will attempt to issue the largest denomination(s)
possible while issuing change.

90 Bibliotheca.com
 7. Repeat the preceding process for NoteRecyclerUsersGreedyMode.
8. Click Save.

15.4 Dispense unknown coins out the front when emptying

To configure the Innovative coin hopper to dispense any unknown or foreign coins out of the front, and in to the
change area, instead of in to the cash box below the coin hopper.

1. Start selfcheck configurator.

2. Expand InnovativeTechnologyCashBox.
3. The display expands to show the InnovativeTechnologyCashBox options.

4. Select DispenseUnknownCoinsOutToFront , then click Modify

5. Use the pull-down icon on the right side of the display to set DispenseUnknownCoinsOutTo Front to
True.

6. After the value is set to True, click Ok.

91 Bibliotheca.com
 15.5 Charge payment requests and the ILS / LMS
This feature controls how quickConnect™ selfCheck sends payment requests to the ILS / LMS when a patron
makes a payment at a kiosk.

The default setting is for a single message to be sent to the ILS / LMS, which then determines the individual
charges to pay. This new configuration option allows other options that pay off charges individually. This allows
charge types successfully paid off to be recorded, which facilitates breakdowns of charges paid by type on the
library's reconciliation reports.

Possible configuration settings include:

l None - The default setting. A single message is sent to the ILS / LMS, which then determines individual
charges to pay.
l Bulk - Uses the response from the ILS / LMS to attempt to determine which fees were paid.
l TopDown - Instructs the ILS / LMS to make a full payment on each charge, starting at the top of the list
of charges (as provided by the ILS / LMS) and proceeding down the list, until funds available for
payments are reduced to zero. A partial payment will be made on the last fee in the list, if able. Uses the
response from the ILS / LMS to attempt to determine which fees were paid.
l BestFit - Starts at the top of the list of charges (as provided by the ILS / LMS) and proceeds down the
list, but attempts to make full payments on as many charges as possible, potentially skipping over fees
that are higher on the list if a full payment cannot be made. Will make a partial payment on the highest
unpaid fee on the list if no additional full payments can be made. Uses the response from the ILS / LMS
to attempt to determine which fees were paid.

l This feature does not allow patrons to select individual charges to pay.
l This feature can only be enabled if the library ILS / LMS supports individual charge breakdowns, with
uniquely identified charges.

92 Bibliotheca.com
 15.6 Configure a barcode card as an Admin card
If you want to configure a barcode card as an Admin card, complete the following steps.

The card must already have a barcode present on it.

1. Access selfCheck configurator.

2. Expand BarcodeAdministratorUser.

3. Expand AdministratorUserIds.

93 Bibliotheca.com
 4. Click Modify. The following Modify Configuration screen appears.

5. Click ... (the elipsis on the right hand side of the screen). The String Collection Editor, shown below,
appears.

6. The barcode list will already contain the defaults PHXADMIN and 00000000000000.

You may add any number of new barcodes to the list. Ensure that each new barcode you add is on it's
own line.

7. Click Ok until you return to the main selfCheck configurator screen, then click Save.

15.7 Database privacy

If the library wishes to exercise extra privacy for it's patrons, you will need to enable the appropriate
DatabasePrivacy setting in Configurator.

94 Bibliotheca.com
 The following privacy levels are available:
l None
l RepeatableHash
l Obfuscated

The chosen setting affects how sensitive data is handled. Sensitive data is tagged with a
SensitivePropertyAttribute in the database, and by default includes the following:
l PatronId
l PatronName
l CustomerId

The configurable settings include a flag to turn off the use of the SensitivePropertyAttribute, and an optional
collection of property names to be used in conjunction with, or instead of, the attribute.

There is also a setting for verbose logging (VerboseLoggingEnabled). By default this setting is disabled, but if
enabled, the original and obfuscated values are logged. This feature is provided for testing/debugging
purposes. It should not be left on when the library has privacy concerns because the unobfuscated value is
exposed.

15.7.1 None
The default setting for extra DatabasePrivacy is None. This setting includes the standard quickConnect™
selfCheck privacy enforcement but no extra privacy options.

- For RepeatableHash and Obfuscated, there are potentially other drawbacks regarding the quality of
recommendations as information on which patron ids have borrowed which items will not be stored.

95 Bibliotheca.com
 15.7.2 RepeatableHash
When RepeatableHash is selected for DatabasePrivacy, a hash code is used in place of the sensitive value.
The hash code will be the same for the same data across sessions and across quickConnect™ executions, so
reports that rely on unique values should remain accurate.

The quality of recommendations offered to patrons will be reduced, as information regarding which items a
patron has borrowed is not stored.

15.7.3 Obfuscated
When Obfuscated is selected for DatabasePrivacy, a random, unique code is used in place of the sensitive
value. This code will be the same across sessions, but only within the same quickConnect™ execution. Reports
that rely on the same unique values across sessions will remain accurate, but not across quickConnect™
executions.

While Obfuscated is enabled, the following is in effect.

l Patron IDs will no longer be stored in the library's local database. GUIDs will be used instead.
l GUIDs are not related to patron IDs in any way.
l Transaction information is still sent to libraryConnect™, however, it includes GUIDs instead of Patron
IDs.
l libraryConnect™ reports still function normally, however, GUIDs are included rather than Patron IDs
(provided the report shows the patron id field).
l If the library exports libraryConnect™ data for manipulation in an external application, they will not be
able to aggregate based on patron id (as every transaction has a unique patron id).

If this feature is enabled at an existing installation, historical data is not changed. Only data stored locally and
data sent to libraryConnect™ for transactions processed after the feature is enabled will be obfuscated. If the
library wishes, historical data can be deleted from the local database / libraryConnect™ using a manual
process.

Also note that the quality of recommendations offered to patrons will be reduced, as information regarding
which items a patron has borrowed is not stored.

96 Bibliotheca.com
 15.8 Email Innovative payment reconciliation reports
To configure the Innovative cash box payment reconciliation (paydown) function to email Z Reports to
appropriate library staff, complete the following steps.

1. Start the selfcheck configurator software.

2. Expand EmailCashBoxZReportProcessor.
3. The display expands to show the EmailCashBoxZReportProcessor options.

4. Select AllowEmail, then click Modify (or just double-click AllowEmail.

5. Use the pull-down icon on the right side of the display to set AllowEmail to True.
6. Enter the target email address next to ToAddress.

7. Select Subjects, then click the ellipsis next to (Collection).

97 Bibliotheca.com
 8. The following screen appears. Click Add. A new item with Key and Value settings appears.

9. Enter the language code for the installation in Key (e.g. ‘en-US’ for US English).
10. Enter an email subject line in Value (e.g. Kiosk Z-Report).

98 Bibliotheca.com
 11. Click OK.
12. Click OK.
13. Click Save.

99 Bibliotheca.com
 15.9 Enable cloudLibrary pop-up messages
If the library has the cloudLibrary service, you will need to set up the cloudLibrary pop-up messages to appear
directing patrons to the app.

To enable the cloudLibrary pop-up messages:

l Start the selfcheck configurator software.
l Select CloudLibrary.
l Select Modify to view the settings.

l Set the following configurations:

l IsMobileSelfCheckEnabled=True - Determines whether the cloudLibrary modules mobile app
functionality (previously referred to as mobile selfCheck) is enabled.
l IsAppOnlyReceiptOptionEnabled=True - Determines whether the App receipt option is
displayed at the end of a transaction.

100 Bibliotheca.com
 l IsAccountPromotionPopupEnabled - If set to true, a promotional pop up message will be displayed
when the patron selects the Account option.
l IsEndSessionPromotionPopupEnabled - If set to true, a promotional pop up message will be displayed
after the patron finishes a transaction (Check-in, Check-out, Renew or a Payment). It is a different pop
up to the one displayed for Account.
l IsEmailPromotionEnabled - If set to true, the e-mail option will be displayed on promotional pop ups,
and will send a promotional e-mail for cloudLibrary to the patron when selected, depending on whether a
valid e-mail address for the patron is stored in the ILS / LMS.
l IsReceiptPromotionEnabled - If set to true, a cloudLibrary promotion will be added to the bottom of a
printed receipt (and will include a QR code for the cloudLibrary mobile app by default).
l Account / EndSessionPromotionPopUpImageUrl - Set the directory path for the image used for the
Account or End Session Promotion pop up respectively.
l Account / EndSessionPromotionPopUpButtonAlignment - Set where the buttons are placed on the
pop up promotion.
l Account / EndSessionPromotionPopUpTimeoutPeriod - Set the timeout period in seconds that the
Promotion pop up will remain on screen without any activity.
l ReceiptPromotionImageUrl - Set the directory path for the image used on the bottom of the printed
receipt. This can be a QR code directing the patron to the cloudLibrary app or any other relevant image.
l IsReceiptPromotionTextBelowImage - Set to True to display text under the receipt image. You can
change the text displayed, if necessary, using System Manager.

101 Bibliotheca.com
 15.10 Comprise Report for payments
All payment transactions, whether cash, credit card or an electronic payment, are sent to Comprise. The
payments appear as a Comprise Report.

The Comprise Report includes totals of amounts paid, fees to LMS/ILS, and change given. It also displays a
summary of Reconciliation Report data.

The report is accessed via the selfCheck configurator.

1. Start selfCheck configurator.

2. Expand Transaction Reporting.
3. Select TransactionReportingEnabled.

102 Bibliotheca.com
 4. Click Modify. The Modify Configuration window appears.

5. Use the pull-down menu to set TransactionReportingEnabled to True.

103 Bibliotheca.com
 6. Click OK. The new value appears in the configurator window.

7. Click Save.

104 Bibliotheca.com
 15.11 Comprise SAM Payment Account Reload
quickConnect™ selfCheck supports users reloading (or, topping-up) their Comprise SAM account via either a
cash or credit card transaction.

This feature can be configured using the selfCheck configurator.

This feature is set to automatic by default. Only change this setting if you wish to disable
the feature.

1. Start selfCheck configurator.

2. Expand Electronic.
3. Select PaymentAccountReloading.

105 Bibliotheca.com
 4. Click Modify. The Modify Configuration window appears.

5. Use the pull-down menu to set PaymentAccountReloading to Disabled.

6. Click OK. The new value appears in the configurator window.

7. Click Save.

106 Bibliotheca.com
 15.12 OCLC
15.12.1 Set alert on previously borrowed items
This feature enables additional workflow behavior that requires a patron to acknowledge that they are
borrowing an item that they have already borrowed.

This feature can currently only be enabled using selfCheck™ configurator:

1. Start selfCheck configurator.

2. Expand Checkout,
3. Select Modify,
4. Set IsBorrowAgainAlertEnabled to true,

5. Select OK on the Modify screen,

6. Select Save on the selfCheck™ configurator main screen.

Customisation of the text for the alert popup can be changed with the Custom Text
feature within System Manager.

107 Bibliotheca.com
 15.12.2 Conditional item messages on failure
This features allows the display of item messages after a failed check-out based on a defined condition, rather
than always displaying the message. Specifically OCLC provides an item screen message in circumstances
like “insufficient credits” and wants to display that, but not other messages. They specify

A custom SIP field must be specified with the ID “FQ” that provides a code, and when this code matches a
configured value, the message is displayed.

To enable this feature:

1. Start selfCheck configurator.

2. Expand Checkout,
3. Select Modify,
4. Set ShowMessagesOnFailure to true,

5. On the FailureMessagesFilter field, click on the elipsis (...) at the end of the row. A popup table will be
displayed,

108 Bibliotheca.com
 6. One or more “filters” can be defined to determine when a message is allowed to be displayed. Each filter
contains a “data name” and a “pattern”. Select Add and enter the DataName and Pattern required, and
select OK to confirm.

In the above screenshot, the Data Name Message Code is the name of the proprietary
SIP field FQ, as defined for OCLC.

7. Select OK on the Modify screen,

8. Select Save on the selfCheck™ configurator main screen.

109 Bibliotheca.com
 15.12.3 HTTP for OCLC
Enabling this feature will allow OCLC to communicate via HTTP instead of TCP. Selecting this will override the
transport provider to use HTTP instead of TCP, and override the LoginEnabled setting to true.

The OCLC specification for this feature states that the SIP login is required, and the login
password must be at least 16 characters long, and cannot match the login user name.
The login user name and password are configured as normal within the SIP settings. See
Authentication in Network > Circulation section.

To enable this feature:

1. Start selfCheck configurator.

2. Expand the SIP2 section,
3. Select Modify,
4. In the Settings section, use the drop down menu next to the System ID field to select OCLC/HTTP.

5. Select OK on the Modify screen,

6. Select Save on the selfCheck™ configurator main screen.

110 Bibliotheca.com
 15.13 Configure LDAP servers
The following process needs to be completed to configure LDAP servers, if required:

1. Open up C:\ Program Files (x86)\Bibliotheca\SelfCheck QCI\bin\SelfCheck.Configurator. exe.,

2. In the LdapAuthenticationConfiguration section, set UseMultipleLdapServers to True if you want to
use more than one LDAP server, and False if configuring a single LDAP server. If set to True, the values
on LdapAuthenticationConfiguration root will be ignored, and those in the LdapServers array will be
used instead.
3. If adding one server, complete the settings under LdapAuthenticationConfiguration,
4. If adding multiple servers, select LdapServers and complete the configurations for [0] = LdapServer # 1
for the first LDAP server you wish to set, and then [1] = LdapServer # 2 and so on for additional servers,

Setting Description Example

Setting the value to True will enable the

LDAP server for use.
IsEnabled True
Setting the value to False will disable the
LDAP server from use.

Sets the server address for the relevant ldap.server1.com:389

LDAP server.
ServerAddress
The address should be shown in the
following format: host: port 192.168.0.200:389

Sets the Domain of the server. This will

specify when the LDAP server will be used,
as opposed to one of the other configured
Domain servers. For example, you can configure staff
quickConnect™ selfCheck to use one server
for staff login, and another for student login
etc.

UseServiceAccount Sets whether a Service Account is used. False

ServiceAccountName Sets the Account Name

ServiceAccountPassword Sets the Account Password

OuPath The LDAP Organisational Unit (OU) “CN=Users,

111 Bibliotheca.com
 DC=LDAPServer,
DC=Bibliothca,
DC=com”

“OU=Patrons,
DC=LDAPServer,
DC=Bibliotheca,
DC=com”

IdAttribute The ID used to identify users uid

UseActiveDirectory Set whether to use an Active Directory False

UseSsl Set whether to use SSL False

LdapVersion Set the version of LDAP being used 3

4. Save the changes.

5. Restart the quickConnect™ selfCheck application.

112 Bibliotheca.com
 15.14 Split patron ID and Date Of Issue from the library card number to use in
SIP2
Where the number on the library card is a combination of the Patron ID and the Date Of Issue, you may need to
split the number in to it's component parts so that it can be used in SIP2.

To configure:

1. Open up C:\ Program Files (x86)\Bibliotheca\SelfCheck QCI\bin\SelfCheck.Configurator. exe.,

2. Expand Patron Card and select Modify,
3. Set the following settings:
l IsCompositeIdentifierEnabled = False (by default). This value has to be set to True.
l CompositeIdentifierPatterns = two values by default. More patterns can be added if needed, and
the QCI will match the patterns from the top to the bottom. If it does not match with the first
pattern, it will move on to the next pattern.
l HasEscapeCharacters = False (by default). Depending on the type of barcode scanner, the pipe
character “|” used in the above listed patterns might be replaced with a Unicode control character,
and we need to set this setting to True to change it back to the pipe character so that it matches
with one of the patterns configured.

4. Save the changes.

5. Restart the quickConnect™ selfCheck application.

113 Bibliotheca.com
 15.15 Allow full titles to be displayed on receipts
On the receipt, you can set the number of lines that the item title can be displayed on. If the title consists of
more characters than can fit on the set number of lines, the title will be cut short.

You can also set the receipt to display the full title, regardless of the number of lines used.

To configure the receipt to allows display the full title, regardless of the number of lines used:

1. Open up C:\ Program Files (x86)\Bibliotheca\SelfCheck QCI\bin\SelfCheck.Configurator. exe.,

2. Select GeneralReceipt > ItemTitleLinesCount and select Modify,

114 Bibliotheca.com
 3. Change the value so that it is blank (null). This will set the number of lines that can be used to unlimited
and will display the full title, regardless of the number of characters.

4. Save the changes.

l On the GeneralReceipt screen, the ItemTitleLinesCount should display as "ItemTitleLines
Count is null"

5. Restart the quickConnect™ selfCheck application.

115 Bibliotheca.com
 15.16 Include Patron ID and expiration date on every receipt
You can set whether to display the Patron ID and patron expiration date on every receipt. The expiration date
will only be displayed if the Patron ID is also displayed.

To configure the receipt:

1. Open up C:\ Program Files (x86)\Bibliotheca\SelfCheck QCI\bin\SelfCheck.Configurator. exe..

2. Select SessionReceipt and select Modify.
3. Set the ShowCustomerID to true.
l Patron Identifiers must be enabled.

4. Save the changes.

5. Restart the quickConnect™ selfCheck application.

116 Bibliotheca.com
 15.17 Configure Payments for Colombian Pesos
To configure an Innovative Technology Cashbox to accept Colombian pesos, complete the following steps.

1. Open SelfCheck.Configurator.exe. Configurator is available in the following directory.

C:\Program Files (x86)\bibliotheca\selfCheck QCI\bin

2. Expand InnovativeTechnologyCashbox.

3. Select CoinAcceptorValueMultiplier.

4. Click Modify.

5. Set CoinAcceptorValueMultiplier to 100.

Note: To operate the Innovative Technology Cashbox with any other currency type, leave this setting at
the default value (1).

6. Click OK.

7. Click Save.

117 Bibliotheca.com
 16 Additional System Manager Tasks
This section lists the items that must be configured or performed for each quickConnect™ selfCheck installation
using System Manager.

Refer to the quickConnect™ selfCheck System Manager user guide for more information.

1. Upload the license file

2. Device roles
3. Innovative Cash Box currency, denominations and float levels
4. SIP2 connection
5. Screen customization
6. Screen prompt animations
7. Recommendations
8. Validate the installation

a. Complete a normal checkout with receipt transaction.

b. If the site supports email receipts, also complete a normal checkout with an email receipt. When
the transaction is complete, verify that all receipt information is correct.

c. Complete a fines and fees transaction for a nominal dollar amount.

d. When the transaction is complete, verify that all line item details are correct.

118 Bibliotheca.com
 17 Set a library user password
To configure a library user password, complete the following steps.

1. Login using the following credentials.

l Windows 7
l User Name: Library
l Password: TNTLibrary#1
l Windows 10
l User Name: Library
l Password: Bibliotheca_001

OR
l User Name: BiblioTech
l Password: BibTech4Lib@
2. Click Create Password.
3. After you create a new password, the Library user will appear in the User Accounts window with the
specified password.
4. Restart the PC and log in as user Library with the specified password.

You can use these same steps to create a 3MTech user with a password of Technician or
Administrator.

119 Bibliotheca.com
 18 Detect cased items based on tag data or alternative SIP data
You can set the kiosk to detect the item type of a cased item by reading from the tag data on the item or from
alternative SIP data.

The settings can be configured in Configurator > RfidReader > MediaTypeOverrides.

The settings for each override are:

l FieldName: the name of the field in the tag the should be used to determine the media type (e.g. Media
Type).
l FieldValue: the value that if read from the FieldName in the tag will be mapped to a media type (e.g. 2).
l MediaType: the media type that will be used if the value read from the specified field is matched (e.g.
DVD).

18.1 Option to ignore block flags

Please note that this is not standard procedure. This process should only be carried out if
the ILS / LMS is incorrectly configured.

Where an ILS / LMS is incorrectly configured so that it initiates block flags when it should not (e.g. blocking a
patron because the ILS / LMS thinks renewal privileges are denied), there is an option to ignore certain block
flags.

To set the option:

1. Open Configurator
2. Go to the SIP2 Settings section,
3. Configure the following two configurations, as required, using the table below (which displays the normal
behaviour for each supported block flag if it is not ignored):
l AllowedPatronStatusFlags – any flags sent from the ILS / LMS that are not in this list will be
ignored. If this setting is left blank, no flags will be ignored.
l MandatedPatronStatusFlags – any flags in this list will always be set to true, regardless of the
ILS / LMS response. If this setting is left blank, the values of the flags will be taken from the ILS /
LMS response as usual.

120 Bibliotheca.com
 Flag Value Normal behaviour (in quickConnect selfCheck)

The “denied” flags restrict access to the

Charge privileges denied 1 corresponding workflows, but do not prevent patron
login.

The “denied” flags restrict access to the

Renewal privileges denied 2 corresponding workflows, but do not prevent patron
login.

Recall privileges denied 4 Not supported

The “denied” flags restrict access to the

Hold privileges denied 8 corresponding workflows, but do not prevent patron
login.

Card reported lost 16 Card reported lost will deny login

Too many items charged 32 Not supported

Too many items overdue 64 Not supported

Too many renewals 128 Not supported

Too many claims of items returned 256 Not supported

Too many items lost 512 Not supported

The “excessive” flags only play a part when

determining how to prompt the patron. When the
Excessive outstanding fines 1024 patron is denied check-out, these flags are used to
determine whether the denial is because of money
owed.

The “excessive” flags only play a part when

determining how to prompt the patron. When the
Excessive outstanding fees 2048 patron is denied check-out, these flags are used to
determine whether the denial is because of money
owed.

Recall overdue 4096 Not supported

Too many items billed 8192 Not supported

None 0

6 supported block flags 3099

All 16383

121 Bibliotheca.com
 Values are presented in integer format in Configurator, and will be converted to a bit array in quickConnect™
selfCheck. You will need to include the values of any flags that you do not want to ignore. This is done by
adding up the values and adding the accumulated total.

For example:
l If you want to ignore all flags except “Charge privileges denied”, set AllowedPatronStatusFlags=1.
l If you want it to ignore all flags except “Charge privileges denied” and “Renew privileges denied”, set
AllowedPatronStatusFlags=3 (because 1+2=3)
l If you want it to only ignore “Charge privileges denied”, set AllowedPatronStatusFlags=16382 (because
16383 [value of all flags]) – 1 [value of “charge privileges denied”] = 16382).

The MandatedPatronStatusFlags setting works in the same way, for example:

l If you want to always set the “Charge privileges denied” flag to true, set Mandated PatronStatusFlags =
1, etc.

122 Bibliotheca.com
 19 Enable a language neutral Welcome screen
For libraries where multiple languages are used without one language being dominant (for example, areas in
Canada where both English and French languages are used with equal standing), an additional screen can be
enabled to appear before the default welcome screen. The patron will see instructional text in all specified
languages and will have the option to choose the language that the software will appear in.

To enable the language neutral welcome screen:

1. Open selfCheck™ configurator,

2. Select Welcome and then select Modify to change the settings,
3. You will see the following screen:

l IsEnabled - Set to True to enable the multiple language welcome screen to appear before the
default welcome screen.
l IsHeaderVisible - Set to True to enable the header to be visible. This is the same header that
appears on the default screens.

123 Bibliotheca.com
 l IsInstructionalText Visible - Set to True to enable instructional text to be visible in each
language.

Complete the following steps to set the text that appears for each language.

a. Open System Manager and log in using the Advanced user name and password.
b. Navigate to Appearance.
c. Select Custom Text.
d. Choose the language that you want to change the instructional text from the Language
drop down menu.
e. Select Session from the Category drop down menu.
f. Select Welcome View from the Group drop down menu.
g. Select Find.
h. Enter the text to appear on screen for the specified language.
i. Select Update.

124 Bibliotheca.com
 l MaxLangaugeCount - Set the number of languages that will appear on the multiple language
welcome screen.

The languages that appear are determined by the languages enabled in the Region and
Languages section on System Manager. If you select three languages to appear, they will be the
top three languages set in System Manager (English -UK, French - Canada and Croatian in the
example below).

If you set five or more languages, the four selected langauges will appear and then the first
checked languages in the More languages list (English - UK, French - Canada, Croatian, Dutch
and Afrikaans in the example below).

l RandomizeDisplayOrder - Set to True to randomise the order that the languages appear on
screen for each transaction. This setting is for libraries that do not wish to assign priority to a
language by having it always appear first.

4. Select OK.
5. Select Save.
6. Restart quickConnect™ selfCheck.

125 Bibliotheca.com
 To customise font size, font colour and background colours or images:

1. Open selfCheck™ configurator.

2. Select Welcome and then select Modify to change the settings.
3. The following screen appears.

4. Under the Style section, select CustomBackroundImagePath and navigate to the file path of the image
that you wish to use.
5. Select CustomBackgroundColor to pick the background colour. If a background image has been
selected, it will supercede the custom background colour.
6. Select CustomInstructionBackgroundColor to pick the colour of the background area around the
instructional text.
7. Select CustomInstructionForegroundColor to pick the text font colour of the instructional text.
8. Select CustomInstructionFontSize to set the text font size of the instructional text.

9. Select OK.
10. Select Save.
11. Restart quickConnect selfCheck.

126 Bibliotheca.com
 19.1 Add a new language after initial installation
To add a new language to the installation (a language not included in the standard set of fully supported
languages), perform the following steps.

1. Contact Bibliotheca support to obtain the resource file for the new language.

Note: Language files share the following format, where language is replaced by the name of the
language being added.

language.<language code>.resx

2. Copy the language resource file to the following directory on the kiosk.

C:\P ROGRAM D ATA \ BIBLIOTHECA \ SELF C HECK QCI\C ONTENT \L OCALIZATION \

3. Open selfCheck Configurator. It is available in the following directory.

C:\P ROGRAM F ILES ( X 86)\ BIBLIOTHECA \ SELF C HECK QCI\ BIN

4. Expand System.

5. Select CustomLanguageCodes.

6. Click Modify.

7. Click the ellipsis (...).

The String Collection Editor for custom language codes appears.

8. Add the code for the new language to any existing codes, then click OK.

9. Under System, select VisibleLanguageCodes.

10. Click Modify.

11. Click the ellipsis (...).

The String Collection Editor for visible language codes appears.

127 Bibliotheca.com
 12. Add the code for the new language to the list, then click OK.

13. Click Save.

The new language is now available to be selected in quickConnect selfCheck.

128 Bibliotheca.com
 20 Request additional item information from the LMS / ILS
Some features, such as grouping items by their permanent location on receipts, require quickConnect™
selfCheck to request additional item information from the LMS / ILS.

To enable the option:

1. Open Configurator.
2. Go to the Checkout section.
3. Set the GetCompleteItemInformation configuration to true.
4. Select OK,
5. Select Save,
6. Restart quickConnect™ selfCheck.

129 Bibliotheca.com
 20.1 Add optional ISIL check when reading tags
To add an optional ISIL check when reading tags:

1. Open up C:\ Program Files (x86)\Bibliotheca\SelfCheck QCI\bin\SelfCheck.Configurator. exe.,

2. In the TagSetRules section, select modify to edit the settings,
3. Set IsEnabled to True to enable the ISIL check functionality,
4. Set the Rules using the same syntax as Sort Matrix / Property Expressions. Rules will be matched from
the top rule to the bottom rule in that order/
l Explanation of rules in the following screenshot:
o Allowed; LibraryId=QA-TSTLIB - Allow tags with ISIL value of "QA-TSTLIB"
o Allowed; LibraryId='' - Allow tags with empty or no ISIL information
o Denied; LibraryId=REGEX:.+ - Deny any tag with non-empty ISIL

5. Properties lists possible property names to be used in rules.

6. Setting IgnoreRejectedTags to False will show denied tags in the list indicating error, and setting to
True will cause denied tags not to be visible in the items list.

7. Save the changes.

8. Restart the quickConnect™ selfCheck application.

130 Bibliotheca.com
 20.2 Configuring ABC protocol for ILS communication
The following process needs to be completed if using ABC protocol for ILS communication instead of SIP2
protocol.

To configure ABC protocol:

1. Open up c:\ Program Files (x86)\Bibliotheca\SelfCheck QCI\bin\SelfCheck.Configurator. exe.

2. In the Circulation section, configure the OnlineProviderId setting to ABC.
3. In the ABC section, configure the Address setting to show the hostname:port (IP address and TCP Port
number) of the ABC host or ACS/ILS.

4. Save the changes.

5. Restart the quickConnect™ selfCheck application.

131 Bibliotheca.com
 20.3 Connecting to an ILS using LCF protocol
The following process needs to be completed if using LCF (rather than SIP) to connect to the library ILS/LMS.

Complete the following steps.

1. Gather all required LCF connection information.

Note: The library should have collected this information from the LCF vendor during the pre-installation
process.

2. Configure each kiosk using selfCheck Configurator.

c:\ Program Files (x86)\Bibliotheca\SelfCheck QCI\bin\SelfCheck.Configurator. exe.

3. In selfCheck Configurator, expand Circulation.

4. Highlight OnlineProviderId = "SIP".

5. Click Modify.

6. Use the pull-down menu to select LCF protocol provider.

7. Click OK.

8. Click Save.

132 Bibliotheca.com
 9. Scroll down the list of configuration options in the Configurator window until you see LCF, then expand
LCF.

10. Enter the specified values in the following fields.

l CustomerProfileId — Used to configure LCF parameters to a known implementation.

Note: Currently the only option is Civica.

l BaseUri — Set to the url of the LCF server, provided to library by LCF vendor.

This value should have /api/ at the end. Append if not present.
l CustomerKey — Provided to library by LCF vendor.
l TerminalId — ID specific to the kiosk, provided to library by LCF vendor.
l TerminalPassword — Password specific to the kiosk, provided to library by the LCF vendor.
l InstitutionId — Library Institution ID.
l LibraryId — Either a branch code or a kiosk code, depending on how the library defines locations
within their ILS/LMS.
l TraceLogging — Determines whether a separate LCF log containing all outbound/inbound
messages is generated.

This feature should be enabled for testing/troubleshooting only. Disable the feature during normal
operation.

Note: The LCF log is stored with other standard logs in the following location.

C:\P ROGRAM D ATA \ BIBLIOTHECA \ SELF C HECK QCI\L OG \

133 Bibliotheca.com
 11. The currect Civica Spydus LCF implementation does not include an alert flag on returned items. Civica
is currently working on implementing this feature.

At present, it is necessary to sort returned items by configuring the system to detect items that either
have reservations, or need to be moved to a different location.

Complete the following steps.

a. Copy the LCF Sorting mapping file provided by the software team to the following location.

C:\P ROGRAM D ATA \ BIBLIOTHECA \ SELF C HECK QCI\C ONFIG \P ROTOCOL \

b. Open quickConnect System Manager.

c. Select Workflow, then Checkin, then Sorting.

d. Add 2 new sorting rules for sending items to the Needs Attention bin.

Alert = true

Permanent Location = ~<location code of this library>

(for example, Permanent Location = ~BE)

12. Synchronize the kiosk Windows time with internet time.

Note: Some LCF servers are very sensitive to timing differences between the remote kiosk and the
server, which can cause borrow requests to be rejected by the ILS.

13. Test the connection.

134 Bibliotheca.com
 21 NCIP configurations
To configure quickConnect™ selfCheck to use NCIP instead of SIP2:

1. Open selfCheck™ configurator,

2. Select Circulation, and then select Modify,

3. Configure the OnlineProviderID field to NCIP.

4. Select OK,
5. Select Save,

6. Select NCIP, and then select Modify,

135 Bibliotheca.com
 7. Configure the following configurations:

l CirculationProviderId = NCIP (default)

l TransportProviderId = HTTP (default)
l CustomerProfileId = Standard (default)
l CustomerProfiles = Standard Customer Profile (default)
l Address = The full web address of the customer’s NCIP server
l Protocolversion = The protocol version in the configuration defines the maximum supported
version, the actual version used is determined from a call to LookupVersion, which allows the
server to identify the version(s) it supports. The default maximum value is determined internally
based on the highest level of support.
l The only two protocols of NCIP currently supported are 1.0 or 1.01.
l FromAgencyID = AgencyId must be populated
l ToAgencyId = AgencyId must be populated
l Schemes = From / ToAgencyIds may be accompanied by a “scheme”, but not mandatory
configurations.
l Trace Logging = Enables (Enabled)or disables (Disabled) NCIP logging. Logging is set to
disabled, by default.
l Double Check Out Transaction Enabled = If the NCIP server does a ‘double borrow’ rather than
a ‘single borrow’, set the field to True.

8. Select OK,
9. Select Save,
10. Restart quickConnect™ selfCheck.

136 Bibliotheca.com
 22 AFI Password Protection

Currently ,this feature is predominantly used for a specific customer - Bochum - to allow
quickConnect™ selfCheck to read and write security to password protected tags.

Tag Manager must also be set to use the DM 62 data model.

Tag Manager allows customers to add a password to their RFID tags during the tagging procedure (using
staffConnect™ conversion) that block any software that would normally be able to change the AFI value on the
tag (switch security on or off) unless the software is configured to recognise the password on the tag.

To configure the Tag Manager application used with quickConnect™ selfCheck:

1. Close quickConnect™ selfCheck to the kiosk desktop, using the admin card.
2. Navigate to C:\ProgramData\Bibliotheca\common\TagManager folder.
3. Open the 1.00.xml file with Notepad++.
4. Set the PasswordMethod setting to 0 (no password protection), 1 (password protection method for
Bochum) or 2 (password protection using bibliochip).
5. If the PasswordMethod has been set to 1 for Bochum, add the password required in text (for example,
<1234567> )to the PasswordValue field.
6. Save the changes.
7. Restart quickConnect™ selfCheck.

137 Bibliotheca.com
 23 Text to Speech
For libraries that want audible messages to be played on the kiosk, mirroring the text on screen, text to speech
functionality can be enabled. This feature is designed to help patrons that may not be able to read or follow the
on-screen text (due to age, visual impairment or dyslexia for example), and can be set for multiple languages,
depending on the language packs installed on the kiosk.

Text-to-speech will be triggered when entering a new screen, as a reminder to take a transaction receipt,
pressing a button on screen, a pop-up is displayed or an item is scanned or selected.

If a new message is triggered (by navigating away from the screen) before the current message has finished,
the previous message is cancelled, and the new message starts playing instead.

If a new message is triggered (by navigating away from the screen) before the current message has finished,
the current message completes. However, any other messages queued for that screen are cancelled.

23.1 Installing Text to Speech

Complete the following steps to install Speech functionality in Windows.

1. Click Start, then select Settings, then Time & Language, then Region & Language.
2. Select Add a language.

3. Choose the desired language from the list.

Note: The following languages include Text-to-Speech capabilities.

l Chinese (simplified)
l Chinese (traditional)
l French
l German
l Italian
l Japanese
l Korean
l Mexican Spanish
l Polish
l Portuguese (Brazilian)
l Russian
l Spanish
l UK English
l US English
4. Deselect Install language pack and set as my Windows display language.
5. Click Install.

6. After installation of the new language is complete, select the language in the Region & Language list.

138 Bibliotheca.com
 Note: It may take several minutes for the new language to install.
7. Select Options, then Speech, then Download.
8. Restart your computer.

After the PC restarts, Text-to-Speech voice for the selected language is installed.

Note: The following languages also support Text-to-Speech, however, in order for them to be available
in quickConnect, you must run the Import_voices.bat file after the language pack is installed.
l Danish
l Dutch
l Finnish
l French (Canada)
l Norwegian
l Portuguese (Portugal)
l Swedish
l Turkish

You can obtain the required bat file from Sharepoint.

https://Bibliothecagroup.sharepoint.com/sites/ProductZone/Software%20Library/Forms/AllItems.aspx?
viewid=54c3ce56-3270-4742-aa52-
705e689f2bcb&id=%2Fsites%2FProductZone%2FSoftware%20Library%2FSelf%20Service%2Fquick
Connect%20selfCheck

The required bat file is located in the following directory.

C:\Program Files (x86)\Bibliotheca\selfCheck QCI\setup_extraneous\text_to_speech

Note: The bat file calls file Import-TextToSpeechVoices.ps1, which makes the required registry changes
to support the additional languages.

23.2 Configuring Text to Speech

To enable Text to Speech:

1. Open selfCheck™ configurator,

2. Select TextToSpeechController,
3. You will see the following screen:

139 Bibliotheca.com
 l TextToSpeechEnabled - Set to true to enable and false to disable all text-to-speech functionality.
l SpeechFilePath - Text to speech prompts can be overridden by pre-recorded WAV files. If using
this functionality, this is the path to the WAV files. See "Overriding a Default Text to Speech
Phrase" on the next page for more information.
l Gender - This feature is obsolete.
l Use Fallback Culture - Set to True to use a fallback culture if the selected culture is not
supported. Please note that this may cause some differences in pronunciation.
l DisplayTextToScreenControls - Enable to display text to speech controls onscreen for Play,
Pause and Repeat functions.

4. Select OK.
5. Select Save.
6. Restart quickConnect™ selfCheck.

If you cannot hear text to speech, ensure that the speaker is not muted and that the
speaker is not damaged or disconnected.

140 Bibliotheca.com
 23.2.1 Overriding a Default Text to Speech Phrase
Complete the following steps to override a default text to speech phrase.

1. Open selfCheck™ configurator.

2. Select Resources and then select Modify to change the settings.
3. Select the ellipsis (...) at the end of the TextToSpeechStrings field.

4. Select Add to add a new phrase to a specific resource string or select one of the already modified
settings (under the members column) if you wish to edit it further.
5. In the CultureName field, set which language that the phrase change will apply to, using the Windows
culture code. For example, selecting en-US will only change the phrase if the patron has chosen US
English or it is the default language on the kiosk. If the kiosk allows the patron to choose between US
and UK English, in this instance, the patron would still hear the default message for UK English.
6. In the ResourceKey field, select the path to the phrase that is being overridden. Resource keys are
structured as follows:
l <view name>.EntrySpeechText and <view name>.ExitSpeechText for entering / exiting a view.
l <view name>.<command name> for pressing a button.
l <popup name>. EntrySpeechText for popups.

The resource key to configure the text read out on the main option selection screen is:
l SelectionViewModel.EntrySpeechText

The following resources do not adhere to the structure:

l ItemViewModelPropertyChanged.ItemRenewed.SpeechText (when an item is
renewed)
l ItemViewModelPropertyChanged.ItemSelected.SpeechText (when an item is
selected)

141 Bibliotheca.com
 The following resources can also include the %title% information from the ILS / LMS:
l ItemSuccessPopupViewModel.CheckIn.Success.EntrySpeechText (when an
item is checked out)
l ItemSuccessPopupViewModel.CheckOut.Success.EntrySpeechText (when an
item is checked in)
l ItemSuccessPopupViewModel.Renewal.Success.EntrySpeechText (when an
item is renewed)
l SessionItemViewModel.Selected (when an item is selected)

7. Enter the replacement phrase In the Value field.

Where the spoken text is provided by the ILS / LMS, include the correct conditions to signify this. For
example, to include the name of a checked out item in the spoken phrase, enter %title% to show that the
information is coming from the ILS / LMS (e.g. %title% checked out).

Alternatively, a pre-recorded WAV file can be used. If using this method, set Value to the name of the
WAV file. The referenced WAV file must be stored at the path specified under TextToSpeechController
> SpeechFilePath.

The %amount% information from the ILS / LMS is used on the following screens:
l Cash payment screen – the name of the override resource for this is:
EscrowAmountText – the %amount% wildcard will be replaced by the amount of
money that the patron has inserted.
l PaymentTypeSelectionViewModel.EntrySpeechText – the %amount% wildcard
will be replaced by the full amount owed by the patron.
l CreditCardPaymentConfirmationPopupViewModel.EntrySpeechText – the
%amount% wildcard will be replaced by the amount that the patron has selected
to pay.

Please view the Text-to-Speech resource strings section for a list of the resource strings
that can be changed.

8. Select OK.
9. Select Save.
10. Restart quickConnect™ selfCheck.

142 Bibliotheca.com
 23.3 Text-to-Speech resource strings
23.3.1 List of Views
These resource strings refer to the phrases that are spoken when the patron enters or exits a screen. An
example of string would be AccountHoldsViewModel.EntrySpeechText where the patron enters the new
screen, and CashPaymentViewModel.ExitSpeechText where the patron leaves a screen.

By default, all ExitSpeechText values are left blank (i.e. no text is spoken) apart from the exceptions marked
with a * in the list below. You can override the text in the value setting for any resource string, if required.
EntrySpeechText overrides ExitSpeechText, by default, so any ExitSpeechText that is immediately followed by
an EntrySpeechText message will be curtailed.

View name Description

AccountHoldsViewModel Holds screen

AccountItemsViewModel Account Items Screen

AccountReportViewModel Account report screen

AccountSummaryViewModel Account summary screen

AdditionalServicesViewModel Additional services screen

CheckInIntroductionViewModel Check in intro screen

CheckOutIntroductionViewModel Check out intro screen

EndSessionViewModel End session screen

ProcessingViewModel Processing screen

DualPatronIdentificationPrompterModel Dual Patron ID screen

SinglePatronIdentificationPrompterModel Single patron ID screen

OutOfServiceViewModel Out of service screen

CashPaymentViewModel* Cash payment screen

CreditCardPaymentViewModel* Credit card payment screen

ElectronicPaymentAccountViewModel* E-payment account screen

ElectronicPaymentViewModel E-payment screen

PaymentTypeSelectionViewModel Payment type selection screen

143 Bibliotheca.com
 View name Description

EventPromotionDetailViewModel Event promotion detail screen

EventPromotionViewModel Event promotion screen

RecommendationsDetailViewModel Recommendations detail screen

RecommendationsViewModel Recommendations view screen

SummaryViewModel Summary view screen

SelectionViewModel.EntrySpeechText Main option selection screen

144 Bibliotheca.com
 23.3.2 List of Commands
These resource strings refer to the phrases that are spoken when a button has been pressed on screen.

Command name Description

Items out

Select all / unselect

AccountItemsViewModel.ToggleAllSelectionsCommand
all button

Renew selected
AccountItemsViewModel.RenewSelectedItemsCommand
button

Check-in selected
AccountItemsViewModel.CheckInSelectedItemsCommand
button

Account report

AccountReportViewModel.PrintReportCommand Print button

AccountReportViewModel.EmailReportCommand E-mail button

Account summary

Go to Check-out
AccountSummaryViewModelCommand.GoToCheckOutCommand
button

AccountSummaryViewModelCommand.GoToAccountItems Command Items out button

AccountSummaryViewModelCommand.GoToAccountHolds Command Holds button

AccountSummaryViewModelCommand.GoToAccountCharges Command Charges button

AccountSummaryViewModelCommand.GoToElectronicPayment
E-payment button
AccountCommand

AccountSummaryViewModelCommand.PrintAccountReportCommand Print report button

AccountSummaryViewModelCommand.EmailAccountReportCommand Email report button

AccountSummaryViewModelCommand.GoToAccountReportCommand Print / E-mail button

145 Bibliotheca.com
 Command name Description

Select receipt type screen

EndSessionViewModel.PrintReceiptCommand Print receipt button

EndSessionViewModel.EmailReceiptCommand E-mail receipt button

App only receipt

EndSessionViewModel.AppOnlyReceiptCommand
button

EndSessionViewModel.NoReceiptCommand No receipt button

Card payment keyboard

CashPaymentViewModel.CommitPaymentCommand Submit button

Payment type selection screen

PaymentTypeSelectionViewModel.CashPaymentCommand Cash button

PaymentTypeSelectionViewModel.CreditCardPaymentCommand Credit card button

PaymentTypeSelectionViewModel.SmartCardPaymentCommand Smart card button

PaymentTypeSelectionViewModel.ElectronicPaymentCommand E-payment button

Promotions

EventPromotionDetailViewModel.PrintCommand Print button

EventPromotionDetailViewModel.EmailCommand E-mail button

Main screen

SelectionViewModel.CheckOutCommand Check out button

SelectionViewModel.CheckInCommand Check in button

SelectionViewModel.AccountInfoCommand Account info button

146 Bibliotheca.com
 Command name Description

SelectionViewModel.MakePaymentCommand Make payment button

SelectionViewModel.RenewItemsCommand Renew button

Additional services
SelectionViewModel.AdditionalServicesCommand
button

Footer buttons

FooterViewModel.FontSizeCommand Font size button

FooterViewModel.SelectLanguage.{language.Name} (where language name is Language selection

the Windows culture code, eg en-US) button

More languages
FooterViewModel.AllLanguagesCommand
button

147 Bibliotheca.com
 23.3.3 List of Pop-ups
These resource strings refer to the phrases that are spoken when a pop-up screen or message is displayed.

Pop-up name Description

Unsuccessful patron
PatronAuthenticationFailurePopupViewModel
login pop-up

Successful patron login

PatronAuthenticationSuccessPopupViewModel
pop-up

Unsuccessful patron
PatronAuthorizationFailurePopupViewModel
authorisation pop-up

Remove patron card

RemovePatronCardPopupViewModel
pop-up

Failed to print Session

SessionReceiptProcessingFailedPopupViewModel
receipt pop-up

Failed to send Account

AccountReportEmailFailedPopupViewModel report e-mail receipt pop-
up

Sent Account report e-

AccountReportEmailSucceededPopupViewModel
mail receipt pop-up

Failed to print Account

AccountReportPrintFailedPopupViewModel
report pop-up

Printed Account report

AccountReportPrintSucceededPopupViewModel
pop-up

Charge detail
ChargeDetailUnavailablePopupViewModel
unavailable pop-up

E-payment account
ElectronicPaymentAccountActionPopupViewModel
action pop-up

E-payment accounr
ElectronicPaymentAccountReloadPopupViewModel
reload pop-up

Hold detail unavailable

HoldDetailUnavailablePopupViewModel
pop-up

Item detail unavailable

ItemDetailUnavailablePopupViewModel
pop-up

CaseUnlockingFailedPopupViewModel Failed to unlock case

148 Bibliotheca.com
 Pop-up name Description

pop-up

Item in the case being

CaseUnlockingItemNotCheckedOutPopupViewModel unlocked not checked
out pop-up

Cash box failure to load

CashBoxLoadingFailedPopupViewModel*
pop-up

Cash box load

CashBoxLoadingSuccessPopupViewModel*
successful pop-up

Cash box pay down

CashBoxPayDownFailedPopupViewModel*
failure pop-up

Cash box Z report not at

CashBoxZReportNotAtFloatLevelPopupViewModel*
Float level pop-up

Cash payment failed

CashPaymentFailedPopupViewModel
pop-up

Successful cash
CashPaymentSuccessPopupViewModel
payment pop-up

Confirmation that the

CreditCardBatchCloseConfirmationPopupViewModel* Credit Card Batch closed
pop-up

Failure to close Credit

CreditCardBatchCloseFailedPopupViewModel*
Card Batch pop-up

Failure to process Credit

CreditCardBatchCloseReportProcessingFailedPopupViewModel* Card Batch Close Report
pop-up

Processed Credit Card

CreditCardBatchCloseSuccessPopupViewModel* Batch Close Report
successfully pop-up

Credit card payment

CreditCardPaymentAbortedPopupViewModel
aborted pop-up

Credit card payment

CreditCardPaymentCanceledPopupViewModel
cancelled pop-up

Credit card payment

CreditCardPaymentCancellationFailedPopupViewModel
cancellation failed pop-

149 Bibliotheca.com
 Pop-up name Description

up

Credit card payment

failed to commit (and no
CreditCardPaymentCommitFailureNoChargePopupViewModel
charge to credit card
account) pop-up

Credit card payment

CreditCardPaymentFailedPopupViewModel
failed pop-up

Credit card payment

CreditCardPaymentCommitFailurePopupViewModel
failed to commit pop-up

Credit card payment

CreditCardPaymentDeclinedPopupViewModel
declined pop-up

Credit card payment

failed (and no charge to
CreditCardPaymentFailedNoChargePopupViewModel
credit card account) pop-
up

Failure to record Credit

CreditCardPaymentRecordingFailurePopupViewModel
card payment pop-up

Failure to reverse Credit

CreditCardPaymentReversalFailurePopupViewModel
card payment pop-up

Successful reversal of
CreditCardPaymentReversalSuccessPopupViewModel Credit card payment
pop-up

Successful Credit card

CreditCardPaymentSuccessPopupViewModel
payment pop-up

Credit card failed to

CreditCardSwipeFailedPopupViewModel
swipe correctly pop-up

Failure to allocate
DonationsAllocationFailurePopupViewModel
donations pop-up

Donation allocated
DonationsAllocationSuccessPopupViewModel
successfully pop-up

Failed E-payment
ElectronicPaymentAuthenticationFailedPopupViewModel
authentication pop-up

ElectronicPaymentConfirmationPopupViewModel E-payment confirmed

150 Bibliotheca.com
 Pop-up name Description

pop-up

Invalid E-payment
ElectronicPaymentCredentialsInvalidPopupViewModel
credentials pop-up

E-payment declined pop-

ElectronicPaymentDeclinedPopupViewModel
up

ElectronicPaymentFailedPopupViewModel E-payment failed pop-up

Failure to record
ElectronicPaymentRecordingFailurePopupViewModel Electronic payment pop-
up

Failure to reverse
ElectronicPaymentReversalFailurePopupViewModel Electronic payment pop-
up

Successful Electronic
ElectronicPaymentSuccessPopupViewModel
payment pop-up

E-payment transaction
ElectronicPaymentTransactionsNotAuthorizedPopupViewModel
not authorised pop-up

Failure to allocate funds

FundsAllocationFailurePopupViewModel
pop-up

Funds allocated
FundsAllocationSuccessPopupViewModel
successfully pop-up

Payment Devices
Administration Failed
PaymentDevicesAdministrationFailedPopupViewModel* pop-up

Payment Devices
PaymentDevicesAdministrationConfirmationPopupViewModel* Administration
Confirmation pop-up

Payment Devices
PaymentDevicesAdministrationReportProcessingFailedPopupViewModel* Administration Report
failed to report pop-up

Payment Devices
PaymentDevicesAdministrationSuccessPopupViewModel* Administration Report
reported successfully

151 Bibliotheca.com
 Pop-up name Description

pop-up

Payment receipt failed to

PaymentReceiptProcessingFailedPopupViewModel
process pop-up

Z report for cash box not

ZReportCashboxNotAvailablePopupViewModel*
available pop-up

Failure to send event

EventPromotionDetailEmailFailurePopupViewModel promotion detail e-mail
pop-up

Event promotion detail e-

EventPromotionDetailEmailSuccessPopupViewModel
mail sent pop-up

Failure to print event

EventPromotionDetailPrintFailurePopupViewModel promotion detail receipt
pop-up

Event promotion detail

EventPromotionDetailPrintSuccessPopupViewModel
receipt printed pop-up

Status of
RecommendationDetailStatusUpdateFailurePopupViewModel recommendation details
failed to upadte pop-up

Recommendation e-mail
RecommendationEmailFailurePopupViewModel
failed to send pop-up

Recommendations e-
RecommendationEmailSuccessPopupViewModel
mail sent pop-up

Recommendation hold
RecommendationHoldFailurePopupViewModel
failed pop-up

Recommendation hold
RecommendationHoldSuccessPopupViewModel
successful pop-up

Recommendations
RecommendationPrintFailurePopupViewModel receipt failed to print pop-
up

Recommendations
RecommendationPrintSuccessPopupViewModel
receipt printed pop-up

Invalid e-mail warning

InvalidEmailWarningPopupViewModel
pop-up

152 Bibliotheca.com
 Pop-up name Description

New fees acquired pop-

NewFeesAcquiredPopupViewModel
up

Account access denied

AccountAccessDeniedPopupViewModel
pop-up

Account balance
AccountBalanceNotificationPopupViewModel
notification pop-up

CaseUnlockingPopupViewModel Case unlocking pop-up

Confirm that you want to

CashManagementConfirmEmptyAllCoinsPopupViewModel* empty all coins in Cash
Management pop-up

Confirm that you want to

CashManagementConfirmEmptyAllNotesPopupViewModel* empty all notes in Cash
Management pop-up

InactivityWarningPopupViewModel Inactivity warning pop-up

InvalidItemIdPopupViewModel Invalid Item ID pop-up

InvalidPatronIdPopupViewModel Invalid Patron ID pop-up

InvalidTagSetPopupViewModel Invalid Tag Set pop-up

ItemIdentifiedPopupViewModel Item Identified pop-up

ItemNotPlacedPopupViewModel Item not placed pop-up

Item not positioned pop-

ItemNotPositionedPopupViewModel
up

Item placement
ItemPlacementInstructionPopupViewModel
instruction pop-up

ItemSuccessPopupViewModel Item success pop-up

Patron assistannce
PatronAssistanceRequestFailedPopupViewModel
request failed pop-up

Patron assistance
PatronAssistanceRequestPopupViewModel
request pop-up

Patron assistance
PatronAssistanceRequestSuccessPopupViewModel
request successful pop-

153 Bibliotheca.com
 Pop-up name Description

up

Payment required
PaymentRequiredPopupViewModel
payment pop-up

RemoveItemPopupViewModel Remove item pop-up

Single item warning pop-

SingleItemWarningPopupViewModel
up

WaitPopupViewModel Wait pop-up

Workflow access pop-up

WorkflowAccessPopupViewModel

CloudLibrary
CloudRecommendationCheckOutSuccessPopupViewModel Recommendation Check
Out success pop-up

CloudLibrary
CloudRecommendationHoldSuccessPopupViewModel Recommendation Hold
success pop-up

Mobile SelfCheck
MobileSelfCheckPromotionEmailFailurePopupViewModel Promotion Email failure
pop-up

Mobile SelfCheck
MobileSelfCheckPromotionPopupViewModelBase
Promotion pop-up

Failed to create Guest

GuestCreationFailedPopupViewModel
account pop-up

Credit card payment

CreditCardPaymentConfirmationPopupViewModel
confirmation pop-up

Some pop-up messages (highlighted with an asterix "*" in the above list) appear only
during staff administration tasks, such as emptying the cash box.

For the security and privacy of the library, the Text-to-Speech values for these pop-up
messages are blank by default, so no announcement will be made.

Should the library require Text-to-Speech to accompany these administrative messages,

the blank phrase can be overridden.

154 Bibliotheca.com
 24 Add patron name and ID to the display
To configure quickConnect™ selfCheck to display the patron name and ID on the bottom of the Borrow, Renew
and Holds screens:

1. Open selfCheck™ configurator,

2. Select Account, and then select Modify,
3. Configure the IsAccountBriefEnabled field to True to enable the feature,

4. Select OK,
5. Select Save.

The screenshot below shows an example of a screen displaying the patron's name and obfuscated (partly
starred out for privacy) patron ID.

155 Bibliotheca.com
 25 Show account balance on borrow screen
To configure quickConnect™ selfCheck to display the patron name and ID on the bottom of the Borrow, Renew
and Holds screens:

1. Open selfCheck™ configurator,

2. Select Account, and then select Modify,
3. Configure the IsAccountBriefEnabled field to True,
4. Configure the IsAccountBriefAccountBalanceEnabled field to True

4. Select OK,
5. Select Save,
6. Restart quickConnect™ selfCheck.

If you would prefer for the patron name and ID to be replaced with custom text (e.g. Account Balance):

1. Open System Manager,

2. Select Custom Text,
3. Select the required language from the Language drop down,
4. Search for Account Balance: Patron Information in the Find field,

5. Change the default text (Patron name) (Patron Id) to the required custom text.

156 Bibliotheca.com
 l If necessary, you can choose a combination of custom text, Patron name and / or Patron ID. For
example, changing the text to Account Balance (PatronName) (PatronId) will display the
custom text and the patron specific name and ID provided by the LMS / ILS on the same line,
above the patron specific account balance amount.

6. Select Update,
7. Restart quickConnect™ selfCheck.

157 Bibliotheca.com
 26 Enable Events with Shared Services
To configure quickConnect™ selfCheck to get Events from Shared Services:

1. Open selfCheck™ configurator,

2. Select Event Provider and Modify ,and then change the ProviderId value to SharedServices.

3. Select OK,
4. Select Save,

5. Select SharedServices, and then select Modify to change the settings,

6. Set the following Shared Services settings:
l Customer Key is a UID (user name) required for libraryConnect™ client configuration. Available
from libraryConnect™ admin, or copy from a working smartadmin™ client config on the kiosk.
l API Key is a UID (user name) required for libraryConnect™ client configuration. Available from
libraryConnect™ admin, or copy from a working smartadmin™ client config on the kiosk.
l API secret is a password UID required for libraryConnect™ client configuration. Available from
libraryConnect™ admin, or copy from a working smartadmin™ client config on the kiosk.
l Authentication endpoint address is the shared services URL. This value is always the same,
and should be https://login.Bibliotheca.services/connect/token.

7. Select OK,
8. Select Save,
9. Select SharedServicesEventItemProvider, and then select Modify to change the settings,
10. Change the ServiceEndpointBaseAddress setting to the URL for the Events server. This value should
always be the same, and should be https://shared.Bibliotheca.services. The Base Address can also be
found in a working smartadmin™ client config on the kiosk.
11. Select OK,
12. Select Save,
13. Open System Manager,
14. Select Appearance > Promotions.
15. Select Shared Service Events from the list in the Provider field,
16. Ensure that the settings for Customer Key, API Key, API Secret and Authentication endpoint address
match the values added to selfCheck™ configurator.
17. Ensure that the URL in the Events section matches the ServiceEndpointBaseAddress added to
selfCheck™ configurator.
18. Select Apply to confirm any changes.
19. Restart quickConnect™ selfCheck.

158 Bibliotheca.com
 Enabling Recommendations with Shared Services can be configured in System
Manager. Please refer to the quickConnect™ selfCheck System Manager user guide for
more detail.

159 Bibliotheca.com
 27 Integration with Netloan
On the quickConnect™ selfCheck screen, you can now configure a tile that will open up access to Netloan.

These instructions do not include the installation and configuration of the Netloan application, and you should
refer to the specific installation guide for the product for additional information.

27.1 Pre-requisites
l Netloan kiosk software installed on the kiosk
l quickConnect™ selfCheck v1.80.0.21 or higher

27.2 Enabling the third party application

Complete the following steps to enable the third party application.

1. Close the quickConnect™ selfCheck application, using the admin card.

2. Open the selfCheck configurator application.
3. Select ExternalApplication, then select Modify.
4. Configure the following settings:
l IsEnabled = Set the value to True to enable access to the third party application.
l ProcessName = Set the location of the .exe file for the Netloan application on the kiosk - C:\
Program Files (x86) \ Netloan \ Kiosk \ NLKiosk.exe.
l ProcessExecution = Use the drop down menu to select how the third party application will
execute. Select OnDemand to only start the application when the patron selects the tile.

5. Select OK.
6. Select Save.

160 Bibliotheca.com
 27.3 Enable the tile on screen and add a custom icon image
Complete the following steps to add a tile for the third party application on screen and decide the location.

1. Close the quickConnect™ selfCheck application, using the admin card.

2. Open the selfCheck configurator application.

3. In the Selection Screen section, select the ellipsis (...) at the end of SelectionButtons.

4. Select the ExternalApplicationCommand option from the Members (left) column.

5. Set IsEnabled to True.
6. Select the ellipsis (...) at the end of CustomImageUri, then navigate to the location of the Netloan image
you want to use.

161 Bibliotheca.com
 8. Select OK, then OK again on the next screen.
9. Select Save.

Do not change the name of the command "External Application Command".

162 Bibliotheca.com
 27.4 Change the text on the tile
Complete the following steps to change the text on the tile.

1. Close down quickConnect™ selfCheck using the admin card.

2. Open the selfCheck configurator application.

3. In the Resources section, select the ellipsis (...) at the end of CustomStrings.
4. Select Add to add a new custom string.
5. Enter the language code for the desired language in CultureName.
6. In ResourceKey, enter SelectionViewModel.ExternalApplicationCommand.Text.
7. Enter the text you want to appear on the Netloan tile (PCs and Printing, for example) in Value.

8. Select OK, then OK again on the next screen.

9. Select Save.

163 Bibliotheca.com
 27.5 Enabling Keyboard Wedge barcode mode
Netloan uses keyboard wedge barcode mode so the barcode scanners need to be amended from USB COM
mode to Keyboard wedge mode, and then add a carriage return.

Complete the following steps to enable keyboard wedge barcode mode.

1. Scan the following keyboard wedge barcode.

2. Scan the following carriage return barcode.

164 Bibliotheca.com
 27.6 Disable the Default (Datalogic) scanner
Complete the following steps to disable the default (Datalogic) scanner.

1. Close down quickConnect™ selfCheck using the admin card.

2. Open the Tech Tool application.

3. Select Datalogic Barcode Scanner from the options in the left column.
4. Select the elipsis (...) next to Role.

5. Deselect all the roles in the Datalogic Barcode Scanner Role editor pop-up screen.

6. Select OK.
7. Select Save Changes.

165 Bibliotheca.com
 27.7 Enable Keyboard Wedge Scanner
Complete the following steps to enable the Keyboard Wedge scanner.

1. Close down quickConnect™ selfCheck using the admin card.

2. Open the Tech Tool application.

3. Select Keyboard Wedge Barcode Scanner from the options in the left column.
4. Select the elipsis (...) next to Role.
5. Select IdentifyPatronAccount and IdentitfyAdministratorUser in the Keyboard Wedge Scanner Role
editor pop-up screen.
6. Select OK.
7. Select Save Changes.
8. Select the elipsis (...) next to DeviceHardwareId.
9. Ensure the cursor is in Device ID, then scan a barcode. All fields should auto-populate.

Note: If you copied quickConnect configurations from another kiosk, scan a barcode on each kiosk (
each barcode scanner will have a different Device ID).
10. Click Apply.
11. Select Save Changes.
12. Delete all prefixes from the Prefixes section.
13. Add a \r suffix to the Suffixes section.
14. Select Save Changes.
15. Use Testto quickly test the set up.

27.8 Stop quickConnect attempting to log in

To stop quickConnect™ automatically logging the patron in when you try to log in to Netloan:

1. Close down quickConnect™ selfCheck using the admin card.

2. Open the selfCheck configurator application.

3. Select SelectionScreens, then set AllowPatronIdentification to False.
4. Select OK, then Save.

27.9 Low Change

If the kiosk is running low on change, Netloan will not allow payment unless every combination of change can
be given.

166 Bibliotheca.com
 28 Integration with ICAM
On the quickConnect™ selfCheck screen, you can now configure a tile that will open up access to ICAM.

These instructions do not include the installation and configuration of the ICAM application. ICAM with will set
up by Insight Media.

28.1 Pre-requisites
l ICAM software installed and configured by Insight Media on the kiosk.
l quickConnect™ selfCheck v1.81.1 or higher

28.2 Enabling the third party application

To enable the third party application:

1. Close the quickConnect™ selfCheck application, using the admin card,

2. Open the selfCheck configurator application,
3. Select ExternalApplication and then select Modify,
4. Configure the following settings:
l IsEnabled = Set the value to True to enable access to the third party application.
l ProcessName = Set the Process Name to ICAMKioskController
l ProcessExecution = Use the drop down menu to select how the third party application will
execute. Select Existing to switch to an application that is already running

5. Select OK,
6. Select Save to save any changes.

167 Bibliotheca.com
 28.3 Enable the tile on screen and add a custom icon image
To add a tile for the third party application on screen and decide the location:

1. Close the quickConnect™ selfCheck application, using the admin card,

2. Open the selfCheck configurator application,

3. In the Selection Screen section, select the ellipsis (...) at the end of the SelectionButtons field.

4. Select the ExternalApplicationCommand option from the Members (left) column,

5. Set the IsEnabled value to True,
6. Select the ellipsis (...) at the end of the CustomImageUri field and navigate to the location of the ICAM
image that you want to use on the tile.

168 Bibliotheca.com
 8. Select OK, and then OK again on the next screen,
9. Select Save to save the changes.

Do not change the name of the command "External Application Command".

28.4 Change the text on the tile

To change the text on the tile:

1. Close down quickConnect™ selfCheck using the admin card.

2. Open the selfCheck configurator application,

3. In the Resources section, select the ellipsis (...) at the end of the CustomStrings field.
4. Select Add to add a new custom string
5. In the CultureName field, enter the language code for the language that you want the text to appear in.
6. In the ResourceKey field, enter SelectionViewModel.ExternalApplicationCommand.Text
7. In the Value field, enter the text that you want to appear on the ICAM tile (PCs and Printing, for
example).

8. Select OK, and then OK again on the next screen,

9. Select Save to save the changes.

169 Bibliotheca.com
 28.5 Remove the Windows Taskbar
The Windows taskbar needs to be removed as ICAM could potentially display the taskbar during operation if it
is left enabled.

To remove the Windows Taskbar:

1. Select the Search icon on the Windows Taskbar,

2. Search for Command Prompt and open the application,
3. Run cmd /c taskkill.exe /F / IM explorer.exe

170 Bibliotheca.com
 29 Session synchronisation with Patron card

This feature is currently only tested and available in the APAC region via SMC.

The library can choose to require the patron to present their Patron ID card and then keep the card in contact or
readable distance of either the RFID reader on the kiosk, a smartcard reader or a proximity reader throughout
the entire transaction. Removing the Patron ID card before the transaction is complete will terminate the
transaction, unless the Patron ID card is placed on the reader again before the transaction times out.

To enable this feature:

1. Open up c:\ Program Files (x86)\Bibliotheca\SelfCheck QCI\bin\SelfCheck.Configurator. exe.

2. Select the SmartCard / RFIDPatronCard / ProximityCard section (depending on which device is
present on the kiosk), and then select Modify,
3. Configure the IsSynchronizedToSession setting to true.
l By default, this setting will be set to false.

4. Configure the Role setting for the required reader device so that the patron identification role is
enabled.
5. Select OK and then select Save.

171 Bibliotheca.com
 30 Option to check patron blocks before directing patron to pay
When a patron block flag is enabled, there may be situations where a patron is not permitted to pay fines using
the kiosk but will see pop-up messages prompting them to Pay now or Pay Later.

There is now an option to check for any patron block flags before showing the pop-up message. If there is a
patron block, the Pay Now and Pay Later will not be displayed on the pop-up.

To enable this option:

1. Open selfCheck™ configurator,

2. Select FinesAndFees, and then select Modify,

3. Configure the DisableWhenBlocked field to True,

4. Select OK,
5. Select Save,
6. Restart quickConnect™ selfCheck.

172 Bibliotheca.com
 31 Add optional payment validity check before allowing payment
There is option to enable optional payment validity checks before allowing payment. This means that if the total
fee does not equal the sum of the individual charges, a pop-up message is displayed, prompting the patron to
speak to a member of staff.

To enable the validity checks:

1. Open selfCheck™ configurator,

2. Select FinesAndFees, and then select Modify,

3. Configure the CheckAccountValidity field to True,

4. Select OK,
5. Select Save,
6. Restart quickConnect™ selfCheck.

The popup text can be customized using System Manager for the resource keys:
l PatronAccountInvalidPopupViewModel.CaptionText
l PatronAccountInvalidPopupViewModel.MessageText

173 Bibliotheca.com
 32 Return trolley reader (Nordic region)
quickConnect™ selfCheck supports the Nordic return trolley reader, and the settings can be enabled using the
Configurator tool.

To enable the return trolley reader:

1. Open selfCheck™ configurator.

2. Select ReturnTrolleyReader, and then select Modify.
3. Under Settings, enter the COM port settings as required for a serial reader.

4. Select OK.
5. Select Save.
6. Select CheckIn, and then select Modify.
7. Click on the ellipsis (...) at the end of the Sorting > Location field.
8. Select Return Trolley Reader from the Members list.

174 Bibliotheca.com
 9. Set the ColorCode as required and ensure that the RfidEnabled field is set to True.

10. Select Add if you need to add more Sort Locations.

11. Select OK.
12. Select Save.
13. Restart quickConnect™ selfCheck.

175 Bibliotheca.com
 33 Appendix A: Tag Data Formats
Tag data formats dictate how and where information is programmed onto a tag during the conversion process.

Prior to the establishment of the ISO 28560 standard (global standard), many vendors provided their own tag
data formats with their own naming conventions (such as data model, tag format, tag programming schema,
etc.).

The following table provides a unified definition for tag formats.Data model numbers presented in bold type are
supported by staffConnect™ conversion.

Data Model Bibliotheca 3M legacy Intellident ITG Notes

Bibliotheca
1
DM1

Bibliotheca
2
DM2

Bibliotheca
3
DM3

Bibliotheca
10
DM10

Bibliotheca Bibliotheca Bibliotheca legacy DM

11 16
DM11 DM11 item for Europe

Bibliotheca Bibliotheca Bibliotheca legacy DM

12
DM12 DM12 item for North America

Bibliotheca
20
DM20

Bibliotheca
21
DM21

Bibliotheca
32
DM32

SATO printer cannot

Axiell 40 Axiell item 8
encode

*Intellident * 3M: version 1.71 or

Intellident 1 41 1
(DM41) greater

*Intellident * 3M: version 1.71 or

Intellident 2 42 2
(DM42) greater

Intellident 3 43 *Intellident 3 * 3M: version 1.71 or

176 Bibliotheca.com
 Data Model Bibliotheca 3M legacy Intellident ITG Notes

(DM43) greater

*Intellident * 3M: version 1.71 or

Intellident 4 44 4
(DM44) greater

Intellident legacy DM
Intellident 5 45 *Intellident item 5 Also Used by D-Tech
and Telepen

Danish 60 *Danish item 12 18 *3M: partial support

Bibliotheca
61 Mirror image of DM60
DM61

Bibliotheca Same as DM61 but

62
DM62 without CRC

*3M: read-only
Bibliotheca
63 Danish for 4-block
DM63
readers

*Dutch Object ID *3M: read-only: writing

Netherlands item, requires special Dutch
70 6
NBD *Dutch Barcode Conversion
item application

Italy 101

Lucatron 128

3M Version 3 133 3M Numeric item 9 Numeric Item ID

3M
3M Version 4 134 Alphanumeric 9 Alphanumeric Item ID
item

ITG legacy DM for

ITG 16 135 ITG 16 16
N.A.

Based on TagSys
standard
*ITG (TagSys)
ITG 15 136 15 *3M: partial support:
item
only item ID is
supported.

177 Bibliotheca.com
 Data Model Bibliotheca 3M legacy Intellident ITG Notes

French Numeric
item,
Idrabib 137 French 7 French Standard
Alphanumeric
item

Plescon 138 14

*Dutch Object ID *3M: read-only: writing

item, requires special Dutch
Belgian 139 11
*Dutch Barcode Conversion
item application

Swiss 140 13

*3M: requires version

2CQR 141 *TagVision item 15 1.60.002 or greater

Australian DM
*ST Logitrak *3M: partial support;
ST Logitrack 142
item only Item ID/patron ID
is supported

Techlogic
143 Tech Logic item
Numeric

Libramation
144 20
Hex

Not compatible for use

Japan 150 with any other data
model

ISO 28560-3 160 ISO Fixed item

ISO 28560-2 170 ISO Object item 10

DM170 variant
permitting alternate
171 *ISO Object item AFI values

*3M: AFI handled

external to tag format

178 Bibliotheca.com
 Data Model Bibliotheca 3M legacy Intellident ITG Notes

*DM172 (ISO MSB-encoded DM171

172
Object mirrored) *3M: read-only

Korean Patron 180 * 3M: read-only

Korean Item
181 *ECO item * 3M: read-only
Ver 1 & 2

Korean Item
182 *ECO item * 3M: read-only
Ver 3

Tagsys C320
VTLS 200
transponder specific

ITG Techlogic Tagsys C220

201
C220 transponder specific

Tagsys C220
Techlogic C220 202
transponder specific

Mifare transponder
Mifare Classic 230
specific

ISO 14443B
CEPAS 231
transponder specific

NFC devices which

NFC Card emulate ISO 14443-A
232
Emulation or ISO 14443-B
transponders

*UID item (Blank)

Uses UID as Item ID
UID 255
* 3M: version 1.62 or
greater

179 Bibliotheca.com
 34 Appendix B: Advanced Hold Printing Module
34.1 Configuring the Advanced Hold Printing Module (AHPM)
When an item on hold is returned at a kiosk, the Advanced Hold Printing Module will print out a hold slip for the
item at a printer specified by the library.

To configure the Advanced Hold Printing Module:

1. Open Configurator > AhpmConfiguration,

2. Change the Enabled setting to True to enable the feature,

3. At the end of the PropertyExpressions field, select the option button (three horizontal dots),
4. Select Add to add a new property and expression that will trigger a hold slip being printed
5. Set the PropertyName setting to the property required. The property types can be seen in the
screenshot above (e.g. Alert Type, Alert, Media Type, Branch ID etc.).

180 Bibliotheca.com
 6. Under the PropertyExpression setting, set the value of the Expression field so that, if matched, it will
result in a hold label being printed. For example:
l If the PropertyName is set to Media Type, setting the Expression value to DVD will prompt a
hold slip to be printed whenever a DVD is returned using the kiosk.
l If the PropertyName is set to Branch ID, you can set the Expression value to the Branch ID of a
specific library branch. If an item matches the Branch ID, a hold slip will be printed.

7. Save the changes.

The principle used to set values to trigger hold slip printing is the same as the sorting
rules used for check-in sorting

181 Bibliotheca.com
 34.2 Accessing the Advanced Hold Printing Module
To open the Advanced Hold Printing Module:
l Open C:\Program Files (x86)\Bibliotheca\selfCheck QCI\bin\ LibrarySystems.Ahpm
Configuration.Tester.exe
l Select the Launch ticket designer button.

34.3 Change the printer to be used

To select the printer to use when printing Hold tickets, select an option from the drop down menu under Printer
to Use.

182 Bibliotheca.com
 34.4 Change the design of the hold ticket
The Advanced Print Configuration window is divided into three columns. The left column contains a print test,
preconfigured templates, receipt width adjustment, and a receipt fields overview. By first selecting a field from
the left column, users can then edit the field's contents in the centre column. The right column provides a zoom-
able preview of the configured receipt.

The following sections describe each column in greater detail.

183 Bibliotheca.com
 34.4.1 Left column
Clicking the Simple Print Test button will print a test receipt using the text entered in the adjacent textbox.

Initially, there is no template set for holds receipts. Bibliotheca has provided five preconfigured templates for
hold receipts, all of which can be customized as desired. Clicking Load from a preconfigured template will
open a popup confirmation dialogue. After clicking Yes, select a template from the list and click Open.

The current template settings are always backed up before a new template is loaded.
The backed up file name will always begin with "CustomerAUTOBackup."

Enter a value for the Printable width, which can then be tested by clicking Simple Print Test. Enter a value that
maximizes the available printable area but not so large that information is lost on the margins.

The fields overview section allows for users to add, remove and rearrange fields on the holds receipt using the
Add, Remove, or up and down buttons respectively.

Each field is individually configurable by selecting the desired field. Its settings then appear in the centre
column. The options available in the centre column are described in the following section.

34.4.2 Centre column

To modify an existing field, select it from the fields' overview list. Its contents can then be configured in the
centre column, which is divided into three sections: Field Data Source, Field Formatting, and Advanced Data

184 Bibliotheca.com
 Source Parsing.

First, enter a Field Name to identify the entry in the fields overview list, then fill out the Field Data Source
section.

34.4.2.1 Field Data Source

Select a Field Type from the drop-down list.

l FIXED defines a values that remains consistent from one hold to another, such as the library's name.
l SIP utilizes information from the library's LMS to fill the field.
l DATE PLUS DAYS and DATE TIME PLUS DAYS display the date a hold will expire, based on the date
an item was returned plus the value entered for Date Plus.

In the Data (for fixed type) or Sample Data (for SIP fields) blank, enter either the desired text to be displayed
when using a fixed type, or enter dummy data to be used for the sample ticket if the field is a SIP type.

Select a SIP Source from the corresponding drop-down menu. This menu contains the SIP fields from which
receipt information can be gathered, if the LMS provides it.

Entering a value greater than 0 in the blank for Truncate Data To limits the number of characters used for the
selected field, starting with the leftmost character. Checking Trunc. from End will use the specified number of
characters beginning with the rightmost character.

Enter the number of days from the date a hold item is returned until the date a hold notice expires in the blank
next to Date Plus - Days to Add.

Enter a Field Prefix to Add in the corresponding blank if desired. This is useful for designating the nature of the
field. For example, "Title:" is a prefix often used to precede the title of a hold item.

185 Bibliotheca.com
 34.4.2.2 Field Formatting
Select an Orientation for the text displayed as either HORIZONTAL or VERTICAL from the drop-down menu.

Only one receipt field can be displayed as a vertical column.

Similarly, select an Alignment for the text as either CENTER, NEAR (left), or FAR (right) from the drop-down
menu.

Clicking Change Font Options opens a window to customise the font used in the selected field, as shown to
below.

186 Bibliotheca.com
 Clicking Change Font Options opens a window to customise the font used in the selected field, as shown to
below.

Entering a value for a Field Pad Beneath Field creates a buffer underneath the field text, separating it from the
field below it.

34.4.2.3 Advanced Data Source Parsing

Most receipt fields do not require any of the features available in this section, which allow for very specific
customizations for libraries with unusual data source formats. Please contact Bibliotheca Support for
assistance with setting up this section.

187 Bibliotheca.com
 34.4.3 Right column
The right column contains a preview image of the configured hold receipt. Click UpdatePreview to update the
image in the preview screen. Clicking the preview receipt zooms in the view, while clicking and holding the shift
key zooms out. The horizontal and vertical scroll bars control the view of the preview window.

188 Bibliotheca.com
 34.4.4 Other Controls
The bottom portion of the Advanced Print Configuration window contains several controls. Most of the buttons
are self-explanatory, affecting some combination of saving the current template and exiting the Advanced Print
Configuration window.

Clicking Print Sample Holds Ticket, prints a holds ticket to the default printer using either the sample data, if
Use Sample Data is selected, or the entered SIP packet, if Use Sample SIP Packet is selected.

Clicking Backup this Configuration as a Template prompts a confirmation dialogue that once confirmed
allows for the current template to be saved with a customizable template name.

189 Bibliotheca.com
 34.5 Load Configuration Settings
The Load Configuration Settings button allows for a test of the currently defined hold slip. Pressing the button
will load the configuration and – upon success – will display a confirmation and indicate readiness for an actual
print test.

34.6 Print sample holds ticket

This feature of the configuration tool will print a sample hold slip. Threaded vs. Non Threaded indicates whether
the print process is executed synchronously or asynchronously.

The example print will use whatever is supplied in the text field below the Print sample button and interpret this
information as raw SIP2 check-in response message (with some extension fields). The message contents will
be used as basis for any SIP fields the hold slip may contain.

190 Bibliotheca.com
 35 Appendix C: Special character buttons on standard keyboards
Do not make changes to the keyboard xml layout files in:
C:\Program Files (x86)\Bibliotheca\selfCheck QCI
\bin\Controls\Keyboards

If you need to make changes to an xml layout files (AlphabetKeyboard.xml or

NumberSymbolKeyboard.xml), first make a copy of the file and save it in the Program
Data folder:
C:\ProgramData\bibliotheca\selfCheck QCI\Content\Controls

Make changes ONLY to the copy of the layout file, then update the configuration to point
to the copy.

To add or change characters on the standard Alphanumeric keyboard or Number Symbol keyboard, complete
the following steps.

1. Copy the xml layout file (AlphabetKeyboard.xml or NumberSymbolKeyboard.xml) you wish to

modify FROM the following directory:
C:\Program Files (x86)\Bibliotheca\selfCheck QCI \bin\Controls\Keyboards

TO the following directory:

C:\ProgramData\bibliotheca\selfCheck QCI\Content\Controls

2. Open System Manager.

191 Bibliotheca.com
 3. Select Workflow, then select Authentication.

4. Ensure that the values for Customer ID Keyboard and Customer PIN Keyboard are set to the desired
values.

5. If you made any changes to the System Manager settings, select Update.

6. Open the copy of the file you created, in Notepad++.

7. Amend the values in the copy to display the desired characters.

a. AlphabeticKeyboard.xml

There are 4 special character buttons on the standard Alphanumeric keyboard by default. The
Shift button on the on-screen keyboard can be used to display more special characters.

Amend the values to display the required characters.

</Key>
<Key KeyType="Character">
<Value>-</Value>
<ShiftValue>_</ShiftValue>

192 Bibliotheca.com
 </Key>
<Key KeyType="Character">
<Value>@</Value>
<ShiftValue>:</ShiftValue>
</Key>
<Key KeyType="Character">
<Value>.</Value>
<ShiftValue>,</ShiftValue>
</Key>
<Key KeyType="Character">
<Value>.com</Value>
<ShiftValue>.net</ShiftValue>
</Key>

b. NumberSymbolKeyboard.xml

Amend the characters (e.g. 1 toggles with !).

<Key KeyType="Character">

<V alue>1</V alue>

<ShiftV alue>!</ShiftV alue>

</Key>

If the customer does not want numbers by default, and instead wants special characters by
default, then switch the values for 1 and !, for example.

<Key KeyType="Character">

<V alue>!</V alue>

<ShiftV alue>1</ShiftV alue>

</Key>

8. Select Save.

9. Open selfCheck Configurator. Configurator can be found in the following directory.

C:\Program Files (x86)\bibliotheca\selfCheck QCI\bin

10. In Configurator, expand Authentication.

11. Point the installation to the copy of the xml layout file (AlphabetKeyboard.xml or
NumberSymbolKeyboard.xml) you modified, for the keyboard type associated with that layout file.

193 Bibliotheca.com
 a. Select CustomerIDKeyboardUri or CustomerPinKeyboardUri.

b. Select Modify.

c. Place the cursor in the field and enter the path to the copy of the xml layout file (for example,
C:\ProgramData\bibliotheca\selfCheck
QCI\Content\Controls\AlphabetKeyboard.xml).

d. Select OK.
e. Select Save.

12. Restart quickConnect.

194 Bibliotheca.com
 36 Appendix D - Setup Gen 1 Payment station (MEI & GBA) -
Legacy
quickConnect™ selfCheck can now support the legacy Gen 1 payment station (MEI Coin Acceptor and GBA
Note Acceptor) that can be found in legacy selfCheck™ 400 kiosks.

Setup the Gen 1 payment station (in Tech Tool):

1. On the kiosk, scan the administration card and close down quickConnect™ selfCheck.
2. Open the Technician Tool application.
3. Select MEI CF7xxx Coin Manager.
4. Select the ellipsis at the end of the Role field.
5. On the pop-up screen, set the Role to AcceptPayment.
6. Select the ellipsis at the end of the SupportedCurrencyDenomination field.
7. On the pop-up screen, select the item next to 0 in the Members list,
l Under settings, check that the CurrencyCode is set to the correct currency (e.g. GBP for Great
British Pound).
l Set the Value setting to the lowest coin denomination that is stored in the MEI Coin Acceptor. In
the example below, you can see that it is set to 0.01 which equates to 1 pence.

8. Work your way down the numbers in the Members list from lowest to highest, ensuring that the
CurrencyCode is set and increasing the Value with the next lowest denomination stored in the Coin
Acceptor (e.g. 0.02 = 2 pence, 0.50 = 50 pence, 1.00 = 1 pound).

9. Once complete, select OK on the pop-up screen.

10. Select Save Changes.
11. Select the ellipsis at the end of the FloatCurrencyDenomination field.

195 Bibliotheca.com
 12. On the pop-up screen, select the item next to 0 in the Members list. This item refers directly to the
denomination that was set against 0 in the SupportedCurrency Denomination field (1 pence, for
example).
13. Set the number of coins for each denomination that you want to set as the float in the Amount setting.
l In the example below, the Amount has been set to 59. This means that the float for this
denomination is 59 individual coins. If the denomination is 1 pence, for example, the float value
would be 59 pence. If the denomination value was 2 pence, the flaot value would be £1.18.

14. Work down the Members list and set the Amount value for each denomiantion accordingly.
15. Select OK to confirm any changes.
16. Select Save Changes.

17. Select the ellipsis at the end of the MinimumCurrencyDenomination field.

18. On the pop-up screen, select the item next to 0 in the Members list. This item refers directly to the
denomination that was set against 0 in the SupportedCurrency Denomination field (1 pence, for
example).
19. Set the minimum number of coins for each denomination in the Amount setting.
l If any denomination reaches it's own individually set minimum amount, cash payment will be
disabled on the kiosk. It is advised to set at least 3 coins for each tubed denomination.

20. Work down the Members list and set the Amount value for each denomination accordingly.
21. Select OK to confirm any changes.
22. Select Save Changes.

23. Select GBA Note Acceptor.

24. Select the ellipsis at the end of the Role field.

196 Bibliotheca.com
 23. On the pop-up screen, set the Role to AcceptPayment.
24. Select OK.
25. Ensure that the CurrencyCode is set to the correct currency.

26. Select the ellipsis at the end of the DataSetNoteTypeValues field.

27. On the pop-up screen, select the item next to 0 in the Members list.
l In Settings, set the IsAccepted value to True.
l Set Value to the lowest accepted note denomination that the Note Acceptor will accept. In the
example below, you can see that it is set to 500, which equates to a 5 pound note (GBP).

28. Work down the Members list, setting the Value for each accepted note denomiantion accordingly, in
order from lowest to highest, and also ensuring that IsAccepted is set to true.
29. Select OK to confirm any changes.
30. Select Save Changes.
31. Close Tech Tool.

Setup the Gen 1 payment station (in System Manager):

197 Bibliotheca.com
 1. On the kiosk, scan the administration card and close down quickConnect™ selfCheck.
2. Open the System Manager.
3. Select Devices > All .
4. Under the Accept Payments section, set the MEI Coin Manager and the GBA Note Acceptor to On.

5. Select Update.
6. Restart quickConnect™ selfCheck.

198 Bibliotheca.com
 Setup the Gen 1 payment station (in Configurator):

1. On the kiosk, scan the administration card and close down quickConnect™ selfCheck.
2. Open the Configurator.
3. Select Cash.
4. Ensure that the value for the Transaction Processor Id setting is set to CashBoxPair.
5. Save Changes.
6. Close Configurator.
7. Restart quickConnect™ selfCheck.

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

The Americas

Brasil Canada
+55 19 2515 7930 +1 877 207 3127 (select option 2)
[email protected] [email protected]

United States
+1 877 207 3127 (select option 2)
[email protected]

Asia and Pacific

Australia 中国
+61 3 8555 3388 +86 21 51078671
[email protected] [email protected]

香港 日本
+85 2 3719 8122 +81 3 6273 0159
[email protected] [email protected]

한국 Singapore
+82 02 6310 6565 +65 6 9044 270
[email protected] [email protected]

中華民國
+886 2 29012974
[email protected]

200 Bibliotheca.com
 Europe

België Danmark
+32 (0) 3 808 11 45 +45 7027 1008
[email protected] [email protected]

Finland France
+358 3410 93347 +33 (0)1 56 24 11 76
[email protected] [email protected]

Deutschland United Kingdom

+49 7121 9264 115 +44 (0)161 498 1150
[email protected] [email protected]

Nederland Norge
+31 (0)85 7600 840 +45 7027 1008
[email protected] [email protected]

Sverige Suisse
+46 8408 39145 +41 41 726 9950
[email protected] [email protected]

201 Bibliotheca.com