Pricer System Manual

Download as pdf or txt
Download as pdf or txt
You are on page 1of 90

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.

Pricer System Manual


R5.5.0 English, 2018-04-09
Copyright © 2018 Pricer AB. All rights reserved.

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

2 Price Automation .................................................................................. 20


2.1 ESL Management ..............................................................................................20
2.1.1 Link ESL....................................................................................................20
2.1.2 Unlink ESL ................................................................................................21
2.1.3 Link Item Batch .........................................................................................22
2.1.4 Reports .....................................................................................................23
2.1.5 Manage IR Key .........................................................................................25
2.1.6 ESL Configuration.....................................................................................26
2.1.7 Advanced Search .....................................................................................26
2.2 Print ....................................................................................................................27
2.2.1 Batch Print ................................................................................................27
2.2.2 Single Print ...............................................................................................28
2.2.3 Batch Reprint ............................................................................................29
2.2.4 Print Configuration ....................................................................................31
2.3 SmartPoster .......................................................................................................33
2.3.1 SmartPoster ..............................................................................................33
2.3.2 SmartPoster Designer ..............................................................................33

3 Click & Collect....................................................................................... 34


3.1 Click & Collect ...................................................................................................34
3.2 Geo configuration .............................................................................................35

4 Task Management ................................................................................ 36


4.1 Task Management .............................................................................................36
4.2 Geo configuration .............................................................................................37

5 Shopper Guidance ................................................................................ 38


5.1 Cloud Configuration .........................................................................................38
5.2 Article Groups ...................................................................................................38

6 Product Finder ...................................................................................... 40


6.1 Cloud Configuration .........................................................................................40
6.2 Article Groups ...................................................................................................40

7 NFC Product Information..................................................................... 41


7.1 Cloud Configuration .........................................................................................41

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.1 General information


This document is the user manual for the current version of the Pricer System software. It contains
information about all the menus in the Pricer Client and explains how to work with them. It also
explains how to install the software.
This manual contains information for the system administrators, configurators and end users.
You can find topics in this manual in three ways:
• Use the table of contents on the previous page to find the menu you are interested in.
• Use the search function and a relevant key word.

1.2 Software installation


This chapter describes how to prepare and perform an installation of the Pricer System.
• 1.2.1 Prerequisites
• 1.2.2 How to change web browser caching
• 1.2.3 Components in the Pricer System
• 1.2.4 Installing the Pricer System
• 1.2.5 Miscellaneous configuration
• 1.2.6 Launching the Pricer System
• 1.2.7 Installing a customer configuration file
• 1.3 Logging in to the Pricer Client

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.

1.2.2 How to change web browser caching


To make sure that the latest information is displayed on the Pricer Client pages, we recommend
that the web browser page cache setting is changed so that the page is renewed every time it is
visited.

Procedure for MS Internet Explorer


To change the web-browser page cache settings, follow these steps:
1. In MS Internet Explorer, go to Tools |
Internet options | General | Browsing
history | Settings dialogue.
2. Click the radio-button for “Every time I visit
the webpage”
3. Click »OK» to complete this procedure.

1.2.3 Components in the Pricer System


The Pricer System installation utility installs the Pricer Server and the Pricer Client user interface.
During the installation of the Pricer System the following third party software programs are also
installed:
NOTE! Please check Release Notes for your version to find the software program versions.
• Java (32 bit)
The Pricer Server requires that the Java JRE package is installed on the computer:
The Java JRE package is included in the Pricer Server installation file. During installation, you
will be asked if you want to use your current Java installation or install our included Java
package. We recommend that you install our included Java JRE package.
Another option is to install Java separately. If you choose to do this, you must quit the Pricer
installation, install Java JRE, and then restart the Pricer installation. Only Java JRE is required
and it can be downloaded from Oracle at http://www.java.com. Download and install the Java
JRE installation package to anywhere on the local computer by following the on-screen
instructions. Remember where you installed it as this information will be needed in the Pricer
System setup.
• MySQL database
• Jetty web server (used for the Pricer Client user interface)

1.2.4 Installing the Pricer System


If all the prerequisites are fulfilled and nothing unexpected occurs, the installation should not take
longer than 5 minutes.

How to install the Pricer System

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.

When the Welcome screen is displayed, Click


»Next» to continue.

2. Carefully read the license agreement.

Select the option, “I accept the terms of this


license agreement” and click »Next».

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.

Click »Next» to continue.


6. Use the default Base Station Name.
7. Enter a Base Station address in the “C port or
IP” field.
8. NOTE: If an Ethernet Base Station is used
then the base station address should contain
the IP address e.g. 192.168.10.1.
9. Click »Next» to continue.
10. Enter a store name and click »Next» to
continue.

11. Enter MySQL user and password. Use default


values pricer if nothing needs to be changed.
12. Click »Next» to continue.

13. Browse the location of the PRC configuration


file (for more information, see chapter 5.8
Config export). If you do not have a
configuration file, leave the field blank.
14. Click »Next» to start the Pricer Server
installation.

15. The Pricer Server installation will continue


showing a couple of screens displaying
progress.
16. When finished, click »Next» to continue the
final part of the Pricer Server installation.

9
17. Step 1/10 will now start where PRC-file is
installed, services etc.
18. Step 10/10, click »Next» to continue.

19. Select whether you want to create shortcuts in


the Start menu and on the desktop.
20. Select which program group the shortcuts
should belong to.
21. If you want to accept the default group
“Pricer” (recommended) click »Next» to
continue.

22. The installation is now finished, and if


selected the Pricer program icon will be
created and placed on your desktop and in
the Start menu.
23. To create an automatic installation file that
can be used to install the Pricer software with
exactly the same settings on other computers,
click »Generate an automatic installation
script».
You will be asked for a name and the file will
then be created in the folder where the Pricer
System was installed.
24. Complete the installation by clicking »Done».

How to perform an automatic installation

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.

1.2.5 Miscellaneous configuration

How to change the Pricer Server access rights

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».

4. Click the »Log On» tab and select »This


Account».
5. Enter the name and password of a user with
network access rights.
6. Complete the procedure by clicking »OK».

How to change Windows 7 shortcut 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”.

Right-click on “Start Pricer Services” and


select “Properties”.

2. Select the “Shortcut” tab and click


»Advanced».

3. Check the check-box “Run as


administrator”.
4. Complete the procedure by clicking »OK».
5. Repeat the procedure from step 1 for the
shortcut “Stop Pricer Services”.
How to turn on sound for Link and Unlink

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.

How to manually start or stop the Pricer Server

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”.

1.2.7 Installing a customer configuration file


The configuration installer tool is used for installing a customer configuration file (PRC file) in an
existing Pricer Server installation.

How to install a configuration file

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>

1.3 Logging in to the Pricer Client

1.3.1 How to login to the Pricer Client


The Pricer Client launches a browser which requires you to login.

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 The toolbar at the top of the screen


The toolbar at the top of the screen contains quick access buttons to the functions Status, Batch Print,
Link and Unlink.

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.

1.5.1 How to perform a quick search


The quick search field can be accessed and used at any time, when working with the Pricer System.
The result of the search depends on the format of the entered value and of the matches found:

If the search string is less than 17 characters:


• An exact match of the item ID will be searched for.
• If no results are found, a search for supplementary search values will be performed.

If the search string is more than 17 characters:


• An exact match for the ESL barcode will be searched for.
• If no results are found, a search for an item ID with more than 17 characters will be done.
• If no results are found, a search for supplementary search values will be done.

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.

1.5.2 How to perform an advanced search


The Search window for advanced searches has a single field. The name of this field reflects which radio
button has been selected. There is a drop-down list connected to this field where you can select the type
of search criteria to use for items or ESLs.

Procedure

To perform a detailed search for an item, follow these steps:


1. Click on »Advanced search»
2. Click »Item» or »ESL».
3. Open the drop down menu and select which type of search criteria you want to use:
Item Description ESL Description
Item ID Search for an item using ESL barcode Search for a specific ESL barcode
Item ID
Item Name Search for an item using ESL model Search for ESLs linked to a
Item name specific model
Items linked to ESL Search for an item ESL in roaming Search for all ESLs that are
model connected to a specific currently in roaming
model
Items linked to ESL Search all items that are ESL in slow roaming Search for all ESLs that have not
linked to an ESL answered for more than three
days
View all items View all items in the ESL with low battery Search for all ESLs that have
system reported low battery. This requires
that the job “Check ESL Battery”
has been run.
Item IPF Search for all items in ESL unlinked Search for all ESLs that have
the system that have a without response been unlinked from the system but
specific IPF have not answered

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.

5. To search for your chosen criteria:


• use a barcode scanner, or
• enter the search string using a keyboard, and then press »Search»
The results of your search will be displayed.
6. To see detailed information about any of the items/ESLs found, click the appropriate link in the
“Item ID”/”ESL Barcode” column.

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.

Type of alert Information


Infrastructure If something in the infrastructure is not working properly. This alert will always show for a few
seconds at the startup of the Pricer server, while the server is trying to connect the
infrastructure.
Security Shows if a security error has been found
ESL failed Shows if an ELS or SmartPoster is in failed state
Roaming level This alert is based on the roaming levels that have not been found during the last 7 days
Warning: when the roaming level is more than 2 percent
Error: when the roaming level is above 5 percent
SmartPoster Shows when a new poster is discovered by the system
License Shows when the license is not configured, or when something is wrong with the license
ESL low Shows when the system finds ESLs with low battery
battery
Stickers Shows when the system finds new items that need new overlays printed
Statistics Shows when the system fails to create or send the statistics
Store Shows when the system tries to keep the SmartFlash alive on ESLs that has SmartFlash
Configuration configured and store business hours has not been configured
Lab Install Shows when the installed system is a LAB release

1.7 Information pane


The Information pane at the bottom left of the Pricer screen shows the store name and user ID of the
person logged in.

Click »LOGOUT» to log out of the Pricer system.

19
2 Price Automation

This chapter describes how to work with “ESL Management”, “Print” and “SmartPoster” in the
Pricer Client.

2.1 ESL Management

2.1.1 Link ESL


This section describes how to link an ESL to an item. For instructions on how to link ESLs using
the SmartAPP, see the SmartAPP Link/Unlink QuickGuide.
Select Price Automation | ESL Management | Link ESL from the main menu to display the “Link
ESL” landing page:

Link ESL fields


The Link ESL screen has the following fields:
Parameter/Field Description
ESL Barcode The code that identifies the ESL in the Pricer System.
Model The model determines which layout script will be used for the ESL display.
Position Select link position if multi-item template is used.
Item ID The code that identifies the item in the Pricer System. This field may also refer to
other identification fields if that has been configured in Web Settings | General
Settings | Supplementary search.
Department Select the department where the link should be done.
Access Code Set unique access code (optional field).

How to link an ESL

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.

How to perform a forced update of an ESL

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).

2.1.2 Unlink ESL


Removing the link between an ESL and an item frees the ESL, and it can now be used with other
items.
For instructions on how to link ESLs using the SmartAPP, see the SmartAPP Link/Unlink
QuickGuide.
Select Price Automation | ESL Management | Unlink ESL from the main menu to display the
“Unlink ESL” landing page:

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.

How to unlink an ESL

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.

2.1.3 Link Item Batch


This chapter explains linking of batches of items and how to work with that.
Graphical labels that do not require paper overlays can be linked in batches. This is done by
importing a text file with a list of item IDs, formatted with one item ID per row.
After import, the required number of graphical labels are scanned and linked to the items in the list.
Supplementary search is supported, which means that other item identifications than item ID may
be used.
Select Price Automation | ESL Management | Link Item Batch from the main menu to display
the “Link Item Batch” landing page:
Link Item Batch fields

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.

How to view a report

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.

How to change default report format

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>

The available formats for JasperReports are:


• pdf (supported by Pricer)
• csv
• xml

3. Save the file and restart Pricer Server.

2.1.5 Manage IR Key


This chapter explains how to start using the IR key in your system.
The Fast Access IR keys are handled as ESLs, in other words, they can be linked and unlinked in
the store. During linking, the IR key is programmed according to the system configuration to get
the correct commands for each of the 16 buttons on the IR key. More information about IR-key
configuration can be found in the Pricer_ESLConfigurationClient.pdf document.
Select Price Automation | ESL Management | Manage IR Key on the main menu to display the
“Manage IR Key” landing page:

Manage IR key fields


Parameter/Field Description
Barcode The barcode of the IR key to be worked on.
Department A drop-down list of all the available departments.

How to link an IR key

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”.

How to remove 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.

How to update an IR key

When the buttons have been configured according to “Pricer_ESLConfigurationClient.pdf”, the IR


key needs to be updated (again).

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.

How to import an Item Batch

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.

2.1.6 ESL Configuration


ESL Configuration is a separate program, in which the label layouts and IR-key configuration are
made. More information about ESL Configuration can be found in
Pricer_ESLConfigurationClient.pdf.

2.1.7 Advanced Search


For information about Advanced Search, see 1.5.2.
2.2 Print

2.2.1 Batch Print


This chapter describes how to use the Batch Print function for printing and managing batches of
overlays. Overlays are the labels that are affixed to Pricer ESLs. There are three menus related to
batch printing.
Select Price Automation | Print | Batch Print from the main menu to display the “Batch Print”
landing page:

Batch Print fields

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.

How to print new overlays

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.

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.

2.2.2 Single Print


This section describes how to use the “Single Print” function. Overlays printed using this function
are not saved or stored in the system.
Select Price Automation | Print | Single print from the main menu to display the “Single Print”
landing page.

Single Print fields


Parameter/Field Description
Model The model specifies the overlay size and information layout.
Parameter/Field Description
Item/ESL The item ID or the ESL code that identifies the item or ESL in the Pricer
System.

How to print a single overlay

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.

2.2.3 Batch Reprint


This function is used when printing overlay batches. Batches can be created either under the
menu Price Automation | Print | Batch Print, or automatically when item data included on an
overlay is changed.
Select Price Automation | Print | Batch Reprint from the main menu to display the “Batch
Reprint” landing page:

Batch Reprint fields


Parameter/Field Description
Number of Batches The total number of batches shown in the list below.
BATCH NAME A unique name given to a batch of overlays.
STATUS Status of if the batch is new or previously printed.

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.

How to reprint a saved batch print job

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».

How to import an item ID file to create a new batch print file

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.

2.2.4 Print Configuration


This chapter explains how to configure your printers and select default setting for how to print.
Select Price Automation | Print | Print Configuration in the main menu to display the “Print
Configuration” landing page:

Print settings fields


Parameter/Field Description
Enable manual printer If the checkbox is checked, the user is allowed to select which printer to
selection use when printing an overlay.
Print batch name format A 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).
Changed overlays This function automatically creates a print batch job whenever any
information related to the overlay for that item has been changed. This is
highlighted in the Alerts pane if the “Stickers” alert is shown

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.

How to configure a printer

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.

How to configure a Client printer

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. Enter the Client name in the “Client” field.


3. Select the department from the “Link Department” drop-down list.
4. Click »Add model».
5. Select the ESL model from the “Model” drop-down list and the IP address or hostname
from the “Printer” drop-down list.
6. To add more Client printers, repeat this procedure from Step 2.
7. Click »Save» at the bottom of the screen

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.

2.3.2 SmartPoster Designer


Displays the list of created templates for the SmartPosters and where to access the template
designer.

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.

3.1 Click & Collect


For information about how to use the Click & Collect functionality in the Pricer SmartAPP, see the
Pricer Click & Collect QuickGuide and the Pricer_Integration.pdf manual.
Parameter Description
Order number Order number
Number of items Number of items in the order
Pick up Time when the order should be collected by the customer
Created Time when the order was created
Status Status of task:
• New – new task
• In Progress – task in progress
• Completed – task completed
Picking time The amount of time it took to pick the order

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.

3.2 Geo configuration


For more information, check the Pricer_SmartAPP_GeoConfig_Guide.pdf.

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.

4.1 Task Management


To be able to create a “Task to Light” list, a merchandising property (i.e. an Item Property) needs
to be selected, this is done under Platform | System Configuration | System Parameters and
the parameter MERCHANDISING_PROPERTY.
When this merchandising property is updated with a new value for a product the “Merchandising
Change Detected” will increase one step. The information in the merchandising property for that
product should be the actual task to perform, like “Add Promo shelf talker”, “Remove shelf talker”,
“Check Planogram” etc. .
Parameter/Field Description
New List
List Name Name of the “Task to Light” list.
Generation Type • Changes Detected – generate a list of products where the
merchandising property has been changed.
• Random Samples – generate a random list of products that should be
checked based on value in the merchandising property.
Maximum Items Maximum number of items in list.
Equal Property Extra filter to check the value of an Item Property.
Equal Value Value to check the actual Item Property value.
Unequal Property Extra filter to check the value of an Item Property.
Equal Property Value to check the actual Item Property value.
Link Filter • Linked with Geo Position – check products that are linked with geo
position.
• Linked – check products that are linked.
• Linked and Unlinked – check all products regardless linked or not.
Merchandising
Merchandising Property Item property that will trigger a new task.
Merchandising Changes Displays how many item property changes that have been detected.
Detected
Task to Light
ID Auto generated ID for the list
Name Name of list
Created Creating date and time
Number of items Number of products to check
Status Status of task:
• New – new task
• In Progress – task in progress
• Completed – task completed
Done Percentage of performed task

4.2 Geo configuration


For more information, check the Pricer_SmartAPP_GeoConfig_Guide.pdf.

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.

Example of Shopper Guidance:

5.1 Cloud Configuration


For more information, see 8.2.1 Cloud Configuration.

5.2 Article Groups


Article Groups is a function to displaying product groups on the GeoPosition map that have same
type of information, for example item group. So for example all items that have item group ‘1’ will
be merged into same group.
How to generate an Article Group

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.

5. Click »Show Group» to display the article group on the map.

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.

Example of Product Finder:

6.1 Cloud Configuration


For more information, see 8.2.1 Cloud Configuration.

6.2 Article Groups


For more information, see 5.2 Article Groups.
7 NFC Product Information

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.

7.1 Cloud Configuration


For more information, see 8.2.1 Cloud Configuration.

41
8 Platform

8.1 System Administration

8.1.1 Advanced
Select Platform | System Administration | Advanced in the main menu to display the
“Advanced” landing page:

How to export ESL data

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.

How to change the ESL key code

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.

How to recalibrate all departments

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».

How to generate transmission diagnostics

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:

How to manually make a backup

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.

Advanced Status fields


Parameter/Field Description
PFI
Datafile Progress Progress of the data file processing.
Resultfile Progress Progress of the result file processing.

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.

System Status fields


Transmission graph
The transmission graph shows the current transmissions requests in 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

Detailed ESL Status


Price The number of queued requests that is related to a price page.
Info The number of queued requests that is related to an info page.
Off The number of queued requests that is related to an off page.
Preload The number of queued requests that is related to a preload page.
Other The number of queued requests that is not related to a view, for example battery
check.
Broadcast The number of queued requests that is related to broadcast.
Roam Request The number of queued requests that is related to roaming.

Transmission status
See Advanced Status

8.1.4 User Management

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.

How to add a new user

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

4. Click »Create» to complete this procedure.

Manage User Settings

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:

How to create a new group

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:

3. Enter all necessary data for the group:


Parameter Description
Group Name Enter preferred group name
Permissions Select permissions the group should have access to
Users Select which local users that should belong to the group
Domain Groups Select which domain groups should be connected to this group, only
when AD is used.

4. Click »Create» to complete this procedure.

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:

3. Enter all necessary data for the LDAP configuration:


Parameter Description
Domain Enter domain name; ex. pricer.com
Server Url Enter server Url IP; ex. ldap://192.168.1.2
User Prefix Enter user prefix; ex. ou=Accounts,dc=pricer,dc=com
Enter the distinguished name for the node that holds all user accounts
Group Prefix Enter group prefix; ex. ou=Groups,dc=pricer,dc=com
Enter the distinguished name for the node that holds all user groups.
BindDn Enter BindDn; ex. CN=Peter Smith,OU=Stockholm,
OU=InternalUsers,OU=Accounts,DC=pricer,DC=com
Enter the distinguished name for the user that will be used to look up in
the AD server. When an LDAP session is created, that is, when an LDAP
client connects to the server, the authentication state of the session is set

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

Distinguished names list


String Attribute type
DC domainComponent
CN commonName
OU organizationalUnitName
O organizationName
STREET streetAddress
L localityName
ST stateOrProvinceName
C countryName
UID userid

4. Click »Test Connection» to verify the domain connection.

5. Click »Create» to complete this procedure.


This require a Pricer Server restart to take effect.
How to administrate LDAP login

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.

5. Click »Save» to finish.


6. Try to login using domain user.

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).

How to view log files

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

8.2.1 Cloud Configuration


The Customer Access Server (CAS) is a cloud based server used for configure NFC and in-store
mapping. For more information, see the Pricer_Cloud_Solutions.pdf manual.

8.2.2 Configuration export


This chapter explains how to create a configuration file. For more information about how to use the
configuration file during an installation, see chapter 1.4.1. Select Platform | System
Administration | Configuration export in the main menu to display the “Configuration export”
landing page:

How to generate a configuration file

A standard customer configuration includes ESL and 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.

8.2.3 General Settings


The General Settings consists of different parameters to control the Pricer Client functionality.

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

Navigates to the Print page.

/WebInstoreUI/control/linkPL

Navigates to the “Link ESL” page.

/WebInstoreUI/control/unLinkPL

Navigates to the “Unlink ESL” page.

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

It is possible to extract parts of an EAN code to be used when searching


for an item in the Pricer Client.

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

e = real Item ID in system.

StoreDrawing Define the store drawing name which should be located in


C:\Pricer\R3Server\images folder.
CustomerLogo The Pricer logotype in the top left corner can be replaced
by another logotype. To do this, the logotype file must be
saved in:
[Install path]\Pricer\R3Server\Images, and the file name
must be written in this field.

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

SupportText The web page redirect URL, e.g. www.pricer.com.


EnableRefreshDMScreen Parameter values:
• TRUE: Enable the “Refresh DM Screen” (this job does not support
the function “Timed Updates”). See Chapter 3.4 Jobs
• FALSE: Disable the Refresh DM Screen job.

8.2.4 Geo Configuration


To work with an indoor positioning system, a store map is needed to position the products and the
shoppers. For more information, check the Pricer_SmartAPP_GeoConfig_Guide.pdf.
8.2.5 Global Parameters
Global parameters can be used as a way to easy set/change a specific value that will be used on
all configured ESLs, for example to apply changes in currency.
Select Platform | Server Settings | Global Parameters in the main menu to display the “Global
Parameters” landing page:

Global parameters fields

Parameter/Field Description Example

KEY The name of the global parameter. “Price in Euro”

VALUE The digit value assigned to the global parameter. Currency rate

Save Save settings.

Refresh Labels Transmits the changes to the ESLs.

How to create a global parameter

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».

How to create a department and add transceivers to it

A department is a group of transceivers (max 12 transceivers/department) connected to the same


base station. A group of transceivers in one department will cover one area in the store. All
transceivers belonging to the same department transmit simultaneously. A transceiver is not active
until it has been allocated to a department.
When connecting a nano-transceiver or a Base Station E3, a department is automatically created.
For all other base stations, their departments must be added manually.
Link Department fields

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.

How to delete a department

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.

How to manage the Transceiver Map

The Transceiver Map is used with


the GeoPosition store map to mark
where each transceiver is located in
the store. This allows the usage of
the IR-trilateration function where
each installed label is automatically
positioned in the store.

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.

8.2.7 Item Configuration


The Item Configuration menu is used for configuring field properties that can be set on different
items.
Select Platform | System Configuration | Item Configuration in the main menu to display the
“Item Configuration” landing page.

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).

How to add field properties

It is possible to add fields to the properties list.

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.

How to modify or delete field properties

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.

8.2.8 Job Configuration


By creating a job, it is possible to automatically run processes with set intervals or a set number of
times, for example a job can run a daily backup.
Select Platform | System Configuration | Job Configuration in the main menu to display the
“Job Configuration” landing page:

Job types

The following types of jobs exist in the Pricer System:


Job type Description
Backup Data Creates a backup of the installation and saves it in the location specified
in “DatabaseConfiguration.xml”. The recommended frequency is once a
day. The data to be included in a backup can be configured in Platform |
System Administration | Backup and then selected when the backup
job is created.
Show Info Page Shows a specific information page on all ESLs for a period of time. This
job is a broadcast command, meaning that it will be sent to all ESLs.
Generate Report Generates a report; either directly on a printer, or by e-mails, or saves it to
disk.
Note! If a network printer should be used, the PricerServer service needs
to log on an account with access to the network printers.
Check ESL Battery Checks the battery status of the ESLs linked to the system. The
recommended frequency is once a month with normal system usage.
Disable Transceivers Disable specific transceivers for a certain time.
ESL Audit Checks that each label is placed in the expected department. If the label
is not found in the place it was last communicated with, it will be given the
status “roaming”.
ESL Audit Classic Checks the status of all labels.
Purge Data This job type has two modes. It either deletes print batch information and
print overlay requests from the system, or it purges the alert event list.
The age of the data to be deleted is specified in the file
“DatabaseConfiguration.xml”.
Create PFI Items/Links Creates PFI files containing all the link and item information available in
the system.
Refresh All Linked ESLs Recalculates the display content for all linked ESLs and sends out an
update if required.
Refresh DM Screen Schedules a time when all DM ESL screens should be refreshed. This job
is a broadcast command, meaning that it will be sent to all DM ESLs. The

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.

How to create a job

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.

How to export a language

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.

How to delete a language

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:

How to get a new license key

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.

How to install license keys in the system

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.

How to delete all installed license keys

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.

How to view an installed license key

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.

8.2.11 Log Settings


Select Platform | System Configuration | Log Settings in the main menu to display the “Log
Settings” landing page:
Log settings fields

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.

How to change the log level

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.

8.2.12 Print Configuration


For more information, see 2.2.4.

75
8.2.13 SmartAPP Configuration
For information on how to configure the Pricer SmartApp, see Pricer_SmartAPP.pdf.

8.2.14 Store Configuration


Store configuration is used for Customer Access Server (CAS) cloud registration, server statistics
collection and SmartFlash operation

Store information

The following data can be entered:


Parameter Description
Store ID The unique store ID that is auto generated during the installation. This is the ID
that is used when register the store and generating the store license.
Store name Name of the store that is given during the installation.
Store chain The store chain that the store belongs to.
Address 1-3 Address to the store.
Zip Code Zip code to the store.
Parameter Description
City City where the store is located.
Country Country where the store is located.

ESL Security Level

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.

Local ESL Security


Local access codes can be used when there is no Internet access. It will require a registration key
provided by Pricer. After providing the registration key, the access codes are handled locally on
the Pricer Server computer. Using local access codes does not allow transfer of ESLs between
stores.
If all access code information in a store is lost the registration key needs to be provided by Pricer
again.

Remote ESL Security


Cloud based access codes are generated on a remote server that is available on the internet. The
access code for an ESL is generated on the remote server and is transferred to the Pricer Server
encrypted. The Pricer Server decrypts the access code and stores it in the local Pricer Server.
If all access code information in a store is lost, in can be retrieved from the cloud server by
unlocking all labels with the associated store ID. Then the labels can be linked again and the store
server will contact the remote server and get the current keys.

How to change ESL security level

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.

8.2.15 System Parameters


For all system parameters in this window, there are descriptive texts for each field. The descriptive
texts are shown when hovering the mouse pointer over the “Value” field. These descriptions are
also given in the “System parameters and default values” table below.
Select Platform | System Configuration | System Parameters in the main menu to display the
“System Parameters” landing page:

System parameters and default values

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.

NAVIGATION_ATTENTION_LED_I 20 Number of items to consider for attention led when


TEMS using map navigation.

NAVIGATION_FORCE_FLASH_DI 5 Distance from user to be included in force flash.


STANCE
NAVIGATION_TRIGGER_NEW_R 8 Distance walked away before a new route is
OUTE_DISTANCE calculated.
PFI_DELETE_DATA_FILE FALSE Parameter values:
• TRUE: Data file will be deleted after process.
• FALSE: Data file will not be deleted after
process.
PFI_ENCODING_TYPE UTF-8 This parameter defines the encoding type to use
while reading and writing and PFI files. The possible
values are ISO8859-1, UTF-8, CP850 etc.
REJECT_UPDATE_ON_UNLINKE FALSE Parameter values:
D • TRUE: Items that are not linked to an ESL will not
be added to the database.
• FALSE: Items that are not linked to an ESL will
be added to the database.
ROUTE_PLANNING_DURATION 180 Route planning duration in seconds. The route
planning is executed when the Geo Configuration is
published.
ROUTE_PLANNING_EXIT_UNIMP 30 Stop the route planning if the route is unimproved
ROVED_DURATION for X seconds. If this value is set to 0, it will always
run the full ROUTE_PLANNING_DURATION.
SIC_ALLOW_MOVING_SIC FALSE Parameter values:

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.

8.2.17 Web Page Configuration


The web page configuration is used for adding or removing fields and columns from specific pages
in the Pricer Client.

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

XML-tag Description Default value


DatabaseProvider Database provider name MySQL
DatabaseAddress Hostname of the computer where the //localhost
database server is running.
Database Name of the database which is used for the PRICER
Pricer Server application.
User Name of the database user root
Password Password to the database user <blank>
Driver Parameter to connect the database to the com.mysql.jdbc.Driver
Pricer Server application.
Url Parameter for the <Driver> to connect to the jdbc:mysql:
Pricer Server application.
Port Port for the database 7799
MaxConnections Parameter that specifies the number of 50
connections in the connection pool
EncodingType Parameter that defines the encoding type to UTF-8
be used while opening connection to the
database. ISO8859-1, UTF-8, CP850 etc.
NumRetryConnLost Number of connection retries before the 20
Pricer Server fails.
ConnectionTimeout Specifies the time in seconds for the 40
connection timeout.
DatabaseBackupFullFilePath Path where the Full Database- and PFI- \Pricer\DatabaseBackup\
backups are stored when an automatic databasebackup.bak
backup Job is performed.
Mysqlbinpath Path where MySQL is installed. \Pricer\mysql\bin
PrintOverlayPurgeDays Specifies the number of days to keep old 7
print requests in the database.
AlertDataPurgeDays Specifies the number of days to keep old 7
alert events in the database.
TrxStatisticsBackup Defines if transceiver statistics should be true
saved or not.
NumberOfBackupsSaved Specifies the number of Full System- and 7
PFI-backups that should be saved before
being automatically removed.

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”

SSL certificate problem

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).

GlobalError log: ERROR - E30272 : Exception in sending mailjavax.mail. MessagingException:


Can't send command to SMTP host; nested exception is: javax.net.ssl. SSLHandshakeException:
sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.
certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

How to add a mail certificate to Java Key Store (JKS)

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

2. Open Command Prompt and go to <C:\Pricer\Java\lib\security>

3. Type: \Pricer\Java\bin\keytool.exe -import -alias name_of_certificate -file


C:\temp\name_of_certificate.crt -keystore cacerts [ENTER]

4. Enter keystore password: changeit [ENTER]

5. Trust this certificate? [no]: y [ENTER]

6. Certificate was added to keystore

7. Restart Pricer Server

You might also like