Chapter 2: Introduction

Application Overview

The IBMS (Integrated Building Management System) application is the managing and configuration application of underlying SCADA and other data acquisition layer, which makes up the meta-data and data normalization process. The IBMS layer makes iviva a SCADA (Supervisory Control And Data Acquisition) system, which talks to various underlying ELV systems (HVAC, Access Control, Fire, CCTV, EVAC, Intrusion Detection, etc.) and other external systems and applications.

The SCADA layer forms a major part of the core of iviva. The IBMS application allows you to configure interfaces to diverse systems, add online equipment, configure points and attributes of points, configure alarms and alarm escalation levels and matrices which, allow you to have a multifaceted, yet structured and manageable notification mechanism.

---

IBMS Application in a Nutshell

• IBMS Application takes the task of configuring and monitoring of data points and their alarms.

• IBMS Application provides templates to easily input SCADA data in the format it recognizes.

• Equipment is a wrapper around an Asset with capabilities for IBMS (Points, Real-time GUI, Alarms, and Trends). Once an Asset is associated with an Equipment, you can observe an additional IBMS section under the details for the particular Asset.

• A System is a collection of points from different Equipment.

• An Equipment Template is a collection of Point Templates that forms a template for a particular make/model Equipment.

• A Point Template is a container of attributes for a point, for particular Equipment.

• Alarms and tasks related to Alarm management are a key part of the IBMS Application.

• Alarm Viewer displays Alarms in real-time while Alarm History would allow you to browse through the past alarms.

• An Alarm Class allows you to classify alarms based on Alarm Severity. Considering the Alarm Severity, you are allowed to configure Alarm Escalation Levels for Working Hours and After Hours.

• An Interface is a communication channel to a Sub-system interface.

• A Trend Group is a collection of trends for points with the same unit of measure (Group of Temperatures, Group of Pressures).

---

Application Concepts

IBMS Application at a Glance

Below illustration shows the main elements used to configure Equipment and acquiring data using the underlying Subsystem interface.

The above illustration depicts the dependencies, and basic components that constitute the IBMS application. Equipment builds up upon a pre-configured Asset.

Equipment Template is a collection of Point Templates. Equipment Template defines the points that belong to particular Equipment.

IBMS Zone is the Site where Equipment is found.

---

Getting Started

The chapter contains the following:

1. How to access “IBMS” Application
2. Application’s Home Page
3. Dashboard Tab
4. Toolbar
5. How to Log out from the System
6. Glossary of IBMS Application Terms

How to Access IBMS Application?

To access the IBMS application;

1. Log in to iviva. Your iviva homepage will appear.

2. On the Application Menu on the left side, click > More. The menu will expand and a set of app icons will be displayed.

3. click the IBMS icon . IBMS App’s home page will appear.

Application’s Homepage

Feature on Homepage	Description
Tabs 🡪Dashboard	Dashboard is the first tab of the homepage for IBMS application. This shows various Weblets related to the IBMS application.
Tabs🡪Equipment	Equipment tab shows the Equipment that has been registered in the application and provides a Search to search for the required Equipment. The same Equipment Search function is found under Settings icon. Equipment tab provides users a quick access to Equipment search.
Tabs🡪Systems	Systems tab shows the Systems that have been registered in the application and it provides a ‘Search’ to search for the required Systems. The same Systems Search function is found under Settings icon. Systems tab provides users a quick access to Systems search.
Tabs🡪Alarms	Allows you to filter alarms using the given search criteria.
Tabs🡪Trends	Allows you to filter Trends according to the given search filters.
Tabs🡪 Trend Groups	Shows Trend Groups associated with System/Equipment or other in a Location.
Settings Icon	The Settings icon on the Application’s homepage gives you access to settings and configuration items within the IBMS Application.
Global Site Filter	Global Site Filter allows to change the “Site” of the entire App at once.

Table 1 : Features on Homepage

Dashboard Tab

Dashboard tab displays various weblets related to the IBMS application. On the IBMS Dashboard, the following default weblets can be found.

Weblets

• Alarm Map
• Systems with Faculty Equipment
• Alarms Confirmed by me
• Alarms Assigned to me
• Active Alarms
• Alarm Summary
• Monthly Alarm Summary
• Alarm Action Summary
• Faulty Equipment
• Overridden Points

Note –Click icon on Weblets to expand the area, which consists of Search criteria and Generate Report option. To collapse the expanded area with Search criteria, click the same icon.

Alarm Map Weblet

Alarm Map Weblet shows the Building alarms on map that are in “Alarmed’’ status for a given Site.

By default, the Alarm Map weblet opens Logged in user’s Site with alarms.

To view another Site map, select the required Site under Site Map box.

: Alarms that are not acknowledged.

: Alarms that have been acknowledged but still in alarmed state.

How to View Alarm Details of a Selected Location?

• Click on the required Building Alarm marker on map. A pop-up window will open.
• Equipment in Alarm: This shows the number of equipment in the respective Location, which has alarms at the moment

  e.g. Equipment in Alarm: 3, meaning there are 3 Equipment with one or multiple alarms

  To view the Equipment, which have alarms, click the Equipment count. It will show the Equipment with alarms on the Equipment search page.

• Systems in Alarm: This shows the number of Systems in the respective Location, which has alarms at the moment

  e.g. Systems in Alarm: 2, meaning there are 2 Systems with alarms To view the Systems, which have alarms, click the System count. It will show the System(s) with alarms on the Systems search page.

• All the alarms in the selected Location will be categorized as per Severity-wise and their alarm count will be displayed along with the Alarm Severity color. Clicking on Alarm Count will open the Alarm Viewer.

Child Map

• View Child Map link:

  Click on the required Building Alarm marker on map. A pop-up window will open.

  Click View child map link. This opens the current location’s immediate child map. Site may consist of Child Maps consisting of maps of child locations/areas belong to the respective Site.

  To view another Child map of a Site, select the required Child map from the Child Map box.

Filters in Alarm (Child) Map

Filter Criteria	Description
Alarm Severity	Used to filter by Priority of the alarm.
Alarm Class	Alarm Class is a way to categorize alarm points into different priorities of escalation levels.
Site Map	Used to select the required Site.
Child Map	Used to select the required Child Map.
Asset Category	Used to filter by the Asset Category that the respective Equipment belongs to.
System Name	Used to filter by the System that the respective Equipment belongs to.
Show un-acked alarms	Select to view only the alarms that are not acknowledged.
Show Alarm Count	Select to view the Alarm Count on the Alarm Map.

Note –You need to upload the Location maps in Location Application beforehand, to view the maps under Alarm Map functionality.

All Active Alarms Link

This is used to view all the active alarms in the selected location.

1. Click on the required Building Alarm marker on map. A pop-up window will open.
2. Click the All Active Alarms link. The current Active Alarm Count will be shown next to the link name. Active alarms will be displayed on the Alarm Viewer.

Systems with Faulty Equipment Weblet

This Weblet shows Systems with alarms (faulty Equipment) for a given Site or All Sites. How to View Details of Systems with Faulty Equipment

• Click the name of the required System shown in the Weblet. A pop-up window will open showing the name/names of the faulty equipment in the selected System.

• Click the Real-Time GUI link under the System name in the pop-up window, to open the Real-Time GUI page of the respective System.

  • On the Real-Time GUI page, button opens the Equipment in System and their Points, Point Values, Alarm Status, etc.
  • On the Real-Time GUI page, click the button to view the pop-up window with the names of the equipment in alarmed state. To go to Equipment page with respective equipment point details, click the required Equipment name on the pop-up window.
• In the weblet, click the name of the required System. Click the Real-time Values link under the System name in the pop-up window, to open the Subsystem Points page of the respective System with Alarms. This page shows the equipment of the respective System along with equipment alarm points and their values, etc.

• On the Subsystem Point page, button opens the Real-Time GUI page of the respective System.
• On the Subsystem Point page, Button opens the pop-up window with the names of the equipment in alarmed state. To go to Equipment page with respective equipment point details, click the required Equipment name on the pop-up window.

Alarms Confirmed by Me Weblet

This Weblet shows the alarms that are confirmed by the logged in user along with the respective equipment.

• Click the required Equipment name on the Weblet to open a pop-up window with the details of the respective Equipment.

• Click an Alarm name on the Weblet, to open the respective Alarm’s detailed page.

Alarms Assigned to Me Weblet

This weblet shows the alarms that are assigned to the logged in user.

Setting under App Configuration:

Alarm Class will be displayed in weblets, only if the “Display Alarm Class in weblets and Search Pages” checkbox under App Configuration is selected.

Active Alarms Weblet

This weblet shows the alarms that are in ‘Active’ stage for a given Site or for all Sites. A colour legend is given in the weblet to represent different alarm stages (New, Escalated, Confirmed, and Acknowledged) on the chart. Note: To view Weblet details on Alarm Viewer, click on a bar of the chart (e.g. Acknowledged) and click the Alarm Stage link on the Quick Info window. Alarm Viewer will open with relevant tab (e.g. Acknowledged Alarms tab).

Alarm Summary Weblet

This weblet shows the percentage of alarm points per alarm severity on a donut chart for all Sites or for a given Site.

Note: Click on an Alarm severity section on chart to open the relevant Quick info (QI) window. On the QI window, click the Severity link which opens the Alarm Viewer with alarms, filtered by the selected Severity on the chart.

In the weblet, you can select the required Alarm Severities you wish to display on the chart and deselect the Alarm Severities not required.

Each Alarm Severity is represented by a colour in the chart. To deselect an Alarm Severity from the chart, click on the required Alarm Severity link. To select an Alarm Severity that is deselected, click on the required Alarm Severity link.

- When the alarm severity is deselected

- When the alarm severity is selected

Monthly Alarm Summary Weblet

Monthly Alarm Summary Weblet shows the number of alarms occurred in each month based on Alarm Severity.

Note: Click on the Weblet and drag to zoom-in the graph. Click Reset Zoom button to move back to the original view.

Alarm Action Summary Weblet

Shows the count of the alarms as per alarm status (e.g. New, Acknowledged, etc.) during the selected time range.

Note: Click on a bar on the chart to open Quick Info window. Click the Alarm Stage (e.g. Acknowledged) link on the QI pop-up window. Alarm Viewer will open with relevant tab.

Faulty Equipment Weblet

Shows the percentage of alarmed equipment as per Asset Category (e.g. AHU) for a time range.

Note: Click on an Asset Category (Equipment Category) on the chart to open its Quick Info window. Click the Equipment Name link on the pop-up window. Alarm Viewer will open applying relevant Equipment as the value in "Asset Category" filter.

In the weblet, you can select the required Asset Categories you wish to display on the chart and deselect the Asset Categories not required.

Each Asset Category is represented by a colour in the chart.

To deselect an Asset Category from the chart, click on the required Asset Category link.

To select an Asset Category that is deselected, click on the required Asset Category link.

Overridden Points Weblet

Overridden Points weblet displays a list of Asset Categories with Overridden Points. Total Number of Overridden Points will be displayed alongside each Asset Category name.

e.g. AHU(4) AHU – Asset Category (4) – Total Number of Overridden Points available for AHU Asset Category

Note: Click on an Asset Category name to open the Overridden Points page of the respective Asset Category.

---

Toolbar

No	Toolbar Icon	Description
1	Alarm Icon	Alarm icon on the toolbar becomes red and blinks when a new alarm is triggered which in turn helps the users to be aware of any new alarm. Alarm icon opens Alarm Viewer pop-up which shows the alarms that are currently in alarmed state.
6	Pencil	Pencil Icon allows you to re-arrange the order of the App icons in the Application bar on the left and change the colors of Weblets and field group sections.
7	Help	Help icon provides links to Documentation, Getting Started and Contact Support pages. If you are on a Report page, clicking on Help icon shows the column titles of the respective Report to understand the search results.
4	Pin- board	Pin-board icon shows the items that are pinned to the pin-board. This gives easy access to the important items.
5	Message	Message icon allows you to open the Inbox containing the Messages.

---

How to Log Out from the System

To log out from the system;

1. Click the Profile image icon on the top left corner, next to your User ID.

2. Click Log Out menu item on the menu. Current User will be logged out from iviva and the User Login page will appear.

---

Glossary of IBMS App Terms

This section includes the definitions of terms that are commonly used in IBMS application.

Terms	Description
Zone	An IBMS Zone is a geo-location with a collection of equipment.
Equipment	Equipment represents the assets which have active data and have runtime points and attributes associated with them.
System	A System represents a combination of Points that makes up a logical entity.
Equipment Template	Equipment Template is a template for a collection of points for a particular type/brand/model of Equipment.
Point Template	Point Template is a template for a particular point on Equipment Template.
Alarm Class	Alarm Class is a way to categorize alarm points into different priorities of escalation levels.
Interfaces	An Interface defines a communication channel between a Point and a Sub System Interface.
Sub System Interface	A Sub System Interface is a driver that communicates with a data source (ELV Systems, Databases, Other Applications, Web Services, etc.).
Trend Groups	A Trend Group is a collection of Trend Points with same unit of measurement. (e.g. Temperatures, percentage, pressure)
Message Templates	Pre-defined templates of messages to be sent when an alarm/event happens.

Table 2 : Glossary of IBMS App Terms