Pricer System Manual
Pricer System Manual
Pricer System Manual
The information in this document is subject to change without notice. No part of this document may be reproduced or re-
transmitted in any form or by any means, electronic or mechanical, for any purpose, without permission in writing from
Pricer AB.
1
Table of contents
1 Introduction ............................................................................................. 5
1.1 General information ............................................................................................5
1.2 Software installation ...........................................................................................5
1.2.1 Prerequisites ...............................................................................................5
1.2.2 How to change web browser caching .........................................................6
1.2.3 Components in the Pricer System ..............................................................7
1.2.4 Installing the Pricer System ........................................................................7
1.2.5 Miscellaneous configuration .....................................................................11
1.2.6 Launching the Pricer System ....................................................................14
1.2.7 Installing a customer configuration file .....................................................14
1.3 Logging in to the Pricer Client ........................................................................15
1.3.1 How to login to the Pricer Client ...............................................................15
1.4 The toolbar at the top of the screen................................................................15
1.4.1 Status ........................................................................................................15
1.4.2 Batch Print ................................................................................................16
1.4.3 Link ...........................................................................................................16
1.4.4 Unlink ........................................................................................................16
1.5 Search ................................................................................................................16
1.5.1 How to perform a quick search .................................................................16
1.5.2 How to perform an advanced search .......................................................17
1.6 Alerts ..................................................................................................................18
1.7 Information pane ...............................................................................................19
8 Platform ................................................................................................. 42
8.1 System Administration .....................................................................................42
8.1.1 Advanced ..................................................................................................42
8.1.2 Backup ......................................................................................................44
8.1.3 Status ........................................................................................................45
8.1.4 User Management ....................................................................................49
8.1.5 Versions ....................................................................................................56
View Logs............................................................................................................56
8.2 System Configuration.......................................................................................58
8.2.1 Cloud Configuration ..................................................................................58
8.2.2 Configuration export .................................................................................58
8.2.3 General Settings .......................................................................................59
8.2.4 Geo Configuration.....................................................................................62
8.2.5 Global Parameters ....................................................................................63
8.2.6 Infrastructure .............................................................................................63
8.2.7 Item Configuration ....................................................................................67
8.2.8 Job Configuration......................................................................................68
8.2.9 Languages ................................................................................................71
8.2.10 Licenses ....................................................................................................72
8.2.11 Log Settings ..............................................................................................74
8.2.12 Print Configuration ....................................................................................75
8.2.13 SmartAPP Configuration ..........................................................................76
8.2.14 Store Configuration ...................................................................................76
8.2.15 System Parameters ..................................................................................78
8.2.16 Text Adapter .............................................................................................87
8.2.17 Web Page Configuration ..........................................................................87
8.3 XML-file Configuration .....................................................................................89
8.3.1 DatabaseConfiguration.xml ......................................................................89
8.3.2 MailInfo.xml ...............................................................................................90
3
1 Introduction
1.2.1 Prerequisites
To install the Pricer System, you need to be logged on to the computer as a user with
administrator rights.
Communication
The mode of communication between the Pricer Server and the Base Stations is either:
• TCP/IP (Base Station E3/E32 or network adapter)
• Serial (COM).
For a Pricer System with remote Clients we recommend that the server running the system has a
static IP address.
5
Hardware and software requirements
Please check the Release Notes to for your version to get the hardware and software minimum
requirements for running the Pricer Server and Client software.
Item Requirements
Backup A secondary backup system is strongly recommended; a tape backup, disk
backup or backup to another computer.
Power supply Uninterruptable power supply (UPS) with soft shutdown of operating system
and the database.
Internet connectivity Required for full functionality
Windows firewall
Depending on the security level set in the firewall included in Windows it might be necessary to
allow exceptions in the firewall for the ports used by Pricer. This particularly applies to TCP ports
950 and 3333 as seen in the list below. To do this in Windows 7, go to Control Panel | Windows
Firewall | Advanced Settings, and then create Inbound or Outbound rules.
Port Type Function
950 outbound TCP Base Station communication
514 inbound UDP Base Station E32 logging
3333 inbound TCP Pricer Client
11096 inbound TCP Public API R4.7
11097 inbound TCP Web Services API
11098 inbound TCP Internal RMI for WebInStore
PDF Viewer
In order to view the reports created by the Pricer Server, a program for viewing PDF files is
required. Adobe Reader (version 6.0 or higher) can be downloaded for free from www.adobe.com.
Prerequisites
You must have access to an installation exe file (e.g. Setup_R5.x.exe).
If you already have a configuration that the Pricer System will be working with, you should use
your configuration file (e.g. StarterConfig_R5.x.prc).
Procedure
To install the Pricer System software, follow these steps:
7
1. Run the Setup_R5.x.exe-file to start the
installation. Wait until the installer is launched,
it may take some time.
3. If you wish to :
4. Install Java included in the installation files,
click »Next».
Optional: use your current Java installation,
enter the path to the folder where your Java
files are installed, or click »Browse» to
navigate and select it. (For more information,
see chapter 1.2.13.). Then click »Next».
5. Accept the suggested installation folder
(C:\Pricer) or enter the name of the folder
where you want the software to be installed.
9
17. Step 1/10 will now start where PRC-file is
installed, services etc.
18. Step 10/10, click »Next» to continue.
The Pricer Server can be installed using an automatic script. An installation script can be
generated at the end of a normal installation. Installation options like Base Station address, name
and JRE path may be edited as necessary.
The installation can be started via the command line with one of the following commands:
• java -jar Installer.jar <installation script file>, or
• Setup.exe <installation script file>.
In this case, the complete path to the installation script file has to be given.
How to perform an automatic upgrade
To perform an automatic upgrade, the following command shall be given via the command line:
• Upgrade.exe /S
For upgrade on a Linux system, the file Upgrade.run shall be used.
If the Pricer software was installed by a user without administrator access rights, the network
access rights will be incorrect. They must then be re-configured after the installation.
Prerequisites
You must be logged into your computer as an administrator.
Procedure
To change the access rights for the Pricer Server, follow these steps:
1. Go to the »Start menu» and click »Control
Panel». Then open »Administrative Tools».
2. Double-click »Services».
3. Right-click »PricerServer» and select
»Properties».
On Windows 7 computers, the Start menu shortcuts “Start Pricer Services” and “Stop Pricer
Services” might not work properly after installation unless they are configured to be run by an
administrator.
11
Prerequisites
You must be logged into your computer as an administrator.
Procedure
To change the shortcut properties for Windows 7, follow these steps:
1. In the Start menu, select “Pricer”, then
“Pricer Server”.
The Link and Unlink dialogues have sound feedback. The sound option is set to OFF by default.
The user will manually have to set it to ON. This is configurable in Internet Explorer.
Prerequisites
You must be logged into your computer as an administrator.
Procedure
To turn on the sound, follow these steps:
1. Open Internet Explorer and select the “Tools”
menu.
2. Select “Internet Options” and select the
“Advanced” tab.
3. Scroll down to the “Multimedia” section and tick
the check-box for “Play sounds in webpages”.
4. Click »Apply» and then »OK».
13
1.2.6 Launching the Pricer System
The Pricer Server runs as a Windows service and starts automatically when Windows is started.
However, there can be occasions when you need to start or stop the Pricer Server manually.
Procedure
To start or stop the Pricer Server manually, follow these steps:
1. From the Start menu, select “Pricer”, then “Pricer Server” and
left-click on “Start Pricer Services”.
2. To stop the server, repeat step 1 but select “Stop Pricer
Services”.
Prerequisites
You must be logged into your computer as an administrator. You must also have access to the
configuration file.
Procedure
To install a configuration file, follow these steps:
1. In the Start menu, select “Pricer”, then
“Tools”.
2. Click on “Configuration Installer”.
3. Click »Browse» to find and select the
configuration file you need.
4. Click »Install» to start the installation.
5. When the installation is finished, click the
Windows »Exit» button to complete the
procedure.
How to perform an automatic configuration installation
The configuration installer can be run in silent mode. To do this, run the following command in the
folder <Pricerinstallationdirectory>/R3Server:
"%PRICER_JAVA_HOME%\bin"\Java –jar R3Server.jar “Prc” <path of prc file>
Prerequisites
The Pricer software must be correctly installed on your computer.
Procedure
To login to your Pricer Client, follow these steps:
1. Start the Pricer Client.
2. Enter the username and password in the “User ID” and “Password” fields. Both are case-sensitive.
Default administrator User ID and Password are both config.
3. If you want to change your password, click the link »Change password».
4. Select the preferred language in the drop down box. The default value depends on the local computer
settings and the settings for the specific user logging in.
5. Check the “Remember me” checkbox if the login credentials should be saved for next login attempts.
This feature is active for two weeks or until the user logsout.
Note! The “Remember me” checkbox can be turned off by using the System Parameter
REMEMBER_ME_AUTHENTICATION.
6. Click »Login» to log into the interface.
The main screen of the Pricer Client will now appear. Any page can be configured as a start page for
a particular user.
NOTE! Maximum number of login attempts are 10 for a specific account before you are locked out for 5
minutes. These parameters are non-configurable.
1.4.1 Status
Use Status to get details about the system status. For more information about the Status page, see
chapter 7.1.5 Status
15
1.4.2 Batch Print
Use Batch Print to print and manage multiple overlays. For more information, see chapter 2.2.1 Batch
print.
1.4.3 Link
Use Link to link ESLs. For more information, see chapter 2.1.1 Link ESL.
1.4.4 Unlink
Use Unlink to unlink ESLs. For more information, see chapter 2.1.1 Unlink ESL.
1.5 Search
This section describes how to search for specific items or ESLs. There are two ways to search; quick
search and advanced search. The entry field for quick search is always available in the top right-hand
corner of the screen.
Procedure
To use Quick search, follow these steps:
1. Enter an Item ID, ESL barcode, or a supplementary search value in the quick search text field and
press the button.
2. If the quick search finds:
• an item matching the search criteria you entered, the result will be shown in a table sorted under
these headings:
• To see more information about an item, click the item number link in the column “ITEM ID”. A new
screen will be displayed showing all the information about the item. You can also print an overlay
for this item from this screen.
• an ESL matching the search criteria you entered, the result will be shown in a table sorted under
these headings:
To see
more information about an ESL, click the ESL barcode link in the column “ESL BARCODE”. A
new screen will be displayed showing all the information about the item. You can also print an
overlay for this item from this screen.
Procedure
17
Items with timed Search for all items on a Failed ESLs Search for all ESLs in the system
update specific date that have a that have status Failed
timed update
Items in roaming Search for all items that ESL waiting for price Search for all ESLs in the system
are in roaming that are currently being updated
with a new price
Items waiting for Search for all items that ESLs price updated Search for all ESLs that have
update are waiting to be at date been updated on a specific date
updated by the system
Items in state OK Search for all items that All posters Display all SmartPosters in the
have status OK system
4. A field corresponding to the criteria type you chose will appear under the search criteria field.
1.6 Alerts
At the bottom left of the Pricer screen, there is a small pane showing system alerts.
Icon Description
“Show Alert history” shows the last 5 days of alerts in the system
Error
Warning
Information
Alert can be removed manually. The cause of the alert may still exist in the system, and the
alert may show up again.
Alert cannot be removed manually. The cause of the alert must be solved before it is
automatically removed.
19
2 Price Automation
This chapter describes how to work with “ESL Management”, “Print” and “SmartPoster” in the
Pricer Client.
Prerequisites
Before linking an ESL, the following prerequisites must be fulfilled:
• The ESL model that you want to link to must be configured in Price Automation |ESL
Management | ESL Configuration.
• The item that you want to link to the ESL must be in your database.
Procedure
To link an ESL to an item, follow these steps:
1. From the main menu, select Price Automation |ESL Management | Link ESL or click
»Link» in the toolbar.
2. Enter the ESL barcode found on the back of the ESL, either by entering it manually in the
field “ESL Barcode” or by using a barcode scanner.
3. Check that the model displayed is correct. If needed, change it by selecting a different
model from the drop-down list.
4. Enter the Item ID found on the overlay on the front of the ESL.
5. Click on the »Link» button to link the ESL to the item. The ESL is updated with the correct
price and item information. This normally takes a few seconds. Look at the ESL display.
The ESLs which have been linked are listed at the bottom of the window. A successful link
is indicated with the word “Success” in the “STATUS” column.
If the item does not exist in the database, an error message will appear when trying to link.
A forced update is a transmission sent to an ESL regardless of the ESL’s status. The latest data is
sent immediately. For example, this can be useful if the user wishes to update to an ESL in
roaming mode without having to wait for the next roaming transmission. If the ESL responds
correctly to the forced update, it will be updated.
Prerequisites
To perform a forced update, the ESLs to be updated must be found using an advanced search,
see chapter 1.5.2 How to perform an advanced search.
Procedure
To force an update on a single ESL or a related group of ESLs, follow these steps:
1. Perform a detailed search for an ESL (see 1.5.2 How to perform an advanced search).
2. To force an update on:
• One or several ESLs, click the check-boxes in the “Select” column for those
ESLs, and then click the button »Force Update on Selected» (positioned under
the list).
• All of the ESLs, click »Force Update on All» (positioned under the list).
21
Unlink ESL fields
The list shows successfully unlinked ESLs.
Parameter/Field Description
ESL Barcode The code that identifies the ESL in the Pricer System. Is found on the
back of the ESL.
Department Select the department where the unlink should be done.
Position Select unlink position if multi-item template is used.
ITEM NAME Name of the item.
ITEM ID The code that identifies the item in the Pricer System.
STATUS Success: unlinking worked.
Invalid barcode: unlinking did not work.
Procedure
To unlink an ESL from an item, open the “Unlink ESL” page and follow these steps:
1. In the field “ESL Barcode”, enter the number found on the back of the ESL, either by
entering it manually using the keyboard or by using a barcode scanner.
If you enter the barcode using a barcode scanner, the system will look up and display what
this ESL is currently linked to and unlink it at the same time.
2. If you entered the barcode manually, click »Unlink» to complete this procedure.
Parameter/Field Description
Import Items Where you can browse for and import the file containing information about
the batch of ESLs.
Link ESL Entry field for the barcode of a single ESL.
ESL Location Gives the location for a single ESL
2.1.4 Reports
This section explains the reports and how to generate them. Pricer uses JasperReports to
generate the reports.
Reports are generated using the functions under Platform | System Configuration | Job
Configuration. They can be set to be generated automatically and repeatedly at certain times.
Reports can be generated for distribution by mail, direct printing or saved to disk.
Select Price Automation | ESL Management | Reports in the main menu to display the “Reports”
landing page:
Report types
These types of reports can be generated:
23
Report Description
ESL Status Report Shows the total number of installed ESLs, total number of ESLs in
roaming, total number of ESLs in waiting for update and total numbers of
ESLs with low battery.
ESL Roaming Report Shows a list of the ESLs that have a communication problem with the
system, grouped by store department.
Recent ESL Roaming Shows a list of the ESLs which had a communication problem during the
Report last seven days (configurable in the parameter
NUMBER_OF_DAYS_FOR_RECENT_ROAMING under Platform |
System Configuration | System Parameters). This report is a
complement to the ESL Roaming Report.
System Status Report Shows the status information for the base stations, transceivers and
ESLs. It includes the total number of units and the number of units with
problems.
Price Change Statistics Shows the number of price changes made per day. It also shows the
Report number of ESLs that have a price display problem and the number of
ESLs that have been linked and unlinked during the day.
By default the report show 3 months of history. The history length can be
configured in the parameter NO_OF_MNTHS_FOR_STAT_REPORT
under Platform | System Configuration | System Parameters.
ESL Summary Report Shows a summary of the ESL statuses at the time of the report, per store
department.
ESL Low Battery Report Shows a list of all ESLs that have reported low battery status during the
latest battery check. This report is only available if a check battery status
job has been scheduled in Platform | System Configuration | Job
Configuration.
Prerequisites
To be able to view the reports on a computer, Adobe Reader must be installed.
Procedure
To view a report, follow these steps:
1. From the main menu, select Price Automation | ESL Management | Reports.
2. Select the report you want to view from the list shown.
3. The report PDF-file will now be displayed in a separate Adobe Reader window.
4. To save or print the report, use the Adobe Reader menu options.
The default and supported report format is pdf. Another format can be used for the report
generating program JasperReports, but this is not officially supported by Pricer. This can be
achived by adding an additional line in the
\Pricer\R3Server\config\ReportNameConfiguration.xml file.
Procedure
To change report format, follow these steps:
1. Open the \Pricer\R3Server\config\ReportNameConfiguration.xml file.
2. Add the line <FileFormat>XXX</FileFormat> for all reports that should have different format
like the following example:
<Report>
<ReportName>CreateRecentRoamingReport</ReportName>
<ReportJRXMLFileName>ESL_RECENT_ROAMING_REPORT.jrxml</ReportJRXMLFileName>
<FileFormat>XXX</FileFormat>
</Report>
Procedure
To link an IR key, follow these steps:
1. From the main menu, select Price Automation | ESL Management | Manage IR Key.
2. Enter the barcode of the IR key to be linked, either by entering it manually or by using a
barcode scanner.
3. Select the department where the initialization should take place.
4. Point the IR key toward the nearest transceiver and click »Enter». You need to point the IR
key because the signal from the IR key is weaker than an ordinary ESL.
25
5. The list will be updated with the new IR key. If the status is set to “NOT OK”, the IR key
has not responded on all configured buttons? In that case, reload the window after 20
seconds to see if the status has changed. If the status does not change from “NOT OK”,
update the IR Key as described the section “How to update an IR Key”.
Procedure
To remove an IR key, follow these steps:
1. From the main menu, select Price Automation | ESL Management | Manage IR Key.
2. Click the check-box of the IR key that you want to remove.
3. Point the IR key toward the nearest transceiver and click »Remove». You need to point
the IR key because the signal from the IR key is weaker than an ordinary ESL.
The removed IR key will be removed from the list of IR keys.
Procedure
To update an IR key, follow these steps:
1. From the main menu, select Price Automation | ESL Management | Manage IR Key.
2. Click the check-box of the IR key that you want to update.
3. Point the IR key toward the nearest transceiver and click »Force Update». You need to
point the IR key because the signal from the IR key is weaker than an ordinary ESL.
4. The IR key is now updated.
Prerequisites
Before importing a text file, make sure that the file only contains item IDs, and that each item ID in
the text file starts on a new row.
Procedure
1. Click »Browse» to find and select the text file that contains the item IDs.
2. Click »Import» to import the IDs from the file.
Parameter/Field Description
Batch Name A unique name given to a batch of overlays.
Model The name of the ESL model which then specifies the overlay size and
information layout.
Item/ESL The Item ID or the ESL code that identifies the item or ESL in the Pricer
System.
Prerequisites
Before printing new overlays, the following prerequisites must be fulfilled.
• The ESL models that you want to print overlays for must be configured in Price
Automation | ESL Management | ESL Configuration.
• The default printer and settings for it must be set in Price Automation | Print | Print
Configuration.
• There must be items in the database.
Procedure
To create a list of overlays (called a batch) and to print these, follow these steps:
1. From the main menu, select Price Automation | Print | Print Configuration or click
»Print» in the toolbar.
2. Enter a name for this batch in the Batch Name field. ”Pricer_<dateandtime>” is suggested
by default. (This default batch name can be changed in the Price Automation | Print |
Print Configuration.)
3. Select the ESL Model from the Model drop-down list. The model specifies the overlay size
and information layout.
27
4. Add an overlay for an item to the list, by:
• entering the Item ID in the “Item/ESL” field and then clicking »Add Item», or
• using a barcode scanner to enter the item ID (adds the item automatically to the
list).
5. If you have added an item incorrectly you can delete it from the list by making sure that it
is the only one with a ticked check-box and then clicking »Delete Selected».
6. Before printing your created overlays, make sure that;
• the check-boxes are ticked,
• the quantities are correct.
7. To Print the batch, click »Print Selected» to complete this procedure.
8. The screen will be displayed automatically, see chapter 2.7 Batch Reprint.
9. To save the batch for later printing, see How to save a batch of overlay print jobs.
If you have created a print batch job but do not want to print it directly, you can save it using this
function.
Prerequisites
To save a batch of print jobs, you must first create a print list, see “How to print new overlays”.
Procedure
1. When you have created a list of items to be printed, make sure that all the check-boxes
are ticked and that the quantities are correct and then click »Save Batch».
2. In the confirmation dialog box that is displayed, click »OK» to complete this procedure.
3. The “Batch Reprint” screen will now be displayed automatically, see chapter 2.7 Batch
Reprint.
Prerequisites
Before printing a single overlay, the following prerequisites must be fulfilled:
• The ESL model that you want to print an overlay for must be configured in Price
Automation | ESL Management | ESL Configuration.
• The default printer and settings for it must be set in Price Automation | Print | Print
Configuration.
• The item to be included in the overlay must be in the database.
Procedure
To print a single overlay, follow these steps:
1. From the main menu, select Price Automation | ESL Management | ESL Configuration.
2. Select the ESL model from the “Model” drop-down list. The model specifies the overlay
size and layout.
3. To print an overlay for a specific item, enter the Item ID in the “Item/ESL” field.
To reprint the overlay for an existing ESL, enter the ESL Barcode.
Both item numbers and barcodes can be entered either manually or with a barcode
scanner.
4. Click »Print» to complete this procedure.
29
Parameter/Field Description
DATE The date when the batch was created or last printed.
MODEL Display which type of model that was printed.
NO. OF OVERLAYS The number of overlays included in this batch.
Model (Create) A drop-down list with all available printable models if an already printed
batch should be printed again, but this time with another model.
1. Select new model from drop-down list.
2. Select which batches (one or several) to reprint using the new
specified model.
3. Click »Print selected» to print the batches with the new specified
model.
Prerequisites
You can only reprint batch print jobs that have been saved. If there are no saved batch jobs, the
list of saved jobs will be empty. To create a new batch job, see chapter 2.2.1 Batch print.
Procedure
To reprint a batch print job, follow these steps:
1. From the main menu, select Price Automation | Print | Batch Reprint.
2. Tick the check-box for the batch that you want to reprint.
3. Click »Print selected» to complete this procedure.
You can also delete saved batches by clicking »Delete Selected».
Prerequisites
Before importing an item file, make sure the text file to be imported is plain text with only a single
item ID per row, or a single model name per row.
Procedure
To import a text file, follow these steps:
1. From the main menu, select Price Automation | Print | Batch Reprint.
2. Click »Import Batch» (positioned below the list of saved batches).
A new screen will be displayed:
3. Enter the name of the new batch file that you will be creating in the “Batch Name” field or
accept the default batch name.
4. Select the ESL Model from the “Model Name” drop-down list to determine the overlay size
and layout.
5. Enter the name of the text file in the “Select” field containing the item ID list, or click
»Browse» to find and select the file.
6. If you want to start reading the file from a different line than the first line, enter the line
number in the “Start Position” field.
If the item codes are a different length than 13 characters, enter the length in the “Length”
field.
7. Click »Import» to complete this procedure. The contents of the file will be saved as a print
batch and will be visible in the “Reprint Batch” landing page.
Click on the Stickers alert to go to the Batch reprint page, where the
overlays can be reprinted.
You can change the name and suffix for this function.
31
Parameter/Field Description
Enable auto PFI print If checkbox is checked, this function automatically tries to print any
batches from the PFI (Pricer File Interface). If the box is unchecked, the
PFI print batches will be saved in the list on the page “Batch Reprint”, with
the status “New”, and will need to be printed manually. The print batch
can be given a default name (set in the “Name:” field) with an added suffix
(set in the “Suffix” field, see description below).
Suffix The suffix can be set using any of the following parameters
“yyMMddHHmmSS”, where: yy=year, MM=month, dd=date, HH=hour,
mm=minutes and ss=seconds.
Prerequisites
At least one Windows printer must be installed and at least one ESL model must be configured to
perform this procedure.
Procedure
To configure a printer, follow these steps:
1. From the main menu, select Price Automation | Print | Print Configuration.
2. In the “Default Printer” area of the screen, click »Add model».
3. From the “Model” drop-down list, select the ESL model. Then select the printer to use for
this type of ESL, from the “Printer” drop-down list.
4. Check the box “Default” to make this setting the default setting for all ESL models. The
default printer will be used if no printer has been selected when making a printout.
5. To add more printers, repeat this procedure from Step 2.
6. Click »Save» at the bottom of the screen to complete this procedure.
This function lets you print from a Client computer and redirect the printouts to a specific printer. It
will also assign the correct home department for this Client.
Prerequisites
At least one Windows printer must be installed and at least one ESL model must be configured to
perform this procedure.
Procedure
1. From the main menu, select Price Automation | Print | Print Configuration.
At the bottom of the window, click »Add Client». An “Add Client” area is displayed:
2.3 SmartPoster
A SmartPoster is a player connected to a large screen that can be used to show several items and
to promote certain articles. For more information how to configure and create templates, see
Pricer_SmartPoster.pdf.
2.3.1 SmartPoster
Displays the list of added SmartPosters.
33
3 Click & Collect
As the online penetration continues to increase, and brick & mortar stores begins to offer their
customers Click & Collect, the importance of improving picking performance is increasing as well.
The Click & Collect solution draws from all components of the Pricer Communication Platform. The
online sales order are imported as curated lists. The picker is positioned using BLE trilateration and
the positions of the ESLs are used to plan the optimal route through the picking. The position of the
picker and the articles on the pick list are displayed on the store map in the pickers handheld device
together with the shortest path to the next article in the list. SmartFlash then provides the final visual
guidance to the specific article.
Statistics
The Statistics page shows statistics of all orders that has been done. The statistics are updated
weekly on Sunday nights.
If there is not enough data to show statistics, it will be updated as soon as there is.
35
4 Task Management
Delisting products, negative stocks, new arrivals, shelf implementation, shelf talker management…
A large portion of the work performed in the shop occurs at the position of the article on the shelf.
The Pricer solution Task Management aims at streamlining the process of finding the position of an
article and performing a task at it. The store staff use the Pricer Task Management Solution to carry
out operational tasks. They receive the list of tasks to carry out and are guided in the store to each
ESL for which a task is requested. The concerned ESL will flash when it is approached and the task
to be performed is displayed. The system combines the indoor positioning of the handheld device
and the positions of the ESLs to guide the staff to the right place and real time SmartFLASH to find
the article on the shelf.
37
5 Shopper Guidance
Shopper Guidance is a solution in the Pricer Platform where the shopper is the intended user.
Shopper guidance gives store managers and retail chains the opportunity to optimize the store visit
with functionality to plan the visit ahead and then get real time guidance on the optimal route through
the store during the visit.
Article master data in the Pricer Platform is published in the Cloud and made available. This allows
the shoppers to search for articles from a remote location and create purchase lists to plan their visit
upfront. As the purchase list is being filled, the Shopper Solution uses the positions of the ESLs to
plan the optimal route through the store passing by all articles.
In the store the store map is retrieved from the Cloud. Trilateration with BLE beacons is used to
position the shopper’s smartphone and display this on the map. The shortest path from the shopper’s
position to the next article in the purchase list is displayed on the map and is updated as the shopper
move through the store.
This procedure explains how to generate an Article Group to show the area in which the ESLs are
located that belongs to same article group.
Procedure
To generate an Article Group, follow these steps:
1. From the main menu, select Platform | Shopper Guidance | Article Groups.
2. Click »Add» and select from the dropdown list which Item Property that the article group
should be generated from.
3. Click »Save and Generate Article Groups» to start the generating.
4. Click »Show Groups» to divide the list into Auto Generated and Manually Managed
positions.
39
6 Product Finder
Product Finder is a solution in the Pricer Platform where the shopper is the intended user. Product
Finder gives store managers and retail chains the opportunity to optimize the store visit with
functionality to get real time guidance to a specific product in the store.
Article master data in the Pricer Platform is published in the Cloud and made available. This allows
the shoppers to search for an article to get the position and get the optimal route through the store.
In the store the store map is retrieved from the Cloud. Trilateration with BLE beacons is used to
position the shopper’s smartphone and display this on the map. The shortest path from the shopper’s
position to the article is displayed on the map and is updated as the shopper move through the store.
With NFC (Near Field Communication) chips integrated into SmartTAG labels, retailers have the
option of providing enriched experiences to the shoppers. When holding their smartphone near NFC
integrated labels, shoppers receive content such as marketing campaigns, videos, product specs or
the retailer’s ecommerce web on their smartphone. NFC also offers the possibility to replace any
bar code scanning applications by new user friendly tools, using shoppers’ smartphones and NFC
integrated ESLs for self-scanning. The NFC configuration is done in the Cloud.
The Pricer NFC solution offers a dynamic configuration platform. Each NFC label is pointing to the
same URL; for example http:\\esl.nu\cf\t7diu840j20js3ha5 (t7diu840j20js3ha5 is the actual
barcode but in encrypted format). When the ESL is linked in the Pricer Server it will also be stored
in the NFC cloud server. In the NFC cloud server the item that is linked to one or several ESLs is
then configured to redirect the NFC request to another URL. This ensures that every ESL that is
linked to same product is redirected to same URL. This can also be handled on chain level as well.
So item A in store 1 and store 2 is redirected to same URL.
41
8 Platform
8.1.1 Advanced
Select Platform | System Administration | Advanced in the main menu to display the
“Advanced” landing page:
A PFI file contains text information about the links between the parts of the system. This procedure
explains how to export ESL data into a PFI file (Pricer File Interface). The files contains ESL data
such as items and links, and can be separated so that for example only a link backup is made.
This may save time when the item database is big and already available.
Procedure
To create a PFI file, follow these steps:
1. From the main menu, select Platform | System Administration | Advanced.
2. In the drop down list under “Export ESL Data”, choose to create a PFI file containing:
• Items and links
• Only items
• Only links
3. Click »Create PFI».
4. To view the PFI file, go to the Pricer installation directory, open and search for the file in
the folder named “Databasebackup” (all PFI files are saved here).
How to update ESLs
This procedure explains how you can issue update commands to ESLs in the system. You can
cause the ESLs to recalculate or re-transmit all information.
Procedure
To update ESLs, follow these steps:
6. From the main menu, select Platform | System Administration | Advanced.
7. Depending on what you want, click one of the following buttons:
• »REFRESH» to force all ESLs to recalculate using their current information.
• »FORCE UPDATE» to re-transmit all changed information irrespective of the
information currently in the ESLs.
• »FULL ROAMING» to perform a roaming sweep for all ESLs on the roaming list.
8. Click »Confirm» in the pop-up confirmation window that appears to complete this
procedure.
This procedure explains how change the key code for the ESLs in the system.
The ESL key code is an access code that is used between all ESLs and IR keys linked to the
system. Without the correct access code an IR key cannot communicate with an ESL.
Procedure
To change the ESL key code, follow these steps:
1. From the main menu, select Platform | System Administration | Advanced.
2. Enter the key code you want to update in the “Update ESL key code” field. The key code is
4 characters in hexadecimal format (0-F can be used). The key code is set to “0” by
default.
3. Click »Update» to set the new key code.
4. Click »Yes» in the pop-up confirmation window that appears to complete this procedure.
5. All ESLs and IR keys linked to the system hereafter will automatically be set to use this
code.
If there are any ESLs that are already linked in the system, click »Force Update» to
transmit the new key code to them.
This procedure forces a recalibration at the next transmission to the departments. Although the
system automatically recalibrates at certain time intervals, there can be a need to manually
recalibrate if there are problems updating ESLs in certain deaprtment.
Procedure
To recalibrate all departments, follow these steps:
1. From the main menu, select Platform | System Administration | Advanced.
2. Click »Recalibrate».
3. Click »Yes» in the pop-up confirmation window that appears to complete this procedure.
43
How to send server statistics to Pricer
Pricer can send store statistics to a remote could server. For this to work a Cloud Registration is
needed.
Procedure
To send statistics about a server to Pricer, follow these steps:
1. From the main menu, select Platform | System Administration | Advanced.
2. Click »Send».
Transmission diagnostics is a special tool that can be used to collect transmission data even if the
server has entereds a deadlock situation. This tool is only intended for support issues.
Procedure
To generate transmission diagnostics, follow these steps:
1. From the main menu, select Platform | System Administration | Advanced.
2. Click »Generate».
8.1.2 Backup
The backup function is used when creating a backup of the complete system or selected parts of
it. Logs and external files/folders can be added to the backup.
It is recommended to schedule daily backups using the “Jobs” function, see 8.2.8 Job
Configuration.
It is also recommended to make frequent backups of the disk containing the backup files.
Select Platform | System Administration | Backup in the main menu to display the “Backup”
landing page:
A full or partial system backup is made by manually selecting which files and folders to be
included.
Procedure
To generate a backup, follow these steps:
1. From the main menu, select Platform | System Administration | Backup.
2. To select files and/or folders to a backup, use the »Add» button for “Files and Folders”. In
the window that opens, select the files and/or folders you want to backup.
3. If you want to save this backup configuration, click »Save».
4. The backup configuration will be displayed below the “Full System Backup” button.
5. Click »Generate» to create the backup.
6. The backup will be made and the text “PRC generated, download” appears under the title.
7. To save the backup file, click “download”. A window will open from which you can select a
location to save the file.
8.1.3 Status
The “Status” page shows the status of the Pricer System including the Pricer Server and ESLs.
Select Platform | System Administration | Status in the main menu, or click on the Status
button at the top of the screen, to display the “System Status” landing page:
Status
Status fields
Parameter/Field Description
Item Status Chart
Red Less than 89% of the ESLs have acknowledged price and information
register updates.
Yellow Between 90% and 95% have acknowledged updates.
Green More than 95% of the ESLs have acknowledged the updates.
Transmitting Chart
Shows the current maximum speed for transmitting data to the ESLs
45
Advanced Status
The Status Advanced page gives detailed status information about the system.
Text Adapter
Datafile Progress Progress of the data file processing.
Back Office
Queue Length Length of back office queue.
Progress Progress of the back office processing.
ESL Status
Number of installed The number of ESLs installed.
Waiting for update Number of ESLs waiting for an update.
ESL failed ESLs that the system for some reason failed to update.
Low battery ESLs that have a weak battery indication. Before the first battery check has been
run, the ESL battery status is automatically set to OK. It is recommended to
configure the system to regularly check the battery status. If the low battery
indicator contains a non-zero value, the ESL battery should be replaced within a
few weeks.
Roaming ratio The percentage of roaming labels compared to the total number of labels.
Transmission Status
Basestation Active/Non active
Trx group Transmitting group of transceivers.
Protocol Type of communication protocol that is used for the transmission.
Priority Priority of transmission.
Start time Start time for transmission.
Backup Status
Name Name of backup.
Started Backup start time.
Ended Backup end time.
Status Status of backup.
History
Source Type of data import source:
• PFI
• TEXT_ADAPTER
• IMAGE_API
Data file Data file name.
Message file Message file name.
Result file Result file name.
Records Number of records in the file.
Failed Number of records failed to be imported.
Items Number of items in the file.
ESLs Number of affected ESLs in the file.
Start Import start time.
End Import end time.
Transmission complete Transmission completed time.
47
System Status
The system status tab is intended for developers to debug the system.
Queue Sizes
The queue size graph shows the current queues in the system.
PFI
See Advanced Status
Text Adapter
See Advanced Status
Back Office
See Advanced Status
ESL Status
See Advanced Status
Transmission status
See Advanced Status
User Management is used for administrate users, groups and domains. Select Platform | System
Administration | User Management in the main menu to display the “User Management” landing
page:
Users
There are two types of default users managed in the system, “Administrator” and “Instore”. Users
are allocated access permissions according to the groups they belong to and each user must
belong to at least one group. The “Disabled” can only be seen by the Administrator which shows
the accounts that has been locked.
Procedure
To add a new user, follow these steps:
1. From the main menu, select Platform | System Administration | User Management and
Users tab.
2. Click »New User». This displays the “New User” windows:
49
3. Enter all necessary data for the user:
Parameter Description
Username Enter preferred username
Password Enter preferred password
Groups Select group/groups this user should belong to
Name Name of user
Department Department for user
Email Email for user
Phone Phone number for user
Language Preferred language for user
Start Page Start Page for user when logging in
To manage the users settings, from the main menu, select Platform | System Administration |
User Management and Users tab and click on the user to manage.
Parameter Description
Disabled Check/Uncheck the disabled box to Disable/Enable the user. Click
»Save» to finish the operation.
Change Password Click »Change Password» to open Change Password window.
Enter new password and click »Change Password» to finish the
operation.
Create API Key Create new API key for the user to be used for API authentication login.
Revoke API Key Revoke previously API key so it cannot be used anymore for API
authentication login.
51
Groups
Groups are used to manage user permissions. Select Platform | System administration | User
Management and Groups tab:
Procedure
To create a new group, follow these steps:
1. From the main menu, select Platform | System Administration | User Management and
Groups tab.
2. Click »New Group». This displays the “New Group” window:
Domain Configuration
Pricer supports Active Directory (AD) with the LDAP protocol. Select Platform | System
administration | User Management and Domain Configuration tab:
How to create a new LDAP configuration
Procedure
To create a LDAP configuration, follow these steps:
1. From the main menu, select Platform | System Administration | User Management and
Domain Configuration tab.
2. Click »New LDAP Configuration» to displays the “New LDAP Configuration” window:
53
Parameter Description
to anonymous. The BIND operation establishes the authentication state
for a session. Only one account is needed to access the other accounts.
Password Enter password for user
Procedure
How to administrate LDAP login, follow these steps:
1. From the main menu, select Platform | System Administration | User Management and
Domain Configuration tab.
2. Set created domain (ex. pricer.com) as default login using the radio button (no save is
needed).
3. Go to the Group tab and select the preferred group (ex. admin group).
4. Add which domain groups that should belong to this group.
NOTE! If default login is still pricer.local (LOCAL) the username must be the full path; ex.
[email protected].
NOTE! If local users like config, instore etc. are used with LDAP the full path must be
specified; ex. [email protected].
NOTE! All AD users are not displayed on the User Management page since it will take too
long time to load all AD users.
55
8.1.5 Versions
The Versions view shows the different software versions and the history of installed Pricer Server
versions.
Select Platform | System Administration | Versions in the main menu to display the “Versions”
landing page:
View Logs
Description of logs
The system consists of three general logs and one base station log:
Log name Description
GlobalErrorLog.txt Logs error events from all subsystems.
InfraLog.txt Logs the transceiver and base station communication.
ServerLog.txt Logs every event from all subsystems.
Base station log There is one base station log for each installed base station. The format
of the log is the base station type and the IP-address (e.g.
E32.172.17.1.10.txt).
This procedure enables you to see the contents of a log. If you want to change the level of the log,
see the section “How to change the log level” in chapter 7.3.6 Log Settings.
Procedure
To see the contents of a log, follow these steps:
1. From the main menu, select Platform | System Administration | View Logs.
2. Select the log you want to see in the “Subsystem Name” drop-down list.
3. Enter the number of lines you want per page in the “Lines Per Page” field.
4. Select the view you want in the “View Logs Criteria” drop-down list:
• to view from the beginning of the file, select “BOF”,
• to view from the end of the file select “EOF”,
• to view a specific range of lines, select “Range” and fill in the start line number in the
“Start Line number” field which is then displayed.
5. Click »Submit» to open the selected log.
6. Scroll through the pages using the “Page” drop-down list that appears at the bottom of the
screen.
57
8.2 System Configuration
Procedure
To create a configuration file, follow these steps:
1. From the main menu, select Platform | System Administration | Configuration export.
2. Enter a suitable name and description of the configuration file you want to generate, in the
“Name” and “Description” fields.
3. Choose to include “Esl Configuration”, “Poster design” and/or “System Configuration” by
checking their respective check boxes.
4. If you want to add files and folders, click the »Add» button for “Files and Folders”. A window
will open (see image) from where you can select the files or folders you want to add.
5. If you want to add custom database tables, use the »Add» button for “Custom database
tables”. A window will open from which you can select which tables to add.
6. If you want to save this configuration setup, click »Save».
7. The configuration setup will be displayed below the »Standard Customer Configuration»
button.
8. Click »Generate» to create the configuration file.
9. The file will be made and the text “PRC generated, download” appears under the title.
10. To save the configuration file, click “download”. A window will open from which you can select
a location to save the file.
Session
Parameter/Field Description
Timeout Idle session time in seconds before the user is automatically logged out
of the Pricer Client.
Sound Set the sound to ON/OFF for Link and Unlink screens.
DefaultUserLanguage Default language for new users. Set to empty to use the default language.
DefaultLoginLanguage Default language on the login screen. Set to empty to use the default
language.
SupplementaryItemSearch A list of item properties that can be used as item identification codes in
the Pricer Client. The order in which the item properties are presented
determines the search order. ITEMID cannot be removed.
Link
Parameter/Field Description
LinkPressCompulsory Parameter values:
• TRUE: A click on the »Link» button (on the “Link ESL” webpage) or an
extra »Enter» is needed after a barcode is scanned.
• FALSE: The link is processed automatically after a barcode is
scanned.
59
Parameter/Field Description
BarcodeConfirmation The string (#LC) that, if made as a barcode, generates
an Enter key stroke and can be used as link
confirmation instead of clicking the »Link» button. This
feature is independent of whether
LinkPressCompulsory is true or false. The default
barcode used for this is:
TruncateLeadingZeros Parameter values:
• TRUE: Leading zeroes in an item code will be removed.
• FALSE: Leading zeroes in an item code will be kept.
PadWithLeadingZeros This parameter is used to pad the searched item code with leading
zeroes. The item code is padded with zeroes if its length is between
(inclusive) MIN-MAX e.g. 4-8, 0-13 or 13-18- The new length is fetched
from the second input field.
DisableItemValidation Disable all item validations in the link form. This also disables the
supplementary item search.
Locations Defines the location of an ESL during linking. The “Location” field for Link
PL must be visible to be able to choose a location during linking.
SupportLinkTitle Title text for the support link. A support link is
a function that allows having an external link
to a webpage that is displayed in the lower
left part of the Pricer Client.
“SupportLinkTitle” contains the title text that
will be linked to the destination set in
“SupportLinkUrl”. In the right image the
SupportLinkTitle parameter is set to “Pricer”.
SupportLinkUrl URL for the support link (see above),
e.g. value “//www.pricer.com”.
Search
Parameter/Field Description
BarcodeLinks A barcode can be used as a shortcut link, that when scanned will open a
specific webpage in the Pricer Client.
Barcode: Default shortcut link:
/WebInstoreUI/control/printOverlay
/WebInstoreUI/control/linkPL
/WebInstoreUI/control/unLinkPL
SearchRemove This parameter contains a list of numbers which will not generate a hit list
if searched for.
Other
Parameter/Field Description
ItemIdFilters Some product EAN codes like packed cheese or meat hold either the
price or the weight in the code. For example 2317109052900 where the
Parameter/Field Description
price is then 5290 (i.e. 52.90). This means that basically all packed
products will have unique EAN codes. But to find the correct product
(2317109000000) in the database the scanned EAN code needs to be
filtered.
Example:
n = any number
w = replace by different number to the right, in this case 0
W = recalculate the check digit if needed
Example:
Entering 28eeeeennnnnn will mean that if the EAN code starts with 28,
the next five digits should be used as item id when searching for this item
in the Pricer Client
LoginChangePasswordEnab Defines whether the “Change password” link shall be visible on the login
led page.
IteminfoPrintTarget Sets the destination for the »Print Overlay» button on the search result
page to either:
• SinglePrint (target = Single Print)
• NewOverlay (target = Batch Print)
PriceFormatting Parameter values:
• TRUE: Price formatting is done. (e.g. will 10.00 be written instead of
1000).
• FALSE: Price formatting is not done. (e.g. 1000 will be written
instead of 10.00).
The price fields affected by this parameter is defined by the system
parameter PRICE_FIELDS.
EnableShowViewDm Parameter values:
• TRUE: The user will not be able to create a Show View DM job in the
Pricer Client.
• FALSE: The user will not be able to create a Show View DM job.
SupportTitle In the Pricer Client, it is possible to create a special link that redirects the
user to another web page, for example a support link. This parameter
determines the name of the link, e.g. Support.
61
Parameter/Field Description
VALUE The digit value assigned to the global parameter. Currency rate
Procedure
To create a global parameter, follow these steps:
1. From the main menu, select Platform | System Configuration | Global Parameters.
2. Enter a suitable name in the “Key” field.
3. Enter a suitable value in the “Value” field.
4. Click »Save» to complete this procedure.
8.2.6 Infrastructure
This chapter explains how to work with infrastructure such as base stations, transceivers and
departments.
Select Platform | System Configuration | Infrastructure in the main menu to display the
“Infrastructure” landing page:
63
How to add a base station
Prerequisites
To perform this procedure, you need to know the address of the base station you want to add.
Procedure
To add a base station, follow these steps:
1. From the main menu, select Platform | System Administration | Infrastructure.
2. Click »Add Base Station».
3. Enter the new base station name consisting of two characters.
4. Enter the base station alias. An alias does not have to be given, however it may be used
to identify where a base station is located.
5. Enter the base station address:
• If the base station is connected to a network, specify its IP network name or IP
address.
• If the base station is connected directly to the COM port of the computer, specify the
COM port name.
6. Click »Save».
Parameter/Field Description
Department name Will be added automatically, based on the basestation name, when
creating a new Link Department.
Alias The alias can be used for giving the department a name other than the
department name, for example a name that easily identifies the location
of the department and its transceivers.
Back Office If this check box is ticked, this department is the back-office department.
A back-office department will transmit first in the system, unless
otherwise configured (can be configured when linking an ESL). There
must always be one back-office department in the system. When the first
department is created in the system, it will automatically turn into the
back-office department. But when you set another department to be the
new back-office department, the previously designated back-office
department will automatically turn into a normal department.
Prerequisites
A base station must be connected and booted.
A store drawing must be stored in the “\Pricer\R3Server\images” folder. To change the store
drawing, go to Platform | System Configuration | General Settings and the parameter
StoreDrawing.
Procedure
To add a link department, follow these steps:
1. From the main menu, select Platform | System Administration | Infrastructure.
2. Click »View Store Drawing». A new browser window will be shown displaying the store
drawing. By looking at the store map, make a plan of how to group your transceivers into
suitable department.
3. Close the store map.
4. Select the base station you want to work with, in the tabs.
5. Click »Add Link Department».
6. A new department will be added at the bottom of the list.
7. Add up to 12 transceivers to this department, by ticking the relevant check-boxes (a
department without transceivers cannot be saved).
65
8. If the new department should be a back-office department (there can only be one back-
office department) click the “Back Office” check box.
9. Click »Save» to complete this procedure.
When you delete a department, any ESLs allocated to it will automatically be transferred to the
back-office department.
Procedure
To delete a department, follow these steps:
1. From the main menu, select Platform | System Configuration| Infrastructure.
2. Select the base station you want to work with, in the tabs.
3. Find the department you want to delete in the list and click on the button to »Delete Link
Department».
A back-office department cannot be deleted (the »Delete Link Department» button is
inactive for the Back-office department). If you want to delete the department that is
currently the back-office department, you must first designate a new back-office
department: Choose the new back-office department and check its “Back Office” check
box.
Procedure
To manage the Transceiver Map,
follow these steps:
1. From the main menu,
select Platform | System
Configuration|
Infrastructure.
2. Select the transceiver that
should be positioned.
3. Add the height and rotation of the transceiver.
In order to get the correct rotation the map pointer must be aligned in the same direction
as the 7-digit LED on the transceiver.
4. Click »Save» when done.
5. In order to generate the product position data for each installed ESL the job Generate IR
Position data must be run.
67
Item configuration fields
Parameter/Field Description
Max Length The length of field in the database. Max length is 1024.
PFI Id A unique Pricer File Interface ID number
Price Field If box is checked: The information in this field will be included for each
item, when creating a price statistics report. When this box is checked the
price statistics counter will also be updated (+1).
Procedure
To add a field, follow these steps:
1. From the main menu, select Platform | System Configuration | Item Configuration.
2. Enter the name of the new field in the empty “Field Name” field (replace the default text
“NEW_PROPERTY”) at the bottom of the screen:
3. Enter the length in the “Max Length” field and a unique Pricer File Interface identification
number in the “PFI Id” field.
4. To add this item to the price statistics report, click the check-box in the “Price Field”
column.
5. Click »Add» to complete this procedure.
6. This new field will be added to the bottom of the list.
7. Click »Save» at the bottom of the screen, when all fields are added.
All fields that are not grey can be modified in terms of field length, kind, and PFI id (Pricer File
Interface ID number). Grey fields are used by the system and cannot be removed or modified.
Procedure
To modify a field, follow these steps:
1. From the main menu, select Platform | System Configuration | Item Configuration.
2. Make the required changes in the “Max Length” and “PFI Id” fields.
3. To add this item to the price statistics report, click the check-box in the “Price Field”
column.
4. If you want to delete a field, click the red “X” to the right of the “Price Field” column (if there
is no “x”, the field cannot be deleted).
5. Click »Save» at the bottom of the screen, when all modifications are ready.
Job types
69
Job type Description
job must be activated by the parameter “EnableRefreshDMScreen” which
is done in Platform | System Configuration | General Settings.
Show Info Page SmartTAG For SmartTAG HD labels (ESLs), it is possible to display an info page for
a specified period of time. For example information for the staff when the
store is closed. An ESL has a timer which can be set up to 18 hours. The
timer will make the ESL automatically go back to the price page when the
time is up. The system parameter “SHOW_VIEW_SMARTTAG_ENABLE”
must be set to “True” to enable the job in Platform | System
Configuration | System parameters. It will then be possible to select in
the list of jobs.
Show View DM For non-SmartTAG labels (ESLs), it is possible to display an info page for
a specified period of time. The job is a broadcast command, meaning that
it will be sent to all DM ESLs. The job must be set to “True” by the
parameter “EnableShowViewDm” which is done in Platform | System
Configuration | General Settings. If there are ESLs configured to show
multiple items, the job will not work.
Generate IR Position Data The job will generate IR position data and send it to the Pricer Cloud to
calculate the actual positions. When the calculation is done the new
position data is downloaded to the Pricer Server where the ESL property
GEO_LOCATION_IR is updated for all ESLs affected by this job. This job
should run once every day during nighttime and not at the same time as
any other job.
The job does not need to affect all ESLs, some filters can be applied:
• Generate data for Items
• Generate data for Item property
• Item property value
To be able to run this job the store must be cloud registered, Platform |
System Configuration | Cloud Configuration
Product Position Calibration The job will generate product position calibration data and send it to the
Pricer Cloud. The job will only affect new added positions and removed
positions. This job should run once every week during nighttime. This job
should not run at the same time as the Generate IR Position Data job.
To be able to run this job the store must be cloud registered, Platform |
System Configuration | Cloud Configuration
Generate Article Groups The job will generate Article Groups that has been configured under
Platform | Shopper Guidance | Article Groups. This job requires cloud
registration, Platform | System Configuration | Cloud Configuration,
and ESL positions. The ESL position don’t have to be of type IR, you can
also use Article Groups with MANUAL or BLE positions (so you don’t
really need to configure the Transceiver Map. The Transceiver Map is
only for IR positions).
Check Firmware Version The job will check that all installed ESLs uses the latest firmware version
that is available in the Pricer Server.
NOTE! The job will be created automatically (daily 02:00) upon new
installation or upgrade from previous version.
Upgrade ESL Firmware The job will perform a firmware upgrade on all installed ESLs. Firmware
upgrade takes time so the procedure will default upgrade 2000 labels per
night. This can be changed by the parameter “Override the Number of
Labels to Upgrade”. Enter a different upgrade number (i.e. 1000, 3000,
5000 etc.).
NOTE! The job will be created automatically (daily 03:00) upon new
installation or upgrade from previous version.
Procedure
To create a job, follow these steps:
1. From the main menu, select Platform |System Configuration | Job Configuration.
2. Click »Create New job». The “New Job” screen will be displayed.
3. Enter a suitable name for this job in the “Job Name” field.
4. Select the type of job from the “Type” drop-down list. For a description of the available
types of jobs, see list on the previous page.
5. Select start date and time, or check the box “Immediately” to start it right away.
6. Select how often you want the job to be performed in the “Frequency” drop down list.
7. If available (depending on the type of job chosen), specify the duration in the “Duration”
fields.
8. Choose other applicable parameters in the “Extra Parameters” drop-down list.
9. Click »Save» to complete this procedure.
8.2.9 Languages
Languages are used when translating the Pricer Client and the SmartAPP. The translation is
stored in the database but the translation is done in a properties file like webinstore_C.properties
(default language) and then imported into the database. The language file should be saved in
UTF-8 format.
71
How to import a language
Prerequisites
A translated language properties file.
Procedure
To import a language, follow these steps:
1. From the main menu, select Platform | System Configuration |Language.
2. Select the language to import from the dropdown list.
3. Select the language properties file.
4. Click on the “Import” button.
Procedure
1. From the main menu, select Platform | System Configuration |Language.
2. Select the language to export from the dropdown list.
3. Select either to export All properties or the only the non-translated properties.
4. Click on the “Export” button.
Prerequisites
An already imported language.
Procedure
1. From the main menu, select Platform | System Configuration |Language.
2. Select the language to delete from the dropdown list.
3. Click on the “Delete” button.
8.2.10 Licenses
To be able to run the Pricer Server a valid license key is required. An unlicensed Pricer Server will
still work but have limited functionality and performance.
The license key handling is done in the cloud License Server and is registered on the unique
store ID. It is also possible to use a chain license if a chain will use same features. The chain
license is restricted in usage.
Select Platform | System Configuration | Licenses in the main menu to display the “Licenses”
landing page:
A license key can only be generated from the Pricer license server. To be able to access the
license server internet access is required and a user account. Please contact Pricer to get a valid
license key.
Pre-requisites
You must have a valid license key to be able to install a license.
Procedure
To install a license key, follow these steps:
1. From the main menu, select Platform | System Configuration | License.
2. Click »Import License» and enter the new license key either manually (copy/paste) or
browse for the license key file, click »Install Key».
73
How to delete an installed license key
Pre-requisites
You must have a previously installed license key.
Procedure
To delete a license key, follow these steps:
1. From the main menu, select Platform | System Configuration | License.
2. Click on the X-button for the license key that should be deleted.
3. Confirm the deletion by answer »Delete» in the confirmation popup dialogue.
Pre-requisites
You must have a previously installed license key.
Procedure
To delete all license keys, follow these steps:
1. From the main menu, select Platform | System Configuration | License.
2. Click »Delete All».
3. Confirm the deletion by answer »Delete All» in the confirmation popup dialogue.
Pre-requisites
You must have a previously installed license key.
Procedure
To view an installed license keys, follow these steps:
1. From the main menu, select Platform | System Configuration | License.
2. Click on the license that should be viewed.
3. A new popup window will appear with the license key details.
Parameter/Field Description
Log level A drop-down list with 4 log levels:
• Error - only error events.
• Warning - warnings and error events.
• Info - information, warnings and error events.
• Debug - every single event.
Base Stations log level A drop-down list of the log levels for the base station log, with the same
content as the Log level down list).
Use split logging If you click this check-box, the information collected in the ServerLog will
be split up into the other logs. If this check-box is not checked, only the
ServerLog will be available for viewing.
Procedure
To change the log level, follow these steps:
1. From the main menu, select Platform | System Configuration | Log Settings.
2. Select the log level you want from the “Log level” drop-down list.
3. Select the log level you want for the base station log from the “Base Station Log Level”
drop-down list.
4. Click the “Use split logging” check-box to create the other logs or leave this unchecked to
only create the ServerLog.
5. Click:
• »Save» to change the log level for all logs (the changes made will immediately be
applied to all logs), or
• »Reset» to reset the log settings to the default values.
75
8.2.13 SmartAPP Configuration
For information on how to configure the Pricer SmartApp, see Pricer_SmartAPP.pdf.
Store information
With access code security is enabled each ESL gets a unique hashCode generated identifier
based on store ID, certificates and a hash algorithm. The unique identifier is generated when the
ESL is linked to an item. When the ESL is unlinked the access code is removed, a new unique
identifier is generated when the ESL is linked again.
The access codes can be generated locally in the Pricer Server (Local ESL Security) or using a
cloud based service (Remote ESL Security). The security solution differs when using local or cloud
generated access codes.
Procedure
To change ESL security level, follow these steps:
1. From the main menu, select Platform | System Configuration | Store Configuration.
2. Click on the Configure button and select the appropriate security level from the popup window.
77
Statistics enabled
Checkbox for checking the daily upload of Pricer Server statistics to the cloud statistics inbox
server. This function requires internet access.
Business Hours
Business Hours are used for checking that the SmartFlash only flashes during store opening
hours and not during the night. During the night, all ESLs with activated SmartFlash will stop
flashing and begin to flash again the next day when store opens. The Closed checkbox is used to
stop the usage of the SmartFlash for that specific day.
Backoffice
Parameter/Field Default Description/Parameter values
value
BACK_OFFICE_HISTORY 8 Number of days to keep back office history such as
PFI, Text Adapter and Click to Collect lists.
DEFAULT_RESULT_FILE_PATH \Pricer\PFIFil Specifies the path of the default result file if not
es\ResultFile specified otherwise in m1 files. This is also the path
s\ResultFile.r for error codes generated during PFI processing.
7 Error codes are produced if an error is found when
Parameter/Field Default Description/Parameter values
value
parsing a message file, or if the specified path of a
message file is not correct.
DROP_FOLDER_ACTIVE FALSE Parameter values:
• TRUE: Drop folder functionality is active.
• FALSE: Drop folder functionality is inactive.
DROP_FOLDER_LOCATION images\\drop Shows the drop folder default location. The location
is either relative to the R3Server folder or absolute.
DROP_FOLDER_SCAN_INTERVA 3 The interval in seconds between Pricer Server
L scans of the Drop folder for new images.
ITEM_MUST EXIST TRUE Parameter values:
• TRUE: It is not possible to link an item to an ESL
if the item is not present in the database.
• FALSE: It is possible to link an item to an ESL if
the item is not present in the database. The item
is automatically added to the database but with
NULL values on all item fields. So the display will
be blank on the ESL.
ITEM_PROPERTY_VALUE_DELIM | Delimiter in the PFI data file.
ITER
MESSAGE_FILE_PATH \Pricer\PFIFil Specifies the search path for the folder where
es\Message message files are generated.
Files
NAVIGATION_ATTENTION_LED_ 10 Maximum distance to consider for attention led
DISTANCE when using map navigation.
NAVIGATION_ATTENTION_LED_ 900 Flash duration for the attention led when using map
DURATION navigation.
79
Parameter/Field Default Description/Parameter values
value
• TRUE: The secondary item code is allowed to be
relinked to a different item.
• FALSE: The secondary item code cannot be
relinked to a different item.
For more information about SIC (Secondary Item
Codes), see the Pricer_Integration.pdf manual.
SIC_APPEND TRUE Parameter values:
• TRUE: The new secondary item code is added to
the current secondary item code.
• FALSE: The new secondary item code replaces
the current secondary item code.
For more information about SIC (Secondary Item
Codes), see the Pricer_Integration.pdf manual.
UNKNOWN_ITEM_IN_UPDATE Install Parameter values:
• Install: A non-existing item in update file will be
added to the database.
• Ignore: A non-existing item in update file will not
be added to the database and an error is
reported.
• Report Error: A non-existing item in update file
will not be added to the database and an error is
reported.
General
Parameter/Field Default Description/Parameter values
value
AD_AUTHENTICATION FALSE Parameter values:
• TRUE: Allows active directory authentication.
• FALSE: Does not allow active directory
authentication.
API_PORT_NEW_RMI 11098 Port number for new RMI.
API_PORT_PUBLIC_API_4_7 11096 Port number for Pricer Public API. Valid from R4.7
or later.
API_PORT_WEBSERVICES 11097 Port number for WebServices.
REMEMBER_ME_AUTHENTICATI TRUE Enables remember me checkbox on the login page.
ON
SERVER_DISCOVERY TRUE Parameter values:
• TRUE: Enables broadcast discovery of the Pricer
server.
• FALSE: Disables broadcast discovery of the
Pricer server.
UNLINKED_ROAMING_INITIAL_D 120 Defines the time in minutes how long the unlinked
ELAY_MINUTES without response roaming should sleep before doing
its first run.
UNLINKED_ROAMING_SLEEP_TI 0 Defines the time in days how long the unlinked
ME_DAYS without response roaming should sleep between
invocations.
USE_BUSY_BLINK FALSE For large labels, especially for those with red color
displays, the total update time is rather long. Busy-
Blink is a method to show that the label is updating
by using the SmartFlash to indicate.
Parameter values:
• TRUE: Enable Busy-Blink function.
Parameter/Field Default Description/Parameter values
value
• FALSE: Disable Busy-Blink function.
WEB_APPLICATION_PORT 3333 The http-port number for the Pricer Web Application
Server.
HTTP(S)_MODE HTTP_ONL This parameter decides which http mode to use:
Y • HTTP_ONLY: use http-port only (default).
• HTTP_AND_HTTPS: use both http- and https-
ports.
• HTTPS_ONLY: use https-port only, all traffic on
the http-port will be redirected to the https-port.
The http Webservice and RMI will be switched
off. Only the WebService_5_0 on the https-port
will work.
WEB_APPLICATION_HTTPS_PO 3336 The https-port number for the Pricer Web
RT Application Server.
JAVA_KEY_STORE_PATH The path to use a company signed domain https
certificate that is placed in Java Key Store (JKS).
JKS is a repository of security certificates used in
SSL encryption. The JKS must have the certificate,
certificate verification chain and the private key.
JAVA_KEY_STORE_CERTIFICAT Certificate alias/name.
E_ALIAS
JAVA_KEY_STORE_PASSWORD Certificate password.
Infrastructure
Parameter/Field Default Description/Parameter values
value
AUTO_BS_REBOOT TRUE Parameter values:
• TRUE: Allows a reboot of the BS automatically, in
case of recognized failure.
• FALSE: Does not allow a reboot of the BS
automatically, in case of recognized failure.
INFRA_TEST_FREQUENCY 30 Number of minutes between the statuses of the
infrastructure is checked by the system.
SINGLE_BASESTATION_ROAM FALSE Parameter values:
• TRUE: Roaming is only performed on one
Basestation in a system.
• FALSE: Roaming is performed on all
Basestations in a system.
TRX_THRESHOLD_MIN 10 Minimum threshold value for changing a TRX status
into an error state.
TRX_THRESHOLD_OK 20 Minimum threshold value for changing a TRX status
from an error state into an “OK” state.
VALID_TRX_TYPES_FOR_ 5032,5034,5 TRX types for which the threshold is included in the
THRESHOLD 039 TRX status.
Item
Parameter/Field Default Description/Parameter values
value
CLOUD_API_PROPERTIES PRICE Comma separated list of properties to submit to
Cloud API.
ITEM_CACHE_ACTIVE TRUE Parameter values:
• TRUE: Cache is active.
81
Parameter/Field Default Description/Parameter values
value
• FALSE: Cache is deactivated. If so, the
performance will be lower, especially on older
hardware.
ITEM_CACHE_SIZE_PERCENTAG 10% The percentage of server allocated memory that is
E used for item caching. It is not recommended to
change this value.
ITEM_DELAYED_THREAD_TIME 1 Specifies how often the Item delayed table is
scanned.
MERCHANDISING_PROPERTY <empty> Item property used for Task to Light.
Logs
Parameter/Field Default Description/Parameter values
value
LOGS_LIFE_TIME 5 Max number of days of history to be included in the
server logs.
PLFT
Parameter/Field Default Description/Parameter values
value
CALLIBRATION_ON_LINK_ TRUE Parameter values:
UNLINK • TRUE: Enables calibration of the transceivers,
after linking and unlinking. The calibration is only
done after the time specified in the
IR_CALIBRATION_INTERVAL system parameter
has passed.
• FALSE: recalibration is disabled, even if it is time
for it.
CALIBRATION_ON_REAL_TIME TRUE Parameter values:
• TRUE: Calibration is done if the department only
contains real-time-led transmission requests.
• FALSE: No calibration is done if the department
only contains real-time-led transmission requests,
even if it is required.
IR_CALIBRATION_INTERVAL 60 Interval in minutes between calibration of IR
department.
REPOSITORY_SIZE 10 All the frames collected for transmission are stored
in “Frame Repository”. REPOSITORY_SIZE is the
maximum number of frames that can be stored in
the repository in one instance of time. If the
REPOSITORY_SIZE is equal to the number of
frames in the repository, no new frames will be
added to it until at least one frame have been
removed. (Recommended: The value should not be
changed by the end-user).
UPDATE_SUCCESS 0 This parameter configures the responses that are
given to PL subsystem (irrespective of the response
being an ACK or a NACK) for any transmitted
request that are sent. When parameter is set to:
• 1: Even if a NACK is received, the response
propagated to PL subsystem will be an ACK.
• 0: The NACK responses will be propagated as
NACKs to PL subsystem.
Pricer label
Parameter/Field Default Description/Parameter values
value
ACK_REQUIRED_FOR_UNLINK TRUE Parameter values:
• TRUE: The frames will be sent one by one, and
the next frame will only be sent if an ACK is
received for the previous frame.
• FALSE: The frames are sent one after another
without waiting for responses. Use the FALSE
parameter to make it possible to unlink D1 ESLs
from a micro base station in back-office without a
transceiver.
ALLOW_MOVING_PL_DM TRUE Parameter values:
• TRUE: Allows a new link of a graphical ESL to be
made without first unlinking it.
• FALSE: Does not allow a new link of a graphical
ESL to be made without first unlinking it.
ALLOW_MOVING_PL_SEGMENT FALSE Parameter values:
• TRUE: Allows a new link of a segment based
ESL to be made without first unlinking it.
• FALSE: Does not allow a new link of a segment
based ESL to be made without first unlinking it.
DM_OFF_VIEW_IMAGE_LARGE Pricer_sp_b OFF page image for Large graphical displays.
w_60px_128 If <empty> no OFF image will be used.
l.bmp
DM_OFF_VIEW_IMAGE_MEDIUM Pricer_sp_b OFF page image for Medium graphical displays.
w_40px_128 If <empty> no OFF image will be used.
l.bmp
DM_OFF_VIEW_IMAGE_SMALL Pricer_sp_b OFF page image for Small graphical displays.
w_20px_93l. If <empty> no OFF image will be used.
bmp
DM_OFF_VIEW_TEXT Label is off Defines which test should be visible above the
image of DM ESLs.
ESL_HISTORY_EXECUTION_TIM 23:07 Time when the ESL History table is updated.
E
ESL_HISTORY_SCAN_INTERVAL 1 The time interval since the Price Change of the
statistics was updated in the database.
FA_FALSE_ACK_PERCENTAGE 5 If FA_FALSE_ACK_ACKS is TRUE, every frame
received has this % chance of getting an ACK
regardless of actual response.
FA_GENERATE_FALSE_ACKS FALSE Parameter values:
• TRUE: Every frame received has a
FA_FALSE_ACK_PERCENTAGE % chance of
getting an ACK regardless of actual response.
• FALSE: No response will be received.
FA_LEVEL_1 5 If the false ACK level is higher than or equal to this
number but lower than FA_LEVEL_2:
FA_LEVEL_1_EXTRAS false ACK adjustments will
be required of compatible PLFTRequests. This
value must be between 0 and 100 inclusive.
FA_LEVEL_1_EXTRAS 2 The number of required false ACK adjustments
required of compatible PLFTRequests. This value
must be equal to or greater than 0, and equal to or
greater than 1, to case a change in the
PLFTRequests transmission behavior.
FA_LEVEL_2 20 If the false ACK level is higher than or equal to this
number, FA_LEVEL_2_EXTRAS false ACK
adjustments will be required of compatible
83
Parameter/Field Default Description/Parameter values
value
PLFTRequests. This value must be between 0 and
100 inclusive.
FA_LEVEL_2_EXTRAS 4 The number of required false ACK adjustments of
compatible PLFTRequests. This value must be
equal to or greater than 0, to be accepted, and
equal to or greater than 1 to case a change in the
PLFTRequests transmission behavior.
FA_NOF_FALSE_ACK_FRAMES 400 Number of false ACK test frames sent for every
false ACK test. Approx. 50 frames can be sent
every second.
FA_PERFORM_FALSE_ACK_TES FALSE Parameter values:
T_EVERY_TRANSMISSION • TRUE: A false ACK test is performed before
every wakeup.
• FALSE: A false ACK test is not performed before
every wakeup.
KEYCODE_SWITCH OFF Parameter values:
• ON: KeyCode frame is sent while linking DM
ESLs.
• OFF: KeyCode frame is not sent while linking DM
ESLs.
MICRO_BS_TRANSMISSION_ON_ FALSE Parameter values:
LINK • TRUE: Possible to link a D1 based ESL using the
Micro Basestation.
• FALSE: Not possible to link a D1 based ESL
using the Micro Basestation.
PARTIAL_UPDATE TRUE Parameter values:
• TRUE: Enables partial updates of DM ESLs.
• FALSE: Disables partial updates of DM ESLs.
Should only be set to FALSE when running
performance tests.
REQUIRE_ACK_ON_FLASH FALSE Parameter values:
• TRUE: Acknowledge of SmartFlash activation is
required. If acknowledge fail a retransmission will
be done. This will make SmartFlash activation
time little longer, but more stable.
• FALSE: Acknowledge of SmartFlash activation is
not required. This will make SmartFlash
activation faster.
PRICE_CHANGE_STATISTIC_ TRUE Parameter values:
SWITCH • TRUE: Statistic data will be saved.
• FALSE: Statistic data will not be saved.
SHOW_VIEW_SMARTTAG_ENAB TRUE Parameter values:
LE • TRUE: The job “Show Info Page SmartTAG” is
enabled in Job Configuration page.
• FALSE: The job “Show Info Page SmartTAG” is
disabled in Job Configuration page.
STRONG_LED FALSE Parameter values:
• TRUE: Use strong SmartFlash when activated
through a Back Office change.
• FALSE: Use weak SmartFlash when activated
through a Back Office change.
TREAT_ALL_DM110_AS_OLD FALSE Parameter values:
Parameter/Field Default Description/Parameter values
value
• TRUE: Preloading, FlexCom or PP16 is not
supported for DM110 #13203. Only 2 pages are
available.
• FALSE: Preloading, FlexCom or PP16 is
supported for DM110 #13203.
DM110 with article no. #13203 where produced in
two variants with different SW and HW possibilities.
Changing this setting requires a Pricer Server
restart.
Proxy
Parameter/Field Default Description/Parameter values
value
PROXY_SERVER <empty> HTTP proxy hostname or IP address. Empty if proxy
is not used.
PROXY_SERVER_PASSWORD <empty> HTTP proxy password.
PROXY_SERVER_PORT 8080 HTTP proxy port.
PROXY_SERVER_USERNAME <empty> HTTP proxy username. Empty if not used.
Report
Parameter/Field Default Description/Parameter values
value
NO_OF_MNTHS_FOR_STAT_REP 3 Max number of months of history to be included in
ORT the Price change statistics report.
Status
Parameter/Field Default Description/Parameter values
value
NUMBER_OF_DAYS_FOR_RECE 7 Max number of days of history to be included in the
NT_ROAMING recent roaming statistics.
SHOW_OVERLAY_STATUS FALSE Parameter values:
• TRUE: Shows if there are changed overlays to
print.
• FALSE: Does not show if there are changed
overlays to print.
User Management
Parameter/Field Default Description/Parameter values
value
GROUP_SECURITY_CHANGE_PA FALSE Parameter values:
SSWORD_ON_FIRST_LOGIN • TRUE: Every new user must change her/his
password the first time the user logs on to the
GUI.
• FALSE: The password does not need to be
changed upon first logon.
GROUP_SECURITY_LOCK_OUT_ 10 The number of minutes a user is locked out after
TIME_MINUTES exceeding the allowed number of tries of using the
wrong password.
GROUP_SECURITY_MAX_FAIL_ 3 The maximum number of tries a user has to enter
COUNT the password before being locked out.
GROUP_SECURITY_MIN_TIME_ 0 Minimum number of days allowed before a user has
BETWEEN_PWD_CHANGE_DAYS to change his/her password.
85
How to change system parameter values
If you change the value of a parameter, the default value will be displayed as a reference in the
“Default Value If Changed” column.
Procedure
To change the value of a system parameter, follow these steps:
1. From the main menu, select Platform |Server Settings | System Parameters.
2. Make the desired changes in the list.
3. Click »Save» (at the bottom of the window) to complete this procedure.
8.2.16 Text Adapter
The Text Adapter is used for importing item data files into the Pricer Server. More information
about the Text Adapter can be found in the PricerIntegration.pdf manual.
Tab Description
Link Page Displays which fields and columns should be visible
on the link page
Item Search Item search result columns
ESL Search ESL search result columns
87
Tab Description
ESL Info Displays which columns that should be visible when
checking ESL information
Item Info Displays which columns that should be visible when
checking item information
Print Batches Displays which fields and columns should be visible
on the print batches page
Poster Item Displays which item columns that should be visible
for the SmartPoster
8.3 XML-file Configuration
Under \Pricer\R3Server\config there are some XML-files that can be configured.
8.3.1 DatabaseConfiguration.xml
89
8.3.2 MailInfo.xml
The MailInfo.xml file is used when setting up an mail account to send reports by mail under
Platform | System Configuration | Job Configuration
XML-tag Description
SMTPHost Mail server name, ex. mail.company.com
SMTPPort Mail server port, default 25
userName User name of sender, ex. [email protected]
password Password for user account, ex. 1qaz-2wsx
authenticate true/false (default)
from Mail address from sender, ex. [email protected]
to Mail address to receiver, ex. [email protected]
debug Debug log settings true (default)/false
subject Mail heading, ex. “Support mail from Store 1”
message Mail message, ex. “This is an automatic report mail from Store 1”
If the mail cannot be send it can be related to an invalid SSL certificate. The certificate could have
expired or it is a non-approved certificate from the Certificate Authority (CA).
There is a workaround to add the mail certificate to Java Key Store (JKS) which is a repository of
security certificates used in SSL encryption.
Procedure
To add the mail certificate to Java Key Store, follow these steps:
1. Export the Mail Server public certificate (ex. name_of_certificate.crt) and put it to ex.
C:\temp