bawit online portal · bawit online - 06 – basic information of bawit online portal |...

BaWiT Online - 06 – Basic information of BaWiT Online portal | SCT1006.0002

of 38

BaWiT Online portal 06 – Basic information of BaWiT Online portal

(Work version of the documentation that has not passed language revision)

SCT1006.0002

Revision No.2.4

www.SCT.sk

www.SCT-Telemetry.eu

www.BaWiT.eu

[email protected]

information, control, telemetry and communication systems

information, control, telemetry and communication systems

http://www.sct.sk/

http://www.sct-telemetry.eu/

http://www.bawit.eu/

mailto:[email protected]

BaWiT Online - 06 – Basic information of BaWiT Online portal | SCT1006.0002 of 38

Table of Content

1. Introduction ................................................................................................................................... 4

1.1 BaWiT Online Architecture ................................................................................................................. 5

1.2 Logon Form ......................................................................................................................................... 6

1.3 Main screen ........................................................................................................................................ 7

2. Users settings and accounts .......................................................................................................... 10

2.1 Settings and management of user accounts .................................................................................... 10

2.2 Management of the user profile ...................................................................................................... 12

2.3 User Role Overview .......................................................................................................................... 12

3. Plugins manipulation .................................................................................................................... 14

3.1 Type of offered data ......................................................................................................................... 14

3.2 Plugin`s sections ................................................................................................................................ 14

3.3 Quick help .......................................................................................................................................... 14

4. Data Filtering ............................................................................................................................... 15

4.1 Period filter ....................................................................................................................................... 15

4.2 Data value filtering ........................................................................................................................... 17

4.3 Data filtering through tables head filters ......................................................................................... 18

4.3.1 Data selection by Condition ......................................................................................................... 18

4.3.2 Data selections by “text contains” method .................................................................................. 18

4.3.3 Data selections from an list .......................................................................................................... 20

4.4 Data sampling (aggregation function) .............................................................................................. 21

4.5 Paging ............................................................................................................................................... 22

5. Data Export .................................................................................................................................. 22

6. Offered Plugins ............................................................................................................................ 24

6.1 Plugin Chart ...................................................................................................................................... 24

6.2 Data Plugin ....................................................................................................................................... 25

6.3 DataPoints Plugin ............................................................................................................................. 26

6.4 Device Specification Plugin ............................................................................................................... 27

6.5 Download Plugin .............................................................................................................................. 28


6.6 Plugin Command .............................................................................................................................. 29

6.7 Service Plugin ................................................................................................................................... 30

6.8 Map Plugin ........................................................................................................................................ 32

6.9 Monitoring Plugin ............................................................................................................................. 33

6.10 Notifications Plugin .......................................................................................................................... 34

6.11 Reports Plugin .................................................................................................................................. 35

6.12 Log viewer Plugin.............................................................................................................................. 36

6.13 User Trace Plugin .............................................................................................................................. 37

6.14 Plugin Project.................................................................................................................................... 38


1. Introduction

BaWiT Online domain (www.BaWiT.eu) is offered without any charge for all Soft & Control Technology

s.r.o. customers . It provides data processing (data points) from technologic objects that can transfer

measured data online, or transfer data at a set time to this domain. The domain name came from one of

sale products, commercially called BaWiT (Battery Wireless telemetry systems). Data transmission can be

realized by connecting via Ethernet, or remotely (telemetry) through GSM/GPRS, CDMA.

BaWiT Online offers features :

Remote control and optimization of energy consumption (relating to gas, electricity, water, heating, and other measurable types of energy).

Remote control and registration of technological conditions in manufacturing and storing in context of ISO requirements.

Guarding the parameters of technological devices and objects. Monitoring, commanding, and movement control of telemetry systems in terrain. Remote collecting, control, commanding, and visualization of data in accordance with the

requirements defined by the portal user. Remote configuration, parameter changing, and system programming. Possibility of new functionality defining by the portal user.

This manual is overview guide of BaWiT Online domain, which introduces their solution. More detailed

guides are accessible through the menu „Help“ after login into BaWiT Online and work on a specify screen –

plugin.



1.1 BaWiT Online Architecture

Domain www.BaWiT.eu is the standard multi-user web application that offers many next

features for users to maximize user-friendly data processing and their visualization. Displayed data

are measured data gained from technological units that are transferred at first to an database ( K2

System Database). Web application “BaWiT online” visualizes them remotely to the users via

internet browser on computers or smart phones. Transferred data are named Data Points (DP next

in this document) which are composed from measured value and additional information about this

value. The Figure 1. shows the architecture of the web solution with a description of its internal

parts under the figure.

User

Measured Data Preprocessing

K2 System Database

BaWiT Online Web Application

Plugin

User

Data Point

Network

Plugin Plugin

Plugin Management

User Profile Management ACL

Data Logic & Application Logic

Fig. 1 Bawit Online application architecture

BaWiT Online (similarly to the nowadays current web solutions) is multi-tier application consisting of

several blocks which we can categorize as follows:

Set of plugins which offer different kinds of users functionalities

Plugin management which manipulates with plugins similar like known Content Management

Systems (CMS). By this way the BaWiT Online can set access rights for different plugins to

different users and also to control the plugin’s behavior for that specify user.

User profile management which is responsible for user registration and user’s profile

maintenance. User profile plays important role to the look-and-feel as well as overall behavior

of the web application.

ACL (Access Control List) as a standard component of multi-user system which determines what

and how a specify user can/cannot do.

Data & Application logic performs collecting and preprocessing correct data to visualization for

a user.



1.2 Logon Form

Log on to the BaWiT online application is processed by correct enter of user’s login and password in the

authentication form (Fig. 2). The user will be redirected to the main screen of application immediately after

success full authentication.

We strongly recommend user to avoid the use of application on different public-available machines

because of authentication process involves collection of sensitive user credentials allowing access to the

application.

On this logon screen is available to download this manual ( see link BaWiT online manual).

Fig. 2 Logon to BaWiT Online application


1.3 Main screen

Main screen of application is divided into the five sections. These sections are responsible for whole web

content appearance and visualization. The list of such sections is as follows:

Upper Pane – Fig. 3.

Left Tree, which contains :

o Available objects tree-,

o Available reports tree- Fig. 3,

o Global settings items tree - .

Available plugins strip - Fig. 3.

Main Pane - Fig. 3.

Fig. 3 Main screen of BaWiT Online application

Main Pane

Upper Pane

Reports

Tree

Plugins strip

Left panel


Fig. 4 Main screen of BaWiT Online application(else view)

Fig. 5 Main screen of BaWiT Online application(else view)

Objects tree

Global settings tree


Upper Pane

This section shows the web application’s logo as well as login name of logged user, and options valid for

overall web application:

Help (represents a link button for partial plugin help activation. Definition of plugin will be

mentioned in following chapters later)

My Profile (represents a link button for access so-called user’s profile management. This will be

explained later)

Logout (allowing log-out from the web application)

Main Pane

Area for Main Pane, shows data in form reflecting for an appropriate chosen plugin from Plugin strip panel.

(User can utilize given plugin immediately after the plugin has been shown).

Plugins strip

In this section are shown the names of all the available plugins dedicated to logged user.

Left panel

Reports Tree

Report Tree provides the users list of available reports. Reports are divided into groups which

represent the groups of objects on available Objects Tree(Fig. 3),

Objects Tree

This module allows user to select either view on data for whole collection of objects, or one specify

selected object from an available collection. Let us also remark that there is a possibility to rename

current object to custom caption(Fig. 4),

Global settings Tree

Items for global settings of the web application(Fig. 5)

Switching between Reports Tree, Objects Tree and Global setting Tree can be done by clicking to the upper

title bar of the section (analogous to the MS Outlook application).


2. Users settings and accounts

2.1 Settings and management of user accounts

BaWiT Online domain is composed from several right levels for registered users.

Users management right levels :

User registration,

User profile maintenance,

User role relations,

User registration

Owner (Soft & Control Technology s.r.o.) of www.BaWiT.eu on a client request can create a new user for

this domain. The client is informed about successful registered of a new user via email, phone. Immediately

after confirmation the client is able to logon into BaWiT Online web application. At first logon will be set

default profile, which can the client change later. Change a user profile is performed on a screen after click

on link “My profile” located on the upper pane.

User profile maintenance

Maintenance, settings of user profile affects behavior of the web application for actual logged in user(link

“My Profile”).

Options for settings:

Local (settings for specify objects, reports, plugins etc.). Settings only for specific logged user,

Global (settings for a whole web application, as using language, themes, etc.)

User role relations

The domain provides feature for specifying so called “Role(s)”. It is about role permits to perform

operations on specify plugin. Each user has allocated own roles.

As was mentioned before, each of the plugins involves some kind of functionality available for the user to

use according to allocated roles, e.g. plugin visibility for specify user, viewing of measured data, possibility

to send commands into specify unit(object), etc. Additionally each plugin contains items which are parts of

the user’s profile settings and they can be modified at anytime, and their value determines the

behavior/activity of the plugin. Changing and adding of user roles is on demand of portal owner - Soft &

Control Technology s.r.o. Specify user plugin for this functionality is under construction.



Summarization

Every user has assigned own profile. At first logon into the web application is setup default profile

and role(s).

User can modify the profile at anytime ,

User’s profile determines behavior of the web application for the given user

User’s profile consists of the next two parts:

o Local Profiles settings related to the user-accessible plugins,

o Global Profile settings relates to the whole web behavior and appearance.

Every user acts in the BaWiT Online in its certain user Role,

User role defines which plugins are accessible for specify user and what operations upon the

plugins can user proceed,

User can manage multiple user accounts, so the user can acts in different roles within the web

application,

Multiple roles may access to the same plugin together with the same allowed operations,

There is possibility to change user role at anytime if the logged user has appropriate permissions for

this purpose (the user can have access rights for the role management plugin)

Fig. 6 shows principle of an user´s role relations

BaWiT Online Web Application

User 1

User 2

Role 1

User Profile 1

Chart Plugin

Operation 1

Role 2

100 90 80

Data Plugin

Role Management Plugin

Operation 2

User Profile 2

Chart PluginChart Plugin

Chart Plugin

Local Profiles

GlobalProfile

Fig. 6 Basic idea of user rights for BaWiT Online


2.2 User Role Overview

Currently there are four user roles in BaWiT Online. Each of the roles access certain set of the plugins.

Behavior of the plugins is same for each user in except of the plugin called „User Trace“ which provides

possibility to view user log for each of the subordinate users. Allowed plugin for the given role is highlighted

by green bullet (Fig. 7 Mapping of allowed user roles to available plugins).


Povolené moduly / Role Viewer User Advance

User Local

Admin Distributor Manufakturer Developer

Reports tree (reports View and Edit)

●V ●V ●V+E ●V+E ●V+E ●V+E ●V+E

Object tree ( View) ● ● ● ● ● ● ●

Monitoring template (View and Edit)

●V ●V ●V+E ●V+E ●V+E ●V+E ●V+E

Plugin Data x ● ● ● ● ● ●

Plugin Chart x ● ● ● ● ● ●

Plugin Map x ● ● ● ● ● ●

Plugin Data Points x ● ● ● ● ● ●

Plugin Notifications x x ● ● ● ● ●

Plugin LogViewer x x ● ● ● ● ●

Plugin Command x x ● ● ● ● ●

Plugin Service x x ● ● ● ● ●

Reports x x ● ● ● ● ●

Plugin Device specification x x ●V ●V+E ●V+E ●V+E ●V+E

Plugin Project x x ●V ●V+E ●V+E ●V+E ●V+E

Globals - - - - - - -

Plugin Download x ● ● ● ● ● ●

Plugin User Trace x ● ● ● ● ● ●

Role Management (under construction)

x x x ● ● ● ●

V – to view data E – Edit(modification)

Fig. 7 Mapping of allowed user roles to available plugins

BaWiT Online - 06 – Basic information of BaWiT Online portal | SCT1006.0002

of 38

3. Plugins manipulation

Plugins do provide specific functionality. This functionality can be oriented to devices, devices group, users

management, reports, data, etc.

The plugins introduced in next chapters are more detailed described in next manuals which are

downloadable after logon into BaWiT Online web application and selected specify plugin with his online

manual.

3.1 Type of offered data

BawIt Online plugins can display data of various types, for example information about an unit (object),

measured data for unit, or collection of units, data for reports. Availability of features and functions depend

on used plugin and his presented information/data.

3.2 Plugin`s sections

Plugins area is divided into sections which can be reduced – rolled up (because to get better look on

presented data at plugin area). In the case, that an user needs to display specify data, or next plugin

features, so the user can easily hide unnecessary sections with click on section label (Figure 11.). This gives

an advantage if we use Bawit Online at devices (e.g. cellular phones) which have screens with significantly

limited resolution.

Fig. 8 The plugin section can be easily expanded or collapsed by simple clicking on its title

3.3 Quick help

Some of offered plugins contains section with examples and quick explanations how to use specify plugin.

BaWiT Online - 06 – Basic information of BaWiT Online portal | SCT1006.0002 Page 14 of 38


4. Data Filtering

4.1 Period filter

Measured data dedicated for visualization can be filtered by provided feature “Period filter”. This filter

offers several options to set time intervals to view desired data. Filter operation is performed by click on

“Apply”.

Available settings of time intervals at “Span Type” :

Last – takes a last-measured data. This selection provides also auto refresh time setting feature,

The latest – takes all measured data from last on for selected time

Fig. 9 “The latest” filter

o “Auto refresh” – this option is enabled for Span Type – “The latest”, “Last” and offers to set time interval for automatics data refreshing.

Fig. 10 Data Auto refresh time intervals

Day – takes data measured in one selected day

Fig. 11 “Day” filter


Day At – shows measured data since chosen time for actual day

Fig. 12 “Day At” filter

Month – takes data measured in one selected month,

Fig. 13 “Month” filter

Actual week - takes measured data in actual week,

Actual month - takes measured data in actual month.


Year – takes data measured in one selected year,

Fig. 14 “Year” filter

Interval – takes measured data within selected interval. This selection envolves interval boundaries

defined by timestamp „Since“ and timestamp „To“. These timestamps may define date as well as

time,

Fig. 15 “Interval” filter

NOTE:

Plugin performance (as well as performance of whole web application) depends on the amount of

selected data to view. Therefore there is need for appropriate data amount selection to avoid the

application performance lose due to high volume of data items in the selection.

4.2 Data value filtering

Measured values are filtered by conditions set via feature shown in Fig. 16.

Fig. 16 Filter according by value.

Interval type: o Inside – means that shown data have their values inside interval Min and Max o Outside – means that shown data have their values outside interval Min and Max

Example 1 Min = 20, Max = 30, Interval settings = Inside: shown data with values between 20 and 30 Example 2


Min = 20, Max = 30, Interval settings = Outside: shown data with values less than 20 and greater than 30 Example 3

Min = 20, Max = 20, Interval settings = Inside: shown data with values equals to 20 Example 4 Min = 20, Max = 20, Interval settings = Outside: shown data with values not equal to 20

4.3 Data filtering through a table head filters

4.3.1 Data selection by Condition

Measured values can be filtered by selection of appropriate limitation condition located in head of tables

see Fig. 17.

Fig. 17 List of prepared data filter conditions.

4.3.2 Data selections by “text contains” method

There is possible to filter measured data by entered specify text/symbol and its occurrence. Selection is

performed by pressed “Enter” key, or do click outside the field where specify text was entered. Examples of

couple plugin screens with this filter option is in next pictures.

Fig. 18 Example 1 – Filtering of Data Points through text in Data point column header, plugin Data Point


Fig. 19 Example 2 – Filtering of Data Points through text in Value column header, plugin log viewer

Fig. 20 Example 3 – Filtering of Data Points through text in Emails column header, plugin notification.


4.3.3 Data selections from an choice list

In some case there is a request to display data with equal label/sign/mark in one column. Examples from

couple plugin screens with this filter option is in next pictures.

Fig. 21 Example 1 - filtering according name of RTU, Data Points plugin.

Fig. 22 Example 2 - filtering according Technology commands list, Commands plugin.


4.4 Data sampling (aggregation function)

Displayed measured values can be calculated according to selected aggregation function.

Fig. 23 Data sampling

Fig. 24 Example of used average aggregate function .

Type – Sample time range. Availability of options depends on the period filter settings( Chapter 4.1)

Function ( aggregation function):

o Min – takes min of each data in one sample

o Max – takes max of each data in one sample

o Average – calculate average of each data in one sample

o Sum – calculate sum of each data in one sample

NOTE:

With large amount of samples for aggregation function is getting low performance of web application.


4.5 Paging

Each table with data is divided into blocks containing max. 20 data items. Switch to the next page with next

data is necessary to use page selector located in the bottom of the table.

Fig. 25 Page navigator

Icon desription:

jump to first page

move to residing page located left

selected page

move to residing page located right

jump to last page

jump over 10 pages left or right in according to the tripple-dot location

5. Data Export Content of table (containing measured values) can be exported into a several offered formats:

Excel,

Word,

CVS (using semicolon”:” as separator).

Fig. 26 Export icons .

Icons for data export are available in upper place at right side of the table.


Fig. 27 Example of data exported into MS Excel.


6. Offered Plugins Each plugin is more detailed described, it means they functionality and settings option, after login to the

www.BaWiT.eu domain and chose “Help” link on each specific shown plugin.

6.1 Plugin Chart

Chart plugin provides chart-based visualization of measured values.

Available features:

Period filter,

Data sampling (aggregation functions),

Data value filtering,

axis orientation,

chart type ,

visibility if Y axis with set of its range.

If there is displayed less than 100 values for the data point, tooltip with more detailed information about

value is shown.

All this settings is possible to store into user personal profile. Every time, when the user accesses to plugin,

data is shown in related to this settings.

Fig. 28 Plugin Chart



6.2 Plugin Data

Data plugin provides table-based visualization of measured values. Table contains data for selected one, or

a collection of technology objects.

Available features:

Period filter,

Option for data automatic refresh within set time,

Data sampling (aggregation functions),

Data value, text, etc. filtering,

Data export to MS Excel, MS Word, CVS

All this settings is possible to store into user personal profile. Every time, when the user accesses to plugin,

data is shown in related to this settings.

Fig. 29 Plugin Data


6.3 Plugin DataPoints

Plugin Data Points offers management for Data-Points(DP) related to the selected technology object, or

collection of technology objects. A setting affects visualization of DPs in plugins.

Offered options:

Enable/Disable of an DP in Chart plugin,

Enable/Disable of an DP on Y2 axe in Chart plugin,

Color representation of an DP,

Enable/Disable of an DP in Data plugin,

Enable/Disable of an DP in Map plugin,

User change of an DP caption,

Data value, text, etc. Filtering.

Fig. 30 Plugin data points


6.4 Plugin Device Specification

The plugin provides the basic information about device and its state. Some of these information are

editable. A logged user can set GPS coordination and user´s caption of selected object. If there is GPS

module installed in a device, GPS settings are rewrite by actual GPS data gained from that device.

Provided information: Main caption of an device (editable), Show at startup(editable),, COA (object address), Id (internal number for the object), Original caption, Name, Active, Last data date( the last data receive to the BaWiT Online domain), State (actually connected, or disconnected specify object ), State date, Type, GPS Latitude(editable), GPS Longitude(editable), Created by, Created date, Changed by, Changed date.

Fig. 31 Plugin Device specification


6.5 Plugin Download

The plugin provides the file exchange interface between SCT and user. Plugin screen is divided to two

sections. First one contains data files determined for current user and second one contains files determined

for all users. User can upload its own file to the first section. An file size limitation for upload is 10MB.

Fig. 32 Plugin Download


6.6 Plugin Command

The plugin provides interface for sending technology commands to an object. User can remotely manage

the object. Availability of the commands depends on their settings (Enabled/Disabled) during configuration

of the object. Plugin provide also command history.

Fig. 33 Plugin screen


6.7 Plugin Service

The plugin provides sending the service commands for object. All sent commands, downloaded files from

an object are logged and presented in plugins at Historical records section (Fig. 34) The plugin also offers

modification and uploading an configuration template, to modification of Data Points (DP) conditions in

graphics form (more comfortable for users) - Fig. 41.

A List of service commands :

Write Configuration

Write Software,

Read Configuration,

Read Software,

Read Service Log,

Read Users,

Write Users,

Read Calibration, Write Calibration.

Fig. 34 Plugin Service


Fig. 35 Configuration template


6.8 Plugin Map

The plugin provides view property location on a map according to set GPS coordination on Device

Specification plugin (Chapter 6.4). When object contains also GPS module option, then actual GPS

coordination are used. In Data Points plugin(Chapter 6.3) it is possible to configure, which Data Points(DPs)

will be displayed at information box.

Fig. 36 Plugin “Map”


6.9 Plugin Monitoring

Monitoring plugin provides online monitoring of measured data in graphical form, what leads to the better

users view on measured data for specify application(Fig. 37). Graphics monitoring template is on a client

request. The data point values are refreshed by set a time period, default period is 5 seconds. In the case

that any value of the Data Point is changed then the field will flash(one times).

Fig. 37. Plugin Monitoring


6.10 Plugin Notifications

The plugin provides email notification. User can set email notification for each data point. Notification

consists with condition and email addresses. When the condition is true, email is sent to pre-defined

emails.

Fig. 38 Plugin Notification

Fig. 39 Email example


6.11 Plugin Reports

The plugin provides interface to configure conditions and visibility for specify data points (DPs), which the

user needs check repeatedly in chart form, or in table form. There is possibility to save this conditions as an

report with entered specify name by the user. (Plugin is called as Reports). The plugin provides possibility to

make multiple reports for same collection of objects.

Fig. 40 Plugin Reports


6.12 Plugin Log viewer

The plugin provides a list of all files transfers. Standard mentioned rules for filtering and export shown

data in the table are available, too.

Fig. 41 Plugin Log viewer


6.13 Plugin User Trace

User Trace plugin provides table-based visualization of user´s activity on BaWiT Online portal history.

Mentioned standard rules for filtering and export of shown data in the table are available, too.

Fig. 42 Plugin User Trace


6.14 Plugin Project

The plugin provides the objects collection information. User can change some parameters.

Displayed information :

Project Caption( editable) ,

Id (internal numbering),

Original caption,

Created date,

Changed date.

Fig. 43 Plugin Project

bawit online portal · bawit online - 06 – basic information of bawit online portal |...

Documents