Wialon Hosting User Guide

list of supported browsers above. The most efficient is Google Chrome. It is

System Requirements and Optimization

Consider these requirements to get the most from Wialon Hosting.

Web Browser

Supported browsers are:

Mozilla Firefox 12+

Opera 10.0+

Internet Explorer 8+

Google Chrome 2.0+

Table of Contents

To make its performance better, it is recommended to install Chrome Frame plugin that is compatible with Windows

7 / Vista / XP SP2.

If you use a browser not mentioned above, Wialon may function incorrectly.

Computer Capability

Computer capability affects browser operation. The key points of high performance are CPU (central processor) and

RAM capacity. Multi-core processors do not affect browser operation in most cases. The exception is Google Chrome

that can use more than one core in its operation.

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 is the monitor, the more data is

queried from server and processed by CPU. It is especially true about maps and when the Internet connection is low.

The solution for big monitors is to do 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 Speed

Wialon requires 1 MB Internet connection channel for one computer. If more than one operator will work simultaneously, do some tests and choose the most appropriate speed. If you use your own map server in your local network, then the Internet channel speed can be decreased twice.

If Wialon is installed in the local network, and operators work in it too, Internet speed is not important. It is enough to have a stable connection of 64 Kbs to receive data from units.

Optimization Measures

Here are some tips which will help you to improve Wialon performance in cases when more than a hundred units are

connected.

1. Web Browser

Web browser is very important. See the

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 monitoring system is rather dynamic and tracks changes 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 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 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 which are necessary for your work at

the moment. Several settings to adjust the way units are displayed are set in

user settings in the section 'Unit

visualization on map'.

Unit tooltip content is also important. In

user settings

in the section 'Show in unit info tip', you select which information should be presented in unit tooltip. To avoid browser overload, disable unusable items or even all items. If there a lot of geofences or geofences composed of lots of points and the option 'Presence in geofences' is enabled, it may overload browser very severely. So, make sure this option is disabled.

3. Queries to Server

When Wialon Hosting 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 are a hundred or more enclosed rows the browser may hang.

Management System

The management of GPS tracking system Wialon Hosting is fulfilled through a special interface – CMS Manager. It is specially designed for Wialon Hosting managers. CMS Manager allows you to manage your tracking service by means of system macro objects which are accounts, users, units, retranslators, and others.

For further information please see:

Management Procedure

Access Rights

CMS Interface

Accounts

Users

Units

Unit Groups

Retranslators

Import and Export

Activation of Modules

Cartography

Management Procedure

This topic depicts the process of creating a small GPS tracking service. All features are described briefly without details. For further information read other sections of this guide.

We recommend to follow this plan (the scheme is not the only possible but reliable):

1.

2.

Create and adjust accounts for clients.

3.

Create units and set access rights to them.

4.

Create accounts containing standard notifications, jobs and reports, and give clients view access to these accounts.

5.

Create other users as a client and give them access to the accounts and units of this client.

6.

Create other managers for managing the system together with you.

See more about standard rights...

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 apply to the system macro objects such as accounts (resources), units, users, units groups, and retranslators.

Table of Contents

Access rights are defined primarily by service manager in the management interface – CMS Manager. However, in some case it can be done by the 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 items and its basic properties

View detailed items properties

Manage access to this item

Delete item

Rename item

View customs fields

Manage custom fields

Edit not mentioned properties

Change icon

Query messages or reports

Edit ACL propagated items

Manage item log

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 include 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:

Route ACL

On the Access tab of every item, all rights are divided in two sections. The upper part displays standard rights, and it is the same for any object. The contents of the lower part depends on item type as it represents special rights.

Hierarchy

It is important to maintain the hierarchy when assigning rights:

The usercreator has all the rights on created item, and they can be limited only by the user of a higher

level.

It is impossible to give a user more rights on an item, than the creator of this user has toward this item.

If a user is allowed to define rights for other users, no more rights then this user has can be given.

Standard Rights (Item ACL)

There are 12 standard rights, i.e. such rights that every macro object has.

Type right of

Code Description

View item and its basic properties

0х1

Allows to see 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 rights 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 и e-mail).

View detailed item properties

0х2

Allows to view more properties of the item in question. It works only for units – i.e. the user can see, but not edit the tabs 'Trip Detection' and 'Fuel consumption', and the parameters for the reports and messages filtration settings are shown on the 'Advanced' tab.

Manage access to the item

0х4

Allows to transfer 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

Rename item

View custom fields

Manage custom fields

0х8 Allows deleting the item from the system.

0х10 Allows renaming the item.

0х20

0х40

The 'Custom Fields' tab becomes available for viewing in the item properties. So far as only units, groups and users have such a tab, this right and the next right do not affect other types of objects.

Allows to create, delete, and change custom fields in unit/group/user properties. This right is valid only together with the previous one.

Edit not mentioned properties

Change icon

0х80

Allows to edit 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.

0х100

Allows changing item's icon. It is valid only for units and unit groups, because other items do not have such features as an icon.

Query reports and messages

0х200

You can query messages and create reports for given item.

Units: it allows to view messages for the selected interval, query reports, build tracks in all modes.

User: the tab “Logs” provide access to viewing the user activity (logins, logouts) and advanced reports of users.

Resource: it allows to use the tab “Statistics” (history of payments).

Edit ACL propagated items

0х400 Only for unit groups.

Manage log

0х800 Allows to see item log in reports (or messages).

If a user has a right to see a unit's creator and account, its groups, assigned driver, etc., those rights can be fully sensible only if this user has also at least view access to those items (user-creator, account, group, driver)

Unit ACL

A user can obtain possibilities to see a unit on map, track its state (speed, sensor values, etc.), change its properties, executed commands, generate reports for units, use unit in jobs and notifications, and many other possibilities.

Standard access rights

were described above. Below is the list of special rights which can be applied specifically for units:

Edit connectivity settings

Create, edit, and delete sensors

Edit counters

Delete messages

Unit ACL

Allows see and edit device type, unique ID, phone number, device access password on the

'General' tab and messages filtration parameters on the 'Advanced' tab. Device type, phone, and

UID appear also in unit info tip. If SMS service is activated, then the user can also send SMS messages to this unit.

Sensors and their value 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.

Allows to change values of the counters (GPRS traffic, mileage, engine hours) and methods of their operation.

Allows deleting data messages, messages about sent commands, and registered events in the

Messages panel. It also allows to delete 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).

Register events

Allows 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. If the flag 'Manage log' is enabled, user can also add a record to unit log.

View service intervals

Create, edit, and delete service intervals

Import messages

Export messages

View commands

Create, edit, and delete commands

Edit trip detector and fuel consumption

Use unit in jobs, notifications, routes, retranslators

Allows to view the 'Service Intervals' tab in unit properties dialog as well as in unit info tip.

Allows to edit and delete service intervals as well as create new. Works only in combination with the previous flag.

Allows importing messages to 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'.

Enables the 'Commands' tab in unit properties.

Allows to create, edit, and delete command on that tab. Works only in combination with the previous flag.

Allows editing the corresponding tabs in unit properties. Works only in combination with 'View detailed item properties'.

Allows to create jobs and notifications for this unit, assign it to routes, and use it in retranslation.

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 (note that calculation tables remain hidden); on the 'Unit Groups' tab – list of groups where unit belongs (if those groups are accessible). Information about unit current state can be seen in unit info tip: last messages 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 allows also to control unit groups, e.i. 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 and neither is report execution.

Edit not mentioned properties

These properties are color schemes for sensors and tracks on the 'Advanced'.

Query messages or reports

Allows to view messages for the selected interval (except the log), query reports (except the tables 'Log' and 'Custom fields' which require additional rights), and build tracks in all modes.

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 'Register events' is enabled).

Other standard access rights ('Manage access to this item', 'Delete item', 'Rename item', 'View custom fields', 'Manage custom fields', 'Change icon') work as has been described above. The flag 'Edit ACL propagated items' does not affect units at all.

Unit Group ACL

The set of rights for unit groups is the same as for individual units. Access given on a group is applied to units which belong to it. For example, if the right to view commands is given to a user, this means this user will be able to see commands of each unit in the group. Besides, some access rights can affect not only units in the group but the group itself. For example, if the right to change icon is given to a user, this means 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

Change icon

Query reports or messages

Manage item log

The flag Edit ACL propagated items is a right which allows to add and remove units from the group.

The rest of access rights affect only units. See

Unit ACL for details.

User ACL

Users are system objects, so access can be given not only to them but on them. In other words, user can be both a subject and an object of ACL relations. If User A has access to user B, it means User A can see User B in the system, view and edit its properties and individual settings, control its activity in the system, etc.

Table of Contents

User ACL

Standard Rights

Special Rights

Standard Rights

Some of 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 и 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, and there access to this user 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.

Most of those reports ('Logins', 'Custom fields', charts) come as a part of Advanced reports package

(however, to query the 'Custom fields' table one needs to have access to custom fields of this user, too).

And one more report – 'Log' – can be executed in case one has 'Manage item log' right in addition.

Standard flags Delete item, Rename item, View custom fields, Edit custom fields, Manage item log 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 user

Right to log in to the system as given user, make this user creator of system objects, etc.

Change flags for given user

Allows to change properties on the 'General' tab of the User Properties dialog. However, changing password requires also the previous right.

resources/accounts as described above

Resource ACL

Access to a resource means access to its contents such as POIs, 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 Hosting.

Table of Contents

Resource ACL

Standard Rights

Special Rights

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

The tabs 'Payment', 'Features' and 'Account' appear in the Account Properties dialog, where you can see account's balance, available services and their cost. 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 to delete 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 user also 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, Manage item log work for

Such flags as 'View custom fields', 'Edit custom fields', '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 POIs

Allows to view POIs belonging to this resource.

Create, edit, and delete

POIs

View geofences

Allows to edit and delete POIs belonging to this resource as well as create new.

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

Create, edit, and delete jobs

Allows to view jobs belonging to this resource.

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 notifications

Allows to edit and delete notifications belonging to this resource as well as create new.

View drivers Allows to view drivers belonging to this resource.

Create, edit, and delete drivers

View driver groups

Allows to edit and delete drivers belonging to this resource as well as create new.

Allows to view driver groups belonging to this resource.

Create, edit, and delete driver groups

Allows to edit and delete driver groups belonging to this resource as well as create new ones.

View drivers-units association list

Allows to view the list of units attached to this resource of drivers and intended for automatic binding

(the Units button in the Drivers panel).

Edit driversunits association list

View trailers

Allows to create and edit this list from available units.

Allows to view trailers belonging to this resource.

Create, edit, and delete trailers

View trailer groups

Allows to edit and delete trailers belonging to this resource as well as create new.

Allows to view trailer groups belonging to this resource.

Create, edit, and delete trailer groups

Allows to edit and delete trailer groups belonging to this resource as well as create new ones.

View trailersunits association list

Allows to view the list of units attached to this resource of trailers and intended for automatic binding

(the Units button in the Trailers panel).

Edit trailersunits association list

Allows to create and edit this list from available units.

View report templates

Create, edit, and delete report

Allows to view report templates belonging to this resource.

Allows to edit and delete report templates belonging to this resource as well as create new.

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 payment and days (the 'Payment' tab), number and cost of services (the 'Features' tab).

Note.

In the main Wialon interface, only manipulations with inner resource contents is possible (i.e. geofences, notifications, report templates, drivers, etc.), including the possibility to see the log of changes concerning this contents. Actions concerning accounts (such as payment control, tariffing, etc.) can be performed only in CMS Manager.

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. But 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 ids given.

users (only those on which you the the right 'Manage user's access rights'). Users

Access Dialog

To manage access to system objects, you are required to have the flag Manage access to this item on these objects and the flag Manage user's access rights on 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 see the list of

already having some access to the item are highlighted with green background and displayed on the top of the list.

If you have less than 100 users, the full list of available users is displayed when you open the tab. If you have more than 100 users, the list is empty and you will need to apply the

filter to search and display users. Enter user's name or

its part and press <enter> or 'Apply'. Search results will be displayed.

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.

To set rights, select a user at the left and assign access right at the right. Several users can be selected at once – use

<shift> and <ctrl> keys for that.

Rights are divided into two sections – standard (see

Item ACL ) and special (lower part). Special rights differ according

to item type:

Unit ACL

User ACL

Resource ACL

Route ACL

Some principles to bear in mind when assigning access:

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.

When finished,press OK to apply new rights.

Attention!

Establishing access to users as system objects is a bit different from other objects. It is described

here

Hint.

User's access to units can be changed not only manually but also automatically – through some types of

jobs and

notifications .

is situated at the top of the window. It shows your login, current time, and some buttons

CMS Interface

CMS interface is simple and in many cases intuitive 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

(Logout,

Settings ,

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: accounts

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.

Settings button to configure some CMS settings;

Top Panel

In the top panel of CMS Manager you can find the following features: login you have used to enter the management system

(another login can be displayed in brackets if the main user is acting as another user); current time (time zone in brackets); the Logout button to exit or reenter;

Import/Export button to store and copy different items and their properties;

language bar to select Russian or English as interface language; a link to Help (optional).

In the top panel several warning messages pop up. If the time became red, it means there has been no connection to the server during the last two minutes. This can happen by a number of reasons, e.g. the Internet connection is broken or some trouble has happened to the server. In case connection is restored, the warning will disappear automatically and the system will continue its work. If there has been no connection for more than 5 minutes, the session is terminated. However, after restoring the connection, the login page will be loaded automatically. At this, if the flag

'Remember on this computer' is enabled, the auto login to the system will be performed, too.

Warning about days left are displayed on the top panel as well. It may look like this:

Besides, in the top panel you can receive

notices from your service administrator.

More about filters and masks...

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

results panel .

Navigation

In the navigation panel there are five tabs. Each of then represents some system object:

Accounts, 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.

Table of Contents

Search

To search objects:

1.

Specify a filter;

2.

Form a request in the Text field;

3.

Push the Search button or <enter>;

4.

Observe the found objects in the

results panel

on the right.

Note.

To simply find all objects of some kind (for example, all users), leave the Text field empty (or with just a single asterisk) and press <enter>.

Search Filter

In the Filter combo box select the search criteria. It can be:

Name: the name given to the object when it was created;

Creator: the

creator of the object.

Account: account to which required object is attached (that is the object is created by account's creator or by a user which is created by account's creator).

If you are searching for units, except these filters some additional filters are available:

Unique ID: unique identification number given to a unit when creating it;

Phone number: the phone number of a SIM card if one is embedded to equipment;

Device type: equipment type/name;

Unit group: a group where a unit is included;

Custom fields: custom fields assigned when configuring the unit.

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 which represents any combination of characters. The asterisk can be placed at the beginning, at the middle or at the end of the request text. It can be used even several times. For example, to find all MANs, select search by name, type man in the Text field, and push the Find button (or <enter>). All units which names contain this combination of characters (both at the beginning and at the end of the name) will be found and displayed.

Another wildcard character which can be used is the question sigh (?). It replaces any single character. As well as the asterisk sigh, it can be put at any place of the query.

navigation and search panel changes, too.

Results Panel

The results panel is located at the right top part of the window. Here the results of displayed.

search are

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, retranslator, or unit groups.

Besides, when switching tabs, if they represent different item types, the

Table of Contents

You actions (such as search) are applied always to an active tab. If this tab contains already any records, they will be replaced.

Managing Tables

The data is given in the form of a table. Records are sorted by name in the direct order that is from A to Z.

For different type of objects, table contents are also different. The most columns are provided for units.

The set of columns is adjustable. To customize it, click on the table header and check needed items (or vice versa unselect some items to hide them).

At the bottom of the table there is tools panel that is useful to perform several tasks such as delete objects, move to another page, etc.

Columns width can be adjusted manually. To do this, click on a column edge and holding the left mouse button drag it to the needed direction. To restore auto width, push Columns auto width button.

Adjust the number of rows to be displayed on one page (10, 50, 100, 500, 1000 are available).

To navigate between pages, use the corresponding arrow -shaped buttons. It is also possible to enter page number manually and press <enter> to move to an indicated page.

Standard Operations

A number of standard actions can be performed over any object displayed in the table ( account

): create a new object of this kind, 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 Input Rules

for details.

A newly created object will not be displayed in the table until you apply some

search parameters.

Copying

Copying is a quick way to create new objects having similar properties with existent objects. Accounts and retranslators cannot be copied.

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 fully identical to the properties of the object being copied will open (at least, those properties which can be shown according to your

access level ). You can alter any properties if needed (especially unique information like

name, phone number, etc.). Press OK to complete creation.

In many situations, instead of copying you can use

Import/Export

tool.

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

access to the item, OK button is not available and you cannot save any changes. Besides, some properties

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 Delete column. Then push the button Delete checked items at the bottom of the table. When getting a warning message, confirm your intentions or cancel the action. Several items can be

selected, too. The result of the action is displayed in the log .

Remember that a certain

right is needed to delete items ('Delete items'). Items which 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.

If a user is deleted, all items created by this user are deleted, too. However, before it happens, you will get the alert.

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.

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 which is in the right top corner of the log panel.

top panel . Here you can customize some

CMS Settings

To view and change CMS settings, click on the Settings button on the

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.

CMS settings are a reduced version of the User Settings

dialog.

objects. This contents can be easily saved to a file or copied to another resource (see Import and Export

Accounts

In most cases, resource and account can be used as synonymic notions, however sometimes it is needed to understand the difference between them.

Resource is a system macro object which includes different micro objects as its contents i.e.

, and

. Availability of a resource gives user opportunity to create such

A resource becomes an account or rather a part of an account in case a separate billing plan was activated while creating this resource. In most cases the names of an account, associated resource, and their creator is the same name.

More than one resource (or even dependent accounts) can be connected to an account. The point is that an account can hold not only a resource and its contents (micro objects mentioned above) but also information about other macro objects as

units ,

users ,

unit groups

routes as well as other dependent resources and accounts.

The count of both macro and micro objects is done in the account and money are written off for their use. A billing plan is applied to an account and not to a user. So, Wialon Hosting manager uses account to limit users' activity, define number and cost of available services, control payment, etc.

Creator is a crucial part of an account. Micro objects are classified to an account by their resource, but macro objects

reveal their belonging to an account through their creator. All macro objects created by the same user who is a creator of an account (or by other users whose creator is this user) are automatically attached to this account.

An account is usually created for each client individually, however a number of users can exist within one account and have different

rights and access to units. For instance, we can create an account Vehicle Fleet 666 with users Boss,

Accountant, Machinist, Manager, etc., and each of these users will use Wialon in their own way.

All dependent macro and micro objects are deleted together with their account.

results panel and continue working with them (edit, register payment, delete, etc.),

Working with Accounts

Working with Accounts

Working with accounts is possible only in the management interface that is CMS Manager. Open the Accounts panel in

the navigation panel

. Here you can:

create new accounts;

find and display existent accounts; control clients' balance, add

payment and days;

allow/deny/limit access to different

services (features);

edit and

delete

accounts.

To view created accounts in the

apply some

search parameters. In the

table of results you see accounts'/resources' names,

creators (if available),

buttons to delete them, and the column to see or change account's status (Active/Blocked). Only accounts can be activated and blocked, not resources. Besides, accounts and resources differ by the way on deleting them.

Import and Export for details.

Click on any account/resource in the table to see its properties. Depending on your access, certain tabs and fields of the dialog can be hidden or unavailable for editing. The Account Properties dialog can contain up to 6 tabs

(however, resources can have only 2). By default, only the General tab is available. There you can change only account's/resource's name and see its parent account and creator. On the Payment, Statistics, Features, and Account tabs you can control payment, add days, define services availability, etc. (see

Payment Control and

Features for

details).

Besides, it is possible to store resource contents in a file or copy elements from one resource to another. See

Accounts can be created and deleted only by service manager. To create a new account, press the Create Account

Creating Accounts

button. Fill in the given fields and press OK. If this button is not active, it means you have no rights to create system objects.

Account name

Give the account its unique name from 4 to 50 characters. In the system there can be no accounts with the same names.

Creator

As a

creator

of the account an existent

user can be selected or a new user can be created together with the account.

New user: a new user will be created and assigned as account's creator. You have to give it login and password. By default, it is offered to give it the same login as the name of the account, but you can enter different name.

Existent user: in the dropdown list choose a user from available.

Activate separate billing

If activated, a separate billing plan can be assigned to this account (select billing plan from the dropdown list). If not activated, an account with the same billing plan as yours will be created, so a user with the same possibilities as yours will be created. Note. If you have no other billing plan except your own, separate billing cannot be used. Billing plans are developed by Wialon Hosting administrator, and you can be given access to these plans.

If all fields are filled in correctly, the OK button becomes active. Push the button to save the account. See the result in

the log .

As the result, a new account (or resource) is created or both account and user are created. Resource is created in case if an account is created as an existent user and separate billing is not activated.

By default, the user indicated while creating the account is assigned to be its creator. However, manage access to the account are given both to this user and the manager who created the account. If a user was created together with account, this user receives manage

access to account and edit access to user itself. The creator of such a user then is

the manager who has created it.

account properties dialog on the

Payment Control

In the

Payment and

Statistics

tabs, you can view account balance, add payment and days, etc.

Payment

Table of Contents

Payment Control

Payment

Statistics

To change billing plan , select one from the dropdown list of available plans. If billing plan is none, it means this account will use your own billing plan. In the next field you see the current balance of the account.

The flag Blocked shows whether the account is active or disabled at the moment. If a critical level of balance/days is reached, the account is blocked automatically. When a payment is made for such a blocked account, you can remove the Blocked flag manually to quickly return the account to life (although it would be done for you automatically anyway but a little bit later). This flag can be also used to block the account manually, however note that it will work correctly only if the level of balance/days is zero or negative. The state of this flag can be changed without opening the Account

Properties dialog – straight from the list of accounts (see the last column).

Activate Dealer rights flag to create a subdealer. It means this account will possess the same rights as you (access to modules, services, billing plans). Then choose billing plans which will be available to this account. In the next field you can see the days left (if this option is activated).

Below you can register a payment. To register a payment, enter sum and description (description required). The sum will be added to the current balance, and the payment will be saves in payment history (see Statistics tab).

Optionally you can activate minimum days counter . In this case the account can be blocked automatically not only when the balance is 0, but also if there are no days left. It can be useful for demo access, for example, or to control monthly fee. To operate days, first activate the option Minimum days counter and apply changes by pressing OK.

Then open the dialog again, and you will find new fields there. Days left will appear above in the same section with the current balance. There you see how much days has left until zero days. Days are counted down automatically when a new day comes. When 5 days are left, a special warning starts to come each time when the user logs in to the system: Your account will be disabled in .. days. When days are negative, this notification is not shown.

In the field Minimum days counter indicate the number of days to block the account (if nothing is indicated, zero is assumed). However, you can enter another number, usually negative (like -3). In this case, the account will be still available several days even when the term is expired.

Days are added in the same way as payment. Indicate the needed number of days in Add days field or choose the final day in the calendar. Then enter description and press Register. Days and money can be added simultaneously in

the same payment or separately from each other.

Note.

If you have not enough rights to view the Payment tab, then the current balance, days left, and billing plan can be viewed (but not altered) on the

Account tab.

Statistics

On the Statistics you can estimate services expenses for indicated period of time (payment history). Define time interval and press Show. All registered payments will appear in the table regardless whether money or days were added.

account properties dialog allows to manage the number of available units,

Features

The Features tab in

SMS, geofences and other system objects, as well as enable or disable access to different services (such as retranslator, Wialon Mobile, jobs, and many others) and define their costs.

On this tab you see the list of services available according to chosen billing plan.

Table of Contents

On the left you see

service name, in the middle you indicate limitations and cost, on the right you see current state of

the service.

List of Services

Here is the full list of services available in Wialon system. Your Features tab may contain not all of them.

Service Description

Advanced reports

Commands

The possibility to use advanced reports i.e. reports unit groups, users, drivers, trailers as well as groups of drivers and trailers (except 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.

Development tools

Remote access to the system via SDK, ActiveX.

Drivers

Е-mail

Activates Drivers module and defines cost and quantity of drivers; if disabled, the Drivers panel in 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 (to not

notifications to overload the server).

Е-mail reports

The possibility to send a report by e -mail (within the Jobs module). Recommended limitation – 10 reports in an hour (to avoid server overload).

Geofences

Activates Geofences module and defines cost and quantity of geofences; if disabled, the Geofences panel in 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 trailers

Defines quantity and cost of trailers; 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.

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.

POIs Activates the POI panel and defines cost and allowed quantity of POIs.

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

Sensors

SMS messages

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.

Defines the count of sensors (calculated for all units in overall) and their cost.

Count and cost of SMS messages.

Trailers Activates the Trailers panel and defines cost and quantity of trailers.

Unit groups Activates the corresponding panel and defines cost and quantity of unit groups.

Units

Users

Wialon

Mobile

Activates the corresponding panel and defines cost and quantity of units.

Activates the corresponding panel and defines cost and quantity of users.

The possibility to track unit from a mobile phone.

Limitations and Cost

In the central column you define service state and enter limitations. Check services to make the available to this account or unselect services to deny access to them. This flag has three states: on, off and default. If the state is on, you can enter quantitative restriction manually, for example, allow only 10 geofences to be created for this account.

Besides, you can specify more sophisticated limitations different cost for different number of items. Cost line is set in the format: COUNTER1:VALUE1;COUNTER2:VALUE2;VALUE3. A counter must be positive and integer (however, values can be fractional). Each next counter must be greater than the previous one. -1 means that the service is prohibited.

Here are some examples of cost lines:

Service Cost line

SMS messages

1:0;10:1.5;-1

Interpretation

The 1st SMS is free, from 2nd to 10th the cost for one SMS is 1.5 charge units. The

11th SMS is denied.

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

In the right column you see the current state of the service (enables/disabled) and, if the state is default, the description of default conditions is given in the brackets.

Note.

If you have not enough rights to view the Features tab, then available services can be viewed (but not altered) on the

Account

tab.

Account

On the Account tab the chosen billing plan and account balance are indicated, and the list of available features is presented. If a service is periodic (limited number of items in an interval), the interval is indicated. For example, 10

SMS messages in one day (daily).

Note.

The information presented on this tab is available to the end user in the User Settings dialog .

, you need to have manage access

Deleting Accounts

To delete an

account

to it. In most cases, you may need to delete an account when account service agreement is broken.

To delete an account, press delete contents and then confirm your intentions.

When deleting an account, all its contents (geofences, drivers, etc.) is deleted, too.

Besides, all users, units, unit groups, resources are deleted, too, if they are created

as account's creator or other users which were created as account's creator.

There can be resources among accounts. Resources are deleted by standard method

units (end users) or manage the system itself (users-managers).

Users

User is a system macro object defined by its specific name (login) and password. Using these login and password users can enter such or such Wialon Hosting interface where they can control their

Table of Contents

Users

Working with

Users

A user has

access rights to interact with other system objects (units, other users, resources, etc.). These rights are

assigned by a system manager. Besides, a user can be a

creator of these objects, which also affects right hierarchy.

Manager's duty is to properly build this hierarchy.

Users as system objects also have some specific applications in Wialon Hosting main interface which is described

below (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 and a filter to search existent users. To see all available users and continue working with them, set and apply some

search parameters. Observe results in a

table on the right. There you can see

users' names, creators (if available) and buttons to delete users.

From this panel, you can login to the system as different user (access flag 'Act as given user' is required). To so 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 (it goes before brackets, in bold).

informational notice

can be sent to your users from this panel.

Standard operations with objects (create, view, edit, copy, delete) were described below. Note that users can be

created independently or together with an

account or resource .

User properties are configured when creating, editing or copying a user. The properties are

User Properties

divided into several tabs. Availability of different tabs and parameters depends on

access you

have to the unit. Two tabs are available in any case – General and Advanced.

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.

Table of Contents

Name

User name (login) from 4 characters.

Password

Password is optional but recommended. When you set a password, you are asked to input it twice – second time is for confirmation.

These login and password will be used by this user to enter the system.

Host mask

Host mask can be applied to user to restrict IP addresses from which to enter service sites. For example, to allow user to login to sites from office only. To set a mask, use the wildcard character *, for example, host mask can be set like this: '212.0.13.*'. If no mask is set, the user can login from any computer.

Creator

Select creator from the dropdown list. User's

creator can be any other user. Creator is important to build hierarchy of

access rights. A user inherits account and billing plan from the creator.

Account

Here you can see to which account the user belongs (if you have any access to this account). Account and creator cannot be changed.

Can create objects

This checkbox defines if user can or cannot create units, users, accounts, resources, unit groups, and retranslators.

Enabled

If disabled, user cannot login to any interface of the system.

Can change password

If disabled, user cannot change their password used for login action.

Can change settings

If disabled, user cannot change their own settings (see User Settings

), however can see them.

Can send SMS

If disabled, user cannot

send SMS messages

to drivers, units, and other users from Wialon Hosting main interface.

SMS buttons will be then hidden.

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:

users.

On the left choose objects type in the dropdown list. To quickly find a needed object, you can additionally enter its name mask and press Apply. Objects that meet your request will be displayed below. Green background appears under 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 itself is a system object and therefor can be accessed by other users. In other words, other users can obtain access rights to this user. To set access to this user, open the properties dialog of some other user and choose Users in the filter.

More about access rights...

Advanced

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

User Settings dialog.

To edit those properties, the access flag Edit not mentioned properties is required.

Custom Fields

Access required: View custom fields – to see the tab; Manage custom fields – to edit or delete existing fields as well as create new ones.

Any kind of information can be added to users account using custom fields. This can be private phone, home address,

post, experience, working shift, and so on.

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 of time. Specify the period and push Show.

Note.

Except the log, user's activity can be controlled through different reports which are available in Wialon Hosting user

interface. More...

Notices are shown in the top panel when the user logs in. See an example

Notices to Users

You can send an informing notice to users of the system. To do this, press the button Send a Notice in the Users panel. This will summon a dialog where you input a subject for your messages, add text of any length, choose users to send the notice to and decide upon life span of your message. When finished, press OK.

To send such notices to users, you are required to have the access 'Edit not mentioned properties' to those users.

Besides, their accounts should be active (not blocked) and they should have the service 'Notices to users' activated in their billing plans. Otherwise those users are not shown in the list of supposed recipients.

. Expiration period (from 1 hour to 23 hours) 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.

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.

Table of Contents

navigation panel . Units configured here become available for

Dialog

Working with units is possible both in CMS Manager and in the main Wialon Hosting interface. To work with units in

CMS Manager, open the Units tab in the

tracking (watch

on the map, control different parameters, etc.).

Here you can create a new unit, observe existent units, view or edit their properties, define access rights to units, and

remove units from the system. Read Standard operations for details.

Unit Properties Dialog

Unit properties dialog is displayed when you create, edit or copy a unit. It contains many tabs and fields that define different unit parameters and how the program will interpret data received from this unit.

The number of tabs can vary depending on your access rights

(max – 11).

Use the following links to get to know the details about each parameter:

Sensors

Sensor Properties

Sensor Types

Sensor Parameter

Validation of Sensors

Calculation Table

Calculation Table Wizard

Sensors

On the Sensors tab of

parameter , and custom description.

dialog, sensors connected to equipment are added and configured as well as edited and removed.

On the the list of available sensors you see sensor name,

type , metrics,

To create a new sensor push Add a New Sensor button, fill in the fields and press OK. If you use similar devices for different units, it is convenient to configure sensors once, and then

import them to other units.

To quickly create a sensor with similar settings, select this sensor and press Clone Sensor. To edit an existing sensor or just view its settings, select this sensor and press Modify Sensor. To delete a sensor, select this sensor and press

Delete Sensor.

To make any alterations on this tab, you need access right Create, edit, and delete sensors.

There is the Visible checkbox against each sensor. It controls whether sensor is shown or hidden. By default, the chackbox 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.

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 info tip, 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.

Parameters come in messages. If the unit already has messages, parameter name can be picked up from the list of

Sensor Properties

When creating, editing or copying a sensor, an additional dialog with sensor properties is displayed. It consist of several tabs. On the first one, the basic properties are adjusted:

Name

Give a name to the sensor. It must consist of one or more characters. The name will be visible in unit info tip, in reports and messages.

Sensor type

Choose the

sensor type

form the dropdown list of available types.

Metrics

As a rule, possible metrics (unit of measure) is given. However, in some cases you can key in your own. This is especially 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.

Description

This field is optional. Add any description and options if needed.

Validator and Validation type

This is optional.

Validation defines dependency of sensors from each other.

Redefine filter quality

This property is specific for fuel level sensors. Filtration degree is adjusted traditionally on the «

Fuel Consumption

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

Then you have to set calculation table for the sensor. It is especially needed for analogue sensors. Not all sensors send ready values that can be put into a report and be intelligible to any user. If the possibility to transform parameters is not provided with device itself, this transformation is adjusted with special

Calculation Table

Wizard .

There are many types of sensors. When configuring a sensor (see sensor properties

Sensor Types

), the choice of sensor type depends on used device and its principle of operation.

Sensor type Metrics Description

Impulse fuel consumption sensor

Absolute fuel consumption sensor

Instant fuel consumption sensor

Fuel level sensor

Fuel level impulse sensor

liters (lt) liters (lt) liters (lt)

The sensor shows fuel consumption over a period of time and presents this data number of impulses. Such sensors usually have a limit after which they are zeroed. The calculation table must be compiled to make it possible to convert impulses to liters. The sensor is used to control fuel consumption when the

calculation method is 'Impulse fuel consumption sensor' .

The sensor detects fuel consumption over all period of vehicle operation. The sensor is used to control fuel consumption when the

consumption sensor' .

calculation method is 'Absolute fuel

The sensor shows fuel consumed from the previous measure (message). The sensor is used to control fuel consumption when the

calculation method is 'Instant fuel consumption sensor'.

This sensor is placed in the tank. The sensor is used to control fuel consumption when the

calculation method is 'Fuel level sensor'

. See some examples

of its configuration.

The sensor detects the number of impulses in a period of time. Fuel level in the tank is calculated from receives values.

Temperature sensor

Celsius degrees

(°C)

The sensor showing some parameter value (not necessary temperature). It can be used to analyze input data. See an

example of configuration.

Temperature coefficient

Temperature coefficient which affects fuel level calculations at different temperature in the tank.

Engine revs sensor

rounds per minute

(rpm)

The sensor displays engine speed.

Engine ignition sensor

Voltage sensor

Custom digital sensor

Custom sensor

Mileage sensor

Relative odometer

On/Off volts

(V)

On/Off

This is engine operation sensor that is used in the

trips/stays detection and

counters . See an

example

report on engine hours

of configuration.

as well as in

The sensor showing some parameter value (not necessary voltage). It can be used to analyze input data.

This sensor can register two states. Its values can be displayed in unit info tip or sent to report.

any

This is a custom sensor for which you can set any unit of measure. Its values can be displayed in unit info tip or sent to report.

kilometers

(km) or miles (mi)

The sensor showing the distance travelled. It can be used to detect trips and stays.

kilometers

(km) or miles (mi)

The sensor shows the distance travelled since the previous message. It can be used to detect trips and stays.

Engine efficiency sensor

Absolute

on/off hours

Defines whether attached implements is operating. Shows the time of work between switchings of states (from 1 to 1 or 0).

The sensor registers the total amount of engine hours.

engine hours

Relative engine hours

Counter sensor

Accelerometer

hours The sensor registers the amount of engine hours subject to intensity of work.

any

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 metrics for this sensor (used in reports).

This types of sensor is used to measure acceleration at X, Y, Z axes and immediately detect a collision of cars.

Parameter is a required sensor property

Sensor Parameter

. Most of sensors are based on a parameter coming in messages. If the configured unit already has any messages, it is recommended to explore them and find available parameters (go to the

Messages Mode ).

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.

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 lon time

geographical latitude geographical longitude time in message

Note.

Some rare devices may not support all of the parameters mentioned above, e.g. altitude or speed.

Table of Contents

Detecting Speed by GPS

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 which registers the values coming form 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 something 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

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 which always returns the same value. N is any number, e.g. const10, const-8.5. Such a sensor can be helpful in charts or as a validator.

Such a sensor can be used both independently (for example, in charts

to mark some critical line) or as a part of

validation chain or in

expressions .

Expressions

Parameter for a sensor can be set in the form of expression. In those expression 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.

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 other metrics), we apply a special coefficient. It varies depending on geographical position. In the example above it is equal to 200000 and applicable to Moscow.

If you have the ignition sensor, the parameter can be set like this:

((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 which will define the intensity of work depending on engine revolutions.

Dependency scheme can be like this:

500 rpm correspond to 90 seconds of engine work coefficient 1,5

1000 rpm correspond to 60 seconds of engine work coefficient 1

1500 rpm correspond to 40 seconds of engine work coefficient 0.67

2000 rpm correspond to 20 seconds of engine work coefficient 0.33

Let's 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=1,5 x=1000 y=1 x=1500 y=0.67

x=2000 y=0.33

Do not forget to set the relative engine hours sensor as the counter of engine hours (the General

tab).

Textual Parameters

Most parameters are designed to sent 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 id displayed as it is. However, the application of text-based sensors is limited – their values can ba shown only in unit info tip and in

unit info tip and in

messages panel .

Advanced Properties ) so that these colors could be used

Validation of Sensors

Validation defines dependency of sensors from each other. It is adjusted in

sensor properties

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.

Table of Contents

Validation of

Sensors

Example

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.

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.

Example

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's 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

to visualize sensor in the Monitoring panel, on the map or in tacks.

Calculation table is very important in sensors configuration (see sensor properties ). According

Calculation Table

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.

However, in some cases calculation table is not needed. It is especially true for digital sensors which 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.

Table of Contents

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

If you use a coefficient and want to take into account the previous segment for Y -axial displacement, enable the

Continue last segment flag.

It is possible to get the tangent of angle (that is needed to be substituted for a coefficient) using mathematics. To do this, find on X and Y axes segments of values operation (deltas). Then divide the values ∆y/∆x. The result value is the tangent of angle.

Lower and upper bounds may be useful to set limits for input values. If some X value is out of range, it is treated

as invalid. If you use a lower bound, the first X value in the calculation table should be bigger than or equal to the lower bound value (and desirably very close to this value). The upper bound should be greater than or equal to the last

X value in the calculation table.

After entering each pair of value, press Add. Incorrect pairs can be removed with the button . To remove all pairs at once, click on the Clear Tale button.

The graphic implementation of the created calculation table can be viewed in the Calculation Chart tab. Push the

Refresh button to build the chart on the basis of your calculation table.

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. At that, Continue last segment option should be disabled.

This method is convenient if converting a analogue signal to a digital.

3.

Enable Continue last segment option and fill in only X and a values. In this case b is calculated automatically. This method is convenient if needed to get a curve knowing the angles.

4.

In many cases it is possible to adjust the calculation table knowing input X values and corresponding output Y values. In these cases use

Calculation Table Wizard .

Example 1: Temperature Sensor

As an example, let’s create a calculation table for temperature sensor. Let's assume that the data is coming in complement code. So, the positive values are form 0 to 127, and negative from 128 (which corresponds to -127 degrees) to 255 (which corresponds to -1 degree).

Move to the Calculation Chart tab to estimate the result (press Refresh).

Note.

The function continue operating to infinity if there is no limitations. The chart extends also to the left to minus infinity. If there are limitations, the chart expands quarter-size to both sides right and left.

Example 2: Engine Ignition Sensor

It is possible to configure non -digital ignition sensor on the basis of a parameter of voltage. For instance, the voltage up to 0.5 V would mean 'ignition off', and over 0.5 V — 'ignition on'. For such a sensor we should create a calculation table like this one:

Move to the Calculation Chart and see if the result meets your expectations (press Refresh).

sensor is less complicated. Here it is enough to

Calculation Table Wizard

This way of creating a calculation table for a

enter input X values and corresponding output Y values. You can use the calculation table wizard when calibrating a sensor by practical consideration. For instance, you pour different volumes of fuel into the tank and each time take the readings from sensor.

Table of Contents

After entering each pair of values, push the Add button. Incorrect pairs can be deleted with button. When all pairs are entered, press Generate calculation table. The

calculation table on the previous tab will be replaced with new data.

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.

When reopening the dialog, all data entered on this tab is preserved. However, note that if any changes were made on the Calculation Table tab, they will not affect the Calculation Table Wizard. In other words, the Calculation Table

Wizard displays only values you entered but not always reflects the real situation.

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

173

252

330

405

477

546

618

686

749

812

874

100

110

120

930

989

1019

130

140

150

These pairs of values should be inserted into calculation table wizard:

Then press Generate Calculation Table and go to the Calculation Table tab. Initially, generated values are given with maximum decimal digits, but after you save changes and reopen the dialog they will be displayed up to 6 decimal places.

Then go to the Calculation Chart tab and press Refresh:

Note.

Wizard displays only values you entered but not always reflects the real situation.

Now let's 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

N a b

X Y (Y

(i+1)

— Y

(i)

) / (X

(i+1)

— X

(i)

) Y — a × X

1 0 0 (10 — 0) / (86 — 0) 0 — a×0

86 10

173 20

252 30

330 40

405 50

477 60

546 70

618 80

(20 — 10) / (173 — 86)

(30 — 20) / (252 — 173)

(40 — 30) / (330 — 252)

(50 — 40) / (405 — 330)

(60 — 50) / (477 — 405)

(70 — 60) / (546 — 477)

(80 — 70) / (618 — 546)

(90 — 80) / (686 — 618)

10 — a×86

20 — a×173

30 — a×252

40 — a×330

50 — a×405

60 — a×477

70 — a×546

80 — a×618

686 90

749 100

812 110

874 120

(100 — 90) / (749 — 686)

(110 — 100) / (812 — 749)

(120 — 110) / (874 — 812)

(130 — 120) / (930 — 874)

90 — a×686

100 — a×749

110 — a×812

120 — a×874

930 130 (140 — 130) / (989 — 930) 130 — a×930

989 140 (150 — 140) / (1019 — 989) 140 — a×989

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)

1,65

1,3

1,25

1,1

2,8

2,58

2,18

2,0

0,96

0,6

0,32

100

Insert these data into the wizard, generate the calculation table and get the calculation chart.

Calculated intervals for this sensor is as follows:

Interval X Y

N a b

X Y (Y

(i+1)

— Y

(i)

) / (X

(i+1)

— X

(i)

) Y — a × X

1 0,32 100 (90 — 100) / (0,6 — 0,32) 100 — a×0,32

0,6 90

0,96 80

1,1 70

1,25 60

1,3 50

1,65 40

2,0 30

2,18 20

2,58 10

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

(30 — 40) / (2,0 — 1,65)

(20 — 30) / (2,18 — 2,0)

(10 — 20) / (2,58 — 2,18)

(0 — 10) / (2,8 — 2,58)

90 — a×0.6

80 — a×0.96

70 — a×1.1

60 — a×1.25

50 — a×1.3

40 — a×1.65

30 — a×2

20 — a×2.18

10 — a×2.58

Custom Intervals

Sometimes you may need to see some text instead of numeric values of a sensor. Here in this tab you can create custom intervals for the sensor and their textual meaning.

Note that like in the calculation table, all intervals operate from indicated value. The exception is the first interval which operates not only form this value to the next but also form minus infinity to this value.

For example, if you input intervals like in the example above, they will be interpreted in the system as follows:

Interval from Interval to Text

-∞

6.(9)

12.(9)

26.(9)

+∞ low middle high extremum

These textual interpretations will appear in

unit info tip and in

messages panel .

Unit Properties dialog the following parameters are set:

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

Name

Enter a name for the unit from 4 to 50 characters.

Device type

Select device type from the list of supported hardware . There can be an additional button near the selected device which can be used to configure some device parameters for the given unit (if this facility is provided in device configuration).

Unique ID

Enter a unique ID for the unit to be identified by the system. Usually it is IMEI or serial number.

Phone number

Here type phone number of the unit if it has embedded SIM card. Phone number should be in the

international format ,

e.g. +15557654321.

Device access password

This password is required for some device types to execute commands or send data.

Creator

User who is

creator for this unit (if you have any access to this user).

Account

Here you can see to which account the unit belongs (if you have any access to this account). Like creator, account cannot be changed.

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.

Mileage counter is used to calculate distance in reports .

Counters

Table of Contents

Access required: Edit counters – to edit counters current values and calculation methods.

Counters

Counter Properties

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

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.

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.

Engine hours counter is widely used in

tabular reports

GPRS Traffic Counter

GPRS traffic counter may be disabled in your package.

GPRS traffic counter is used to calculate Internet traffic consumed by the unit to transmit and receive data. Traffic is measured in kilobytes (KB). At any moment you can reset this counter manually if pressing the Reset counter button.

You will be offered to save the event of reset and the current value in unit events history to be exported to a

report

later.

Counter Properties

You can set the Current value for each counter, and the further calculations will start from the indicated point. In order the new data were added to the current value automatically, activate the Auto option at the right of the counter.

You can manually zero counters if entering '0' to the current value field.

Counters values can be altered not only in this dialog but also with the help of appropriate

jobs and

notifications

Values of mileage and engine hours counters can be shown in unit info tip .

Unit Properties dialog you can define access to the unit from the behalf of different

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

users .

The list of users whose access can be changed is displayed on the left. Users with green 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

Access Rights

for details.

display your unit on the map

Icon

Access required: Change icon.

On the Icon tab of the

Unit Properties dialog

you can select or load any image to

and on different lists.

There is a number of standard icons: push the Icon Library button and select one. Alternatively, you can load your own image: push Browse and select a file on the disk. Supported formats are PNG, JPG и GIF.

Depending on course, unit icon can be rotated to show direction of movement. For this, enable Rotate icon option.

Rotated icon should be faced North, otherwise, it may confuse you. You can find some images suitable for rotation in the Icon Library.

The button Reset to default allows returning the default icon in case it has been changed. Default icon may be useful sometimes. If a unit has a default icon, and a unit group where it belongs has a non-default icon, then unit acquires the icon of this unit group.

Unit Properties dialog messages validity parameters are defined,

Advanced Properties

Access required: View detailed properties – to view parameters for reports and settings of messages filtration (first and last sections); Edit not mentioned properties – to edit color schemes for track/sensor (middle sections); Edit connectivity settings – to edit parameters of messages filtration (last section).

On the Advanced tab of the

colors for tracks are adjusted, and speed limitations are set.

Table of Contents

Advanced Properties

Parameters Used in Reports

Colors

Message Validity

Enable filtration of unit position information in messages

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

report on speedings .

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

reports on speed

, in statistics , and in advanced

reports on drivers .

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 engine hours report

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

report on engine hours

(to estimate utilization and useful utilization). Engine hours operation is is defined by the corresponding

counter

Mileage Coefficient

Mileage coefficient is useful to compare detected mileage with mileage by speedometer. The corresponding column can be included in any

tabular report containing information about mileage, and in

statistics .

Colors

Different colors can be used to show unit itself on the map or its movements (tracks). Tracks can be built in the

Reports Mode , or in the Monitoring panel

panel,

Messages ,

quick tracks . Track segments can be different colors

depending on speed, sensor values and so on.

These properties are adjusted for each unit individually. Note that 'speed based', 'sensor based' and 'unconditional' options are mutually exclusive (only one can be chosen).

How to set up colors

Enter pairs: speed/sensor value and corresponding color. Separate value and color with a space, and pairs themselves with semi ';'. For example, if '0 ff0000; 60 cc0000ff' is entered, the track consisting of messages with speeds form 0 to 59 km/h will be displayed in red color, over 60 km/h – in blue.

For your convenience, there is a color palette which is shown when you click on any colored square box. To apply settings push the Apply button. To restore default colors push Reset to default .

The color for some range can be transparent. For this, its first bite should be 0×01. For example, the string '0

1ff0000;0.9 00ff00' means that the values from 0 to 0.9 will be transparent, from 0.9 and upper – green.

Speed based track colors

Activate this feature to make track color different according to speed of movement. Input speed values and set colors that should correspond.

Sensor based track colors

The track can be drawn in different colors according to values from a

sensor . Choose a sensor to be taken into

account. Then define sensor values and colors corresponding to them.

Unconditional track color

Track color set here is applied to all tracks of the unit regardless speed or sensor values. This option allows to assign 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.

Sensor colors

This feature can be used in two ways:

1.

To visualize sensor state in the appropriate column of the

Monitoring panel

(activated in User Settings

2.

To show unit on the map (the option Replace unit icons with motion state signs in User Settings ): the unit

can be displayed on the map with special signs as arrow (moving), square (stationary) or yellow

(stationary but engine on) which will obtain the color defined on this tab.

Value intervals and colors are set in the manner as for track colors. Besides, you can enter description for each interval. These descriptions will be used in popup windows for the Sensor Value column in the monitoring panel. If no description is assigned here, the exact value will be displayed in the popup window.

Message Validity

Enable filtration of unit position information in messages

All

messages

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:

Skip invalid messages

Some controllers may send a flag about coordinates validity/invalidity in messages. A messages 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 messages contains other parameters (such as sensors values), 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 form 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, more accurate the coordinates.

Maximum speed

The messages which contain the speed higher than set here, are marked as invalid. The values must be in km/h.

unit info tip (if enabled in

Custom Fields

Access required: View custom fields – to view this tab and its contents; Manage custom fields – to create, edit, and delete custom fields for given unit.

On the Custom Fields tab of the

Units Properties dialog

you can input information of any type. This can be some notes or precisions about the equipment, vehicle or any other information needed.

Key in a field name and its value and press the Add button. To delete an incorrect field, press Remove.

When the next time you will open unit properties dialog, the entered fields will be alphabetized. The same will happed when displaying custom fields in unit info tip.

Application of unit custom fields:

search units by some property.

);

Custom Fields

table that can be generated both for a unit and for a unit group;

In the Monitoring panel to

Units Properties dialog you can view whether the unit is included in some group or not.

Unit Groups

On the Unit Groups tab of the

You can also see the list of all existent groups and include the unit to one or several groups if needed.

To include/exclude the unit in/from groups, use the appropriate buttons Add and Remove or double-click on a group in the appropriate list.

If you do not have rights to change units in given group ('Edit ACL propagated items'), such group name is dimmed

(grey).

jobs ) as well as via SMS. A command can be executed for several units at once, but in this case it should be

Commands

Table of Contents

Access required: View commands – to view this tab and its contents; Create, edit, and

delete commands – to create, edit, and delete commands.

Commands

Command

Properties

The Commands tab of the

Units Properties dialog

gives possibility to create and configure commands for the given unit. To be able to send a command to a unit, it is crucial that this command is registered here.

A command can be sent both manually (from the Monitoring panel) and automatically (with the help of

notifications and

configured in the properties of all those units and bare exactly the same name.

To create a new command, press the New Command button. Sometimes it is convenient to create a new command using existing one as the basis – select a template command and press Clone Command . To view or change properties of an existing command, select it and press Modify Command. To delete a command, select it and press

Delete Command.

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

standard commands

supported in Wialon.

Link type

Select the link type to be used each time when sending the command (Auto, TCP, UDP, Virtual, SMS). If Auto link type is set, the program will automatically select a channel which is available at the moment of execution (if several are available, then the priority is given like in the list of link types). The list of link types also depends on the device type indicated on the

General tab.

Note that if the link type is TCP or UDP, it is required that the unit was connected at the moment of execution. If the command is executed through GSM channel, a phone number in the international format should be present in unit properties and the user is supposed to have rights to send SMS messages.

Access rights

Indicate access flags 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. So, 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 link type or parameters if they are set.

More about commands...

Units Properties dialog you define parameters to detect

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

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.

Table of Contents

Depending on the equipment installed and the parameters set on this tab the reports can look rather different.

Movement Detection

There are five main methods of how movement intervals are detected:

1.

GPS speed

This method is universal and can be applied to any device type and configuration. The parameters of this method are described below.

2.

GPS coordinates

This method is universal as well. The movement is detected if the coordinates in two successive messages are different. The fact is that some equipment types do not provide speed parameter in

messages . In this case, movement can be detected by coordinated without installing additional equipment.

3.

Engine ignition sensor

This method is available for units having ignition

sensor . If so, the trip begins when the sensor is switched

on and ends when the sensor is switched off. Besides, GPS correction can be added.

4.

Mileage sensor

This method can be used for units which have a mileage sensor. The sensor transmits the absolute mileage. The beginning of a trip is detected when the mileage value increases, and the end is detected when mileage value stops to grow. Here GPS additional correction is also available.

5.

Relative odometer

shows what distance was rolled from the previous message. Note that 'Minimal movement speed' parameter must be '0'.

In all cases you can additionally use GPS correction to receive more precise data in reports.

GPS Correction

To activate GPS correction of data put a check mark near Allow GPS correction.

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

Minimum 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 an accuracy of ±10, so a speed of 1-2 km/h can be assigned to the unit which is not moving in fact. To exclude such cases from the trips, set this parameter.

Minimum parking time

Set time in seconds how long the unit should be immovable to register this as a parking. This option allows excluding stops in traffic jams, at a lights or at an intersections.

Maximum distance between messages

Indicate the distance in meters to exclude outliers of data. It means 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.

Minimum trip time

This is also 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).

Minimum trip distance

This is a similar parameter. But here you indicate the minimum trip distance (in meters). For example, the car is parked, and the device sends coordinated according to which the car has moved a couple of meters. It can happen because of permissible equipment error. In order to not count such situation as movement, indicate how far the unit have to move to consider it as the start of a trip.

sensors . Fuel consumption

Fuel Consumption

Access required: View detailed properties – to view this tab; Edit trip detector and fuel

consumption – to edit this tab.

Wialon has instruments to calculate fuel level and fuel consumption. Parameters to calculate fuel and calculation method itself are set on this tab.

Fuel fillings and thefts can be detected only if unit has fuel level

calculation will be more accurate if unit has fuel consumption sensors, however it can be calculated with mathematical method.

Table of Contents

Fuel Consumption

Fuel fillings/thefts detection

General sensors parameters

Impulse fuel consumption sensors

Absolute fuel consumption sensors

Instant fuel consumption sensors

Fuel fillings/thefts detection

Minimum fuel filling volume

How considerable should be increasing of fuel level to be regarded as a filling.

Minimum fuel theft volume

How considerable should be fuel level fall to be regarded as a theft.

Ignore the messages after the start of motion, sec

At the very beginning of movement the data on fuel level can not accurate, so you can ignore these messages.

Minimum stay timeout to detect fuel theft, sec

How long should continue a stay accompanied with fuel level decreasing to be regarded as fuel theft.

Detect fuel filling only while stopped

If activated, the volume of filling registered can be fewer. In this case, fuel level before filling is taken from the messages with zero speed only.

Detect fuel thefts in motion

Traditionally, fuel theft is better detected while the unit is stationary. However, you can enable this option to detect thefts even in motion. Note that it can lead to the situation when false

Ignore filtration when calculating filling volume

Filtration is set in the parameter Filter fuel level sensors values (below on the same page). Sometimes it may cause

the underestimation of filled fuel volume. So, it can be useful to ignore filtration to calculate filled fuel volume.

Ignore filtration when calculating theft volume

Along similar lines, filtration can be disables while calculating fuel theft volume to prevent underestimation of fuel stolen.

Note:

Fuel fillings and thefts can be controlled through reports ( see

Fuel Fillings

and

Fuel Thefts tables) as well as

through the appropriate

job .

General sensors parameters

Merge same name sensors (fuel level)

If there are several fuel level sensors with the same names, their values can be summed. If this feature is not activated, the search of fillings/thefts is done for each sensor separately. If a message contains no value of a sensor, this message is ignored in calculations.

Attention! With this option enabled, no individual filtration cen be applied to fuel level sensors (FLS).

Merge same name sensors (fuel consumption)

If a unit has several engines and absolute fuel consumption sensors or impulse fuel consumption sensors are installed, this feature is useful. The values from different sensors will be summed (the sensors must have the same names). If the option is not activated, each sensor is controlled separately.

Time-based fuel level sensors consumption

This option is useful for non moving units. As a rule, fuel consumption is calculate by mileage, but it can be calculated by time as well (for hoisting cranes, for example).

Filter fuel level sensors values

Apply smoothing algorithm for sensors. If marked, set also Filter quality (from 0 to 255). The greater this parameter, the smoother are the charts. For fuel level sensors (FLS), filtration degree can be adjusted individually for each – in

sensor properties . However, this individual filtration works only if the option 'Merge same name sensors

(fuel level)' is off.

Consumption Math

This is a purely mathematical method of calculate fuel consumption (no sensors are required). To use this method, the following parameters should be set:

Idling, litres per hour: fuel consumption when staying with engine on;

Urban cycle, litres per 100 km: fuel consumption when moving with a speed less than 36 km/h;

Suburban cycle, litres per 100 km : fuel consumption when moving with a speed more than 80 km/h (fuel consumption at speed between 36 and 80 km/h is calculated in direct proportion of urban cycle to suburban cycle);

Coefficient when moving under load : the impact of loading on fuel consumption calculations.

This coefficient will be used when engine efficiency sensor value is above zero.

Consumption by rates

This is also a mathematical method. If the previous method takes account of speed and load, this method considers the season (winter/summer time). Specify the following parameters:

Summer consumption, litres per 100 km: the rate of fuel consumption in summer time.

Winter consumption, litres per 100 km: the rate of fuel consumption in winter time.

Winter from/to: winter time period.

Fuel level sensors

Fuel consumption is defined from fuel level in the tank where fuel level sensors are installed. The difference between the average values at the beginning and at the end of the period is calculated.

Impulse fuel consumption sensors

The readings are taken from impulse fuel consumption sensors. A sensor of this type needs a calculation table to convert impulses to liters. If there is a limit after which impulse counter is zeroed, this limit can be specified

(Maximum impulses field). However, with such a limit, in case of abnormal reset, the further calculations become senseless. In such a case, the limit must be 0.

Absolute fuel consumption sensors

The readings are taken form absolute fuel consumption sensors. The calculation table is applied to each sensor separately, and then the difference between transformed sensor values in two consecutive messages is calculated.

You may need to add a coefficient to get more precise values. Then add to the calculation table the following entries: X:0, a:coefficient value, b:0. For example, to increase fuel consumption level for 10%, a coefficient must be

1.1.

Instant fuel consumption sensors

The readings are taken from instant fuel consumption sensors. It calculated how much fuel has been consumed since the previous message. Thus, unlike other fuel sensors, there is no connection between consecutive messages.

Check your counters properties on the General

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 much days, engine hours or kilometers has left or are already expired to do this service.

Depending on the state (time left or expired), the lines are red or green.

Table of Contents

Service Intervals

Service Intervals in Use

To add a new service interval, press New Service Interval 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 must be done every n number of kilometers travelled.

Engine hours interval means that the service must be done every n number of engine hours.

Days interval means that the service must be done every n number of days.

You can simultaneously choose several interval types at once, and each of them will be calculated independently. That is the term by days cab by expired, but by mileage the term 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.

tab, do not forget to mark the Auto checkbox.

Done times: here you indicate how many time this kind of service was already done. This number can be entered

into this field manually or changed automatically when

registering a service of this kind. Besides, after registration the

time of the Last Service changes, and the count of days/kilometers/engine hours will be zeroed and started again.

At the end press ОК. The newly created service interval will appear on the list. To manage intervals, use the following buttons:

New Service Interval opens a dialog to create a new service interval and set parameters for it.

Clone Service Interval opens a dialog with all parameters of the selected interval. You can edit these parameters and save the interval under another name.

Modify Service Interval opens a dialog to view and/or edit the interval.

Delete Service Interval deletes the selected interval.

Service Intervals in Use

Tracking

Service intervals with their terms can be indicated in unit info tip. See User Settings

Events Registration

Maintenance works can be

registered in unit history

and used in report later. When registering maintenance, it can be bound to a certain service interval (existing in unit properties). After registration, the count of days/kilometers/engine hours will be restarted, done times will be added, and the last service term will change. The changes can be estimated in unit info tip as well as in unit properties dialog.

Notifications

There is a notification of the Routine servicing control type. With the help of this tool you can receive automatic notifications by e-mail, SMS, in online popup window or by other means about service terms which are approaching

or expired. See Notifications

Reports

Two tables concerning service intervals can be generated for units or unit groups: Maintenance and Utilization cost.

The report on maintenance

presents the list of registered maintenance works. The

report on utilization cost

includes maintenance works as well as fillings.

Some information about maintenance can be shown in

Statistics : total duration of maintenance works, total cost of

maintenance works, the number of services done, total utilization cost, and the number of fillings and services.

access rights to units. You

Unit Groups

Unit group is a system macro object incorporating several

units

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

Table of Contents

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.

How to use unit groups for tracking purposes is described below

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 groups and a filter to search existent groups. To see all available groups and continue working with them, set and apply some

search parameters. Observe results in a

table on the right. There you

can see unit name, image, creator

(if available), and button to delete group. Standard operations with objects (create,

view, edit, copy, delete) were described below

unit group properties, you see a dialog with

Unit Group Properties

When creating, copying, editing or just viewing

General

several tabs on which group configuration is adjusted. The number of tabs can vary depending on your

access rights (max – 4).

Table of Contents

Name

Give group a valid name (see

Input Rules ).

Creator

Creator is important to build hierarchy of access rights

. Do not forget that the creator automatically gets manage access to units in the group.

Account

Here you can see to which account the unit group belongs (if you have any access to this account). Account and creator cannot be changed afterwards.

Units

Add units to the group. On the left there is a list of all units available. On the right there is a list of units in the group.

To add a unit to the group, double-click on it or push the Add button. To remove a unit from the group, push Remove or double-click on the unit in the right column.

If you are editing an existing group, you are required to have Edit ACL propagated items access to this group to add/remove units. Otherwise, all units in both sections will be gray and you will not be able to move them.

Note:.

Except the manual way to manipulate groups, there is an automated way to add/remove units to/from a group. See

Notification Action for details.

Access

Access required: Manage access to this item – to group; Manage user's access rights – to users.

On this tab, you can define

access that different

users will have to this group.

On the left there is a list of users whose access rights can be controlled. Green background indicates those users which already have any access.

Select a user on the left and check access flags for this user on the right. Access rights are divided into two sections –

standard rights

(Item ACL) and special rights

(Unit group ACL).

More about access setup...

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 which belong in 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 this tab and its contents; Manage custom fields – to create, edit, and delete custom fields for given unit group.

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.

Messages from units can be retranslated in real -time from your server to other servers or systems. It is possible to

Retranslators

Attention!

This functionality is available if Retranslator module is activated.

retransmit data to several servers simultaneously and at different protocols. The ID of a retranslated unit can be different from its ID in Wialon.

Retranslation is possible only in

CMS Manager and it is done in the Retranslators panel. There you can create any

number of retranslators that will transmit messages of selected units to other systems. At any moment, any retranslator can be stopped or started again.

To create a retranslator, press the Create Retranslator button. In the dialog input a name for the retranslator (at least 4 characters) and choose a retranslation protocol. At the moment, the following retranslation protocols are available:

Wialon Retranslator,

Nis (M2M),

Granit Navigator,

Skaut,

Cyber GLX,

Wialon IPS,

VT 300,

EGTS,

SOAP.

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

Bellow select units for retranslation. To do this, move units from the left list (available units) to the right list (units for retranslation) by double-clicking on a unit or using the arrow-shaped buttons. Besides, you can input a new ID for units to be retranslated. To retransmit data by Granit Navigator protocol, unit ID should be a number in the range from 0 to

65535.

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.

To view the list of available retranslators in the

results panel and continue working with them (start, stop, add or

remove units, delete, change parameters, etc.), enter corresponding

search terms. Search results are displayed in the

form of a

table where you 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.

Manager or in the ground panel

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 Hosting interfaces – manager's and user's. To open the tool, click on a corresponding button in the

top panel of CMS

of the main interface.

Table of Contents

Import/Export Subject

You can 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 info tip, 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 give 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 Hosting to exchange

POIs

and

Access rights are important for import/export. Bear in mind two simple rules:

between resources as well as import and export POIs and geofences from/to external sources.

Exporting to an object allows you to transfer data (properties or contents) straight from an object to another object of the same type or to several objects at once. For example, you can copy geofences from one resource to another.

Required Access

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 edible for you (you need 'create, edit, delete' access to these properties of the destination object).

See more:

Unit Properties Transfer

Resource Contents Transfer

User Settings Transfer

import unit properties, resource contents, or user settings from a WLP file to an object of the

Import from WLP

This option allows you to

appropriate type. It makes sense only if you already have any WLP files.

Indicate the path to the file and press Upload. The file will be processed on the server, and available contents will be displayed in the section Import options. At the same time, in the section on the rights (Destination items ) objects of proper type will be displayed.

If the loaded file contains unit properties, all available units will be displayed on the right; if it contains resource contents, all available resources; if it contains user settings, all available users.

Check data to be imported on the right and select destination objects on the left. Use the

dynamic filter

to quickly find a necessary object. In case of units, they can be filtered not only by name but also by device type (if it is accessible).

For unit properties (such as sensors, custom fields, commands, service intervals) and resource contents you should choose also export type:

Replace: data will be replaced completely.

Merge: items with the same name will be replaced and the new items will be added.

Append: items with the same name will be left intact and the new ones will be added.

At the end press OK. See the log to check whether the operation has succeeded.

This option allows you to export data from an object to a WLP file or another object.

Export to WLP

Choose object type (unit/resource/user) in the dropdown list Export from. Then indicate certain item of that type in the

Origination item dropdown list. Select export destination – to a file or to an item. In case of file, you can additionally type a name for this file. Otherwise, the file will be named after the origination item.

When a certain item is selected, its available properties or contents is displayed below, 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 export to a file, then after you press OK, file stores on the disk. If you perform export to an item, then the

Import

dialog described above is displayed. There select destination objects and press OK.

This option allows you to import POIs and geofences from a file to a resource.

Import from KML/KMZ

Indicate the path to a proper file and select object type (geofences or POIs). Then press Upload. The file will be processed on the server, and its contents will be displayed below. Check items to be imported and select a destination resource. In the dropdown list, you can see only those resources to which you have access Create, edit, and delete

POIs or Create, edit, and delete geofences correspondingly.

When all settings are adjusted, press OK. If the executed file contains any developed geofences (lines, polygons), they will be omitted if you are trying to convert them into POIs. Only circle-shaped geofences can be transformed into POIs.

However, any POI can become a circle -shaped geofence, but with this it will lose its image and title formatting, and other geofence properties (address source, ride beginning/end) will be set to defaults. POI with zero radius will acquire default radius – 100m.

See the log to check how the operation goes. If the import failed, you get a warning alert.

You can check the result of the operation if you open the appropriate panel (POI or Geofences) and apply a filter by resource. New items will be selected in the first column of the list. It allows not only to see them on the map, but also easily delete them all together if necessary.

This option allows you to export POIs or geofences from all available resources to a file.

Export to KML/KMZ

When you export to KML/KMZ, the list of all available POIs or geofences (depending on item type chosen) is displayed.

Check items you want to export and press OK. Optionally, you can enter file name and compress file as KMZ. After that, press OK and save the file.

Almost any unit properties

Unit Properties Transfer

can be imported and exported:

General properties: unit name, device type, phone number, unique ID, device access password (from the General tab).

Device configuration: device configuration parameters (from the General tab).

Counters: current values of counters and their calculation parameters (from the General tab).

Report properties: five upper parameters from the Advanced tab.

Advanced properties : color schemes for sensors and tracks from the Advanced tab as well as messages filtration parameters form the same tab.

Sensors: contents of the Sensors tab.

Custom fields: contents of the Custom Fields tab.

Commands: contents of the Commands tab.

Trip detector: contents of the Trip Detector tab.

Fuel consumption: contents of the Fuel Consumption tab.

Service intervals: contents of the Service Intervals tab.

Exceptions are icon, access, groups, and information about account and creator – those 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.

resource can be imported and exported:

Resource Contents Transfer

Any contents of a

POIs

Geofences

Jobs

Notifications

Drivers

Trailers

Report templates

POI images, like unit icons, cannot be imported and exported. If you need them transferred, use import/export through

KML/KMZ files. Besides, KML/KMZ files can be used to convert POIs to geofences and vice versa (if they are circles).

See

Import from KML/KMZ

and

Export to KML/KMZ .

Photos of drivers and trailers cannot be exported either. If you need to transfer them, you can use the copying option instead of import/export.

Note also that drivers with the same phone numbers (or with phone numbers that belong already to some units) cannot exist in the system. If you are trying to import such phones, their values will be emptied, and drivers will be created without phone numbers.

If a report template contains parameters to filter intervals by geofences, those 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.

User Settings dialog, the tabs Settings, Map, and Monitoring Panel. User's e-mail,

User Settings Transfer

Individual settings can be transferred from one user to others or stored in a file. To import settings to a user you are required to have 'Edit not mentioned properties' access to this user.

Settings to export are taken from the

password and any data from the Account tab cannot be exported. Here is the list of settings that can be imported/exported:

Time zone: time zone choice, daylight saving time option, and calendar.

US metrics flag: on/off.

Unit info tip contents: options from the section 'Show in unit info tip'.

Monitoring panel configuration: everything from the 'Monitoring Panel' tab.

Unit visualization on map: options from the section 'Unit visualization on map'.

POI visualization on map: options from the section 'POI visualization on map'.

Geofence visualization on map: options from the section 'Geofence visualization on map'.

Address provider and 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), common map flag, option for online notifications and messages.

Map position at startup: initial map coordinates and zoom.

Format of coordinates: degrees or degrees and minutes.

Maps and layers: choice of activated maps, option of rendering geofences/POI on server (settings from the 'Maps' tab).

Locator flag: on/off.

Mobile access: access key to Wialon Mobile v1.

Note.

Settings imported to a user can be applied only after this user refreshes the page or reenters the system.

top panel – Activate Modules. It is used to enable additional

Activation of Modules

Managers of higher level will have one more button on the

modules or packages such as '50 units', '20 routes', 'Advanced reports', '500 SMS messages' etc. If you have such a button, 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 press OK. An alert will be shown where you should confirm your intentions or cancel the activation.

Conversion Table: Polyline (PL)

Cartography

All address information for online tracking and reports is taken from Gurtam Maps.

Maps in AVD format are used. AVD 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 can 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.

Table of Contents

Vector maps in the closed AVD format allow ADF-based programs to render map images in various projections, fulfill the search of named element, use geocoding including reverse geocoding.

Conversion Table: POI

Conversion Table: Polygon (PG)

Scale (AVD)

Conversion Table: Polyline

.MP

.OSM

Code Key Value

0×0001 highway motorway highway motorway_link

0×0002 highway trunk highway trunk_link

0×0003 highway primary

Keys

.AVD

Key_ values

Type

AVD

Type

(0-

255)

Data level

(0-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 aren't 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.

Roads generally linking

Image Icon

highway primary_link

0×0004 highway secondary highway secondary_link

0×0000 highway tertiary highway tertiary_link

0x000a highway unclassified

0×0042 highway unsurfaced highway track

0×0005 highway residential

0×0006

0x000b

0×0008

0×0009

0×0049 highway living_street

0×0007 highway service highway bridleway highway cycleway cycleway lane

2 larger towns.

The link roads

(sliproads/ramps) leading to/from a primary road from/to a primary road or lower class highway.

Roads generally linking smaller towns and villages.

The link roads

(sliproads/ramps) leading to/from a secondary road from/to a secondary road or lower class highway.

2 Minor roads.

PL 9

PL 10

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 grid network.

1 Unpaved roads.

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

1 Roads for horses, cartage.

1 Cycleways for bicycles.

A lane is a route for bicycles that lies within the roadway.

0-6

7-8

0-6

7-8

0-6

(7-9)

(0-5)

(6)

cycleway track highway footway

0×0048

0×0016 highway pedestrian highway bus_guideway junction roundabout

0×0014 railway rail railway tram

0x003f railway subway railway disused railway monorail

0x001f waterway river

0×0018 waterway canal

0×0026 waterway stream

0×0044 waterway drain waterway weir

PL 18

A route for bicycles that is separate from the road.

Footpaths for pedestrians, e.g. walking tracks and gravel paths.

For roads mainly/exclusively used for pedestrians/shopping areas. Also for tagging squares and plazas.

A busway where the vehicle guided by the way

(though not a railway) and is not suitable for other traffic.

1 Circle movement.

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.

A city passenger rail service running mostly grade separated.

Metro/underground/subway lines.

A section of railway which is no longer used but where the track and infrastructure remains in place.

A railway with only a single rail.

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 aren't 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.

100

0-6

(7-9)

waterway dam aeroway runway

POI 52

0×0045

0x001d boundary administrative admin_level

0x001c

0x001e boundary administrative admin_level border_type

2 nation

PL 191

PL 192

PL 193

Conversion Table: POI

.MP

.OSM

Code Key Value

0xf201 highway traffic_signals

0xf002

0x2f08

0x2f17

0xf001

0xf003

0xf004 highway bus_stop

0x2f03 highway services

.AVD

Type

AVD

Type

(0-

255)

Data level

(0-2)

POI 50

Comment

0 Lights that control the traffic.

POI 51

A wall built across a river or stream to impound the water. A dam normally 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.

State, council.

county, local

1 Region boundary.

2 National boundary.

0 A small bus stop.

Image Icon

0xf007 railway station

0xf006 railway halt

0×4600 amenity pub

0x2d02

0x2d00 amenity nightclub

0x2a0e amenity cafe

0×4500 amenity restaurant

0x2a0d amenity fast_food

0x2f0b amenity parking

0x2f02 amenity car_rental amenity taxi

0x2f01 amenity fuel

POI 53

POI 55

POI 56

POI 57

A service station to get food and eat something, often found at motorways.

0 A railway station.

A small railway station, may not have a platform, trains may only stop on request.

A place selling beer and other alcoholic drinks; may also provide food or accommodation.

0 A nightclub.

0 A cafe.

0 A restaurant.

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.

A place where taxis wait for passengers.

Petrol station, gas station, marine fuel,

101

0×4400

0x2e05 amenity pharmacy amenity hospital

0×3001 amenity police

0×3008 amenity fire_station

0xf001 amenity bus_station

0x2f06 amenity bank amenity atm

0x2b00 tourism hotel

0x2b01 tourism motel

0x2b02 tourism guest_house tourism hostel

0×0100

0×0200

POI

POI amenity bureau_de_change POI

POI

63 etc.

0 A pharmacy.

0 A hospital.

0 A police station.

0 A fire station.

0 Bus station.

0 A bank.

Currency exchange, a place to change foreign bank notes and travellers cheques.

An ATM or cash point.

A hotel.

A motel.

Guest house.

A hostel.

A megalopolis over 5 million people.

0×0300

0×0400 place city POI 64 2

A city of 1-5 million people (MP).

A city over 100 thousand people

( OSM ).

0x0b00

0x0c00

0x0d00

0x0e00

0x0f00

0×1000

0×1100

0×0010

0×0500

0×0600

0×0700

0×0800

0×0900

0x0a00

0×0006

0×0004 place place town village_greenhamlet POI

0x640a

0×3002

0×6408 place continent

0×6602 place state

0x1e00 place region

0x1f00 place country

POI

65 1-2

POI 149

POI 195

POI 196

POI 197

POI 198

A town form 10 to 100 thousand people.

A village below 10 thousand people.

Captions.

A hospital.

A continent.

A state.

A region.

A country, area.

Conversion Table: Polygon

.MP

.OSM

.AVD

Code Key Value Type

AVD

Type

(0-

255)

Data level

(0-2)

Comment

0×0047

0x003b

Used for large rivers, to define an

Image Icon

102

0×0045

0×0049

0×0040

0×0041 divided by size divided by size

0×0028 waterway natural landuse waterway leisure riverbank water reservoir riverbank park leisure

0x004e

0x004f

0x008e

0×0086

0×0087

0×0088 leisure

0x006d amenity

0x001a amenity landuse common garden townhall grave_vard cemetery

0x000a amenity school amenity university

PG 130 2 area between the opposite riverbanks.

PG 131 2 Lakes, water bodies, etc.

PG 131

PG 132

PG 133

PG 140

2 An artificial reservoir.

2 Sea, ocean.

2 A large river.

A park, open green area for recreation.

An area where the public can walk anywhere.

PG 141 1 A garden.

PG 146

PG 147

148

1 A town hall building (mayor's office).

1 A graveyard.

1 A cemetery.

A school.

A university.

amenity

0×3002 amenity amenity

0×6408 building college hospital pharmacy clinic

PG 148 1 A college.

PG 149 1 A hospital.

PG 149 1 A pharmacy.

PG 149 1 A clinic.

0x000b building shop building building tourism hospital supermarket shopping camp_site

PG 149 1 A hospital.

PG 151

PG 153

1 A supermarket.

1 A shop.

Camping, a place where you can pitch a tent.

103

(0-5)

(6)

(0-5)

(6)

(0-5)

(6)

(0-5)

(6)

(0-5)

(6)

(0-5)

(6)

(0-5)

(6)

tourism landuse landuse landuse

0×0004 landuse

0×0014

0x000d

0×0015

0×0016

0×0017

0x001e

0x001f

0×0020

0×0098

0×0051

0×0096

0x008b natural natural

0×0018 sport sport tourism tourism tourism tourism tourism historic

0×0050

0×0081

0×0082

0×0083

0×0084

0×0085

0×0052

0x008f

0×0090

0×0091

0×0001

0×0002

0×0003 landuse landuse landuse landuse

0x000c landuse

0×0006 landuse caravan_site picnic_site theme_park

PG 153

PG 154

PG 155 attraction zoo

PG 156

PG 157 artwork PG 158 archaelogical_site PG 159

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.

1 Theme park, amusement park.

0 A general tourism attraction.

1 A zoo.

1 A tag for public pieces of art.

0 Archaeological museum.

forest residential retail commercial industrial blownfield greenfield railway construction millitary wood marsh golf horse_racing

PG 167

PG 168

PG 169

PG 170

PG 171

PG 172

PG 173

165

166

184

185

PG 194

Managed forest or woodland plantation.

Predominantly houses or apartment buildings.

1 Predominantly shops.

Predominantly office buildings, business parks, etc.

Predominantly workshops, factories, warehouses.

0 Garages, vehicle sheds.

A district to be developed, an empty area.

Describes land scheduled for new development where there have been no buildings before .

Area for railway use, generally offlimits to the general public.

1 Something under construction.

For land areas owned/used by the military for whatever purpose.

104

Natural woodland (trees). Only for completely unmanaged/wild ares.

Low poorly drained land that is sometimes flooded and often lies at the edge of lakes, streams, etc.

1 Golf course.

1 Hippodrome, racecourse.

sport sport sport building leisure leisure leisure leisure multi football soccer stadium golf_course stadium track pitch building palace

PG 194

194

PG 194

1 Sports ground, playing field.

1 Футбол.

1 Football or soccer.

A stadium, a major sports arena with substantial tiered seating.

1 Golf course.

1 A stadium.

A track, e.g. running, cycle-racing, greyhound, horses.

A field for playing football/soccer, cricket, baseball sports, etc.

PG 207 1 A palace.

building postoffice PG 208 1 A post office.

building restaurant PG 209 1 A restaurant.

0x006f

0x006f amenity

0×0013

0x006c building public_building PG 210 1 Public building.

yes PG 210 1 General tag for buildings.

0x006e building terminal denomination baptist catholic christian evangelical lutheran

Roman Catholic roman_catholic

PG 211 0 A church.

0×9999 surface

PG 210 1 A building.

PG 212 2 Ground surface.

Scale (AVD)

Scale (km) Scale (m) Data level Zoom level Value

0,01

0,02

0,05

0,1

0,15

0,2

0,5

100

150

200

500

-1

1000

2000

5000

10000

15000

25000

50000

105

(0-5)

(6)

(0-5)

(6)

(0-5)

(6)

(0-5)

(6)

(0-5)

(6)

(0-5)

(6)

(0-5)

(6)

(0-5)

(6)

100

150

200

500

1000

2000

5000

10000

20000

50000

100000

150000

200000

500000

1000000

2000000

5000000

10000000

20000000

50000000

100000000

150000000

250000000

500000000

1000000000

106

The monitoring system is used by end users

Monitoring System

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 , registering work shifts, binding to unit, etc.);

interpreting information derived from the unit in various kinds of reports (tables, charts, movement tracks,

event markers, complete statistics, etc.); and much more.

Tracking results can be presented on the computer screen as well as exported to files in different formats.

107

System Requirements and Optimization ».

Wialon Quick Start

1. Login

Key in your user name and password on the login page, and press Enter.

Make sure you use one of supported browsers, which are: Mozilla Firefox 3+, Opera 10.0+,

Internet Explorer 8+, Google Chrome 11+. See «

Table of Contents

2. Interface

You have entered the main interface of the monitoring system. On the left there is the

work area . Here you switch

between panels like Monitoring, Tracks, My Places, Geofences, Notifications, Jobs and so on.

On the right there is usually the map. There can also be reports, messages, log, etc. – it depends on the

mode

chosen. The modes (Map, Messages, Reports) are changed in the mode-switch panel over the work area.

Dragging the

map with the left mouse button and zooming it with the mouse scroll, move to the location (city or town)

which will be the basic for you in the tracking process.

3. User Settings

108

Now open the

User Settings

dialog (click the appropriate

button at the top). First and foremost, indicate your time zone and type of daylight saving time used in your region. These settings are extremely important as they affects time data in reports, messages, tooltips, jobs, routes, and everywhere throughout the system.

In the same dialog move to the Maps tab and press the button Store current. With this, the current map position will be stored and used for further logins to the system. At the end press OK to apply new settings. The page will be reloaded.

Preparatory work is finished. Now let's 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.

109

The dialog with multiple unit settings will be displayed. Give a name to the unit, select device type from the list of available devices, enter unique ID (IMEI or serial number) and the phone number of the SIM card inserted in the device.

The Image tab of the dialog provides an opportunity to choose the most appropriate image to display the unit on the map. Press the Image Library button and choose one.

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 on the list. Click on unit name to locate it on the map.

110

It will also appear in the monitoring panel.

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

log

. To see the log, open it pressing the button in the bottom right -hand corner of the

program.

Except 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

tooltip : last

message time, location (address or coordinates), speed, etc.

c) Messages Mode

The most reliable way to check unit operability is to view its

messages . To switch to the Messages Mode, click on the

messages link over the work area. Then 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.

111

6. Creating Geofences

Geofences

are to be created in places of interest, which should get under control. For this, go to the Geofences panel in the Map Mode 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

Now we can create a

notification about a unit entering a geofence. Go to the Notifications panel and press the Create

Notification button.

112

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, particularly, Geofence control.

3.

Specify a check type – Control entries to a geofence, and select geofence(s) to be controlled on the list below. To select several geofences, press the CTRL key on the keyboard and tick necessary geofences.

4.

Leave default notification text without changes.

5.

Choose a method of delivery, for example, Display online notification in a popup window.

6.

Key in 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

Reports Mode , click the Reports link in the mode-switch panel 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

tables (visits to geofences and speedings) and a

chart .

To create a report template, go to the Reports Mode and press the New button. At the top of the template properties dialog you see two important buttons – Add Table and Add Chart.

113

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

chart

type (for example, mileage in trips). Note that for many charts to be generated the appropriate sensors are required. Press OK.

114

This is how our report template looks after we have added two tables and a chart. Report contents id displayed on the left. Now name 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).

115

116

The first thing you see when entered the system is the Monitoring

User Interface

User interface of Wialon Hosting is simple and in many cases intuitive intelligible. There is plenty of screen tips and helpers associated with various buttons, icons, dialog boxes, edit fields, and other elements of interface.

In the picture below, you see general view of the system. To observe the system in a greater scale, switch to the fullscreen mode by pressing the <F11> button on the keyboard. This hotkey is supported by most of

browsers .

Different interface elements are described in further sections of the guide:

117

Enter service URL into the address line of your

browser

On the login page key in your username and password that were given to you while registering, choose interface language, and then press Enter.

If you are using a private computer, you can additionally put a check mark near Remember

on this computer. In this case, the next time you enter the system you will not be asked to

input your login and password again.

Table of Contents

panel.

If You Forgot Your Password

If you have already registered in the system but forgot the password, please, follow the link Forgot your

password? There you will be asked to key in your user name and e-mail address that were indicated while

registering. Then push the Reset password button. A password reset link will be sent to you. Follow this link to get your new password.

If you have pressed Forgot your password? by accident, just ignore the e-mail with password reset link and use your former login and pass. If you still follow this link, you will have to accept the new password.

How to Change Your Password

The current password can be changed in the

User Settings dialog. However, not all users are allowed to do this.

Contact your service administrator for more information.

Login As

118

It is possible to login to the system as another user (either to the monitoring interface or to CMS Manager). To do so, you need to have 'Act as given user' flag in access rights for this particular user.

To login as another user, enter your user name and password, as usual, and then click on Login as caption and enter login name of needed user.

When you are logged in as another user, you can see only items available to this user and perform actions allowed to this user. Herewith, login history is saved to this user.

You can switch to another user even after entering the system, however, in this case the login will not be saved in the user's history. Go to the Users panel, and you will find the 'Login as' button against each user. If you do not have enough access privileges, the button will be disabled. To return afterwards to your main user, use a special button in the top panel (the main user is written in bold).

119

map layer menu (Gurtam Maps, Google Maps, etc.);

Top Panel

On the top left of the window there are the following elements: service provider logo; current time with time zone in brackets (time parameters are adjusted in

User Settings ),

the language menu (contact your service administrator to enlarge this list if needed).

On the top right you see:

the Tools menu;

the User Settings

button; login (username) that has been used to enter the system

(another login can be displayed in brackets if the main user is acting as another user);

the button to login as different user

or come back to the main user; the Logout button; a link to online user guide (optional); a link to technical support service (optional); product logo.

will be loaded automatically. At this, if the flag

Remember on this computer is enabled, the auto login to the system will be performed, too.

In the top panel the notification about days left may appear.

Besides, in the top panel you can receive

notices from your service administrator.

120

Messages Mode where you can view database of messages received from your units (this mode is

Work Area

The left side of the screen is the work area where you can configure and observe different system elements necessary for tracking purposes.

At the top of the work area there is the mode selector – to switch between three modes available in Wialon Hosting user interface:

1.

Map Mode where you track you units and manage attendant system elements like geofences, drivers, job, notifications, etc.

2.

optional).

3.

Reports Mode where you generate reports based on data received in messages.

Below there is the work menu, a menu of available panels representing different system elements:

Monitoring — tracking units position, state and movements.

Tracks — viewing movement history.

POI — creating, editing, removing points of interest on the map.

Geofences — creating, editing, removing geographical areas.

Jobs — creating, editing, removing jobs performed by schedule.

Routes — controlling units on routes.

— creating, editing, removing notifications about events.

Units — managing available units.

Users — managing other users.

Unit Groups — grouping units in your own way.

Drivers — creating drivers and assigning them to units.

The panels are available only in the Map mode, which can be selected in the modes panel. To navigate through the panels, place the cursor over the name of the panel on top of the work area. Then in the list that appears select a desired panel. It is more convenient to navigate between panels using

Shortcuts .

The work area size is changeable. Click on its right border and drag right or left to widen or narrow it. Besides, the work area can be completely hidden. For this, use the arrow-shaped button on the modes panel.

121

Unit Presentation on Map for details);

Ground Panel

At the left end of the ground panel you see three buttons to manage unit display mode as well as SMS button:

— сhide/show unit traces;

— hide/show unit names;

— hide/show unit movement direction (course) arrows (see

— hide/show the dialog to send SMS messages to drivers, users, and units.

At the right end of the ground panel there are three buttons which are used to show or hide additional windows:

—

Messages

window which displays messages received from drivers

( — there are new unread messages);

—

Log window which contains current events and operations.

window which pops up when an online notification triggers ( — there are new unread notifications);

— Pictures window which allows to view pictures from messages;

—

Minimap

window to navigate over the map or watch units;

—

In the center of the ground panel there can be your copyright with a hyperlink.

122

geofences and other elements can be displayed on the map.

Map

Table of Contents

The map exists in all modes. Usually, it occupies the greatest part of the screen. Units and their traces, marked

POI ,

Map

Using the Map in

Different Modes

To adjust the map size in relation to the

work area and the

log , drag a slider between the

corresponding panels up/down or right/left.

Map Source

Navigation

To expand the map as much as possible, you can hide the work area and the log at all (

Zooming the Map

and buttons) and switch to the fullscreen mode by pressing <F11> that is supported by most of

browsers .

Using the Map in Different Modes

The map is common for all of three modes: Map Mode,

Messages Mode , and

Reports Mode . It means that while

switching between modes the zoom and coordinates of the map center remain the same. Graphic elements such as track lines, markers, places, geofences, units icons stay in their places as well.

However, graphic elements mapped in any mode can be easily on or off. To display or hide these elements, put marks in the corresponding check boxes in the mode selector.

The common map feature can be disabled. To do this, remove the flag Use common map for all modes in

Settings . Then when switching between modes, graphic elements of inactive modes will be disabled automatically. At

that, map zoom and center remain the same.

Map Source

The menu with available maps is located on the top panel of the program. Select the map source you like, and currently displayed map area will be reloaded from different source. It concerns both the main map and the minimap.

123

To activate more maps, go to

or contact your service administrator.

For Google and Yandex maps, traffic layer is supported. To enable it, choose the appropriate option in map source menu. Traffic information from Google is updated each time you move or zoom the map. Traffic information from

Yandex is reloaded each 5 minutes.

Navigation

There are three basic ways to navigate over the map.

1.

Using corresponding buttons

At the left top corner of the map there are four arrow -like buttons that allow you to move map over the screen up, down, right, and left correspondingly.

2.

Using the mouse

This is similar to drag and drop method. Left click on any place of the map and drag to necessary direction. Then release the mouse button.

3.

Using minimap panel

This way is more convenient when working with large scaled maps. To open this panel, press the minimap button at the bottom. Click on any place in the minimap window to move through the main map. Except navigation, the minimap can be used for

tracking purposes.

Zooming the Map

Here several methods are also assigned:

1.

Scale on the map

At the top right corner of the map under navigation buttons there is a scale that allows to zoom in (+) or zoom out (-). At the same time, the center of the map is staying stable.

2.

Mouse scroll wheel

It is more convenient to adjust zoom level using mouse scroll wheel. Scroll up corresponds to zoom in, scroll down corresponds to zoom out. During the scrolling actions point the mouse cursor at needed place so that it would not get out of sight.

3.

Mouse and <shift> button

124

If you push and hold <shift> button and select some area of the map with the left mouse button, the map will be zoomed in to this area.

4.

Double-click

Double-click on any place of the map to zoom it in.

At the bottom of the map the current scale (in kilometers/meters and miles/feet) and geographical coordinates of the cursor are indicated. Format of coordinated can be either degrees or degrees and minutes. It can be selected in

Settings => Maps .

125

decrease the log, drag the horizontal slider at log's top up or down. The log window is semitransparent so that the map

Log

The log contains records of current events and operations running in the system: new message from a

unit appears,

new SMS is received, unit configuration is changed, new

geofence

is created, etc. The log contains messages from units in the work list. Depending on the units quantity and equipment configuration, the messages in the log can appear even every second.

To show or hide the log window, use a special button in the right bottom corner. The log is resizable. To enlarge or

under it could be visible.

If an event registered in the log has happened in a certain place (for example, a new location of a unit was 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 most regular messages concerning units motions and actions. The green indicates user's activity: creation and editing of places, units, geofencs, user settings changes, etc. Red color is used to display error messages and alarm messages from units.

126

Shortcuts

Keyboard shortcuts give more convenient and quick to navigate through the system. This feature is activated in

Shortcuts for mode selection:

1 – the

Map Mode;

2 – the

Messages Mode;

3 – the

Reports Mode.

Shortcuts for tools:

;

tool;

Area tool;

Address tool;

Routing tool;

Hittest tool;

tool.

Shortcuts for panels (elements):

Q —

Monitoring

;

W —

;

E —

POI

;

R —

Geofences

;

A —

Jobs ;

S —

;

B —

Trailers

;

Z —

;

X —

Users

;

C —

Unit Groups ;

V —

Drivers .

Other shortcuts:

~ – hide/show the

Work Area

;

L – show/hide the

Log .

The hints for the shortcuts are given in brackets as it is shown in the picture.

127

User Settings . At that, if Arabic is selected as interface language, the

Calendar

Table of Contents

The calendar is used in many cases: to specify time interval to generate a report or query messages; to indicate date and time when a notification, job or route should be activated; to register events and drivers' working shifts.

The calendar allows to set time accurate within minutes. Time format is: date – month – year – hours – minutes. It can work with dates since the 1st January 1971.

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 in the open calendar. Year field will appear below. Scroll the mouse up/down or input from the keyboard the necessary value, below click on a month and then select a day.

The Persian Calendar

128

There was the usual Gregorian calendar. However, Wialon works also with the Iranian calendar also known as Persian solar calendar. It is used in Iran and Afghanistan.

The Persian calendar can be activated in

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.

129

While typing you query, you can use wildcard symbols such as * and ? which use is described below

Filters and Masks

Filters and masks are developed for your convenience. With them you can: narrow a list of item in such a way to show only items needed at the moment; find an item with known name or other attributes on a large list; specify an element (e.g. sensor) to base a notification or report on it.

Table of Contents

List Formation

When you create any objects (geofences, places, drivers, custom fields, etc.) they are organized into lists. Items on the list are displayed in the alphabetical order: numbers first, then Latin alphabet, and Cyrillic at the end. Capitalization of letters is not taken into account. When a new item is created, it is added primarily to the end of the list, but when you open this list again, all items are arranged in the alphabetical order. After renaming an item, it remains at its former place until you reopen the list.

Dynamic Filter

If a list contains a great number of items, it can be not so easy to quickly find necessary item. For your convenience, you can fulfill dynamic search. It is available in all panels except Tracks. Simply start typing the name of an item

(geofence, unit, route, etc. depending on the panel opened). You can start typing a name from any point. While typing, items which correspond to your query will be immediately displayed.

If you leave the search field empty, all items will be displayed.

The dynamic filter can be found also in properties dialog of units, units groups and users when adjusting access right.

However, the difference is that search results are displayed not while typing but after you press the Apply button.

The particularities of the dynamic filter usage in the Monitoring panel are described in

Unit List Management

section.

Name Mask

Besides the dynamic search, there is the other type of filter. It is used to specify an item (sensor, geofence, etc.) when configuring reports, notifications, etc. This assumes that you can define item's name using the wildcard symbols

asterisk * and/or question ?

The asterisk sign is a wildcard symbol which represents any combination of allowed characters in the name of an item. It can be placed in any place of the query (at the beginning, in the middle, at the end) or in several places at once, depending on which part of the name is known or is the same for a number of items. For example, if you type

*h*nda*, all Hondas and Hyundais will be found.

Another wildcard symbol which can be used is the question sigh (? ). It replaces any single character (only one character). As well as the asterisk sigh, it can be put at any place of the query.

The request is not case sensitive.

130

For example, a unit has two fuel sensors which names are Sensor fuel level and Fuel in tank. We are going to create a notification which would be based on both of them. To achieve it, in notification properties we must set sensor name mask in such a way that it would correspond to the names of both sensors. In our case the best choice is *fuel*:

You can do a search without using the asterisk but then you have to indicate the name (geofence, driver, sensor, etc.) exactly as it exist 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:

in notifications to specify sensor, route or driver under control as well as set SMS text mask or parameter

in messages;

in user properties to set host mask for users

;

in reports to specify driver, sensor, event/violation, route and its geofence, and when selecting geofences;

in the Messages Mode to filter

found messages; in all panels masks can be used instead of the

Dynamic filter .

131

Input Rules

Table of Contents

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:

Input Rules

Incorrect entries are:

Phone numbers and e-mail

Not enough characters in a name or a phone number. Names of monitoring

addresses

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.

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. Except numbers, a phone can contain only one character – plus (+) at the beginning. 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].

132

Users can configure some parameters of system operation according to their needs and tasks.

User Settings

To view user settings, click on the corresponding button on the

top panel .

The User Settings dialog can contain up to four tabs that depends on system configuration:

General Settings

Monitoring Panel Settings

Maps

Account

Hint.

Settings from one user can be imported to other users.

133

The first tab of the User Settings dialog

General Settings

contains general settings. Here you indicate you time zone, input your e -mail address, change the password to enter the system, and set many other parameters.

Table of Contents

General Settings

Show in unit info tip

Unit visualization on map

POI visualization on map

Geofence visualization on map

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 on, the Persian calendar will replace usual (Gregorian) calendar in the places where a user should indicate some time interval (to build a track, to query messages or a report, to setup a job or assign a route, etc.) At that, if Arabic is selected as interface language, the calendar will be in Farsi (language spoken in Iran) and shown from right to left. Otherwise, it will be in English (in Latin characters and Arabic numbers) and shown from left to right (see

details ). Enabling/disabling the Persian calendar requires reloading the page.

E-mail

This e-mail address will be used to send you a reset password link in case you forget your password.

Enable public access to locator page

If you enable public access to your account, your units location will become available to other people and at any moment accessible to other people through the locator page. Enable the option and save user settings. Then display the dialog again and follow the locator page link to see how it will look. The feature works only with Google Map

service. More...

City

In this field you can indicate your city. It will be used in the

Nearest Units and

Address tools as the default city. Enter

the full city name or its beginning, and in the dropdown menu below confirm your choice selecting a needed city from the list (there can be several towns with the same names in different countries).

Change password

If you push this button, some additional fields will appear. You will be asked to input your current password, and then

your new password (two times). New password can be applied on the login

page. Note: However, not all users are allowed to change their passwords.

134

Access key to mobile site

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.

Use US metrics (miles, gallons)

By default distance is measured in meters (kilometers), and fuel level is given in liters. Mark this check box to switch to the US units of measurement – miles and gallons. This parameter affects only online tracking, to apply US metrics to reports, see

Report template advanced settings

Use common map for all modes

The option is activated by default. It means that all graphics mapped in different modes

(map, messages, reports) remain on the map when switching between the modes. If the option is disabled, graphic elements of inactive modes are disabled automatically when switching between modes.

Play sound for events

The sound can be played for

online notifications

and

drivers' messages . When a notification or a message pops up, the

browser will play sound. In Windows OC QuickTime Alternative can be used as media player.

Automatically display popup events

If ticked,

online notifications

and

messages from drivers

pop up automatically. However, if you remove the flag, only the blinking envelope in the bottom panel will indicate that there are new events.

Use shortcuts

Check this box to activate

Shortcuts .

Show in unit info tip

Here you choose which information should be listed in unit tooltip

(on the map and in the work list). If nothing is selected, only last message time will be displayed in unit info tip.

Unit info

Device type, unique ID, and phone number which are specified in unit properties

. This information is available to users with manage or edit rights only.

Location

The last detected address.

Speed

Speed in the latest message.

Altitude

Altitude in the latest message (if device is able to give such data).

Satellites

The number of satellites locked.

Counters

Values of mileage counter and engine hours counter. See

Counters .

Presence in geofences

If unit is situated in a

geofence , geofence's name will be displayed, and it will have the same color as assigned in

geofence properties).

Parameters

Message

parameters

are CAN bus, power voltages, and many others. Their names (as they come in messages) and their raw values can be shown in unit info tip.

Sensors values

Sensors configured for the unit and their known values will be listed. Custom sensor name is displayed and the value

processed according to calculation table of this sensor.

Custom fields

Custom fields from unit properties.

135

Route control

Assigned routes

and their current states.

Drivers

Name, photo, and phone number of the driver(s)

currently bound to the unit.

Trailers

Name and photo (if available) of the

trailer(s) currently bound to the unit.

Maintenance state

Service intervals together with their states (days/engine hours/kilometers left or expired) are shown.

Note that counters in unit tooltip are refreshed once a minute, as well as information about driver.

Unit visualization on map

Replace unit icons with motion state signs

If marked, unit

icons 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

Unit presentation on map .

Display overlapping units in one icon

If one or more units overlay on the map, their icons can be grouped into one. It lightens visual reception of the map. The exception is in two biggest zooms where all icons are displayed regardless their overlapping.

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.

POI visualization on map

Display POI names on the map

Depending on this flag, POI can be displayed on the map with its name or without it (only with image or/and a circle).

Default color for these captions is orange, however it can be changed for each POI individually (see

POI properties

Display overlapping POI in one icon

If several POI icons overlap when displayed on the map, they can be grouped into one icon. Place the cursor over this icon to know which POI hide behind it. Note that for reports this option is set independently — in

advanced options of report template.

Geofence visualization on map

Display names of geofences on the map

If activated,

are displayed on the map with captions. Caption color is magenta (purple).

136

User Settings dialog you can customize the view of your

Monitoring Panel Settings

On this tab of the

Monitoring panel . Choose the elements to

be displayed in the working list. If you mark an element in the left check box, this item will have its own column in the monitoring list. If you mark an element in the right check box, this item will get into unit actions menu under button. If not marked at all, the item is not displayed.

Location

This column will show units' last addresses. Depending on

chosen format , addresses can be longer (including state,

region, etc.) or shorter (e.g. just street and building number). However, in any case this will be the widest column in the

Monitoring panel, so it is not recommended to switch it on if you are short of screen space.

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.

Sensor state

Shows

sensor state (on/off, value, etc.) with different colors.

How to adjust these colors...

Tracking option

If selected in this column, unit will be always in sight on the map.

Command can be locate unit, block engine, send a message to driver, and many others depending on device type

Commands

used.

Motion state

This column shows whether unit is moving or stationary, as well as whether ignition is on or off (if there is the appropriate sensor).

Data accuracy

Shows how many satellites were locked and when the latest message was received. According to their last message time, units can be automatically displayed or hidden. To make use of this option, change Without filtration to Monitoring

panel or Panel + Map and specify filtration interval in minutes. The filtration can affect only the work list in the

monitoring panel or both the work list and the map. More...

Connection state

Shows whether there is connection with unit at the moment. Unit is considered to be online if it has TCP or UDP commands available or it has sent messages within last 10 minutes.

Pictures from messages

137

The button to display

images

received from the unit (useful if such functionality is provided for type of device used).

SMS

The button to send

SMS to a unit or a driver bound to this unit.

Quick track

The column of buttons to build

tracks straight from the Monitoring panel. You should also select an interval to be

applied to 'quick' tracks: current day, last 24 hours, last complete day, or manual mode. Manual mode means that the interval is taken from the Tracks panel.

Messages

View

messages for the selected unit.

Properties

View

unit /

group properties dialog.

Drivers

The column with information on drivers. In the tooltip you can see name, photo, and phone of driver(s) assigned to unit.

Trailers

The column with information about trailers. In the tooltip you can see name and photo of

trailer(s) bound to unit.

Clear list

Buttons to remove individual units/groups from the work list or clear the whole list at once.

For further information about columns and icons in the Monitoring panel see

Icons Explanation

138

User Settings dialog on the Maps tab.

Maps

Maps settings are adjusted in

Format of coordinates

Format of coordinates can be either degrees or degrees and minutes. Selected format affects coordinates of cursor displayed in the lower right corner of the

map . However, in messages and POI coordinates can be displayed only in

degrees; in reports and event registrar – only in degrees and minutes.

Map position at startup

There are two positions of the button – Store current and Reset to defaults. The first one is used to store current map position and zoom and use it for further logins. To make use of this option, exit the dialog and

move/rescale the map to

the desired position. Then open the settings dialog again and push the button Store current.

If there are any monitoring units displayed on the map, the map loaded at startup is resized to make them all visible, and it does not matter what default or current positions are.

When a custom position is stored, the button changes to Reset to default state. It is then used to restore the default map position. After pushing the button you can leave this default position or set a new custom position because the button changes to Store current state again.

Enable…

Tick the appropriate check boxes to activate more map layers. The changes will take effect after clicking OK and refreshing the page. To choose a different map as a base layer, choose it in the

maps menu at the top panel of the

program.

The following maps can be used in Wialon Hosting: Google Maps, Microsoft Virtual Earth, Yahoo Maps, Kosmosnimki,

2GIS, WikiMapia, Navitel, Visicom, Regio, Yandex, MyIndia. 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 . Apart from that, traffic layers are supported for Google and

Yandex maps.

If a map you need is not available, address your request to your service provider.

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

Render geofences/POI on server

139

By default, all

geofences and

POI

are rendered in browser. It can considerably slow down browser work especially if your computer is not very powerful. However, if you have good Internet connection and enough traffic, it is reasonable to choose geofences/POI rendering on server.

140

User Settings dialog contains two sections: General and Statistics. In the General section

Account

Attention! This tab can be not shown to end user.

The Account tab of

information on billing plan and current balance is presented. You see also how many objects (like places, geofences, devices, users, etc.) you can create and how many of them already exist.

In the Statistics section you can make an inquiry about charges for different operations produced over a given period.

Specify the period of time and push the Show button to see statistics.

141

Tracking is performed in the main window. In the work area

Monitoring

Unit tracking includes: detecting unit position and watching its motion; unit management (sending messages, assigning jobs and drivers, adjusting notifications, etc.); supervising unit parameters such as speed, fuel level, temperature, voltage, etc.; interpreting information derived from the unit.

Table of Contents

Monitoring Panel

choose Monitoring. The work list being under control at the moment is displayed there. These can be 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 are a number of

buttons and signs which allow to estimate unit state or perform an

action over it. The choice of signs and buttons to be displayed in the Monitoring panel is customized in

. These columns can be also used to sort units on the work list.

=> Monitoring Panel

Unit Info Tip

Hover the mouse pointer over the unit to see detailed information about unit current state in a popup info tip.

Information to be displayed in the tip is selected in User Settings

For example, a unit info tip can look like this:

142

Monitoring Modes

Two monitoring modes are available: tracking by units and tracking by

unit groups . In the first case, each unit is

displayed on the work list and can be shown on the map individually. In case of group tracking, unit groups are displayed on the list and units from a group can be shown on the map only all together.

More about group tracking...

Tracking mode is selected in a special menu in the Monitoring panel.

143

. The map will be centered by

Tracking Units on Map

To locate a unit on the map, click on its name in the

work list

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.

Table of Contents

Unit Presentation on Map

However, if the option Show unit icons at map borders is selected in

User Settings , in

case a unit gets out of view, its icon is displayed by map border. Click on the icon to move to the unit on the map.

It is possible to watch a unit constantly. For this, enable the option Watch unit on map against a necessary unit in the corresponding column ( ) of the

Monitoring panel . Units marked in this column are always seen on the map. If

such a unit gets out of view, the map automatically centers at this unit each time when a new message comes.

Tracking on Minimap

You can use minimap for tracking. This is an additional small window which opens in the right bottom corner of the map. Only one unit can be dis[played on this map. Position and scale of the minimap can be different from the main map. So, you can simultaneously track a unit on the minimap and manipulate the main map in different ways – track other units, create geofences, generate reports, etc. At that, the selected unit is always in sight on the minimap, and its position is refreshed automatically with each new message.

To open the minimap, press the special button at the bottom of the window. The minimap has three modes and three functions correspondingly:

1.

2.

– navigation through the main map,

– tracking a unit on minimap,

3.

– tracking a unit in 3D mode on Google Street View.

The first (navigational) function was described below

. To track a unit on the minimap, click on it on the main map.

The minimap itself can be open before or after clicking on a unit.

In the tracking mode, the minimap cannot be moved – it is centered automatically by unit last location. However, you can adjust the zoom level using +/- in the top left hand corner of the minimap. Above there is a button to switch

144

between navigation and tracking modes.

The tracked unit must be checked in the first column of the work list

in the Monitoring panel. Otherwise, if you disable this flag, the unit will disappear both from the main map and from the minimap, and the minimap will automatically switch to the navigational mode.

On the minimap a unit is represented by its icon and its name (or driver's name). Motion state signs, trace from last messages, and sensor-based colors are not available. If you hover the mouse cursor over the unit, you can see

unit info tip

with the newest information about the unit. If you click on a unit in the minimap, the main map is centered to this unit too.

In addition, the third mode of the minimap can be activated — Google Street View . It allows to track units on 'real' streets. Google Street View is a technology featured in Google Maps that provides panoramic views from various positions along many streets in the world (mainly in Western Europe, North America, Australia, Japan, Brazil, and some others). You can observe buildings, roads, any surrounding objects which creates an illusion of virtual presence.

The third mode of minimap works only if Google Maps are activated in

User Settings and if there is

coverage fir requested geographical area.

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

=> Image . Unit icon can be rotated on the map according to course (movement direction). This feature is also defined

in unit properties.

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 arrow's direction shows movement direction.

145

This option is called Replace unit icons with motion state signs and set in

functionality is adjusted in Unit Properties => Advanced

Besides, the colors of these icons (arrow, square, circle) can be different and dependent on a sensor value. This

(Sensor color in the Monitoring panel). In other words, the shape of the icon is defined by state (if standing – square, if moving – arrow), and the color depends on sensor value (intervals and colors are adjusted in unit properties).

Alternatives for Names

Unit names can be: disabled – the

button in the ground panel

; replaced with drivers' names – the option Replace unit names with drivers' names in

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

Both direction arrows and traces can be disabled. To do this, use the appropriate buttons in the

ground panel :

– hide/show unit traces;

– hide/show unit movement directions.

146

User Settings => Monitoring Panel

Icons Explanation

The list of all icons which can be found in the Monitoring panel is presented below. Depending on your individual needs you can hide or show certain columns in the dialog

All icons can be divided into two groups:

1.

Operational: icons -buttons, if pressed they allow to perform an action over a unit (such as event registration, command execution, messages query, track building, properties editing, removal from the work list, etc.). Further instructions can be found in appropriate dialogs and panels which are invoked by these buttons.

2.

Informational: icons which 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.

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.

The button to sort units by name in direct order.

The button to sort units by name in reverse order.

The button to add units/groups to the list using a

filter .

The button to add all available units/groups to the

work list .

A column with units' last addresses. 'Resolving' means an address is being searched. 'N/A' goes for units which addresses are not available, for example, in situation when a unit has never sent any messages. If you press the icon in the header, units in the work list will be sorted according to their location (by alphabet in direct or reverse order. Address format can be selected in

User Settings => Map .

You can register an event.

Not enough rights to register an event for this unit. \\See Events Registrar

for details.

In this column sensor state can be shown

(if the appropriate parameters are set in

Unit Properties => Advanced => Sensor color in the Monitoring panel ):

– the value is unknown (or the option is not activated for this unit);

(or a small square of any other color) – visualizes sensor's value. When putting a cursor over the square, in the popup window you can see the value or description.

Mark a unit to fulfill its active tracking. That means it will be always in sight when a new message comes from it. If pressing the button in the head of the table, all units selected to be shown on the map (ticked in the first column) will get into active tracking.

The button to send a command or a message

to unit:

– there are available commands,

147

– 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 to execute them,

– there are no commands available.

Unit state:

– 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 stationary;

– the last message from unit was received over an hour ago: unit was moving.

Unit state is detected according to its speed value in the last message and ignition sensor state (is there is such).

Apart from that, if unit is stationary in the tooltip you can see for how long (the current session data is taken into account as well as the last message from unit before you have logged in).

This column indicates data accuracy.

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

To know the precise time of the latest information update, place a cursor over the icon and read a tooltip.

Unit connection to server:

– unit is connected,

– unit is not connected.

Unit is considered to be online if it has TCP or UDP commands available or it has sent messages within last 10 minutes.

View

pictures sent by unit:

– the button to load pictures,

– no pictures available.

Send SMS to unit or driver (the addressee is selected in the dropdown menu if both options are available). To

explore the full functionality of this option, the current user must have rights to send SMS messages, access to unit at least at execute commands level, a driver must be bound to the unit, and both (units and driver) must have phone numbers in their properties.

You can send an SMS to unit or driver.

SMS sending is not possible.

Fast track building. The button can obtain several states:

– show track on the map,

– remove track from the map,

– not enough rights to query tracks for this unit.

View messages received from unit (see

Messages ).

Display

unit or

group properties dialog]]. In case of groups, the button may have different looks depending on your

access level:

– there are properties that you can edit,

– only view access.

In this column

driver's

small photo is displayed. Put a cursor over it to see enlarged photo, driver's name and phone number.

– No driver assigned.

— a driver assigned has no photo.

— several drivers are bound to the unit.

The similar column with

trailers . If a trailer is bound to the units, its small photo is displayed, and in the tooltip you

can see trailer's name and enlarged photo.

— no trailers bound.

148

— a bound trailer has no photo.

— several trailers are bound (see more information in the tooltip).

An additional menu that can contain any of above mentioned buttons and signs. Its contents is adjusted in

Remove all units/groups from the work list (the button is at the top of the table). See Unit List Management

– remove a particular unit/group from the work list (the button is situated against the selected unit).

149

Deleting Units from the List

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 display on the map but also how you manipulate units on other panels when creating jobs, notifications, routes, querying messages, reports, and tracks, assigning drivers or trailers, looking for nearest units, etc.

Sorting Items

For your convenience, the 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 .

Table of Contents

Dynamic Work List

Besides, it is possible to sort the items on the list by other attributes like motion state, connection quality, etc. To do this, push the appropriate button in the head of the table. Possible filters:

last location;

motion state,

last message time,

commands availability,

online connection state,

sensor state availability,

quick track availability,

pictures from messages 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

User Settings => Monitoring Panel .

Units Search

It is not needed to display all available units on the working list. Units can be easily added to and removed from the list. Sometimes it is more convenient to work with a certain group of units and have it on the screen.

To add a unit or several units to the list, push the asterisk button at the head of the table and set search parameters.

Select the criterion of search (Search by dropdown list): by name, creator, phone number, unique ID, device type, access for user, geofences, unit groups, sensor, custom field, driver, trailer.

Then formulate your inquiry in the Filter field. For example, to find all

MANs, select search by name, and in the template field type *man*

. All units 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.

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.

The most of search parameters (except geofences, drivers, and trailers) are taken and can be viewed and changed in

150

Unit Properties .

If you need to add all units from a

unit group

, select a search by unit group, and in the template field enter the group name (or a part of the name).

After the first search is complete, another search can be done on the second 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.

Add Units to the List

To display all available units on the work list, use Add all available button. Note that the option is disabled if

dynamic work list

is used.

To add search result to the working list, press the green plus-shaped button. The found units will be added to the list.

To replace existing working list with search results, press the tick-shaped button.

To add a single unit form search results to the monitoring list, double-click on the needed unit.

Apart from that, if the checkbox Show added units on map is enabled, all units being added with any of described methods get not only on the work list but on the map, too.

Deleting Units from the List

A button against each unit to delete 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, go to the

Nearest Units tool operates with the work list dynamically updated in the Monitoring panel.

panel.

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

user settings

on the Monitoring Panel tab. Change Without filtration option to

Monitoring panel or Panel + Map and specify filtration interval in minutes. The filtration can affect only the work list in the monitoring panel or both the work list and the map.

ATTENTION!

With this mode enabled, some other functionality becomes not available or operates in different way:

1.

Manipulations with the work list (such as search, addition and removal of units) are impossible.

2.

Unit lists displayed when creating jobs, notifications and routes, querying messages, reports and tracks will contain not units from the work list as usual but all available units.

3.

However,

4.

The filtration by last message time does not affect the work list if the mode of unit group monitoring

is selected.

151

Commands

Command is a request which is 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

Commands from the Monitoring

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.

—

— output number output number time interval (from – to)

Table of Contents

Panel

Chat with Driver

Standard Commands

13 standard commands are reserved in Wialon Hosting:

Icon Command

Name in the system

Query position

(get unit current location)

Block engine

Unblobk engine

Activate output

Deactivate output

Download messages query_pos block_engine unblock_engine output_on output_off download_msgs

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

Send message to driver

Send position driver_msg send_position

Upload configuration upload_cfg

Upload firmware

Query snapshot upload_sw query_photo

Parameters

interval in seconds command text message text coordinates path to configuration file path to firmware file

—

If your device supports a command which is not mentioned on the list above, this command can be sent anyway. To do this, use the standard command Send custom message . In this case you should know exact name for the command (how it is written in device configuration).

Command can hold predefined parameters of its execution. This is adjusted for each unit individually in its properties

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.

152

From a mobile device with the help of Wialon Mobile v1

Information about commands sent to a unit is available:

In the

Messages panel (all commands sent to unit).

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 User Settings

dialog. 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 . Further more, 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, etc. (depending on command type).

4.

Press OK. The command will be executed immediately, and its result will be reported in the

log . To show

or hide the log window click on the double-arrow in the right bottom corner of the window.

Note.

If a commands 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.

Chat with Driver

153

Operator (dispatcher) can exchange messages with

drivers . To do this, select the command Send message to

driver and type a text.

In case the driver answers, driver's message will popup in a special window. New message can be accompanied with

a signal (see User Settings

. If you have unread messages, the icon at the bottom of the window near the messages button blinks, and in its tooltip you can see the number of unread messages.

Newly coming messages are added to the top of the list. The headers of unread messages are highlighted with a blue background. To expand/hide the full text of a message, use the switch button plus-minus.

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. Usually, the window closes automatically if you delete all messages. However, you can remove the flag Close window after deleting all messages, and then the window will remain even without messages.

To simply hide the messages window, click on the Messages button at the top of the browser. To display the messages window again, click on the same button.

The operator can quickly send a reply to the driver (a command of the appropriate type Send messages to driver should be configured in unit properties in advance). When clicking on the green triangle-shaped button, command executing dialog appears and the operator can type the messages and send it.

Besides, you can generate a report called Chat

, which will contain all chat history including operator's messages and driver's answers.

154

Sending SMS messages

SMS messages can be sent to drivers, units, and to any phone number. SMS dialog is accessible in

Monitoring ,

find a needed object on the list, use the dynamic filter

, and

Drivers

panels as well as in the

ground panel

of the program. The buttons are not shown if the current user does not have enough rights to send SMS messages.

In the dropdown list Drivers/Units select addressee. Below there will be displayed the list of objects of the selected type which have phone number in their properties. Phone number is displayed in brackets after object's name. To quickly

On the right of the dialog the phone number of the selected element is displayed. It is taken from the object's properties. However, you can input any other number in

international format .

As you type your message, below you can see the number of symbols used and the number of SMS messages which are needed to send your message. Remember that letters of the Latin alphabet are optimal.

After you have typed the text, press Send. After that, in the dialog as well as in the log there will be a record about how

successful the operation has been.

A driver can send SMS to a dispatcher from his phone. This phone number must be indicated in

driver's properties

Drivers' messages appear in the

log

and popup in a special window (the same as for drivers' messages sent from a device in the form of a

command

). Besides, if there are unread messages, a blue envelope will blink in the bottom panel . To reply to an SMS, click on the SMS button against the message.

If you have the Advanced Reports module in your package, SMS chat of a dispatcher with a driver can be shown in a

special table called SMS .

155

notifications . Other events such as fuel

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

geofences ,

sensor

values, etc. can be detected automatically be the system with the help of

filling, maintenance or any custom event 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 in

User Settings => Monitoring Panel

Attention!

To register events for a unit, the access right Register events is needed. In the other case, the registrar button is dimmed.

Push the registrar button and choose one of four types of events to be registered:

make a record in unit log , register custom event ,

Table of Contents

Registered Events in Reports

Make a Record in Unit 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 report

generated for this unit (query the Log table).

To add messages to unit log, you should have not only Register events access, but also Manage log access.

Register Custom Event

Select Register custom event in the registrar and press Next. Give the event a name, enter description and choose the place.

There is a possibility to save events descriptions to speed up the process. To do this, enter your description and press

Store. The description will appear below in Stored descriptions. To select a previously saved description for a

new event, just click on one of them. To delete a saved description, select it and press Delete.

156

If you check Violation, the event will be registered in unit history as violation, otherwise it is registered as simple event. It means this event will appear in different kinds of reports:

Events

Violations .

Register 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

Register Filling

In the Monitoring panel you can register fuel fillings for units manually. Manual registration helps to estimate the difference between registered and detected fuel, compare consumed fuel with consumption rates, calculate running costs, etc.

In the registrar select Register filling and press Next.

Enter the volume of filled fuel in liters and the cost. Fractional numbers (up to hundredth) can be also used for fuel volume and cost. To enter fractional numbers, use point as delimiter. For example, to register fuel filling for 77 dollars and 88 cents you enter '77.88'.

Entered values will be automatically added into the Description field below. If necessary, you can edit the text manually. Then enter date and time when the filling happened and possible deviation from this time in minutes.

Besides, it is possible to indicate the place where the filling happened. To do this, press the Select Location button.

The focus will switch to the map, and you can indicate the place by double -click. The address of the place will be detected by Web-GIS and written in the Location field. Press the Reset Location button to clean this address and indicate another one. Besides, you can manually edit this field (for example, you can add gas station name). When the focus is on the map, the dialog moves to the top left-hand corner, and the Restore Dialog button appears. If you [ress it, the dialog becomes active again even if you do not indicate any place on the map.

Register Maintenance Work

In the registrar choose Register maintenance work and press Next.

Enter the following data: kind of work (type from the keyboard or select from available service intervals on the right),

157

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 which were done that time. This this action the interval selected will be zeroed and will start the count again. Note that if you select anything here, the contents of 'Kind of work' field changes.

Attention!

Registered events are not editable, however, they can be deleted from the database in the

Messages panel (special

access is required).

Registered Events in Reports

Registered fillings and maintenance can appear in the

report on events together with other things. Registered custom

event depending on your choice can get into report on events or

report on violations . Both report 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.

Time received

Date and time when event was registered.

Column Content

Event text

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

Location

Unit location at the moment of event. It is taken from the coordinated indicated while registering th event

(the Select Location button and double -click on the map). If Web -GIS has address information for these coordinated, this information is given in this cell of report.

If any of above mentioned fields are not filled correctly, then the corresponding columns will be empty.

Other reports which use registered events are

report on maintenance and

utilization costs

158

Sometimes it is more convenient to track units by groups. To switch to the mode

Unit Groups Monitoring

of unit groups monitoring, select this option in the Monitoring panel.

Table of Contents

Unit Groups

Monitoring

Sending

Commands/Messages to Unit Group

Groups are added to the work list using the filter . The rules of using the filter are the same as for units (see

Unit List

Management . One can search groups by name, unit or creator. To add all available groups to the work list, press the

button .

The

icons

described above are used on the work list. When hovering the mouse cursor over an icon such as Motion

state, GPRS connection, Information accuracy or Sensor state, in a popup tooltip you see information about all units in group. To adjust columns to be displayed on the work list, go to

User Settings => Monitoring Panel and select/unselect

items in your own way.

Here is the list of all columns available in the group mode:

motion state (moving/standing, engine on/off),

information accuracy (the number of satellites locked and last message time),

connection state (connected/not connected),

sensor state,

display group properties dialog,

execute a command over a group of units,

remove a group form the list (but not form the system); if pressed at the head of the table, all groups are removed.

The check box before each group on the list is to show or hide units icons on the map.

Sending Commands/Messages to Unit Group

To send a command or messages to a group of units, this command should be added to each of those units in their properties dialog on the

Commands tab. More further, it should have the same name. The second condition is that you

should have enough access rights

to execute this command over selected units.

The procedure is as follows:

1.

Click on the button against the needed group.

2.

In the dialog you will see a list which have at least one command available at the moment. Select necessary units and press Next.

3.

Select a command from the list of available commands.

A green sign against each command indicates that all of the selected units support the given command.

A yellow sign with the exclamation mark means that not all units support the command (see details in the tooltip).

4.

Set additional parameters if needed. For example, input/output index, report interval, etc.

5.

Press OK. The command will be executed immediately, and its result will be reported in the

159

User Settings => Monitoring Panel

Pictures from Messages

If the equipment supports such a possibility, units can send pictures together with messages. Pictures can be viewed in the Messages Mode as well as in the Monitoring panel. To display a special column in the Monitoring panel, activate the option Picture from message in

After pressing the button, picture viewer will be displayed. You can view all the pictures received during the current session as well as the latest picture received before you logged in.

The above mentioned way is to view pictures of a certain unit. To view last pictures of all units, press the pictures button at the bottom of the screen.

To move between images, use arrows. Between them you can see the number of the pictures viewed and the number of available images. Pictures are sorted according to the time they come to the server.

Above each picture, there is its date and time. Under each picture you can see a unit name and address information from the message.

Some pictures can be enlarged with a special button in the right top corner. To close a picture viewer, use the button in the right bottom corner.

All images received from a units can be observed in

reports .

You can get a picture from a unit at any time using the Query snapshot

command .

160

icons . Clicking on a unit, you get more information about it (last message

Locator

Using the locator, you can make information about your units available on outside sources (i.e. other Internet sites).

Units are displayed on the map with their

time, actuality, speed). The feature works only with Google Maps.

This option is enabled in

and called Enable public access to locator page. Tick the box and save changes. Then open the dialog again and follow the locator page link to see how it will look and pick up its address.

Note that units do not move in the locator. To get the latest information about them, you need to refresh the Internet page each time (press F5 to do this).

Attention!

When the public access is enabled, it means any who knows your login can track your units.

To integrate the locator to your web site, use the following code (replace user name gurtamcebit with any other):

u=gurtamcebit&zoom=14&lang=ru" width="700" height="400"></iframe>

Possible zoom grades are from 1 (small scale) to 18 (vast scale). If the map zoom does not match to covet all the units being watched, then the map will be rescaled automatically. That is why in most cases it is effectual to choose the largest scale (18).

If you are going to use the link to the locator on an external site, you may need to adjust a custom zoom for the map.

Below, it is shown there the zoom level is written in the locator address.

../locator/index.html?u=locator1&zoom=13&map_type=1

161

the points from where messages came. Each point stores also date and time when the message was received and

Tracks

Required access to unit is Query messages or reports.

Track is a line drawn on the map to show how a unit moved during the indicated period of time. A track is mapped by

coordinates at the point as well as other parameters (speed, sensors etc.).

Any number of tracks can be drown 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 build tracks, go to the Tracks panel in the

vertical menu .

162

for the track (color, thickness, etc.).

Mapping a Track

To build a track in the Tracks panel, do the following:

1.

Select a unit in the drop -down list. Its contents depends on the

work list in the

Monitoring panel and access to those units.

2.

Adjust desires

parameters

3.

Define a time interval within which you want to get the data.

4.

After filling in all fields, press Show Track.

Table of Contents

Mapping a Track

Invalid Tracks

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 is too long to wait the track to appear on the map, it may mean you have indicated too large interval or your Internet access rate is 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 Monitoring panel with the help of fast track buttons.

In the

Messages panel when viewing data messages.

In the

Reports panel if the appropriate option is selected in report template.

Invalid Tracks

When mapping a track you can get a dashed line that means that some track coordinates are doubtful. It may occur if there were no coordinates at all or they were invalid. This situation may be caused by connection loss or poor satellite visibility. Connection loss is detected according parameters set in

unit properties

on the Advanced tab (see the options

'Maximum interval between messages' and 'Minimum satellites').

163

track can be built with one click of a mouse, straight from the

Quick Tracks

Monitoring panel. There is a special column named Quick track which can be enabled in

. There you also specify the interval for fast track building: current day, last 24 hours, last complete day or other

(manual mode).

When pressing the Show Track button opposite a unit, a track of this unit appears on the map. To remove the track from the map, press the same button again.

Many parameters for quick track building are borrowed from the Tracks panel: line width, annotations, trip detector, etc.

In case of manual mode , the time interval should be also specified there. Track colors are set in unit properties

(Advanced tab) or in the Tracks panel as well.

All fast-built 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.

164

track , it is impossible to change its parameters (time, unit, color,

Track Parameters

After you have built a

Track Color

annotations). In case of error, delete incorrect track and create a new one.

Table of Contents

A track can be of one color or different colors depending on detected speed or sensor values registered on a segment of the track. The single color is selected in the palette in the Tracks panel.

Other colors for tracks are adjusted in Unit Properties => Advanced

. If in unit configuration one of the options (Speed

based track colors, Sensor based track colors) is selected and intervals and colors are set, a track can be multicolored. These colors can be changed only through unit properties dialog. You can alter unit properties rights in the Tracks panel – user the Edit button against the unit.

If no colors are adjusted in unit properties, then the recently used single color is applied to the 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.

Annotations

Indicate weather 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 get from the tooltip that appears when you hover the cursor over a point.

165

Trip Detector

Trip detector flag affects distance value and track visualization. For example, in places of stops and parkings there will be just one point instead of conglomeration of points, and the mileage will include just intervals detected as trips. Trip

detector is set up in Unit Properties => Trip Detector

Like in the Messages panel, distance is calculated by coordinates (it does not depend on mileage counter). That is why distance in tracks can differ from mileage in reports.

166

tracks on any unit for any time interval. The list of tracks created will be displayed in the work area at the

Tracks Management

You can add

left. To prevent tracks merging, select different colors for them.

Hover the cursor over track to get accurate information about track point (points where messages were received).

Messages are searched in the radius of 50 pixels to the cursor. Points found are highlighted by small green circle, and a tooltip appears with the following information: time, speed, coordinates, satellites, altitude, and sensor values.

Messages with zero speed are marked with bigger points.

Note.

If track is snapped to roads, some points may be located not exactly on the track.

You can manage tracks in the left part of the window under the Show Track button. Newly built tracks are added to the top of the list. Unit name is displayed on the list as well as travelled mileage. Like in the Messages panel, distance is calculated by coordinates (it does not depend on mileage counter). That is why distance in tracks can differ from mileage in reports.

It is possible to view all created tracks on the map simultaneously or select just some of them. The tracks marked with flags are displayed. Unmark a track to hide it. Using the checkbox in the header you can select/unselect all tracks at once.

Use the arrows to quickly locate the initial/final point of the track. To see the whole track and center the map on it just click on its name in the list.

To delete a track, click on the appropriate button against it . Using the same button at the header of the list, you can delete all tracks at once.

Special tools can be applied to a track:

Hittest – allows to get the exhaustive information for any point of the track.

Track Player – allows to playback the track.

167

addresses in reports (in the 'Location' columns).

POI

POI (point of interest) is a place on the map that has some importance for you and requires a special attention in the tracking process. Each place can have its image on the map (an icon). In addition you can add any comments.

In Wialon Hosting, POIs have various applications:

POIs visually enrich the map by marking important places.

In POI tooltip you can get dynamically updated images from external sources (video from web cameras, photos of crossroads, weather, etc.).

POIs can be used as

POIs can be used as check points for

routes .

To create and manage POIs, open the POI panel in the

work area on the left of the screen. Here the list of all created

POI is displayed.

Learn more:

Creating POI

POI Management

168

POIs are created on the POI panel. Press the New button and double-click on the map to locate a new POI. Fill in the

Creating POI

To create POIs, you should have Create, edit, and delete POIs access at least to one resource.

Table of Contents

Creating POI

POI Properties

dialog of

POI properties

(at least, name is required) and press OK.

An alternative way to create POIs is to import them from a file or another resource.

POI Properties

Name

Name is a required parameter for a POI like any other system object. It can be of one or more symbols. Besides, you can specify font color and size for the caption. It has sense if POI names on map are enabled in

Default radius for a POI is 100 meters. It can be used for address detection in reports as well as to display the POI on

Image

Each POI can have its own image. An image can be chosen from the standard icons (Image Library button) or loaded from your computer (Load Image button). Supported formats are PNG, JPG and GIF. All loaded images are automatically resized by 64×64 pixels to display the POI on the map and on the list. However, in the tooltip for the POI you can see enlarged image (up to 256х256 px).

Description

When you create a POI, this field is automatically filled with address information for the point. However, you can edit it and write any custom description. Its length is not limited. You can use html (including iframe) tags in descriptions in order to format text or get images from other sites. For example, you can embed video from web cameras, get photos from crossroads, load weather or currency exchange, etc.

Latitude & Longitude

Coordinates are indicated automatically depending on the point on the map you have double-clicked when creating the POI. However, you can edit coordinates manually if necessary.

Visibility scale

Visibility scale is map zooms at which POI will be displayed or not. For example, if a POI is a city, it has sense to see it on remote scales, whereas if a POI is a building it is more logical to see it on more detailed scales. Graduation of scales corresponds to map scales used in Gurtam Maps (this scale is traditionally displayed in the bottom-left corner of the map).

Radius

169

the map. Tick the Show circle checkbox and choose the color if you want the POI to be displayed on the map as a circle with the specified radius.

When finished, press OK. The newly create POI will appear at the bottom of the list. However, when the list is reloaded, the POI will take its place according to the alphabet. At that, the flag to display the POI on the map will be enabled.

Further information – POI Management

170

POI are sorted by name. To quickly find a certain place, use the

POI Management

dynamic filter above the list. Begin to input the name

of a place and see the results. To move to a certain POI on the map, simply click on its name on the list.

In the first column of the table, tick those POIs that should be seen on the map. Put the flag at the header of the list to select/unselect all POIs. POIs can be presented on the map by their names (default color is orange), attached images and circles as well as any combination of these three items. Overlapping POIs can be grouped under one icon.

Parameters of POI visualization are adjusted both in

POI properties and in

If you have too many POIs to show on the map, it may slow down browser

performance. In this case, enable the option

of rendering POIs on server (see User Settings => Maps

Place a mouse cursor over a place name on the list or on the map to see related information in a tooltip: name, coordinates, visibility scale, radius, description, enlarged image, and a resource which the POI belongs to (if there is access to several resources). If POIs are rendered on the server, only name and description can be displayed in the tooltip. If the description contains links to any external content, it is shown in the tooltip. For example, a tooltip of a POI can look like this:

All POIs regardless resource they belong to are displayed on the list. However, you can easily filter them by this parameter. To do this, in the dropdown list choose account name to display only POI belonging to this resource. This

filter is not displayed if the current user has access only to one resource. To find a POI by name, use the dynamic filter

The following buttons can be used to manage created POIs:

171

Change POI location.

When you push this button against a POI, a red marker appears on its place. Double-click on any other place on the map to move your POI there and press Save. Otherwise, press Cancel to ignore changes.

Edit or view POI properties.

These buttons are used to open

POI Properties dialog where you can edit POI or just view its properties

(depending on your

access ).

Delete POI.

To remove place, press the Delete button against it and confirm your intension. You can even delete several POIs at once if you check them and press the Delete button at the heading of the table.

Note.

If you have not enough rights for a resource (you have View POIs but do not have Create, edit, and delete POIs), you cannot move, edit or delete its POIs. That is why the corresponding buttons are dimmed.

172

work area on the left. Here you can view, create, edit, and

Geofences

Geofence, or geographical zone, is some area on the map that is important for your tracking purposes. Geofences can be used to control unit activity in these areas or, on the contrary, outside them.

A geofence can have a shape of a polyline (for example, an avenue or any road), polygon (a city or park or plant) or circle with any radius.

To work with geofences, open the Geofences panel in the

delete geofences.

173

A quick way to map a geofence is by using the

Creating a Geofence

Here are three steps to create a geofence.

1. Map Geofence

Table of Contents

After you have pressed the New button, a help window appears to provide you with the instructions about drawing geofences. Choose a geofence type on the left: line, polygon or circle.

Then map a geofence. Here are the basic rules for mapping a geofence:

Double-click on any place of the map to put the first point. Then add more points using the same method. Put the points as close or as far from each other as you want.

To insert a point between two other points, double-click on a segment between them.

To move a point to another place, click on it and holding the left mouse button drag to another place on the map. Then release the mouse button.

To delete a point, just double-click on it. Note that points can not be deleted if there are only two points

– for lines, or three – for polygons.

Hint.

Routing tool

(create lines) or

Address tool

(create circles).

2. Set Geofence Properties

Name: a geofence name that is used while tracking units as well as in reports and notifications.

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

However, you can edit it or delete at all.

Type: line, polygon or circle. For line you also have to indicate its thickness, for circle – radius (in meters).

Account: this dropdown list is shown if the current user has the access to more than one account.

Area & Perimeter: these fields are not editable, they are calculated automatically when mapping a geofence.

Address source: check this box if you want to use a geofence instead of a usual addresses. In this

174

case, a geofence name can be used in reports in the location columns. It happens if Geofences as

address source option is activated in the

report template

Ride beginning/end: these parameters are important for

reports on rides

. The same geofence can be simultaneously the end of one ride and the beginning of another, but cannot be the beginning and the end of one ride.

Color: choose a color using the palette or enter a color RGB code. This color will be used to display a geofence on the map and show its name in a unit info tip (if a unit is located in this geofence).

3. Save Geofence

When finished, press Save. In case of a mistake, press Clear and try again. To close the create mode without saving results, press Cancel. Created geofence appears at the end of the list and on the map.

Note/.

Geofences can be saved to a file and easily

imported and exported from one resource to another.

175

or not (depending User Settings

Geofences Management

In the work area there is a list of all created geofences. Put check marks in the left column to choose geofences to be displayed on the map. Unselect this box to remove geofences from the map. Geofences can be displayed with captions

). If you have ticked too many geofences or they are very big, it can slow down browser

performance. In this case, the option to render geofences on the server can help (see

User Settings => Maps ).

Geofences are given in the alphabetical order. When you create a new geofence, it appears at the end of the list with map checkbox enabled. However, when the list is reloaded, new geofences take their places according to their names.

Placing a cursor over a geofence name, in the popup tooltip you will get all the information about a geofence type, its parameters (ride beginning/end, address source, description), and the resource where the geofence belongs (if you have access to more than one resource).

For your convenience, there is a filter with several predefined criteria to sort geofences:

By some property:

All geofences;

Geofences used as address;

Ride beginning;

Ride end;

Ride beginning and and;

Polygons;

Lines;

Circles.

By resource:

Here is a list of all resources available for the current user (if there are more than one). Click on any of them to display geofences belonging only to this particular resource.

To quickly find a needed geofence, you can use the dynamic filter above the list. Type a geofence name or a part of

the name and observe the search results.

Here is an explanation of icons and buttons used in the Geofences panel:

Shows how many units are there within a geofence at the moment. To see these units, place the cursor over the number. If there are question signs (? ) in this cell, it means the option is disabled. To activate it, go to

Settings and check the item Presence in geofences.

The button to edit geofence properties (size, shape, name, color, position, etc.).

The button to view a geofence properties (editing is disabled).

The button to copy a geofence. You can edit a geofence and save it under another name.

The button to delete a geofence. To delete several geofences at once, check them in the first column of the table

and press the delete button at the top of the list. If the button is dimmed, it means you have not enough access rights to the resource which the geofence belongs to.

The button in the header of the table to delete selected geofences.

176

unit info tip . For this, check the option Presence in

Usage

Table of Contents

While Tracking Online

Usage

While Tracking

Online

Geofences can be displayed on the map and mark some area of interest and simplify visual reception of the map. If a geofence is displayed on the map and the mouse cursor is

In Notifications

In Reports

placed over it, you can press <ctrl> to see its name, area, perimeter, and the list of units located in this geofence at the moment with addresses where they are. Perimeter for a line is its length (line thickness is not taken into account).

If geofences are rendered on the server, only geofence name is available in the tooltip.

If a unit is situated in a geofence, this fact can be shown in

geofences in

In Notifications

You can be notified by e -mail, SMS, online or by other means when your unit leaves a geofence or enters in a geofence. It is possible also to set speed limitations and sensor range for unit during its presence in a geofence.

Besides, on an entrance to a geofence or an exit from it, an action can be performed automatically: send a message to driver, block the engine, change users access to this unit, and many others. See

as addresses (in the Location column), if Geofences as address source is

In Reports

Geofences can be used in reports

checked.

Geofences can be used in many tabled reports, for example:

Geofences

: visits to geofences (all entires and exits to/from selected geofence(s) are given together with visit duration, distance travelled within the geofence, average and maximum speed, etc.).

Non-visited Geofences

: geofences which were ignored (non-visited) during a period of time or on certain days.

Rides and

Unfinished Rides : rides from one geofence to another (convenient to control how a cargo is

transported in several trips).

Geofences can be also used to

filter intervals

in reports.

177

dynamic filter to save your

Jobs

A job is a set of actions to be performed by a predefined schedule. A job can be command execution, sending reports by e-mail, assigning a route, change access to units, etc.

To configure jobs, open the Jobs panel in the

work area . Here you see

the list of all jobs created, information on their state, and the button to create a new job.

On the list, jobs are sorted by name. Use the

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.

Hover a mouse pointer over a job to view details in the tooltip: job type, parameters, last execution time (whether successful or not), and resource (if there is access to several). 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.

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:

—

command execution

;

—

sending report by e-mail ;

—

sending information about fuel

;

—

access management ;

—

manipulate GPRS traffic counter ;

—

manipulate engine hours counter ;

—

manipulate mileage counter .

Clicking on job state sign at the header of the table, you can enable/disable all jobs at once (if you have access rights on them).

Enable or disable a certain job.

The first (left) column shows how many successful executions there were; the second (right) column shows maximum executions allowed.

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 Create, edits, and delete jobs, then it will be

still executable, however, you will not be able to change its state, edit or delete it.

178

To make manipulations with jobs, you should have at least one resource with the right Create, edit, and delete jobs.

Configuring Jobs

To create a new job, press the New button. In the dialog choose job type:

access

Table of Contents

Configuring Jobs

Selecting Units for

Jobs, Notifications, and Routes

Basic Parameters for Jobs

Execute a command over unit(s) ,

GPRS traffic accounting ,

Change access to units ,

Mileage accounting ,

Engine hours accounting ,

Send fuel information by e-mail or SMS ,

Send a report by e-mail .

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, Notifications, and Routes

Access required: Use unit in jobs, notifications, routes, retranslators (resource's creator where the job belongs is supposed to have this access to units to assign then this job).

By default, only units which are on the work list

of the

Monitoring panel at the moment are displayed in the dialog

where you choose units for a

job ,

notification or

route

. If you use the

dynamic work list (formed according to data

actuality), all units allowed for the activity are displayed in the dialog.

If you see no units, try Display all available units/groups option. If it does not help, it means there is not enough access to any of units.

You can switch between

units

and

groups . Use the selector on the left for this. If you select a group, it means the

action will be applied to all units in this group. The list of units is in group's tooltip.

Mark units/groups to apply a job/notification/route to. Put the flag in the header of the table to select all items.

179

While editing a job or notification, this page contains units selected for the job (they are checked) and units displayed on the work list at the moment. You can add more units for the action or remove some. However, only unit with Use

unit in jobs… flag can be displayed here. If a job or notification that you are editing contain units to which you have not enough rights, you will be warned about it and in case you save the job/notification, those unit will be lost.

Basic Parameters for Jobs

These parameters are adjusted in the last page of the dialog:

Name

It is used in jobs list 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 tooltip.

Execution schedule

Two ways to set schedule exist:

(1) Periodic execution: each … hours and minutes.

(2) On schedule. Key in time in the format of hours:minutes or just hours. If you need to indicate several points in time, separate them by spaces.

Activation time

Date and time when the job will be activated.

Maximum executions

Enter the number of job executions after which it will automatically deleted. If you leave this field empty, the job will be executed endlessly until you delete it or disable manually.

Enabled

This check box indicated whether the job is on or off. When creating a job, enable this check box to activate the job just after creation. If this check box is not marked, the job will appear on the list anyway, and you can activate it later.

Time limitations

In the right part of the dialog one can define time limitations by days, months, time, etc. For instance, the job can be assigned to a unit just on weekdays and within working hours from 9 AM to 6 PM. Or you may want to reset traffic counter once a month on the first day of the month. To do this, select the day 1.

180

Job name and schedule are required fields, other parameters are optional.

181

More about executing commands...

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 which are configured in selected units (if you have Execute commands rights to these units).

Not all of selected units may be able to execute a chosen command, and it is seen from the indicator:

a green sign means that all selected units support this command;

a yellow triangle means that not all of selected units can perform it (see details in the tooltip).

Restrictions can be placed due to access rights or device type used.

For some commands you should set additional parameters like input/output number, online report interval, etc.

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.

182

access rights automatically, for example, if you want to give someone demo access

Change Access to Units

This job is aimed to change users'

for several days or restrict access to working hours.

To configure this job, select

users and assign them new access. On the list there are only users to which you have

access Manage user's access rights.

Check necessary users on the left and indicate access flags on the right. You can set flags, remove flags, or leave them untouched.

Attention!

This type of job can be performed successfully only if at the moment of its execution all 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'.

183

Counters of three types are used in Wialon tracking system: counters of GPRS traffic,

Jobs about Counters

mileage, and engine hours. They can be set up in unit properties.

Jobs about counters allow to automate accounting of mileage, engine hours, and GPRS traffic.

Table of Contents

GPRS Traffic Accounting

This job is aimed to:

1.

Automate

traffic counter reset;

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

report on traffic to see traffic consumption. If

the option is not activated, resets are not registered anywhere.

The option Reset GPRS traffic counter is to set the counter to 0 each time when the job is performed.

Mileage Accounting

This kind of job can help you to fulfill control over mileage counter automatically, according to schedule. With this job you can store mileage counter value in unit history, reset mileage counter, set a new value for it, save its value as parameter in data message.

To set a new value or to reset the counter, choose the option Set new value for mileage counter and input the desired value below (in kilometers). The counter will obtain this value each time when the job is executed.

Set the flag Store counter value as parameter of unit data message to save the counter value as parameter in data message. Later on it can be used to get initial and final mileage for trips. It is recommended to store the counter while the unit is parked, for example, once a day at night time.

The option Store counter value in unit history can be used to store current mileage counter value. It is especially recommended if according to the job properties, the counter has to be reset or altered.

Engine Hours Accounting

This is analogue of the previous type of job but it is applied to engine hours sensors.

184

If you store engine hours sensor as parameter in data message, you can use this parameter to create engine hours sensor on its basis.

Attention!

This types of job can be performed successfully only if at the moment of its execution all necessary rights are OK. The user who is a creator of the resource where the job belongs should have unit ACL flag 'Edit counters'.

Counters' values (traffic, mileage, engine hours) are stored in unit history as

registered events

, which is needed for creating reports –

Events

Chronology . When counter values are stored as parameters, it means new data

messages are added to unit database. Those messages bear

data message type, and mileage and engine hours are

displayed there in meters and seconds correspondingly.

185

This job can be used to automatically generate and send

Send a Report by E-mail

reports about units activity to your e-mail(s).

Choose report template, file format(s) and parameters. Specify time interval – for previous … days/weeks/months/years.

In the Recipients section enter e-mail address(es) where to send reports.

More about parameters of report export...

In the list of report templates, only those that belong to the same resource as the job are displayed. Depending on template type, you choose appropriate objects for report generation in the next page of the dialog – units, groups, users, drivers, routes, resources, or retranslators. To apply the job for those objects, you should have a special access to them – Query messages or reports (besides, units are taken here from the

work list of the Monitoring panel).

Only compressed files of reports can be sent as a job. Subject for the e-mail is taken from the name of job, and the repository itself derives its name from the report template name plus data (yyyy-mm-dd). After you have received a letter with a report, extract files to some folder and open them with appropriate applications depending on file formats.

Note.

If in your company the workday sometimes finished after midnight (because some vehicles may arrive late at night), then you can adjust the parameters for the daily report in the following way. Select report interval 'for previous 24 hours' and set job activation time at 4 AM. Then the report will be automatically generated every day at 4 AM. It will contain data for the last day, and the trips which finished after midnight will not be broken into two parts.

186

Send Information about Fuel

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

Table of Contents

SMS Format

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

international format . When all slots to enter e -mails and phones are filled, additional slots appear

automatically.

Message form: one unit in one message or all units in one message.

Time offset (in minutes). This parameter allows you to analyze messages from the black box. In this case, time offset value is subtracted from interval beginning and end.

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 (in liters); b – fuel filling (in liters); c – fuel theft (in liters).

For example, SMS message

Iveco_1501

1 66/-/-

187

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

188

To create, edit and view notifications, open the Notifications panel in the work area

Notifications

You can be notified about any unit activity that you consider to be 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 with some other means.

at the left.

Table of Contents

How to Create a

Notification

How to Create a Notification

1.

Push the New button.

2.

Choose unit(s) to create a notification for, and push Next. If you have only one unit available, it is selected automatically, and this page is not displayed.

3.

Select what you would like to control: geofence, speed, alarms, sensor values, message parameter, etc.

Push Next.

geofences, indicate speed limits, etc. Push Next. More...

4.

Adjust control parameters needed for the notification type selected in the previous window: select

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

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.

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

189

In case of this choice, in the following window you select geofence(s) to control and control type: control entries to or

Notification Type

Geofence control

exits from geofence(s). Those geofences should be created in advance and belong to the same resource with the notification. To choose several geofences at once, hold <ctrl> key and click on needed geofences in sequence.

In addition you can narrow trigger case adjusting speed limitations or sensor value range inside (outside) the geofence.

Then the notification will trigger when a unit being inside (outside) a controlled geofence breaks these limitations.

For additional speed control, indicate lower and higher speed limit, and the notification will trigger if beyond the limits.

For sensor control you can set trigger inside the indicated values as well as outside them. Choose sensor types on the dropdown list or set the mask using a wildcard symbol (*). If there will be two or more sensors of the same type or mask found, their values can be summed or calculated separately (select the corresponding option).

Speed control

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.

Alarm button trigger

For this type of notification no specific settings are needed.

Digital input activation/deactivation

190

Specify the number of digital input and select control type: trigger on input activation or deactivation.

Message parameter control

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 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 ans 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 control

Choose sensor

type on the dropdown list or set the mask using a wildcard symbol (*). Preset minimum and maximum values, indicate if you want similar sensors to be summed or calculated separately, and select control type: trigger in the specified range or out of it. If there will be two or more sensors of the same type or mask found, their values can be summed or calculated separately (select the corresponding option).

Connection or coordinates loss

Choose control type:

1.

Connection loss. It can be a simple connection loss when no messages are received from the unit during a period of time.

2.

Coordinates loss . 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.

Idles

For this type of control, indicate speed and time. Speed should be more then 0 km/h in order to exclude possible

191

equipment errors. Indicate also time allowed for staying. If this time exceeded, this will be considered as an idle, and the notification will trigger. In addition, you can activate sensor value control – in this case the notification will trigger only if both conditions are met. It is convenient to control idles with engine on, for example.

SMS control

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 which were chosen for the notification itself.

In addition you can narrow trigger case adjusting speed limitations or sensor value range (like in geofence control).

Excess of messages

With this notification, you can be warned if a unit exceeds the limit of messages you have set. Either usual data messages or only SMS messages can be under control of this type of notification. Indicate the limit of messages and set the reset interval. The example below assumes that the notification will trigger if unit sends 10 or more SMS messages in an hour's time.

Route control

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.

192

Driver control

Choose control type:

deriver assignment or deriver reset. To control both activities, two notifications of different types

will be required. Using this notification you can control all drivers (*) or just some of them – input driver's name (or code) mask.

Trailer control

Choose control type:

trailer

assignment or reset. Settings to adjust are the same as for previous type.

Routine servicing

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 or engine hours or all together. You can control all intervals existing in the

Service Intervals tab in unit properties or just

several intervals. To indicate certain intervals, disable 'Control all service intervals' option and enter a mask using wildcard symbols like asterisk (*) and question sign (?).

Notification about maintenance triggers only once – when a critical point is met (mileage, engine hours or time) about any maintenance interval. Then information about service work done should be delivered through

event registrar or

through

unit properties dialog . Only after that, the notification starts working again.

193

Notification action is the system will react when a notification triggers.

Notification Text

The text of 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'».

Below is the list of parameters applicable to any type of notification:

%UNIT%

%CURR_TIME%

Unit name

Current date and time

%LOCATION% Unit location at the moment when notification triggered

%LAST_LOCATION%

Last known unit location

(may be useful if there is no position in the triggered message)

%SPEED%

%POS_TIME%

%MSG_TIME%

%DRIVER%

Speed registered at the moment when notification triggered

Date and time of the latest message with position

Date and time of the message triggered

Driver's name

%TRAILER% Trailer's name

%ALL_SENSORS% All sensors and their values

%ENGINE_HOURS% Engine hours at the moment of notification

%MILEAGE% Mileage at the moment of notification

%LAT%

%LON%

%LAT%

%LON%

%GOOGLE_LINK%

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

)

194

There are also parameters which make sense only with certain types of notifications:

%ZONE%

%SENSOR_NAME%

%SENSOR_VALUE%

%SERVICE_NAME%

%SERVICE_TERM%

%PARAM_NAME%

%PARAM_VALUE%

%SMS_TEXT%

%DRIVER_ID%

%DRIVER_NAME%

%TRAILER_ID%

%TRAILER_NAME%

%OTHER_UNIT%

%ROUTE_NAME%

%ROUTE_STATUS%

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 interval state – left/expired value (used in notifications about maintenance)

Parameter name (used in parameter control)

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

%ROUTE_POINT% Check point name (used in notifications of route control)

%ROUTE_SCHEDULE% Schedule name (used in notifications of route control)

%ROUND_NAME% Round name (used in notifications of route control)

Note that a parameter must be marked by percent sigh from both sides. Otherwise, it will considered as simple text as is and will be not converted to real values.

195

Notification Action

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.

Display online notification in popup window

A notification can be displayed in a popup window.

event but as violation, and one more report type will be available to you. For further information see reports on Events

Register event for unit

In this case a notification is stored in unit history. Then a report on these events can be generated. If this option is selected.

Register as violation is additionally proposed. If you check it too, the notification will be registered not only as

and

Violations .

Execute a command

For this action, choose a command to be executed over unit(s). The list consists of all commands which are 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.

196

More about executing commands...

Change Access to Units

Choose

users which access rights to be modified when trigger conditions occur. Select access level to be set to this

user after notification triggers: no access, view, execute commands, edit. This feature can be used, for instance, in the following situation. Let us assume, we have created a user to give him opportunity to track his cargo transportation – we have given him view access to a unit which is carrying this cargo. When this unit enters a destination place (a geofence under control), the notification triggers, and the unit becomes unavailable to the user (view access is modified to no access).

Set counter value

Counter values can be changed (or zeroed) when notification triggers. Select one or more counters (mileage counter,

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 used to create

sensors 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

status

can be set for unit when a notification triggers. For instance, when unit enters a geofence, private state 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 round for unit can be chosen as an action undertaken after the notification triggers. For example, when

one round is finished, a new round can be assigned, or when unit leaves its garage (as a geofence), a round is automatically created for it.

Reset driver

This feature can be used, for example, to reset driver

automatically when the unit returns to the depot. This action can be completed successfully only if you have enough rights for the resource where the driver under question belongs –

'Create, edit, delete drivers'.

Reset trailer

Similar to the previous one but concerns

trailers . This action can be completed successfully only if you have enough

rights for the resource where the trailer under question belongs – 'Create, edit, delete trailers'.

197

Notification Parameters

In the given window you can 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.

Notification name

Key in any mane. It will be displayed on the list of notifications and in the notification itself.

Time interval

The period after which the notification will be deleted.

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.

Max triggers

How many notifications can be delivered until it will be automatically deleted.

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 a 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 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

198

Delay from the moment when message was received and before it it will be checked. This delay is especially recommended if a unit has a black box that usually requires time to unload all messages stored in the period of communication loss (for instance, while it was abroad).

Enabled

If activated, the notification after creation/editing will be active. If not, it will be disabled.

Time limitations

It is possible to set limitations depending on time, day or month. For example, the control can be performed only on weekdays and within working hours.

199

dynamic filter , you can save your time when looking for a certain notification on the list. Enter notification

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

Control type Action(s)

speeding,

geofences,

alarm button trigger,

digital input activation/deactivation,

sensor value control,

message parameter control,

connection loss,

idle,

SMS control,

interposition of units,

excess of messages,

route control,

driver control,

trailer control,

maintenance.

e-mail,

SMS,

online popup window,

event registration,

violation registration,

command execution,

modify users access level,

manipulate counters,

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 more detailed information in the tooltip: validity period, notification text, and resource to which the notification belongs (shown if you have access to more than one resource). If a notification has several actions, just an icon for the first one is showed. However, in its right top corner you can see the count of actual actions, and if you hover the mouse pointer over it, you can see the complete list of selected actions.

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 which belong to this resource. Note that if you have just view rights to an resource, you cannot edit or delete these notifications.

200

remove the flag Automatically display popup events in User Settings

Online Notification

Online notifications will popup in a separate window and can be accompanied by a special sound (see

User Settings ).

As more notifications come, they are stored in the same window.

Newly come notifications are added to the list on the top. The captions of unread notifications are highlighted with a blue background. The caption for an online notification is taken from the triggered notification tiself. To expand or minimize a notification, use the switch button +/-.

If clicking on a notification, the map is centered on the place where the event happened. If clicking on a unit name, map is centered on the latest unit position.

To delete a notification, click on a red cross against it. Is it possible also to delete all notifications or delete all read notifications ( Delete all or Delete read). Usually, the window closes automatically when you delete all notifications.

However, you can remove the flag Close window after deleting all messages, and then the window will remain on the screen even without notifications.

You can hide or show the notification window. To hide it, click on the Notifications icon on the bottom again (or use the standard little cross in the upper right -hand corner of the Notifications window). If the icon blinks, it means there are unread notifications. If you place the mouse pointer over the icon, in the tooltip you can see the number of unread notifications.

By default, the notification window appears automatically when a new online notification triggers. However, if you

, only the blinking envelope in the bottom panel will indicate that there are new notifications.

Note.

Any user who has any access to a resource will get all online notifications created in this resource.

201

work area on the left of the

Units

Unit is a vehicle, machine, person, pat or any other moving or stationary object that can be controlled with the help of a GPS tracking system.

To work work units, open the Units panel in the

window. Here you can see the list of units available to the current user. That are those units which are available for tracking on the

Monitoring panel. Here you

can create, view, copy, edit, delete units, import/export their properties and send

SMS messages.

On the list, units are displayed in the alphabetical order. To quickly find a necessary unit, apply the

dynamic filter . Place a mouse cursor over unit to

display its details in a popup window (type, ID, phone number). Unique ID and unit phone number are shown only to users who have edit or manage

access level

to the unit.

Use the following buttons against each unit to perform standard actions over it:

— Send SMS to unit's SIM card. It can be a

command or other message. SMS buttons are not

displayed if this feature is not activated for the current user. If the button is dimmed, it means there is no phone number in unit properties.

More about sending SMS messages...

— View or edit unit properties. To get the most efficient results both in reports and in

online monitoring , unit should be set up correctly, in accordance with device type used, available sensors, and

tracking tasks. Unit is configured in

unit properties dialog that was described above. Depending on your

access level , the dialog can contain up to 12 tabs which detailed description can be found in the following

topics:

— Create a copy of this unit.

— Delete a unit from the system completely. To do this, you need manage rights. If the button is dimmed, it means you do not have enough access (manage rights are required).

Routes

assigned to unit are deleted together with it.

202

To work with users, open the Users panel in the work area on the left of the

Users

User is a system object defined by its specific name (login) and password. Users can login to

Wialon Hosting 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.

Table of Contents

Working with Users

window. Here you can create, view, copy, edit, and delete users.

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

dynamic filter 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.

resources or account is displayed in object's tooltip or properties dialog. Besides, in all panels containing filters, there

or – Edit or view user's properties (depending on your

access ). User

properties dialog can contain up to five tabs which 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

is an additional filter by user/account (in the form of a dropdown list).

Actions of users in the system are logged. For instance, you can view user's (operator's) chat with driver, learn which commands were sent to units by this user, what alterations this user made to some object properties, what objects created, etc. This functionality is available mainly through

reports .

advanced reports on users

you can create the most detailed tables on users' logins and logouts as well as get charts of their activity by hours and days.

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

Individual settings can be transferred from one user to others.

203

work area on the left of the window. Here you can create, view,

Unit Groups

Unit group is a system macro object incorporating several

units

which have something in common. In many cases it is convenient to operate a group of units instead of performing an action over each unit individually.

Table of Contents

Working with Unit Groups

To work with users, open the Unit Groups panel in the

copy, edit, and delete unit groups.

On the panel there is a button to create new groups, a filter, and a list of unit groups available to the current user. On the list there is an indication of the number of units in each group. If hovering the mouse cursor over a group, in a tooltip you can see which units there are and their current location. For your convenience, the groups are arranged by name. If there are many unit groups, use the

dynamic filter above the list to easily find a

necessary one.

Use buttons against each unit group to perform a standard action over it:

or — Edit or view

unit group properties – depends on your

access

(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 button is dimmed, it means you have not enough

access .

When working with unit groups, consider some specific features relating to

access rights :

A group can be used to give a user access to several units at once.

With groups, access to a unit can be widen but not narrowed.

The creator of the group must have rights to units in this group. Otherwise, it wouldn't 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 Hosting:

1.

Online tracking of unit groups: display/remove from the map a group of units with one mouse click; see the current position of grouped units in one window; 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.

204

2.

Advanced reports: all tabular reports can be generated for a unit group; draw tacks of all grouped units on the map.

routes , they can be applied to a group of units at once,

3.

Configuring jobs, notifications, and routes:

When configuring

jobs ,

notifications or

which accelerates the process.

Unit groups also have some specific functions in the management system which were described

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.

205

To create and manage drivers, open the Drivers panel in the work area

Drivers

In this panel you can the list of drivers who form your personnel. With one click of a mouse a driver can be assigned to a unit that is attached to a vehicle. Then in the reports on this unit the driver can be indicated. It is especially convenient when different persons drive a unit. There is also possibility to detect drivers automatically with the help of iButton system.

206

imported and exported through files or directly from one resource to

Creating a Driver

Push the New button and set required parameters.

Name

Give driver a name that will be visible during the tracking process and in reports.

Code

Enter unique driver code needed to identify the driver. 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.

Photo

To quickly identify a driver, you can attach their photo or any other image. To do this, press the Browse button and find and load an image from the disk. Supported formats are PNG, JPG, and GIF.

Custom fields

Create driver's card adding any information as custom fields. They are shown in driver's tooltip and can be summoned in reports. Custom fields with the same name cannot coexist within one particular driver.

At the end press OK. The new driver will appear on the list.

The same dialog opens when editing a driver.

Hint.

Like any other resource contents, drivers can be

another. However, that is not true for driver groups.

207

Drivers are listed in the alphabetical order. To quickly find a certain driver, use the dynamic filter

Managing Driver List

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.

In the tooltip of each driver you can see their name, phone number, enlarged photo, resource (if there are several), description, and custom fields (if any were set). Unit which is driven by this driver is also indicated if the driver is bound to any. If you have Skype on your computer, the phone number is highlighted, and you can make a call if clicking on it. If a driver is bound to a unit and displayed on the map as a small icon in the right bottom corner of the unit's icon, driver's tooltip is shortened (only name and photo) because it can contain data about other drivers and trailers bound to this unit.

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 info tip is displayed (the same as in the Monitoring panel).

Several actions can be performed over drivers:

or –

bind/unbind

driver to/from a unit (disabled if not enough access);

– send

SMS to driver (the button is not displayed if the current user does not have enough rights; if the button is

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

208

Choose a unit to bind a driver to. This list contains only units from the work list of the monitoring panel.

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.

Table of Contents

Driver's Assignment

Manual Binding

Automatic Binding

Manual Binding

The manual assignment can be performed in the Drivers panel. Use the corresponding switch button Bind / Unbind

to attach and detach drivers to/from units. The button is disabled if your access is not sufficient.

Press the button Bind to unit and choose one of two options: Bind to unit or Register working shift. The first option is used if the assignment must be registered right in the moment. The second option is used to fix driver's work post factum. Select an option and press Next.

If you register a working shift, there will be one more page where you indicate shift beginning and shift end (or one of them). For example, you can indicate just the beginning of the shift, and the end can be detected automatically when

the unit arrives to garage (as a geofence) – to do this, create a notification of Geofence control type with method of

delivery Reset driver.

The button Unbind from unit is used to remove driver from unit manually (the first option) or register a working shift in the same way as it was described above.

Automatic Binding

To detect a driver automatically the corresponding equipment has to be installed. In authorized personnel control system iButtons with i -wire bus inside are widely used. When getting into the vehicle, the driver applies the electronic key to be identified by the system.

209

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.

2. Drivers -units association list should be created. Press the Units button in the Drivers panel and create lists of

automatically attachable units for each resource of drivers.

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-attacheable units applied to the resource where the driver belongs.

210

Groups of Drivers

Groups can be created from any available drivers. Driver groups are used to filter the list of drivers as well as to query reports for a group.

To create a new group of drivers, press the button . Enter name and description and choose drivers to fill the group.

Press OK.

Only drivers who belong to the same resource as the group itself can compose the group.

Created groups are displayed on the dropdown list. Choose a group in the list and the drivers belonging to it will be displayed below. Besides, you can choose to display all drivers outside groups. On the right of the selector, you will find buttons to edit, copy, and delete a selected group as well as create a new one.

211

Usage

While Tracking Online

The name of the driver is displayed (if available) in unit info tip. To activate this option, check Driver in

activate Show drivers column in User Settings

. The photo and phone number is also displayed if available.

Table of Contents

Besides, it is possible to have a special column in the monitoring panel to display drivers. For this, it is required to

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 above

In Notifications

Drivers appear in

notifications . You can configure a notification to get informed when a driver is assigned to a unit or

unbound from it. Using notifications, you can also unbind driver automatically, for example, when entering the depot.

In Reports

The drivers can be also mentioned in reports if the appropriate column is chosen in report template. This is available for the following tables: Trips, Engine hours, Rides, Unfinished rides, Fuel fillings, Fuel thefts, Speedings, and some others. To see drivers in a resulting report, choose the appropriate column in the report template. If a driver was appointed to the unit during a considered period (certain trip, speeding, etc.), his name is shown; if several drivers have been detected on the interval, only the first of them is shown. To have drivers' proper names in reports, those drivers should belong to the same resource as the report template used. Otherwise, drivers' codes will be displayed instead of names.

212

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

Advanced Reports module, you can generate a report totally dedicated to working shifts of a

certain driver or even a group of drivers.

213

Trailers

Trailers refer to any kind of motor -drawn implements attached to the main vehicle ('unit') and not having their own trackers or controllers. They are very similar to drivers in functionality and implementation.

To work with trailers, open the Trailers panel in the left part of the screen or use the shortcut key В .

214

imported and exported through files or directly from one resource to

Creating a Trailer

Go to the Trailers panel and press the New button. In the dialog, enter a name and the identification code for a new trailer (those fields are required). Optionally, you can add a description or enter custom fields (both will be shown in trailer's tooltip). You can upload an image for the trailer which will be used to show the trailer on the list and on the map. Images with square aspect ration are recommended.

Hint.

Like any other resource contents, trailers can be

another. However, that is not true for trailer groups.

215

dynamic filter above the list. There

Managing Trailer List

Trailers are listed in the alphabetical order. To quickly find a certain trailer, use the

are also filters to display trailers belonging to a certain resource or group, or display trailers according to their status

(loose/bound). Those filters are presented in the form of dropdown menus above the list.

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 on the list to center the map on its position. An 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.

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 info tip is displayed (the same as in the Monitoring panel).

Several actions can be performed over trailers:

or –

bind/unbind trailer to/from a unit (disabled if not enough access);

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

216

work list of the Monitoring panel. If the

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.

Table of Contents

Manual Binding

Manual binding/unbinding can be performed in the Trailers panel. A special switch button is located against each trailer – or correspondingly. The button is disabled if there is not enough access.

After pressing the binding button, choose one of two options: Bind to unit or Register working interval. The first option is used if the assignment must be registered right at the current moment. The second option is used to register trailer's work interval post factum. Select an option and press Next.

On the next page, select a unit. This list of units contains only units from the

working interval option was chosen, you should additionally indicate date and time of work beginning and end.

Several trailers can be bound to one unit.

Using the unbinding button, you can either detach a trailer from unit or, again, register a working interval. Besides, unbinding can be done automatically via special

notification action (e.g. when unit arrives at the garage).

Automatic Binding

Automatic method of binding trailers to units requires both special equipment (such as iButton system) and special adjustments in the system.

1. Create a special sensors of Trailer binding type in the properties of each unit intended for auto-binding. A

parameter for this sensor can be avl_driver or some other depending on your equipment and its configuration.

2. Press the Units button in the Trailers panel and create lists of automatically attachable units for each resource of

trailers.

217

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-attacheable units applied to the resource where the trailer belongs.

218

Groups of Trailers

Groups can be formed from any available trailers. Trailer groups can be applied to filter trailer list and to query reports for groups.

To create a new group of trailers, press the button . Enter name and description and choose trailers to compose the group.

Only trailer belonging to the same resource as the group itself can be added to the group.

Created groups are displayed in the dropdown list. It operates also as a filer, i.e. if you choose a group from this list, all trailers of this group will be displayed below. You can also choose to display all trailers or just trailers outside groups.

On the right of a selected group, you will find buttons to edit, copy, or delete it as well as the button to create a new group.

219

unit info tip if this option is selected in the User Settings.

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

Trailers can be displayed in the

Monitoring panel as a column, again, if this option is selected in the User

Settings.

In notifications:

You can configure a notification to get informed when a trailer is bound to a unit or unbound from it.

In reports:

Using notifications, you can also unbind trailer automatically, for example, when entering the destination point.

Many

tables

(such as 'Trips', 'Geofences', 'Parkings' etc.) can have a column which displays a trailer if any 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'.

220

unit database. Here you can view messages received from unit (coordinates,

Messages

The Massages panel gives access to

parameters, speed, etc.), as well as SMS messages received from unit, commands sent to unit, and events registered in unit history. Besides, data messages can be

exported to a number of formats.

Choose Messages in the

work area

to open the Messages panel. 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, drug to a required direction.

221

Messages , in top left cornet of the window. You specify the

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

following parameters:

1.

Select a unit for execution. The dropdown list contains not all units available to you, but only the units from the

Table of Contents

2.

Specify the period of time to show messages for.

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.

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 the page. Apart from that, you can set the number of messages to be displayed on one page: 25,

50, 100, 500, 1000. Besides, page number can be entered manually (to apply, press <Enter>).

The width of the columns is also customizable. To change it, drag column edge with the mouse to 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

222

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 which can be enabled or disabled. By default, only visible sensors

are displayed (the rest can be enabled manually).

Messages Filter

To quickly find a necessary message or filter found messages by a parameter, use a special filter. If applied to

data messages (with parameters shown as raw data), the filter involves parameter names,

in SMS messages and

registered events

– message/event text, in sent commands – additional parameters values, for

log – description of the action. The filter is disabled for data messages with parameters shown as sensor values.

Details instructions for filter usage were given

. 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 manage access to the unit.

In the last column of the table tick messages to be deleted (one or more). Then press the Delete button and confirm your intentions. If the checkbox at the head of the table is ticked, all messages on the current page will be selected.

After the operation, the newly deleted messages still remain on the table, however, the delete checkbox for such messages is dimmed which indicates that the messages are deleted. Next time when you load messages, the deleted messages will be completely removed from the table.

Note:

Deleting last incoming message or last message with position (valid coordinates) is impossible. That is why the delete checkbox for these messages is always dimmed.

223

visible sensors are displayed but you can enable other sensors

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 different ways. They can be presented in the form of a table or as a chart, play the track or just examine the statistics.

Table of Contents

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

manually (see

Viewing Messages

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.

Coordinates: latitude and longitude, in the brackets the number of satellited locked is displayed.

Altitude: elevation over sea level. If there are only zeros, it may mean your device does not detect altitude.

Location: country, city, street (if available). If address information is not available, the coordinates are displayed

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.

Image (if available): the button to display a picture made by unit and sent with the message.

Delete (if allowed): checkboxes to

delete messages .

Red rows in the table mean alarm messages registered by the system.

Statistics

224

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 (calculated by coordinates, mileage counter does not affect this value);

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 by this point and a red marker is set there.

By default, track color is blue, but you can adjust settings to paint the track depending on speed or sensor value. This is set in unit properties dialog on the

Advanced tab.

Besides, to get information about track points, hover mouse cursor over and see information in a tooltip (time, speed, coordinates, altitude, sensor values). Note that messages are searched in the radius of 50 pixels from the cursor.

Note:

If after the Messages panel you switch to Map or Reports panel, map layout and all track lines are preserved. To

remove unnecessary graphics, go back to the Messages panel and press the Clear button. More...

Charts

Except the text mode that is the table, 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.

225

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.

226

send commands to units. The resulting table includes:

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

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 which 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, this cell is empty).

Channel: channel type used to transmit the command (TCP, UDP, Virtual, SMS).

227

notifications (delivery method must be Register event for unit ,

Registered Events

Different types of events can be registered in unit history automatically or manually.

Automatic registration is adjusted with the help of

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. In such a manner you can register

fuel fillings, maintenance, unit statuses, and any custom event.

Traffic counter reset and

routes statuses

can be also 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.

228

access but also Manage log.

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

report

229

Export/Import Messages

Open the Export messages tab in the left section of the window. Select destination format and push Export. Depending on your browser configuration settings, you will be offered to open or save the file. The resulting file can be compressed. For this, leave the flag Compress file.

The supported 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;

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.

Select the Import messages tab in the left section of the window.

The supported formats are:

Raw GPRMC navigator logs in format defined by NMEA 0183 specification – searched in files with extension .txt or .log.

Rainbow Skipper messages from MMC card – searched in files with extension .gps.

Wialon messages – searched in files with extension .wln.

Wialon binary messages – searched in files with extension .wlb.

Push Browse to define a file (or an archive) to import messages from and push the Import button.

Hint.

To simplify and accelerate the process you may first compress files with ZIP or GZIP. After upload process is completed, files will be unpacked and processed on server.

230

horizontal menu . As a result, reports window will

Reports

To switch to the Reports panel, select the appropriate item in the

open. Here you can generate reports in real time and view them right in the browser or

export them to files of various

formats like PDF, XML, XLS (Excel), HTML, CSV.

The Reports panel window can be separated 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

map .

In the bottom right-hand section you see the report itself if it has been generated online

. A report appears in the form of

tables and

charts

The sizes of the sections are changeable. Click on the horizontal or vertical slider and holding the left mouse button drag it up/down or left/right.

231

If no templates are available, it is impossible to generate a report. How to create a report template...

Query and View Reports

To generate a report, set the following parameters:

Report template

Choose a

report template

from the dropdown list. On the right of the selected template there is a button to display template properties for viewing and editing.

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

access ( Query messages or reports is required) are displayed in this dropdown list.

However, in case with units, not all units are displayed in this dropdown list but only those which are in the

work list of

the Monitoring panel at the moment. If at that the group monitoring mode

is enabled, the units included in the groups chosen in the Monitoring panel are displayed in the dropdown list.

Interval type

Select a type of the interval and fill in the required fields to indicate the reporting period. Three ways to specify the interval are possible here:

Specified interval: specify date and time (to seconds) 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] days/weeks/months/years. The current day (week, etc.) can be included to the interval or not depending on the state of Include current checkbox.

When report parameters are adjusted, you can view the report

online

or in a file

Hints.

1.

To receive reports by e-mail in indicated time, adjust a job

2.

To receive a report when an event happens, adjust a

notification .

232

map , for example, tracks and markers.

Online Report

To generate a report online, adjust the parameters described above and push 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 which 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

If the text in a cell is blue, it means that there are coordinates for this point. Click on such a cell to move to that place on the map.

To adjust the number of rows to be displayed on one page, choose the number in the dropdown menu: 25, 50, 75 or

100. To navigate between the pages, use the blue buttons:

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.

233

Print Report

After generating an online report, it can be printed without saving it to the disk. To do this, press the Print button which 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 which you are going to print. At the right you can preview all these tables, charts, map, etc. To start printing, press

Print. To exit, press Close.

234

Reports in the form of files can be regularly sent to your e-mail automatically – through jobs

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.

Table of Contents

Export Report to File

and

notifications .

Export Parameters

Give the file any name. This is optional and if left empty, a file will be given a default name (like 'Online_report').

Specify weather to apply compression to file or not – 'Compress report files' option. Compression is mandatory for

HTML and CSV file as well as for cases when more than one format is selected.

The map can be attached to the report if it is HTML or PDF file. Note that the map will be attached to the file only if

any graphical elements (as tracks, markers, geofences, etc.

) are chosen in the

report template . Only Gurtam Maps

can be used here. Further more, the map layer can be hidden ('Hide cartographic basis' option) so that only tracks and markers will be shown on the blank background.

More parameters can be adjusted for some file formats. Those additional parameters are described below.

If there is no ready report in the browser, then it will be generated according to parameters set in the Reports panel.

Report is always generated in case you receive it from a job or notification. However, if you query report file online and there is already a report in the browser, this particular report can be exported to a file regardless parameters set in the

Reports panel. In any case, if you want to generate a new report, check the 'Generate report' option.

At the end, press OK. Depending on browser settings you will be offered to open file or save it.

Report Formats

HTML

Your report will be generated as Internet page and will open in any browser.

PDF

235

PDF is a widespread format suitable for electronic usage as well as for printing. To view these files Adobe

AcrobatReader is used (for Windows OC 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. You can additionally tick 'Excel 2007+' checkbox to get .xlsx file instead of standard .xls. Additional parameter can be adjusted for this file – 'Excel 2007+'. It is used for compatibility with newer MS Office versions.

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 each raw in the file corresponds to a raw of a table, and the columns are separates from each other by a special delimiter.

You can additionally set coding (utf8, cp1251) and delimiter (comma or semicolon).

236

In the tooltip you see the name of the resource

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

tables

and charts

to be included in 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.

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 Create, edits, and delete report

templates, then you will not be able to edit or delete this template.

237

report template , press the New button. In the dialog enter a name for the template and choose its

Creating Report Template

To make manipulations with reports templates, you should have at least one resource with the

access right Create,

edit, and delete report templates.

To create a new

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

unit group );

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.

It is not recommended to change template type when editing a previously created template because all template contents will be lost with this action.

Add

tables

and

charts

to your template, choose items for

statistics , adjust

map output , and decide upon other

parameters of the report. All added contents will be displayed at the left of the dialog.

Attention!

The set of report types as well as the set of tables and charts available for each type depends on your services and

modules. For instance, reports on unit groups, users, and drivers come as a part of the Advanced Reports extension

package. Otherwise, only the 'Log' table will be available for users and unit groups. And the Route Control module is required to get reports on routes (rounds).

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.

238

Details about fuel and mileage in reports...

Advanced Settings

The right part of the Reports Template dialog contains advanced settings which are divided into four sections:

Depending on template type, all or just several of these sections may be displayed.

Table of Contents

Options

Use US metrics (miles, gallons) option defines how mileage, speed, and fuel are given in the report. If this box

is checked, miles and gallons are used instead of kilometers and liters.

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

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 options which affects mileage calculation.

Mileage can be calculated either by all messages or by messages in trips

(considering trip detector).

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 your POI and 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 (km) says that if unit is located near a road and there is a city (i.e. city,

239

town, village) within the indicated distance, then in the address you will have the road's name and distance to the city.

Min radius (km) 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

proper format

Addresses from POIs and Geofences

Sometimes Gurtam Maps may be not very reach on addresses for some regions. In these cases you can use

POI created in the appropriate panels as addresses. Besides, you can make use of this feature to

and

customize some addresses, make them more clear.

Use POIs for addresses options allow to use POIs' names instead of usual addresses extracted from Gurtam

Maps. If coordinates of unit location get into the radius of 100 meters from this POI (or other radius indicated in unit properties), the address will be takes from its name. If unit location gets into the radius of two or more places, the nearest is used. If both options (geofences and POI as addresses) are activated, the priority is given to places.

Use geofences for addresses options allow to use geofences' names instead of usual addresses extracted

from Gurtam Maps. Those geofences require to have the flag Address source in their

properties . If coordinates of

unit location get into such a geofence, its name will be used in address cell. If two different geofences overlay, the smallest is used.

POIs and geofences from all resources option is useful if you choose to show POI and/or geofences as

addresses. By default, only geofences and POIs which belong to the same resource as the reports template are used. However, if the given option is activated and user has access to geofences and POIs in several resources, all of them will be used.

Add POI/geofence description to address option is also useful if you choose to show POI and/or geofences

as addresses. If you enable it, not only POI/geofence name will be displayed in the address but also the description text from their properties.

If no POI or geofence are found in given location, the address from the map is displayed.

240

Tables

The following tables (for units and unit groups) can be added to a report:

Non-visited Geofences

A template can contain any number of tables and charts. You can even add the same table type several times with different configuration of columns, data grouping and other settings.

To add any of above mentioned tables to the template, click the Add Table button and choose a table from the list.

Each table type has its set of columns which can form this table. After you have chosen table type, the list of columns available is displayed below. Check the columns you would like to include in the resulting table. To select all columns at once, press <ctrl> on the keyboard and click on any checkbox. To make all columns unselected, repeat the same operation. This combination works also for reports where you choose geofences, events, etc.

You can rename columns, clicking on their names and editing the text. In the same way you can change the name of the table itself (the Name text box at the top of the dialog). To restore default column names, use the button Restore

default (when it is gray, it means the current name is default).

Besides, you can apply to the columns any sequence order. Move them up and down dragging the button .

241

In the right part of the report template

Table Parameters

dialog you can set additional parameters for the table such as:

grouping ,

detalization , row numbering ,

total row , time limitation .

These parameters can be applied to any kind of table.

Table of Contents

Grouping

Data given in the table can be grouped by time intervals such as days, weeks and months. By default, the grouping is off. It means the data is given in the detailed view that is each raw of the table represents a separate event (such as fuel filling, violation, parking, SMS, etc. depending on table type selected), and these raws are arranged in the chronological order.

If any grouping interval is set, then each raw in the table will correspond to an interval (day, week or month). An additional column named Date, Week or Month will be added as the first column of the table.

Below there are two examples. The first one is a detailed report on parkings from 1st to 4th of July 2012. No grouping is applied.

242

The second table represents parkings for the same unit and interval, but here the data is grouped by days.

When using a grouping, all events which began in the analyzed interval are included in this interval, and when calculating event's duration all its duration is considered. That is why in the example above the total duration of parkings for the 4th of July is “1 days 5:58:06” that is larger than a day.

It is convenient to include the Count column in the table with a grouping. In this column you get the count of events which happened within the current interval (day/week/month). In a detailed report this column will contain only ones. At the same time, it is recommended to exclude such columns as Location when configuring a table with a grouping because events happen in different places. However, even if you have selected this column, note that the location for the first event in the interval will be displayed.

One more column can be useful for tables with groupping – Total time. The meaning of this column if similar to

'Duration' column but a bit different. 'Duration' shows the sum of intervals, for example, the sum of all trips detected.

'Total time' shows time from the beginning of the first interval to the end of the last, for example, time from the beginning of the first trip on a day to the end of the last trip on the same day (so, you can know real working shift).

Detalization

A table with a grouping applied can be supplemented with detalization which is also reasonable for the

advanced reports . Then a plus-shaped button will be added at the beginning of each raw. Press this plus to expand the hidden

contents for a certain raw. To expand an enclosed level of all raws at once, press the corresponding number in the header of the table.

For example, if there were four parkings detected at a day, in the grouped report the beginning of the first parking and the end of the last one will be indicated. But if you expand the hidden contents, you can get a detailed information for each of parkings in between. In the examples below you see the same report on parkings with grouping and detalization.

Detalization can be applied only to grouped tables; it does not affect detailed tables.

Row Numbering

Row numeration can be added to any table type. To switch the numeration on, check Row numeration box in table advanced parameters. The numeration is added to the table as its first column.

243

When numeration and detalization meet together, you get two-level numeration. The first level is a usual numeration of main rows with integer numbers. The second level is the numeration of nested rows as “main row number – dot – nested row number”.

Total

The Total raw can be added to any table regardless its type, grouping or detalization applied. The total raw is added as the last raw 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 raw 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 raw (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. However, if a state (for example, a trip) began within the indicated interval and finished outside this interval, the state will not be cut off and its duration will be wholly included in the report.

244

masks . Sensors masks can affect Sensors filter, Counter column, and

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, stops, parkings, sensors, driver, 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. Or you can query visited geofences with a stop at least 10 minutes in them.

Incomplete interval

This filter affects only the last interval in the report. In many cases, reported period ends and the last interval (trip, sensor operation, etc.) still continues. You can choose one of the following options to deal with such unfinished intervals:

Show and cut off : show the incomplete interval and consider that it ends with the last message within the reported period;

Do not show in report: do not show the incomplete interval in the report;

Show and mark as incomplete : the incomplete interval will be shown and will have 'Unknown' as the end time.

Duration

Minimum and/or maximum duration of the interval (in minutes).

Mileage

Minimum and/or maximum distance travelled in the interval (in kilometers).

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 minutes). In addition, engine hours sensor mask can be specified in the filter below – Engine hours sensor.

Speed range

Indicate minimum and/or maximum speed to be considered (in km/h). 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.

Stops

Tick the checkbox and choose one of the two possibilities: With stops or Without stops. Then in the resulting table only intervals which 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 (in minutes). 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

245

make up the specified time will be displayed.

Sensors

The intervals where there are messages with sensor on or off can be selected. In addition, you can indicate minimum and/or maximum time of sensor's on/off state. Like in parkings, the duration can be summed up (the Sum up intervals flag). Besides, the intervals of on/off state can be retrieved, and each of them can be presented as a separate row of the table (the Retrieve intervals flag). To indicate a certain sensor to be controlled, type its mask below. If you select several, then the intervals which contain points with all these sensors on/off (simultaneously) will be selected. If no masks are specified, then all digital sensors are considered.

Sensors masks You can enter up to 4

information on fuel (if any of these options is selected in the report template).

Driver

This filter allows to select intervals with a certain driver or without any drivers. Choose the option With driver and specify driver's name mask. The resulting table will contain only intervals with a corresponding driver – it does not matter whether this driver is at the beginning, in the middle, at the end or in all course of the interval. In case several drivers match the mask, all of them are considered but only the first one is displayed in the table. In addition, you can enable the option Retrieve intervals to retrieve only segments with a specified driver from the scope of intervals.

If the option Without driver is selected, the resulting table will consist of intervals which contain segments without any drivers. These segments can be retrieved as well.

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 (in liters). Fillings can be sum 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 (in liters). Like fillings, fuel thefts can be sum up.

Geofences/Units

The filter is divided into two parts – geofences and units. In the upper part you can select geofences to be analyzed for the report. You can focus on unit activity in or out of a geofence. To put a geofence under control, move the marker from None to In or Out against a required geofence. Only geofences that belong to the same resource as the reports template itself can be displayed here.

In the same way you can choose units (they are considered as 'moving geofences'). In this case, indicate radius for these units in meters. So, you can get information about unit activity in or out of the area of selected units. Only units to which you have Query reports or messages access are displayed here. To quickly find a necessary geofence or unit,

use the dynamic filter

. To select all items at once, use the <ctrl> key.

You can enter both integer or fractional numbers. Use point as a delimiter for fractional numbers.

Each of described above limitations can be applied both independently or along with other limitations. If the option

Retrieve intervals (in the Sensors or Speed sections) is combined with other conditions, then the filtration by other conditions is applied after retrieving the appropriate intervals.

246

How to carry a chat with driver...

Chat

This report unites commands of the kind Send message to driver and replied got from the 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.

247

Route points refer to check points

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 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 hurry in regard to arrival time set in point properties.

Departure time deviation: the same for departure time.

Presence duration: time spent in the check point.

Presence mileage: mileage in the check point.

Section duration: time spent to travel from the previous check point to this one.

Section mileage: mileage from the previous check point.

Count: points count.

Driver: driver's name if available.

Trailer: trailer's name if any was bound.

Notes: an empty column for your custom comments.

See

Route Statuses to know how different events about check point are detected.

Masks for geofence and/or route name can be applied additionally to this report. They are used in the same way as in

Rounds (for route) report.

248

Chronology

This kind of report gives information about all actions and changes in unit state during the indicated period of time.

Unlike most of other tables which are dedicated to a certain thing (parkings, sensors, trips, etc.) this table can unite phenomena 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)

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.

249

Unit Properties => Advanced where you set Maximum interval between messages.

Connection Problems

This kind of report lists cases when connection with server or satellites was lost. The parameters for this report are adjusted in

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.

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

filtration by driver and geofences/units can be applied to this report.

250

sensors . In the template you set the mask (filter) for sensors or choose

Counter Sensors

This table shows the operation of counter type

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 (useful if grouping by days is enabled).

Location: unit location when counter was activated.

Mileage: distance travelled 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.

Notes: an empty column for your custom comments.

Intervals filtration can be applied to this table: by duration, mileage, engine hours, speed range, stops, parkings,

sensors, drivers, fuel fillings, fuel thefts, and geofences/units.

Counter sensor's value can be visualized in the chart that shows counter's operation intervals and its value.

More about charts...

251

Unit Properties => Custom Fields ). Possible columns:

Custom Fields

The table Custom fields represents the list of custom fields entered in the corresponding tab of unit properties dialog

(see

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

Advanced Reports ), make sure the option Detalization is enabled. Pay attention

that individual fields of each unit will be displayed, and not the fields of the selected unit group.

252

Unit Properties => Sensors

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

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 sigh ? (replaces one symbol). Sensor name cannot contain commas. Check the All sensors check box to automatically select all existing sensors. If no sensors are selected or sensors are indicated incorrectly, the table cannot be formed.

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 last (useful if grouping by days is enabled).

Location: unit location at the moment of activation.

Mileage: the distance travelled while the sensor was on.

Mileage (adjusted): mileage subject to the coefficient set in unit properties (Advanced tab).

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.

Driver: driver's name if available.

Trailer: trailer's name if any was bound.

Notes: an empty column for your custom comments.

Intervals filtration can be applied to this table: by duration, mileage, engine hours, speed range, stops, parkings, driver,

fuel fillings, fuel thefts, and geofences/units.

253

sensors : engine ignition sensor, and advisably engine efficiency

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 must have the following

sensor and any fuel sensors.

The method of calculating engine hours is set in Unit Properties => General

. In

Unit Properties => Advanced you can

also set two more properties: Daily engine hours rate (to calculate utilization and productivity) and Maximum interval

between messages (to cut off false intervals of engine hours operation).

Additionally, you can specify engine hours sensor to be used in this report. For this, enter its name mask in a special filter in the reports template. It allows to create a separated table for each engine if there are several.

In the table you can see:

Beginning: time when ignition was on.

Initial location: location at the moment when the ignition was on.

End: time when ignition was off.

Final location: location at the moment when the ignition was off.

Off-time: period of time passed from the end of the previous interval to the beginning of the current one.

Engine hours: time interval of engine or attached implements operation.

Total time: time from the beginning of the first engine hours interval to the end of last interval (useful if grouping by days is enabled).

In movement: time when the unit had been moving within this interval.

Idling: time when the unit was standing with the engine on.

Mileage: distance traveled with engine on.

Mileage (adjusted): mileage subject to the coefficient set in unit properties (Advanced tab).

Counter: counter sensor value.

Initial counter: counter value at the beginning.

Finale counter: counter value at the end.

Status: unit status registered during engine hours operation (if there are several, the first one is displayed).

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

254

Avg consumption by …: average consumption in engine hours.

Consumed by … in trips: fuel volume used 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.

Initial fuel level: fuel level at the beginning of the interval.

Final fuel level: fuel level at the end of the interval.

Max fuel level: maximum fuel level.

Min fuel level: minimum fuel level.

Notes: an empty column for your custom comments.

Intervals filtration can be applied to this table: by duration, mileage, engine hours, speed range, stops, parkings,

sensors, driver, fuel fillings, fuel thefts, and geofences/units.

255

All events registered by the system (including violations ) can be shown in the report on events.

Events

There are different ways to add events to unit history:

1.

Triggered notifications which method of delivery is Register event for unit.

2.

Events registered manually by the user in

events registrar .

3.

Manipulations with

counters (change, store, reset counter value) with the help of corresponding

jobs or

notifications .

4.

When unit performs a

route (if it was chosen to save events on route).

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 that moment of event. Some events (like manipulations with counters or manually registered events) may have no location.

Count: the count of events.

Notes: an empty column for your custom comments.

In addition, you can use special

markers for this report: a yellow flag means event, a red flag means violation. In the

tooltip you can find the detailed information.

256

User: login name of the user who performed the command (hidden if you do not have

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.

access rights to

some user).

Command name: command name as it is written in unit properties.

Command type: command type (see the list ).

Parameter: additional parameter in the command (for messages it is text).

Execution time: time when the command was executed.

Channel: channel type used to transmit the command (TCP, UDP, Virtual, SMS).

Count: the number of sent commands.

Notes: an empty column for your custom comments.

This is a list of successfully executed commands. To see all commands sent to the unit regardless their execution, go to the

Messages panel.

More about commands...

257

Unit Properties => Fuel Consumption . At that, fillings registered manually are not taken into account.

Fuel Fillings

These reports shows where and when a vehicle was filled up. The parameters for this report to be generated are set in

Time: date and time of filling.

Location: unit location at that moment.

Initial fuel level: fuel level before the filling.

Filled: the volume of filled fuel (sensor name may be indicated in brackets).

Final fuel level: fuel level after the filling.

Registered: the volume of registered fuel.

Difference: difference between detected and registered filling volume.

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.

Notes: an empty column for your custom comments.

Intervals filtration by geofences/units, driver and filling volume can be additionally applied to this table.

You can use special

markers for this report to mark places of fillings on the map.

Attention!

If no fillings were detected, the table is not generated. And registered fillings are ignores then, too.

See also

Fuel Thefts .

258

Unit Properties => Fuel Consumption .

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

In the table you can have:

Beginning: date and time when the theft began.

Initial location: unit location at that moment.

End: date and time when the theft ended.

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 during the theft.

Notes: an empty column for your custom comments.

Intervals filtration by geofences/units, driver and theft volume can be additionally applied to this table.

Special

markers can be shown on the map in the places of thefts.

See also

Fuel Fillings .

259

geofences . At the right part of the template dialog the list

Geofences

This report shows when and how often a unit visited different

of all geofences is displayed. You can indicate one or more geofences to put them under control of this report, otherwise the report will not be generated. The list of geofences includes only those geofences which belong to the same resource as the report template itself (so, you need to have

access to them). Geofences on the list are sorted by

name.

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.

Perimeter: perimeter of the geofence. Perimeter for a line is its length (line thickness is not taken into account).

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 (useful if grouping by days is enabled).

Parkings duration: time spent in parkings.

Off-time: time between the previous visit and the current one.

Mileage: mileage in this visit.

Mileage (adjusted): mileage subject to the coefficient set in unit properties (Advanced tab).

Off-mileage: mileage outside the geofence (that is before the visit).

Off-mileage (adjusted): mileage outside the geofence subject 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.

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.

Intervals filtration can be applied to this table: by duration, mileage, engine hours, speed range, stops, parkings,

sensors, drivers, fuel fillings and thefts.

Geofences can be displayed on the map. For this choose

Render geofences

option in the report template.

Rides .

260

To apply this report to a unit, this unit must have registered events of GPRS traffic counter

GPRS Traffic

Attention!

This report can be not included to your package.

reset or traffic storage should be adjusted in

jobs .

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.

261

detalization is required in this case):

Logs

The Log table can be generated for any type of element presented in reports, i.e. for unit, unit group, user, resource, retranslator, or route. Log contains records about changes made in object's properties or its contents. To see the log of a unit, it is no enough to have Query messages or reports access to it; in addition, you need Manage log access.

Time – date and time when the change was done (saved).

User – name of the user who did it. You can specify user's name mask in report template and so get only changed made by a certain user.

Item type – unit, unit group, user, resource, retranslator, or route.

Action – description of the change performed.

Host – the address of the computer from which the user did the change or it can be 'job' or 'notification' if the action was automatic.

Notes – empty column for custom notes.

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 u nit group has an additional parameter – 'Group itself'. If this checkbox in disabled, the log shows changes made to units in the group (

If the option 'Group itself' is enabled, the log shows changes made to this unit group as system object:

262

) done during the indicated period and и registered

Maintenance

This table contains the list of service works (

maintenance

by users who have at least edit access to this unit. The table can be composed of the following columns:

Service time: date and time that were indicated during the registration.

Registration time: date and time when the event was registered.

Kind of work: the text from the field 'Kind of work'.

Comment: the text from the field 'Description'.

Location: location indicated while registering (together with comments entered manually).

Duration: duration of work.

Cost: service cost.

Mileage: mileage counter value at the moment of registration.

Engine hours: engine hours counter value at the moment of registration.

Count: the number of services.

Notes: an empty column for your custom comments.

Attention.

If the rows in the table are white and not green, it means that during the registration the place was not shown on the map.

263

Non-visited Geofences

This report gives the list of

unit group , you can find one more parameter in the report template – Consider group

which were not visited during the indicated period of time. In report template choose geofences to be checked when generating the table. The list of geofences includes only those geofences which belong to the same account with the report template. Geofences on the list are sorted by name. If the list is large, it is convenient to use name mask to quickly find necessary geofences.

Let us assume, we have 10 stores (geofences) to be visited every day. We would like to find out whether there are geofences which were ignored within the work week from 11th to 15th of May. To do this, we enable grouping by days and detalization, select necessary geofences and columns for the table.

Geofence: geofence name.

Type: geofence type (line, polygon, circle).

Area: total geofence area.

Perimeter: geofence perimeter.

Count: the number of geofences which were skipped.

Notes: an empty column for your custom comments.

From this report we see that 11th of May 'Store 2' and 'Store 7' were ignored, 14th of May – 'Store 3', and 15th of May

– 'Store 2' again. 12th and 13th are missed in the list, and it means that all predefined geofences were visited on those days. The cells with geofences' names are green, and if you click one the map will be moved to the first point of this geofence.

When the table is applied to a

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 which were visited by none of the units in the group.

264

Trip Detection when configuring a unit. To get information as

Parkings

Parkings are estimated according to parameters set in

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. But 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 are 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 (useful if

Data in Reports to learn how time (duration) can be formatted.

by days is enabled).

Off-time: time interval from the previous parking and to the current parking beginning.

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.

Status: unit status registered during the current parking interval (if there are several, the first one is displayed).

Count: the number of parkings.

Notes: an empty column for your custom comments.

See

Intervals filtration (by parking duration, sensor state, driver, fuel fillings/thefts, and geofences/units) can be 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.

265

Attention!

You should distinguish parkings from

stops .

266

geofences are needed to indicate ride beginning and ride end. The beginning and

Rides

Table of Contents

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 period of time. 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 zone;

2) when a unit enters the ride ending zone.

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,

the end can be the same geofence if the ride starts and ends in one place, for example, if it is necessary to travel ride around some shops and come back to the base.

Let us assume, that it is needed to transport goods from one place to another, and more than one ride is needed to do this. To control this process, we create Point A geofence and make it the beginning of the ride. Then create

Point B geofence and make it the end of the ride.

Rides Parameters

When you create a template for rides, pay attention on additional parameters to be set.

Circle ride is a ride which starts and finishes in the same geofence, that is a unit must leave this geofence and

return after a while. Such a geofence must have both flags – ride beginning and ride end.

The option Show rides started/finished with a stop only can be used as an additional filter. If activated, it means that ride beginning and end can be only a visit to a corresponding geofence with a stop in it. If a unit visited a geofence with ride beginning flag but did not make a stop there, this ride will be not considered by the system. In a similar way, if a unit visited a geofence with ride end flag but did not make a stop there, the ride will continue (if ride beginning was detected before).

In the Redefine ride beginning/end section you choose which geofences and units will be analyzed in this report.

The list of geofences includes only those geofences which belong to the same resource as the report template itself.

When you create this type of report template, some of the geofences can be already ticked – it means they have corresponding flags in their properties. You can remove flags or set more flags if needed. Besides, you can choose units as so-called 'moving geofences'. For them, set radius to outline unit's area. Geofences and units on the lists are sorted by name. If the list is large, it is convenient to use name mask to quickly find necessary items. You can even set ride beginning at unit area and ride end at an ordinary geofence.

267

Besides,

intervals filtration can be applied to this table: by duration, mileage, engine hours, speed range, stops,

parkings, sensor state, driver, fuel thefts, fillings, and geofences/units.

Report on Rides

The report on rides gives the list of all performed rides. The table can contain the following information:

Ride: ride mane consists of starting geofence name and final geofence name hyphenated compound.

Ride from: can be used instead of the previous column. Only the departure geofence is indicated here.

Ride to: destination geofence.

Beginning: date and time when the ride began.

End: date and time when the ride ended.

Mileage: distance travelled in this ride.

Mileage (adjusted): mileage subject to the coefficient set in unit properties (Advanced tab).

Ride duration: how much time it took to perform the ride.

Total time : time from the first ride beginning to the last ride end (useful if groupping by days is enabled).

Parkings duration: time spent in parkings.

Avg speed: average speed calculated for this ride.

Max speed: maximum speed registered during this ride.

Driver: driver's name if he was identified.

Trailer: trailer's name if any was bound.

Counter: counter sensor value (masks for these sensors are set at the right).

Count: the number of rides.

Status: unit status registered during the current ride (if there are several, the first one is displayed).

Consumed by ImpFCS/AbsFCS/InsFCS/FLS/math/rates: the volume of consumed fuel detected by a fuel sensor (like impulse/absolute/instant fuel consumption sensor, fuel level sensor) or calculated by math or rates.

Avg consumption by ImpFCS/AbsFCS/InsFCS/FLS/math/rates: average fuel consumption in the ride detected by one of the methods mentioned above.

Initial fuel level: fuel level at the beginning of the ride.

Final fuel level: fuel level at the end of the ride.

Max fuel level: maximum fuel level.

Min fuel level: minimum fuel level.

Notes: an empty column for your custom comments.

268

See also

Unfinished Rides .

269

routes were assigned to unit and events about routes were stored in unit history, a report based on these event

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 bases more detailed report can be generated – see

Check Points

Duration: time taken to perform the route.

Total time: time from the first route beginning to the last route end (useful if

How different route statuses are defined (route beginning, route end, point skipped, point visit, etc.), find here

by days is enabled).

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

report template you can indicate masks for geofences and routes. It means, you can get in a

report not all routes performed by a unit within the indicated period, but only the routes which use a certain geofence or which correspond to the given mask of route name. Both filters can be used simultaneously or separately from each other.

Besides, these filters affect the data layout in the table if the

grouping by days/weeks/month is used. For instance, if

the data is grouped by days and the filter by geofence is on, the table is built on the basis of geofences. If the data is grouped by days and the filter by routes is on, the table is built on the basis of routes. If both filters are activated, the sorting is made on the basis of both.

Intervals filtration can be applied to this table: by duration, mileage, engine hours, speed range, stops, parkings,

sensors, driver, fuel thefts, fillings, and geofences/units.

270

A special report can be built to show units' performance of a certain route

Rounds (for route)

. The following columns can be presented:

Beginning — round beginning time (activation time or entrance in the first check point).

Round: round name.

Schedule: schedule name.

Unit — name of unit preforming the round.

Status — result: Finished (the route was activated successfully, and later on the entrance to the last point was detected) or Not finished (the last point was not visited).

Points — total number of check points in the route (on this bases more detailed report can be generated – see

Check Points

Skipped — the number of check points skipped.

Visited — the number of check points visited.

Report type should be Route.

271

intervals filtration for details).

Sensor Tracing

Table of Contents

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.

Sensor Tracing

Out of range values

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:

Sensor: sensor name.

Time: the time of the message from which the value was taken.

Value: the value (numbers only).

Formatted value: the value with units of measurement.

Driver: driver's name if available.

Trailer: trailer's name if any was bound.

Notes: an empty column for custom notes.

In addition, you can choose a driver and geofences/units to be controlled (see

Out of range values

If a value received is out of range (the bounds are indicated in sensor properties), then the phrase Out of range is displayed as formatted value. To exclude such rows, flag the option Skip out of range values in the report template.

272

SMS Messages

This report gives possibility to view all SMS messages receives from a unit in a specified period. Here you see date and time when the message was received and the text of the message.

Time received: date and time when the data was received by the server.

SMS text: message text.

Count: the number of messages.

Notes: an empty column for your custom comments.

273

Advanced where you set Speed limit. The messages (at least two in succession) containing a speed value greater than

Speeding

This kind of report shows speed limitations violations. The parameters for this report are set in

Unit Properties =>

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

Location: device location at that moment.

Duration: how long the violation continued.

Total time: time from the first speeding beginning to the last speeding end (useful if grouping by days is enabled).

Max speed: maximum speed within this period.

Mileage: the distance travelled with exceeded speed.

Mileage (adjusted): mileage subject to the coefficient set in unit properties (Advanced tab).

Avg speed: average speed within the interval.

Average excess: average speed excess within the interval.

Driver: driver's name (if a driver was identified).

Trailer: trailer's name if any was bound.

Count: the number of speed violations.

Notes: an empty column for your custom comments.

Intervals filtration (by speeding duration, mileage, driver, geofences/units) can be applied to this table.

You can use special

markers for this report:

Other means to control speed are described in

274

parkings . Parameters to detect trips, parkings, and stops are adjusted in the

Stops

A stop is two or more consecutive messages with a zero speed. Stops can be registered at lights, intersections, in traffic jams, etc.

Stops should be distinguished from

trip detector . If there are several messages in succession, they are united in one stop. If total time of such a stop reaches

Minimum parking time, it is registered as a parking (not a stop).

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 (useful if grouping by days is enabled).

Off-time: time from the end of the previous stop to the beginning of this one.

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.

Notes: an empty column for your custom comments.

See

Data in Reports to learn how time (duration) can be formatted.

Intervals filtration (by stop duration, sensor state, driver, fuel fillings and thefts) can be applied to this table.

This kind of report can be supplemented by corresponding

markers on the map.

275

setting in unit properties). More about mileage in reports...

Summary

This kind of report allows to from a table with diverse data concerning a period of time and at the same independent of any conditions like trips, sensor operation, geofence visit, etc. The following columns can be included:

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

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.

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.

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 by… — average fuel consumption on the interval.

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.

As additional settings, you can specify masks for sensors (fuel, counters), including engine hours sensor.

When a report is generated for a single unit, it makes sense to enable

by days/weeks/month. Otherwise, there will be only one row in the resulting table — summarized data for the whole interval. In

reports for units groups

(without grouping) a row corresponds to a unit.

276

Detection and adjusted for each unit individually.

Trips

This kind of report shows intervals of movement with indication of time, location, and other parameters such as speed, mileage, fuel, and many others. Intervals of movement (trips) are detected according to parameters set in

Trip

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.

Duration: time interval of the trip.

Total time: time from the first trip beginning to the last trip end (useful if grouping by days is enabled).

Off-time: period of time passed from the end of the previous trip to the beginning of the current 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 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 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.

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.

Finale counter: counter value at the end of the trip.

Status: unit status registered during the current trip (if there are several, the first one is displayed).

Messages count: the number of messages that formed the trip.

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.

Data in Reports to discover more about formatting time, mileage, fuel, etc.

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 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 consumption by … (mileage/1l): average fuel consumption 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.

Notes: an empty column for your custom comments.

277

See

Intervals filtration can be applied to this table: by duration, mileage, engine hours, speed range, stops, sensors, driver,

fuel fillings, fuel thefts, and geofences/units. For example, you can query trips with a sensor on

The tracks of the trips can be displayed on the map. To make use of this feature, select

Tracks on map option in report

template.

278

Rides to learn how to prepare rides for this report.

Unfinished Rides

See the previous topic

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 travelled in this ride.

Mileage (adjusted): mileage subject to the coefficient set in unit properties (Advanced tab).

Ride duration: how much time it took to perform the ride.

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.

Count: the number of rides.

Status: unit status registered during the current ride (if there are several, the first one is displayed).

Consumed by ImpFCS/AbsFCS/InsFCS/FLS/math/rates : the volume of consumed fuel detected by a fuel sensor (like impulse/absolute/instant fuel consumption sensor, fuel level sensor) or calculated by math or rates.

Rides to find out more information about additional parameters for Unfinished rides.

Avg consumption by ImpFCS/AbsFCS/InsFCS/FLS/math/rates: average fuel consumption in the ride detected by one of the methods mentioned above.

Initial fuel level: fuel level at the beginning of the ride.

Final fuel level: fuel level at the end of the ride.

Max fuel level: maximum fuel level.

Min fuel level: minimum fuel level.

Notes: an empty column for your custom comments.

See

279

Fuel Fillings ). This tables is designed to show running costs. Note that only

Utilization Cost

The table on utilization costs unites two kinds of expenses: maintenance and fillings. Both of these things have their own detailed tables (see

Maintenance

and

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.

If the rows of the table are white and not green, it means that no location was indicated while registering an event.

280

Triggered notifications which method of delivery is Register as violation;

Violations

Violations are particular case of

events

. The report on violations gives the list of violations detected by the system and registered manually and stored in unit events history.

Violations are:

1.

2.

Manually registered

custom event 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.

Count: the number of violations.

Notes: an empty column for your custom comments.

In addition, you can use special

markers for this report.

281

Mileage (adjusted): mileage subject to the coefficient set in advanced unit properties.

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.

Total time: time from the first entrance to the street to the last exit from it (useful if

grouping by days is

enabled).

Mileage: distance that was traveled by the unit while moving through this street.

About mileage in reports...

Avg speed: average speed while moving along this street.

Max speed: maximum speed detected while moving along this street.

About speed in reports...

Streets count: the number of performed visits (useful if

Intervals filtration can be applied to this table: by duration, mileage, engine hours, speed range, stops, parkings,

by days/weeks/month is enabled).

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.

282

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.

Table of Contents

Charts

Regular Charts

To receive charts in reports you need to have corresponding equipment (sensors) properly installed and configured

(except speed and altitude charts which do not need any special sensors). How to create and configure sensors, read in

Sensors .

To add a char to a report template, click the Add Chart button in the template properties dialog. A chart cannot be included to a report if report type is Unit group.

Enter a name for a chart or live default Chart (the same for all charts).

Regular Charts

There are several types of charts. First of all, this is Regular type. Their X axis always presents time scale, and you choose data for Y axis:

Speed

Altitude

Engine operation

Voltage

Temperature

Engine revs

Counter sensor

Custom sensors

Custom digital sensors

Absolute mileage

Mileage in trips

Instant mileage

Fuel level (no filtration is applied)

Processed fuel level (filtration is applied)

Fuel consumption by ImpFCS

283

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 then 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. At that,

Processed fuel level chart does not work if the flag Time-based fuel level sensors consumption is disabled.

Mileage Charts

Four kinds of mileage chart can be created: absolute mileage, mileage in trips, instant mileage, and instant mileage smoothed. The two first 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 (red) and mileage in trips (green).

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.

284

Chart Management

A handy interface provides enough tools to work with charts. You can adjust a needed zoom, move along the chart left and right, get a precise sensor value in the indicated point, etc.

To navigate a chart, use the corresponding arrow-shaped buttons:

move left;

move right.

The buttons to scale a chart (along the X axis): zoom in a chart in half the size; zoom out in half the size;

custom zoom.

When the custom zoom is activated, a mouse cursor is displayed as a blue vertical line. Holding the left mouse button you can select a needed area of a chart to increase it. Repeat the operation several times. To reset zoom level to the initial position, press the Reset button .

To get a sensor value in a given point, activate Trace chart values option . A mouse cursor is then displayed as a red vertical line. Click on any place on the chart and read the exact value in a text box below (for instance, time and fuel level or time and speed). If there are several curves, choose a needed one on the dropdown list at the end of the toolbar. If the X axis shows time, you move to the requested massage on the map, and a marker is put at that place.

To scale the Y axis, use the button Y axis auto zoom . If the button is pressed, and you change chart zoom along the X axis, then the Y scale is recalculated automatically in such a way to use the maximum of chart space. If the button is released, the Y scale always stays unchanged.

Pay attention that there is one more parameter which affects chart zoom. This option is set in report template and called Count from zero. If it is on, the Y axis will always have zero despite of the position of the Y axis auto zoom button.

285

trip detector settings. If trip detector is not set, the line will not

Chart Parameters

Table of Contents

Select Sensors

In the right part of the dialog you can indicate sensors to form the chart. This selection does not affect such charts as Speed, Altitude, Fuel consumption by math and Fuel consumption by rates because they do not need any sensors to be built.

To indicate necessary sensors, enter a mask to search sensors – full sensor name or its part using wildcard symbols like asterisk * (replaces any number of characters) or question sign ? (replaces one character).

Sensor name cannot contain comma.

You can skip this possibility and select All sensors option. In this case the system will automatically define sensors of a required type when building a certain chart.

If any masks are assigned and All sensors option is selected, the chart will be built for all sensors and masks will be cleaned.

Split Sensors

If there are several sensors of the same type and a chart of the same type is created, the curves for all sensors will appear in one chart. To split them, choose the appropriate option Split sensors. Then an individual chart will be built for each sensor. For example, there is a unit with two voltage sensors – external voltage and internal voltage. If creating a voltage chart for this unit we can get one chart with two curves on it or two chart with one curve on each (if

Split sensors option is selected).

If several data is selected for the chart and for each several sensors exist, the upper one will be split. Let's 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

286

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

In the picture below you see two speed charts built for one unit for the same period of time. The first chart is regular, the second one has the flag Count from zero.

Trips

The chart can contain a special line displaying unit state: upper position is for movement (trip), lower position is for stay. Movement/stay intervals are detected according to

appear. To activate the line, choose Trips option in chart parameters.

Smoothing

Almost all regular charts can be presented in two forms: raw and smoothed. Raw charts are drawn from one message to another in a linear way and have angular look. Smoothed charts look more streamlined. The smoothing algorithm is the same for all chart kinds.

Below is an example where the red line displays a raw voltage chart, and the green line displays a smoothed voltage chart. The blue line is to indicate trip and stay intervals.

287

288

Other Charts

Except regular charts you can generate the following charts:

Processed fuel level

Speed/Fuel Consumption by…

Table of Contents

The axes of these charts cannot be changed, however, it is possible to change chart name and use Select sensors and

Split sensors options.

Processed Fuel Level

Processed fuel level chart shows the values which are used while calculating fuel level, fillings and thefts in tables.

The chart shows how fuel level changes in time or depending on mileage. The caption of the tab will be correspondingly Time/Fuel level or Mileage/Fuel level. The chart Time/Fuel level is built only if in unit configuration the option Time-based fuel level sensors consumption is on. In all other cases the chart Mileage/Fuel level is built.

Besides, the data is processed according to filtration level set on the

Fuel Consumption tab (the option Filter fuel level

sensors values) or in sensor properties

Below are two fuel level charts: the first one is processed (time-based FLS is on, filtration is on, filtration level is 25), and the second one is not processed.

A special chart Processed fuel level should be distinguished from two similar regular charts:

1.

Regular chart Fuel level represents the raw data (no filtration is applied). The flag Time-based fuel level

289

sensors consumption does not affects the chart.

2.

Regular chart Processed fuel level is not available if the option Time-based fuel level sensors

consumption is off. If the option is on, the filtration is applied.

These regular charts can represent data only in the form Time/Fuel level. Besides, it is possible to overlay other charts, such as voltage chart, for example. Special charts cannot be combined with other charts.

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

Fuel Consumption

tab.

For example, to create this chart, a unit with instant fuel consumption sensor (InsFCS) was used.

290

Reports panel the map can be scaled and moved in the same way as everywhere esle: zoom, move, apply tools,

Map Output

In the

change the map source, etc. Even being in the Reports panel you can still track your units. Besides, some specific map options can be applied exactly to reports.

The map with tracks can be also

exported to HTML or PDF file together with report text. To include the map to the

exported report, in the Export dialog check the box Attach map.

In such reports as 'Trips', 'Parkings', 'Fuel fillings' and many others which contain information about unit location, this location can be easily shown on the map. To move to a place where something happened, click on a green row of the table. The map will be centered on the place and a marker will appear there. A similar feature is available in the regular charts (where the X axis displays time): when using the trace tool, you move to the requested massage on the map.

Some elements can be drawn on the map as a part of the report. They can be selected in the Map output section of the

report template dialog. These can be

routes traveled by unit, created

POI and geofences , as well as special

markers in the form of small icons which can be put in the places of events, fillings, thefts, speedings, etc.

All graphical elements are shown for the current report. If generating a new report, all tracks and markers from the previous report will be erased and replaced by new.

When switching to other panels, all graphical elements from the current online report as well as map position and zoom remain on the map. To remove them, return to the Reports panel and push the Clear button. Alternatively, the graphics of any panel can be hidden or displayed again. To do this, check the corresponding boxes in the horizontal menu.

291

Advanced Reports ). It is reasonable to assign different colors for

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

) will be displayed as tracks. In case of All messages on map, all messages with valid coordinates will be converted into a track. If in unit history there are intervals where the connection has been lost (no messages for a long time) or coordinates miss in messages, such intervals are displayed with a dashed line.

By default the routes are drawn with blue color. However, you can choose another color or even have many-colored tracks according to speed or sensor state. The set of colors to be used in tracks is defined in

Unit Advanced

Properties ).

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

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.

292

293

POIs and Geofences on Map

Created

POI and

visibility parameter set in POI properties

can be a part of a report. They will be displayed on the map if you check the corresponding boxes – Render geofences and Render POIs in the report template. Both geofences and POI are displayed with captions – purple for geofences and orange for POIs (if no other color is selected in POI properties).

Apart from that, additional options can be applied to POIs:

Group icons.

POI as well as markers can be united in one conditional icon when they overlap and details are given in the tooltip.

Consider POI visibility scale.

By default, all POIs are rendered on the map. However, they can be seen or hidden according to their

Note.

POI and geofences are taken only from the same account that report template.

294

User Settings . In the popup tooltip you will find time when message received, speed at that point,

Markers

Most kinds of reports can have additional 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.

Table of Contents

Markers

Unit Last Location

Parking marker

Stop marker

Filling marker

Theft marker

Event marker

Violation marker

Speeding marker

Note.

When enabling event markers, in addition to event markers you will get violation markers because violation is a special case of event.

Markers appear on the map after report is generated. If you see no markers, it means there is no events of the indicated type or the current map scale is not enough (try to zoom in).

When hover the mouse cursor over a marker, in a tooltip you see additional information: for stops and parkings – starting time and duration, for events and violations – time and notification text, for fillings and thefts – time and fuel volume, for speedings – starting time, speed limitation as it is defines in unit properties, how much the speed is exceeded, and duration of this speeding.

Apart from that, markers as well as POIs can be united in one conditional icon when they overlap – Group icons option in report template. Then more detailed information about what happened in that place will be available in the tooltip.

However, if there are more than 100 grouped markers, only their names appear in the tooltip, without detailed information.

You can enable Marker numbering option in report template. In this case, each number will have its sequence number which is indicated above the marker in violet colour. Numbers are assigned chronologically, and each marker type has its own numeration. If marker icons are grouped, the numbers are given in the tooltip.

295

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

(depending on

altitude, and the values of mileage and engine hours counters.

296

report template in the section of Advanced settings . Check fields you would like to include in

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

Statistics. For your convenience, items are divided into subgroups. To select all items in a subgroup, tick the checkbox near its name.

If any item in statistics is checked, the section Statistics appears at the left part of the report template. You can edit it if you click on the button against it. Then you can add and remove items, rename them, and change their position. In the middle column the subgroup is indicated.

In the resulting report, Statistics is always displayed at the beginning of the reports.

The following information can be included in Statistics for reports of Unit type. For other types of reports, statistics is different and can contain just a couple of rows: report template name, object's name, report interval beginning, report interval end, and time of report generation.

Statistics

297

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

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.

mileage coefficient (a setting in unit

Counter sensors

Total counter: the sum of values of all sensors of counter type.

Engine hours

Engine hours: engine hours duration. It can be calculated by engine hours sensor or by ignition sensor depending on unit properties.

Mileage in engine hours: distance travelled during engine hours operation.

Engine efficiency duration: the duration of attached implements operation (if having engine efficiency sensor).

Engine efficiency idling: engine hours minus engine efficiency time.

Utilization: percentage ratio of engine hours duration to engine hours rate.

Useful utilization: percentage ratio of engine efficiency duration to engine hours rate.

Productivity: percentage ratio of engine efficiency duration to engine hours duration.

Consumption by ImpFCS/AbsFCS/InsFCS/FLS/math/rates in e/h: fuel volume used in engine hours. It can be detected by a fuel sensor (like impulse/absolute/instant fuel consumption sensor, fuel level sensor) or calculated by math or rates.

Details...

Avg consumption by ImpFCS/AbsFCS/InsFCS/FLS/math/rates in e/h in trips : average fuel consumption in engine hours detected by one of the methods mentioned above.

Events

Events count: the number of

events

registered.

Executed commands

Executed commands: the number of

commands sent to unit.

Fuel fillings

Total filled: the volume of fuel filled during the reporting interval.

Total registered: registered fuel volume regardless binding to sensors and calculation methods.

Difference: the difference between registered and detected fillings.

298

Total fillings: the number of fuel fillings detected within the reporting period.

Fuel thefts

Total fuel stolen: the total volume of stolen fuel.

Total thefts: the number of thefts detected within the reporting period.

Images

Images: the number of

images

received from unit. And if there are any, the resulting report will contain a section with all those images. Supported formats are JPEG, PNG, GIF.

Maintenance

Total maintenance duration: time spent for servicing.

Total maintenance cost: total cost of all maintenance works.

Services count: the number of services performed.

Non-visited geofences

Non-visited geofences count: the number of geofences which were not visited.

Parkings

Parking time: total duration of parkings for the reporting period. Parkings are detected by Trip

Detector. IF it is not set properly, there may be no parkings found.

Parkings count: the number of parkings for the reporting period.

Rides

Rides count: the number of accomplished

rides .

SMS messages

SMS messages: the number of SMS messages received from unit.

Stops

Stops count: the number of stops for the reporting period.

Trips

Move time: total duration of all trips.

Engine hours: engine hours worked.

Mileage in trips: total distance travelled in all trips.

Mileage (adjusted) : the same distance multiplied by

properties).

Urban mileage in trips: distance travelled at speed which is considered as speed in populated areas.

Suburban mileage in trips : distance travelled at speed which is considered as speed outside populated areas.

Urban speed limit

is a setting in unit properties which defines if unit is moving in urban area or outside it.

Average speed in trips: average speed in trips (total mileage divided by move time).

Maximum speed in trips: the maximum speed registered during the trips.

Trips count: the number of trips.

Consumption by ImpFCS/AbsFCS/InsFCS/FLS/math/rates in trips: fuel consumed in trips.

It can be detected by a fuel sensor (like impulse/absolute/instant fuel consumption sensor, fuel level

299

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 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 litre' or as 'miles per gallon' .

Unfinished rides

Unfinished rides count: the number of unfinished rides.

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

General

tab.

Utilization cost

Total utilization cost: total cost of all registered service works and fuel fillings.

Count of services and fillings: total number of all registered service works and fuel fillings.

Violations

Violations count: the number of

violations registered within the reporting period.

Visited streets

Streets count: the number of found visits of

streets .

300

Log table), drivers, trailers, and groups of drivers and

Advanced Reports

Attention! To create reports on unit groups, users or drivers, you need Advanced reports module to be included in your package.

Advanced reports are reports on unit groups, users (except the

trailers. These report types are defined when creating a template.

Reports on Unit Groups

Reports on Users

Reports on Drivers and Driver Groups

Reports on Trailers and Trailer Groups

301

Data from several units can be gathered in one report if these units from a unit group

Reports on Unit Groups

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

Table of Contents

Any

;

Graphical elements on map: POI, geofences, any markers, unit last location icons, tracks and all messages

on map;

Some graphs in Statistics

: 'Report', 'Group', 'Interval beginning', 'Interval end', 'Report execution time';

Advanced options : US metrics, address format, etc.

All tables available for units are available for unit groups, too. Besides, the table

Unit latest data is available for unit

groups only.

In Unit group reports the following features are not available:

Charts;

Most of statistics excluding those mentioned above.

Tables for Unit Groups

When configuring tables for unit groups, take into account some peculiarities. As the first column of the table, you will see the list of all units included into the selected group (in the alphabetical order). Other columns are defined in the template in the same way as for usual tables. In the columns such as 'Count' there will be the number of events registered in the reporting period for the given unit.

Below is an example of a table on parkings for a group of six units (detalization is off) The table provides us with the following data: beginning of the first parking, end of the last parking, summarized duration of all parkings for the reported period. One row is dedicated to one unit.

If the option of detalization is applied (either full or partial), the second level appears. That means you can expand the contents of a basic row and see a detailed list of events for the given unit. The number of hidden rows will coincide with the number in the 'Count' column.

302

In addition to detalization, you can apply the grouping by days/weeks/months. In this case, it matters which level of detalization you choose – partial or full. Partial detalization assumes only one enclosed level. So, the first level will contain the list of units with general information for the whole reported period, and the second level will give general information about events for each day, week or month where those events were detected.

Full detalization (applied together with grouping by days/weeks/months) allows to reach all enclosed rows. In our

example, weekly information can be expanded, and each event of the type shown.

The grouping does not affect the report in any way if the detalization is off.

To expand enclosed rows, click on the plus-shaped button at the beginning of each row of higher level. It is possible to open all rows of 2nd or 3rd level if you click on the corresponding number in the header of the table. To hide all enclosed rows back, click on the button '1'.

If there is no data for the given unit, in other cells there will be '—–'. In some cases that can be not convenient, then you can disable such uninformative rows. To do this, enable the option Skip empty rows in the report template.

Unit Latest Data

This kind of table available only for unit groups. As for separate units, this information is available in statistics

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

303

By default, the latest information refers to report execution time. However, it can be bound to the end of reporting interval. To do this, enable the Consider report interval checkbox in the template.

Apart from that,

filtration

by geofences/units can be used for this report. This allows to quickly find units which are situated in a certain place or close to other units.

Last location can be visualized on the map by units icons – activate the option

Unit last location

in the report template.

304

users can be generated ( Logins and Custom fields ) and two charts

Reports on Users

Two tables about

(Logins/Hours and Logins/Days of week).

Tables Applied to Users

This kind of table shows user activity: logins to different services. The table can contain the following columns (they are adjusted after you press the 'Add Table' button):

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.

Table of Contents

The same

params as for all tables can be applied to user logins table: grouping, detalization, row numbering, total row,

and time limitations. In the example below you can see user logins table with grouping by days, detalization, numbering, and total row.

The table Custom fields represents the list of custom fields entered in the corresponding tab of

user properties dialog

View custom fields access is required.

In the

Statistics the following fields are available: report name, user name, reporting interval (beginning/end), report

execution time, total time spent in the system, and logins count.

Charts Applied to Users

305

Two kinds of charts can be attached to the report on user logins: Logins/Hours and Logins/Days of week. To get these charts, in report template push the button Add Chart and choose the type in the dropdown list.

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:

306

access to the resource where

Reports on Drivers and Driver Groups

Three kinds of tables can be applied to

To generate reports on drivers or driver groups, the proper

those drivers or groups belong is required – 'Query reports or messages' flag.

Table of Contents

Reports on Drivers and Driver Groups

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.

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 mush 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: time interval of the trip.

Total time: time from the first trip beginning to the last trip end (useful if groupping by days is enabled).

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

Unit Properties => Advanced (Urban speed limit setting).

Avg speed: average speed within the interval.

307

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

Count: the number of bindings found.

Avg consumption by ImpFCS/AbsFCS/InsFCS/FLS/math/rates: average fuel consumption in the trip detected by one of the methods mentioned above.

Initial fuel level: fuel level at the beginning of the working shift.

Final fuel level: fuel level at the end of the working shift.

Notes: an empty column for your custom comments.

When creating/editing a report template, you can also choose units to be under control of this report. Their list is on the right of the columns list. If no units are selected, it means that all units will be considered.

The report is designed in such a way that the first column is the list of units on which the driver was working. It is recommended to apply the

detalization

option to this table to get a possibility to expand any unit and see more detailed information about all working shifts on it.

Custom Fields

The table Custom fields represents the list of custom fields entered in the corresponding tab of

driver's properties .

Possible columns:

Name: custom field name.

Value: custom field value.

Notes: an empty column for your custom comments.

Additional Possibilities

You can apply the option of

(by days/weeks/months) to the tables 'Bindings' and 'SMS messages'. However, those tables generated for single drivers can have only one enclosed level of rows. On the first level you see the list of units, on the second – summarized information for certain day, week, or month. And this second level cannot be expanded.

In addition, you can query

statistics

for such reports, which can include the following fields: report template name, driver name, report interval (beginning and end), and report generation time.

of driver's movements can be built on the map.

The table of bindings can be generated for a

group of drivers .

Bindings for Driver Groups

308

The columns available for this report are the same as for the similar report on single drivers. However, with driver groups you can build complicated multi-level tables.

In the Bindings table for driver groups, the first level contains drivers themselves, the second level contains units (if the grouping is off) or days/weeks/months (if the grouping is on and detalization is partial). The forth level appears if the grouping is on and the detalization is full.

309

To generate reports on trailers or trailer groups, the proper access to the resource where those trailers or groups

Reports on Trailers and Trailer Groups

belong is required – 'Query reports or messages' flag.

Two tables are possible for

trailers :

1.

Bindings

This table shows working intervals if the chosen trailer if it was bound to units. It comes along with information on fuel consumed, distance traveled etc. Parameters and possible columns for this table are the same as in the

that the column 'Violations' is absent). The Bindings table can be also generated for

trailer groups – it gives

possibility to build complicated four -level reports (trailers –> units –> dates/weeks/months –> single bindings).

trailer properties . It is not available for groups f

2.

Custom fields

This table represents the list of custom fields created in

trailers.

310

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.

Table of Contents

Duration of a state is given in the format HH:MM:SS. If a duration is bigger than a day, first the number of days is indicated, and then HH:MM:SS. It can look like that: '5 days 12:34:56' which means '5 days, 12 hours, 34 minutes, 56 seconds'. However, duration larger than 24 hours can be not combined into days. So, there will be “132:34:56” instead of “5 days 12:34:56”. To disable days and leave only hours, go to report template properties dialog and set the Duration format option to Hours and minutes. This parameter affects not only time formatting in the cells but in the Total row as well.

In some rare cases the duration of a state is '0 seconds'. It can happen if the state is detected by only one message.

For example, a speeding was detected in one message, and in previous and next messages there is no speeding.

The duration of a speeding is considered a period of time from the first message with speeding to the last messages with speeding in sequence. So, if having only one message with speeding, the duration turns to be zero.

If grouping is used, the time appears as follows:

If grouping by days is used, the column called 'Date' is added. It gives the date in the format

YYYY:MM:DD. If the columns 'Beginning' and 'End' are selected, they will contain only time (HH:MM:SS).

However, if a state began in one day and finished in another, in the 'End' column date and time will be given.

If grouping by weeks is used, the column called 'Week' is added. The month and the number of week of year are indicated there. The first week of year is considered the first full week. If a week begins in one month and ends in another, it refers to the month where it begins.

If grouping by months is used, the column called 'Month' is added.

Attention!

To receive reliable data for time/duration, it is important to correctly indicate the time zone, the first option in

can depend also on Trip Detector

Mileage

Mileage can appear in reports on trips, geofences, rides, speedings, digital sensors, etc., as well as in statistics and processed fuel level chart.

Mileage is calculated according to settings of mileage counter on the

General

tab in unit properties. Besides, mileage

because the intervals of movement and parkings are detected by it.

Mileage can be ordinary or adjusted. The adjusted mileage may be useful to coordinate mileage detected by the program and mileage detected by vehicle itself. Correction coefficient is set in

unit properties on the Advanced tab.

In Statistics and in various tables, you can find many possibilities for mileage:

Mileage in all messages – the full mileage without any filtration by trip detector. It is always the longest mileage because it includes also all adjustment of data.

Mileage in trips – total mileage of all movement intervals found according to trip detector.

Mileage (adjusted) – mileage in trips multiplied by correction coefficient.

Mileage in engine hours – mileage in intervals of engine hours.

Urban mileage – distance travelled at speed which is considered as speed in populated areas.

Suburban mileage – distance travelled at speed which is considered as speed outside populated areas.

Urban speed limit is a setting in unit properties which defines if unit is moving in urban area or outside it.

311

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.

Mileage counter – absolute mileage (mileage counter value at the moment of report generation).

In many tabled reports, mileage can be displayed. It can be calculated either by all messages or by messages in trips.

Such or such method of calculation is defined by the flag 'Mileage from trips only' in

additional settings of the Report

Template dialog.

Mileage if less than 20 (miles or kilometers) is displayed with accuracy to hundredths (other decimal places are simply cut). Measurement units for speed and mileage (kilometers and kilometers per hour or miles and miles per hour) are selected in additional settings of the Report Template dialog. There you can also set the option Mileage/fuel/counters

with accuracy to two decimal places to see mileage always with hundredths.

Speed

Average and maximum speed values can be included in the same reports as mileage: trips, geofences, rides, speedings, digital sensors. Note that the average speed directly depends on mileage because it is calculated by dividing mileage by duration (for example, distance travelled with a sensor on divided by duration of on state. That is why a situation can happen when the average speed is zero and maximum speed is a positive number. It can happen

(1) if state duration is zero (see explanation above); (2) if mileage is zero (unit was parked or the mileage counter is set incorrectly); (3) if the mileage is insignificant, for example, '0,01', and the result of division is smaller than one.

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

sensors on your unit;

properly configure the sensors in

unit properties ;

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:

use

mathematical method to calculate fuel consumed (it takes into account urban and suburban cycle, idle

running, and moving under load); use

consumption rates

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

312

given mask) and they are not summed (the option 'Merge same name sensors' is off), then a separate column will be generated for each of these sensors. If you want a certain sensor to be used for fuel calculations, enter its name mask in the reports templates in the filter called “Sensor masks”.

If in the report template you select columns which do not match with unit configuration, in the resulting report there will zeros in those cells.

In statistics, there is no possibility to show a separate row for each sensor. Even if they are not merged, in the rows like 'Avg consumption …', 'Consumed by …', 'Rates deviation …' etc. you can get only one row for each type of fuel sensor (FLS/ImpFCS/AbsFCS/InsFCS). That is why consumed fuel ('Consumed by …') in statistics is the sum of sensors of a type, and average consumption ('Avg consumption …') is the arithmetic mean between those sensors.

However, calculation of deviation from rates ('Rates deviation …') depends on sensors adjustments. If a unit has two sensors of the same type with different names (or with the same name and the merging of sensors is disabled), rates deviation is calculated for each sensor separately but for the statistics (as it can be only one row) the sum of those deviations is shown. Thus, the formula is:

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 US metrics

are selected, fuel is measured in gallons, and average consumption in mpg (miles per gallon) unlike the

European system where average consumption is measures as lt/100km (liters per 100 kilometers).

All fuel data is processed before getting to reports. The data is processed according to filtration level set on the Fuel

Consumption tab (the option Filter fuel level sensors values).

313

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.

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 work with routes, open the Routes panel. Here you can configure routes and observe the progress of active rounds.

314

Creating a Route

To create a new route, press the New Route button.

Table of Contents

Input a name for route (at least four characters), give description (optional), and choose color which will be used to display the route on the map and in the timeline.

A route consists of check points that are supposed to be visited. Check points can be added by various means: directly from the map, from POIs or geofences, and as moving units.

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

geofences will be displayed. On the left of geofence name, you can see

. 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

its type (circle, line, polygon). Click on geofences to add them as check points. To quickly find a needed

one, use the dynamic filter on the top. On the right there is a button to move to a geofence on the map,

however, it will be visible only if this geofence is marked to be displayed on the map in the Geofences panel (the similar is with POIs and units). If you have more than 100 geofences, they will divided into pages, and to view them all you will need to use navigation buttons on the bottom of the list.

3.

From POIs.

In a similar manner, you can add POIs for the route.

315

4.

From units.

A check point may have no fixed coordinates, that is to be a moving unit. In this case, to visit this point will

mean to approach within indicated radius. To add a unit

as a check point, click on it in the list.

When points are added, you can edit their radius (except geofences) and place them in desired order, remove points or add more if necessary. To change points sequence oder, 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 POIs and geofences are created in the route, so route check points created from them lose connection with their predecessors completely when the route is created. You can then edit or delete those original

POIs and geofences, and it will not affect the route in any way. Meanwhile, units as check points are different because their IDs are stored in the route. So, the connection with the unit is always maintained unless the unit is deleted.

When finished, press Save. The route will appear on the list. To see it on the map, click on its name. It is strongly recommended to estimate the result visually and double check all points before proceeding because afterwards, when the route has schedules, it is impossible to edit it.

Attention!

When a route has schedules, it becomes impossible to edit its check points (add, delete, set sequence order). If you need to alter such a route, make a copy of it and make all necessary changes there. Then delete the original route.

However, in this case you will have to configure schedules and rounds for this route again.

316

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 week days, 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.

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 tick this option. 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 a day).

Absolute

Scheduled time of point visit includes also a date. Such schedule can be used only once.

317

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 contained in the route and times of their visit. Visit time can indicate only arrival or both arrival and departure. Besides, you can set variation time to give unit some degree of freedom to visit the point

(like plus or minus 5 minutes). Time format here is hh:mm.

Enter arrival time for each check point. To indicate departure time as well, tick this option to activate it. Variation time can be set automatically. Enter value into the appropriate box and press Apply.

If time is set 00:00 then any visit of the point at any time will be considered as perfectly in accordance with the schedule (not late, not early).

If a route is going to have arbitrary points order, you can indicate time interval within which each check point should be visited. It is especially convenient for delivery services and the like. For example, a point should be visited between

18:00 and 20:00. Then write 18:00 as arrival time and 20:00 as departure time. At that, time variations should be zero.

Time limitation

Time limitations can be applied to schedule to restrict its operation to some 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 week days, etc. Note that this option does not work with Absolute schedule type.

Units

Choose unit(s) to be assigned to this schedule and thus create rounds. Required access is Use unit in retranslators,

jobs, and notifications. If several units are chosen, the first that begins the round will be assigned.

Round name

Here you can set name that will be applied to rounds created on the basis of this schedule do differentiate it from other rounds. Special tags can be used to form the name:

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

318

Schedule for details). New

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.

Rides can be created manually or automatically.

Table of Contents

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 as well as assigned units. Enter round name and description, decide upon points order, expiration time, and other parameters (see

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

Automatic Round Creation

Automatic creation of rounds is adjusted in schedule properties – Automatically create rounds for this schedule.

notifications . You can create a notification with trigger action to

Another way to create a route automatically is through

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 . Specify time period and observe all kind of routes – automatic and manual, finished, impending and in progress.

319

Route Control

There are several methods of tracking units on routes and you can choose what suits you better.

Online Control

Table of Contents

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 criteria is chosen in the dropdown list, and in the textfield 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 'Lick current time' for this . While this button is pressed, the timeline cannot be moved manually.

On the timeline, a route is represented by a horizontal line of such colour that was assigned to it. Check points are represented as vertical sections on this line and they are situated in the places where the arrival to a check point is expected according to the schedule. A check point can be also displayed as a rectangle if not only arrival but departure time as well are indicated in the schedule. Besides, check points which contain only arrival time can be expanded to rectangles at the expense of deviation time (if specified). For this, apply the option 'Mark deviation time'

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 e-

320

mail or SMS, shown online in a popup window, stored in unit history as events or violations, etc. See

list of rounds for this route (finished, in progress, pending);

for 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:

321

Routes Management

Routes in the panel are listed in the alphabetical order. To quickly find a definite route, use the

dynamic filter situated

above the list. Enter route name or its part and observe the results.

In the dropdown list above the list, you can choose how routes are displayed:

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, colour, and check points radius;

– add a new

schedule for this route;

– see the

– create a

round for this manually;

– copy route i.e. create a new route on the basis of chosen one;

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

322

To quickly access a tool use shortcuts

Tools

The list of available tools is accessible through the Tools menu in the top panel.

With a help of such features as Track Player, Distance, Area, Address, Routing,

Hittest, and Nearest units 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 reposition the point, click on it and holding the left mouse button drag to another place on the map.

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

Find detailed information about each tool:

323

Track Player

It is possible to view how unit was moving and how its various parameters were changing with time. This

tool is applied

to tracks only. There three ways to get a track on the map:

1.

In the Map Mode, open the Tracks panel and request tracks of unit movement for the indicated period.

2.

In the Messages Mode, while viewing messages for the indicated period, the track is mapped automatically.

3.

In the Reports Mode, 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 Fast Track Building button.

A track is chosen in the dropdown list. Track names coincides with unit name, in brackets it is specified in which mode the track was built (monitoring, reports, messages). When you choose one or another track, the map moves to it and the unit itself appears in the first point of the track regardless its current location. 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 the playback is performed, the real unit temporarily disappears from the map.

After selecting a track, choose the most appropriate speed for its playback: real time speed, 10 or 30 seconds per second, 1, 5, 10 or 30 minutes per second, 1, 2, 3 hours per second. These playback speeds are rather conventional, especially at high velocities. When you choose a high speed, the playback performance depends on the model 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 expected, and there can be no considerable difference in actual speed between 1 and 3 hours per second. In any case, all messages will be played even if it will take more time.

By default, messages with zero speed are skipped. It means, only intervals of movement are played. However, some devices do not send speed, and to play their track, it is necessary to disable the check box Ignore the messages with

zero speed.

324

To start playing the track, press the Play button. At this, it transforms to the Pause button, which can be used to stop the playback. If after a pause the playback is started again, it continues from the point it stopped the previous time.

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 .

If playback speed is not very high, the map is centered on each message. However, you can adjust a handy zoom and scale for the

map and disable the flag Move map while playing. Then the map will not jump automatically while playing.

Track playback can be invoked from any message. Navigate throughout the track by clicking on any place of the timeline. If just hovering the timeline, time is indicated above. To navigate through a track, you can also use arrowshaped buttons – to move to the next/previous point of the track.

When the playback comes to the end, the timeline shows '100%'. To start playing the track again, press the reset button, and then press the play button again. When the reset button is pressed, you can see unit's current location for a short time but then the unit returns to the first point of the track.

Additional information is available below, in 4 sections (mark the appropriate checkboxes to expand necessary sections):

1.

Information: message number of the whole number of messages, message time, speed, and location.

2.

Parameters: available parameters and their values.

3.

Sensors: available sensors and their values ( visible sensors

only).

4.

Pictures: if the device used is able to send pictures, they are displayed.

As a track is played, all data in these sections is refreshed dynamically according to message being played at the moment.

Note:

Sometimes Track Player can occupy much room of the screen, and not enough space will remain for the map. To help this, you can hide two things:

Track Player itself – use the button in the top right-hand corner of the tool dialog .

Work Area – use the button at the bottom panel .

325

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.

326

Area

Choose

Tools => Area

on the menu. To draw a polygon follow the same directions as for polyline creation. The perimeter and total area can be known from the popup window in the corner.

It is also possible to calculate the area of intersecting polygons. When creating such an area, sections filled by semitransparent white color are included to the resulting area.

Use the Reset button to clean the map and draw a new area.

327

User Settings , you can indicate City. Then this city/town will be selected automatically when you open the Address

Address

The address

tool is designed to:

find a place (city, house, etc.) on map ; detect the address of a place.

Table of Contents

Choose Tools Address on the menu to make use of the tool.

The address information can be received form different provider (depending on maps activated and their support):

Gurtam Maps, Google, Yandex, etc. (see

Map Source ).

tool.

Search by Address

To start searching, input the first letters of the name of the city/town into the City field. After typing three or more characters, in the Results field a list of places starting with these letters will appear. If the place you are looking for is the first on the list, push <Enter>. In other case, select the necessary item in the list and click on it. The similar actions can be performed in the Street field. After selecting the street, a list of houses located there becomes available.

Choose one, and the map will be centered at this house.

The found place will be marked with a red marker. Information (coordinates and address if available) will be displayed below. If it gets into any

The found place can be saved as a circle-shaped geofence

, their list will be given, too. On the left of geofence name there will be a square box with color assigned to this geofence.

The search can be stopped on city or street if it is enough for you.

The Back button is used to go back to the street search (if you are already selecting a house) or to the city search (if you are in the street field).

If you have moved the map or zoomed it, you can reset changes pushing the Show button.

To start a new search, press New search.

Address Detection

To know address of a point on the map, just double-click on it. See the address and the coordinates in the popup window. If it gets into any geofences, they will be listed below.

It is possible also to detect address by coordinates. Input latitude and longitude in grades and fractions (they should

328

be separated by a dot) and push the Show button. The map will be centered at this point.

Save as Geofence

with 100 m radius. The detected address will be used as the name for this geofence (however, you can edit it).

329

tool helps to quickly make routes from one point to another visiting any number of

Routing

This

interstitial points. You can define the sequence of points yourself or the program will optimize it for you. You can indicate key points double -clicking on the map or entering needed

addresses. Resulting route can be saved as geofence

with control points or without them and used for routes control or geofences control later on.

Choose Tools Routing to make use of this feature. Set points and press Calculate.

Table of Contents

Selecting Provider

Depending on maps available at your service, different map providers can be used to make a route: Gurtam Maps,

Google, Yandex, Visicom. They are chosen in the dropdown list.

Gurtam Maps do not lock routes to roads when making a route, however it can offer optimized sequence order of points (considering the straight distance between them). Other providers make routes along the roads but cannot change points order.

Depending on map provider, more features can become available. For example, if Google is selected, the route can be mapped regarding the way you travel: by car (default option) or walking or avoiding highways (tick the appropriate check box). Yandex adds possibility to take into account traffic jams.

Placing Points

There are two basic ways to set key points for route:

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

Address tool

was minutely described 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 point are set, it is possible already to draw the route (the Calculate button). However, before doing that, you can edit key points, especially if you are going to save this route as geofence with control points.

The list of points is displayed in the Points panel. Here you can edit point name, its radius, and delete unnecessary point.

330

Route Calculation

If building a route with Gurtam Maps, sequence order of points can be interpreted in two ways:

Default option is that the point follow in the order you put them.

Point order can be optimized in order to make the route as much short as possible. For this you should enable the flag Optimize points order. The route will be drawn beginning from the first point (without snapping to roads). The last point can be fixed (for example, if a unit lefts the depot and after a while is expected to come back), that is regardless any sequence order offered by the program the last point will be that which was set the last. For this, enable the flag Stick last point.

At the end, press the Calculate button and estimate the result. If you need to change some parameters (for example, add more points), press Undo calculation. If you want to built a new route, remove all points with the special button on the head of the points list.

In addition, you can choose line color as well as view information about route – its length and number of points.

Saving Route

After the route is mapped, it can be saved as a line-shaped

geofence . To do this, enter geofence name, choose

account, and push Save. If the key points were given manes, the geofence will have control points.

If the map provider was not Gurtam Maps, there are two ways to save the route: the full line (can contain any number of points), only control points with preset sequence order.

331

This tool is applied to tracks only. There three ways to get a track on the map:

Hittest

1.

In the Map Mode, open the

visible sensors only). It is duplicated in

panel and request tracks of unit movement for the indicated period.

2.

In the Messages Mode, while viewing messages for the indicated period, the track is mapped automatically.

3.

In the Reports Mode, 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 Fast Track Building button.

Choose a track in the dropdown list. Hover the cursor over track to get accurate information about any point in a tooltip.

Double-click at any place of the track (or even on the map), and the nearest to your click message will be found and highlighted by the marker. The map will be centered on this point.

Two modes are available here: single-point and multipoint. Depending on your choice, you can get information about one or more points at once. The information is displayed in the popup window when placing the cursor over a marker.

The information is: date and time, location, coordinates, speed, sensors values (

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.

332

tool is designed to help you to find units which are the nearest to a certain place

Nearest Units

This

according to their last message.

Choose Instruments Nearest units on the menu. In a special window set the parameters of your request and observe search results.

Table of Contents

Request

There are two ways to indicate a place:

1.

Double-click on the map in this place.

2.

Enter city and street in the appropriate fields. When you start to enter a street, the system starts looking for streets which names start from these letters. Soon a list of streets is generated and you can choose a street from it. Then buildings are displayed (if there are available) and you can choose from them, too.

In the selected place a red cursor starts to blink, and at the bottom the list of nearest units is displayed.

If in

User Settings the parameter City is set, then the city/town is already selected when you open the tool and you

need just enter a street.

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 be shown

5, 10 or 20 units can be shown (choose the number from the dropdown list).

Use routing

When choosing this option, the distance from the indicated place to a unit is calculated not directly but taking into account existing roads. The source for routing can be Google or Visicom maps.

District

Any geofence can be selected as district limitation. If any geofence in selected, the search is performed only among the units which are in this geofence at the moment. This feature is designed to exclude from search results the units which are far away from the indicated place. Note that after applying search parameters, district is reset automatically.

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 doesn't 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 unit name, driver's phone number (if any driver with indicated phone number is bound to unit), distance to the indicated place, and the button to

send commands to unit (including sending a message to driver).

333

If you are not satisfied with search results, please, check your

work list because the search of nearest units is made

on the basis of units displayed on this list.

334

Wialon Mobile

Attention! This module is licensed separately and can be not included in your package.

Wialon Mobile v1

Wialon Mobile v2

335

User Settings . You can also select the interface language. When logged in, observe the main menu and

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.

Table of Contents

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.

336

When a time passed, you can get fresher information about the unit. Simply push the Refresh button to get the latest data.

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.

More about commands...

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.

337

After you have logged in, the main menu

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 and mobile browser: 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

Table of Contents

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

to the system from an ordinary computer.

becomes available.

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;

Logout – logout from the program.

Units

At the first login, no units are displayed on the list until you apply a filter.

However, further times your previous work list will be restored.

To add or remove units from the work list, use a filter at the top. As you type, the work list is updated dynamically to fit your query (see

dynamic filter ). To display

all units, type *.

Units on the list are displayed with their names and icons. Additional information on each unit is available as well: time, speed, and location.

If clicking on a unit, its

properties are displayed.

338

Unit Properties

Unit properties are divided into two tabs:

Information

— information on current state of unit:

Main — time, phone number, UID (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);

Parameters — state of inputs/outputs and other parameters available in the last message.

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.

If a unit has the Show on map option enabled, there will be the Map button on the right. Clicking on it you can view unit current location.

Settings

Settings are also divided into two tabs:

Units

— options concerning the work list of units:

Show icons — enable/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 mobile device properties, Internet, and other factors.

Map

— options concerning the map:

Use geolocation — enable/disable

geolocation function.

Address provider — address provider can be either Gurtam Maps or Google Maps.

To return to the work list, press Back. All altered properties are saved

339

automatically.

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 depicted by its icon. Besides, it can have a tail (red line) that shows its movements for last 5 messages (if these movements were detected within the current session).

If you click on a unit displayed on the map, in the tooltip you can see the detailed information about this unit.

If you move to the map from the

main menu

, the map is scaled in the way to let you see all selected units. If you move to the map form

unit properties

, the map is centered on this unit.

However, map zoom can be altered, and the map itself can be moved. the scaled is changed with the help of plus/minus buttons in the top left corner as well as with the help of scroll button. To move the map, just drag it to the desired direction. In Apple devices the map can be also zoomed using multitouch function.

You can choose from several kinds of maps:

Gurtam Maps,

Google Map (with and without captions),

Google Satellite.

Geolocation

Wialon Mobile v2 supports geolocation function. Geolocation is the identification of 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 . Also you may need to 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 top. Click on this button at any time to move the map to your current location. Click on this marker to see available address information (it is taken from Google Maps, not from Gurtam

Maps).

In case geolocation is not successful, an error is displayed and the corresponding marker and button are not shown.

340

ActiveX

Attention! This module is licensed separately and can be not included in your package.

ActiveX allows to connect to the satellite tracking server Wialon™ through TCP/IP session (Internet or LAN) from different OLE applications such as 1C, Excel, Visual Basic, Word, or any HTML page.

ActiveX can be used also to create client connections which work with Wialon™ from different IDE such as Visual C++,

Visual Basic, Visual Basic for Application, Visual .NET, Delphi, etc.

It is possible to maintain simultaneously an unlimited number of clients connected to different Wialon™ servers through it.

WialoActiveX is designed as ActiveX COM server in the form of system DLL. The program is ready to use right after the installation. It does not need any additional configuration.

This component is available in two versions: for 32 -bit applications – WialonActiveX and for 64 -bit applications –

WialonActiveX64. Both of them can be installed simultaneously on Windows x64 OS in order to be used in different kinds of applications.

341

Connecting ActiveX to Wialon

To connect to ActiveX COM server, you have to construct the object WialonActiveX.WialonConnection that implements

IWialonConnection interface.

Here is an example of a code in Visual Basic. It contains comments but does not contain error check.

' The main component of the system that provides connection to Wialon

Dim Wialon As Object

' The collection of available units

Dim Units As Object

' A certain unit

Dim Unit As Object

' Wialon error string

Dim ErrStr As String

' The collection of messages from a unit

Dim Msgs As Object

' Counter

Dim i As Long

' The number of units in the collection

Dim CountOfUnits As Long

' Creating an object to connect to Wialon (for 64-bit applications --

WialonActiveX64)

Wialon = CreateObject ( "WialonActiveX.WialonConnection" )

' Connection check

If Wialon Is Nothing Then

' In case of error, the alert is generated

MsgBox ( "No Object" )

Return

End If

' Adjusting connection settings through

Wialon.

SetProxyMode "ProxyHost" , 8080 , "Login:Passw"

' Getting all units available to the "user" with the "passw" from the server

' "https://activex.gurtam.com" (prefix is required for secure connection)

' at 443 port without proxy server

Units = Wialon.

' Check for available units

If Units Is Nothing Then

' If units are not available, ActiveX error is reported as well as Wialon error

MsgBox ( "Error = " + Err .

Number .

ToString () + ": " + Err .

Source .

ToString ()

+ " (" + Err .

Description .

ToString () + ")" )

' Getting error from Wialon server

ErrStr = Wialon.

GetLastError ()

MsgBox ( "Wialon error: " + ErrStr )

Return

End If

' Getting the number of available units

CountOfUnits = Units.

Count

' Displaying a message box with the number of available units

342

MsgBox ( "Units = " + CountOfUnits.

ToString ())

' Starting the cycle for units search

For i = 1 To CountOfUnits

' Getting a unit from the collection

Unit = Units.

Item ( i )

' Check if the unit is available

If Unit Is Nothing Then

' If the unit is not available, report the error

MsgBox ( "Not unit" )

Return

End If

' Adjusting the flag to get addresses by coordinayed. False -- without addresses (fast). True -- with addresses (slow).

Unit.

ResolveLocations ( False )

' Getting messages from a unit for the indicated period (time in UNIX format)

Msgs = Unit.

GetMessages ( 1255112326 , 1256312326 )

' Check for messages availability

If Msgs Is Nothing Then

' If there are no messages, display the alert

MsgBox ( "No messages for unit: " + Unit.

Name )

Else

' Display the number of messages found

MsgBox ( "Messages = " + Msgs.

Count .

ToString ())

' Decrement the reference count for the given invoked environment frame CLR

' (if explicit memory release is needed after using an object)

System.

Runtime .

InteropServices .

Marshal .

ReleaseComObject ( Msgs )

' Releasing unit with messages

Msgs = Nothing

End If

' Decrement the reference count for the given invoked environment frame

CLR

' (if explicit memory release is needed after using an object)

System.

Runtime .

InteropServices .

Marshal .

ReleaseComObject ( Unit )

' Releasing unit with unit :)

Unit = Nothing

Next i

' Decrement the reference count for the given invoked environment frame CLR

' (if explicit memory release is needed after using an object)

System.

Runtime .

InteropServices .

Marshal .

ReleaseComObject ( Units )

' This is the end of the program, we're not going to work with these objects anymore, releasing

Units = Nothing

Wialon = Nothing

' End

MsgBox ( "End" )

More detailed example is available in Excel file delivered with ActiveX.

343

IWialonConnection – connection to ActiveX COM server.

ActiveX API

To see the description of all available interfaces and their features, use available DLL sources viewer.

Note.

Do not forget to free the storage space each time after using an object (example code for VBA: Set Unit = Nothing).

Available interfaces:

IWialonCollection – ActiveX collection of objects: IWialonUnit, IWialonUnitMsg, IWialonParam,

IWialonReport, IWialonUnitGroup.

IWialonUnit – units to be tracked.

IWialonUnitMsg – messages from units.

IWialonParam – message parameters.

IWialonReport – reports.

IWialonUnitGroup – unit groups.

344

IWialonConnection

IWialonConnection is the main interface which allows to connect to Wialon server and retrieve needed objects from there.

Login

Method

GetLastError

Disconnect

Parameter Return Value

BSTR Host, unsigned short

Port,

BSTR UserName,

BSTR Password

**UnitsCol

– BSTR* Error

– –

Description

To get all objects available to the current user. It is required to check each return value to be in existence

(Not Nothing) or check return result (Error). To get newer data, disconnect from the server using the function Disconnect.

To get the latest error from Wialon.

Disconnect from Wialon server in order to inquire fresh data later on (refresh).

GetReportsList

GetReportByID

SetProxyMode

– unsigned From, unsigned To, long long UnitID, int

TimeZoneOffset,

BSTR Lang, long long

ResourceID,

long long

ReportID

BSTR Proxy, unsigned short

ProxyPort,

BSTR

ProxyUserPwd

**ReportsCol

BSTR*

ReportData

To get all available report templates. It is required to check each return value to be in existence (Not

Nothing) or check return result (Error).

To get a report by report or resource ID. This is an analogue of the function Generate from the

IWialonReport interface. Starting and end time (From

– To) is indicated in UNIX format, that is in seconds from the 1 st

of January 1970. Unit ID can be received from the collection of available units. Time zone

(TimeZoneOffset) is indicated in seconds, for example, the value for Moscow is 10800, the shift from the prime meridian. The language Lang is indicated like domains (ru, en, etc). Report or resource ID can be received from the collection of available reports.

GetReportByIDU

GetUnitGroups

GetUnitGroupByID

int From, int To, int UnitID, int

TimeZoneOffset,

BSTR Lang, int ResourceID, int ReportID

BSTR*

ReportData

–

**UnitGroups long long

UnitGroupID

GetUnitGroupByIDU int UnitGroupID

**UnitGroup

This is an analogue of the function GetReportByID compatible with applications which do not support 64bit integer numbers. Not available in 64-bit version.

To get all available unit groups

To get a unit group

by its ID.

**UnitGroup

The analogue of the function GetUnitGroupByID compatible with applications which do not support 64bit integer numbers. Not available in 64-bit version.

–

Set parameters to connect to proxy server (host, port, login:password).

Get addresses by coordinates. Coordinates must be

345

GetLocationsText

BSTR Lats,

BSTR Lons, int Count

BSTR* Text in text format separated with comma. Use dot as decimal delimiter. The number of coordinates is set in the third parameter, so the number of addresses, so the number of addresses returned will be as set.

Addresses are returned in text format, separated with comma.

346

IWialonCollection

This interface describes the collection of ActiveX objects. It can contain the following interfaces: IWialonUnit,

IWialonUnitMsg, IWialonParam.

Property Parameter

Item

Count

long Index

–

Return

Value

long

*pVal

Description

IDispatch**

pVal

To get an object from the collection by the given index. The indexes begin from one (1). It is required to check each return value to be in existence (Not Nothing) or check return result (Error).

To get the number of units contained in the collection.

347

IWialonUnit

This interface contains the description of units.

Method/Property

Name (property)

GUID (property)

ID (property)

IDU (property)

Phone (property)

LastPosition

(property)

GetMessages

(method)

GetMessagesU

(method)

Parameter

unsigned From, unsigned To int From, int To

Return Value Description

BSTR* Name To get unit name.

BSTR* GUID To get unit GUID (global unique identifier).

long long* ID int* ID

To get unit local ID.

The analogue of the function ID compatible with applications which do not support 64 -bit integer numbers. Not available in 64-bit version.

BSTR* Phone

IWialonUnitMsg

**LastPos

To get the phone number of the SIM card installed on a unit.

To get the latest message from the unit with its location.

**MsgCol

To get the collection of messages for the given period. The time is indicated in UNIX format, that is in seconds beginning from the 1 st

of January

1970. It is required to check each return value to be in existence (Not Nothing) or check return result (Error). To speed up server work, it is recommended to inquire messages for up to 30 days.

**MsgCol

The analogue of the function GetMessages compatible with applications which do not support

64-bit integer numbers. Not available in 64-bit version.

GetLastError

(method)

BSTR* Error

ResolveLocations

(method)

BOOL

ResolveLocationsFlag

–

To get the latest error from Wialon.

Set the option to define location by coordinates when getting message. If the option is on, it considerably enlarges time to get messages.

348

IWialonUnitMsg

The interface containing the description of one message from a unit.

Time

TimeU

Speed

Course

X

Y

Z

Property

Type

CountSats

Param

Location

ParamCount

Parameter Return Value

int Number unsigned*

Time

int* Time int* Speed int* Course double* X double* Y double* Z

BSTR* Type int*

CountSats

IWialonParam

**Param

Description

To get message time. The time is indicated in UNIX format, that is in seconds beginning from the 1 st

of January 1970.

The analogue of the property Time compatible with applications which do not support 64 -bit integer numbers. Not available in 64bit version.

To retrieve speed from a message. It is required to check the result of function operation because there can be no speed in a message.

To get movement direction from a message. It is required to check the result of function operation because there can be no course in a message.

To get longitude. It is required to check the result of function operation because there can be no location information in a message.

To get latitude. It is required to check the result of function operation because there can be no location information in a message.

To get altitude. It is required to check the result of function operation because there can be no location information in a message.

To get message type: SMS, Data, CMD, etc.

– udp – message contains location and data such as speed, course, number of satellites, I/O, driver ID.

– ud – message contains only data from a device such as I/O and driver ID.

– ucr – message contains information about an executed command (command name, parameters, user, link type, connector name, execution time).

– us – message contains information about a received SMS message (SMS text, phone number).

– evt – message contains location of an event happened.

To get the number of satellites which is important to estimate coordinates accuracy. If the number is 255, it means satellites are locked successfully but their number is unknown. It can happen if the device used does not send such information in general. It is required to check the result of function operation because there can be no location information in a message.

To get messages parameter by its number. It is required to check each return value to be in existence (Not Nothing) or check return result (Error).

BSTR*

Location

long*

ParamCount

To get unit location in the from of address.

To get the number of parameters in a message.

To get a parameter by its name. It is required to check each return

349

ParamByName

BSTR

ParamName

SMSText

Driver

CMDName

IWialonParam

**Param value to be in existence (Not Nothing) or check return result

(Error).

BSTR* SMS To get SMS text (only for SMS messages).

BSTR* Driver To get driver's name if known.

BSTR*

CMDName

To get command name if known.

CMDParam

UserGUID

LinkName

LinkType

ModemPhone -

EventText

BSTR*

CMDParam

BSTR*

UserGUID

BSTR*

LinkName

BSTR*

LinkType

To get command parameters if known.

To get the name the user who executed the command (if known).

To get the name of hardware which were used to connect to the unit for command execution (if known).

To get link type (UDP, TCP, GSM) used to execute a command (if known).

BSTR*

ModemPhone

To get the number of the modem used to execute a command (if known).

BSTR*

EventText

To get event text if there is such.

350

IWialonParam

The interface contains the description of parameters in a message.

Property Param

Type

Name

Value

ValueStr -

Return

Value

Description

BSTR*

Type

BSTR*

Name

VARIANT*

Value

BSTR*

Value

To get message type (int, double, string).

To get parameter name.

To get parameter value. Previously, you should get to know data type in VARIANT – to do this use the function Value.Type or VarType(Value).

The analogue of the property Value compatible with applications which do not support

VARIANT data type.

351

IWialonReport

This interface allows to retrieve reports from the monitoring system. Only ready report templates can be used. Creating new report templates is impossible here. To generate a report, the function GetReportByID from

IWialonConnection

interface can be used instead.

Method/Property

ReportIDU

(property)

ResourceID

(property)

ResourceIDU

(property)

Parameter

int* ReportID long long*

ResourceID

int*

Return

Value

ResourceID

Description

Generate

(method) unsigned From, unsigned To, long long UnitID, int

TimeZoneOffset,

BSTR Lang

BSTR*

XMLData

long long*

ReportID

To generate a report on the server and get it in the form of

XML string. Starting and end time (From – To) is indicated in UNIX format, that is in seconds from the 1 st

of January

1970. Unit ID can be received from the collection of available units. Time zone (TimeZoneOffset) is indicated in seconds, for example, the value for Moscow is 10800, the shift from the prime meridian. The language Lang is indicated like domains (ru, en, etc).

GenerateU

(method)

Name (property)

int From, int To, int UnitID, int

TimeZoneOffset,

BSTR Lang

BSTR*

XMLData

The analogue of the function Generate compatible with applications which do not support 64 -bit integer numbers.

Not available in 64-bit version.

BSTR*

ReportName

To get report name. Not available in 64-bit version.

ReportID

(property)

To get report unique ID.

The analogue of the property ReportID compatible with applications which do not support 64 -bit integer numbers.

Not available in 64-bit version.

To get the unique ID of the resource where a report template belongs to.

The analogue of the property ResourceID compatible with applications which do not support 64 -bit integer numbers.

Not available in 64-bit version.

352

IWialonUnitGroup

The interface contains the description of unit groups. To get unit groups collection see

IWialonConnection .

Method/Property Parameter Return Value

Name (property)

Description

BSTR*

UnitGroupName

To get the name of current unit group.

ID (property)

IDU (property)

GetUnits (method)

CheckUnitInGroup

(method)

CheckUnitInGroupU

(method)

int UnitID long

UnitGroupID

long*

To get unit group unique ID.

int* UnitGroupID

The analogue of the property ID compatible with applications which do not support 64 -bit integer numbers.

Not available in 64-bit version.

**UnitsCol long long

UnitID

BOOL*

UnitInGroup

BOOL*

UnitInGroup

To get collection of the units in the group.

To check whether a unit with the given ID belongs to the given group.

The analogue of the function CheckUnitInGroup compatible with applications which do not support 64 -bit integer numbers. Not available in 64-bit version.

353

Compatibility

The functions with the ending U are intended to create compatibility with 64-bit integer numbers (1C 7th version). This ending indicates that the function will get or return all values as usual 32-bit integer numbers (signed integer).

All duplicated functions and properties are interchangeable. If your application can support 64-bit integer numbers, it is recommended to use the functions which support this digital capacity, that is without U ending.

Always use homogeneous functions. It means, if you are working with 64-bit integer numbers, use them throughout the application. The same is for 32-bit systems.

For 64 -bit operating systems there is a special component – WialonActiveX64. It works only with 64-bit applications.

For 32-bit applications installed on 64-bit OS, use 32-bit component WialonActiveX.

354

Garbage Collector

System garbage collector is a service that automatically reclaims unused memory. See GC Class for details.

If using ActiveX you notice that the garbage collector rarely cleans the main memory, in your program code you can decrement the count of references to object before the garbage collector is activated. To do this, use the following code

(VB):

System.

Runtime .

InteropServices .

Marshal .

ReleaseComObject ( object )

object = Nothing

It will allow you to free the memory beeing used by an object if its references count is zero. See

Marshal.ReleaseComObject Method for more details.

An alternative way to clean the memory is a method of forced garbage collection (VB):

GB.

Collect ()

See GC.Collect Method for the full description of the method.

355

Calculating Fuel: Time-Based or Trip-Based

Errors

Each function or method activated in the program returns an error code. Below see the list of more frequent errors which can help you to detect the problem:

-99

-300

-301

-302

-303

-28

-34

-35

-36

-9

-18

-22

-27

-47

-51

-55

-56

-80

-3

-5

-1

-2

-6

-7

Error

Code

-81

-95

-96

-97

-98

-304

-305

Description

Succeeded.

Unknown error.

Non-supported protocol.

Error initializing connection. It can happen when trying to create an object IWialonConnection repeatedly.

Invalid URL address.

Error to resolve proxy server name.

Error to resolve server name.

Error connecting to the given address. It can happen when firewall or antivirus program are set incorrectly.

Access to server denied.

Insufficient data. It is possible if connection to server is broken or in case of server abnormal termination.

Http error.

Internal error while executing query.

Execution timeout is exceeded.

POST query error.

Error connecting through a protected connection (SSL).

It is impossible to continue loading. Connection may be broken.

Too many redirections.

Certificate error.

Data communication error.

Data acquisition error.

Incorrect SSL connection termination.

The socket is not ready to data sending or acquisition. Maybe, all sockets are busy – try to upload unusable applications.

Wialon server error. Use the function GetLastError to retrieve the error text.

Error when operating file input/output. It can happen if the user who is executing the program does not have enough access to read and record data in the temporary folder.

Error processing data. Maybe, the server returned invalid data or was abnormally terminated while executing the inquiry.

Error processing data. Maybe, the server returned nothing or was abnormally terminated while executing the inquiry.

Inquiry to the server is impossible because of incorrect product settings. Please, reinstall ActiveX.

Error when parsing data received from the server.

Error while creating objects. It may be caused by memory lack or if you inquire too many messages. Close other applications and retry.

Not enough memory to unpack data. Close other applications and retry.

356

Frequently Asked Questions

Reports

Common Report for All Units

False Thefts or Fillings

Fuel Filling Is Not Detected

Fuel Theft Is Not Detected

Incorrect Intervals of Engine Hours

Incorrect Mileage

No Report on Geofences

Trip Not Detected

GPS Hardware

Calibrating a Fuel Tank

Device Does Not Connect

New Hardware Support

No Parameter for a Sensor

Protocol for a New Device

Unable to Execute a Command

Maps

Google and Yandex Addresses in Reports

INGIT Maps

Placing New Maps on Wialon Hosting

Wrong addresses

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 – 'Litres' and 'Volts', and so many rows as parts you divide your tank into (+ O litres 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 ('Litres') 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 analysed 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 litres and the other point 5 volts = max litres.

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.

369

New Hardware Support for details.

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 you type of device required 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 on the list, write to [email protected] and attach the original communications protocol of your device. See

370

New Hardware Support

What to do to support a new type of tracking hardware in Wialon?

To integrate a new device in Wialon, we need the following information:

1.

The original communications protocol of the device.

2.

Accurate name of the device.

3.

Link to the site of the manufacturer of the device.

4.

Photo of the device.

After obtaining this information, its analysis will be done and further actions defined.

To support a new device, we need to see real data from it. For this, it should be connected to our special test server for a while.

371

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.

372

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.

373

list of standard commands .

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

[email protected] with detailed description of those commands. See the

374

Maps

Google and Yandex Addresses in Reports

INGIT Maps

Placing New Maps on Wialon Hosting

Wrong addresses

375

More about addresses in reports...

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.

376

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

377

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

Cartography

for details.

It is possible to place a map for private usage (visible only for users of your tracking system). This feature is a part of

Premium

package.

378

Placing New Maps on Wialon Hosting .

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

Cartography for details.

See also

379

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.

385

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.

386

Restoring Deleted Unit

How to restore an accidentally deleted unit?

1.

Deleted items are stored in the Trash during 10 days after deletion. During that period, they still can be saved. Make a request to [email protected] for restoring a unit.

2.

In you request, indicate unit name, deleting time, and user who made it.

3.

The unit will be restored in the main account and available only to the manager of hither level. Access rights can be corrected if necessary. Besides, you can recreate the unit in the account where it belonged before and transfer all necessary properties to it.

387

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 trip detector

to that track:

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

388

Apparently, the user has no right to change their settings. If the option 'Can change settings' is disabled in user properties , activate it for a while, then log in as this user and add all necessary units to the Monitoring list. After that,

Unit Disappear from the Monitoring List

I add all available units to the Monitoring panel but with each new session (login) the list is 2-3 units short again.

you can disable the option again.

389

access to the unit. Required access flag is 'Register events'. Check if the user (or rather the

Violations Are Not Registered

I created a notification with action to register a violation. The notification triggers but the violation is not registered. Why?

Possible cause is a lack of

creator of the resource where the notification belongs) has such access.

390