Queue-Busting APP

Project: Queue-Busting User Manual

Date: 22 October 2014
Author: A.Pettenò
Version: 1.0

1
REV DESCRIPTION OF CHANGE DATE BY

1.0 First revision of document OCTOBER 22, ANDREA

2014
PETTENO’

2
 Index
1 HOW TO INSTALL “QUEUE BUSTING” INTO JOYA DEVICES............ 4
2 QUEUE BUSTING EXPERIENCE ....................................................... 5
2.1 How to run Queue Busting ............................................................. 5
2.2 Terminal pickup ............................................................................ 5
2.3 Operator welcome ......................................................................... 6
2.4 Adding an item ............................................................................. 7
2.5 Item not found ............................................................................. 8
2.6 Deleting an item ........................................................................... 8
2.7 Basket Recap................................................................................ 9
2.8 Items List Review......................................................................... 10
2.9 End of Queue Busting ................................................................... 11
2.10 Abort of Queue Busting ................................................................. 12
2.11 Printer pairing ............................................................................. 13
2.12 Print ok ....................................................................................... 14
2.13 Session lock ................................................................................ 15
2.14 Currency on Joya Device ............................................................... 16
3 PAIRING BARCODE ...................................................................... 17
3.1 Bluetooth connection .................................................................... 17
3.2 Wi-Fi Connection .......................................................................... 19
4 HOW TO INSTALL “QUEUE BUSTING APPLICATION ” INTO PC..... 25
4.1 HW & SW Requirements ................................................................ 25
4.2 Installation .................................................................................. 26
5 EXAMPLE UPGRADE/MODIFY PLU WITH XML FILE....................... 28

3
1 HOW TO INSTALL “QUEUE BUSTING” INTO
JOYA DEVICES
Connect JOYA Device to a PC using standard micro USB cable
Transfer (using Microsoft ActiveSync) the file QBApp_Joya_RelX_YY.cab in \
(root).
From JOYA Device execute QBApp_Joya_RelX_YY.cab with double click
In the pop-up window “Install Datalogic”, select “OK”, and wait for complete
installation.
Perform a cold boot, by lightly pressing with a metallic clip inside the circle
hole on the back

4
2 QUEUE BUSTING EXPERIENCE

2.1 How to run Queue Busting

Double Click on “Queue Busting” icon on JOYA Desktop

2.2 Terminal pickup

This screen is shown to the operator when he withdraws the terminal from
the cradle using the magnet or when he starts the application double clicking
on the application icon.

5
2.3 Operator welcome
In order to be recognized by the application the operator must read his
operator identifying barcode

This screen is shown when an operator scans his operator identifying barcode
(so the application has recognized him).

6
2.4 Adding an item
When the operator scans an item the application retrieves, if present, the
item from its internal database and shows the information linked with this
item in the screen shown below.

Let resume the elements shown in this screen, starting from the top:

• Description: description of the item represented by this barcode

(“Olive Barilla”)
• Quantity: number of items (equal to the current one) present in the
basket (“1”)
• Price : gross price of the item (“£2.36”)

With plus and minus buttons can be used to increment or decrement the
item quantity.

7
2.5 Item not found
This screen is shown to the operator when he/she scan a barcode that is not present in the
database

2.6 Deleting an item

This screen is shown to the operator each time deletes an item from the basket.

8
2.7 Basket Recap
This screen is shown to the operator each time he/she wants to know the
basket recap pressing the button “=”on Joya

Let resume the elements shown in this screen, starting from the top:
• Quantity: Is the number of items present in the basket
• Gross Total: is the sum of the gross prices of all the items bought

NOTE: pressing button the shopping is closed and sent to the

printer (if paired).

9
2.8 Items List Review
This screen is shown to the operator each time he/she wants to know the
review the list of items bought pressing the button “e”

Let resume the elements shown in this screen for each item shown:
• Description: description of the item
• Price : sum of the prices of the items with that description
• Qty : numer of items with that description

10
2.9 End of Queue Busting
This screen is shown to the operator each time he/she wants to end a

shopping with pressing the button when the operator is on the Shopping
Recap

From this screen the operator must pair the printer reading the printer
pairing barcode ( in order to create the right barcode to pair the printer see
chapter 3 )

11
2.10 Abort of Queue Busting
This screen is shown to the customer each time he/she aborts a queue
busting reading the abort barcode

From this screen the operator can confirm to Discard the current session with
button or go back to the shop with button

12
2.11 Printer pairing
This screen is shown to the operator when he/she correctly pair a printer
using the printer pairing barcode ( in order to create the right barcode to pair
the printer see chapter 3 )

From this screen the operator can confirm to printer with button or read
a different printer barcode

As a result, the printer will print the QR code in a receipt similar to the one
that follows:

13
2.12 Print ok
This screen is shown to the operator when the terminal correctly prints a
basket.

From this screen the operator can read a new operator card,start with a new

shop with button or reprint the receipt with button or read a

different printer barcode

14
2.13 Session lock

If the terminal is not used for a customizable amount of time, in goes in a

“suspend” state (the screen becomes black).
If the terminal is still not used, the next time a user presses any button to
work with it, the following image appears to him/her:

The terminal will be usable only after the operator barcode scanning.
After this operation, the user will be asked to confirm the cancellation of the
previous session with button or to maintain it as it was by clicking the
button .

15
2.14 Currency on Joya Device

It is possible to change the currency on Joya device.

The default value is £

Modify the file QBApp.json that you can find on the folder BACKUP like shown
in the picture

For setting EURO

For setting DOLLAR

16
3 PAIRING BARCODE
Below the procedure in order to pair a ZEBRA printer to demo queue busting
application

3.1 Bluetooth connection

Run Zebra Setup Utilities into your pc

Connect Zebra printer to pc with usb cable

Select Next and later Finish to complete the installation

17
With the window of Zebra Setup Utilities select Open Printer Tools,Print
Configuration label Send

The result of this operation is a receipt from the print where is reported the mac
address

The printer pairing barcode is a CODE 128 STANDARD. It is possible to get it

by using a suitable barcode generator software and typing the following text:

cmd=pair,MACADDRESS

Here below an example

18
3.2 Wi-Fi Connection

Run Zebra Setup Utilities into your pc

Connect Zebra printer to pc with usb cable

Select Next Finish to complete the installation

19
With the window of Zebra Setup Utilities select Configure Printer Connectivity
Wireless Next

Set Hostname ( in the picture Zebra_WiFi )

20
Set ESSID and security mode of your LAN infrastructure( in the picture TSS
and without security mode )and select next

Select next

21
Select next

Select Finish

22
With the window of Zebra Setup Utilities select Open Printer Tools,Print
Configuration label Send

The result of this operation is a receipt from the print where is reported the IP
address of Zebra Printer

The printer pairing barcode is a CODE 128 STANDARD. It is possible to get it

by using a suitable barcode generator software and typing the following text:

cmd=pair,IPADDRESS

Here below an example

23
On Joya device go to My Device Control Panel Wi-Fi Profile

Set SSID and security mode of your LAN infrastructure( in the picture TSS
and without security mode )and select COMMIT

Exit from Summit Client Utility

Modify the file QBApp.json that you can find on the folder BACKUP like shown
in the picture

The default is : type=bluetooth

24
4 HOW TO INSTALL “QUEUE BUSTING
APPLICATION ” INTO PC

4.1 HW & SW Requirements

The PC where Queue Busting runs must have at least the following
hardware features:
• CPU: Intel core 2 duo or successive, AMD k10 architecture or
successive
• RAM: at least 2 Gbyte
• Hard Disk: 1 hard disk of at least 40 Gbytes;
• Network adapters: 1 Ethernet port 100BaseT depending on the chosen
network configuration
• USB Port

Required Software:
• Operative System:
o Microsoft® Windows XP® with Service Pack 3 or
o Microsoft® Windows 7® 32bit
.NET Runtime Ver 3.5 or higher

25
4.2 Installation

Double click on SetUp.msi

Select next

Select next

26
Select next

Wait the end of installation

27
5 EXAMPLE UPGRADE/MODIFY PLU WITH
XML FILE
Open file config properties present on folder
C:\Program Files\Datalogic ADC-MCSA\QueueBusting-
BackOffice\config.properties
and edit it and save like show below

Open Queue Busting-BackOffice

Connect Joya device

Select confirm

28
Copy file ItemsImport1.xml on folder
C:\temp\incoming (if not present create it )
The program show automatically if are present upgrade for Joya device.

Select confirm

Wait the end of the update

29