Wialon Local 1408 en
Wialon Local 1408 en
User Guide
as of January 16, 2015
Wialon Local
Basic Definitions
Wialon Administration
Technical Specification and Requirements
Installation of Wialon Local
License
Administration Panel
Status
License
Maps
Gurtam Maps
WebGIS
Format Specification
Logs
Wialon
Root User
Sites
Modems
Trash
System
Backup Server
Changelog
Management System
Access Rights
Standard Rights (Item ACL)
Unit ACL
Unit Group ACL
User ACL
Resource ACL
Route ACL
Creator
Access Dialog
CMS Interface
Top Panel
Navigation and Search
Results Panel
Log
CMS Settings
Accounts
Working with Accounts
Creating Accounts
Payment Control
Features
Deleting Accounts
Billing Plans
General Properties
Features
Users
User Properties
Notices to Users
Units
Sensors
2
Sensor Properties
Sensor Types
Sensor Parameter
Validation of Sensors
Calculation Table
Calculation Table Wizard
Custom Intervals
Signed Parameters Converting
Temperature Coefficient
General Properties
Counters
Access to Unit
Icon
Advanced Properties
Custom Fields
Unit Groups
Commands
Trip Detection
Fuel Consumption
Service Intervals
Unit Groups
Unit Group Properties
Retranslators
Import and Export
Import from WLP
Export to WLP
Import from KML/KMZ
Export to KML/KMZ
Unit Properties Transfer
Resource Contents Transfer
User Settings Transfer
Conversion
Apps
Monitoring System
System Optimization
User Interface
Login
Top Panel
Work Area
Bottom Panel
Map
Log
Shortcuts
Calendar
Filters and Masks
Input Rules
User Settings
General Settings
Maps
Account
Monitoring
Tracking Units on Map
Icons Explanation
Unit List Management
Commands
Events Registrar
Pictures from Messages
3
Locator
Tracks
Mapping a Track
Track Parameters
Tracks Management
Messages
Working with Messages
Data Messages
SMS Messages
Sent Commands
Registered Events
Unit Log
Export/Import Messages
Reports
Query and View Reports
Online Report
Print Report
Export Report to File
Report Templates
Creating Report Template
Advanced Settings
Tables
Table Parameters
Intervals Filtration
Chat History
Check Points
Chronology
Connection Problems
Counter Sensors
Custom Fields
Digital Sensors
Engine Hours
Events
Executed Commands
Fuel Fillings
Fuel Thefts
Geofences
GPRS Traffic
Logs
Maintenance
Non-visited Geofences
Parkings
Rides
Rounds (for unit)
Rounds (for route)
Sensor Tracing
SMS Messages (for unit)
SMS Messages (for resource)
Speeding
Stops
Summary
Trips
Unfinished Rides
Utilization Cost
Violations
Visited Streets
Charts
4
Chart Management
Chart Parameters
Other Charts
Map Output
Tracks on Map
POIs and Geofences on Map
Markers
Statistics
Other Reports
Reports on Unit Groups
Reports on Users
Reports on Drivers and Driver Groups
Reports on Trailers and Trailer Groups
Data in Reports
Fuel
Getting data (being updated …)
Data preparation
Filtration
Fillings Detection
Thefts detection
Consumption calculation
Speeding
POI
Creating POI
POI Management
Geofences
Creating a Geofence
Geofences Management
Usage
Routes
Creating a Route
Schedule
Rounds
Route Control
Routes Management
Drivers
Creating a Driver
Managing Driver List
Driver's Assignment
Groups of Drivers
Usage
Trailers
Creating a Trailer
Managing Trailer List
Binding and Unbinding Trailers
Groups of Trailers
Usage of Trailers
Jobs
Configuring Jobs
Execute a Command over a Unit
Change Access to Units
Jobs about Counters
Send a Report by E-mail
Send Information about Fuel
Notifications
Notification Type
Notification Action
5
Notification Text
Notification Parameters
Notifications Management
Online Notification
Users
Units
Unit Groups
Tools
Track Player
Distance
Area
Address
Routing
Hittest
Nearest Units
SMS
Apps
Wialon Mobile
ActiveX
SDK
6
Basic Definitions Table of Contents
Basic Definitions
Main Interface (Tracking
GPS tracking system Wialon Local is a software product that allows end users to control System)
their units (vehicle fleet, machinery, employees, pets, etc.). CMS Manager (Management
System)
Administration Panel
Unit tracking includes:
Tracking results can be presented on the computer screen as well as exported to files in different formats.
Wialon Local main interface is an interface where end users watch their units
and create and configure diverse system micro objects for tracking purposes:
POIs,
geofences,
jobs,
notifications,
drivers,
trailers,
report templates.
These items cannot exist independently and are a part of some resource.
The detailed description of Wialon Local user interface can be found in the section of this guide entitled Monitoring
System.
CMS Manager is a special interface developed for Wialon Local managers. CMS refers to Content Management
System. Content in this context is system macro objects which are:
accounts (resources),
billing plans,
users,
units,
unit groups,
retranslators.
They exist independently and are not a part of a bigger object like resource.
They can include smaller items as their contents, and those items are deleted together with the macro
object they belong to. As mentioned above, a resource can hold POIs, geofences, jobs, notifications,
drivers, and report templates. A unit can contain sensors, commands, custom fields, and service intervals.
Users and unit groups can hold only custom fields.
Access rights are assigned to macro objects, and they affect those objects themselves as well as their
contents. That is why macro object properties dialog usually has a special Access tab to manage rights.
7
Some macro objects like retranslators, accounts (resources), and billing plans are accessible only through
the management interface that is CMS Manager.
CMS Manager is designed to work with these items — create, configure, update, copy, import, export, delete them,
and what is the most important distribute access rights to these objects. Access right is a possibility to view some
system objects and perform allowed actions over them.
Partly these functions can be also fulfilled in the user interface. However, the main difference here is that CMS
Manager has a handy easy-to-use interface that allows to work with a great number of items, filter them by different
criteria, display them in the form of a table, create tabs with search results, and many more. Besides, the exclusive
privilege of CMS Manager is possibility to work with accounts (that is to control payment, restrict services and adjust
their cost) and retranslators.
Note.
There is one type of macro object that is not available in CMS Manager — route. Routes can be created only in the
user interface of Wialon Local. They store check points and schedules inside and do not depend on any resource.
However, it is possible to manage access to routes — through user properties dialog.
The detailed description of CMS Manager interface can be found in the section of this guide entitled «Management
System».
Administration Panel
The administrator of Wialon Local can start and stop Wialon, watch its
operation, monitor errors, take care of memory consumption and CPU load, etc.
8
Wialon Administration
Technical Specification and Requirements
Installation of Wialon Local
License
Administration Panel
Status
License
Maps
Logs
Wialon
System
Changelog
9
Technical Specification and Requirements Table of Contents
Technical Specification and
Requirements
Wialon Local is provided as all-in-one solution which includes basic OS (Debian Linux) and Server Requirements
components installed via ISO file. Some components, like hardware drivers and modules of
Wialon Local itself, require network access during the installation process.
Provided OS is Debian Linux (Jessie), highly customized to meet the needs of Wialon Local. It is not recommended to
use it for other software except for the products that are needed for Wialon Local to operate properly.
Apart from the OS, there are some software components (like inbound nginx and postfix servers) installed for proper
functionality of your Wialon Local server (to have your DNS working and e-mails sent).
Wialon DB
Wialon Local has embedded data storage system Wialon DB, a proprietary DBMS with stable support for transactional
processing and replication features. Physically it is located in storage folder of your Wialon Local. All kind of
communications with the database are done either via provided web interfaces or various development tools.
Server Requirements
1. CPU: Core i7
2. RAM: 16 GB (Wialon only)
3. HD: any RAID from 2TB
Naturally, there is some level of approximation in these hardware requirements. Storage volume may vary a lot
depending on how frequently and what amount of parameters units send. Operation of jobs and notifications,
execution of reports, amount of units in online tracking, total number of system items created by users, hardware
extension — the more of all these, the more cores of the CPU and total RAM you should use.
10
Installation of Wialon Local
The distribution of Wialon Local contains also operating system Debian Linux (Jessie). In case of installation onto
Windows server, use a virtual machine.
First, download ISO image from the distribution server and write it onto a CD, DVD, or USB flash drive.
Adjust BIOS configuration in such a way to boot from CD/DVD drive. Then follow the instructions on the screen:
1. Choose installation type: on one drive, two (RAID-1), or four (RAID-10) drives.
2. If more than one network is detected, you will be asked to select one to be used during the installation process.
However, if DHCP server is not available during the installation, check network availability and repeat network
adjustment or set network parameters manually:
11
3. Set up password for root account — main account of your Debian OS.
12
4. If installation on one drive was chosen in the beginning, select a particular drive here.
5. When installation process is complete, the system will reboot automatically (do not forget to readjust BIOS
settings back). After reboot, URL address for Wialon Local administration system will be shown.
6. Enter this URL in your browser's address bar. To authorize, use user name and password given to you when
13
purchasing Wialon Local.
7. After successful authorization, Wialon Local will be downloaded and installed. It may take some time.
8. When the process is complete, the Administration Panel will show up.
Entering administration system, you can get a warning like on the image below (You are looking for site that is not
available here. Please check your DNS configuration.)
In this case, you should write your new address for the administration system in the file /etc/nginx/conf.d/lcm.conf.
For example,
14
License
The license is integrated into your personal build of software.
Every day, Wialon Local connects to the license server and confirms the product usage on one server at a time. If this
license check is blocked because of firewall or lack of Internet connection, it will cause a ban to use the program. In
this case, you will not be able to create new units. At that, working service with all its configuration will not be damaged.
Several times a day Wialon Local connects to the server local-api.wialon.com to fetch updates. This server also
responsible for authorization of the administrator. Successful authorization of the administrator, as well as successful
purchases are possible only with enabled Internet connection.
If there is a problem with license, you cannot create any monitoring units, and phrases like Error fetching license:
'avl.unit' can be found in log files.
15
Administration Panel
Status
License
Maps
Gurtam Maps
WebGIS
Logs
Wialon
Root User
Sites
Modems
Trash
System
Backup Server
16
Status Table of Contents
Status
Log
On this page, basic and most vitally important parameters of service operation are shown.
Wialon status
Your Wialon Local can be either running or stopped. If it is running, you can see also for how long — in the format
hh:mm:ss. Time is zeroed when you restart Wialon.
Wialon can be started/stopped on the System page. It is also restarted when updates are installed.
Units online
This row shows the percentage of online units (figure before slash) relative to all units created (figure after slash).
Total users
The number of all users created in the system.
Active sessions
The number of sessions active at the moment. Note that one user can create multiple sessions.
Message requests
The number of requests for providing messages that the database received within the last minute.
RAM usage
Percentage and absolute volume of memory being used.
HDD usage
Percentage and absolute volume of disk space being used. If 90 and more percent of disk space is reached, a warning
is sent to the administrator (whose e-mail is adjusted on the System page).
Graph
The graph shows the dynamics of service operation for the last 24 hours (or since the last global launch). Blue line
17
represents the number of users, orange line — units.
Log
The Log is located on the bottom of each page in the Administration Panel. Here current events occurring in the
system are reported. For example, Wialon starting and terminating, availability of new updates, installation of
components, etc. The log clears when you reload the page.
18
License
On this page, you can control your license — see what you already have and activate new components according to
your needs. Three types of components exist. They are modules, retranslators, and hardware.
Modules
Modules are mostly helpful for extending your service possibilities. This can be either new features for end users (like
“Notifications”, “Fuel Control”, “Advanced Reports”, etc.) or enhancement of general service qualities (like “Hot Backup”,
“Personal Design”, “Extra Site”, etc.).
Retranslators
Here you can activate new retranslation protocols for your service.
Hardware
Here you activate new types of devices to be used in your system. They go in groups according to manufacturer. This
means, purchasing XYZ hardware you purchase all types of devices made by XYZ company. Visit GPS Hardware to
find the full list of supported devices and further information.
In all blocks, items are sorted alphabetically, however, purchased items are placed on top forming their own sublist.
Sorting type can be changed — by current usage, price, or purchase status. Just click on the corresponding column
title once (for direct sorting order) or twice (for reverse sorting order). To quickly find certain item, use text filter which is
located in the header of each of three blocks.
Division of items by status (purchased or not) can be disabled. Just click on “Status” in the header twice (unlike other
titles, this one has three states — up, down, and none). With sorting by status disabled, you can get the list of items
strongly alphabetically or by other criteria.
Activated components have the status Purchased. Components available for purchase have the Add to card button in
their status. Press this button to add new components to your service. The total cost of your purchase is indicated
below. When finished, press Buy selected and confirm your actions.
For changes to take effect, go to the System page and install updates. To complete the procedure, Wialon will be
automatically restarted. Sometimes you may also need to refresh the page and clear cache.
19
Current amount is indicated for such components as units, extra sites, mobiles, and personal designs. When
purchasing them, the price is given for one piece, and in case of units — for a package of 25 units.
20
Maps Table of Contents
Maps
Map Source
On this page, you configure your cartographic system. Maps are important for end users in two Configuring AVD Maps
ways. First, maps serve as a background to place tracking units on it, build tracks of
movements, draw geofences, etc. For another thing, maps define the accuracy of address information that appears
during online tracking as well as in reports.
Map Source
First of all, choose them map source: either AVD or Gurtam Maps (they cannot be used together).
Choosing Gurtam Maps means that Gurtam will be responsible for maintaining the map server and updating
cartographic data. That is why if you select Gurtam Maps, other sections on this page collapse indicating that you will
not need them.
This module is paid and can be purchased on the License page.
Choose AVD if you prefer to create and manage your own WebGIS server. The process is described below.
21
maps are sorted into folders by country.
22
Gurtam Maps Table of Contents
Gurtam Maps
Conversion Table: Polyline
All address information for online tracking and reports is taken from Gurtam Maps. Conversion Table: POI
Conversion Table: Polygon
Maps in Gurtam Maps format are used. Gurtam Maps format refers to vector graphics files, Scale (Gurtam Maps)
which contain a map of a particular place or region. This format means to be used in
applications developed on the basis of ADF software platform such as Gurtam Maps.
Gurtam Maps are created from vector maps in different formats like MP, MapInfo, ESRI Shape, OSM
(OpenStreetMap). Note that a source map must be in WGS-84 coordinate projection in grades.
Vector maps in the closed Gurtam Maps format allow ADF-based programs to render map images, fulfill the search of
named element, use geocoding including reverse geocoding.
23
(sliproads/ramps) leading 0-5
highway primary_link PL 6 2 to/from a primary road
6-7
from/to a primary road or
lower class highway.
0-5
Roads generally linking
0×0004 highway secondary PL 7 2
smaller towns and villages. 6-9
24
cycleway lane PL 18 1 bicycles that lies within the
roadway.
25
aeroplanes to take off from
and land on.
0×0045
boundary administrative admin_level 8 PL 191 1 State, county, local council.
0x001d
0x001c PL 192 1 Region boundary.
admin_level 2
0x001e boundary administrative PL 193 2 National boundary.
border_type nation
0xf002
0x2f08
0x2f17
highway bus_stop POI 51 0 A small bus stop.
0xf001
0xf003
0xf004
highway metro POI 500 Metro.
highway tram POI 501 A tram stop.
0×5900
highway airport POI 503 Airport.
0×5901
A service station to get food and eat
0x2f03 highway services POI 52 0
something, often found at motorways.
26
amenity bureau_de_change POI 61 0 foreign bank notes and travellers
cheques.
amenity atm POI 61 0 An ATM or cash point.
0x2b00
0x2b01 tourism hotel POI 62 0 A hotel, a motel, a guest house
0x2b02
tourism hostel POI 62 0 A hostel.
0×0100 POI 302 Capital.
0×0200 POI 63 2 A megalopolis over 5 million people.
A city of 1-5 million people (MP).
0×0300
place city POI 64 2 A city over 100 thousand people
0×0400
( OSM).
0×0500
0×0600
0×0700
0×0800
place town POI 65 1-2 A town from 10 to 100 thousand people.
0×0900
0x0a00
0×0006
0×0004
0x0b00
0x0c00
0x0d00
0x0e00
place village_greenhamlet POI 66 1 A village below 10 thousand people.
0x0f00
0×1000
0×1100
0×0010
0x640a POI 67 0 Captions.
place continent POI 195 2 A continent.
0×6602 place state POI 196 2 A state.
0x1e00 place region POI 197 1 A region.
0x1f00 place country POI 198 1 A country, area.
27
0x004f
0x008e
leisure garden PG 141 1 A garden.
0×0086
0×0087
0×0088
0-2
145- A town hall building (mayor's office),
0x006d amenity townhall PG 1
146 administrative building. 3
0×0001 0-3
Predominantly houses or apartment
0×0002 landuse residential PG 166 1
buildings. 4-7
0×0003
0-3
landuse retail PG 167 1 Predominantly shops.
4-7
0-3
Predominantly office buildings, business
landuse commercial PG 168 1
parks, etc. 4-7
0-3
Predominantly workshops, factories,
0x000c landuse industrial PG 169 1
warehouses. 4-7
0-3
28
0×0006 PG 169 0 Garages, vehicle sheds.
4-7
0-2
building postoffice PG 208 1 A post office.
3
0-2
building restaurant PG 209 1 A restaurant.
3
0-2
0x006f
amenity public_building PG 210 1 Public building.
0x006f 3
0-2
0×0013
building yes PG 210 1 General tag for buildings.
0x006c 3
baptist
catholic 0-2
christian
denomination PG 211 0 A church.
evangelical 3
lutheran
roman_catholic
0×9999 surface PG 212 2 Bottom surface.
29
0,05 50 0 1 5000
0,1 100 0 2 10000
0,1 100 0 3 10000
0,2 200 0 4 20000
1 1000 1 5 100000
1 1000 1 6 100000
2 2000 1 7 200000
5 5000 1 8 500000
10 10000 1 9 1000000
20 20000 1 10 2000000
50 50000 2 11 5000000
100 100000 2 12 10000000
100 100000 2 13 10000000
200 200000 2 14 20000000
30
WebGIS Table of Contents
WebGIS
Compilation Parameters
Standard WebGIS server is included to the Wialon local. By default any address information Creating a Map from MP Format
used for online tracking and reports is taken directly from it. Creating Maps From OSM
Format
Maps from Other Vector
AVD format files are used in WebGIS. Files of such a format could be created from other vector Formats
data formats, such as MP, MapInfo, ESRI Shape, OSM (OpenStreetMap). Note that the
source map should be done in WGS-84 coordinate system (in grades).
Source maps in the supported vector format should be downloaded to the server. Source maps' files should be given
as data archive including a set of configuration files. Depending on the source map format, the archive should include a
particular set of files. To successfully unpack the archive on the server, the first one should not contain subfolders.
Compilation Parameters
Map name
Map name, for example, the name of the city for which the map is created.
Map tag
Map tag like city, country, etc. Could be used for a search or as a drawing filter.
Priority
Map priority, default – 100. Bigger priority means earlier map render. Maps with minor priority are rendered later and
are situated above those with bigger priority.
Min level
Min level to draw the map. Default – to be detected automatically.
Max level
Max level to draw the map. Default – to be detected automatically.
Add search
Add search info to the map.
Capital letters
Consider a letter case (lower/upper) in the MP file address info (Cities, Regions, Countries).
Clear background
Clear background on render map flag is used for combining multiple maps. Maps with higher priority situated in lower
layers are not displayed. If the maps overlay, the top (more detailed) map is displayed. Background will be white. The
flag is highly recommended to be used.
Skip render
Skip map rendering means not to include drawing information for the map (then the map will be used for a search
only).
Skip addresses
Skip addresses means not to enable possibility for reverse geocoding (address search by coordinates). The map will
be used for rendering only.
To create a map from the Polish MP format, you have to use a special XML configuration file. To download it on
server, an archive consisting of a source map in MP format and of a configuration XML file should be created.
31
Standard configuration file transforming MP files to AVD files (pfm.xml)could be downloaded here:
http://distro.gurtam.com/maps_cfg/. You can create your own configuration file according to your requirements.
Example:
<pfm>
<feature type="0x0001" shape="PL" avd_type="1" max_level="2" name="A restricted
access major divided highway, normally with 2 or more running lanes plus emergency
hard shoulder. Equivalent to the Freeway, Autobahn, etc." use_addr="1"
is_street="1"/>
<feature type="0x0002" shape="PL" avd_type="3" max_level="2" name=" Important
roads that aren't motorways. Typically maintained by central, not local government.
Need not necessarily be a divided highway." use_addr="1" is_street="1"/>
<feature type="0x0003" shape="PL" avd_type="5" max_level="2" name="Roads generally
linking larger towns." use_addr="1" is_street="1"/>
<feature type="0x0004" shape="PL" avd_type="7" max_level="2" name="Roads generally
linking smaller towns and villages." use_addr="1" is_street="1"/>
<feature type="0x0000" shape="PL" avd_type="9" max_level="2" name="Minor roads."
use_addr="1" is_street="1"/>
<feature type="0x000a" shape="PL" avd_type="11" max_level="1" name="Unclassified
roads typically form the lowest form of the interconnecting grid network."
use_addr="1" is_street="1"/>
<feature type="0x0042" shape="PL" avd_type="12" max_level="1" name="Unpaved roads."
use_addr="1"/>
<feature type="0x3008" shape="POI" avd_type="59" max_level="0" name="A fire station."
use_addr="1" is_house="1"/>
<feature type="0xf001" shape="POI" avd_type="60" max_level="0" name="Bus station."
use_addr="1" is_house="1"/>
<feature type="0x2f06" shape="POI" avd_type="61" max_level="0" name="A bank."
use_addr="1" is_house="1"/>
<feature type="0x2b00" shape="POI" avd_type="62" max_level="0" name="A hotel."
use_addr="1" is_house="1"/>
</pfm>
use_addr
Use this element when searching address by coordinates.
is_city
Use this element when searching a place by name (city).
is_street
Use this element when searching a street by name (street). Locking (snap) to roads function can also use this
element.
is_house
Use this element when searching a house by name or number (house).
is_road
A road. This element can also be used to lock unit's movements to existing roads.
type
Source type from MP file (Polish format).
shape:
32
PG –- polygon, PL –- polyline, POI –- point.
avd_type
Resulting map type in AVD file (0-255).
max_level
Maximum level to store map data in AVD format. Levels depend on metrage: o level – from 10 to 250 meters, 1 level –
from 250 m to 20 km, 3 level – from 20 to 500 km.
name
The name of an object, area, point, that is custom mark.
Note.
The following conditions should be met in order to properly store map inscriptions:
source MP file must be encoded in Win 1251, and the inscription (IMG ID) must contain the string
CodePage=1251;
source MP file must be encoded in Win UTF-8, and the inscription (IMG ID) must contain the string
CodePage=1252 or other value different from 1251.
To create maps from OSM format files, a configuration XML file or allCountries.txt are used. To download on server,
an archive containing OSM format source map, configuration XML file, and allCountries.txt should be formed. The last
one (allCountries.txt) is an additional file for address binding. The document consists of world cities list in which the
population size is indicated. An approximate radius of a city is calculated on the basis of the special algorithm and
depends on the population size.
osm.xml is a configuration file transferring OSM files to the standard AVD files.
Standard configuration file transferring OSm files to AVD files (osm.xml) and allCountries.txt could be downloaded
here: http://distro.gurtam.com/maps_cfg/.
To create maps from other vector formats such as MapInfo, ESRI shapefile, etc., it is necessary to download an
archive consisting of the source map layers in a corresponding format and of a configuration XML file.
The file starts and ends with the conv tag. The following keys can be used inside this tag: name – map name,
encoding – file encoding for a conversion.
The main part of a map conversion is a description of layers used to receive data. The layer tag allows to describe
each layer individually and, if provided by different attributes, converse a map according to them.
Then you should indicate the features layer properties. In the type key it is necessary to indicate the elements' type
value from the map in the format *.avd (see it in pfm.xml or osm.xml). The name parameter is used to display any
properties of a converting objects. This parameter will be used as a caption for objects on the map. Only Latin letters
and $ sign are accepted. In the above mentioned example the names for the used fields could be found in the files
indicated there,i.e., in *.shp. If other symbols are used, the file may be converted with errors or not converted at all. If
you would like to convert such files, you should change the fields' names for the latin ones.
It is also necessary to indicate the level on which the maps from the file will be situated. The max_level parameter is
in charge for it. Depending on your preferences, you can vary these parameters from 0 to 2 or leave them as in
pfm.xml or osm.xml.
data_type – object type: polygon (pg), polyline (pl), point (poi). Example: data_type=“pg”.
33
address – define address by the indicated value.
region – define region name by the indicated value. Example: region=“$Region”.
street – define street name by the indicated value. Example: street=“$st”.
street_type – define street type by the indicated value. Example: street_type=“$sts_type”.
house – define house number by the indicated value. Example: house=“$number”.
is_city – define if this object is a city. If it is not, do not use this parameter. Example: is_city=“1”.
is_street – define if this object is a street. If it is not, do not use this parameter. Example: is_street=“1”.
is_house – define if this object is a house. If it is not, do not use this parameter. Example: is_house=“1”.
dump_attr is responsible for displaying particular object properties (in stdout). It works in the same way
as the name parameter, but it displays information for a user who is converting the map.
Dollar sign in quotes (“$”) means that letters which follow will be used as a variable and substituted with this variable
value. To use a usual text together with a variable, it is necessary to mark it with | sign from both sides. To retrieve
data from some other layer, use the hash sign (#). After #, set three parameters. In the first parameter indicate the
field from which the value should be taken, and then put a dot (.). The second parameter indicates the layer (filename
without extension) to be used to get data, put a dot again. The third parameter indicates which field from the indicated
layer should be used. The forth parameter can be used if the value is hidden in a string field or among a number of
values – enter field, equal sign (=), and % sign in single quotes ('%'). Do not forget to separate all parameters with
dots.
Here is an example.
Then,
If you have noticed that the layer file contains objects of different types (you can check it with the dump_attr
parameter), and you want to display them as different types, use the mod tag. There you set filtration conditions and
object type expected as the result of conversion process. In the filter parameter enter the condition as SQL query.
The type parameter is set in the same manner as it was described above.
In one layer there can be any number of features. In one features there can be any number of mod.
If there is an error when reading the file, try to open it in another program, for example, Internet Explorer: if there are
any errors in file body, IE displays only the correct part of the file, however note that the check is performed only for
opening/closing tags.
Use comments to make easier further editing and usage of the file.
34
Format Specification Table of Contents
Format Specification
Conversion Table: Polyline
Vector maps in the closed AVD format allow rendering map images in various projections, fulfill Conversion Table: POI
the search of named objects, and detect location by given coordinates. Conversion Table: Polygon
Scale (AVD)
35
highway secondary_link PL 8 2 to/from a secondary road
from/to a secondary road
or lower class highway.
0-6
0×0000 highway tertiary PL 9 2 Minor roads.
7-8
36
squares and plazas.
A busway where the 0-6
vehicle guided by the way
highway bus_guideway PL 20 1 (though not a railway) and (7-
is not suitable for other 9)
traffic.
junction roundabout PL 21 1 Circle movement.
Full sized passenger or
freight trains in the
0×0014 railway rail PL 25 1
standard gauge for the
country or state.
One or two carriage rail
railway tram PL 25 1 vehicles, usually sharing
motor road for trams.
A city passenger rail
service running mostly
0x003f railway subway PL 26 1 grade separated.
Metro/underground/subway
lines.
A section of railway which
is no longer used but
railway disused PL 25 1 where the track and
infrastructure remains in
place.
A railway with only a single
railway monorail PL 27 1
rail.
For narrow rivers which will
0x001f waterway river PL 30 2
be rendered as a line.
An artificial open waterway
0×0018 waterway canal PL 30 1 used for transportation,
waterpower, or irrigation.
A naturally-formed
waterway that is too thin to
be classed as a river. An
0×0026 waterway stream PL 30 1 active, able-bodied person
should be able to jump
over it if trees along it are
not too thick.
An artificial waterway for
0×0044 waterway drain PL 30 1 carrying storm water or
industrial discharge.
A barrier built across a
river, sometimes to divert
waterway weir PL 30 1 water for industrial
purposes. Water can still
flow over the top.
A wall built across a river
or stream to impound the
waterway dam PL 31 1 water. A dam normally
does not have water
flowing over the top of it.
A strip of land kept clear
and set aside for
aeroway runway PL 35 1
aeroplanes to take off from
and land on.
37
0×0045
boundary administrative admin_level 8 PL 191 1 State, county, local council.
0x001d
admin_level 2
0x001e boundary administrative PL 193 2 National boundary.
border_type nation
0xf002
0x2f08
0x2f17
highway bus_stop POI 51 0 A small bus stop.
0xf001
0xf003
0xf004
A service station to get food and eat
0x2f03 highway services POI 52 0
something, often found at motorways.
38
0x2b00 tourism hotel POI 62 0 A hotel.
0x2b01 tourism motel POI 62 0 A motel.
0x2b02 tourism guest_house POI 62 0 Guest house.
tourism hostel POI 62 0 A hostel.
0×0100
POI 63 2 A megalopolis over 5 million people.
0×0200
0×0300 A city of 1-5 million people (MP).
place city POI 64 2
0×0400 A city over 100 thousand people ( OSM).
0×0500
0×0600
0×0700
0×0800
place town POI 65 1-2 A town from 10 to 100 thousand people.
0×0900
0x0a00
0×0006
0×0004
0x0b00
0x0c00
0x0d00
0x0e00
place village_greenhamlet POI 66 1 A village below 10 thousand people.
0x0f00
0×1000
0×1100
0×0010
0x640a POI 67 0 Captions.
0×3002
POI 149 0 A hospital.
0×6408
place continent POI 195 2 A continent.
0×6602 place state POI 196 2 A state.
0x1e00 place region POI 197 1 A region.
0x1f00 place country POI 198 1 A country, area.
39
anywhere.
0x004e
0x004f
0x008e
leisure garden PG 141 1 A garden.
0×0086
0×0087
0×0088
0x006d amenity townhall PG 146 1 A town hall building (mayor's office).
0x001a amenity grave_vard PG 147 1 A graveyard.
(0-
5)
0x000a amenity school PG 148 1 A school.
(6)
(0-
5)
amenity university PG 148 1 A university.
(6)
(0-
5)
amenity college PG 148 1 A college.
(6)
(0-
5)
0×3002 amenity hospital PG 149 1 A hospital.
(6)
(0-
5)
amenity pharmacy PG 149 1 A pharmacy.
(6)
(0-
5)
0×6408 building clinic PG 149 1 A clinic.
(6)
(0-
5)
0x000b building hospital PG 149 1 A hospital.
(6)
shop
supermarket PG 151 1 A supermarket.
building
building shopping PG 151 1 A shop.
Camping, a place where you can pitch
tourism camp_site PG 153 0
a tent.
A place where you can park a caravan
tourism caravan_site PG 153 0
overnight or for longer periods.
A place where you can have an
tourism picnic_site PG 154 0 outdoor picnic. May have facilities such
as tables and benches.
tourism theme_park PG 155 1 Theme park, amusement park.
40
tourism attraction PG 156 0 A general tourism attraction.
tourism zoo PG 157 1 A zoo.
tourism artwork PG 158 1 A tag for public pieces of art.
historic archaelogical_site PG 159 0 Archaeological museum.
0×0050
0×0081
0×0082
0×0083
0×0084
landuse forest PG 165 2 Managed forest or woodland plantation.
0×0085
0×0052
0x008f
0×0090
0×0091
0×0001
Predominantly houses or apartment
0×0002 landuse residential PG 166 1
buildings.
0×0003
landuse retail PG 167 1 Predominantly shops.
Predominantly office buildings,
landuse commercial PG 168 1
business parks, etc.
Predominantly workshops, factories,
0x000c landuse industrial PG 169 1
warehouses.
0×0006 PG 169 0 Garages, vehicle sheds.
A district to be developed, an empty
landuse blownfield PG 170 1
area.
Describes land scheduled for new
landuse greenfield PG 170 1 development where there have been
no buildings before .
Area for railway use, generally off-limits
landuse railway PG 171 1
to the general public.
landuse construction PG 172 1 Something under construction.
For land areas owned/used by the
0×0004 landuse millitary PG 173 1
military for whatever purpose.
0×0014
0x000d
0×0015
0×0016
Natural woodland (trees). Only for
0×0017 natural wood PG 184 2
completely unmanaged/wild areas.
0x001e
0x001f
0×0020
0×0098
0×0051 Low poorly drained land that is
0×0096 natural marsh PG 185 1 sometimes flooded and often lies at the
0x008b edge of lakes, streams, etc.
0×0018 sport golf PG 194 1 Golf course.
sport horse_racing PG 194 1 Hippodrome, racecourse.
sport multi PG 194 1 Sports ground, playing field.
sport football PG 194 1 Football.
sport soccer PG 194 1 Football or soccer.
A stadium, a major sports arena with
building stadium PG 194 1
substantial tiered seating.
leisure golf_course PG 194 1 Golf course.
41
leisure stadium PG 194 1 A stadium.
A track, e.g. running, cycle-racing,
leisure track PG 194 1
greyhound, horses.
A field for playing football/soccer,
leisure pitch PG 194 1
cricket, baseball sports, etc.
(0-
5)
building palace PG 207 1 A palace.
(6)
(0-
5)
building postoffice PG 208 1 A post office.
(6)
(0-
5)
building restaurant PG 209 1 A restaurant.
(6)
(0-
0x006f 5)
amenity public_building PG 210 1 Public building.
0x006f
(6)
(0-
0×0013 5)
building yes PG 210 1 General tag for buildings.
0x006c
(6)
(0-
5)
0x006e building terminal PG 210 1 A building.
(6)
baptist
catholic (0-
christian 5)
denomination evangelical PG 211 0 A church.
lutheran (6)
Roman Catholic
roman_catholic
(0-
5)
0×9999 surface PG 212 2 Ground surface.
(6)
Scale (AVD)
42
2 2000 1 7 200000
5 5000 1 8 500000
10 10000 1 9 1000000
20 20000 1 10 2000000
50 50000 2 11 5000000
100 100000 2 12 10000000
100 100000 2 13 10000000
200 200000 2 14 20000000
43
Logs
On this page, you can observe different kinds of logs kept in the system. Last hundred messages are available for:
Wialon logs
Wialon errors
Nginx logs
System logs
Local logs
The system checks for errors once an hour, and if there are any, a report is sent to the administrator (whose e-mail is
adjusted on the System page).
44
Wialon
This page is accessible only when Wialon is operating. Here you configure sites and modems, manage recycle bin, etc.
Further information:
Root User
Sites
Modems
Trash
45
Root User
The root user is “wialon”. With this username and initially the same password, you can login to the main tracking
interface (Wialon Web), CMS Manager, and other Wialon services (sites).
On the Wialon page, you can enter e-mail address and password for the root user. E-mail is required for reset
password procedure, password — for login action.
Note that only the root user can create and manage billing plans, Apps, and perform conversion.
46
Sites Table of Contents
Sites
Personalization
By default, two sites are available: one of Wialon Web type and one of CMS Manager type. Maps and Languages
CMS Manager (management system where accounts, users, units, retranslators are created);
Wialon Web (the main tracking interface where end users watch their units, generate reports, etc.);
Wialon Mobile (a simplified tracking interface for mobile devices);
ActiveX (a third-party software solution providing possibility to connect to Wialon database from external
applications).
You can have only one CMS Manager site and one ActiveX, however, several Wialon Web sites (“Extra Site” module)
and Wialon Mobile sites can be added, each located on its own DNS and, perhaps, wearing personal skin (paid option
for Wialon Web sites).
Press the Edit button to adjust site configuration — mainly DNS. Additional options are available for sites of Wialon
Web type. You can define your custom title for a site, add copyright (this link will be displayed in the bottom panel), and
apply a personal design.
In the table, you see site DNS, type, and two buttons: to reconfigure a site and to stop/start it. Stopping a site means
that users will not be able to login. Click on DNS link to open a site.
Note.
After (re)starting Wialon, all sites are restarted, too, regardless what state they were before.
Personalization
Sites of Wialon Web type (main tracking interface) can have a personalized look (each of them).
First of all, there is a paid option of “Personal Design”. It provides possibility to customize color scheme, fonts, and
styles specially developed for your site (in addition to logos, favicon, and copyright link). However, no changes can be
made to the layout of functional blocks (like panels and menus) and standard icons. Usually, new look is appealing to
your corporate style.
Personal designs are known also as skins. To apply one, choose its name in the appropriate dropdown list.
Some level of customization is possible even without personal design. You can give a title to your site, place your
logos, and add copyright information. For the logos and favicon, make sure they meet requirements introduced in
corresponding tooltips. After choosing an image, do not forget to press “Upload”. Moreover, URL addresses of support
and help services can be indicated on this tab. Such services could be used in the main tracking interface. To finalize
changes press “Save”.
To come back to the initial look, empty all text fields on this tab and reset all images to “Default”.
47
Here is where you can find all these things:
Maps should be enabled for each site separately. By default, users get access to Gurtam Maps / WebGIS (according
to your system configuration) and OpenStreetMap. Other maps can be used as background for tracking units, too.
However, most of them require activation keys.
Select maps you need and enter activation keys (if needed) on this tab. Note that even with maps enabled for the site,
users still need to activate maps they need in their own settings.
48
On the Languages tab, select necessary languages. Note that if no flag is chosen, then all the languages will be
available by default.
49
Modems Table of Contents
Modems
Modem Common Parameters
This module is paid and can be purchased on the License page. GSM Modem Parameters
SMPP Gateway Parameters
To create a new modem, press the “Add modem” button on top of the section. Two types of Advance Parameters
modems are supported: GSM modem and SMPP gateway. Some of parameters of their
configuration are common and others differ.
Name
Enter a name for the modem.
Phone
Enter phone number of SIM card installed on the modem.
Link priority
Define communications channel priority.
Restart interval
Indicate restart interval in seconds. If the connection with modem is broken by any reason, after the time it will be
automatically restarted. Note that if the restart interval is zero, the modem is not started when restarting the service.
Phone mask
Use this field if you want to restrict modem activity to indicated phone numbers. If a mask is entered here, this modem
will be used only to send messages to phone numbers that correspond to this mask. Otherwise, message will be sent
via another modem or not be sent at all.
Serial port
Indicate serial port where the modem is located.
Port speed
Indicate port speed. If any errors appear while operating, descend this value.
AT commands
Indicate additional initialization AT commands if they are required according to modem instructions manual.
50
Use 8-bit encoding only
Check this option if you want to exclude other kind of encoding.
Server …
Indicate server host (IP address or DNS name), server port, and password to connect to the server. If needed, indicate
server type, which can be VMS (voice mail system), OTA (over-the-air activation system), or other.
TON/NPI
Define format if necessary.
Advance Parameters
Modem activity can be restricted to selected billing plans. Tick this checkbox “Associate modem with selected billing
plans” and choose plans moving them from the left to the right. If the flag is not set, the modem will be available to all
billing plans without exceptions.
51
Note.
To delete a modem, open its settings and press “Delete” on the bottom of the dialog.
52
Trash
The Trash preserves objects deleted from the system and allows restoring them if needed.
On the list, you can observe object's name, type, and date and time of deletion. Object types are the following:
avl_unit — unit;
storage_user — user;
avl_resource — resource;
avl_unit_group — unit group;
avl_retranslator –– retranslator;
avl_route — route.
Found object can be restored or deleted from the system completely. To restore/delete multiple objects at once, select
them with mouse click and then press “Restore all” or “Delete all” in the header.
53
System Table of Contents
System
Updates
On this page, you can start/stop Wialon manually, install updates, adjust mail server, and set Mail System
Here you can also indicate your e-mail (“Administrator's e-mail”) which will be used for the following:
Updates
Updates can come from two sources: either you have purchased something on the License page or Gurtam has
published a new release for Wialon Local.
You can choose to install updates manually or automatically. If you enable the option “Auto install updates”, the
system will automatically detect availability of updates and install them immediately. If the option is disabled, you will
be informed about updates in the Log, and a corresponding phrase (like “3 updates available” instead of “Everything is
up to date”) will appear near the checkbox. To install updates manually, press the link “Install now”.
No matter how you install updates, manually or automatically, Wialon will be restarted. This will cause restarting of
sites, modems, etc., and all active sessions will be forcibly finished.
Upon the arising of any failures connected with modules, you can change the situation by reinstalling them. To do so,
click on the button ‘Update all’ situated on the tab ‘System’ and then install the uploaded update.
Mail System
For correct operation of the system, SMTP server is needed. It is used for sending mail (either to administrator about
Wialon operation or to end users with reports and notifications).
54
Set SMTP server address first. It may prove to be enough if you have your own SMTP server. However, if you use an
external server for sending mail (like gmail.com, for example), you will need authorization. In this case, you enter your
login and password you obtained in that mail system below.
When finished, press “Save”. To check if the mailing system is configured properly, you can press “Verify”. A test
message will be sent to the administrator's e-mail. You can also see results of this check in the Log below.
Limitations
Adjust these limitations to ensure stable operation of the server and prevent it from overloading.
55
Backup Server Table of Contents
Backup Server
Installation
This module is the subject for an additional licensing and may be not included to your Recovery from Failure
package.
'Hot Backup' installation software is installed to provide online data backup. This installation software is recommended
to install and activate on the server different from the one where your operating Wialon Local is launched.
Hot backup server provides real time full replication of Wialon Local database ('storage' directory). There is a possibility
of simultaneous usage of several hot backup servers.
Installation
Requirements:
Reserve server needs to be installed on the 64 bit Linux operating system. The key requirement is a HDD capacity. It
should be no less the HDD of the principal server.
Installation process:
download archive
unpack the archive in the working directory
to activate hot backup system it is necessary to set the variable in the configuration file (custom/config.txt):
ADF_STORAGE_SYNC_SERVER = interface:port:access_key
In case of Wialon Local server failure you should start using reserve server database copy. The following steps should
be followed:
56
Changelog Table of Contents
Changelog
January 14, 2015
This is a list of updates released for Wialon Local in 2015. January 9, 2015
January 9, 2015
57
Management System
The management of GPS tracking system Wialon Local is fulfilled through a special interface — CMS Manager. It is
specially designed for Wialon Local managers. CMS Manager allows you to manage your tracking service by means of
system macro objects, which are accounts (resources), users, units, billing plans, retranslators, and others.
Access Rights
CMS Interface
Accounts
Billing Plans
Users
Units
Unit Groups
Retranslators
Import and Export
Conversion
Apps
58
Access Rights Table of Contents
Access Rights
Types of Rights
Access Control List, or ACL. Hierarchy
Access rights refer to the possibility to see certain system objects and carry out permitted actions over them. In the first
place, access rights are applied to the system macro objects such as accounts (resources), units, users, units groups,
and retranslators. See more...
Access rights are defined primarily by service manager of the management interface – CMS Manager. However, in
some cases it can be done by end users. Rightholders can be any users of the system including managers and end
users of any level.
Rights are assigned to each user individually when creating or editing this user, on the Access tab. Alternatively,
access rights can be rearranged through dialogs of other macro objects, on their Access tab.
Types of Rights
The set of standard rights ('Item ACL') that are applicable to any type of macro object is as follows:
Besides, special rights can be applied to each object type – a list of permitted/prohibited actions that make sense for
those particular types of objects. For example, unit ACL includes a special right to create, edit and delete service
intervals, user ACL includes a right to act as given user, resource ACL includes the right to create, edit, and delete
geofences, etc. See more information about special rights for each type of object in the following sections:
Unit ACL
Unit Group ACL
User ACL
Resource ACL
Route ACL
On the Access tab of every item, all rights are divided into two sections. The upper part displays standard rights, and it
is the same for any object. The contents of the lower part depend on item type as it represents special rights.
Hierarchy
The user-creator has all the rights on created item, and they can be limited only by the user of a higher
level.
It is impossible to give a user more rights on an item, than the creator of this user has towards this item.
59
If a user is allowed to define rights for other users, no more rights than this user has can be given.
60
Standard Rights (Item ACL)
There are 14 standard rights, i.e., rights that every macro object has.
Type of
Code Description
right
Allows seeing the item in different lists and panels. The 'General' tab (at least, name, creator,
and resource or account) is available in item properties dialog. However, no property can be
View item
changed without additional rights. This right is basic, no other rights have any sense without it.
and its
0х1 This access right is often referred to as 'minimum access' or 'view right'.
basic
Units: to see counters, sensors, some advanced properties (color schemes for sensors and
properties
tracks), drivers, current location on map, to control unit groups.
User: the 'General' tab with all its contents and the 'Advanced' tab (e-mail).
View
Allows viewing more properties of the item in question. It works only for units – i.e., the user can
detailed
0х2 see but not edit the tabs 'Trip Detection' and 'Fuel Consumption', and the parameters for the
item
reports and messages filtration settings are shown on the 'Advanced' tab.
properties
Allows transferring rights on this item to other users, i.e., the 'Access' tab becomes available in
Manage
the item properties where user can establish which actions are allowed to other users in relation
access to 0х4
to this item.
the item
User: this user can be assigned to the rights of settings by other users.
Delete item 0х8 Allows deleting the item from the system.
Rename
0х10 Allows renaming the item.
item
View The 'Custom Fields' tab becomes available for viewing in the item properties. So far as only
custom 0х20 units, groups, and users have such a tab, this right and the next right do not affect other types of
fields objects.
Manage
Allows user to create, delete, and change custom fields in unit/group/user properties. This right is
custom 0х40
valid only together with the previous one.
fields
View
Allows user to view custom fields with limited access (admin fields) on the 'Custom Fields' tab of
admin 0×1000
unit/group/user properties.
fields
Manage
admin 0×2000 Allows user to create, delete, and edit admin fields.
fields
Edit not
Allows editing some advanced item properties. This right is applicable only to units – i.e., gives
mentioned 0х80
the opportunity to edit color schemes for track/sensor on the 'Advanced' tab.
properties
Change Allows changing item's icon. It is valid only for units and unit groups, because other items do not
0х100
icon have such feature as an icon.
You can query messages and create reports for given item.
Query
Units: it allows user to view messages for the selected interval, query reports, and build tracks.
reports or 0х200
User: control user's activity through reports and the Logs tab of User Properties dialog.
messages
Resource: it allows using the “Statistics” tab (history of payments).
Edit ACL
propagated 0х400 Only for unit groups.
items
Manage
0х800 Allows seeing item log in reports (or messages).
log
If a user has rights to see a unit's creator and account, its groups, assigned driver, etc., these rights can be fully
61
sensible only if this user has also at least view access to those items (user-creator, account, group, driver).
See also:
Unit ACL
Unit Group ACL
User ACL
Resource ACL
Route ACL
62
Unit ACL
A user can obtain abilities to see unit on map, track its state (speed, sensor values, etc.), change its properties,
executed commands, generate reports about its activity, use unit in jobs and notifications, etc.
Standard access rights have been described above. Below is the list of special rights which can be applied specifically
for units:
Unit ACL
Allows user to see and edit device type, unique ID, phone number(s), device access password on the
Edit
'General' tab, and messages filtration parameters on the 'Advanced' tab. Device type, phone(s), and
connectivity
UID appear also in unit's tooltip and in extended unit information. If SMS service is activated, then the
settings
user can also send SMS messages to this unit.
Create, edit, Sensors and their values are available without any particular rights, however, this access flag allows to
and delete edit and delete them as well as create new. Besides, calculation tables of created sensors become
sensors available for editing.
Allows changing values of the counters (GPRS traffic, mileage, engine hours) and methods of their
Edit counters
operation.
Allows deleting data messages and messages about sent commands in the Messages panel. It also
Delete
allows deleting records from the log (if the 'Manage log' flag is enabled). Works only in combination
messages
with 'Query messages or reports'.
Execute
Allows executing commands over the unit (for example, sending them from the Monitoring panel).
commands
Allows user to register such events as fuel fillings, maintenance work, custom event, and unit status. A
Manage
special registrar in the Monitoring panel is used for that. Having this flag activated user can also delete
events
registered events. If the flag 'Manage log' is enabled, user can also add a record to a unit log.
View service Allows viewing the 'Service Intervals' tab in unit properties dialog as well as viewing maintenance
intervals state in unit's tooltip and in extended unit information.
Create, edit,
and delete Allows user to edit and delete service intervals as well as create new. Works only in combination with
service the previous flag.
intervals
Import Allows importing messages to a unit database. Works only in combination with 'Query messages or
messages reports'.
Export Allows exporting messages from this unit to a file. Works only in combination with 'Query messages or
messages reports'.
View
Enables the 'Commands' tab in unit properties.
commands
Create, edit,
Allows to create, edit, and delete command on that tab. Works only in combination with the previous
and delete
flag.
commands
Edit trip
detector and Allows editing the corresponding tabs in unit properties. Works only in combination with 'View detailed
fuel item properties'.
consumption
Use unit in
jobs,
notifications, Allows user to create jobs and notifications for this unit, assign it to routes, and use it in retranslation.
routes,
retranslators
63
View item and its basic properties
The following information is available in unit properties dialog: on the 'General' tab – name, creator, account, counters;
on the 'Advanced' tab – color schemes for sensors and tracks; on the 'Sensors' tab – list of sensors; on the 'Unit
Groups' tab – list of groups where unit belongs (if those groups are accessible). Information about unit's current state
can be seen in its tooltip and in extended unit information: last message time, current location, speed, altitude,
satellites, values of counters, sensors, and parameters as well as presence in geofences and assigned driver. Unit can
be displayed in different lists and panels, watched on the map in real time (although tracks cannot be built), its
performance on routes can be observed (although assigning it to a round is prohibited). This flag also allows controlling
unit groups, i.e., add/remove unit to/from groups which can be done through unit group properties dialog.
Manage log
Allows to query unit log through messages or reports (if the flag 'Query messages or reports' is enabled) and make
custom records in the log (if the flag 'Manage events' is enabled).
Other standard access rights ('Manage access to this item', 'Delete item', 'Rename item', 'View custom fields', 'Manage
custom fields', 'View admin fields', 'Manage admin fields', 'Change icon') work as has been described above. The flag
'Edit ACL propagated items' does not affect units at all.
64
Unit Group ACL
The set of rights for unit groups is the same as for individual units. Access given to a group is applied for units that
belong to it. For example, if the right to view commands is given to a user, then the user will be able to see commands
of each unit in the group. Besides, some access rights can affect not only units in a group but a group itself. For
example, if the right to change icon is given to a user, then this user will be able to change both the icon of any unit in
the group and the icon of the group itself. Here is the list of rights with dual action:
The flag Edit ACL propagated items is the right that allows adding and removing units to/from the group.
The rest of access rights affect only units. See Unit ACL for details.
65
User ACL Table of Contents
User ACL
Standard Rights
Users can receive rights on any system objects including other users. Put it differently, user can Special Rights
be both a subject and an object of ACL relations. If User A has access to user B, then User A
can see User B in the system, view and edit its properties and individual settings, control its activity in the system, etc.
Standard Rights
Standard flags Delete item, Rename item, View custom fields, Edit custom fields, View admin fields, Manage
admin fields, Manage item log work for users as described above.
Access rights such as 'View detailed item properties', 'Change icon', and 'Edit ACL propagated items' do not affect
users at all.
Special Rights
User ACL
Manage
In the User Properties dialog, the 'Access' tab becomes available where the user can be given rights to
user's
various system objects. Besides, user's rights can be changed automatically – through appropriate jobs
access
and notifications.
rights
Act as given
Right to log in to the system as given user, make this user creator of system objects, etc.
user
Change
Allows changing properties on the 'General' tab of the User Properties dialog. However, changing
flags for
password requires also the previous right.
given user
66
Resource ACL Table of Contents
Resource ACL
Standard Rights
Access to a resource means access to its contents such as POIs, geofences, jobs, Special Rights
notifications, drivers, report templates, etc. User can have either just view access to those items
or edit privileges. Manipulations with those items are possible in the main interface of Wialon Local.
If a resource is actually an account (which means that it has its billing plan activated), then more access rights can be
applied, like add payments, define permitted service and their cost, etc. Such manipulations are possible only in CMS
Manager.
Standard Rights
Delete item
Allows deleting resource with all its contents. However, to delete an account, you should additionally have
the flag 'Manage account'.
Standard access rights Manage access to this item, Rename item, Manage item log work for resources/accounts
as described above.
Such flags as 'View custom fields', 'Manage custom fields', 'View admin fields', 'Manage admin fields', 'Edit not
mentioned properties', 'Change icon', and 'Edit ACL propagated items' do not affect resources or accounts at all.
Special Rights
Resource ACL
View POIs Allows to view POIs belonging to this resource.
Create, edit,
and delete Allows to edit and delete POIs belonging to this resource as well as create new.
POIs
View
Allows to view geofences belonging to this resource.
geofences
Create, edit,
and delete Allows to edit and delete geofences belonging to this resource as well as create new.
67
geofences
View jobs Allows to view jobs belonging to this resource.
Create, edit,
and delete Allows to edit and delete jobs belonging to this resource as well as create new.
jobs
View
Allows to view notifications belonging to this resource.
notifications
Create, edit,
and delete Allows to edit and delete notifications belonging to this resource as well as create new.
notifications
View drivers Allows to view drivers belonging to this resource.
Create, edit,
and delete Allows to edit and delete drivers belonging to this resource as well as create new.
drivers
View driver
Allows to view driver groups belonging to this resource.
groups
Create, edit,
and delete
Allows to edit and delete driver groups belonging to this resource as well as create new ones.
driver
groups
View
drivers-
Allows to view the list of units attached to this resource of drivers and intended for automatic binding
units
(the Units button in the Drivers panel).
association
list
Edit drivers-
units
Allows to create and edit this list from available units.
association
list
View trailers Allows to view trailers belonging to this resource.
Create, edit,
and delete Allows to edit and delete trailers belonging to this resource as well as create new.
trailers
View trailer
Allows to view trailer groups belonging to this resource.
groups
Create, edit,
and delete
Allows to edit and delete trailer groups belonging to this resource as well as create new ones.
trailer
groups
View
trailers-
Allows to view the list of units attached to this resource of trailers and intended for automatic binding
units
(the Units button in the Trailers panel).
association
list
Edit trailers-
units
Allows to create and edit this list from available units.
association
list
View report
Allows to view report templates belonging to this resource.
templates
Create, edit,
and delete
Allows to edit and delete report templates belonging to this resource as well as create new.
report
templates
68
For accounts only. Combined with the flag 'Delete item', allows to delete an account from the system
Manage completely, including resource with its contents, account's creator and all objects created by this user.
account In combination with the flag 'View detailed item properties', gives possibility to control payment and
days (the 'Payment' tab), number and cost of services (the 'Features' tab).
Note.
In the main Wialon interface, only manipulations with inner resource contents is possible (i.e., geofences, notifications,
report templates, drivers, etc.), including the possibility to see the log of changes concerning this contents. Actions
concerning accounts (such as payment control, tariffing, etc.) can be performed only in CMS Manager.
69
Route ACL
Route access rights could be the following:
Delete item
Allows deleting a route.
Rename item
Allows renaming a route.
70
Creator
Creator is a user that initially has full access rights to an object being created and can define access rights for other
users. The creator of a user also automatically gets manage rights to units created by this user. Afterwards creator's
rights can be dimensioned if needed.
Building hierarchy with the help of creator allows to divide the whole work among several users, assign different rights
to objects, as well as reduce information content processed on the screen.
In the system, there can be no objects without creator. The creator is assigned when creating an object and cannot be
changed later. Usually (when a user, a unit or a unit group is created) the creator is selected from the list of existent
users. However, when a new account is created, its creator can be created with it simultaneously.
It is impossible to delete a user that is the creator of some object. You first should delete this object. For usual users it
is done manually. What concerns an account creator, it can be deleted only deleting this account.
To establish access rights it is necessary to have the flag Manage access to this item both for the user who is
supposed to obtain rights and the object to which the access is given.
71
Access Dialog Table of Contents
Access Dialog
Templates of Access Rights
To manage access to system objects, you are required to have the flag Manage access to
this item toward these objects and the flag Manage user's access rights toward users to give them rights.
To establish access to an object, go to its properties dialog and open the Access tab. This tab is displayed only if you
have the right 'Manage access to this item'.
On the left, you will see the list of users (only those on which you have the right 'Manage user's access rights'). Users
already having some access to the item are highlighted with colored background and displayed on the upper part of the
list. To quickly find a user, enter user's name or its part into the filter above.
Another way to facilitate your work with a list is to use sorting. You can sort the items in the list either in alphabetic or
access right order. To do so click on the corresponding button to the right of the dynamic filter. The button shows the
variant of sorting different from the used one.
— access rights sorting to be used.
— alphabetic sorting to be used.
Note.
If the number of items exceeds 1000, then the default setting for sorting is alphabetical.
On the right, you see the list of access flags. When you switch users on the left, checkboxes on the right change
depending on access that is provided to the selected user.
Rights are divided into two sections — standard (see Item ACL) and special (lower part). Special rights differ according
to item type:
Unit ACL
User ACL
Unit Group ACL
Resource ACL
Route ACL
To set rights, select a user on the left and assign access flags or a template on the right.
Several users can be selected at once — use <shift> or <ctrl> keys for that.
72
If you are trying to set a flag which does not work without another flag, that another flag will be marked
automatically. For example, if you mark the flag 'Manage custom fields', the flag 'View custom fields' will be
added to it, because it is impossible to edit something you cannot even see.
The same is with removing flags. It is impossible to remove a flag while there are other flags depending on
it. Those subordinate flags must be removed first.
To place or remove all flags in one section at once, hold on the <ctrl> key and click on any flag.
If you are trying to assign a right you do not have yourself, it will be reset upon saving action.
Templates facilitate the assigning of access rights. Different sets of rights could be created for different roles, for
example, operator, manager, customer, etc. Moreover, personal templates can be made for any type of element (unit,
route, etc.). The created templates can be applied to the chosen user within one mouse click.
Templates section is situated in the dialog at the top of access rights list. You can edit or delete the templates
provided by default as well as create new ones. 'Edit Templates' button situated at the bottom of templates list
provides such an opportunity. Upon the clicking of this button the left part of the dialog and access rights list is shown
as disabled, and the buttons of working with templates appear.
To create a new template, click the 'Create' button. A new template appears in the templates list. Name it (double click
on the name field), and then put the necessary flags in the activated access rights list below. Click 'Save'.
A new template can be created by making a copy of an existing one. To do so, click on the corresponding button
which appears when you point on a template with mouse cursor. Make changes (edit name and flags), and then click
'Save'. Note, that you can not create templates with identical flags for the elements of the same type. Such copies will
be deleted.
To delete access rights template click on the corresponding button which appears when you point a mouse cursor
on a template.
Each template has its own color which is given to it upon creation. The color can not be changed. If a template is
applied to any user, then the user name will be highlighted in the corresponding color in the left part of the dialog.
Though there are some exceptions in color appliance. If there are no flags chosen in the template (for example the 'No
Access' template), then its color is not applied (users without access are not highlighted in the list). The users which
have an access different to all the templates are highlighted in yellow in the list. This color differs from all the other
colors of the templates. The same color is given to the users to which the template can not be completely applied
(when the 'distributing' user does not have the rights which he is going to pass to the others).
Attention!
Establishing access to users as system objects is a bit different from other objects (see user properties dialog).
Hint.
User's access to units can be changed not only manually but also automatically — through some types of jobs and
notifications.
73
CMS Interface
CMS interface is simple and in many cases intuitively intelligible. There is plenty of screen tips associated with various
buttons, icons, dialog boxes and other controls.
Top panel is situated at the top of the window. It shows your login, current time, and some buttons
(Logout, Settings, Import/Export, Converter, Apps, Help). Here, in the top panel, all warnings are shown.
Navigation and search panel is a panel at the left of the window. It contains five tabs — in accordance
with five object types: accounts, billing plans, users, units, unit groups, and retranslators.
Results panel is the largest, central part. Here you can manipulate system objects (create, edit, delete,
configure, assign rights, etc.).
Log is situated at the bottom of the window. Here you can view messages about succeeded actions or
occurred errors.
Sizes of all panels are customizable. To adjust the size of the results panel and the log in relation to each other, drag
the horizontal slider between them up or down. To adjust the width of the navigation panel, find a vertical slider and
drag it right or left.
74
Top Panel
In the top panel of CMS Manager you can find the following features:
Note.
More buttons are displayed for top users:
Conversion — enables to transfer some obects from one metric system to another;
the button in the shape of a wrench to manage Apps.
Information notices from service administrator can appear in the top panel as well as notices on the amount of days left
before blocking the monitoring system (if stipulated by the tariff agreement).
75
Navigation and Search Table of Contents
Navigation and Search
Navigation
Navigation and search panel is situated on the left of the window. Here you form a query for Search
Navigation
There are five tabs in the navigation panel. Each of them represents some system object: Accounts, Billing Plans,
Users, Units, Unit Groups, Retranslators. To move to a tab, just click on its name.
Each tab consists of two sections: Actions and Search. The Actions section
contains a button to create a new object of the selected type. The detailed
instructions for creating and configuring objects are given in the further topics
of this guide.
The Search section is used to find already created objects and display them
in the results panel where you can manage objects, view and edit their
properties.
Search
To search objects:
1. Specify a filter;
2. Form a request in the Text field;
3. Push the Search button or <enter>;
4. Observe the found objects in the results panel on the right.
Note.
To simply find all objects of some kind (for example, all users), leave the Text field empty (or with just a single
asterisk) and press <enter>.
Search Filter
In the Filter combo box select the search criteria. It can be:
If you are searching for units, some additional filters are available along with these ones:
Unique ID: unique identification number given to a unit when creating it;
Phone number: the phone number of a SIM card embedded to equipment (or two);
Device type: equipment type/name;
Unit group: a group where a unit is included;
Custom fields: custom fields configured in unit properties;
Admin fields: administrative fields configured in unit properties.
Retranslators can be filtered according to protocol, and billing plans — only by name.
If any of these properties is not available to you according to your access rights, searching by this criteria will be
unsuccessful.
Search Text
76
Formulate you request in the Text field. Use any characters allowed and the asterisk sign (*). The asterisk is a
wildcard sign that represents any combination of characters. The asterisk can be placed at the beginning, at the
middle or at the end of the request text. It can be used even several times. For example, to find all MANs, select
search by name, type man in the Text field, and push the Find button (or <enter>). All units which names contain
this combination of characters (both at the beginning and at the end of the name) will be found and displayed.
Another wildcard character that can be used is the question sign (?). It replaces any single character. As well as the
asterisk sign, it can be put at any place of the query. More about filters and masks...
77
Results Panel Table of Contents
Results Panel
Managing Tables
The results panel is located at the right top part of the window. Here the results of search are Standard Operations
The caption on the tab displays item type: users, units, accounts, retranslators, or unit groups. Besides, when switching
tabs, if they represent different item types, the navigation and search panel changes, too.
Your actions (such as search) are always applied to an active tab. If this tab already contains any records, they will be
replaced.
Managing Tables
The data is given in the form of a table. Records are sorted by name in the direct order that is from A to Z.
For different type of objects, table contents are also different. The most columns are provided for units.
The set of columns is adjustable. To customize it, click on the table header and check needed items (or vice versa,
unselect some items to hide them).
At the bottom of the table, there is tools panel that is useful to perform several tasks such as delete objects, move to
another page, etc.
Columns width can be adjusted manually. To do this, click on a column edge and holding the left mouse button drag it
in the needed direction. To restore auto width, push Columns auto width button.
Adjust the number of rows to be displayed on one page (10, 50, 100, 500, 1000 are available).
To navigate between pages, use the corresponding arrow-shaped buttons. It is also possible to enter page number
manually and press <enter> to move to an indicated page.
Standard Operations
A number of standard actions can be performed over any object displayed in the table (account, user, unit, unit group
or retranslator): create a new object of this kind, view or edit objects' properties, copy or delete an object.
78
disabled if the current user does not have enough rights.
Fill in necessary fields and tabs of the dialog and press OK. OK button remains disabled until information in the
dialog is enough and correct. For example, it is impossible to create an item with no name or with name shorter
than 4 characters. Do not use any prohibited symbols in text fields of the dialog. Read Input Rules for details.
A newly created object will not be displayed in the table until you apply some search parameters.
Copying
Copying is a quick way to create new objects having similar properties with existent objects.
To make a copy of an object, hold the <ctrl> key and click on the needed object in the table. A properties dialog with
information identical to the properties of the object being copied will open (at least, those properties which can be
shown according to your access level). You can alter any properties if needed (especially unique information like
name, phone number, etc.). Press OK to complete creation.
Hint:
In many situations, instead of copying you can use Import/Export tool.
Note.
The operation of copying cannot be applied to accounts (resources) and billing plans.
If you have made any changes and want to save them, press OK. To quit dialog without saving changes, press
Cancel or click on a small cross sign in the right-hand corner of the dialog.
Deleting Items
To delete an item, check it in the Delete column. Then push the button Delete checked items at the bottom of
the table. When getting a warning message, confirm your intentions or cancel the action. Several items can be
selected, too. The result of the action is displayed in the log.
Remember that a certain right is needed to delete items ('Delete items'). Items that are not allowed to be deleted
cannot be checked.
Deletion of a unit group or retranslator does not result in deletion of units that are included in them.
To delete a user, use the red delete button that is displayed against each user in the table. However,
only users who are not creators for any system objects can be actually deleted. See more...
An account can be deleted only with all its contents and depending objects, that is why deleting
accounts is different from deleting other system objects. See more...
79
Log
The log is situated at the bottom of the window. It contains records of current events and operations running in the
system.
The structure of a record is simple: date, time, text (description of the event).
The log uses fonts of different colors in order to separate different type of entries from each other. Black color is for
information messages, for example, about the number of tabs allowed to create. Green color is used for preventive
messages, for example, when a new object is created or successfully deleted, or its configuration is changed. Red
records mean error messages.
You can clean up the log using the appropriate button that is in the right top corner of the log panel.
80
CMS Settings
To view and change CMS settings, click on the Settings button on the top panel. Here you can customize some
parameters.
1. General Settings – there you can indicate your time zone, e-mail, change password, etc.
2. Account – there you can see your current balance and days left, services used and left, transactions
made, etc.
The User Settings dialog in CMS Manager is a reduced version of the User Settings dialog in the main interface.
81
Accounts
In most cases, resource and account can be used as synonymic notions, however, sometimes it is needed to
understand the difference between them.
Resource is a system macro object which includes different micro objects as its contents, which are POIs, geofences,
jobs, notifications, drivers, trailers, and report templates. Availability of a resource gives user opportunity to create such
objects. These contents can be easily saved to a file or copied to another resource (see Import and Export).
A resource becomes an account or rather a part of an account in case a separate тарифный план was activated while
creating this resource. In most cases the names of an account, associated resource, and their creator is the same
name.
More than one resource (or even dependent account) can be connected to an account. The point is that an account
can hold not only a resource and its contents (micro objects mentioned above) but also information about other macro
objects as units, users, unit groups, routes as well as other dependent resources and accounts.
The count of both macro and micro objects is done in the account and money is written off for their use. A billing plan
is applied to an account and not to a user. Therefore, Wialon Local manager uses account to limit users' activity, define
number and cost of available services, control payment, etc.
Creator is a crucial part of an account. Micro objects are classified to an account by their resource, but macro objects
reveal their belonging to an account through their creator. All macro objects created by the same user who is a creator
of an account (or by other users whose creator is this user) are automatically attached to this account.
An account is usually created for each client individually, however, a number of users can exist within one account and
have different rights and access to units. For instance, we can create an account Vehicle Fleet 666 with users Boss,
Accountant, Machinist, Manager, etc., and each of these users will use Wialon in their own way.
All dependent macro and micro objects are deleted together with their account. More...
82
Working with Accounts
Working with accounts is possible only in the management interface that is CMS Manager. Open the Accounts panel in
the navigation panel. Here you can:
In the table of results, you see accounts'/resources' names, creators (if available), columns to see account's balance,
days left (see estimated blocking date in the tooltip), status (Active/Blocked), and buttons for deletion. Only accounts
(not resources) can hold information about status, balance and days. Besides, accounts and resources differ by the
way on deleting them. More...
Click on any account/resource in the table to see its properties. Depending on your access, certain tabs and fields of
the dialog can be hidden or unavailable for editing. The Account Properties dialog can contain up to 6 tabs (however,
resources can have only 2). By default, only the General tab is available. There you can change only
account's/resource's name and see its parent account and creator. On the Payment, Statistics, Features, and Account
tabs you can control payment, add days, define services availability, etc. (see Payment Control and Features for
details).
Besides, it is possible to store resource contents in a file or copy elements from one resource to another. See Import
and Export for details.
83
Creating Accounts
Accounts can be created and deleted only by service manager. To create a new account, press the Create Account
button. Fill in the given fields and press OK. If this button is not active, then you have no rights to create system
objects.
Account name
Give the account its unique name from 4 to 50 characters. In the system, there can be no accounts with the same
names.
Creator
As a creator of the account an existent user can be selected or a new user can be created together with the account.
New user: a new user will be created and assigned as account's creator. You have to give the new user
login and password. By default, it is offered to give the same login as the name of the account, but you can
enter a different name. Set measurement system for the user. The metric system uses kilometers and
liters, the U.S. system — miles and gallons.
Note.
When a resource is created, its measurement system is initially taken from its creator. However, it can be changed
afterwards through the conversion.
Note.
If you have no billing plans, separate billing cannot be used.
If all fields are filled in correctly, the OK button becomes active. Push the button to save the account. See the result in
the log.
As the result, a new account (or resource) is created or both account and user are created. Resource is created in
case if an account is created as an existent user and separate billing is not activated.
By default, the user indicated while creating the account is assigned to be its creator. However, manage access to the
account are given both to this user and the manager who created the account. If a user was created together with
account, this user receives manage access to account and edit access to user itself. The creator of such a user then is
the manager who has created it.
84
Payment Control Table of Contents
Payment Control
Payment
In the account properties dialog on the Payment and Statistics tabs, you can view account Statistics
Payment
Billing plan
To change billing plan, select one from the dropdown list of available plans.
Balance
In this field, you see the current balance of the account.
Blocked This flag shows whether the account is active or disabled at the moment. If a critical level of balance/days is
reached, the account is blocked automatically. When a payment is made for such a blocked account, you can remove
the Blocked flag manually to quickly return the account to life (although it would be done for you automatically anyway
but a little bit later). This flag can be also used to block the account manually, however, note that it will work correctly
only if the level of balance/days is zero or negative. The state of this flag can be changed without opening the Account
Properties dialog — straight from the list of accounts (see the last column).
Dealer rights
Activate this flag to create a subdealer. It means this account will possess the same rights as you (access to modules,
services, billing plans). Then choose billing plans that will be available to this account.
History period
You can set history period to store data (in days). It means that all messages older than this term will be automatically
removed from the database. The value of history period should not exceed the same value in the properties of the
billing plan assigned to this account. To restore the default value, enter '0'.
The next three options refer to restricting user's activity in case of nonpayment. Usually, these values are either zero
or negative. It is to give users possibility to use the tracking system for a while even when payment date is expired. If
these options are not activated here, in this dialog, they take over assigned billing plan or top account.
Block by balance
Enter balance reaching which the account will be blocked.
Limit by balance
85
Enter balance reaching which paid services will be denied.
Block by days
Enter days counter reaching which the account will be blocked. This will work independently of 'Block by balance'
option. If both of these parameters are adjusted, an account will be blocked when meeting either of set conditions. In
this case, the account can be blocked automatically not only when the balance is low, but also if there are no days left.
It can be useful for demo access, for example, or to control monthly fee. When the days counter embedded in the
system says that days left on an account have reached the value indicated in this field, the account is blocked
automatically.
Days left
If the previous option was activated and this state was successfully saved, the field 'Days left' appears at the next
opening of the dialog. It shows how many days have left before zero. At that, when 5 days are left, a special warning
starts to come each time when the user logs in to the system: “Your account will be disabled in .. days.” When days
are negative, another notification is displayed: “Attention! Your account will be blocked soon.”
Days are added in the same manner as payment. Indicate the needed number of days in 'Add days' field or choose
the final day in the calendar. Then enter description and press 'Register'. Days and money can be added
simultaneously in the same payment or separately from each other.
Note.
If you have not enough rights to view the Payment tab, then the current balance, days left, and billing plan can be
viewed (but not altered) on the Account tab.
Statistics
On the Statistics you can estimate services expenses for indicated period of time (payment history). Define time
interval and press Show. All registered payments will appear in the table regardless whether money or days were
added.
86
Features Table of Contents
Features
List of Services
The Features tab in account properties dialog allows to manage the number of available units, Limitations and Cost
SMS, geofences and other system objects, as well as enable or disable access to different Account
services (such as retranslator, Wialon Mobile, jobs, and many others) and define their costs.
On this tab, you see the list of services available according to chosen billing plan.
On the left you see service name, in the middle you indicate limitations and cost, on the right you see current state of
the service.
List of Services
Here is the full list of services available in Wialon system. Your Features tab may contain not all of them.
Service Description
ActiveX Remote access to the system via ActiveX.
The possibility to create admin fields in the properties of unit, user or group (on the Custom Fields tab);
Admin fields
defines cost and quantity (summarized, by objects of different types) of admin fields.
Advanced The possibility to generate reports on unit groups and use intervals filtration in reports. Works within
reports Reports service.
Activates the corresponding tab in the Unit Properties dialog; defines the quantity (all units in sum) and
Commands
cost of commands.
Create Activates the button to create resources and accounts on the corresponding panel (in CMS Manager
resources only).
Create unit
Activates the button to create unit groups on the corresponding panel.
groups
Create units Activates the button to create units on the corresponding panel.
Create users Activates the button to create users on the corresponding panel.
Custom Activates the corresponding tab in the properties of unit, user or group; defines cost and quantity
fields (summarized, by objects of different types) of custom fields; does not affect drivers and trailers.
Activates Drivers module and defines cost and quantity of drivers; if disabled, the Drivers panel is not
Drivers
shown, and any mention of drivers disappears from notifications, user settings, and SMS dialog.
Е-mail The possibility to send notifications by e-mail. Recommended limitation – 10 reports in an hour (not to
notifications overload the server).
87
Е-mail The possibility to send a report by e-mail (within the Jobs module). Recommended limitation – 10
reports reports in an hour (to avoid server overload).
Activates Geofences module and defines cost and quantity of geofences; if disabled, the Geofences
Geofences
panel is not shown, and any mention of geofences disappears from reports and user settings.
GPRS traffic The possibility to control GPRS traffic through jobs, notifications, reports, and unit properties.
Groups of
Defines quantity and cost of driver groups; works within Drivers module.
drivers
Groups of
Defines quantity and cost of trailers; works within Trailers module.
trailers
Jobs Activates the Jobs panel and defines cost and allowed quantity of jobs.
Defines cost and quantity of service intervals; if activated, the Service Intervals tab appears in the Unit
Maintenance Properties dialog, maintenance can be registered in the Monitoring panel, and corresponding
notifications and reports appear.
Management
Access to CMS Manager.
system
Messages Access to the Messages panel.
Notices to
Possibility to receive notices from the administrator of the service.
users
Notifications Activates the Notifications panel and defines cost and allowed quantity of notifications.
POIs Activates the POI panel and defines cost and allowed quantity of POIs.
Activates reports and defines cost and allowed quantity of report templates; if disabled, associated jobs
Reports
and notifications disappear and trip detector cannot be used.
Resources Activates the Accounts panel in CMS Manager; defines quantity and cost of resources and accounts.
Possibility to transmit messages from units to other servers and systems; activates the corresponding
Retranslators
panel in CMS Manager; defines allowed quantity and cost of retranslators.
Route
Defines the count of allowed rounds and their cost (within Routes module).
rounds
Route
Defines the count of allowed schedules and their cost (within Routes module).
schedules
Routes Activates Routes module – enables the Routes panel and associated reports and notifications.
SDK Remote access to the system via SDK and access to Apps.
Sensors Defines the count of sensors (calculated for all units in overall) and their cost.
Here you can allow/deny access to different sites within your system (like Wialon Mobile, extra sites,
Site access
etc).
SMS
Count and cost of SMS messages.
messages
Trailers Activates the Trailers panel and defines cost and quantity of trailers.
Unit groups Activates the corresponding panel and defines cost and quantity of unit groups.
Units Activates the corresponding panel and defines cost and quantity of units.
Users Activates the corresponding panel and defines cost and quantity of users.
Wialon
The possibility to track unit from a mobile device.
Mobile (2)
Note.
If you see 'Apps' in front of a service name, it means this service is an application.
In the central column, you define service state and enter limitations. Check services to make them available to this
account or unselect services to deny access to them. This flag has three states: on, off and default. If the state is on,
you can enter quantitative restriction manually, for example, allow only 10 geofences to be created for this account.
Besides, you can specify more sophisticated limitations different cost for different number of items. Cost line is set in
88
the format: COUNTER1:VALUE1;COUNTER2:VALUE2;VALUE3. A counter must be positive and integer (however,
values can be fractional). Each next counter must be greater than the previous one. -1 means that the service is
prohibited.
In the right column you see the current state of the service (enabled/disabled) and, if the state is default, the
description of default conditions is given in the brackets.
Note.
If you have not enough rights to view the Features tab, then available services can be viewed (but not altered) on the
Account tab.
Account
On the Account tab the chosen billing plan and account balance are indicated, and the list of available features is
presented. If a service is periodic (limited number of items in an interval), the interval is indicated. For example, 10
SMS messages in one day (daily). If the limit is 0, it means the service is unavailable. If you see a dash in the limit, it
means that no limitations are applied to this service.
Note.
The information presented on this tab is available to the end user in the User Settings dialog.
89
Deleting Accounts
To delete an account, you need to have manage access to it. In most cases, you may need to delete an account when
account service agreement is broken.
To delete an account, press delete contents and then confirm your intentions.
When deleting an account, all its contents (geofences, drivers, etc.) is deleted, too. Besides, all users, units, unit
groups, resources are deleted, too, if they are created as account's creator or other users which were created as
account's creator.
There can be resources among accounts. Resources are deleted by standard method.
90
Billing Plans Table of Contents
Billing Plans
Working with Billing Plans
Attention!
Only the root user can manage billing plans.
Billing plan defines the set of available services, their cost, and some basic properties such as minimum balance to
block an account, minimum balance to deny services, currency format, etc.
A billing plan assigned to an account defines initial set of allowed/denied services, which can be redefined later
(extended or narrowed) for each account individually. If you adjust services through a billing plan, you can apply
limitations and costs to several accounts at once (which are associated with this plan). If you adjust services in
accounts themselves, each account is to be edited separately.
In CMS Manager, open the Billing Plans tab in the navigation panel on the left of the window. Here you can view and
edit billing plans assigned to account in your system.
In the table of results, you can see the list of billing plans as well as some of their parameters, which are described in
detail below. Initially, one billing plan exists — “Wialon”.
Further information:
General Properties
Features
91
General Properties
On this tab you can configure general parameters of a billing plan. Some of them may be redefined in a particular
billing plan separately — on the Payment tab.
Name
Cannot be changed.
E-mail
E-mail address from which various system messages (notifications, reports, etc.) will be sent.
Parent plan
Choose a parent billing plan if necessary. If any parent plan is assigned, current plan will initially inherit its properties.
Although they can be changed for the child plan later, a child plan cannot have more features and possibilities than its
parent plan.
Block by balance
Enter balance reaching which the account will be blocked.
Limit by balance
Enter balance reaching which paid services will be denied.
Block by days
Works independently of 'Block by balance' option. If both of these parameters are adjusted, an account will be blocked
when meeting either of set conditions. When the days counter embedded in the system says that 'Days left' on an
account have reached the value indicated in this field, the account is blocked automatically. At that, when 5 days are
left, a special warning starts to come each time when the user logs in to the system: “Your account will be disabled in ..
days.”
Note.
Usually, three above-mentioned values are either zero or negative. It is to give users possibility to use the tracking
system for a while even when payment date is expired. Besides, all or some of these three options can be disabled at
all.
Currency format
Enter currency sign before or after '%.02f'.
92
The time period to store unit history. For example, if the value is '100', messages older than 100 days are automatically
deleted. This parameter can also be redefined for each account separately. If you set zero here, history period will be
unlimited.
Map tags
This field makes sense only if your service uses own WebGIS for cartography. Enter tags of maps that should be
available with this billing plan. Separate tags with commas. If the field is empty, it assumes that all default maps will be
available.
Description
Give a description (optional).
93
Features
This tab provides the list of all services possible for this billing plan, their state and cost.
In the 'State/Limit' column, you can enter allowed number of items of the king and their cost, or enable/disable a service
in general. These adjustments are made in the same way as in similar account settings.
Description will let you know what is the current state if the service. 'By default' means that no particular limitations are
applied to this service within this billing plan — that is limitations (if they exist) will be taken from the top account and
parent billing plan.
The 'Limit' column shows what maximum amount of items is possible for this service reasoning from the top account
settings.
In addition to usual services, billing plans can be used to give access to Apps and different sites (Monitoring, CMS
Manager, Mobile). By default, they are disabled.
Availability of a service, its cost and allowed number can be also set (redefined) for each account separately — on the
Payment tab.
Attention!
Disabling a feature in a billing plan does not mean that the same feature will be automatically disabled in an account
which is associated with this plan. If a feature is redefined (that is not default) in the account itself, the priority is given
to the account. The state of services is borrowed from the billing plan, if in account it says 'By default'.
94
Users Table of Contents
Users
Working with Users
User is a system macro object defined by its specific name (login) and password. Using these
login and password users can enter one of Wialon Local interfaces where they can control their units (end users) or
manage the system itself (users-managers).
A user has access rights to interact with other system objects (units, other users, resources, etc.). These rights are
assigned by a system manager. Besides, a user can be a creator of these objects, which also affects right hierarchy.
Manager's duty is to properly build this hierarchy.
Users as system objects also have some specific applications in Wialon Local main interface that is described below
(send SMS, control user activity, etc.).
Working with users is possible both in CMS Manager and in the main interface. In CMS Manager, open the Users tab
in the navigation panel on the left of the window.
There is a button to create a new user, a filter to search existent users, and a button (optional) to send informational
notices to your users.
In the table of results, you can see user's name, creator, buttons to delete users and login as them. Availability of
buttons and information depends on your access rights.
Standard operations described below (such as create, view, edit, copy) can be applied to users in the same way as to
other system objects. However, the following particularities should be taken into consideration:
A user can be created not only independently but also together with an account or resource.
Users cannot be as easily deleted as other system objects. Actually, only users who are not creators of
any other system objects can be deleted. To delete a user, press the red delete button against their name
and confirm your intentions (a dash is displayed instead of the button if you have no rights for deletion). If
you are trying to delete a user who is a creator of any items in the system, you will get a alert which cites
all those objects, and they should be deleted prior to their creator. Nevertheless, automatic deletion of all
subordinated items together with their creator is still possible – through deleting an account they belong
to.
Straightaway form the table, you can login to the system as another user (access flag 'Act as given user' is required).
To do this, use buttons in the right column of the table. If connected as different user, both user names are displayed
on the top panel. To return to the main user, click on their name in the top panel (before brackets, in bold).
95
User Properties Table of Contents
User Properties
General
User properties are configured when creating, editing or copying a user. The properties are Access
divided into several tabs. Availability of different tabs and parameters depends on access you Advanced
Custom Fields
have to the user. Two tabs are available in any case — General and Advanced. Furthermore, Logs
some properties become uneditable when the account of this user is blocked.
General
Here the basic properties like name, password, allowed activity, etc. are set. They are defined while creating a user
and can be altered only if you have manage access to this user.
Name
User name (login) from 4 characters.
Password
Password is optional but recommended. When you set a password, you are asked to input it twice — second time is
for confirmation.
These login and password will be used by this user to enter the system.
Host mask
Host mask can be applied to user to restrict IP addresses from which to enter service sites. For example, to allow user
to login to sites from office only. To set a mask, use the wildcard character *, for example, host mask can be set like
this: '212.0.13.*'. If no mask is set, the user can login from any computer.
Creator
Select creator from the dropdown list. User's creator can be any other user. Creator is important to build hierarchy of
access rights. A user inherits account and billing plan from the creator.
Account
Here you can see to which account the user belongs (if you have any access to this account). Account and creator
cannot be changed.
Measurement system
This parameter is shown only when creating a new user. For existing users, it can be changed either through the
converter or by themselves in their own settings.
Enabled
If disabled, user cannot login to any interface of the system.
96
If disabled, user cannot change their password used for login action.
To edit most of these properties, you should have the access Change flags for given user. Changing password
requires also the right Act as given user.
Access
Here you give user access rights to objects existing in the system: units, resources (accounts), unit groups, routes,
and other users.
On the left, you select objects. To quickly find a needed object, user filters — choose object type in the dropdown list
and set a name mask below. Objects that meet your request will be displayed in the list. Also, to facilitate a search the
list can be sorted alphabetically or by access rights. To use the sorting you should click the corresponding button to
the right of the dynamic filter.
Colored background highlights objects to which the edited/created user already has any access.
Select an object on the left and mark actions allowed to the user on the right. More about access rights...
Note that this tab allows you to set access rights for a user to different system objects. However, user as such is a
system object, too, and therefore can be accessed by other users. In other words, other users can obtain access rights
toward this user. To set access to a user as system object, open the properties dialog of some other user and choose
Users in the dropdown filter.
Advanced
On this tab, you can enter e-mail address that will be used to send notifications to this user from the service
administration.
These settings can be changed by users themselves — in their User Settings dialog.
97
To edit those properties, the access flag Edit not mentioned properties is required.
Custom Fields
Access required: View custom fields – to view general custom fields; Manage custom fields – to create, edit, and
delete general custom fields for given unit; View admin fields – administrative custom fields; Manage admin fields – to
create, edit, and delete administrative fields.
Any kind of information can be added to a user with the help of custom fields. This can be private phone, home
address, post, experience, working shift, and so on. Administrative fields (seen only to users with special access
rights) are marked in the first column.
On the left enter field name, and on the right field value. Then press the Add button. When finished, press OK.
Next time you open the dialog custom fields will be automatically alphabetized.
Logs
Here you can view all users' logins/logounts to/from different system interfaces for an indicated period. Specify the
period and push Show.
Note.
Besides the log, user's activity can be controlled through different reports that are available in Wialon Local user
interface. More...
98
Notices to Users
You can send an informing notice to users of the system. To do this, press the button Send a Notice in the Users
panel. This will summon a dialog where you input a subject for your message, add text of any length, choose users to
send the notice to and decide upon life span of your message. When finished, press OK.
To send such notices to users, you are required to have the access 'Edit not mentioned properties' to those users.
Besides, their accounts should be active (not blocked) and they should have the service 'Notices to users' activated in
their billing plans. Otherwise, those users are not shown in the list of supposed recipients. To quickly find necessary
users on the list, use the dynamic filter above the list; users can be searched either by name or by custom fields.
Notices are shown in the top panel when the user logs in (see an example). Expiration period (from 1 hour to 30 days)
defines the period during which the notice will appear on the screen each time the user logs in to the system until the
user closes the notice.
99
Units Table of Contents
Units
Unit Properties Dialog
Unit is a system macro object defined by its specific device type and unique identification
number (UID). It represents a vehicle, machine, person, pat or any other mobile or stationary object that can be
controlled with the help of a GPS tracking system.
Working with units is possible both in CMS Manager and in the main Wialon Local interface. To work with units in CMS
Manager, open the Units tab in the navigation panel. Units configured here become available for tracking (watch on the
map, control different parameters, etc.).
Here you can create a new unit, observe existent units, view or edit their properties, define access rights to units, and
remove units from the system. Read Standard operations for details.
Unit properties dialog is displayed when you create, edit or copy a unit. It contains many tabs and fields that define
different unit parameters and how the program will interpret data received from this unit.
The number of tabs can vary depending on your access rights and purchased modules (max — 11).
Use the following links to get to know the details about each parameter:
Sensors
Sensor Properties
Sensor Types
Sensor Parameter
Validation of Sensors
Calculation Table
Calculation Table Wizard
Custom Intervals
Signed Parameters Converting
Temperature Coefficient
General Properties
Counters
Access to Unit
Icon
100
Advanced Properties
Custom Fields
Unit Groups
Commands
Trip Detection
Fuel Consumption
Service Intervals
101
Sensors
On the Sensors tab of Unit Properties dialog, sensors connected to equipment are added and configured as well as
edited and removed.
On the list of available sensors you see sensor name, type, metrics, parameter, and custom description.
To create a new sensor, push the New button, fill in the fields and press OK. If you use similar devices for different
units, it is convenient to configure sensors once, and then import them to other units.
To quickly create a sensor with similar settings, select this sensor and press Copy. To edit an existing sensor or just
view its settings, select this sensor and press Properties. To delete a sensor, select this sensor and press Delete.
To make any alterations on this tab, you need access right Create, edit, and delete sensors. Otherwise, you can only
observe existing sensors and their settings.
There is the Visible checkbox against each sensor. It controls whether sensor is shown or hidden. By default, the
checkbox is enabled or disabled depending on sensor type. However, you may want to hide or show some particular
sensors. Hiding is reasonable especially if a sensor is used as a validator and does not have its proper meaning.
If a sensor is visible, then the Time flag may become available for it. Activation of this flag affects how the sensor
appears in additional information (unit's tooltip, etc.). If the Time flag is enabled, duration of the last state is shown in
brackets, for example: Ignition: On (47 minutes 33 seconds ago).
Attention! Some limitations are applied to this feature. The sensor should have no calculation table, validators,
custom intervals, nor contain references to other sensors in its parameter. In these cases, the Time checkbox will be
unavailable.
Sensors' order on the list can be changed manually. To place sensors in a desirable order, just drag them up and down
holding on the arrow-shaped icon on the left. Sensors' order and visibility is considered in unit's tooltip, extended unit
information, track player, track hittest, and in the Messages panel. Only visible sensors are shown and they follow in
the order as given here, in unit properties dialog.
102
Sensor Properties Table of Contents
Sensor Properties
Additional Properties
When creating, editing or copying a sensor, an additional dialog with sensor properties is
displayed. It consist of several tabs. On the first one, the basic properties are adjusted:
Name
Give a name to the sensor. It must consist of one or more characters. The name will be visible in unit's tooltip, in
reports and messages.
Sensor type
Choose the sensor type to form the dropdown list of available types (the list depends on modules purchased).
U.S. measurement
Tick the checkbox if American units of measurement should be used to indicate a sensor value. The caption and the
checkbox are displayed only for the sensors which units of measurement differ in metric and American measurement
systems.
Metrics
Metrics is presented in reports (also in chart legends), tasks, tooltips etc. As a rule, every kind of sensors has its own
default metrics (units of measurement). For some sensor types units of measurement could not be changed, for the
others you could do it manually. This is particularly applicable for digital sensors such as engine operation sensor or
custom digital sensors. Instead of default On/Off values you can input Activated/Deactivated, Laden/Unladen, and the
like.
Parameter
Parameters come in messages. If the unit already has messages, parameter name can be picked up from the list of
available in the last message.
Description
This field is optional. Add any description and options if needed.
Then you have to set calculation table for the sensor. It is especially needed for analogue sensors. Not all sensors
send ready values that can be put into a report and be intelligible to any user. If the possibility to transform parameters
is not provided with device itself, this transformation is adjusted with special Calculation Table or Calculation Table
Wizard.
103
Additional Properties
Validate unbinding
This property is specific for sensors of driver/trailer binding. If the option is activated, a driver bound to a unit
automatically can be unbound from this unit only if empty value comes from the same parameter which was used to
bind the driver. Otherwise, driver reset coming from any parameter will lead to the reset of all drivers bound to the unit.
And similar with trailers.
Unbinding code
This property is also applicable to the drivers/trailers binding sensors. Any code could be entered in the Unbinding
code field. If the code is entered, then driver/trailer unbinding will be implemented either receiving an empty value or
receiving the code.
104
Sensor Types
There are many types of sensors. When configuring a sensor (see sensor properties), the choice of sensor type
depends on used device and its principle of operation.
105
like opening/closing the door, etc. Several types of counters are known:
– instant (counts the number from the previous to the current message),
Counter
any – differential (shows total number), differential with overflow (2 bytes),
sensor
– switcher from OFF to ON (counts the number of activations),
– switcher from ON to OFF (counts the number of deactivations).
Besides, you can enter any unit of measurement for this sensor.
This type of sensor is used to measure acceleration at X, Y, Z axes and
Accelerometer G
immediately detect a collision of cars.
Driver binding This sensor can be used to detect drivers assigned to units.
Trailer
This sensor can be used to detect trailers attached to units.
binding
Sensor which non-nil value allows marking a message as an alarm message
Alarm trigger
(SOS).
106
Sensor Parameter Table of Contents
Sensor Parameter
Virtual Parameters
Parameter is a required sensor property. Most of sensors are based on a parameter coming in Inputs and Outputs
One parameter can be used to create as many different sensors as you want. The maximum number of sensors
allowed can be viewed on the Account tab of User Settings dialog.
Virtual Parameters
Note.
Some rare devices may not support all of the parameters mentioned above, e.g., altitude or speed.
The system supports up to 32 digital inputs and outputs. They are adjusted in the following format:
For example, adc8 is referred to as parameter that registers the values coming from the eighth analog input.
Normally, data from digital inputs and outputs are presented in messages in the following format: I/O = 0/0, where I
refers to inputs, O – outputs. If I/O = 0/0, it means all bits (inputs and outputs) are inactive. If any of them is not zero, it
means that an input/output or several of them are active. To define, which of them exactly, hexadecimal number
(which you see in message) must be converted into bit number.
For example, when ignition was activated, the message with parameter I/O = 10/0 was received. We need to retrieve
bit (input in our case) number from the received value – 10. To achieve this, open the calculator in the HEX mode and
key in 10. Then switch to the BIN mode and get the binary number – 10000 in our case. Now count in which position
1 appeared (count from right to left). In our example, this is the 5th position, so, the ignition is connected to digital
input 5. This means that the required parameter is in5.
107
There is a possibility of bitwise parameter control. That means that not the whole parameter value can be analyzed
but a certain bit. For this, indicate bit number after parameter name separating it with colon. For example, param199:3
should be written to control the 3rd bit of the parameter named param199.
This feature is applicable when a device sends various data in one parameter: for example, the first bit shows alarm
condition (on/off), the second bit indicates driver's door state (open/closed), the third – headlights, etc. Thus, using
bitwise control it is possible to create several sensors on basis of one parameter.
Note that doubles are converted to integers, and only then the bit is retrieved.
Constant Parameter
Besides, constN parameter can be used to create a sensor that always returns the same value. N is any number,
e.g., const10, const-8.5. Such a sensor can be helpful in charts or as a validator.
Such a sensor can be used both independently (for example, in charts to mark some critical line) or as a part of
validation chain or in expressions.
Expressions
Parameter for a sensor can be set in the form of expression. In those expressions you can use:
+ addition
− subtraction
multiplication
/ division
^ exponentiation & rooting
( ) brackets of priority
Note:
Parameters from the previous message are not available in notifications.
Expressions allow creating a great variety of sensors, which can satisfy any needs and assigned tasks.
((lat-#lat)^const2+(lon-#lon)^const2)^const0.5/(time-#time)*const200000
Explanation:
The traditional formula to calculate the speed of movement is 'distance divided by time'. To calculate the distance,
we apply Pythagorean theorem: squared difference of latitudes in neighboring messages plus squared difference of
longitudes in neighboring messages, and then the square root is taken from this sum. So, we get the distance (in
degrees). This value is divided by the difference of time in two neighboring messages. As the result, we have the
distance in degrees per second. To convert this to more habitual kilometers per hour (or miles per hour), we apply a
special coefficient. It varies depending on geographical position. In the example above it is equal to 200000 and
applicable to Moscow.
If you have the ignition sensor, the parameter can be set like this:
108
((lat-#lat)^const2+(lon-#lon)^const2)^const0.5/(time-#time)*const200000*[Ignition
sensor name]
First, create a sensor of Relative engine hours type. The parameter for the sensor will be:
The meaning: time difference in neighboring messages multiplied by the coefficient of intensity of work and divided
by 3600. The division by 3600 is applied to convert seconds into hours.
Then, create the coefficient sensor that will define the intensity of work depending on engine revolutions.
Dependency scheme can be like this:
1 minute work with intensity of 2000 rpm correspond to 90 seconds of engine work coefficient 1.5
1 minute work with intensity of 1500 rpm correspond to 60 seconds of engine work coefficient 1
1 minute work with intensity of 1000 rpm correspond to 40 seconds of engine work coefficient 0.67
1 minute work with intensity of 500 rpm correspond to 20 seconds of engine work coefficient 0.33
Let us assume that param1 sends engine revolutions. Then the coefficient parameter will be like this:
(param1+#param1)/const2
To convert revolutions into coefficient, adjust the calculation table for this sensor:
x=500 y=0.33
x=1000 y=0.67
x=1500 y=1
x=2000 y=1.5
Do not forget to set the relative engine hours sensor as the counter of engine hours (the General tab).
Textual Parameters
Most parameters are designed to send numeric data, however, in some cases they may provide textual data. This can
be, for example, a name of a status (business/private), some state (free/waiting/busy, on/off), time passed since a
certain event, etc.
Sensors with textual parameters do not require calculation table. Textual data is displayed as it is. However, the
application of text-based sensors is limited – their values can be shown only in additional information about the unit, in
messages panel, in track player, and in track hittest.
109
Validation of Sensors Table of Contents
Validation of Sensors
Examples
Validation defines dependency of sensors from each other. It is adjusted in sensor properties. Logical OR
Mathematical AND
Validator is a sensor that affects the current sensor. Validator is another sensor which must be Mathematical Operations
Usage
created in advance. It is chosen from the list of available sensors.
Validation type defines in which way the validator will affect the current sensor. The following validation methods are
available:
Logical AND: values of both sensors are analyzed, and the logical function AND is applied. That means,
the output is true (1) if both values are not null. As a result, current sensor value can be either 0 or 1.
Logical OR: both values are analyzed, and the logical function OR is applied. That means, the output is
true if at least one value is not null. As a result, current sensor value can be either 0 or 1.
Not-null check: if validator is not null, current sensor value is considered true and displayed without
transformations. In the other case, it is blank.
Subtract validator from sensor: validator value is subtracted from sensor value.
Subtract sensor from validator: sensor value is subtracted from validator value.
Replace sensor with validator in case of error: if the main sensor has no available data, all values are
taken from the validator.
Note:
Validation chain can consist of any number of sensors. So, one sensor can be a validator for another sensor and at the
same time depend on the third sensor.
Examples
Logical OR
The example is the following: every door of a vehicle is equipped with a sensor. Every sensor indicates whether the
door is opened or closed. It is necessary to know if the vehicle is opened or closed, and the state of the particular
door does not really matter.
For this purpose the sensor with ‘Custom digital sensor’ type should be created in Wialon for every door. Then, one
by one, validate the sensors indicating ‘Logic OR’ as validation type. Using ‘Logic OR’ function, the vehicle is
considered to be opened if any of its doors is opened (the 1st, or the 2d, or the 3d…). If it is more convenient, then
the visibility for all the sensors used except for the last validated one could be switched off. Therefore the visible
sensor shows whether the vehicle is closed or opened.
Mathematical AND
110
In the following example there is a vehicle with the sensors installed on every door, and these sensors show
whether the door is opened or not. In this example it is necessary to know the state of every door individually. The
equipment used in our example sends the doors’ state value in one parameter (each bit represents the door).
The sensor with ‘Custom sensor’ type is created in Wialon and the parameter for incoming value of the doors’ state
is indicated. Then the sensor with ‘Customer digital sensor’ type is created for every door individually indicating
constant parameter (for the first — const1, for the second — const2, for the third — const4, for the fourth — const8).
The earlier created custom sensor should be indicated as the validator with the validation type ‘Mathematical AND’
for every created custom digital sensor. Therefore, using ‘Mathematical AND’ the verification of a received
parameter is implemented, and we find out the state of every door.
Let us suppose, three different kinds of equipment is installed on a unit (brush, plough, and thrower). Each of them
is connected to a digital input which shows whether it is active at the moment or not. Using the validation system, we
can control all three pieces of equipment not separately from each other but at once, in one sensor.
For each piece of equipment, we create a sensor, so, as a result we have three sensors – А, B and С. Let them all
be custom digital sensors. With this, each sensor must have a calculation table adjusted in such a way that each
sensor has a unique value. For example, one sensor (brush) if activated, will send 1, as usual; the second sensor
(plough) will send 10; and the third sensor (thrower) will send 100. Thus, if you sum up the received values, you can
easily estimate which sensor(s) are activated. Possible values:
To make this scheme work, adjust dependency between the sensors. Let us make Sensor A basic. Then the
validator for Sensor A will be Sensor B, with validation type 'Sum up'. Sensor C will be validator for Sensor B (with
the same validation type).
It is also useful to assign a color to each possible value (see Advanced Properties) so that these colors could be
used to visualize sensor in the Monitoring panel, on the map or in tacks.
Example 2
Supposedly, there is a vehicle with two fuel tanks. Each tank has its own fuel level sensor. We need to know total
fuel level of the two tanks.
Two sensors with ‘Fuel level sensor’ type should be created in Wialon. One of them is set to be a validator for the
other with ‘Sum up’ validation type. If it is more convenient, then the visibility flag for the validated sensor should
stay, for the other — could be unchecked. Therefore we can see the validated sensor value which is the total fuel
level for these fuel tanks.
Using any mathematical operation as a validation method is equal to indicating sensor parameter using formula. In
other words, any mathematical operation as a method of validation has an alternative without validation usage. In
order to understand how it works, we shall use the above mentioned example with two tanks where we should know
the total fuel level of two tanks.
Three fuel level sensors should be created in Wialon (‘Tank1’, ‘Tank2’, and ‘Total’). In the parameter of ‘Total’
sensor enter the formula [Tank1]+[Tank2]. ‘Tank1’ and ‘Tank2’ sensors show their own fuel level, and ‘Total' sensor
shows us the total fuel level of both the tanks.
The advantage of using formulas is in the amount of information received. For example, if ‘Tank2’ is validated by
‘Tank1’, then we would know ‘Tank1’ fuel level, but ‘Tank2’ would show us only the total fuel level for these two
111
tanks. Using formulas, we will also know ‘Tank2’ fuel level.
The only disadvantage for formula usage is creating of greater amount of sensors than during validation usage.
112
Calculation Table Table of Contents
Calculation Table
Example 1: Temperature
Calculation table is very important in sensors configuration (see sensor properties). According Sensor
to the calculation table adjusted, raw data coming in a parameter is transformed into sensor Example 2: Engine Ignition
Sensor
values, for instance, some abstract 86 is interpreted as 10.5 liters of fuel.
Attention: filled calculation table is essential for analog engine ignition sensor because it must be defined how all
available analog values are transformed into two available states – On/Off.
However, in some cases calculation table is not needed. It is especially true for digital sensors that send 1 or 0, and
this corresponds to 'On/Off”. So, there can be no need in transforming this data in some way. On the contrary, analog
sensors usually require calculation table.
When a new message comes, necessary parameters are retrieved and substituted into the formula as X values; a and
b are computed automatically according to the calculation table adjusted for the sensors. As a result, Y values become
known.
Each row of the table operates only within its segment that is till the X value of the next row. That is why X values
cannot repeat.
If you use a coefficient and want to take into account the previous segment for Y-axial displacement, enable the
Continue last segment flag.
It is possible to get the tangent of angle (that is needed to be substituted for a coefficient) using mathematics. To do
this, find on X and Y axes segments of values operation (deltas). Then divide the values ∆y/∆x. The result value is the
tangent of angle.
Lower and upper bounds may be useful to set limits for input values. If some X value is out of range, it is treated as
invalid. If you use a lower bound, then the lower bound value should be smaller than or equal to the first X value in
the calculation table (and preferably very close to this value). The upper bound should be greater than or equal to the
last X value in the calculation table.
After entering each pair of value, press Add. Incorrect pairs can be removed with the button . To remove all pairs at
once, click on the Clear Tale button.
The graphic implementation of the created calculation table can be viewed in the Calculation Chart tab. Push the
Refresh button to build the chart based on your calculation table.
1. Fill in all available fields (X, b, and a). Use this method to get the calculation table under your complete
control.
2. Fill in only X and b values, and a set as zero. At that, Continue last segment option should be disabled.
This method is convenient if converting a analogue signal to a digital.
3. Enable Continue last segment option and fill in only X and a values. In this case, b is calculated
automatically. This method is convenient if needed to get a curve knowing the angles.
4. In many cases it is possible to adjust the calculation table knowing input X values and corresponding
output Y values. In these cases use Calculation Table Wizard.
113
As an example, let us create a calculation table for temperature sensor. Let us assume that the data is coming in
complement code. Thus, the positive values are form 0 to 127, and negative from 128 (which corresponds to -127
degrees) to 255 (which corresponds to -1 degree).
Move to the Calculation Chart tab to estimate the result (press Refresh).
Note.
The function continues operating to infinity if there are no limitations. The chart extends also to the left to minus
infinity. If there are limitations, the chart expands quarter-size to both sides, right and left.
It is possible to configure a non-digital ignition sensor based on the parameter sending voltage. For instance, the
voltage up to 0.5 V would mean 'ignition off', and over 0.5 V — 'ignition on'. For such a sensor, we should create a
calculation table like this one:
Move to the Calculation Chart and see if the result meets your expectations (press Refresh).
114
115
Calculation Table Wizard Table of Contents
Calculation Table Wizard
Example 1: Fuel Level Sensor
This way of creating a calculation table for a sensor is less complicated. It is enough to enter Example 2: Fuel Level Sensor
input X values and corresponding output Y values. You can use the calculation table wizard
when calibrating a sensor experimentally. For instance, you fill different volumes of fuel into the tank and each time you
take the readings from the sensor.
After entering each pair of values, push the Add button. Incorrect pairs can be deleted with button. When all pairs
are entered, press Generate calculation table. The calculation table on the previous tab will be replaced with new
data.
a is calculated by the formula ∆Y/∆X. X- and Y-axial displacement is calculated separately for each
interval, and then Y-axial displacement is divided by X-axial displacement, that is ∆Y/∆X.
b is calculated by the formula b = Y — a × X.
When reopening the dialog, all data entered on this tab is preserved. However, note that if any changes were made on
the Calculation Table tab, they will not affect the Calculation Table Wizard. In other words, the Calculation Table
Wizard displays only values you entered but not always reflects the real situation.
Let us imagine that we poured 10 liters of fuel and the sensor returned the value 86, then we poured 20 liters and got
173, and so on. In the end, we can form a table:
116
Then press Generate Calculation Table and go to the Calculation Table tab.
Note.
When reopening the dialog, all data entered on this tab is preserved. However, note that if any changes were made on
the Calculation Table tab, they will not affect the Calculation Table Wizard. In other words, the Calculation Table
Wizard displays only values you entered but not always reflects the real situation.
Now let us see how a and b were calculated. The first interval starts with 0 and lasts until 86. At that, in the last point
the output is 10. So, X displacement is ∆Х = 86 — 0 = 86, and Y displacement is ∆Y = 10 — 0 = 10. Now a coefficient
117
can be calculated: a = ∆Y/∆X = 10 / 86 = 0,11627906976744186. The same algorithm is applied to all intervals:
Interval X Y a b
N X Y (Y(i+1) — Y (i)) / (X(i+1) — X (i)) Y—a×X
1 0 0 (10 — 0) / (86 — 0) 0 — a×0
2 86 10 (20 — 10) / (173 — 86) 10 — a×86
3 173 20 (30 — 20) / (252 — 173) 20 — a×173
4 252 30 (40 — 30) / (330 — 252) 30 — a×252
5 330 40 (50 — 40) / (405 — 330) 40 — a×330
6 405 50 (60 — 50) / (477 — 405) 50 — a×405
7 477 60 (70 — 60) / (546 — 477) 60 — a×477
8 546 70 (80 — 70) / (618 — 546) 70 — a×546
9 618 80 (90 — 80) / (686 — 618) 80 — a×618
10 686 90 (100 — 90) / (749 — 686) 90 — a×686
11 749 100 (110 — 100) / (812 — 749) 100 — a×749
12 812 110 (120 — 110) / (874 — 812) 110 — a×812
13 874 120 (130 — 120) / (930 — 874) 120 — a×874
14 930 130 (140 — 130) / (989 — 930) 130 — a×930
15 989 140 (150 — 140) / (1019 — 989) 140 — a×989
In this example, input X values decline while output Y values grow. Insert the pairs into the wizard in any order – they
will be rearranged automatically.
Initial data:
Insert these data into the wizard, generate the calculation table and get the calculation chart.
118
Calculated intervals for this sensor are as follows:
Interval X Y a b
N X Y (Y(i+1) — Y (i)) / (X(i+1) — X (i)) Y—a×X
1 0,32 100 (90 — 100) / (0,6 — 0,32) 100 — a×0,32
2 0,6 90 (80 — 90) / (0,96 — 0,6) 90 — a×0.6
3 0,96 80 (70 — 80) / (1,1 — 0,96) 80 — a×0.96
4 1,1 70 (60 — 70) / (1,25 — 1,1) 70 — a×1.1
5 1,25 60 (50 — 60) / (1,3 — 1,25) 60 — a×1.25
6 1,3 50 (40 — 50) / (1,65 — 1,3) 50 — a×1.3
7 1,65 40 (30 — 40) / (2,0 — 1,65) 40 — a×1.65
8 2,0 30 (20 — 30) / (2,18 — 2,0) 30 — a×2
9 2,18 20 (10 — 20) / (2,58 — 2,18) 20 — a×2.18
10 2,58 10 (0 — 10) / (2,8 — 2,58) 10 — a×2.58
119
Custom Intervals
Sometimes you may need to see some text instead of numeric values of a sensor. This tab helps you to create custom
intervals for the sensor and their textual meaning.
Note that like in the calculation table, all intervals operate from indicated value. The exception is the first interval, which
operates not only from this value to the next but also from minus infinity to this value.
For example, if you input intervals like in the example above, they will be interpreted in the system as follows:
These textual interpretations will appear in additional information about the unit, and in messages.
120
Signed Parameters Converting Table of Contents
Signed Parameters Converting
Parameter Analysis
It is supposed that data received by Wialon in the format of two- and four-byte integer appears Defining the Maximum Value
to be unsigned. In other words, all the incoming values (both positive and negative) are Sensor Calculation Table
Result Analysis
displayed as unsigned, i.e., positive.
In case when equipment used by you sends signed values in any parameter (for example, temperature parameter), it is
necessary to create a sensor on the basis of this parameter and adjust a calculation table in a proper way.
Parameter Analysis
Switch to the Messages panel and request messages for any interval of time. Indicate Show parameters as raw data.
In the column 'Parameters' find the necessary parameter and analyse its incoming values.
You can see that when temperature goes down and crosses 0 degrees threshold the necessary negative numbers are
constituted with enormously large ones.
Firstly, you should define the maximum threshold for such numbers. In order to do so, take any of such numbers
appeared in parameter values and put it into a calculator in the decimal mode (Dec.). Afterwards, switch to the
hexadecimal displaying (Hex. mode).
Count the register length in the number appeared. Possible values are: 2, 4, 8. If the register length is less, we should
round it up (for example, 5 should be rounded up to 8). In our case the register length is 8.
Now letter F should be put in to the calculator in Hex. mode as much times as the register length appears to be after
rounding up. Afterwards, switch to the 'Dec' mode. Appeared result is the maximum possible number. You should
write it down or memorize.
121
Sensor Calculation Table
Switch to the unit properties dialog and create a sensor on the basis of this parameter. Now you should create a
calculation table for it. Switch to the 'Calculation Table' tab and deselect Continue last segment checkbox.
We have found out that all the interval of possible values is from 0 to 4294967295. Therefore possible values start
from 0 to the half of the maximum number and negative numbers go from the half to the end of the maximum number
(where the maximum number is the smallest negative number module). Divide the maximum number by 2, which
equals 4294967295 : 2 = 2147483647,5. It means that positive values start from 0 to 2147483647 and negative —
from 2147483648 to 4294967295.
In the calculation table X is a raw data sent by parameter, a — coefficient, b — necessary correction. And all these
values are needed to get some Y which appears to be a real temperature value.
Whether (a) coefficient is used for this parameter you can find out in the equipment specification. In our case
coefficient equals 0.1, therefore if parameter's value sent by equipment equals 6 then the real temperature is 0.6
degrees.
The first piece doesn't need b correction (i.e., 0) but the second piece needs it because the values go in reverse order
(maximum number corresponds to the smallest negative temperature value module). To calculate b shifting it is
necessary to add one (because we already have 0) and multiply by coefficient. Therefore we have:
(4294967295+1)х0.1 = 429496729.6. The received value should be deducted that's why it should be put to the
calculation table as negative.
Now you can insert both the intervals (either for positive and negative numbers) in the calculation table.
Notice.
Calculation could be also made in 'Hex' mode. In this case you should put letter F as much times as the register
length appears to be (which is 8 in our case) and then divide by 2. Afterwards, switch to the 'Dec' mode (decimal
numbers) and save or memorize a number received. This is the maximum positive value.
Result Analysis
You can analyse received table, switching to the 'Calculation Table' tab and pressing 'Refresh' button.
122
Besides, you can estimate sensor's adjustment in the Messages panel. Request messages on the unit for the same
time interval and this time choose 'Show parameter as sensor values'.
123
Temperature Coefficient
Temperature coefficient is a sensor which is created on the basis of a parameter sending temperature/voltage and
applicable for a fuel level correction. Any liquids depending on ambient temperatures could occupy different volume,
that's why fuel level sensor's information, especially of high volumes (for example, tanker), could seem to be incorrect
without considering temperature values.
Temperature coefficient sensor as well as the other sensors is created in the unit's properties in the tab 'Sensors'.
Press 'New' button and fill in the necessary fields. Sensor type is Temperature coefficient, name and description is any
of your choice. Unit of measurement is not necessary to be indicated. The parameter sending temperature data is
obligatory for indication.
Afterwards, switch to the 'Calculation Table Wizard' tab where you should put in two coefficient values, maximum and
minimum temperature coefficient. Beforehand, some preliminary preparations to be done:
1. Look through the specification and find out maximum and minimum working temperatures of your fuel level
sensor. In our case they will be: tmax = +100 and tmin = -60°С.
2. Find out rated temperature for the reference amount, in other words the temperature which doesn't change
fuel amount and and won't require a coefficient application. In our case the value is the following: trated =
+20°С.
3. Find out the density of a fuel used by you (ρ). In our case it is diesel, the density of which is 0.89 t/m 3 .
Thus we have:
Now insert the data found for the minimum and maximum temperature values into the fields of 'Calculation Table
Wizard' and generate a calculation table.
124
Notice.
If not the temperature, but, for example, voltage is sent by parameter, then instead for the minimum, maximum, and
rated temperature it is necessary to know the minimum and maximum voltage and also a rated voltage of a reference
amount, and do the calculations on the basis of this data.
125
General Properties
Access required: Edit connectivity settings – to view and edit devices type, phone number, UID, and access
password.
On the General tab of the Unit Properties dialog the following parameters are set:
Name
Enter a name for the unit from 4 to 50 characters.
Device type
Select device type from the list of devices provided according to your License. Three devices most used by the current
user are listed on the right and can be easily chosen by simple click. To display the full list of available device types,
click on the entry field once (at that it should be empty). To quickly find a necessary device type, use the dynamic filter.
On the right of the entry field there is a button which can be used to configure device parameters for the given unit,
however, it is active only if this facility is supported within selected device type.
See also the full list of supported hardware.
Unique ID
Enter a unique ID for the unit to be identified by the system. Usually it is IMEI or serial number.
Phone number
Here type phone number of the unit if it has embedded SIM card. Phone number should be in the international format,
e.g., +15557654321. If your device supports two SIM cards, you can enter the second phone number on the right.
Creator
User who is creator for this unit (if you have any access to this user).
Account
Here you can see to which account the unit belongs (if you have any access to this account). Like creator, account is
set while creating a unit cannot be changed later.
Measurement system
Either metric or U.S. system of measurement can be applied to a unit. This parameter is taken from a current user.
Attention!
Units with the same unique IDs within certain device type as well as units or drivers with the same phone numbers
cannot exist in the system. If you are attempting to create a unit with a repeated ID or phone number, a special alert
will be displayed. However, unit will be created anyway but with empty ID or phone number which could be edited later.
Note.
Parameters of units could be set in metric system of measurement (kilometers, liters) or U.S. (miles, gallons). System
of measurement for new units created is taken from current user settings. Therefore, to choose a system of
126
measurement for a unit it is necessary to choose a corresponding system of measurement in the settings of a current
user. System of measurement for already existing units could be changed by conversion.
127
Counters Table of Contents
Counters
Counter Properties
Access required: Edit counters – to edit counters current values and calculation methods.
Parameters for counters are adjusted on the General tab. Counters are widely used in the system – in online
monitoring as well as in reports. Three types of standard counters are supported: mileage counter, engine hours
counter, and GPRS traffic counter.
Mileage Counter
GPS: mileage is calculated by GPS coordinates. It means if the change of coordinates was detected, the
distance between them is added to mileage.
Mileage sensor: mileage is calculated by mileage sensor.
Relative odometer: mileage is calculated by relative odometer sensor.
GPS + engine ignition sensor: mileage is calculated by GPS coordinates considering ignition state.
Be careful when selecting a method. If you choose to calculate mileage by a sensor, and your unit does not have this
sensor, then mileage values will be zero.
Engine hours counter calculates engine hours by one of three sensors (engine hours are measured in hours):
GPRS traffic counter is used to calculate Internet traffic consumed by the unit to transmit and receive data. Traffic is
measured in kilobytes (KB). At any moment, you can reset this counter manually if pressing the Reset counter button.
You will be offered to save the event of reset and the current value in unit events history to be exported to a report
later.
Counter Properties
You can set the Current value for each counter, and the further calculations will start from the indicated point. In order
the new data were added to the current value automatically, activate the Auto option at the right of the counter. You
can manually zero counters if entering '0' to the current value field.
Counters values can be altered not only in this dialog but also with the help of appropriate jobs and notifications.
Values of mileage and engine hours counters can be shown in unit's tooltip and in extended unit information.
128
Access to Unit
Access required: Manage access to this item on the unit you are editing; Manage user's access rights on the users in
the left part of the dialog.
On the Access tab of the Unit Properties dialog you can define access to the unit on behalf of different users.
The list of users whose access can be changed is displayed on the left. Users with colored background on the top of
the list are those who already have some access to this unit.
On the right, the list of both standard and special access rights is displayed where allowed actions are ticked.
129
Icon
Access required: Change icon.
On the Icon tab of the Unit Properties dialog you can select or load any image to display your unit on the map and on
different lists.
There is a number of standard icons: push the Icon Library button and select one. Alternatively, you can load your own
image: push Browse and select a file on the disk. Supported formats are PNG, JPG and GIF.
Depending on course, unit icon can be rotated to show direction of movement. For this, enable Rotate icon option.
Rotated icon should be faced North, otherwise, it may confuse you. You can find some images suitable for rotation in
the Icon Library.
The button Reset to default allows returning the default icon in case it has been changed. Default icon may be useful
sometimes. If a unit has a default icon, and a unit group where it belongs has a non-default icon, then unit acquires the
icon of this unit group.
130
Advanced Properties Table of Contents
Advanced Properties
Parameters Used in Reports
Access required: View detailed properties – to view parameters for reports and settings of Colors
messages filtration (first and last sections); Edit not mentioned properties – to edit color Message Validity
Enable filtration of unit
schemes for track/sensor (middle sections); Edit connectivity settings – to edit parameters of position information in
messages filtration (last section). messages
On the Advanced tab of the Unit Properties dialog messages validity parameters are defined, colors for tracks are
adjusted, and speed limitations are set.
Speed limit
Enter the maximum speed allowed. All messages with higher speed will be detected as cases of violation and
exported to the report on speeding.
Mileage Coefficient
Mileage coefficient is useful to compare detected mileage with mileage by speedometer. The corresponding column
can be included in any tabular report containing information about mileage, and in statistics.
Colors
131
Different colors can be used to show unit itself on the map or its movements (tracks). Tracks can be built in the Tracks
panel, Messages panel, Reports panel, or in the Monitoring panel (quick tracks). Track segments can be different
colors depending on speed, sensor values and so on.
These properties are adjusted for each unit individually. Note that 'speed based', 'sensor based' and 'unconditional'
options are mutually exclusive (only one can be chosen).
Enter pairs: speed/sensor value and corresponding color. Separate value and color with a space, and pairs
themselves with semi ';'. For example, if '0 ff0000; 60 cc0000ff' is entered, the track consisting of messages with
speeds from 0 to 59 km/h will be displayed in red color, over 60 km/h – in blue.
For your convenience, there is a color palette which is shown when you click on any colored square box. To
apply settings push the Apply button. To restore default colors push Reset to default .
The color for some range can be transparent. For this, its first bite should be 0×01. For example, the string '0
1ff0000;0.9 00ff00' means that the values from 0 to 0.9 will be transparent, from 0.9 and upper – green.
Sensor colors
This feature can be used in two ways:
Value intervals and colors are set in the manner as for track colors. Besides, you can enter description for each
interval. These descriptions will be used in popup windows for the Sensor Value column in the monitoring panel. If no
description is assigned here, the exact value will be displayed in the popup window.
132
Message Validity
Minimum satellites
If the number of satellites locked is lower, the message considered to be invalid. Recommended value is three and
more, but some equipment can give correct coordinates beginning from two satellites.
Maximum speed
The messages containing speed higher than one set here are marked as invalid.
133
Custom Fields
Access required: View custom fields – to view general custom fields; Manage custom fields – to create, edit, and
delete general custom fields for given unit; View admin fields – to view administrative custom fields; Manage admin
fields – to create, edit, and delete administrative fields.
On the Custom Fields tab of the Unit Properties dialog you can input information of any type. This can be some notes
or precisions about the equipment, vehicle or any other information needed. Administrative fields (seen only to users
with special access rights) are marked in the first column.
Input a field name and its value and press the Add button. To delete an incorrect field, press Remove.
When the next time you will open unit properties dialog, the entered fields will be alphabetized. The same will happen
when displaying custom fields in unit's tooltip.
In unit's tooltip and in extended unit information (if enabled in User Settings);
In Custom Fields table that can be generated both for a unit and for a unit group;
In the Monitoring panel to search units by some property;
In the text of notifications.
134
Unit Groups
On the Unit Groups tab of the Unit Properties dialog you can view whether the unit is included in some group or not.
You can also see the list of all existent groups and include the unit to one or several groups if needed.
To include/exclude the unit in/from groups, use the appropriate buttons Add and Remove or double-click on a group in
the appropriate list.
If you do not have rights to change units in given group ('Edit ACL propagated items'), such group name is dimmed
(grey).
135
Commands Table of Contents
Commands
Command Properties
Access required: View commands – to view this tab and its contents; Create, edit, and delete
commands – to create, edit, and delete commands.
The Commands tab of the Unit Properties dialog gives possibility to create and configure commands for the given unit.
To be able to send a command to a unit, it is crucial that this command is registered here.
A command can be sent both manually (from the Monitoring panel) and automatically (with the help of notifications and
jobs) as well as via SMS. A command can be executed for several units at once, but in this case it should be
configured in the properties of all those units and bare exactly the same name.
To create a new command, press the New button. Sometimes it is convenient to create a new command using existing
one as the basis – select a template command and press Copy. To view or change configuration of an existing
command, select it and press Properties. To delete a command, select it and press Delete.
Command Properties
Command name
Input command name. Names cannot be repeated within one unit.
Command type
Choose command type from the list of commands supported by the device used. See the list of standard commands
supported in Wialon.
Link type
Select the link type to be used each time when sending the command (Auto, TCP, UDP, Virtual, SMS). If Auto link
type is set, the program will automatically select a channel which is available at the moment of execution (if several
are available, then the priority is given like in the list of link types). The list of link types also depends on the device
type indicated on the General tab.
Note that if the link type is TCP or UDP, it is required that the unit was connected at the moment of execution. If the
command is executed through GSM channel, a phone number in the international format should be present in unit
properties and the user is supposed to have rights to send SMS messages.
Phone number
Phone number is required for SMS commands only. Some types of devices can support two SIM cards, so a unit can
have two different phone numbers. Here you choose which of them will be used to send the command:
first/second/any. Like with parameters and link type, the phone number selected here cannot be changed at the
moment of sending the command.
Access rights
136
Indicate access rights which would be required for users to execute this command. To choose a combination of rights,
press <ctrl> key and select several items. Regardless of selected rights, the flag Execute commands is required
anyway.
Parameters
Additional parameters may be necessary for some commands. It can be like input/output number, report interval, etc.
Those parameters can be set when configuring the command, and in this case, they will be applied automatically each
time when the command is being executed. Thus, several commands with different parameters and link types can be
created on the basis of one command type. However, it is not obligatory to set parameters when creating command,
because you can indicate them when executing (manually only). To do so, mark the checkbox Without parameters. It
will be impossible to change parameters (as well as link type or phone number) if they are set.
137
Trip Detection Table of Contents
Trip Detection
Movement Detection
Access required: View detailed properties – to view this tab; Edit trip detector and fuel
consumption – to edit this tab.
On the Trip Detection tab of the Unit Properties dialog you define parameters to detect movement intervals (trips) and
idles (stops, parkings). Trip is a period of time when a unit was moving. Stay is a period of time when a unit was
motionless.
Depending on the equipment installed and the parameters set on this tab, reports can look rather different.
Movement Detection
There are five main methods of how movement intervals are detected:
GPS speed
This method is universal and can be applied to any device type and configuration. The parameters of this
method are described below.
GPS coordinates
This method is universal as well. The movement is detected if the coordinates in two successive
messages are different. The fact is that some equipment types do not provide speed parameter in
messages. In this case, movement can be detected by coordinates without installing additional equipment.
Mileage sensor
This method can be used for units which have a mileage sensor. The sensor transmits the absolute
mileage. The beginning of a trip is detected when the mileage value increases, and the end is detected
when mileage value stops to grow.
Relative odometer
Shows what distance was rolled from the previous message. Note that 'Min moving speed' parameter
must be '0'.
After you have established the way to detect intervals of movement and stay, consider the parameters below. They
are needed to distinguish trips, parkings, and stops.
138
stops in traffic jams, at a lights or at an intersections as a part of a trip (instead of breaking the trip). When defining
movement by a sensor (for example, ignition), this parameter is applied only to intervals with when the sensor is off. If
'Allow GPS correction' is on, the value of the minimum parking time should be no less than 10.
139
Fuel Consumption
Attention!
This module is licensed separately.
Access required: View detailed properties – to view this tab; Edit trip detector and fuel consumption – to edit this tab.
Wialon has instruments to calculate fuel level and fuel consumption. Parameters to calculate fuel and calculation
method itself are set on this tab.
Fuel fillings and thefts can be detected only if unit has fuel level sensors. Fuel consumption calculation will be more
accurate if unit has fuel consumption sensors, however, it can be calculated mathematically, too.
140
Detect fuel thefts in motion
Traditionally, fuel theft is better detected while the unit is stationary. However, you can enable this option to detect
thefts even in motion. Note that in many cases activation of this option can lead to the situation when false thefts are
defined.
Note:
Fuel fillings and thefts can be controlled through reports ( see Fuel Fillings and Fuel Thefts tables) as well as
through the appropriate job.
Consumption math
This is a purely mathematical method of calculate fuel consumption (no sensors are required). To use this method,
the following parameters should be set:
Consumption by rates
This is also a mathematical method. If the previous method takes account of speed and load, this method considers
the season (winter/summer time). Specify the following parameters:
141
Fuel level sensors
Fuel consumption is defined from fuel level in the tank where fuel level sensors are installed. The difference
between the average values at the beginning and at the end of the period is calculated.
142
Service Intervals Table of Contents
Service Intervals
Service Intervals in Use
Attention! Tracking
On the Service Intervals tab of the Units Properties dialog, you can define maintenance intervals to perform all
necessary routine servicing in time. These can be oil change, yearly checkup or just a washing.
In the list you see the name of each interval, its description (if available) and the state – how many days, engine hours
or mileage have left or are already expired to do this service. Depending on the state (time left or expired), the lines are
red or green.
To add a new service interval, press the New button. Then enter necessary parameters: name, description, interval and
last execution time.
Mileage interval means that the service has to be done every n number of kilometers (miles) travelled.
Engine hours interval means that the service must be done every n number of engine hours.
Days interval means that the service must be done every n number of days.
You can simultaneously choose several interval types at once, and each of them will be tracked independently. For
example, the term by days can be expired, and at the same time, the term by mileage has not passed yet.
When choosing an interval, indicate which counter value (or day) was when this kind of service was made the previous
time. Enter this value into the Last Service field. For your convenience, the current values of the counters are indicated
below.
Attention.
Check your counters properties on the General tab, and do not forget to mark the Auto checkbox.
Done times: here you indicate how much time this kind of service was already done. This number can be entered into
this field manually or changed automatically when registering a service of this kind. Besides, after registration the time
of the Last Service changes, and the count of days/mileage/engine hours will be zeroed and started again.
At the end press ОК. The newly created service interval will appear on the list. To manage intervals, use the following
buttons:
143
New opens a dialog to create a new service interval and set parameters for it.
Copy opens a dialog with all parameters of the selected interval. You can edit these parameters and save
the interval under another name.
Properties opens a dialog to view and/or edit the interval.
Delete deletes the selected interval.
Tracking
Service intervals with their terms can be indicated in unit's tooltip and in extended unit information. See User
Settings.
Events Registration
Maintenance works can be registered in unit history and used in report later. When registering maintenance, it can
be bound to a certain service interval (existing in unit properties). After registration, the count of days/mileage/engine
hours will be restarted, done times will be added, and the last service term will change. The changes can be
estimated in unit's tooltip, in extended unit information as well as in unit properties dialog.
Notifications
There is a notification of the Routine servicing control type. With the help of this tool you can receive automatic
notifications by e-mail, SMS, in online popup window or by other means about service terms which are approaching
or expired. See Notifications.
Reports
Two tables concerning service intervals can be generated for units or unit groups: Maintenance and Utilization cost.
The report on maintenance presents the list of registered maintenance works. The report on utilization cost includes
maintenance works as well as fillings.
Some information about maintenance can be shown in Statistics: total duration of maintenance works, total cost of
maintenance works, the number of services done, total utilization cost, and the number of fillings and services.
144
Unit Groups Table of Contents
Unit Groups
Unit Groups in Management
Unit group is a system macro object incorporating several units that have something in Working with Unit Groups
common. Unit groups have broad application in Wialon and are useful both for managers and
for end users. That is why working with unit groups is possible both in CMS Manager and in the main interface.
Unit groups can be used in management system in two ways: they make easier assigning access rights to units. You
can give a user access to a group of units at once.
To work with groups of units, open Unit Groups tab in the navigation panel of CMS Manager. Here you can create,
view, edit, copy, and delete unit groups.
There is a button to create a new unit group and a filter to search existent groups. In the table of results, you can see
group's name, image, creator (if available), and button to delete group. Standard operations with objects (create, view,
edit, copy, delete) were described below.
145
Unit Group Properties Table of Contents
Unit Group Properties
General
When creating, copying, editing or just viewing unit group properties, you see a dialog with Access
several tabs on which group configuration is adjusted. The number of tabs can vary depending Icon
Custom Fields
on your access rights (max — 4).
General
Name
Give group a valid name (see Input Rules).
Creator
Creator is important to build hierarchy of access rights. Do not forget that the creator automatically gets manage
access to units in the group.
Account
Here you can see to which account the unit group belongs (if you have any access to this account). Account and
creator cannot be changed afterwards.
Units
Add units to the group. On the left, there is a list of all units available. On the right, there is a list of units in the group.
To add a unit to the group, double-click on it or push the Add button. To remove a unit from the group, push Remove
or double-click on the unit in the right column.
If you are editing an existing group, you are required to have Edit ACL propagated items access to this group to
add/remove units. Otherwise, all units in both sections will be gray and you will not be able to move them.
Note:.
Along with the manual way to manipulate groups, there is an automated way to add/remove units to/from a group. See
Notification Action for details.
Access
Access required: Manage access to this item — to group; Manage user's access rights — to users.
On this tab, you can define access that different users will have to this group.
On the left, there is a list of users whose access rights can be controlled. Colored background indicates those users
146
who already have any access.
Select a user on the left and check access flags for this user on the right. Access rights are divided into two sections
— standard rights (Item ACL) and special rights (Unit group ACL).
Icon
Access required: Change icon — to view this tab and change icon.
Image for the group can be selected from a set of standard icons (the Icon Library button) or loaded from disk (the
Browse button).
Icon is used mainly to display group in the Unit Groups list. However, it may be applied also to display units that
belong to this group. If a unit has a default icon, and a unit group where it belongs has a non-default icon, then unit
acquires the icon of this unit group. More about icons...
Custom Fields
Access required: View custom fields – to view general custom fields; Manage custom fields –– to create, edit, and
delete general custom fields for given unit; View admin fields – to view administrative custom fields; Manage admin
fields –– to create, edit, and delete administrative fields.
Here you can enter any additional information about this unit group. Information is entered in the form of fields:
<field_name> — <field_value>. Key in a field name and its value and press the Add button. To delete a field, press
Remove. Administrative fields (seen only to users with special access rights) are marked in the first column.
147
Retranslators
Messages from units can be retranslated in real-time from your server to other servers or systems. It is possible to
retransmit data to several servers simultaneously and at different protocols. The ID of a retranslated unit can be
different from its ID in Wialon.
Retranslation is possible only in CMS Manager and it is done in the Retranslators panel. There you can create any
number of retranslators that will transmit messages of selected units to other systems. At any moment, any retranslator
can be stopped or started again.
To create a retranslator, press the Create Retranslator button. In the dialog input a name for the retranslator (at least
4 characters) and choose a retranslation protocol.
The number of available retranslation protocols depends on your License. The full list is as follows:
Wialon Retranslator,
Nis (M2M),
Granit Navigator,
Scout,
Cyber GLX,
Wialon IPS,
VT 300,
EGTS,
SOAP,
TransNavi,
NVG,
RTTI.
Then indicate retranslation server, port, and in some cases authorization (auth). If the port is not indicated, it is set to
defaults. Authorization for Nis protocol is login and password separated by colon (login:password). As for the EGTS
protocol, you can disable authorization if it is irrelevant, indicate time interval (in seconds) at the end of which
authorization will be repeated, and set dispatcher ID.
Below select units for retranslation. To do this, move units from the left list (available units) to the right list (units for
retranslation) by double-clicking on a unit or using the arrow-shaped buttons. Besides, you can input a new ID for units
to be retranslated. To retransmit data by Granit Navigator protocol, unit ID should be a number in the range from 0 to
65535.
Attention!
Data from units with empty IDs cannot be transmitted. For that reason, such units are not saved in the list of units for
retranslation and when you reopen the dialog, you will see them in the left part again.
148
When a new retranslator is created, it is stopped. It can be started from the list of retranslators or in the dialog of its
properties.
In the results panel, you can see retranslator's name, creator, retranslation protocol, server address, state, and buttons
to start/stop retranslator and delete it. Click on a retranslator to view/change its properties.
149
Import and Export Table of Contents
Import and Export
Import/Export Subject
The Import/Export tool is designed to easily transfer and copy different objects and their Import/Export Destination
properties. The Import/Export tool is available in both Wialon Local interfaces — manager's and Required Access
user's. To open the tool, click on a corresponding button in the top panel of CMS Manager or in
the bottom panel of the main interface.
Import/Export Subject
Moreover, you can choose particular items to be imported/exported, for example, you can indicate not all but certain
service intervals or sensors (for units), certain geofences and jobs (for resources), etc.
Import/Export Destination
Data can be imported and exported via files or directly from one object into another.
Exporting to a file gives you possibility to store data on disc and use it when necessary. For instance, you can create
templates of unit properties, which makes it considerably easier to create and configure new units. Two file formats are
supported:
1. WLP is a native format for Wialon. It can be used to store and transfer different kinds of data like unit
properties, resource contents, and user settings.
2. KML (if compressed –– KMZ) is a widely known file format used to display geographic data in Google
Earth and Google Maps. This format can be used in Wialon Local to exchange POIs and geofences
between resources as well as import and export POIs and geofences from/to external sources.
Exporting to an object allows you to transfer data (properties or contents) straight from an object to another object of
the same type or to several objects at once. For example, you can copy geofences from one resource to another.
Required Access
Access rights are important for import/export. Bear in mind two simple rules:
1. You can export from an object only those properties or contents that are available to you (you should have
at least view access to these properties in the originated object).
2. You can import into an object only those properties or contents that are editable for you (you need 'create,
edit, delete' access to these properties of the destination object).
See more:
150
Import from WLP
This option allows you to import unit properties, resource contents, or user settings from a WLP file to an object of the
appropriate type. It makes sense only if you already have any WLP files.
Indicate the path to the file and press Upload. The file will be processed on the server, and available contents will be
displayed in the section Import options. At the same time, in the section on the rights (Destination items) objects of
proper type will be displayed.
Note.
Filtration by measurement system takes place in this list, because you cannot import data if the source and destination
items have different systems of measurement. For more information see the section Conversion.
If the loaded file contains unit properties, all available units will be displayed on the right; if it contains resource
contents, all available resources; if it contains user settings, all available users.
Check data to be imported on the right and select destination objects on the left. Use the dynamic filter to quickly find a
necessary object. In case of units, they can be filtered not only by name but also by device type, creator, custom fields
(if these properties are accessible), or unit groups.
For unit properties (such as sensors, custom fields, commands, service intervals) and resource contents you should
choose also export type:
Replace:
data will be replaced completely.
Merge:
items with the same name will be replaced and the new items will be added.
Append:
items with the same name will be left intact and the new ones will be added.
At the end press OK. See the log to check whether the operation has succeeded.
151
Export to WLP
This option allows you to export data from an object to a WLP file or straight to another object.
Choose object type (unit/resource/user) in the dropdown list Export from. Then select export destination – to a file or an
item.
Export to an item
In the Source items section, select an origination item (just one). When a certain item is selected, its available
properties or contents are displayed on the right, in the section Export options. Choose data for export. To tick all items
at once, hold <ctrl> key and select any item. Repeat the same operation to uncheck all items at once.
If you perform export to an item, then the Import dialog described above is displayed. Select destination objects there
and press OK.
Export to a file
You can choose one or more objects to export them to a file. To select multiple items, use <ctrl> or <shift> keys.
However, note that when exporting several objects subitems of Commands, Sensors etc. cannot be expanded. Thus,
you can export only the whole contents of such tabs.
You can additionally type a name for the file. Otherwise, the file will be named after the origination item (if only one is
chosen) or have a name like 'Units'/'Resources'/'Users' (if multiple items are selected).
152
If you export to a file, then after you press OK, file is stored on the disk. As a result, you get a single WLP file (in case
of one source item) or an archive with several files (in case if multiple source items).
153
Import from KML/KMZ
This option allows you to import POIs and geofences from a file to a resource.
Indicate the path to a proper file and select object type (geofences or POIs). Then press Upload. The file will be
processed on the server, and its contents will be displayed below. Check items to be imported and select a destination
resource. In the dropdown list, you can see only those resources to which you have access Create, edit, and delete
POIs or Create, edit, and delete geofences correspondingly.
When all settings are adjusted, press OK. If the executed file contains any developed geofences (lines, polygons), they
will be omitted if you are trying to convert them into POIs. Only circle-shaped geofences can be transformed into POIs.
However, any POI can become a circle-shaped geofence, but with this it will lose its image and title formatting, and
other geofence properties (address source, ride beginning/end) will be set to defaults. POI with zero radius will acquire
default radius – 100m.
See the log to check how the operation goes. If the import failed, you get a warning alert.
You can check the result of the operation if you open the appropriate panel (POI or Geofences) and apply a filter by
resource. New items will be selected in the first column of the list. It allows to not only see them on the map, but also
easily delete them all together if necessary.
154
Export to KML/KMZ
This option allows you to export POIs or geofences from all available resources to a file.
When you export to KML/KMZ, the list of all available POIs or geofences (depending on item type chosen) is displayed.
Check items you want to export and press OK. Optionally, you can enter file name and compress file as KMZ. After
that, press OK and save the file.
155
Unit Properties Transfer
Almost any unit properties can be imported and exported:
General properties: unit name, device type, phone number(s), unique ID, device access password (from
the General tab).
Device configuration: device configuration parameters (from the General tab).
Counters: current values of counters and their calculation parameters (from the General tab).
Report properties: five upper parameters from the Advanced tab.
Advanced properties: color schemes for sensors and tracks from the Advanced tab as well as messages
filtration parameters form the same tab.
Sensors: contents of the Sensors tab.
Custom fields: contents of the Custom Fields tab.
Commands: contents of the Commands tab.
Trip detector: contents of the Trip Detector tab.
Fuel consumption: contents of the Fuel Consumption tab.
Service intervals: contents of the Service Intervals tab.
Exceptions are icon, access, groups, and information about account and creator. These properties cannot be
transferred. In case you need this data to be transferred (except account/creator), use the copying option.
Units with the same unique IDs within one device type as well as units or drivers with the same phone numbers cannot
exist in the system. If you are attempting to import such fields, their values will be emptied, and you can edit them later.
156
Resource Contents Transfer
Any contents of a resource can be imported and exported:
POIs
Geofences
Jobs
Notifications
Drivers
Trailers
Report templates
POI images, like unit icons, cannot be imported and exported. If you need them transferred, use import/export through
KML/KMZ files. Besides, KML/KMZ files can be used to convert POIs to geofences and vice versa (if they are circles).
See Import from KML/KMZ and Export to KML/KMZ.
Photos of drivers and trailers cannot be exported either. If you need to transfer them, you can use the copying option
instead of import/export.
Note also that drivers with the same phone numbers (or with phone numbers that belong already to some units) cannot
exist in the system. If you are trying to import such phones, their values will be emptied, and drivers will be created
without phone numbers.
If a report template contains parameters to filter intervals by geofences, these parameters should be checked (and
probably corrected) when the template is copied to another resource. It is because geofences can be tied to a template
only within the same resource. It is also possible that connection with units could be lost because the new owner of the
template may not have enough access to those units.
This is a similar situation with jobs and notifications if they concern geofences, units, users, reports, groups etc.
Remember that imported jobs and notifications can work correctly only if geofences and templates are checked and
access to units/users/groups is proved.
157
User Settings Transfer
Individual settings can be transferred from one user to others or stored in a file.
You can import data from User Settings dialog, the tabs Settings, Maps, and Monitoring Panel. For this, you are
required to have access 'Edit not mentioned properties' to a user you are importing into. Most of User Properties can be
imported, too (the tabs General, Advanced, Custom Fields). To import them, you should have access rights 'Change
flags for given user', 'Edit not mentioned properties', and 'Manage custom/admin fields', accordingly. Such unique
settings as e-mail, password, account information, access rights, etc. cannot be transferred.
You can also create a complete copy of a user. It will include not only above-mentioned parameters but also some
hidden parameters (like operational settings for Apps).
Note.
Settings imported to a user can be applied only after this user refreshes the page or reenters the system.
158
Conversion Table of Contents
Conversion
Conversion Effects
Wialon Local works with two measurement systems: metric and U.S. The corresponding For Units
parameter could be set for units, resources and users during their creation. Measurement For Resources
For Users
system for routes depends on user's settings at the moment of creation. For Routes
The system of measurement for the objects which already exist could be changed with the help of conversion. Only the
top level managers have the Converter button in the top panel.
The table below provides you with the units of measurement (and their abbreviations) for both systems:
Metric U.S.
Mileage (large values) Kilometers (km) Miles (mi)
Mileage (small values) Meters (m) Feet (ft)
Speed Kilometers per hour (km/h) Miles per hour (mph)
Fuel amount Liters (lt) Gallons (gal)
Fuel consumption Liters per 100 kilometers (lt/100 km) Miles per gallon (mpg)
Temperature Degrees Celsius (°С) Degrees Fahrenheit (°F)
Area (large values) Square kilometers (km2 ) Square miles (mi 2 )
Area (small values) Square meters (m2 ) Square feet (ft2 )
In the dropdown menu, choose an object type (units, resources, users) over which a conversion will be made. To the
right of the dropdown menu there is a brief description of the actions to be made over the objects of a corresponding
type.
Below the object type, you choose a conversion pair: from metric into U.S. or from U.S. into metric system,
correspondingly. If you choose “Metric U.S.”, a list of objects currently using the metric system is formed below. If the
conversion pair is “U.S. Metric”, then the list of objects currently using the U.S. measurements is formed.
In the list you choose the objects which should be converted. To add these objects for a conversion you should double-
click them with the left mouse button or select an object and press 'Add'. The added objects form the list on the right.
To remove items from this list double-click them with the left mouse button or select and press 'Remove'. To select
multiple items, click on them with the left mouse button holding <Ctrl> button pressed on the keyboard. To implement
conversion of the added items press OK. Then confirm your actions in the appeared window. Conversion result can be
observed in the log.
Conversion Effects
Ideally, users have the same measurement system as resources and units used by them. In this case everything that
the user can see during online tracking in different panels and dialogs and also everything that is received by e-mail
using jobs and notifications has the same system of measurement.
For Units
If a conversion is made over units, then units' parameters such as trip detector, fuel consumption settings, counters,
etc. will be recalculated. This affects units' representation in the tracking system. Changes will affect not only units'
properties, but also displaying of their messages, tracks, tooltips and etc.
Note.
A conversion doesn't influence unit sensors. If it is necessary, their measurement system could be changed
manually switching on/off the 'American system' option.
159
For Resources
If a conversion is implemented over resources, then some contents of these resources, particularly, POIs, circle-
shaped geofences, different settings of jobs and notifications, etc. will be recalculated to the other measurement
system.
Note.
Measurement system could be set individually in the section of advanced settings for every report template
regardless of the resource it belongs to. Units of measurement chosen for one or another report template are given
in the resulting report (whether made online or received according to a job or notification). Neither resource
measurement system nor measurement system of a unit is taken into account.
For Users
If a conversion is made over users, then the measurement system for the chosen users will be changed. It will affect
different online calculations, particularly the work of such tools as Distance, Area, Routing, Nearest units. Address
defining parameters will be recalculated as well.
Besides, a measurement system set for the current user is chosen automatically during creating report templates,
units, other users, resources (regardless of who is chosen as creator or in which resource an item is created).
Herein, on the stage of the items' creation, a measurement system could be changed manually. It doesn't concern
such items as POIs, geofences, jobs and notifications, because their measurement system is taken from a resource
they belong to.
For Routes
Conversion made over routes touches only their checkpoints — their radius.
160
Apps Table of Contents
Apps
Installed
Using SDK, you can implement your own tools and features and add them to your Wialon as Library
additional applications.
Only the top user can manage applications. To open the Apps dialog, click on the wrench icon in the top panel.
In the Apps dialog two tabs are situated: Installed and Library. Using these tabs you can look through all the
applications available at the moment and add them if necessary.
Installed
A list of added apps can be found on the Installed tab. There are four basic applications available to all users:
Chatterbox, Dashboard, iDriveSafe, Track Player. They cannot be edited or deleted (only disabled).
This tab also serves for adding new applications. To do so, choose the upper item 'New' and enter parameters. The
parameters to configure an application are the following:
Name
Enter a visible name for your app (at least 4 characters).
Description
Enter any text as a description of your app (optional). It will be shown in a tooltip for your application when it is
displayed on the list of applications available to a user.
URL
Type URL address where your application is placed.
Required services
Choose services (features) which are required for default activation of the application. If the list of features available to
a user does not fit this list (or if you leave this section empty), the application will be disabled for this user.
Billing plans
Select billing plans where this application will be mentioned as a service (feature). If no plans selected, your
application will be added to all available billing plans.
Compatible languages
Application availability can be limited by chosen interface language. For example, if you tick English here, it will mean
that the application will be available only when English is chosen as interface language. If no languages selected, it
assumes that the application is compatible with all languages.
After setting all parameters, press Add and when closing the dialog press OK to save the changes.
To change an application, select it on the left, edit parameters, and press Apply, and then, when closing
the dialog, press OK.
To delete an application, select it on the left and press Delete, and then, when closing the dialog, press
OK.
To create a new application from an existing one, select the base application on the left, edit parameters,
and press Apply, and then, when closing the dialog, press OK.
To ignore all the changes made, press Cancel.
161
Added applications become available in billing plans and in account properties on the Features tab. They look like
other services, but with 'Apps:' in front of a name of an app. You can enable and disable applications added by you
and control their availability to other users.
Library
The list of all standard apps is situated on the Library tab. Adding application from the library is a little bit easier as all
the mandatory parameters and also the advanced URL parameters are indicated by default.
Choose an app on the list to see detailed information about it on the right: an app's icon, its name, short description,
URL address, and the date of release. If the application has not been added before, the Add button should be active.
Pressing this button will switch you automatically to the Installed tab. There you can edit app operational parameters if
needed (for example, you can change or translate a description). To complete the procedure press Apply and then
OK.
162
Monitoring System
The monitoring system is used by end users to control their units (vehicle fleet, machinery, employees, pets, etc.).
observing dynamic change of various unit parameters such as speed, fuel level, temperature, voltage, etc.;
management of units (sending commands and messages, assigning jobs and routes, adjusting
notifications, etc.) and drivers (phone calls, SMS, registering work shifts, binding to unit, etc.);
interpreting information derived from a unit in various kinds of reports (tables, charts, movement tracks,
event markers, complete statistics, etc.);
Tracking results can be either presented on a computer screen or exported to files in different formats.
163
System Optimization Table of Contents
System Optimization
Web Browser
Consider these requirements to get the most from Wialon Local. Computer Capability
Internet Connection
Optimization Measures
Web Browser
To make its performance better, it is recommended to install Chrome Frame plugin that is compatible with Windows
7 / Vista / XP SP2.
If you use a browser not mentioned above, Wialon may function incorrectly.
Computer Capability
Computer capability affects browser operation. The key points of high performance are CPU (central processor) and
RAM capacity. Multi-core processors do not affect browser operation in most cases. The exception is Google Chrome
that can use more than one core in its operation.
Monitor size and screen resolution should be also considered. The bigger the monitor is, the more data is queried
from server and processed by CPU. It is especially true for the maps and when the Internet connection is slow. The
solution for big monitors is to not use browser in full-screen mode.
Antivirus software can slow down computer performance as well as gathering actual data from units. If Wialon is
getting slower, you can add it to the list of exceptions or simply disable antivirus monitoring during Wialon session.
You can also create a rule which allows Wialon to develop any activity.
Internet Connection
Wialon requires 1 Mbit Internet connection channel for one computer. If more than one operator will work
simultaneously, do some tests and choose the most appropriate speed.
Furthermore, when working with Wialon, your IP address should not be changed within a session.
Optimization Measures
Here are some tips, which will help you to improve Wialon performance in cases when more than a hundred units are
connected.
1. Web Browser
Web browser is very important. See the list of supported browsers above. The most efficient is Google Chrome. It is
164
followed by Mozilla Firefox and Opera. The slowest, according to our tests, is Internet Explorer.
Wialon efficiency strongly depends on browser event system. Each browser has its individual event model. As the
tracking system is rather dynamic and tracks change with up to 2-second delay, some browsers (like Internet Explorer)
cannot process such a large quantity of events. The solution here is to use a more powerful computer.
Graphic elements displayed on the map and in lists are resource-consuming. If you notice that your browser is getting
slower, try to disable the mapping of the following elements: units, geofences, places, tracks, as well as names,
direction arrows, and 'tails' for units (these elements are disabled with the three corresponding buttons in the bottom
panel. Limit the number of units displayed in the Monitoring panel. Limit the number of other objects displayed on
other panels that are frequently used (apply the filter for doing that). Enable only those elements that are necessary for
your work at the moment. Several settings to adjust the way units are displayed are set in user settings in the section
'Unit visualization on map'.
Unit's tooltip contents are also important. In User Settings dialog in the section 'Show additional information about the
unit', you select which information should be presented in unit's tooltip and in extended unit information. To avoid
browser overload, disable unusable items or even all items. If there are a lot of geofences or geofences composed of
multiple points and the option 'Presence in geofences' is enabled, then your browser could be strongly overloaded. So,
make sure this option is disabled.
3. Queries to Server
When Wialon Local starts, not all data is loaded at once. It is made to speed up the loading and operation. That is
why some action that done for the first time may take more time than for future work. Resource-consuming reports
(such as reports on groups or reports with grouping and detalization) should be avoided. Enclosed rows of detalization
stay hidden until you expand them, and if there is a hundred or more enclosed rows the browser may hang.
165
User Interface
User interface of Wialon Local is simple and in many cases intuitive. There are plenty of screen tips and helpers
associated with various buttons, icons, dialog boxes, edit fields, and other elements of the interface.
Generally, the following basic structural elements could be distinguished in the interface design:
work area
map
top panel
bottom panel
log
There are also a lot of other different panels and windows which could be activated if necessary.
Notice.
To switch for the full-screen mode, press <F11> button. This feature is provided by the majority of browsers.
Further information:
Login
Top Panel
Work Area
Bottom Panel
Map
Log
Shortcuts
Calendar
Filters and Masks
Input Rules
166
Login Table of Contents
Login
New Password Receiving
Enter service URL into the address line of your browser. How to Change Your Password
Login as Another User
On the login page, type your username and password given to you while registering, choose
interface language, and then press Enter.
If you are using a private computer, you can additionally put a check mark near Remember on this computer. In this
case, the next time you enter the system you will not be asked to input your login and password again. The first thing
you see when entered the system is the Monitoring panel.
Note.
If current time is displayed in red and in the middle of the screen you can see a warning message (“Unable to connect
to the server. The page will be reloaded automatically when connection is restored”), then connection to the server has
been lost for more than two minutes. It could be caused by Internet connection failure or some internal system
problems. After connection is restored the message disappears automatically, and the system continues its work. In
case of server connection loss for 5 minutes and more the session will be finished. However, upon server connection
restoration, an automatic entrance to the login page takes place.
A quick login without entering (or even knowing) user name and password is possible, provided that there is an active
session available. Then URL link should contain the sid parameter, e.g.,
http://wialonb3.gurtam.com/?sid=3086417ea744b0dbb85202cebe3ff134. Note that a login to the system through such
a link can be successful only within one IP address. However, be careful giving away such links as while the session is
alive anyone having this link can login to the system and perform different actions allowed to that user. To abort a
session, just exit the system (press 'Logout').
If you have already registered in the system but forgot the password, please, follow Forgot your password? link.
There you will be asked to enter your user name and e-mail address indicated during registration. Then push the
Reset password button. A password reset link will be sent to you. Follow this link to get your new password.
If you have pressed Forgot your password? by accident, just ignore the e-mail with password reset link and use your
former login and pass. If you still follow this link, you will have to accept the new password.
167
How to Change Your Password
The current password can be changed after authorization in the User Settings dialog. However, not all the users are
allowed to do this. Contact your service administrator for additional information.
It is possible to login to the system as another user (either to the monitoring interface or to CMS Manager). To do so,
you need to have 'Act as given user' flag in access rights for this particular user.
To login as another user, enter your user name and password, as usual, and then click on Login as caption and enter
login name of a needed user.
When you are logged in as another user, you can see only items available to this user and perform actions allowed to
this user. Herewith, login history is saved to this user.
You can switch to another user even after entering the system, however, in this case login will not be saved in the
user's history. Go to the Users panel and you will find the 'Login as' button against each user. If you do not have
enough access privileges, the button will be disabled.
After authorization as another user, the user name is written in brackets to the right of the main one (in the right corner
of the Top panel). To switch back to the main user, click on the current user name, choose Switch User and in the
appeared window select a main user (will be highlighted in bold). This window could be used to login as another user
after authorization as well.
168
Top Panel Table of Contents
Top Panel
User Menu
The logo of tracking services provider is situated in the left corner of the top panel and in the Information Notices
right corner you can see the setting menu button and user name under which you have logged
in to the system.
The main menu of the program occupies the central part of the top panel. It could contain different elements depending
on the settings applied and also on the modules provided.
User Menu
User login is displayed in the right corner of the top panel, under which an
authorization has been made. Meanwhile, the other login could be specified in
brackets if the main user logged in under the other user's name.
Clicking on the user's name an additional menu appears. It contains the following
options:
User settings
Opens the user settings dialog for viewing and/or editing.
Switch user
Enables to login as another user. Could be disabled.
Import/Export
Enables to transfer units' settings, users, resources' contents (refer to Import and Export).
Help
Help request. Could be unavailable.
Support
Technical support request. Could be unavailable.
Logout
Button to log out of the system (session termination).
'Help' and 'Technical support' are links to outside Internet resources containing either documentation or technical
support. By default, they are disabled. These options can be activated on the site settings' corresponding tab of
administration system.
Information Notices
Information notices from service manager could appear in the top panel under the user's name, as well as notices on
the amount of days left before blocking the monitoring system (if stipulated by the tariff agreement).
169
170
Work Area Table of Contents
Work Area
Main Menu Adjustment and
Work area, where different actions with various elements of the system take place and different Navigation
requests to be composed, is situated in the left part of the screen. Layers on the Map
Alternative Means of Navigation
Depending on the tag chosen in the top menu, one of the following panels could be opened in
the work area:
Top menu also could include two panels which are not shown in the work area. They have their separate windows.
They are:
Tools — tools for calculation distance and area, laying the best routes, searching for the nearest units, etc.
Apps — applications enabling to tackle with various user's targets.
The width of the work area could be changed. To do this, please click on its right border and drag to the direction
needed, holding the mouse button pressed. Moreover, work area could be hidden completely by pressing the button
situated in the left bottom corner .
To adjust the main menu click on and select the menu items which you are going to work with. The chosen ones
should immediately appear in the top menu.
A name of a panel currently opened in the work area has a darker ground. To navigate through the menu, you just
need to click on the necessary name. Contents of the left panel (work area) will change automatically.
Keyboard shortcuts are used for faster navigation through the panels.
171
All the range of items chosen for the main menu is displayed at the top. The names of the panels will be shortened if
there is a lack of space. That is why you should choose only those items which you are currently using.
The name of each panel is accompanied by the corresponding icon. It serves not only for a fast identification of the
panel, but in some cases - as an indicator of the layer on the map (whether it is on or off).
Layers are relevant for many, but not for all panels. For example, in messages panel a unit's traffic track for a chosen
period of time could be shown on the map, in monitoring panel - units' icons, showing their current location, etc. At the
same time, in jobs and users panels there is nothing to be shown on the map.
Any of these layers could be switched on/off randomly. Panel's icon is used as a switch. If it's highlighted in color, then
the layer is switched on; if it's black-and-white, then the layer is switched off or this particular panel could not have any
layer on the map.
After adding any panel to the menu, the icon of the panel is activated automatically. Remove a panel from the main
menu and its layer is automatically removed from the map.
If size of a browser window is not large, but there are a lot of panels selected, inscriptions could possibly be not
visible, and menu panels would be presented just with icons. In such cases clicking on the icon mostly leads to
switching on/off the layer on the map. Therefore, in such cases to switch the panels you should additionally hold <Ctrl>
on the keyboard.
Another means of navigation is through the menu settings window. Clicking on the name of any clause in settings
window, transition to the corresponding panel occurs. In such case, if it were not displayed in menu, it would show up.
Also, don't forget, that the layer will be activated automatically after panel's selection in menu settings window.
The same occurs in case of “forced” transitions between panels, for example, during report request out of monitoring
panel or during transition from reports to messages. Even if requested panel is not displayed in main menu, a
transition takes place successfully. In this case the corresponding clause is added to the menu and the layer becomes
active.
172
Bottom Panel
At the left end of the bottom panel you see three buttons to manage unit display mode as well as SMS button:
In the right corner of the bottom panel the following buttons are situated:
Current time and time zone shown in brakets (which could be changed in user settings) are displayed in the right
bottom corner.
Your copyright with the hyperlink to our web-site could be situated in the middle of the bottom panel.
173
Map Table of Contents
Map
Using the Map While Working
The map is available regardless of which panel is activated. Usually, it occupies the most of the with Different Panels
screen. Units and their traces, POI, geofences and other elements can be displayed on the Map Source
Map Navigation
map. Zooming the Map
Map size can be adjusted in relation to work area and log. To do so, drag map scale slider, which is situated in the
middle left part of the map, up or down.
To maximize the map size as much as possible, you can hide the work area and the log completely ( and
buttons) and switch to the full-screen mode by pressing <F11> that is supported by most of browsers.
The map is common for all panels. It means that while switching the panels, zoom and coordinates of the map center
remain the same. Graphic elements such as track lines, markers, POIs, geofences, units' icons stay on their places as
well. Therefore, for example, if you've made a report showing parking locations on the map, and then switched to the
tracks panel to create tracks for unit's movement (even if this is an absolutely different unit), all the graphical
elements, lines, markers, etc. still will be shown on the map, until you delete them or switch them off.
A lot of panels could have their layers on the map, such as: “Monitoring”, “Tracks”, “Messages”, “Reports”, “POI”,
“Geofences” “Routes”, “Drivers” and “Trails”. Graphical elements plot on the map in any panel, can be easily switched
on/off. Displaying or hiding one or another layer is adjusted for every layer individually - using special switch-button,
situated in front of the panel's name in top menu. More...
Map Source
To change a map source, click button in the bottom panel. Map choosing menu is conditionally divided into two
sections, top and bottom one. Top section contains main map layers, i.e., map sources. Bottom section contains
additional or, in other words, informational layers which overlay the main ones (traffic, weather, etc.). Choose another
map from the list and the map area already displayed on your screen will be reloaded from the other source. It is
applicable to the main map as well as to the mini-map.
174
To activate more maps, go to User Settings. There, as well, you can save current position of the map for the further
system logins. If you don't have an option for enabling some particular kinds of maps, please, contact your tracking
system administrator.
If additional map layers are available, then they can be displayed on the main ones. In other words, all the maps can
display the information on road traffic or weather condition. To enable it, you should select the corresponding flag in
the section of additional layers in the map choosing menu ('Google Weather', 'Google Traffic', 'Yandex Traffic').
Attention.
A map, chosen in this menu influences only the displayed (graphical) map layer. Geocoding (address definition, etc.) is
implemented mainly in Gurtam Maps.
Map Navigation
There are three basic ways to navigate through the map (or, more precisely, for moving a map on the screen).
175
Map zooming can also be implemented in several ways:
In the left bottom corner of the map the current scale of the map is indicated. Right bottom corner shows us
geographical coordinates, mouse cursor is pointed on. Coordinates' format can be either degrees or degrees and
minutes. It can be selected in User Settings => Maps.
176
Log
Log is an interface element, enabling to look through records of current operations, such as: new message/SMS
receiving, unit configuration changing, etc. The log contains messages from units in the work list. Depending on
quantity of units and equipment configuration, the messages in the log can be received even every second.
Show/hide log button is situated on the bottom panel. A size of the log could be adjusted. Pointing on the upper
border of the log a cursor changes its shape to a vertical double arrow. It means that by clicking on this border and
dragging it up or down you can change the size of the log. The log window is semitransparent, this allows map and
units to be always visible under the log.
If an event registered in the log happens in a certain place (for example, a new location of a unit is detected), you can
move to this place on the map clicking on the black arrow at the end of the entry .
The log uses fonts of different colors in order to separate different type of entries from each other. The black color is
used for registering unit's state, changing of its location, receiving new SMS messages from units and etc. The green
indicates user's activity: creation and editing of places, POIs, geofences, user settings changes, etc. Red color is used
to display error messages and alarm messages from units.
177
Shortcuts
Keyboard shortcuts ensure more convenient and quick means to navigate through the system. This feature is activated
in User Settings.
M — Monitoring;
T — Tracks;
E — Messages;
R — Reports;
P — POI;
G — Geofences;
O — Routes;
D — Drivers;
I — Trailers.
J — Jobs;
N — Notifications;
U — Users;
Y — Units;
Z — Unit groups.
1 — Track Player;
2 — Distance;
3 — Area;
4 — Address;
5 — Routing;
6 — Hittest;
7 — Nearest units;
8 — SMS.
Other shortcuts:
A — Apps;
S — User Settings;
~ — show/hide Left Panel;
L — show/hide Log.
178
Calendar Table of Contents
Calendar
Method 1.
The calendar is used in many cases: specifying time intervals Method 2.
The calendar date includes year, month (word) and day. Date mask chosen in a current
user settings dialog influences only the arrangement order of a year, month and day.
The earliest possible date is the 1st January 1971.
Concerning time, its format corresponds to the mask chosen in the user settings dialog. The only exception is that
regardless of the mask chosen, seconds are not displayed in the calendar.
There are several methods to handle the calendar and quickly set up a desired date and time: manual input, clicking
buttons, using mouse scroll, etc.
Method 1.
Date and time can be adjusted without opening the calendar itself – in the text field above it.
You can input numbers straight from the keyboard or use the mouse scroll. Place the cursor over time element you
want to alter and scroll up (increase value) or down (decrease value).
Method 2.
If you open the calendar, you can adjust date and time clicking on the appropriate buttons: on the top of the
calendar – single arrows for months, double arrows for years; on the bottom – arrows for hours and minutes. To
change these values you can either click on these buttons or use the mouse scroll. Besides, time can be time on the
keyboard.
To finish with date/time selection, choose a day in the central part of the calendar. Only then your adjustments will
be applied and the calendar will close.
Method 3.
Today's date can be set with one click. Open the calendar and press the Today
button. This action affects year, month and day but not exact time.
Method 4.
Click on month and year area in the top of the calendar. Year field will appear below. Enter a year using keyboard,
click on a month below and then select a day.
179
The Persian Calendar
There was the usual Gregorian calendar. However, Wialon works also with the Iranian calendar also known as Persian
solar calendar. It is used in Iran and Afghanistan.
The Persian calendar can be activated in User Settings. At that, if Arabic is selected as interface language, the
calendar will be in Farsi (language spoken in Iran) and shown from right to left. Otherwise, it will be in English (in Latin
characters and Arabic numbers) and shown from left to right.
In this calendar, you can adjust year, month, day and time, set the today's day with one click, etc. Click the question
sign on the top to invoke the help window with detailed information. To close the calendar, click on a cross. Besides,
you can drag the calendar to any place of the screen.
180
Filters and Masks Table of Contents
Filters and Masks
List Formation
Filters and masks are applied for users' convenience. They enable to narrow a list of items in Dynamic Filter
such a way that only the objects necessary for users will be shown. Also, you can find objects Name Mask
Drop-down Lists
with particular characteristics or name in a list and specify the objects of tracking system
towards which a report, notification, etc. will be applied.
List Formation
Lists are composed of various objects created in tracking system (geofences, POI, drivers, custom fields, sensors,
etc.) Objects from the lists are shown in the alphabetic order, provided that the figures go first, then Latin alphabet
letters, and then Cyrillic. Capitalization is not taken into account. New object created (for example, new job or custom
field) is originally added to the end of a list. Next time you open this list the objects will be arranged in the alphabetical
order. After renaming an object it remains at its former place until reopening the list.
Dynamic Filter
If a list contains a great number of items, it may not be so easy to find a necessary one quickly. For your convenience,
you can use quick dynamic search. It is applicable for all the panels, except for Tracks. Start entering item's name
(geofences, units, routes, etc. — depending on the panel you currently in). A name could be typed beginning from any
part. While typing items that correspond to your query will be immediately displayed.
If you leave the filter field empty, all the items will be displayed in a list.
The dynamic filter can be found also in properties dialog of units, unit groups and users when adjusting access rights.
However, the difference is that search results are displayed not while typing but after you press the Apply button.
The particularities of the dynamic filter usage in the Monitoring panel are described in Unit List Management section.
Searching you can enter special characters such as * and ?, the usage of which is described below.
Name Mask
Besides the dynamic search, filters are also used for specification of an item, which will be effected by report,
notification, etc. Item's name mask is created for this purpose, there you can apply special characters: “asterisk” (*)
and “question mark” (?).
The asterisk sign is a special symbol, which could be inserted in any place of the word in a search field to represent
any combination of symbols allowed. The asterisk sign could be put in any place of a search field It can be placed in
any place of the query (at the beginning, in the middle, at the end) or in several places at once, depending on which
part of the name is known or is the same for a number of items. For example, if you type *h*nda*, all Hondas and
Hyundais will be found.
Another wildcard symbol that can be used is the question sigh (?). It replaces any single character (only one
character). As well as the asterisk sign, it can be put at any place of the query.
181
The request is not case sensitive.
For example, a unit has two fuel sensors with the names Sensor fuel level and Fuel in tank. We are going to create a
notification that would be based on both of them. To achieve it, in notification properties we must set sensor name
mask in such a way that it would correspond to the names of both sensors. In our case, the best choice is *fuel*:
You can do a search without using the asterisk but then you have to indicate the name (geofence, driver, sensor, etc.)
exactly as it exists in the system.
To find all items of some kind (users, sensors, geofences, etc.), simply type one asterisk in the input box of search
terms.
in notifications to specify sensor, route or driver under control as well as set SMS text mask or parameter
in messages;
in user properties to set host mask for users;
in reports to specify driver, sensor, event/violation, route and its geofence, and when selecting geofences;
in the Messages panel to filter found messages;
in all panels masks can be used instead of the dynamic filter.
Drop-down Lists
Means of quick search are also developed for the drop-down lists. For example, this could be the list of units available
during reports' generating, messages' request, etc., list of tables during report templates' editing and so on.
To apply quick search open the list and then enter on keyboard the first letter of item's name. Whether to use capital
or lower-case letters is not important, the important thing is a keyboard layout. If the list consists of names, beginning
with a specified letter, the list will shift to the first of them.
Continue to press the same button, and you will keep going through the list, highlighting other items beginning with
this letter, and after showing all of them, return to the first one. Moreover to navigate through the list you can you
arrows (up/down) and combinations of keyboard buttons <ctrl + home> (move to the beginning of the list) and <ctrl +
end> (move to the end of the list).
You can specify the beginning of the name with more than one letter, to do so you need to enter them quickly, while
182
one letter search hasn't been applied yet.
When the choice is made, press <ENTER> on the keyboard. The drop-down list folds up and the necessary item is
chosen.
183
Input Rules Table of Contents
Input Rules
Incorrect entries are:
All editable fields are checked to approve that entered data is valid. If there is incorrect data, Phone numbers and e-mail
Excessive number of characters (more than 50) in names of monitoring units, units groups and users.
Letters in numeric fields (phone numbers, sensor values, radius, fuel consumption and trip detector
settings, etc.)
Forbidden characters:
double quotation marks ''
curly brackets { }
the backslash \
Using angle brackets ('>' and '<') is allowed but not recommended as, in some cases, they will be automatically
substituted for '>' and '<'.
If any entry in a dialog is not valid, it is impossible to save changes or create an object, because OK button
becomes not available. There can be also an alert when trying to save incorrect data – Incorrect entry.
E-mail addresses must be in the format user name – the “at” sign (@) – domain name. E-mails can contain letters
of Latin alphabet as well as dots (.), hyphens (-) and underscores (_). Example: username@domain.net.
184
User Settings
Users can configure some system operation parameters according to their needs and
tasks.
To view user settings click on the username in the top panel and then press User
Settings button in the popup window.
The User Settings dialog can contain up to three tabs that depend on system
configuration:
General Settings
Maps
Account
Hint.
Settings from one user can be imported to other users. More....
185
General Settings Table of Contents
General Settings
Show Additional Information
The first tab of the User Settings dialog contains general settings. Here you indicate your time about the Unit
zone, input your e-mail address, change the password to enter the system, and set many other Unit Visualization on the Map
POI Visualization on the Map
parameters. Geofence Visualization on the
Map
Language
The language menu. Contact your service administrator to enlarge the list of available languages.
Time zone
Indicate your time zone accurately because all time values in messages got from devices are displayed in accordance
with time zone selected. Changing time zone requires reloading the page.
Persian calendar
This option allows to activate the Iranian calendar also known as Persian solar calendar. It is used in Iran and
Afghanistan. If the option is chosen, the Persian calendar will replace usual (Gregorian) calendar in the places where a
user should indicate some time interval (to build a track, to query messages or a report, to setup a job or assign a
route, etc.) At that, if Arabic is selected as interface language, the calendar will be in Farsi (language spoken in Iran)
and shown from right to left. Otherwise, it will be in English (in Latin characters and Arabic numbers) and shown from
left to right (see details). Enabling/disabling the Persian calendar requires reloading the page.
186
Measurement system
This parameter defines whether kilometers and meters ('Metric') or miles and feet ('U.S.') will be used in tools like
Distance, Area, Routing, Nearest Units. It also affects address processing in some way, as well as creation of routes.
However, in most other places of the tracking system measurements used depend on either unit's or resource's
properties and not on current user.
E-mail
This e-mail address will be used to send you a reset password link in case you forget your password.
City
In this field you can indicate your city. It will be used in the Nearest Units and Address tools as the default city. Enter
the full city name or its beginning, and in the dropdown menu below confirm your choice selecting a needed city from
the list (there can be several towns with the same names in different countries).
Change password
If you push this button, some additional fields will appear. You will be asked to input your current password, and then
your new password (two times). New password can be applied on the login page. Note: However, not all users are
allowed to change their passwords.
Use shortcuts
Check this box to activate Shortcuts.
Here you choose additional information about the unit to be displayed in different places of the tracking system.
In the left column, check information to be shown in unit's tooltip (displayed as you hover mouse pointer over unit's
icon).
In the right column, check items to be shown in extended unit information in the work list.
Last message
Time when the last message was received and how long ago.
Location
The last detected address (or coordinates).
Presence in geofences
If unit is situated in a geofence, geofence's name will be displayed in unit's tooltip and in extended unit information with
sorting by area (from small to large), and it will have the same color as assigned in geofence properties. This option
also affects units count in the Geofences panel.
Speed
Speed in the latest message.
Altitude
187
Altitude in the latest message (if device is able to give such data).
Counters
Values of mileage counter and engine hours counter. See Counters.
Satellites
The number of satellites locked.
Connectivity settings
Device type, unique ID, and phone number(s) which are specified in unit properties. This information is available to
users with 'Edit connectivity settings' access flag.
Sensors values
Sensors configured for the unit and their known values will be listed. Custom sensor name is displayed and the value
processed according to calculation table of this sensor.
Parameters
Latest known parameters like CAN bus, power voltages, and many others. Their names (as they come in messages)
and their raw values can be shown as additional information.
Custom fields
Custom fields from unit properties (general or/and admin fields depending on access).
Note!
Counters are refreshed once a minute, as well as information about drivers and trailers. The check for presence in
geofences is performed every two minutes. Other information is refreshed immediately.
Trace
It is possible to indicate the length of the trace which is added to a moving unit on the map (the 'Points in traces'
parameter), and choose the color and width for it.
188
advanced options of report template.
189
Maps
Maps settings are adjusted in User Settings dialog on the Maps tab.
Format of coordinates
Format of coordinates can be either degrees or degrees and minutes. Selected format affects coordinates of cursor
displayed in the lower right corner of the map. However, in messages and POI coordinates can be displayed only in
degrees; in reports and event registrar – only in degrees and minutes.
When a custom position is stored, the button changes to Reset to default state. It is then used to restore the default
map position. After pushing the button, you can leave this default position or set a new custom position because the
button changes to Store current state again.
Enable…
Tick the appropriate check boxes to activate more map layers. The changes will take effect after clicking OK and
refreshing the page. To choose a different map as a base layer, choose it in the maps menu at the top panel of the
program.
The following maps can be used in Wialon Local: Google Maps, Bing Maps, 2GIS, WikiMapia, Navitel, Visicom,
Yandex, Regio, Luxena, MyIndia, ArcGIS. Besides, Gurtam Maps or WebGIS (depending on your system configuration)
and OpenStreetMap are available by default.
Some maps go in blocks. For example, when you enable Google Maps, several map layouts appear on the menu at
once: Google Streets, Google Physical, Google Satellite, Google Hybrid, Google Map Maker, Google Map Maker
Hybrid, and Google Street View for tracking on mini map. Moreover, if the additional layers are available (traffic,
weather), then they can be visually put over any chosen map.
190
cities/towns/villages.
When out of cities/towns/villages (on motorways between them), address information is given according to the following
parameters:
Max distance from unit defines that if unit is on a road or close to it and there is a city/town/village in the
indicated distance then the address is displayed as name of the road and distance to that city (if several
cities fit, we take the nearest).
Min city radius defines that if no cities/towns/villages have been found in the distance indicated as 'Max
distance from unit' then the address is bound to the nearest city which radius is equal or larger than 'Min
city radius' values. This parameter can be used to eliminate small towns from address information and stick
to large cities instead.
191
Account
Attention! This tab could be unavailable due to the service configuration peculiarities.
On the Account tab of User Settings dialog you can view information on the billing plan, current state of account,
services used and available, etc.
The tab contains two sections: General and Statistics. In the General section, information on billing plan, current state
of account, balance and days left is presented. You see also how many objects (like POIs, geofences, devices, users,
etc.) you can create and how many of them already exist. The table specifies services, their status, limit and reset
interval. If the limit is 0, it means the service is unavailable. If you see a dash in the limit, it means that no limitations
are applied to this service.
In the Statistics section, you can see transactions for given period. Specify time period and push the Show button to
see statistics.
192
Monitoring Table of Contents
Monitoring
Additional Information about the
The Monitoring panel displays the work list of units and gives access to the basic features Unit
The work list can contain either all units available to the current user or just some of them.
Units can be easily added and removed from the work list, which does not lead to their removal from the system. See
how to manage the work list...
Near the name of each unit, there can be a number of buttons and signs that allows to estimate unit's state or perform
an action over it. The choice of signs and buttons to be displayed in the Monitoring panel is customizable. These
columns can be also used to sort units in the work list.
To open Monitoring panel, choose a corresponding name in the top panel or click on the necessary item in the main
menu customizer.
Unit's Tooltip
Hover the mouse pointer over the unit on the map, in the work list, or in a dialog to see detailed information about
unit current state in a popup info tip. The content for this tooltip is selected in User Settings.
193
Note.
All measurements used in the tooltip are taken from corresponding properties of the unit itself.
You can apply extended view to any number of units on the work list. To hide the extended information back, just
click on unit's icon again.
Attention!
Extended information is not available in the treelike view of units with sorting by groups.
194
Tracking Units on Map Table of Contents
Tracking Units on Map
Tracking on Minimap
To locate a unit on the map, click on its name in the work list. The map will be centered on this Unit Presentation on Map
unit. At that, current map zoom will remain the same. Alternatives for Icons
Other Markings
Only units checked in the first column of the work list are shown on the map. To display all
units from the work list, mark a check box in the left top corner of the list. Remove this checkbox to remove unit icons
from the map.
Note, that in order units to be displayed on the map you should check if the corresponding layer icon in the main
menu is active.
Units are seen on the map if they get into view according to the current map position. You can move and zoom the
map according to your needs.
However, if the option Show unit icons at map borders is selected in User Settings, in case a unit gets out of view, its
icon is displayed by map border. Click on the icon to move to the unit on the map.
It is possible to watch a unit constantly. For this, enable the option Watch unit on map against a necessary unit in the
corresponding column ( ) of the Monitoring panel. Units marked in this column are always seen on the map. If such a
unit gets out of view, the map automatically centers at this unit each time when a new message comes.
Tracking on Minimap
You can use minimap for tracking. This is an additional small window that opens in the right bottom corner of the
map. Only one unit can be displayed on this map. Position and scale of the minimap can be different from the main
map. Therefore, you can simultaneously track a unit on the minimap and manipulate the main map in different ways
– track other units, create geofences, generate reports, etc. At that, the selected unit is always in sight on the
minimap, and its position is refreshed automatically with each new message.
To open the minimap, press the special button at the bottom of the window. The minimap has three modes and
three functions correspondingly:
The first (navigational) function was described below. To track a unit on the minimap, click on it on the main map.
The minimap itself can be open before or after clicking on a unit.
195
In the tracking mode, the minimap cannot be moved – it is centered automatically by unit last location. However, you
can adjust the zoom level using +/- in the top left hand corner of the minimap. Above there is a button to switch
between navigation and tracking modes.
The tracked unit must be checked in the first column of the work list in the Monitoring panel. Otherwise, if you
disable this flag, the unit will disappear both from the main map and from the minimap, and the minimap will
automatically switch to the navigational mode.
On the minimap, a unit is represented by its icon and its name (or driver's name). Motion state signs, trace from last
messages, and sensor-based colors are not available. If you hover the mouse cursor over the unit, you can see
unit's tooltip with the newest information about the unit. If you click on a unit in the minimap, the main map is
centered to this unit too.
In addition, the third mode of the minimap can be activated — Google Street View. It allows tracking units on 'real'
streets. Google Street View is a technology featured in Google Maps that provides panoramic views from various
positions along many streets in the world (mainly in Western Europe, North America, Australia, Japan, Brazil, and
some others). You can observe buildings, roads, any surrounding objects, which creates an illusion of virtual
presence.
The third mode of minimap works only if Google Maps are activated in User Settings and if there is coverage for
requested geographical area.
By default, units on the map are displayed with icons assigned to them and their names (captions color is red). Icons
196
for units can be selected from a standard set, e.g. , or you can load your own image. See the dialog Unit Properties
=> Image. Unit icon can be rotated on the map according to course (movement direction). This feature is also defined
in unit properties.
yellow circle – the unit is not moving but the engine is on;
red square – the unit is not moving, and the engine is off (if the unit has ignition sensor);
green arrow – the unit is moving, and arrow's direction shows movement direction.
This option is called Replace unit icons with motion state signs and set in User Settings.
Besides, the colors of these icons (arrow, square, circle) can be different and dependent on a sensor value. This
functionality is adjusted in Unit Properties = > Advanced (Sensor color in the Monitoring panel). In other words, the
shape of the icon is defined by state (if standing – square, if moving – arrow), and the color depends on sensor
value (intervals and colors are adjusted in unit properties).
Unit names can be either shown or hidden when displaying a unit on the map. It depends on the state of the
button in the bottom panel.
Other Markings
If a unit is currently in motion, a green arrow shows movement direction, and the unit
can be followed by a blue 'tail' (trace) which shows unit track for several latest
messages. If the unit is stationary (according to the last message), this arrow is not
shown. If there was no motion within several latest messages, the trace is not shown
(or the page has been just loaded). Trace default length is 5 messages, however, it
can be changed together with trace width and color in User Settings.
Both direction arrows and traces can be disabled. To do this, use the appropriate buttons in the bottom panel:
197
Icons Explanation
The list of all icons that can be found in the Monitoring panel is presented below. The number of options available here
depends on purchased modules.
Depending on your individual needs, you can hide or show certain columns using the Monitoring Panel customizer.
Choose the elements to be displayed in the work list. If you mark an item in the left checkbox, it will have its own
column. If you mark an item in the right checkbox, it will get into unit actions menu. If marked in none of checkboxes,
the item is not displayed in the Monitoring panel.
1. Operational: icons-buttons, if clicked they allow to perform an action over a unit (such as event registration,
command execution, messages query, report generation, track building, properties editing, removal from
the work list, etc.). Further instructions can be found in appropriate dialogs and panels that are invoked by
these buttons.
2. Informational: icons that give information about unit current conditions (moving or stationary, sensor value,
connection state, data accuracy, driver, etc.). Further information in such cases can be found in tooltips. To
read a tooltip, put a mouse pointer over a chosen icon.
Icons at the head of the table are also applicable. In many cases, they allow to sort items on the list according to a
condition: for instance, moving units at the top, stationary units at the bottom.
Location
A column with units' last location – either in the form of addresses or in the form of geofences. By pressing the icon in
the header, units in the work list can be sorted according to their location (by alphabet in direct or reverse order).
'Resolving' means an address is being searched. 'N/A' goes for units which location is not available, for example, in
case a unit has never sent any messages or it does not get into known geofences.
Addresses
If you use Gurtam Maps in the system, depending on chosen format, addresses can be longer (including
state, region, etc.) or shorter (e.g., just street and building number). If you use your own WebGIS,
addresses can have only full format, and if no address information is available, then coordinated are
displayed instead.
Geofences
If a unit gets into several geofences, all of them are displayed. At that they are sorted by area (from small
198
to large) and written in color set in geofences' properties. Attention! To calculate units inside geofences,
the option Presence in geofences should be activated on the 'General Settings' tab. That is why this flag is
enabled automatically if you choose geofences for the location column.
Tracking option
If selected in this column, unit will be always in sight on the map when a new message comes from it. To select all
units, press the button in the header. More...
Motion state
This column shows whether unit is moving or stationary, as well as whether ignition is on or off (if there is an
appropriate sensor).
– unit is moving,
– unit is moving, engine is on,
– unit is stationary,
– unit is stationary, engine is on;
– the last message from unit was received over an hour ago: unit was moving;
– the last message from unit was received over an hour ago: unit was stationary.
Unit state is detected according to its speed value in the last message and ignition sensor state (if there is such). Apart
from that, if a unit is stationary, in the tooltip you can see for how long.
Data accuracy
This column indicates data accuracy – shows how many satellites were locked and when the latest message was
received. To know the precise time of the latest information update, place a cursor over the icon and read a tooltip.
green – satellites are available (see the precise number of satellites locked in the tooltip),
red – satellites are not available.
Second bar shows the last data was get from unit:
According to their last message time, units can be automatically displayed or hidden. To make use of this option,
change Without filtration to Monitoring panel or Panel + Map and specify filtration interval in minutes. The filtration can
affect only the work list in the monitoring panel or both the work list and the map. More...
Connection state
Shows whether there is connection with unit at the moment.
– unit is connected,
– unit is not connected.
Unit is considered as online if it has TCP or UDP commands available or it has sent messages within last 10 minutes.
Sensor state
In this column sensor state can be shown with different colors.
When putting a cursor over the square, in the tooltip you can see the value or description. How to adjust these colors...
Drivers
The column with information on drivers. In the tooltip, you can see name, photo, and phone of driver(s) assigned to
unit.
199
– no drivers bound,
— a driver assigned has no photo,
— several drivers are bound to the unit.
Trailers
The column with information about trailers. In the tooltip, you can see name and photo of trailer(s) bound to unit.
— no trailers bound,
— a bound trailer has no photo,
— several trailers are bound (see more information in the tooltip).
Quick track
The column of buttons to build tracks of unit movements. In panel settings, you should also specify the interval for quick
track building: 'Yesterday', 'Week', 'Month' or 'Other' (manual mode).
When pressing the Show Track button opposite a unit, a track of this unit appears on the map. Many parameters for
quick track building are borrowed from the Tracks panel: line width, annotations, markers, trip detector, etc. Moreover,
the interval is also taken from there if it is set as 'Other'. Track colors can be set in unit properties (Advanced tab) or in
the Tracks panel as well.
All 'quick' tracks are displayed in the Tracks panel where you can manipulate them in the same way as usual tracks:
show/hide, remove from the map, focus, apply hittest, etc.
Messages
Buttons to query data messages.
— display messages,
— not enough rights to query messages from this unit.
When pressing the button, you will automatically move to the Messages panel where requested data will be displayed
in the tabular form. Time interval ('Today', 'Yesterday', 'Week' or 'Month') for the query is set in the Monitoring panel
customizer. In case of 'Other', the interval is taken from the Messages panel. Only messages of data time are loaded in
this way. Parameters can be displayed in raw form or as sensors. It depends on what is chosen in the Messages panel
itself a the moment.
Quick report
Quick report generation.
— execute a report,
— not enough rights to execute reports for this unit or report template is unavailable.
When pressing the active button, a report is generated for the unit. A template for the quick report is selected in the
Monitoring panel customizer as well as time interval ('Today', 'Yesterday', 'Week' or 'Month'). Choose a template from
the dropdown list. Note, this list contains only templates dedicated to single units. Time interval can be either standard
or 'Other', which means it will be taken from the Report panel. The requested report itself is displayed in the Reports
panel and navigated/managed from there.
Commands
Buttons to send commands to units:
200
– there are available commands, including GPRS commands (using TCP or UDP channel),
– there are available commands, including GPRS commands, however, the current user has not enough
access rights to execute them,
– there are no commands available or no rights to execute them.
SMS
Send SMS to unit or driver (the addressee is selected in the dropdown menu if both options are available).
To explore the full functionality of this option, the current user must have rights to send SMS messages, access to unit
Edit connectivity settings, a driver must be bound to the unit, and both (unit and driver) must have phone numbers in
their properties.
Events registrar
This column contains buttons to display event registrar dialog. It is used to register fuel fillings, maintenance service
and other events to unit history.
– open registrar,
– not enough rights to register an event for this unit.
Properties
View unit/group properties dialog (depending on work list display mode). In case of groups, the button can be different
regarding [[cms/rights/rights|access rights.
Clear list
Buttons to remove individual units/groups from the work list or clear the whole list at once.
– remove all units/groups from the work list (if pressed in the header of the table) or remove a group (if
pressed against a group),
– remove a particular unit from the work list.
If an option is selected for the additional menu (that is checked in the second column of the Monitoring panel
customizer), you will find it in the column with the icon under the button . The additional menu that can contain
any of the above mentioned buttons and signs.
Other buttons and signs that can be found in the Monitoring panel.
The first column in the table is filled by check boxes. Put flags near units you want to be displayed on the map.
Put a flag at the top of the table to mark all units at once.
A switch-button showing that items of the work list are sorted by name in direct order.
A switch-button showing that items of the work list are sorted by name in reverse order.
A switch-button showing that the work list displays singular units.
A switch-button showing that the work list displays a tree view of units (with grouping). More about the work list
settings...
The button to add units/groups to the list using a filter.
The button to add all available units/groups to the work list.
Monitoring panel customizer that helps you to choose columns to be displayed and options for the additional
menu.
201
Unit List Management Table of Contents
Unit List Management
Singular Units
Unit work list affects the tracking process in many ways. It is not only about what you can see Treelike View
on the list and on the map but also how you manipulate units in other panels when creating Search Tool
Dynamic Work List
jobs, notifications, querying messages, reports, and tracks, assigning drivers or trailers, looking
for nearest units, etc.
Each of those lists is independent and their settings are stored separately. When switching between them, previously
applied settings are restored for each.
Singular Units
To add units to the work list, use one of two buttons located above the list:
However, there are some alternative ways to add units to the work list:
from the Online Notifications window (you can add a unit for which a notification has triggered);
dynamic formation of the list regarding data accuracy.
Units can be removed from the work list by one or all together:
a button against each unit to remove this single unit from the list;
a button at the head of the list to clear the work list (remove all units).
Note that units are deleted from the list and not from the system. They can be added back at any time using the ways
described above. To delete a unit from the system completely, go to the Units panel.
Sorting
For your convenience, items on the list are sorted by name. They can be sorted in direct alphabetical order or in
reverse order. To change the order, use the switch button or .
Besides, it is possible to sort units by other attributes like motion state, connection quality, etc. To do this, push the
appropriate button in the head of the table. Possible filters are:
202
last location;
sensor state availability,
commands availability,
motion state,
last message time,
online connection state,
pictures from messages availability,
quick track availability,
driver information availability,
trailer information availability.
For instance, to sort units by state, press the button . Then at the top of the list there will be moving units, and at
the bottom – staying or vice versa if you press this button twice.
Available columns are defined in the Monitoring panel customizer. Signs and icons used in the columns are described
in Icons Explanation.
Treelike View
This mode of the work list shows the tree of units with sorting by groups. Expand a group to see its units and
information about their current state. Signs and icons used here are the same as in the singular view. Units can be
easily removed from the list and with this they are not removed from the group itself.
The button to add all available objects allows adding all not-yet-present groups to the work list. The newly added
groups will have the complete set of units inside. However, if a group was on the list already, its currently represented
set of units remains untouched.
To collapse/expand a group (that is show/hide its units), use the plus/minus button in the first column of the table. The
checkbox before group's name is responsible for units' visibility on the map. This button allows you to quickly draw all
group's units on the map or otherwise remove them with one mouse click. However, each unit has the same
checkbox, so the visibility of units can be controlled individually, too.
If units not included into any of the groups are added to the list, a special virtual group is generated for them – Units
outside groups . This group cannot be edited, however, it possesses many of the features of ordinary groups.
If you expand a group and see omission points at the end of its list of units, it means that not all of them are displayed
in the current list. Point mouse cursor over this sign to see how many units are missing; press this button to add them.
In the tooltip of a group, you can see the list of all its units. Besides, in tooltips of some icons situated against each
group, you can see specific information concerning certain parameter (again, all units in one tooltip):
— sensor state;
— motion state (moving/stationary, ignition on/off);
— data accuracy (number of satellites and last message time);
— connection state (connected/not connected);
— assigned drivers;
— assigned trailers.
The following actions can be performed over a group from the Monitoring panel:
— send a command to a group of units (a list of available commands is shown if you hover the cursor;
commands execution dialog opens if you press the button);
or — view/edit group properties).
Search Tool
It is not needed to display all available units on the working list. Units can be easily added to and removed from the
list. Sometimes it is more convenient to work with a certain group of units and have it on the screen.
There is a convenient tool to search necessary units and add them to the work list. To open this tool, press the button
203
on top of the panel. There you see the list of all groups (in square brackets) and then all units in alphabetical
order. Double-click on a unit/group to add it to the work list. If it happens to be in the simple view, one or more singular
units will be added. If the treelike view is on, groups are added to the list (collapsed). If you choose a group to be
added, all its units are added with it. If you choose a unit to be added, its group is added and it will have just this unit
inside if you expand this group. However, there will be omission points to indicate that there are more units in this
group (press to add them). If you add a unit whose group is already in the list, this unit will be added to its group,
however, you will not notice it if the group is collapsed. If you add a unit that does not belong to any of the groups, a
special virtual group Units outside groups appears on the work list.
Apart from that, if the checkbox Show added units on map is enabled, all units being added with any of described
methods appear not only on the work list but on the map, too.
Search by criteria
When you have many units/groups, it is handy to perform a search among them by certain parameters: name, creator,
custom fields. In case of units, there are even more criteria: phone number, unique ID, device type, access from user,
geofences, unit groups, sensor, driver, and trailer.
Select search parameter and then type a key phrase. For instance, to
find all MANs, select search by name, and in the template field type
man. All units and groups which names contain the combination of
characters man (both at the beginning and at the end of the name)
will be found and displayed immediately.
If you leave the search field empty, all units possessing the selected
property (sensors, ID, etc.) will be displayed, for example, all units
having a driver assigned to them. Then you begin to type driver's
name or code to narrow the selection.
After the first search is complete, another search can be done on the second (third etc.) level: a search among the first
search results. To do this, push Add to the search list . The principals of inquiry formulation remain the same.
If the search is successful and you want to include the results in the work list, you can do it by double-click (described
above) or using the following buttons:
The work list in the Monitoring panel can be formed dynamically according to the time when the last message from a
unit was received. Units are removed and added to the list and map automatically. The work list updated each 10
seconds.
The function can be enabled in the Monitoring panel customizer. Change Without filtration option to Monitoring panel
or Panel + Map and specify filtration interval in minutes. The filtration can affect only the work list in the monitoring
panel or both the work list and the map.
ATTENTION!
With this mode enabled, some other functionality becomes not available or operates in different way:
1. Manipulations with the work list (such as search, addition and removal of units) are impossible.
2. Unit lists displayed when creating jobs, notifications and routes, querying messages, reports and tracks
will contain not units from the work list as usual but all available units.
3. However, Nearest Units tool operates with the work list dynamically updated in the Monitoring panel.
4. The filtration by last message time does not affect the work list if the treelike view is selected.
204
Commands Table of Contents
Commands
Standard Commands
Command is a request that can be sent to a unit. In response, the unit can send its Sending and Tracking
coordinates, take a picture, activate an output, block engine, etc. Available commands depend Commands
Executing Commands from the
on type of device used and its configuration. Monitoring Panel
Chat with Driver
A command should be configured in Unit Properties beforehand. Only then users will be able to
execute it. Besides, users are required to possess access rights specified for each command of a unit individually as
well as the flag Execute commands.
Standard Commands
If your device supports a command that is not mentioned on the list above, this command can be sent anyway. To
do this, use the standard command Send custom message. In this case, you should know exact name for the
command (how it is written in device configuration).
Command can hold predefined parameters of its execution. This is adjusted for each unit individually in its properties.
Manually from the Monitoring panel, including commands sent to a group of units.
As a job fulfilled according to schedule.
As an action for a triggered notification (command is sent when specified conditions are met).
From a mobile device by means of simple SMS text message.
205
Executing Commands from the Monitoring Panel
In the Monitoring panel, there can be a button to send commands. If not, it can be activated through the Monitoring
panel customizer. The button can obtain different looks:
there are available commands for the selected unit;
there are GPRS commands among available;
or there are no commands supported by the selected unit or the current user has not enough access to the unit.
Put the cursor over the active button against the needed unit to see the list of available commands. The list can
contain only commands configured in Unit Properties = > Commands. Furthermore, only commands available at the
moment are shown (link type availability is important here).
Note.
If a command you are trying to send has the same name but belongs to different types and parameters are not
adjusted, then it will be sent without parameters and thus may not be executed properly.
Operator (dispatcher) can exchange messages with drivers. To do this, select the command Send message to driver
and type a text.
In case the driver answers, driver's message will popup in a special window. New message can be accompanied with
sound (see User Settings). If you have unread messages, the number of them is shown in red circle next to the chat
icon in the bottom panel. If there are any messages in the window (either read or unread), the icon itself is active
which means it is colourful and can be pressed on.
206
Newly received messages are added to the top of the list. Unread notifications has a sky-blue background by default.
To expand/hide the full text of a message, use the switch button +/– or click on the header of the notification in a place
with no text.
When clicking on a message, the map is focused on the place where this message was received. When clicking on a
unit name, the map is focused on unit's last location.
To delete a message, click on the cross at its right. You can also delete read messages or all messages at all if you
use the appropriate buttons at the bottom of the messages window. The window is closed automatically if you delete
all messages. If the online notifications' window is closed by clicking on the grey cross in the upper right corner, then
the window ceases to appear automatically upon receiving of notifications until the window is opened by clicking the
corresponding button in the bottom panel.
The window itself can be moved over the screen and resized.
The operator can quickly send a reply to the driver (a command of the appropriate type Send messages to driver
should be configured in unit properties in advance). When clicking on the green triangle-shaped button, command
executing dialog appears and the operator can type the messages and send it.
Besides, you can generate a report called Chat, which will contain all chat history including operator's messages and
driver's answers.
207
Events Registrar Table of Contents
Events Registrar
Make a Record in Unit Log
Different events can be registered in unit history and then shown in the corresponding reports. Register Custom Event
Some events such as speeding, idling, visits to geofences, sensor values, etc. can be detected Register Unit Status
Register Filling
automatically by the system with the help of notifications. Other events such as fuel filling, Register Maintenance Work
maintenance or any custom events are registered in unit history manually with the help of a Registered Events in Reports
To display the registrar, press the button on the monitoring panel . If you do not see such a button, it can be added
through the monitoring panel customizer.
Attention!
To register events for a unit, the access right Manage events is needed. In the other case, the registrar button is
dimmed.
Push the registrar button and choose a type of event to be registered (the list depends on purchased modules):
Note.
Measurement units which you may encounter in the dialog (e.g., to indicate fuel volume or mileage) depend on
properties of the unit for which the registration is being made.
Using this option, you can add any text note to unit log. It will be labeled as 'Manual record' and dated time you have
created it. Such records can be viewed in messages (choose Log as messages type) and in a report generated for this
unit (query the Log table).
To add messages to unit log, you should have not only Manage events access, but also Manage log access.
Select Register custom event in the registrar and press Next. Give the event a name, enter description and choose
the place.
There is a possibility to save events descriptions to speed up the process. To do this, enter your description and press
208
Store. The description will appear below in Stored descriptions. To select a previously saved description for a new
event, just click on one of them. To delete a saved description, select it and press Delete.
If you check Violation, the event will be registered in unit history as violation, otherwise it is registered as simple
event. It means this event will appear in different kinds of reports: Events or Violations.
Using this functionality, you can register the beginning of a state, which can be afterwards displayed in some reports.
For instance, the status can be like business/private is a vehicle is used both for personal and business needs.
The process of registration is the same as for custom event. You choose date and time and enter any text. The text
can be saved and used in other registrations. The date and time chosen means the beginning of the status. The state
comes to end when a new state is registered.
Statuses can be set automatically (for example, when the unit enters a geofence) – see Notifications. Columns with
the corresponding contents are available in several reports which are Trips, Engine hours, Rides, and Parkings.
Register Filling
In the Monitoring panel, you can register fuel fillings for units manually. Manual registration helps to estimate the
difference between registered and detected fuel, compare consumed fuel with consumption rates, calculate running
costs, etc.
Enter the volume of filled fuel and its cost. Fractional numbers (up to hundredth) can be also used for fuel volume and
cost. To enter fractional numbers, use point as delimiter. For example, to register fuel filling for 77 dollars and 88 cents
you enter '77.88'.
Entered values will be automatically added into the Description field below. If necessary, you can edit the text
manually. Then enter date and time when the filling happened and possible deviation from this time in minutes.
Besides, it is possible to indicate the place where the filling happened. To do this, press the Select Location button.
The focus will switch to the map, and you can indicate the place by double-click. The address of the place will be
detected by Web-GIS and written in the Location field. Press the Reset Location button to clean this address and
indicate another one. Besides, you can manually edit this field (for example, you can add gas station name). When the
focus is on the map, the dialog moves to the top left-hand corner, and the Restore Dialog button appears. If you press
it, the dialog becomes active again even if you do not indicate any place on the map.
209
Enter the following data:
kind of work (type from the keyboard or select from available service intervals on the right),
custom description,
cost,
service duration in minutes,
location (press the Select Location button and double click on the map or edit this field manually),
date and time when the work was done (be default, the current date and time are offered),
values of mileage and engine hours counters at the moment of the event (the current values are displayed
but you can edit them).
In the right part of the dialog, you see the list of service intervals contained in Unit Properties = > Service Intervals.
Check the services that were done that time. This this action the interval selected will be zeroed and will start the
count again. Note that if you select anything here, the contents of 'Kind of work' field changes.
Attention!
Registered events are not editable, however, they can be deleted from the database in the Messages panel (special
access is required).
Registered fillings and maintenance can appear in the report on events together with other things. Registered custom
event depending on your choice can get into report on events or report on violations. Both reports have the similar
structure.
When transporting registration data to a report on events (violations), the information is distributed among columns
which contents are taken from certain fields of registration dialog. The table below gives the correspondence between
the column in report and the field in registrar.
Column
Column Content
Header
Event
Date and time when event happened.
time
Time
Date and time when event was registered.
received
Event Text is taken from the Description field. For maintenance, if there is no description, the text can be taken
text from the field 'Kind of work'.
Unit location at the moment of event. It is taken from the coordinates indicated while registering the event
Location
(press the Select Location button and double-click on the map).
If any of above-mentioned fields are not filled correctly, then the corresponding columns will be empty.
Other reports that use registered events are report on maintenance and utilization costs.
210
Pictures from Messages
If the equipment supports such an option, units can send pictures along with messages. Pictures can be viewed in the
Messages panel as well as in the Monitoring panel. To display a special column in the Monitoring panel, activate the
option Picture from message in the Monitoring panel customizer.
After pressing the button, picture viewer will be displayed. You can view all the pictures received during the current
session as well as the latest picture received prior to your login.
The above-mentioned way is to view pictures of a certain unit. To view pictures of all units, press the pictures button at
the bottom of the screen. It is active (that is colorful and able to be pressed) if there are pictures in the current session.
Their number is displayed at the right of the button. If new pictures have appeared after last opening of the window, the
number is displayed in red circle to attract your attention. In this window, only images received during current session
are displayed.
To move between images, use arrows. Between them, you can see the number of the pictures viewed and the number
of available images. Pictures are sorted according to the time they come to the server.
Above each picture, there is its date and time. Under each picture, you can see a unit name and address information
from the message.
Some pictures can be enlarged with a special button in the right top corner. To close a picture viewer, use the button in
the right bottom corner.
All images received from units can be observed in reports and messages.
You can get a picture from a unit at any time using the Query snapshot command.
211
Locator
Using the locator, you can make information about your units available on outside sources (i.e., other Internet sites).
Units are displayed on the map with their icons. Clicking on a unit, you get more information about it (last message
time, actuality, speed).
Units in the locator are shown on OpenStreetMap or, if available, on Google Maps.
The option is enabled in User Settings and called Enable public access to locator page. Tick the box and save
changes. Then open the dialog again and follow the locator page link to see how it will look and pick up its address.
Note that units do not move in the locator. To get the latest information about them, you need to refresh the page each
time (press F5 to do this).
Attention!
When the public access is enabled, it means anyone who knows your login can track your units.
To integrate the locator to a web site, use the following form of code (replace user name Gurtam Partner with any
other):
<iframe src="http://hosting.wialon.com/locator/index.html?u=Gurtam
Partner&zoom=14&lang=en&map_type=1" width="700" height="400"></iframe>
If the 'zoom' parameter is not set, the map will be rescaled automatically to display all units. However, if you indicate
certain zoom level, it will be applied to the map and the map will focus on one of the units. Possible zoom grades are
212
from 1 (small scale) to 18 (vast scale).
213
Tracks
Track is a line drawn on the map to show how a unit moved during the indicated period. A track is mapped by the
points from where messages came. Each point stores also date and time when the message was received and
coordinates at the point as well as other parameters (speed, sensors etc.). Besides, markers indicating places of fuel
fillings, parkings and other events can be drawn on the track.
Any number of tracks can be drawn on the map. They can represent different units and various time intervals. To
prevent tracks from being confused with each other, you can set different colors for them. Besides, different segments
of the track can be of different colors depending on speed or sensor values.
To open the Tracks panel, choose a corresponding name in the top panel or click on the necessary item in the main
menu customizer.
214
Mapping a Track Table of Contents
Mapping a Track
Invalid Tracks
To build a track in the Tracks panel, do the following:
Note, that in order tracks to be displayed on the map you should check if the corresponding layer icon in the main
menu is active.
The principle of interval adjustment is the same as in reports (see Query and View Reports). The third and fourth steps
can be united into one if you choose one of the 'quick intervals' (the buttons Today, Yesterday, Week, and Month).
A point-to-point track built according to preset parameters will appear on the map (if unit has any messages with
coordinates for the period). If it takes too long for the track to appear on the map, it may mean you have indicated an
interval that is too long or your Internet speed is too low.
If within the indicated period the unit was not moving, there will be no track on the map, however, it will be in the list of
tracks below, and the distance travelled will be 0 km.
Invalid Tracks
When mapping a track you can get a dashed line that means that some track coordinates are doubtful. It may occur if
there were no coordinates at all or they were invalid. This situation may be caused by connection loss or poor satellite
visibility. Connection loss is detected according to the parameters set in unit properties on the Advanced tab (see the
options 'Maximum interval between messages' and 'Minimum satellites').
215
Track Parameters Table of Contents
Track Parameters
Track Color
After you have built a track, it is impossible to change its parameters (time, unit, color, Track Line Thickness
annotations). In case of error, delete incorrect track and create a new one. Markers
Annotations
Trip Detector
Track Color
A track color depends on unit settings (see Unit Properties = > Advanced). There are three alternative color settings
available: 'Speed based track colors', 'Sensor based track colors' and 'Unconditional track color'. Initially, one on these
settings is chosen for a unit. If the setting is not specified, then track color is single. Track color for a single track is
chosen before every track building. If a color is not specified in the color range, then a new color for every new track is
chosen automatically from the color range going circle-wise. Also, if a unit has 'Unconditional track color' setting and
you have chosen the other color from the color range manually, then a new color will be automatically chosen from the
color range going circle-wise for every next track.
Indicate track width in pixels (from 1 to 15). Track can be represented as a number of not connected points (from
where messages were received) – for this choose the option Points only.
Markers
You can enable markers to highlight places of significant happenings on the track. The choice of possible markers is
the same as in reports:
fuel thefts,
speeding,
fuel fillings,
events (if a violation took place, the marker
would be red),
pictures from messages.
parking places,
short stops,
Choose desired markers before building a track. To activate a marker, just click on its icon so that it became colorful. If
at least one kind of marker is selected, additional marker options can be applied:
numbering,
grouping.
Markers in tracks are drawn and used along the same principles as markers in reports.
216
Annotations
Indicate whether you want annotations to be displayed. Annotations are hints which are attached to each point of the
track to show when (date and time) the message was received. On big zooms, information about speed becomes also
available. Annotations are rather informative but they make visual reception of track more complicated. That is why it is
reasonable sometimes to switch them off. Full information about any point of the track can be obtained from the tooltip
that appears when you hover the cursor over a point. Measurement system in annotations depends on current
user's settings.
Trip Detector
Trip detector flag affects distance value and track visualization. For example, in places of stops and parkings there will
be just one point instead of conglomeration of points, and the mileage will include just intervals detected as trips. Trip
detector is set up in Unit Properties => Trip Detector.
Like in the Messages panel, distance is calculated by coordinates (it does not depend on mileage counter). That is
why distance in tracks can differ from mileage in reports.
217
Tracks Management
You can add tracks on any unit for any time interval. The list of tracks created will be displayed in the work area at the
left. To prevent tracks merging, select different colors for them.
Hover the cursor over track to get accurate information about track point (points where messages were received).
Messages are searched in the radius of 50 pixels to the cursor. Points found are highlighted by small green circle, and
a tooltip appears with the following information: time, address, speed, altitude, coordinates, satellites, and sensor
values. Messages with zero speed are marked with bigger points. Measurements used in the tooltip are borrowed from
unit's properties (speed in kilometers or miles per hour, altitude in meters or feet) as well as mileage in the list of
tracks.
You can manage tracks in the left part of the window under the Show Track button. Unit name is displayed on the list
as well as time interval and travelled mileage. Like in the Messages panel, distance is calculated by coordinates (it
does not depend on mileage counter). That is why distance in tracks can differ from mileage in reports.
It is possible to view all created tracks on the map simultaneously or select just some of them. The tracks marked with
flags are displayed. Unmark a track to hide it. Using the checkbox in the header, you can select/unselect all tracks at
once. You can temporarily hide all tracks by disabling the corresponding layer in the top panel.
If there are several tracks available, you can sort them by length or name. To do so, click in the header of the list
above mileage or name columns. Click again to reverse the sort order.
Use the arrows to quickly locate the initial/final point of the track. To see the whole track and focus the map on it,
just click on its name in the list.
To delete a track, click on an appropriate button against it . Using a similar button at the header of the list, you can
delete all tracks at once.
A track can be played. That means unit's icon will move along the track line with selected speed. Pressing the Play
button against a track will open a special tool — Track Player — and playback will launch.
Furthermore, another special tool can be applied to a track — Hittest. It allows you to get the exhaustive information for
any point of the track.
218
Messages
The Messages panel gives access to units database. Here you can view messages received from units (coordinates,
parameters, speed, etc.) as well as SMS messages received from units, commands sent to units and events registered
in units history. Besides, data messages can be exported to a number of formats.
To open the Messages panel, choose a corresponding name in the top panel or click on the necessary item in the main
menu customizer. The workspace of the panel can be divided into four sections:
in the left top corner you can set parameters of your request;
in the bottom left part there is statistics for current request or a panel to export/import messages;
in the top right section there is the map;
at the right bottom there are messages themselves.
Vertical sizes of the messages panel and the map are adjustable. To control them, click on the splitter between them
and holding the mouse button, drag in a required direction.
219
Working with Messages Table of Contents
Working with Messages
Request Messages from Server
Working with messages is query messages, view and filter them, and delete them. Viewing Messages
Messages Filter
Deleting Messages
Request Messages from Server
The request is formulated in the Messages, in top left corner of the window. You specify the following parameters:
1. Select a unit for execution. The dropdown list contains not all units available to you, but only the units from
the work list. On the right, there is a button to summon Unit Properties dialog.
Data messages
SMS messages
Sent commands
Registered events
Log
4. At the end, press the Execute button. A table will be generated in the right part of the window. To clear
table (and map), press Clear.
Note.
Note, that in order messages track to be displayed on the map you should check if the corresponding layer icon in
the main menu is active.
Viewing Messages
If a large time interval is selected, there will be probably many messages. In this case they will be presented in several
pages. Use navigation panel (blue arrows) to move through the pages, or enter page number manually and press
<enter> to display certain page. Apart from that, you can set the number of messages to be displayed on one page:
25, 50, 100, 500, 1000.
220
The width of the columns is also customizable. To change it, drag column edge with the mouse in the required
direction. To reset columns width, push Set column auto width button in such a way that A letter appeared there .
In this case, column width will be set according to contents in the cells. To save columns width when moving to other
page of messages, make the button inactive . Note that if loading many messages (500, 1000 per page), it is better
to disable column auto width because it can considerably slow down the loading process especially if the number of
parameters differs from one message to another.
Table's content is adjustable. It is possible to hide and show back any column. To choose columns to be displayed,
place the cursor over table's header. Near each column name there is a button to show the dropdown list where you
can choose what to display. Note that all columns cannot be hidden simultaneously. If sensors are displayed, each of
them has its own column that can be enabled or disabled. By default, only visible sensors are displayed (the rest can
be enabled manually).
Messages Filter
To quickly find a necessary message or filter found messages by a parameter, use a special filter. If
applied to data messages (with parameters shown as raw data), the filter involves parameter names, in SMS
messages and registered events – message/event text, in sent commands – additional parameters values, for log –
description of the action. The filter is disabled for data messages with parameters shown as sensor values.
Details instructions for filter usage were given above. You can use wildcard characters (* or ?) or input your query
without them. For example, to find all messages with images input “image”. Other available parameters depend on
device type used.
To apply the filter, press <enter> or the Apply button on the right of the filer. At that, messages corresponding to your
query will be displayed. To remove filtration and show all available messages again, clear filter text field and apply the
filter again. If the filter is applies, the number of found (filtered) messages is displayed on the left.
Attention!
The filter affects only the current page. However, while leafing through pages, the filter is applied to each new page
automatically.
Deleting Messages
Deleting a message can be applied when you think the message is invalid and can badly affect reports, tracks, etc.
Deleting messages is available only if you have enough access to the unit.
In the last column of the table, tick messages to be deleted (one or more). Then press the Delete button and
confirm your intentions. If the checkbox at the head of the table is ticked, all messages on the current page will be
selected.
After the operation, the newly deleted messages still remain on the table, however, the delete checkbox for such
messages is dimmed which indicates that the messages are deleted. Next time when you load messages, the deleted
messages will be completely removed from the table.
Note:
Deleting last incoming message or last message with position (valid coordinates) is impossible. That is why the delete
221
checkbox for these messages is always dimmed.
222
Data Messages Table of Contents
Data Messages
Statistics
If you request data messages, the table of messages will contain information about time, Using the Map
speed, coordinates, location, as well as parameters. Besides, resultant information will be given Charts
Raw data – all parameters are displayed in one column, in one line in their initial form.
Sensor values – each sensor has its individual column in the table, and the values are given according to
the calculation table. By default, only visible sensors are displayed but you can enable other sensors
manually (see Viewing Messages).
Red rows in the table mean alarm messages registered by the system.
Note.
Measurement system (either metric or U.S.) used to display speed, altitude as well as statistic information depends on
unit's properties.
223
Statistics
In the Statistics section the general information about the request is given:
The track for the chosen period is displayed on the map. It is generated together with the table. Click on any
message in the table to move to this point on the map. The map is centered by this point and a red marker is set
there.
By default, track color is blue, but you can adjust settings to paint the track depending on speed or sensor value. This
is set in unit properties dialog on the Advanced tab.
Besides, to get information about track points, hover mouse cursor over and see information in a tooltip (time, address,
speed, altitude, coordinates, satellites, sensor values). Note that messages are searched in the radius of 50 pixels
from the cursor.
Note:
If after the Messages panel you switch to Map or Reports panel, map layout and all track lines are preserved. To
remove unnecessary graphics, go back to the Messages panel and press the Clear button. More...
Charts
Besides tables, some data can be presented in the graphical form. To switch between the modes, use and
buttons correspondingly.
In the graphical mode, parameters charts are available. When you switch to the graphical mode, the Chart legend
panel opens on the left. There you tick parameters to be displayed in the chart. Several parameters can be selected
simultaneously. Then the chart will contain several curves. For your convenience they will by drawn with different
colors.
The chart can be zoomed with the help of a mouse. Select the necessary section holding the left mouse button. Place
the mouse pointer over a point to get the precise value at the point in a tooltip.
224
SMS Messages
SMS messages can be sent by unit while executing a command, generating an alarm or in other cases, which depend
on device type. A table generated for this request will consist of three columns: time when message was received,
message text, and SIM card number embedded into unit. Messages can be filtered by text.
225
Sent Commands
Commands sent to the unit by user(s) are displayed for this request. There is a special button in the monitoring panel
to send commands to units. The resulting table includes:
226
Registered Events
Different types of events can be registered in unit history automatically or manually.
Automatic registration is adjusted with the help of notifications (delivery method must be Register event for unit,
Register as violation or Register unit status. In such a manner, you can control geofence visits, connection loss, idling,
service intervals, etc.
Manually an event can be registered in the special registrar in the monitoring panel. With this method, you can register
fuel fillings, maintenance, unit statuses, and any custom event.
time when the event was detected (automatic registration) or registered (manually by user);
type: event (traffic counter reset, events from notifications, some custom events, route control statuses),
violation (violations from notifications, some custom events), maintenance (registered manually).
event text which is taken from notification text or from description entered while registering manually.
227
Unit Log
Any manipulations with unit properties or its database are logged in the system automatically. In addition, records can
be added to unit log manually – through event registrar. To see unit log or add messages to it, you should have not
only Query reports or messages access but also Manage log.
Any changes in Unit Properties dialog are logged as well as import, export, and removal of messages, assignment or
reset of a driver and others.
Time – date and time when the change was done (saved).
User – name of the user who did it.
Action – description of the change performed. Messages can be filtered by text in this description.
Host – the address of the computer from which the user did the change or it can be 'job' or 'notification' if
the action was automatic.
Delete – buttons to delete records.
228
Export/Import Messages Table of Contents
Export/Import Messages
Export
Messages can be imported and exported. It concerns only messages of the first type that is Import
data messages.
Export
Open the Export Messages tab in the left section of the window. Select
destination format and push Export. Depending on your browser configuration
settings, you will be offered to open or save the file. The resulting file can be
compressed. For this, leave the flag Compress file.
NMEA messages (.txt): National Marine Electronics Association text file, communications protocol used in
sea navigation equipment.
Attention! Parameters (sensors) are not stored when exporting to this format.
Google Earth (.kml): an XML-based format used in Google Earth to transmit three-dimensional geospatial
data.
Wialon binary messages (.wlb): a binary format to be used with Wialon software.
Import
Select the Import Messages tab in the left section of the window.
Push Browse to define a file (or an archive) to import messages from and push the Import button.
Hint.
To simplify and accelerate the process, you may first compress files with ZIP or GZIP. When uploading process is
completed, files will be unpacked and processed on the server.
229
Reports
Attention!
This module is licensed separately.
Wialon Local allows building various kinds of reports on units, users, resources, retranslators, routes, drivers, trailers as
well as groups of units, drivers, or trailers.
However, corresponding modules are required to query reports about all those items. For instance, reports on unit
groups come as a part of the Advanced Reports module. To see reports on routes (rounds), the Route Control module
is required, etc. In addition, the set of available tables, charts, filters, columns, etc. depends on purchased modules and
activated services.
Reports on activity of a unit (included in the Basic Reports module) can be presented as tables or charts. Here you can
create report templates, generate reports and view them right in the browser or export them to the files of various
formats like PDF, XML, XLS (Excel), HTML, CSV.
To open the Reports panel, choose a corresponding name in the top panel or click on the necessary item in the main
menu customizer.
In the top left-hand corner, the basic parameters to generate a report are adjusted.
In the bottom left-hand corner, you create and store your report templates. After an online report is
generated, this section changes for the navigation bar.
In the top right-hand section, there is the map.
In the bottom right-hand section, you see the report itself if it has been generated online. A report appears
in the form of tables and charts.
The sizes of the sections are changeable. Click on the horizontal or vertical slider and holding the left mouse button
drag it up/down or left/right.
230
Query and View Reports
To generate a report, set the following parameters:
Report template
The last created or edited report template is chosen in the dropdown list by
default. Choose any other template from the dropdown list if necessary. On the
right of the selected template, there is a button to display template properties for
viewing and editing.
If no templates are available, it is impossible to generate a report. How to
create a report template...
Item
Choose a system object to apply the report to. Depending on the template selected above, you will be offered to
choose unit, unit group, user, driver, route, retranslator, or resource. As in case of templates, on the right of the
selected object there is a button to check object's properties. Usually, all objects of the appropriate type and enough
access (Query messages or reports is required) are displayed in this dropdown list. However, in case with units, not all
units are displayed in this dropdown list but only those which are in the work list of the Monitoring panel at the moment.
Interval type
Use buttons Today, Yesterday, Week, Month for quick report generation for the most frequently wanted intervals.
What concerns the last two, you will get a report for previous week or month (that is last full week or month), and week
starts on Monday. Note that if you press one of those four quick buttons, the report launches immediately (no need to
press 'Execute').
Otherwise, you can select other types of intervals to specify the reporting period more accurately. Three ways to specify
the interval are possible here:
Specified interval: specify date and time (to minutes) of the interval beginning and end.
Starts 'From' until today: specify the beginning only, and the and will be set automatically as the current
date and time.
For previous [select the number] hours/days/weeks/months/years. The current day (week, etc.) can be
included to the interval or not depending on the state of Include current checkbox.
When report parameters are adjusted, press the Execute button below.
Note.
Note, that in order units' track to be displayed on the map you should check if the corresponding layer icon in the
main menu is active.
231
Online Report Table of Contents
Online Report
Transfer from tabular report to
To generate a report online, adjust the parameters described above and push the Execute messages
button. If no tables or charts appear on the right, it means there is no data about the selected
object for the selected period or poor report content is selected in the template.
After executing a report, the Report Templates panel changes to Report Results that displays report contents and
provides navigation through the report. Usually, a report contains several pages. To switch between them, use
navigation links in the Report Results panel. The name of the active page is bold and highlighted with a light blue
background.
The information in reports can be presented in the form of tables or charts. Some information can be visualized on the
map, for example, tracks and markers.
If the text in a cell is blue, it means that there are coordinates for this point. Click on such a cell to move to that place
on the map.
To adjust the number of rows to be displayed on one page, choose the number in the dropdown menu: 25, 50, 100,
200, 500. To navigate between the pages, use the blue buttons in the toolkit:
The page number can be entered manually. After entering a number, push <enter> on the keyboard to go to the
required page.
To delete an online report, push Clear. The map and the report itself will be cleaned, and the Report Result panel will
be replaced by Report Templates again. However, you can switch between these two panels manually. To do this, just
click on the header of the corresponding panel.
The tracking system allows transferring to messages straight from a tabular online report. It can be useful for analysis
of unit data messages.
232
To move from table to messages, it is necessary to press the 'Transfer to messages' button in the toolkit. After
pressing it, text in some time cells becomes purple and works as a link. By clicking on the link transfer to messages is
performed. Depending on the table type columns with time indication can vary, for instance, 'Time', 'Beginning', 'End',
etc.
Messages are loaded for the whole report period, at that a page with selected message is opened first. The line with
this message is highlighted blue. The map is centered in regard to the selected message which is indicated with a red
marker.
By default, the transfer button is released. When switching from table to chart it is restored to default state, in spite of
the fact that it could be pressed before in one of report tables.
233
Print Report
After generating an online report, it can be printed without saving it to the disk. To do this, press the Print button that
becomes accessible only when there is a report in browser window.
In the left part of the Print Report dialog, you see the list of sections which are included in the report. Check those of
them that you are going to print. On the right, you can preview all these tables, charts, map, etc. To start printing, press
Print. To exit, press Close.
Note.
In Internet Explorer 10, maps and charts cannot be printed if the option 'Enhanced Protected Mode' is on.
234
Export Report to File Table of Contents
Export Report to File
Export Parameters
To get a report in the form of a file that is suitable to save on disk, print or send by e-mail, push Report Formats
Reports in the form of files can be regularly sent to your e-mail automatically — through jobs and notifications.
Export Parameters
Give the file any name. This is optional and if left empty, a file will be given a default name (like 'Online_report').
Specify whether to apply compression to file or not — 'Compress report files' option. Compression is mandatory for
HTML and CSV file as well as for cases when more than one format is selected.
The map can be attached to the report if it is HTML or PDF file. Note that the map will be attached to the file only if
any graphical elements (as tracks, markers, geofences, etc.) are chosen in the report template. Gurtam Maps or
WebGIS (depending on your system configuration) will be used here. Furthermore, the map layer can be hidden ('Hide
cartographic basis' option) so that only tracks and markers will be shown on the blank background.
More parameters can be adjusted for some file formats. Those additional parameters are described below.
Usually you export to a file a report that is already in the browser. However, you can also generate a new one
according to the parameters set in the left panel. In this case, you should check the 'Generate report' option.
At the end, press OK. Depending on browser settings, you will be offered to open file or save it.
Report Formats
HTML
Your report will be generated as Internet page and will open in any browser.
PDF
PDF is a widespread format suitable for electronic usage as well as for printing. To view these files Adobe Acrobat
Reader is used (for Windows OS only).
You can additionally adjust such page parameters as orientation (landscape or portrait) and page size (A4 or A3). If
a table in the report contains many columns, page width option can be also useful. The standard page width is fixed
235
which means it depends on selected page format and orientation. However, if a table is too wide and does not
match the fixed page width, this table will not be exported (only the heading will be displayed). In such cases, you
can select automatic page width, which means it will correspond to the largest row in the table. If Auto, compact is
selected, cell with is equal to the length of the largest word in it. If Auto, no wrap is selected, cell with is equal to the
largest phrase in it (no line breaks are applied). Note that if automatic page width is selected, page format and
orientation become relative — they define only page height.
Еxcel
Your report will be presented as Microsoft Excel electronic table (.xlsx file).
Note.
When exporting PDF, HTML, Excel the alignment is used. The columns containing text (names of sensors,
geofences, drivers, users, SMS and notification text, location addresses, etc.) are aligned left. The columns
containing numeric data (time, duration, speed, mileage, fuel, payments, count, etc.) are aligned right.
XML
XML is a textual data format that is notable for structured data storage and useful for data exchange between
programs.
CSV
CSV is a textual data format used for the digital storage of data structured in a table of lists form, where each row in
the file corresponds to a row of a table, and the columns are separates from each other by a special delimiter. You
can additionally set coding (utf8, cp1251) and delimiter (comma or semicolon).
236
Report Templates
The list of all templates available is located in the bottom left-hand corner of the window under the header Report
Templates. Here you can create, edit and delete templates for reports, as well as copy them and move them from one
account to another.
In the tooltip, you see the name of the resource which holds this
template (if you have access to more than one resource). If clicking on
a template, it becomes selected in the Template field of report
generation parameters.
When searching for a template on the list, it is convenient to use the dynamic filter. Enter template name or its part into
the search text box and observe the results. Additional search parameters are set in the dropdown list where you can
choose the resource or leave All.
Note.
If a template belongs to some resource to which you do not have access rights to Create, edit, and delete report
templates, then you will not be able to edit or delete this template.
237
Creating Report Template
To make manipulations with reports templates, you should have at least one resource with the access right Create,
edit, and delete report templates.
To create a new report template, press the New button. In the dialog enter a name for the template and choose its
type:
It is not recommended to change template type when editing a previously created template because all template
contents will be lost with this action.
Add tables and charts to your template, choose items for statistics, adjust map output, and decide upon other
parameters of the report. All added contents will be displayed at the left of the dialog.
Attention!
The set of report types as well as the set of tables and charts available for each type depends on your services and
modules.
In the left part of the dialog, you can set the sequence order of the pages and give them custom names if needed. To
change section name, click on it and enter any text. To manage template contents, use the following buttons:
— drag up/down,
— edit a table/chart,
— make a copy of a table/chart,
— delete page.
Note.
No matter where you place a chart, in the resulting report all charts follow after all tables, and the Statistics section
goes first.
238
Advanced Settings Table of Contents
Advanced Settings
Options
The right part of the Reports Template dialog contains advanced settings. They are divided into Address
Map output
Statistics
Address
Depending on template type, all or just several of these sections may be displayed.
Options
U.S. measurements option defines how mileage, speed, and fuel are given
in the report. If this box is checked, miles and gallons will be used throughout
the resulting report and not kilometers and liters.
Note.
If you check/uncheck this box for a report template where the intervals
filtration is applied, you should consider that the values of filtration
parameters won't be converted to the corresponding values of the other
measurement system automatically, though the units of measurement will be
changed from metric to American system or vice versa. For example, if you
have 50 kilometers mileage and 100 kilometers per hour speed, after
checking the box you will receive 50 miles mileage and 100 miles per hour
speed.
Multiple drivers/trailers option usage makes sense if a table containing such columns as ‘Driver’ or ‘Trailer’ is added
to the report template. If the box is not checked, then regardless of the number of drivers/trailers appointed to a unit
for the particular interval (trip, parking, etc.), only the first one of them will be shown in the table. If the box is checked,
then all the drivers/trailers appointed to a unit for the particular interval are shown in the table.
Mileage/fuel/counters with accuracy to two decimal places. By default, mileage less than 20 and fuel less than 50
is displayed with accuracy to hundredths, and larger values are given as integers (if the value is rounded to 0, the
result is printed as 0.00). Counter sensors of any values are by default displayed as integers, too. However, if you
consider it is necessary, mileage, fuel, and counters can be shown with accuracy to two decimals (other decimal
places are simply cut). If you see '0.00' in a cell, it means the initial value had thousands or even smaller fractions,
which can be seen if you export report to XML, CSV or Excel.
Exclude thefts from fuel consumption can be chosen if you want to ignore thefts when calculating fuel consumption
in different tables and statistics. Normally, thefts are considered as a part of fuel consumption. That is, if the option is
enabled, columns like Consumed by FLS and Average consumption by FLS are calculated without considering fuel
thefts.
Mileage from trips only is an option that affects mileage calculation. Mileage can be calculated either by all
messages or by messages in trips (considering trip detector).
Persian calendar and Date and time format options are applied to cells of the resulting report where time is shown.
These options are adjusted in the same way as in the User Settings dialog.
One more option is provided for group reports – Skip empty rows. It is used to withdraw uninformative rows from the
resulting table. For example, you create a report about fuel thefts, but not each and every unit in the selected group
has thefts, so there can be a lot of empty rows in the table.
Address
239
Here you choose how address information is presented in the resulting report. Address information can be displayed in
many reports: initial/final location in trip, place of fuel filling or theft, location where the unit parked or had speeding,
location where connection was lost, message received, event registered, etc.
Addresses can be taken either from your main map (Gurtam Maps / WebGIS) or from your POIs and geofences. No
Google, Yandex, or other services can be used.
For addresses which fall out of city bounds (near or on roads), two settings are important:
Max distance from unit says that if unit is located near a road and there is a city (i.e., city, town,
village) within the indicated distance, then in the address you will have the road's name and distance to
the city.
Min radius says that if no city has been found within maximum distance from unit (the previous option),
then the address is bound to another city. How big this city should be to form the address, you indicate
here – minimum radius of a city. This can be used to eliminate small cities from addresses.
Use POIs for addresses options allow to use POIs' names instead of usual addresses extracted from Gurtam Maps
/ WebGIS. If coordinates of unit location get into the radius of 100 meters from this POI (or other radius indicated in
unit properties), the address will be takes from its name. If unit location gets into the radius of two or more places,
the nearest is used. If both options (geofences and POI as addresses) are activated, the priority is given to POIs.
Use geofences for addresses options allow to use geofences' names instead of usual addresses. Those geofences
require having the flag Address source in their properties. If coordinates of unit location get into such a geofence, its
name will be used in address cell. If two different geofences overlay, the smallest is used.
POIs and geofences from all resources option is useful if you choose to show POI and/or geofences as
addresses. By default, only geofences and POIs that belong to the same resource as the reports template are used.
However, if the given option is activated and user has access to geofences and POIs in several resources, all of
them will be used.
Add POI/geofence description to address option is also useful if you choose to show POI and/or geofences as
addresses. If you enable it, not only POI/geofence name will be displayed in the address but also the description
text from their properties.
If no POI or geofence are found in given location, the address from the map is displayed.
240
Tables
The following tables (for units and unit groups) can be added to a report:
Table Parameters
Intervals Filtration
Chat History
Check Points
Chronology
Connection Problems
Counter Sensors
Custom Fields
Digital Sensors
Engine Hours
Events
Executed Commands
Fuel Fillings
Fuel Thefts
Geofences
GPRS Traffic
Logs
Maintenance
Non-visited Geofences
Parkings
Rides
Rounds (for unit)
Rounds (for route)
Sensor Tracing
SMS Messages (for unit)
SMS Messages (for resource)
Speeding
Stops
Summary
Trips
Unfinished Rides
Utilization Cost
Violations
Visited Streets
A template can contain any number of tables and charts. You can even add the same table type several times with
different configuration of columns, data grouping and other settings.
To add any of above mentioned tables to the template, click the Add Table button and choose a table from the list.
Each table type has its set of columns that can form this table. After you have chosen table type, the list of columns
available is displayed below. Check the columns you would like to include in the resulting table. To select all columns at
once, press <ctrl> on the keyboard and click on any checkbox. To make all columns unselected, repeat the same
operation. This combination works also for reports where you choose geofences, events, etc.
You can rename columns, clicking on their names and editing the text. In the same way you can change the name of
the table itself (the Name text box at the top of the dialog). To restore default column names, use the button Restore
default (when it is gray, it means the current name is default).
Besides, you can apply to the columns any sequence order. Move them up and down dragging the button .
241
Table Parameters Table of Contents
Table Parameters
Grouping
In the right part of the report template dialog, you can set additional parameters for the table Detalization
Grouping
Data given in the table can be grouped by time intervals such as days, weeks and months. By default, the grouping is
off. It means the data is given in the detailed view that is each row of the table represents a separate event (such as
fuel filling, violation, parking, SMS, etc. depending on table type selected), and these rows are arranged in the
chronological order.
If any grouping interval is set, then each row in the table will correspond to an interval (day, week, or month). An
additional column named Date, Week, or Month will be added as the first column of the table. A week can begin
either on Monday or Sunday, which depends on User Settings.
Below there are two examples. The first one is a detailed report on parkings from 1st to 4th of July 2012. No grouping
is applied.
242
The second table represents parkings for the same unit and interval, but here the data is grouped by days.
When using a grouping, all events that began in the analyzed interval are included in this interval, and when
calculating event's duration all its duration is considered. That is why in the example above the total duration of
parkings for the 4th of July is “1 days 5:58:06” that is larger than a day.
It is convenient to include the Count column in the table with a grouping. In this column, you get the count of events
which happened within the current interval (day/week/month). In a detailed report, this column will contain only ones.
At the same time, it is recommended to exclude such columns as Location when configuring a table with a grouping
because events happen in different places. However, even if you have selected this column, note that the location for
the first event in the interval will be displayed.
One more column can be useful for tables with groupping – Total time. The meaning of this column is similar to
'Duration' column but a bit different. 'Duration' shows the sum of intervals, for example, the sum of all trips detected.
'Total time' shows time from the beginning of the first interval to the end of the last, for example, time from the
beginning of the first trip on a day to the end of the last trip on the same day (so, you can know real working shift).
Detalization
A table with a grouping applied can be supplemented with detalization that is also reasonable for the group reports.
Then a plus-shaped button will be added at the beginning of each row. Press this plus to expand the hidden contents
for a certain row. To expand an enclosed level of all rows at once, press the corresponding number in the header of
the table.
For example, if there were four parkings detected at a day, in the grouped report the beginning of the first parking and
the end of the last one will be indicated. But if you expand the hidden contents, you can get a detailed information for
each of parkings in between. In the examples below you see the same report on parkings with grouping and
detalization.
Detalization can be applied only to grouped tables; it does not affect detailed tables.
Row Numbering
Row numeration can be added to any table type. To switch the numeration on, check Row numeration box in table
advanced parameters. The numeration is added to the table as its first column.
243
When numeration and detalization meet together, you get two-level numeration. The first level is a usual numeration of
main rows with integer numbers. The second level is the numeration of nested rows as “main row number – dot –
nested row number”.
Total
The Total row can be added to any table regardless its type, grouping or detalization applied. The total row is added
as the last row in the table and contains the resulting information such as total duration of a state, total number of
events registered, etc.
In online reports the total row is located at the bottom of the window regardless the number of pages in the table or
scrolling bar location.
Time Limitation
Time limitations can be applied to tables to limit data analysis by some time intervals, days of the week, days of the
month or months. For example, you can select working days and working time to be considered while generating the
table. However, if a state (for example, a trip) began within the indicated interval and finished outside this interval, the
state will not be cut off and its duration will be wholly included in the report.
244
Intervals Filtration
Attention!
This is part of the Advanced Reports module.
Several tables are supplied with additional parameters to filter intervals. There you can set conditions to select
information to be displayed in the resulting report. These conditions affect reports that concern selecting intervals from
the collection of messages. These reports are: Counter sensors, Digital sensors, Geofences, Engine hours, Parkings
and Stops, Rides and Unfinished rides, Speedings, Trips, and others.
The set of filtration parameters varies depending on table type. The following
parameters are possible: duration, mileage, engine hours, speed range, trips, stops,
parkings, sensors, driver, trailer, fuel fillings and thefts, geofences. Adjusting these
parameters will limit the scope of intervals getting to the report. For example, you
can indicate the minimum duration and minimum mileage for the trips to be
displayed. Alternatively, you can query visited geofences with a stop at least 10
minutes in them.
Incomplete interval
This filter affects only the last interval in the report. In many cases, reported period
ends and the last interval (trip, sensor operation, etc.) still continues. You can
choose one of the following options to deal with such unfinished intervals:
Show and cut off: show the incomplete interval and consider that it
ends with the last message within the reported period;
Do not show in report: do not show the incomplete interval in the
report;
Show and mark as incomplete: the incomplete interval will be shown
and will have 'Unknown' as the end time.
Duration
Minimum and/or maximum duration of the interval.
Mileage
Minimum and/or maximum distance travelled in the interval.
Engine hours
Minimum and/or maximum duration of engine hours. In addition, engine hours
sensor mask can be specified in the filter below – Engine hours sensor.
Speed range
Indicate minimum and/or maximum speed to be considered. It means that only those intervals will be displayed in the
report which contain at least one message with speed falling into the range. But more helpful might be retrieving
intervals. If you check the Retrieve intervals box, the report will focus on intervals where all speeds fall into the range.
Trips
This filter is used to show only intervals which somehow intersect with trips or, on the contrary, do not intersect.
Stops
Tick the checkbox and choose one of the two possibilities: With stops or Without stops. Then in the resulting table, only
intervals that meet the given condition will be shown. If the Stops option is not selected, then all intervals are displayed
regardless if there were any stops or not.
Parkings
245
The settings are similar to those for stops. In addition, you can indicate the minimum parking duration. For instance,
you can query geofences where there is a parking of a specified time (the Minimum duration flag). Besides, the parking
time can be summed up (the Sum up intervals flag). That means the geofences where the total parkings make up the
specified time will be displayed.
Sensors
The intervals where there are messages with sensor on or off can be selected. In addition, you can indicate minimum
and/or maximum time of sensor's on/off state. Like in parkings, the duration can be summed up (the Sum up intervals
flag). Besides, the intervals of on/off state can be retrieved, and each of them can be presented as a separate row of
the table (the Retrieve intervals flag). To indicate a certain sensor to be controlled, type its mask below. If you select
several, then the intervals which contain points with all these sensors on/off (simultaneously) will be selected. If no
masks are specified, then all digital sensors are considered.
Sensors masks
You can enter up to 4 masks. Sensors masks can affect Sensors filter, Counter column, and information on fuel (if any
of these options is selected in the report template).
Driver
This filter allows to select intervals with a certain driver or without any drivers. Choose the option With driver and
specify driver's name mask. The resulting table will contain only intervals with a corresponding driver – it does not
matter whether this driver is at the beginning, in the middle, at the end or in all course of the interval. In case several
drivers match the mask, all of them are considered but only the first one is displayed in the table. In addition, you can
enable the option Retrieve intervals to retrieve only segments with a specified driver from the scope of intervals.
If the option Without driver is selected, the resulting table will consist of intervals which contain segments without any
drivers. These segments can be retrieved as well.
Trailer
This filter works in the same way as the previous one, but it allows to filter intervals according to presence or absence
of a trailer assigned to a unit.
Fuel fillings
Intervals with fillings or without fillings can be displayed in the table. If the first case is chosen, then you can additionally
indicate max and min filling volume. Fillings can be summed up. In this case, the indicated filling volume will be applied
to the total of fillings found.
Fuel thefts
Intervals with fuel thefts or without thefts can be displayed. If the first case is chosen, then you can additionally indicate
max and min theft volume. Like fillings, fuel thefts can be summed up.
Geofences/Units
The filter is divided into two parts – geofences and units. In the upper part you can select geofences to be analyzed for
the report. You can focus on unit activity in or out of a geofence. To put a geofence under control, move the marker
from None to In or Out against a required geofence. Only geofences that belong to the same resource as the reports
template itself can be displayed here.
In the same way you can choose units (they are considered as 'moving geofences'). In this case, indicate radius for
these units. Thus, you can get information about unit activity in or out of the area of selected units. Only units to which
you have Query reports or messages access are displayed here. To quickly find a necessary geofence or unit, use the
dynamic filter. To select all items at once, use the <ctrl> key.
You can enter either integer or fractional numbers. Use point as a delimiter for fractional numbers.
Each of described above limitations can be applied either independently or along with other limitations. If the option
Retrieve intervals (in the Sensors or Speed sections) is combined with other conditions, then the filtration by other
conditions is applied after retrieving the appropriate intervals.
246
Chat History
This report unites commands of the kind Send message to driver and replies from the driver. How to carry a chat with a
driver...
247
Check Points
Route points refer to check points indicated when creating a route. The table can include:
Point name: the name given to this check point while creating it.
Real arrival: time when the unit entered this point.
Scheduled arrival: time when the unit was supposed to be there according to the schedule.
Initial location: location at that time.
Real departure: time when the unit left this point.
Scheduled departure: time when the unit was supposed to leave the point according to the schedule.
Final location: location at that time.
Result: Visited (both entrance and exit were detected), Entrance only, Exit only, Skipped.
Route: the name of the route to which this check point belongs.
Schedule: schedule name.
Round: round name.
Arrival time deviation: positive value if delayed, negative value if in a hurry in regard to arrival time set in
point properties.
Departure time deviation: the same for departure time.
Presence duration: time spent in the check point.
Presence mileage: mileage in the check point.
Section duration: time spent to travel from the previous check point to this one.
Section mileage: mileage from the previous check point.
Count: points count.
Driver: driver's name if available.
Trailer: trailer's name if any was bound.
Notes: an empty column for your custom comments.
See Route Statuses to know how different events about check point are detected.
Masks for geofence and/or route name can be applied additionally to this report. They are used in the same way as in
Rounds (for route) report.
248
Chronology
This kind of report gives information about all actions and changes in unit state during the indicated period of time.
Unlike most of other tables which are dedicated to certain things (parkings, sensors, trips, etc.), this table can gather
events of various kinds which allows to estimate movement history in the whole.
The following things can be included to the chronology (in the template select necessary):
Trips
Parkings
Stops
Engine hours
Fillings
Thefts
Events
Drivers
Trailers
Speedings
Connection loss
Sensor trigger (enter one or two masks to indicate needed sensors)
Type: trip, parking, stop, engine hours, filling (or reg. filling), theft, event (or violation), driver, connection
loss, sensor.
Beginning: when the detected activity began.
Initial location: unit location at the moment of activity beginning.
End: when the detected activity finished.
Final location: unit location at the moment of activity end.
Duration: how long this activity lasted.
Description: for trips and speedings – mileage, for events and violations – the text of notification, for
engine hours – duration, for drivers – registered driver name or 'driver unbound', for fuel fillings and thefts –
the volume of fuel and sensor name, for sensors – sensor activation/deactivation.
Notes: an empty column for your custom comments.
249
Connection Problems
This kind of report lists cases when connection with server or satellites was lost. The parameters for this report are
adjusted in Unit Properties => Advanced where you set Maximum interval between messages.
Additional filtration by driver, trailer, and geofences/units can be applied to this report.
250
Counter Sensors
This table shows the operation of counter type sensors. In the template, you set the mask (filter) for sensors or choose
All sensors. Possible columns are:
Intervals filtration can be applied to this table: by duration, mileage, engine hours, speed range, trips, stops, parkings,
sensors, drivers, fuel fillings, fuel thefts, and geofences/units.
Counter sensor's value can be visualized in the chart that shows counter's operation intervals and its value. More about
charts...
251
Custom Fields
The table Custom fields represents the list of custom fields entered in the corresponding tab of unit properties dialog
(see Unit Properties => Custom Fields).
To get this report, you need the access 'View custom fields' and/or 'View admin fields' for a unit/user/unit group. The
type of fields is selected in the right part of the report template dialog (all/general/admin fields).
Possible columns:
There is no point to apply additional parameters such as grouping, Total row, and numbering to this kind of report. It
does not matter what interval you choose for the report, because only the current fields contained in unit properties can
be displayed.
To get custom fields for unit group (see Other Reports), make sure the option Detalization is enabled. Pay attention
that individual fields of each unit will be displayed, and not the fields of the selected unit group. To get the fields of
group itself, check the option Group itself in report template.
252
Digital Sensors
Usually, digital sensors have two states: on/off, activated/deactivated, busy/free and so on. For example, it can be
ignition sensor or cargo load sensor. All sensors are configured in Unit Properties => Sensors.
In the report template you can select up to four sensors using masks. Enter sensor's full name or a part of the name
using wildcard symbols like asterisk * (replaces several characters) or question mark ? (replaces one symbol). Sensor
name cannot contain commas. Check the All sensors check box to automatically select all existing sensors. If no
sensors are selected or sensors are indicated incorrectly, the table cannot be formed.
Intervals filtration can be applied to this table: by duration, mileage, engine hours, speed range, trips, stops, parkings,
driver, trailer, fuel fillings, fuel thefts, and geofences/units.
253
Engine Hours
Engine hours report shows working actively of a unit, its productivity and utilization as well as fuel consumption and
some more things. The activity and efficiency of work of attached implements can be also analyzed.
To generate this report, the unit is supposed to have sensors like ignition, engine efficiency or absolute/relative engine
hours sensor.
The method of calculating engine hours is set in Unit Properties => General. In Unit Properties = > Advanced you can
also set two more properties: Daily engine hours rate (to calculate utilization and productivity) and Maximum interval
between messages (to cut off false intervals of engine hours operation).
Additionally, you can specify engine hours sensor to be used in this report. For this, enter its name mask in a special
filter in the reports template. It allows creating a separated table for each engine if there are several.
254
Productivity: percentage ratio of engine efficiency duration to engine hours duration
Consumed by ImpFCS/AbsFCS/InsFCS/FLS/math/rates: fuel volume used in engine hours. It can be
detected by a fuel sensor (like impulse/absolute/instant fuel consumption sensor, fuel level sensor) or
calculated by math or rates. Details about fuel in reports...
Avg consumption by …: average consumption in engine hours.
Consumed in motion by …: fuel volume used in engine hours while moving.
Avg consumption in motion by …: average consumption in engine hours while moving.
Consumed in idle run by …: fuel volume used in engine hours during idle running.
Avg consumption in idle run by …: average fuel consumption in idling.
Avg consumption by … in trips: average fuel consumption in trips.
Initial fuel level: fuel level at the beginning of the interval.
Final fuel level: fuel level at the end of the interval.
Max fuel level: maximum fuel level.
Min fuel level: minimum fuel level.
Notes: an empty column for your custom comments.
Intervals filtration can be applied to this table: by duration, mileage, engine hours, speed range, trips, stops, parkings,
sensors, driver, trailer, fuel fillings, fuel thefts, and geofences/units.
255
Events
All events registered by the system (including violations) can be shown in the report on events.
To make a report dedicated just to events of a certain kind, in report template enter a mask to filter events
text/description (like *speed*, *traffic*, *filling*, etc.). Only those messages which text corresponds to the given mask
will be added to the table.
In addition, you can use special markers for this report: a yellow flag means event, a red flag means violation. In the
tooltip you can find the detailed information.
256
Executed Commands
This kind or report gives a list of commands sent to a unit and successfully executed. Possible columns are:
Sending time: time when the command was sent to the unit.
User: login name of the user who performed the command (hidden if you do not have access rights to
some user).
Command name: command name as it is written in unit properties.
Command type: command type (see the list).
Parameter: additional parameter in the command (for messages it is text).
Execution time: time when the command was executed.
Channel: channel type used to transmit the command (TCP, UDP, Virtual, SMS).
Count: the number of sent commands.
Notes: an empty column for your custom comments.
This is a list of successfully executed commands. To see all commands sent to the unit regardless their execution, go
to the Messages panel.
257
Fuel Fillings
These reports show where and when a vehicle was filled up. The parameters for this report to be generated are set in
Unit Properties => Fuel Consumption. At that, fillings registered manually are not taken into account.
Intervals filtration by geofences/units, driver, trailer, and filling volume can be additionally applied to this table.
You can use special markers for this report to mark places of fillings on the map.
Attention!
If no fillings were detected, the table is not generated. Furthermore, registered fillings are ignored then, too.
258
Fuel Thefts
This report is aimed to show all thefts – when, where and how much fuel was stolen. The parameters for this report are
set in Unit Properties => Fuel Consumption.
Intervals filtration by geofences/units, driver, trailer, and theft volume can be additionally applied to this table.
259
Geofences
This report shows when and how often a unit visited different geofences. In the right part of the template dialog, the list
of all geofences is displayed. You can indicate one or more geofences to put them under control of this report,
otherwise the report will not be generated. The list of geofences includes only those geofences which belong to the
same resource as the report template itself (so, you need to have access to them). Geofences on the list are sorted by
name.
Instead of geofences, you can choose units in the reports template. Additionally, you indicate radius for these units (in
meters). In this case, those units are considered as 'moving geofences', and the activity of the unit selected to generate
the report is analyzed in regard to these moving geofences. The access Query reports or messages is required to
those units.
Intervals filtration can be applied to this table: by duration, mileage, engine hours, speed range, trips, stops, parkings,
260
sensors, drivers, trailers, fuel fillings and thefts.
Geofences can be displayed on the map. For this choose Render geofences option in the report template.
261
GPRS Traffic
Attention!
This report can be not included to your package.
To apply this report to a unit, this unit must have registered events of GPRS traffic counter reset or traffic storage
should be adjusted in jobs.
262
Logs
The Log table can be generated for any type of an object presented in reports, i.e., for unit, unit group, user, resource,
retranslator, or route. Log contains records about changes made in object's properties or its contents. To see the log of
a unit, it is no enough to have Query messages or reports access to it; in addition, you need Manage log access.
Time – date and time when the change was done (saved).
User – name of the user who did it. You can specify user's name mask in report template and so get only
changed made by a certain user.
Item type – unit, unit group, user, resource, retranslator, or route.
Action – description of the change performed.
Host – the address of the computer from which the user did the change or it can be 'job' or 'notification' if
the action was automatic.
Notes – empty column for custom notes.
User's log provides with two types of information: changes made by this user and changes made by other users in
regard to this user as system object. One more column is available in this report – 'Item name':
The log of u nit group has an additional parameter – 'Group itself'. If this checkbox in disabled, the log shows changes
made to units in the group (detalization is required in this case):
If the option 'Group itself' is enabled, the log shows changes made to this unit group as system object:
263
Maintenance
This table contains the list of service works (maintenance) done during the indicated period and registered by users
who have at least edit access to this unit. The table can be composed of the following columns:
Service time: date and time that were indicated during the registration.
Registration time: date and time when the event was registered.
Kind of work: the text from the field 'Kind of work'.
Comment: the text from the field 'Description'.
Location: location indicated while registering (together with comments entered manually).
Duration: duration of work.
Cost: service cost.
Mileage: mileage counter value at the moment of registration.
Engine hours: engine hours counter value at the moment of registration.
Count: the number of services.
Notes: an empty column for your custom comments.
Attention.
Blue rows mean that the place was indicated on the map during the registration.
264
Non-visited Geofences
This report gives the list of geofences that were not visited during the indicated time period. In report template, choose
geofences to be checked when generating the table. The list of geofences includes only those geofences that belong to
the same account as the report template itself. Geofences on the list are sorted by name. If the list is large, it is
convenient to use name mask to quickly find necessary geofences.
Let us assume, we have 10 stores (geofences) to be visited every day. We would like to find out whether there are
geofences which were ignored within the work week from 11th to 15th of May. To do this, we enable grouping by days
and detalization, select necessary geofences and columns for the table.
From this report we see that on 1st of June 'Point 11' and 'Point 7' were ignored, on 4th of June – 'Point 2', and on 5th
of June – five geofences. 2nd and 3rd are missed in the list, and it means that all predefined geofences were visited on
those days. You can click on geofences' names to move the map to the first point of a geofence.
When the table is applied to a unit group, you can find one more parameter in the report template – Consider group
as a whole. When the flag is off, a group report is structured in the same way as individual report, and the information
is given for each separate unit from the group. When the flag 'Consider group as a whole' is on, report structure is
different – you get the list of geofences that were visited by none of the units in the group.
265
Parkings
Parkings are estimated according to parameters set in Trip Detection when configuring a unit. To get information as
accurate as possible, it is advised that you configure each parameter individually for every piece of equipment.
1. Insignificant speed. The speed detected must fall in the range from 0 to the Minimum moving speed.
When this speed is achieved, unit's behavior is regarded as movement (= trip), if by time and distance it
corresponds to trip definition (Minimum trip time and Minimum trip distance parameters). Then the parking
finishes. However, if by time or distance the movement does not fall into trip definition, the parking is
prolonged.
2. Sufficient time interval. Insignificant speed must continue not less than Minimum parking time. If this time
is not achieved, unit's behaviour is not regarded as parking. It may be regarded as a stop, but only in case
there was a zero speed registered.
3. Insignificant location change. As it has been already noted above, the parking is also an insignificant
movement in space, that is a travel which in not longer than Minimum trip distance if by time it not shorter
than Minimum parking time.
Intervals filtration (by parking duration, sensor state, driver, trailer, fuel fillings/thefts, and geofences/units) can be
266
applied to this table.
The parkings can be displayed on the map. To make use of this feature, select Parking markers in the report template.
Attention!
You should distinguish parkings from stops.
267
Rides Table of Contents
Rides
Preparing a Ride
A ride is a travel from one point (called ride beginning) to another (called ride ending). A ride Rides Parameters
can be done many times in a specified time period. Rides are useful, for example, when Report on Rides
Preparing a Ride
To get a report on rides performed, geofences are needed to indicate ride beginning and ride end. The beginning and
the end can be the same geofence if the ride starts and ends in one place, for example, if it is necessary to travel ride
around some shops and come back to the base.
Let us assume that it is needed to transport goods from one place to another, and more than one ride is needed to do
this. To control this process, we create Point A geofence and make it the beginning of the ride. Then create Point B
geofence and make it the end of the ride.
Rides Parameters
When you create a template for rides, pay attention on additional parameters to be set.
Circle ride is a ride that starts and finishes in the same geofence, that is a unit must leave this geofence and return
after a while. Such a geofence must have both flags – ride beginning and ride end.
The option Show rides started/finished with a stop only can be used as an additional filter. If activated, it means
that ride beginning and end can be only a visit to a corresponding geofence with a stop in it. If a unit visited a
geofence with ride beginning flag but did not make a stop there, this ride will be not considered by the system. In a
similar way, if a unit visited a geofence with ride end flag but did not make a stop there, the ride will continue (if ride
beginning was detected before).
In the Redefine ride beginning/end section, you choose which geofences and units will be analyzed in this report.
The list of geofences includes only those geofences that belong to the same resource as the report template itself.
When you create this type of report template, some of the geofences can be already ticked – it means they have
corresponding flags in their properties. You can remove flags or set more flags if needed. Besides, you can choose
units as so-called 'moving geofences'. For them, set radius to outline unit's area. Geofences and units on the lists are
sorted by name. If the list is large, it is convenient to use name mask to quickly find necessary items. You can even
set ride beginning at unit area and ride end at an ordinary geofence.
268
Besides, intervals filtration can be applied to this table: by duration, mileage, engine hours, speed range, trips, stops,
parkings, sensor state, driver, trailer, fuel thefts, fillings, and geofences/units.
Report on Rides
The report on rides gives the list of all performed rides. The table can contain the following information:
Ride: ride mane consists of starting geofence name and final geofence name hyphenated compound.
Ride from: can be used instead of the previous column. Only the departure geofence is indicated here.
Ride to: destination geofence.
Beginning: date and time when the ride began.
End: date and time when the ride ended.
Mileage: distance travelled in this ride.
Mileage (adjusted): mileage subject to the coefficient set in unit properties (Advanced tab).
Ride duration: how much time it took to perform the ride.
Total time: time from the first ride beginning to the last ride end (useful if groupping by days is enabled).
Parkings duration: time spent in parkings.
Avg speed: average speed calculated for this ride.
Max speed: maximum speed registered during this ride.
Driver: driver's name if he was identified.
Trailer: trailer's name if any was bound.
Counter: counter sensor value.
Initial counter: counter value at the beginning.
Finale counter: counter value at the end.
Count: the number of rides.
Status: unit status registered during the current ride (if there are several, the first one is displayed).
Consumed by ImpFCS/AbsFCS/InsFCS/FLS/math/rates: the volume of consumed fuel detected by a
fuel sensor (like impulse/absolute/instant fuel consumption sensor, fuel level sensor) or calculated by math
or rates.
Avg consumption by ImpFCS/AbsFCS/InsFCS/FLS/math/rates: average fuel consumption in the ride
detected by one of the methods mentioned above.
Initial fuel level: fuel level at the beginning of the ride.
Final fuel level: fuel level at the end of the ride.
Max fuel level: maximum fuel level.
Min fuel level: minimum fuel level.
Notes: an empty column for your custom comments.
269
See also Unfinished Rides.
270
Rounds (for unit)
If any routes were assigned to unit and events about routes were stored in unit history, a report based on these events
can be generated:
How different route statuses are defined (route beginning, route end, point skipped, point visit, etc.), find here.
In addition, in report template, you can indicate masks for geofences and routes. It means you can get in a report not
all routes performed by a unit within the indicated period, but only the routes which use a certain geofence or which
correspond to the given mask of route name. Both filters can be used simultaneously or separately from each other.
Besides, these filters affect the data layout in the table if the grouping by days/weeks/month is used. For instance, if
the data is grouped by days and the filter by geofence is on, the table is built on the basis of geofences. If the data is
grouped by days and the filter by routes is on, the table is built on the basis of routes. If both filters are activated, the
sorting is made on the basis of both.
Intervals filtration can be applied to this table: by duration, mileage, engine hours, speed range, trips, stops, parkings,
sensors, driver, trailer, fuel thefts, fillings, and geofences/units.
271
Rounds (for route)
A special report can be built to show units' performance of a certain route. The following columns can be presented:
Beginning — round beginning time (activation time or entrance in the first check point).
Last activity – time of latest event concerning this round.
Round – round name.
Schedule – schedule name.
Order – check points order.
Unit — name of unit preforming the round.
Status — result: Finished (the route was activated successfully, and later on the entrance to the last point
was detected) or Not finished (the last point was not visited).
Points — total number of check points in the route (on this bases more detailed report can be generated –
see Check Points).
Skipped — the number of check points skipped.
Visited — the number of check points visited.
272
Sensor Tracing Table of Contents
Sensor Tracing
Out of range values
This table shows sensor values in certain point in time. The table can be exported in MS Excel
where you can build any custom charts based on the data provided.
The report can include all messages or take a value in a time interval (like take a
value every 10 minutes). One or the other alternative is chosen when configuring
report template. If tracing interval is indicated, the system will search and display
sensor value from the message which is the closest to the necessary point in
time.
Available columns:
Activate the appropriate checkbox to get a separate column for each sensor. This option is available only in reports for
single units, not for unit groups. Besides, with this option enabled, it is impossible to skip out-of-range values. If you
choose this option, the columns 'Values' or/and 'Formatted value' will be generated for each sensor individually (sensor
name is given in brackets then). This allows exporting sensor values to MS Excel and eventually building various charts
and diagrams on this basis.
In addition, you can choose a driver/trailer and geofences/units to be controlled (see intervals filtration for details).
273
SMS Messages (for unit)
This report gives possibility to view all SMS messages receives from a unit in a specified period. Here you see date
and time when the message was received and the text of the message.
Time received: date and time when the data was received by the server.
SMS text: message text.
Count: the number of messages.
Notes: an empty column for your custom comments.
274
SMS Messages (for resource)
This report provides a possibility to view information about all the SMS messages sent by users of any resource for the
indicated period of time. The information may contain the following columns:
275
Speeding
This kind of report shows speed limitations violations. The parameters for this report are set in Unit Properties = >
Advanced where you set Speed limit. The messages (at least two in succession) containing a speed value greater than
set in that parameter will become the basis for this report. If these messages are several in succession, they are united
in one speeding event.
Beginning: date and time when the speed limit was excessed.
Location: device location at that moment.
Duration: how long the violation continued.
Total time: time from the first speeding beginning to the last speeding end (useful if grouping by days is
enabled).
Max speed: maximum speed within this period.
Mileage: the distance travelled with exceeded speed.
Mileage (adjusted): mileage subject to the coefficient set in unit properties (Advanced tab).
Avg speed: average speed within the interval.
Average excess: average speed excess within the interval.
Driver: driver's name (if a driver was identified).
Trailer: trailer's name if any was bound.
Count: the number of speed violations.
Notes: an empty column for your custom comments.
Intervals filtration (by speeding duration, mileage, driver, geofences/units) can be applied to this table.
276
Stops
A stop is one or more consecutive messages with a zero speed. Stops can be registered at lights, intersections, in
traffic jams, etc.
Stops should be distinguished from parkings. Parameters to detect trips, parkings, and stops are adjusted in the trip
detector. If there are several messages in succession, they are united in one stop. If total time of such a stop reaches
Minimum parking time, it is registered as a parking (not a stop).
Intervals filtration (by stop duration, sensor state, driver, trailer, fuel fillings and thefts) can be applied to this table.
277
Summary
This kind of report allows to from a table with diverse data concerning a period of time and at the same independent of
any conditions like trips, sensor operation, geofence visit, etc. The following columns can be included:
Fuel can be calculated for the whole interval, in trips or in engine hours, which is chosen in additional parameters of the
table. This option affects such columns as “Consumed…” and “Avg consumption…”.
As additional settings, you can specify masks for sensors (fuel, counters), including engine hours sensor.
When a report is generated for a single unit, it makes sense to enable grouping by days/weeks/month. Otherwise, there
will be only one row in the resulting table — summarized data for the whole interval. In reports for units groups (without
grouping) a row corresponds to a unit.
278
Trips
This kind of report shows intervals of movement with indication of time, location, and other parameters such as speed,
mileage, fuel, and many others. Intervals of movement (trips) are detected according to parameters set in Trip
Detection and adjusted for each unit individually.
279
See Data in Reports to discover more about formatting time, mileage, fuel, etc.
Intervals filtration can be applied to this table: by duration, mileage, engine hours, speed range, stops, sensors, driver,
fuel fillings, fuel thefts, and geofences/units. For example, you can query trips with a sensor on
The tracks of the trips can be displayed on the map. To make use of this feature, select Tracks on map option in report
template.
280
Unfinished Rides
See the previous topic Rides to learn how to prepare rides for this report.
Unfinished is a ride when a unit left a beginning-ride geofence and after a while entered a beginning-ride geofence
again. This can be the same geofence (if circle rides are not allowed) or another one.
See Rides to find out more information about additional parameters for Unfinished rides.
281
Utilization Cost
The table on utilization costs unites two kinds of expenses: maintenance and fillings. Both of these things have their
own detailed tables (see Maintenance and Fuel Fillings). This table is designed to show running costs. Note that only
fillings registered manually in a special Events Registrar get here (no fillings detected by a fuel sensor).
Time: date and time that were indicated during the registration.
Registration time: date and time when the event was registered.
Expense item: maintenance or filling.
Description: custom description entered when registering.
Location: location indicated while registering (together with comments entered manually).
Cost: service or filling cost.
Count: the number of services and/or fillings.
Notes: an empty column for your custom comments.
Blue rows mean that the place was indicated on the map during the registration.
282
Violations
Violations are particular case of events. The report on violations gives the list of violations detected and registered in
unit history.
Violations are:
To make a report dedicated just to violations of a certain kind, in report template enter a mask to filter violations
text/description (like *speed*, *accident*, *temperature*, etc.). Only those messages which text corresponds to the
given mask will be added to the table.
283
Visited Streets
This report shows which streets were visited and when. Highways, roads, and other places with available addresses
are also considered as streets in this report.
When clicking on a green cell in the table, the map is moved in such a way to display a point where the unit entered or
left the indicated street, or reached the maximum speed, and this place is highlighted by a special marker.
Sometimes there can be gaps in cells. It may happen when only one message from a place was received in
succession. In such cases, just the name of the street and arrival time are given.
Intervals filtration can be applied to this table: by duration, mileage, engine hours, speed range, trips, stops, parkings,
sensors, fuel fillings and thefts. For example, you can get streets where a sensor was on or the streets where a sensor
was off.
284
Charts Table of Contents
Charts
Regular Charts
Some reports give information in the form of a chart. For instance, it can be a chart showing
how a unit speed varied with time or a chart showing dependence of fuel consumption on speed, and many other kinds
of charts.
To receive charts in reports you need to have corresponding equipment (sensors) properly installed and configured
(except for some charts like Speed or Altitude which do not require any special sensors). How to create and configure
sensors, read in the section Sensors.
To add a char to a report template, click the Add Chart button in the template properties dialog. A chart cannot be
included to a report if report type is Unit group.
Enter a name for a chart or live default Chart (the same for all charts).
Regular Charts
There are several types of charts. First of all, this is Regular type. Their X axis always presents time scale, and you
choose data for Y axis:
Speed
Altitude
Engine operation
Voltage
Temperature
Engine revs
Counter sensor
Custom sensors
Custom digital sensors
Absolute mileage
Mileage in trips
Instant mileage
Fuel level (no filtration is applied)
Processed fuel level (filtration is applied)
Fuel consumption by ImpFCS
285
Fuel consumption by AbsFCS
Fuel consumption by InsFCS
Fuel consumption by FLS
Fuel consumption by math
Fuel consumption by rates
Attention!
This list depends on purchased modules.
The names of these items are editable. However, when building a curve for a sensor, it will borrow sensor name.
Select data set for the chart checking necessary items in the list. You can select two items, then the chart will contain
two curves, for example, speed and engine revs. You can select even more items but note that only two variables can
exist in one chart in addition to time. It means if Y axis presents speed scale at the left and temperature scale at the
right, there is no place for engine revs. But if Y axis presents speed scale at the left and consumption by ImpFCS at
the right, it is still possible to add consumption by AbsFLS and other methods because all they are measured in the
same metrics and will use Y right scale.
In the picture below there a speed chart united with fuel level chart. To receive such a chart, it is needed to set
Regular chart type and select Speed and Fuel level for data set.
If there are more than one curve in the chart, they are displayed in different colors. At the top of the chart you can see
the names of all lines as they are indicated in the report template or sensors names. In addition, the metrics are
indicated for all axes.
Fuel level chart represents 'raw' data. On the contrary, Processed fuel level chart shows filtered data. At that,
Processed fuel level chart does not work if the flag Time-based calculation of fuel consumption is disabled.
Mileage Charts
Four kinds of mileage chart can be created: absolute mileage, mileage in trips, instant mileage, and instant mileage
smoothed. The first two show how mileage changed (increased) with time. Absolute mileage chart is built on the bases
of all messages. That means any inaccuracy and outlying data affect the resulting chart. Mileage in trips chart
considers trip detector that is chows mileage in trips only. Below you see the chart with curves: absolute mileage
(blue) and mileage in trips (orange).
Instant mileage represents data in the form 'mileage from the previous message to the current one' that is the distance
between two adjacent messages. This kind of chart can be useful to detect excessive mileage during connection loss,
286
or to detect made-up additions to the mileage.
287
Chart Management
A handy interface provides enough tools to work with charts. You can adjust a needed zoom, move along the chart left
and right, get a precise sensor value in the indicated point, etc.
To navigate a chart along the X axis, use the corresponding arrow-shaped buttons. They are useful if the
Scroll current zoom level does not hold the whole chart. The chart shifts right and left by a quarter of its visible
right/left part.
Use this button to scale the Y axis. If the button is pressed and you are changing chart zoom along the X
Y axis
axis, then the Y scale is recalculated automatically in such a way to use the maximum of chart space. If the
auto
button is released, the Y scale always stays unchanged.
zoom
The buttons to scale a chart along the X axis make visible area of the chart twice as wide or twice as narrow
Zoom
in regard to the current position. At that, the center of the chart stays in its place.
in/out
When the custom zoom is activated, a mouse cursor is displayed as a blue vertical line. Holding the left
Custom mouse button you can select a needed area of a chart to increase it. You can repeat the operation several
zoom times.
To see the chart in its initial position and scale, press the Reset button.
Reset
Pay attention that there is one more parameter which affects chart zoom. This option is set in report template and
called Count from zero. If it is on, the Y axis will always have zero despite of the position of the Y axis auto zoom
button.
Chart tracing
To get a sensor value in a given point, activate Trace chart values option. A mouse cursor is then displayed as a red
vertical line. Place it over any place on the chart and get detailed information at that point (as in the picture above).
Three sections can be contained in the popup tooltip:
1. Time where the cursor is placed and all values of the curves for this point.
2. Message nearest to this point: time (can slightly differ from the time of the cursor!), location, speed,
coordinates, altitude.
3. Values of all visible sensors at this point.
If the X axis shows time, you can click on any place of the chart to move to the corresponding location on the map.
288
You can move to unit's messages straight from an online chart to analyze initial data. To do this, press the 'Transfer to
messages' button in the toolkit. Then, click on any place of the chart to load messages for the reported period with
focus on clicked point. Other functionality is the same as with tables.
289
Chart Parameters Table of Contents
Chart Parameters
Select Sensors
In the right part of the dialog, you can indicate sensors to form the chart. This selection does Smoothing
not affect such charts as Speed, Altitude, Fuel consumption by math and Fuel consumption by
rates because they do not need any sensors to be built.
To indicate necessary sensors, enter a mask to search sensors – full sensor name or its part using wildcard symbols
like asterisk * (replaces any number of characters) or question sign ? (replaces one character). Sensor name cannot
contain comma.
You can skip this possibility and select All sensors option. In this case, the system will automatically define sensors of
a required type when building a certain chart.
If any masks are assigned and All sensors option is selected, the chart will be built for all sensors and masks will be
cleaned.
Split Sensors
If there are several sensors of the same type and a chart of the same type is created, the curves for all sensors will
appear in one chart. To split them, choose the appropriate option Split sensors. Then an individual chart will be built
for each sensor. For example, there is a unit with two voltage sensors – external voltage and internal voltage. If
creating a voltage chart for this unit, we can get one chart with two curves on it or two chart with one curve on each (if
Split sensors option is enabled).
290
If several data is selected for the chart and for each several sensors exist, the upper one will be split. Let us assume
that a unit has two voltage sensors and two temperature sensors, and you are building a voltage/temperature chart for
it. If Split sensors option is off, you will get one chart with four curves in it. If Split sensors option is on, you will get two
charts with three curves on each: one chart will contain the first voltage sensor and both temperature sensors, and
another one will contain the second voltage sensor and again two temperature sensors.
This flag is responsible for chart zoom. By default, Y scale range depends on the range of values found within the
interval. For instance, if the temperature varies from 3 to 5, Y axis begins from 3, and the curve occupies maximum
space in the chart. If the option Count from zero is activated, Y axis is built from zero to the highest value (or from
the lowest value to zero if the values are negative).
In the picture below you see two temperature charts built for one unit for the same period. The first chart is regular; the
second one has the flag Count from zero.
Trips
The chart can contain a special line displaying unit state: upper position is for movement (trip), lower position is for
stay. Movement/stay intervals are detected according to trip detector settings. If trip detector is not set, the line will not
appear. To activate the line, choose Trips option in chart parameters.
Smoothing
Almost all regular charts can be presented in two forms: raw and smoothed. Raw charts are drawn from one message
to another in a linear way and have angular look. Smoothed charts look more streamlined. The smoothing algorithm is
the same for all chart kinds.
291
Below is an example where the orange line displays a raw speed chart, and the blue line displays a smoothed speed
chart. The violet line is to indicate trip and stay intervals.
292
Other Charts Table of Contents
Other Charts
Processed Fuel Level
Along with the regular charts, you can generate the following charts: Speed/Fuel Consumption Chart
The axes of these charts cannot be changed, however, it is possible to change chart name and use Select sensors and
Split sensors options.
Processed fuel level chart shows the values which are used while calculating fuel level, fillings and thefts in tables.
The chart shows how fuel level changes in time or depending on mileage. The caption of the tab will be
correspondingly Time/Fuel level or Mileage/Fuel level. The chart Time/Fuel level is built only if in unit configuration the
option Time-based fuel level sensors consumption is on. In all other cases, the chart Mileage/Fuel level is built.
Besides, the data is processed according to filtration level set on the Fuel Consumption tab (the option Filter fuel level
sensors values) or in sensor properties.
Below are two fuel level charts: the first one is processed (time-based FLS is on, filtration is on, filtration level is 25),
and the second one is not processed.
A special chart Processed fuel level should be distinguished from two similar regular charts:
293
1. Regular chart Fuel level represents the raw data (no filtration is applied). The flag Time-based fuel level
sensors consumption does not affects the chart.
2. Regular chart Processed fuel level is not available if the option Time-based fuel level sensors
consumption is off. If the option is on, the filtration is applied.
These regular charts can represent data only in the form Time/Fuel level. Besides, it is possible to overlay other
charts, such as voltage chart, for example. Special charts cannot be combined with other charts.
This chart shows dependence of average fuel consumption on speed. The data for these charts can be taken from fuel
consumption sensors of different types (as impulse, absolute, instant) or fuel level sensor, or predefined consumption
by math or rates. The appropriate calculation methods must be indicated in unit properties on the Fuel Consumption
tab.
For example, to create this chart, a unit with instant fuel consumption sensor (InsFCS) was used.
294
Map Output
In the Reports panel, the map can be scaled and moved in the same way as everywhere else: zoom, move, apply
tools, change the map source, etc. Even being in the Reports panel you can still track your units. Besides, some
specific map options can be applied exactly to reports.
The map with tracks can be also exported to HTML or PDF file together with report text. To include the map to the
exported report, in the Export dialog check the box Attach map.
In such reports as 'Trips', 'Parkings', 'Fuel fillings' and many others which contain information about unit location,
this location can be easily shown on the map. To move to a place where something happened, click on a green
row of the table. The map will be centered on the place and a marker will appear there. A similar feature is available in
the regular charts (where the X axis displays time): when using the trace tool, you move to the requested massage on
the map.
Some elements can be drawn on the map as a part of the report. They can be selected in the Map output section of
the report template dialog. These can be routes traveled by unit, created POI and geofences, as well as special
markers in the form of small icons which can be put in the places of events, fillings, thefts, speedings, etc.
All graphical elements are shown for the current report. If generating a new report, all tracks and markers from the
previous report will be erased and replaced by new.
When switching to other panels, all graphical elements from the current online report as well as map position and zoom
remain on the map. To remove them, return to the Reports panel and push the Clear button. Alternatively, the graphics
of any panel can be hidden or displayed again. To do this, check the corresponding boxes in the horizontal menu.
More...
295
Tracks on Map
The routes traveled by a unit in a chosen period of time can be shown on the map. To do this, in advanced settings a
report template dialog select the corresponding options – Trips routes or All messages on map. These options are
similar but a bit different. In case of Trip routes, only the intervals considered as trips (according to Trip Detector) will
be displayed as tracks. In case of All messages on map, all messages with valid coordinates will be converted into a
track. If in unit history there are intervals where the connection has been lost (no messages for a long time) or
coordinates miss in messages, such intervals are displayed with a dashed line.
By default the routes are drawn with blue color. However, you can choose another color or even have many-colored
tracks according to speed or sensor state. The set of colors to be used in tracks is defined in Unit Advanced
Properties).
Besides, to get information about track points, hover mouse cursor over and see information in a tooltip (time, speed,
coordinates, altitude, sensor values). Note that messages are searched in the radius of 50 pixels to the cursor.
If tracks or all messages are on, then in such tables as Trips, Rides, Engine hours, Speedings will be supplied with an
additional first column containing the icon of the binoculars. When clicking on the icon, the map is centered at a certain
segment of the track, and this segment is highlighted by a thick red line on the map.
Tracks can be rendered for units groups, too (see Other Reports). It is reasonable to assign different colors for units in
group to differentiate them on the map. However note that the number of simultaneously drawn messages can be
limited by your service provider.
296
297
POIs and Geofences on Map
Created POI and geofences can be a part of a report. They will be displayed on the map if you check the
corresponding boxes – Render geofences and Render POIs in the report template. Both geofences and POI are
displayed with captions – purple for geofences and orange for POIs (if no other color is selected in POI properties).
Group icons.
POI as well as markers can be united in one conditional icon when they overlap and details are given in
the tooltip.
Consider POI visibility scale.
By default, all POIs are rendered on the map. However, they can be seen or hidden according to their
visibility parameter set in POI properties.
Note.
POI and geofences are taken only from the same account that report template.
298
Markers Table of Contents
Markers
Unit Last Location
Most kinds of reports can have additional information visualized on the map with the help of
special markers. To get these markers in a report, select necessary markers in a report template.
The table below presents all possible markers and their icons.
Parking Marks a location where according to the trip detector a parking takes place. A tooltip shows the
marker beginning of a parking time and parking duration.
Stop Marks a location where according to the trip detector a stop takes place. A tooltip shows the beginning
marker of a stop time and stop duration.
Filling Marks a location where according to sensors data a fuel filling takes place. A tooltip shows filling time
marker and amount of fuel filled.
Theft Marks a location where according to sensors data a fuel theft takes place. A tooltip shows theft time and
marker amount of fuel stolen.
Marks a location where events were automatically registered in notifications, routes, and etc. The events
Event
registered manually, including fuel fillings, are also shown by such markers if a location (and preferably a
marker
description) is indicated upon event registration. A tooltip shows event time and text of an event.
Violation If you choose event markers, then both event and violation markers to be displayed, because violation is
marker a special case of an event.
Marks a location where speed limits indicated in the unit properties have been violated. A tooltip shows
Speeding the initial time of speeding interval (i.e., the time of receiving the first message with speed value
marker exceeding the allowed one), the allowed speed (indicated in the unit properties), the value of speeding
and the total duration of a speeding interval.
Image
Marks a location where pictures from a unit have been received.
marker
Note.
When enabling event markers, in addition to event markers you will get violation markers because violation is a special
case of event.
Markers appear on the map after report is generated. If you see no markers, it means there is no events of the
indicated type or the current map scale is not enough (try to zoom in).
When hover the mouse cursor over a marker, in a tooltip you see additional information: for stops and parkings –
starting time and duration, for events and violations – time and notification text, for fillings and thefts – time and fuel
volume, for speedings – starting time, speed limitation as it is defines in unit properties, how much the speed is
exceeded, and duration of this speeding.
Apart from that, markers as well as POIs can be united in one conditional icon when they overlap – Group icons option
in report template. Then more detailed information about what happened in that place will be available in the tooltip.
However, if there are more than 100 grouped markers, only their names appear in the tooltip, without detailed
299
information.
You can enable Marker numbering option in report template. In this case, each number will have its sequence number
which is indicated above the marker in violet colour. Numbers are assigned chronologically, and each marker type has
its own numeration. If marker icons are grouped, the numbers are given in the tooltip.
The last location of the unit can be displayed on the map. To enable this feature, select the Unit last location checkbox
in map output settings of report template. Last location does not depend on the reported interval, it is taken from the
latest message received from the unit. Units are displayed on the map by their icons or by motion state signs
(depending on User Settings. In the popup tooltip you will find time when message received, speed at that point,
altitude, and the values of mileage and engine hours counters.
300
Statistics
Statistics is a table consisting of two columns where the first one contains the parameters you have chosen, and the
second one shows their values.
Statistics is a special table giving general information and results. It can contain reports name, unit name, reported
interval, number of messages analyzed for the report, and any statistical information you select.
It is recommended to include Statistics to any report as it contains the basic information about the report itself.
Statistics is adjusted in report template in the section of Advanced settings. Check fields you would like to include in
Statistics. For your convenience, items are divided into subgroups. To select all items in a subgroup, tick the checkbox
near its name.
If any item in statistics is checked, the section Statistics appears at the left part of the report template. You can edit it if
you click on the button against it. Then you can add and remove items, rename them, and change their position. In
the middle column the subgroup is indicated.
In the resulting report, Statistics is always displayed at the beginning of the reports.
The following information can be included in Statistics for reports of Unit type. For other types of reports, statistics is
different and can contain just a couple of rows: report template name, object's name, report interval beginning, report
interval end, and time of report generation.
Statistics
Report: reports template name.
301
Unit: unit name.
Report execution time: time of report generation when a user executed the report online or it was
generated automatically as a job or notification.
Interval beginning: reporting interval beginning.
Interval end: reporting interval end.
Time zone: time zone as it is set in user settings.
Messages: messages analyzed within the reporting period.
Mileage in all messages: mileage in all messages according to the mileage counter selected (without
filtration by trip detector).
Consumed by ImpFCS/AbsFCS/InsFCS/FLS/math/rates: the volume of consumed fuel detected by
a fuel sensor (like impulse/absolute/instant fuel consumption sensor, fuel level sensor) or calculated
by math or rates.
Avg consumption by ImpFCS/AbsFCS/InsFCS/FLS/math/rates: average fuel consumption in trips
detected by one of the methods mentioned above. It can be presented either as liters per 100
kilometers or miles per one gallon. The whole mileage of the reported interval is normally taken for
these calculations. However, average consumption by FLS can take either all mileage or mileage by
trip detector.
Initial fuel level: fuel level at the beginning of the interval.
Final fuel level: fuel level at the end of the interval.
Max fuel level: maximum fuel level.
Min fuel level: minimum fuel level. Details about fuel in reports...
Counter sensors
Total counter: the sum of values of all sensors of counter type.
Engine hours
Engine hours: engine hours duration. It can be calculated by engine hours sensor or by ignition
sensor depending on unit properties.
Mileage in engine hours: distance travelled during engine hours operation.
Avg engine revs: average rate of engine revolutions.
Max engine revs: maximum rate of engine revolutions.
Engine efficiency duration: the duration of attached implements operation (if having engine
efficiency sensor).
Engine efficiency idling: engine hours minus engine efficiency time.
Utilization: percentage ratio of engine hours duration to engine hours rate.
Useful utilization: percentage ratio of engine efficiency duration to engine hours rate.
Productivity: percentage ratio of engine efficiency duration to engine hours duration.
Consumption by ImpFCS/AbsFCS/InsFCS/FLS/math/rates in e/h: fuel volume used in engine
hours. It can be detected by a fuel sensor (like impulse/absolute/instant fuel consumption sensor, fuel
level sensor) or calculated by math or rates. Details...
Avg consumption by ImpFCS/AbsFCS/InsFCS/FLS/math/rates in e/h in trips: average fuel
consumption in engine hours detected by one of the methods mentioned above.
Events
Events count: the number of events registered.
Executed commands
Executed commands: the number of commands sent to unit.
Fuel fillings
Total filled: the volume of fuel filled during the reporting interval.
Total registered: registered fuel volume regardless binding to sensors and calculation methods.
302
Difference: the difference between registered and detected fillings.
Total fillings: the number of fuel fillings detected within the reporting period.
Fuel thefts
Total fuel stolen: the total volume of stolen fuel.
Total thefts: the number of thefts detected within the reporting period.
Images
Images: the number of images received from unit. And if there are any, the resulting report will
contain a section with all those images. Supported format is JPEG.
Maintenance
Total maintenance duration: time spent for servicing.
Total maintenance cost: total cost of all maintenance works.
Services count: the number of services performed.
Non-visited geofences
Non-visited geofences count: the number of geofences which were not visited.
Parkings
Parking time: total duration of parkings for the reporting period. Parkings are detected by Trip
Detector. IF it is not set properly, there may be no parkings found.
Parkings count: the number of parkings for the reporting period.
Rides
Rides count: the number of accomplished rides.
SMS messages
SMS messages: the number of SMS messages received from unit.
Stops
Stops count: the number of stops for the reporting period.
Trips
Move time: total duration of all trips.
Engine hours: engine hours worked.
Mileage in trips: total distance travelled in all trips.
Mileage (adjusted): the same distance multiplied by mileage coefficient (a setting in unit properties).
Urban mileage in trips: distance travelled at speed which is considered as speed in populated areas.
Suburban mileage in trips: distance travelled at speed which is considered as speed outside
populated areas. Urban speed limit is a setting in unit properties which defines if unit is moving in
urban area or outside it.
Average speed in trips: average speed in trips (total mileage divided by move time).
Maximum speed in trips: the maximum speed registered during the trips.
Trips count: the number of trips.
Consumption by ImpFCS/AbsFCS/InsFCS/FLS/math/rates in trips: fuel consumed in trips. It can
be detected by a fuel sensor (like impulse/absolute/instant fuel consumption sensor, fuel level sensor)
or calculated by math or rates. Details...
303
Rates deviation by ImpFCS/AbsFCS/InsFCS/FLS in trips: the difference between fuel consumption
detected by a sensors and fuel consumption rates.
Avg consumption by ImpFCS/AbsFCS/InsFCS/FLS/math/rates in trips: average fuel consumption
in trips detected by one of the methods mentioned above.
Avg mileage per unit of fuel by ImpFCS/AbsFCS/InsFCS/FLS/math/rates in trips: average fuel
consumption presented as 'kilometers per liter' or as 'miles per gallon' .
Unfinished rides
Unfinished rides count: the number of unfinished rides.
How mileage and engine hours are calculated is adjusted in unit properties on the General tab.
Utilization cost
Total utilization cost: total cost of all registered service works and fuel fillings.
Count of services and fillings: total number of all registered service works and fuel fillings.
Violations
Violations count: the number of violations registered within the reporting period.
Visited streets
Streets count: the number of found visits of streets.
304
Other Reports
If you have corresponding modules activated, you can build reports on routes, drivers, trailers, and unit groups. These
report types are defined when creating a template.
305
Reports on Unit Groups Table of Contents
Reports on Unit Groups
Tables for Unit Groups
Attention! Unit Latest Data
Data from several units can be gathered in one report if these units from a unit group. To get a report on several units,
select the Unit group type for the report template.
The functionality of these reports is very similar to reports on separate units but has a number of peculiarities and
restrictions.
Any tables;
Graphical elements on map: POI, geofences, any markers, unit last location icons, tracks and all messages
on map;
Some graphs in Statistics: 'Report', 'Group', 'Interval beginning', 'Interval end', 'Report execution time';
Advanced options: U.S. measurements, address format, etc.
All tables available for units are available for unit groups, too. Besides, the table Unit latest data is available for unit
groups only.
Charts;
Most of statistics excluding those mentioned above.
When configuring tables for unit groups, take into account some peculiarities. As the first column of the table, you will
see the list of all units included into the selected group (in the alphabetical order). Other columns are defined in the
template in the same way as for usual tables. In the columns such as 'Count' there will be the number of events
registered in the reporting period for the given unit.
Below is an example of a table on parkings for a group of six units (detalization is off) The table provides us with the
following data: beginning of the first parking, end of the last parking, summarized duration of all parkings for the
reported period. One row is dedicated to one unit.
If the option of detalization is applied (either full or partial), the second level appears. That means you can expand the
contents of a basic row and see a detailed list of events for the given unit. The number of hidden rows will coincide
with the number in the 'Count' column.
306
In addition to detalization, you can apply the grouping by days/weeks/months. In this case, it matters which level of
detalization you choose – partial or full. Partial detalization assumes only one enclosed level. So, the first level will
contain the list of units with general information for the whole reported period, and the second level will give general
information about events for each day, week or month where those events were detected.
Full detalization (applied together with grouping by days/weeks/months) allows to reach all enclosed rows. In our
example, weekly information can be expanded, and each event of the type shown.
The grouping does not affect the report in any way if the detalization is off.
To expand enclosed rows, click on the plus-shaped button at the beginning of each row of higher level. It is possible to
open all rows of 2nd or 3rd level if you click on the corresponding number in the header of the table. To hide all
enclosed rows back, click on the button '1'.
If there is no data for the given unit, in other cells there will be '—–'. In some cases that can be not convenient, then
you can disable such uninformative rows. To do this, enable the option Skip empty rows in the report template.
307
coincides with the previous column).
Location: address or coordinates of the last location.
Speed: speed according to the last message.
Mileage: mileage counter value.
Engine hours: engine hours counter value.
Traffic: GPRS traffic counter value.
Driver: name of driver (if any detected).
Trailer: name of trailer (if any detected).
Notes: an empty column for your custom comments.
By default, the latest information refers to report execution time. However, it can be bound to the end of reporting
interval. To do this, enable the Consider report interval checkbox in the template.
Apart from that, filtration by geofences/units can be used for this report. This allows to quickly find units which are
situated in a certain place or close to other units.
Last location can be visualized on the map by units icons – activate the option Unit last location in the report
template.
308
Reports on Users Table of Contents
Reports on Users
Tables Applied to Users
Two tables about users can be generated (Logins and Custom fields) and two charts Charts Applied to Users
This kind of table shows user activity: logins to different services. The table can contain the following columns (they
are adjusted after you press the 'Add Table' button):
The same params as for all tables can be applied to user logins table: grouping, detalization, row numbering, total row,
and time limitations. In the example below you can see user logins table with grouping by days, detalization,
numbering, and total row.
The table Custom fields represents the list of custom fields entered in the corresponding tab of user properties dialog.
This report has the same characteristics as the same kind of report for units and groups.
In the Statistics the following fields are available: report name, user name, reporting interval (beginning/end), report
execution time, total time spent in the system, and logins count.
Two kinds of charts can be attached to the report on user logins: Logins/Hours and Logins/Days of week. To get these
charts, in report template push the button Add Chart and choose the type in the dropdown list.
309
Logins/Hours chart shows how user's activity in different hours of the day:
Logins/Days of week chart shows how often user logged to the system in different days of the week:
310
Reports on Drivers and Driver Groups Table of Contents
Reports on Drivers and Driver
Groups
Three kinds of tables can be applied to drivers: SMS Messages
Bindings
Custom fields.
To generate reports on drivers or driver groups, the proper access to the resource where those drivers or groups
belong is required – 'Query reports or messages' flag.
SMS Messages
This report shows chat of a dispatcher with a driver via SMS messages. A dispatcher (operator) can send messages to
a driver from Wialon interface through a special SMS window. A driver sends messages from his mobile phone. This
mobile phone number must be indicated in driver's properties.
Bindings
A table of Bindings can be built for each driver. This report shows which units the selected driver was working on, for
how long, how much fuel was consumed, distance traveled etc.
311
Status: unit status registered during the interval (if there are several, the first one is displayed).
Violations: the number of violations occured.
Count: the number of bindings found.
Consumed by ImpFCS/AbsFCS/InsFCS/FLS/math/rates: the volume of consumed fuel detected by a
fuel sensor (like impulse/absolute/instant fuel consumption sensor, fuel level sensor) or calculated by math
or rates.
Avg consumption by ImpFCS/AbsFCS/InsFCS/FLS/math/rates: average fuel consumption in the trip
detected by one of the methods mentioned above.
Initial fuel level: fuel level at the beginning of the working shift.
Final fuel level: fuel level at the end of the working shift.
Notes: an empty column for your custom comments.
When creating/editing a report template, you can also choose units to be under control of this report. Their list is on the
right of the columns list. If no units are selected, it means that all units will be considered.
The report is designed in such a way that the first column is the list of units on which the driver was working. It is
recommended to apply the detalization option to this table to get a possibility to expand any unit and see more
detailed information about all working shifts on it.
Custom Fields
The table Custom fields represents the list of custom fields entered in the corresponding tab of driver's properties.
Possible columns:
Additional Possibilities
You can apply the option of grouping (by days/weeks/months) to the tables 'Bindings' and 'SMS messages'. However,
those tables generated for single drivers can have only one enclosed level of rows. On the first level you see the list of
units, on the second – summarized information for certain day, week, or month. And this second level cannot be
expanded.
In addition, you can query statistics for such reports, which can include the following fields: report template name,
driver name, report interval (beginning and end), and report generation time.
312
groups you can build complicated multi-level tables.
In the Bindings table for driver groups, the first level contains drivers themselves, the second level contains units (if
the grouping is off) or days/weeks/months (if the grouping is on and detalization is partial). The forth level appears if
the grouping is on and the detalization is full.
Note.
The Total row cannot be used in reports on driver and trailer groups.
313
Reports on Trailers and Trailer Groups
To generate reports on trailers or trailer groups, the proper access to the resource where those trailers or groups
belong is required – 'Query reports or messages' flag.
1. Bindings
This table shows working intervals if the chosen trailer if it was bound to units. It comes
along with information on fuel consumed, distance traveled etc. Parameters and possible
columns for this table are the same as in the similar table for drivers (with the exception
that the column 'Violations' is absent). The Bindings table can be also generated for trailer groups – it gives
possibility to build complicated four-level reports (trailers –> units –> dates/weeks/months –> single
bindings). More...
2. Custom fields
This table represents the list of custom fields created in trailer properties. It is not available for trailer
groups.
314
Data in Reports Table of Contents
Data in Reports
Time in Reports
Time when an event happened/begun/finished is given in reports in the form of date and time:
YYYY:MM:DD HH:MM:SS.
Duration of a state is given in the format HH:MM:SS. If a duration is bigger than a day, first the number of days is
indicated, and then HH:MM:SS. It can look like that: '5 days 12:34:56' which means '5 days, 12 hours, 34 minutes, 56
seconds'. However, duration larger than 24 hours can be not combined into days. So, there will be “132:34:56” instead
of “5 days 12:34:56”. To disable days and leave only hours, go to report template properties dialog and set the
Duration format option to Hours and minutes. This parameter affects not only time formatting in the cells but in the
Total row as well.
In some rare cases the duration of a state is '0 seconds'. It can happen if the state is detected by only one message.
For example, a speeding was detected in one message, and in previous and next messages there is no speeding.
The duration of a speeding is considered a period of time from the first message with speeding to the last messages
with speeding in sequence. So, if having only one message with speeding, the duration turns to be zero.
If grouping by days is used, the column called 'Date' is added. It gives the date in the format
YYYY:MM:DD. If the columns 'Beginning' and 'End' are selected, they will contain only time (HH:MM:SS).
However, if a state began in one day and finished in another, in the 'End' column date and time will be
given.
If grouping by weeks is used, the column called 'Week' is added. The month and the number of week of
year are indicated there. The first week of year is considered the first full week. If a week begins in one
month and ends in another, it refers to the month where it begins.
If grouping by months is used, the column called 'Month' is added.
Attention!
To receive reliable data for time/duration, it is important to correctly indicate the time zone, the first option in User
Settings.
Mileage
Mileage can appear in reports on trips, geofences, rides, speedings, digital sensors, etc., as well as in statistics and
processed fuel level chart.
Mileage is calculated according to settings of mileage counter on the General tab in unit properties. Besides, mileage
can depend also on Trip Detector because the intervals of movement and parkings are detected by it.
Mileage can be ordinary or adjusted. The adjusted mileage may be useful to coordinate mileage detected by the
program and mileage detected by vehicle itself. Correction coefficient is set in unit properties on the Advanced tab.
In Statistics and in various tables, you can find many possibilities for mileage:
Mileage in all messages – the full mileage without any filtration by trip detector. It is always the longest
mileage because it includes also all adjustment of data.
Mileage in trips – total mileage of all movement intervals found according to trip detector.
Mileage (adjusted) – mileage in trips multiplied by correction coefficient.
Mileage in engine hours – mileage in intervals of engine hours.
Urban mileage – distance travelled at speed which is considered as speed in populated areas.
Suburban mileage – distance travelled at speed which is considered as speed outside populated areas.
Urban speed limit is a setting in unit properties which defines if unit is moving in urban area or outside it.
Initial mileage – mileage counter value at the beginning of the interval (trip, street visit, sensor operation,
315
etc.).
Final mileage – mileage counter value at the end of the interval.
Mileage counter – absolute mileage (mileage counter value at the moment of report generation).
In many tabular reports, mileage can be displayed. It can be calculated either by all messages or by messages in trips.
Choice of the method of calculation is defined by the flag 'Mileage from trips only' in additional settings of the Report
Template dialog.
Mileage if less than 20 (miles or kilometers) is displayed with accuracy to hundredths (other decimal places are simply
cut). Measurement units for speed and mileage (kilometers and kilometers per hour or miles and miles per hour) are
selected in additional settings of the Report Template dialog. There you can also set the option Mileage/fuel/counters
with accuracy to two decimal places to see mileage always with hundredths.
Speed
Average and maximum speed values can be included in the same reports as mileage: trips, geofences, rides,
speedings, digital sensors. Note that the average speed directly depends on mileage because it is calculated by
dividing mileage by duration (for example, distance travelled with a sensor on divided by duration of on state. That is
why a situation can happen when the average speed is zero and maximum speed is a positive number. It can happen
(1) if state duration is zero (see explanation above); (2) if mileage is zero (unit was parked or the mileage counter is
set incorrectly); (3) if the mileage is insignificant, for example, '0,01', and the result of division is smaller than one.
Note also that mileage can be calculated either by all messages or by trips only (option in template's advanced
settings), and this will obviously affect resulting values of average speed.
Maximum speed has nothing to do with mileage and any counters. To calculate maximum speed within an interval, all
messages which get to this interval are analyzed and the largest speed value is selected and displayed in the
corresponding cell.
Fuel in Reports
Many reports can provide information about fuel: fuel level (initial/final), the volume of filled/stolen/registered/consumed
fuel, average consumption, etc.
Abbreviations used:
To receive the most accurate information about fuel, you need to:
However, even if you do not have special fuel sensors, you can control fuel in the following ways:
To calculate fuel consumption by rates or math, you do not need any sensors to be installed. To use these method, it
is enough to enter necessary values in the Fuel Consumption tab of unit properties dialog.
In report template several methods of calculating fuel can be selected simultaneously. In this case a separate column
316
will be generated for each method. Above all, if there are several sensors of the same type (or corresponding to the
given mask) and they are not summed (the option 'Merge same name sensors' is off), then a separate column will be
generated for each of these sensors. If you want a certain sensor to be used for fuel calculations, enter its name mask
in the reports templates in the filter called “Sensor masks”.
If in the report template you select columns which do not match with unit configuration, in the resulting report there will
zeros in those cells.
In statistics, there is no possibility to show a separate row for each sensor. Even if they are not merged, in the rows
like 'Avg consumption …', 'Consumed by …', 'Rates deviation …' etc. you can get only one row for each type of fuel
sensor (FLS/ImpFCS/AbsFCS/InsFCS). That is why consumed fuel ('Consumed by …') in statistics is the sum of
sensors of a type, and average consumption ('Avg consumption …') is the arithmetic mean between those sensors.
However, calculation of deviation from rates ('Rates deviation …') depends on sensors adjustments. If a unit has two
sensors of the same type with different names (or with the same name and the merging of sensors is disabled), rates
deviation is calculated for each sensor separately but for the statistics (as it can be only one row) the sum of those
deviations is shown. Thus, the formula is:
If there are two fuel sensors with the same names and the merging is enabled, the formula is:
Fuel consumption detected by FLS as well as average consumption according to FLS can be calculated including fuel
thefts or excluding them. This is adjusted in additional options of a report template – the checkbox Exclude thefts from
fuel consumption. Depending on this option, you can get summarized information about fuel consumption or
information about fuel consumed exactly by a vehicle.
Fuel level is given in integer numbers. The volume of fuel consumed/registered/stolen as well as average consumption
are given correct to the nearest hundredth (other decimal places are simply cut). However, if the value is over 50
(liters/gallons), it is shown as integer. However, if you consider it is necessary, you can see fuel always with accuracy
to hundredths. For this, check the option Mileage/fuel/counters with accuracy to two decimal places in report template.
If the U.S. measurements are selected, fuel is measured in gallons, and average consumption in mpg (miles per
gallon) unlike the European system where average consumption is measures as lt/100km (liters per 100 kilometers).
All fuel data is processed before getting to reports. The data is processed according to filtration level set on the Fuel
Consumption tab (the option Filter fuel level sensors values).
317
Fuel
All the sensor workflow can be divided into sequential steps (there are important options, terms in step subsections):
1. Getting data
Process: Sensor calibration (being updated …).
2. Data preparation
Option: Ignore the messages after the start of motion;
Options: Merge sensors;
Term difference: "Mileage-based calculation" VS "Time-based calculation".
3. Filtration
Option: Filter fuel level sensors values;
Option: Filtration level.
4. Fillings Detection
Option: Minimum fuel filling volume;
Option: Detect fuel filling only while stopped;
Option: Ignore filtration when calculating filling volume;
Special Case: How a filling is processed?
5. Thefts detection
Option: Minimum fuel theft volume;
Option: Idling;
Option: Detect fuel theft in motion;
Option: Ignore filtration when calculating theft volume.
6. Consumption calculation
Option: Replace invalid values with math consumption;
Option: Exclude thefts from fuel consumption;
Special Case: Filling/theft is sliced with one of interval frontiers.
318
Data preparation Table of Contents
Data preparation
Ignore the messages after the
Note: Ellipsis (…) substitutes “Unit properties → Fuel consumption” is option paths. start of motion
Merge same name sensors
Mileage-based calculation VS
Time-based calculation
Among important options the next list should be mentioned:
... → "Fuel fillings/thefts detection" block → "Ignore the messages after the start
of motion, sec"
This option allows messages being ignored after motion has started for a period of time in seconds. Messages which
are frontier ones to ignored time period are joined by drawn line.
Here is whole algorithm more precisely:
1. all starts with start motion message, it is used to define the amount of messages being ignored;
2. this message is regarded as left-frontier message;
3. then we add seconds set in the option to this message timestamp to get end moment of ignored time
period;
4. all FLS messages being within this time period are ignored while processing;
5. the first message which comes after ignored period (p.3), is called right-frontier message;
6. Both left- and right-frontier messages are joined by line being drawn (instead taking ignored messages
into account while building graph).
All processed graphs have the option for such correction (except for the Regular graphs, where data is raw).
319
Merge same name sensors
... → "General sensors parameters" block → "Merge same name sensors (fuel level)"
... → "General sensors parameters" block → "Merge same name sensors (fuel
consumption)"
In case of desire to group an amount of sensors into one result please use the next approach: set the same sensor
type (“Unit properties“→ “Sensors” → Choose desired sensor → “Properties”, “Sensor type” field); set the same sensor
name (the same menu, “Name” field);
The table below shows “option ↔ sensor type” matching:
Note: you can group several sensor types (up to all types you got in the list).
Convergence of data (i.e., when sum of interval results equals to whole interval result) is guaranteed when all
mentioned options activated/deactivated:
1. time-based calculation of fillings;
2. time-based calculation of thefts;
3. time-based calculation of fuel consumption.
While “Time-based calculation” (all three options) switched on the x-axis is time:
While “Time-based calculation” switched off (data is calculated as mileage-based) the x-axis is mileage:
320
Filtration Table of Contents
Filtration
Filtration enabling and filtration
Note: Ellipsis (…) substitutes “Unit properties → Fuel consumption” is option paths. level setting
... → "Fuel level sensors" block → "Filter fuel level sensors values";
... → "Fuel level sensors" block → "Filtration level (0..255)".
It is OK to use filtration when wrong messages appeared, i.e., with unreasonably bigger/smaller values. During filtering
median smoothing is used.
ATTENTION!
If value 0 is set in “Filtration level” option, a user must be aware of that filtration is not disabled this way,
but its minimal level is used instead (three messages being filtered, because that is the minimum input
required for median smoothing).
Any number from 1 to 255 being set in “Filtration level” is multiplied by 5. The result number is the amount
of messages to be filtered.
To disable filtration completely please uncheck “Filter fuel level sensors values” option.
321
Fillings Detection Table of Contents
Fillings Detection
Minimum fuel filling volume
ATTENTION! In order to detect fillings the processed data is used (it is done on "Data Detect fuel filling only while
... → "Fuel fillings/thefts detection" block → "Minimum fuel filling volume, liters"
This option helps to quit false fillings, because in motion sensors may send false data rise.
... → "Fuel fillings/thefts detection" block → "Detect fuel filling only while
stopped"
In normal conditions transport vehicles are fueled on stops. This option narrows its search to stops/parkings.
... → "Fuel level sensors" block → "Ignore filtration when calculating filling
volume"
When filtration switched on then some fuel level deviations may occur at the beginning and end of a filling. To avoid it
the system uses unfiltered data when filling volume calculated.
322
Thefts detection Table of Contents
Thefts detection
Minimum fuel theft volume
ATTENTION! In order to detect thefts the processed data is used (it is done on "Data Idling
... → "Fuel fillings/thefts detection" block → "Minimum fuel theft volume, liters"
This option defines applicable fuel level falling minus fuel consumption for motion/idling to call such falling the theft and
detect it.
Idling
The option allows to detect thefts on stops/parkings. System finds difference between fuel volume spent according to
sensors and mathematically calculated one. In case of non-zero difference which is equal to or more than value set in
minimum fuel theft volume option then fuel theft detected.
On default this option is unchecked. In case there is a necessity to control thefts in motion a user may use the option.
But if sharp fuel level drop takes place then false theft may be detected.
... → "Fuel level sensors" block → "Ignore filtration when calculating theft volume"
Similar to fillings, filtration may deviate start and end fuel level values on thefts. To ignore such deviations the system
uses unfiltered data while computing theft volume.
323
Consumption calculation Table of Contents
Consumption calculation
Replace invalid values with
ATTENTION! In order to calculate consumption the processed data is used (it is done on math consumption
Two options and special case are toughly connected with this step:
... → "Fuel level sensors" block → "Replace invalid values with math consumption"
In case of values falseness, they are replaced with math calculation which uses data set in “Consumption math” area.
Algorithm: Let's say Vinit – initial volume for the interval (the way what interval is taken is defined in specified report
template), Vfinal – final volume. Then difference is calculated between them with respect to fillings volume like Vinit –
Vfinal + Vfill. In case of caluclated value is equal to or greater than zero the interval is marked as correct. But if the
result value is negative then consumption is treated as falsy and math consumption takes place (with further whole
interval falsy values replacing).
That option defines whether a theft took part in consumption while computing different indices. Keeping this option
switched on is valuable when ignoring deviations because of detected thefts. Switch it off when discharge is
authorized, as an example, agriculture vehicles are being filled with refueller and the user is to get fuel turnover being
spent during specified period of time.
Special Case: filling/theft is sliced with one of interval frontiers. What is the way
filling/theft being detected?
Let's examine the case on a filling example. Assume we've sliced the filling with the interval initial frontier. As
described in how a filling is processed section a filling timestamp is defined dynamically according to the unique case.
Since we've sliced the filling with interval, the second interval message becomes the initial filling message and it
informs that fuel level has grown compared to the previous value (the first message is the reference used to calculate
the delta (d=Vcurr - Vprev) for the second message, it cannot be calculated for the first message because of the
absence of its previous one).
The filling final message remains the same.
The filling volume declines compared to unsliced filling reference (because of the initial message shifts to the right).
The filling timestamp might hold the position/shift to the right, because it is all about the case whether the message,
which timestamp is regarded as unsliced filling timestamp, is taking into account during calculation the time where the
filling has occurred.
324
Speeding Table of Contents
Speeding
Allowed Speed Messages
If the interval between two speedings (see Speeding table) is less than 60 seconds, then these Come During Timeout Period
speedings will be combined into one (from the beginning of the first to the end of the second
speeding). Any number of speedings can be united this way if timeout rule is met. When a speeding event (single or
combined) finally ends, its duration is considered to be the time from the first speeding message to the last one (but not
to the first allowed speed message).
point 1 – the first message showing unit's speeding –- 60-second timeout to be launched;
point 2 – message inside the timeout showing a speed higher than the limit;
horizontal red line – speed indicated in “Speed limit” parameter.
Look at the Pic.1. The unit moves, then exceeds the speed limit (point 1). From this point the speeding event to be
started, 60-second timeout is on. Receiving allowed speed messages during timeout means that event is still
considered to be speeding, but if speeding messages come during timeout (dot 2), then the last timeout ends and the
new one starts from this message. This could be repeated multiple times if speeding messages come during timeout
period.
point 3 – speeding message. Here it is the case when only allowed speed messages come during
timeout;
point 4 – a speeding is registered to be the first message after timeout;
point 5 – an allowed speed is shown in the first message after timeout;
horizontal red line – speed indicated in “Speed limit” parameter.
On exceeding the speed limit, 60-second timeout is launched (point 3). In this example only the messages with
allowed speed are received during timeout. When timeout is finished, the futher determining whether event is
considered to be speeding or not depends on the speed received in the first message (allowed or unallowed).
Cases:
speeding event is continued: the first message received is speeding message (Pic. 2, point 4) – the event
is continued (timeout launched one more time, see Pic. 1);
325
speeding event is ended: the first message received is allowed speed message (Pic. 3, point 5) – the
event is finished, the last speeding message is considered to be the end of speeding event.
326
POI
POI (point of interest) is a place on the map that has some importance for you and requires a special attention in the
tracking process. Each place can have its image on the map (an icon). In addition, you can add any comments.
In POI tooltip, you can get dynamically updated images from external sources (video from web cameras,
photos of crossroads, weather, etc.).
To open the POI panel, choose a corresponding name in the top panel or click on the necessary item in the main menu
customizer.
Learn more:
Creating POI
POI Management
327
Creating POI Table of Contents
Creating POI
POI Properties
To create POIs, you should have Create, edit, and delete POIs access to at least one
resource.
POIs are created on the POI panel. Press the New button and double-click on the map to locate a new POI. Fill in the
dialog of POI properties (at least, name is required) and press OK.
An alternative way to create POIs is to import them from a file or another resource.
POI Properties
Name
Name is a required parameter for a POI like any other system object. It can be of one or more symbols. Besides, you
can specify font color and size for the caption. It has sense if POI names on map are enabled in User Settings.
Image
Each POI can have its own image. An image can be chosen from the standard icons (Icon Library button) or loaded
from your computer (Upload Image button). Supported formats are PNG, JPG and GIF. All loaded images are
automatically resized by 64×64 pixels to display the POI on the map and on the list. However, in the tooltip for the POI
you can see enlarged image (up to 256х256 px).
Description
When you create a POI, this field is automatically filled with address information for the point. However, you can edit it
and write any custom description. Its length is not limited. You can use html (including iframe) tags in descriptions in
order to format text or get images from other sites. For example, you can embed video from web cameras, get photos
from crossroads, load weather or currency exchange, etc.
Visibility scale
Visibility scale is map zooms at which POI will be displayed or not. For example, if a POI is a city, it has sense to see
it on remote scales, whereas if a POI is a building it is more logical to see it on more detailed scales. Different map
types can have different graduation of map scales. However, all possible values fall into the range from 1 to 19, where
1 is the most detailed scale (small streets and houses are displayed) and 19 is an overview (the whole world).
Radius
Default radius for a POI is 100 (whether meters or feet, depends on resource settings). Radius can be used for
address detection in reports as well as to display the POI on the map. Tick the Show circle checkbox and choose the
color if you want the POI to be displayed on the map as a circle with the specified radius.
328
When finished, press OK. The newly create POI will appear at the bottom of the list. However, when the list is
reloaded, the POI will take its place according to the alphabet. At that, the flag to display the POI on the map will be
enabled.
Attention!
One resource cannot contain more than 31744 POIs.
329
POI Management
POI are sorted by name. To quickly find a certain place, use the dynamic filter above the list. Begin to input the name
of a place and see the results. To move to a certain POI on the map, simply click on its name on the list.
In the first column of the table, tick those POIs that should be seen on the map. Put the flag at the header of the list to
select/unselect all POIs. POIs can be presented on the map by their names (default color is orange), attached images
and circles as well as any combination of these three items. Overlapping POIs can be grouped under one icon.
Parameters of POI visualization are adjusted both in POI properties and in User Settings.
Note, that in order POIs to be displayed on the map you should check if the corresponding layer icon in the main
menu is active.
If you have too many POIs to show on the map, it may slow down browser performance. In this case, enable the option
of rendering POIs on server (see User Settings => Maps).
Place a mouse cursor over a place name on the list or on the map to see related information in a tooltip: name,
description, enlarged image, and a resource where the POI belongs (if there is access to several resources). If POIs
are rendered on the server, only name and description can be displayed in the tooltip. If the description contains links
to any external content, it is shown in the tooltip. For example, a tooltip of a POI can look like this:
All POIs regardless resource they belong to are displayed on the list. However, you can easily filter them by this
parameter. To do this, in the dropdown list choose account name to display only POI belonging to this resource. This
330
filter is not displayed if the current user has access only to one resource. To find a POI by name, use the dynamic filter.
Note.
If you have not enough rights for a resource (you have View POIs but do not have Create, edit, and delete POIs), you
cannot move, edit or delete its POIs. That is why the corresponding buttons are dimmed.
331
Geofences
Geofence, or geographical zone, is some area on the map that is important for your tracking purposes. Geofences can
be used to control unit activity in these areas or, on the contrary, outside them.
A geofence can have a shape of a line (for example, an avenue or any road), polygon (a city or park or plant) or circle
with any radius.
To open the Geofences panel, choose a corresponding name in the top panel or click on the necessary item in the
main menu customizer.
After entering the Geofences panel, you can view, create, edit, and delete geofences.
332
Creating a Geofence Table of Contents
Creating a Geofence
1. Map Geofence
Here are three steps to create a geofence. 2. Set Geofence Properties
3. Save Geofence
1. Map Geofence
After you have pressed the New button, a help window appears to provide you with the instructions about drawing
geofences. Choose a geofence type on the left: line, polygon or circle.
Then map a geofence. Here are the basic rules for mapping a geofence:
Double-click on any place of the map to put the first point. Then add more points using the same
method. Put the points as close or as far from each other as you want.
To insert a point between two other points, double-click on a segment between them.
To move a point to another place, click on it and holding the left mouse button drag to another place on
the map. Then release the mouse button.
To delete a point, just double-click on it. Note that points cannot be deleted if there are only two points –
for lines, or three – for polygons.
Hint.
A quick way to map a geofence is by using the Routing tool (create lines) or Address tool (create circles).
333
address source option is activated in the report template.
Ride beginning/end: these parameters are important for reports on rides. The same geofence can be
simultaneously the end of one ride and the beginning of another, but cannot be the beginning and the
end of one ride.
Color: choose a color using the palette or enter a color RGB code. This color will be used to render a
geofence on the map and to display this geofence in a unit's tooltip and in extended unit information (if a
unit is located in this geofence).
3. Save Geofence
When finished, press Save. In case of a mistake, press Clear and try again. To close the create mode without
saving results, press Cancel. Created geofence appears at the end of the list and on the map.
Note/.
Geofences can be saved to a file and easily imported and exported from one resource to another.
334
Geofences Management
In the work area there is a list of all created geofences. Put check marks in the left column to choose geofences to be
displayed on the map. Unselect this box to remove geofences from the map. Geofences can be displayed with captions
or not (depending User Settings). If you have ticked too many geofences or they are very big, it can slow down browser
performance. In this case, the option to render geofences on the server can help (see User Settings => Maps).
Geofences are given in the alphabetical order. When you create a new geofence, it appears at the end of the list with
map checkbox enabled. However, when the list is reloaded, new geofences take their places according to their names.
Placing a cursor over a geofence name, you will get information about it in the popup tooltip: geofence type, its
belonging to a resource (if you have access to more than one resource), description, as well as the list of units located
inside the geofence. Depending on geofence type, there will be also area, perimeter, length, and/or radius.
By some property:
All geofences;
Geofences used as address;
Ride beginning;
Ride end;
Ride beginning and end;
Polygons;
Lines;
Circles.
By resource:
Here is a list of all resources available for the current user (if there are more than one). Click on any of
them to display geofences belonging only to this particular resource.
To quickly find a needed geofence, you can use the dynamic filter above the list. Type a geofence name or a part of
the name and observe the search results.
Shows how many units are there inside the geofence at the moment. These units are listed in the tooltip (this data
refreshes once in a minute). If there are question signs (?) in this column, it means the option is disabled. To
activate it, go to User Settings and check the item Presence in geofences.
The button to edit geofence properties (size, shape, name, color, position, etc.).
The button to view a geofence properties (editing is disabled).
The button to copy a geofence. You can edit a geofence and save it under another name.
The button to delete a geofence. To delete several geofences at once, check them in the first column of the table
and press the delete button at the top of the list. If the button is dimmed, it means you have not enough access
rights to the resource which the geofence belongs to.
The button in the header of the table to delete selected geofences.
335
Usage Table of Contents
Usage
While Tracking Online
Geofences can be displayed on the map and mark some area of interest and simplify visual reception of the map. If
a geofence is displayed on the map and the mouse cursor is placed over it, you can press <ctrl> to see its tooltip
(name, type, list of units inside, etc.).
Note, that in order Geofences to be displayed on the map you should check if the corresponding layer icon in the
main menu is active.
If a unit is situated in a geofence, this fact can be shown in unit's tooltip and in extended unit information. For this,
check the option Presence in geofences in User Settings. Besides, a column with geofences where units are located
can be displayed in the Monitoring panel (instead of ordinary addresses).
In Notifications
You can be notified by e-mail, SMS, online or by other means when your unit leaves a geofence or enters in a
geofence. It is possible also to set speed limitations and sensor range for unit during its presence in a geofence.
Besides, on an entrance to a geofence or an exit from it, an action can be performed automatically: send a message
to driver, block the engine, change users' access to this unit, and many others. See Notifications.
In Reports
Geofences can be used in reports as addresses (in the Location column), if Geofences as address source is
checked.
Geofences: visits to geofences (all entries and exits to/from selected geofence(s) are given together
with visit duration, distance travelled within the geofence, average and maximum speed, etc.).
Non-visited Geofences: geofences which were ignored (non-visited) during a period of time or on certain
days.
Rides and Unfinished Rides: rides from one geofence to another (convenient to control how a cargo is
transported in several trips).
336
Routes
Attention!
This module is licensed separately.
Wialon tracking system provides an opportunity to track a unit being on route and supposed to visit definite check
points in predefined or arbitrary order, at definite time or without any strict schedule.
To understand how routes work, three notions are important: route, schedule, and round.
Route is a set of check points, each characterized by its location on map. The number of check points in a route is
unlimited.
Schedule is a timetable which holds time of visit for each point. One route can have many schedules attached to it.
Note, that in order routes to be displayed on the map you should check if the corresponding layer icon in the main
menu is active.
When everything is configured properly, you can analyze unit performance on route by various means:
To open the Routes panel, choose a corresponding name in the top panel or click on the necessary item in the main
menu customizer. Here you can configure routes and observe the progress of active rounds.
337
Creating a Route Table of Contents
Creating a Route
Adding Check Points
To create a new route, press the New Route button. Optimization
Input a name for route (at least four characters), give description (optional), and choose color which will be used to
display the route on the map and in the timeline.
A route consists of check points that are supposed to be visited. Check points can be added by various means: directly
from the map, from POIs or geofences, and as moving units.
Click on the corresponding icon to add check points using one of the four methods:
1. From map/address.
Either enter address or simply double-click on the map to indicate a place for a check point. The usage of
the Address tool was described above. When necessary point is found, add it to the route by clicking Add
as check point. Before adding, edit point name (the Address field) if necessary, because it will be
impossible later.
2. From geofences.
If you click on this icon, the list of geofences will be displayed. To the left of a geofence name, you can
see its type (circle, line, polygon). Click on geofences to add them as check points. To quickly find a
needed one, use the dynamic filter on the top. On the right there is a button to move to a geofence on the
map, however, it will be visible only if this geofence is marked to be displayed on the map in the
Geofences panel (the similar is with POIs and units). If you have more than 100 geofences, they will be
divided into pages, and to view them all you will need to use navigation buttons on the bottom of the list.
3. From POIs.
In a similar manner, you can add POIs for the route.
338
4. From units.
A check point may have no fixed coordinates, that is to be a moving unit. In this case, to visit this point will
mean to approach within indicated radius. To add a unit as a check point, click on it in the list.
When points are added, you can edit their radius (except geofences) and place them in desired order, remove points
or add more if necessary. To change points sequence order, just drag points up and down holding them at blue arrow-
shaped icons. Radius for geofences is not specified because their shape and size are taken as they are. And check
points cannot be renamed.
Remember that copies of POIs and geofences are created in the route, so route check points created from them lose
connection with their predecessors completely when the route is created. You can then edit or delete those original
POIs and geofences, and it will not affect the route in any way. Meanwhile, units as check points are different because
their IDs are stored in the route. So, the connection with the unit is always maintained unless the unit is deleted.
When finished, press Save. The route will appear on the list. To see it on the map, click on its name. It is strongly
recommended to estimate the result visually and double check all points before proceeding because afterwards, when
the route has schedules, it is impossible to edit it.
Attention!
When a route has schedules, it becomes impossible to edit its check points (add, delete, set sequence order). If you
need to alter such a route, make a copy of it and make all necessary changes there. Then delete the original route.
However, in this case you will have to configure schedules and rounds for this route again.
Optimization
Whichever method you choose to add check points to a route, you can afterwards apply the function of optimization to
those points. The program will automatically detect the shortest way to visit all the points. The shortest route can be
built considering existing roads, or avoiding highways, or by foot, etc. – these additional parameters depend on map
provider selected. As cartographic sources, Gurtam Maps / WebGIS, Google Maps, Yandex Maps, and Visicom Maps
can be used.
To apply optimization, press the Optimize button. See the route distance before and after optimization below. To
restore the initial route, press Cancel near the button of optimization.
339
Schedule
A schedule is a list of route check points with times of their intended visit. One route can have unlimited number of
schedules. Different schedules can be applied in odd and even days, at weekends and weekdays, in different months,
etc.
To create a schedule for a route, press the Add schedule button against this route and adjust required parameters.
General parameters
Schedule name
You can use automatically generated name for the schedule. It is composed of first point time and last point
time or it can be 'Copy of …' if the schedule is created using the copying method. However, you can give
schedule any desired name if you put the checkbox before its name.
Schedule type
Relative to activation
Scheduled time of point visit will refer to time from round beginning. Such schedule can be used at
anytime.
Relative to day
Scheduled time of point visit will refer to time of day. Such schedule can be used in different days (once in
a day).
Absolute
Scheduled time of point visit includes also a date. Such schedule can be used only once.
340
This parameter is extremely important for route control.
Strict
All check points are supposed to be visited in the sequence order they are places in the route. No skipping
is allowed. It means, while we are waiting for the arrival to the Point #3, any visits to other check points are
ignored if they happen. The route is considered as finished when unit (after visiting all points) enters the
last check point.
Skipping possible
Check points are supposed to be visited in the default order, however, it is possible that unit would visit not
all of them. If after the visit to the Point #2 the unit gets to the Point #4, then the Point #3 is considered as
skipped (even if visited later). The round is estimated as finished when a unit enters the last check point,
and it does not matter how many of other points it has visited.
Arbitrary
Check points can be visited in any order but only when all of them are visited, the routes finishes.
Schedule grid
Here you see the list of all check points contained in the route and times of their visit. Visit time can indicate only arrival
or both arrival and departure. Besides, you can set variation time to give unit some degree of freedom to visit the point
(like plus or minus 5 minutes). Time format here is hh:mm.
Enter arrival time for each check point. To indicate departure time as well, tick this option to activate it. Variation time
can be set automatically. Enter value into the appropriate box and press Apply.
If time is set 00:00, then any visit of the point at any time will be considered as perfectly in accordance with the
schedule (not late, not early).
If a route is going to have arbitrary points order, you can indicate time interval within which each check point should be
visited. It is especially convenient for delivery services and the like. For example, a point should be visited between
18:00 and 20:00. Then write 18:00 as arrival time and 20:00 as departure time. At that, time variations should be zero.
Time limitation
Time limitations can be applied to schedule to restrict its operation to certain time intervals, days of the week, days of
the month or months. For example, you can select only event or odd days or only working hours of weekdays, etc. Note
that this option does not work with Absolute schedule type.
Units
Choose unit(s) to be assigned to this schedule and thus create rounds. Required access is Use unit in retranslators,
jobs, and notifications. If several units are chosen, the first that begins the round will be assigned.
Round name
Here you can set name that will be applied to rounds created on the
basis of this schedule do differentiate it from other rounds. Special
tags can be used to form the name:
When you have configured the first schedule, others can be easily created by copying and shifting. Press the Copy
schedule button against necessary schedule and alter some parameters. Enter shifting time (hh:mm) and press up or
down icon (shift schedule upwards or backwards in time). Besides, you may want to change schedule name.
341
Rounds Table of Contents
Rounds
Manual Round Creation
Round is a route, its schedule and assigned unit put together. Unit performs a route (that is to Automatic Round Creation
say visits route's check points) according predefined schedule. Round List
To create a round manually, press Create manual round button against a needed schedule.
At the top, you can see the name of chosen route and schedule as well as assigned units. Enter round name and
description, decide upon points order, expiration time, and other parameters (see Schedule for details). New
parameter here is Activation time.
This is date and time to start the control. Activation time is especially important for schedules of Relative to activation
type. The round then will be tracked from this time on. Activation time can be omitted – in this case we consider that
the route starts when unit enters the first check point (if points order is Strict) or any check point (in other points
orders).
Automatic creation of rounds is adjusted in schedule properties – set the option Automatically create rounds for this
schedule.
Besides, automatic creation of rounds can be enabled straight from the Routes panel – using the corresponding switch
button before each schedule name.
Another way to create a route automatically is through notifications. You can create a notification with trigger action to
assign a new route after the previous one is finished.
Round List
To see the list of rounds created or planned for a certain schedule of a certain route, press the button .
342
Choose time period (Hour, Today, Yesterday, Week) or set your custom interval. For intervals like 'Today' or
'Yesterday', it is convenient to slightly extend the period by some more hours (+hh:mm) if the working shift ends after
midnight.
You can observe either all rounds or rounds of a certain status: in progress, pending, finished, estimated. When all
parameters have been set, press the Apply button to display rounds you need. Besides, in the header of the table, you
can choose a route to show rounds for, or you can request a list of rounds for all tour routes.
In the table you see the round beginning time, name, state (finished, aborted, estimated, in progress, history), points
order (arbitrary, strict, skipping possible), and unit(s) bound to this round. Finished and aborted (finished forcibly due
to expiration) rounds can be deleted. It means they disappear from the timeline and get the status 'History'. Yet, all
information about them is stored and can be reached through reports.
343
Route Control Table of Contents
Route Control
Online Control
There are several methods of tracking units on routes and you can choose what suits you Notifications about Routes
Online Control
Active rounds are displayed in the timeline which is situated in the right lower part of the screen. Here you see all
rounds which are in the progress at the moment as well as all manually created rounds.
If there are many rounds, you can filter them according to adjusted parameters: by route name, by schedule, round,
unit. A criterion is chosen in the dropdown list, and in the text field on the right you enter name mask of a
route/schedule/round/unit. You can also specify a time interval to show rounds for. To apply adjusted filtration
parameters, press <enter>.
Additionally, you can apply grouping to this list of rounds . Then each row on the list will be dedicated to one
route/schedule/round/unit. The name of such a row will contain the number of items it holds (in brackets).
Timeline scale is adjustable – it can display a period of time equal to a fortnight or just a minute. In some scales, point
names can overlap and become partly hidden. That is why there are several possibilities in displaying captions for
check point:
You can move the timeline right and left by simple dragging. Besides, it can move by itself in such a way to maintain
the current moment in focus – press 'Lick current time' for this . While this button is pressed, the timeline cannot be
moved manually.
On the timeline, a route is represented by a horizontal line of such colour that was assigned to it. Check points are
represented as vertical sections on this line and they are situated in the places where the arrival to a check point is
expected according to the schedule. A check point can be also displayed as a rectangle if not only arrival but
departure time as well are indicated in the schedule. Besides, check points which contain only arrival time can be
expanded to rectangles at the expense of deviation time (if specified). For this, apply the option 'Mark deviation time'
.
If a point has been visited in accordance to schedule, no contour will be applied. If a point has been skipped, it will
obtain a red contour and a red filling regardless appointed route colour.
Apply 'In fact' option to see how a unit really visited the points – time of real visit will be shown above the planned
line.
While a unit is performing a round, you can receive notifications about how it is going. To do this, create a notification
of the Route control type and adjust it properly depending on your needs. You can be notified when a round has
started or finished, if a check point has been skipped, and in some other cases. These notifications can be sent by e-
mail or SMS, shown online in a popup window, stored in unit history as events or violations, etc. See Notifications for
details.
344
Reports on Routes
All events connected with units' performance on routes are stored in the system automatically. This data can be used
to generate the following types of reports:
345
Routes Management
Routes in the panel are listed in the alphabetical order. To quickly find a definite route, use the dynamic filter situated
above the list. Enter route name or its part and observe the results.
In the dropdown list above the list, you can choose how routes are displayed:
To see a route on the map, enable the checkbox before its name. Click on route's name to center the map on this
route.
346
Drivers
Attention!
This module is licensed separately.
In this panel, you can manage the list of drivers who form your personnel. One click of a mouse can assign driver to a
unit, i.e., attach to a vehicle. Then in the reports on this unit, a driver will be indicated. It is especially convenient when
different persons drive a unit. There is also possibility to detect drivers automatically with the help of iButton system.
To open the Drivers panel, choose a corresponding name in the top panel or click on the necessary item in the main
menu customizer. Afterwards, you are able to work with drivers list.
347
Creating a Driver
Push the New button and set required parameters.
Name
Give driver a name that will be visible during the tracking process and in reports.
Code
Enter unique driver code needed to identify the driver if an automatic method of binding will be used. Codes of different
drivers should be different.
Description
Type any comments (optional). It is shown in driver's tooltip.
Phone number
Enter driver's phone number. It will be shown in driver's tooltip and can be used to send SMS messages to the driver
and make calls. Note that units or drivers with the same phone numbers cannot exist in the system. If you attempt to
create a driver with a phone number that is already reserved to another driver or unit, a special alert will be displayed,
and this phone number will not be saved.
Exclusive
If this flag is enabled, this driver can be the only one assigned to a unit. In case you bind this driver to a unit (in real
time) which already has one or more assigned drivers, those drivers are reset automatically. This flag works only for
drivers within a common resource.
Photo
To quickly identify a driver, you can attach their photo or any other image. To do this, press the Browse button and find
and load an image from the disk. Supported formats are PNG, JPG, and GIF.
Custom fields
Create driver's card adding any information as custom fields. They are shown in driver's tooltip and can be summoned
in reports. Custom fields with the same name cannot coexist within one particular driver.
At the end press OK. The new driver will appear on the list.
Hint.
Like any other resource contents, drivers can be imported and exported through files or directly from one resource to
348
another. However, that is not true for driver groups.
349
Managing Driver List
Drivers are listed in the alphabetical order. To quickly find a certain driver, use the dynamic filter above the list. There
are also filters to display drivers belonging to a certain resource or group or display drivers according to their status
(loose/bound). Those filters are presented in the form of dropdown menus above the list.
To display a driver on the map, tick the checkbox on their left. As drivers do not have their own coordinates, they
borrow their location from units to which they are assigned. Click on driver's name on the list to center the map on their
position. An assigned driver is represented by a small icon at the bottom right corner of unit's icon. If a driver is not
attached to any unit at the moment, their last known position is shown (with a bigger icon). If there is no data about
driver's location (for example, if they have never been bound to any unit), such a driver is not shown on the map.
Note, that in order drivers to be displayed on the map you should check if the corresponding layer icon in the main
menu is active.
In the tooltip of each driver, you can see their name, phone number, enlarged photo, resource (if there are several),
description, and custom fields (if any were set). Unit that is driven by this driver is also indicated if the driver is bound
to any. If you have Skype on your computer, the phone number is highlighted, and you can make a call if clicking on
it.
If a driver is bound to a unit, unit icon is displayed on the right of trailer's name. If you place the cursor over this icon,
the unit's tooltip is displayed (the same as in the Monitoring panel).
350
Driver's Assignment Table of Contents
Driver's Assignment
Manual Binding
Several drivers can be assigned to one unit. To assign drivers to units, you need to have Automatic Binding
access flag 'Create, edit, and delete drivers' on the resource where those drivers belong. Delete Bindings
Simultaneous Bindings
There are two ways to bind a driver to a unit: manual and automatic.
Manual Binding
The manual assignment can be performed in the Drivers panel. Use the corresponding switch button Bind / Unbind
to attach and detach drivers to/from units. The button is disabled if your access is not sufficient.
Press the button Bind to unit and choose one of two options: Bind to unit or Register working shift. The first option
is used if the assignment must be registered right in the moment. The second option is used to fix driver's work post
factum. Select an option and press Next.
Choose a unit to bind a driver to. This list contains only units from the work list of the monitoring panel.
If you register a working shift, there will be one more page where you indicate shift beginning and shift end (or one of
them). For example, you can indicate just the beginning of the shift, and the end can be detected automatically when
the unit arrives to garage (as a geofence) – to do this, create a notification of Geofence type with method of action
Reset driver.
The button Unbind from unit is used to remove driver from unit manually (the first option) or register a working
shift in the same way as it was described above.
Automatic Binding
To detect a driver automatically the corresponding equipment has to be installed. In authorized personnel
control system iButtons with i-wire bus inside are widely used. When getting into the vehicle, the driver
applies the electronic key to be identified by the system.
To use the automatic method of binding, some adjustments should be done in the system beforehand.
351
1. A special sensors of Driver binding type should be created in the properties of each unit intended for auto-binding. A
parameter for this sensor can be avl_driver or some other depending on your equipment and its configuration. One or
more driver sensors can be created on the basis of different parameters. If more than one driver binding sensor exist
within a unit, the option Validate unbinding can be useful. If the option is activated, a driver bound to a unit
automatically can be unbound from this unit only if zero value comes from the same parameter that was used to bind
the driver. Otherwise, driver reset coming from any parameter will lead to the reset of all drivers bound to this unit.
2. Drivers-units association list should be created. Press the Units button in the Drivers panel and create lists of
automatically attachable units for each resource of drivers.
352
Thus, a driver will be automatically bound to a unit with the help of iButton in case that (1) this unit has a special
sensor in its properties and (2) this unit is indicated in the list of auto-attachable units applied to the resource where
the driver belongs.
Delete Bindings
Incorrect registrations of drivers can affect reports and their informational efficiency. That is why sometimes you may
need to delete such (un)bindings from the database. In the dialog, choose the last option – Delete bindings – and
press Next. Specify time interval and press Show to display all bindings and unbindings of the driver on the interval.
Check invalid messages and press OK to delete them.
Note!
Like with units, the last message from the driver (whether assign or reset) cannot be deleted.
Simultaneous Bindings
A driver can be bound simultaneously only to one unit. If somehow (for example, through registration of shifts) you are
trying to bind a driver to another unit, later assignment cuts off the previous one.
However, several drivers can be assigned to one unit at once. It is reasonable with long-distance truck drivers and
truckers.
If you want to avoid situation when a unit may have several drivers assigned to it, use the flag Exclusive in drivers'
properties. If a driver with such a flag is bound to a unit, other previously assigned drivers are reset automatically.
Note the following restrictions:
353
Groups of Drivers
Groups can be created from any available drivers. Driver groups are used to filter the list of drivers as well as to query
reports for a group.
To create a new group of drivers, press the button . Enter name and description and choose drivers to fill the group.
Press OK.
Only drivers who belong to the same resource as the group itself can compose the group.
Created groups are displayed on the dropdown list. Choose a group in the list and the drivers belonging to it will be
displayed below. Besides, you can choose to display all drivers outside groups. On the right of the selector, you will find
buttons to edit, copy, and delete a selected group as well as create a new one.
354
Usage Table of Contents
Usage
While Tracking Online
The name of the driver is displayed (if available) in unit's tooltip and in extended unit information. To activate this
option, check Driver in User Settings. The photo and phone number is also displayed if available.
Besides, it is possible to have a special column in the Monitoring panel to display drivers. For this, it is required to
activate Show drivers column in the Monitoring panel customizer.
Attention!
When a new driver is assigned, information about it in tooltip is refreshed within a minute (not instantly).
In Notifications
Drivers appear in notifications. You can configure a notification to get informed when a driver is assigned to a unit or
unbound from it. Using notifications, you can also unbind driver automatically, for example, when entering the depot.
In Reports
The drivers can be also mentioned in reports if the appropriate column is chosen in report template. This is available
for the following tables: Trips, Engine hours, Rides, Unfinished rides, Fuel fillings, Fuel thefts, Speedings, and some
others. To see drivers in a resulting report, choose the appropriate column in the report template.
In different kinds of reports, drivers can be used as a criteria of intervals filtration, meaning that you can get trips,
parkings, etc. for certain driver (or without any) if you set his name mask in the report template.
Besides, if you have Other Reports module, you can generate a report totally dedicated to working shifts of a certain
driver or even a group of drivers. More...
355
Trailers
Attention!
This module is licensed separately.
Trailers refer to any kind of motor-drawn implements attached to the main vehicle ('unit') and not having their own
trackers or controllers. They are very similar to drivers in functionality and implementation.
To open the Trailers panel, choose a corresponding name in the top panel or click on the necessary item in the main
menu customizer.
356
Creating a Trailer
Go to the Trailers panel and press the New button. In the dialog, enter a name, identification code (for automatic
binding), description and custom fields (two last will be shown in trailer's tooltip). You can upload an image for the
trailer which will be used to show the trailer on the list and on the map. Images with square aspect ratio are
recommended. Properties of trailers are the same as those of drivers.
Hint.
Like any other resource contents, trailers can be imported and exported through files or directly from one resource to
another. However, that is not true for trailer groups.
357
Managing Trailer List
Trailers are listed in the alphabetical order. To quickly find a certain
trailer, use the dynamic filter above the list. There are also filters to
display trailers belonging to a certain resource or group, or display
trailers according to their status (loose/bound). Those filters are
presented in the form of dropdown menus above the list.
If a trailer is bound to a unit, unit icon is displayed on the right of trailer's name. If you place the cursor over this icon,
the unit's tooltip is displayed (the same as in the Monitoring panel).
358
Binding and Unbinding Trailers Table of Contents
Binding and Unbinding Trailers
Manual Binding
Like with drivers, trailers can be bound to units either manually or automatically. To assign Automatic Binding
trailers to units, you need to have access flag 'Create, edit, and delete trailers' on the resource Delete Bindings
where those trailers belong. The conception of simultaneous bindings of trailers to units is the
same as for drivers.
Manual Binding
Manual binding/unbinding can be performed in the Trailers panel. A special switch button is located against each
trailer — or correspondingly. The button is disabled if there is not enough access.
After pressing the binding button, choose one of two options: Bind to unit or Register working interval. The first option
is used if the assignment must be registered right at the current moment. The second option is used to register trailer's
work interval post factum. Select an option and press Next.
On the next page, select a unit. This list of units contains only units from the work list of the Monitoring panel. If the
working interval option was chosen, you should additionally indicate date and time of work beginning and end.
Using the unbinding button, you can either detach a trailer from unit or, again, register a working interval. Besides,
unbinding can be done automatically via special notification action (e.g., when unit arrives at the garage).
Automatic Binding
Automatic method of binding trailers to units requires both special equipment (such as iButton system) and special
adjustments in the system.
1. Create a special sensor of Trailer binding type in the properties of each unit intended for auto-binding. A parameter
for this sensor can be avl_driver or some other depending on your equipment and its configuration.
2. Press the Units button in the Trailers panel and create lists of automatically attachable units for each resource of
trailers.
359
Thus, a trailer will be automatically bound to a unit with the help of iButton in case that this unit has a special sensor
configured in its properties and that this unit is indicated in the list of auto-attachable units applied to the resource
where the trailer belongs.
Delete Bindings
Incorrect registrations of trailers can affect reports and their informational efficiency. That is why sometimes you may
need to delete such (un)bindings from the database. Open 'bind/unbind' dialog, choose the last option – Delete
bindings – and press Next. Specify time interval and press Show to display all bindings and unbindings of the trailer
on the interval. Check invalid messages and press OK to delete them.
Note!
Like with units, the last message from the trailer (whether it is a binding or unbinding) cannot be deleted.
360
Groups of Trailers
Groups can be formed from any available trailers. Trailer groups can be applied to filter trailer list and to query reports
for groups.
To create a new group of trailers, press the button . Enter name and description and choose trailers to compose the
group.
Only trailer belonging to the same resource as the group itself can be added to the group.
Created groups are displayed in the dropdown list. It operates also as a filter, i.e., if you choose a group from this list,
all trailers of this group will be displayed below. You can also choose to display all trailers or just trailers outside
groups. On the right of a selected group, you will find buttons to edit, copy, or delete it as well as the button to create a
new group.
361
Usage of Trailers
Online tracking:
Trailers can be displayed on the map if they are checked in the panel in the first column.
Trailers can be displayed in unit's tooltip and in extended unit information if this option is selected in the
User Settings dialog.
Trailers can be displayed in the Monitoring panel as a column if this option is selected in the User Settings
dialog.
In notifications:
You can configure a notification to get informed when a trailer is bound to a unit or unbound from it.
Using notifications, you can also unbind trailer automatically, for example, when entering the destination
point.
In reports:
Many tables (such as 'Trips', 'Geofences', 'Parkings' etc.) can have a column that displays a trailer if any
was bound to the unit on certain interval.
You can generate tables for individual trailers and trailer groups. Two tables are currently available –
'Bindings' and 'Custom fields'.
362
Jobs
Attention!
This module is licensed separately. In addition, the set of available job types depends on purchased modules.
In the list, jobs are sorted by name. Use the dynamic filter to save
your time when looking for a certain job. Input job name or its part
into the search box and observe the results. The other way to filter
jobs can be used if you have access to more than one resource.
Then, on the dropdown list, choose a resource to display only jobs belonging to it.
Direct a mouse pointer over a job to view details in the tooltip: job type, parameters, schedule, last execution time
(whether successful or not), resource (if there is access to several), and other parameters depending on job
configuration. In columns on the right, you can see job state (on/off), the number of executions already made, and the
number of maximum executions allowed.
Different kinds of jobs are marked with special icons in the first column:
— command execution;
— sending report by e-mail;
Job — sending information about fuel;
type — access management;
— manipulate GPRS traffic counter;
— manipulate engine hours counter;
— manipulate mileage counter.
Clicking on job state sign at the header of the table, you can enable/disable all jobs at once (if you have access
rights on them).
Enable or disable a certain job.
The first (left) column shows how many successful executions there were; the second (right) column shows
maximum executions allowed.
Note.
If a job belongs to some resource to which you do not have access rights to Create, edit, and delete jobs, then some
kind of actions towards these jobs, such as enable/disable, edit or delete will be unavailable.
363
Configuring Jobs Table of Contents
Configuring Jobs
Selecting Units for Jobs and
To make manipulations with jobs, you should have at least one resource with the access Notifications
right Create, edit, and delete jobs. Basic Parameters for Jobs
To create a new job, press the New button. In the dialog choose job type:
Then follow instructions in the dialog. For any type, you have to select units to apply this job to and set the basic
parameters like activation time and schedule. For each type of job, adjust also individual parameters described below.
Access required: Use unit in jobs, notifications, routes, retranslators (resource's creator where the job belongs is
supposed to have this access to units to assign then this job).
By default, only units which are on the work list of the Monitoring panel at the moment are displayed in the dialog
where you choose units for a job or notification. If you use the dynamic work list (formed according to data accuracy),
all units allowed for the activity are displayed in the dialog.
If you see no units, press the 'Display all' button . If it does not help, it means there is not enough access to any of
units.
You can switch between units and groups by clicking the switch-button / . If you select a group, it means the
action will be applied to all units in this group. The list of units is in group's tooltip.
Mark units/groups to apply a job/notification to. Put the flag in the header of the table to select all items.
Please note that if there are more than a hundred units on this page, their icons are not displayed.
364
While editing a job or notification, this page contains units selected for the job (they are checked) and units displayed
on the work list at the moment. You can add more units for the action or remove some. However, only unit with Use
unit in jobs… flag can be displayed here. If a job or notification that you are editing contains units to which you have
not enough rights, you will be warned about it and in case you save the job/notification, those units will be lost.
Name
It is used in the list of jobs or as mail topic if the job is to send some information by e-mail.
Description
Job description is optional. Is can appear in job's tooltip.
Execution schedule
Two ways to set schedule exist:
(1) Periodic execution: each … hours and minutes.
(2) On schedule. Key in time in the format of hours:minutes or just hours. If you need to indicate several points in time,
separate them by spaces.
Activation time
Date and time when the job will be activated.
Maximum executions
Enter the number of job executions after which it will automatically deleted. If you leave this field empty, the job will be
executed endlessly until you delete it or disable manually.
Enabled
This check box indicated whether the job is on or off. When creating a job, enable this check box to activate the job
365
just after creation. If this check box is not marked, the job will appear on the list anyway, and you can activate it later.
Time limitations
In the right part of the dialog one can define time limitations by days, months, time, etc. For instance, the job can be
assigned to a unit just on weekdays and within working hours from 9 AM to 6 PM. Or you may want to reset traffic
counter once a month on the first day of the month. To do this, select the day 1.
Job name and schedule are required fields, other parameters are optional.
366
Execute a Command over a Unit
While creating a job of this type, choose a command to be executed from the given list. The list consists of all
commands that are configured in selected units (if you have Execute commands rights to these units).
Not all of selected units may be able to execute a chosen command, and it is seen from the indicator:
a green sign means that all selected units support this command;
a yellow triangle means that not all of selected units can perform it (see details in the tooltip).
Restrictions can be placed due to access rights or device type used.
For some commands, you should set additional parameters like input/output number, online report interval, etc.
More about executing commands...
Attention!
When the time comes to execute a command as a job, all kinds of rights are checked beforehand. The user who is a
creator of a resource where the job belongs should have the following access flags to unit: 'Execute commands' and
the set of flags specified in properties of this command.
367
Change Access to Units
This job is aimed to change users' access rights automatically, for example, if you want to give someone demo access
for several days or restrict access to working hours.
To configure this job, select users and assign them new access. On the list, there are only users to which you have
access Manage user's access rights.
Check necessary users on the left and indicate access flags on the right. You can set flags, remove flags, or leave
them untouched.
Attention!
This type of job can be performed successfully only if at the moment of its execution necessary rights are OK. The user
who is a creator of the resource where the job belongs should have unit ACL flag 'Manage access to this item'.
368
Jobs about Counters Table of Contents
Jobs about Counters
GPRS Traffic Accounting
Counters of three types are used in Wialon tracking system: counters of GPRS traffic, mileage, Mileage Accounting
and engine hours. They can be set up in unit properties. Engine Hours Accounting
Jobs about counters allow you to automate accounting of mileage, engine hours, and GPRS traffic.
For example, you can assign to reset the traffic counter once a month and register each reset with the current value in
unit history.
Indicate the status of the option Store counter value in unit history. If the option is activated, each reset is
registered in the system, and then you can generate a report on events or report on traffic to see traffic consumption. If
the option is not activated, resets are not registered anywhere.
The option Reset GPRS traffic counter is to set the counter to 0 each time when the job is performed.
Mileage Accounting
This kind of job can help you to fulfill control over mileage counter automatically, according to schedule. With this job
you can store mileage counter value in unit history, reset mileage counter, set a new value for it, save its value as
parameter in data message.
To set a new value or to reset the counter, choose the option Set new value for mileage counter and input the
desired value below. The counter will obtain this value each time when the job is executed.
Set the flag Store counter value as parameter of unit data message to save the counter value as parameter in data
message. Later on it can be used to get initial and final mileage for trips. It is recommended to store the counter while
the unit is parked, for example, once a day at night time.
The option Store counter value in unit history can be used to store current mileage counter value. It is especially
recommended if according to the job properties, the counter has to be reset or altered.
This is analogue of the previous type of job but it is applied to engine hours sensors.
369
If you store engine hours sensor as parameter in data message, you can use this parameter to create engine hours
sensor on its basis.
Attention!
This types of job can be performed successfully only if at the moment of its execution all necessary rights are OK. The
user who is a creator of the resource where the job belongs should have unit ACL flag 'Edit counters'.
Counters' values (traffic, mileage, engine hours) are stored in unit history as registered events, which is needed for
creating reports – Events or Chronology. When counter values are stored as parameters, it means new data
messages are added to unit database. Those messages bear data message type, and mileage and engine hours are
displayed there in meters or feet (depending on unit's properties) and seconds correspondingly.
370
Send a Report by E-mail
This job can be used to automatically generate and send reports about units' activity to your e-mail(s).
Choose report template, file format(s) and parameters. Specify time interval – for previous … days/weeks/months/years.
In the Recipients section enter e-mail address(es) where to send reports. More about parameters of report export...
In the list of report templates, only those that belong to the same resource as the job are displayed. Depending on
template type, you choose appropriate objects for report generation in the next page of the dialog – units, groups,
users, drivers, routes, resources, or retranslators. To apply the job for those objects, you should have a special access
to them – Query messages or reports (besides, units are taken here from the work list of the Monitoring panel).
Only compressed files of reports can be sent as a job. Subject for the e-mail is taken from the name of job, and the
repository itself derives its name from the report template name plus data (yyyy-mm-dd). After you have received a
letter with a report, extract files to some folder and open them with appropriate applications depending on file formats.
Note.
If in your company the workday sometimes finished after midnight (because some vehicles may arrive late at night),
then you can adjust the parameters for the daily report in the following way. Select report interval 'for previous 24 hours'
and set job activation time at 4 AM. Then the report will be automatically generated every day at 4 AM. It will contain
data for the last day, and the trips finished after midnight will not be divided into two parts.
371
Send Information about Fuel Table of Contents
Send Information about Fuel
SMS Format
You can get information about fuel (fillings, thefts, fuel level) by e-mail or SMS according to
predefined schedule. This information is given in liters only.
To detect fuel fillings and thefts, the appropriate unit settings are used (see Unit Properties => Fuel Consumption).
Event type: filling, theft, fuel level (all three can be chosen). Fuel level means fuel level at the beginning
and at the end of the interval (the interval is set later).
Method of delivery: by e-mail and/or SMS. On the right, enter your e-mail(s) and phone number(s) in the
international format. When all slots to enter e-mails and phones are filled, additional slots appear
automatically.
Message form: one unit in one message or all units in one message.
Time offset (in minutes). This parameter allows you to analyze messages from the black box. In this case,
time offset value is subtracted from interval beginning.
Note.
Information about fuel filling and thefts is sent only in case if any has been detected. Information about fuel level is
given in any case.
SMS Format
Unit Name
x a/b/c
where
Unit Name is unit name as set in unit properties (to save traffic it is recommended to use no other letters
but Latin);
x – sensor number;
a – fuel level;
b – fuel filling;
c – fuel theft.
Iveco_1501
372
1 66/-/-
2 100/-/10
means that according to the first sensor the unit Iveco_1501 has 66 lt of fuel, and no fillings and thefts were detected;
according to the second sensor (fuel in the second tank, for example) fuel level is 100 lt, no fillings were found, and 10
lt theft was detected.
1. The corresponding flag is not ticked in job parameters. For example, it is not chosen to send fuel level.
2. There are no valid data (it may happen with fuel level).
3. Required events were not detected (it may happen with fillings and thefts).
Note.
Whether fuel volume will be sent in liters or gallons, depends on resource settings (where the job belongs) and not on
units' settings.
373
Notifications Table of Contents
Notifications
How to Create a Notification
Attention!
This module is licensed separately. In addition, the set of available notification types and actions depends on
purchased modules.
You can be notified about any unit activity that you consider significant. It can be speeding, location, sensors values,
etc. A notification can be delivered by e-mail or SMS, shown online in a popup window or replied by some other
means.
To create, edit and view notifications, open the Notifications panel, choosing a corresponding name in the top panel or
clicking on the necessary item in the main menu customizer.
Attention!
To create a notification, the access flag Use unit in jobs, notifications, routes, retranslators is required. However,
sometimes it is not enough – if a notification concerns an action, you need to have rights to perform those actions, and
only then the notification will trigger.
374
Notification Type
Speed
Define the minimum and/or maximum speed values. If a unit goes out of this range, the notification will trigger. In
addition, you can activate sensor value control – in this case, the notification will trigger only if both conditions are met.
Geofence
In case of this choice, in the following window you select geofence(s) to control and control type: control entries to or
exits from geofence(s). Those geofences should be created in advance and belong to the same resource with the
notification. To choose several geofences at once, hold <ctrl> key and click on needed geofences in sequence.
In addition, you can narrow trigger case adjusting speed limitations or sensor value range inside (outside) the
geofence. Then the notification will trigger when a unit being inside (outside) a controlled geofence breaks these
limitations.
For additional speed control, indicate lower and higher speed limit, and the notification will trigger if beyond the limits.
For sensor control, you can set trigger inside the indicated values as well as outside them. Choose sensor types on the
dropdown list or set the mask using a wildcard symbol (*). If there will be two or more sensors of the same type or
mask found, their values can be summed or calculated separately (select the corresponding option).
375
Alarm (SOS)
Digital input
Specify the number of digital input and select control type: trigger on input activation or deactivation.
Parameter in a message
Four control types are provided: value range, text mask, parameter availability, and parameter lack. Only real
parameters, i.e., sent by device itself can be considered whereas virtual parameters such as speed, altitude, sats
(satellites) etc. cannot be controlled by this type of notification.
To control Value range, specify parameter name, define minimum and maximum values for it, and select whether to
trigger in the specified range or out of it. If you need to get notifications for all parameters except 0, set 0 as min and as
max value and choose trigger type 'Out of specified range'.
To control text, enter parameter name and Text mask using wildcard symbols (? and *).
For Parameter availability and Parameter lack, it is enough to indicate parameter name. These two last mentioned
options can be interpreted as parameter appearance and disappearance if on the last page of the dialog you set the
option 'Generate notification only when state changed'. For in and out parameters it is possible only to control
parameter availability/lack.
Sensor value
With this notification type, you can control either sensor getting some undesirable value (Value range) or abrupt
significant change in sensor value (Value leap). To specify sensors to be controlled by the notification, choose sensor
type on the dropdown list or set the name mask using wildcard symbols (*). You can as well do both. If there will be
found two or more sensors meeting these conditions (same type or name mask or both), their values can be summed
or regarded separately — select the corresponding option. Then enter minimum and maximum values and select
control type: trigger in the specified range or out of it. If you control value leap, enter only delta (notification triggers
376
when delta is exceeded).
Connection loss
1. No data. It can be a simple connection loss when no messages are received from the unit during a period
of time.
2. No coordinates. There are also cases when all sensors are active and their values are known, but it is
impossible to locate the unit. It is especially true if someone covered GPS receiver.
Indicate loss time: how long (in minutes) the connection/coordinates loss should continue before a notification triggers.
Idling
For this type of control, indicate speed and time. Speed should be more than 0 in order to exclude possible equipment
errors. Indicate also time allowed for staying. If this time exceeded, this will be considered as an idle, and the
notification will trigger. In addition, you can activate sensor value control – in this case the notification will trigger only if
both conditions are met. It is convenient to control idles with engine on, for example.
SMS
You can receive a notification when a certain SMS message comes. To define, which SMS messages you are
interested in, enter a mask for message text. This feature can be useful, for example, when a device sends SMS of a
certain content in case of malfunction.
Interposition of units
This type of notification allows you to control approaching of units to each other and moving away from each other.
Select control type (approaching or moving away) and specify radius in meters – if this distance between units is
insufficient or exceeded, then the notification will trigger. Choose units which position will be estimated regarding the
units that were chosen for the notification itself.
In addition, you can narrow trigger case adjusting speed limitations or sensor value range (like in geofence control).
377
Address
This type of notification is similar to geofence control. You can control entrance/exit or being in or out of a particular
place. Enter some address parameters (e.g., city, street, and house) and then select the most appropriate option from
found addresses. Additionally, adjust the radius of controllable area.
Excess of messages
With this notification, you can be warned if a unit exceeds the limit of messages you have set. Either usual data
messages or only SMS messages can be under control of this type of notification. Indicate the limit of messages and
set the reset interval. The example below assumes that the notification will trigger if unit sends 10 or more SMS
messages in an hour's time.
Route progress
For this type of notification, select statuses to control: round start, round finish, arrival to check point, check point skip,
departure from check point, etc. Additionally, you can specify name masks for routes, schedule and/or round.
Driver
Choose control type: driver assignment or driver reset. To control both activities, two notifications of different types will
be required. Using this notification you can control all drivers (*) or just some of them – input driver's name (or code)
mask.
378
Trailer
Choose control type: trailer assignment or reset. Settings to adjust are the same as for previous type.
Maintenance
First, you choose trigger type: notify when service term approaches or notify when service term is expired. Then
indicate the interval before or after the term for the notification to trigger. This interval can be in days, kilometers,
engine hours, or together. You can control either all intervals existing in the Service Intervals tab in unit properties or
just several intervals. To specify target intervals, enter a name mask using wildcard symbols like asterisk (*) and
question sign (?). Then indicate how much mileage, or time, or how many engine hours should be left or expired to
make the notification trigger.
Notification about maintenance triggers only once – when a critical point is met (mileage, engine hours or time) about
any maintenance interval. Then information about service work done should be delivered through event registrar or
through unit properties dialog. Only after that, the notification starts working again.
Note.
As each notification belongs to some resource, it takes its measurement units from this resource. If the American
measurement system is set for the resource, then speed is shown in miles per hour (mph), radius in feet (ft), and
mileage in miles (mi). Otherwise (in case of metric system), it will be kilometers per hour, meters and kilometers,
correspondingly.
379
Notification Action
Notification action is the system will react when a notification triggers.
Notify by e-mail
You can indicate one or more e-mail addresses to send a notification to. When all slots to enter addresses are filled,
additional slots appear automatically. Besides, you can check the option Attach image from triggered message if your
the device used takes pictures.
Notify by SMS
Key in one or more telephone numbers in the international format, for example, +375293293294. When all slots to
enter phones are filled, additional slots appear automatically.
Attention!
Different browsers can have restrictions regarding formats of audio files:
To highlight a notification, you can set an individual colour to it. This colour will be applied to the background of the
triggered notification so that you could easily notice it.
380
Register as violation is additionally proposed. If you check it too, the notification will be registered not only as
event but also as violation, and one more report type will be available to you. For further information, see reports on
Events and Violations.
Execute a command
For this action, choose a command to be executed over unit(s). The list consists of all commands configured in the
properties of selected units. So, different commands on the list may be supported by different units. Support status is
seen with special indicators:
For some commands, you should set additional parameters like input/output number, online report interval, etc.
More about executing commands...
Create a round
Creating a new round for unit can be chosen as an action undertaken after the notification triggers. For example, when
one round is finished, a new round can be assigned, or when unit leaves its garage (as a geofence), a round is
381
automatically created for it.
Reset driver
This feature can be used, for example, to reset driver automatically when the unit returns to the depot. This action can
be completed successfully only if you have enough rights for the resource where the driver under question belongs –
'Create, edit, delete drivers'.
Reset trailer
Similar to the previous one but concerns trailers. This action can be completed successfully only if you have enough
rights for the resource where the trailer under question belongs – 'Create, edit, delete trailers'.
382
Notification Text
Text can be set for such actions as notify by SMS or e-mail, register an event in unit history, or display popup window
online.
The text of a notification can be written in any language, contain any characters, words and phrases, and be of any
size. Large messages are acceptable for e-mail notifications. Of course, for SMS notifications it is better to form more
compact messages.
To be more informative, a notification should contain special parameters (tags) which are substituted with real values in
an incoming notification.
Example.
The text «'%UNIT%' violated speed limitations. At '%POS_TIME%' it moved %SPEED% near '%LOCATION%'» can be
transformed to «'Rover-119' violated speed limitations. At '2000-01-01 12:01:37' it moved 136 km/h near 'KU 8,
Thurnau, DE'».
Measurement units (kilometers or miles) used to decipher parameters depend on resource settings where the
notification belongs. Date and time format are taken from the creator of this resource.
383
%MILEAGE% Mileage at the moment of notification
%LAT% Latitude at the moment of notification (e.g., N 55° 45.7530')
%LON% Longitude at the moment of notification (e.g., E 37° 35.2068')
%LAT% Latitude without formatting
%LON% Longitude without formatting
Link to Google Maps with the position at the moment of notification
%GOOGLE_LINK%
(e.g., http://maps.google.com/?q=55.762550N,37.586780E)
Unit custom fields. If you leave the asterisk sign in the brackets, all accessible custom fields
(both regular and administrative) will be shown with their values (in the format “key: value”).
%CUSTOM_FIELD(*)% However, you can get the value of a certain field if you specify its complete name in the
brackets. In this case, the resulting notification text will contain the value of the specified field
(only the value but not its name).
There are also parameters which make sense only with certain types of notifications:
Note that a parameter must be marked by percent sigh from both sides. Otherwise, it will be considered as plain text
and will not be converted to real values.
384
Notification Parameters
Here you set general parameters for a notification as well as define the specific character of its operation. The set of
parameters can vary depending on notification type.
Name
Key in any mane. It will be displayed on the list of notifications and in the notification itself.
Max triggers
How many notifications can be delivered until it will be switched off (or permanently deleted if units
mentioned in this notification do not exist anymore).
Generate notification: (1) Only when state changed, (2) For all messages
In the first case, the notification will trigger when unit state changes, that is if at the moment when the
notification was activated a unit is already in an alarm state, the notification will not trigger. In the second
case, the notification will trigger as soon as an alarm state is detected. If the second option is selected, the
following parameters are not needed.
385
Maximum time between the latest message and the previous one to form a notification. If the interval
between the current message and the previous one exceeds this value, the notification does not trigger.
Timeout
Delay from the moment when message was received and before it will be checked. This delay is especially
recommended if a unit has a black box that usually requires time to unload all messages stored in the
period of communication loss (for instance, while it was abroad).
Enabled
If activated, the notification after creation/editing will be active. If not, it will be disabled.
Time limitations
It is possible to set limitations depending on time, day or month. For example, the control can be performed
only on weekdays and within working hours.
386
Notifications Management
On the list of notifications, you can get the following information:
Hover the mouse cursor over a notification to see detailed information in the tooltip: control type, parameters, actions,
life time, text and resource (if available).
enable/disable notification,
enable/disable all notifications at once,
edit a notification settings,
create a new notification using this one as the basis,
delete a notification.
If you have just view access to the resource where a notification is located, you cannot edit or delete it, and some
buttons look different:
you cannot change notification state,
view notification properties (editing not available),
impossible to delete the notification.
Using the dynamic filter, you can save your time when looking for a certain notification on the list. Enter notification
name or its part into the search box above the list and estimate the results.
The other way to filter notifications can be used if you have access to more than one resource. Then, on the dropdown
list, choose resource name to display only the notifications that belong to this resource. Note that if you have just view
rights to a resource, you cannot edit or delete these notifications.
387
Online Notification
Online notifications will popup in a separate window and can be accompanied by a special sound (see User Settings). If
special parameters are not specified in notification properties, the standard audio signal is used. However, you can
assign your own sounds, for each notification individually.
Newly received notifications are added to the list on the top. Unread notifications has a sky-blue background by default.
The caption for an online notification is taken from notification's name provided during its creation and is highlighted in
blue. To expand or minimize a particular notification, use the switch button +/- or click on the header of the notification
in a place with no text.
Records in this window can have different background (if this was set in action parameters). Colorful backgrounds can
be applied to highlight most important messages or visually separate notifications of various types from each other.
Background becomes lighter after the notification has been read.
If clicking on a notification, the map is centered on the place where the event happened. If clicking on unit's name, the
map is centered on the latest unit position. At that, the unit is added to the work list of the Monitoring panel with the flag
'Show on map'.
To delete a notification, click on a red cross against it. It is possible also to delete all notifications or delete all read
notifications (Delete all or Delete read). The window is closed automatically when you delete all notifications. If the
online notifications' window is closed by clicking on the grey cross in the upper right corner, then the window ceases to
appear automatically upon receiving of notifications until the window is opened by clicking the corresponding button in
the bottom panel.
The notification window can be hidden or shown, resized or dragged over the screen. To resize the window, click on its
right or bottom edge and drag in the necessary direction. To hide the window, click on the Online Notifications icon on
the bottom of the screen (or use the standard little cross in the upper right-hand corner of the window).
By default, the notification window appears automatically when a new online notification triggers. However, if you
remove the flag Automatically display popup events in User Settings, only the number in red circle next to the
notifications icon will indicate that there are new messages. If there are any messages in the window (either read or
unread), the icon itself is active which means it is colorful and can be pressed on.
Note.
Any user who has any access to a resource will get all online notifications created in this resource.
388
Users Table of Contents
Users
Working with Users
User is a system object defined by its specific name (login) and password. Users can login to Application of Users
Wialon Local and control their units with the help of different tools and features. Different users
can have different access to units and different set of allowed activities. They can create their own geofences, report
templates, etc. non-visible to other users.
General,
Access,
Advanced,
Logs,
Custom fields.
Application of Users
If you have access to several users, it affects system in whole. You can create objects under a selected user or within
their account. As a rule, the information that a certain object (driver, geofence, unit, etc.) belongs to a certain resource
or account is displayed in object's tooltip or properties dialog. Besides, in all panels containing filters, there is an
additional filter by user/account (in the form of a dropdown list).
Actions of users in the system are logged. For instance, you can view user's (operator's) chat with driver, learn which
commands were sent to units by this user, what alterations this user made to some object properties, what objects
created, etc. This functionality is available mainly through reports.
In reports on users you can create the most detailed tables on users' logins and logouts as well as get charts of their
activity by hours and days.
with the help of the the appropriate job (for instance, you can allow access only during the working shift);
with the help of the notification with the appropriate action (for instance, deny access when a route is
complete).
389
Units
Unit is a vehicle, machine, person, pet or any other moving or
stationary object that can be controlled with the help of a GPS
tracking system.
Use the following buttons against each unit to perform standard actions over it:
— Send SMS to unit's SIM card. It can be a command or other message. SMS buttons are not
displayed if this feature is not activated for the current user. If the button is dimmed, it means there is no
phone number in unit properties or the current user has not enough rights to the unit. If two phone numbers
are given in unit properties, choose one of them when the dialog of SMS sending opens. More about
sending SMS messages...
— View or edit unit properties. To get the most efficient results both in reports and in online monitoring,
unit should be set up correctly, in accordance with device type used, available sensors, and tracking tasks.
Unit is configured in unit properties dialog that was described above. Depending on your access level, the
dialog can contain up to 12 tabs which detailed description can be found in the following topics:
General,
Access to Unit,
Icon,
Advanced,
Sensors,
Custom Fields,
Unit Groups,
Commands,
Trip Detection,
Fuel Consumption,
Service Intervals.
— Delete a unit from the system completely. To do this, you need manage rights. If the button is
dimmed, it means you do not have enough access (manage rights are required). Routes assigned to unit
are deleted together with it.
390
Unit Groups Table of Contents
Unit Groups
Working with Unit Groups
Unit group is a system macro object incorporating several units that have something in Application of Unit Groups
To open the Unit Groups panel, choose a corresponding name in the top panel or click on the necessary item in the
main menu customizer. Here you can create, view, copy, edit, and delete unit groups.
General,
Access,
Icon,
Custom fields.
When working with unit groups, consider some specific features relating to access rights:
Unit groups are widely used in the user interface of Wialon Local:
391
draw tacks of all grouped units on the map.
More...
3. Configuring jobs, notifications, and routes:
When configuring jobs, notifications or routes, they can be applied to a group of units at once,
which accelerates the process.
More...
Unit groups also have some specific functions in the management system, which were described above.
At that, unit groups are easy to handle. Deleting groups does not mean physical removal of units belonged to this
group. That is why you can easily create, manipulate and delete groups. Besides, the dynamic formation of groups is
supported – see Notification Action. It means, if some preset conditions are met, a unit can be added to a group
automatically or removed from it.
392
Tools
To find a necessary tool, open Tools dropdown menu, choosing a
corresponding name in the top panel or clicking on the necessary
item in the main menu customizer.
To quickly access a tool, use shortcuts. Any tool can be minimized or closed with two corresponding buttons located in
the upper right-hand corner of the window of each tool. Besides, these windows can be dragged over the screen. Their
custom position is stored (for each tool individually), and next time they will be opened in the place they were closed
the previous time.
Measurement system applied to tools which require online calculations (such as Distance, Area, Address, Routing,
Nearest units) is taken from the settings of current user (see User Settings. Measurements for tools associated with
track processing (such as Track Player, Hittest) are borrowed from units' properties.
Track Player
Distance
Area
Address
Routing
Hittest
Nearest Units
SMS
393
Track Player Table of Contents
Track Player
Player Settings
This tool allows viewing how unit was moving and how its various parameters were changing Playback
with time. The tool can be applied to tracks only. There are four ways to get a track on the
map:
1. In the Tracks panel, request tracks of units' movements for any period of time.
2. In the Messages panel, while viewing messages for the indicated period, the track is mapped
automatically.
3. In the Reports panel, while generating a report the track is mapped if the corresponding option ('Trip
routes' or 'All messages on map') is activated in report template.
4. Tracks can be built directly from the Monitoring panel with the Quick Track button.
The most recently built track (in any panel) becomes selected in the Track Player automatically. However, you can
switch tracks manually choosing them in the dropdown list. A track name coincides with unit's name, and the panel
where the track was built is specified in brackets (Tracks, Reports, Messages).
Player Settings
Adjust appropriate playback speed using the speed slider bar. It can vary from real time speed (1x) to acceleration by
90 times (90x). Regardless selected value, messages with zero speed and no movement will be played at maximum
velocity. If you change playback speed while playing a track, new value will be applied after you press 'Pause' and
then 'Play' again.
Note:
Playback speed is a rather conventional thing. Playback performance depends on type of browser used, computer
processing power, number of messages in the track, and time intervals between messages. It is likely that the track
will be played more slowly than you expect because, in any case, all messages will be played even if it takes more
time.
The map can be moved manually or automatically. This setting is adjusted with the switch button . If it is disabled,
the map cam be moved only manually. If it is active, the map is moved automatically in the following cases:
394
when navigating the track by clicking on different places of the timeline;
when choosing a new track in the dropdown list (the map is moved to the first point of the track).
If the device used is able to send pictures, they can be displayed, too. This option can be disabled though — use the
switch button .
Playback
To start playing the track, press the Play button . At this, it transforms to the Pause button, which can be used to
stop playback. If after a pause playback is started again, it continues from the place it stopped the previous time.
There is a similar button in the Tracks panel, against each track on the list. When the playback is completed the unit
stays in the point of its last location, and the button changes from Pause to Play. If you click this button once again a
time scale will be set to zero, and a track will be played from the very beginning.
As messages are being played, the selected unit is moving over the map. It can be represented by its icon or
movement state signs. It is also convenient to use rotating icons — see Unit Presentation on Map. A unit being played
is easily distinguished from the real unit by the color of its name — purple for playable units, red for real units. While
playback is performed, the real unit temporarily disappears from the map.
While playing, address and speed of each point are displayed above the timeline. Below the timeline, you can track
also changing values of parameters and sensors (visible sensors only). Expand two below sections to see their full
contents. There can be a great number of parameters and sensors and you may want to single out those you want to
track during playback. Double-click on necessary items to move them to the main section of the player (right below the
timeline). Then you can collapse sections with all parameters and sensors.
As a track is played, all data in these sections is refreshed dynamically according to message being played at the
moment. If there are images in messages, they popup in corresponding places, too.
Track playback can be invoked from any message. Navigate throughout the track by clicking on any place of the
timeline or track itself. Besides, you can use the buttons:
Tracks can be also played in a special app — Track player. This application allows playing tracks of several units at
once.
395
Distance
Choose Tools => Distance to measure the distance between two objects. To indicate the initial point, double-click on
any place of the map. Then sequentially add new points. At any moment, you can move the map or zoom it using any
of the ways described above.
Near each point, the distance from the previous point is indicated. The total sum of all segments is known from the
popup window in the corner. To know the sum, the mouse pointer must be placed over the last point of the polyline.
Unlike other points that are red, it is white with blue border. If the cursor points some other place, the total sum will also
include the distance to the current cursor position. At the same time, in brackets two numbers are given: the sum of all
segments drawn + the distance to the cursor (if the cursor is over the last drawn point, this distance is 0m).
When the line is on the map, move the cursor along the line to get the distance from the starting point to the current
cursor position. Cursor position is marked by a white point (if put the cursor over, it becomes plus-shaped), and a black
font is used to display distance value.
To clean the map and start new measurements, use the Reset button.
396
Area
Choose Tools => Area on the menu. To draw a polygon, follow the same directions as for polyline creation. The
perimeter and total area can be known from the popup window in the corner.
Use the Reset button to clean the map and draw a new area.
397
Address Table of Contents
Address
Search by Address
The address tool is designed to: Address Detection
Save as Geofence
The address information can be received from different provider (depending on maps activated and their support):
Gurtam Maps / WebGIS, Google, Yandex, etc. (see Map Source).
In User Settings, you can indicate City. Then this city/town will be selected automatically when you open the Address
tool.
Search by Address
To start searching, input the first letters of the name of the city/town into the City field. After typing three or more
characters, in the Results field a list of places starting with these letters will appear. If the place you are looking for is
the first on the list, push <Enter>. In other case, select the necessary item in the list and click on it. The similar actions
can be performed in the Street field. After selecting the street, a list of houses located there becomes available.
Choose one, and the map will be centered at this house.
The found place will be marked with a red marker. Information (coordinates and address if available) will be
displayed below. If it gets into any geofences, their list will be given, too. On the left of geofence name there will
be a square box with color assigned to this geofence.
The Back button is used to go back to the street search (if you are already selecting a house) or to the city search (if
you are in the street field).
If you have moved the map or scaled it, you can reset changes pushing the Show button.
Address Detection
To know address of a point on the map, just double-click on it. See the address and the coordinates in the popup
window. If it gets into any geofences, they will be listed below.
It is possible also to detect address by coordinates. Input latitude and longitude in grades and fractions (they should
398
be separated by a dot) and push the Show button. The map will be centered at this point.
Save as Geofence
The found place can be saved as a circle-shaped geofence with 100 m radius. The detected address will be used as
the name for this geofence (however, you can edit it).
399
Routing Table of Contents
Routing
Selecting Provider
This tool helps to quickly make routes from one point to another visiting any number of Placing Points
interstitial points. You can define the sequence of points yourself or the program will optimize it Route Calculation
Saving As Geofence
for you. You can indicate key points double-clicking on the map or entering needed addresses.
Resulting route can be saved as geofence with control points or without them and used for routes control or geofences
control later on.
Choose Tools Routing to make use of this feature. Set points and press Calculate.
Selecting Provider
Depending on maps available at your service, different map providers can be used to make a route: Gurtam Maps /
WebGIS, Google, Yandex, etc. They are chosen in the dropdown list.
Gurtam Maps and WebGIS do not lock routes to roads when making a route, however, they can offer optimized
sequence order of points (considering the straight distance between them). Other providers make routes along the
roads but cannot change points order.
Depending on map provider, more features can become available. For example, if Google is selected, the route can be
mapped regarding the way you travel: by car (default option) or walking or avoiding highways (tick the appropriate
check box). Yandex adds possibility to take into account traffic jams.
Placing Points
There are two basic ways to set key points for route:
Note.
If you are going to use this route for Route Control, it is recommended to enter departing point as the first point of the
route.
When all points are set, it is possible already to draw the route (the Calculate button). However, before doing that, you
can edit key points, especially if you are going to save this route as geofence with control points.
The list of points is displayed in the Points panel. Here you can edit point name, its radius, and delete unnecessary
point.
400
Route Calculation
If building a route with Gurtam Maps or WEbGIS, sequence order of points can be interpreted in two ways:
Default option is that the points follow in the order you put them.
Point order can be optimized in order to make the route as short as possible. For this you should enable
the flag Optimize points order. The route will be drawn beginning from the first point (without snapping to
roads). The last point can be fixed (for example, if a unit lefts the depot and after a while is expected to
come back), that is regardless any sequence order offered by the program the last point will be that which
was set the last. For this, enable the flag Stick last point.
At the end, press the Calculate button and estimate the result. If you need to change some parameters (for example,
add more points), press Undo calculation. If you want to build a new route, remove all points with the special button
on the head of the points list.
In addition, you can choose line color as well as view information about route – its length and number of points.
Saving As Geofence
After the route is mapped, it can be saved as a line-shaped geofence. To do this, enter geofence name, choose
account, and push Save. If the key points were given manes, the geofence will have control points.
If the map provider was not Gurtam Maps or WebGIS, there are two ways to save the route:
401
The newly created geofence will appear on the Geofences panel where it can be edited and used for different
purposes.
402
Hittest
This tool is applied to tracks only. There three ways to get a track on the map:
1. Open the Tracks panel and request tracks of unit movement for the indicated period.
2. In the Messages panel, while viewing messages for the indicated period, the track is mapped
automatically.
3. In the Reports panel, while generating a report the track is mapped if the corresponding option ('Trip
routes' or 'All messages on map') is selected in report template.
4. Tracks can be built directly from the monitoring panel with the Quick Track Building button.
Choose a track in the dropdown list. Hover the cursor over track to get accurate information about any point in a tooltip.
Double-click at any place of the track (or even on the map), and the nearest to your click message will be found and
highlighted by the marker. The map will be centered on this point.
Two modes are available here: single-point and multipoint. Depending on your choice, you can get information about
one or more points at once. The information is displayed in the popup window when placing the cursor over a marker.
The information is: date and time, location, speed, altitude, coordinates, satellites, sensors values (visible sensors only).
It is duplicated in the table at the top of the screen.
If the multipoint mode is selected, you can mark several point of the track. The active (selected) point is then blue and
others are red. In the table, the active point is also highlighted by blue color. To navigate from one point to another,
click on a corresponding marker on the map or corresponding row in the table. Besides, if the multipoint mode is
selected, the displacement from the starting point (in time and distance) is calculated, and in brackets you can find the
displacement from the previously put point.
403
Nearest Units Table of Contents
Nearest Units
Request
This tool is designed to help you to find units which are the nearest to a certain place according Additional Parameters
Choose Tools Nearest Units on the menu. In a special window set the parameters of your request and observe
search results.
Request
In the selected place, a red marker appears, and at the bottom the list of nearest units is displayed.
If in User Settings the parameter City is set, then the city/town is already specified when you open the tool.
Note.
Only Gurtam Maps or WebGIS (depending on your system configuration) can be used for address detection.
Additional Parameters
Consider routing
When choosing this option, the distance from the indicated place to a unit is calculated not directly but taking into
account existing roads. The source for routing can be Google or Visicom maps.
Routing provider
By default, it is Gurtam Maps / WebGIS. However, in can be also Google or Visicom.
Geofence
Any geofence can be selected as district limitation. The filter by geofence is applied to found results only. This feature
is designed to exclude from search results the units which are far away from the indicated place.
Search Results
Search results are presented at the bottom of the window as a list of units. There you can see the following
information:
404
If you are not satisfied with search results, please, check your work list because the search of nearest units is
performed on the basis of units displayed on that list.
405
SMS
SMS messages can be sent to drivers, units, and to any phone number. SMS dialog is accessible in Monitoring, Units,
and Drivers panels as well as in the Tools dropdown menu. The buttons are not shown if the current user does not
have enough rights to send SMS messages. Besides, to send SMS to a unit, the user is required to have the right 'Edit
connectivity settings' to this unit.
In the dropdown list Drivers/Units select addressee. Below you will see the list of objects of the selected type, but only
objects that have a phone number in their properties. This phone number is displayed in brackets after object's name. If
a unit has two phone numbers, such unit is displayed on the list twice – with each number. To quickly find a needed
object on the list, use the dynamic filter.
On the right of the dialog, the phone number of the selected item is displayed. It is taken from the object's properties.
However, you can input any other number in international format.
As you type your message, below you can see the number of symbols used and the number of SMS messages that
will be needed to send your message. Remember that letters of the Latin alphabet are optimal.
After you have typed the text, press Send. After that, in the dialog as well as in the log there will be a record about how
successful the operation has been.
A driver can send SMS to a dispatcher from his phone. This phone number must be indicated in driver's properties.
Drivers' messages appear in the log and popup in a special window (the same as for drivers' messages sent from a
device in the form of a command). Besides, if there are unread messages, the number of them is shown in red circle
next to the chat icon in the bottom panel. To reply to an SMS, click on the SMS button against the message.
The chat of a dispatcher with a driver can be shown in a special tabled report called SMS.
406
Apps
Along with the basic features of Wialon Local, you can get access to additional applications. Those applications can be
highly customized reports, specialized tools, or just a calculator. Applications are implemented and added by the
administrator of your tracking service (More).
To open Apps window, choose a corresponding name in the top panel or click on the necessary item in the main menu
customizer. Use the dynamic filter to quickly find a necessary application.
Click on any application to open it in a separate window over Wialon Local. Windows with applications can be dragged
over the screen, resized, and collapsed. An application can be also opened in a new tab of the browser if you click on
the corresponding button at the right of application name.
407
Wialon Mobile Table of Contents
Wialon Mobile
Login
Attention! Navigation
iOS
Android 1.6+
Only native browsers can be used, and cookies should be activated in the browser.
Login
To access Wialon Mobile, enter its address in browser, e.g., http://m.wialon.com. On the
login page input your user name and password, the same as you use to login to the
system from an ordinary computer.
Enable cookies in your mobile browser. It is required for correct operation of the
program.
Navigation
Units — show the list of available units with short information on them;
Map — show units on the map (to be 'seen', unit has to have a special flag
enabled in its properties – Show on map);
Units
At the first login, no units are displayed on the list until you apply a filter.
However, further times your previous work list will be restored.
408
To add or remove units from the work list, use a filter at the top. As you type, the
work list is updated dynamically to fit your query (see dynamic filter). To display
all units, type *.
Units on the list are displayed with their names and icons. Additional information
on each unit is available as well: time, speed, and location.
Unit Properties
Show on map — if activated, unit will be seen on the map (the option
is stored only for the current user);
Watch on map — if activate, each time new message from this unit
comes, the map automatically moves to its latest location (the option
is stored only for the current user).
To return to the work list, press Back. All altered properties are saved
automatically.
Settings
409
Program settings are also divided into two tabs:
General settings:
Unit settings:
Map settings:
Show unit names — unit can be displayed on the map either as just
an icon or together with its name.
Address provider — default address provider is Gurtam Maps or WebGIS (depending on your system
configuration), however, Google Maps can be activated, too. If no address information is available, then
coordinates are shown.
Unit's tooltip:
Parameters — display values of raw parameters taken from the last message in unit's tooltip that appears
when you click on unit's icon on the map.
Sensors — display values of sensors in unit's tooltip.
To return to the work list, press Back. All altered properties are saved automatically and affect only the current user.
Map
The Map mode is designed to locate current position of units and track
them. On the map, there can be displayed only those units which have the
Show on map flag enabled in their properties.
On the map, a unit is represented with its icon and with name (if the last is
chosen in settings (the option Show unit names). Besides, it can have a tail
(red line) that shows its movements for last 5 messages (if these
movements were detected within the current session).
If you click on a unit displayed on the map, in the tooltip you can see the
detailed information about this unit.
If you move to the map from the main menu, the map is scaled in the way
to let you see all selected units. If you move to the map from unit properties,
the map is centered on this unit.
However, map zoom can be altered, and the map itself can be moved. The
scale can be changed with the help of plus/minus buttons in the top left
corner as well as with the help of scroll button. To move the map, just drag
it to the desired direction. In Apple devices, the map can be also zoomed using multitouch function. Current scale is
displayed at the bottom.
410
Tracks
A track of unit's movement can be built for any period of time. In the Map mode,
press the Tracks button on the top panel and adjust required track parameters.
Choose a unit in the dropdown list. Only units with the flag Show on map are
displayed on this list. Press the Units button above to go to the work list and set
those flags if necessary.
After adjusting all parameters, press the Execute button below. Your track will be shown on the map.
None that any number of tracks can be drawn on the map, either for different units or for one unit at different time
periods. To remove all those tracks from the map, press Clear.
Click on any point of the track to get detailed information for this point: message time, speed of movement, address (or
coordinates), satellites count.
If you click on unit icon, you will be offered two options: Remove track and Information. The first one is designed to
remove all tracks drawn on the map for this unit. The second is to see a standard tooltip with detailed information on
the unit.
Geolocation
Geolocation is activated in settings. Note that you may need to additionally check
browser settings.
When you switch to the map mode, the program essays to locate you. Your
supposed position will be indicated on the map with a special marker. In addition,
the button I`m here will appear on the screen. Click on this button at any time to
move the map to your current location. Click on this marker to see available address
information.
In case geolocation is not successful, an error is displayed and the corresponding marker and button are not shown.
Note.
Google Maps are activated separately and can be missing in your package.
411
ActiveX
Attention!
This module is licensed separately.
412
SDK
SDK is a software development kit that allows for the creation of additional applications and sites for Wialon Local
platform. It provides an API (application programming interface) as a source code based specification intended to be
used as an interface by software components to communicate with each other. All documentation available at
http://sdk.wialon.com
Remote API gives access to data through low-level HTTP (hypertext transfer protocol) requests. Using it,
you can develop your own web services, mobile device applications, etc. on Wialon basis.
JavaScript API gives you access to Wialon Local functions from your web application using JavaScript.
IT considerable decreases time of creation a web application because basic procedures have been already
implemented.
413