Professional Documents
Culture Documents
Company Information
Telenity is a leading provider of innovative services and solutions for communications networks in
emerging markets. With a portfolio of market ready software products, Telenity enables operators to
unleash and monetize their network assets, and personalize services through location. Telenity's
revenue generating solutions include location middleware, partner management system, and location
based mobile marketing platform built with reusable service delivery components; location-based
operator solutions for subscriber acquisition and customer experience management; messaging
products including SMSC, MMSC, USSD and Messenger; innovative VAS such as people and
resource finder, local tips and personalized call completion; and M2M solutions for device/connectivity
management and service enablement.
Copyright Information
In no event shall Telenity, or the authors or the distributors be liable to any party for any damage
including but not limited to direct, indirect, special, incidental, or consequential damages arising out of
the use of this documentation, or the Software, or any derivatives thereof, even if Telenity, or the
authors or the distributors have been advised of the possibility of such damage. Telenity, the authors
and the distributors specifically disclaim any warranties, including but not limited to, the implied
warranties of merchantability, fitness for a particular purpose, and non-infringement. This document
and the Software are provided on an "as is" basis, and Telenity and the authors and distributors have
no obligation to provide maintenance, support, updates, enhancements, or modifications.
Trademarks
Telenity and Canvas are registered trademarks of Telenity Iletisim Hizmetleri A.S.
TABLE OF CONTENTS
1. INTRODUCTION .......................................................................................................................... 6
1.1. Introduction ............................................................................................................................ 6
1.2. Executive Overview .............................................................................................................. 6
1.3. Key Features ......................................................................................................................... 7
1.4. Architecture............................................................................................................................ 8
2. FEATURES – CUSTOMER MANAGEMENT .......................................................................... 9
2.1. Landing Page ........................................................................................................................ 9
2.2. Customer Management ..................................................................................................... 10
2.2.1. Adding a Company ..................................................................................................... 10
2.2.2. Listing Companies ...................................................................................................... 14
2.2.3. Deactivating Companies ............................................................................................ 15
2.3. User Management .............................................................................................................. 15
2.3.1. Adding a New User ..................................................................................................... 15
2.3.2. User List ....................................................................................................................... 16
2.3.3. Delete User .................................................................................................................. 17
2.4. Resource Management ..................................................................................................... 17
2.4.1. Adding Resources ...................................................................................................... 17
2.4.2. Adding Resources - Bulk ........................................................................................... 18
2.4.3. Listing Resources ....................................................................................................... 19
2.4.4. Delete Resource ......................................................................................................... 20
3. FEATURES – RESOURCE MANAGEMENT ........................................................................ 21
3.1. Dashboard ........................................................................................................................... 21
3.2. Map ....................................................................................................................................... 22
3.3. Resources Menu ................................................................................................................. 22
3.3.1. Resource List............................................................................................................... 23
3.3.2. Add Resource Groups................................................................................................ 24
3.3.3. Resource Group List .................................................................................................. 26
3.3.4. Locate Resources ....................................................................................................... 27
1. INTRODUCTION
1.1. Introduction
airtel tracemate+ is an innovative service for enterprises and small businesses to locate,
monitor, and manage their employees, resources, and vehicles from a unified and easy-to-
use Web based interface.
Managing employees in the field has always been a challenge, especially for small
businesses. Small Businesses and Enterprises are looking for solutions that will help them
be more efficient through smarter dispatching, which would mean faster driving routes, better
customer service, and fuel savings.
airtel tracemate+ is a member of the Canvas® enterprise location based service portfolio. It
is a powerful location-based employee, resource and vehicle tracking application that runs
with network provided location information to help SMEs and Enterprises to achieve
efficiency in managing employees in the field.
As the solution works with network provided location information, SMEs and Enterprises do
not need to invest on expensive solutions. All the existing mobile phones can be used to get
the location of the resources.
Company administrator(s) can monitor and track employee activities through a Web based
application. The data generated by the application can be used to generate different activity
reports and planning purposes.
Airtel tracemate+ complements enterprise business with location and drives subscription-
based revenues. It also allows mobile network operators to get the data created by the
application which in turn can be used for marketing purposes.
It also allows SMEs and Enterprises to communicate with their resources in an effective way.
It offers SMS broadcasting functionality with advanced proximity options.
1.4. Architecture
Airtel tracemate+
Airtel tracemate+ platform integrates with the operator network through the Location
Middleware, which consists of the following modules: Location Gateway (LCGW) and
Signaling Gateway for connecting to GMLCs and HLRs for network based positioning,
Services Subscription Manager (SSM) for subscription management, and Messaging
Gateway (MSGW) for messaging.
The Web Portal use RESTful APIs to integrate with the platform and can integrate with
different Online Map Data providers as needed.
Landing Page:
Helps mobile network operators to introduce airtel tracemate+.
Supports multi-language and SMEs and Enterprises can check the features of airtel
tracemate+ and learn how to subscribe to the service.
Provides access to Guides and Sign In page.
It is possible to customize the landing page and other pages accessed through the landing
page by simply changing images, logos, and text.
Log in Page
Credentials for the customer companies are created by System Administrators. If company
admin loses or does not remember the login credentials, it is possible to reset the password
by clicking on the “Forgot Username or Password” link.
System Administrators also use the same log in page to access administration capabilities.
Once the System Administrator logs-in to the system, the following operations can be
accessed through the menu:
Companies
o Add Company
o Company List
Users
o Add User
o User List
Resources
o Add Resources
o Resource List
System Administrator can add a new company to the system by filling out the following
form:
Adding a Company
The form is composed of three pages and all the mandatory fields should be filled in
correct format.
Pricing Info
Charging MSISDN
Circle Id
Active (Yes / No)
Pricing information is only used to keep record of the sales price. The system does not
use this information for real time charging purposes. Charging MSISDN is logged into the
CDRs and CDRs are used to charge the customer. Thus, charging is an offline process.
It is possible to configure tracking days and period. These settings are company-wide
and will be applied to all resources of the company.
Getting consent from the customer is optional. Every customer should decide whether or
not to ask for tracking consents from the employees. If consents are enabled for a
customer, then the employees that belong to the customer cannot be tracked unless the
employee gives consent (via SMS).
Tracking Settings
Once all the information is entered by the system administrator, company will be created
in the system and company admin will be able to access to the system.
Company List
Company Name
Number of Resources
Contact Person
Pricing
Sales Representative
Industry
By selecting a company from the list, it is possible to edit or deactivate the company. If
edit option is chosen, System Admin will be shown the details of the company.
When the Deactivate option is chosen, a confirmation dialogue is displayed. If the System
Admin confirms the deactivation operation, company will be deactivated.
Deactivated companies can be activated later on.
User Management
It is possible to add new users to the system. The following roles are available:
System Admin
Company Admin
Company User
Username
Name
Surname
Email Address
User Role
Password
Password Confirmation
User List
By selecting a user from the list, it is possible to edit or delete the user. If edit option is
chosen, System Admin will be shown the details of the user.
When the Delete option is chosen, a confirmation dialogue is displayed. If the System
Admin confirms the delete operation, user will be deleted.
Resource Management
First Name
Last Name
MSISDN
Status (Can be Active or Inactive)
It is also possible to import resources using a CSV formatted (Comma Separated Values)
file.
Uploaded file is checked and validated before importing resources. If the validation is
successful, resources will be imported from the file and created under selected company.
Resource Management
Name
MSISDN
Company
Status
By selecting a resource from the list, it is possible to edit, delete, or deactivate the
resource. If edit option is chosen, System Admin will be shown the details of the
resource.
Resource Management
When the Delete option is chosen, a confirmation dialogue is displayed. If the System
Admin confirms the delete operation, resource will be deleted.
Once the customer, its users, and resources are created, customer admins and users can
login to the system to start managing their resources.
3.1. Dashboard
Dashboard
On top of the dashboard page, there are links to the features (Resource, Landmarks, etc.), a
notification icon showing unread alarm count and the logged in user’s icon which offers
operations like logging out, changing password and setting tracking parameters.
On the left side of the dashboard, there is a sliding control (activated when clicked on “i”
icon) that displays a summary of resources, resource groups, landmarks, and alarms. This
control provides read-only information. No operations can be performed on it.
Under Resources, total count of company resources (Total) and count of resources
that are being actively tracked (Tracking Active) are displayed.
Under Resource Groups and Landmarks, total count of company’s resource groups
and defined landmarks can be seen.
Alarm Definitions part shows the total count of defined alarms.
Total numbers of resources that are successfully tracked and failed to track are
shown under Latest Marks.
3.2. Map
Resources menu allows customer admin and customer users to group resources, view
resources, and locate resources on map.
Resources Menu
Resources List
The resource list can downloaded to local hard drive as a CSV file by using the
Download button (top left of the page).
On the right side of the page, there is a field that allows customer admin and customer
user to search resources within the list. It is a smart search field; it retrieves the entries
while typing.
The icons shown under the Actions heading in the above figure are visible when the
mouse is hovered on that column. Customer Admin or Customer user can
deactivate/activate (disable/enable tracking) the resource, see the 50 last location
records of the resource (Marks button), and change the details of the resource (Edit
button). To edit a resource, it is also possible to click on its name under the Name
heading, too.
When the Marks button is clicked when a resource is selected, last 50 location mark
records of the resource is displayed on the map and listed on the screen.
Marks
When the addresses listed on the screen are clicked, the location is shown on the map.
Resource Group creation involves two steps. First one is giving its profile information
(Profile tab) and second is configuring its tracking (Tracking tab).
On Profile tab, name of the resource group should be given. Description is optional.
Resources that will be the members of the resource group are selected at the Resources
field. This field has smart search feature. While typing it pulls the list of resources
matching the characters, as a combo box list. Also, it is possible to just click into this field
and see the whole resources on the system.
To make the resource group active (trackable), “Yes” option at “Is Active” field should be
selected.
The next tab helps customer admin and customer user to set preferences for tracking of
the group.
It is possible to lower the frequency of tracking at the field Tracking Interval. Its value (10
min in the above sample) comes from the tracking frequency set for the customer
company.
Note: If the tracking interval and other available tracking settings are changed for the
resource group, they will override the tracking settings set for the customer company.
This menu item lists the resource groups defined on the system.
Like resource list described previously, there is a smart search field at the top right of
window, it retrieves the entries while typing.
The list can be sorted using the column headings (Name, Description, Number of
Resources and Is Active (green icon means that the resource is active, red icons are for
deactivated resources)).
The icons shown under the Actions heading in the above figure are visible when the
mouse is hovered on that column. It is possible to deactivate/activate (disable/enable
tracking) the resource group, change the details of the resource group (Edit button) or
delete it from the system.
This feature can be used to see the last recorded location of a resource on the map.
Once it is clicked from the Resources menu, page shown below appears.
Locate Resources
In the sliding control names of resource groups are listed. To select resources, just click
on a desired resource group. It will expand and list its resources, as shown above (e.g.
Telenity). One or multiple resources can be located by clicking on the resource names. It
is possible to see locations of all resources in a resource group by clicking on “All”
button. To clear the map, click on “None” button.
There is also an “ALL” item that can be seen at the very below of resource groups. It
lists all the active resources defined on the system. It can be particularly used when
there are resources that are not members of any resource groups.
When a resource is located on the map, name, MSISDN, address, and date and time
information is displayed.
Landmarks on airtel tracemate+ are used for setting proximity alarms (e.g. to be notified
when a resource is close to a landmark). They belong to landmark categories and a
landmark can be a member of multiple landmark categories.
Landmarks can be of two types: Geo-fence and POI (Point of Interest). A geo-fence is a
geographical region specified by a circle, rectangle or polygon and POI is a location point
specified by coordinates.
Landmarks menu is used to perform operations like adding/listing landmarks and landmark
categories.
Landmarks Menu
To add a landmark, first determine what type of a landmark it will be. On the left of the
map view, there are small icons. Polygon ( ), rectangle ( ) and circle ( ) icons are
used for geo-fence landmarks. Marker ( ) icon is used for POIs.
According to the landmark type, click on the appropriate icon and hover the mouse
cursor to the desired location. Cursor image will change to a big plus sign. If you are
creating a geo-fence, click the mouse button, draw your shape and release it when
finished. If it is POI, clicking on the location point is enough. Tooltips of the mouse cursor
will guide the process (see below screen). Below sample screen shows a drawn
landmark as a rectangular geo-fence.
Creating a Landmark
As soon as drawing is finished (release the mouse button), a form asking the details of
the landmark appears, as shown below.
Landmark Details
Click Save to create the landmark after providing a name and selecting a landmark
category. Please note that, a landmark may belong to multiple categories. Providing a
description is optional.
After the landmark is created, it is possible to locate it using the map view. Below screen
shows the created landmark on the map.
Landmark Details
When clicked on any point within the landmark region, a tooltip including the landmark’s
icon, name and the coordinates of the clicked point appears, as shown below.
Landmark Tooltip
This tooltip also includes the link “Show nearby resources”. When clicked, a form right to
the map view opens, as shown below.
Resources nearby
This form lists the resources that are close to the landmark within the default range (3
km). This distance can be changed using the Range field and get the list of resources by
clicking on km button next to this field.
This form is also useful to send a short message to the resources that are close to a
landmark. Just write the SMS into the Message field (maximum 140 characters) and click
on the Send SMS button. To close this form, click on Cancel.
Landmark List
There is a smart search field at the top right of window, i.e. it retrieves the entries while
typing.
It is possible to sort the list using the column headings. Just click on the arrow buttons at
Type, Name, Description and Category headings.
The icons shown under the Actions heading in the above figure are visible when the
mouse is hovered on that column. You can change the details of the landmark (Edit
button) or delete it from the system. To edit a landmark, you can click on its name under
the Name heading, too.
Landmark Category
On this form, name of the category should be given. Providing its description is optional.
An appropriate icon from the Icon combo box field should be selected as well.
There is a smart search field at the top right of window, i.e. it retrieves the entries while
typing.
It is possible to sort the list by the column headings. Just click on the arrow buttons at
Name and Description headings.
The icons shown under the Actions heading in the above figure are visible when the
mouse is hovered on that column. It is possible to change the details of the category (Edit
button) or delete it from the system.
Alarms Menu
While defining an alarm, the first step is to provide a name for the alarm. Then, the type
of the alarm should be selected.
Add Alarm
Available values are Landmark Entry-Exit and Proximity Monitoring. Former one is
used to produce alarms when a tracked resource is entered into or exited from a
landmark. When Landmark Entry-Exit is selected, two new fields appear as shown
below.
The landmarks for this type of alarm should be provided in the Landmarks field. Also, a
condition for this type of alarms should be given in the Alarm Condition field. Available
conditions are:
A landmark should be provided. Also, a distance from the landmark should be given in
the Distance (Km) field. When a resource is located within this distance from the
landmark, the alarm will be produced.
Then, select the severity of the alarm. Available values are Informational, Warning, Minor,
Major and Critical.
Provide the resources and/or resource groups that will be subjected to the alarm
definition (using the fields Resources to Monitor and Resource Groups to Monitor). Both
fields have smart search capabilities. They retrieve the values as typing. It is also
possible to click into these fields to see the whole lists of resources and resource groups.
Finally, SMS and e-mail distribution lists should be selected. These lists include the
phone numbers and e-mail addresses to which the alarms will be sent. Both lists can be
provided.
There is a field on top right of the window that lets you search alarms within the list. It is a
smart search field, i.e. it retrieves the entries while typing.
Alarm List
The list can be sorted by the column headings. Just click on the arrow buttons at each
heading. Each column information comes from the form used when an alarm definition is
created.
The icons shown under the Actions heading in the above figure are visible when the
mouse is hovered on that column. It is possible to change the details of the alarm (Edit
button) or delete it from the system.
Distribution List
Provide a name for the list. Description is optional. Select the type of the list in the
Distribution List Type.
When SMS is selected, a new field appears below it; MSISDN List. Phone numbers can
be inserted into this field. Once typing is finished, it will be shown as a linked text just
below the field, as shown in the figure.
Select this linked text; the number will be placed into the field. It is possible to provide as
much numbers as desired.
Distribution Lists
There is a field on top right of the window that lets you search the lists. It is a smart
search field, i.e. it retrieves the entries while typing.
It is possible to sort the list by the column headings. Just click on the arrow buttons at
headings.
The icons shown under the Actions heading in the above figure are visible when the
mouse is hovered on that column. It is possible to change the details of the list (Edit
button) or delete it from the system.
Alarm Notifications
Note: The same view can also be reached using the notification icon located at the top
Initially, when this page is opened, it retrieves all the alarms produced. It is possible to
provide some criteria to narrow down the list using the filtering feature. There is a Filter
button on top right of the page for this purpose, as shown below.
Alarm list can be filtered by severity, type and name of alarms. Also, a date range can be
provided, so that alarms produced only between the specified dates are listed. It is also
possible to provide resource or resources (using the Resource Name field) to see the
alarms produced for these resources.
Alarm Filter
Top left of the alarm list; there is a checkbox which enables selection of all messages on
the current page.
Selecting Alarms
None is for deselecting alarms. Actions button is used to mark the selected or all alarms
as read.
A nice feature of the alarm list is to see the alarm event on the map. Show on Map
button at each line in the alarm list is used for this purpose. Once it is clicked, a small
map view within the list appears, as shown below.
Below sample shows a resource approaching to a landmark, which is the event that
produced Proximity Alarm2.
Airtel tracemate+ provides useful reports to monitor resource tracking. They can be reached
through Reports menu, as shown below.
Reports Menu
A time range should be provided using the fields for From Date and To Date. It is
possible to retrieve the report for all the resources by selecting Yes for the field Use all
resources.
It is possible to retrieve the report for specific resources or resource groups. In that case,
select No. Two new fields appear in the form asking for the resources/resource groups,
as shown below.
After the criteria are provided, click the Search button, the report will be retrieved, as
shown below.
Summary View on top of the report output is used to generate a summary out of the
location report, as shown below.
Summary view
This summarized report can be exported in Microsoft Excel format and downloaded to
local disk, by clicking on the Excel button.
Location History report has also heat maps feature. It is useful to see which resources
are located at which locations, at how many times. It can be opened using the Heat map
View button on top of the report view. A sample heat map view is shown below.
It is possible to see more detailed counts and locations by zooming in on the map.
Traffic Report
Initially, the report is retrieved for the last 1 year. It is possible to specify another date
range (not exceeding 1 year) using the Filter button. Below form appears when it is
clicked.
Other than the features mentioned in the earlier sections, airtel tracemate+ map has also a
distance measurement feature. It can be used in all operations where the map is involved.
Below sample view is from the Manage Landmarks on Map item under the Landmarks menu.
Map View
To measure distances (bird’s eye) just click on the ( ) icon on the map. Mouse cursor turns
into a big plus sign. First click on the map will be the starting point for measurement.
Map View
Map view will show the distances between points you clicked. To finish measurement, just
click on the last point you selected.