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
