Wialon Hosting User Guide
Below you will find brief information for Wialon Hosting. Wialon Hosting is a software product that allows end users to control their units (vehicle fleet, machinery, employees, pets, etc.). You can detect unit position and watch its movements on map; observe dynamic change of various unit parameters such as speed, fuel level, temperature, voltage, etc.; manage units (sending commands and messages, assigning jobs and routes, adjusting notifications, etc.) and drivers (phone calls, SMS, work shifts); control of unit movement along a route with check points; interpret information derived from the unit in various kinds of reports (tables, charts); and much more.
Advertisement
Advertisement
Wialon Hosting
User Guide
as of 2016.12.29
Table of Contents
Basic Definitions
System Requirements and Optimization
Hardware Enabling
Management System
Managing Wialon Service: First Steps
Service Structure
Access Rights
CMS Interface
Accounts
Transferring Units from One Account into Another
Billing Plans
Users
Units
Sensors
1
Unit Groups
Trash
Retranslators
Import and Export
Measurement System And Conversion
Service Hierarchy
Activation of Modules
Apps
Cartography
Monitoring System
Quick Start
User Interface
User Settings
Monitoring
Tracks
2
Messages
Reports
Query and View Reports
Report Templates
Tables
3
Charts
Map Output
Statistics
Advanced Reports
Data in Reports
Fuel
Geofences
Routes
Drivers
Trailers
Binding and Unbinding Trailers
Passengers
Binding and Unbinding Passengers
Jobs
4
Notifications
Users
Units
Tools
Apps
Manage Applications
Wialon on Mobile
Wialon Mobile Client
Wialon Mobile v1
ActiveX
Wialon Mobile v2
SDK
Frequently Asked Questions
Reports
Calculating Fuel: Time-Based or Trip-Based
Incorrect Intervals of Engine Hours
GPS Hardware
Maps
5
Google and Yandex Addresses in Reports
Placing New Maps on Wialon Hosting
Other Questions
%ZONE% instead of Geofence Name
Cannot Remove Access to a Unit
Error 'Your browser does not support cookies'
Problem Logging In Because of a Supposed Attack
Tracks with 'Stars' at Parkings
Unit Disappear from the Monitoring List
Violations Are Not Registered
Wialon Hosting Design
6
Basic Definitions
GPS tracking system Wialon Hosting
is a software product that allows end users to control their units (vehicle fleet, machinery, employees, pets, etc.).
Unit tracking includes: detecting unit position and watching its movements on map; 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, work shifts); control of unit movement along a route with check points; interpreting information derived from the unit in various kinds of reports (tables, charts); and much more.
Tracking results can be presented on the computer screen as well as exported to files in different formats.
Main Interface
Wialon Hosting main interface is an interface where end users watch their units and create and configure diverse system micro objects for tracking purposes:
geofences
jobs
notifications
drivers
trailers
passengers
report templates
These items cannot exist independently and are a part of some
The detailed description of Wialon Hosting user interface can be found in the section of this guide entitled
CMS Manager
CMS Manager is a special interface developed for Wialon Hosting 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
Macro objects are different from micro objects in several ways:
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 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.
7
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.
Some macro objects like retranslators, billing plans, and accounts (resources) 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.
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 Hosting. 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 «
8
System Requirements and Optimization
Consider these requirements to get the most from Wialon.
Web Browser
Supported browsers are:
Google Chrome 49+
Mozilla Firefox 45+
Opera 36+
Internet Explorer 11 (EDGE)
Besides, if you use Windows OS, you can install a special application Wialon GPS Tracking , which allows using the tracking system without any browsers. You can create a shortcut on the desktop, remember user name and password, etc.
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.
Considering all above mentioned, the minimum requirements are:
CPU at 1,6 Hz clock rate;
512 MB of RAM.
and recommended requirements:
CPU at 2,4 Hz clock rate
(if Google Chrome is used as web browser, a processor with two and more cores is recommended);
2 GB of RAM.
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.
9
1. Web Browser
Web browser is very important. See the
list of supported browsers above. The most efficient is Google Chrome. It is
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.
2. Graphics & Tooltips
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
in the section
'Unit visualization on map'.
Unit's tooltip contents are also important. In
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.
If Internet connection is slow, disable geofences' rendering on map. Besides, if you query reports (containing map), messages, and tracks, clear your request as soon as it is no longer useful.
3. Queries to Server
When Wialon 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.
Limitations
Limits for logins and sessions:
No more than 10 unsuccessful logins from one IP address per minute;
No more than 120 successful logins from one IP address per minute;
No more than 100 active sessions of one user from one IP address;
No more than 120 logins per minute.
If these limits are met, IP address will be temporarily blocked. It can cause difficulty to log in to the system.
Limits for messages:
No more than 15 million messages can be loaded by a user;
No more than 10 million messages can be loaded by a user within 2 minutes;
No more than 500 thousand messages can be imported per minute.
If these limits are met, messages stop being loaded or imported. It may cause difficulties in executing reports, building tracks, etc. If this happens, you can clear the panels Tracks, Messages, and Reports (or simply reload the page) and try again.
Limits for reports:
Online execution of a report takes up to 2 minutes;
Report execution on jobs takes up to 10 minutes;
Report execution on notifications takes up to 5 minutes.
When the timeout is exceeded, report execution will be aborted. That means the report will not be generated. In this
10
case, diminish time interval, number of analyzed objects, or scope of requested data (tables, charts, etc.).
Other limitations:
No more than 3 heavy requests (e.g., message loading, report execution, etc.) can be processed simultaneously in a session;
No more than 10 API requests can be processed simultaneously during one session;
No more than 3 map tracings can be processed simultaneously during one session;
No more than 10 'avl_evts' requests can be processed during 10 seconds.
11
Hardware Enabling
Tracking is fulfilled with the help of GPS and GLONASS devices as well as special software with similar features.
Hardware Adjustment
Data from devices should be sent to the server of Wialon Hosting. Frequency of data collection and sending as well as parameters contained inside and overall correctness of the data depends on how device is configured. Configuration can be done remotely or using special configuration program if device is connected to a computer. It is specified in the manual provided with the device (the manual can be obtained from the seller/manufacturer of the device).
Crucial parameters for each type of device are server IP address and port. Please visit the Hardware page on our site and find your device there. The port is indicated on the 'Specification' tab. If IP address is not mentioned, use the general IP — 193.193.165.165.
In some cases devices or their software are already set to work with Wialon and don't need additional configuration.
Wialon Hosting Adjustment
If a device is set up properly and its data is coming to Wialon, then create a unit for it in the system to see it on the map. When creating the unit, pay attention to the following mandatory parameters: name (any custom text), device type (choose in the dropdown list or enter from the keyboard), unique ID (device identification number), telephone number of the SIM card used in this device in the international format.
The access password should be specified only if the device enciphers data to be transmitted.
12
Management System
The management of GPS tracking system Wialon is fulfilled through a special interface — CMS Manager. It is specially designed for Wialon managers. CMS Manager allows you to manage your tracking service by means of system macro objects, which are accounts, billing plans, users, units, retranslators, and others.
For further information, please see:
Managing Wialon Service: First Steps
Service Structure
Access Rights
CMS Interface
Accounts
Billing Plans
Users
Units
Unit Groups
Trash
Retranslators
Import and Export
Measurement System And Conversion
Service Hierarchy
Activation of Modules
Apps
Cartography
13
Managing Wialon Service: First Steps
The correct organization of accounts, sub-accounts, and billing plans from the very start can, to a great degree, determine the easiness with which your team members and customers will manage Wialon service. Our downloadable pdf manual will help you in setting Wialon service hierarchy.
14
Service Structure
Effectiveness of the service management depends on the account structure created by you. Perfect structure has a clear hierarchy. Below there are recommendations necessary to help you clarify accounts’ hierarchy peculiarities.
Understanding of such peculiarities will help you to build a proper service structure meeting the needs of your business.
When creating the structure, it is important to understand the following rule: an item cannot have more privileges, possibilities, or rights then its superior item has. This is true for services in accounts, for access rights, etc.
First Log in to the System
Upon the first logging in to the system (CMS Manager) such elements as account, user, and appointed billing plan are available to the service owner. These elements have an identical name. Further, the account will be discussed in depth.
System Account
Top_account
(individual name for every client) is an account of the top level. It is created automatically upon new service activation. Top account for every client is created with its own individual name, serving as a global identifier of a service in Wialon Hosting. Billing plan name is the same as an account name. This billing plan has all the available functionality by default. Top account is considered to be a system one that is why a service owner does not have access rights either for its editing or for the editing of its billing plan.
Therefore, the first obligatory step for the Top_account user is creation of a managing account.
Creating Accounts
Manager
is an account which should be created for the service management. It is created from the top level account.
Access rights and available capabilities of the Manager user can be restricted by the Top_account user only. This account is considered to be a starting point for the creation of the proper accounts structure. Due to its high place in the hierarchy the Manager user can create new accounts as well as manage them (changing access rights, payment control, blocking, etc.). This account receives the same billing plan as the Top_account. All the necessary billing plan restrictions can be added in the account properties.
The next step for the Manager user is to make estimations on the number of end customers. Depending on the result of the estimation, the corresponding account should be chosen and created (Customer_Service or
Major_Customer_Service).
Customer_Service
is an account which should be created for managing users with a small number of units
15
(End_Customer_1,2,3). Such an account can be utilized in the sphere of personal tracking or private vehicle tracking.
Set of functionality for a user of this account includes creating, changing, controlling, and providing technical support for users/accounts belonging to this account. Process of account capabilities configuration for every end user (manual enabling of the available functionality) could be rather time-consuming. Therefore, in order to automate this process, a set of ready-to-use billing plans (for example, Beginner, Advanced, Pre-Major) can be created in Customer_Service account. Note that these billing plans should be paid individually. Service charges are varied depending on the available functionality of the created billing plans.
Perfect structure implies an individual account for every end user, as well as creating units with necessary restrictions inside the own account (restriction on deleting a unit and its messages is considered to be a minimum required restriction).
Major_Customer_Service
is an account for managing major clients with dozens/hundreds units
(Major_Customer_1,2,3). Such an account provides a possibility to activate individual special billing plan either for all major customers (Major_Customer_1,2,3) or for every customer individually. Major_Customer_Service can provide with a developed hierarchy of subordinate accounts similarly to the structure of the whole service.
Besides, there is one more account to be spoken about (see below).
Dealer_1
is an account which should be created for a dealer. Dealer user possesses high degree of independence, its own customer support service, and also maximum of the available functionality. Dealer subordinate accounts structure can be created similar to the whole service structure.
16
Access Rights
Access Control List, or ACL.
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.
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:
View item and its basic properties
View detailed item properties
Manage access to this item
Delete item
Rename item
View customs fields
Manage custom fields
View admin fields
Manage admin fields
Edit not mentioned properties
Change icon
Query messages or reports
Edit ACL propagated items
Manage item log
View and download files
Upload and delete files
See more about standard rights...
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:
On the 'Access' tab of every item, all rights are divided into two sections. The left section displays standard rights, and it is the same for any object. The contents of the right section depend on item type as it represents special rights.
Hierarchy
17
It is important to maintain the hierarchy when assigning rights:
level.
It is impossible to give a user more rights on an item, than the creator of this user has towards this item.
If a user is allowed to define rights for other users, no more rights than this user has can be given.
18
Standard Rights (Item ACL)
There are 16 standard rights, i.e., rights that every macro object has.
Type of right
Code Description
View item and its basic properties
0х1
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 changed without additional rights. This right is basic, no other rights have any sense without it.
This access right is often referred to as 'minimum access' or 'view right'.
Units: to see counters, sensors, some advanced properties (color schemes for sensors and tracks), drivers, current location on map, to control unit groups.
User: the 'General' tab with all its contents and the 'Advanced' tab (access to Wialon Mobile v1 and e-mail).
View detailed item properties
Manage access to the item
0х2
0х4
Allows viewing more properties of the item. It influences either units (viewing 'Trip Detection' and
'Fuel Consumption' tabs) or accounts (the contents of the 'General' tab in the account properties dialog are added by two additional sections, as well as 'Services' and 'Restrictions' tabs appear in this dialog; 'Account' tab is added in the user settings dialog. )
Allows transferring rights on this item to other users, i.e., the 'Access' tab becomes available in the item properties where user can establish which actions are allowed to other users in relation to this 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 item
0х10 Allows renaming the item.
View custom fields
Manage custom fields
0х20
0х40
The 'Custom fields' tab becomes available for viewing in the properties of an object (unit, unit group, user, resource). Moreover, the 'Characteristics' tab also becomes available for viewing in the properties of a unit. Both 'View custom fields' right and the next one ('Manage custom fields') influence the above mentioned objects (units, unit groups, users, resources).
Allows creating, deleting, and changing custom fields in unit/group/user/resource properties, as well as editing contents of a 'Characteristics' tab in unit properties. This right is valid only together with the previous one.
View admin fields
0х1000
Allows user to view custom fields with limited access (admin fields) on the 'Custom Fields' tab of unit/group/user/resource properties.
Manage admin fields
0х2000 Allows user to create, delete, and edit admin fields.
Edit not mentioned properties
Change icon
Query reports or messages
0х80
0х100
0х200
Allows editing some advanced item properties. This right is applicable only to units – i.e., gives the opportunity to edit color schemes for track/sensor on the 'Advanced' tab, or enable icon rotation on the 'Icon' tab.
Allows changing item's icon. It is valid only for units and unit groups, because other items do not have such feature as an icon.
You can query messages and create reports for given item.
Units: it allows user to view messages for the selected interval, query reports, and build tracks in all modes.
User: the tab 'Logs' provides access to viewing the user activity (logins, logouts) and advanced reports of users.
Resource: it allows using the 'Statistics' tab (history of payments).
Edit ACL
19
propagated items
0х400 Only for unit groups.
Manage log
0х800 Allows seeing item log in reports (or messages).
View and download
0х4000 Allows a user to use file server for viewing and downloading files for the chosen item.
files
Upload and delete
0х8000 Allows a user to use file server for uploading and deleting files the chosen item.
files
If a user has rights to see a unit's creator and account, its groups, assigned driver, etc., these rights can be fully sensible only if this user has also at least view access to those items (user-creator, account, group, driver).
See also:
20
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.
for units:
Edit connectivity settings
Create, edit, and delete sensors
Edit counters
Delete messages
Unit ACL
Allows user to see and edit device type, unique ID, phone number(s), device access password on the
'General' tab, and messages filtration parameters on the 'Advanced' tab. Device type, phone(s), and
UID appear also in unit's tooltip and in extended unit information. If SMS service is activated, then the user can also send SMS messages to this unit.
Sensors and their values are available without any particular rights, however, this access flag allows to edit and delete them as well as create new. Besides, calculation tables of created sensors become available for editing.
Allows changing values of the counters (GPRS traffic, mileage, engine hours) and methods of their operation.
Allows deleting data messages and messages about sent commands in the Messages panel. It also allows deleting records from the log (if the 'Manage log' flag is enabled). Works only in combination with 'Query messages or reports'.
Execute commands
Allows executing commands over the unit (for example, sending them from the Monitoring panel).
Manage events
View service intervals
Allows user to register such events as fuel fillings, maintenance work, custom event, and unit status. A special registrar in the Monitoring panel is used for that. Having such flag activated user can also delete registered events. If the flag 'Manage log' is enabled, user can also add a record to a unit log.
Allows viewing the 'Service Intervals' tab in unit properties dialog as well as viewing maintenance state in unit's tooltip and in extended unit information.
Create, edit, and delete service intervals
Allows user to edit and delete service intervals as well as create new. Works only in combination with the previous flag.
Import messages
Export messages
Allows importing messages to a unit database. Works only in combination with 'Query messages or reports'.
Allows exporting messages from this unit to a file. Works only in combination with 'Query messages or reports'.
View commands
Enables the 'Commands' tab in unit properties.
Create, edit, and delete commands
Allows to create, edit, and delete command on that tab. Works only in combination with the previous flag.
Edit trip detector and fuel consumption
Use unit in jobs, notifications, routes, retranslators
Allows editing such tabs as 'Trip Detection', 'Fuel Consumption', 'Eco Driving', and report parameters on the Advanced' tab. Works only in combination with 'View detailed item properties'.
Allows user to create jobs and notifications for this unit, assign it to routes, and use it in retranslation.
21
Some details about standard rights for units:
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.
View item detailed properties
The user can see properties applied to reports: the 'Trip Detection' and 'Fuel Consumption' tabs, reports parameters and messages filtration settings on the 'Advanced' tab. Editing these things is not allowed, neither is report execution.
Edit not mentioned properties
These properties are color schemes for sensors and tracks on the 'Advanced' tab.
Query messages or reports
Allows to view messages for the selected interval (except for the log), query reports (except for the tables 'Log' and
'Custom Fields' which require additional rights), and build tracks.
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', 'View and download files', 'Upload and delete files') work as has been described above. The flag 'Edit ACL propagated items' does not affect units at all.
22
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:
View item and its basic properties
Manage access to this item
Delete item
Rename item
View custom fields
Manage custom fields
View admin fields
Manage admin fields
Change icon
Query reports or messages
Manage item log
View and download files
Upload and delete files
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
23
User ACL
Users can receive rights on any system objects including other users. Put it differently, user can 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
Some of the standard access rights are applicable to users:
View item and its basic properties
User appears in various panels and lists. The 'General' tab with all its contents and the 'Advanced' tab
(access to Wialon Mobile v1 and e-mail) are available in the User Properties dialog (only view). User name can be displayed in different reports and in 'Creator' field.
Manage access to this item
User appears on the 'Access' tab of the User Properties dialog of other users, where access to this user
(as system object) can be adjusted.
Edit not mentioned properties
Allows to edit the 'Advanced' tab in the User Properties dialog and change individual user settings as well as send notices to this user from CMS Manager.
Query reports or messages
Enable the 'Logs' tab in the User Properties dialog — there you can observe user's activity (logins, logouts to different services of the system). This flag also gives permission to generate report about this user.
Note that to query the 'Custom fields' report, one needs to have access to custom fields of this user. And one more report — 'Log' — can be executed in case one has 'Manage item log' access right in addition.
Standard flags Delete item, Rename item, View custom fields, Edit custom fields, View admin fields, Manage
admin fields
, Manage item log, View and download files, and Upload and delete files work for users as described
Access rights such as 'View detailed item properties', 'Change icon', and 'Edit ACL propagated items' do not affect users at all.
Special Rights
Special rights that can be applied to users:
User ACL
Manage user's access rights
In the User Properties dialog, the 'Access' tab becomes available where the user can be given rights to various system objects. Besides, user's rights can be changed automatically – through appropriate jobs and notifications.
Act as given
Right to log in to the system as given user, make this user creator of system objects, etc.
user
Change flags for given user
Allows changing properties on the 'General' tab of the User Properties dialog. However, changing password requires also the previous right.
24
Resource ACL
Access to a resource means access to its contents such as geofences, jobs, 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.
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
The following standard (Item ACL) rights can be applied to resources/accounts:
View item and its basic properties
Allows to see whether system objects like units, users, units groups belong to this account. It is usually written on the first tab of their properties dialog.
View detailed item properties
Makes sense for account only. The second and third sections of the Account Properties dialog become visible as well as the tabs 'Services' and 'Restrictions'. If the end user gets this right to their own account, they can see the 'Account' tab in User Settings (it gives information on used and available services, account's balance, etc.
Delete item
Allows deleting resource with all its contents. However, to delete an account, you should additionally have the flag 'Manage account'.
Query reports or messages
For resources, this flag allows to generate the 'Log' table and see how different users created, edited, and deleted resource's contents (at that, the flag 'Manage item log' is required). This access flag allows also user to generate reports on drivers and trailers as well as driver and trailer groups if they belong to this resource. For accounts, this flag gives possibility to see the 'Statistics' tab (history of payments and withdrawals) but only if you have the flag 'View detailed item properties', too. The similar sub-tab appears on the 'Account' tab of the Account Properties dialog.
Standard access rights Manage access to this item, Rename item, View custom fields, Edit custom fields, View
admin fields
, Edit admin fields, Manage item log, View and download files, Upload and delete files work for resources/accounts as described
Such flags as 'Edit not mentioned properties', 'Change icon', and 'Edit ACL propagated items' do not affect resources or accounts at all.
Special Rights
The following special rights can be applied to resources/accounts:
Resource ACL
View geofences
Allows to view geofences belonging to this resource.
Create, edit, and delete geofences
Allows to edit and delete geofences belonging to this resource as well as create new.
View jobs
Allows to view jobs belonging to this resource.
25
Create, edit, and delete jobs
Allows to edit and delete jobs belonging to this resource as well as create new.
View notifications
Allows to view notifications belonging to this resource.
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 and driver groups belonging to this resource. Moreover, allows to view the drivers' automatic binding list.
Create, edit, and delete drivers
Allows to edit and delete drivers and driver groups belonging to this resource as well as create new.
Moreover, allows to create and edit drivers' automatic binding list.
View passengers
Allows to view passengers belonging to this resource. Moreover, allows to view the passengers' automatic binding list.
Create, edit, and delete passengers
Allows to edit and delete passengers belonging to this resource as well as create new. Moreover, allows to create and edit passengers' automatic binding list.
View trailers
Allows to view trailers and trailer groups belonging to this resource. Moreover, allows to view the trailers' automatic binding list.
Create, edit, and delete trailers
Allows to edit and delete trailers and trailer groups belonging to this resource as well as create new.
Moreover, allows to create and edit trailers' automatic binding list.
View report templates
Allows to view report templates belonging to this resource.
Create, edit, and delete
Allows to edit and delete report templates belonging to this resource as well as create new.
report templates
Manage account
For accounts only. Combined with the flag 'Delete item', allows to delete an account from the system completely, including resource with its contents, account's creator and all objects created by this user.
In combination with the flag 'View detailed item properties', gives possibility to control billing plan and payment (the 'General' tab), number and cost of services (the 'Services' tab), and some other parameters (the 'Restrictions' tab).
View orders
Allows to view orders belonging to this resource.
Create, edit, and delete orders
Allows to edit and delete orders belonging to this resource as well as create new.
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, tariffication, etc.) can be performed only in CMS Manager.
26
Route ACL
Route access rights could be the following:
View item and its basic properties
Having this right indicated allows a user to see the route in the 'Routes' panel.
Manage access to this item
When this right is indicated, a user can transfer the right to the routes on other users. Moreover, this right allows a user to see the route not only in the panel but also on the map. A user is enabled to edit the route
(add, delete check points, and change their radius), add schedules, show list of rounds for the route, and copy the route.
Delete item
Allows deleting a route.
Rename item
Allows renaming a route.
Query reports or messages
Allows a user to receive reports containing data for the available route.
27
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.
28
Access Dialog
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
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:
There are 2 columns of flags in each section of the access rights. The first one (direct rights) is used to enable/disable rights. The second one (combined rights) is used to show the rights currently possessed by a user (the column is for
29
viewing only).
There may be a case when direct rights are enabled but not applied to a chosen user. The case occurs when users superior to the chosen one do not possess these rights (hierarchy restriction). Such a restriction may be shown by the absence of flags in the second column.
Dealing with units there can be a reversed situation — direct rights are disabled while combined ones enabled. This means a unit is included into a group towards which a user possesses more rights then towards a unit itself. Therefore until a unit belongs to this group, a user will possess the same rights for this unit as for the group.
Here are some principles to bear in mind when assigning access:
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.
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.
When finished, click OK to apply new rights.
Access Rights Templates
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 an object (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 cannot 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 cannot 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 cannot be completely applied
(when the 'distributing' user does not have the rights which he is going to pass to the others). Moreover, the yellow is applied to users possessing combined rights but lacking direct ones.
Attention!
).
Hint.
30
User's access to units can be changed not only manually but also automatically — through some types of
.
31
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.
The work area can be divided into several sections:
Top panel
is situated at the top of the window. It shows your login, current time, and some buttons
(Logout,
Import/Export , English/Russian, 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:
,
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.
32
Top Panel
There is a logo of CMS Manager system in the left corner of a top panel. The right side of the top panel contains the following elements: number of days till account blocking (displayed in green, though to be turned red when the number of days left reaches 0);
'
Apps ' button — opens the list of available applications;
current time (time zone in brackets); login (right corner) — a name used to enter the management system (another login can be displayed in brackets if the main user is
If a current time is displayed in red, then server connection loss has occurred. It may be caused by internet connection failure, or by some internal service problems.
Note.
Top users have the number of available SMS indicated in this panel. Moreover, such information as number of units left before reaching the limit can be displayed for top users in this panel as well.
User menu
User login is displayed in the right corner of the top panel. Click it in order the additional menu to be opened. The menu contains the following items:
User Settings
Opens the
dialog for viewing and/or editing.
Import/Export
Can be used to transfer the settings of units, users, as well as the
contents of resources (ref. Import and Export ).
Manage Applications
Allows you to view and edit the list of authorized applications , and mobile notifications .
Service Hierarchy
Allows you to view information on the service structure
.
Help
Help request. Could be unavailable.
Logout
Button to log out of the system (session termination).
Note.
Additional menu items are available for top users:
Activate Modules — to enable additional modules or packages;
Conversion — enables transferring some objects from one measurement system to another;
— enables adding applications, and adjusting their settings.
Login as Another User
It is possible to login to the system as another user. To do so, you need to possess the 'Act as given user' right towards a user.
To switch for another user (log in as another user), it is necessary to click on
33
the icon (door with arrow) situated in the top panel to the right of the username. Afterwards the dialog containing the list of available units is opened. You can use
filter in order to facilitate a search of a unit. The search
is made either by unit name or account name. Click the line of a necessary user to fulfill an authorization in the current tab, or click an icon in the end of the line to do it in a new tab.
There is also an alternative way to log in as another user. Go to the 'Users' tab in the
. In the table of results click on the 'Login as' icon in the corresponding line.
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 icon (door with arrow) to the right of the name, and confirm your action by pressing OK in appeared window.
Information notices
left before blocking the tracking system (if stipulated by the tariff agreement). Information notices are shown in the window with a blue outline. For alarm notices a red outline is used.
34
Navigation and Search
Navigation and search panel is situated on the left of the window. Here you form a query for items to be displayed in the
Navigation
There are several 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
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' field choose the criterion on the basis of which a search is made. It can be:
Name
: the name given to the object when it was created;
Creator
: the
Account
: account to which required object is attached.
Individual filters for accounts:
Parent account
: search by an account from under which an object have been created;
Billing plan
: search by a billing plan used;
Blocked accounts
: search is implemented among blocked accounts;
Custom fields
: custom fields configured in unit properties;
Admin fields
: administrative fields configured in unit properties.
Individual filters for resources:
Custom fields
: custom fields configured in unit properties;
Admin fields
: administrative fields configured in unit properties.
Individual filters for users:
35
Billing plan
: search by a billing plan used;
Custom fields
: custom fields configured in unit properties;
Admin fields
: administrative fields configured in unit properties.
Individual filters for units:
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;
Profile fields
: profile fields configured in unit properties.
Individual filters for unit groups:
Custom fields
: custom fields configured in unit properties;
Admin fields
: administrative fields configured in unit properties.
Individual filters for retranslators:
Protocol
: search by the used protocols;
Server
: search by server name;
Unit name
: search by unit name;
Started
: search by started retranslators.
If any of these properties is not available to you according to your access rights, searching by this criteria will be unsuccessful.
Search Text
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 click 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. The request is not case sensitive.
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.
Comma sign (,) can be applied to string together several requests. For instance, you would like to find all MANs and all Ivecos. In this case, type *man*,*iveco*.
36
Results Panel
The results panel is located at the right top part of the window. Here the results of
It is possible to create up to five tabs in the results panel. To create a new tab, press on an inactive 'New' tab that is situated on the right of all created tabs. To navigate between tabs, just click on a needed one. To close a tab, press on a red cross near its name.
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. To sort the data by any other criterion presented in the table, it is necessary to click on the corresponding name of the table. Note that the sorting by a criterion is available if the mouse cursor changes its shape for a pointer.
Table contents, and number of columns, correspondingly, depend on the type of objects displayed. For example, accounts table contains the biggest number of columns.
The set of columns can be adjusted according to your needs. To do so, click on the last column in a table header
(arrow down). Afterwards, in the appeared menu select the flags for the necessary columns, or deselect them for the columns which are not currently needed.
At the bottom of the table, there is tools panel that can be used to perform several tasks such as deleting items, moving to another page, etc. Moreover, working with such system elements as accounts (resources), users, units, and unit groups, there is a possibility to save table data in Excel format. To do so, click on the corresponding icon in the right corner of the tools panel.
Columns width can be adjusted manually. To do this, click and drag a column edge 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, 20, 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.
37
Standard Operations
Usually, a number of standard actions can be performed over any object displayed in the table (
,
retranslators ): create a new item of this kind (except billing plans), view or edit objects'
properties, copy or delete an object.
Creating New Items
To create a new object, open the corresponding panel on the left and press the 'Create…' button. The button is 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
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. Units, users, unit groups, retranslators, and billing plans can be copied (but not accounts/resources).
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
). However, the very tab which represents access rights cannot be copied. You can alter any properties if needed, e.g., unique information like name, phone number, etc. Then press OK to complete creation.
Hint.
In many situations, instead of copying you can use '
View and Edit
To view or change item's properties, click on it in the table. A dialog with its properties will open. If you have not enough
and even the whole tabs can be hidden.
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 'Select' column. To select all the items at once, press <ctrl> on the keyboard and put any flag in the corresponding 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
Remember that a certain
right is needed to delete items ('Delete items'). Items that are not allowed to be deleted
cannot be checked.
You should know some particularities of deleting different types of objects:
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.
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.
Note that top users have an opportunity to
38
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.
39
CMS Settings
parameters.
The 'User Settings' dialog contains two tabs:
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.
Moreover, the 'User Settings' dialog of a top user contains a 'Branches' tab. This tab provides a possibility to choose branches for user's DNS available:
Stable
: stable branch, rarely added with updates.
Beta
: a branch containing the latest updates developed for the monitoring system. This branch is intended for the analysis of Wialon Hosting updates.
Stable/Beta
: choose the option in order the users utilizing this DNS to be able to switch between branches on the login page of the monitoring system.
The User Settings dialog in CMS Manager is a reduced version of the
User Settings dialog in the main interface.
40
Accounts
In most cases, resource and account can be used as synonymous 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,
,
,
report templates . Availability of a resource gives user an opportunity to
create such objects. These contents can be easily saved to a file or copied to another resource (see
A distinctive characteristic of an account is considered to be a billing plan
usage. An account may contain more than one resource (or even dependent 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, such as
,
,
routes as well as other dependent resources and accounts.
The count of both macro and micro objects is supported in the account and money is written off for their usage. A billing plan is applied to an account and not to a user. Therefore, Wialon manager uses account to limit users' activity, define number and cost of available services, control payment, etc.
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 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...
Transferring Units from One Account into Another
41
Working with Accounts
Working with accounts is possible only in CMS Manager . Click on 'Accounts' in the
navigation panel . Here you can:
new accounts and resources; find and display existent accounts and resources;
, add payment and days; allow/deny/limit access to different
edit and
delete accounts and resources;
of resources;
of accounts.
On the 'Accounts' tab of the
navigation panel you can create new account/resource, or find it among the created ones.
This tab contains a switcher which allows displaying either accounts (default position) or resources. To refresh table data after changing position of the switcher, click 'Search'.
(apart from name and creator) parent account,
billing plan , dealer rights, number of units in the account (including units
from subsidiary accounts), balance, days left (see estimated blocking date in the tooltip), status (active or blocked), date of blocking (if blocked), buttons to query a report on contents, and buttons for deletion. Note that accounts and resources differ by the way of their
If blocking by days is activated in the account, then the amount of days left will be shown in the table of results with the black color. If the same is activated in the billing plan, then gray color will be used. If blocking by days is disabled, nothing is displayed in this column.
To open the properties of an account or resource, click on its row in the table. Depending on the level of
possessed, certain tabs and fields of the dialog may be unavailable for editing or hidden at all. The Resource
Properties dialog can contain up to 3 tabs — 'General', 'Access', and 'Custom Fields'. Meanwhile, the
dialog can contain up to 6 tabs. The 'General' tab is available in all cases.
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.
42
Creating Accounts
Accounts can be either created or deleted in the interface of
only. To create a new account, click the
corresponding button on the 'Accounts' tab of the navigation panel .
Further there is a list of parameters used upon account creation.
Account name
Enter a unique name from 4 to 50 characters. In the system, there can be no accounts with the same name.
Create as
A
New user
A new user will be created and assigned as creator. Enter login name for a new user. Primarily, account's name is offered as login name but you can enter any other name as well. Then choose a password and confirm it. You can also specify a creator for a new user if you do not want it to be a current user. Similar situation with a measurement system — normally, it is inherited from a current user but you can readjust it here. Note that if a creator of a new user cannot distribute billing plans (account is not a
the billing plans section becomes disabled.
Existent user
In the dropdown list, choose a user. Note that the user which appears to be a creator of system macro objects cannot become a creator of new accounts as such an operation violates current hierarchy.
However, such a user can
. When an account is created by an existent user, its measurement system is taken from its creator. However, it can be changed afterwards through the
Billing plan
Billing plan usage is considered to be a distinctive characteristic of an account. Select an available
for the account from the dropdown list. If there are no billing plans available, then account cannot be created.
When all the fields are set correctly, click OK and check a result in the
log . Depending on parameters chosen before, a
new account or a new account and a user is created. Account creator automatically receives full
towards created objects.
43
Creating Resources
Resources can be either created or deleted in the interface of CMS Manager
only. To create a new resource, click the
corresponding button on the 'Accounts' tab of the navigation panel .
Further there is a list of parameters used upon resource creation.
Name
Enter a unique name from 4 to 50 characters. In the system, there can be no resources with the same name.
Creator
Choose a creator for a new resource.
Account
Here it is shown an account to which a created resource belongs. In other words, this is a creator's account.
Note that a measurement system is taken from its creator by default. However, it can be changed afterwards through the
When all the fields are set correctly, click OK and check a result in the
log . A resource is created. Resource creator
automatically receives full
access rights towards created objects.
44
Account Properties
Account Properties dialog can contain up to 6 tabs. Their availability depends on
General
The 'General' tab has 3 sections. However, only the first of them is available to users with minimum access. This section holds account's name, information about creator, account, and parent account.
The second and third sections are designed mainly to add payment and block/unblock account.
The second section lists
, current balance, blocking limits, and account's status: active or blocked.
The row 'Balance' shows current monetary balance as well as days left (if the option 'Block by days' is enabled on the
This is just a reminder of these limits; they can be modified on the same Restrictions tab.
If account is blocked, the flag 'Blocked' is checked and the date when it happened is shown in addition. If account is active, the flag is unchecked and the date of estimated blocking is displayed (only if the option 'Block by days' is enabled for the account). You can change this flag's position manually. This may prove useful, for instance, to promptly unblock an account when required payment arrived. This flag can be also applied to manually block an account, however, this strategy will work correctly only if money/days balance if zero or negative. Note that to alter this flag's position, there is no need to open the dialog at all — it can be done in the list of accounts itself, in the Status column.
Adding payment and days is available in the third section of the 'General' tab.
To register a payment, enter sum and comment (comment is mandatory) and click on 'Register'. The sum will be added to the current balance, and the payment will be saved in payment history (see the
If the option 'Block by days' is enabled, the field to amend days will be available as well. Days are added in the same manner as payment. Indicate the needed number of days or choose the final day in the calendar (the button on the right). Then enter comment and press 'Register'. Days and money can be added simultaneously in the same payment or separately from each other.
45
Services
The 'Services' tab in the Account Properties dialog allows managing the number of available units, SMS, geofences and other system objects, as well as enable or disable access to different services (such as retranslator, Wialon
Mobile, jobs, etc.) and define their cost.
The list of available services depends on billing plan and activated modules.
Services can be sorted by first and second columns, that is by name (alphabetically) or status (enabled/disabled).
Service statuses:
— service enabled
— service disabled
For enabled services, one can additionally adjust allowed number, cost, and reset interval (if necessary). To establish a simple quantitative limit on a service, just enter the necessary number in the corresponding field. For example, if you input 11 opposite 'Geofences', it will mean that only 11 geofences can be created within this account.
In some cases, reset interval should accompany quantitative limit. For example, to establish the limit of 5 SMS messages hourly. Other possible reset intervals are weekly, daily, monthly.
Together with quantitative limitations, cost can be adjusted. Cost line is set in the format:
COUNTER1:VALUE1;COUNTER2:VALUE2;VALUE3. A counter must be positive integer (but values can be fractional). Each next counter must be greater than the previous one. Here are some examples of cost lines:
Service Cost line Interpretation
SMS messages
Units
1:0;10:1.5;-1
The 1st SMS is free, from 2nd to 10th the cost for one SMS is 1.5 charge units. The
11th SMS is denied.
1:0;5:10;10:3;50:1
The first unit is free, from 2nd to 5th they will cost 10 charge units, from 6th to 10th —
3 charge units, from 11th to infinity — each for 1.
Geofences 5:0;-1 5 geofences can be created for free. The creation of a 6th geofence is prohibited.
A gray icon opposite a service means that the state of this service is taken from billing plan assigned to the account. If state or limitations have been modified at some point and thus redefined for the account individually, the button unblocks . Press it to restore default billing plan's values.
In the 'Used' column, you can see the number of objects of appropriate type, which are already in use in this account.
It concerns only countable services (such as units, drivers, etc.) and makes no sense for uncountable (such as SKD,
Eco driving, etc.).
Restrictions
46
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 specify billing plans that will be available to this account.
The next three options refer to restricting user's activity in case of nonpayment. Usually, these values are either zero or negative (to give users possibility to use the tracking system for a while even when payment date has expired). If these options are not enabled here, in this dialog, they will take over from assigned billing plan or parent account.
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
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.
If the option 'Block by days' was activated and this state was successfully saved, new fields will appear on the
tab — balance of days left, input to add days when registering payment. Days counter decreases automatically every day. At that, when 5 days are left, a special warning starts to come each time the user logs in to the system: 'Your account will be blocked. … days left.' When days are negative, another notification is displayed: “Attention! Your account will be blocked soon.”
History period
You can set history period to store data. It can be indicated either in days or months. To choose this setting, start entering the value into the field, and then pick days/months option from the appeared dropdown list. All the messages older than this term will be automatically removed from the database. The default value of history storing is taken from billing plan settings. If the history period value indicated for an account exceeds the one indicated for the billing plan assigned to this account, then time of history storing is taken from the billing plan. If the history period value is less than the one indicated for the billing plan, then the history storing period is taken from account settings. To restore the default value, enter '0'.
Statistics
On the Statistics tab you can observe all additions to the balance as well as all withdrawals. Define time interval and press 'Show'. All registered payments will appear in the table regardless whether money or days were added. All
47
payments and withdrawals will be shown in a table. Moreover, to see them separately, use a dropdown filter (in this case you should press the Show button again).
Other tabs of the 'Account' or 'Resource' Properties dialog —
— have standard contents described above.
48
List of Services
Here is the full list of services available in Wialon system.
Service
ActiveX
Admin fields
Description
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); defines cost and quantity (summarized, by objects of different types) of admin fields.
Advanced reports
Commands
Drivers
Е-mail notifications
Е-mail reports
The possibility to use advanced reports, i.e., reports on unit groups, users, drivers, trailers, as well as groups of drivers and trailers (except for the 'Log' table for users and unit groups). Works within Reports module.
Activates the corresponding tab in the Unit Properties dialog; defines the quantity (all units in sum) and cost of commands.
Activates the button to create resources and accounts on the corresponding panel (in CMS Manager only).
Create resources
Create unit groups
Activates the button to create unit groups on the corresponding panel.
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 fields
Activates the corresponding tab in the properties of unit, user or group; defines cost and quantity
(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 shown, and any mention of drivers disappears from notifications, user settings, and SMS dialog.
The possibility to send notifications by e-mail. Recommended limitation — 10 reports in an hour (not to overload the server).
Eco driving
Geofences
The possibility to send a report by e-mail (within the Jobs module). Recommended limitation — 10 reports in an hour (to avoid server overload).
Activates Eco Driving tab in the unit properties dialog, as well as same-name table in reports. Besides, this service is required for same-name app.
Activates 'Geofences' module and defines cost and quantity of geofences; if disabled, the '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 drivers
Defines quantity and cost of driver groups; works within 'Drivers' module.
Groups of geofences
Groups of trailers
Defines quantity and cost of geofence groups; works within 'Geofences' module.
Defines quantity and cost of trailer groups; works within 'Trailers' module.
Jobs
Maintenance
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
Properties dialog, maintenance can be registered in the Monitoring panel, and corresponding notifications and reports appear.
Management system
Access to CMS Manager.
Messages Access to the 'Messages' panel.
Mobile notifications
Activates the corresponding action in notifications, as well as corresponding tab in 'Manage Applications' dialog (in user menu).
49
Notices to users
Possibility to receive notices from the administrator of the service.
Notifications Activates the 'Notifications' panel and defines cost and allowed quantity of notifications.
Orders
Activates an access to the Wialon Logistics application and provides a possibility to generate corresponding reports either on units or drivers.
Passengers Activates the 'Passengers' panel and defines cost and quantity of passengers.
Quick guide Access to the 'Quick guide' tutorial.
Reports
Activates 'Reports' module and defines cost and allowed quantity of report templates; if disabled, associated jobs 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.
Retranslators
Possibility to transmit messages from units to other servers and systems; activates the corresponding panel in CMS Manager; defines allowed quantity and cost of retranslators.
Route rounds
Route schedules
Routes
SDK
Sensors
Site access
Defines the count of allowed rounds and their cost (within Routes module).
Defines the count of allowed schedules and their cost (within Routes module).
Activates Routes module — enables the 'Routes' panel and associated reports and notifications.
Remote access to the system via SDK and access to Apps.
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 v2, extra sites, etc).
SMS messages
Count and cost of SMS messages.
Tachograph Activates 'Driver activity' and 'Infringements' tables in reports on drivers.
Toll roads
Trailers
Activates the 'Toll roads mileage' and 'Toll roads cost' columns in the 'Trips' report and adds the corresponding statistics fields in the advanced settings of a report template.
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 mobile client
Wialon
Mobile
Activates access to
.
The possibility to track unit from a mobile phone (Wialon Mobile v1).
Wialon
Mobile (2)
The possibility to track unit from a mobile phone (Wialon Mobile v2).
If mobile service URL is different from m.wialon.com, it can be disabled only through the feature 'Site access'.
Note.
If you see 'Apps' in front of a service name, it means this service is an
50
Report on Account Contents
CMS Manager provides with a possibility to view a report on the contents of an account. The report is presented as a table displaying the amount of all the
macro and micro objects included into an account.
On the 'Accounts' tab in the table of results click the button in the 'Contents' column to view the report on the contents of the corresponding account.
To adjust the table, click the corresponding button (left top corner of the table), and choose the necessary columns.
The table is automatically rebuilt according to the chosen parameters. To facilitate the work with data presented in the table, you can highlight any line by clicking on it.
By default the sorting in the table is made by account name (alphabetic order). Though, data from the table can be sorted by columns (from maximum to minimum value of the column, or vice versa). To do so, click on the necessary column.
A table may contain numeric values divided by slash ('/'). It is used when any
features have been indicated. For
example, the available amount of units is 20, but only five of them are currently used. Therefore, in the table it will be displayed as 5/20.
Left bottom corner of the dialog contains information on the amount of accounts loaded and the total amount of accounts. If the total amount of accounts exceeds 100, then the data on the accounts is loaded by parts. In other words, if there are 200 accounts available, you will receive information on the first 100, then press 'Show more' link button, and receive the rest 100.
A report on account contents can be exported into CSV file. To do so, click on the 'Export' button in the bottom corner of the table.
51
Deleting Accounts/Resources
To delete an account or resource, you are required to possess appropriate level of access
to it. In most cases, accounts are deleted when service agreement is broken and a client ceases to use the system.
To delete an account
, press 'delete contents' opposite it and then confirm your intentions. When deleting an account, all its contents (geofences, drivers, trailers, passengers, jobs, notifications, report templates) is deleted, too. Besides, all users, units, unit groups, resources, routes, retranslators residing in this account and created by this account's
(or other users which were created as account's creator) will be deleted as well.
To delete a resource
, apply a standard method: choose the corresponding flag in the first column, and click delete button in the bottom of the table. Note that all the contents of a resource will be deleted along with it (geofences, drivers, trailers, passengers, jobs, notifications, report templates).
52
Restore Resource Contents
Attention!
Contents of the top account cannot be restored using the method described below.
Wialon system supports the possibility of restoring the contents of a resource. The following items are included into resource contents: geofences, drivers, trailers, jobs, notifications, and report templates. Once a day these contents are automatically copied to the server, and can be restored later. Note that groups of drivers/trailers as well as custom fields cannot be restored.
One can restore resource contents saved for the last 30 days only.
To restore resource contents, it is necessary to possess the following rights towards a resource: 'Delete item', 'Upload and delete files', 'Create, edit, and delete geofences', 'Create, edit, and delete drivers', 'Create, edit, and delete trailers',
'Create, edit, and delete jobs', 'Create, edit, and delete notifications', 'Create, edit, and delete report templates'.
The option of restoring resource contents is available in the properties dialog of a created resource. The corresponding button is situated in the bottom left corner of the dialog. Click on it to open the calendar where dates highlighted in orange have the stored contents of a resource. Choose the necessary date, and you open the dialog of
53
Transferring Units from One Account into Another
Units can be transferred from one account into another. In order this feature to be active you should possess the dealer rights for your account. The hierarchy of transferring units goes either from the account currently used to the lower standing ones or just between the lower standing ones.
Units are transferred in the management interface. To start with, go to the 'Units' tab and check the boxes for the units you would like to transfer. Then at the bottom of the table click the button which switches accounts for the units (the button is available only if you have dealer rights for the account). The 'Switch Account' dialog appears.
There are two lists available in the dialog. The left one is for units, the right one is for accounts. The left list consists of the units chosen earlier. If you possess enough rights for units, then these units are shown in the list. If there are no enough rights for a unit, then the notification appears in front of the list. The necessary rights towards a unit to possess:
Manage access to this item
Delete item
Edit connectivity settings
Delete messages
Moreover, it is necessary to possess the right 'View item and its basic properties' towards a creator of a unit.
The right list displays appropriate account to one of which units can be transferred. To transfer units into an account you should possess the right of managing this account and the right of viewing its detailed properties. Besides, this account should have a sufficient number of enabled units and should not be blocked. Moreover, you should possess the right 'Act as given user' towards the creator of the account into which the units to be transferred. Note that the creator should possess the right of viewing items and their basic properties towards the items from the left list.
The system carries out the search of accounts corresponding to the above stated criteria. All the found accounts are added to the list. If the search gives no result, then the notification of no appropriate accounts to be displayed in the right list.
To complete units transfer choose the necessary account and click OK. Upon transfer completion some parameters will be changed. For units it concerns a creator and belonging to an account, for accounts it concerns a counter of created/available units.
54
Billing Plans
Attention!
Only the top user can create and 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.
Working with Billing Plans
of the management system. Here you can create new billing plans, as well as view, edit, and delete created ones.
Note that the maximum number of billing plan is limited to twenty. The 'Create Billing Plan' button is automatically disabled upon reaching this value.
balance, block by days, and currency format.
The above mentioned criteria are described in depth in the following sections:
55
General Properties
To create a new billing plan, click on the corresponding button. In the appeared dialog it is necessary to indicate
general parameters of the billing plan. Some of them may be redefined in a particular account
separately.
Editing a list of services available to this billing plan is implemented on the '
Services ' tab in the properties dialog of a
created billing plan.
Name
Billing plan name (from 4 to 50 symbols).
E-mail address from which various system messages (notifications, reports, etc.) will be sent. Note that filling this field is obligatory in order to send jobs/notifications by e-mail. Otherwise, sending jobs/notifications by e-mail will not be fulfilled.
Most mail systems perform special checks for spam messages. They compare original IP address from which the messages goes with the MX record of the sender's domain. If MX record is not found, sending messages might be suspended, or the sender's address might be added to the 'grey list' (this eventually might lead to total denial of processing and sending messages). To avoid such situation, when you register your tracking site, make sure that the server address mx.gurtam.com is included in the MX records of your domain.
Block by balance
Enter balance reaching which the account will be blocked.
Limit by balance
Enter balance reaching which paid services along with some free services (messages, apps) 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.'
56
Note.
These three above-mentioned features can be enabled or disabled according to your needs. Usually, their values are either zero or negative. It is to give users a chance to use the tracking system for a while even when payment date is expired. Besides, these parameters can be redefined for each account individually.
Currency format
Enter currency sign before or after '%.02f'.
History period
The time period to store unit history. This time period can be entered either in days or months (choose from the dropdown list). For example, if the value is 100 days, then messages older than 100 days are automatically deleted.
This parameter can also be redefined for each account separately.
Description
Give a description (optional).
57
Services
This tab provides the list of all services possible for this billing plan, their state and cost.
differences. For example, the 'Limit' column shows the maximum allowed quantity of a service considering top account limitations.
Availability of services, their cost and allowed number can be also set (redefined) for each account separately, on the same name 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'.
58
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 interfaces where they can control their
(end users) or manage the system itself
(users-managers).
A user has
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.
(send
SMS, control user activity, etc.).
Working with Users
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
to your users.
In the
table of results , you can see user's name,
billing plan , date and time of a last visit in the
system, buttons to delete users and login as them. Availability of buttons and information depends on your
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
59
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 from 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).
60
User Properties
Availability of different tabs and parameters depends on
access you have to the user. Two tabs are available in any
case — 'General' and 'Advanced'. Furthermore, 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 required for each user. When you set a password, you are asked to input it twice — the 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
access rights. A user inherits account and billing plan from the creator. Creator is assigned when a user is being created and cannot be changed afterwards.
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
new user. For existing users, it can be changed by the
converter . Moreover, users can change a measurement system
by themselves in the monitoring system. To do so, it is necessary to summon the user settings dialog and choose a proper measurement system on the '
Can create items
61
This checkbox defines if user can or cannot create units, users, accounts, resources, unit groups, routes, and retranslators.
Can change password
If disabled, user cannot change their password used for login action.
Can send SMS
If disabled, user cannot
send SMS messages to drivers, units, and other users from Wialon main interface. SMS
buttons will be then hidden.
However, this option does not affect execution of commands via SMS channel.
Enabled
If disabled, user cannot login to any interface of the system.
Can change settings
If disabled, user cannot change their own settings (see User Settings
), however, can see them.
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
Access required: Manage user's access rights.
Here you give user
access rights to objects existing in the system:
,
and other users.
On the left, you select objects. To quickly find a needed object, use 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.
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
62
On this tab, you can activate access to
Wialon Mobile v1 for the user. Additionally, enter access key.
Then 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
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
Access rights required: Query reports or messages.
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 main interface.
63
Manage Applications
Authorized Applications
This tab contains the list of applications having any access to your account and data. To the left there is an application name, to the right you can see access rights possessed by an application towards your data or account. To block an access for the application it is necessary to delete the corresponding application from the list.
Mobile Notifications
This tab contains the list of applications which are allowed to send notifications to your mobile devices. To the left there is an application name, to the right you can see a device type. To block mobile notifications sending it is necessary to delete the corresponding application from the list.
64
Notices for Users
You can send a notice to the users of the system. To do this, click 'Send a Notice' in the 'Users' panel. This summons a dialog where you input a subject for your message and add text of any length. Either hyperlinks or e-mail addresses can be added to the text. Moreover, a text can be formatted using standard tools. Afterwards choose users to send the notice to, and decide upon life span of your message. When finished, click OK.
To send such notices to users, you are required to have the access 'Edit not mentioned properties' towards 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 in the list, use the dynamic filter above the list. Users can be searched by different criteria: name, creator, account, billing plan, custom fields, and admin fields.
Sent notices are shown to a corresponding user in the popup window (in both systems:
).
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.
65
Units
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 interface. To work with units in CMS
Manager, open the Units tab in the
navigation panel . Units configured here become available for
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
for details. Besides, you can transfer units from one account
into another.
Moreover, there is a possibility to create units with settings improrted
from WLP files. To do so, click the 'Create from
WLP' button. Choose a file, indicate the necessary parameters, and click 'Next'. Afterwards, a unit with the indicated parameters is created, and a
of the created unit is opened.
Unit Properties Dialog
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
Use the following links to get to know the details about each parameter:
Sensors
66
Restore Properties/Export to File
The option of restoring unit properties, or exporting them to file, is available in the unit properties dialog of a created unit. The corresponding buttons are situated in the bottom left corner of the dialog.
Restore Properties
To restore unit properties, it is necessary to possess the following rights:
'Delete item', 'Rename item', 'Manage custom fields', 'Edit not mentioned properties', 'Manage admin fields', 'Upload and delete files', 'Create, edit, and delete report templates' (towards a resource);
'Edit connectivity settings (device type, UID, phone, access password, messages filter)', 'Create, edit, and delete sensors', 'Edit counters', 'Create, edit, and delete service intervals', 'Create, edit, and delete commands' (towards a unit).
Wialon system supports the possibility of restoring unit properties. Configured properties are automatically copied on daily basis and stored on a remote server. To come back to the previous configuration, it is necessary to click the corresponding button situated in the left bottom corner of the dialog. The button is active only in case you possess enough rights for properties restoring. Click the button in order to open a calendar where all the dates highlighted in orange have the configuration stored. Choose the necessary date, and you open the dialog of importing from WLP file.
The sequence of actions with this dialog is described in the corresponding section of documentation
.
Export to File
corner.
67
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,
, 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.
Such buttons as 'Properties', 'Copy', and 'Delete' are used for the work with created sensors, and situated in the end of the line opposite to the sensor name. To quickly create a sensor with similar settings, press 'Copy' in the line of a template sensor. To edit an existing sensor or just view its settings, press 'Properties'. To delete a sensor, 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.
contain time duration for how long parameter's value stays unchanged (for example, Ignition: On (47 minutes 33
seconds ago)
), then activate this flag.
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.
68
Sensor Properties
When creating, editing or copying a sensor, an additional dialog with sensor properties is displayed. It consists 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.
Measurement system
corresponding dropdown list are displayed only for those sensors the metrics of which can be different depending on the measurement system chosen.
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
available in the last message.
Last message only
This flag affects sensor's value in unit's tooltip and similar places. If enabled, sensor's value will be calculated only from the most recent message, and in case when no required parameters are present in the last message, there will be
'Unknown'. If disabled, the last known values are displayed even if they appear invalid (and no matter how up-to-date they are).
Description
This field is optional. Add any description and options if needed.
69
Validator
and Validation type
This is optional.
Validation defines dependency of sensors from each other.
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
Intervals and colors
Wialon system provides a possibility to differentiate sensor values by color. For this purpose in sensor properties it is necessary to create intervals of values and choose their colors. There is also a possibility to accompany received digital values by a text.
By default any sensor values (from -∞ to +∞) are displayed in black color. To set an interval, choose custom color, and indicate a text, click button near the scale. Note that values are set for each interval individually. Further there are some peculiarities of setting intervals and choosing their color that could be helpful:
No value in the first field corresponds to -∞, in the second — to +∞;
Adding an interval which crosses an existing one and reaches beyond it, the added interval is set instead of existing one;
Adding an interval which crosses an existing one without reaching beyond it, the added interval is inserted inside the existing one. Moreover, both the intervals on which the existing one has been cut, receive its text and color;
You can either choose a necessary color from a color picker or indicate its text value (in HEX) in the corresponding field.
Upon completion, all the set intervals of a chosen color along with their text info are shown on the scale. Each interval of the scale, its color, and text can be edited. To do so, click the corresponding interval on the scale and set the necessary parameters. To delete all set intervals from the scale, click the 'Delete' button to the right of it.
An alternative method is supported for adjusting intervals — table view. To switch to the table view, click the corresponding icon to the right of the scale. Click the same button to switch back to the scale. Note that upon creating more than 10 intervals, the scale is automatically switched to the table view.
If a sensor sends values smaller than ones indicated in the first interval, then such values are considered to be part of the first interval.
Created intervals can be used in several cases:
To visualize sensor state in the corresponding column of the
To display multicolor tracks of unit's movements;
To show unit on the map according to sensor's state (if it is chosen to replace usual icons with
To quickly pick a necessary information on sensors either in
unit's tooltip or in extended unit information ;
To visualize sensor's state in the '
In the first three cases, you need to specify sensor for each case separately, on the Advanced
tab of the Unit
Properties dialog.
Additional Properties
70
More properties can be applied to some specific types of sensors:
Redefine filtration level
This property is specific for fuel level sensors. Filtration degree is adjusted traditionally on the
tab.
However, in some cases each sensor needs to be set up individually. This option gives such a possibility. Individual filtration works only if the option 'Merge same name sensors (fuel level)' is disabled on the Fuel Consumption page.
Filtration level
The possibility of indicating filtration level is applicable to the following sensors: temperature sensor, engine revs sensor, voltage sensor, accelerometer, custom sensor, weight sensor. This option allows to apply smoothing algorithm to sensor values. It is necessary to indicate the level of such a smoothing (from 0 to 255) in the corresponding field.
Filtration level for the sensors of such type is indicated individually.
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.
Overflow by raw data
This option appears only for differential counter sensors with overflow. If it is activated, raw data is analyzed first, and then calculation table is applied. It means that raw data (and not data processed with calculation table as in case when the option is disabled) is taken to estimate overflow.
Timeout
This property is a specific feature for engine ignition sensor, custom digital sensor, and engine efficiency sensor.
Indicate time value (in seconds) in this field. If nothing is indicated in the field or 0 is entered in it, then the option is considered to be disabled. If time between messages exceeds the one indicated by you, then the period of time on which the timeout has been exceeded will be considered invalid, and the remaining time will be divided into intervals
(before and after the invalid time period). In other words, the last message before, and the first message after the invalid time period will be considered the end of the first and the beginning of the second interval, correspondingly.
For example, custom digital sensor is used and 1 hour timeout has been indicated. The following data comes from digital sensor: 1 (22:00), 1 (22:10), 1 (07:50), and 1 (08:00). If timeout property had not been indicated, then we would have one continuous interval (from 22:00 to 08:00). But using 1 hour timeout we receive the following situation: there is less than 1 hour between 1st and 2d message, so we have first interval (from 22:00 to 22:10); between 2d and 3d message more than 1 hour pass, so this data is considered to be an invalid time period (from 22:10 to 07:50); and there is less than hour between 3d and 4th message, so we receive the second interval (from 07:50 to 08:00).
With overflow
This option is available for the sensors, which could be influenced by occasional resets (mileage sensor, absolute engine hours, absolute fuel consumption sensor). Enabling this option the system uses the following algorithm. The value from the latest message is compared to the previous one. If the value is greater than the previous one, the difference of these values is added to the previous value. If it is less, then the value from the latest message is added.
Therefore, this function guarantees receiving correct mileage data.
Text parameters
This option is available only for custom sensors. It is to be activated if a sensor sends text parameters instead of numeric. In this case, in the table of intervals and colors you can list those parameters and give them broader descriptions. For example, device sends parameters 'error1', 'error2', 'error3', etc. You can specify their meaning in the
'Text' column (like 'Power supply disconnected', 'Invalid data', etc.). Besides, you can use special characters like *
(asterisk). For example, the values could be entered as 'error*' and its text would be simply 'Error'.
71
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.
The table contains all sensor types currently available in the Wialon system. Moreover, here you can find units of measurement for the sensor values (either in metric or American/imperial systems), as well as short description for every sensor type.
Mileage sensor
Relative odometer
kilometers
(km) kilometers
(km) miles
(mi) miles
(mi)
Mileage
The sensor showing the distance traveled. It can be used to detect trips and stays.
The sensor shows the distance traveled since the previous message. It can be used to detect trips and stays.
Digital
Engine ignition sensor
On/Off or any
This is engine operation sensor that is used in the
well as in trips/stays detection
Alarm trigger
Private mode
Real-time motion sensor
Custom digital sensor
Voltage sensor
Weight sensor
Accelerometer
Temperature sensor
Temperature coefficient
Engine revs sensor
Sensor which non-nil value allows marking a message as an alarm message
(SOS).
On/Off or any
This sensor is used to determine trip type ('Business', 'Private').
On/Off
On/Off or any
The sensor determines units' motion state in real time. Its values are used to show the motion state in the 'Monitoring' panel and on the map (if the option
'Replace unit icons with motion state signs' is activated in the
). The sensor can be based on such parameters as speed, ignition, engine revolutions, etc. Its parameter can contain formulae, which allows using validation.
This sensor can register two states. Its values can be displayed in unit's tooltip, in extended unit information or sent to report.
Gauges
tons
(t) volts
(V) pounds
(lb)
The sensor showing some parameter value (not necessarily voltage). It can be used to analyze input data.
This sensor is used to detect weight of transported cargo.
Celsius degrees
(°C) g
This type of sensor is used to measure acceleration at X, Y, Z axes and immediately detect a collision of cars.
Fahrenheit degrees
(°F)
The sensor showing some parameter value (not necessarily temperature). It
can be used to analyze input data. See an example of configuration.
Temperature coefficient that affects fuel level calculations at different temperature in the tank.
Engine
rounds per minute
(rpm)
The sensor displays engine speed.
Engine efficiency sensor
Absolute
on/off hours
Defines whether an attached implement is operating. Shows the time of work between shifts of states (from 1 to 1 or 0).
The sensor registers the total amount of engine hours.
72
engine hours
Relative engine hours
hours The sensor registers the amount of engine hours subject to intensity of work.
Impulse fuel consumption sensor
liters (lt)
Absolute fuel consumption sensor
Instant fuel consumption sensor
Fuel level sensor
Fuel level impulse sensor
liters (lt) liters (lt) liters (lt) liters (lt)
Counter sensor
Custom sensor
Driver binding
Trailer binding
Passengers sensor
any any gallons
(gal) gallons
(gal) gallons
(gal) gallons
(gal)
Fuel
The sensor shows an accumulated value of impulses. To convert the incoming value into the amount of consumed fuel, a calculation table should be applied.
For such sensor type a calculation table is applied to the difference between two adjacent messages. After sensor creation and adjustment it is necessary to enable
impulse fuel consumption sensor
on the corresponding tab.
Note that if a device sends not an accumulated value of impulses, but the number of impulses between messages, then it is necessary to use absolute fuel consumption sensor.
The sensor detects fuel consumption over all period of vehicle operation. After sensor creation and adjustment it is necessary to enable
absolute fuel consumption sensor on the corresponding tab.
The sensor shows fuel consumed from the previous measure (message). After sensor creation and adjustment it is necessary to enable
instant fuel consumption sensor on the corresponding tab.
This sensor is placed in the tank. After sensor creation and adjustment (see
) it is necessary to enable fuel level sensor
on the corresponding tab.
gallons
(gal)
The sensor detects the number of impulses in a period. Fuel level in the tank is calculated from received values.
Other
The sensor can show passenger traffic or count the number of some actions like opening/closing the door, etc. Several types of counters are known:
— instant (counts the number from the previous to the current message),
— differential (shows total number), differential with overflow (2 bytes),
— 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 is a custom sensor for which you can set any unit of measure. Its values can be displayed in unit's tooltip, in extended unit information or sent to report.
This sensor can be used to detect drivers assigned to units.
This sensor can be used to detect trailers attached to units.
This sensor supports detection of passengers entering and leaving a vehicle.
73
Sensor Parameter
Parameters can be of any names. These names are normally predefined in device configuration, for example,
param199, param240, TEMP, pwr_int, gsm, can6
, and the like. Read device specification to find out which parameters are available and what they measure.
If the configured unit already has any messages, it is recommended to explore them and find available parameters (go to the '
' panel). Parameters from the last message appear on the dropdown list of available parameters when creating or editing a sensor. However, even if the parameter you need is not on the list, you can enter its name manually.
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
Some of supported parameters are reserved in the system as default:
speed
speed of motion
altitude
altitude above sea level (may be not supported by some devices)
sats
satellites count
course
course (direction of motion)
lat
geographical latitude
lon
geographical longitude
time
time in message
Note.
Some rare devices may not support all of the parameters mentioned above, e.g., altitude or speed.
Inputs and Outputs
The system supports up to 32 digital inputs and outputs. They are adjusted in the following format:
inN
digital input parameter, N — input number
outN
digital output parameter, N — output number
adcN
analog input parameter, N — input number
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.
Bitwise Parameter Control
74
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
chain or in
.
Expressions
Parameter for a sensor can be set in the form of expression. In those expressions you can use: parameters in the current message (adc1, in1 etc.), parameters in the previous message (they begin from the hash sign #, for example, #adc1), bitwise parameters (like param199:3), sensors (sensor name must be in square brackets, for example, [Fuel level]), constant numbers (const10, const-4.54 etc.), mathematical operation signs:
+
addition
− subtraction
multiplication
/
division
^
exponentiation & rooting
( )
brackets of priority
|
For example, ^const2 — square, ^const0.5 — take the square root.
Note.
Parameters from the previous message are not available in notifications and in tooltips for charts.
Expressions allow creating a great variety of sensors, which can satisfy any needs and assigned tasks.
Example 1: Detecting Speed by GPS Coordinates
It is possible to create a sensor to detect speed by coordinates. It will have the following parameter:
((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.
75
If you have the ignition sensor, the parameter can be set like this:
((lat-#lat)^const2+(lon-#lon)^const2)^const0.5/(time-#time)*const200000*[Ignition sensor name]
Example 2: Relative Engine Hours Sensor
To get real
engine hours in report, create two sensors:
1.
relative engine hours sensor,
2.
coefficient sensor which depends on engine revolutions.
First, create a sensor of Relative engine hours type. The parameter for the sensor will be:
(time-#time)*[Name of coefficient sensor]/const3600
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
The meaning: arithmetic average of engine revolutions between neighboring messages.
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
Example 3: Value Availability Check
There is an equipment installed on the vehicle. It sends some parameter (for example, in1). Then the equipment gets out of order. A new one is installed. The new equipment sends the same data in the other parameter (for example, in2). To exclude data loss during report generation, it is necessary to use value availability check in
'Parameter' field upon creating a sensor. The old equipment has lasted all December, the new one — all January, and we need a report for these two months. If the value availability check is used during parameter indication
('in1|in2' entered as sensor parameter), then the system takes a value from 'in1' parameter, and if the 'in1' value is invalid (for example, an equipment is broken), then the system takes a value from 'in2' parameter. In other words, upon using the value availability check, the system takes into account the first valid parameter value received.
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
76
application of text-based sensors is limited — their values can be shown only in
additional information about the unit , in
Other Textual Parameters
If a textual parameter is used in an expression, it is converted into 64-bit integer. By default, it is interpreted as decimal, however, positional notation can be specified after colon. For example, there is a parameter called 'text_param' and it has the value '100', then: text_param = 100 text_param:16 = 256 text_param:2 = 4
77
Validation of Sensors
Validation defines dependency of sensors from each other. It is adjusted in
Validator
is a sensor that affects the current sensor. Validator is another sensor which must be 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.
Mathematical AND
: the mathematical function AND is applied.
Mathematical OR
: the mathematical function OR is applied.
Sum up
: values are summed up.
Subtract validator from sensor
: validator value is subtracted from sensor value.
Subtract sensor from validator
: sensor value is subtracted from validator value.
Multiply
: values are multiplied.
Divide sensor by validator
: sensor value is divided by validator value.
Divide validator by sensor
: validator value is divided by sensor 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.
Attention!
Validation will not be working if validator uses parameter from previous message .
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
78
sensor shows whether the vehicle is closed or opened.
Mathematical AND
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.
Mathematical Operations Usage
Example 1
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:
0 — all equipment is off;
1 — the brush is on;
10 — the plough is on;
11 — the brush and plough are on;
100 — the thrower is on;
101 — the brush and thrower are on;
110 — the thrower and plough are on;
111 — all equipment is on.
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
79
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 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.
80
Calculation Table
Calculation table is very important in sensors configuration (see
). According to the calculation table adjusted, raw data coming in a parameter is transformed into sensor values, for instance, some abstract 86 is interpreted as 10.5 liters of fuel.
Calculation table is not always 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.
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.
Calculation table recalculates data according to straight-line equation Y = a×X + b, where
X
is input value — values coming from device;
Y
is output value — processed values which gets into reports, charts, tooltips, etc.;
a
is a coefficient that determines the slope or gradient of that line (tangent of angle, or relation of the opposite cathetus to the adjoining one);
b
determines the point at which the line crosses the y-axis.
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 be repeated.
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
are used to set limits for input values. Note that the bounds correspond to the half-open interval. In other words, the lower bound is included in the interval of valid values while the upper one is not. In case of receiving values beyond the indicated interval, these values are considered to be invalid. Moreover, depending on the enabling/disabling of the 'Apply after calculation' flag, the indicated limits are applied to the raw values X (disabled flag), or to the processed values Y (enabled flag).
Incorrect pairs of values can be removed with the button . To remove all pairs at once, click the delete button in the header of the table.
A graphic for the created calculation table can be viewed by clicking 'Show chart' icon at the top of the table header.
Table Filling
Here are several ways to compile a calculation:
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. This method is convenient if converting a analogue signal to a digital.
3.
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
81
output Y values. In these cases use the calculation table wizard .
Chart Managing
A chart can be managed using the following buttons:
Area selection
Activate the button in order to zoom in any selected chart area. Select an area holding left mouse button. This operation can be repeated multiple times.
Autoscaling
Go back to a default chart scale by clicking this button.
Zoom in/zoom out
The buttons to scale a chart along the X axis. Click a button in order to make a visible area of the chart twice as wide/narrow in regard to the current position. Yet the center of the chart stays in its place.
Save as
PNG
To save a visible chart area along with the axis in PNG format, click this button.
Example 1: Temperature Sensor
As an example, let us create a calculation table for a temperature sensor. Let us assume that 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).
On the basis of values indicated in the table, a chart is made. To view a chart, click the 'Show chart' icon on top of the table header.
Note.
The function continues operating to infinity if there are no limitations. The chart extends also to the left to minus
82
infinity. If there are limitations, the chart expands quarter-size to both sides, right and left.
Example 2: Engine Ignition Sensor
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.
Calculation Table Wizard
A calculation table wizard is a tool simplifying a process of calculation table creation. In this tool it is sufficient to indicate input X values and corresponding output Y values. You can use the calculation table wizard to calibrate a sensor experimentally. For instance, you fill different volumes of fuel into the tank and each time you take the readings from the sensor. The calculation table wizard is situated in the right side if the dialog window. It is disabled by default.
To use a wizard, indicate the 'Generate from XY pairs' flag.
Enter the pairs and click 'Generate' in order them to be processed by the system. On the basis of values indicated in the wizard, a calculation table will be created.
The program calculates a and b using the following algorithm:
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.
Note.
Indicated XY pairs can be saved on server and restored afterwards. To do so, use the corresponding buttons below the wizard.
83
Example 1: Fuel Level Sensor
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:
Input values (X) Output values (Y)
0 0
86
173
252
330
405
477
10
20
30
40
50
60
546
618
686
749
70
80
90
100
Enter these pairs into the wizard and click 'Generate'. A calculation table will be created on the basis of values from the wizard:
In order to view a chart, click the 'Show chart' icon.
84
Note.
When reopening the dialog, all data entered on this tab is preserved. However, note that if any changes were made to the Calculation Table, they will not affect the Wizard. In other words, the Wizard displays only values you entered but doesn't reflect 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
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
3
4
5
1
2
0 0
86 10
173 20
252 30
330 40
(10 — 0) / (86 — 0)
(20 — 10) / (173 — 86)
(30 — 20) / (252 — 173)
(40 — 30) / (330 — 252)
(50 — 40) / (405 — 330)
0 — a×0
10 — a×86
20 — a×173
30 — a×252
40 — a×330
6
7
8
405 50
477 60
546 70
(60 — 50) / (477 — 405)
(70 — 60) / (546 — 477)
(80 — 70) / (618 — 546)
50 — a×405
60 — a×477
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
Example 2: Fuel Level Sensor
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:
Input values (X) Output values (Y)
2.8
0
2.58
2.18
2.0
1.65
10
20
30
40
85
1.3
1.25
1.1
0.96
0.6
0.32
50
60
70
80
90
100
Insert these pairs into the wizard, generate the calculation table and view the calculation chart.
Calculated intervals for this sensor are as follows:
N
1
2
3
4
5
6
Interval X Y a b
X Y (Y
(i+1)
— Y
(i)
) / (X
(i+1)
— X
(i)
)
Y — a × X
0,32 100 (90 — 100) / (0,6 — 0,32) 100 — a×0,32
0,6 90
0,96 80
1,1 70
1,25 60
1,3 50
(80 — 90) / (0,96 — 0,6)
(70 — 80) / (1,1 — 0,96)
(60 — 70) / (1,25 — 1,1)
(50 — 60) / (1,3 — 1,25)
(40 — 50) / (1,65 — 1,3)
90 — a×0.6
80 — a×0.96
70 — a×1.1
60 — a×1.25
50 — a×1.3
86
7
8
9
1,65 40
2,0 30
10 2,58 10
(30 — 40) / (2,0 — 1,65)
(20 — 30) / (2,18 — 2,0)
2,18 20 (10 — 20) / (2,58 — 2,18) 20 — a×2.18
(0 — 10) / (2,8 — 2,58)
40 — a×1.65
30 — a×2
10 — a×2.58
87
Signed Parameters Converting
It is supposed that data received by Wialon in the format of two- and four-byte integer appears to be unsigned. In other words, all the incoming values (both positive and negative) are 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
on the basis of this parameter and adjust a calculation table
in a proper way.
Parameter Analysis
Switch to the '
' 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.
Defining the Maximum Value
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.
88
Sensor Calculation Table
Switch to the
unit properties dialog and create a
sensor on the basis of this parameter. Now you should create a
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.
Note.
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.
89
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'.
90
Temperature Coefficient
Temperature coefficient is a
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' tab and using
wizard put in two coefficient values, maximum and minimum
temperature coefficient. Beforehand, some preliminary preparations should 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: t max
= +100 and t min
= -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: t rated
=
+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
.
Calculate coefficients' values using the following formulas:
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.
91
Note.
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.
92
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 supported hardware . 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. Note that upon creating a unit from WLP file there can be a situation when the device type used by the source unit is not available for your account. In this case the device type of a new unit is automatically changed for the Wialon Retranslator.
Unique ID
Enter a unique ID for the unit to be identified by the system. Usually it is IMEI or serial number. Some types of devices may support two unique IDs. In this case, an additional input field appears on the right.
Phone number
Here type phone number of the unit if it has embedded SIM card. Phone number should be in the
e.g., +15557654321. If your device supports two SIM cards, you can enter the second phone number on the right.
Device access password
This password is required for some device types to execute commands or send data.
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.
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.
93
Parameters of units could be set in different
measurement systems . Systems of measurement for new units created is
taken from current user settings. Therefore, to choose a system of 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 can be changed by
94
Counters
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
Mileage counter is used to calculate distance in
Four methods are suggested for calculating mileage:
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.
Note that if a sensor needs a parameter from the previous message, then such a sensor cannot be used as a method of mileage calculation.
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
Engine hours counter calculates engine hours by one of three sensors
(engine hours are measured in hours): engine ignition sensor, absolute engine hours sensor, relative engine hours sensor.
Note that if a sensor needs a parameter from the previous message, then such a sensor cannot be used as a method of engine hours calculation.
Engine hours counter is widely used in tabular reports
.
GPRS Traffic Counter
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
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
Values of mileage and engine hours counters can be shown in
unit's tooltip and in extended unit information
.
95
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
.
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.
See the main topic about
96
Icon
Access required: Change icon — for choosing an icon for a unit; Edit not mentioned properties — for unit's icon rotation.
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.
To display a unit, you can either use standard icons (choose after clicking 'Icon Library' button) or upload custom image from your computer. To upload an image from computer, click a current icon, choose an image on your computer, and click OK. Supported formats are PNG, JPG, GIF, and SVG.
If you would like to quickly change a current icon to a default one, point a cursor over it and click delete button.
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.
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. Note that in this case a group icon will not be rotated even if the corresponding flag is chosen.
Note that in order to upload individual icons for units, unit groups, and geofences you can use the Icon Library application (for top accounts only). Icons uploaded to the system using this application will be available for you in the standard icon library. To facilitate the work with the library, the uploaded icons are placed in the same list, but separately from the standard ones (at the top).
97
Advanced Properties
Access required: View detailed properties — to view parameters for reports, driver's activity source, and messages filtration settings (the first, the second, the third, and the last sections); Edit not mentioned properties — to edit color schemes for track/sensor (middle sections); Edit trip detector and fuel consumption — to edit report parameters, and driver's activity source; Edit connectivity settings — to edit parameters of messages filtration (last section).
On the 'Advanced' tab of the
messages validity parameters are defined, colors for tracks are adjusted, and speed limitations are set.
Parameters Used in Reports
Speed limit
Enter the maximum speed allowed. All messages with higher speed will be detected as cases of violation and exported to the
Urban speed limit
This setting is used in report on trips. If the unit goes with the speed under indicated here, it is considered as urban mileage. If the speed is higher, this mileage is regarded as suburban mileage. This property can be used in
, in statistics , and in advanced
Maximum interval between messages
Maximum interval between messages (in seconds) is needed to exclude invalid messages. When the indicated value is exceeded it is regarded as connection loss (GSM). These cases can be viewed in the
report on connection quality .
In addition, this setting is used in the
to cut off false intervals of engine hours operation.
Daily engine hours rate
If the unit has an engine hours sensor, here you can indicate the daily rate of engine hours to use this value in the
(to estimate utilization and useful utilization). Engine hours operation is defined by the corresponding
.
Mileage Coefficient
Mileage coefficient is useful to compare detected mileage with mileage by odometer. The corresponding column can be included in any
tabular report containing information about mileage, and in
.
98
Speeding
This block deals with speeding detection method. The chosen variant defines the sequence of further actions.
None
The default setting for this method is set to 'None'. It means that speedings are not registered by the system (this option is relevant, for example, for nonmoving units, because such data brings no sense for them).
Use fixed limit
Fixed limit as a method of speeding detection means that the speed limit for a unit is chosen individually. In other words, maximum speed limit for a unit is indicated in the corresponding field. Upon receiving messages with speed higher than the indicated one, the speeding is registered by the system. Moreover, here you can enter the minimum speeding duration (1 second by default). Any speeding with duration less than the indicated one is not registered by the system as speeding.
Use limits from roads
Using this method you do not indicate any particular speed limit, but the registration of speeding depends on the current speed limitation road signs used on any road sections. In other words, the system contains data on speed limits for the particular road section, and if a unit exceeds this speed limit, then the speeding is registered. If this method have been chosen, then you can indicate tolerance on speeding value. It means that speeding consists of a total of speed limit and tolerance values. For example, in some countries exceeding speed limit by 10 km/h is not a violation, that is why you can indicate 10 km/h tolerance on speeding. Therefore, on the road section with 60 km/h speed limit sign a unit can be driven 70 km/h, and this speed will not be a speeding. Moreover, here (the same as for the previous method) the minimum speeding duration can be indicated.
In order the speeding to be registered it is necessary to receive not less than two speeding messages in a row.
Speedings are registered in the system, and subsequently you can generate a
. Moreover, during building a track you can enable speeding markers which highlight the corresponding events on track.
Driver Activity
Driver's activity information helps to control whether a driver follows the AETR standards or not. Such information will
be displayed in unit's or driver's tooltips
as well as in
extended unit information if the corresponding flag is indicated in
the
This section allows choosing driver's activity source, in other words, the way information on driver's activity is received.
The dropdown list contains 3 items: 'None', 'Tachograph', and 'Bindings'. If the 'None' item is chosen, then unit's or driver's tooltips, or extended unit information do not show the current data on driver's activity. If the 'Tachograph' item is chosen, then information on the activity of a driver bound to this unit will be received from a tachograph installed in the vehicle. If the 'Binding' item is chosen (for example, is a vehicle is not equipped with a tachograph), then activity of a driver bound to this unit will be determined in the following way:
'Driving' status is registered as driver's activity when either trip or stop have been detected for a unit.
'Work' status is registered when parking have been detected.
'Rest' status is registered upon unbinding a driver from such a unit.
Unit label color
By default, unit names on the map are red. However, you can change this color here and even set different colors for different units.
Track Colors
Different colors can be used to show on the map not only unit itself, but also its movements (tracks). Tracks can be built in the
panel,
panel (quick tracks).
Track segments can be colored differently depending on speed, sensor values, and so on. These properties are set individually for each unit. Note that such settings of colors as 'By speed', 'By sensor', and 'Single' are mutually
99
exclusive (only one can be chosen).
Single (constant track color)
Track color set here is applied to all tracks of a unit regardless to its speed or sensor values. This option allows assigning an individual track color for each unit, which is very useful for rendering unit group tracks on the map.
Individual colors help to differentiate tracks from each other.
By Speed (speed based track colors)
Activate this option in order a track color to be changed depending on unit's speed. To set values for speed intervals and indicate their colors, click an interval adding button ( ). Track color is set for each interval individually. In other words, it is necessary to set an interval, pick its color, and click OK. Afterwards, the same procedure should be done for the rest intervals. Further there are some peculiarities of setting intervals and choosing their color that could be helpful:
No value in the first field corresponds to -∞, in the second — to +∞;
Adding an interval which crosses an existing one and reaches beyond it, the added interval is set instead of existing one;
Adding an interval which crosses an existing one without reaching beyond it, the added interval is inserted inside the existing one. Moreover, both the intervals on which the existing one has been cut, receive its text and color.
You can either choose a necessary color from a color picker or indicate its text value (in HEX) in the corresponding field.
Upon completion all the set intervals of a chosen color are shown on the scale. Each interval of the scale and its color can be edited. To do so, click the corresponding interval on the scale and set the necessary parameters. To reset all created intervals for the default ones, click the corresponding button to the right of it ( ).
By Sensor (sensor based track colors)
Activate this option in order a track color to be changed according to a sensor state. Choose a necessary sensor from
the dropdown list (the list is formed on the basis of all the sensors
created for a unit). For each sensor created you can set value intervals and pick their colors on the
corresponding tab . Therefore, activation of this option enables
visualization of a track according to the colors indicated on the intervals' scale of a chosen sensor.
Usage of Sensor Colors
in the monitoring panel or for the
alternative displaying of units on the map
.
Messages Validity Filtration
All the
without any exception are stored in the system. However, if having outlying data, it can affect reports and other processes based on database analysis. That is why, it is recommended to enable filtration of data. For example, if there are outlying data, messages without coordinates, etc., these messages can be marked as invalid and ignored when generating reports, calculating mileage, and so on. To adjust filtration settings, fill in the fields:
Allow positioning by cellular base stations
Positioning by cellular base stations ('LBS detection') is an alternative method of defining unit's location. This method implies using cellular base stations as a guide for location detection. Note that the method is inferior to using of GPS data, and just allows to receive the approximate location. Note that enabling of this flag does not mean 'LBS detection' method is constantly applied, but that it will be applied only if LBS detected data to be more recent than GPS one.
100
Skip invalid messages
Some controllers may send a flag about coordinates validity/invalidity in messages. A message with invalid coordinates is marked by the flag of invalidity, and when sending such a message to the server, the current time and the last valid coordinates are given. Wialon will consider this message as a message without position data, and it will be not used when constructing movement tracks, detecting location in reports, etc. However, if this message contains other parameters (such as sensors), they will be used.
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 HDOP value
HDOP refers to Horizontal Dilution of Precision. Here you set the minimum HDOP value for messages to be regarded as valid. The lower this parameter, the more accurate the coordinates.
Maximum speed value
The messages containing speed higher than or equal to one set here are marked as invalid.
101
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
you can input information of any type. This can be some notes or precisions about the equipment, vehicle or any other information needed. Moreover, you can indicate any external links in this field. Administrative fields (seen only to users with special access rights) are marked in the first column.
Input a field name and its value and click the 'Add' button. To delete an incorrect field, click '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.
Application of unit custom fields:
In
unit's tooltip and in extended unit information (if enabled in
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;
.
102
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.
103
Commands
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
configured in the properties of all those units and bare exactly the same name.
To create a new command, click the 'New' button ( ). Afterwards fill in the necessary fields, and press OK. Such buttons as 'Properties', 'Copy', and 'Delete' are used for the work with created commands, and situated in the end of the line opposite to the command name. Sometimes it is convenient to create a new command using existing one as the basis — press 'Copy' in the template command line. To view or change configuration of an existing command, press 'Properties'. To delete a command, press 'Delete' ( ).
Command Properties
A command has the following 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
supported in Wialon.
Channel
Select the channel (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
104
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
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.
105
Eco Driving
Access required: View detailed item properties — to view the tab; Edit trip detector and fuel consumption — to edit the tab.
Driving behavior influences condition of a transported cargo, as well as technical condition of the vehicle used. Wialon system possesses the functionality enabling to receive the estimation of driving quality. The functionality helps to evaluate how a driver treats the entrusted vehicle, and as a result promote driving safety, prolong vehicle life, reduce fuel costs, and ensure cargo safety.
With these settings properly adjusted, you can get the special
as well as include columns with penalties and rank into many other reports.
Settings
'Eco Driving' tab is presented by the form where you should either choose or insert the parameters used for penalty scoring. It is conditionally divided into 2 sections: key parameters (obligatory ones), and additional (optional for indicating). Criterion, name, sensor (if 'Custom' criterion is chosen), penalty value are considered to be the key parameters. Moreover, in this section you can indicate minimum/maximum violation value. Additional parameters section contains validator, multiplier, averaging, minimum/maximum duration and speed. After indicating of all the necessary parameters you can either save the chosen criterion with individual name and other parameters, or clear the form by using the corresponding buttons.
To calculate positive (speedup) or negative (slowdown) acceleration, the system uses different data analysis methods.
By default data is analysed on the basis of received GPS coordinates or accelerometer readings. However, there is a possibility to choose either only GPS or only accelerometer. If GPS is chosen as data analysis method, then positional data will be considered for acceleration calculation. If accelerometer is chosen, then calculation will be made on the basis of parameters received from the corresponding equipment. If GPS and accelerometer is chosen as a method, then the system chooses the bigger acceleration value calculated either considering positional data, or received parameters. All the methods work for such criteria as acceleration, braking, turn, and reckless driving. Note that a chosen method is applied to all the created criteria.
Criteria
Criterion is a key parameter on the basis of which a driving quality can be determined. Wialon system supports the work with the following criteria: speeding, acceleration, braking, turning, reckless driving, and custom one. The detailed information on every criterion is presented below.
106
Speeding
In the corresponding fields indicate a speeding value (min — max) in km/h which should be detected as violation, and also a penalty value charged for this violation. Moreover, additionally you can choose validator (multiplier), averaging, and also indicate min/max duration and min/max speed on which a violation to be detected. Note that speedings are detected by
, however if it is necessary, the min/max speed option provides a possibility of indicating custom limits.
Acceleration
A parameter which is used for detection of unreasonably hard vehicle speedups. In the corresponding fields indicate an acceleration value (min — max) measured in g which should be detected as violation, and also a penalty value charged for this violation. Moreover, additionally you can choose validator (multiplier), averaging, and also indicate min/max duration and min/max speed on which a violation to be detected. Such option as min/max speed can be applied, for example, in order to exclude low speed accelerations from a report.
Braking
A parameter which is used for detection of unreasonably hard deceleration. In the corresponding fields indicate a braking value (min — max) measured in g which should be detected as violation, and also a penalty value charged for this violation. Moreover, additionally you can choose validator (multiplier), averaging, and also indicate min/max duration and min/max speed on which a violation to be detected. Such option as min/max speed can be applied, for example, in order to exclude low speed braking from a report.
Turn
A parameter which on the basis of vehicle turning direction and acceleration in the moment of turning helps to evaluate the quality of passing the maneuver. In the corresponding fields indicate a value (min — max) measured in g which should be detected as violation, and also a penalty value charged for this violation. Moreover, additionally you can choose validator (multiplier), averaging, and also indicate min/max duration and min/max speed on which a violation to be detected.
Reckless Driving
A parameter which is used for detection of unreasonably hard accelerations prior to deceleration. In the corresponding fields indicate a value (min — max) measured in g which should be detected as violation, and also a penalty value charged for this violation. Moreover, additionally you can choose validator (multiplier), averaging, and also indicate min/max duration and min/max speed on which a violation to be detected.
According to the indicated settings the system detects so called peaks of violations, afterwards sets value for every peak, and also identifies intervals on which the peaks can be found. Furthermore, if you have several 'Reckless
Driving' criteria with different violation settings, the system determines which one of them suits most. Afterwards, filters indicated in the additional parameters section come into action:
min/max speed
— on the basis of received parameters the system calculates maximum speed on the interval. Then the calculated speed is compared to the values entered in the key parameters section. So, if the calculated speed matches the filter, then it gets into a report. Otherwise, a violation does not get into it.
min/max duration
— if the length of the interval exceeds minimum duration value indicated as filter, then such a violation gets into a report. If the length of the interval exceeds maximum duration value, then a penalty is multiplied by the number of maximum values contained by the interval.
As it has been mentioned before, a validator (multiplier) can be used for this criterion. The basic principles of using a validator (multiplier) are described below, in the 'Additional parameters' section.
Custom
A parameter which uses any sensor created in the system for a violation detection. Using a custom criterion, it is necessary to choose a sensor itself (from the dropdown list), indicate min/max violation value, and a penalty charged for it. Afterwards, you can choose validator (multiplier), averaging, and indicate min/max duration and min/max speed on which a violation to be detected.
Key Parameters
Criterion
Violation type (speeding, acceleration, braking, turn, reckless driving, custom).
107
Name
Any name for the criterion chosen above. It is considered to be an obligatory field because the system allows the same criterion to be chosen multiple times.
Penalty
A number of penalty points charged for the violation of such a type.
Sensor
This parameter is available upon choosing the 'Custom' criterion. Any sensor created for the unit can be used.
Violations are registered using the values of the chosen sensor. Note that working with a digital sensor you can indicate additional settings:
Violations from device — indicate this flag in order a violation's duration to correspond to the sensor's working interval (from on to off state).
Min/max value
Is a range of violation values. If a received parameter value falls within the range, then a violation is recorded
(minimum value is included into the range, and the maximum is not).
Note.
Intervals of violations for such criterion as acceleration/braking can be connected. In other words, if a repeated violation occurs during 30 seconds after the end of a primary one, then both these violations will be connected into one.
Note.
Take into consideration that evaluating the driving behavior the speeding is determined by
Additional Parameters
Validator
Any of the sensors created for a unit. It is applied to confirm or contradict the received values of a chosen criterion. A violation gets into a report upon receiving any positive value from validator. Otherwise, the violation does not get into it.
Moreover, if you check the 'Multiplier' flag, then the sensor chosen as a validator is used as a coefficient multiplying a penalty score.
Here it is an example. If the main objective of the company is to provide a cargo safety during its transportation, then the violations evaluation severity should become higher. It is necessary to create a weight sensor and use it as a validator-multiplier. 0 value is received when the vehicle is empty, any positive value received for the loaded one. So, in case of speeding by the loaded vehicle the penalty value is multiplied by a validator's value.
Min/max duration, sec
Duration range for the criterion (from — to) on which a violation is recorded. If a duration for the criterion is less than indicated minimum value, then a violation is not recorded. If a maximum indicated value is exceeded, then a violation will be automatically terminated, and a new one started.
Min/max speed, km/h
Speed range (from — to) on which a violation is recorded.
Averaging
There are 3 variants to work with averaging:
Averaging is disabled
. Penalty points received for the trip are summarized. Besides, they are accumulated in a linear progression. So, the more trip interval is, the more violations to be registered.
That is why this way cannot match everyone. Therefore, there is a possibility to connect penalties with time or mileage intervals, and receive average value of penalty points for the interval.
Averaging by mileage
. Using the averaging by mileage, the total amount of penalty points is divided by the number of 1 kilometer intervals of the trip. Therefore, as a result we receive average amount of penalty points for every kilometer of the trip.
108
Note that if a trip is less than 1 kilometer, then averaging by mileage cannot be applied to the trip.
Averaging by time
. Using the averaging by time, the total amount of penalty points for the trip is divided by the number of 1 minutes intervals of the trip. Therefore, as a result we receive average amount of penalty points for every minute of the trip.
Note that if a trip is less than 1 minute, then averaging by time cannot be applied for the trip.
109
Profile
Access required: View custom fields — to view this tab, Manage custom fields — to edit this tab.
On the 'Profile' tab of the
in the corresponding fields you can enter registrational and technical information concerning a vehicle. Depending on the flags indicated in
user settings , profile information can be displayed
either in the work list or in unit's tooltip. Besides, a corresponding
report can be generated on the basis of profile data.
Moreover, profile data as well as the other unit properties can be imported or
On the 'Profile' tab combo boxes are used along with standard input fields. Combo box is a field where you can indicate a value, choose a value in the dropdown list, or filter the dropdown list by an entered value. The dropdown list consists of values saved in the reference book. The reference book may contain up to 50 values for each combo box. The reference book can be filled in manually (open using the button to the right of a combo box and add new values) or automatically (enter values in combo boxes and save indicated characteristics).
Note that depending on a unit settings, different
measurement systems can be used in profile data.
110
Trip 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
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 to detect movement:
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 can be used for devices sending location data only, because in this method speed parameter does not influence a movement detection. The movement is detected if coordinates in two successive messages are different. This type of movement detection needs GPS correction activation.
Engine ignition sensor
This method is available for units having ignition
. A trip is detected upon meeting 2 conditions: a sensor should be switched on and a speed value from a message should be higher than minimum moving speed. A trip ends when the sensor is switched off or incoming speed value is less then the indicated minimum moving speed. Also a trip is considered to be terminated when exceeding a
Mileage sensor
This method can be used for units which have a mileage sensor. The sensor transmits an absolute mileage. A movement is detected upon receiving messages with an increased mileage sensor value and speed value higher than minimum moving speed. Moreover, a movement can be detected using mileage sensor values only, if speed parameter is missed or invalid.
Relative odometer
Shows what distance was travelled from the previous message. A movement is detected upon receiving a message with more than 0 value of a relative odometer and speed value higher than minimum moving speed. Moreover, a movement can be detected using relative odometer values only, if speed parameter is missed or invalid.
After a movement detection method is chosen, use the parameters described below. These parameters provides the possibility to detect movement states, such as trips, parkings, and stops.
111
Detection of Movement States
Min moving speed
Specify which speed should be considered as the beginning of the motion. This is needed to exclude outliers of data. The equipment can locate coordinates with some inaccuracy, so a speed of 1-2 can be assigned to the unit that is not moving in fact. To exclude such cases from the trips, set this parameter. When defining movement by a sensor (for example, ignition), this parameter is used to detect stops inside a trip.
Min parking time
Set time in seconds how long the unit should be immovable to register this as a parking. This option allows you to include stops (in traffic jams, at lights or intersections) in a trip (instead of breaking the trip). However, if the time interval between two closest messages is longer than the minimum parking time, the trip will be broken into two parts. Defining movement by a sensor (for example, ignition), this parameter is applied only to intervals on which a sensor is off or speed is less then a minimum moving speed. If 'Allow GPS correction' is on, the value of the minimum parking time should be no less than 10 seconds. Note that to detect a parking duration, it is necessary to receive not less than 2 messages with a speed value below the min moving speed indicated.
Allow GPS correction
For non-sensor-based detection, this option is applied automatically. In case you use one of the sensors (ignition, mileage, or odometer), you can use GPS correction in addition — to receive more precise data in reports. To activate GPS correction of trip/stay detection, put a check mark near 'Allow GPS correction' and configure the parameters described below.
Min satellites count
It means how many satellites are needed to consider data to be valid. Recommended number is three and more, but two are enough for some types of equipment.
Max distance between messages
If according to the message received the unit moved relatively to the previous message greater distance, then the previous trip is over and a new trip begins. The value in this field should be at least 50 meters or 150 feet.
Min trip time
This is to exclude cases of outliers of data. For example, the unit on the parking moved from one place to another, and movement during 40 seconds was detected. To exclude such cases from trips, set minimum trip time (in seconds).
Min trip distance
This is a similar parameter. But here you indicate the minimum trip distance. For example, the car is parked, and the device sends coordinates according to which the car has moved slightly. It can happen because of permissible equipment error. In order to not count such situation as movement, indicate how far the unit has to move to consider it as the start of a trip.
112
Fuel Consumption
Access required: View detailed properties — to view the tab; Edit trip detector and fuel consumption — to edit the tab.
Fuel fillings and thefts can be detected only if a unit has fuel level
and has the option '
' activated. Fuel consumption is calculated if there are fuel consumption sensors. The determination accuracy depends on the accuracy of the installed sensors as well as on their correct configuration. The parameters adjusted on this tab are used during the calculations. For your convenience they are divided into several sections.
Fuel Fillings/Thefts Detection
Minimum fuel filling volume
The minimum increase of the fuel level that should be considered a refueling.
Minimum fuel theft volume
The minimum decrease of the fuel level that should be considered a theft.
Ignore the messages after the start of motion
This feature allows to skip the indicated number of seconds at the beginning of the movement, when due to different factors the received fuel level data may not be very accurate. The beginning of the movement is registered when the
minimum moving speed adjusted in the 'Trip detection' tab is achieved.
Minimum stay timeout to detect fuel theft
The minimum duration of the interval with no movement followed by a decrease of the fuel level in the tank for more than the minimum fuel theft volume indicated above.
Timeout to separate consecutive fillings
The system can sometimes detect more than one fuel filling during a short time interval. In such cases they can be united in one if the time between them (timeout) doesn't exceed the time indicated here.
Timeout to separate consecutive thefts
This feature is similar to the previous one, but regarding fuel thefts. The thefts are not united if the timeout is exceeded and if the fuel level has increased between them.
Detect fuel filling only while stopped
If this feature is activated, the changes of the fuel level are searched only within the intervals with no movement. This allows reducing the number of false refueling that may be caused, for example, by the fuel level fluctuation during the movement. The initial fuel level is taken from the first message without movement or from the last message with
113
movement.
Timeout to detect final filling volume
During a filling there may be interruptions. This option appears if the previous one is selected and allows setting the duration of such interruptions. In this case not the last message that corresponds to a filling is used to determine the fuel level after a refueling, but the one that follows the indicated timeout.
Detect fuel thefts in motion
Traditionally, fuel thefts are searched during the stops. This feature allows searching for them during the motion, too.
That may be of use for ships, for example. However, in many cases it may cause the detection of false fuel thefts due to probable fuel level differences while, for instance, moving by a rough terrain.
Time-based calculation of fillings
It is recommended to use this calculation method for the units with high fuel consumption during the idling (generator, tower crane, etc.). When it is activated, the whole time period is taken into account regardless trips/stops.
For a time-based fuel calculation the options 'Time-based calculation of fillings', 'Time-based calculation of thefts' and 'Time-based calculation of fuel consumption' should be activated at the same time.
Time-based calculation of thefts
The feature is similar to the previous one, but regarding fuel thefts.
Calculate fuel filling volume by raw data
With this feature activated the initial and the final fuel levels on an interval corresponding to a refueling are replaced by the values from the messages before applying the filtration.
Calculate theft volume by raw data
With this feature activated the initial and the final fuel levels on an interval corresponding to a fuel theft are replaced by the values from the messages before applying the filtration.
Note.
Fuel fillings and thefts can be controlled by means of tabular reports
'Fuel Thefts' , as well as the job
'Send fuel information by e-mail or SMS' or the
notification about fuel fillings/thefts .
General sensors parameters
Merge same name sensors (fuel level)
.
If this option is activated for a unit that has several fuel tanks with fuel level sensors in each, the sensors' values will be summed (they must have the same names). If deactivated, the fuel level detection and the search of fillings/thefts is done for each sensor individually. If there is no value of a sensor in some message, this message will be ignored during the calculations.
Attention!
With this option enabled, no individual filtration can be applied to the fuel level sensor (in the properties of the sensor itself).
Merge same name sensors (fuel consumption)
This option works if a unit has several engines with installed impulse or absolute fuel consumption sensors. If activated, the values of the sensors with the same names will be summed during the fuel consumption calculation (like in the previous option). If deactivated, every sensor will be controlled individually.
Consumption Math
In this section you can set the parameters of fuel consumption in different conditions:
Idling
;
Urban cycle
;
Suburban cycle
;
Coefficient when moving under load
.
If this calculation method is chosen and the parameters are set, these parameters can be used for mathematical calculation of the fuel information in the reports.
114
The mathematical calculation takes into account such basic parameters as fuel consumption in urban and suburban cycles. The average speed in the urban cycle is considered to be 10 m/s (36 km/h) and in the suburban cycle — 22 m/s (80km/h). The calculation algorithm is as follows:
1.
On the basis of the urban and suburban speeds and the fuel consumption parameters that correspond them a chart is created. The chart below was created according to the default data (10 and 7 liters per
100 km, respectively).
2.
The fuel consumption during the movement is calculated. Let us assume, that we have two messages from a unit with the speeds V1 = 50 km/h, V2 = 60 km/h and the distance between them 0.15 km. Now we calculate the average speed: (50 + 60) / 2 = 55 km/h.
According to the chart, the consumption for this speed is 8.7 l/100 km. The total fuel consumed is: 0.15 *
8.7 / 100 = 0.01305 (l).
As seen in the chart, if the average speed is lower than 36 km/h, the consumption is considered to be 10 l/100 km. If it is higher than 80 km/h, the consumption is 7 l/100 km.
3.
If there is an engine efficiency sensor (sensors), the coefficient when moving under load is used (1.3 by default). If the sensor is activated in both messages, then the volume of the consumed fuel is multiplied by the coefficient. That is: 0.01305 * 1.3 = 0,016965 (l). If there are several such sensors, the coefficients are summed: ((k1+ (k2-1) + (k3-1))*N, where k are the coefficients and N is the volume of the fuel consumed during the interval.
4.
The consumption during stops (idling) is calculated. Let us suppose, that we have two messages from a unit with the speeds V1 = 0 km/h, V2 = 1 km/h and 65 seconds between them. Using the parameter
'Idling' (2 l/h by default) we determine the total fuel volume consumed: 2 * 65 / 3600 = 0.0361 (l).
Note.
If the parameters of consumption in urban and suburban cycles are zero, the average speed is not being checked, and all the consumption is calculated as during the idling.
5.
The total consumption consists of the consumption during the movement and during the idling. A sign of movement is considered to be the speed between two messages higher than 3 km/h.
Consumption by Rates
Unlike the previous method, the fuel consumption by rates only takes into consideration mileage and season
(summer/winter).
Specify the rates for fuel consumption in summer and in winter and the duration of winter period.
The following algorithm is used for the calculation. Let us assume, that we have the mileage of 0.15 km between two messages on January, 13. The fuel consumption in winter (from the 1 st
December till the 29 th
February) is: 0.15 * 12 /
100 = 0.018 (l). The consumption for the same mileage in summer (10 l /100 km) will be: 0.15 * 10 / 100 = 0.015 (l).
Fuel Level Sensors
When this type of sensors is used, the fuel consumption is determined on the basis of its level in the tank according to the following scheme: [fuel level value at the beginning of the interval] — [value at the end of the interval] + [fillings] —
[thefts].
Note.
115
The intervals are different for different tables. You can learn more about the intervals from the description of the tables.
Replace invalid values with math consumption
If the feature is activated, in case of erroneous values on the interval they will be replaced by the values calculated mathematically using the data indicated in the section '
Time-based calculation of fuel consumption
If the option is enabled, while calculating the fuel, all the time is taken into consideration, doesn't matter whether the unit has been moving or not. If it is disabled, the fuel level during the intervals with no motion is not considered during the calculations.
Filter fuel level sensors values
This feature allows to apply median filtering to the received values of the sensor to exclude data emissions (sudden increases or decreases). The minimum filtration level is 0 (zero) — the smoothing is realized according to 3 messages.
Then all the filtration levels from 1 to 255 are multiplied by 5 to determine the number of messages which will be used for smoothing. Therefore, the higher the filtration level is, the more the fuel chart will approximate to a straight line, that is why it is not recommended using the filtration level higher than 8 (the optimum is from 0 to 3).
Example
. Let us suppose that at the beginning of a period covered the value of a fuel level sensor is 230 l, and at the end — 150 l. The consumption by the FLS will be: 230 — 50 = 180 (l).
Impulse Fuel Consumption Sensors
Two types of impulse fuel consumption sensors are used in Wialon: a simple accumulative and with overflow (on reaching a definite value, the impulses counter resets and the calculation restarts from zero). It is not practical to use the first type, while the sensors with overflow are widely spread.
This calculation method takes into consideration the values of the sensors from the previous and the current messages: the previous value is subtracted from the current one and, if needed, the calculation table is applied to the received value. The sum of the values received on the interval corresponds to the amount of the fuel consumed.
Every sensor of this type needs a calculation table from impulses into liters (gallons).
Two options are available in this section:
Max impulses
If there is a limit after which the impulse counter is zeroed (overflow), it can be indicated in this field. However, with this limit adjusted in case of an emergency reset, the calculations will have no sense.
Skip first zero value
This feature allows to ignore the indications of consumption with zero level at the beginning of the motion.
Absolute Fuel Consumption Sensors
The sensors of this type show fuel consumption during all the period of a vehicle operation. The values of an AbsFCS increase all the time, therefore such a sensor is not supposed to have an overflow.
The fuel consumption is calculated in the following way: the sensor's value at the beginning of an interval is subtracted from the sensor's value at the end of the interval and, if needed, the calculation table is applied (to every sensor of this type individually).
Instant Fuel Consumption Sensors
If this type of sensors is used, the hardware sends messages that contain the amount of the fuel consumed from the previous message till the current one. Accordingly, to determine the fuel consumption on an interval, the values of the
InsFCS are summed.
For instance, a hardware has sent three messages with the following values: х1 = 0,01 l, х2 = 0,023 l, х3 = 0,048 l.
The fuel consumption during this interval will be: х1 + х2 + х3 = 0,01 + 0,023 + 0,015 = 0,048 (l).
116
Service Intervals
Access required: View service intervals — to view this tab and its contents; Create, edit, and delete service intervals
— to create, edit, and delete service intervals for given unit.
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, click the 'New' button ( ). Then enter necessary parameters: name, description, interval and last execution time.
Three ways to indicate an interval are possible:
Mileage interval
means that the service has to be done every n number of kilometers (miles) traveled.
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 '
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
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.
117
At the end press ОК. The newly created service interval will appear on the list. To manage intervals, use the buttons situated in the end of the line opposite to the interval name:
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.
Service Intervals in Use
Tracking
Service intervals with their terms can be indicated in unit's tooltip and in extended unit information. See
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
Reports
Three tables concerning service intervals can be generated for units or unit groups: Maintenance, Upcoming
maintenance
, and Utilization cost. The
presents the list of registered maintenance works.
The
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.
118
Unit Groups
Unit group is a system macro object incorporating several
that have something in 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 in Management
Unit groups can be used in management system in two ways: they make easier assigning
can give a user access to a group of units at once.
for the monitoring purposes.
Working with Unit Groups
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,
, and number of units. Standard operations with objects (create, view, edit, copy, delete) were described
.
119
Unit Group Properties
When creating, copying, editing or just viewing
properties, you see a dialog with several tabs on which group configuration is adjusted. The number of tabs can vary depending on your
General
Name
Give group a valid name (see Input Rules ).
Creator
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. To facilitate a search of the necessary units you can use dynamic filter. Here units can be filtered not only by name, but also by phone number, unique ID, device type, fields, etc. 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.
120
On this tab, you can define access
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 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
—
(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.
121
Trash
Note.
This panel is available to top users only.
Deleted system objects get into 'Trash' and are stored there for 30 days. During this period, they still can be restored in the system.
Such objects as resources, units, unit groups, users, routes, and retranslators can be found there (that is to say
).
to quickly find a necessary object. The table of results includes the following columns: name of an object, its type, time of removal, and buttons to restore.
For restoring, click the corresponding button opposite to an item. Afterwards, the element disappears from the list. To restore several objects at once, tick them out and then click the orange button 'Restore selected items' at the bottom of the table.
Attention!
Restoring of an object becomes available in 20 minutes after its removal. If 20 minutes have not passed since the removal of the object, then the object is shown in the table with the 'Restore' button disabled.
122
Retranslators
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
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. At the moment, the following retranslation protocols are available:
Wialon Retranslator,
Nis (M2M),
Granit Navigator,
SCOUT,
Cyber GLX,
Wialon IPS (1.1),
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. Also, you can indicate carrier ID for the RTTI protocol. Moreover, note that such retranslation protocols as Wialon Retranslator and Wialon IPS support an option of calculated sensor values retransmission. Check the corresponding flag ('Add calculated sensor values') to enable the option.
Below select units for retranslation. To facilitate a search of the necessary units you can use dynamic filter. Here units can be filtered not only by name, but also by phone number, unique ID, device type, creator, profile fields, etc. After the necessary units have been found, move them from the left list (available units) to the right one (units for retranslation) by double-clicking on a unit or using the arrow-shaped buttons. Note that dynamic filter can be applied to the list of units for retranslation as well (filtering by name, and redefined ID). To delete added units, move them from the right list to the left one using 'Remove' button (arrows pointing left). 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
123
of units for retranslation and when you reopen the dialog, you will see them in the left part again.
For units with two IDs, the first is shown.
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.
There is a specially developed app to work with retranslators — Protocoller .
Past Period Retranslators
This option makes possible retransmitting messages from units for the past period of time. In other words, you can specify particular period of time in the past for which you would like to retransmit data of the chosen units. Note that data retransmission for the past period does not start immediately (it could take up to 10 minutes before beginning).
The necessary actions:
In retranslator dialog check the box 'Retransmit past period data';
Indicate the period of retransmission (from — to);
Press start button to the right of the retransmitting period field.
Note.
This option is active only if the prime retranslator have already been started.
Retransmitting data progress is shown in percentage on the 'History' column of the results panel. The indicated value shows percentage of the units for which data retransmission has been already finished.
124
Import and Export
The Import/Export tool is designed to easily transfer and copy different objects and their properties. The Import/Export tool is available in both Wialon interfaces — manager's and user's. To open the tool, click on the corresponding item in the User Menu of CMS Manager or
Import/Export Subject
You can import/export:
unit properties (sensors, commands, fuel consumption settings, etc.),
contents of a resource (geofences, drivers, notifications, etc.),
user settings (Monitoring panel settings, contents of user's tooltip, user's custom fields, etc.).
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 to exchange
geofences between resources as
well as import and export them 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:
125
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.
Choose a file and press 'Upload'. Afterwards, the chosen file is processed on the server, and available contents are displayed in the section 'Import options'. At the same time, objects of a proper type are displayed in the section on the right (Destination items).
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
If the uploaded file contains unit properties, then all available units are displayed in the 'Destination items' block; if it is resource contents uploaded, then the 'Destination items' block displays all available resources; if it is user settings uploaded, then the block displays all available users.
Check data to be imported on the left and select destination objects on the right. Use the
to quickly find a necessary object (works by various criteria).
For unit properties (such as sensors, custom fields, commands, service intervals) and resource contents you should also choose 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 a status of an operation.
126
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 a necessary item (just one). To quickly find certain object, use the
(works by various criteria). When the 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).
127
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).
128
Import from KML/KMZ
This option allows you to
import geofences from a file to a resource.
Indicate the path to a proper file and 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 geofences'.
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 (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.
129
Export to KML/KMZ
This option allows you to
export geofences from all available resources to a file.
When you export to KML/KMZ, the list of all available geofences (depending on item type chosen) is displayed. Check the 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.
130
Unit Properties Transfer
Almost any unit properties can be
General properties
Unit name, device type, phone number(s), unique ID(s), device access password (from the 'General' tab).
Icon
Unit's icon and the state of 'Rotate icon' flag. Note that transfer of an individual icon requires possession of the 'View item and its basic properties' right towards a unit the icon of which you are going to transfer.
Device configuration
Device configuration parameters (from the 'General' tab).
Counters
Current values of counters and their calculation parameters (from the 'General' tab).
Report properties
Parameters used in reports, as well as speeding and driver activity parameters from the 'Advanced' tab.
Advanced properties
Color parameters and messages filtration parameters from the 'Advanced' tab.
Sensors
Contents of the 'Sensors' tab.
Custom fields
Contents of the 'Custom Fields' tab.
Admin fields
Available admin fields from the 'Custom Fields' tab.
Commands
Contents of the 'Commands' tab.
Eco Driving
Contents of the 'Eco Driving' tab.
Profile
Contents of the 'Profile' 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 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.
131
Resource Contents Transfer
Any contents of a
resource can be imported and exported:
Geofences
Jobs
Notifications
Drivers
Trailers
Report templates
Transferring geofences from one resource to another, geofences' standard library icons can be transferred using one of the earlier described methods (KML/KMZ, and WLP import/export). The other geofences' images are transferred using
KML/KMZ files only.
Photos of drivers and trailers cannot be exported. If you need to transfer them, you can use the copying option instead of import/export.
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.
Note that importing drivers and trailers by the way of merge or replacement leads to the loss of all their attachments
(bindings).
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.
132
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
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.
Here is the list of settings that can be chosen for import/export:
Time zone
: time zone and DST.
Date and time settings
: date and time format, first day of week, and Persian calendar.
Additional information about the unit
: options from the section 'Show additional information about the unit' (they affect contents of unit's tooltip and unit extended view in the work list).
Monitoring panel configuration
: columns chosen in the Monitoring panel.
Unit visualization on map
: options from the section 'Unit visualization on map'.
Other items on map
: options from the section 'Other items on map'.
City
: the 'City' field on the 'Settings' tab.
Address format
: parameters for address format form the 'Maps' tab.
User interface parameters
: state of the log (open/hidden), shortcuts (on/off), settings for online notifications and messages.
Format of coordinates
: degrees or degrees and minutes.
Maps and layers
: choice of activated maps.
Mobile access
: access key to Wialon Mobile v1.
General flags
: checkboxes from the 'General' tab of 'User Properties' dialog (including host mask).
Custom fields
: custom and administrative fields from User Properties dialog.
Templates of access rights
:
templates of access rights created by this user.
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.
133
Measurement System And Conversion
Wialon works with different measurement systems: metric, U.S., imperial, and metric with gallons. The corresponding feature could be set for units, resources, and users during their creation. Measurement system for routes depends on user settings at the moment of creation.
The table below provides you with the units of measurement (and their abbreviations) for the systems used:
Metric U.S./imperial Metric with gallons
Mileage
(large values)
Kilometers (km) Miles (mi) Kilometers (km)
Mileage
(small values)
Meters (m) Feet (ft) Meters (m)
Speed
Fuel amount
Kilometers per hour (km/h)
Liters (lt)
Miles per hour (mph)
Gallons (gal)
Fuel consumption
Liters per 100 kilometers (lt/100 km) Miles per gallon (mpg)
Temperature
Degrees Celsius (°С)
Area
Weight
Hectares (ha)
Tons (t)
Carrying capacity
Tons (t)
Dimensions
Millimeters (mm)
Kilometers per hour (km/h)
Gallons (gal)
Kilometers per gallon (kpg)
Degrees Fahrenheit (°F) Degrees Celsius (°С)
Square miles (mi
2
) or feet (ft
2
) Hectares (ha)
Pounds (lbs) Tons (t)
Pounds (lbs)
Inches (in)
Tons (t)
Millimeters (mm)
Actually American and imperial systems both use the same units of measurement. The major difference is only in fuel amount calculation. You can find the difference between American and imperial gallon:
1 U.S. gallon ≈ 0.833 imperial gallon
1 imperial gallon ≈ 1.201 U.S. gallons
Conversion
The system of measurement for the elements which already exist could be changed with the help of conversion. Only top users have the 'Conversion' item in the
. The conversion can be made by a top user only. Conversion is available in the interface of the management system. To summon a conversion dialog, it is necessary to choose the
corresponding item in the user menu . The Converter dialog has the following view:
134
In the dropdown list, choose an object type (units, resources, users, routes) over which a conversion will be made. To the right of the dropdown list there is a brief description of the actions to be made over the objects of a corresponding type.
Below the object type choose initial and target measurement systems for a conversion. On the basis of an initial measurement system chosen a list of elements is formed. For example, if you choose 'Metric U.S.', a list of elements currently using the metric system is formed below.
In the list you choose the objects which should be converted. To add these objects for a conversion, use double-click or select an object and press the corresponding button (right arrow) between the lists. The added objects form the list on the right. To remove items from this list, either double-click them or select and press the corresponding button (left arrow). To select multiple items, click them holding <ctrl> on the keyboard. To convert the added items click OK and
confirm your actions in the appeared window. A 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
. If it is necessary, their measurement system could be changed manually choosing the proper one in the corresponding dropdown menu.
For Resources
If a conversion is implemented over resources, then some contents of these resources, particularly, 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
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 affect such items as geofences, jobs and notifications, because their measurement system is taken from a resource they belong to.
For Routes
Conversion made over routes affects only the radius of checkpoints.
135
Service Hierarchy
Attention!
This feature is available both for top users and dealers.
Service hierarchy is a sort of report providing you with schematic representation of the information concerning the structure of your service. Choose the corresponding item in the
user menu in order to generate a table containing
information on the types of macro objects used in your service, their amount, and the way these objects correlate with each other.
136
Activation of Modules
Managers of top level have access to one more item in the
— 'Activate Modules'. It is used to enable additional modules or packages such as '50 units', 'Advanced reports', '500 SMS messages' etc. If you have such an item, you can activate those modules yourself, without addressing to your administrator.
In the dialog, the list of available modules/packages is displayed as well as their cost. Select one or more modules and click OK. An alert will be shown where you should confirm your intentions or cancel the activation.
137
Apps
Using SDK , you can implement your own tools and features and add them to your Wialon as additional applications.
Applications can be managed only by top users. 'Apps Configurator' item of the
allows you to do this. Click on this item in order the 'Apps Configurator' dialog to be opened. It contains two tabs: 'Installed' and 'Library'. On these tabs you can have a look at all the applications available, as well as adjust the settings of the new ones and add them.
Installed
A list of added apps can be found on the Installed tab. There are 6 basic applications available to all users:
Chatterbox , Dashboard , iDriveSafe , Track Player , Eco Driving , Wialon Logistics . 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).
URL
Type URL address where your application is placed. Name and URL are mandatory, other parameters are optional.
Advanced URL parameters
Specify advanced URL parameters if necessary (Active SID, Current user, Base URL, Host URL, Language, Authorize hash).
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 this application will be available to.
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.
Other operations with applications:
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.
138
Added applications become available in
billing plans and in account properties on the '
List of Services ' 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 click 'Apply' and then OK.
See also Wialon Apps review .
Starting Applications
To start an application, click on the 'Apps' item in the
top panel . This action opens the menu containing the list of all
139
the app's name in order it to be opened in a new tab of the browser.
140
Cartography
All address information for online tracking and reports is taken from Gurtam Maps.
Maps in Gurtam Maps format are used. Gurtam Maps format refers to vector graphics files, 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.
Limited access is possible with the maps. It means that the detailed map of some town or region can be available only to users with certain billing plan. To add such maps, forward a request to [email protected]
.
Conversion Table: Polyline (PL)
Conversion Table: Polygon (PG)
Conversion Table: Polyline
.MP
Code Key
0x0001 highway motorway
0x0002 highway trunk
Value
highway trunk_link
.OSM
highway motorway_link
Keys
Gurtam Maps
Key_ values
Type
GM
Data level
Type
(0-2)
PL
PL
PL
PL
1
2 2
3
4
2
2
2
Comment
A restricted access major divided highway, normally with 2 or more running lanes plus emergency hard shoulder. Equivalent to the
Freeway, Autobahn, etc.
The link roads
(sliproads/ramps) leading to/from a motorway from/to a motorway or lower class highway. Normally with the same motorway restrictions.
Important roads that are not motorways. Typically maintained by central, not local government. Need not necessarily be a divided highway.
The link roads
(sliproads/ramps) leading to/from a trunk road from/to a trunk road or lower class highway.
Image Icon
0-4
5-7
0-4
5-7
0-4
5-9
10-
12
0-4
5-9
10-
12
141
0x0003 highway primary highway primary_link
0x0004 highway secondary highway secondary_link
0x0000 highway tertiary highway tertiary_link
0x000a highway unclassified
0x0042 highway unsurfaced highway track
0x0005 highway residential
0x0006
0x000b
0x0008
0x0009
0x0049 highway living_street
0x0007 highway service
PL 5
PL
PL
PL
6
7
8
2
Roads generally linking larger towns.
2
The link roads
(sliproads/ramps) leading to/from a primary road from/to a primary road or lower class highway.
2
Roads generally linking smaller towns and villages.
2
The link roads
(sliproads/ramps) leading to/from a secondary road from/to a secondary road or lower class highway.
PL 9 2 Minor roads.
PL 10
PL 11
2
1
The link roads
(sliproads/ramps) leading to/from a tertiary road from/to other minor roads.
Unclassified roads typically form the lowest form of the interconnecting network.
grid
PL 12 1 Unpaved roads.
PL 13
PL 14
PL 15
PL 16
1
1
1
1
Roads for agricultural use, gravel roads in the forest etc., usually unpaved/unsealed but may occasionally apply to paved tracks as well.
Roads accessing or around residential areas but which are not a classified or unclassified highway.
Streets.
A street where pedestrians have priority over cars, children can play on the street, maximum speed is low. Sometimes called
'Home Zone'.
Generally for access to a building, motorway service station, beach, campsite, industrial estate, business park, etc. This is also commonly used for access to parking and trash
142
0-2
3-5
0-5
6-9
0-5
6-7
0-5
6-8
0-5
6
0-3
4-7
0-3
4-7
0-5
6-12
0-5
6-7
0-4
5-7
0-2
3-5
highway bridleway highway cycleway cycleway lane cycleway track highway footway
0x0048
0x0016 highway pedestrian highway bus_guideway junction roundabout
0x0014 railway rail railway tram
0x001f waterway river
0x0018 waterway canal
0x0026 waterway stream
0x0044 waterway drain waterway weir waterway dam
PL 17
PL 18
PL 18
PL 18
PL 19
PL 19
PL 20 collection.
1 Roads for horses, cartage.
1 Cycleways for bicycles.
1
A lane is a route for bicycles that lies within the roadway.
1
A route for bicycles that is separate from the road.
1
1
1
Footpaths for pedestrians, e.g., walking tracks and gravel paths.
For roads mainly/exclusively pedestrians/shopping areas. Also for tagging squares and plazas.
used for
A busway where the vehicle guided by the way
(though not a railway) and is not suitable for other traffic.
PL 21 1 Circle movement.
PL 25
PL 26
PL 30
PL 30
PL 30
PL 30
PL 30
PL
143
31
1
1
2
1
1
1
1
1
Full sized passenger or freight trains in the standard gauge for the country or state.
One or two carriage rail vehicles, usually sharing motor road for trams.
For narrow rivers which will be rendered as a line.
An artificial open waterway used for transportation, waterpower, or irrigation.
A naturally-formed waterway that is too thin to be classed as a river. An active, able-bodied person should be able to jump over it if trees along it are not too thick.
An artificial waterway for carrying storm water or industrial discharge.
A barrier built across a river, sometimes to divert water for industrial purposes. Water can still flow over the top.
A wall built across a river or stream to impound the water. A dam normally
0-3
4-7
0-3
4-6
0xf201
0xf002
0x2f08
0x2f17
0xf001
0xf003
0xf004 aeroway runway PL 35 1 does not have water flowing over the top of it.
A strip of land kept clear and set aside for aeroplanes to take off from and land on.
0x0045
0x001d boundary administrative admin_level 8
0x001c
0x001e boundary administrative admin_level border_type
2 nation
PL 191 1 State, county, local council.
PL 192 1 Region boundary.
PL 193 2 National boundary.
Conversion Table: POI
.MP
.OSM
Code Key Value
highway traffic_signals
Gurtam Maps
Type
GM
Data level
Type
(0-2)
POI 50
Comment
0 Lights that control the traffic.
highway bus_stop POI 51 0 A small bus stop.
0x5900
0x5901
0x2f03
0xf007
0x4600
0x2d02
0x2d00
0x2a0e
0x4500
0x2a0d
0x2f0b
0x2f02
0x2f01
0x4400
0x2e05
0xf001 highway metro highway tram highway airport highway services railway station amenity pub amenity nightclub amenity cafe amenity restaurant amenity fast_food amenity parking amenity car_rental amenity taxi amenity fuel amenity pharmacy amenity hospital amenity bus_station
POI 500
POI 501
POI 503
POI 52
Metro.
A tram stop.
0
Airport.
A service station to get food and eat something, often found at motorways.
POI 53
POI 55
POI 55
POI 55
POI 55
POI 55
POI 56
POI 56
POI 56
POI 57
POI 58
POI 58
POI 60
0 A railway station.
0
A place selling beer and other alcoholic drinks; may also provide food or accommodation.
0 A nightclub.
0 A cafe.
0 A restaurant.
0
An area with several different restaurant food counters and a shared eating area.
Commonly found in malls, airports, etc.
0 Car park or a parking.
0 A place to rent a car.
0 A place where taxis wait for passengers.
0
Petrol station, gas station, marine fuel, etc.
0 A pharmacy.
0 A hospital.
0 Bus station.
144
Image Icon
0x2f06 amenity bank amenity atm
POI 61 amenity bureau_de_change POI 61
POI 61
0 A bank.
0
Currency exchange, a place to change foreign bank notes and travellers cheques.
0 An ATM or cash point.
0x2b00
0x2b01
0x2b02 tourism hotel POI 62 0 A hotel, a motel, a guest house
0x0100
0x0200
0x0300
0x0400
0x0b00
0x0c00
0x0d00
0x0e00
0x0f00
0x1000
0x1100
0x0010
0x0500
0x0600
0x0700
0x0800
0x0900
0x0a00
0x0006
0x0004
0x640a tourism hostel place city place town
POI 62
POI 302
POI 63
POI 64
0 A hostel.
Capital.
2 A megalopolis over 5 million people.
2
A city of 1-5 million people (MP).
A city over 100 thousand people
( OSM ).
place village_greenhamlet POI 66 1 A village below 10 thousand people.
0x6602
0x1e00
0x1f00 place continent place state place region place country
Conversion Table: Polygon
.MP
.OSM
POI 65 1-2 A town from 10 to 100 thousand people.
POI 67 0 Captions.
POI 195 2 A continent.
POI 196 2 A state.
POI 197 1 A region.
POI 198 1 A country, area.
Gurtam Maps
Code Key Value Type
GM
Data level
Type
(0-2)
Comment
0x0047
0x003b
0x0045
0x0049
0x0040
0x0041 divided by size divided by size
0x0028 waterway natural landuse waterway riverbank water reservoir riverbank
PG 130 2
Used for large rivers, to define an area between the opposite riverbanks.
PG 131 2 Lakes, water bodies, etc.
PG 131 2 An artificial reservoir.
PG 132 2 Sea, ocean.
PG 133 2 A large river.
145
Image Icon
tourism tourism tourism tourism tourism historic
0x0050
0x0081
0x0082
0x0083
0x0084
0x0085
0x0052
0x008f
0x0090
0x0091
0x0001
0x0002
0x0003 landuse landuse landuse leisure
0x004e
0x004f
0x008e
0x0086
0x0087
0x0088 leisure
0x006d amenity
0x001a landuse
0x000a amenity amenity amenity
0x3002 amenity shop building tourism tourism park garden
PG 140
PG 141 townhall grave_vard school university college hospital supermarket
PG
145-
146
1
A town hall building (mayor's office), administrative building.
PG 147
PG 148
PG 148
PG 148
PG 149
1 A graveyard, a cemetery
1 A school.
1 A university.
1 A college.
1 A hospital.
PG 151 1 A supermarket.
camp_site caravan_site picnic_site
PG 153 0
Camping, a place where you can pitch a tent.
PG 153
PG 154
0
0
A place where you can park a caravan overnight or for longer periods.
A place where you can have an outdoor picnic. May have facilities such as tables and benches.
PG 155 1 Theme park, amusement park.
theme_park attraction zoo artwork
PG 156
PG 157
PG 158
0 A general tourism attraction.
1 A zoo.
1 A tag for public pieces of art.
archaelogical_site PG 159 0 Archaeological museum.
forest residential retail
PG 165
PG 166
PG 167
1 A park, open green area for recreation.
1 A garden.
2 Managed forest or woodland plantation.
1
Predominantly houses or apartment buildings.
1 Predominantly shops.
landuse
0x000c landuse commercial industrial
PG 168 1
Predominantly office buildings, business parks, etc.
PG 169 1
Predominantly warehouses.
146 workshops, factories,
0-2
3
0-2
3
0-3
4-7
0-3
4-7
0-3
4-7
0-3
4-7
0x0006 landuse landuse landuse landuse
0x0004 landuse landuse
0x0014
0x000d
0x0015
0x0016
0x0017
0x001e
0x001f
0x0020
0x0098 natural
0x0051
0x0096
0x008b natural
0x0018 sport building blownfield greenfield railway construction millitary airport wood marsh golf palace
PG 169 0 Garages, vehicle sheds.
PG 170 1 A district to be developed, an empty area.
PG 170 1
Describes land scheduled for new development where there have been no buildings before.
PG 171 1
Area for railway use, generally off-limits to the general public.
PG 172 1 Something under construction.
PG 173 1
For land areas owned/used by the military for whatever purpose.
PG 401 1 Airport area.
PG 184 2
Natural woodland (trees). Only for completely unmanaged/wild areas.
PG 185 1
Low poorly drained land that is sometimes flooded and often lies at the edge of lakes, streams, etc.
PG 194 1 Golf course, football, stadium.
PG 207 1 A palace.
building building
0x006f
0x006f amenity postoffice restaurant
PG 208
PG 209
1 A post office.
1 A restaurant.
public_building PG 210 1 Public building.
0x0013
0x006c building yes denomination baptist catholic christian evangelical lutheran roman_catholic
0x9999 surface
Scale (Gurtam Maps)
PG 210 1 General tag for buildings.
PG 211 0 A church.
PG 212 2 Bottom surface.
147
0-3
4-7
0-2
3
0-2
3
0-2
3
0-2
3
0-2
3
0-2
3
20
50
100
150
2
5
10
200
500
Scale (km) Scale (m) Data level Zoom level Value
0,02 20 0 -1 2000
0,05
0,1
0,15
0,2
0,5
1
50
100
150
200
500
1000
0
0
0
0
1
1
0
1
2
3
4
5
5000
10000
15000
25000
50000
1000000
2000
5000
10000
20000
50000
100000
150000
200000
500000
2
2
1
2
2
2
1
1
1
9
10
11
12
13
14
6
7
8
2000000
5000000
10000000
20000000
50000000
100000000
150000000
250000000
500000000
148
Monitoring System
The monitoring system is used by end users
to control their
(vehicle fleet, machinery, employees, pets, etc.).
Unit tracking includes: detecting unit position and
observing dynamic change of various unit parameters such as speed, fuel level, temperature, voltage, etc.; management of units (sending
and messages, assigning
, adjusting
(phone calls, SMS , registering work shifts, binding to unit, etc.);
interpreting information derived from a unit in various kinds of
(tables, charts, movement tracks, event markers, complete statistics, etc.); and much more.
Tracking results can be either presented on a computer screen or exported to files in different formats.
149
Quick Start
1. Login
Key in your user name and password on the login page, and press 'Enter'.
The list of supported browsers is provided in the '
System Requirements and Optimization
' section.
2. Interface
above the work area.
On the right, there is usually the map.
Wialon's interface is developed to be user friendly that is why we can choose the panels of main menu we need to work with. They are: Monitoring, Messages, Reports, Geofences, Notifications, Units (
in this task).
Dragging the
which will be the basic for you in the tracking process.
150
3. User Settings
settings' button in the dropdown menu. Afterwards, follow the steps:
First and foremost, indicate your time zone.
Secondly, indicate a type of daylight saving time used in your region.
Make sure you have selected the above mentioned settings properly, because they could influence the correctness of data presented in reports, messages, tooltips, jobs, routes, and elsewhere throughout the system.
Indicate
entries to the tracking system.
Preparatory work is finished. Now let us create a tracking unit.
4. Creating Unit
Before configuring a unit, make sure the device is directed to Wialon. For more information on server IP, port, phone number, and the like, find your type of device in the list of supported devices and set the required parameters.
Open the '
Units ' panel in the work area and press the 'New' button.
The dialog with multiple unit settings will be displayed. Give a name to the unit, indicate device type (click inside the field to see the list of available devices), enter unique ID (IMEI or serial number) and the phone number of the SIM card inserted into the device.
151
The 'Icon' tab of the dialog provides an opportunity to choose the most appropriate image to display the unit on the map.
On the 'Advanced' tab specify Speed limit, km/h. This setting is used to generate reports on speedings.
At the end press OK button. The newly created unit will appear in the list. Click on a unit name to locate it on the map.
It will also appear in the monitoring panel.
152
5. Unit Check
a) Log
After creating a unit, data from it starts coming in the system as long as the unit is configured correctly. Each incoming message appears in the
. To see the log, open it pressing the button in the bottom right-hand corner of the program.
Along with the messages coming from tracking units, the log also shows current actions and operations such as creation and modification of geofences, notifications, unit properties, etc.
b) Unit info tip
Hover the mouse pointer over the unit in the 'Monitoring' panel or on the map to see the latest data in a
: last message time, location (address or coordinates), speed, etc.
c) Messages panel
The most reliable way to check unit operability is to view its messages
. To switch to the 'Messages' panel, click on the
messages
panel in the main menu. Then in the work area select an interval to get messages for, and press 'Execute'.
Results appear on the right. There you can estimate how many messages were received during the indicated period and what kind of data they present. Besides, the track of unit movements is shown on the map.
153
6. Creating Geofences
and press the 'New' button.
The simplest and quickest geofence type to create is circle with specified radius. Enter name for the geofence and select the type Circle. Then double-click on the map in the place of supposed geofence. Alter the radius if necessary and press 'Save'.
In a similar way, create as many geofences as necessary.
If you need a geofence of a more sophisticated form, choose type Polygon or Line. However, in this case a greater number of points is required to specify geofence's borders.
7. Notifications
154
Now we can create a
notification about a unit entering a geofence. Go to the Notifications panel and press the 'Create
Notification' button.
Moving through the dialog with the help of the 'Next' button, set the following parameters for the notification:
1.
Select your unit (tick it).
2.
Choose a control type (in our example we choose Geofence).
3.
Specify a check type (Inside geofence), and select necessary geofence(s) from the list below.
4.
Leave default notification text without changes.
5.
Choose a method of a notification delivery, for example, Display online notification in a popup window.
6.
Enter a name for the notification.
7.
Press ОК.
When the notification triggers, it will appear in the top right corner of the program.
8. Reports
To switch to the
, click on the corresponding panel in the menu above the work area.
First of all, we need at least one
report template to generate a report according to parameters set there. We are going
to create a report template containing two
(visits to geofences and speeding) and a chart
.
To create a report template, go to the Reports panel and press the 'New' button. At the top of the template properties dialog, you see two important buttons — 'Add Table' and 'Add Chart'.
155
Press the 'Add Table' button and set table type to Geofences. On the left, tick the columns to be displayed in the resulting report. On the right, choose geofence(s). When finished, press OK. The table will be added to the report.
Then add the second table — press 'Add Table' again and choose a table of Speedings type. For this table we have set the parameter Speed limit in unit properties ('Advanced' tab). In additional parameters indicate that a speeding should last at least one minute (Min duration parameter). Press OK. The table will be added to the report.
Then press the 'Add Chart' button and select the necessary
type (for example, mileage in trips). Note that for many charts to be generated the appropriate sensors are required. Press OK.
156
This is how our report template looks like after we have added two tables and a chart. Report contents are displayed on the left. Now give a name to the report and save it.
To obtain a report, set parameters in the work area: select report template, unit, reported interval, and press 'Execute'.
Generated report will appear on the right. On the left, you see tabs to navigate between report sections (tables and charts). Besides, the report can be exported to various formats or printed (for this, use the proper buttons — 'Export to
File' and 'Print').
157
158
User Interface
User interface of Wialon 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. Moreover, special icons are situated in the interface . They are used to deal with the most 'difficult places', as a help text will be opened by clicking on any of them.
Generally, the following basic structural elements could be distinguished in the interface design:
There are also a lot of other different panels and windows which could be activated if necessary.
Note.
To switch for the full-screen mode, press <F11> button. This feature is provided by the majority of
Further information:
159
160
Login
Enter service URL into the address line of your
On the login page, type your username and password given to you while registering. Note that characters used in these fields are case sensitive. Afterwards choose the interface language. Moreover, depending on your service configuration, you may have a possibility to choose branches for your DNS:
Stable: stable branch, rarely added with updates.
Beta: a branch containing the latest updates developed for the monitoring system. This branch is intended for the analysis of Wialon Hosting updates.
After all the necessary fields are indicated, click 'Enter'.
If you are using a private computer, you can additionally put a check mark near 'Remember'. In this case, the next time you enter the system you will not be asked to input your login and password again. Moreover, this flag is necessary to automatically enter the system in case of session loss. Note that the term of use of this flag is limited to 30 days.
Besides, the flag is unchecked if you logout from the system.
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').
New Password Receiving
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.
161
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.
How to Change Your Password
The current password can be changed after authorization in the '
' dialog. However, not all the users are allowed to do this. Contact your service administrator for additional information.
Login as Another User
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 possess the 'Act as given user' right towards a user.
If you would like to login as another user from the authorization page, it is necessary to enter your username and password, as usual, and then click on
'Login as'
caption and enter login name of a needed user in the appeared field. When you are logged in as another user, you can see only items available to this user and perform actions allowed to this user. Note that login history is saved to this user as well.
You can switch to another user even after entering the system, however, in this case your logging in will not be saved in the user's history. To do so, it is necessary to click on the icon (door with arrow) to the right of the username.
Afterwards, the dialog containing two columns (user name and account name) is opened.
may help you to facilitate a search of a user. The search is made either by user name or account name. Click the line of a necessary user to fulfill an authorization in the current tab, or click an icon in the end of the line to do it in a new tab.
There is also an alternative way to log in as another user. 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
confirm your action by pressing OK in appeared window.
162
Top Panel
The logo of tracking services provider is situated in the left corner of the top panel and in the right corner you can see the setting menu button and user name under which you have logged in to the system.
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
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
dialog for viewing and/or editing.
Manage applications
Opens the
dialog.
Locator
Opens the
Import/Export
Enables to transfer units' settings, users, resources' contents (refer to
Help
Help request. Could be unavailable.
Technical 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. To activate those options, contact Gurtam Help System and provide corresponding URL addresses.
Information Notices
the amount of days left before blocking the tracking system (if stipulated by the tariff agreement).
163
164
Work Area
Work area, where different actions with various elements of the system take place and different requests to be composed, is situated in the left part of the screen.
Depending on the tag chosen in the top menu, one of the following panels could be opened in the work area:
Monitoring — tracking units position, state and movements.
Tracks — viewing movement history.
Messages — viewing messages come from units.
Reports — wide range of survey instruments and sorting of data received from a unit.
Geofences — creating, editing, removing geographical areas.
Routes — creating and monitoring a unit's traffic route according to its schedule.
Drivers — creating drivers and assigning them to units.
Trailers — creating trailers and binding them to units.
Passengers — creating passengers and binding them to units.
Jobs — creating, editing, removing jobs performed by schedule.
Notifications — creating, editing and removing events' notifications.
— managing other users.
Units — managing available units.
Top menu also could include two panels which are not shown in the work area. They have their separate windows.
They are:
Search on Map — dynamic search of system's micro objects on the map;
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 .
Main Menu Adjustment and Navigation
To adjust the main menu click the customizer icon and select the menu items 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 to facilitate navigation through the panels.
165
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.
Alternative Means of Navigation
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.
166
Bottom Panel
At the left end of the bottom panel you see three buttons to manage unit display mode as well as SMS button:
— hide/show
;
— hide/show
In the right corner of the bottom panel the following buttons are situated:
— hide/show
— hide/show
or
— hide/show
— hide/show
Current time and time zone shown in brackets (which could be changed in
) 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.
167
Map
The map is available regardless of which panel is activated. Usually, it occupies the most of the screen. Units and their
traces, geofences and other elements can be displayed on the map.
Map size can be adjusted in relation to
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
Visible Layers
The map provides a possibility of working with graphical layers. In other words, different graphical layers can be enabled/disabled on the map. The layers display graphical elements of such panels as monitoring, tracks, messages, reports, geofences, routes, drivers, trailers, and passengers.
Layers can be displayed on the map upon presence of the corresponding panels in the main menu only. For example, if the main menu contains a monitoring item, then on the map you can enable the same layer showing a current location of indicated units. Add an item to the main menu, and a corresponding layer will be automatically enabled on the map. Remove an item, and a layer will be disabled.
Enabling/disabling of a graphical layer is implemented in the layers menu. To summon this menu, click the 'Eye' icon
(top left corner of the map). The layers menu is divided into 2 sections: panels' layers (left) and units' layers (right).
Every graphical layer is presented by the icon of its panel. The work with the panels' layers is described above. The
units' layers serve to control units' view on the map
(arrows, traces, and names).
Using the Map While Working with Different Panels
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, 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
168
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', 'Geofences',
'Routes', 'Drivers' and 'Trailers'. 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 top left corner of the map. 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, maritime navigation, 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.
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 condition or maritime navigation. To enable it, you should select the corresponding flag in the section of additional layers in the map choosing menu ('Google Traffic', 'Yandex Traffic', etc.).
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
To navigate through the map (to move a map on the screen), click the map (left mouse button) and drag it to the side needed.
Zooming the Map
Map zooming can also be implemented in several ways:
1.
Using scale on the map
Zooming scale is situated in the top right corner of the map under navigation buttons. The scale allows to zoom in (+) or zoom out (-). At the same time, the center of the map is staying stable.
You can press '+' and '-' buttons to change zoom in step by step mode, or click on any place on the gradation scale.
2.
Using mouse scroll wheel
It is even more convenient to adjust zoom level using mouse scroll wheel. Scroll up corresponds to zoom in, scroll down — to zoom out. During the scrolling action, point a mouse cursor on the place needed so that it would not get out of sight.
3.
Using mouse and <shift> button
To zoom in the chosen area, hold <shift> button and select some area of the map with the left mouse button, the map will be zoomed within this area.
4.
Using double-click
Double-click on any place of the map to zoom it in.
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
.
169
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
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, geofences, user settings changes, etc. Red color is used to display error messages and alarm messages from units.
Note.
When emptying a black box or retransmitting past data, messages older than an hour from latest known positional message of a unit are omitted in the log.
170
Shortcuts
Keyboard shortcuts ensure more convenient and quick means to navigate through the system. This feature is activated
.
Shortcuts for panels navigation:
M
;
T
E
—
;
R
;
G
—
O
—
D
;
I
—
.
J
—
;
N
;
U
;
Y
—
Shortcuts for tools activation:
1
—
2
—
3
—
;
4
—
5
—
6
—
7
—
8
—
9
—
F
Other shortcuts:
A
S
—
~
— show/hide
L
— show/hide
171
Calendar
The calendar is used in many cases: specifying time intervals to generate reports, indicating date and time in notifications, jobs, routs, etc.
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.
The Persian Calendar
172
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.
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.
173
Filters and Masks
Lists are composed of various objects created in tracking system (geofences, 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.
Filters and masks are applied for users' convenience. They enable to narrow a list of items in such a way that only the objects necessary for users will be shown. Also, you can find objects with particular characteristics or name in a list and specify the objects of tracking system towards which a report, notification, etc. will be applied.
Dynamic Search
If a list contains a great number of items, it may not be so easy to find a necessary one quickly. For your convenience,
,
, 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 available items will be displayed in a list.
The dynamic filter can also be found in unit properties dialog,
unit groups , and users when adjusting access rights.
Moreover, dynamic filter is used for choosing a resource upon creation of notifications, jobs, geofences, drivers/trailers
(their groups, automatic binding lists), and also report templates.
The peculiarities 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
Name Mask
Besides the dynamic search, filters are also used for specification of an item, which will be effected by
, 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 special 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.
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
174
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.
Masks are employed:
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
;
in the Messages panel to
found messages; in all panels masks can be used instead of the
.
Manipulations with Lists
Keyboard keys and their combinations can be used working with lists. Using the keys facilitates a lot of operations, such as list navigation, search of necessary items, and their selection.
Dropdown Lists
Dropdown lists are commonly used in the monitoring system. They provide a possibility to work with large amount of items. 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.
Upon building tracks or querying messages and reports, you can use dynamic search in dropdown lists. Dealing with tracks and messages you can quickly find a necessary unit in the dropdown list, dealing with reports you can find templates or objects. To use a dynamic search, click a corresponding dropdown list and start entering a name of a necessary unit/template/object.
Special character asterisk (*) can be used to facilitate a search. As a result, a
dropdown list is filtered according to the indicated symbols.
To work with a dropdown list, you can use a keyboard. Utilize arrows (up/down) for navigation through the list and
<enter> for choosing a necessary item.
Multiple Select Box
In the lists of such type you can choose multiple items. To choose several items throughout the list, hold <ctrl> button, and consequently click on the necessary items.
175
Moreover, the following keys, and their combinations can be used:
<home> — move to the list beginning;
<end> — move to the list end;
< > (arrow up) — move to the previous item;
< > (arrow down) — move to the next item;
<ctrl + A> — choose all;
<shift + home> — choose everything from the current place to the list beginning;
<shift + end> — choose everything from the current place to the list end;
<shift + > — consequently choose the items going up from the current one;
<shift + > — consequently choose the items going down from the current one.
Checkbox list
Multiple choice lists may contain checkboxes indicating whether the item is chosen or not. <ctrl + click> combination can be used in such lists in order to check/uncheck all the items at once.
Attention!
Working on MacOS it is necessary to use <cmd + click> combination instead of <ctrl + click> one.
176
Input Rules
All editable fields are checked to approve that entered data is valid. If there is incorrect data, the field is highlighted red.
Incorrect entries are:
Not enough characters in the name or a phone number. Names of monitoring units, units groups and users must consist of at least 4 characters. Other objects like places, geofences, drivers, report templates, etc. can have names from one character.
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 \
Partly forbidden characters:
spaces
are not allowed at the beginning and at the end of editable fields, however, they are allowed at the middle);
comma
cannot be used in numeric fields as the delimiter (for entering fractional numbers the dot is used).
in report templates (column names, table titles, and statistics fields) you cannot use comma, colon, or & symbol.
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.
Phone numbers and e-mail addresses
Phone numbers
must be in international format . They must contain all necessary codes (country code, communication statement or city code, and then the phone number itself). Brackets, spaces and hyphens are not allowed. The only character that is used entering phone numbers is plus (+) which, if necessary, could be typed before the digits. Examples: +19176726154, +15551234567.
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: [email protected].
177
User Settings
Users can configure some system operation parameters according to their
needs and tasks.
Note.
User settings can be changed if the corresponding flag has been indicated in
To view user settings click on the username in the top panel
and then choose
User Settings
in the menu.
The 'User Settings' dialog can contain up to three tabs that depend on system configuration:
Hint.
Settings from one user can be imported to other users.
178
General Settings
The first tab of the
contains general settings. Here you indicate your time zone, input your e-mail address, change the password to enter the system, and set many other parameters.
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.
Daylight saving time
Specify DST options if you use summer and winter time in your region — choose the most appropriate DST schedule on the dropdown list. None — summer time is not used.
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.) Note that the Persian calendar can be used to indicate particular dates of an interval only (from – to).
Working with 'quick intervals' ('Today', 'Yesterday', 'Week', 'Month', 'Year'), the Gregorian calendar is applied. 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
).
Enabling/disabling the Persian calendar requires reloading the page.
Date and time format
These masks of date and time format define date and time presentation throughout the system. For example, months can be written in words or numbers, year can consist of two or four digits, day of week can be included or not.
Moreover, you can change the order in which those items appear in the date. Instructions upon the syntax of these fields is given in their tooltips. Besides, you can just choose one of predefined masks in the dropdown list. Here are some examples of formats:
Date mask
yyyy-MM-dd
Time mask Result 1
HH:mm:ss 2014-01-25 09:45:33
Result 2
1987-12-02 17:20:00 d/MM/yy HH:mm 25/01/14 09:45 2/12/87 17:20 d MMMM yyyy dddd hh:mm:ss tt 25 January 2014 Saturday 09:45:33 am 2 December 1987 Wednesday 05:20:00 pm dd MMM yyyy ddd hh:mm tt 25 Jan 2014 Sat 09:45 am 02 Dec 1987 Wed 05:20 pm
179
First day of week
Choose Monday or Sunday as the first day of week. This will affect the appearance of the
counting weeks in general.
Measurement system
Choose one of the
measurement systems available. The corresponding units of measurement will be used in
like
Distance, Area, Routing, Nearest Units. A chosen measurement system also influences address processing in some way, as well as creation of
routes . However, the earlier created units and resources (together with geofences, jobs,
and notifications) possess the measurement system chosen upon their creation. Speaking about reports, their
measurement system is set separately (refer to ' Advanced settings of a report template
').
City
In this field you can indicate your city. It will be used in the
Address tools as the default city. Enter
the name of the city. Upon entering of the first letters the dropdown menu with the names corresponding to the request will be automatically opened. You can either continue typing in the name or choose it from the dropdown menu (there can be several towns with the same names in different countries).
Position of the map upon entering the tracking system is stipulated by the city indicated in this setting (if the field is blank, then Minsk is considered to be a chosen city by default). However, if there are any units displayed on the map, then upon the entering the map will be scaled in such a way that all of them will be visible.
This e-mail address will be used to send you a reset password link in case you forget your password.
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.
Mobile access
If you are going to use
mobile phone or PPC to manage the server, enter the access key. If you leave this field empty,
the access will be denied.
Play sound for events
The sound can be played for
. When a notification or message from driver pop up, the browser will play sound. In Windows OS, QuickTime Alternative can be used as media player.
Automatically display popup events
In order
messages from drivers to be automatically shown on the display, it is necessary to
indicate this flag. If you remove the flag, only a number on red background in the bottom panel indicates receiving of new events.
Closing online notifications window or chat with driver window using the cross in the upper right corner leads to unchecking the 'Automatically display popup events' flag. The flag can be checked again either in the user settings window or by clicking on the 'Online notifications' or 'Chat with drivers' buttons in the bottom panel.
Use keyboard shortcuts
Check this box to activate Shortcuts
.
Infinite map
Allows moving (dragging) the map infinitely right or left. This option is to be activated only in the case when tracking occurs in the region of 180th longitude (Fiji, Chukotka, etc.).
Driver's activity
Check this box in order an information on driver's activity to be shown in unit's and driver's
, as well as in
Render charts on server
Indicate this flag in order static charts to be used in the monitoring system.
Show Additional Information about the Unit
Here you choose additional information about the unit to be displayed in different places of the tracking system.
180
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.
To check all the items from any column, hold <ctrl> on the keyboard and check any box of the corresponding column.
Last message
Time when the last message was received and how long ago.
Location
The last detected address.
Presence in geofences
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
Altitude in the latest message (if device is able to give such data).
Counters
Values of mileage counter and engine hours counter. See
Satellites
The number of satellites locked.
Connectivity settings
Device type, unique ID(s), and phone number(s) specified in
unit properties . This information is available to users with
'Edit connectivity settings' access flag.
Sensors values
processed according to calculation table of this sensor.
Parameters
Latest known
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.
Drivers
Name, photo, and phone number of the
currently bound to the unit.
Trailers
Name and photo (if available) of the
currently bound to the unit.
Custom fields
Custom fields from unit properties (general or/and admin fields depending on access).
Profile
Unit's
Maintenance state
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.
Unit Visualization on Map
Replace unit icons with motion state signs
181
If marked, unit
are hidden, and all units are displayed with motion direction arrows (if they are in motion) or with blue rhomb shaped marker (if they are stationary). See also
Display overlapping units in one icon
If two or more units overlay each other on the map, then their icons are grouped into the common one. It facilitates visual perception of the map. The common icon has a value indicator showing a number of units in it. To see a list of units the common icon contains, summon its pop-up window by pointing mouse cursor over the icon.
Upon clicking the common icon the map is scaled in such a way that all units of the common icon get into vision field.
Note that overlaying icons cannot be grouped into the common one on the 2 largest scales. Accuracy is the topic issue viewing map on such a scale, therefore all unit icons will be displayed regardless to the overlaying.
Show unit icons at map borders
If a unit gets out of view, its icon will be displayed at map border in the direction where the unit is located. Click on this icon to move to this unit on the map.
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.
Multicolor sensors in unit's tooltip
Sensors, if chosen to be displayed in unit's tooltip, can change their colors according to received values. Color scheme can be adjusted on the first tab of
sensor's properties . In unit's tooltip, color can be applied either to the whole row with
sensor (both its name and value) or only to its value — select desired option in the dropdown list. If the option
'Multicolor sensors in unit's tooltip' is disabled, default color (black) will be employed.
Other Items on Map
Display names of routes' check points on map
Depending on the flag,
routes' check points can be displayed with or without their names on the map.
Display names of geofences on map
Depending on this flag,
geofences can be displayed on the map with their names or without them. The color of the
captions is adjusted in geofence properties .
Display overlapping geofences in one icon
If several icons of geofences overlap when displayed on the map, they can be grouped into one. Place the cursor over this icon to know which geofences are hidden behind it. Note that for reports this option is set independently — in
advanced options of report template.
Render geofences on server
By default, all
geofences are rendered in browser. This may slow down browser work if your computer is not very
powerful. But if you have good Internet connection, it is possible to increase Wialon system performance by enabling the option of rendering on server.
182
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 geofences coordinates can be displayed only
in degrees; in reports and event registrar — only in degrees and minutes.
Available maps
To activate necessary map layers, indicate corresponding flags. Changes are applied after clicking 'OK' and refreshing
the page. To choose a different map as a base layer, choose it in the maps menu
.
The following maps can be used in Wialon: Google, Bing, Kosmosnimki, 2GIS, WikiMapia, Visicom, Yandex, HERE,
Regio, Luxena, what3words, MyIndia, ArcGIS, GoMap.az, Mapbox, OpenSeaMap (additional layers). Besides, Gurtam
Maps 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 (for example,
traffic layer, maritime navigation), then they can be visually put over any chosen map.
If a map you need is not available, address your request to Gurtam Help System .
Usage of cartographic services is stipulated by the procedures established by the author or by other right holder of such services. By choosing cartographic service you confirm that you acknowledge and accept the full responsibility for its possible misuse.
Address format
Here you can define how addresses will look in tooltips, tools, messages, and other places. Choose which of standard address components to be displayed: country, region, city, street, and house (at least one of these items should be selected). For example, if your units move mainly within the same city or town you can omit country, region, and city and leave only street name and house number in addresses. Address components can be put in any order. To change this order, drag components up and down sticking to arrow-shaped buttons. This format affects addresses mainly in 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
183
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.
For every block (enabling maps, address format) there is a possibility to check all the boxes at once. To do so, hold
<ctrl> button on the keyboard and check any box of the corresponding block.
184
Account
Attention!
This tab could be unavailable due to the service configuration peculiarities.
On the 'Account' tab of
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 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.
185
Monitoring
The 'Monitoring' panel displays the work list of units and gives access to the basic features connected with tracking.
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
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
To open 'Monitoring' panel, choose a corresponding name in the
or click on the necessary item in the
To locate a unit on the map, click on its name in the
work list . The map will be centered on this unit. At that, current
map zoom will remain the same.
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.
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
. 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.
To track stationary units, make use of a specially designed app — Sensolator .
186
Unit Presentation on Map
By default, units on the map are displayed with
icons assigned to them and their names (captions color is red). Icons
for units can be selected from a standard set, e.g. , or you can load your own image. See the dialog
. Unit icon can be rotated on the map according to course (movement direction). This feature is also defined in unit properties.
Icons overlaying each other on the map can be replaced by the common icon with a number indicator. To do so, choose the option '
Display overlapping units in one icon ' in the 'User Settings' dialog.
Alternatives for Icons
Unit icons can be replaced with motion state signs: 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 the arrow showing 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 depend on a sensor value. This functionality is adjusted on the '
Advanced ' tab of unit properties. In other words, the shape of the icon is defined by
state (standing still — square, moving — arrow), and the color depends on sensor value (intervals and colors are adjusted in
Unit names can be either shown or hidden upon displaying a unit on the map. It depends on the state of the button (
on the map.
Displaying Inactive Units
Monitoring units are conditionally divided on active and inactive ones. If data messages from a unit have not been received for more than 48 hours, then a unit is considered to be inactive.
Unit's icon and its name can help you to find out unit's condition. Inactive units are displayed on the map with a blurred icons and transparent names. If signs of motion are used instead of icons, then transparency will be used both for signs and names. If the flag 'Display overlapping units in one icon' is chosen in 'User Settings', and all the units with overlapping icons are inactive, then the icon for them will be displayed blurred. Moreover, either drivers' or trailers' icons binded to an inactive unit are also displayed blurred until unbinding.
187
Displaying Units with 'LBS Detector'
'LBS detection' is an alternative method of finding units on the map. The accuracy of this method is inferior to the defining location using GPS, but in case of experiencing any troubles with GPS connection you can switch to the 'LBS
' on the
'Advanced' tab of unit properties dialog. Therefore, if 'LBS detected' data is more recent than GPS one, then it will be used for determining current unit's location.
Upon using 'LBS detection', units are displayed on the map the following way: current icon is placed into a transparent white circle with a red dashed line border, the brightness of an icon is reduced.
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
Direction arrows, traces, and names can be disabled. To do so, use the corresponding buttons in the
on the map:
— hide/show unit traces;
— hide/show unit movement directions;
— hide/show names of units.
188
Minimaps
Minimap is an additional window (help window) focused on the current information about the chosen unit. Double click on unit's name in the monitoring panel list to open its minimap. The chosen unit is also centered on the map. Moreover, the window can be open by double-clicking a unit on the map. However, in this case the unit is not centered on the map.
Note that if no messages with coordinates have been received from a unit, then no actions take place when you double click on it.
Minimap Modes
There are two modes available for minimaps: map mode, and info mode. They can be switched using the corresponding button in the right corner of a help window header .
Map
The main purpose of a map mode is to show a unit location, as well as its speed and address from the last received message. The map cannot be moved, because it is automatically centered on the unit's last location and the unit does not leave the field of view. Except for this peculiarity, working with help windows in map mode is completely identical to working with the main map.
Moreover, in the map mode you can activate Google Street View . This is a submode which provides a possibility of tracking units on 'real' streets. Google Street View is a technology featured in Google Maps that provides panoramic views from positions along many streets in the world. Its coverage spreads throughout Western Europe, North
America, Australia, Japan, Brazil, and some other countries.
189
This submode works only if Google Maps are activated in
'User Settings' and if there is
coverage for requested geographical area.
Info
Switch to the info mode using the corresponding button in the minimap header. Here you can find the main buttons and icons chosen for the monitoring panel work list. Moreover, info mode includes additional information about the unit configured in the
dialog.
Online Notifications in Minimaps
Minimaps provide you with an alternative way of viewing online notifications
. Upon online notification triggering an opened minimap of a corresponding unit is highlighted in red. If the minimap is hidden, then it will be shown automatically upon receiving of a notification. To receive and view online notifications in minimaps, it is necessary to
check the 'Blink minimap' flag while choosing a notification action
.
An icon indicating a number of unread notifications appears in a minimap's header near the mode switcher. Click the icon to view received notifications. The concept of work with notification is identical to the one used in online notifications window. To return to the initial mode used, click the notifications icon once again. Note that a minimap is not synchronized to the online notifications window, therefore an activity of reading or deleting notifications in a minimap does not lead to any changes in the window of online notifications.
The maximum number of minimaps corresponds to 9 items. That is why if all the available windows are already opened, and a notification has come for a unit not opened in a minimap, then a notification will be available in the window of online notifications only.
Manipulations with Minimaps
There is a scaled icon and a unit name in the header of every help window in order to simplify the search of the necessary one. A mode switch and a close button are also situated in the header. You can open up to 9 help windows in the tracking system. Besides, you can use only one minimap per unit.
The button in the left corner of the
bottom panel can be used to hide/show all minimaps at once. Apart from that,
to avoid excessive information, minimaps are automatically hidden when you switch to the 'Reports', 'Messages', and
'Routes' panels (but even then, they can be shown forcibly if necessary). Minimaps are shown automatically upon leaving these panels.
The latest used layout of minimaps is restored each time a user authorizes in the system.
190
Unit Additional Information
Additional information includes the following items: last message, location, presence in geofences, speed, altitude, counters, satellites, connectivity settings, sensor values, parameters, drivers, trailers, custom fields, and maintenance intervals.
Additional information can be found in a unit's tooltip as well as in the extended unit information of the monitoring panel work list.
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
For example, a unit's tooltip can look like this:
Note.
All measurements used in the tooltip are taken from corresponding properties of the unit itself.
Extended Unit Information
Apart from that, additional information about the unit can be summoned and displayed stationary in the work list itself.
Click on unit's icon in the Monitoring panel to see extended information. Content of the extended unit view is also
regulated through User Settings
.
191
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.
Menu by Clicking on a Unit
Click on a unit on the map to open the menu at the top of a unit. This menu contains the same icons and buttons which have been
chosen for the monitoring panel table. Moreover, regardless to the chosen icons/units the menu
always contains the buttons for generating quick report and building quick track. The menu does not contain the following items even if they are chosen in the monitoring panel table — unit location icon, tracking option, and clear list button.
During a movement of a unit the menu moves with it and always displays updated unit information. To close it, click on any place of the program.
192
Icons Explanation
The list of all icons that can be found in the 'Monitoring' panel is presented below. 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 in the work list as well as in the
none of checkboxes, the item is not displayed in the 'Monitoring' panel.
All icons can be divided into two groups:
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
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.
Addresses
Depending on
chosen format , addresses can be longer (including state, region, etc.) or shorter (e.g., just
street and building number).
Geofences
If a unit gets into several geofences, all of them are displayed. At that they are sorted by area (from small to large) and written in color set in geofences' properties. If a unit is outside of all geofences available,
193
then its location will be indicated by an address.
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.
Motion State
This column shows whether a unit is moving or stationary, as well as whether ignition is on or off (if there is an
).
To monitor unit motion states, it is necessary to indicate a validity period of motion state icons (the corresponding line in the monitoring panel customizer). Here validity period corresponds to a time interval (in minutes) upon an expiry of
— 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 data is received by
— data received by LBS detection is outdated;
— no messages are received from a unit.
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.
First bar
shows satellites availability:
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:
green — unit sent data less than 5 minutes ago,
yellow — unit sent information within the last hour ,
orange — unit sent data within the last day,
red — there was no messages for a long period of time.
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.
There is a special app helping to reveal inactive units — Actualizer . The application allows setting any period of inactivity.
Connection State
194
Shows whether there is a connection with a unit at the moment.
— unit is connected,
— unit is not connected.
Unit is considered to be connected if it has TCP or UDP commands available or it has sent messages within last X minutes. A necessary value of minutes you can indicate in the corresponding line of the monitoring panel customizer
(from 0 to 999). The default value is 0. It means that connection state is defined automatically regardless to a time of receiving messages.
Sensor State
In this column
sensor state can be shown with different colors.
(or a small square of any other color) — visualizes sensor's value;
— text parameters (can be properly adjusted through custom sensor);
— the option is not activated for this unit;
— the value is unknown.
When putting a cursor over the square, in the tooltip you can see the value or description. Colors are adjusted in
sensor properties and sensors are chosen on the '
Additional ' tab of unit properties.
Drivers
The column with information on
drivers . Depending on the option chosen in the monitoring panel customizer for
driver's presentation, this column may contain photo, photo and name, or photo and phone number. A tooltip always contains photo, name, and phone number of a driver assigned to a unit.
— no drivers bound,
— a driver assigned has no photo,
— several drivers are bound to the unit.
Trailers
The column with information about
trailers . Depending on the option chosen in the monitoring panel customizer
for trailer's presentation, this column may contain photo or photo and name. A tooltip always contains photo and name of a trailer bound to a 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).
— show track on the map,
— remove track from the map,
— not enough rights to query tracks for this unit.
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.
195
Messages
Buttons to query data
.
— 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
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.
Media
View the latest
of device used).
— the button to view pictures (video),
— no pictures (video) available.
Commands
Buttons to send
— there are available commands,
— 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,
— sending SMS is not possible.
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.
196
— open registrar,
— not enough rights to register an event for this unit.
Properties
View
properties dialog (depending on work list
— some properties of the group are editable;
— only view access.
Clear List
Buttons to remove individual units/groups from the
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
Other buttons and signs 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
The button to add all available units/groups to the
.
Monitoring panel customizer that helps you to choose columns to be displayed and options for the additional menu.
197
Unit List Management
Unit work list affects the tracking process in many ways. It is not only about what you can see on the list and on the map but also how you manipulate units in other panels when creating jobs, notifications, querying messages, reports, and tracks, assigning drivers or trailers, looking for nearest units, etc.
Two display modes are possible for the work list:
simple list of
;
of units with sorting by groups.
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
Adding units to the list
To add units to the work list, use one of two buttons located above the list:
— add all available units;
— find necessary units using a special
However, there are some alternative ways to add units to the work list: from the
window (you can add a unit for which a notification has triggered);
dynamic formation of the list regarding data accuracy.
Removing units from the list
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 .
198
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:
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
. Signs and icons used in the columns are described
.
Treelike View
This mode of the work list shows the tree of units with sorting by groups. In the end of a name of each group in brackets you can see a number of units of the corresponding group. Expand a group to see all of them 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:
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
Search Tool
199
It is not needed to display all available units on the work 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
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, profile fields, phone number, unique ID, device type, access from user, geofences, sensor, driver, trailer, etc.
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.
Most of search parameters (except geofences, drivers, and trailers) are taken and can be viewed and changed in
Properties . If doing a search by sensor, not only sensor
name can be entered in the template field, but also a part of its description, parameter type or parameter name.
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:
add search result to the work list;
replace the current work list with search results.
Dynamic Work List
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
. 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:
200
1.
Manipulations with the work list (such as search, addition and removal of units) are impossible.
2.
The filtration by last message time does not affect the work list if the
201
Commands
Command is a request that can be sent to a unit. In response, the unit can send its coordinates, take a picture, activate an output, block engine, etc. Available commands depend on type of device used and its configuration.
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
17 standard commands are reserved in Wialon:
Icon Command
Query position
(get unit current location)
Send message to driver
Send position
Send route
Send waypoints
Upload configuration
Upload firmware
Query snapshot
Query snapshot from camera
Query DDD file
(for tachographs)
Name in the system
query_pos query_ddd
—
—
Parameters
Block engine
Unblock engine
Activate output block_engine unblock_engine output_on
—
— output number
Deactivate output
Download messages output_off download_msgs output number time interval (from – to)
Set data transfer interval
(how often unit sends data to the server) set_report_interval
Send custom message
(to send a non-standard command to a unit) custom_msg interval in seconds command text driver_msg send_position send_route send_waypoints upload_cfg upload_sw query_photo query_photo_cam message text coordinates checkpoints checkpoints path to configuration file path to firmware file
— camera's number
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
.
Sending and Tracking Commands
There are several ways to send a command to a unit:
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.
202
From a mobile device with the help of
Such commands as 'Upload configuration' and 'Upload firmware' have their own peculiarities. If these commands have been saved for units without choosing a file, then sending the commands as a job/notification or sending them to a group of units is impossible.
Information about commands sent to a unit is available:
In the
panel (all commands sent to unit).
In Executed commands report (only successfully executed commands).
Immediately after sending a command — in the log .
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
. 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).
1.
Push the command button or .
2.
Select a command from the list of commands available at the moment.
3.
Set additional parameters if needed, for example, input/output index, report interval, path to load
configuration or firmware file, checkpoints of the route
, etc. (depending on command type).
4.
Press OK. The command will be executed immediately, and its result will be reported in the
or hide the log window click on the double-arrow in the right bottom corner of the window.
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.
203
Chat with Driver
Operator (dispatcher) can exchange messages with
. 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
). 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.
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 '
', which will contain all chat history including operator's messages and driver's answers.
Correspondence with driver can be fulfilled with the help of a specially developed app — Chatterbox . This application allows sending not only commands but also SMS messages.
Sending Route/Sending Waypoints
Sending a route, it is necessary to indicate its name in the corresponding field of the dialog.
To send route/waypoints it is necessary to indicate its checkpoints in the command dialog. Checkpoints can be found in various sources: addresses, geofences, routes. You can apply search filter (buttons at the top of the dialog) which helps you to expand/narrow the number of sources to be used. Enabled button means that the corresponding source is applied as a filter, disabled means the opposite.
To indicate a checkpoint start typing a text into the corresponding field, and in the dropdown list, depending on the filter used, you can find the possible variants along with their source information.
Moreover, you can add a checkpoint directly from the map. To do so, click on the map summoning button situated to the right of the field. Move on the map to the target position, and double click on it. As a result a checkpoint will be
204
indicated automatically.
If a checkpoint is added from a route, then all the points of the route will be added. However, if the route contains moving units as checkpoints, then they will be omitted.
Coordinates of the first checkpoint are used when you add them from line or polygon type geofences.
After the necessary checkpoint is entered, a green check mark appears to the right of it. This check mark is a point validity indicator which shows that a checkpoint possesses coordinates. Checkpoint's name cannot be edited, it is filled in automatically. If you try to edit a name, the earlier search results will be reset (point validity indicator disappears) and you should begin the search once again. Every indicated checkpoint has a 'Notice' field under it. This field is not an obligatory one.
Indicated checkpoints can be saved as a route, and afterwards you can use it in the Routes
panel of the tracking system. To do so, check the box in the bottom of the dialog. You can also give a name to the route during flag activation (for sending waypoints only). Click OK to complete the procedure. Route saving takes place along with sending a command.
205
Events Registrar
Different events can be registered in unit history and then shown in the corresponding reports. Some events such as speeding, idling, visits to
values, etc. can be detected automatically by the system with the help of
. Other events such as fuel filling, maintenance or any custom events are registered in unit history manually with the help of a special tool — Events Registrar.
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:
make a record in unit log , register custom event
,
,
,
Note.
Units of measurement which you may encounter in the registrar dialog depend on a
measurement system set in unit
properties.
Record in the Log
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
generated for this unit (query the Log table).
To add messages to a unit log, you should have not only 'Manage events' access, but also 'Manage log' access.
Custom Event
Select Custom event in the registrar and click '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 click
'Store'. The description will appear below in Stored descriptions. To select a previously saved description for a new
206
event, just click on one of them. To delete a saved description, select it and click '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:
Unit Status
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
,
Fuel 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.
In the registrar, select Register filling and click 'Next'.
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, clic 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.
Registered fuel fillings participate in the following reports: '
', '
'.
Maintenance Work
In the registrar choose 'Register maintenance work' and press 'Next'.
207
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 '
' panel (special access is required).
Registered Events in Reports
Registered fillings and maintenance can appear in the
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
Header
Event time
Date and time when event happened.
Column Content
Time received
Date and time when event was registered.
Event text
Location
Text is taken from the 'Description' field. For maintenance, if there is no description, the text can be taken from the field 'Kind of work'.
Unit location at the moment of event. It is taken from the coordinates indicated while registering the event
(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
.
208
Media Files from Messages
If the equipment supports such an option, units can send pictures or video files along with the messages. Pictures and videos 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 'Media' in the
.
Press the button in order picture and video viewer to be displayed. The viewer window contains the latest picture
(video), as well as the total number of available pictures (videos) received in the current session.
The above-mentioned way is for viewing pictures (videos) of a particular unit. To view pictures (videos) of all units, press the 'Media' button at the bottom of the screen. It is active (that is colorful and able to be pressed) if there are pictures (video) available in the current session. Their number is displayed at the right of the button. If new pictures
(videos) have appeared after last opening of the window, the number is displayed in red circle to attract your attention.
In this window, only images (videos) received during current session are displayed.
To move between images (video files), use arrows. Between them, you can see the number of the pictures (videos) viewed and the number of available images (videos). Media files are sorted according to the time they come to the server.
Date and time of picture (video) coming is displayed above each one of them. Below the media file you can see a unit name and address information from the message.
Some media files can be enlarged with a special button in the right top corner. To close a media file viewer, use the button in the right bottom corner.
209
All images received from units can be observed in
and
. Moreover, in messages you can also view video files.
You can get a picture from a unit at any time using the 'Query snapshot'
210
Locator
Locator is used to generate links and share current units' location. Conditionally locator can be divided into two parts — links creation, and their viewing. Links are created in the locator's dialog window. To open the dialog, choose the corresponding item in the
. Viewing is performed on locator's map which becomes available upon clicking on the provided link.
Viewing on the Map
Open a link to view locator’s map where units to be displayed along with geofences (if they've been indicated in a link creation settings). Gurtam Maps, OpenStreetMap, and, if available, Google Maps are used to show units’ location. To choose a map layer, point a cursor on the corresponding icon below the scaling buttons (left top corner). This icon also helps to enable/disable displaying of geofences on the map.
Units
A unit is presented on the map by its icon. Unit name and movement direction arrows are shown as well (by default). You can also activate unit traces, or so called 'tails' (switched off by default). Click a gear shaped button in the right bottom corner to enable/disable the above mentioned settings.
If among the number of units presented on the map you need to monitor a particular one, you can use the monitoring tool. Click on the corresponding button (quadrate with green arrows) in the right top corner and choose the necessary unit from the dropdown list. Afterwards the map will be scaled and centered on the chosen unit. To disable scaling and centering it is necessary to quit the monitoring option (choose dash from the dropdown list).
Note that you cannot monitor all the available units at once. Therefore, if the 'All units' item is chosen in the dropdown list, then a search instead of monitoring will be used, and all the available units will get into vision field.
After the unit has been found, you can view its latest data. The data is shown in the window opened by clicking on a unit. The amount of provided information depends on a unit state (moving/stationary). If a unit is moving (movement arrow is an indicator), then the following parameters are shown for it: speed, time of movement beginning, its duration, and covered distance. For a unit which is not moving such parameters as speed and covered distance does not make sense, therefore only two parameters will be shown for it: time of beginning the stationary state, and its duration. Besides, regardless to the unit state the header of the opened window contains such information as time passed from the last message, and address from the last message. Note that upon receiving new messages
211
either position of a unit on the map or its current parameters will be automatically refreshed.
If it is necessary to know the history of unit's movement, you can generate and view its track (for the last 24 hours).
To do so, click on the corresponding button in the right top corner (green points and flag), and choose the necessary unit from the dropdown list. Afterwards, a track is built, and the map scaled in order the whole track to be displayed. To remove a track from the map, click on the track building button once again. Note that in locator track color is constant (blue), and it does not depend on any unit settings.
Note.
A track of movements can be viewed only if a user indicates such a possibility during link creation.
Current Location
Locator provides a possibility of defining your current location on the map. It could be particularly helpful if you use a locator from a mobile device.
To define your current location press the corresponding button (green arrow) in the bottom right corner. Afterwards, the map will be scaled and centered on your location.
If a particular unit has been chosen using the monitoring tool, and afterwards you press the defining location button, then both the unit and your current location get into vision field. However, as it was stated before, upon receiving new messages from the unit chosen in the monitoring tool, the map continues scaling and centering on it until the monitoring is disabled (choose dash from the dropdown list).
Scaling
Upon the locator opening the map is automatically scaled in such a way that all the units to get into vision field. To move around the map, drag it using the mouse.
The map can be scaled using either the corresponding buttons in the upper right corner (+/-) or mouse scroll. A graduated scale situated in the left bottom corner helps you to understand distances on the map.
Depending on the used scale and the number of available items some of the icons could be overlayed by each other. In this case the assembly of icons will be substituted by the group icon (a number of elements is shown for every group):
— for units;
— for geofences.
Click on the group item in order the list of all items to be shown (icon + name).
Links Creation
Links are generated and edited in locator's dialog situated in the user menu
. Click on the user name in the right corner of the top panel to open the menu.
To create a new link, press green plus shaped button, and enter the fields of the form.
In the left side of the form select units the location of which you would like to share. The following variants can be chosen:
All units
. You can generate a link containing all the units available to a user. In other words, if the number of units available to a user is changed (creating/deleting), then the number of units in locator will be automatically corrected as well. To activate this option, check the ‘All units’ (written in bold) flag in the list of available units.
Unit groups
. Unit groups’ names are displayed in the list in square brackets. Choose the necessary group. <ctrl> + mouse click combination is used to check all the unit groups’ flags at once. A link generated contains all the units included in the chosen group(s). The number of units in a group is dynamical, that is why if the number of units is changed (creating/deleting), then the number of units in locator will be automatically corrected as well.
212
Units
. Choose any units. If it is necessary to indicate all the units currently available to a user, use the
<ctrl> + click combination.
Afterwards indicate link activation time to the right of the list. By default a link is considered to be active from the moment of its adding. You can see it by the 'Now' position of the radio button. To indicate another time for link activation, switch radio button to the next position. It enables time field. Click on this field to open the calendar where it is necessary to indicate date and time for link activation. Note that link activation term cannot exceed 100 days.
Furthermore enter the link life span into the corresponding field. The value can be indicated in minutes, hours, or days
(choose from the dropdown list). Note that link's life span can be unlimited. Indicate 0 in the field to apply this option.
Below is the field where, if necessary, you can enter a note for a link. This allows to identify the necessary link in the list of links. Besides, a note (if it has been entered) will be shown in the header of locator's page itself.
Optionally you can also check geofences' checkboxes in order to share them in the link. Moreover, you can provide the possibility of generating and viewing a track of a unit by indicating the 'Tracks' flag. Note that a user providing the possibility of viewing a track of a unit should possess the 'Query reports or messages' right towards a unit.
Click 'Add' button in order to generate a link, or Cancel to clear this form.
List of Links
Generated links are placed in the corresponding list containing such information as sequence number, the link itself
(displayed by the link beginning and termination time), notes, link life span, units' number icon, and also geofences indicators. If there is less than hour left before link to be terminated, the corresponding line is highlighted in red.
Click on the link to open it in a new tab. To copy URL-address of a link click on the button to the right of it. The link can also be edited (spanner shaped button), or deleted (cross shaped button).
Attention!
Upon exceeding of the life span the link is automatically deleted.
Upon changing the user's password all the locator's links are automatically deleted.
Locator Integration
Use the following form of code to integrate locator into your web-site:
<iframe src="link_address&lang=en" width="700" height="400"></iframe>
Necessary actions:
In the link list click on the icon to the right of the link and copy it.
Paste the copied link instead of ‘link address’.
Such parameters as ‘width’ and ‘height’ stand for the corresponding properties of the integrated window. ‘Lang’
213
parameter stands for the language used.
Manipulations with Link
As has been described earlier, there are 3 settings for a unit displaying (movement direction, name, 'tails'). Changing these settings the corresponding information is added to the locator's URL:
'Tail' (on/off)
&tails=1/0
Name (on/off)
&labels=1/0
Arrow (on/off)
&directs=1/0
Therefore, to save the applied settings and use them afterwards, it is necessary to utilize not the basic link (created in locator's dialog), but the modified one (received by changing settings of unit presentation on the map).
Moreover, there is a possibility to choose a map source in advance. Information on the map source is added to the locator's URL. The procedure is the same for any map available, let's see it on the example of OpenStreetMap:
&map=OpenStreetMap
214
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
To build a track, it is necessary to possess the 'Query reports or messages' right towards a corresponding unit.
215
Mapping a Track
To build a track in the 'Tracks' panel, do the following:
1.
Select a unit in the dropdown list. Its contents depend on the
in the 'Monitoring' panel and access to those units. In case the work list is empty (when
when units have been deleted from the work list manually), the units to which you possess the corresponding rights will be displayed.
2.
Adjust the desired
parameters
for the track (color, thickness,
etc.).
3.
Define a time interval within which you want to get the data.
4.
After filling in all the fields, press 'Show Track'.
Note that in order tracks to be displayed on the map you should check if the corresponding
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 traveled will be 0 km.
Alternative methods to build a track on the map are:
In the '
' panel with the help of quick track buttons.
In the '
Messages ' panel, when viewing data messages.
In the '
' panel, if the appropriate option is selected in report template.
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').
A track or its part can be displayed on the map as a dashed line. Such situation indicates that this part of the track might be imprecise. The cause of this can be one of the following:
1.
Maximum interval between messages is exceeded (see the '
' tab);
2.
Not enough satellites (less than 4, and only when the messages validity filtration is disabled).
216
Track Parameters
delete incorrect track and create a new one.
Track Color
A track color depends on unit settings (see
). There are three alternative color settings available: 'By Speed', 'By sensor' and 'Single'. 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 'Single' 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.
Track Line Thickness
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
Markers in tracks are unavailable if a user has no access to reports.
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,
video 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.
217
Markers in tracks are drawn and used along the same principles as
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 .
Mileage in tracks can sometimes differ from mileage in reports (if there are invalid messages within the interval). In such cases, more accurate mileage is provided in reports.
218
Tracks Management
You can add
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 a pulsating 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 traveled mileage. Mileage in tracks can sometimes differ from mileage in reports (if there are invalid messages within the interval). In such cases, more accurate mileage is provided 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
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.
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.
Moreover, a built track can be saved as a line
geofence . To do so, click the corresponding button
. Note that if the number of points of a track is more than 10000, it will be saved in several geofences with the same name and a digital index in brackets. For example, 'Geofence (1)', 'Geofence (2)', etc.
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.
any point of the track.
219
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.
There is a specially developed app to work with messages — Messages Manager .
220
Working with Messages
Working with messages is query messages, view and filter them, and delete them.
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 the units available to you, but only the units from the
of monitoring panel. In case the work list is empty (when
when units have been deleted from the work list manually), the units to which you possess the corresponding rights will be displayed. Spanner shaped button situated to the right of the dropdown list
serves to summon up a Unit Properties dialog
.
2.
Specify time interval to show messages for. The principle of
interval adjustment is the same as in reports (see Query and View
Reports ). The second and fourth steps can be united into one if
you choose one of the 'quick intervals' (the buttons Today,
Yesterday
, Week, and Month).
3.
Select message type from the dropdown list (each type is described in detail below):
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.
There are alternative ways to query messages: from the
; from a table or chart of an
Note that in order messages track to be displayed on the map, you should check if the corresponding
Viewing Messages
Messages of any type are displayed in the form of a table.
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.
221
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
are displayed (the rest can be enabled manually).
Messages Filter
To quickly find a necessary message, use a special filter. Data messages
(with parameters shown as raw data) can be filtered by parameter names and parameter values,
— by message/event text,
sent commands — by additional parameters' values,
— by 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 click 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.
222
Note.
Deleting last incoming message or last message with position (valid coordinates) is impossible. That is why the delete checkbox for these messages is always dimmed.
223
Data Messages
If you request data messages, the table of messages will contain information about time, speed, coordinates, location, as well as parameters. Besides, resultant information will be given in statistics. You can observe messages in in the form of a table or as a chart.
The way to display parameters can be one of the following:
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
are displayed but you can enable other sensors manually (see
The table of messages has the following columns:
Time
when the message was received.
Speed
registered at that point. It is calculated as the distance traveled between the previous message and the current one divided on time between these two messages (in km/h or mph depending on unit's properties).
Coordinates
: latitude and longitude, in the brackets the number of satellites locked is displayed.
Altitude
: elevation over sea level. If there are only zeros, it may mean your device does not detect altitude
(in meters or feet depending on unit's properties).
Location
: country, city, street, etc. (according to user's settings).
Parameters
(if available) can be given in one row (if raw data is selected) or separate column for each
parameter (if sensors values is selected). You can filter messages
by parameters.
Media
(if available): the button to display a picture or a video made by unit and sent with the message.
Delete
(if allowed): checkboxes to
.
Red rows in the table mean alarm messages registered by the system.
224
Note.
Measurement system (either metric or U.S.) used to display speed, altitude as well as statistic information depends on unit's properties.
Statistics
In the 'Statistics' section the general information about the request is given:
Total messages
: the number of messages for the whole period;
Total time
: the interval between the first and the last message in the selected period;
Distance
: the distance traveled by the unit within the indicated time interval. Mileage in messages can sometimes differ from mileage in reports (if there are invalid messages within the interval). In such cases, more accurate mileage is provided in reports.
Average speed
: the average of all speed values registered during the period;
Maximum speed
: the maximum speed registered.
Using the Map
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 on this point and a blue 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 '
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.
Charts
225
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.
226
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.
227
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:
Time
: time when the command was sent to the unit.
User
: login name of the
user who performed the command. If there is a dash in this cell, it means you have
no
access to this user, that is why the login name is hidden.
Command name
: command name as it is written in unit properties.
Command type
: command type (see the list ).
Parameter
: for those commands that require additional parameters (like message to driver, input activation/deactivation, report period, custom message, etc.).
Execution time
: time when the command was executed. If execution failed due to billing limitations (e.g., you ran out of SMS messages), this cell will contain only dashes.
Channel
: channel type used to transmit the command (TCP, UDP, Virtual, SMS).
228
Registered Events
Different types of events can be registered in unit history automatically or manually.
Automatic registration is adjusted with the help of
(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.
and
routes statuses can be saved as events.
In the table you see: 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.
229
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'
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.
Unit log contains the following information:
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.
Unit log is also presented as a
230
Export/Import Messages
Messages can be imported and exported. It concerns only messages of the first type that is
.
Attention!
Size limit for an imported file/archive is 64 MB, which, in case of archive, is approximately 3.5 million messages.
Export
Open the 'Export and Import Messages' tab in the left section of the window.
Select destination format and click '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, indicate the flag 'Compress file'.
The supported export formats are:
OziExplorer track(.plt): Ozi Explorer format that stores track as a list of coordinates of track's points.
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 messages (.wln): a format to be used with Wialon software.
Wialon binary messages (.wlb): a binary format to be used with Wialon software.
Import
Select the 'Export and Import Messages' tab in the left section of the window.
The supported import formats are:
Raw GPRMC navigator logs in format defined by NMEA 0183 specification — searched in files with extension .txt or .log.
Wialon messages — searched in files with extension .wln.
Wialon binary messages — searched in files with extension .wlb.
Click on the empty field, specify a file (or an archive) to import messages from, and click 'Upload'.
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.
231
Reports
To open the 'Reports' panel, choose a corresponding name in the
top panel or click on the necessary item in the
As a result, reports window will appear. Units activity could be presented in reports 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.
The 'Reports' panel window can be divided into four sections:
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
In the bottom right-hand section, you see the report itself if it has been generated online
. A report appears in the form of
and
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.
232
Query and View Reports
To generate a report, set the following parameters:
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...
Object
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
units are displayed in this dropdown list but only those which are in the
work list of the 'Monitoring' panel at the
moment. In case the work list is empty (when dynamic work list
is used or when units have been deleted from the work list manually), the units to which you possess the corresponding rights will be displayed.
Interval
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] minutes/hours/days/weeks/months/years. The digital value of an interval can be chosen in the corresponding field using special arrows or scroll wheel. If you press and hold an arrow, the numbers will change at an increased speed. Note that the acceptable values are from 1 to 99.
The current day (week, etc.) can be included into the interval or not depending on the state of 'Include current' checkbox.
In case of setting a custom interval (from – to), click 'Execute' to generate a report. Choosing an interval, note that the number of lines in a generated report is limited to 100 000 for the optimal system performance.
Note.
There are alternative ways to receive reports in the tracking system:
1.
getting reports by e-mail at specified time (adjusted through jobs
);
2.
getting a report when an event happens (adjusted through
);
3.
quick report generation from the Monitoring panel (see
Monitoring => Icons Explanation ).
is active.
233
Online Report
To generate a report online, adjust the parameters described above and click the 'Execute' 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.
Table report may contain up to 100 000 lines, therefore it is divided into pages. 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:
go to the next page,
go to the previous page,
go to the first page,
go to the last page.
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.
Other buttons located in the toolkit allow to:
—
— quick
— quick
234
—
—
Transfer from tabular report to messages
The tracking system allows transferring to messages straight from a tabular online report. It can be useful for analysis of unit data messages.
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 in grey. 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.
235
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.
236
Export Report to File
To get a report in the form of a file that is suitable to save on disk, print or send by e-mail, push the 'Export to file' button .
Choose desirable file format or several formats at once and specify parameters. Supported formats are HTML, PDF,
Еxcel, XML, CSV.
Reports in the form of files can be regularly sent to your e-mail automatically – through
.
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').
To zip a file, indicate the 'Compress report files' flag. Note that HTML, CSV, and XML formats undergo archivation regardless to the flag availability. Moreover, archivation is applied if total size of files exceeds 20 MB. In other cases archivation is applied depending on the flag availability.
Indicate the corresponding flag if it is necessary to attach map to the exported report. Graphical objects (like map, chart) can be exported only into HTML or PDF files. 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 . By default the map is scaled in order
track/markers/last unit position to be seen on it. If these elements are not shown on map (not chosen in report template), then the map will not be attached. If the 'Squeeze in all graphics' flag is chosen, then the map is scaled in such a way that geofences are shown on map along with the above mentioned elements. Only Gurtam Maps can be used for in exported files. Furthermore, the map layer can be hidden ('Hide cartographic basis' option) so that tracks and markers will be shown on the blank background.
A function of using a link to display location (coordinates should be available) is supported for the files exported in
PDF or Excel. It works the following way: open the exported report (PDF/Excel), place a cursor on the corresponding field of a report, for example, beginning/end time or address information from a unit (cursor pointer changes its shape for a hand), click on the link, and afterwards Google Maps cartographical service is opened in your browser showing unit's location by a special marker. If there is no need in showing unit's location you can disable links to Google Maps in PDF and Excel files by indicating the corresponding flag in export parameters.
If necessary, you can disable links to Google Maps in PDF and Excel files by indicating the corresponding flag.
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.
237
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 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 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 separated from each other by a special delimiter. You can additionally set coding (utf8, cp1251) and delimiter (comma or semicolon).
238
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.
Templates contain information upon which
and
the resulting report, what kind of content to be presented in tables, sequence order of columns in tables and sections in the report, which graphical elements to be rendered on the map, and many other parameters which define the look of the resulting report.
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.
The following actions are available:
or — edit or view a report template (depends on your access level);
— create a new template using this one as a basis;
— delete a template (if the button is dimmed, you have not enough rights).
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.
239
Creating Report Template
To make manipulations with reports templates, you should have at least one resource with the
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
:
Unit
: such template can be applied to separate units;
Unit group
: such template will be used to gather information about several units at once (see
);
User
: such template can be used to analyze users' activity in the system;
Drivers
: such template can be used to analyze drivers' work;
Resource
: such template is used to analyze how resource contents change;
Retranslator
: such template is used to analyze the work of retranslators;
Route
: such template can be used to analyze units' performance on routes;
Group of drivers
: such template can be used to analyze performed work of several drivers simultaneously;
Group of trailers
: such template can be used to analyze performed work of several trailers simultaneously;
Passengers
: such template can be used to analyze passengers transportation.
It is not recommended to change template type when editing a previously created template because all template contents will be lost with this action.
Report template can be bound to the particular object(s) of the system. For example, you create a report template, choose 'Unit' as its type, and you know for sure that this report is necessary for some particular units (not for all your fleet). If the corresponding units are not chosen for this report, then during
you will need to look through the whole list of units to find the necessary ones. However, if the necessary units are bound to the report template, then during request formation the list of elements will contain only the units you have indicated. Note that object binding works for all types of report templates.
To bind object(s) to a report template, click the 'Bind' button to the right of the report type field. In the appeared window indicate flags for the necessary objects, and click OK. Note that afterwards a number of bound objects will be shown on the 'Bind' button.
Add
and
charts to your template, choose items for
, adjust
map output , and decide upon other
parameters of the report. All added contents will be displayed at the left of the dialog.
240
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.
241
Advanced Settings
The right part of the Reports Template dialog contains advanced settings. They are divided into four sections:
Depending on template type, all or just several of these sections may be displayed.
Options
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).
Consider track-geofence intersections
is an option which allows detecting geofence visiting in case a trip intersects
a geofence by any segment of its track. This option can be applied for such reports as ' Geofences
', and '
Connection loss based on GPS data
option can be applied to the 'Connection problems' and 'Chronology' tables, as well as to charts upon choosing a background for connection losses. If the flag is indicated, then time intervals with no messages from units or messages without coordinates will be shown in corresponding reports or in charts. If no flag is indicated, then you can see time intervals without messages only.
'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 '
'Measurement system'
option defines the metrics for such parameters as mileage, speed, fuel, and temperature in reports.
Note.
Depending on the
measurement system chosen in a report template for which the
intervals filtration has been applied
you should consider that the values of filtration parameters will not be converted to the corresponding values of the other measurement system automatically. Nonetheless, the metrics will be changed to the corresponding metrics of
242
the chosen system. For example, if you have 50 kilometers mileage and 100 kilometers per hour speed, after choosing the american measurement system you will receive 50 miles mileage and 100 miles per hour speed.
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
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 Gurtam Maps or from geofences.
Addresses from Map
You can select which address items to be displayed (country, region, city, street, and house are available) and specify their sequence order (for this, drag items up and down with blue arrows). If none of five address items is chosen, coordinates are displayed instead of addresses.
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.
Note.
Addresses for reports can be taken only from Gurtam Maps (no Google, Yandex, or other services can be used). If you find inaccurate address information in the reports, updating the map of your region/city may help. For this, make a request to the technical support and enclose a new map in
Addresses from Geofences
Sometimes Gurtam Maps may not contain precise addresses in certain regions. In such cases, you can use
clearer.
If the option 'Use geofences for addresses' is selected, additional parameters become available. In particular, you can choose to display geofence's description alongside with its name (the option 'Add geofence description to address').
The range of geofences used as addresses is adjustable. By default, all geofences that belong to the same resource as the reports template are used. However, geofences from all available resources can be employed if necessary.
Alternatively, to narrow this range, you can specify certain group of geofences to be used (it should be created in the same resource as report template itself). Choose one or another option in the dropdown list 'Specify geofences'
(groups of geofences are in square brackets).
If you choose to use geofences as addresses and coordinates of a unit get into one, its name (and maybe description) will be displayed in the address cell. If two or more geofences are found in this place, then the smallest one will be used. If no geofences are found in given location, the address from the map will be displayed.
Shifts
If the option is enabled, then information in the report will be structured by shifts. For example, a transport company has a vehicle and two drivers. And it has been calculated that profit from the vehicle usage comes only if it is used in two shifts: from 9 a.m. till 7 p.m., and from 9 p.m. till 7 a.m. Assume that we would like to receive any kind of report for
243
the unit in terms of this shifts, and we need no information on what happens with the vehicle in time between shifts.
So, it is necessary to adjust shifts correspondingly, and indicate its flag in order this setting to be used. Moreover, for this particular situation it is necessary to apply
grouping by shifts and use intervals' retrieving .
244
Tables
The following tables (for units and unit groups) can be added to a report:
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.
245
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 .
Several alternatives to standard reports are available as applications: iDriveSafe — assessment of driving behavior;
Dashboard — graphic presentation of key performance indicators of your fleet;
Driving Logbook — tax report determining actual use of the company car for private and/or business purposes (on the basis of Trips report).
246
Table Parameters
In the right part of the
report template dialog, you can set additional parameters for the table such as:
,
,
.
These parameters can be applied to any kind of table.
Grouping/Sorting
Grouping
Reports are supported with a grouping feature. It works in the following way: from the available time intervals (year, month, season, week, day of the week, day of the month, date, shift, duration) you choose those by which you would like to group table data. Grouping can be made either by single time interval or by several (or even by all of them). If grouping by several time intervals is chosen, you should indicate the order of nesting for these time intervals. For example, table data can be grouped by years, each year group can contain months' grouping (nested inside), and each month can contain grouping by dates (nested inside). Nesting is adjusted by dragging the corresponding time interval up/down in the list of groupings (the lower items are nested in the higher ones)
If grouping by such intervals as season and duration is chosen, then beneath you can find a special block where it is necessary to set intervals' values. Let's see it in detail:
For season
It is necessary to indicate season's name (any), for example, summer, autumn, etc. Afterwards, using dropdown lists choose season's duration. Note that season's duration is considered to be a time period from the first day of the month in the first dropdown list to the last day of the month in the second one.
Minimum season's duration is 1 month. To indicate minimum duration, choose the same month in both the dropdown lists. To activate an entered season, click '+' button. Maximum number of seasons is 12.
For duration
It is necessary to give name for an interval (for example, interval 1), indicate interval's duration in
247
seconds/minutes/hours/days (choose from dropdown list), and activate it by clicking '+' button. Maximum number of durations is 5. On the example of 'Trips' report let's observe how the usage of duration periods influences report data presentation. The following periods are indicated: 'Short' — to 15 minutes, 'Middle'
— to 1 hour, 'Long' — to 3 hours. Data in the report will be presented in the following way: short trips — from minimum trip time indicated in
trip detector up to 15 minutes, middle trips — from 15 minutes up to 1
hour, long trips — from 1 hour up to 3 hours.
Note that depending on report type additional groupings can be used along with the standard ones (for example, by geofence, route, sensor, user, event, action type, violation type, trips, streets). In this case items in a group are arranged by their name .
Sorting
Grouped data can be sorted by any criterion chosen as a column of a table. Opposite to each interval a dropdown list is situated. Each list contains a number of sorting criteria (table columns included in a report). From this dropdown list choose a criterion which will be applied to the nested level of grouping. Moreover, to the left of the dropdown list there is an icon clicking which you can indicate the sorting direction (from min to max or vice versa).
Note that table data can be sorted even without grouping applied. To do so, choose the corresponding sorting parameter opposite to the 'Total' interval, and afterwards indicate sorting direction.
Let's explore grouping and sorting features on the example. To do so, we create report on trips. We are interested in maximum speed, duration, engine hours, and mileage criteria, so it is necessary to check these flags (table columns).
Moreover, we need to divide information by years, months, and dates, and also it would be convenient for us if the dates were sorted by maximum speed (from max to min value).
By default a grouping is off, so we receive a detailed report where an individual line corresponds to every criterion, and these lines are displayed in a chronological order, or according to a sorting chosen for a table.
But in our case it is necessary to apply grouping. Check the 'Year', 'Month', and 'Date' flags. Adjust nesting (by dragging items in the list). Afterwards, choose a sorting criterion from the dropdown list, and indicate sorting direction
(from max to min value). We would like to apply sorting for the level nested into the months (dates), so it is necessary to choose the corresponding criterion from the dropdown list opposite to the month interval. Then click on the sorting direction icon in order to adjust sorting from maximum to minimum values. Note that usually if a dash is chosen in the dropdown list, then the sorting has chronological order.
The report has the following view. The table receives two additional columns, one of them shows grouping, and the other contains the buttons ('+'/'-') using which you can expand/hide nested levels of a grouping applied. Information is grouped by years. You can either expand groupings consequently (by clicking all the pluses one by one), or go straight to the necessary nested level (by clicking the corresponding one in the header of the table). The dates in the table are sorted by maximum speed (from maximum to minimum value).
248
Available time intervals and their application in reports:
Total
: the top level of grouping (cannot be moved). If the flag is checked, then we receive a groping with data resulting (total duration of any state, total number of registered events, etc.). This grouping contains all the other nested levels (if available).
Year
: table data is grouped by years.
Month
: table data is grouped by months.
Week
: table data is grouped by weeks. The week is presented in the table by its number (for example, week 26, etc.).
Day of the week
: table data is grouped by days of the week (for example, Monday, Tuesday,
Wednesday, etc.).
Day of the month
: table data is grouped by days of the month (for example, 1st, 2d, etc.).
Date
: table information is grouped by dates.
Shift
: table data is grouped by shifts
.
Note that if grouping is used, then all the events beginning in the analyzed interval are included in this interval even if they exceed the actual duration of an interval.
One more column can be useful for tables with grouping — 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).
Retrieve Intervals
This option can be applied only for reports with grouping by
. If the 'Retrieve intervals' flag is not indicated, then the whole interval of a trip 'crossing' the shift gets into the report. If the 'Retrieve intervals' flag is indicated, then the report will contain only data from messages received inside the indicated interval.
Detalization
A table with a grouping can be extended by the way of detalization. Detalization is actually a final level of nesting (date and time). To view this level, you can either expand all the previous ones ('+' at the beginning of the line), or click the largest number in the heading of the corresponding column (expands all the enclosed nesting levels).
Let's take the previous example with groupings, and extend it by the way of detalization (check the corresponding flag in the table parameters). This example already includes the grouping by years, months, and dates, so the option of detalization allows us to extend the level of nesting directly to the time an event has taken place (hours, minutes, seconds).
Note, as it was already mentioned before, sorting is applied to the following level of nesting. And as far as detalization corresponds to the final level of nesting, you can indicate sorting for it as well. Sorting for detalization is indicated in the same way as for the groupings.
Detalization can be applied only to grouped tables; it does not affect detailed tables.
249
Row Numbering
Row numeration can be added to any table type. To switch the numeration on, check 'Row numbering' box in table advanced parameters. The numeration is added to the table as its first column.
When numbering and grouping meet together, you get multilevel numbering. The main level is a usual numeration of main rows with integer numbers. The following 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.
Location information is not given in the total row (replaced by dashes).
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.
There are two algorithms available for time limitation. According to the first one ('Cut off intervals' flag is not chosen) if any state (for example, trip) begins inside the indicated time limitation interval, and ends outside it, then such a state will not be terminated, and its full duration will be included in the report. According to the second one ('Cut off intervals'
250
flag is chosen) if any state (for example, trip) begins inside the limitation interval, and ens outside it, then the report will include only the duration of such a state inside the indicated interval, and everything outside the interval will be 'cut off'.
For example, if the period from 9:00 till 18:00 is chosen as time limitation interval, and two trips has been registered, the first — from 7:50 till 12:00 and the second — from 13:00 till 18:20, then: according to the first algorithm, only the trip started inside the limitation interval will be entirely included in the report. I.e., there will be one trip from 13:00 till 18:20 in the report.
according to the second algorithm, two trips within the indicated limitation interval will be included in the report (from 9:00 till 12:00 and from 13:00 till 18:00).
To apply time limitation equal to the whole day, insert the interval from 00:01 to 23:59.
251
Intervals Filtration
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. Note that all the filters except for the mileage one work with integer values.
Counter sensor value range
This filter can be used for the 'Counter Sensors' table only. It provides a possibility to generate a report for a period of time on which messages' values received correspond to the indicated value range.
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 traveled in the interval. Either integer or non-integral values can be indicated as a filter. For non-integral values use dot as a delimiter.
Engine hours sensor
Enter name mask for engine hours sensor. It affects calculations in reports which contain any information on engine hours as well as engine hours filter below.
Engine hours
Minimum and/or maximum duration of engine hours. In addition, engine hours sensor mask can be specified in the filter '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.
252
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
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 sensors will be considered.
Sensors masks
Here you can enter sensor
masks which will be considered upon report
generating. Sensors masks can affect 'Sensors' filter, 'Counter' column, and information on fuel (if any of these options is selected in the report template).
Note that engine hours mask is indicated individually in the corresponding field.
Driver
This filter allows selecting intervals with a certain driver or driver group or without them. Choose the option With driver and specify the driver's name mask. The resulting table will contain only the intervals with the 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. If the option 'Driver group' is chosen, while generating a report only those intervals that have some driver belonging to a group (the group’s name mask can be indicated as well) will be analyzed. In addition, you can enable the option
'Retrieve intervals'
to get only those segments that contain the specified driver or group 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 or driver groups. Those 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. To facilitate the process, you can indicate flags for
(displayed in square brackets). Indicating the flag for a group of geofences equals to indicating flags for every geofence of this group. Note that number of geofences in a group is dynamic (adding to/deleting from groups of geofences), and notifications come considering this dynamics.
253
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.
In addition, you can enable the option 'Retrieve intervals to retrieve only segments inside or outside selected geofences or units.
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.
The above described filters can be used either independently or in combination with each other. Each filter is applied directly to the indicated time interval, and a generated report shows a value meeting the parameters of all the filters used.
254
Account Tree (for resource)
This report provides you with information concerning the structure of an account. In other words, a table helps you to understand which object types an account consists of, and also understand the hierarchy among these objects.
A table may contain the following columns:
Object type
: accounts, resources, users, units, unit groups, retranslators, routes.
Name
: name of an object.
Moreover, to narrow the object type line, it is necessary to indicate the object type which hierarchy you are interested in. To do so, indicate the corresponding flags in report template parameters section.
Note that objects' hierarchy will be presented more obviously, if the grouping by object type is chosen in a report template.
255
Chat
This report unites commands of the kind Send message to driver and replies from the driver.
How to carry a chat with a driver...
Time
: date and time when the message was received.
Sender
: driver or operator (operator's username in brackets).
Text
: message text.
Count
: the number of messages.
Notes
: an empty column to add your custom comments after printing or exporting the report.
256
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.
257
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; note that when you enter a mask the sensors are firstly filtered by their type (digital sensors), and then by name)
The following columns can be selected to form the table:
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.
Note that the system does not calculate state duration for such activity types as fillings and thefts. Therefore, beginning and end time for fillings/thefts are the same in the 'Chronology' table, and duration column displays zero value.
258
Connection Problems
This kind of report lists periods when no data has been generated and/or send to the system from a unit. The parameters for this report are adjusted in
Unit Properties => Advanced where you set Maximum interval between
messages
.
The following information can be presented in this kind of report:
Beginning
: date and time when connection loss happened.
End
: date and time when connection was recovered. Note that if the time passed between receiving the last message on a report interval and the end of a report interval exceeds a value of a maximum interval between messages, then a connection loss interval will be added to the report. The beginning of this interval corresponds to the time of last message receiving, and the end corresponds to the end of a report interval.
Duration
: time interval of connection loss.
Location
: the address where the unit was right before the connection broke.
Count
: the number of connection gaps detected.
Driver
: driver's name if available.
Trailer
: trailer's name if any was bound.
Notes
: an empty column for your custom comments.
Additional
by driver, trailer, and geofences/units can be applied to this report.
259
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:
Sensor
: sensor name.
Activated
: activation time.
Deactivated
: deactivation time.
Duration
: operation time.
Total time
: time from the first activation beginning to the last activation end.
Location
: unit location when counter was activated.
Mileage
: distance traveled for the operation period.
Mileage (adjusted)
: mileage subject to the coefficient set in unit properties (Advanced tab).
Avg speed
: average speed in this period.
Max speed
: maximum speed in this period.
Counter
: the value (can be sown with accuracy to two decimal places – see Advanced Settings
).
Driver
: driver's name if available.
Trailer
: trailer's name if any was bound.
Penalties
: penalties calculated for adjusted
Rank
: received penalty points converted into a grade using 6 point scoring system.
Notes
: an empty column for your custom comments.
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.
260
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:
Name
: custom field name.
Value
: custom field value.
Notes
: an empty column for your custom comments.
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
), 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.
261
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 digital sensors. If no sensors are selected or sensors are indicated incorrectly, the table cannot be formed.
The table can contain the following columns:
Sensor
: the name of the sensor under control.
On
: time when the sensor was activated.
Off
: time when the sensor was deactivated.
Duration
: the interval when the sensor was on.
Total time
: time from the beginning of first activation to the end of last one.
Location
: unit location at the moment of activation.
Mileage
: the distance traveled while the sensor was on.
Mileage (adjusted)
: mileage subject to the coefficient set in unit properties ('Advanced' tab).
Initial mileage
: mileage counter value at the moment of a sensor activating. If no saving of mileage parameter was made through the reported period, then mileage is counted from 0.
Final mileage
: mileage counter value at the moment of a sensor deactivating.
Avg speed
: average speed of movement when the sensor was on
Max speed
: maximum speed detected in the interval.
Activations count
: the number of activations (can be helpful either in grouping table data by years/months/weeks/days/shifts or for the reports on unit groups).
Driver
: driver's name if available.
Trailer
: trailer's name if any was bound.
Penalties
: penalties calculated for adjusted
Rank
: received penalty points converted into a grade using 6 point scoring system.
Notes
: an empty column for your custom comments.
driver, trailer, fuel fillings, fuel thefts, and geofences/units.
262
Eco Driving
The report provides you with the information on how a driver treats the entrusted vehicle. Analyses of driving behaviour could help you to prolong vehicle life, reduce fuel costs, ensure cargo safety, and also understand the reason for any case of emergency.
Before generating 'Eco Driving' report it is necessary to indicate settings on the
corresponding tab of unit properties
dialog.
A table may contain the following information:
Violation
: a type of violation.
Beginning
: time of violation beginning.
Initial location
: an address of unit location on the moment of violation beginning.
End
: time of violation end.
Final location
: an address of unit location on the moment of a violation end.
Value
: parameter value during violation.
Avg speed
: average speed during violation.
Max speed
: maximum speed during violation.
Penalty
: penalty value indicated on the
'Eco Driving' tab of unit properties.
Rank
: received penalty points converted into a grade using 6 point scoring system (can be useful if grouping by years, months, weeks, days, shifts, or trips has been applied ).
Rating by violations
: an individual index number of a unit/driver calculated on the basis of committed violations. The lower the rating is, the less violations are committed. This column can be used in the report on unit groups and driver groups only.
Mileage
: distance covered on a violation or grouping interval.
Mileage (adjusted)
: mileage considering a coefficient set in unit properties ('Advanced' tab).
Initial mileage
: mileage counter value at the moment of violation beginning. If no saving of mileage parameter was made through the reported period, then mileage is counted from 0.
Final mileage
: mileage counter value at the moment of violation end.
Duration
: duration of a violation or grouping interval.
Count
: number of violations of such type.
Driver
: name of a driver on this vehicle.
Special attention should be paid to the 'Rating by violations' column. It can be used in the report on unit groups and driver groups only. If the column is included in a table, then units/drivers can be placed in the table according to the violations committed (from the lower rating to the highest one). To do so, choose the total grouping by rating in parameters of a report template. Rating by violations is calculated by the system on the basis of eco driving ranks. In case the ranks are similar, the system takes covered mileage into account. The higher the mileage value travelled upon the same rank, the lower the rating by violations is. Note that the system supports visual marking of rating fields according to the eco driving rank. To do so, choose colors and the values matching them in the corresponding block of report template parameters.
Note that it is easier to analyse the received report, if a grouping option has been applied to a report template.
263
Information received in a report can be grouped on the basis of different criteria, such as time (year, month, week, day, shift), type of violation, and trips.
Moreover, in addition to grouping an option of detalization
can be applied. This option allows viewing the final level of nesting (date and time) inside of grouping. Though, take into consideration that penalty and rank can be given for the violation taken place on some interval of time (not immediately). That is why on the final level of nesting (date and time) a dash is given in the 'Rank' column, and the 'Penalty' column receives the value indicated on the 'Eco Driving' tab of unit properties.
Penalty Scoring System
The value of penalty points for a particular criterion is indicated on the
'Eco driving' tab of a unit properties dialog.
Afterwards the indicated points are used in the report for driving quality evaluation. The calculation of penalty points is made using the special algorithm. The main peculiarities are presented below.
Without grouping
If no averaging has been used, then the penalty value (earlier indicated on the 'Eco Driving' tab) is displayed opposite to every criterion in the corresponding column. And the 'Total' line (if available) contains the value which corresponds to the sum of points scored for violations.
If averaging (by mileage/by time) has been used, then the main difference is that the 'Total' value corresponds to the quotient received as a result of division of the scored penalty points total number by the number of minute intervals (averaging by time), or by the number of kilometer intervals (averaging by mileage) in a trip.
With grouping
If no averaging has been used, then a total number of penalty points for the violations of a particular group is displayed opposite to every group in the corresponding column. And the 'Total' line (if available) contains a sum of penalty scores received for all the violations.
If averaging (by mileage/by time) has been used, then this averaging is applied to every group of parameters in the report table. Besides, if the 'Total' line is available, then the averaging will be applied to the total number of the scored penalty points. The algorithm of averaging is described above. You can also get acquainted with it on the 'Eco Driving' tab of a unit properties dialog.
Penalty–Rank Conversion
The system provides the algorithm to convert received penalties into a rank:
Penalty Rank
Less than 20 5.9
20-50 5.0
50-100 4.0
100-200
200-500
3.0
2.0
More than 500 1.0
264
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 Daily engine hours rate to calculate utilization and productivity.
There are two properties which can be used in engine hours report. They are
timeout (to be indicated for a sensor) and
defining of engine hours amount. If values for both timeout and maximum interval between messages are indicated, then the system will use the property with minimum value indicated.
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 separate table for each engine if there are several.
In the table, you can see:
Beginning
: time when engine hours interval begins.
Initial location
: location at that moment.
End
: time when engine hours interval ends.
Final location
: location at that moment.
Engine hours
: value of engine hours on the interval. For accurate engine hours calculation, the equipment should send a valid parameter value of an engine sensor. In case of receiving an invalid value, it is necessary to
replace sensor with validator using the correct value (for example, 0).
Initial engine hours
: value of engine hours in the beginning of the interval.
Final engine hours
: value of engine hours in the end of the interval.
Total time
: duration of the interval. If grouping by days is enabled, it shows time from the beginning of the first engine hours interval to the end of last interval.
Off-time
: period of time passed from the end of the previous interval to the beginning of the current one (to be defined beginning from the second interval).
In movement
: time when the unit had been moving within this interval.
Idling
: time when the unit was standing with the engine on. Note that idling cannot be detected if an equipment sends no messages containing speed value.
Mileage
: distance traveled for an interval of engine operation.
Mileage (adjusted)
: mileage subject to the coefficient set in unit properties (Advanced tab).
Avg speed
: average speed for an interval of engine operation.
Max speed
: maximum speed for an interval of engine operation.
Counter
: counter sensor value.
Initial counter
: counter value at the beginning.
Finale counter
: counter value at the end.
Avg engine revs
: average rate of engine revolutions.
265
Max engine revs
: maximum rate of engine revolutions.
Avg temperature
: average temperature value registered for an interval of engine operation.
Min temperature
: minimum temperature value registered for an interval of engine operation.
Max temperature
: maximum temperature value registered for an interval of engine operation.
Initial temperature
: temperature value upon the beginning of engine hours operation.
Final temperature
: temperature value upon the end of engine hours operation.
Status
: unit status registered during engine hours operation (if there are several, the first one is displayed).
Cargo weight
: weight of a transported cargo.
Driver
: driver's name if such was identified.
Trailer
: trailer's name if any was bound.
Movement productivity
: percentage ratio of engine hours in movement to engine hours duration.
Engine efficiency duration
: the duration of attached implements operation (if having engine efficiency sensor).
Engine efficiency idling
: engine operation time after deduction of efficiency time (total engine hours subtract engine efficiency duration).
Utilization
: percentage ratio of engine hours duration to engine hours rate (engine hours divided by daily engine hours rate indicated in unit properties).
Useful utilization
: percentage ratio of engine efficiency duration to engine hours rate.
Productivity
: percentage ratio of engine efficiency duration to engine hours duration.
Consumed
: the volume of consumed fuel detected by any sort of fuel sensor. If several such sensors are available, their values sum up.
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
: average fuel consumption by any sort of fuel sensor. If several such sensors are available, their values sum up.
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.
Penalties
: penalties calculated for adjusted
Rank
: received penalty points converted into a grade using 6 point scoring system.
Notes
: an empty column for your custom comments.
sensors, driver, trailer, fuel fillings, fuel thefts, and geofences/units.
266
Events
All events registered by the system (including violations
) can be shown in the report on events.
There are different ways to add events to unit history:
1.
Triggered
which method of delivery is Register event for unit.
2.
Events registered manually by the user in
3.
Manipulations with
(change, store, reset counter value) with the help of corresponding
.
4.
Automatically, upon completing a
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.
The following columns can be included to this table:
Event time
: time when the event happened.
Time received
: time when the server received this data.
Event text
: notification text or event description.
Location
: unit location at the moment of an event. If an event is registered manually then unit's location is detected on the basis of messages received upon event registration. The same is true for events registered by storing counters' values in unit properties.
Driver
:
Count
: the count of events.
Notes
: an empty column for your custom comments.
In addition, you can use special
markers for this report: a green flag means event, a red flag means violation. In the
tooltip you can find the detailed information.
267
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
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 '
' panel.
268
Fuel Fillings
This report shows where and when a vehicle was filled up. Parameters for the report to be generated are set in
Properties => Fuel Consumption
. This report is generated on the basis of fillings registered manually
or detected by sensors. A table cannot be generated if no fuel fillings are found on the indicated time interval.
This report may include the following columns:
Time
: date and time of filling.
Location
: unit location upon filling (if a filling is registered manually, then unit's location is detected on the basis of messages received upon filling registration).
Initial fuel level
: fuel level before the filling.
Final fuel level
: fuel level after the filling.
Filled
: the volume of filled fuel (sensor name may be indicated in brackets).
Registered
: the volume of registered fuel.
Difference
: difference between detected and registered filling volume.
Description
: short description indicated upon manual registration of fuel filling.
Sensor
: sensor which detected the filling.
Driver
: driver's name if one was identified.
Trailer
: trailer's name if any was bound.
Count
: the number of fillings.
Mileage
: distance traveled from the interval start to the filling end.
Notes
: an empty column for your custom comments.
this table. Note that in case with sensors' masks, intervals filtration is applied to fuel filling detected by sensors only.
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.
See also
.
269
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 .
In the table, you can have:
Beginning
: date and time when the theft began.
Initial location
: unit location at that moment.
Time
: moment of the most significant drop of fuel level.
Final location
: unit location at that moment.
Initial fuel level
: fuel level before the theft.
Initial speed
: speed at the beginning.
Stolen
: stolen fuel volume.
Final fuel level
: fuel level after the theft.
Final speed
: speed at the end.
Sensor name
: sensor which detected fuel theft.
Driver
: driver's name if any was identified.
Trailer
: trailer's name if any was bound.
Count
: the number of thefts.
Counter
: counter sensor value.
Mileage
: distance traveled from the interval start to the theft end.
Notes
: an empty column for your custom comments.
by geofences/units, driver, trailer, and theft volume can be additionally applied to this table.
can be shown on the map in the places of thefts.
See also
.
270
Geofences
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
name.
The following columns can be selected for this table:
Geofence
: geofence name.
Type
: polygon, line, circle, unit (if units and not geofences are selected in the report template).
Area
: total area of the geofence (if the metric system is used, then area will be indicated in hectares).
Perimeter
: perimeter of the geofence. Perimeter for a line is its length (line thickness is not taken into account).
Description
: taken from geofence properties.
Time in
: the time when the unit entered the geofence.
Time out
: time when the unit left the geofence.
Duration in
: duration of the visit.
Total time
: time from the first visit beginning to the last visit end.
Parkings duration
: time spent in parkings.
Off-time
: time between the previous visit and the current one (to be defined beginning from the second geofence visit).
Mileage
: mileage in this visit.
Mileage (adjusted)
: mileage subject to the coefficient set in unit properties (Advanced tab).
Counter
: value of counter sensor.
Initial counter
: counter value at the entrance.
Finale counter
: counter value at the exit.
Avg engine revs
: average rate of engine revolutions.
Max engine revs
: maximum rate of engine revolutions.
Avg temperature
: average temperature value registered inside a geofence.
Min temperature
: minimum temperature value registered inside a geofence.
Max temperature
: maximum temperature value registered inside a geofence.
Initial temperature
: temperature value upon entering a geofence.
Final temperature
: temperature value upon leaving a geofence.
Off-mileage
: mileage traveled from previous visit.
Off-mileage (adjusted)
: mileage traveled from previous visit subjected to the coefficient.
Avg speed
: average speed the unit was moving in the geofence.
Max speed
: maximum speed detected in that visit.
Driver
: driver's name if available.
Trailer
: trailer's name if any was bound.
Visits
: the number of visits (can be helpful either in grouping table data by years/months/weeks/days/shifts or for the reports on unit groups).
Consumed
: the volume of consumed fuel detected by any sort of fuel sensor. If several such sensors are available, their values sum up.
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.
Details about fuel in reports...
Avg consumption
: average fuel consumption by any sort of fuel sensor. If several such sensors are available, their values sum up.
Avg consumption by ImpFCS/AbsFCS/InsFCS/FLS/math/rates
: average fuel consumption by one of the methods mentioned above.
271
Penalties
: penalties calculated for adjusted
Rank
: received penalty points converted into a grade using 6 point scoring system.
Notes
: an empty column for your custom comments.
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.
sensors, drivers, trailers, fuel fillings and thefts.
Geofences can be displayed on the map. To do so, choose '
option in the report template.
Note that monitoring system provides a possibility of detecting geofence visit in case a trip intersects a geofence by
any segment of its track. This option can be enabled in the advanced settings
of a report template.
See related reports — Non-visited Geofences
,
272
GPRS Traffic
To apply this report to a unit, this unit must have registered events of
GPRS traffic counter reset or traffic storage
.
Time
: time when the counter value was registered.
Current value
: value at the moment of registration.
Absolute value
: GPRS traffic total size by the moment of registration.
Reset
: Yes — reset was fulfilled, No — no reset was fulfilled.
Notes
: empty column for your custom notes.
273
Images
This report shows all the images received from a unit. Click on the image to open it in the image viewer.
Moreover, every image contains additional information, such as date, time, and sending location. Click this information in order the map to be centered on unit's location at the moment of image sending. Location is shown on the map with the blue marker.
In addition, you can use special markers for this report.
274
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 name
: name of an item. This column is used in the same report on users only.
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.
Log example for a resource:
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 a unit group has an additional parameter — 'Group itself'. If this checkbox is 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:
275
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 indicated upon a 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 upon a registration.
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.
276
Messages Tracing
The main target of this report is to facilitate the work with parameters from
messages . To do so, parameters are not
presented as single data array, but have a particular structure. It means that every parameter is located in its own column.
Along with the values of parameters this report contains other columns as well:
Time
: date and time of sending a message.
Speed
: speed of a unit.
Coordinates
: unit's coordinates.
Location
: address of a unit location.
Value
: value of a parameter sent in a message.
Driver
: driver's name if available.
Trailer
: trailer's name if any was bound.
Notes
: an empty column to add your custom comments after printing or exporting the report.
Note that you can view the position of a unit on map by clicking on a link in such columns as 'Time', 'Coordinates', and
'Speed'.
Note.
This table cannot be generated for unit groups.
277
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 11 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 1st to 5th of June. To do this, we enable grouping by days
(with detalization), select necessary geofences and columns for the table.
Geofence
: geofence name.
Type
: geofence type (line, polygon, or circle).
Area
: total geofence area (if the metric system is used, then area will be indicated in hectares).
Perimeter
: geofence perimeter.
Count
: the number of geofences that were skipped.
Notes
: an empty column for your custom comments.
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.
278
Orders
Attention!
To generate a report, activate the 'Orders'
This kind of report shows detailed information concerning orders. A table may contain the following columns:
Name
: a name of an order.
Client name
: client name.
Time from
: time from which an order should be delivered (beginning of a delivery interval).
Time to
: time to which an order should be delivered (end of a delivery interval).
Estimated arrival time
: approximate time of arriving to a destination point (system calculation).
Actual arrival time
: actual time of arriving to a destination point.
Deviation
: difference between actual and estimated arrival time.
Estimated mileage
: approximate distance to a destination point (system calculation).
Actual mileage
: actual distance covered to a destination point.
Estimated time to point
: approximate time for covering distance between previous and current destination points (system calculation).
Actual time to point
: actual time spent for covering distance between previous and current destination points.
Fuel consumed
: amount of fuel spent for an order delivery.
Avg temperature
: average temperature value registered for an interval of an order distribution.
Min temperature
: minimum temperature value registered for an interval of an order distribution.
Max temperature
: maximum temperature value registered for an interval of an order distribution.
Initial temperature
: temperature value upon the beginning of an order distribution.
Final temperature
: temperature value upon the end of an order distribution.
Status
: сorder delivery state (confirmed/rejected/not set).
Comment
: comment entered upon status indication.
Address
: delivery point's address.
Weight
: total weight of goods in the order.
Volume
: a quantitative value (for example, items) of an order indicated upon its creation.
Cost
: total cost of goods in the order.
Additional parameters can be chosen for this kind of report. In other words, a report on orders can be generated on the basis of orders of a particular type:
All orders
— all orders for an indicated time period.
Visited
— courier's arrival to an address is detected or any status is set.
Visited late
— orders are visited late or any statuses are set late.
Fulfilled
— courier's arrival to an address is detected, the 'Confirm' status is set.
Rejected
— orders with the 'Reject' statuses set.
Visited without status
— courier's arrival to an address is detected, a status is not set.
Non-visited
— courier's arrival to an address is not detected.
279
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.
A parking is an interval of time when the following conditions are satisfied:
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.
The following information is presented in this kind of report:
Beginning
: the time when the parking started.
End
: the time when the parking ended.
Duration
: time interval of the parking.
Total time
: time from the first parking beginning to the last parking end.
Off-time
: time interval from the previous parking end to the current parking beginning (to be defined beginning from the second parking).
Location
: the address where the unit was stationary. If there was an insignificant movement detected, the initial address is used.
Driver
: driver's name if available.
Trailer
: trailer's name if any was bound.
Counter
: counter sensor values.
Initial counter
: counter value at the beginning of the parking.
Finale counter
: counter value at the end of the parking.
Avg temperature
: average temperature value registered for the parking interval.
Min temperature
: minimum temperature value registered for the parking interval.
Max temperature
: maximum temperature value registered for the parking interval.
Initial temperature
: temperature value in the beginning of the parking interval.
Final temperature
: temperature value in the end of the parking interval.
Avg weight
: average weight value registered for the parking interval.
Min weight
: minimum weight value registered for the parking interval.
Max weight
: maximum weight value registered for the parking interval.
Initial weight
: weight value in the beginning of the parking interval.
Final weight
: weight value in the end of the parking interval.
Status
: unit status registered during the current parking interval (if there are several, the first one is displayed).
Count
: the number of parkings (can be helpful either in grouping table data by years/months/weeks/days/shifts or for the reports on unit groups).
Notes
: an empty column for your custom comments.
280
See
Data in Reports to learn how time (duration) can be formatted.
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
281
Profile
This kind of report shows profile information indicated on the
of unit properties dialog.
The following columns can be included in the table:
Name
: name of an element.
Value
: indicated value.
Notes
: an empty column for your custom comments.
282
Rides
A ride is a travel from one point (called ride beginning) to another (called ride ending). A ride can be done many times in a specified time period. Rides are useful, for example, when controlling cargo transportation form one point to another in several attempts.
For the report to be generated, two factors are significant:
1) when a unit leaves the ride beginning geofence;
2) when a unit enters the ride ending geofence.
If both of these factors occur, then a ride is completed and can be included in the report. In addition, trip detector is taken into consideration.
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 the task is to transport goods from one place to another, and more than one ride will be required for this. To control this process, we create two geofences and then assign them starting and terminal points appropriately in the report template.
Ride Parameters
When you create a template for rides, pay attention on additional parameters to be set.
Allow circle ride
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.
Show the rides finished with a stop
This can be used as an additional filter. If activated, it means that the ride ends if a unit stops in the destination geofence. Note that stop is considered to be a unit state in which its speed is less than the minimum moving speed indicated in
(after the ride beginning has been detected), but does not make a stop there, then the ride is continued. The ride ends only upon making a stop in the destination geofence.
Starting and terminal points
In this section you choose which geofences and units will be analyzed in the report. The list of geofences includes only
283
those geofences that belong to the same resource as the report template itself. Besides, you can choose units as socalled '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's area and ride end at an ordinary geofence.
Besides,
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.
Note that monitoring system provides a possibility of detecting geofence visit in case a trip intersects a geofence by
any segment of its track. This option can be enabled in the advanced settings of a report template.
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 traveled 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.
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 (can be helpful either in grouping table data by years/months/weeks/days/shifts or for the reports on unit groups).
Initial counter
: counter value at the beginning.
Finale counter
: counter value at the end.
Avg temperature
: average temperature value registered in a ride.
Min temperature
: minimum temperature value registered in a ride.
Max temperature
: maximum temperature value registered in a ride.
Initial temperature
: temperature value in the beginning of a ride.
Final temperature
: temperature value in the end of a ride.
Count
: the number of rides.
284
Status
: unit status registered during the current ride (if there are several, the first one is displayed).
Cargo weight
: weight of a cargo transported within a trip between geofences.
Consumed
: the volume of consumed fuel detected by any sort of fuel sensor. If several such sensors are available, their values sum up.
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
: average fuel consumption by any sort of fuel sensor. If several such sensors are available, their values sum up.
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.
Penalties
: penalties calculated for adjusted '
Rank
: received penalty points converted into a grade using 6 point scoring system.
Notes
: an empty column for your custom comments.
.
285
Rounds (for unit)
If any
can be generated:
Route
: route name.
Schedule
: schedule name.
Round
: round name.
Beginning
: round beginning time (activation time or entrance in the first check point).
Initial location
: unit location at the beginning of the route.
End
: round end time (entrance to the last point).
Final location
: unit location at the end of the route.
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).
Skipped points
: the number of check points skipped (on this basis more detailed report can be generated
— see
Duration
: time taken to perform the route.
Total time
: time from the first route beginning to the last route end.
Mileage
: distance traveled while performing the route.
Avg speed
: average speed on the route.
Max speed
: maximum speed on the route.
Count
: the number of routes.
Driver
: driver's name if available.
Trailer
: trailer's name if any was bound.
Notes
: an empty column for your custom comments.
In addition, in
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.
sensors, driver, trailer, fuel thefts, fillings, and geofences/units.
286
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 performing the round.
Status
: 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
Skipped
: the number of check points skipped.
Visited
: the number of check points visited.
Report type should be Route.
287
Sensor Tracing
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:
Speed
: unit's speed from the message from which the value was taken.
Coordinates
: unit's coordinates from the message.
Location
: unit's location at the moment of sending the message with the sensor's value.
Sensor
: sensor name.
Time
: the time of the message from which the value was taken.
Value
: the value (numbers only).
Formatted value
: the value in the indicated units of measurement.
Driver
: driver's name if available.
Trailer
: trailer's name if any was bound.
Notes
: an empty column for custom notes.
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. If you choose this option, the columns 'Values' or/and 'Formatted value' will be generated for each sensor individually. This allows exporting sensor values to MS Excel and eventually building various charts and diagrams on this basis.
If you activate the options 'Each sensor in separate column' and 'Skip invalid values' simultaneously, only the lines that have at least one sensor's value will be shown in the generated report. The lines without any sensor's value will not be shown. A name of a column containing formatted values is marked by a special symbol (*). Formatted value fields may contain textual information (in brackets) indicated for
for details).
Invalid Values
If a received value is out of range (the bounds are indicated in sensor properties), then there will be a dash (« —– ») in the lines with the sensor's values. To exclude such rows, flag the option 'Skip invalid values' in the report template.
288
The cases when a sensor sends text values (as opposed to numeric) or no values at all are also considered 'invalid'.
289
SMS Messages (for unit)
This report gives possibility to view all SMS messages received 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.
290
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:
Time
: time of sending a message.
User
: name of a user sending a message.
Phone
: a phone number the message is sent to.
Parts
: number of parts the message consists of.
291
Speeding
This kind of report shows speed limitation violations. The parameters for this report are set in
. 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.
The following information can be presented in this kind of report:
Beginning
: date and time when the speed limit was exceeded.
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.
Max speed
: maximum speed within this period.
Speed limit
: maximum allowed speed on particular road section or in unit properties.
Mileage
: the distance traveled with exceeded speed.
Mileage (adjusted)
: mileage subject to the coefficient set in unit properties ('Advanced' tab).
Initial mileage
: mileage counter value at the moment of speeding beginning. If no saving of mileage parameter was made through the reported period, then mileage is counted from 0.
Final mileage
: mileage counter value at the moment of speeding interval's end.
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.
(by speeding duration, mileage, driver, geofences/units) can be applied to this table.
You can use special
Other means to control speed are described in
292
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
Minimum parking time
, it is registered as a parking (not a stop).
The following information is presented in this kind of report:
Beginning
: the time when the stop started.
End
: the time when the stop ended.
Duration
: total time of the stop.
Total time
: time from the first stop beginning to the last stop end.
Off-time
: time from the end of the previous stop to the beginning of this one (to be defined beginning from the second stop).
Location
: the address where the unit stopped.
Driver
: driver's name if available.
Trailer
: trailer's name if any was bound.
Count
: the number of stops.
Counter
: counter sensor values (can be helpful either in grouping table data by years/months/weeks/days/shifts or for the reports on unit groups).
Notes
: an empty column for your custom comments.
Avg weight
: average weight value registered for the stop interval.
Min weight
: minimum weight value registered for the stop interval.
Max weight
: maximum weight value registered for the stop interval.
Initial weight
: weight value in the beginning of the stop interval.
Final weight
: weight value in the end of the stop interval.
See
Data in Reports to learn how time (duration) can be formatted.
(by stop duration, sensor state, driver, trailer, fuel fillings and thefts) can be applied to this table.
This kind of report can be supplemented by corresponding
293
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. In other words, summary report processes all the messages for the indicated period regardless to the unit's duration of work, and time spent in motion.
The following columns can be included:
Mileage in trips
: mileage on the interval by trip detector.
Mileage in all messages
: mileage on the interval by mileage counter.
Mileage (adjusted)
: mileage on the interval by mileage counter multiplied by
mileage coefficient (a setting
in unit properties).
More about mileage in reports...
Avg speed
: average speed on the interval.
Max speed
: maximum speed on the interval. More about speed in reports...
Move time
: time in trips.
Engine hours
: time of engine hours operation.
Engine efficiency duration
: the duration of attached implements operation (if having engine efficiency sensor).
Parkings
: total time of parkings on the interval.
Counter
: counter sensor value.
Initial counter
: counter value at the beginning of the interval.
Final counter
: counter value at the end of the interval.
Custom sensor initial value
: custom sensor value at the beginning of the interval. If there are more than one custom sensors, a separate column is built for each of them and name is written in brackets. Custom sensors name masks can be indicated in the right part of the template dialog.
Custom sensor final value
: custom sensor value at the end of the interval.
Difference
: difference between initial and final values of custom sensor.
Utilization
: percentage ratio of engine hours duration to engine hours rate (engine hours divided by daily engine hours rate indicated in unit properties).
Useful utilization
: percentage ratio of engine efficiency duration to engine hours rate.
Productivity
: percentage ratio of engine efficiency duration to engine hours duration.
Consumed
: the volume of consumed fuel detected by any sort of fuel sensor. If several such sensors are available, their values sum up.
Consumed by…
: 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. Besides, in report template (on the right) you can specify additional parameters to calculate fuel: on the whole intervals, in trips or in engine hours.
Avg consumption
: average fuel consumption by any sort of fuel sensor. If several such sensors are available, their values sum up.
Avg consumption by…
: average fuel consumption on the interval. Details about fuel in reports...
Initial fuel level
: counter value at the beginning of the interval.
Final fuel level
: counter value at the end of the interval.
Total fillings
: number of fuel fillings detected.
Total thefts
: number of fuel thefts detected.
Filled
: volume of filled fuel (only fuel fillings detected by a sensor).
Stolen
: volume of stolen fuel.
Penalties
: penalties calculated for adjusted
Rank
: received penalty points converted into a grade using 6 point scoring system.
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.
294
'Summary' table is presented by one row — summarized data for a chosen period of time. However, report template parameters for this table contain an individual option — 'Summary by'. This option allows choosing time interval
(shifts/days/weeks/months) according to which table data will be arranged. This option can be used either in reports for units or in
Note.
Often a value received from analog sensor may differ from the corresponding value in the 'Total' row. It is stipulated by analog data leaping, and application of grouping by days/weeks/months towards the values received as a result of processing such data. In the other words, analog data values (with or without leaps) are divided into intervals and then summarized. That is why the value of the summarized intervals can be sufficiently different from the value not divided into intervals. And so far as the values in the 'Total' row are not divided into intervals, you can receive the difference comparing to the values from analog sensors. For example, calculating fuel, a value in the 'Consumed by FLS' column may differ from the corresponding value in the 'Total' row.
295
Trips
This kind of report shows intervals of movement with indication of time, location, and other parameters such as speed,
Detection and adjusted for each unit individually.
The following columns can be included in this kind of report:
Beginning
: date and time when the trip began.
Initial location
: the address where the device was at the beginning of the trip.
End
: date and time when the trip ended.
Final location
: the address where the device was at the end of the trip.
Driver
:
driver's name (if a driver was identified).
Trailer
:
trailer's name if any was bound.
Passengers count
: number of passengers carried within a trip.
Duration
: time interval of the trip.
Total time
: time from the first trip beginning to the last trip end.
Off-time
: period of time passed from the end of the previous trip to the beginning of the current one (to be defined beginning from the second trip).
Following off-time
: period of time passed from the end of the current trip to the beginning of the next one.
Engine hours
: time of engine hours operation during the trip (you can specify engine hours sensor entering name mask for it in the report template).
Mileage
: the distance traveled in the whole trip.
Mileage (adjusted)
: mileage considering a coefficient set in unit properties ('Advanced' tab).
Urban mileage
: the distance traveled in urban area.
Suburban mileage
: the distance traveled in suburban area. It is calculated in regard to speed. The
urban/suburban speed line is indicated in Unit Properties => Advanced ('Urban speed limit' setting).
Initial mileage
: mileage counter value at the moment of trip beginning. If no saving of mileage parameter was made through the reported period, mileage is counted from 0.
Final mileage
: mileage counter value at the moment of trip ending.
Toll roads mileage
: the distance of a trip travelled by the roads where 'Platon' system is used.
Toll roads cost
: a sum of money (in RUB) for the toll roads mileage calculated on the basis of covered distance and the 'Platon' tariff.
Avg speed
: average speed within the trip.
Max speed
: maximum speed registered within this interval.
Trips count
: the number of trips made.
Counter
: counter sensor value.
Initial counter
: counter value at the beginning of the trip.
Final counter
: counter value at the end of the trip.
Avg engine revs
: average rate of engine revolutions.
Max engine revs
: maximum rate of engine revolutions.
Avg temperature
: average temperature value registered in a trip.
Min temperature
: minimum temperature value registered in a trip.
Max temperature
: maximum temperature value registered in a trip.
Initial temperature
: temperature value in the beginning of a trip.
Final temperature
: temperature value in the end of a trip.
Status
: unit status registered during the current trip (if there are several, the first one is displayed).
Cargo weight
: weight of a cargo transported within a trip.
Messages count
: the number of messages that formed the trip.
Consumed
: the volume of consumed fuel detected by any sort of fuel sensor. If several such sensors are available, their values sum up.
Consumed by ImpFCS/AbsFCS/InsFCS/FLS/math/rates
: the volume of consumed fuel detected by a fuel
296
sensor (like impulse/absolute/instant fuel consumption sensor, fuel level sensor) or calculated by math or rates.
Details about fuel in reports...
Rates deviation by ImpFCS/AbsFCS/InsFCS/FLS
: difference between consumed fuel detected by a sensor and consumption rates. If a number in this cell is negative, it means detected consumption does not exceed the indicated rates.
Avg consumption
: average fuel consumption by any sort of fuel sensor. If several such sensors are available, their values sum up.
Avg consumption by ImpFCS/AbsFCS/InsFCS/FLS/math/rates
: average fuel consumption in the trip detected by one of the methods mentioned above.
Avg consumption in idle run by …
: average fuel consumption in the trip during idle run.
Avg mileage per unit of fuel by …
: average fuel consumption (per one liter/gallon) in the trip detected by one of the methods mentioned above.
Initial fuel level
: fuel level at the beginning of the trip.
Final fuel level
: fuel level at the end of the trip.
Max fuel level
: maximum fuel level in the trip.
Min fuel level
: minimum fuel level in the trip.
Penalties
: penalties calculated for adjusted '
Rank
: received penalty points converted into a grade using 6 point scoring system.
Notes
: an empty column for your custom comments.
Attention!
Availability of the columns 'Toll roads mileage' and 'Toll roads cost' is stipulated by a special service. Contact your service provider if you would like to use this functionality.
See
Data in Reports to discover more about formatting time, mileage, fuel, etc.
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
option in report template.
297
Unfinished Rides
See the
Rides topic 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.
The structure of the report is the same as for usual rides:
Ride
: departure and destination geofences.
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 traveled 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.
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.
Final counter
: counter value at the end.
Count
: the number of rides (can be helpful either in grouping table data by years/months/weeks/days/shifts or for the reports on unit groups).
Status
: unit status registered during the current ride (if there are several, the first one is displayed).
Consumed
: the volume of consumed fuel detected by any sort of fuel sensor. If several such sensors are available, their values sum up.
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.
Details about fuel in reports...
Avg consumption
: average fuel consumption by any sort of fuel sensor. If several such sensors are available, their values sum up.
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.
Penalties
: penalties calculated for adjusted '
Rank
: received penalty points converted into a grade using 6 point scoring system.
Notes
: an empty column for your custom comments.
298
See
Rides to find out more information about additional parameters for 'Unfinished rides'.
299
Upcoming Maintenance
Upcoming maintenance table contains a list of service works set for a unit, and status of their execution. A table may include the following columns:
Service interval
: a name of a service work indicated on the 'Service Intervals' tab of a unit properties dialog in the 'Service name' field. The work should be repeatedly done in a particular interval which is also indicated on the 'Service Intervals' tab.
State
: an overall state of service work execution. In other words, it corresponds to the left or exceeded interval of mileage, engine hours, and days.
State by mileage
: left or expired mileage interval.
State by engine hours
: left or expired engine hours interval.
State by days
: left or expired days interval.
Description
: information taken from the corresponding field on the 'Service Intervals' tab.
Frequency
: an interval (mileage, engine hours, or days) showing how often a vehicle maintenance should be executed.
Notes
: an empty column for your custom comments.
Note that there is no need in indicating time interval for the 'Upcoming maintenance' report generation, because this table provides you with the information on all the indicated service works regardless to the time period.
Moreover, an individual parameters of
grouping (without any connection to time intervals) are used in the 'Upcoming
maintenance' table. Data can be grouped on the basis of state (planned/expired maintenance), service interval, or unit
(for reports on unit groups).
300
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
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).
The table can be composed of the following columns:
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.
301
Video
This report provides you with a list of video files received from a unit. The report contains the fixed number of columns:
Time
: time a video file being received;
Location
: location of a unit upon sending video file;
Video
: here you can find an icon clicking which a video is opened for viewing.
302
Violations
Violations are particular case of
events . The report on violations gives the list of violations detected and registered in
unit history.
Violations are:
1.
Triggered
which method of delivery is Register as violation;
2.
Manually registered custom events if they have the Violation flag.
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.
The following information can be presented in this kind of report:
Violation time
: time when the violation happened.
Time received
: time when the server received this data.
Violation text
: notification text or event description.
Location
: unit location at that moment.
Driver
:
Count
: the number of violations.
Notes
: an empty column for your custom comments.
In addition, you can use special markers
for this report.
303
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.
The following columns can be presented in this kind of report:
Street
: street, roads, highway, etc. name.
Initial location
: place where the first messages from this street was received. It can be the same as the previous cell or more detailed (for example, it can additionally contain house number).
Beginning
: time when the unit started moving along this street.
End
: time when the unit left the street.
Duration
: total time the unit was there.
Mileage
: distance that was traveled by the unit while moving through this street.
Mileage (adjusted)
: mileage subject to the coefficient set in advanced unit properties. About mileage in reports...
Avg speed
: average speed while moving along this street.
Max speed
: maximum speed detected while moving along this street.
Streets count
: the number of performed visits (can be helpful either in
years/months/weeks/days/shifts or for the reports on unit groups).
Notes
: an empty column for your custom comments.
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.
sensors, fuel fillings and thefts. For example, you can get streets where a sensor was on or the streets where a sensor was off.
304
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 '
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
Cargo weight
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)
305
Fuel consumption by ImpFCS
Fuel consumption by AbsFCS
Fuel consumption by InsFCS
Fuel consumption by FLS
Fuel consumption by math
Fuel consumption by rates
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 Charts
'Fuel level'
chart represents 'raw' data. On the contrary, 'Processed fuel level' chart shows filtered data.
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).
306
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, or to detect made-up additions to the mileage.
307
Chart Parameters
Sensors Masks
In the parameters block (right part of the dialog) you can indicate particular sensors on the basis of which the corresponding charts will be built. This selection does not affect such charts as 'Speed', 'Altitude', 'Fuel consumption by math' and 'Fuel consumption by rates' because these charts can be built regardless to unit sensors availability.
To indicate the necessary sensors, enter the corresponding masks. You can indicate full sensor name or its part using wildcard symbols like asterisk * (replaces any number of characters) or question sign ? (replaces one character). A sensor name cannot contain comma. If no masks are indicated, then the system automatically defines sensors of a required type to build charts.
Markers
In this section you can choose markers to visualize corresponding events on a chart. The same
the map.
Background
The following intervals of events can be used as a chart background: stops, parkings, trips, connection losses, and work of engine hours. Using these backgrounds you can correlate a chart value and an interval to which it corresponds. Different colors can be chosen for a background (click the color box). Note that backgrounds are opaque and they have a priority of visualization. In other words, an upper interval covers the bottom ones. To change a priority, drag and drop a corresponding event interval.
Line Color
This section provides a possibility of using
as a line color of a corresponding chart. To apply sensor's color scheme, indicate its mask in the corresponding field of the section. If no mask is indicated, then default colors are used.
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
308
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).
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.
Count from Zero
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).
On the picture below you can see two temperature charts built for one unit for the same time interval. The first chart is regular, the second one has the flag 'Count from zero' activated.
309
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.
Below is an example where the orange line displays a raw speed chart, and the blue line displays a smoothed speed chart.
310
Special Charts
Along with the regular charts, you can generate the following charts:
Processed fuel level
Speed/Fuel Consumption by…
or
Processed Fuel Level
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 '
' tab (the option 'Filter fuel
level sensors values'
) or in
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.
311
A special chart 'Processed fuel level' should be distinguished from two similar regular charts:
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' represents dependence of filtered and smoothed on the basis of mileage data from time.
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.
Speed/Fuel Consumption Chart
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 '
' tab.
For example, to create this chart, a unit with instant fuel consumption sensor (InsFCS) was used.
312
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.
Above the chart, there is a toolkit with useful buttons:
Area selection
Activate the button in order to zoom in any selected chart area. Select an area holding left mouse button. This operation can be repeated multiple times.
/
Lock/unlock Y axis
Autoscaling
Button to switch between working with a single axis (X) to multiple axes (XY).
Go back to a default chart scale by clicking this button.
Zoom in/zoom out
The buttons to scale a chart along the X axis. Click a button in order to make a visible area of the chart twice as wide/narrow in regard to the current position. Yet the center of the chart stays in its place.
/
Messages/point
Switching between these modes, you can view details either of a single chart or all the available ones.
tracing
Save as PNG
To save a visible chart area along with the axis in PNG format, click this button.
If the X axis shows time, you can click on any place of the chart to move to the corresponding location on the map.
Transfer from chart to messages
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
.
Upon switching between charts, the button receives a default state automatically.
Chart Legend
A chart legend can be found in the work area. The legend contains several sections of information on the chosen charts and their
parameters . Using the legend you can choose parameters to be shown
on a chart (all of them are shown by default). To enable/disable any
313
parameter, click it in the legend.
314
Map Output
In the '
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
dialog. These can be
routes traveled by unit, created
geofences , as well as special
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 click 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.
315
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
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
).
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
Advanced Reports ). It is reasonable to assign different colors for
316
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.
317
Geofences on Map
Created
Render geofences
— in the section 'Map' of the report template.
Geofences are displayed with their captions and images or icons (if you have chosen any). The color and the font size of the caption is taken from their properties. Apart from that, additional options can be applied to geofences:
Group icons
.
The geofences that overlap each other can be replaced by one conditional item, and its tooltip will contain
the detailed information. The same can be applied to markers .
Consider geofence visibility scale
.
By default, all the geofences are rendered on the map. However, they can be seen or hidden according to their visibility parameter set in the properties .
Note.
Geofences are taken only from the same account as the report template itself.
318
Markers
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 marker
Stop marker
Filling marker
Theft marker
Event marker
Marks a location where according to the
trip detector a parking takes place. A tooltip shows the
beginning of a parking time and parking duration.
Marks a location where according to the
trip detector a stop takes place. A tooltip shows the beginning
of a stop time and stop duration.
Marks a location where according to sensors data a fuel filling takes place. A tooltip shows filling time and amount of fuel filled.
Marks a location where according to sensors data a fuel theft takes place. A tooltip shows theft time and amount of fuel stolen.
Marks a location where events were automatically registered in
,
description) is indicated upon event registration. A tooltip shows event time and text of an event.
If you choose event markers, then both event and violation markers to be displayed, because violation is a special case of an event.
Violation marker
Speeding marker
Marks a location where speed limits indicated in the unit properties
have been violated. A tooltip shows the initial time of speeding interval (i.e., the time of receiving the first message with speed value 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 marker
Video marker
Marks a location where
Marks a location where
from a unit have been received.
from a unit have been received.
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.
319
Moreover, markers as well as geofences can be grouped in case they overlap each other — indicate the 'Group icons' option in report template for it. In case of markers grouping, a number of elements included in a group is indicated.
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 information.
You can enable 'Marker numbering' option in report template. In this case, each marker will have its sequence number which is indicated below the marker in red color. Numbers are assigned chronologically, and each marker type has its own numeration.
Unit Last Location
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
320
(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.
321
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
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.
322
Statistics
Report
: reports template name.
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
: the volume of consumed fuel detected by any sort of fuel sensor. If several such sensors are available, their values sum up.
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
: average fuel consumption by any sort of fuel sensor. If several such sensors are available, their values sum up.
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.
Eco driving
Penalties
: overall penalty for
Rank
: received penalty points converted into a grade using 6 point scoring system.
Engine hours
Engine hours
: engine hours duration. It can be calculated by engine hours sensor or by ignition sensor depending on unit properties.
Initial engine hours
: value of engine hours in the beginning of the interval.
Final engine hours
: value of engine hours in the end of the interval.
In movement
: time when the unit had been moving within this interval.
Idling
: total idling time.
Mileage in engine hours
: distance traveled 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.
Consumed in e/h
: the volume of consumed fuel detected by any sort of fuel sensor. If several such sensors are available, their values sum up.
323
Consumed 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.
Consumed in idle run by ImpFCS/AbsFCS/InsFCS/FLS/math/rates
: fuel volume used in engine hours during idle running detected by one of the methods mentioned above.
Avg consumption in e/h
: average fuel consumption by any sort of fuel sensor. If several such sensors are available, their values sum up.
Avg consumption by ImpFCS/AbsFCS/InsFCS/FLS/math/rates in e/h
: average fuel consumption in engine hours detected by one of the methods mentioned above.
Avg consumption by ImpFCS/AbsFCS/InsFCS/FLS/math/rates in e/h in trips
: average fuel consumption in engine hours in trips detected by one of the methods mentioned above.
Events
Events count
: the number of
registered.
Executed commands
Executed commands
: the number of
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.
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
Maintenance
Total maintenance duration
: time spent for servicing.
Total maintenance cost
: total cost of all maintenance works.
Services count
: the number of services performed.
Orders
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.
Total orders
: total amount of orders within the indicated time period.
Orders visited
: courier's arrival to an address is detected or any status is set.
Orders visited in time
: an order is visited in time (in advance) or any status is set.
Orders visited late
: an order is visited late or any status is set late.
Non-visited orders
: courier's arrival to an address is not detected.
Orders fulfilled
: courier's arrival to an address is detected, the 'Confirm' status is set.
Orders fulfilled in time
: an order is fulfilled in time (in advance), the 'Confirm' status is set.
Orders fulfilled late
: an order is fulfilled late, the 'Confirm' status is set.
Orders visited without status
: courier's arrival to an address is detected, a status is not set.
Orders rejected
: an order for which the 'Reject' status is set.
Order's avg time (estimated)
: a ratio of time for orders visiting (system calculation) to a total amount of orders.
324
Order's avg time (actual)
: a ratio of time spent delivering orders to a total amount of orders.
Avg time deviation in orders
: a difference between actual and estimated order's average time.
Order's avg mileage (actual)
: a ratio of a distance covered by a courier to a total amount of orders.
Order's avg weight
: a ratio of orders' total weight to a total amount of orders.
Order's avg volume
: a ratio of orders' total volume to a total amount of orders.
Order's avg cost
: a ratio of orders' total cost to a total amount of orders.
Avg fuel consumption for an order
: a ratio of a total amount of fuel consumed to a total amount of orders.
Orders' estimated mileage
: total distance calculated by the system for orders delivery.
Orders' actual mileage
: total distance covered by a courier delivering orders.
Fuel consumed in orders
: total amount of fuel consumed delivering orders.
Orders' total weight
: overall weight of all orders created.
Orders' total volume
: overall volume of all orders created.
Orders' total cost
: overall cost of all orders created.
Moreover, the following data may be included in orders' statistics:
Percentage of orders visited in time
Percentage of orders visited late
Percentage of non-visited orders
Percentage of orders fulfilled in time
Percentage of orders fulfilled late
Percentage of orders visited without status
Percentage of orders rejected
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.
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 traveled in all trips.
Mileage (adjusted)
: the same distance multiplied by mileage coefficient (a setting in unit properties).
Urban mileage in trips
: distance traveled at speed which is considered as speed in populated areas.
Suburban mileage in trips
: distance traveled 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 moment of trip beginning. If no saving of mileage parameter was made through the reported period, mileage is counted from 0.
Final mileage
: mileage counter value at the moment of trip ending.
Toll roads mileage
: the distance of a trip travelled by the roads where 'Platon' system is used.
Toll roads cost
: a sum of money (in RUB) for the toll roads mileage calculated on the basis of covered distance and the 'Platon' tariff.
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.
325
Consumed in trips
: the volume of consumed fuel detected by any sort of fuel sensor. If several such sensors are available, their values sum up.
Consumed 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...
Rates deviation by ImpFCS/AbsFCS/InsFCS/FLS in trips
: the difference between fuel consumption detected by a sensors and fuel consumption rates.
Avg consumption in trips
: average fuel consumption by any sort of fuel sensor. If several such sensors are available, their values sum up.
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' .
Unit latest data
Note that all items in this section do not depend on report interval. The latest information is taken at the moment of report execution.
Mileage counter
: mileage counter value.
Engine hours counter
: engine hours counter value.
GPRS traffic counter
: consumed traffic.
Unit last location
: the latest unit location detected (address or coordinates).
Last message time
: the time when the latest messages from the unit was received.
How mileage and engine hours are calculated is adjusted in unit properties on the '
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.
Video
List of video files received from a unit.
Violations
Violations count
: the number of
violations registered within the reporting period.
Visited streets
Streets count
: the number of found visits of
326
Advanced Reports
Advanced reports are reports on unit groups and users (except the '
' table), all tables for drivers, trailers, and their groups, as well as report on logins for resource.
These report types are defined when creating a template.
327
Reports on Unit Groups
Data from several units can be gathered in one report if these units from a
. 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.
In Unit group reports the following features are available:
Any
;
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';
: U.S. measurements, address format, etc.
All tables available for units are available for unit groups as well. Besides, the table
is available for unit groups only. Moreover, the 'Eco driving' report on unit groups contains a unique column '
'.
In Unit group reports the following features are not available:
Charts;
Most of statistics excluding those mentioned above.
Note that if in '
in report template such parameter as 'Unit' should occupy the main position (drag to the top) in the grouping list.
Tables for Unit Groups
There are some peculiarities in configuring tables for unit groups. The first column of the table shows the list of all units included into a selected group (alphabetical order). This column is put in front of all the other ones indicated in a template. The 'Count' column (if included in a report template) shows the number of events registered for the reporting period of a given unit.
Below is an example of a table on parkings for a group of 5 units. 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.
Every line is dedicated to a single unit.
If the option of
detalization
is applied, the nesting level appears. That means you can expand the contents of a basic line ('+' at the beginning of a line, or corresponding number in the heading of the column) and see a detailed list of events for a given unit. The number of hidden lines corresponds to the number in the 'Count' column.
328
In addition to detalization, you can apply the
grouping
by years/months/weeks/days/shifts. In this case table data is
grouped by a chosen time interval. If several grouping intervals are chosen, then they will be arranged in several levels of nesting. In case with groupings a detalization is situated on the final level of nesting, and still shows a detailed list of events for a given unit.
To expand enclosed information, click on the plus-shaped button at the beginning of each line. It is also possible to expand the nested levels by clicking the corresponding numbers-buttons in the heading of the nesting column. To hide all the expanded lines, click on the button '1'.
If there is no data for the given unit, all the cells except for the name will contain only dashes. In some cases it is not convenient, then you can disable such uninformative lines. To do so, enable the option 'Skip empty rows' in the report template.
Unit Latest Data
This kind of table available only for unit groups. As for separate units, this information is available in
table presents last location and counters values known.
The following columns can be selected to form the table:
Unit
: unit name.
Last message
: time when the latest message form the unit was received.
Last coordinates
: time when the latest message with valid coordinates was received (not always 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,
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 '
'
in the report template.
329
Reports on Users
In the
report execution time, total time spent in the system, and logins count.
Log Table
A set of columns for this table matches the one used in the
on units.
Logins Table
This kind of table shows user activity: logins to different services. The table can contain the following columns:
Login time
: time when user logged in a service.
Logout time
: time when user exited the service.
Duration
: time interval user was online on the service.
Host
: the address of the computer from which user logged in.
Site
: the name of service where user logged in.
Count
: the number of logins.
Notes
: empty column for custom notes.
The same
row, and time limitations. In the example below you can see user logins table with grouping by days, detalization, numbering, and total row.
One report can display logins of more than one user. However, in this case, report type should be not User but
Resource
. All users belonging to an account, for which such report is executed, will get into the report. Example:
330
Custom Fields Table
The table 'Custom fields' represents the list of custom fields entered in the corresponding tab of
This report has the same characteristics as the
same kind of report for units and groups .
Charts Applied to Users
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 click the button 'Add Chart' and choose the type in the dropdown list.
'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:
331
Reports on Drivers
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. Moreover, a driver and a report template should belong to the same resource.
The following types of tables can be applied to
:
,
,
,
,
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.
The following columns can be included in this kind of report:
Beginning
: date and time when the driver was assigned.
Initial location
: the address (if available) at that moment.
End
: date and time when the driver was reset.
Final location
: the address (if available) at that moment.
Duration
: duration of a working shift.
Total time
: time from the first trip beginning to the last trip end.
Engine hours
: total amount of engine hours for a working interval of a bound driver.
Engine hours in movement
: an amount of engine hours for an interval of unit's movement.
Engine hours in idle run
: an amount of engine hours for an interval of unit's idling.
Mileage
: the distance traveled within the period.
Mileage (adjusted)
: mileage subject to the coefficient set in unit properties ('Advanced' tab).
Urban mileage
: the distance traveled in urban area.
Suburban mileage
: the distance traveled in suburban area. It is calculated in regard to speed. The urban/suburban speed line is indicated in
('Urban speed limit' setting).
Avg speed
: average speed within the interval.
Max speed
: maximum speed registered within this working shift.
Counter
: counter sensor value.
Status
: unit status registered during the interval (if there are several, the first one is displayed).
Violations
: the number of violations occurred.
Count
: the number of bindings found.
Consumed
: the volume of consumed fuel detected by any sort of fuel sensor. If several such sensors are available, their values sum up.
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
: average fuel consumption by any sort of fuel sensor. If several such sensors are available, their values sum up.
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.
332
Final fuel level
: fuel level at the end of the working shift.
Penalties
: penalties calculated for adjusted '
Rank
: received penalty points converted into a grade using 6 point scoring system.
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
Possible columns:
Name
: custom field name.
Value
: custom field value.
Notes
: an empty column for your custom comments.
Driver Activity
Driver activity table shows such information as type of driver's action, crew size of a vehicle, tachograph card state. It may include the following columns:
Beginning
: date and time of message coming.
Card
: digital tachograph card state (inserted/not inserted).
Activity
: type of driver's activity (rest, work, driving, available, not available).
Driving
: driving time interval.
Work
: active working hours (time spent by a driver for vehicle repairing, fuel filling, etc.).
Availability
: passive working hours (time spent by a second driver in the moving vehicle).
Rest
: driver's rest time interval (vehicle is stopped, driver takes rest in a special place or equipped cabin).
Overall work
: time spent by a driver working, driving, or being available.
Slot
: slot for digital tachograph card (Driver or Co-driver).
Status
: vehicle crew size (single/crew).
Daily mileage
: distance covered by an attached driver during the day (24 hours).
333
Note that creating this report template, it is necessary to choose driver activity source (DDD files or online data) in the
Eco Driving
This reports is the same as
Infringements
This report shows information on the violation of labor routine by the driver. It may include the following columns:
Time
: date and time of violation recording.
Infringement
: type of driver's activity the conditions of which have been violated.
Description
: short description of the infringement.
Seriousness
: the extent of the infringement.
Note that creating this report template, it is necessary to choose driver activity source (DDD files or online data) in the
Orders
This reports is the same as
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 .
The following columns can be included in the table:
Time
: date and time when message came.
Type
: message type: sent (a message that was sent by a dispatcher) or received (a message that was received from a driver).
Text
: text of the message.
Phone
: driver's phone number.
Modem phone
: phone number of the modem that sent/received SMS.
334
Additional Possibilities
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.
Tracks of driver's movements can be built on the map.
Most tables can be generated for a
Note.
The Total row cannot be used in reports on driver and trailer groups.
335
Reports on Trailers
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. Moreover, a driver and a report template should belong to the same resource.
Two tables are possible for
Bindings
This table shows working intervals if the chosen trailer if it was bound to units. It comes along with information on fuel
for drivers (with the exception that the column 'Violations' is absent). The Bindings table can be also generated for
single bindings).
Custom Fields
This table represents the list of custom fields created in
trailer properties . It is not available for trailer groups.
336
Reports on Passengers
To generate reports on passengers, it is necessary to possess the 'Query reports or messages' flag towards a resource to which these passengers belong. Moreover, a passenger and a report template should belong to the same resource.
The 'Bindings' report can be generated on passengers .
The 'Bindings' table may include time and location of passengers' boarding/leaving a vehicle, name of a unit used by passengers, duration of a trip, etc.
Beginning
: time a passenger was bound to a unit.
Initial location
: passenger's location upon binding to a unit.
End
: time a passenger was unbound from a unit.
Final location
: passenger's location upon unbinding from a unit.
Unit
: name of a unit to which a passenger was bound.
Driver
: name of a driver of a unit to which a passenger was bound.
Duration
: passengers time in trip (time between binding and subsequent unbinding).
337
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.
If grouping is used, then a table receives additional column 'Grouping' displaying time in the following way:
Grouping by years shows corresponding years (for example, 2015);
Grouping by months shows months' names (for example, August);
Grouping by weeks shows a number of a week in a year (for example, week 10; note that the first week is considered to be the first full week in a year.)
Grouping by day of the week shows the corresponding day (for example, Friday);
Grouping by day of the month shows the corresponding day (from day 1 to day 31);
Grouping by dates shows the corresponding date in the format chosen in the advanced settings of a report template;
Grouping by shifts shows the corresponding shifts (for example, shift 1).
Attention!
To receive reliable data for time/duration, it is important to correctly indicate the time zone and DST options in
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 '
' 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 traveled at speed which is considered as speed in populated areas.
Suburban mileage: distance traveled at speed which is considered as speed outside populated areas.
'
Initial mileage: mileage counter value at the beginning of the interval (trip, street visit, sensor operation, etc.).
Final mileage: mileage counter value at the end of the interval.
338
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
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 traveled 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.
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.
Speed is given only in integer numbers.
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:
FLS: fuel level sensor;
ImpFCS: impulse fuel consumption sensor;
AbsFCS: absolute fuel consumption sensor;
InsFCS: instant fuel consumption sensor.
To receive the most accurate information about fuel, you need to: install fuel
properly configure the sensors in
on the
Fuel Consumption select calculation methods corresponding to these sensors.
However, even if you do not have special fuel sensors, you can control fuel in the following ways:
register fillings manually in the Monitoring panel;
use
mathematical method to calculate fuel consumed (it takes into account urban and suburban cycle, idle
running, and moving under load); use
to calculate fuel consumed (it takes into account consumption rates in winter and summer periods); use mathematical method and consumption rates to calculate average fuel consumption within a given interval of movement.
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 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
339
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:
Rates deviation = (Consumed by FLS1 — Consumed by rates) + (Consumed by FLS2 — Consumed by rates)
If there are two fuel sensors with the same names and the merging is enabled, the formula is:
Rates deviation = (Consumed by FLS1 + Consumed by FLS2) — Consumed by rates
.
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
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
Consumption tab (the option 'Filter fuel level sensors values').
340
Fuel
All the sensor workflow can be divided into sequential steps (there are important options, terms in step subsections):
1.
Option:
Ignore the messages after the start of motion
;
Options:
2.
Term difference: 'Mileage-based calculation' VS 'Time-based calculation' .
Option:
Filter fuel level sensors values ;
Option:
3.
Option:
Option:
Detect fuel filling only while stopped
;
Option:
Ignore filtration when calculating filling volume ;
Special Case: How a filling is processed?
4.
Option:
;
Option:
Option:
Option:
Ignore filtration when calculating theft volume
.
5.
Option:
Replace invalid values with math consumption
;
Option:
Exclude thefts from fuel consumption ;
Special Case: Filling/theft is sliced with one of interval frontiers
.
341
Data preparation
Note: Ellipsis (…) substitutes 'Unit properties
→ Fuel consumption' is option paths.
Among important options the next list should be mentioned:
Option: Ignore the messages after the start of motion;
Option: Merge same name sensors;
Special Case: Mileage-based calculation VS Time-based calculation.
Ignore the messages after the start of motion
...
→ '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).
This is the graph with no ignoring:
This graph is being ignore option 10 set:
342
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:
Option Sensor type
'Merge same name sensors
(fuel level)'
- fuel level sensor;
— impulse fuel level sensor
'Merge same name sensors
(fuel consumption)'
— impulse fuel consumption sensor;
— absolute fuel consumption sensor;
— instant fuel consumption sensor
Note.
You can group several sensor types (up to all types you got in the list).
Mileage-based calculation VS Time-based calculation
...
→ 'Fuel fillings/thefts detection' block → 'Time-based calculation of fillings'
...
→ 'Fuel fillings/thefts detection' block → 'Time-based calculation of thefts'
...
→ 'Fuel level sensors' block → 'Time-based calculation of fuel consumption'
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: fuel consumption/idling looks like slowly descending curve on graph; thefts/fillings — quick falling of fuel level on a small period of time (theft/filling processing time).
While 'Time-based calculation' switched off (data is calculated as mileage-based) the x-axis is mileage: fuel consumption in motion looks like slowly descending curve; idling – because mileage is not incremented, should be seen as vertical falling of fuel level; thefts/fillings on stops — because mileage is not incremented, should be seen as vertical rising of fuel level.
343
Filtration
Note: Ellipsis (…) substitutes 'Unit properties
→ Fuel consumption' is option paths.
Two options are connected with filtering:
Option: 'Filter fuel level sensors values';
Option: 'Filtration level (0..255)'.
Filtration enabling and filtration level setting
...
→ 'Fuel level sensors' block → 'Filter fuel level sensors values';
...
→ 'Fuel level sensors' block → 'Filtration level (0..255)'.
To use filtration be sure to:
1.
check 'Fuel level sensors' area ('Unit properties → Fuel consumption');
2.
check 'Filter fuel level sensors values';
3.
set non-zero value for '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.
There is the chart filtration disabled:
This chart is for enabled filtration 10:
344
345
Fillings Detection
Attention!
In order to detect fillings the processed data is used (it is done on
Note: Ellipsis (…) substitutes 'Unit properties
→ Fuel consumption' is option paths.
Three options are attached to this detection:
Option: Minimum fuel filling volume, liters;
Option: Detect fuel filling only while stopped;
Option: Ignore filtration when calculating filling volume;
Special Case: How a filling is processed?
Minimum fuel filling volume
...
→ '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.
Detect fuel filling only while stopped
...
→ '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.
Ignore filtration when calculating filling volume
...
→ '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.
Special Case: How a filling is processed?
Filling time frontiers and its volume
The filling is processing.
Assume, that fuel volume in this message is Vcurr, previous message fuel volume — Vprev. If the difference d
(=Vcurr - Vprev) for the current message is positive, then current message will be marked as initial filling message.
Time passes by. The filling is close to finish. When d-value for some message becomes negative (i.e., the current message fuel volume is less than in previous one), then it is called final filling message.
Filling volume equals to Vfinal - Vinit (difference in fuel volumes between final and initial filling messages).
Filling timestamp calculation algorithm
Now it's time to find the filling timestamp.
346
Iteratively for every message within filling interval (exclude the last one) the system seeks delta(=Vnext - Vcurr) for the next message which shows the fuel level growth between the current message and the next one.
Message timestamp which delta is the ultimately biggest among others is regarded as filling timestamp (in other words, the left message is chosen from the message pair which delta is the biggest one).
Worth highlighting, that a filling timestamp is calculated dynamically depend on the current unique case.
347
Thefts detection
Attention!
In order to detect thefts the processed data is used (it is done on 'Data preparation'
and
steps).
Note: Ellipsis (…) substitutes 'Unit properties
→ Fuel consumption' is option paths.
The next options are crucial while detecting thefts:
Minimum fuel theft volume, liters;
Idling;
Detect fuel theft in motion;
Ignore filtration when calculating theft volume.
Minimum fuel theft volume
...
→ '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
...
→ 'Consumption math' block → 'Idling, liters per hour'
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.
Detect fuel theft in motion
...
→ 'Fuel fillings/thefts detection' block → 'Detect fuel theft in motion'
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.
Ignore filtration when calculating theft volume
...
→ '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.
348
Consumption calculation
Attention!
In order to calculate consumption the processed data is used (it is done on 'Data preparation'
and
steps).
Note: Ellipsis (…) substitutes 'Unit properties
→ Fuel consumption' is option paths.
Two options and special case are toughly connected with this step:
Replace invalid values with math consumption;
Reports → Report Template Properties → Options → Exclude thefts from fuel consumption;
Special Case: filling/theft is sliced with one of interval frontiers.
Replace invalid values with math consumption
...
→ '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).
Exclude thefts from fuel consumption
Reports
→ Report Template Properties → Options → 'Exclude thefts from fuel consumption'
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
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.
349
Geofences
Geofence, or geographical zone, is an area on the map that is important for user’s tracking purposes and requires special attention. Geofences can be used to control units’ activity in these areas or, on the contrary, outside them. You can choose an image for a geofence or add a discription.
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.
Geofences are
in Wialon. Along with the map’s visual enrichment, they can be used in reports, notifications, and units’ tooltips. Geofences can also be used as check points for route configuration. Geofence's tooltip may contain dynamically updated images and videos from external sources.
To open the Geofences panel, click the corresponding name in the
top panel or choose the necessary item in the
main menu customizer . Afterwards, choose a mode which allows you to work either with geofences or
Note that geofence creation is available in the 'Geofences' mode only, while the other options can be used in the
'Groups' mode as well.
350
Creating a Geofence
Here are three steps to create a geofence.
1. Map Geofence
Start working with geofences by choosing the corresponding mode.
Press the 'New' button, and help window will provide you with the instructions on geofences' creation. 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 the
(create circles).
2. Set Geofence Properties
Name
Geofence's name is used while tracking units as well as in reports and notifications. It is a required parameter. It can consist of one or more symbols. Besides, you can specify caption color and size. It has sense if in
option 'Display names of geofences on map' is enabled.
Description
This field is optional. Description is displayed in geofence's tooltip. It can be also added to geofence's name if the geofence is used as address source in reports. When you create a geofence, the description is filled in automatically with the address information taken from the first point you map. However, you can edit it or simply delete. Its length is
351
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.
Type
Geofence can be of the shape of the line, polygon, or circle. For line, you also can indicate its thickness, for circle — radius (in meters or feet, depending on resource settings).
Resource
This option is shown if the current user has access to more than one resource. The resource chosen while creating a geofence defines the measurement system used to calculate its area, length, radius, thickness, etc. (metric, U.S. or imperial system).
Image
You can attach any image to a geofence. An image can be chosen from the standard icons ('Icon Library' button) or loaded from your computer by pressing the corresponding area and choosing the file you need. Supported formats are
PNG, JPG, GIF, and SVG. Moreover, you can use the Icon Library application (for top accounts only) which enables uploading individual icons for geofences. The icons uploaded to the system using this application will be available for you in the standard Icon Library. To facilitate the work with the library, the uploaded icons are placed in the same list, but separately from the standard ones (at the top). All loaded images are automatically resized by 64×64 pixels to display the geofences on the map and on the list. However, in the tooltip for a geofence you can see an enlarged image (up to 256х256 px). In the geofence’s editing dialog you can delete the image used. To do so, point a cursor on it, and click the appeared delete button. Click OK to save changes, or Cancel to dismiss them.
Area & Perimeter
These fields are not editable, they are calculated automatically.
Note.
Area and perimeter values also depend on resource settings, and can be given in hectares and kilometers or square miles, square feet and miles (feet), respectively.
Color
This color will be used to render a geofence on the map and to display it in a unit's tooltip and in extended unit information as well as some other places where next to the geofence's name where a unit is located, is shown a square of the same color. The color is chosen using the palette or manually (by entering its RGB code). You can also choose if geofence's shape should be shown on the map. For this purpose the corresponding flag to the left of the color palette is used.
Visibility
Here you specify map zooms at which geofences will be displayed or not. For example, if a geofence is a city, it has sense to see it on remote scales, whereas if it is a building it is more logical to see it on more detailed scales. Different
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).
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.
Note.
Geofences can be saved to a file and easily
transferred from one resource to another.
352
Geofences Management
In the work area there is a list of all available geofences. To move to the necessary geofence on the map, click on its name in the list.
Put check marks in the left column of the table to choose the geofences you want to be displayed on the map. Deselect these boxes to remove geofences from the map. A check mark at the header of the list selects/deselects all the
geofences if their visibility corresponds to the current map scale and the appropriate layer
is enabled.
setting of rendering geofences on server may help.
A geofence can be presented on the map by its name (if the flag 'Display names of geofences on map' is enabled in
combination of these three elements. The geofences that overlap each other can be replaced by one
Placing a cursor over a geofence name (in the list or on the map), you will get the following information about it in the popup tooltip: name, type, description (if specified), enlarged image, the name of the resource (if you have access to several), as well as the list of units located inside the geofence at the moment. Depending on geofence type, there will be also area, perimeter, length, and/or radius. The measuring units for these parameters depend on the measurement system chosen for a resource to which the geofence belongs. If a description contains links to other images, they will be shown as well. For instance, a tooltip of a geofence can look like this:
353
The following code has been used to add weather forecast to the tooltip:
<iframe src="https://www.meteoblue.com/en/weather/widget/daily/city-of-london_unitedkingdom_2643741?
geoloc=fixed&days=4&tempunit=CELSIUS&windunit=KILOMETER_PER_HOUR&coloured=coloured&pictoi frameborder="0" scrolling="NO" allowtransparency="true" sandbox="allow-same-origin allow-scripts allow-popups" style="width: 216px;height: 245px"></iframe><div><!-- DO
NOT REMOVE THIS LINK --><a href="https://www.meteoblue.com/en/weather/forecast/week/city-of-london_unitedkingdom_2643741?
utm_source=weather_widget&utm_medium=linkus&utm_content=daily&utm_campaign=Weather%2BWidg target="_blank">meteoblue</a></div>
To find or to sort geofences there is a filter and a fast search provided. The filter is a dropdown list with several predefined criteria:
By property
:
By resource
:
Polygons;
Lines;
Circles.
Here you can find a list of the resources available for the current user (if they are more than one). Click on any of them to display geofences belonging only to this particular resource.
To find a needed geofence quickly, you can use the
dynamic filter above the list. Type the name of the geofence or
some part of the name and observe the search results.
The following icons and buttons are used in the panel 'Geofences':
Shows how many units are there inside the geofence at the moment. These units are listed in the tooltip (the data refreshes once in two minutes). If there are question signs (?) in this column, it means the option 'Presence in geofences' is disabled. If needed, activate it in
etc.
354
The button to copy a geofence. You can edit a geofence and save it under another name.
The button to delete a geofence(s). 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 don't have enough
access rights to the resource which the geofence belongs to.
355
Groups of Geofences
Created geofences can be formed into groups. Groups are used to unite geofences on the basis of any criteria, and serve as
group itself.
To work with groups, choose the corresponding mode in the 'Geofences' panel.
To create a new group of geofences, click the 'New' button. Enter a name and description, and choose geofences to be included in a group. Click OK.
A list of created groups of geofences is displayed in the work area. Groups are arranged alphabetically. The same as
Note that upon deleting a group you can not delete its contents.
Geofences not included in any group can be found in the 'Geofences outside groups'.
Series of standard actions are available for geofences in a group (unfold a group in order the corresponding buttons to appear).
356
Usage
While Tracking Online
Geofences can be displayed on the map (the ones that have flags in the panel 'Geofences' are shown). That simplifies the visual perception of the map and enriches it. Different regions can be selected by different colors and you can estimate the units' presence in definite areas. If a geofence is displayed on the map, you can press <ctrl> and put the mouse cursor over it to see its tooltip (name, type, list of units inside, etc.). In case of the geofences that have images assigned, the tooltips appear as you just point them with the cursor.
In a unit's tooltip and in its additional information you can see its presence in geofences if the option 'Presence in geofences' is enabled in
Besides, it's possible to get images from external sources
in geofences' tooltips (webcam videos, photos, rates of exchange, etc.).
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 or enters a geofence. It is also possible to set speed limitations and sensor range for a unit during its presence in a geofence. Besides, entering a geofence or leaving it can be automatically accompanied by an action: send a message to the driver, block the engine, change users' access to this unit, and many others. See
In Reports
enabled in the 'Advanced settings' block of the reports' template.
Many tables are generated on the basis of geofences. Among them there are the following:
with visit duration, distance travelled within the geofence, average and maximum speed, etc.).
357
days.
: rides from one geofence to another (convenient to control how a cargo is transported in several trips).
Geofences can be also used to filter intervals
in reports.
When a report is generated, geofences can be
In Routes
Geofences can be used as check points while configuring
.
358
Routes
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.
Round
is a route, its schedule and assigned unit put together.
So, to configure a route, perform the following steps:
1.
Create a route itself, i.e., mark check point on map.
2.
Create one or more schedules for this route.
3.
Assign rounds manually or adjust automatic creation of rounds.
Note that in order routes to be displayed on the map you should check if the corresponding
menu is active.
When everything is configured properly, you can analyze unit performance on route by various means:
1.
In a specially designed online timeline.
2.
In reports.
3.
Get notifications about round progress.
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.
Routes take their measurement system from
359
Creating a Route
To create a new route, press the 'New Route' button.
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 geofences, and from moving units.
Adding Check Points
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 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 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.
360
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 arrowshaped 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 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 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. The default cartographical sources is Gurtam Maps. Though, Google Maps, Yandex Maps, Visicom, and HERE Maps can also be chosen from the dropdown list.
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.
To build a route, you can also use specially designed app — Delivery Service
.
361
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
Automatically create rounds for this schedule
Rounds can be created automatically without any assistance of a dispatcher. When the time draws near the first point visit, the round is activated and the system starts to track it. This option works only with
'Relative to day'
schedule type. Besides, one or more units should be selected on the 'Units' tab of the same dialog.
Expiration time (DD:HH:MM)
This is time after which the round (if not finished) will be finished forcibly and obtain the 'Aborted' status.
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.
Remove finished rounds from the timeline
It is advisable to leave this option checked. Otherwise, finished rounds will remain on the timeline and soon will become too numerous and difficult to navigate through them.
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
362
a day).
Absolute
Scheduled time of point visit includes also a date. Such schedule can be used only once.
Check points order
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 of a route and their visiting time. For visiting time you can indicate only arrival or both arrival and departure. Besides, you can set deviation time to give a unit some degree of freedom to visit the point (for example, +/- 5 minutes).
Arrival time
to a check point. Time format is hh:mm.
Arrival variation
(hh:mm) corresponds to a time interval on which an arrival time is allowed to vary. For example, deviation time is 5 minutes, arrival time is 16:30, then a unit has to come to a check point between 16:25 and 16:35.
Departure time
from a check point.
Departure variation
corresponds to a time interval on which a departure time is allowed to vary.
The same variation time of arrival/departure can be set for all check points simultaneously. To do so, indicate common variation time in the corresponding field and click 'Apply'.
If a schedule contains an arrival time only, then a check point is considered to be visited upon arriving to it. If both arrival and departure time is indicated, then a check point becomes visited when both arrival and departure are detected.
Variation from arrival to the 1st check point is highly important, because a round is created (appears on the timeline) in advance. If the 1st check point arrival variation equals zero or has a small value, then it can be a situation when a visit is not detected. For example, a check point is visited before creation of a corresponding round. Therefore, it is recommended to set a larger arrival variation value for the 1st check point.
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. If rounds are created automatically, then units have to be indicated. If rounds are created manually, then a unit can be assigned upon a round creation. If several units are chosen, then the first that begins the round will be assigned to it. Required access right is 'Use unit in retranslators, jobs, and notifications'.
Switch to the tab 'Units'. Here you can see two lists. The units to be assigned are situated in the left one, the right one contains already chosen units. The left list contains not all the units available to you, but those situated in the
363
monitoring panel
. In case the work list is empty (when dynamic work list
is used or when units have been deleted from the work list manually), the units to which you possess enough rights will be displayed.
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:
%ROUTE% — route name;
%SCHEDULE% — schedule name;
%FIRSTPOINT% — first check point name;
%LASTPOINT% — last check point name;
%DATE% — date of round creation;
%TIME% — time of round creation.
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.
364
Rounds
Round is a route, its schedule and assigned unit put together. Unit performs a route (that is to say visits route's check points) according predefined schedule.
Rounds can be created manually or automatically.
Manual Round Creation
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. Underneath you can see two lists. The units to be assigned are situated in the left one, the right one contains already chosen units. The left list contains not all the units
available to you, but those situated in the monitoring panel work list
. In case the work list is empty (when
is used or when units have been deleted from the work list manually), the units to which you possess enough rights will be displayed. Afterwards 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).
At the end, press Create a round.
Automatic Round Creation
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
. 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 .
365
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.
366
Route Control
There are several methods of tracking units on routes and you can choose what suits you better.
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:
do not show point names at all;
show names for 'hot' check points i.e., points where units are located at the moment or points awaiting arrival at;
show captions for all check points.
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 'Lock 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'
.
Until a point is visited, it is displayed on the timeline as an empty rectangle; when visited, this rectangle obtains a filling of the colour assigned to the route. In addition, you can enable contours highlighting schedule violations:
yellow — late visit (delay);
pink — early visit (outrunning).
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.
Notifications about Routes
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 email or SMS, shown online in a popup window, stored in unit history as events or violations, etc. See
for
367
details.
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:
368
Routes Management
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:
Routes
: the simplest list of routes without any sublevels.
Schedules
: routes and their schedules.
Check points
: routes and their check points.
Active units
: routes and units which are currently performing them.
The following icons are used in the panel:
— edit route i.e., change its name, description, color, and check points radius;
— add a new schedule for this route;
for this route (finished, in progress, pending);
— create a
for this manually;
— copy a route (i.e., create a new route on the basis of chosen one) or a schedule;
— delete a route or a schedule;
— automatic creation of rounds for this schedule is enabled (click to disable);
— automatic creation of rounds for this schedule is disabled (click to enable);
— automatic creation of rounds for this schedule is impossible because the schedule type is not 'Relative to day'.
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. Note that check points' names are displayed on the map by default. Uncheck the corresponding box in
user settings dialog in order the names not to be displayed.
369
Drivers
Wialon system provides a possibility to create and manage the list of drivers working for you. 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 particularly useful when several drivers work with the same unit. There is also a possibility to detect drivers automatically with the help of iButton system. Moreover, created drivers can be formed into groups.
To start working with drivers, choose the 'Drivers' item in the
top panel , or click the necessary item in the
main menu customizer . Afterwards, choose the mode you would like to work with (drivers or groups).
370
Creating a Driver
In the corresponding monitoring panel choose the appropriate mode ('Drivers'), click the 'New' button, and indicate 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.
Mobile key
Password for mobile authorization.
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, GIF, and SVG. In the driver's editing dialog you can delete an image used. To do so, point a cursor on it, and click the appeared delete button. Click OK to save changes, or Cancel to dismiss them.
Custom fields
Create driver's card adding any information as custom fields (information may include external links). They are shown in driver's tooltip and can be summoned in reports. Note that custom fields with the same name cannot coexist within one particular driver.
At the end click OK. The new driver appears in the list.
371
Hint.
Like any other resource contents, drivers can be
imported and exported through files or directly from one resource to
another. However, that is not true for driver groups.
372
Managing Driver List
Drivers are listed in the alphabetic 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
is active.
DDD files received from tachograph contain driver's activity information. Such files can be uploaded automatically (due to the corresponding settings of an equipment), or manually (using ' TachoManager ' application). Received information on driver's activity helps to control whether a driver follows the AETR standards or not. Driver's activity is displayed in the tooltip of each driver, and contains the following data: current state (driving, work, availability, rest), and its duration; uninterrupted driving info (time left for driving/exceeded driving time/missed rest beginning, and also the necessary rest duration); driving info for the current shift (time left for driving/exceeded driving time/missed rest beginning, and also the necessary rest duration); week's driving info (time left for driving/exceeded driving time/missed rest beginning, and also the necessary rest duration); two-weeks driving info (time left for driving/exceeded driving time/missed rest beginning, and also the necessary rest duration).
Moreover, the tooltip shows driver's name, phone number, enlarged photo, resource (if there are several), description, and custom fields (if any were set). Moreover a unit name can be shown in a tooltip is a driver is bound to it. You can call a phone number shown in the tooltip by Skype if you have ' Click to Call ' plugin downloaded and enabled on your computer. To do so, click a necessary phone number in the tooltip.
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).
373
Several actions can be performed over drivers:
—
register working shift or delete bindings
;
— send
dimmed, it means there is no phone number in driver's properties);
or — edit or view driver's properties;
— create a new driver using this one as a basis;
— delete driver (the button is dimmed if you have not enough rights).
374
Driver's Assignment
Several drivers can be assigned to one unit. To assign drivers to units, you need to have access flag 'Create, edit, and delete drivers' on the resource where those drivers belong.
There are two ways to bind a driver to a unit: manual and automatic.
Manual Binding
The manual assignment can be performed in both modes ('Drivers', 'Groups') of the 'Drivers' panel. Use the corresponding switch button 'Bind / Unbind' to attach or detach drivers to/from units. The button is disabled if your access is not sufficient.
Click 'Bind to unit' button ( ), choose a unit the driver to be bound to, and click OK.
Availability of units in this list depends on the
work list in the Monitoring panel. If there are no units in the list, click
'Add all available' button . If the list is still empty, then you have no access rights to these units.
To unbind a driver from a unit, click an icon of a unit opposite to driver's name, and then use the corresponding button
( ). Besides, you can unbind a driver by
registering a working shift , or
deleting bindings from history.
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.
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.
Note.
A driver can be unbound from a unit by sending the
corresponding notification (for example, upon switching off an
engine).
375
2.
Create a list of units for any resource the drivers of which are intended to be bound automatically. In order to do so, click 'Auto-binding' icon ( ), and follow the steps listed below.
Upon clicking the 'Automatic binding' icon a list of available resources is opened. Here you choose a resource the drivers of which will be used in automatic binding (with the units chosen in the next dialog). In order to understand which drivers belong to a particular resource, go back to the 'Drivers' panel, and apply a filter by resource (dropdown menu to the right of 'Create' button).
After choosing a resource, click 'Next'. If only one resource is available, then it will be chosen automatically.
The next dialog contains a list of units to which the drivers from a chosen resource can be bound automatically.
Depending on the access rights possessed, the list can be viewed or edited.
376
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.
Automatic binding of drivers is removed in the same way: summon 'Automatic binding' dialog, choose a resource, and uncheck flags of units for which the automatic binding will not be used.
Register Working Shift
This option can be used, for example, if you would like to register working shift post factum. Use the corresponding button ( ) opposite to a trailer's name, choose the 'Register working shift' option, and click 'Next'. In the appeared dialog window choose a unit to which the trailer will be assigned in the indicated shift, click 'Next'. Now indicate time of shift beginning and end. Moreover, you can indicate either only beginning or only end time. For example, you have indicated shift beginning, and you would like its end to be registered automatically when a unit arrives to garage (as a geofence). To do so, create a
notification of 'Geofence' type with method of action 'Reset trailer'. Anyway, registering a
working shift you can use only past dates or current time (no future allowed).
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.
377
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:
For correct operation, all drivers must belong to one resource.
It works only in real time, i.e., there are no such rules when registering drivers' working shifts.
It does not work in reverse way, i.e., if a driver with 'Exclusive' flag is assigned to a unit at the moment and another driver without that flag is being assigned, both of those drivers will be bound.
378
Groups of Drivers
Created drivers can be formed into groups. Groups can unite drivers by any criteria. Driver groups are used in group reports. Only drivers who belong to the same resource as the group itself can compose the group.
To start working with groups, choose the corresponding mode in the 'Drivers' panel.
To create a new group of drivers, press the 'New' button. Enter name and description, and choose drivers to fill the group. Press OK.
A list of created driver groups is displayed in the work area. Groups are arranged alphabetically. The same as for drivers, a filter or a
dynamic search can be used for groups. Moreover, groups can be edited, copied, or deleted. Note
that upon deleting a group you can not delete its contents.
Drivers not included in any group can be found in the 'Drivers outside groups'.
appear).
379
Usage of Drivers
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).
Drivers can be located on the map, which was described
In Notifications
Drivers appear in
. 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
module, you can generate a report totally dedicated to working shifts of a certain driver or even a group of drivers.
380
Trailers
Trailers refer to any kind of mechanisms attached to or driven by 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
381
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. This information is shown in trailer's tooltip, and used in reports. You can upload an image for the trailer which will be used to show the trailer in the list and on the map. It is recommended to upload square images in order their proportions not to be altered. Properties of trailers are the same as those of
Hint.
Like any other resource contents, trailers can be
imported and exported through files or directly from one resource to
another. However, it is not applicable to trailer groups.
382
Managing Trailer List
Trailers are listed in the alphabetical order. To quickly find a certain trailer, use the filter (choose filtration by property or by resource from dropdown list to the right of the 'New' button). Besides, the usage of a
as well.
To display a trailer on the map, tick the checkbox on its left. As trailers do not have their own coordinates, they borrow their location from units to which they are bound. Click on trailer's name in the list to center the map on its position. A bound trailer is represented by a small icon at the bottom right corner of unit's icon. If a trailer is not attached to any unit at the moment, its last known position is shown (with a bigger icon). If there is no data about trailer's location (for example, if it has never been bound to any unit), such a trailer is not shown on the map.
menu is active.
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).
Several actions can be performed over trailers:
or —
— register working interval, or
;
or — edit or view trailer's properties;
— create a new trailer using this one as a basis;
— delete trailer (the button is dimmed if you have not enough rights).
383
Binding and Unbinding Trailers
Like with drivers, trailers can be bound to units either manually or automatically. To assign trailers to units, you need to have access flag 'Create, edit, and delete trailers' on the resource where those trailers belong. The conception of
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. If you do not have enough access rights, then the button is disabled .
Click 'Bind to unit' button ( ), choose a unit the trailer to be bound to, and click OK.
Availability of units in this list depends on the
work list in the Monitoring panel. If there are no units in the list, click
'Add all available' button . If the list is still empty, then you have no access rights to these units.
To unbind a trailer from a unit, click an icon of a unit opposite to trailer's name, and then use the corresponding button
( ). Besides, you can unbind a trailer by
registering a new working shift , or by
deleting bindings from history.
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.
384
2.
Create a list of units for any resource the trailers of which are intended to be bound automatically. In order to do so, click 'Auto-binding' icon ( ), and follow the steps listed below.
Upon clicking the 'Automatic binding' icon a list of available resources is opened. Here you choose a resource the trailers of which will be used in automatic binding (with the units chosen in the next dialog). In order to understand which trailers belong to a particular resource, go back to the 'Trailers' panel, and apply a filter by resource (dropdown menu to the right of 'Create' button).
After choosing a resource, click 'Next'. If only one resource is available, then it will be chosen automatically.
The next dialog contains a list of units to which the trailers from a chosen resource can be bound automatically.
Depending on the access rights possessed, the list can be viewed or edited.
385
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.
Automatic binding of trailers is removed in the same way: summon 'Automatic binding' dialog, choose a resource, and uncheck flags of units for which the automatic binding will not be used.
Register Working Shift
This option can be used, for example, if you would like to register working shift post factum. Use the corresponding button ( ) opposite to a driver's name, choose the 'Register working shift' option, and click 'Next'. In the appeared dialog window choose a unit to which the driver will be assigned in the indicated shift, click 'Next'. Now indicate time of shift beginning and end. Moreover, you can indicate either only beginning or only end time. For example, you have indicated shift beginning, and you would like its end to be registered automatically when a unit arrives to garage (as a geofence). To do so, create a
notification of 'Geofence' type with method of action 'Reset driver'. Anyway, registering a
working shift you can use only past dates or current time (no future allowed).
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. In the interval registering 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.
386
Note.
Like with units, the last message from the trailer (whether it is a binding or unbinding) cannot be deleted.
387
Groups of Trailers
Created trailers can be formed into groups. Trailer groups can unite drivers by any criteria, and they can be used to query reports for groups. Only a trailer belonging to the same resource as the group itself can be added to the group.
To start working with groups, choose the corresponding mode in the 'Trailers' panel.
To create a new group of trailers, press the New button. Enter name and description, and choose trailers to compose the group.
A list of created trailer groups is displayed in the work area. Groups are arranged alphabetically. The same as for trailers, a filter or a
dynamic search can be used for groups. Moreover, groups can be edited, copied, or deleted. Note
that upon deleting a group you can not delete its contents.
Trailers not included in any group can be found in the 'Trailers outside groups'.
appear).
388
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 additional information if this option is selected in the 'User Settings'
dialog.
Trailers can be displayed in the '
' panel as a column if this option is selected in the 'User
Settings' dialog.
In notifications
:
You can configure a
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
was bound to the unit on certain interval.
As a part of '
Advanced Reports ' module, you can generate tables for individual trailers and trailer groups.
Two tables are currently available — 'Bindings' and 'Custom fields'.
389
Passengers
Wialon system provides the means to control passengers doing regular trips by special transport (for example, school buses or corporate vehicles). RFID tags are commonly used for this purpose. Upon getting into and out a vehicle, passengers bring their tags against a reader. Received data is sent to Wialon Hosting where it can be further used for the monitoring purposes.
Algorithm of controlling a passenger
RFID tag sends identical information upon bringing it against a reader. Therefore, the algorithm should be used in order to establish a strict line between getting into and out a vehicle:
The first operation of a RFID tag in 24 hours means a passenger gets into a vehicle. The second operation of the same tag in the same vehicle means a passenger gets out. If the second operation of the tag occurs in the same vehicle within 1 minute after getting into/out, then it is considered to be a false one. Such an operation is ignored by the system.
If a passenger gets into a vehicle using RFID tag, and afterwards the same tag operates in the other vehicle, then the system recognizes it as getting out of the first vehicle and getting into the second one.
If no RFID tag operation detected within 10 hours after a passenger gets into a vehicle using a RFID tag, then such a passenger is recognized by the system as the one left a vehicle.
To implement control over a passenger, it is necessary to
create passengers in the interface of the monitoring system
and form
. Data received from a RFID tag provides a possibility to implement online monitoring, generate
, and send
390
Creating a Passenger
To create passengers, it is necessary to possess the right 'Create, edit, and delete passengers' towards a resource.
To summon a passenger creation dialog, go to the 'Passengers' panel and click 'New'. Here enter a name, identification code (for automatic binding), and, if necessary, fill in custom fields. This kind of information is shown in passenger's tooltip and partially in reports. You can upload passenger's image in different formats: PNG, JPG, GIF, and SVG. An image is used to identify a passenger either in the list or on the map. It is recommended to upload square images in order their proportions not to be altered. Detailed description of parameters used upon passenger creation is provided in the section of
391
Managing Passenger List
To view a passenger list, it is necessary to possess the right 'View passengers' towards a resource.
Passengers are listed in the alphabetical order. To quickly find a certain passenger, use the filter (choose filtration by property or by resource from dropdown list to the right of the 'New' button). Besides, the usage of a
is supported as well.
To display a passenger on the map, indicate its checkbox (the corresponding
should be activated).
Passengers do not possess their own coordinates, therefore they borrow their location from units to which they are bound. Click passenger's name in the list to center the map on its position. A bound passenger is represented by a small icon in the bottom right corner of unit's icon. If a passenger is not bound to any unit at the moment, its last known position is shown (with a bigger icon). If there is no data about passenger's location (for example, if it has never been bound to any unit), such a passenger is not shown on the map.
In the passenger's tooltip you can find its name, enlarged image, and custom fields (if any were set), as well as a name of a unit to which a passenger is currently bound.
Passenger's line may contain an icon of a unit to which a passenger is currently bound. In this case you can view unit's info by pointing an icon with a mouse.
The following actions can be performed over passengers:
— view or edit passenger's history;
or — edit or view passenger's properties;
— create a new passenger using this one as a basis;
— delete a passenger (the button is inactive if you have not enough rights).
392
Binding and Unbinding Passengers
Attention
To bind/unbind a passenger, it is necessary to possess the right 'Create, edit, and delete passengers' towards a resource.
Automatic binding is the only way for passengers to be bound to a unit. Automatic identification method requires utilization of the corresponding equipment. Dealing with passenger flow, RFID tags become commonly used. Getting into/out of a vehicle, a passenger brings a RFID tag against a reader.
Automatic binding/unbinding of passengers requires special adjustments to be done in the system as well:
1. Create the passenger type sensor for each unit intended for passengers binding. A parameter for this sensor can be
'avl_driver' or some other depending on your equipment and its configuration.
2. Create automatic binding list. To do so, click 'Auto-binding' icon ( ) and follow the steps described below.
Upon clicking the 'Automatic binding' icon a list of available resources is opened. You should possess at least minimum rights towards a resource creator, otherwise it is impossible to work with resource contents.
Here you choose a resource the passengers of which will be used in automatic binding (with the units chosen in the next dialog). In order to understand which passengers belong to a particular resource, go back to the 'Passengers' panel, and apply a filter by resource (dropdown list to the right of 'Create' button).
After choosing a resource, click 'Next'. If only one resource is available, then it will be chosen automatically.
393
The next dialog contains a list of units to which passengers from a chosen resource can be bound automatically.
Depending on the access rights possessed, the list can be viewed or edited.
Thus, a passenger will be automatically bound to a unit with the help of a RFID tag in case this unit has a special sensor configured in its properties and this unit is indicated in the automatic binding list of a resource to which this passenger belongs.
Automatic binding of passengers is removed in the same way: summon 'Automatic binding' dialog, choose a resource, and uncheck flags of units for which the automatic binding will not be used any longer.
394
Usage of Passengers
Online tracking
:
Passengers can be displayed on the map if their flags are indicated.
In notifications
:
You can configure a '
Passenger activity ' notification to get informed when a passenger gets into or out of a
vehicle.
You can configure a '
Passenger alarm ' notification to get informed if a passenger doesn't leave a vehicle
within an indicated time interval.
In reports
:
Such report as '
Trips ' may include a column displaying a number of passengers carried by a unit within a
trip.
As a part of '
Advanced Reports ' module, you can generate the '
' table showing time and location of getting into and out of a vehicle, name of a unit used by passengers, duration of a trip, etc.
395
Jobs
A job is a set of actions to be performed on a predefined schedule. A job can be command execution, sending reports by e-mail, changing access to units, etc.
To configure jobs, open the 'Jobs' panel choosing a corresponding name in the
or clicking on the necessary item in the
Here you can see the list of all jobs created, information on their state, and the button to create a new job.
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.
The system supports running test execution of a job. Test execution is a single execution of a created job regardless to its activation time and number of executions indicated. Test execution is implemented upon clicking the corresponding icon in the work list, and takes up to 1 minute. A result of a test execution is recorded in the
on job's test execution can be viewed in the
In the panel, the following icons and buttons are used:
Job type
Different kinds of jobs are marked with special icons in the first column:
—
—
—
sending information about fuel by e-mail or SMS ;
—
—
job on engine hours counting ;
—
—
job on GPRS traffic counting .
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.
Job's test execution column. Test execution can be run for a particular job only. To run it, click .
The first (left) column shows how many successful executions there were; the second (right) column shows maximum executions allowed.
Buttons to view and/or alter
job properties (depending on your access).
Create a new job on the basis of this one.
Delete selected job.
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 this job, such as enable/disable, edit or delete will be unavailable.
396
Configuring Jobs
To make manipulations with jobs, you should have at least one resource with the
'Create, edit, and delete jobs'.
To create a new job, press the 'New' button. In the dialog choose job type:
Execute a command over unit(s)
,
,
,
Send fuel information by e-mail or SMS
,
,
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.
Selecting Units for Jobs and Notifications
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).
Dialog of choosing units for a
or
notification consists of the units currently displayed in the
.
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.
and groups by clicking the switch-button / . If a unit group have been selected, then
the action is applied to all the units the group contains on the moment of action implementation. The list of current units you can find in a 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.
397
Please note that if there are more than a hundred units on this page, their icons are not displayed.
Upon editing a job/notification, units selecting dialog contains both units selected for a job/notification and units currently displayed in the work list. In order a unit to be listed in the dialog, it is necessary to possess the 'Use unit in jobs…' right towards this unit. If a job or notification that you are editing contains units to which you don't possess enough rights, you will be warned about it and in case you save the job/notification, those units will be lost.
Parameters for Jobs
These parameters are adjusted in the last page of the dialog:
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
Use one of two ways to set job's schedule:
(1) Periodic execution — each N hours and/or minutes.
(2) On schedule. Execution time is set in 24-hour format hours:minutes or just hours. If you need to indicate several points in time, separate them with spaces. Example:
8:00 22:00
In this case, the job will be executed at 8 AM and 10 PM daily (if other conditions concerning execution days are not set on the 'Time Limitation' tab).
Activation time
Date and time when the job will be activated.
398
Maximum executions
Enter the number of job executions after which the job will be automatically disabled. 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 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 limitation
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.
399
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 the selected units support this command;
a yellow triangle means that not all the 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.
400
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
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'.
401
Send a Report by E-mail
This
job can be used to automatically generate and send
about units' activity to your e-mail(s).
Choose report template, file format(s) and parameters. Specify time interval — for previous … minutes/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).
Reports can be sent as a job using file compression. In this case a letter sent to e-mail contains ZIP archive. Archive's name consists of a report template name and a date (yyyy-mm-dd). Upon receiving such a letter, extract files to a folder and open them with applications dealing with corresponding formats. Here are some rules of files zipping:
Compulsory zipping
: for the files in HTML, CSV, and XML formats, as well as for the files with total size exceeding 20 MB.
Zipping upon flag activation
: for the files in PDF or XLSX format.
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.
402
Send Information about Fuel
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 ).
Additional parameters to configure this report are:
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
. When all slots to enter e-mails and phones are filled, additional slots appear
delivery method becomes unavailable.
Message form: one unit in one message or all units in one message.
Time offset (in minutes): a parameter which 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.
For example, SMS message
Iveco_1501
1 66/-/-
403
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.
Dashes may mean one of the following:
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.
404
Jobs on Counters
can be set up in unit properties.
Jobs about counters allow you to automate accounting of mileage, engine hours, and GPRS traffic.
Mileage Counters
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. Depending on resource settings,
different measurement systems can be used.
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 event 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.
Engine Hours Counters
This is analogue of the previous type of job but it is applied to engine hours sensors.
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'.
creating reports —
. 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.
GPRS Traffic Counters
This job is aimed to:
405
1.
Automate
2.
Store GPRS traffic counter value in unit's history.
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
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.
406
Notifications
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.
or clicking on the necessary item in the
.
How to Create a Notification
1.
Click the 'New' button.
2.
Choose unit(s) to create a notification for, and click 'Next'. Units are selected in the same way as in jobs.
3.
Select what you would like to control: geofence, speed, alarms, sensor values, message parameter, etc.
4.
Adjust control parameters needed for the notification type selected in the previous window: select geofences, indicate speed limits, etc. Click 'Next'.
5.
Input your text for the notification using special tags listed in the table below. They will be substituted with real values when notification triggers.
6.
Indicate how the notification should be delivered: sent by e-mail or SMS, popup online, registered in unit history, etc.
7.
Key in a name for the notification and adjust the schedule for its performance.
8.
Click OK. The created notification will appear on the list in the left part of the window.
All of the steps of creating notification are described in detail below.
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.
407
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
to control and control type: control entries to or exits from geofences. Those geofences should be created in advance and belong to the same resource with the notification.
In addition, you can adjust speed limitations and/or sensor value range inside (outside) chosen geofences. Then the notification will trigger when all conditions are met.
Alarm (SOS)
For this type of notification, no specific settings are needed.
Digital input
408
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 (* and ?). 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, then enter delta. Notification triggers when delta is exceeded. Note that an indicated delta is compared to the module of values' delta.
Connection loss
Choose control type:
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.
409
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. Note that maximum allowed time of idling corresponds to 98 hours and 59 minutes.
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). Note that units interposition is checked by the system using their latest messages only.
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.
410
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 3 or more SMS messages in an hour's time.
Fuel filling
This notification type allows you to control fuel fillings, and provides with an information on the amount of fuel filled.
Upon notification creating you can indicate sensor masks in order to use this particular sensors for fuel filling detection.
Besides, checking the corresponding flag you can control location of filling in relation to the chosen geofences
(inside/outside geofence). These geofences should be created in advance, and belong to the same resource as the notification itself. Moreover, there is an 'Ignore recalculated data' option. Enabling this option allows receiving notifications for a new (current) fillings. If the option is disabled, then upon receiving a historic message (from the black box, or after importing messages, etc.) the number of events will be recalculated, and you will receive messages on the old (not current) fillings.
Note that notification triggers for every fuel level sensor individually, therefore the '
Merge same name sensors (fuel level) ' option is ignored in this case.
Fuel theft
This notification type allows you to control fuel thefts, and provides with an information on the amount of fuel stollen.
Upon notification creating you can indicate sensor masks in order to use this particular sensors for fuel theft detection.
Besides, checking the corresponding flag you can control location of filling in relation to the chosen geofences
(inside/outside geofence). These geofences should be created in advance, and belong to the same resource as the notification itself. Moreover, there is an 'Ignore recalculated data' option. Enabling this option allows receiving notifications for a new (current) thefts. If the option is disabled, then upon receiving a historic message (from the black box, or after importing messages, etc.) the number of events will be recalculated, and you will receive messages on the old (not current) thefts.
411
Note that notification triggers for every fuel level sensor individually, therefore the '
Merge same name sensors (fuel level) ' option is ignored in this case.
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:
be required. Using this notification you can control all drivers (*) or just some of them — input driver's name (or code) mask.
Trailer
Passenger Activity
To receive notifications on passenger's activity, choose control type: check in/out. Moreover, indicate passenger's code in the corresponding field. To control all the passenger, leave just the asterisk sign (*) in the field.
412
Passenger Alarm
Indicate a timeout upon the expiry of which you'll receive an alarm message if any passenger of a chosen resource stays in a vehicle. Timeout is started to count upon passenger binding.
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 '
' tab in unit properties or just several intervals. To specify target intervals, enter a
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)
or through unit properties dialog . Only after that, the notification starts working again.
Notifications' triggering peculiarities:
If upon creation of notification a unit with an already exceeded maintenance interval is chosen, then the notification for such a unit will not trigger.
If no position messages have been sent to a unit, then the notification for such a unit will not trigger.
Note.
As each notification belongs to some resource, it takes its measurement units from this resource. If the american or imperial 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.
413
Notification Action
Notification action is the way 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.
Note that if the flag 'Can send SMS' is not chosen in
, then the corresponding notification delivery method becomes unavailable.
Display online notification in a popup window
A notification can be displayed in a
. It can be silent or accompanied by a specific sound. If no URL is given for the sound, the standard tune will be used. Otherwise, enter sound URL to use a custom tune.
Recommended file size is up to 0.5 MB.
'Blink minimap' flag in this section.
Attention!
Different browsers can have restrictions regarding formats of audio files:
414
MP3 WAV Ogg AAC
Internet Explorer 9+
+ +
Google Chrome 11+
+
Mozilla Firefox 12+
Safari 5+
Opera 10+
+
+
+
+
+
+
+
+
+
To highlight a notification, you can set an individual color to it. This color will be applied to the background of the triggered notification so that you could easily notice it.
Send mobile notification
In this case upon notification triggering mobile notification is sent to a user/users of an application. Choose the necessary application in the left field. Then the system checks the possession of the necessary rights towards users:
'View detailed item properties', 'Act as given user'. Current user as well as creator of a resource to which a notification belongs are checked for the possession of these rights. Afterwards on the basis of this check a list of users is formed in the right field. Here you can indicate a user/multiple users (choosing the corresponding flags) or all the users
(holding <ctrl> and checking any user's flag) to whom a notification will be sent. Note that mobile notifications service availability depends on the chosen
Note that in order to receive mobile notifications, a user of
Wialon Mobile Client should authorize in the application
and enable the '
Send a request
You can transfer a notice on the triggered notification to external systems. Choosing this measure it is necessary to indicate server address as well as HTTP request method ('POST' or 'GET').
Register event for unit
In this case notification text is stored in unit history. Then a report on these events can be generated.
Register as violation
Upon checking this option 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
.
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:
command is supported by all selected units;
not all of selected units support given command (see details in the tooltip).
For some commands, you should set additional parameters like input/output number, online report interval, etc.
More about executing commands...
415
Change access to units
Choose
whose access rights will be modified when trigger conditions occur. Specify access that will be applied to those users after the notification triggers. This feature can be used, for instance, in the following situation.
Set counter value
engine hours counter, traffic counter) and set new values for them.
Store counter value as parameter
Current values of mileage or engine hours counters can be stored as parameters in unit data messages (odometer or
engine_hours
correspondingly). These parameters can be used to create
on their basis (for example, engine hours sensor) and to get initial/final mileage in reports. For more precise calculations, it is recommended to store counters while the unit is parked, for example, once a day at night time.
Register unit status
A new
can automatically switch to business.
Modify unit groups
You can change the contents of unit groups when a notification triggers — add triggered unit to a group or remove it from a group. On the left, there is a list of all available unit groups. Move necessary groups to the right to 'Add to
group'
or 'Remove from group' sections.
Send a report by e-mail
Enter e-mail address(es) to send a report to if the notification triggers. Select report template, object, file format(s), and other parameters to get a needed report. Sometimes it is convenient to choose 'Triggered unit' option — then the report will be generated for the same unit that the notification has triggered for.
Create a round
Creating a new
one round is finished, a new round can be assigned, or when unit leaves its garage (as a geofence), a round is 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'. Note that driver resetting can take place only within the resource to which a notification belongs.
416
Reset trailer
Similar to the previous one but concerns
. 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'. Moreover, the same as for driver resetting, trailers should belong to the same resource in order the action to be executed correctly.
417
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.
Below is the list of parameters applicable to most types of notifications:
%UNIT%
%CURR_TIME%
%LOCATION%
%LAST_LOCATION%
%ZONE_MIN%
%ZONES_ALL%
%SPEED%
%POS_TIME%
%MSG_TIME%
%DRIVER%
%TRAILER%
Unit name
Current date and time
Unit location at the moment when notification triggered
Last known unit location
(may be useful if there is no position in the triggered message)
The smallest of geofences holding unit at the moment of notification
All geofences holding unit at the moment of notification
Speed registered at the moment when notification triggered (is not applicable to fuel fillings/thefts)
Date and time of the latest message with position
Date and time of the message triggered
Driver's name (can be displayed only if the driver belongs to the same resource as notification)
Trailer's name (can be displayed only if the trailer belongs to the same resource as notification)
418
%ALL_SENSORS%
%LATD%
%LOND%
%GOOGLE_LINK%
All sensors and their values (not applicable to fuel fillings/thefts; does not show sensors with textual parameters)
%ENGINE_HOURS% Engine hours at the moment of notification
%MILEAGE% Mileage at the moment of notification
%LAT%
%LON%
Latitude at the moment of notification (e.g., N 55° 45.7530')
Longitude at the moment of notification (e.g., E 37° 35.2068')
Latitude without formatting
Longitude without formatting
Link to Google Maps with the position at the moment of notification
(e.g., http://maps.google.com/?q=55.762550N,37.586780E
)
%CUSTOM_FIELD(*)%
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').
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:
%ZONE%
%SENSOR_NAME%
%SENSOR_VALUE%
%SERVICE_NAME%
Triggered geofence name (used in notifications of geofence control)
Triggered sensor name (used in various notifications)
Triggered sensor value
Service interval name (used in notifications about maintenance)
%SERVICE_TERM% Service interval state — left/expired value (used in notifications about maintenance)
%TRIGGERED_SENSORS% All triggered sensors and their values (used in notifications about maintenance)
%PARAM_NAME% Parameter name (used in parameter control)
%PARAM_VALUE%
%SMS_TEXT%
%DRIVER_ID%
%DRIVER_NAME%
Parameter value (used in parameter control)
Text from SMS message (used in SMS control)
Driver's code (used in notifications about drivers)
Driver's name (used in notifications about drivers)
%TRAILER_ID%
%TRAILER_NAME%
%OTHER_UNIT%
%ROUTE_NAME%
%ROUTE_STATUS%
%ROUTE_POINT%
%ROUTE_SCHEDULE%
%ROUND_NAME%
%COUNTRY%
%REGION%
%CITY%
%STREET%
%HOUSE%
Trailer's code (used in notifications about trailers)
Trailer's name (used in notifications about trailers)
Name of another unit (used in notifications about interposition of units)
Route name (used in notifications of route control)
Round execution status (used in notifications of route control)
Check point name (used in notifications of route control)
Schedule name (used in notifications of route control)
Round name (used in notifications of route control)
Country
Region (state, etc.)
City (town, etc.)
Street
House
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.
419
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.
Time interval (from – to)
Time interval is a notification validity period. It is unlimited by default (the Time interval box is not checked).
Though, if it is necessary any notification validity period could be set accurate to the minutes (check the box and indicate an interval needed). Upon the expiration of the indicated time period, a notification will be automatically switched off (or permanently deleted if units mentioned in this notification do not exist anymore).
Control period from current time
This is a period of between the time when the notification triggered and the current server time. If this interval is exceeded, the message is not taken into account.
Min duration of alarm state
This parameter is aimed to exclude cases of accidental trigger that can be caused by equipment errors and inaccuracy. For example, a tracker can show that a unit left a geofence but returned 10 seconds later. In this field you can define how much time the alarm state have to continue in order to be registered. Choose an interval from 10 seconds up to 1 day. Minimum duration value is applicable directly to the main triggering condition (notification type) and does not influence the additional ones (speed, sensor value, etc.).
Max triggers
Maximum number of notifications to be delivered. The notification is disabled automatically upon reaching this value.
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.
Min duration of the previous state
This parameter is needed to exclude excessive triggers. For example, the unit can return to the normal
420
state for a very short time and then returns back to the alarm state. In order that the notification in such a case would not trigger twice, this parameter is used. Choose an interval from 10 seconds up to 1 day.
Max time difference between messages
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.
Process LBS messages
Activate this flag in order the system to consider location received via LBS detection.
Time limitation
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.
421
Notifications Management
On the list of notifications, you can get the following information:
Notification state: — enabled, — disabled.
How many times a notification has already triggered.
How many units are under control of this notification (see the list of these units in the tooltip).
Action(s) Control type
speed
geofences
alarm (SOS)
digital input activation/deactivation
sensor value
parameter in a message
connection loss
idling
SMS
interposition of units
address visit
excess of messages
fuel filling
fuel theft
route progress
driver control
trailer control
maintenance (service intervals)
SMS
online popup window
mobile notifications sending
POST/GET request sending
event registration
violation registration
command execution
modify users access level
manipulate counters
register unit status
modify unit groups
send a report by e-mail
create new round
reset driver
reset trailer
Hover the mouse cursor over a notification to see detailed information in the tooltip: control type, parameters, actions, life time, max triggers, text, and resource (if available).
The following actions can be executed over notifications:
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
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.
422
Online Notification
Online notifications can be received only by users logged in to the system on the moment of notification triggering.
Moreover, received online notifications are not stored in the system after logging out.
Online notifications will popup in a separate window and can be accompanied by a special sound (see
special parameters are not specified in
, the standard audio signal is used. However, you can assign your own sounds, for each notification individually.
As more notifications come, they are stored in the same window.
Received notifications are displayed in the online notifications window. A button-indicator of the number of newly
received (unread) notifications is situated in the right part of the bottom panel
. You can hide/show online notifications clicking this button. Moreover, a number of unread online notifications is shown on the browser tab.
Newly received notifications are added to the list on the top. An online notification's caption is taken from notification's name provided during its creation and highlighted in blue. To expand or collapse 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 new notifications until the '
Automatically display popup events
' flag is activated.
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).
Note.
Any user who has any access to a resource will get all online notifications created in this resource.
Note.
Online notifications can also be viewed in
Note.
The system supports receiving browser push notifications. Their main advantage is that you can see a notification
423
working on any tab of your browser, or even if a browser is minimized. You can enable browser push notifications in the dialog window which appears upon receiving the first online notification.
424
Users
User is a system object defined by its specific name (login) and password. Users can login to Wialon 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.
Working with Users
To work with users, open the 'Users' panel, choosing a corresponding name in the
top panel or clicking on the necessary item in the
On the panel, there is a button to create new users, and a list of available users. For your convenience, the users are arranged by name. If there are many users, use the
above the list to easily find them. Use buttons against each user to perform an action over a user:
— The button to login as this user. It is disabled if you do not have
enough access privileges. More...
or
tabs that were described above:
— Create a copy of this user.
— Delete user from the system. If the button is dimmed, it means you have not enough rights to delete it.
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
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
.
In
charts of their activity by hours and days.
Users' access to units can be changed automatically: 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).
425
Individual settings can be transferred from one user to others.
426
Units
Unit is a vehicle, equipment, person, pet or any other moving or stationary object that can be monitored via GPS tracking system.
The 'Units' panel provides the possibility to create (including creation from WLP), view, edit, copy, and delete units, export/import their properties and send SMS messages to them.
To work with units, open the 'Units' panel by clicking the corresponding name in the
corresponding item in the
. Afterwards, choose a mode which allows you to work either with units or groups of units. Note that unit creation is available in the 'Units' mode only, while other options can be used in the
'Groups' mode as well.
427
Managing Units
To create a unit, click 'Create', fill in
general properties , and click OK. A unit
created appears in the work area.
Units are listed in the alphabetic order. Each unit has an icon. To facilitate unit search, use dynamic filter. Such information as unit type, unique ID, and phone number(s) can be found in unit's tooltip. To do so, place a cursor on the unit. In order to view unit's tooltip it is necessary to possess the 'Edit connectivity settings'
The following icons are used to perform standard actions over units:
— Send SMS to unit's SIM card. It can be a command
or other message. SMS icons are not displayed if this feature is not activated for the current user. If the icon is inactive, then there is no phone number indicated in unit properties or a current user has no enough rights towards a 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
and in
, unit should be set up correctly, in accordance with device type used, available sensors, and tracking tasks. Unit is configured in
that was described above. Depending on your access level
, the dialog can contain up to 13 tabs which detailed description can be found in the following topics:
,
,
,
,
,
,
.
— Create a copy of this unit.
— Delete a unit from the system completely. If the icon is inactive, then you don't possess enough rights to perform such an action. Note that
routes assigned to a unit are deleted together with it.
428
Unit Groups
Created units can be formed into groups. Groups are used to unite units on the basis of any criteria.
To work with unit groups, choose the corresponding mode in the 'Units' panel.
To create a group, click 'Create', fill in
general properties , choose units forming a group, and click OK.
A list of unit groups created is displayed in the work area. Groups are listed in the alphabetic order. To the right of each group name you can see a number of units in it. To see names of units forming a group, place a cursor on the necessary group (names are shown in a tooltip). To facilitate a search of the necessary unit group, use dynamic search above the list.
The following icons are used to perform standard actions over units:
or — Edit or view
— depends on your
(change name, add more units, remove units, manage access, etc.). The dialog of unit group properties can contain up to 4 tabs which were described above:
,
,
.
— Create a new group using this one as a basis (copy).
— Delete the group from the system. Deleting a group does not mean deleting the units included. If the icon is inactive, then you don't possess enough
to perform such an action.
Working with unit groups, consider some specific features of
A group can be used to give a user access to several units at once.
With groups, access to a unit can be widened but not narrowed.
The creator of the group must have rights to units in this group. Otherwise, it would not be possible to transfer the rights properly.
To add/remove unit to/from a group, you are required to have the rights 'Edit ACL propagated items' on this group.
Application of Unit Groups
Unit groups are widely used in the user interface of Wialon:
429
1.
Online tracking of unit groups: display/remove from the map a group of units with one mouse click; send commands to a group of units at once; observe a certain parameter (sensor value, movement state, etc.) for a group of units in one window.
2.
Advanced reports: all tabular reports can be generated for a unit group; draw tacks of all grouped units on the map.
3.
Configuring jobs, notifications, and routes:
When configuring
,
or
routes , they can be applied to a group of units at once,
which accelerates the process.
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.
430
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 .
With a help of such features as Track Player, Distance, Area, Address, Routing, Hittest, Nearest units, and LBS
Detector
you can measure the length of polyline or just a distance between two points, measure an area of any piece of the map, find out the address of some place, get to know the shortest way to a certain destination point, analyze movement tracks, etc.
To get more accurate measurements, observe the following rules:
To add a point, double-click on any place on the map;
To insert a point, double-click on the segment between two points;
To delete a point, double-click it;
To change position of a point, click on it and holding the left mouse button drag to another place on the map.
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,
track processing (such as Track Player, Hittest) are borrowed from units' properties.
Find detailed information about each tool:
431
Track Player
This
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 '
' 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
1000 times (1000x). 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: along with the unit, while playing a track; when locating initial and final position in the track with special buttons; when moving along the track point-by-point manually;
432
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 has been 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:
— go to first point (accompanied by the marker on the map),
— go to last point (accompanied by the marker on the map),
— move to next point of the track,
— move to previous point of the track.
Tracks can be also played in a special app — Track player . This application allows playing tracks of several units at once.
433
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 ways described
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.
434
Area
Choose
Tools => Area
on the menu. To draw a polygon, follow the same directions as for polyline creation. The perimeter and total area are indicated in the instrument's window.
Note that for users with metric system of measurement the area value is given in hectares, for users with U.S./imperial
— in square miles and square feet.
Use the 'Reset' button to clean the map and draw a new area.
435
Address
is designed to: find a place (city, house, etc.) on map; detect the address of a place.
Choose Tools Address on the menu to make use of the tool.
The default provider for address information is Gurtam Maps. Though you can choose another source (depending on
In
, you can indicate City. Then this city/town will be selected automatically when you open the Address tool.
Search by Address
Start entering address details into the 'Search address' field and choose the appropriate matching from the appeared address list. If nothing is found try to rephrase your request. A found place is indicated on the map with the blue marker.
The 'Address' instrument's window displays such information as coordinates and address (if available). If the found place gets into any
assigned to this geofence.
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 coordinates in the instrument's 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 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 . To do so, there is the 'Save as geofence' section at the
bottom of the 'Address' window. Unfold the section by clicking on it. Here the following parameters are indicated: resource (can be chosen from the dropdown list), geofence name, and radius.
436
To save the geofence, click the corresponding button. The saved geofence becomes available for viewing and editing on the 'Geofences' tab.
437
Routing
This
define the sequence of points yourself or the program will optimize it for you. You can indicate key points double-
control points, or a
route , and can be used for routes control or geofences control later on.
Choose Tools Routing to make use of this feature. Set points and click 'Calculate'.
Selecting Provider
Gurtam Maps is a default cartographical service for making a route. Besides, depending on the maps available at your service, other map providers can also be used: Google, Yandex, HERE, etc. However in this case the order of points should be chosen manually (or previously determined using Gurtam Maps). Some providers offer additional options.
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:
1.
With the mouse
.
Just make several double-clicks on the map to mark key points. If the option 'Use detected addresses as
names for points'
is enabled in the 'Points' panel, then address information is set as point name. If no address information is available, the point is added anyway but with empty name.
2.
With the address tool
.
In the 'Address' panel indicate addresses to be visited (city, street, house). The usage of the
was described in details in the previous section. The found points can be added to the route automatically
(if the flag 'Auto save of points' is enabled), or manually (with the 'Add point' button if this flag is disabled).
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 or as a route.
The list of points is displayed in the 'Points' panel. Here you can edit point name, its radius, and delete unnecessary point.
438
Route Calculation
If building a route with Gurtam Maps, 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, click 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.
If the calculation is made using routing, then the route will be built considering the existing roads. The default routing provider is Gurtam Maps. Though, the other sources can be chosen as well: Google Maps, Yandex, HERE, etc.
Saving as Geofence or Route
After the calculation and visualization has been done, the result can be saved either as a line-shaped geofence or as a route. Geofence saving section is automatically opened after calculation by default. Here you should enter geofence
439
name, choose a corresponding resource, and click 'Save' button. There are two variants for saving in this section:
If 'Save key points only' flag is activated, then geofence corresponds to a line going straight through the key points;
If the flag is not activated, then geofence corresponds to the full line of a route (can contain any number of points).
The newly created geofence will appear on the '
' panel where it can be edited and used for different purposes.
As it was mentioned before, the result can also be saved as a route. To do so, it is necessary to unfold the corresponding section, indicate a name for the route, and click 'Save'. The created route appears in the '
where it could be edited or used.
To build a route, you can also make use of a specially designed app — Delivery Service .
440
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 'Report's 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.
This point will be highlighted with the pulsating circle. Double-click at any place of the track (or even on the map), and the nearest to your click message will be found and indicated 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 (
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.
441
Nearest Units
This
Choose Instruments Nearest Units on the menu. In a special window set the parameters of your request and observe search results.
Request
There are two ways to indicate a place:
1.
Double-click on the map in this place.
2.
Enter address in the 'Search' field and then choose the most likely variant below.
In the selected place, a red marker appears, and at the bottom the list of nearest units is displayed.
If in
Note.
Only Gurtam Maps can be used for address detection.
Additional Parameters
Several additional parameters can be applied to the search:
Number of units to show
5, 10 or 20 units can be shown (choose the number from the dropdown list).
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. Moreover, enabling this option you can not only receive the distance between the indicated point and a unit, but also time which is necessary for covering this distance.
Routing provider
By default, it is Gurtam Maps. However, in can be Google, Yandex, Visicom, and HERE as well.
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.
Data for last
Units which have not been sending messages for a long time can make difficulties for locating nearest units. Then it is handy to narrow the search interval: for last 5 or 30 minutes, 1, 6, 12 or 24 hours, or set 'Anytime' (no limitations). If unit last message does not get into the specified interval, this unit will not be considered.
Search Results
Search results are presented at the bottom of the window as a list of units. There you can see the following information: unit name (click to focus the map on unit), driver's phone number (if any driver with indicated phone number is bound to unit), distance to the indicated place (if routing is applied, the first number stands for a distance considering routing and the number in brackets stands for the time necessary to cover this distance, if available), sensor state indicator (adjusted on the
Advanced tab of unit properties),
buttons to
to unit (including messages to driver).
442
If you are not satisfied with search results, please, check your
because the search of nearest units is performed on the basis of units displayed on that list.
443
LBS Detector
LBS Detector is a
tool which helps to detect unit's location on the map using mobile network.
Note that this instrument enables to determine a location of the nearest base station only. So, the knowledge of the base station location implies the unit is nearby.
Choose the corresponding item in the instruments menu to open the 'LBS Detector'. The further actions are listed below.
Working with LBS Detector
Choose a necessary unit in the dropdown list. Its contents depend on the
of the Monitoring panel and access to those units ('Query reports or messages'). Besides, the list contains only the units with corresponding parameters.
After the unit is chosen, a search starts automatically. Then the map is centered on the found location identified with the blue marker. Also, unit's name can be enabled/disabled below the marker by pressing the corresponding button in the
its address. To the right of this data there is a 'Refresh' button pressing which the location information will be updated.
444
SMS
SMS messages can be sent to drivers, units, and to any phone number. SMS dialog is accessible in '
',
'
Drivers ' panels as well as in the '
' 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
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
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.
SMS chat of a dispatcher with a driver can be shown in a special table called
Correspondence with driver can be also fulfilled with the help of a specially developed app — Chatterbox .
445
Search on Map
In the
to the left of the user name there is the 'Search on Map' tool (search icon). This tool is used to dynamically search the necessary item by its name. The search is made among units, geofences, unit groups, drivers, trailers, and routes. Moreover, if the names of the above mentioned items do not contain indicated symbols, then addresses corresponding to the entered filter are shown.
Search Process
Click the corresponding icon in order to use 'Search on Map' tool. In the appeared field enter a search filter (type in symbols of a desired item's name). Moreover, searching a unit you can enter its
. Upon indication of the first symbol the list of the items corresponding to the filter appears below. Items in the list are displayed using their names, and icons specifying their type. If lots of items correspond to the indicated filter, then the list will contain single result for each item’s type.
Switching to the Item on the Map
Click on the necessary item in a search list in order it to be shown on the map. The alternative way to do this is to use up and down arrow keys and <enter> on the keyboard. The map is centered on the chosen item. Moreover, the map is scaled in such a way that the chosen item gets into the vision field. After you choose the item in the list, the search tool will be folded up.
446
Apps
Along with the basic features of Wialon, 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.
To open the 'Apps' menu, choose a
or click the necessary item in the
Click the logo (or name) of an application to open it in a new tab of your browser. An application can also be opened in a separate window over Wialon by clicking the following icon — (appears upon pointing a cursor over an application). Windows with applications can be dragged over the screen, resized, and closed down.
447
Manage Applications
Authorized applications
This tab contains the list of applications having any access to your account and data. To the left there is an application name, to the right you can see access rights possessed by an application towards your data or account. To block an access for the application it is necessary to delete the corresponding application from the list.
Mobile Notifications
This tab contains the list of applications which are allowed to send notifications to your mobile devices. To the left there is an application name, to the right you can see a device type. To block mobile notifications sending it is necessary to delete the corresponding application from the list.
448
Wialon on Mobile
You can track your units not only from a full-sized desktop computer but also from a smartphone, tablet, and other mobile devices. The interface is adapted for such cases. Moreover, a special mobile application for Android and iOS is available as well as two previously developed web applications.
Wialon Mobile Client
Wialon Mobile v1
Wialon Mobile v2
449
Wialon Mobile Client
Wialon Mobile Client is an application providing you with the basic Wialon Hosting capabilities on your mobile devices.
Wialon Mobile Client is available for both Android (smartphone) and iOS (smartphones, tablet computer) platforms.
The set of Wialon Mobile Client functionality amounts to the following: tracking of unit location and moving state (trip, stopping, parking), controlling ignition state (on/off), monitoring data actuality (time passed from the last message received) and latest events (trip, parking, fuel filling/theft), as well as sending several commands.
Note.
Wialon Mobile Client 1.4 and further versions require iOS 8.0+.
Further information:
450
Units
First start of the application brings us to the 'Units' mode, or simply work list. In the work list you can monitor units' parameters, or you can switch either to the '
' mode from here.
The work list contains dynamically updated unit information. This information includes current moving state, data actuality, state beginning time, duration, and address. Further let's explore the possible variants of graphic information presentation:
Current state
for movement states detection are also taken into account in the application.
Trip
Stop
Parking
Current state unknown (check trip detection properties)
Last known state is no longer relevant as it was detected more than a week ago
No data from unit
Ignition state
Ignition is on (green circle with key). Ignition off — key not shown
451
Attention!
Unit's current state as well as ignition state are available only if you have 'Query messages or reports' right.
Data actuality
last message was received no more than 5 minutes ago last message was received no more than an hour ago last message was received no more than 24 hours ago last message was received more than a day ago
On the first launch of Wialon Mobile Client the work list contains all the units available in the Monitoring panel of
Wialon. However, it is more convenient if the work list contains the units you are currently interested in. To form the work list, it is necessary to move to the 'Choose units' menu by clicking the 'Eye' icon to the left of the dynamic search
(for iOS — to the right of the dynamic search).
Units indicated by a flag in this menu are added to the work list. You can either choose all the necessary units one by one (tap it), or choose all the units at once (corresponding button in the end of the list). Use dynamic search to find a particular unit.
To get back to the work list after units choosing, it is necessary to save or dismiss indicated changes. In the interface of Android use the green check mark icon (save changes) or red cross icon (dismiss changes) to the left of the dynamic filter. Using iOS device, tap 'Save' or 'Cancel' buttons situated on both sides of the menu name.
452
Map
Map mode can be activated by choosing the corresponding item in the main menu, or by tapping the map's icon situated in all the available modes to the right of their names. Units from the work list are displayed on the map. By default the map is centered in such a way that all the units get into vision field. Note that geofences created in Wialon can be shown on the map of mobile client (enable the corresponding option in the 'Settings' mode of Wialon Mobile
Client).
Interacting with Map
Zooming
Map zooming is made by special controls appeared in the bottom right corner of the map. These controls can be enabled/disabled in the 'Settings' mode (choose in the main menu).
Moreover, map zooming can be made using special gestures on the screen:
Double tap — zoom in.
Two fingers tap — zoom out.
Two fingers stretch/pinch — zoom in and zoom out, correspondingly.
Double tap without releasing on the second tap, and then slide the finger down — to zoom in, or up — to zoom out.
Tilt gestures
You can tilt the map by placing two fingers on it and moving them up (increasing tilt angle) or down (decreasing tilt angle).
Map rotation
To rotate the map, place two fingers on it and apply a rotate motion. After the map has been rotated, a compass icon appears in the top right corner. Tap it in order the map to return to default position (North in the top of the screen).
Finding Device Location
Finding your own location is an additional feature of the application's map mode (can be used only if Gurtam Maps cartographic service is chosen). Tap the 'Arrow' control in the top right corner in order your current location to be shown on the map by a marker (the control receives active state). Upon moving the map and loosing location marker from the vision field, the 'Arrow' button changes for the 'Target' one, by tapping which the map will be centered on your location once again.
From the 'Map' mode you can move to the main menu (corresponding button in the upper left corner), or to the 'Track' mode (tap unit icon on the map).
453
Tracking
There are several ways of switching to the 'Tracking' mode. One of them (switching from the 'Map' mode) has been described in the
the necessary unit in the work list.
'Tracking' mode provides you with a possibility to monitor both unit's location on the map, and parameters received from a unit.
'History' tab
You can view unit's events on the 'History' tab. All the events are presented here chronologically.
Types of events and provided information:
Trip
Event's start time, duration, covered distance, unit's average speed
Parking
Event's start time, duration, location address
Fuel filling
Event's time, amount of fuel filled, location address
Fuel theft
Event's time, amount of theft, location address
Choose any event in the history to display it on the map. In order the map to be centered on a unit of monitoring, tap its icon.
Note that some values of event parameters (time intervals, amounts of fuel, unit's location) may differ from the values of the same parameters in the reports of the monitoring system. It occurs due to the implementation of different calculation systems in main Wialon and in Wialon Mobile Client. For example, upon detecting fuel fillings/thefts, mobile client uses time of a last message received before a fuel level changing, while main Wialon uses time of the first message from the interval with the biggest difference of fuel levels. Moreover, movement state in Wialon Mobile Client is determined only by GPS speed, while other methods can be used in main Wialon.
Note that in Wialon Mobile Client the correctness of data received on any event depends on parameters indicated on the trip detector tab.
454
'Info' tab
The 'Info' tab displays an additional unit's information, such as equipment data, values of custom fields, sensors, counters, and parameters.
'Timeline' tab
On the 'Timeline' tab you can visually identify events duration, find out their number, and get full details on grouped events (tap a number indicator). You can work with the following events: trips, fuel fillings, fuel thefts. Moreover, both sensor state changing (ignition sensor, custom digital sensor) and sensor values increasing (mileage sensor, relative odometer, counter) are considered to be events as well.
You can view up to 4 events on the timeline. Trips, fillings, and thefts are chosen by default (names are displayed in the bottom of the screen). To choose other events, summon the corresponding menu by tapping any event in the bottom of the screen.
Locator
The application supports a locator functionality. Locator is used to generate links and share current units' location.
Locator can be available either from the work list ('Units' mode) or from the 'Tracking' mode. To generate a link, use left swipe in the line of a corresponding unit, and tap the 'Target'. In the appeared menu, choose locator's link validity period (from 1 hour to week). Then choose a necessary action: send a location link by any messenger on your smartphone, copy it, open in a browser, etc. Viewing is performed on locator's map which becomes available upon clicking on the provided link.
455
Notifications
To receive mobile notifications, it is necessary to configure their sending in Wialon. In other words, it is necessary to
a way of
. Notification receiving should also be activated in the 'Settings' mode of Wialon Mobile
Client.
Moreover, to send mobile notifications it is necessary to activate such services as 'Mobile notifications' and 'Wialon
Mobile Client'.
Received notifications are automatically saved in the system, and afterwards can be viewed in the corresponding mode. Note that notifications are stored in the system within 30 days. Besides, the number of notifications per one user is limited to 2000 items.
Blue marker on the icon of switching to the main menu signals about receiving a notification. The number of received notifications is displayed to the right of the corresponding menu item. After switching to the 'Notifications' mode the marker disappears.
Switching to the 'Notifications' mode is done via the same called menu item. Moreover, it is possible to be done through the work list or through the 'Tracking' mode. To do so, swipe to the left in the line of a unit for which a notification have triggered and tap the 'Bell'.
'Notifications' mode features a list of all the mobile notifications received. Tap any notification in the list to view unit's location on the map during notification triggering.
456
Commands
The following commands are supported in Wialon Mobile Client:
Query position;
Block engine;
Unblock engine;
Activate output;
Deactivate output;
Set data transfer interval (how often unit sends data to the server);
Send custom message (sending of a non-standard command to a unit);
Send message to driver;
Upload configuration (not supported for iOS);
Upload firmware;
Query snapshot;
Query snapshot from specified camera;
Query DDD file.
Switching to the command sending menu can be done either from the work list ('Units' mode) or from the 'Tracking' mode. To do so, swipe to the left in the line of the corresponding unit, tap triangle, and choose the necessary command.
Here you can view detailed information on commands.
457
Wialon Mobile v1
Mobile Wialon can be used from mobile phone or Pocket PC. Its functionality includes: display current location and movement history of a unit (or unit group) for a period of time on the map; information about unit state, its sensor values, its latest position and latest registered event; sending commands to a unit remotely; search cities, streets, addresses on the map.
To access Wialon Mobile v1, enter address in the browser. On the first page, enter your user name and access key as it is set in
select the operation to perform.
Unit Information
Select unit to get information about, push Next and get the data. The information includes unit name and device type, its location and speed, time when the latest message was received. It also provides all sensors values, the latest event, and phone number if available.
When a time passed, you can get fresher information about the unit. Simply push the 'Refresh' button to get the latest data.
To get information about some other unit, push Back and select other unit from the dropdowm list.
Monitoring
Select one or more units to monitor them and click Next. Select time interval to map the track for, indicate map size and scale. Push 'Show' to display the search result.
The map can be moved and zoomed using the appropriate buttons above (arrows — to move, plus and minus — to zoom). However, if more than one unit is selected, then the map is scaled in such a way to show all units, and it is impossible to move and zoom it.
When a time passed, you can get fresher information about the unit. Simply push the Refresh button to get the latest data.
458
Click on 'Menu' to go back to the main menu.
Commands
Select one or more units to execute a command. In the next window choose the command and specify parameters if needed. At the end, click the 'Send' button. You will be notified whether the action was successful.
Search
To find a place on the map, enter some first characters of the city and/or street, add house number if you need more accurate search. Set also map size and scale. The received result you can scale and move.
459
Wialon Mobile v2
Wialon Mobile v2 is a specially developed program which gives access to lite version of Wialon from different mobile devices such as Android, iPod, iPhone.
Requirements for mobile operating system: iOS;
Android 1.6+;
Only native browsers can be used, and cookies should be activated in the browser.
Wialon Mobile basic features are: displaying unit current position on map; unit movements for latest 5 messages; dynamic filter of units by name; information about unit state, connection, driver, sensor values, etc.; tracking of moving units; geolocation.
Login
Navigation
The following options are accessible through the main menu:
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);
Settings
: custom configuration of the program (map, icons, etc.);
Logout
: logout from the program.
Units and Commands
To access Wialon Mobile v2, 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
system from an ordinary computer.
Enable cookies in your mobile browser. It is required for correct operation of the program.
If you have logged in successfully, the main menu becomes available.
Upon the first login, no units are displayed in the list until you apply a filter.
However, the next time you log in your previous work list will be displayed.
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
display all units, type *.
Units in the list are displayed by their names and icons. Additional information on each unit is available as well: last message's time and speed. Tap a unit
460
in the list in order its
to be displayed.
Moreover, there are two buttons to the right of each unit in the work list. One of them enables/disables a unit displaying on the map, tapping the other button you can send commands (if the button is active). These are the states of the buttons:
— a unit is displayed on the map
— a unit is not displayed on the map;
— commands are available;
— no available commands.
If you would to send a command to a unit, tap the corresponding button. Afterwards, a menu of available commands is
opened. Choose the necessary one and tap it to send. Note that commands' creation
is available in the interface of monitoring system only.
Unit Properties
Unit properties are divided into two tabs:
Information
— information on current state of unit:
General
— last messages time, device type, phone number, unique
ID (phone number and UID are available only if the current user has
manage
access to this unit);
Position
— location (if available), speed of movement, altitude, satellites locked, course (direction of movement, if available);
Counters
— mileage, engine hours, GPRS traffic.
Sensors
— sensors and their values.
Parameters
— state of inputs/outputs and other parameters available in the last message.
Custom fields
— unit custom fields from its properties.
Settings
— unit display on the map:
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.
461
Settings
Program settings are also divided into two tabs:
General settings
:
Language
— choose English or Russian as interface language.
Unit settings
:
Show icons
— enable or disable displaying units' icons in the work list. By default, the option is activated. However, you may want to disable it in order to increase program performance. Smooth scrolling of the work list depends on mobile device properties,
Internet connection quality, and other factors.
Map settings
:
Show unit names
— unit can be displayed on the map either as just an icon or together with its name.
Use geolocation
function.
Address provider
— default address provider is Gurtam Maps, however, Google Maps can be activated, too. If no address information is available, then coordinated 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.
462
If you move to the map from the
, the map is scaled in the way to let you see all selected units. If you move to the map from
the map is centered on this unit.
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.
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
You can choose from several kinds of maps:
Gurtam Maps,
Google Maps (if keys provided).
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.
Set time interval (from — to) and other track parameters:
Trips
— apply trip detector while building the track;
Annotations
— show annotations at the points where messages were received (time and speed is given in the annotation);
Color
— track can be of different colors depending on speed or sensor values or be just one-colored.
More about track parameters...
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
Wialon Mobile v2 supports geolocation function. Geolocation is the identification of
463
the real-world geographic location of an object, such as mobile phone or an
Internet-connected computer terminal known from the Internet Protocol (IP) address,
MAC address, hardware embedded article/production number, embedded software number, or other information.
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. At that, Gurtam Maps are always available.
464
ActiveX
Documentation available at http://sdk.wialon.com/wiki/en/sidebar/activex/activex .
465
SDK
SDK is a software development kit that allows you to integrate Wialon with other systems, as well as create additional applications and sites for Wialon 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
Two areas of SDK development are available at the moment:
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 functions from your web application using JavaScript. IT considerable decreases time of creation a web application because basic procedures have been already implemented.
466
Frequently Asked Questions
Reports
Calculating Fuel: Time-Based or Trip-Based
Incorrect Intervals of Engine Hours
GPS Hardware
Maps
Google and Yandex Addresses in Reports
Placing New Maps on Wialon Hosting
Other Questions
%ZONE% instead of Geofence Name
Cannot Remove Access to a Unit
Error 'Your browser does not support cookies'
Problem Logging In Because of a Supposed Attack
Tracks with 'Stars' at Parkings
Unit Disappear from the Monitoring List
Violations Are Not Registered
Wialon Hosting Design
467
Reports
Calculating Fuel: Time-Based or Trip-Based
Incorrect Intervals of Engine Hours
468
Calculating Fuel: Time-Based or Trip-Based
What is the difference between time-based and trip-based calculation of fuel level?
1. Trip-based calculation
In a standard situation, all calculations of fuel level are trip-based. That means data from the FLS is taken only during intervals of movement (trips). Those trips are defined according to parameters set in the
Thefts and fillings are detected if there is a difference between fuel level in following trip (X) and fuel level in previous trip (Y). If (X – Y) > 0, it is a filling; if (X – Y) < 0, it is a theft; if X = Y, it is neither. Of course, there can be some inaccuracy in data coming from the FLS. That is why, to avoid false thefts and fillings, set the following parameters on the
Fuel Consumption tab of unit properties:
minimum fuel filling volume, minimum fuel theft volume, minimum stay timeout to detect fuel theft, and some others.
2. Time-based calculation
Time-based calculation of fuel level is recommended only for stationary objects like tower crane, generator etc. It is not good for usual vehicles. This type of calculation is very complicated and based on sophisticated mathematical functions.
Example 1.
A vehicle stayed at a parking lot during 10 hours. Defueling was made by small portions over the whole parking period.
As a result, 60 liters of fuel were stolen. Such theft will be detected only with trip-based calculation method.
Example 2.
If a device was cut off from power and a theft was done during that period, such theft can be detected only with tripbased calculation method.
469
Common Report for All Units
How can I make a common report for all units at once?
To do this, create a unit group which includes all your units. Then create a reports template of 'Unit group' type. This template can be applied to your group of all units.
470
False Thefts or Fillings
When the tracker is cut off power, FLS sends zero values. As a result, false fuel fillings and thefts appear in reports. How to avoid that?
If FLS does not provide data for some reason, the tracker may send zeroes instead. Those zeroes will be interpreted by the program as valuable data. That is why non-existent fuel fillings and thefts may appear.
To avoid this situation, set in FLS properties X lower bound like '0.0001'. So, values lower than this will be considered as invalid and ignored in calculations. Note that X lower bound should not be higher than minimal X value from the
As an alternative, you can use
to solve this problem – validation type 'Not-null check'. In this case you will have to create two sensors based on the parameter of FLS.
471
Fuel Filling Is Not Detected
We have refuelled the vehicle but cannot find this filling in the report. Why?
Possible explanations and actions:
1. Incorrect settings for trip detector.
The option to analyze fuel filling only at stops is set on the '
' tab of unit properties, however, the Trip
increase minimum moving speed or maximum distance between messages).
2. High filtration level of FLS.
Decrease filtration level of FLS on the Fuel Consumption tab (recommended are values up to 15) or set the option
'Calculate filling volume by raw data'.
3. High value of minimum filling.
Decrease the value of minimum filling volume on the 'Fuel Consumption' tab.
472
Fuel Theft Is Not Detected
A fuel theft was made but it is not shown in the report. Why?
Possible explanations and actions:
1. Test theft right before fuel filling.
If you made a defueling for test purposes and then refueled the vehicle right away, the system may regard this as outlier of data. In real situation, when a theft is not followed by immediate refueling, such theft will be detected.
2. Theft during a prolonged shutdown of the device.
A theft can be detected only if the option 'Time-based fuel level sensors consumption' is off (see the
tab of unit properties) and if there is a trip after switching on the device again.
3. High filtration level of FLS.
Decrease filtration level of FLS on the 'Fuel Consumption' tab (recommended are values up to 15) or set the option
'Calculate theft volume by raw data'.
4. High value of minimum theft.
Decrease the value of minimum theft volume on the 'Fuel Consumption' tab.
473
Incorrect Intervals of Engine Hours
In the table of engine hours, incorrect intervals are detected. What can I do?
Possible reasons and how to eliminate them:
If engine hours are detected by ignition sensor, the reason can be that data coming from this sensor is
incorrect. Check sensor properties
: parameter, calculation table, validation, etc.
For accurate engine hours calculation the equipment should send a valid parameter value of an engine sensor. In case of receiving an invalid value it is necessary to
using the correct value (for example, 0).
The value of 'Maximum interval between messages' (adjusted on the
Advanced tab of unit properties) is
less than a typical interval between messages transmission. That is why intervals of engine hours are wrong. In this case, set the parameter 'Maximum interval between messages' as zero or give it another adequate value.
474
Incorrect Mileage
Incorrect distance/mileage is shown in the reports. What can I do?
Possible reasons and their elimination:
1. Outliers of data.
To detect such outliers, build a track of unit movement for the appropriate period. Outliers of data will be seen on the track as dashed lines.
Ways to overcome outliers:
Enable filtration of unit positional information in messages (on the Advanced
tab of unit properties). This will not affect old messages but applied to new ones.
To correct data in reports, change settings of
trip detection , in particular, reduce 'Maximum interval
between messages' and increase 'Minimum satellites'.
2. Incorrect settings or operation of the mileage counter.
Check the mileage counter settings on the
General tab of unit properties.
475
No Report on Geofences
From the track of unit movements, I can see that the unit visited geofences. However, in the report on geofences there is no such information.
Possible solutions:
Enable/select necessary geofences in table properties of the report template – see
If you cannot find necessary geofences listed in the report template, it means that the report template and
those geofences belong to different resources. To solve this problem, you can use the import/export
tool to transfer necessary geofences to the corresponding resource.
476
Trip Not Detected
A vehicle definitely moved (there are messages with 70 kph speed), however, this trip is not shown in the report.
Possible explanations and actions:
Movement detection is set incorrectly in the
trip detector , e.g., the ignition sensor is out of operation or
configured inproperly.
of intervals is selected in the reports template (by minimum mileage, by stops, etc.), those filters can weed out this trip. Clear the filters or correct them.
The interval for data transmission which is set in the device is bigger than 'Minimum parking time' option set in the trip detector. Either configure the tracker to send data more often or increase minimum parking time value.
Check other parameters of the trip detector.
477
GPS Hardware
478
Calibrating a Fuel Tank
How to make calibration of a fuel tank?
General procedure of calibration for an analogue FLS (fuel level sensor):
1.
Empty the tank completely. Make sure the vehicle accumulator is charged and will not go flat in a couple of hours.
2.
Cut the FLS to the necessary length and install it into the tank.
3.
Enable data transmission for the necessary input (for example, Ain1). It is recommended to set a frequent data transmission (like once in 10 seconds, for example).
4.
Draw a grid for your future calibration table. There will be two columns – 'Liters' and 'Volts', and so many rows as parts you divide your tank into (+ O liters row). Write the beginning time of the operation.
5.
Divide the volume of your tank into 10-30 parts. Pour portions of fuel and each time write the current fuel level in the tank into your calibration table. Wait 2-3 minutes after each new portion. Continue till the tank is full. As a result, the first column of your table ('Liters') will be filled in.
6.
Work at the computer. Log in to Wialon and go to the Messages panel. Query messages from the unit for the calibration period.
7.
Fill in the second column of the calibration table ('Volts'). Do not forget the zero point. The dynamics of changes in voltage can be analyzed through the table of messages itself or through parameter's chart (the button to switch between the table and chart view are situated above). If there are many messages, do not forget to load next pages.
8.
On the basis of gathered data, create a sensor in unit properties on the Sensors tab. Input the data from the calibration table to the Calculation Table Wizard.
9.
Optionally, add two more points with values exceeding maximum and minimum. It makes the chart look better. For example, if your calibration table has the range from 1.2 to 4 volts, add a point 1 volt = 0 liters and the other point 5 volts = max liters.
10.
When all data is in the Calculation Table Wizard, press the button 'Generate Calculation Table'. Then go to the tab 'Calculation Chart' and press the button 'Refresh' to estimate the result of your work. If necessary, return to the wizard, edit fields, and generate new table and chat.
11.
Optionally, define minimum value (different from zero) on the Calculation Table tab (for example, 1 volt).
This may help to avoid detection of false fuel filling when the accumulator is off.
12.
Save the sensor pressing OK button.
13.
Enable fuel level sensors on the Fuel Calculation tab of unit properties.
For a digital FLS, the procedure is similar but with the following peculiarities:
1.
After cutting the FLS (before calibration!), connect it to the configurator and take the readings from two points – zero and maximum. 0 is taken from the sensor hung up in the air, max is taken from fully dipped sensor. It does not mean that you need to empty and refuel the tank completely. You can simply use a stoppered segment of a sewage pipe or some other container/vessel.
2.
To save time, steps from 3 to 7 can be replaced with the following. Connect your sensor to a laptop. Input data to the calibration table with each new portion of fuel.
Note:
You can get the most accurate data if your portions do not exceed 5-10% of tank volume and smaller portions are used to calibrate the upper part of the tank.
479
Device Does Not Connect
What to do if I am directing a device to the server and cannot see any messages from it? It says my device is not connected.
Var 1:
The device is not connected or adjusted properly.
There can be several reasons why a device has the status not connected in Wialon. To identify and eliminate them, do the following:
1.
Make sure the device is in good order and situated in the area of satellite availability, all wires, aerials, and power supply are connected correctly.
2.
Check SIM card balance.
3.
Make sure the device is adjusted properly: check IP address, server port, connection interval, APN. There can be other settings and peculiarities concerning your device and its connection, so consult the user's guide or contact the manufacturer. You can also pick up some tips from the forums:
Gurtam Forum => Tracking Devices
GPS-Trace Orange Forum => GPS Tracking Hardware
4.
Check device ID in Device Unique ID Checker . Follow the link and you will find the IP address of a special server where you direct your device to verify its ID. Direct your device to this server and wait till the information about its connection appears. If connection successful, compare the value in the column
'Unique ID' with unique ID written in unit properties. If your type of device requires password for sending data, it should be written in unit properties, too.
5.
If you cannot see your device in Device Unique ID Checker for a long time, double-check all settings mentioned above, and then write to [email protected]. Describe your problem and what you have already done, send us the name and unique ID of your device. We will make an analysis of the situation.
Possible reason is changes or errors in device firmware.
Var 2:
This type of device is not supported in Wialon.
See the full list of supported devices . If your device is not in the list, write to [email protected] and attach the original communications protocol of your device. See
New Hardware Support for details.
480
New Hardware Support
What to do to support a new type of tracking hardware in Wialon?
To integrate a new device in Wialon, send a request to [email protected].
481
No Parameter for a Sensor
Why there is not parameter for a sensor?
1.
Make sure your device is able to work with this sensor.
2.
Double-check all parameters. It is possible that the necessary parameter has another name. Usually, adcX stands for analogue inputs, inX for digital inputs, outX for digital outputs. Some parameters can have prefixes like can_ (parameters for CAN bus).
3.
Some devices send sensor data in separate messages and not together with positional messages. In this case, you can either adjust device to send messages of this type or adjust a command in Wialon to query such messages from time to time.
4.
If you are sure the sensor is compatible with your device, connected properly, and sends data to Wialon, then write to [email protected] with the request to support your sensor, and attach the latest version of the communications protocol for your device.
482
Protocol for a New Device
Is there a recommended protocol for manufacturers of GPS devices?
Your program or hardware (device) will be supported in Wialon faster and more efficaciously if you use one of previously supported protocols. For new devices, we recommend Wialon IPS protocol.
483
Unable to Execute a Command
What to do if I cannot execute a command over a unit?
1.
Check user's access rights – the flag 'Execute commands' is required.
2.
Check if the command is written in unit properties (on the 'Commands' tab). In the properties of the command itself, see which rights are required for execution and check whether the user has such rights.
3.
If the command is executed through TCP or UDP, it is necessary that the unit was connected at the moment of execution. So, you need to wait when it connects.
4.
If the command is executed through GSM channel, the user is supposed to have rights to send SMS messages (the flag 'Can send SMS' in user properties + the appropriate service in billing plan) and a phone number in the international format should be present in unit properties.
It is also possible that commands for your type of device are not supported in Wialon. In this case, send a request to
with detailed description of those commands. See the list of standard commands .
484
Maps
Google and Yandex Addresses in Reports
Placing New Maps on Wialon Hosting
485
Google and Yandex Addresses in Reports
Is it possible to have address information form Google or Yandex maps in reports?
There is no such possibility. Only Gurtam Maps are located on our server. Google and Yandex Maps are located on exterior servers and can be used only for rendering (visualization). Getting data from exterior servers takes an excessively long time. Besides, such services do not allow making the number of requests necessary for report generation.
More about addresses in reports...
486
INGIT Maps
Is it possible to activate INGIT Maps for Wialon Hosting?
There is no such possibility. INGIT Maps can be connected only to a client program. They do not fit for the web as their images are not static which means they cannot be split into squares (tiles).
487
Placing New Maps on Wialon Hosting
What is the procedure to place a new map on Wialon Hosting?
Send your request with attached map to [email protected]. If the map is too big to be sent by e-mail, you will be given FTP access.
Supported map formats are: MP, MapInfo, ESRI Shape, OSM (OpenStreetMap). See the section
for details.
It is possible to place a map with classified access.
488
Wrong Addresses
What is to be done if incorrect addresses appear in reports or in search address tool?
As address information is taken form the map, a more accurate or modern map is required in such situations. You can send us such a map to [email protected]. Supported map formats are: MP, MapInfo, ESRI Shape, OSM
(OpenStreetMap). See the section
for details.
See also
Placing New Maps on Wialon Hosting
.
489
Other Questions
%ZONE% instead of Geofence Name
Cannot Remove Access to a Unit
Error 'Your browser does not support cookies'
Problem Logging In Because of a Supposed Attack
Tracks with 'Stars' at Parkings
Unit Disappear from the Monitoring List
Violations Are Not Registered
Wialon Hosting Design
490
%ZONE% instead of Geofence Name
My notifications come with the text like that:
Vehicle_001 left %ZONE%. At 2011-11-23 13:35:10 it moved with
speed 74 kph near 'Seaside Park Hotel, Leipzig'
. Why there is no geofence name?
The reason is that if you control exit from several
notification , it is impossible to detect which
geofence exactly was left. To have geofence name in such type of notification, you should create a separate notification for each of those geofences.
491
Cannot Remove Access to a Unit
I remove access to a unit from a user, however, this unit remains available to this user.
A possible explanation is that the unit is included in a group to which the user has some access.
492
Error 'Your browser does not support cookies'
Why do I get the error 'Apparently, your browser does not support cookies. Try again later'?
It is nothing critical. To login to the system, just press the Enter button once more.
493
Limit SMS Messages
How can I restrict the number of SMS messages that a user can send? For example, to 5 messages per day.
This limit can be set in CMS Manager. Go to the the
Services tab of the 'Account Properties' dialog.
494
Notifications about Thefts
How can I get notified about fuel thefts when they happen?
Perform the following steps:
1.
Create a
job with the type 'Send fuel information by e-mail or SMS'.
2.
Choose 'Theft' as event type and set method(s) of delivery (е-mail and/or SMS).
3.
Select units to be under control.
4.
Give the job a name and set execution schedule, e.g., once in 3 hours.
To receive SMS messages, a special service should be activated.
495
Problem Logging In Because of a Supposed Attack
I cannot log in to the system. The error is: 'Reported/suspected attack site!'
To enter the system, press 'Ignore this warning' below and continue.
Probably, attacks were noticed on the parent domain of your monitoring service and the parent site was added to the blacklist together with subordinated sites and pages.
Report this situation to administrator of your site and ask them to unblock it.
496
Tracks with 'Stars' at Parkings
The reason is a slight inaccuracy in coordinates sent by the tracker. It is absolutely normal for any type of equipment.
This inaccuracy is appreciable particularly at parkings. A unit stays still, however, the coordinates sent by the tracker slightly differ from each other. That is why 'stars' appear at the places of parkings.
You may want to get rid of those 'stars' to make the track look more intelligible. To weed off the stars at parkings, apply the
1.
When building a track in the Tracks panel or by quick track method, activate the checkbox 'Apply trip detector' in the Tracks panel.
2.
When getting a track through reports, in the report template choose 'Trip routes' (and not 'All messages on map') to apply the trip detector.
If you build a track in the Messages panel, the trip detector cannot be applied because that track shows all messages registered in unit's database.
Make sure that the trip detector is adjusted correctly. Additionally, you can activate the
message validity filter on the
Advanced tab of unit properties.
497
Download
Public link updated
The public link to your chat has been updated. You may view and manage your chat links after registration here.
Document public link
Advertisement
Key features
Unit tracking on map
Monitoring dynamic parameters
Unit and driver management
Route control with check points
Reporting and data analysis
Access rights management
Frequently asked questions
Wialon Hosting is a software product that allows end users to control their units (vehicle fleet, machinery, employees, pets, etc.).
You can track unit position, speed, fuel level, temperature, voltage, and more.
Yes, you can manage drivers, send them messages, and control their work shifts.
You can assign routes with check points and monitor unit movement along those routes.
Wialon Hosting provides various reports in the form of tables and charts to analyze the tracked data.
