enteliWEB 4.20 Operator Guide

Download as pdf or txt
Download as pdf or txt
You are on page 1of 244

enteliWEB 4.

20
Operator Guide
Edition 1.0
© 2021 Delta Controls Inc. All rights reserved.
No part of this document may be reproduced, transmitted, transcribed, stored in a retrieval
system, or translated into any language (natural or computer), in any form or by any means,
without the prior written permission of Delta Controls Inc.
Limited permission is granted to reproduce documents released in Adobe® Portable Document
Format (PDF) electronic format in paper format. Documents released in PDF electronic format
may be printed by end-users for their own use using a printer such as an inkjet or laser device.
Authorized distributors of Delta Controls Inc. products (Delta Partners) may print PDF documents
for their own internal use or for use by their customers. Authorized Delta Partners may engage a
printing or copying company to produce copies of released PDF documents with the prior written
permission of Delta Controls Inc.
Information in this document is subject to change without notice and does not represent a
commitment to past versions of this document on the part of Delta Controls Inc. Delta Controls
Inc. may make improvements and/or changes to this document/the associated software/or
associated hardware at any time.
BACstat, Earthright, enteliBRIDGE, enteliBUS, enteliCLOUD, enteliSTAT, enteliTOUCH, enteliVIZ,
enteliVAULT, enteliWEB, enteliZONE, O3, ORCAview, and ORCAweb are registered trademarks of
Delta Controls Inc.
All other trademarks are the property of their respective owners.
Document edition: 1.0
Contents
Operator Guide Introduction 16
Organization 16
Getting Started 18
Welcome 18
Support 18
Version 18
Searching for Information in enteliWEB 18
Searching the Graphics Tree View 19
Changing Your Personal User Settings 19
User Information 19
Site and Device Navigation 22
Device View Concepts 22
Network Tree View 22
BACnet Devices List 24
Device View Tasks 25
Network Tree View Tasks 25
BACnet Devices List Tasks 26
Object List 29
About the Object List Page 29
How many objects are listed? 29
Managing the Object List page 29
Simple and Advanced Search Filters 30
Simple filter 30
Advanced filter 30
How Object Instances Are Derived 31
Command Objects 31
Auto 31
Manual 32
Other 32
Reset Object 32
Archive 32
Enabled and Disabled 33
Run and Halt 33
Scanning and Stopped 33
Manage Objects 33
Create Object 33
Delete Object 34
Copy Object 34
Paste Object 34
Source device goes offline during copy/paste 39
Stuck paste task 40
Rename Object 40
Create Trend Logs 40
Configure Trend Logs 40
Load from File 41
Save to File 41
Show Access Users tab 41
Device Actions 41
Reload Objects 41
Reconfirm Status 42
Communication Control 42
Reconfigure 43
Reset 43
Set Time 43
Object Security 44
Activate Network Change 45
Save Database to File 46
Save Database to Flash 46
Save Database to Server 47
Load Database from File 47
Load Database from Flash 48
Load Database from Server 48
Clear Database 49
Object Pages 50
Object Page Tasks and Related Information Views 50
Object Page 50
What is an Object Reference? 50
Common Object Page Tasks 52
Commanding or Overriding an Object Manually 57
Related Information Views on an Object Page 58
Object Description Field 62
Dashboards 63
About Dashboards 63
System dashboard type 63
Enterprise dashboard type 63
Personal dashboard type 63
About Personal Dashboards 63
Creating a Personal Dashboard 63
Adding a Widget to a Personal Dashboard 64
Adding an Object to a Watchlist Widget 64
Removing an Object from a Watchlist Widget 65
Deleting a Personal Dashboard 65
Calendars and Schedules 66
Calendar (CAL) Object Concepts 66
About the Calendar object 66
About Calendar view 66
Types of calendar entries 66
Calendar (CAL) Object Tasks 67
Adding a Single Date calendar entry 67
Adding a Date Range calendar entry 67
Adding a Recurring Week and Day calendar entry 68
Adding a Recurring Date calendar entry 68
Deleting a calendar entry 68
Deleting a Calendar Object 69
Schedule (SCH) Object (BACnet Revision 4) Concepts 69
About the BACnet Revision 4 Schedule Object 69
Time ranges 70
Week view 72
Month view 73
Details view 73
Intrinsic Alarm 73
Automatic Deletion of Event Schedules 73
Schedule (SCH) Object (BACnet Revision 4) Tasks 73
Setting the Schedule Type 74
Adding a Weekly Schedule 74
Adding a Single Date Event Schedule 74
Adding a Date Range Event Schedule 75
Adding a Recurring Week and Day Event Schedule 75
Adding a Recurring Date Event Schedule 76
Adding a Calendar Reference Event Schedule 76
Editing a Schedule 77
Deleting a Schedule 77
Changing Schedule Configuration Properties 77
Schedule (SCH) Object (BACnet Revision 3) Concepts 78
About the BACnet Revision 3 Schedule Object 78
Schedule (SCH) Object (BACnet Revision 3) Tasks 78
Adding a Time Range 78
Adding a Calendar Object Reference 78
Editing a Time Range 79
Viewing Time Range Setting 79
Deleting a Time Range 79
Trend Logs 80
About the Trend Log Object 80
Viewing Sample Data 80
Chart Span Axis and the Time Span Axis 81
Plotting COV Samples 81
Archiving to Historian 82
Data Archiving Design Goals 82
How to Avoid Data Loss 83
Archiving to a CopperCube 83
Multiple CopperCubes 84
Archiving to enteliVAULT 84
How enteliVAULT Collects Data Samples from Controller TL Objects 84
Trend Log Object Settings 85
Configuration 85
Trend Log (TL) Object Tasks 89
Multitrend (MT) Object Concepts 93
Chart Options 94
Legend 95
Plotting COV Samples 95
Plotting Large Number of Samples 96
Multitrend (MT) Object Configuration Reference 96
Expand Chart 96
Include Non-Data Samples 96
Chart Options 96
Values 97
Trend Setup 98
Configuration 98
Multitrend (MT) Object Tasks 100
Configuring a Multitrend Object - Main Steps 100
Adding a Trend Log Object to the Multitrend Object Chart 100
Setting the Time Span to Always View New Samples 101
Setting the Time Span to View Samples in the Past 101
Updating Sample Data Automatically (Refresh) from the TL Objects 101
Zooming In the Chart View 101
Panning the Chart View 102
Loading and Viewing Adjacent Earlier or Later Data Samples 102
Zooming Out the Chart View 102
Viewing Sample Data from the Chart 102
Removing and Restoring a TL Object Plot from the Chart Temporarily 103
Printing the Chart 103
Downloading Data Samples to CSV File 103
Importing Sample Data in CSV file into Excel 104
Alarms and Events 105
About Delta Controls' Event Management System 105
Sequence of Steps in Event Management 106
Detecting Alarm Conditions 107
Out of Range 107
Floating Limit 108
Change of State 109
Command Failure 110
Buffer Ready 110
Prioritizing Events and Alarms in the Delta System 111
Categorizing Events with the EVC Object 111
Prioritizing Alarms with Alarm Groups 112
Managing Events and Alarms 112
Presenting Active Alarms to a User 112
Annunciating an Alarm to a User 112
Acknowledging Alarms 112
Logging Events and Alarms 112
Archiving Events and Alarms 113
Alarm and Alert List Concepts 113
About the Alarm and Alert List 113
How the Alarms and Alert List Page Is Organized 116
Managing Filters 122
About Alarm Notifications 123
Server Not Responding Error 126
Permissions and Alarm Management 126
Alerts Concepts 126
System Alerts 127
Energy Alerts 129
Application Module Alerts 131
Alert Notifications 131
Active Alarm List Details and Tasks 133
Alarm and Alert List Reference 133
Information in an Active Alarm and Alert Listing 133
Filter Dialog 135
Advanced Filter 139
Filter Attributes 141
Alarm Details 142
Alarm Acknowledge Dialog 143
Alarm and Alert List Tasks 143
Alarm and Alert List Tasks 143
Acknowledging Alarms Tasks 145
Alarm Details Tasks 147
Search Tasks 148
Filter Tasks 148
Quickbar Tasks 151
Saving to File Tasks 152
Email Tasks for Non-administrative Users 152
Notifications Tasks 154
Totalizers 157
Analog Totalizer (AT) Object Concepts 157
About the Analog Totalizer Object 157
Monitoring Parameters 157
Value Bar 157
Start Time 157
COV Minimum Increment 157
Monitored Object 157
Binary Totalizer (BT) Object Concepts 158
About the Binary Totalizer Object 158
Monitoring Parameters 158
Value Bar 158
Number of <active state name> State Changes 158
Since 158
COV Minimum Increment 158
Control Loops 160
Control Loop Object 160
Monitoring Parameters 160
Value Bar 160
Input Source 160
Input Value 160
Setpoint Source 160
Setpoint Value 161
COV Minimum Increment 161
Real-Time Control Loop Performance 161
Optimum Start 162
Optimum Start (OS) Object Concepts 162
About the Optimum Start Object 162
Optimum Start Calculation 162
History 163
Monitoring Parameters 165
Value Bar 165
Status 166
Start Type 166
Target Temperature 166
Indoor Temperature 166
Schedule 167
Schedule Next On at 167
Time to Next Schedule On 167
Reports 168
Reports Concepts 168
Report Features 168
Access Control Reports 168
Building Automation Reports 168
Energy Reports 168
Reports Tasks 168
Creating a Report 169
Scheduling a Report 169
Deleting a Report 169
Managing Report History 169
Exporting a Report 170
Emailing a Report 171
Copying a Report 171
Modifying the Report Setup 171
Energy Management Reports 172
Energy Reports Concepts 172
About Energy Reports 172
Consumption Report 174
About the Consumption Report 174
Report Parameters 175
Consumption by Meter Report 176
About the Consumption by Meter Report 176
Report Parameters 177
Consumption by Time Report 178
About the Consumption by Time Report 178
Report Parameters 179
Consumption Comparison Report 181
About the Consumption Comparison Report 181
Report Parameters 182
Consumption Target Report 184
About the Consumption Target Report 184
Report Parameters 184
Contribution Comparison Report 186
About the Contribution Comparison Report 186
Report Parameters 187
Cost Ranking Report 188
About the Cost Ranking Report 188
Report Parameters 189
Cumulative Consumption Report 190
About the Cumulative Consumption Report 190
Report Parameters 191
Daily Average Report 193
About the Daily Average Report 193
Report Parameters 193
Degree Days Report 195
About the Degree Days Report 195
Report Parameters 196
Load Duration Report 198
About the Load Duration Report 198
Report Parameters 199
Single Meter Occupancy Report 201
About the Single Meter Occupancy Report 201
Report Parameters 202
Energy Reports Tasks 204
Building Automation (BAS) Reports Concepts 206
About Building Automation Reports 206
Offline Devices 206
Calibration Report 206
About the Calibration Report 206
Report Parameters 206
Commissioning Sheets Report 207
About the Commissioning Sheets Report 207
Report Parameters 208
Decommissioned and Fault Report 208
About the Decommissioned and Fault Report 208
Report Parameters 209
Input Points Report 209
Input Points Report 209
Report Parameters 210
Objects in Manual Report 210
About the Objects in Manual Report 210
Report Parameters 211
Object Query Report 212
About the Object Query Report 212
Report Parameters 213
Output Points Report 214
About the Output Points Report 214
Report Parameters 214
Trend Log Report 215
About the Trend Log Report 215
Report Parameters 215
Date Configuration 215
Sample Configuration 216
Report Format 217
Plotting a Large Number of Samples 218
Advanced Object Filter 218
Building Automation Reports Tasks 221
Version 3 Access Control Reports 224
About Version 3 Access Control Reports 224
Card Access Activity Report 224
Card Access Activity Report 224
Report Parameters 225
Card Access Activity by Card User Report 226
Card Access Activity by Card User Report 226
Report Parameters 227
Card User Activity by Door Report 228
Card User Activity by Door Report 228
Report Parameters 228
Door Activity Report 230
Door Activity Report 230
Report Parameters 230
Transactions by Event Type Report 232
Transactions by Event Type Report 232
Report Parameters 232
Version 3 Access Control Reports Tasks 234
O3 Access Control Reports 237
About O3 Access Control Reports 237
O3 Access Control Reports Tasks 237
Document Revision History 243
Operator Guide Introduction
This guide is intended for facility operators and others responsible for the day-to-
day operation of the site or sites being managed by enteliWEB. Daily tasks include
monitoring values, changing setpoints, setting schedules and calendars, handling
alarms, trending, and printing. This guide does not cover administrative functions.
To use this guide, you must be a member of an enteliWEB user group with the
following permissions:
l User Interface permissions for Dashboards, Navigation, Graphics and Alarms
l No Manage permissions.
l No Show Configuration Properties on Object Pages permission
l Allow permission for all devices on the site
l Read permission for all objects, except Create permission for Multitrend and
Trend Log objects, and Write permission for schedule objects

Organization
This guide is organized into the following sections:
l Getting Started provides important information to get you started. Review the
section about changing your personal user settings and set up your account
accordingly.
l Site and Device Navigation covers site navigation and the site's device list.
This section describes tasks associated with the device list and devices.
l Object List covers the Object List page, which lets you manage a device's
database. This section describes tasks associated with the object list and
with commanding objects.
l Object Pages provides information common to most BACnet object pages and
covers common object page tasks.
l Dashboards describes the enteliWEB dashboards and covers the tasks
associated with the personal dashboard.
l Calendars and Schedules covers the Schedule and Calendar objects. This
section describes the capabilities of each object and tasks associated with
schedules.
l Trend Logs covers the Trend Log and Multitrend objects. This section
describes the capabilities of each object and tasks for creating, maintaining,
visualizing, and printing trend logs.

16 enteliWEB 4.20 Operator Guide


Edition 1.0
Operator Guide Introduction

l Alarms and Events introduces the Delta Controls Event Management System.
This section describes alarm and event management, the alarm list page, the
notification history window, and how user group permissions affect alarm
management.
l Active Alarm List Details and Tasks covers the Alarm List page. This section
describes tasks associated with managing alarms and events.
l Totalizers covers the analog and binary totalizer objects.
l Control Loops covers the Loop object and describes how to monitor the
performance of the loop.
l Optimum Start covers the Optimum Start object and describes how to
monitor the optimum start object's operational history.
l Reports describes tasks associated with printing enteliWEB building
automation reports.
l Energy Management Reports covers the reporting aspects of Energy
Management, include a description of each report and the tasks associated
with creating and managing the reports.
l Building Automation System Reports covers building automation reports and
includes a description of each report and the tasks associated with creating
and managing the reports.
l Version 3 Access Control Reports covers V3 access control activity reports
and includes a description of each report and the tasks associated with
creating and managing the reports.
l O3 Access Control Report covers the V4 access control activity report and
includes a description of the tasks associated with creating and managing
the report.

© 2021 Delta Controls Inc. 17


Getting Started
This topic provides important information to get you started. Review the section
about Changing your personal user settings and set up your account accordingly.

Welcome
Welcome to enteliWEB - the complete control system software for BACnet-based
facility automation systems.
enteliWEB combines the power of enterprise dashboards with easy-to-use facility
management tools. Customizable energy management dashboards and powerful
energy reports give managers the tools they need to reduce consumption and
lower costs.
Visualizing both energy management and facility management on a single
dashboard makes it easy to close the loop between monitoring and control.

Support
This operator guide is intended to be an intuitive and comprehensive document
about using enteliWEB as an operator. However, given the flexibility of enteliWEB
and the many different ways in which our partners use it, we recognize you may
have additional questions that are not covered.
If you are a Delta Controls partner, contact Delta Technical Services for
assistance with any technical questions about Delta Controls products. Your email
address must be registered in Delta's Case Management System, or your question
will not be received.

Version
This document is current for enteliWEB version 4.20.
For complete information about this version of enteliWEB, see the release notes
document that is available on the enteliWEB product page of George Support.

Searching for Information in enteliWEB


Several pages in enteliWEB include a search function that lets you narrow down
the information displayed on the page based on a matching text fragment. Each
search function is adapted to suit the type of information displayed on the page.

18 enteliWEB 4.20 Operator Guide


Edition 1.0
Getting Started

Follow the links below to learn about the available search functions.
Search Alarm List
Search Devices on a Site Network
Search Navigation Tree for One or More Sites

Searching the Graphics Tree View


The Graphics section in the left navigation pane includes a Search field that
accepts a text fragment for the name of a graphic or graphic folder you want to
find.
1. In the Search field at the top of the Graphics tree view, enter one or more
characters and press Enter.
The tree view lists only the graphics and graphic folders where the
characters you entered occur anywhere in their name. When no graphic or
graphic folder name matches the search text, the tree view is empty.
2. To restore the complete tree view, delete all the characters from the Search
field and press Enter.

Changing Your Personal User Settings


The Settings page lets you view and change your personal enteliWEB user
information settings.
Click your username on the enteliWEB banner to open the Settings page.

User Information

Username
Username displays the name that enteliWEB uses to identify you. Contact the
enteliWEB administrator if you want to change your username.

Old Password, New Password, Confirm Password


Old Password, New Password, and Confirm Password fields allow you to change
your password.
When you open the Settings page, these fields are blank.

© 2021 Delta Controls Inc. 19


Getting Started

When your credentials are authenticated by an LDAP directory server, the


Old Password, New Password, and Confirm Password fields are hidden.

Changing Your Password


1. Enter your current password in the Old Password field.
2. Enter the password you want to use in the New Password field. This
password must comply with the password strength rules that are set by the
enteliWEB administrator.
3. Enter the password you want to use in the Confirm Password field.
The password you enter in the New Password field and in the Confirm
Password field must be identical.
4. Click Save.

Email Address
Email Address displays the email address that enteliWEB uses to send
information such as alarm notifications to you.
For the supported email address formats for HTML mail and SMS or plain text
mail, see the User Account Settings Reference help topic.
Email Address is optional, the field can be blank.
To add or change your email address, enter the email address you want to use and
Click Save.

When your credentials are authenticated by an LDAP directory server, the


Email Address field is read-only.

Email Format
Email Format lets you choose an email message template that suits the type of
client or device you want to receive enteliWEB email with.
For detailed information about the email templates, see the User Account Settings
Reference help topic.

Start Page
Start Page indicates the enteliWEB page that is displayed when you log in. Select
your start page from the list. If you don't see the page you want on the list, then

20 enteliWEB 4.20 Operator Guide


Edition 1.0
Getting Started

that is because the access permissions of the group you are a member of prevent
it from being listed.

Open in Fullscreen
Select Open in Fullscreen when you want the start page to occupy the entire
screen.

Language
Language lets you select the language you want enteliWEB to use when you log in.
Select the language from the list and click Save.

Group Third Party Devices in Network View


Select the Group Third Party Devices in Network View checkbox when you want
devices from manufacturers other than Delta Controls and Delta Electronics to be
separated in the Navigation tree into a folder labeled Third Party. When there are
no third-party devices on the network, the Third Party folder is not shown.
When Group Third Party Devices in Network View is not selected then third-party
devices and Delta devices are listed together in the Navigation tree.

© 2021 Delta Controls Inc. 21


Site and Device Navigation
Device View Concepts
In enteliWEB, there are two locations for viewing and monitoring a site's BACnet
devices.
l The network tree view displays the devices hierarchically in the left pane
when you expand the site node in the Network tab under Navigation.
l The BACnet Devices list displays the devices in a table in the main window
when you select the site in the network tree view.

Network Tree View


The network tree view consists of devices and workstations grouped under sites.

Site
The network tree view lists all the sites known to enteliWEB. When you expand a
site node , you can see the devices on the site network ordered by their
device number (address). Each device is identified by an icon, followed by the
device name and, in parentheses, the device number. The device name and
number are set in the DEV object.

22 enteliWEB 4.20 Operator Guide


Edition 1.0
Site and Device Navigation

The tree view shows both Delta devices and third-party devices. Third-party
devices can be combined with Delta devices or kept in a separate folder. This is
defined in the user's settings. Delta devices include Delta Controls devices, virtual
devices that reside on an enteliBRIDGE device, and Delta Electronics devices.
These devices have vendor IDs of 8, 402, and 435 respectively.
Hierarchical relationships among Delta devices are shown as parent-child
relationships in the tree. Devices in the tree are organized into three levels,
corresponding to the area, system, and subnet groupings in Delta Controls'
Derived Network Addressing (DNA) scheme.
Under the DNA scheme, the device number format is AASSDD where:
AA represents the area level in the range 010000 to 990000 (in increments of
10000)
SS represents the system level in the range 0100 to 9900 (in increments of
100)
DD represents the subnet level in the range 01 to 99 (in increments of 1)
Subnet devices are grouped under system devices, and system devices are
grouped under area devices (if present).
For example:
Area Device 1 (140000)
System Device 1 (140100)
Subnet Device 1 (140101)
Subnet Device 2 (140102)
System Device 2 (140200)
Subnet Device 1 (140201)

© 2021 Delta Controls Inc. 23


Site and Device Navigation

Area Device 2 (150000)

enteliWEB builds the tree based on the device number in the controller's DEV
object. It does not use the network number or on-board switch settings. Delta
devices that are properly addressed are displayed in a logical order in the tree.
Third-party devices, when combined with the Delta devices in the tree, are always
shown as children of the site.

Workstation
Servers and workstations are contained in a separate folder labeled Workstation.
Servers that are offline when the tree is constructed are hidden. Servers that go
offline after the tree is constructed are indicated by .

Third Party
Devices from manufacturers other than Delta Controls are contained in a separate
folder labeled Third Party when that option is selected in the user's settings.
If there are no third-party devices on the network, the Third Party folder is not
shown.

Products from Delta Electronics are displayed with Delta Controls


devices, not in the Third Party folder.

BACnet Devices List


The BACnet Devices list displays the devices on the network in a tabular view. In
addition to the device icon, device name, and device number, the table displays the
model name, the software version that the device is compatible with, the
device'sfirmware version, and the vendor ID. This information is read-only. The
device name and number are set in the DEV object.

The organization of the device list can be tailored to meet your needs by
rearranging the column positions and hiding columns you don't want to see.
The search filter lets you narrow down the number of devices in the list to show
only the devices you are interested in.
At the bottom of the page, the number of devices in the list is displayed.
When you select one or more devices in the device list, the Object List page opens.

24 enteliWEB 4.20 Operator Guide


Edition 1.0
Site and Device Navigation

Actions
The Action menu contains a list of actions for managing the site, such as finding
new devices and sending a network time synchronization message.

Device View Tasks


This section describes the network tree view tasks that you can perform on the
Network tab in the left pane Navigation section, and the BACnet Devices list tasks
that you can perform on the BACnet Devices tab.

Network Tree View Tasks

Expanding/Collapsing Branches in the Tree

To expand all branches, press and hold the Ctrl key, and then click . All
branches below the node are expanded, including subnets.

To collapse all branches, press and hold the Ctrl key, and then click . All
branches below the node are collapsed, including subnets.

Searching the Tree


To search the tree, enter one or more characters in the Search field above the
tree, and then press Enter. The tree displays the sites where the characters you
entered occur in a device number or device name. Expand each site node to
view the devices that match the search.
To restore the complete tree view, delete all the characters from the Search field
and press Enter.

Viewing Objects for a Single Device


To view the object details for a single device, click the device name. The Object
List page opens in the main window displaying the objects for the selected device.

Viewing Objects for Multiple Devices


To view the object details for multiple devices, press and hold the Ctrl key and
then click the device names. The Object List page opens in the main window
displaying the objects for the selected devices.

© 2021 Delta Controls Inc. 25


Site and Device Navigation

BACnet Devices List Tasks

Viewing the BACnet Devices List


To view the BACnet Devices list, in the left pane, under Navigation, select a site
in the network tree view. The list of devices for that site is displayed in the
main window on the BACnet Devices tab. If the list of devices spans multiple
pages, click More in the lower right corner to continue to the next page.

Searching the BACnet Devices List


To search the BACnet Devices list, in the Search field on the BACnet Devices tab,
enter one or more characters, and then press Enter. The list displays the devices
where the characters you entered occur in the device number or device name.
To restore the complete list, delete all the characters from the Search field and
press Enter.

Sorting the BACnet Devices List


By default, the BACnet Devices list is sorted by device number. To sort the list by a
different category (name, model name, version, etc.), click the column heading
corresponding to the category that you want to sort by. The list is sorted in
ascending order. To sort the list in descending order, click the column heading
again.

Rearranging Columns in the BACnet Devices List


To rearrange columns in the BACnet Devices list, drag the column headings to a
new position.

Hiding/Showing Columns in the BACnet Devices List


To hide or show columns in the BACnet Devices list, hold the pointer over any
column heading, click the drop-down arrow, and then select Columns. A list of
possible columns is displayed. To show a column, select its checkbox. To hide a
column, clear its checkbox. The BACnet Devices list is updated immediately.

Viewing Objects for a Single Device


To view object details for a single device, click the device name to open the
device's Object List page.

26 enteliWEB 4.20 Operator Guide


Edition 1.0
Site and Device Navigation

Finding a Device
To find a device, click Action, and then click Find Device. In the Find Device dialog,
enter the device number of the device that you want to find, and then click Find.
enteliWEB looks for the specified device on the BACnet network. If the device
responds, enteliWEB updates its list of known devices.

Finding New Devices


To find new devices, click Action, and then click Find New Devices. If new devices
are found, enteliWEB updates its list of known devices.

Reinitializing Descriptors
If the network tree view doesn't represent the network accurately, or if a network
routing change has resulted in a large number of devices going offline, you can
reinitialize (reload) the device descriptors.
To reinitialize the descriptors, click Action, and then click Reinitialize Descriptors.
A confirmation message appears. Click Yes to continue. You are asked to confirm
the operation because the process can take a while, especially on sites with a
large number of devices.
enteliWEB displays the following indications of progress for the re-initialization
process:
l A banner with the message Reinitialize Descriptors: OK is
displayed at the top of the page to confirm that the reinitialization has begun.
l While the reinitialization is in progress, is displayed for the site in the tree.
l The tree is updated every two seconds for up to 60 seconds.
The BACnet Server deletes the device table, the descriptor table, and the active
alarm list tables from its local data caches. Then it starts a network-wide
discovery process that populates these tables with current information.

When reinitialization is completed, is replaced by for the site in the tree.


Device Discovery and Descriptors

When the BACnet Server discovers a new device on the network, it performs
following three operations:
1. The BACnet Server confirms the device. It reads definition settings from the
device such as the model name, the vendor, the version information, the
BACnet services supported, the object types supported and so on.

© 2021 Delta Controls Inc. 27


Site and Device Navigation

The BACnet Server uses the device information to identify the device uniquely
and to determine what the device is capable of doing. The device information
is stored in the device table.
2. The BACnet Server loads the descriptors from the device. Once the BACnet
Server has identified a device, it then needs to know what BACnet objects are
in that device. The BACnet Server queries the list of object identifiers in the
device and then reads the object name and optionally the HAL flag for every
object.
For the BACnet Server, a descriptor is essentially just an object name. For
Version 3 systems and ORCAview, a descriptor was the collection of data that
was associated with an object: the object name plus other object info that
may have been cached.
The object information is stored in the descriptor table.
3. The BACnet Server loads the alarm list from the device by querying the list of
active alarms in the device. The alarm information is stored in the active
alarm list tables.
Together, the device table (devices), the descriptor table (objects), and the active
alarm list tables (alarms) act as local data caches. By using these caches, the
BACnet Server provides much better performance than if it had to request the
information directly from devices each time it was needed.
Because devices are not added or removed from the network frequently, and
because objects are not created or deleted often, these tables allow enteliWEB to
display the network tree view, device list, and object list as soon as a user logs in.

28 enteliWEB 4.20 Operator Guide


Edition 1.0
Object List
About the Object List Page
The Object List page displays the contents of the Objects tab, which lists objects in
one or more device databases.
enteliWEB maintains an information model of a site which it constantly keeps up
to date as it discovers changes on the network. This model includes information
about the devices on the network and about their object databases. Collectively,
the information is referred to as descriptors. enteliWEB uses the site model
information to construct the tree view of the network in the left-pane Navigation
section and to maintain the list of objects and their status on the Object List page.
When enteliWEB connects to a site for the first time it immediately begins to
discover the site and to load descriptor information from the network. For a
network with a large number of devices, the discovery process can take several
minutes. A user who is a member of a group with the Manage Configuration
permission can use the Reconfirm Status action to cause enteliWEB to reload or
"reinitialize" the descriptors for one device.

How many objects are listed?


enteliWEB lists all the objects in the selected device(s) that match the search
filter. The total number of objects listed on the Object tab is displayed in the lower
left corner of the page.
When there are more than 400 objects to list, enteliWEB indicates this by two
numbers separated by a slash character such as 400/895, meaning (objects listed
in the page)/(total objects that match the filter) and by the More button to allow
you to add the next 500 objects to the list.
The number of selected objects is displayed in the lower left corner of the page.

Managing the Object List page


You can organize the objects and object property values displayed in the Objects
tab as follows:
l By searching and filtering the object list
l By sorting the object list
l By grouping similar objects
l By hiding or showing the built-in columns
l By adding or removing a property or subproperty column

© 2021 Delta Controls Inc. 29


Object List

Simple and Advanced Search Filters


To narrow down the information in the object list to meet your needs, you can use
simple or advanced filters.
Filters are logically ANDed. For example, an advanced filter for all objects in
manual and a simple filter for all AI objects results in an object list that includes
only the AI objects that are in manual.

Search doesn't find objects that are filtered out by the BACnet device
filter.

Simple filter
A simple filter is created by entering one or more search terms in the Search field
and pressing Enter.

Advanced filter
An advanced filter consists of one or more rules that include objects, object
properties, logical operators and comparison operators.
An advanced filter adds the object properties it references as columns in the
object list.
You can create your own advanced filters or use the built-in filters. The following
filters are included in enteliWEB:
l Inputs Output. Lists input and output objects.
l Alarms. Lists EV and EVC objects.
l Trends. Lists TL objects and MT objects.
l Values. Lists AV, BSV, BV, CSV, IV, LAV, MV, PIV objects.
l Manual. Lists all objects that are overridden, using the rule: Manual_
Override not equal to null.
l LINKnet. Lists objects and properties that pertain to LINKnet: IP, OP, AV
(101-1299), LNK, LCD objects.
l CO Tuning. Lists objects and properties that pertain to CO object tuning: AI,
AO, AV, CO, MT, TL objects.
l Network. Lists BACnet network-related objects: BCP, BDE, BMD, DER, DES,
DEV, IPS, NET objects.

30 enteliWEB 4.20 Operator Guide


Edition 1.0
Object List

In enteliWEB 4.18 and later, you can create up to 50 advanced filters. These filters
can be exported and imported, allowing them to be reused in different projects.
The built-in filters cannot be exported or imported.

How Object Instances Are Derived


The Create Object dialog suggests an object instance number based on device type
and object type. The following rules are applied to derive the suggested instance.
l If the object does not represent an input or output point, enteliWEB suggests
the lowest available instance number.
l If the object represents an input or output point on a DSC/DAC device,
enteliWEB suggests the lowest available instance number.
l If the object represents an input or output point on an enteliBUS eBM
module, enteliWEB suggests the lowest available instance number based on
the enteliBUS I/O point naming convention and installed eBM modules.
l If the object represents an input or output point on a LINKnet device that is
connected to an enteliBUS, enteliWEB suggests the lowest available instance
number based on the LINKnet device I/O point naming convention for
enteliBUS.
For more information, see the Object List Page Reference topic.

Command Objects
The Object List page for a device lets you perform the following commands that
act on selected objects.

You access these commands from the Command list.


Commands that apply to all object types are always present in the Command list.
A command that applies to a specific object type appears on the Command list
only when an object of that type is selected. For example, to enable or disable a TL
object, you first select a TL object to expose the Enabled and Disabled commands.

Auto
The Auto command is enabled for all object types to let you cancel an override on
selected objects.

© 2021 Delta Controls Inc. 31


Object List

Manual
The Manual commands let you command a permanent override for one or more
objects. The Auto command lets you cancel the override.
l Manual is enabled for all object types to allow you to command a permanent
override.
l Manual Value is enabled for analog objects and multi-state objects to allow
you to command a permanent override and set the override value.
l Manual On and Manual Off are enabled for binary objects to allow you to
command a permanent override and to set the objects override state to
Active or Inactive. The associated BDC object determines the actual terms
displayed for these states. When no BDC object is associated with the binary
object, then the terms On and Off are used.

For Accumulator (AC) objects that use scaling, enter the unscaled value
as the manual override value. Scaling is then applied and the resulting
scaled value is displayed on the Object List page.

Other
The Other command is enabled when one or more object property columns have
been added to the object list.
The Other command lets you set a value for an object property.

Reset Object
The Reset Object command is enabled for all object types that support object
reset to allow you to reset one or more objects.
When an object that does not support reset is selected, the Reset Object command
is disabled.
The operation of the reset function varies depending on the object type.

Archive
The Archive command lets you add a Trend Log object to one or more Historians
or CopperCubes. enteliVAULT is excluded from the list of supported archivers.

32 enteliWEB 4.20 Operator Guide


Edition 1.0
Object List

Enabled and Disabled


The Enabled and Disabled commands appear on the Command list when a TL
object is selected.
The Disabled command lets you override the TL object to stop it from collecting
samples.
The Enabled command lets you cancel an override of TL object to allow it to
collect samples.

Run and Halt


The Run and Halt commands appear on the Command list when a PG object is
selected.
The Halt command lets you override the PG object to its Halt state.
The Run command lets you cancel an override of PG object to allow the program
to run.

Scanning and Stopped


The Scanning and Stopped commands appear on the Command list when a CR
(Card Reader) object is selected.
These commands allow you to switch the CR object between its scanning and its
stopped states.

Manage Objects
The Object List page lets you perform the following management tasks that act on
selected objects.

You access these tasks from the Manage list.


Manage object operations are recorded in the enteliWEB log.

Create Object
Create Object creates an object of specified type, instance and name that does not
conflict with existing objects in the device.
Conflicts that prevent you from creating an object are as follows.
l duplicate object name
l duplicate object instance for specified object type

© 2021 Delta Controls Inc. 33


Object List

l duplicate object instance for similar object type (for example, attempting to
create MI1 when AI1 or BI1 exist)
l device allows only a limited number of the object type in its database and that
limit has already been reached
l device is a CopperCube, which does not allow object creation, or an
enteliBRIDGE, which is managed by an embedded user interface
The Create Object dialog presents a list of possible object types that you can
create. Only the listed object types can be created for the device.

Delete Object
Delete object deletes the selected objects from the device database. Certain
objects such as the DEV object can't be deleted.

Copy Object
Copy Object is the first step for you to replicate objects. The second step is the
Paste Object operation.
When you perform the Copy Object operation, enteliWEB copies all the information
it needs to replicate the selected object or objects from the source device
database to the browser cache memory.
The copied information is retained in the browser cache memory. That information
is lost when you navigate to another page in the enteliWEB user interface.

Paste Object
Paste Object is the second step for you to replicate objects. The first step is the
Copy Object operation.
The Paste Object operation addresses two scenarios:
l Paste the objects in the same or source device that you copied from
l Paste the objects in a different or destination device or devices
Both scenarios are described in detail in following sections.

Paste objects in the same or source device


The Paste Object operation creates new objects in the source device's database
with different object instances and names that do not conflict with existing
objects.

34 enteliWEB 4.20 Operator Guide


Edition 1.0
Object List

Before an object is created, you are prompted to accept the suggested instance
and name or to change them. For an LO object suggestion see How an LO object
suggested instance number is determined.
When you are copying multiple objects, then for each object you are prompted to
accept the suggested instance and name or to change them. Alternatively, you can
apply an instance number rule to the created objects. The instance number rules
are described in following paragraphs.
l Use instance numbers of copied objects + offset
Allows you to specify a number that is added to the copied objects' instance
numbers to calculate the pasted objects' instance numbers. For example,
when you copy AI1101, AI1102 and AI1106 and specify an offset number of
1000, the pasted objects will be AI2101, AI2102 and AI2106.
Object is overwritten with pasted object if instance number exists on target
device.
l Use lowest available instance numbers
Objects are pasted to the lowest available instance numbers.
l Use instance numbers starting at highest number in use +1
Objects are pasted to instance numbers that are higher than in use numbers.
That is, the highest instance number in use + 1, + 2, + 3 and so on.
l Use available instance numbers starting at:
Allows you to specify the starting instance number for the pasted objects. If
the number you specify is already in use, the paste operation uses the next
available instance numbers that are higher.
Example 1, when you copy AI1101, AI1102 and AI1106 and specify the starting
instance number of 20000 when the instance numbers 20000, 20001 and
20002 are not in use, the pasted objects will be AI20000, AI20001 and
AI20002.
Example 2, when you copy AI1101, AI1102 and AI1106 and specify the starting
instance number of 20000 when the instance numbers 20000, 20001 and
20002 are in use, the pasted objects will be AI20003, AI20004 and AI20005.
The rule you select becomes your default setting for future object pasting
operations.
For copy/paste of a CU object, the rule defaults to "Use instance numbers starting
at highest number in use +1."

© 2021 Delta Controls Inc. 35


Object List

Paste objects in a different or destination device


The Paste Object operation to destination devices creates new objects in the
destination device's database.
The Paste Object operation attempts to create objects with the same object
instances and the same names as those of the source objects. However, a conflict
is possible in which case the paste operation can't create objects with the same
object instances and the same names.
When you are copying multiple objects, then for each object you are prompted to
accept the suggested instance and name or to change them. Alternatively, you can
apply an instance number rule to the created objects. In addition to the instance
number rules described above, the following rule is also available.
l Use instance numbers of copied objects
l Objects are pasted to the same instance numbers as the copied objects.
Object is overwritten with pasted object if instance number exists on target
device

How an LO object instance number is determined


l If a DALI module is present, create the LO object on DALI module, start with
instance number LO600120 first and then from LO600100 to LO600115 and
then to the next DALI module if present, e.g., LO700120 and then LO700100 to
LO700115...
l If no DALI module is present but an O3-DIN-8xP module is present, create
the LO object on the 8xP module starting from the 8xP module's hardware
address, e.g., from 1201 to 1208.
l If no DALI module is present and no 8xP module is present, start with LO1.
l The above rules apply only when copying/pasting to the same device and
when creating new LO objects. When copying/pasting to another device, the
instance suggestion defaults to the copied LO's instance number.

The LO instance number must not be in conflict with an existing output


object instance.

Paste operation conflict


When a conflict is detected, the paste operation proceeds according to certain
rules. The following table contains the possible conflicts and the corresponding
response of the paste operation.

36 enteliWEB 4.20 Operator Guide


Edition 1.0
Object List

Conflict Scenario Paste Operation


Object with the same name exists in one or Paste operation changes the
more of the destination devices name automatically by
appending a count like "(2)"
For example, "Room Setpoint"
is pasted as "Room Setpoint
(2)".
Object of a similar type and the same instance Paste operation displays an
exists error banner and no objects
For example, pasting an AI1 object when a BI1 are pasted
object exists
Object of the same type and the same instance Paste operation overwrites
exists existing object
The destination device does not allow the object Paste operation displays an
type to be created error banner and no objects
are pasted.
The destination device allows only a limited Paste operation displays an
number of the object type in its database and error banner and no objects
that limit has already been reached are pasted.

Resolving object references in pasted objects


The objects being copied may include links to other objects, also known as object
references. For example, the TL, EV, PG, AT, BT objects usually refer to other
objects as monitored objects.
The paste operation includes rules which govern how the object references in the
pasted objects are resolved.
The two rules are as follows:
1. When the referenced object is included in the Paste Object operation, that is,
it is one of the objects that you are copying, then all references to it in the
pasted objects are changed.
Example 1, same device: when you copy/paste a TL object and its monitored
object on the same device then the pasted TL object links to the pasted

© 2021 Delta Controls Inc. 37


Object List

monitored object. That is, copy 100.TL1 (monitoring 100.AV1) and 100.AV1,
paste creates 100.TL2 (monitoring 100.AV2) and 100.AV2.
Example 2, different device: when you copy/paste an AI object and its AIC
object on a different device then the pasted AI object links to the pasted AIC
object. That is, copy 100.AI1 (linked to 100.AIC1) and 100.AIC1, paste creates
200.AI1 (linked to 200.AIC1) and 200.AIC1.
2. When the referenced object is not included in the Paste Object operation, that
is, it is not one of the objects that you are copying, then any references to it in
the pasted objects are not changed.
Example 1: when you copy/paste a TL object without including its monitored
object then the monitored object link in the pasted TL object remains the
same as the monitored object in the copied object. That is, copy 100.TL1
(monitoring 100.AV1), paste creates 100.TL2 (monitoring 100.AV1).
Example 2: when you copy/paste an AI object without including its AIC object
then the pasted AI object links to the original AIC object. That is, copy 100.AI1
(linked to 100.AIC1), paste creates 100.AI2 (linked to 100.AIC1).

Resolving parent/child relationships


The Paste operation resolves parent/child relationships described by the following
TL object examples. The resolution is similar for MT objects.
l 101.TL1 refers to 101.AV1 and is copied to another device. In this case,
because AV1 is local to the original TL, the paste refers to the local AV in the
pasted device. For example, if 101.TL1 is copied to 102.TL1, then 102.TL1
refers to 102.AV1.
l 101.TL1 refers to 100.AV1 and is copied to device 102. Since 101 and 102 are
both "children" of 100, the paste doesn't change the reference. 102.TL1 still
refers to 100.AV1.
l 101.TL1 refers to 100.AV1 and is copied to device 201. Since 101 and 201 have
different "parents", the paste changes the reference. 201.TL1 refers to
200.AV1.
l 101.TL1 refers to 100.AV1 and is copied to device 92201. Again, different
parents, so the paste changes the reference. 92201.TL1 refers to 92200.AV1.
l 101.TL1 refers to 100.AV1 and is copied to device 97400. In this case, the
paste is at a different level of the hierarchy, so parent/child relationships
don't exist. 97400.TL1 still refers to 100.AV1 (no change).
l 100.TL1 refers to 101.AV1 and is copied to device 97400. In this case, the
paste is parent to parent. 97400.TL1 now refers to 97401.AV1.

38 enteliWEB 4.20 Operator Guide


Edition 1.0
Object List

l 100.TL1 refers to 101.AV1 and is copied to device 92201. In this case, the
paste is at a different level of the hierarchy, so parent/child relationships
don't exist. 92201.TL1 still refers to 101.AV1 (no change).
l 101.TL1 refers to 200.AV1 and is copied to device 102. 200 is not 101's parent,
but the paste to 102 retains the same link. 102.TL1 still refers to 200.AV1 (no
change).
l 101.TL1 refers to 200.AV1 and is copied to device 301. 200 is not 301's parent.
301.TL1 still refers to 200.AV1 (no change).

Resolving object references exceptions


There are, however, exceptions to the above rules.
l An object reference in the Intrinsic Alarming section of a copied object is
pasted without being changed, whether or not the referenced object is also
included in the paste operation.

Pasting an object with a priority array


If the object is in Auto mode, then no priority—that is, priority 17—is used for the
pasted object.
If the object is in Manual mode, the priority of the pasted object is determined as
follows:
l When the source object is on a third-party device then the priority of the
pasted object is 8 (Manual Operator), as that is the priority that third-party
objects tend to use for manual mode.
l When the source object is on a Delta device then the priority of the pasted
object is either 5 (Critical Equipment Control) or 8, depending on the 'Manual
Override at' setting, which is governed by the Critical_Control property in V3
objects or the Manual_Override_Priority_Level property in V4 objects.
l Since the BACnet standard calls only for support of priority 8 for manual
mode (support for other manual mode priority levels being proprietary), when
a Delta object is in manual mode and is set to priority 5, then the priority is
changed to 8 when the object is pasted to a third-party device.

Source device goes offline during copy/paste


If the source device goes offline during a copy/paste operation, the copied objects
still get created in the destination devices but with default object settings and not
with the settings of the copied objects in the source device.

© 2021 Delta Controls Inc. 39


Object List

Stuck paste task


When a paste task is stuck, that is, it keeps retrying and keeps failing, enteliWEB
attempts to recover as follows:
l The paste task is terminated 24 hours after it was started.
l When there are multiple stuck paste tasks and one has been terminated, the
remaining stuck tasks do not continue to run and are terminated when they
reach the 24 hours time limit.

Rename Object
Rename Object lets you change the name of selected object or objects in the
following ways.
l Replace some or all text in the object name.
l Add a prefix or suffix or both to the object name.
When multiple objects are selected, enteliWEB may suggest some text in the Text
to Find field, when it recognizes the same text fragment in the object names. This
recognition is case-sensitive.

Create Trend Logs


Create Trend Logs lets you quickly create trend logs for one or more selected
objects. The trend log settings are defined in the Global Trend Log Configuration
dialog, which can be accessed by clicking Manage > Configure Trend Logs.

Configure Trend Logs


Configure Trend Logs lets you view and change the settings that govern automatic
trend log creation in enteliWEB.
The default settings are as follows:
l Trend log names are formed by adding "TL" after the name of the monitored
object.
l Trend logs monitoring analog object types (AI, AO, AST, AV, LAV) have their
Log Type property set to Polling, with samples taken at 15 minute intervals.
The Max Samples property, which defines the maximum number of samples
to hold in the trend log object's buffer memory, is set at 300.
l Trend logs monitoring binary object types (BI, BO, BST, BV) and multistate
object types (MI, MO, MV) have their Log Type property set to Change of Value

40 enteliWEB 4.20 Operator Guide


Edition 1.0
Object List

(COV). The Max Samples property, which defines the maximum number of
samples to hold in the trend log object's buffer memory, is set at 100.
You can adjust these settings as needed.

Load from File


Load from File lets you add or replace one or multiple objects to the database
from a file. You can keep useful preconfigured objects, such as AIC, GWT and PG
objects on your service laptop that you can reuse on different types of devices,
different firmware versions and different sites.
When there is a mismatch in the properties available when loading a BACnet
object from a different device type, you may be warned that you should review the
configuration due to the mismatch.
Supported file types are .zob or .zip of multiple .zob files.

Save to File
Save to File lets you save one or multiple objects from the database to a file. A
saved object can be reused as described above in Load from File. When you save a
single object, a .zob file is created. When you save multiple objects, a .zip
containing multiple .zob files is created.

Show Access Users tab


Displays the Access Users tab on the Object List page until you select another
controller on the Navigation Pane tree.
This option is only available for devices that belong to the O3 Access Control and
V3 Access systems.

Device Actions
Actions are tasks that act on the entire device rather than selected objects.
You access these actions from the Device Actions list.
The Object List page for a device lets you perform the following actions .

Reload Objects
The Reload Objects action is a "lighter-weight" action than Reconfirm Status
because it performs a subset of the Reconfirm Status processing and therefore it
takes less time to complete.

© 2021 Delta Controls Inc. 41


Object List

The Reload Objects action causes BACnet Server to perform only the third step of
the device discovery mechanism. This step gets a list of objects from the device
and then sequentially reads each of the objects' names.
enteliWEB then updates the Object List page with this new object list and gets the
related information for each object.

Reconfirm Status
The Reconfirm Status action causes the BACnet Server to execute its entire device
discovery mechanism, for the selected device or devices. The device discovery
mechanism is sometimes referred to as reloading descriptors. This mechanism
consists of four main steps and can take many seconds to complete for each
device.
When the discovery is completed, enteliWEB updates the Object List page with this
new object list and gets the related information for each object.

Communication Control
Device Communication Control lets you command a device to stop communicating
on the network for a specified duration of time. Applies to the device's peer and
subnet levels.
The Communication Control feature is typically used in the following situations.
l Stop a device from sending too much traffic over a network for a specified
duration.
l Set a device to only respond to requests and to not initiate communication for
a specified duration.
l Locate a device causing problems when troubleshooting a network.
Device Communication Control can be password-protected when the device's DEV
object has its Communications Control Command password configured.
Devices that support the Device Communication Control feature indicate so by
their DEV.Protocol_Services_Supported property.
The device stops initializing communication and optionally stops responding to
APDUs. An APDU (Application Protocol Data Unit) is an encoded message that is
exchanged between devices over the BACnet network. BACnet defines a variety of
APDU types such as confirmed request, unconfirmed request, simple
acknowledge, complex acknowledge, segment acknowledge and so on.
The Device Communication Control feature implements ASHRAE Standard 135,
Annex K, clause K.5.5.

42 enteliWEB 4.20 Operator Guide


Edition 1.0
Object List

Reconfigure
Reconfigure is used for devices that display a yellow wrench icon in the left
pane navigation tree, which indicates an incorrect or duplicate BACnet network
number. Network numbers must be unique for each network segment, and all
devices on the same network segment must be configured with the same network
number.
Reconfigure commands the device to forget the network number it thinks it should
use and to ask the network which one to use. Reconfigure may disrupt network
operation and does not always resolve the network number problem. Typically,
additional actions are required.

Databases of devices displaying a yellow wrench icon are not backed


up during scheduled backup tasks.

Reset
Reset performs a software reset by sending the BACnet ReinitializeDevice service
to the selected device.
Reset is disabled when more than one device is selected.
When a Delta Controls or Delta Electronics device is selected, then Reset
performs a cold start.
When a third-party device is selected, the Reset lets you choose a warm or cold
start service to specify the state of the device after its reinitialization.
Warm start is defined by the BACnet standard. A warm start causes the device to
reboot and start over, retaining all data and programs that are retained during a
brief power outage.
Cold start is defined by the vendor. For most Delta devices, a cold start is
equivalent to a warm start. For the O3-DIN system, a cold start turns off and on
the power to the system. For a third-party device, see the vendor's
documentation.
The Reset action can be password-protected by configuring the Reset Command
Password in the device's DEV object.
The Reset feature implements ASHRAE Standard 135, Annex K, clause K.5.15.

Set Time
Set Time sends a BACnet time synchronization message to the selected device.

© 2021 Delta Controls Inc. 43


Object List

Set Time displays the local date and time of the client that you are accessing
enteliWEB from, but actually sends the local date and time of the enteliWEB
server unless you specify a different date and time.
If Offset from UTC is enabled in the device's DEV object, the time synchronization
message is converted to the device's local time.
Set Time is disabled in the Device Actions list if the selected device does not
support the BACnet TimeSynchronization service.
If you want to send a time synchronization broadcast to all devices on the network,
use the Sync Device Times action on the device list page.

Object Security
Object Security works with the device's Object Restriction Settings (ORS) objects
to provide device-based security for objects in the device database. An ORS object
restricts the operations by BACnet network requests on objects in the database
based on the list of object exceptions it contains.
When object security is in effect, the object list displays only the objects that are
permitted by both the object exceptions in the ORS object and by the enteliWEB
device and object permissions of the group you are a member of.
The Object Security action is enabled when ORS1 object exists on the device.

When the time difference between the device and the enteliWEB server is
5 minutes or more, the Lock and Unlock operations fail. To eliminate the
time difference, you should define the time zone for the device or
synchronize the device time.

Object Security > Unlock


The Unlock action unlocks ORS1 to remove or disable the device-based security
for objects in the device database. All BACnet network requests are allowed and
processed. The object exceptions in any ORS object are ignored.
The object list is updated to display the objects that are permitted by the
enteliWEB device and object permissions of the group you are a member of.

Object Security > Lock


The Lock action locks the ORS1 object and the objects in the device are secured.
BACnet network requests are allowed and processed or are denied and ignored
based on the object exceptions in the ORS1 object.

44 enteliWEB 4.20 Operator Guide


Edition 1.0
Object List

The object list is updated to display the objects that are permitted by both the
object exceptions in the ORS1 object and by the enteliWEB device and object
permissions of the group you are a member of.

Object Security > Temporary Login


The Temporary Login action allows a user such as a service technician to log in to
a secured device without completely disabling the device security imposed by
ORS1. The ORS object that the user logs in to as well as the username and
password, are specified by an SUA object and not by the user's enteliWEB account.
The Temporary Login remains in effect until there is no user activity for the time
period specified in the user's SUA object Auto-logoff setting.
The object list is updated to display the objects that are permitted by both the
object exceptions in the ORS object that the user logged in to and by the
enteliWEB device and object permissions of the group the user is a member of.

Objects listed in the ORS exception list are visible to all enteliWEB users.
The ORS object identifies the temporary user by the MAC address of the
device that the user logged in from. Since the device (and, therefore, the
MAC address) is always the enteliWEB server, when a device with ORS is
temporarily unlocked, it is unlocked to the whole machine—in this case,
enteliWEB.

Activate Network Change


The Activate Network Change action is used to apply saved pending changes on all
NP objects in the object list.
If you have made changes without clicking the Activate Network Change action, an
icon is displayed on the Network tab. The icon is displayed until you click
Activate Network Change on the Network tab.

© 2021 Delta Controls Inc. 45


Object List

Save Database to File


Save Database to File collects all the files related to the device's configuration and
saves them in a single file that is downloaded to your computer and to the
enteliWEB server (see > Management > Manage Device Databases).
To save the databases of multiple devices in one operation, you can select up to 10
devices from the Navigation tree view. The configuration files are downloaded as a
single .zdd file with a unique filename. If the Save Database to File action is
performed for multiple devices, the .zdd files are collected in a .zip file.
By saving the device database, you create a backup or snapshot that can be
restored by the Load Device Database from File action.
To confirm the results of the Save Database to File action, see the Task Queue
page. The Save Database to File action is logged in the DEV object History and in
the enteliWEB log.
To perform Save Database to File, you must be a member of a group that has Save
Database enabled in Service Permissions and Object Permissions for the DEV
object set to Delete.

Save Database to Flash


Save Database to Flash copies a device's resident active database to the device's
non-volatile memory. By saving the database to non-volatile memory, you create a
backup or snapshot that can be restored by the Load Database from Flash action.
Save Database to Flash can be performed on one device or on multiple devices.
The term flash refers to a specific type of non-volatile memory that is used in
most Delta devices. Although some devices may use other types of non-volatile
memory, the term flash is retained in recognition of its legacy in the Delta product
line.
The Save Database to Flash action is logged in the DEV object History and in the
enteliWEB log.
Save Database to Flash is available only for devices that are manufactured by
Delta Controls.
To perform Save Database to Flash, you must be a member of a group that has
Save Database enabled in the Service Permissions and the Object Permissions for
the DEV object set to Write.

46 enteliWEB 4.20 Operator Guide


Edition 1.0
Object List

Save Database to Server


Save Database to Server collects all the files related to the device's configuration
and saves them in a single file that is saved to the enteliWEB server (see >
Management > Manage Device Databases).
To save the databases of multiple devices in one operation, you can select devices
from the Navigation tree view, or you can create a run-once task.
To confirm the results of the Save Database to Server action, see the Task Queue
page. The Save Database to Server action is logged in the DEV object History and
in the enteliWEB log.
To perform Save Database to Server, you must be a member of a group that has
Save Database enabled in the Service Permissions and the Object Permissions for
the DEV object set to Delete.

Load Database from File

On an O3-DIN controller running firmware version 4.9 and later, the ACC,
ACU and ACR objects in the database are cleared after loading the
database in enteliWEB. If you have enteliSYNC 4.14 or later running on
the same system, these objects are replaced with objects from the
enteliSYNC database during synchronization.

Load Database from File takes a saved database file that was created by the Save
Database to File action or a .pdb file that was created by ORCAview and downloads
it to the device. The device's entire configuration is replaced by the contents of the
downloaded file.
The saved database file must be accessible from your client computer.
The Load Database from File action is logged in the DEV object History and in the
enteliWEB log.
To perform Load Database from File, you must be a member of a group that has
the Object Permissions for the DEV object set to Delete.

© 2021 Delta Controls Inc. 47


Object List

Load Database from Flash

On an O3-DIN controller running firmware version 4.9 and later, the ACC,
ACU and ACR objects in the database are cleared after loading the
database in enteliWEB. If you have enteliSYNC 4.14 or later running on
the same system, these objects are replaced with objects from the
enteliSYNC database during synchronization.

Load Database from Flash copies the database from the device's non-volatile
flash memory to the overwrite the resident active database in the device. By
loading the database from flash, you restore the device to a backup or snapshot
that was saved by the Save Database to Flash action. Load Database to Flash can
be performed on one device or on multiple devices.
The Load Database from Flash action is logged in the DEV object History and in
the enteliWEB log.
Load Database from Flash is available only for devices that are manufactured by
Delta Controls.
To perform Load Database from Flash, you must be a member of a group that has
the Object Permissions for the DEV object set to Write and has Service
Permissions to Load Database.

Load Database from Server

On an O3-DIN controller running firmware version 4.9 and later, the ACC,
ACU and ACR objects in the database are cleared after loading the
database in enteliWEB. If you have enteliSYNC 4.14 or later running on
the same system, these objects are replaced with objects from the
enteliSYNC database during synchronization.

Load Database from Server takes a saved database file that was created by the
Save Database to Server action and downloads it to the device. The device's entire
configuration is replaced by the contents of the downloaded file.
Load Database from Server performs a similar operation to Load Database from
File except that the saved database file is downloaded from the enteliWEB server.
The Load Database from Server action is logged in the DEV object History and in
the enteliWEB log.

48 enteliWEB 4.20 Operator Guide


Edition 1.0
Object List

To perform Load Database from Server, you must be a member of a group that
has the Object Permissions for the DEV object set to Delete.

Load Database from Server will fail if the device that you are loading to
has a password. In that case, use Load Database from File, which
prompts for a password.

Clear Database
Clear Database causes the device to delete all database objects and to re-create
the standard system objects such as DEV, DBI, and so on. Network settings
necessary to maintain a connection to the controller are retained on database
clear. On controllers running O3/enteliBUS firmware V4.9 and later, time settings
necessary to maintain a Secure Connect connection are also retained on database
clear (see Device Time for details).
Clear Device Database does not affect or remove the saved database from the
device's flash memory.
To perform Clear Database, you must be a member of a group that has the Object
permissions for the DEV object set to Write and Delete.

© 2021 Delta Controls Inc. 49


Object Pages
Object Page Tasks and Related Information Views
Object Page
An object page displays the status and properties that apply to an instance of a
specific type of object. The help page that you open from an object page provides
information about what that object page displays and about how to configure that
type of object.
Each object page also includes features and tasks that are the same on almost
every object page, certainly on every object page for a specific type of object.
Most of these tasks can be performed only be a user with the proper permissions.

What is an Object Reference?


An object reference is an identifier for an object. An object reference, when the
site name is included in the reference, is unique over all the sites that are
managed by an enteliWEB server.
The format of an object reference is as follows.
//sitename/device address.object identifier
where:
sitename is the name of the site. sitename is case-sensitive. It must match exactly
the name given to the site and shown in the left navigation pane, Navigation
section. For example, when the name of the site is MainSite, enter MainSite, not
mainsite or Mainsite.
device address is the numeric address that is assigned to the device or controller
on which the object you are referring to resides.
object identifier is the object type abbreviation and object instance number for the
object you are referring to. For example, PG3, where PG is the abbreviation for a
GCL Program object with an instance number of 3.
Example: //MainSite/5600.PG3

Format of the I/O Object Reference Instance Number


The object identifier for I/O objects often contain information about their local
environment on the controller.

50 enteliWEB 4.20 Operator Guide


Edition 1.0
Object Pages

For information about the format of the object reference instance number for an
I/O object that resides on an enteliBUS controller, see Object List Page Reference
section in the enteliWEB help.
For information about the format of the object reference instance number for an
I/O object that resides on a DSC or DAC controller, see Object List Page Reference
section in the enteliWEB help.
For information about the format of the object reference instance number for
objects that reside on the O3 devices, see Object List Page Reference section in
the enteliWEB help.

Site Independence
The device address.object identifier component of the object reference can be the
same on different sites that are managed by an enteliWEB server, but it must be
unique in a particular site.

About the Object Picker


The object picker is a specialized component of the enteliWEB user interface that
simplifies the task of entering an object reference.
When a field in a configuration dialog requires an object reference, the enteliWEB
user interface presents the object picker. For example, many object dialogs and
some widget types use the object picker.
An empty object picker looks like this:

When you enter an exact object reference such as AV4 or an exact object name,
the object picker accepts it without the need for you to select from a list of
suggestions, when the object or name exists.
When you enter a partial object reference such as AV or a partial object name, the
object picker searches for and lists the matching objects. Local matching objects
are listed first, followed by matching objects on remote devices.
The object picker makes sure that the list of objects contains only the object types
that meet the requirements of the field. For example, when the field you are
configuring must reference an analog object, the object picker lists analog objects
only. Or, when the reference must be to an object on the same controller, then
only local objects are listed.
Local objects are listed first followed by remote objects.

© 2021 Delta Controls Inc. 51


Object Pages

You can work around the object picker's constraints for object type by entering the
complete object reference for the object you want. For example, if an object picker
is constrained to list only AV objects, you can force it to accept an AI object by
entering the AI object reference in the field.
An object picker containing a valid object reference looks like this:

Hot Water Supply Temp

Although the object name is displayed in the object picker field, the value sent to
the controller is the object reference.
To specify an object property other than Present_Value, at the end of the object
name enter a period followed by a partial name of the property you want. For
example, .cov. The matching properties are listed.
When you are configuring an object reference in an offline scenario, the object
picker may not be able to list the object you want to reference. In this case the
object picker lets you enter the complete object reference in the form
//sitename/device address.object identifier .
An object picker containing a valid complete object reference looks like this:

//MainSite/2001.BI3

See Using the Object Picker for a Local Reference and Using the Object Picker for
a Remote Reference for how to use the object picker.

Common Object Page Tasks


The following sections describe the tasks that are common to most object pages.

Using the Object Picker for a Local Reference

52 enteliWEB 4.20 Operator Guide


Edition 1.0
Object Pages

1. In the object picker field, enter the local reference in one of the following
formats.
<object reference>
<object name>
<object name>.<property name>
You can enter partial references or names. The Object Picker lists matches
for you to choose from. Select the object that you want to reference from the
list.
To specify an object property other than Present_Value, at the end of the
object name enter a period followed by a partial name of the property you
want. For example, .cov. The matching properties are listed. Select the
property you want to use.
2. Click Save to send the configuration to the object.

Using the Object Picker for a Remote Reference


1. In the object picker field, enter the remote reference in one of the following
formats.
<device number>.<object reference>
<device number>.<object name>
<device number>.<object name>.<property name>
//<site name>/<device number>.<object reference>
You can enter partial references or names. The Object Picker lists matches
for you to choose from. Select the object that you want to reference from the
list.
To specify an object property other than Present_Value, at the end of the
object name enter a period followed by a partial name of the property you
want. For example, .cov. The matching properties are listed. Select the
property you want to use.
2. Click Save to send the configuration to the object.

Saving an Object Page


Click Save to send all configuration properties to the object for validation.

© 2021 Delta Controls Inc. 53


Object Pages

The result of the Save operation is indicated by a banner at the top of the object
page.
OK Result

When all configuration properties are valid, then the confirmation banner
is displayed at the top of the page. Click the confirmation banner to list
all the properties that were affected by the save operation, marked as OK.
Click More..., on the right side of the banner, to see the complete list of affected
properties.
Error Result

When one or more of the configuration properties was invalid, then the error
banner is displayed at the top of the page. Click the error banner to list
all the properties that were affected by the save operation. When a change to a
property was accepted by the object, it is marked as OK. When a change to a
property was rejected by the object, it is marked with an error message.
Click More... , on the right side of the banner, to see the complete list of affected
properties and their corresponding error messages.

Some Objects Don't Have a Save Button


When an object page doesn't have a Save button, then the changes you
make are sent immediately to the object. For example, the MT object and
the SCH object.

Closing an Object Page Without Saving Changes


Use one of the following ways to close the object page without saving changes.
l Click Close. The Object List page is displayed.
l Click Back to Object List. The Object List page is displayed.
l
Click . The previous object in the Object List is opened.
The adjacent numbers show you the position in the object list of the object
you are viewing. For example, 37 of 142 indicates that you are viewing the
37th object out of a total of 142 objects that are listed on the Object list page.
The number of objects that are listed on the Object List page varies
depending on the Object List page's search filter setting.
l
Click . The next object in the Object List is opened.

54 enteliWEB 4.20 Operator Guide


Edition 1.0
Object Pages

When you have made changes to the object page, the Are you Sure You Want to
Leave This Page dialog opens. Click Leave this page.

Showing and Hiding Sections of an Object Page


Most object pages are divided into sections by horizontal banners. Use the
following ways to hide and show a section.
Click . The section of the object page is shown.
Click . The section of the object page is hidden.

Showing and Hiding the Property List


The Property List section is a list of all of the object's properties and values.
To display the Property List section, click the invisible button in the lower left
corner of the object page. The property list is displayed.
To remove the Property List section from being displayed, click the invisible
button in the lower left corner of the object page. The property list is hidden.

Editing any Object Property


1. Display the Property List, as described above.
2. Edit property.
3. Click Save to send all configuration properties to the object for validation.

Adding an Object to a Watchlist


This procedure describes how to add an object to the Watchlist widget on a
personal dashboard.
1. Add the Watchlist widget to a personal dashboard. Make a note of the name
of the watchlist.
2. Open the object page of the object you want to add to the watchlist.
3. In the Dashboard pane to the right of the object page, select the watchlist
from the Watchlist list and click Add.
When there are no watchlists on any dashboards, the Dashboard pane is not
displayed.
4. The Dashboard pane displays the watchlist as a link. Click the link to go to
the dashboard. The watchlist widget on the dashboard lists the object you

© 2021 Delta Controls Inc. 55


Object Pages

added.

Importing CSV file into Excel


Data from TL and MT objects can be exported to a CSV (Comma Separated Value)
file.
This procedure ensures that special characters such as unit symbols are
converted correctly when a CSV file is imported into Excel.
1. Open Excel
2. Select Data > From Text. The Import Text File dialog opens.
3. In the Import Text File dialog, set the file type to *.csv
4. Navigate to and select the CSV file you want to import into Excel.
5. Click Import. The Text Import Wizard Step 1 dialog opens.
6. In the area titled Original data type, select Delimited.
7. From the list labeled File origin, select 65001 : Unicode (UTF-8).
8. Click Next. The Text Import Wizard Step 2 dialog opens.
9. In the area titled Delimiters, select Comma.
10. Click Next. The Text Import Wizard Step 3 dialog opens.
11. Click Finish. The Import Data dialog opens to ask the question Where do you
want to put the data?
12. Make any necessary changes to this dialog and click OK.
13. The data is imported and is displayed in the Excel spreadsheet.

Deleting an Object
1. Click Delete. The delete confirmation dialog opens.
2. Click Yes to delete the object.
When the object is deleted, the object page closes and the Object List page
for the device is displayed.

Navigating to Next or Previous Object Page


To go to the next object page, click or press the SHIFT + Page Down keys.

To go to the previous object page, click or press the SHIFT + Page Up keys.

Returning to the Object List Page

56 enteliWEB 4.20 Operator Guide


Edition 1.0
Object Pages

To return to the Object List page, click Back to Object List or click Close on the
object page, or select the device in the left pane navigation tree.

Commanding or Overriding an Object Manually


Many objects allow an operator to command them to a specific manually entered
value, either permanently or for a time period. When an object value is
commanded, the object stops performing its function. The object's value remains
unchanged until the object returns to Auto mode.

Commanding a Permanent Manual Override


1. In the Value bar, select Manual.
2. In the Value bar, enter the value you want to override the object to.
3. Click Save to send the override command to the object.

The Manual mode icon is displayed.


The override persists permanently or until you revert to Auto manually.

Commanding a Timed Manual Override


1. In the Value bar, select Timed Override. The Timed Override Setting dialog
opens.
2. Set the Timed Override Period or the End Date and End Time to specify the
duration of the override.
3. Click OK to accept the values and close the Timed Override Setting dialog.
4. In the Value bar, enter the value you want to override the object to.
5. Click Save to send the override command to the object.

The Manual mode icon and the Timed Override mode icon are
displayed on the Value bar.

Changing a Timed Override


1. In the Value bar, select Timed Override or click . The Timed Override
Setting dialog opens.
2. Change the Timed Override Period or the End Date and End Time.
3. Click OK to accept the values and close the Timed Override Setting dialog.
4. Click Save to send the override command to the object.

© 2021 Delta Controls Inc. 57


Object Pages

Commanding a Related Object


1. In one of the related panes to the right of the main object pane, click
adjacent to the object you want to command. The Command dialog opens.
2. Set the dialog to the command you want to issue to the object.
3. Click Save to send the command to the object.

When Commanding a PG Object ...


When you open the Command dialog for a PG object, your choices are
Auto and Manual. Auto means Run and Manual means Halt.

Relinquishing a Manual Override and Reverting an Object to Auto


1. In the Value bar, select Auto.
2. Click Save to send the command to the object.

The Manual mode icon or is no longer displayed.

Related Information Views on an Object Page


When an object page is open, information that is related to the object is displayed
in a series of panes to the right of the main object pane.
The related information that is displayed varies, depending on the type of object
and the BACnet permissions of the user group that you are a member of.
The following sections describe the possible related information panes.

Associated System
The Associated System pane lists the system or systems that the object is a
member of.
When the object is not a member of any system, the Associated System pane is not
displayed.

58 enteliWEB 4.20 Operator Guide


Edition 1.0
Object Pages

Configuration
The Configuration pane lists the objects that provide configuration information to
the object you are viewing, or it lists the objects that reference the object you are
viewing for configuration information. For example, an AIC object provides
configuration information to an AI object which that object applies to its
conversion algorithm for its present value, or a BDC object provides state
numbers and state text state configuration information to BI, BO, and BV objects.
An AIC object, for example, lists all the AI objects that reference that AIC object.

Controlled By
The Controlled By pane lists the objects that provide control values to the object
you are viewing, when it is in Auto mode. For example, a CO object provides a
value in % to an AO object which that object converts to its present value, or a SCH
object provides schedule state to an OS object.
Objects for which you are denied access because of your user group's BACnet
permissions are not listed.

Controlling
The Controlling pane lists the objects that receive the output of the object you are
viewing. For example, a CO object may control an AO object or a SCH object may
provide its schedule state to multiple objects such as OS objects.

Dashboard
The Dashboard pane lists the watchlist widgets that watch the object you are
viewing and it lets you add the object to other watchlist widgets.
When there are no watchlists on any dashboards, the Dashboard pane is not
displayed.
When the object is on all watchlists, then the Watchlist list and the Add button are
not displayed.

Graph
The Graph pane displays a real-time chart that corresponds to a TL object that is
monitoring and recording samples of the object.
To open the TL object page, click the graph.

© 2021 Delta Controls Inc. 59


Object Pages

History
The History pane displays the 10 most recent events that occurred for the object
such as the results of each Save operation.

When more than 10 events have occurred for the object, the pane title,
History, becomes a link, History, to a view of the Log that is filtered for
the object. The Log view lists the full history of the object.

Save operations

The result of a save operation displays date and time, property changed or
attempted to be changed and the username of person who made the change.
indicates that the save operation was successful. indicates that the save
operation failed.
When a property has multiple components, such as a group, union or array, the
results are formatted to make it clear what each component was set to.
Alarm transitions

Alarm transitions are displayed in History when the object is configured for
intrinsic alarm reporting, otherwise the alarm transitions are displayed in the
monitoring EV object History pane.
For alarm transitions, the date and time is the device date and time when the
transition occurred.
When both the from state and the to state are known, then the History pane
displays both states as from-state => to-state.
When only the to state is known, then the History pane displays only that state.
For example, Normal by itself means the transition resulted in the normal state.
Other transitions

For DEV objects, the History pane displays when the device goes online and
offline.

60 enteliWEB 4.20 Operator Guide


Edition 1.0
Object Pages

Member
The Member pane is displayed for the access group (AG) object. The Member
pane lists the card users (CU objects) that are members of the access group you
are viewing. The Member pane limits the number of card users that it displays.
The Member pane is displayed for the access user (ACU) object. The Member
pane lists the access credential (ACC) objects that are assigned to the access
user.

Member Of
The Member Of pane is displayed for the card user (CU) object. The Member Of
pane lists the access groups (AG objects) that the card user is a member of.
The Member Of pane is displayed for the access credential (ACC) object. The
Member Of pane lists the access user (ACU) object that the credential is assigned
to.

Monitored By
The Monitored By pane lists the objects such as TL and MT objects that the object
you are viewing is an input to.
Objects to which you are denied access because of your user group's BACnet
permissions are not listed.
Sometimes an object displays a PG object in both the Monitored By pane and the
Controlled By pane when PG is writing to the object and you would expect to see
the PG object in the Controlled By pane only. The PG object is listed in the
Monitored By pane because it is monitoring the object's out of service status.

Monitoring
The Monitoring pane lists the objects that are inputs to the object you are viewing.
For example, the AV object that is providing a setpoint to a CO object or the AI
object that is providing indoor temperature to an OS object.
Objects for which you are denied access because of your user group's BACnet
permissions are not listed.

Watch

© 2021 Delta Controls Inc. 61


Object Pages

The Watch pane is used by the PG object to list the names and values of constants,
object references and variables in the program you are viewing. The values are
updated periodically when the program is running.

Object Description Field


The Description field that is present on every object page lets you enter textual
information about the object.

Entering URL with http:// or https://


The Description field lets you enter a URL link that starts with http:// or https://.
When the link is clicked, the referenced page opens in a new tab in the browser.

Entering URL with file://


The Description field lets you enter a URL link that starts with file://. When the
link is clicked, the referenced document opens in a new tab in the browser.
The URL link to the file must be according to one of the following formats.
l Filename with spaces: entire URL must be enclosed in quotation marks. For
example, "file://eZNS Application Guide.pdf"
l Filename without spaces: quotation marks not required but may be used for
consistency
enteliWEB expects the file to be located in the public folder, that is, C:\Program
Files (x86)\Delta Controls\enteliWEB\website\public. The document can be in a
subfolder of public, in which case the folder name must be in the URL, as, for
example, "file://catalog_sheets/eZNS Application Guide.pdf", where catalog_
sheets is the name of the subfolder within the public folder.

62 enteliWEB 4.20 Operator Guide


Edition 1.0
Dashboards
About Dashboards
Dashboards are task-driven visualizations that provide users with the information
they need automatically, without them having to search for it. Dashboards make
the process of navigating from high level operational views to specific elements of
the system into a simple and intuitive task.
A dashboard type determines its intended purpose and whether or not a user can
change its settings. enteliWEB defines the following three types of dashboards.

System dashboard type


A system dashboard displays a mechanical system or subsystem within the
building automation system, as defined by an enteliWEB system. A system
dashboard is visualized when it is included in an enteliWEB view. To learn about
views, see About Views in the enteliWEB help.

Enterprise dashboard type


An enterprise dashboard provides high level information in simple graphical
formats to help operators manage a facility's key operational goals.
Enterprise dashboards are created by the enteliWEB administrator and display the
widgets assigned to them by the administrator. Enterprise dashboards cannot be
modified by other users.

Personal dashboard type


To learn about personal dashboards, see About Personal Dashboards.

About Personal Dashboards


A personal dashboard displays widgets that are selected from the widgets
provided by the enteliWEB administrator.
A personal dashboard is managed by the user who creates it. A personal
dashboard cannot be viewed or modified by other users.

Creating a Personal Dashboard


1. Select the Dashboards section from the left navigation pane. A list of your
personal dashboards is displayed.

© 2021 Delta Controls Inc. 63


Dashboards

2. From the Action list that is located at the bottom of the Dashboards section,
select Create Personal Dashboard. The Create Personal Dashboard dialog
opens.
3. Enter a name for the dashboard in the Name field and then click Add. A
personal dashboard with this name is displayed in the Dashboards section of
the left navigation pane.
4. Select the new personal dashboard to open it in the right pane.
The layout of a personal dashboard is fixed to the following layout. The layout
can't be changed.

Adding a Widget to a Personal Dashboard


1. Open the dashboard you want to add the widget to.
2. Click Add Widget. The Add Widget dialog opens.
The Add Widget dialog lists widgets that an enteliWEB administrator has
created. It also includes the Watchlist widget.
3. Select the widget or widgets that you want to add to the dashboard.
When there are many widgets to choose from, you can reduce the list of
widgets that the dialog displays by selecting a widget type in the left column
of the dialog or by selecting All and doing a text search using the Search
field.
4. Click Add to Dashboard. The dashboard displays the widgets you selected.
5. Click and drag a widget to position it on the dashboard.
6. Configure the widgets that have user preferences. Click to open a
widget's user preferences dialog.

Adding an Object to a Watchlist Widget


A watchlist widget displays a list of objects that you are interested in monitoring.
You can add multiple watchlist widgets to a dashboard.
To add an object to a watchlist, you must be a member of a group that has view
objects permissions.

64 enteliWEB 4.20 Operator Guide


Edition 1.0
Dashboards

1. Navigate to the object page for the object you want to add to the watchlist.
2. On the right side of the object page, in the Dashboard pane, select your
watchlist widget from the Add to Watchlist list and click Add.
3. Return to your personal dashboard to confirm that the object is included in
the watchlist widget.

Removing an Object from a Watchlist Widget


1. On the watchlist widget, select the object that you want to remove.
2. Click Remove. The selected objects are removed from the list.

Deleting a Personal Dashboard


1. Select the Dashboards section from the left navigation pane. A list of your
personal dashboards is displayed.
2. Select the dashboard you want to delete.
3. From the Action list that is located at the bottom of the Dashboards section,
select Delete Personal Dashboard. You are prompted to confirm that you
want to delete the dashboard.
4. Click Yes. The dashboard is deleted.

© 2021 Delta Controls Inc. 65


Calendars and Schedules
Calendar (CAL) Object Concepts
About the Calendar object
The Calendar (CAL) object defines calendar date entries which might be thought of
as special event days such as holidays or as simply a list of dates. When the
controller's current date matches a date that is defined as a special event day or
calendar entry in the CAL object, the CAL object's present value changes to On for
the entire day. When controller's current date doesn't match a date that is defined
as a special event day or calendar entry in the CAL object, the CAL object's
present value remains Off.
Typically, objects such as Schedule objects and GCL programs monitor the CAL
object's present value and operate differently on special event days.

About Calendar view


Calendar view displays a traditional monthly calendar. In the Calendar view, a
special day or calendar entry is indicated by a single date or a date range, a
descriptive phrase, and an associated square-shaped color dot. See the legend for
the association between color and type of calendar entry.

Types of calendar entries


A calendar entry specifies a date range during which the CAL object's present
value is On. For all dates that are not within a calendar entry, the CAL object's
present value is Off.
You can specify multiple calendar entries and overlapping calendar entries.
Calendar entries in the past are deleted automatically, when the CAL object is
configured to do so.
When you add a calendar entry, you choose from four types of calendar entries to
add, as described below:

Single Date
A Single Date entry specifies the date for one day.
indicates a Single Date.

66 enteliWEB 4.20 Operator Guide


Edition 1.0
Calendars and Schedules

Date Range
A Date Range entry specifies the dates for one or more consecutive days.
indicates the dates that the Date Range entry occurs on.

Recurring Week and Day


A Recurring Week and Day entry specifies a repeating pattern for one weekday or
all weekdays. The selected weekday can be configured to repeat in many ways.
indicates the dates that the recurring entry occurs on.

Recurring Date
A Recurring Date entry specifies a repeating pattern for one day in a month. The
selected day can be configured to repeat in many ways.
indicates the dates that the recurring entry occurs on.

Calendar (CAL) Object Tasks


Adding a Single Date calendar entry
1. Click Add Entry. The Calendar Entry dialog opens.
2. Select Single Date from the Type list.
3. Enter a short phrase that describes this calendar entry. In the calendar view,
this phrase appears on the date that this calendar entry occurs on.
4. Select the date that you want the calendar entry to occur. Dates in the past
are not accepted.
5. Click Save to save the calendar entry.

Adding a Date Range calendar entry


1. Click Add Entry. The Calendar Entry dialog opens.
2. Select Date Range from the Type list.
3. Enter a short phrase that describes this calendar entry. In the calendar view,
this phrase appears on the dates that this calendar entry occurs on.
4. Select the date that you want to be the last date in the range that this
calendar entry occurs on, from the End Date calendar.
5. Select the date that you want to be the first date in the range that this
calendar entry occurs on, from the Start Date calendar.
6. Click Save to save the calendar entry.

© 2021 Delta Controls Inc. 67


Calendars and Schedules

Adding a Recurring Week and Day calendar entry


1. Click Add Entry. The Calendar Entry dialog opens.
2. Select Recurring Week and Day from the Type list.
3. Enter a short phrase that describes this calendar entry. In the calendar view,
this phrase appears on the dates that this calendar entry occurs on.
4. Select the week that you want the calendar entry to recur on, from the Week
list. Select Every when you want the calendar entry to recur on all weeks.
Select Last when you want the calendar entry to recur on the last week of the
month regardless of whether that week is the fourth week or the fifth week.
5. Select the weekday that you want the calendar entry to recur on, from the
Weekday list. Select Week when you want the calendar entry to recur on
every day of the week.
6. Select the month that you want the calendar entry to recur on, from the
Month list. Select Every when you want the calendar entry to recur on all
months.
7. Click Save to save the calendar entry.

Adding a Recurring Date calendar entry


1. Click Add Entry. The Calendar Entry dialog opens.
2. Select Recurring Date from the Type list.
3. Enter a short phrase that describes this calendar entry. In the calendar view,
this phrase appears on the dates that this calendar entry occurs on.
4. Select the month that you want the calendar entry to recur on, from the
Month list. Select Every when you want the calendar entry to recur on all
months.
5. Select the day date that you want the calendar entry to recur on, from the
Date list. Select Every when you want the calendar entry to recur on every
day of the month.
6. Select the year that you want the calendar entry to recur on, from the Year
list. Select Every when you want the calendar entry to recur on all years.
7. Click Save to save the calendar entry.

Deleting a calendar entry


1. Click the calendar entry you want to delete, in the Calendar view. The
Calendar Entry dialog opens. The dialog displays the settings for the calendar
entry you clicked.

68 enteliWEB 4.20 Operator Guide


Edition 1.0
Calendars and Schedules

2. Click Delete to confirm you want to delete that calendar entry.


3. The Calendar view is displayed with the deleted calendar entry removed.

Deleting a Calendar Object


1. Click Delete. The delete confirmation dialog opens.
2. Click Yes to delete the object.
When the object is deleted, the object page closes and the Object List page
for the device is displayed.

Schedule (SCH) Object (BACnet Revision 4) Concepts


About the BACnet Revision 4 Schedule Object
The Schedule (SCH) object describes a periodic sequence of weekly schedules and
event schedules that recurs during a range of dates.
When weekly schedules and event schedules overlap, a priority mechanism
determines which weekly schedule or event schedule is in control.
The current state of the SCH object, the value of its Present Value property, is
calculated from the weekly schedules and event schedules defined in the
schedule. When no weekly schedule or event schedule is in effect, the present
value is set to the SCH object's default value.
When the present value changes, the SCH object writes the present value to
subscriber objects that require schedule control information.

Schedule Type
The schedule type setting determines the nature of the values that the SCH object
provides to subscriber objects and therefore which type of objects can be
controlled by the schedule.
You select the schedule type when you open a SCH object that has no schedules
defined. Typically, that means when you open a SCH object for the first time after
it is created.
The following schedule types are possible:
Binary

A schedule of type Binary provides schedule values as 1 for On and 0 for Off
schedule states.

© 2021 Delta Controls Inc. 69


Calendars and Schedules

Multistate

A schedule of type Multistate provides schedule values as integers in the range


from 1 to 65534.
Analog

A schedule of type Analog provides schedule values as analog values, that is, real
numbers, such as periodic setpoint changes, in the range from -65534 to +65534.
Boolean

A schedule of type Boolean provides schedule values as 1 for True and 0 for False
schedule states.
True state is displayed as On and False state is displayed as Off.

View Tabs
The view tabs provide the following functions:
Week displays the schedule week view and the weekly schedules and event
schedules for that week.
Month displays the schedule month view and lets you navigate the timeline
from month to month.
Details displays a list view of the weekly schedules and event schedules that
are in the schedule.
Setup displays configuration fields that allow certain SCH object properties
to be viewed and changed.

Time ranges
The schedule represented by a SCH object consists of one or more time ranges
and corresponding schedule values that you define. Time Ranges are defined by
weekly schedules, event schedules and the SCH object's default value.

Time Range Precision


A time range is specified by a start time and end time. Both of these times are
typically specified to the minute. However, you can specify these times to the
second and to the tenth of a second as needed.

Default value
The default value that you specify is applied to all time ranges that are not covered
by a weekly schedule or an event schedule.

70 enteliWEB 4.20 Operator Guide


Edition 1.0
Calendars and Schedules

Weekly schedule
A weekly schedule is typically used to define the facility's normal weekly
equipment operation or its occupancy hours. A weekly schedule time range
repeats every week, at the same times and days. Although you can define multiple
weekly schedules, a given time range can be defined by only one weekly schedule.
Unlike event schedules described below, a weekly schedule doesn't have a priority
setting and doesn't overlap with other weekly schedules.

Event schedule

Event schedules are not supported on enteliZONE controllers.

An event schedule defines a temporary or recurring event that take priority over
the default value and the weekly schedule time ranges. An event schedule is
typically for a one-time event such as a holiday or an event that occurs regularly
but doesn't work as a weekly schedule.
An event schedule can repeat, for example as a specific month and day every year
such as the first Monday of January, the New Year's Day holiday, or as a recurring
time range such as the third week of every month. Alternatively, an event
schedule can link to a local calendar which defines its time ranges.
You can add up to 100 event schedules to a schedule. Event schedules that will
never occur again are deleted automatically.
You can add the following types of event schedules:
Single Date event schedule

A Single Date event schedule defines an event schedule that occurs on one day
only.
Date Range event schedule

A Date Range event schedule defines an event schedule that occurs at the same
time on one or more consecutive days.
Recurring Week and Day event schedule

A Recurring Week and Day event schedule defines an event schedule that recurs
at the same time on specified days, weeks and months.

© 2021 Delta Controls Inc. 71


Calendars and Schedules

Recurring Date event schedule

A Recurring Date entry specifies a repeating pattern for one day in a month. The
selected day can be configured to repeat in many ways.
Calendar Reference event schedule

A Calendar Reference event schedule defines an event schedule that occurs at the
same time on the days determined by the referenced Calendar object. A Calendar
Reference event schedule provides a convenient method of overriding the normal
weekly schedule of a Schedule object.

Event schedule priority


When you add or edit an event schedule, you set its priority in the range 1 to 16.
Priority is used to resolve conflict for the time range when multiple event
schedules overlap. When event schedules overlap, the event schedule with the
lowest priority number is the highest priority event schedule and it determines the
schedule's value for the overlapped time range.

Week view
In the Week view, color shading indicates the time range associated with weekly
schedules and event schedules. When a time range is colored white, no weekly
schedule or event schedule is defined for that time range and therefore the
default schedule value is in effect for that time range. See the legend for the
association between color and event type.

Navigating Week view


The buttons that are located above the days of the week provide the following
functions:

Click this button to display the previous week in the schedule timeline.
Click this button to display the next week in the schedule timeline.
Click this button to display the calendar dialog where you can choose the
week and month that you want to view the schedule for.
Display Events checkbox in Week view, lets you select whether or not the
event schedules are displayed. When Display Events is not selected, then
weekly schedules only are displayed.

or Click this button to display the legend for the colors associated
with each type of weekly schedule and event.

72 enteliWEB 4.20 Operator Guide


Edition 1.0
Calendars and Schedules

Month view
In the Month view, the month calendar lists the time ranges and associated color
dot on the days when they occur to indicate weekly schedules and events and their
schedule types. When a time range is not listed, the default schedule value is in
effect for that time range. See the legend for the association between color and
event type.

Navigating Month view


The buttons that are located above the month calendar provide the following
navigational functions:

Click this button to display the previous month in the schedule timeline.
Click this button to display the next month in the schedule timeline.
Click this button to display the calendar dialog where you can choose the
month that you want to view the schedule for.

or Click this button to display the legend for the colors associated
with each type of weekly schedule and event.

Details view
In the Details view, all weekly schedules and all event schedules for the schedule
object are listed in tabular format. The schedules are organized in the tables by
date and time.

Intrinsic Alarm
Intrinsic alarming for the SCH object supports the Change of Reliability algorithm
to report fault and return to normal transitions that are derived from changes to
its Reliability property.

Automatic Deletion of Event Schedules


Event schedules that occurred in the past and do not recur in the future are
automatically deleted after the number of weeks that you configure.
This feature is present in DAC, DSC and enteliBUS controllers.

Schedule (SCH) Object (BACnet Revision 4) Tasks

Event schedules are not supported on enteliZONE controllers.

© 2021 Delta Controls Inc. 73


Calendars and Schedules

Setting the Schedule Type


The Select Schedule Type dialog is displayed only for a SCH object that has no
schedule entries. Schedule Type can't be changed once a schedule entry is made
in the SCH object.
1. Open the SCH object. The Select Schedule Type dialog opens.
If the SCH object page opens, then you can't change the Schedule Type for
this object.
2. Select the Schedule Type for the SCH object.
3. Click Save. The Select Schedule Type dialog closes and the SCH object page
opens.

Adding a Weekly Schedule


1. Click Add Schedule. The Add Weekly/Event Schedule dialog opens.
2. In the Recurrence list, select Weekly.
3. Set the weekly schedule's daily start time in the left Time field.
4. Set the weekly schedule's daily end time in the right Time field.
5. Using the checkboxes, select the day or days that this weekly schedule
applies to.
6. In the Value field, set the weekly schedule's value.
7. Click Save to add the weekly schedule to the schedule. This new weekly
schedule replaces any other weekly schedule that it overlaps with. It doesn't
affect event schedules that it overlaps with.

Adding a Single Date Event Schedule


1. Click Add Schedule. The Add Weekly/Event Schedule dialog opens.
2. In the Recurrence list, select Single Date.
3. In the Description field, enter a short phrase that describes this event
schedule.
4. Set the event schedule's start time in the left Time field.
5. Set the event schedule's end time in the right Time field.
6. Set the date that you want this event schedule to occur on.
7. In the Value field, enter the event schedule's value.
8. In the Priority list, select the priority for this event schedule.
9. Click Save to add the single date event schedule to the schedule.

74 enteliWEB 4.20 Operator Guide


Edition 1.0
Calendars and Schedules

Adding a Date Range Event Schedule


1. Click Add Schedule. The Add Weekly/Event Schedule dialog opens.
2. In the Recurrence list, select Date Range.
3. In the Description field, enter a short phrase that describes this event
schedule.
4. Set the event schedule's daily start time in the left Time field.
5. Set the date that you want this event schedule to begin on.
6. Set the event schedule's daily end time in the right Time field.
7. Set the date that you want this event schedule to end on.
8. In the Value field, enter the event schedule's value.
9. In the Priority list, select the priority for this event schedule.
10. Click Save to add the date range event schedule to the schedule.

Adding a Recurring Week and Day Event Schedule


1. Click Add Schedule. The Add Weekly/Event Schedule dialog opens.
2. In the Recurrence list, select Recurring Week and Day.
3. In the Description field, enter a short phrase that describes this event
schedule.
4. Set the event schedule's daily start time in the left Time field.
5. Set the event schedule's daily end time in the right Time field.
6. Select the week that you want the event schedule to recur on, from the Week
list. Select Every when you want the event schedule to recur on all weeks.
Select Last when you want the event schedule to recur on the last week of
the month regardless of whether that week is the fourth week or the fifth
week.
7. Select the weekday that you want the event schedule to recur on, from the
Day list. Select Every when you want the event schedule to recur on every day
of the week.
8. Select the month that you want the event schedule to recur on, from the
Month list. Select Every when you want the event schedule to recur on all
months. Select Odd Months when you want the event schedule to recur on
January, March, May, July, September and November. Select Even Months
when you want the event schedule to recur on February, April, June, August,
October and December.
9. In the Value field, enter the event schedule's value.

© 2021 Delta Controls Inc. 75


Calendars and Schedules

10. In the Priority list, select the priority for this event schedule.
11. Click Save to add the recurring week and day event schedule to the schedule.

Adding a Recurring Date Event Schedule


1. Click Add Schedule. The Add Weekly/Event Schedule dialog opens.
2. In the Recurrence list, select Recurring Date.
3. In the Description field, enter a short phrase that describes this event
schedule.
4. Set the event schedule's start time in the left Time field.
5. Set the event schedule's end time in the right Time field.
6. Select the month that you want the event schedule to recur on, from the
Month list. Select Every when you want the event schedule to recur on all
months. Select Odd Months when you want the event schedule to recur on
January, March, May, July, September and November. Select Even Months
when you want the event schedule to recur on February, April, June, August,
October and December.
7. Select the date that you want the event schedule to recur on, from the Date
list. Select Every when you want the event schedule to recur on every day of
the month. Select Last when you want the event schedule to recur on the last
day of the month regardless of the date.
8. Select the year that you want the event schedule to recur on, from the Year
list. Select Every when you want the event schedule to recur on every year.
9. Select the weekday with the specified date that you want the event schedule
to recur on, from the Day list. Select Every when you want the event schedule
to recur on any weekday with the specified date.
If Every Year and a specific Day is selected, then the event schedule applies
only to the years when the specified date also occurs on the specified
weekday.
10. In the Value field, enter the event schedule's value.
11. In the Priority list, select the priority for this event schedule.
12. Click Save to add the recurring date event schedule to the schedule.

Adding a Calendar Reference Event Schedule


1. Click Add Schedule. The Add Weekly/Event Schedule dialog opens.
2. In the Recurrence list, select Calendar Reference.

76 enteliWEB 4.20 Operator Guide


Edition 1.0
Calendars and Schedules

3. In the Description field, enter a short phrase that describes this event
schedule.
4. Set the event schedule's daily start time in the left Time field.
5. Set the event schedule's daily end time in the right Time field.
6. Select or enter the name of the Calendar object.
7. In the Value field, enter the event schedule's value.
8. In the Priority list, select the priority for this event schedule.
9. Click Save to add the calendar reference event schedule to the schedule.

Editing a Schedule
1. Click Details to display information about all the schedules in a table.
2. Click the schedule's link in the Description column. The Edit Event Schedule
or the Edit Weekly Schedule dialog opens.
3. Change the settings as required.
4. Click Save to save the changes.

Deleting a Schedule
1. Click Details to display information about all the schedules, in tabular
format.
2. Select the schedule you want to delete. The Delete button becomes active.
3. Click Delete. You are prompted to confirm that you want to delete the
schedule.
4. Click Yes to delete the schedule.

Changing Schedule Configuration Properties


1. Click Setup to display the configuration properties.
2. Change as needed, the properties Name, Default Value, Start Date and End
Date.
3. Select Commissioned when appropriate.
4. Before you make changes to the Controlled Objects list, review the
information about Controlled Objects
5. Click Save to send the configuration to the object.

© 2021 Delta Controls Inc. 77


Calendars and Schedules

Schedule (SCH) Object (BACnet Revision 3) Concepts


About the BACnet Revision 3 Schedule Object
A weekly schedule is typically defines the facility's normal weekly equipment
operation or its occupancy hours. A weekly schedule time range repeats every
week, at the same times and days.
The BACnet Revision 3 Schedule (SCH) object describes a weekly schedule with
seven days that recurs during a range of dates.
Each day of the week contains up to eight time ranges when the schedule is in the
On state.
Portions of the day that are not covered by a time range are in the Off state.
When the schedule transitions to On or to Off, the SCH object writes the present
value to controlled objects that subscribe to the schedule.
You can associate one or two calendar (CAL) objects with the SCH object. The CAL
objects act as overrides to the SCH object. When a calendar day is On, then a
separate set of up to eight time ranges are in effect, regardless of the schedule
for that weekday.

Schedule (SCH) Object (BACnet Revision 3) Tasks


Adding a Time Range
1. In the drop-down list, select the weekday or calendar object that you want to
add the time range to.
2. Set the time range's start time by hour and minute in the On field. Select the
closest time from the list and then edit minutes to exact time.
3. Set the time range's end time by hour and minute in the Off field. Select the
closest time from the list and then edit minutes to exact time.
4. Click Add Time to add the time range to the schedule. The time range is
displayed on the schedule as a gray rectangle.

Adding a Calendar Object Reference


1. In the Event Schedules table, click Add. A row opens in the table.
2. Select the CAL object from the list.
3. Click Add to add the calendar object reference to the schedule.

78 enteliWEB 4.20 Operator Guide


Edition 1.0
Calendars and Schedules

Editing a Time Range


1. On the schedule, select the time range you want to change. The time range
changes color from gray to blue.
2. Change the On and Off settings as required.
3. Click Edit Time to save the changes.

Viewing Time Range Setting


To view the exact On time and Off time for a time range, move your mouse cursor
over the time range. The time range and duration are displayed.

Deleting a Time Range


1. On the schedule, select the time range you want to delete. The time range
changes color from gray to blue.
2. Click Delete Time. You are prompted to confirm that you want to delete the
time range.
3. Click OK to remove the time range from the schedule.

© 2021 Delta Controls Inc. 79


Trend Logs
This section covers the Trend Log object and the Multitrend object. This section
includes descriptions of the capabilities of the objects and provides all the tasks
you need to create, maintain, visualize and print trend logs via the object pages.

About the Trend Log Object


The Trend Log (TL) object collects samples that consist of a monitored object's
value and a corresponding timestamp. The samples are recorded in the internal
buffer memory of the TL object.
The TL object collects the samples either periodically on a fixed time interval or it
collects a sample when a significant change in the monitored object's value has
occurred.
To extend the TL object's limited sample storage capacity, you must use an
archiver (enteliVAULT, CopperCube, or Historian). The data samples are
transferred from the TL object memory to the archive, where the capacity is
unlimited.
The TL object page lets you visualize the samples on a line chart and view the
samples in tabular format.
The TL object page lets you download samples, in comma-separated values (CSV)
format, to a file.
When samples are stored in an archive, then the TL object lets you view that
archived data.

Viewing Sample Data


On the TL object page, the sample data is listed in the table and plotted on the
chart. The table also lists non-data samples or status messages such as Log
Enabled, Log Disabled, and so on.
The TL object detects when its samples are being stored in an archiver and
retrieves the samples to plot from the archiver rather than from the TL object
internal buffer memory.
You request the number of samples you want to view from the TL object by
entering that number in the Showing Samples field and then clicking Go.
You can change the chart time span by zooming in and zooming out.

80 enteliWEB 4.20 Operator Guide


Edition 1.0
Trend Logs

The sample data that is plotted on the chart can be downloaded in CSV format to a
file.

Chart Span Axis and the Time Span Axis


The example chart below, identifies and describes the time axes and the time
range adjusters.

Example Trend Log Chart

Legend
1 - The Chart Span axis displays the time range of the samples that are
plotted on the chart.
2 - The Time Span axis displays the entire time range of the samples that are
listed in the sample data table.
3 - The Time Span axis displays the time range of the samples that are
plotted on the chart, highlighted in blue.
4 - Time range adjuster that sets the earliest time for the Chart Span axis.
5 - Time range adjuster that sets the latest time for the Chart Span axis.
When this time range adjuster is positioned at the extreme right end of the
time range then the chart refreshes periodically with the most recent
samples. When this time range adjuster is positioned elsewhere in the time
range, the chart does not refresh.

Plotting COV Samples


When the monitored object provides an analog value and the TL object collects
samples based on change of value, then the following rules are applied when
plotting the line that joins the samples.

© 2021 Delta Controls Inc. 81


Trend Logs

l When the difference between two adjacent samples is greater than 1.5 times
the COV increment, then the points are joined by a step change line.
l When the difference between two adjacent samples is less than or equal to
1.5 times the COV increment, then the points are joined by a sloped line.
When more than one sample has the same time stamp then increments of one
one-hundredth of a second are added to the time stamps to differentiate them.

Archiving to Historian
Historian is a licensed ORCAview add-on that collects and archives trend log data
permanently in a standard SQL database. Data samples that are collected by
thousands of TL objects are collected by Historian over the BACnet network and
archived in its SQL database. Historian provides an opportunity to record, view,
analyze and manage data in ways that are not possible using the TL object and the
Multitrend (MT) object.

Data Archiving Design Goals


To achieve reliable data archiving, two design principles must be observed:
l Ensure no data is lost, that Historian doesn't miss samples
l Reserve Historian capacity for future or dynamic increases in data archiving
Data archiving reliability is affected primarily by two controller TL object settings:
l Max Samples which specifies the number of samples buffered by the
controller TL. Historian must collect the controller TL's new samples before
the buffer memory is full and the samples are overwritten.
l Log Type which specifies when a sample is collected from the monitored
object: by polling or by change of value (COV).
Clearly, a controller TL with a low Max Samples setting coupled with a frequent
Sample Interval setting or a monitored object with a low COV Minimum Increment
setting is a high usage TL and a candidate for experiencing data loss.
While a controller TL with Log Type set to Polling means a predictable and
constant sampling rate, a controller TL with Log Type set to COV means a dynamic
sampling rate. Depending on the COV Minimum Increment, rapid changes in the
monitored value generate more frequent samples that when the value is constant.
For example, a room temperature is relatively constant during occupied times but
may change rapidly when the space is scheduled to unoccupied and the
temperature conditioning is turned off.

82 enteliWEB 4.20 Operator Guide


Edition 1.0
Trend Logs

Therefore, the rapid change in temperature causes a controller TL with Log Type
set to COV to experience a sudden influx of samples in a short period. Historian's
scheduler may not be able to respond quickly enough to avoid data loss.

How to Avoid Data Loss

When Log Type is set to Polling


When Log Type = Polling, two controller TL object settings work together to
determine the number of samples collected: Max Samples and Sample Interval.
When controller memory is a limitation, you must increase the Sample Interval
setting to reduce the rate at which samples are collected. If you absolutely must
collect you sample at the high rate, then you must increase Max Samples to
allocate more sample buffering memory in the controller.

When Log Type is set to Change of Value


When Log Type = Change of Value, two settings work together to determine the
number of samples collected: the controller TL Max Samples settings and the
monitored object's COV Minimum Increment setting. When controller sample
buffering memory is a limitation, you must increase the COV Minimum Increment
setting to reduce the number of samples generated due to the rapid signal
changes. If you absolutely must monitor with a low COV Minimum Increment, then
you must increase Max Samples to allocate more sample buffering memory in the
controller.

Archiving to a CopperCube
A CopperCube is a licensed device from Delta Controls that collects and archives
trend log data permanently in a standard SQL database. Data samples from
thousands of TL objects are collected by CopperCube over the BACnet network
and archived in its SQL database.
A CopperCube provides a comprehensive user interface that lets you configure
trend log archiving and to manage data in ways that are not possible using the TL
object and the Multitrend (MT) object.
The same data archiving and design goals described for Historian apply for the
CopperCube.
Before you can view trend log data that is being archived on a CopperCube, you
must create a connection between enteliWEB and the CopperCube.

© 2021 Delta Controls Inc. 83


Trend Logs

Multiple CopperCubes
It is possible for multiple CopperCubes to be connected to the same BACnet
network and for those CopperCubes to be archiving samples from the same TL
object, to provide a degree of redundancy.
When you open the TL object page for a TL object that is being archived on
multiple CopperCubes, enteliWEB selects the CopperCube that has archived the
most samples for that TL object. The samples from the selected CopperCube
archive are displayed on the TL object page.
The TL object page does not select the CopperCube based on any other criteria
such as older samples versus newer samples and it does not merge archived
samples from multiple CopperCubes.

Archiving to enteliVAULT

This feature is only available for enteliCLOUD.

enteliVAULT collects and archives up to 50,000 TL objects from all sites created
on a single enteliCLOUD instance. The enteliVAULT archiving functionality is
available on enteliCLOUD instances that have purchased the enteliVAULT add-on
option.
Data samples are archived in a PostgreSQL database, and you access this data
using enteliWEB features such as the TL or MT object pages.
The same data archiving and design goals described for Historian and
CopperCube apply to enteliVAULT.

How enteliVAULT Collects Data Samples from Controller TL Objects


After the ranges are defined on the enteliVAULT Settings Rules page, enteliVAULT
automatically monitors the TL objects and collects new data samples.
enteliVAULT supports TL objects set to these Log Types: Polling, Change of Value
(COV), and Triggered.
In enteliVAULT 4.2 and later, data samples are collected according to the
following schedules:
l For Polling TLs, the collection schedule is based on half of the buffer full
time. For example, if the trend log has a 120 sample buffer and a 60 second
polling interval, the calculation is (120 * 60) / 2 = 3600 seconds, or every 60

84 enteliWEB 4.20 Operator Guide


Edition 1.0
Trend Logs

minutes.
l For COV or Triggered TLs, the collection schedule is based solely on the
buffer size. To avoid missing samples, it takes half the buffer size and uses
that in seconds. For example, if the trend log has a 120 sample buffer, the
calculation is 120/2 = 60 seconds, or every minute.
l For COV TLs with buffer-ready notification, data samples are collected as
soon as the buffer-ready notification is received over BACnet.

Trend Log Object Settings


Configuration

Name
Name specifies the name for the object.

Monitored Object
Monitored Object specifies the name of the object that you want the TL object to
collect samples from. By default, the TL object collects samples of the monitored
object's present value.
To monitor a property other than present value, specify that property name. For
example, 9100.AI1.Commissioned causes the TL object to collect samples of the
object's commissioned status.
When the collected samples are being archived by Historian, the Monitored Object
field is read-only.

When the Monitored Object datatype cannot be determined, the chart is


drawn based on sample data. When the sample datatype is
Real/Double/Signed/Unsigned then use Analog. When the sample
datatype is Boolean then use Binary. When the sample datatype is Enum
then use Multistate.

Log Type
Log Type specifies how the TL object collects samples.

© 2021 Delta Controls Inc. 85


Trend Logs

Polling

In the Polling method for collecting samples, the TL object collects a sample from
the monitored object periodically on a fixed time interval. The TL object collects a
sample regardless of whether or not the monitored object's value has changed.
For example, every minute.
Change of Value

In the Change of Value method for collecting samples, the TL object collects a
sample when it detects that the monitored object's value has changed by the
specified COV minimum increment or more. To detect that the monitored object's
value has changed, the TL object obtains the current value every database scan
and compares it to the value it obtained on the previous scan. When the monitored
object's value doesn't change significantly, no samples are collected.

Triggered

Historian does not support TL objects with Log Type set to Triggered.

In the Triggered method for collecting samples, the TL object collects a sample
from the monitored object when its Trigger property is set to True. The TL object
collects a sample regardless of whether or not the monitored object's value has
changed. The Trigger property remains True while the TL object is collecting the
sample and then it is returned to False by the TL object.
When the Trigger property is set to True while the logging type is either COV or
Polling, then no sample is collected based on the trigger. The Trigger property will
remain True until the logging type is set to Triggered, at which point a sample will
be taken and Trigger will be returned to False.

Sample Interval
Sample Interval specifies the time interval you want to elapse between samples
when Log Type is set to Polling.
When you select Daily, a sample is collected at 24 hour intervals, at the Start
Sampling at time.
When you select Interval, enter the time interval in the adjacent field in hours,
minutes and seconds. Sample interval range is from 00:00:01 second to 23:59:59
hours.

86 enteliWEB 4.20 Operator Guide


Edition 1.0
Trend Logs

Max Samples
When the TL object is not archiving to Historian or to a CopperCube, Max Samples
specifies the maximum number of samples you want to hold in the TL object's
buffer memory.
As a rough guide, each sample requires approximately 10 bytes of memory. For
example, when Max Samples is set to 100 then 1000 bytes of buffer memory is
used to store 100 data samples.
When the maximum number of samples are stored in the TL object memory then
the trend log is considered to be full. When the trend log is full, the next sample
overwrites the earliest sample unless you set Stop Sampling at to When Trend Log
is Full.
When the TL object is archiving to Historian, Max Samples is disabled. It displays
Unlimited.

Where Do Really Old Samples Go To?


In Version 3 firmware, samples that are older than 490 days are removed
automatically from the controller TL object memory on a weekly basis.
This does not apply to archive trend logs.
This behavior does not apply to Version 4 firmware. In V4, samples are
removed when the log buffer is full.

Start Sampling at
Start Sampling At specifies when the TL object will begin to collect samples.
When the Start Sampling At checkbox is cleared, the text "Specify Start Date" is
displayed. The TL object begins to collect samples immediately or when the
controller is reset or when the controller time changes.
To start sampling on a specific date and time, select the Specify Start Date
checkbox and configure the date and time when you want the sampling to begin.
When Log Type is set to Polling, the sampling start time affects when the TL
object polls for the sample. The TL object calculates the poll time using the
sampling start time and the Sample Interval setting. The table below provides
several examples of the behavior for determining when the poll occurs.

© 2021 Delta Controls Inc. 87


Trend Logs

Sample
Start Time Poll Times
Interval

0:00:00 15 minutes 0:00:00, 0:15:00, 0:30:00, 0:45:00, 1:00:00 and so


on
0:10:00 15 minutes 0:10:00, 0:25:00, 0:40:00, 0:55:00, 1:10:00 and so
on
0:00:00 1 hour 0:00:00, 1:00:00, 2:00:00, 3:00:00, 4:00:00 and so
on
0:30:00 1 hour 0:30:00, 1:30:00, 2:30:00, 3:30:00, 4:30:00 and so
on
0:00:00 2 hours 0:00:00, 2:00:00, 4:00:00, 6:00:00, 8:00:00 and so
on
1:00:00 2 hours 1:00:00, 3:00:00, 5:00:00, 7:00:00, 9:00:00 and so
on
17:00:00 24 hours every day at 17:00:00

Stop Sampling at
Stop Sampling At specifies when the TL object will stop collecting samples.
When the Stop Sampling At checkbox is cleared, the text "Specify End Date" is
displayed.
To stop collecting samples on a specific date and time, select the Specify End Date
checkbox and configure the date and time when you want the TL object to stop
collecting samples. When the Specify End Date checkbox is cleared, sample
collection continues indefinitely.
To stop collecting samples when the TL object has collected the number of
samples specified by Max Samples, select When Trend Log is Full.

88 enteliWEB 4.20 Operator Guide


Edition 1.0
Trend Logs

Trend Log (TL) Object Tasks

These Tasks Apply To TL Objects And To Archive TL Objects


The tasks described here apply to both controller TL objects and to
archive TL objects, unless otherwise indicated by the task.
See Archiving to Historian for a description of controller TL objects and
archive TL objects.

Configuring a Trend Log Object


This task applies to controller TL objects only.
1. Enter a name for the trend log. When the TL object is being archived by
Historian, changing the TL object name does not change the name of the
archive trend log.
2. In the Monitored Object field, select the object you want to collect samples
from, using the object picker.
To monitor a property other than present value, append the property to the
object name you selected from the list, separated by a decimal point.
For example:

Hot Water Supply Temp.MaxValue

Alternatively, enter the complete object reference and specify the property
name. For example, //MainSite/9100.AI1.MaxValue
3. Select the Log Type.
Select Polling when you want the TL object to collect samples at regular time
intervals. When you select Polling, the Sample Interval setting appears below
Start Sampling At to allow you to set the polling interval.
Select Change of Value when you want the TL object to collect a sample
whenever the change in the monitored object's value is greater or equal to its
COV minimum increment setting.
Select Triggered when you want the TL object to collect a sample when the
Trigger property is set to True.

Historian does not support TL objects with Log Type set to Triggered.

© 2021 Delta Controls Inc. 89


Trend Logs

4. Select Sample Interval. The Sample Interval setting is displayed when you
select Polling for the Log Type setting.
When you select Interval, enter the sampling or polling interval in the form
hh:mm:ss or choose it from the list.
5. Enter the maximum number of samples you want the trend log to hold.
6. Select when you want the TL object to start sampling:
l Clear the Start Sampling At checkbox to start immediately, or
l Select the Specify Start Date checkbox to set a date and time to start
sampling.
7. Select when you want the TL object to stop sampling:
l To set a specific date and time, select the Specify End Date checkbox
and enter the date and time, or
l To stop sampling when the TL object reaches the maximum number of
samples, select When Trend Log is Full, or
l To have sampling continue forever and never stop, clear all checkboxes.
8. Select Commissioned when appropriate.
9. Click Save to send the configuration to the object.

Updating Sample Data Manually from the TL Object


1. Set the Showing Samples field to the number of samples that you want to
retrieve from the TL object.
2. Click Go. A progress bar appears adjacent to the Go button.
When the update is completed, the progress bar is removed.

Updating Sample Data Automatically (Refresh) from the TL Object


To set the chart to be refreshed periodically with the most recent samples,
position the time range adjuster at the extreme right end of the time range.

Triggering a Sample to be Logged


To use this procedure, Log Type must be set to Triggered.
1. Click Trigger and then click Save. The message Trigger = true is displayed in
the History pane.
2. Click Go to update the sample data on the TL object page.

90 enteliWEB 4.20 Operator Guide


Edition 1.0
Trend Logs

Zooming In the Chart View


1. Method A: Click and drag the mouse cursor over the chart to highlight the
time range you want to expand. Release the mouse and the chart timeline
expands to display only the selected time range.
2. Method B: Click and drag the time range adjusters to the earliest and latest
times you want to view on the chart. The chart plot adjusts to display only the
samples that were collected between those times.
For example, as shown below, the time range adjusters set the earliest time
to 06:40 and the latest time to approximately 07:20.

Zooming Out the Chart View


This procedure operates over the range of samples you requested from the TL
object when you clicked Go. To view earlier samples, increase the Showing
Samples setting and click Go.

1. Method A: Click to zoom out to display all the samples that you obtained
from the TL object. When this button is not displayed, the chart is displaying
all the samples as specified by the Showing Samples setting.
2. Method B: Position the time range adjusters to the earliest and latest times
you want to view on the chart. The chart plot adjusts to display only the
samples that were collected between those times.

Locating a Specific Sample on the Chart From the Table


1. Select the row in the sample table that you want to locate on the chart.
2. A vertical dark blue dotted line appears on the chart to mark the timestamp
of the row you selected. The chart also attempts to center its plot on that
data sample.

© 2021 Delta Controls Inc. 91


Trend Logs

Viewing Sample Data from the Chart


1. Move your mouse cursor over the chart.
2. When the mouse cursor passes near a sample, the sample value is displayed
adjacent to the data point and the associated timestamp is displayed on the
Chart Span axis.

Displaying the Sample Data Table


1. Click Show Sample Data. The sample data table is displayed.
2. Set Showing Samples to the number of samples you want to display in the
sample data table and in the chart. Set Showing Samples to the maximum
value to display all the samples in the TL object.
3. Click Go to update the sample data table and chart with current samples
from the TL object. When the Showing Samples setting is less than the Max
Samples setting, the most recent samples are displayed.

Changing the Sample Table View


1. To order the samples by time, click the Time column heading. On each click,
the Sample Data table alternates between earliest to latest sample and latest
to earliest sample.
2. To order the samples by value, click the Value column heading. On each click,
the Sample Data table alternates between sort ascending and sort
descending.
3. To reverse the positions of the columns, click a column heading and drag it to
the new position.
4. To view only values or only times in the sample table, hold the pointer over
either column heading to display the drop-down menu indicator.

Click the menu indicator to display the selection menu. Select Columns
from the menu then select or clear a checkbox to add or remove a column.
5. Clear the Include Non-Data Samples checkbox to remove all the non-data
samples from the sample data table. The non-data samples are not deleted
from the TL object memory.

Viewing Non-Data Samples


The TL object collects non-data samples or status messages such as Log Enabled,
Log Disabled and so on.

92 enteliWEB 4.20 Operator Guide


Edition 1.0
Trend Logs

1. Set Showing Samples to the maximum value and click Go to upload all
samples from the TL object.
2. Select Include Non-Data Samples to list both the sample data and the non-
data samples in the sample data table.
3. Sort the Value column as Sort Descending. When the data samples are
numeric, the non-data samples are all displayed at the top of the Value
column. When the data samples are text, you need to scan the Value column
for groups of non-data samples.

Printing the Chart

Click to begin. Follow your browser's print dialogs to complete.

Deleting Sample Data from a TL Object


This task applies to controller TL objects only.
1. Click Delete Sample Data to delete all samples from the TL object memory.
2. Click Save to confirm that you want to complete this operation or click
Delete Sample Data again to cancel the operation.

Multitrend (MT) Object Concepts


The Multitrend (MT) object lets you visualize the samples that have been collected
and stored by Trend Log (TL) objects, in line chart format.
The MT object plots the samples of up to eight TL objects. The MT object can
obtain samples from the following sources:
l TL object memory on the device
l CopperCube archive of a TL object
l Historian archive of a TL object
The MT object page includes several features that allow you to arrange the chart
to display the samples for the time range window you want and to move or pan
your view both forward and backward along the time range window.
TL objects that are trending a Bitstring data type are accepted by the MT object
but the trend log data is not plotted.

© 2021 Delta Controls Inc. 93


Trend Logs

Chart Options
Two settings, View Samples and Time Span, together, allow you to set the time
range window for the samples that the MT object loads from the TL objects and
that you can view on the chart. The pan and zoom functions are constrained to
operate in this time range window.
View Samples / Most Recent allows you view new samples as they are collected by
the TL objects. Then, Time Span lets you set the time interval in the past that you
want to view samples for.
View Samples / Go To sets the time at the start of the time axis. Then, Time Span
lets you set the width of the time range window.
Adjusters on the chart allow you to move the time range window in increments of
the Time Span setting.

Time Span Axis and the Chart Span Axis


The Time axis displays two scales: the chart span axis and the time span axis.
The chart span axis displays the time line of the samples that visible and are
plotted in the chart.
The time span axis displays the time line for all of the samples that the MT object
loaded from the TL objects. The View Samples and the time span settings
determine what samples are loaded.
When you zoom and pan, the chart span axis time line changes and the time span
axis doesn't. However, the chart span time line is highlighted in blue on the time
span axis. The two time adjusters mark the earliest and latest times of the chart
span time line, on the time span axis.
The example below identifies the chart span axis, the time span axis and the time
range adjusters.
Time Span Axis and the Chart Span Axis

Legend

1 - The chart span axis with zoom in applied


2 - The time span axis when Time Span is set to 24 Hours.

94 enteliWEB 4.20 Operator Guide


Edition 1.0
Trend Logs

3 - The time span axis displays the chart span axis time range highlighted in
blue.
4 - Time range adjuster that sets the earliest time for the chart span axis.
5 - Time range adjuster that sets the latest time for the chart span axis.
When this time range adjuster is positioned at the extreme right end of the
time range then the chart refreshes periodically with the most recent
samples. When this time range adjuster is positioned elsewhere in the time
range, the chart does not refresh.

Legend
The legend, which is located above the chart, displays the names of the objects
that are monitored by the TL objects and the colors of their plots.
If the monitored object has a property appended to the object name, that object
and property combination name is displayed in the legend.
When a TL object resides on a remote device rather than on the device with the MT
object, then the remote device's address is shown as a prefix to the object name.
The legend may be displayed in up to four groups as follows:
Left - objects are associated with the y-axis scale on the left side of the plot
Right - objects are associated with the y-axis scale on the right side of the
plot
Digital - objects are associated with TL objects that contain two-state
samples
Multistate - objects are associated with TL objects that contain multi-state
samples

Plotting COV Samples


When the monitored object provides an analog value and the TL object collects
samples based on change of value, then the following rules are applied when
plotting the line that joins the samples.
l When the difference between two adjacent samples is greater than 1.5 times
the COV increment, then the points are joined by a step change line.
l When the difference between two adjacent samples is less than or equal to
1.5 times the COV increment, then the points are joined by a sloped line.
When more than one sample has the same time stamp then increments of one
one-hundredth of a second are added to the time stamps to differentiate them.

© 2021 Delta Controls Inc. 95


Trend Logs

Plotting Large Number of Samples


When a TL object holds more than 5000 samples, the sample density is reduced or
thinned before it is plotted. For example, when TL object has 15000 samples,
every third sample is plotted. When the sample density is reduced, a warning is
displayed.

Multitrend (MT) Object Configuration Reference


Expand Chart
When this option is selected, the chart expands to fill the browser window.

Include Non-Data Samples


Non-data samples, like status and time change messages, cannot be plotted on
the chart. For example, status messages like Log Enabled and Log Disabled.
This option lets you include or remove non-data samples from the chart data.
When removed, the non-data samples no longer appear in the downloaded CSV
file.

Chart Options

View Samples
Most Recent

Most Recent specifies that you want the chart to be dynamic and to always
displays new samples collected by the TL objects. Data is refreshed every minute.
Go To

Go To lets you set the time and date at the start of the chart's timeline.

Time Span
Time Span specifies the time interval that you want to view data samples for. That
is, it sets the maximum extent of the chart's timeline.

96 enteliWEB 4.20 Operator Guide


Edition 1.0
Trend Logs

Values

Monitored Object
Displays the name of the object being monitored by the trend log. Both the trend
log and its monitored object share the same color reference.

Value
This column displays the latest object value from the chart in the selected time
range.

Min / Last Off


For trend logs that monitor analog objects, the column displays the smallest value
in the trend log data.
For trend logs that monitor binary objects, the column displays the time stamp of
the last time the object had OFF value.
This column is blank for trend logs with enumerated data types.

Max / Last On
For trend logs that monitor analog objects, the column displays the largest value
in the trend log data.
For trend logs that monitor binary objects, the column displays the time stamp of
the last time the object had ON value.
This column is blank for trend logs with enumerated data types.

Average / On Time
For trend logs that monitor analog objects, the column displays the calculated
average value in the data.
For trend logs that monitor binary objects, the column displays the total time the
object spent in the ON state.
This column is blank for trend logs with enumerated data types.

Units
Displays the units used by the monitored analog object value. For binary objects,
this column displays the active and inactive states.

© 2021 Delta Controls Inc. 97


Trend Logs

Trend Setup

TL Reference
TL Reference specifies the local or remote TL objects that you want to view data
samples from. The TL objects are listed by their names. Each name is a link to the
TL object.
When a referenced TL object is deleted, it remains on the TL Reference list as a
TL object reference, for example, 1000.TL5, with no link.
TL objects that are trending a Bitstring data type are accepted but the trend log
data is not plotted by the MT object.

Axis
Left and Right specify, for analog values, which y-axis, Left or Right, has the
corresponding label and unit of measure.
Digital specifies, for two-state values, that the Digital area of the chart is to be
used for the plot.
Multistate specifies, for multi-state values, that the Multistate area of the chart is
to be used for the plot.

Color
Color specifies the color of the line on the chart for the TL object samples.

Configuration

Name
Name specifies the name of the MT object.

Left Y Axis Label


Left Y Axis Label specifies the text that is displayed as a label for the y-axis on the
left side of the chart.

Left Y Axis Minimum Value


When the checkbox is selected, Left Y Axis Minimum Value specifies the lowest
value that is displayed on the y-axis scale on the left side of the chart.
When the checkbox is not selected, the charting software determines an
appropriate value.

98 enteliWEB 4.20 Operator Guide


Edition 1.0
Trend Logs

Left Y Axis Maximum Value


When the checkbox is selected, Left Y Axis Maximum Value specifies the highest
value that is displayed on the y-axis scale on the left side of the chart.
When the checkbox is not selected, the charting software determines an
appropriate value.

Right Y Axis Label


Right Axis Label specifies the text that is displayed as a label for the y-axis on the
right side of the chart.

Right Y Axis Minimum Value


When the checkbox is selected, Right Y Axis Minimum Value specifies the lowest
value that is displayed on the y-axis scale on the right side of the chart.
When the checkbox is not selected, the charting software determines an
appropriate value.

Right Y Axis Maximum Value


When the checkbox is selected, Right Y Axis Maximum Value specifies the highest
value that is displayed on the y-axis scale on the right side of the chart.
When the checkbox is not selected, the charting software determines an
appropriate value.

Reliability Evaluation Inhibit


The Reliability Evaluation Inhibit checkbox, when selected, specifies that the
object does not evaluate its condition and does not update Reliability. Reliability is
set to No Fault Detected.
When the Reliability Evaluation Inhibit checkbox is not selected, the object
evaluates its condition and updates Reliability.

Commissioned
The Commissioned checkbox, when selected, specifies that the object has been
field commissioned.
The Commissioned checkbox, when not selected, specifies that the object is not
field commissioned.

© 2021 Delta Controls Inc. 99


Trend Logs

The Not Commissioned icon is displayed for an object that is not


commissioned.

Multitrend (MT) Object Tasks


Configuring a Multitrend Object - Main Steps
1. Add the TL object that you want to view samples from, as described in Adding
A Trend Log Object to the MultiTrend Object Chart.
2. Adjust the View Samples and Time Span settings to load the data samples
you want to plot from the TL objects, as described in Setting the Time Span.
3. The changes that you make will take effect immediately.
4. Enter the y-axes labels and the axes maximums and minimums.
5. Click Save to send the configuration to the MT object.

Adding a Trend Log Object to the Multitrend Object Chart


1. In the area titled Trend Setup, click Add. The Edit Settings dialog opens.
2. Enter the TL Reference, as follows:
l By the object name. Enter a letter or number contained in the name of
the object. enteliWEB builds and displays a list of matching objects.
Choose the object you want from the list. This field is an object picker.
See About the Object Picker for information about a field that is an
object picker.
l By the object reference number. For example, 9100.TL1 or just TL1
when the TL object is local.
3. Select the Axis that pertains to the type of data samples that the TL object
collects.
4. Select the line color you want for the plot of the data samples.
5. Click OK to add the TL object to the chart. The chart refreshes immediately to
plot the TL object's data samples on the chart. The name of the monitored
object is added to the legend above the chart.
When the TL object's samples are not displayed, consult the History log to
determine the reason.

100 enteliWEB 4.20 Operator Guide


Edition 1.0
Trend Logs

Setting the Time Span to Always View New Samples


1. In Chart Options, select Most Recent.
2. Select the Time Span from the list to set how far in the past you want to view.
The Time Span axis is updated immediately.

Setting the Time Span to View Samples in the Past


1. In Chart Options, select Go To.
2. Select the time and date that you want to set at the start of the time axis and
click Go.
3. Select the Time Span from the list. Time Span sets the entire range of the
axis.
The Time Span axis is updated immediately.

Updating Sample Data Automatically (Refresh) from the TL Objects


To set the chart to be refreshed periodically with the most recent samples,
position the time range adjuster at the extreme right end of the time range.

Zooming In the Chart View

1. Method A: Click to enable Zoom mode. Click and drag the mouse cursor
over the chart to highlight the time range you want to expand. Release the
mouse and the chart timeline expands to display only the selected time
range.
2. Method B: Click and drag the time range adjusters to the earliest and latest
times you want to view on the chart. The chart plot adjusts to display only the
data samples that were collected between those times.
For example, as shown below, the time range adjusters set the earliest time
to 02:00 and the latest time to 06:00.

© 2021 Delta Controls Inc. 101


Trend Logs

Panning the Chart View


The panning function described here operates over the data samples that the MT
object has loaded from the TL objects. It is similar to moving both time range
adjusters in the same direction.
1. Zoom in the chart.

2. Click to enable Pan mode.


3. Click the mouse cursor on the chart and drag left to view later data samples
or drag right to view earlier data samples, from the data samples.

Loading and Viewing Adjacent Earlier or Later Data Samples

1. Click to zoom out to display all the data samples that the MT object
loaded from the TL objects. When this button is not displayed, the chart is
already displaying all the data samples that were loaded from the TL objects.
2. Click to load the adjacent later data samples for the interval specified by
Time Span.
3. Click to load the adjacent earlier data samples for the interval specified by
Time Span.

Zooming Out the Chart View

1. Method A: Click to zoom out to display all the data samples that the MT
object loaded from the TL objects. When this button is not displayed, the
chart is already displaying all the data samples that were loaded from the TL
objects.
2. Method B: Position the time range adjusters to the earliest and latest times
you want to view on the chart. The chart plot adjusts to display only the
samples that were collected between those times.

Viewing Sample Data from the Chart


1. Move your mouse cursor over the chart.
2. When the mouse cursor passes near a sample, the sample value is displayed
adjacent to the data point and the associated timestamp is displayed on the
Time axis.

102 enteliWEB 4.20 Operator Guide


Edition 1.0
Trend Logs

Removing and Restoring a TL Object Plot from the Chart


Temporarily

Removing a TL Object Plot from the Chart Temporarily


In the area titled Trend Setup, clear the checkbox that is adjacent to the TL object
you want to remove from the chart. The plot for that TL object is no longer
displayed on the chart.

Restoring a TL Object Plot to the Chart


In the area titled Trend Setup, select the checkbox that is adjacent to the TL object
you want to restore to the chart. The plot for that TL object is displayed on the
chart.

Printing the Chart

1. Click to begin.
When using Chrome as your browser, a preview page opens and displays the
chart that will be printed.
When the preview displays the chart in grayscale and you want color, then
select a color printer as the destination printer and select Background colors
and images.
2. Follow your browser's print dialog to complete the printing.

Downloading Data Samples to CSV File


The CSV (Comma Separated Values) file contains data samples for the time
interval defined by the Time Span setting.
The name of the CSV file is of the form MT_<MT object name>.csv. Characters that
are not allowed in a filename are removed from the MT object name.
1. Adjust Time Span for the time interval of the data samples that you want to
export. Wait for the samples to be retrieved from their sources.

2. Click to begin the download process. Please wait. There is no visible


change immediately to the user interface.
3. Eventually your browser prompts you to save the CSV file.

© 2021 Delta Controls Inc. 103


Trend Logs

Delimiters used in CSV file are based on locale of user who downloads
the samples. User who imports the CSV into Excel must use same locale.

Importing Sample Data in CSV file into Excel


Follow the Importing CSV file into Excel procedure to ensure that special
characters such as unit symbols are converted correctly.
User who is importing CSV into Excel must use same locale as user who
downloaded samples to CSV file.

104 enteliWEB 4.20 Operator Guide


Edition 1.0
Alarms and Events
About Delta Controls' Event Management System
Delta Controls' event management system conforms to ASHRAE Standard 135 and
adds proprietary features that enhance event management across sites.
In Delta's system, standard BACnet event management objects are given the
following abbreviations (not defined in the standard).

Object Name Delta Object Abbreviation


Event Enrollment object EV
Notification Class object EVC
Event Log object EVL

The following diagram depicts the main components of Delta's event management
system.

© 2021 Delta Controls Inc. 105


Alarms and Events

Legend
1. User manages alarms with enteliWEB using the Alarm List page and the
Notification History window.
2. LAN, WAN, or cloud
3. User receives alarm notifications via email
4. Historian server logs and archives alarm notifications
5. BACnet network
6. In this example, the EV object detects the alarm condition in the monitored
object, the AI object.
The EVC object sends a notification over the network.
7. In this example, the intrinsic alarming function of the object, the AI object,
detects the alarm condition. The EVC object sends a notification over the
network.
8. enteliWEB server
9. enteliWEB's alarm and event management system
10. Alarm list
11. Notification history
12. Alarm groups
13. Alert rules
14. Log
15. TCP/IP network
16. SMTP server, needed for emailing alarm notifications

Sequence of Steps in Event Management


The following example describes the sequence of steps that occurs when the
event management system detects and reports an alarm condition.
A room temperature is monitored and an alarm is reported when the room
temperature becomes too high or too low. An AI object obtains the room
temperature from the room temperature sensor. An EV object monitors the AI
object's value. The EV object is configured with the parameters for what the
reasonable temperature limits are for this room.
Alternatively, instead of using an EV object, the AI object's intrinsic alarming
capability could be used to monitor the room temperature. That is, the AI object
would be configured with the parameters for what the reasonable temperature
limits are for this room.

106 enteliWEB 4.20 Operator Guide


Edition 1.0
Alarms and Events

At 72°F (22.2°C), the room temperature is acceptable. However, if the room


temperature rises to 85°F (29.4°C), the room is clearly too hot and this condition
must be reported.
The EV object recognizes the alarm condition and reports it by notifying the
associated EVC object.
The EVC object prioritizes the event according to its importance and then sends a
notification message over the BACnet network so other controllers and the
operator work station can act on it.
At this point the AI, EV, and EVC objects have done their jobs by reporting the
alarm to the rest of the system. Now, depending on the destinations that are
configured in the EVC object's recipient list, the following actions may occur:
l an EVL object on a controller records the alarm in its local log
l an EVL object on a Historian server records the alarm in its SQL database
l enteliWEB adds the alarm to its alarm list and notifies one or more users
who are logged in
l enteliWEB sends a message by email to notify other users about the alarm
l an enteliWEB user manages the alarm to ensure that the condition that
caused the room temperature to rise is fixed
l an enteliWEB user acknowledges the alarm if that is required

Detecting Alarm Conditions


The ASHRAE standard specifies the event algorithms that can be used to detect
alarm conditions. Delta Controls has implemented most of these algorithms in the
EV object and in the objects that support intrinsic alarming.
Delta Controls recommends the following event algorithms for alarm detection.

Out of Range
The out of range algorithm asks: "Is the analog input or value in its normal range
between fixed limits?" A setpoint is not involved.
If the input or value is not in the normal range, a high limit or low limit alarm is
generated.

© 2021 Delta Controls Inc. 107


Alarms and Events

Illustration: Out of Range (time represented by x-axis)

Legend
 High Limit Alarm   Normal   Low Limit Alarm   Input 

Floating Limit
The floating limit algorithm asks: "Is the analog input close to the setpoint?" Or, in
the case of the Loop (CO) object: "Is the error between the input to the loop and
the setpoint small enough?"
If the input is not in the normal range with respect to the setpoint, a high limit or
low limit alarm is generated.

108 enteliWEB 4.20 Operator Guide


Edition 1.0
Alarms and Events

Illustration: Floating Limit (time represented by x-axis)

Legend
 High Limit Alarm   Normal   Low Limit Alarm   Input   Setpoint 

Change of State
The change of state algorithm asks: "Is the binary input or binary value on or off?"
Or: "Is the multi-state input or multi-state value equal to the expected state?"
If the input or value is not in the expected state, an alarm is generated.

Illustration: Change of State to On (time represented by x-axis)

Legend
 Alarm   Normal   Input  1 = On state  0 = Off state 

© 2021 Delta Controls Inc. 109


Alarms and Events

Illustration: Change of State to Off (time represented by x-axis)

Legend
 Alarm   Normal   Input  1 = On state  0 = Off state 

Command Failure
The command failure algorithm asks: "Is the status reported by a binary or multi-
state input equal to the state of the binary or multi-state control signal?"
If the status is not in the same state as the control signal, an alarm is generated.

Illustration: Command Failure (time represented by x-axis)

Legend
 Alarm   Normal   Status   Control  1 = On state  0 = Off state 

Buffer Ready
The buffer ready algorithm asks: "Is the logging object recording samples as
expected?" This algorithm is only supported in intrinsic alarming and intrinsic
event reporting.
The buffer ready causes the object to report when the specified number of
samples have been recorded since the last notification. The buffer ready event
generates To-Normal transitions only.

110 enteliWEB 4.20 Operator Guide


Edition 1.0
Alarms and Events

Prioritizing Events and Alarms in the Delta System


In the Delta Controls system, the Notification Class (EVC) object is responsible for
setting the importance or priority of the event or alarm.

Categorizing Events with the EVC Object


The EVC object allows the many events that a building automation system
generates to be grouped into categories. Each category takes its name from the
name of an EVC object.
The database in a Delta Controls controller has the following predefined EVC
objects:

EVC Name Object Reference


Maintenance EVC1
Network EVC2
Security EVC3
Critical EVC4
Notification EVC5
Fire EVC6
Access Control Event EVC7
Access Control Alarm EVC8
Archival EVC9
Diagnostics EVC10
Fault Monitoring EVC11

Additional EVC objects can be created to allow better alarm filtering or for
specialized needs. For example, a building automation system consisting of
multiple buildings often benefits from having unique notification classes for each
building. If new EVC objects are added, however, they must be added to every
controller on the network.
The EVC object also lets you set an individual BACnet priority for each of the three
event transitions: To Alarm, To Fault, and Return to Normal. The BACnet priority
provides enteliWEB with an alternative to the Delta notification class categories,
for prioritizing alarms.

© 2021 Delta Controls Inc. 111


Alarms and Events

Prioritizing Alarms with Alarm Groups


Alarm prioritization takes place when the alarm notification reaches enteliWEB.
enteliWEB determines the priority from the alarm groups you create and
maintain. An alarm group is assigned a combination of notification classes and
BACnet priority numbers.
The order that the alarm groups are listed on the Alarm Settings page determines
their relative priorities.

Managing Events and Alarms


Presenting Active Alarms to a User
See Alarm List Concepts for information about enteliWEB's capabilities for
managing events and alarms.

Annunciating an Alarm to a User


enteliWEB provides a range of capabilities for annunciating the alarm notification
to the user.
See About Alarm Notifications for that information.

Acknowledging Alarms
The acknowledge settings in the EVC object determine if someone has to
acknowledge the alarm when it occurs. The EVC object lets you set an individual
acknowledge requirement for each of the three event transitions: To Alarm, To
Fault and Return to Normal. Typically, Return to Normal does not require an
acknowledgment.
The acknowledge settings in the EVC object are particular to each controller. For
consistent system behavior, the acknowledge settings for a given notification
class must be kept the same in all controllers.

Logging Events and Alarms


Event and alarm logging is performed by an Event Log (EVL) object. An EVL object
on a controller can keep a history of recent alarms only, due to the memory
limitations of the controller.
An EVL object on a Historian server can archive an unlimited history of alarms.

112 enteliWEB 4.20 Operator Guide


Edition 1.0
Alarms and Events

Archiving Events and Alarms


Historian is a licensed Delta Controls software application that maintains a data
archive for alarms and events in an SQL database. Historian stores data for an
unrestricted period of time and allows users to record a large dataset.
To record alarm events, Historian uses an Event Log object named EVL1 which
records all non-access control events via Notification Class objects (EVCs) 1
through 6. These six EVC objects correspond to the alarm classes: Maintenance,
Network, Security, Critical, Notification, and Fire.
Additional EVL objects can be created on the Historian computer and linked to an
EVC object. All events recorded by these EVL objects are stored directly in the
Historian database.
To view the contents of Historian's alarm database, use the EVL1 object's dialog.

Alarm and Alert List Concepts


About the Alarm and Alert List
The Alarm and Alert List page provides all the tools you need to manage the alarm
notifications and alerts that are reported to the enteliWEB alarm and alert
management system. This page also displays system messages.
In this and related topics, the term "alarm list" refers to the list of alarms, alerts,
and system messages on the Alarm and Alert List page.
The alarm list displays active alarms that have been reported by objects in devices
on a BACnet network. Alarms are reported when the object that detects a problem
generates an alarm notification that is sent over the BACnet network.
The alarm list reflects only the alarm notifications that reach enteliWEB.
Therefore, the definitive source for active alarms remains in the objects.
For background information about the enteliWEB event management system, see
Event Management System Concepts.
On the Alarm and Alert List page, you can perform the following tasks:
l Acknowledge one or multiple alarms
l Search the alarm list based on text
l Filter the alarm list based on text
l Filter the alarm list based on numerous criteria
l Create reusable filters based on numerous criteria

© 2021 Delta Controls Inc. 113


Alarms and Events

l Flag one or multiple alarms for specific treatment


l Assign one or multiple alarms to a user
l Add notes to one or multiple alarms
l View trend log plot
l View the alarm history
l View related objects
l Configure the emailing of alarm or alert notifications to users or groups of
users
l Update the alarm list from the source devices
l Remove one or multiple alarms from the alarm list
l Save alarm list as PDF or as CSV file
See Alarm and Alert List Tasks for the detailed procedures.

What is an active alarm?


When a problem is detected by the building automation system, such as a room
temperature that is too high or a freeze stat that is tripped, an alarm notification
is generated and sent to enteliWEB over the BACnet network. enteliWEB notifies
the user and places the alarm in the alarm list.
An alarm is active, and therefore remains on the alarm list, when one or both of
the following conditions is present:
l The building automation system component that is reporting the problem is
currently in an alarm state or fault state.
l The building automation system component no longer has the problem and is
currently in a normal state, but was previously in an alarm state or fault
state that was not acknowledged.
An alarm notification is generated by an Event Enrollment (EV) object, by an EV
object that is associated with the monitored object, or by the monitored object
itself when it supports intrinsic reporting.
An alarm notification can also be generated by a custom module.

What is an alert?
When a problem is detected with an enteliWEB subsystem in the enteliWEB
server, an alert notification is generated. An alert is an alarm that reports an
internal problem, rather than an alarm that reports a problem from the building
automation system over the BACnet network.

114 enteliWEB 4.20 Operator Guide


Edition 1.0
Alarms and Events

In addition, an application module that has been implemented with the enteliWEB
API can generate alerts.
The Alarm and Alert List page lets you manage alerts in the same way that you
manage alarms.

What is a system message?


When a device detects a network issue, such as a circular network or multiple
devices with the same device number, it generates a system message and sends it
over the network. To view a system message, in the left navigation pane, click
Alarms > Alerts > System. System messages are also displayed in the alarm
notification history window and are recorded in the log.
System messages do not need to be acknowledged. Like other alarm/alert
notifications, they can be assigned to a user for investigation. System messages
that are not assigned to a user are deleted after 24 hours.

What is a filter?
Perhaps the most powerful feature of the Alarm and Alert List page is its filtering
capability. You can narrow down the list of alarms by specifying criteria that an
active alarm must match to appear in the alarm list.
You can create any number of filters to allow you focus quickly on the alarms you
are interested in, such as critical alarms, alarms assigned to you, alarms from
certain devices and so on.
A filter also governs some aspects of the treatment of the alarms such as visual
notifications and email notifications.

How do you extinguish an alarm?


To extinguish an alarm and remove it permanently from the alarm list you must
resolve the condition or conditions that make the alarm an active alarm.
If the alarm requires an acknowledgment, then you must acknowledge it.
If the component that has the problem is in either an alarm state or the fault state
currently then you must correct the problem to allow the component to return to
the normal state.

When happens to an alarm when it is no longer active?


When an alarm is no longer active, it is placed in the enteliWEB log. To view the
enteliWEB log, select the Log section from the left navigation pane.

© 2021 Delta Controls Inc. 115


Alarms and Events

How the Alarms and Alert List Page Is Organized


The Alarm and Alert List page is organized to allow for many different alarm
management styles and approaches.
The following illustration identifies the functional components and their location.

Legend

1 - Source for alarms


2 - Command list
3 - Search
4 - Filter and Manage Filters dialog buttons, Save as PDF or CSV buttons
5 - Quickbar
6 - List of active alarms
7 - Alarm flags, Assign to, and Notes
8 - Trend log plot
9 - History

116 enteliWEB 4.20 Operator Guide


Edition 1.0
Alarms and Events

10 - Related Items
11 - Page Selection and Refresh

Source for Alarms


The alarms that are listed on the Alarm and Alert List page come from the one
source that you select in the Alarms section of the left navigation pane or from the
source or sources you configure in the advanced filter.
The Alarms section of the left navigation pane lists the following types of sources,
in tree view format:
l Network (which consist of sites)
l Alerts
l Views
The advanced filter allows you configure the following types of sources:
l Multiple sites
l Multiple systems/views
l Range of device addresses
l Types of objects

Command List
The Command list allow you to select from the following commands.
Acknowledge

The Acknowledge command sends an acknowledgment indication to the devices


for the alarms that you have selected from the alarm list. You are prompted to add
an acknowledge message. The execution of this command is recorded in the
enteliWEB log with a separate log record for each alarm that was acknowledged.
Acknowledge All

The Acknowledges All command sends an acknowledgment indication to all


devices in the alarm list that require an acknowledgment. You are prompted to
add an acknowledge message. The execution of this command is recorded in the
enteliWEB log with a separate log record for each alarm that was acknowledged.
Delete Alarm

The Delete Alarm command deletes the selected alarms from the alarm list.

© 2021 Delta Controls Inc. 117


Alarms and Events

When you delete an alarm from the alarm list, you are deleting it from
enteliWEB's internal list of active alarms. You are not acknowledging the alarm
and you are not changing the alarm state of the source object.
Therefore, when you update the alarm list, the alarms that you deleted are listed
again in the alarm list.
Update Alarms

The Update Alarms command discards the current alarm list that is held in the
BACnet Server and reloads the active alarms from all devices and objects on the
network.

Search
The search lets you narrow down the number of active alarms that are displayed
in the alarm list.
Search matches the text fragment you enter with any occurrence of that fragment
in any field in an alarm notification, for the active alarms that are listed.
For example, enter temp in the search field to view only the active alarms in the
list in which temp or words that include the letters temp appear in the alarm
notification or in associated information such as alarm flags, assign to and notes.

Filter and Manage Filters Dialog Buttons


Filter

The Filter dialog lets you search based on information in certain fields of an active
alarm. You can save the filters that you use regularly.
The Filter dialog is where you can create filters and apply them against the active
alarm list to test them.
The Filter dialog is hidden when it is not being used.
The filter button allow you to open the Filter dialog and the Manage Filter dialog.
To indicate that the displayed alarm list is a filtered view, the Filter button is
highlighted as follows: Filtered.
Advanced Filter Dialog

The Advanced Filter dialog lets you create a BACnet network-oriented filter to
filter across multiple sites, by device range, system and object type.
The Advanced Filter dialog is included as an option in the Filter dialog.

118 enteliWEB 4.20 Operator Guide


Edition 1.0
Alarms and Events

Search, Filter, and Quickbar filters are logically ANDed


When multiple filters are activated, then the alarm list displays only the
active alarms that meet the filter settings of all of the activated filters.
That is, search, filter and quickbar are logically ANDed.

Manage Filters

The Manage Filters dialog allows a user to view and change the filter setting and
attributes of saved filters, depending on the user's permissions. Administrative
users are granted more capabilities than non-administrative users.
The Manage Filters dialog allows administrative users to assign filters to users
and groups and to subscribe users and groups to receive alarm notification
emails.
See Managing Filters for information about filter management capabilities for
administrative and non-administrative users.

Save as PDF or CSV File Buttons

The button lets you save the active alarms in the list to a file in PDF format.

The button lets you save the active alarms in the list to a file in CSV (Comma-
Separated Value) format.

Quickbar
The Quickbar pane holds the filters that you use frequently, which lets you activate
and deactivate them with a click. An activated filter is displayed with highlighting,
as for example, Today's Alarms. The Quickbar displays two default filters:
Critical and Today's Alarms. The Critical filter includes alarms that belong to the
Critical BACnet notification class. The Today's Alarms filter includes alarms that
were generated for the current day.

The Quickbar is consistent across the alarm lists for multiple sites and views.
That is, when you select different items in the Alarms section of the left navigation
pane, the Quickbar remains in place with the all the filters displayed.

© 2021 Delta Controls Inc. 119


Alarms and Events

The Quickbar is hidden when it holds no filters.


You add a filter to the Quickbar using the Manage Filters dialog.

Alarm and Alert List


The alarm list displays detailed information about the active alarms and alerts
that match your text search and filter settings.
When you are not using the Advanced filter, the alarm list displays active alarms
or alerts for the one source that you selected in the Alarms section of the left
navigation pane. Alternatively, if you are using the advanced filter, the alarm list
displays active alarms or alerts for the sources that you have selected in the
advanced filter.
When the text search and filter settings are empty, the alarm list displays all of
the active alarms or alerts that enteliWEB knows about for the source that you
selected in the Alarms section of the left navigation pane.
To view all active alarms for all sites, select Network in the left navigation pane as
the source.
See Alarm and Alert List Reference for the organization of the information that is
presented in an active alarm.

Alarm Flags, Assign To, and Notes


The Alarm Flags, Assign To, and Notes pane displays information about the active
alarm that you selected in the alarm list.
The Alarm Flags and Assign To assignments and the Notes information you enter
for an alarm are saved by enteliWEB. Then when the same alarm occurs again and
is listed in the alarms list, the Alarm Flags, Assign To and Notes from the
previous occurrence of that alarm are displayed.
You can add and save the following information about the alarm, information
which you can then filter on:
Alarm Flags

An alarm flag is an attribute that you can assign to one or more alarms. Typically,
an alarm flag is used to mark a critical alarm or to assist you to implement a
workflow for managing certain types of alarms. Alarm flags have no inherent
meaning to enteliWEB.
enteliWEB has four built-in alarm flags: Nuisance, Important, Needs Repair,
Under Repair

120 enteliWEB 4.20 Operator Guide


Edition 1.0
Alarms and Events

Assign to

Assign to lets you associate an enteliWEB user with one or more alarms. By
assigning alarms to users, you can implement a workflow for delegating alarms.
Each user should create an "assigned to me" filter.
Notes

Notes lets you add comments about one or more alarms. Anyone who views the
alarm will see the notes.

Trend Log
The trend log pane displays a plot from the trend log object that is trending the
monitored object.
The trend log pane is hidden when there is no trend log to display.

History
The History pane displays a list of the recent activity for a selected alarm.
indicates that an operator acknowledge message is associated with the activity

Related Items
The Related Items pane lists all the links to associated objects, dashboards and
graphics that pertain to the monitored object for a selected alarm.

Page Selection and Refresh


The Page Selection and Refresh area lets you step through the alarm list from
page to page, and to refresh the alarm list either on your command or by enabling
enteliWEB to refresh it periodically.
Refresh means to update the Alarm and Alert List page with the active alarms that
match your text search and filter settings, from the list of active alarms that
enteliWEB knows about. Otherwise, unless enteliWEB is set to refresh the Alarm
and Alert List page automatically, the alarm list is not updated when new active
alarms are annunciated.
When enteliWEB is set to refresh the Alarm and Alert List page automatically, it
does so approximately every 20 seconds.
When you select an alarm from the alarm list, the automatic refresh function is
deactivated.

© 2021 Delta Controls Inc. 121


Alarms and Events

The Refresh Operation and the Update Alarm List Operation Perform
Different Functions
The Refresh operation updates the alarm list from enteliWEB's internal
alarm list.
Update Alarm List replaces enteliWEB's internal alarm list by uploading
all active alarms from the devices on the network.

Managing Filters
You manage filters to keep them current with your changing alarm management
needs. Administrative users are granted more filter management capabilities than
non-administrative users.
The Manage Filters dialog is provided for managing filters. The Manage Filters
dialog consists of two main parts: the filter list and the filter settings for the filter
you select in the filter list.
The filter management capabilities for administrative users and for non-
administrative users are described separately in the following sections.

Managing Filters by an Administrative User


An administrative user for alarms is a user who is a member of a group with
Manage Alarms permission.
An administrative user can manage the filters that he or she created and filters
that other administrative users have created. An administrative user can assign
those filters to other users.
An administrative user can perform all of the following the tasks.
l Create a filter
l Delete a filter
l Change filter settings for a filter
l Display a checkbox on the Quickbar that can be used to apply the filter
l Disable alarm annunciations for alarm notifications that match the filter
l Set the subscriber list of users and groups who will be emailed a notification
about alarms or alerts that match the filter
l Set the subscriber list of users and groups for whom a checkbox is displayed
on their Quickbar to allow them to apply the filter, for a filter created by the
administrator

122 enteliWEB 4.20 Operator Guide


Edition 1.0
Alarms and Events

See Permissions and Alarm Management for other aspects of user permissions
and alarms.

Managing Filters by a Non-Administrative User


A non-administrative user for alarms is a user who is a member of a group with
access to the Alarms section of the left pane navigation tree. A non-administrative
user does not have Manage Alarms permission.
A non-administrative user is limited to managing the filters that he or she
created. A non-administrative user can't manage a filter on the Quickbar that has
been subscribed for the user by an administrative user.
A non-administrative user can perform all of the following the tasks for a filter
that he or she created.
l Create a filter
l Delete a filter
l Change filter settings for filter
l Display a checkbox on the Quickbar that can be used to apply a filter
l Disable alarm annunciations for alarm notifications that match filter
l Subscribe to be emailed an alarm notification about alarms that match filter
l View but not change or delete settings for a filter that an administrative user
has subscribed for the non-administrative user
See Permissions and Alarm Management for other aspects of user permissions
and alarms.

About Alarm Notifications


An alarm notification alerts the user that a notification has been received by
enteliWEB, that is, a transition has occurred in the state of a monitored object.
enteliWEB provides the following methods for annunciating the alarm notification
to the user:
l Notification History Window
l Notification Pop-up Window
l Notification Sound
l Notification Status Indicator
l Email
Each of these methods is described in the following sections.

© 2021 Delta Controls Inc. 123


Alarms and Events

Notification History Window


The notification history window displays information about the recent notifications
in chronological order.
The notification history window presents, in tabular format, one row that contains
the following information, for each notification:
l Color indicator corresponding to the associated alarm group
l Status icon
l Name and link to monitored object
l Alarm notification message text
l Link to acknowledge the alarm, for alarms that require acknowledgment.
l Link to the system dashboard that contains the monitored object
l Link to alarm graphic
When the notification history window is pinned, it remains visible and persists
when the user moves from page to page in enteliWEB. When it is not pinned, the
notification history window closes when it loses user focus.
The user can clear the notification history window at any time by dismissing the
notifications.
Behavior of Notification History Window When it is Pinned

When the notification history window is pinned, it remains active and open at all
times. A user may or may not be present when new notifications are received and
he or she will not see the annunciation. Therefore, a new alarm notification is
identified with a shaded background until it is cleared by the user.

Notification Pop-up Window


The notification pop-up window is a temporary display in the lower right corner of
the page that provides summary information to alert the user about one or more
new alarm notifications. The user can choose to ignore the pop-up or click it to
deal with the alarm immediately.
The notification pop-up is enabled or disabled in the user settings by the
administrator.
The notification pop-up can be disabled for certain alarms when an alarm list
filter has Exclude from Alarm Notification selected.

124 enteliWEB 4.20 Operator Guide


Edition 1.0
Alarms and Events

Notification Sound
An alarm notification can be annunciated by sound at the user's workstation. You
choose the sounds by adding the sound files to the enteliWEB server and
assigning them to alarm groups. A different sound can be played for each alarm
group.
The notification sound is enabled or disabled in the user settings by the
administrator.
The notification sound can be disabled for certain alarms when an alarm list filter
has Exclude from Alarm Notification selected.

Notification Status Indicator


The notification status indicator is displayed to allow the user to open the
notification history window. When the notification status indicator is clicked, the
notification history window opens.
The notification status indicator is presented in the following formats

Two new notifications are listed in the notification history window.


The number corresponds to the number of notifications that have occurred since
the last time the user opened the notification history window.

No new notifications are listed in the notification history window.


The notification status indicator is not displayed when the user has dismissed all
notifications from the notification history window.
The notification status indicator is enabled or disabled in the user settings, by the
administrator.
The notification status indicator can be disabled for certain alarms when an alarm
list filter has Exclude from Alarm Notification selected.

Emailing Notifications
By subscribing to email in an filter, a user can receive an email message for every
alarm or alert notification that matches the filter. The email is sent to the address
that is specified in the user settings.
See Managing Filters for information about subscribing to alarm or alert
notification by email.

© 2021 Delta Controls Inc. 125


Alarms and Events

Email notification is not enabled and disabled by the Alarm Notification setting in
the user settings.
Email notifications are not sent to disabled users.
See Permissions and Notifications for information about user permissions and
email notifications.
A user's email address is specified in the user settings email address.

Server Not Responding Error


The client computer you are using polls the enteliWEB server periodically to
request new alarm notifications to display.
When the server does not respond as expected, an error message is displayed in
the notification history window similar to following:
Dismiss All Error receiving alarms! Last Refresh 3 mins ago   

Permissions and Alarm Management


To allow a user to work with alarms, he or she must be a member of a group with
the correct permissions.
Three types of permissions must be taken into account: Manage permissions,
User Interface permissions and Network permissions.

Permissions and Notifications


Notifications, including email, are not annunciated to a user in the following
situations:
l User is not a member of a group that has permission for the site.
l User is a member of a group that has permission for the site but user is not a
member of a group that has permission for the device.
l User is a member of a group that has permission for the site and for the
device but user is not a member of a group that has at least Read permission
for the monitored object.

Alerts Concepts
An alert is an alarm that reports a problem with an internal system, module, or
connection. Associated with each alert is a rule, which uses a built-in algorithm to
detect alarm states.

126 enteliWEB 4.20 Operator Guide


Edition 1.0
Alarms and Events

There are three types of alerts: system alerts, energy alerts, and application
module alerts.

System Alerts
System alerts are generated according to rules, which monitor specific systems,
connections, or devices. These rules can't be created or deleted.
There are five system rules:
l CopperCube Connection Detection
l Device Offline Detection
l Historian Offline Detection
l Service Monitor
l System Messages

CopperCube Connection Detection Rule


The CopperCube Connection Detection rule monitors the connection between
enteliWEB and a CopperCube. The connection is checked every 30 seconds.
An alert notification is generated whenever the connection fails or is restored.
enteliWEB generates a separate alert notification for each CopperCube.
The algorithm used by the CopperCube Connection Detection rule is named
CopperCube Status.

Device Offline Detection Rule


The Device Offline Detection rule monitors the online status of specified devices.

© 2021 Delta Controls Inc. 127


Alarms and Events

To monitor a device with the rule, you must create a Device Offline Detection alert.
enteliWEB does not detect offline devices or generate alert notifications for offline
devices by default.
When an alert is created using the Device Offline Detection rule, an alert
notification is generated whenever the BACnet Server can no longer communicate
with the selected device(s). A configurable time delay lets you exclude intermittent
anomalies that you don't want to be notified about.
You can monitor any number of devices. The monitored devices remain defined
when an offline device is removed or when a Reinitialize Descriptors command is
given. Devices are no longer monitored when a site is deleted.
The frequency at which enteliWEB monitors an online device depends on the
device. Certain types of devices, such as enteliBUS controllers, are treated with
higher importance and are therefore checked more frequently.
The following table displays the poll frequency for common device types.

Device Type Poll Frequency

eBMGR, eBCON, ASM, O3-DIN controller once every 15 minutes


CopperCube, Ethernet and BACnet/IP devices once every 2 hours
MS/TP devices once every 24 hours

When a device is offline, enteliWEB monitors the device to detect when it comes
back online using the following timings.

Offline Device Poll Delay

1st 2 minutes after device detected as offline


2nd 2 minutes after 1st poll
3rd 30 minutes after 2nd poll
4th 30 minutes after 3rd poll
5th, 6th, 7th ... 60 minutes after previous poll

The algorithm used by the Device Offline Detection rule is named Device Offline
Detection.

Historian Offline Detection Rule


The Historian Offline Detection rule monitors the connection between enteliWEB
and a Historian server. The connection is checked every 30 seconds.

128 enteliWEB 4.20 Operator Guide


Edition 1.0
Alarms and Events

An alert notification is generated whenever the connection fails or is restored.


enteliWEB generates a separate alert notification for each site that has a
Historian server.
The algorithm used by the Historian Offline Detection rule is named Historian
Status.

Service Monitor Rule


The Service Monitor rule monitors the enteliWEB Connection Service, Report
Generation Engine Service, and enteliVAULT Service (if present). Each service is
checked every 30 seconds.
An alert notification is generated whenever a service stops or restarts. enteliWEB
generates a separate alert notification for each service.
The algorithm used by the Service Monitor rule is named Service Status.

System Messages Rule


When a BACnet device detects a network issue, such as a circular network or
multiple devices with the same device number, it generates a system message
and sends it over the network.
The System Messages rule monitors the BACnet network for system messages,
checking it at 30 second intervals.
An alert notification is generated whenever a system message is detected.

System messages that are not assigned to a user are deleted after 24
hours.

Energy Alerts
You can create any number of energy rules and alerts. Rules are used to monitor
the data that the energy management system imports from an area or a meter. An
alert notification is generated when an anomaly is detected in the imported data,
or when the imported data is significantly different from the target data.
Energy alerts have three components: rules, monitored objects, and configuration
parameters.

Rules
An energy rule is defined by the algorithm that you assign to it when you create
the rule. The algorithms are built into enteliWEB and can't be changed.

© 2021 Delta Controls Inc. 129


Alarms and Events

There are three algorithms to choose from:


l Anomaly Detection
l Rolling Target
l Target
Anomaly Detection Algorithm

The anomaly detection algorithm calculates the arithmetic mean and the standard
deviation of the meter data that has been imported during the previous calendar
month. For example, if the current month is November, the previous calendar
month was October. Then it calculates the mean of the meter data of the previous
full hour. For example, if the current time is 11:28 AM, the previous full hour was
from 10:00 AM to 10:59 AM.
The algorithm calculates whether the mean data of the previous hour is within the
specified number of standard deviations of the mean data of the previous month. If
it is outside that range, the algorithm reports an anomaly, generating an alert
notification and setting the status of the alert to Alarm. If no meter data is found,
the status of the alert is set to Fault.
You must specify the type of data to monitor, such as electric consumption or gas
volume, and the number of standard deviations that must be exceeded for an
anomaly to be detected.
Target Algorithm

The target algorithm compares the consumption measured for a datapoint against
its target consumption for a specified time period. When the measured
consumption reaches a specified percentage of the target consumption, an alert is
generated and the status of the alert is set to High Limit. The status of the alert is
set to Fault when no target is set or when a consumption value is not found.
You must specify the type of data to monitor, such as electric consumption or gas
volume, the time range of data to monitor, and the threshold as a percentage of
the target consumption.
See Area and Meter Configuration for information about how to specify the target
data.
Rolling Target Algorithm

The rolling target algorithm compares the actual meter consumption against its
target consumption over a number of intervals. When the actual consumption
exceeds the target consumption by a specified percent, an alert is generated. The

130 enteliWEB 4.20 Operator Guide


Edition 1.0
Alarms and Events

status of the alert is set to Fault when no target is set or when a consumption
value is not found.
You must specify the type of data to monitor, such as electric consumption or gas
volume, the time range of data to monitor, the number of intervals to compare the
meter consumption and target consumption, and the threshold as a percentage of
the target consumption.
See Area and Meter Configuration for information about how to specify the target
data.

Monitored Objects
The monitored object defines the source of the data that the energy alert is
monitoring.
The source can be an area or a meter. An area represents a collection of meters
that is typically organized based on their physical location or function. A meter is a
collection of BACnet objects that read data from a physical meter. Typically, two
objects are required: one for consumption and another for demand.
See Area and Meter Configuration for information about areas and meters.

Configuration Parameters
The configuration parameters allow you to tailor the energy rule in following ways:
l Fine-tune the operation of the algorithm by tweaking certain parameters.
l Specify or create the notification class that is associated with the alert
notifications for the rule.
l Specify a meaningful name for the rule.

Application Module Alerts


An application module alert originates from an application that has been
developed using the enteliWEB API. An application generates an alert notification
based its detection rules.
For information about how to create a module that generates alerts, see the
enteliWEB API documentation.

Alert Notifications
Like other alarm notifications, alert notifications can be assigned to another user
for investigation, searched, filtered, sent via email, and so on. See Alarm and
Alerts Tasks for more details.

© 2021 Delta Controls Inc. 131


Alarms and Events

An alert is prioritized on the Alarm and Alert List page in the same way that an
alarm is prioritized: by the alarm group that it is a member of. Alarm group
membership for an alert is determined by the notification class that is associated
with the alert rule. Alerts that use the same rule have the same priority.
System alerts are associated with the Critical notification class. When alarm list
filters are set to filter only on Critical, then both the alarms and the alerts that are
associated with Critical are listed or included in an email. To include only alerts,
the filter needs to exclude all sites.
When creating an energy rule, you can create a pseudo Notification Class (EVC)
object that is specifically for alerts. These objects are assigned an instance
number of 1000 or greater (to prevent conflicts with other EVC objects on the
BACnet network) and given a BACnet priority of 170.

132 enteliWEB 4.20 Operator Guide


Edition 1.0
Active Alarm List Details and Tasks
Alarm and Alert List Reference
Information in an Active Alarm and Alert Listing

Organization of Information in an Active Alarm/Alert Listing


Here is an example of alarm/alert listings on the Alarm and Alert List.

Each listing follows this general organizational structure:

monitored object event enrollment object


notification class (priority) assigned to
status icon alarm notification ack flag date and time
status icon alarm notification ack flag date and time
status icon alarm notification ack flag date and time

The following paragraphs describe the information items that are shown in the
preceding Organization of Information in an Active Alarm Listing illustration.

Monitored Object
monitored object is the icon and name of the object that is in alarm or fault. Also a
link to the object page. When you hover the mouse cursor over the monitored
object name then its complete object reference is displayed.
When you select Network as the source of active alarms in the left navigation
pane, each monitored object also displays their site name in square brackets.
When config.xml is used to display an object name as both object name and object
description then monitored object obeys that setting.

© 2021 Delta Controls Inc. 133


Active Alarm List Details and Tasks

Event Enrollment Object


event enrollment object is the icon and name of the EV object that is associated
with the monitored object. Also a link to the EV object page. When you hover the
mouse cursor over the event enrollment object name then its complete object
reference is displayed.
If no event enrollment object is displayed, then the alarm was generated
intrinsically by the monitored object.

Assigned To
assigned to is an optional item that indicates the username of the enteliWEB user
who is associated with the alarm.

Notification Class (priority)


notification class (priority) displays the name of the class or category and priority
number that are included in the notification. When the event is from the BACnet
module, the name of the class is the local name of the Notification Class (EVC)
object given on the controller where it resides, regardless of its object instance.

Status Icon
status icon provides a visual indication of the status of the monitored object, as
reported by the corresponding alarm notification. The possible status icons are as
follows:

when the alarm state is not In Fault and is not Normal


when the alarm state is In Fault
when the alarm state is Normal

Alarm Notification
alarm notification is the text message that is included in the corresponding alarm
notification. The most recent alarm notification is listed first

Ack Flag

ack flag is displayed when the corresponding alarm notification needs to be


acknowledged. When no ack flag is displayed, then that alarm notification does
not require notification.
Click on the flag to open the Acknowledge dialog.

134 enteliWEB 4.20 Operator Guide


Edition 1.0
Active Alarm List Details and Tasks

Date and Time


date and time displays the date and time when the controller generated the alarm
notification. This date and time is the local information from the controller. When
the controller time is ahead of the enteliWEB server time, then the controller time
is displayed in parentheses to indicate that it is in the future. For example, (Apr
23, 2013 4:38 PM)
When you hover your mouse cursor over date and time, a pop-up displays full date
and time information.

Filter Dialog

The filter dialog lets you apply more than one filter dialog setting to the alarm or
alert list. Multiple filter dialog settings are ANDed to create a composite filter.
The following paragraphs describe each filter dialog setting as shown in the above
image.

Multiple entries in a filter dialog setting are ORed


For any of the filter dialog settings that allow multiple entries, such as
Alarm Group or Assigned To, the filter acts by accepting any one of the
entries, that is, entry 1 or entry 2 or ... and so on.

Alarm Group
Alarm Group specifies one or more alarm group names. When an alarm that is of
a notification class or of a BACnet priority that matches one of the alarm groups,
then that alarm is listed in the Alarm List page. Alarms that do not match are not
listed.
Alternatively, when exclude is selected then the alarms that don't match any of
the specified alarm groups are listed in the Alarm List page.

© 2021 Delta Controls Inc. 135


Active Alarm List Details and Tasks

Notification Class
Notification Class specifies one or more classes or category names from a list of
all classes or categories that enteliWEB is aware of, for all the modules that
enteliWEB is aware of.
When an alarm is of a class or category that matches one of those that you
specified, then that alarm is listed in the Alarm List page. Alarms that do not
match are not listed.
Alternatively, when exclude is selected then the alarms that don't match any of
the specified notification classes are listed in the Alarm List page.
In the selection list, each notification class is displayed as notification class name
(EVC object instance). For example, Critical (2). The categories in the list do not
have numbers in parentheses following their names.
In the selection list, you may see a notification class with more than one number
in parentheses. In this case, the right-most number is the EVC object instance.
The other numbers are part of the notification class or EVC object name. The
numbers included in the name were added when the object was copied. These
objects should be renamed to remove the numbers.
There are two Critical notification classes: alarms use the BACnet - Critical
notification class whereas alerts use the Alert - Critical notification class.

Alarm State
Alarm State specifies one or more alarm states that are specified in all EVC
objects that enteliWEB has found on the network. When an alarm that is of an
alarm state that matches one of the alarm states, then that alarm is listed in the
Alarm List page. Alarms that do not match are not listed.
Alternatively, when exclude is selected then the alarms that don't match any of
the specified alarm states are listed in the Alarm List page.

Assigned To
Assigned To specifies the usernames of one or more enteliWEB users to which
alarms have been assigned. When an assigned alarm matches one of the
usernames, then that alarm is listed in the Alarm List page. Alarms that do not
match are not listed. The match must be complete, that is, for similar usernames,
only alarms in which the assigned username fully matches the Assigned To
username will satisfy the filter.
When Assigned To is blank, then the alarm's assigned to status is not considered.

136 enteliWEB 4.20 Operator Guide


Edition 1.0
Active Alarm List Details and Tasks

Alternatively, when exclude is selected then the alarms that aren't assigned to any
of the users that are specified in the Assigned To field are listed in the Alarm List
page.

Alarm Flags
Alarm Flags specifies one or more of the alarm flags that can be added to an
alarm: Nuisance, Needs Repair, Important, Under Repair. When an alarm matches
one of the flags that you specify in the Alarm Flags field, then that alarm is listed
in the Alarm List page. Alarms that do not match are not listed.
Alternatively, when exclude is selected then the alarms that are not flagged or are
flagged with a flag that is not specified in the Alarm Flags field are listed in the
Alarm List page.

Ack Flags
Ack Flags specifies the acknowledged status of the alarms you want to be
displayed on the Alarm List page. When an alarm matches the flag that you
selected in the Ack Flags field, then that alarm is listed in the Alarm List page.
Alarms that do not match are not listed.
Select Acknowledged to list only the alarms in which the most recent alarm
notification does not require an acknowledgment. That is, it doesn't display .
Select Acknowledgement Required to list only the alarms in which the most
recent alarm notification requires an acknowledgment. That is, it displays .
When neither Ack Flag is selected, then the alarm's acknowledged status is not
considered.

Alarm Text
Alarm Text specifies a text phrase or fragment in the alarm text portion of the
notification for the alarms you want to be displayed on the Alarm List page. When
alarm text matches the text that you specify in the Alarm Text field, then that
alarm is listed in the Alarm List page. Alarms that do not match are not listed.
The filter performs the alarm text matching as case independent.

Priority
Priority specifies a range of numbers representing priority of a notification. A
notification with priority in the range that you specify is listed in the Alarm List
page. Notifications with priority that is outside the range are not listed.

© 2021 Delta Controls Inc. 137


Active Alarm List Details and Tasks

When the notification originates from a BACnet device, priority is the BACnet
priority.
Start

Set the field labeled Start to lowest number in the range.


When the Start field is blank, then the filter assumes it is set to 0.
End

Set the field labeled End to the highest number in the range.
When the End field is blank, then the filter assumes it is set to 255.

Date/Time
An alarm with an alarm notification that was time-stamped in the time range that
you specify is listed in the Alarm List page. Alarm notification that are time-
stamped outside the time range are not listed.
Date/Time lets you specify one of the following time ranges:
Today

Matches active alarms with an alarm notification that was time-stamped at or


after 12:00 am of the current day. The current day is that of the enteliWEB
server's date and time.
Last 7 Days (This Week)

Matches active alarms with an alarm notification that was time-stamped at or


after 12:00 am of the day that was seven days ago. For example, today being
Monday March 11, then Last 7 Days matches alarm notifications that were time-
stamped at or after 12:00 am on Tuesday March 5. The seven days is with respect
to the enteliWEB server's date and time.
Date Range

Matches active alarms with an alarm notification that was time-stamped in the
date and time range you specify. You can use any combination of the four Date
Range fields to specify the exact the time range you want. Start date must be
earlier than or the same as End date, when you are using both date fields.

138 enteliWEB 4.20 Operator Guide


Edition 1.0
Active Alarm List Details and Tasks

Alarm notification date and time is from the controller


The date and time that are considered by the Date/Time filter is the date
and time when the controller generated and time-stamped the alarm
notification. The time stamp is local date and time information from the
controller. It is not the enteliWEB server's date and time when the alarm
notification was received.

Alert
Alert specifies one or more sources for alerts that are present on the enteliWEB
server. By choosing an alert source for this field, you override the source that you
selected by the navigation tree.
When an application module that has been implemented with the enteliWEB API
uses the alarm management system, then its name is specified as a source for
alerts.
When an alert that is from a source that matches one of the specified sources,
then that alert is listed in the Alarm List page. Alerts that do not match are not
listed.
The Alert field is displayed for alerts only. When you are viewing alarms, the Alert
field is not displayed.

Object
Object specifies some text that you want to match with object information related
to an alert, such as the object name, the object type or the object reference. The
matching is case-insensitive.
The Object field is displayed for alerts only. When you are viewing alarms, the
Object field is located in the advanced filter.

Advanced Filter
The Advanced Filter dialog is displayed for alarms only. When you are viewing
alerts, the Advanced Filter dialog is not displayed.

Site
Site specifies one or more site names. When an alarm is from any of the specified
sites, then that alarm is listed in the Alarm List page. Alarms that do not match
are not listed.

© 2021 Delta Controls Inc. 139


Active Alarm List Details and Tasks

When one or more sites are specified in the Site field, then the source that you
selected in the Alarms section of the left navigation pane is superseded or
overridden by these sites, in the filter.
When the Site field is blank then the site that you have selected in the Alarms
section of the left navigation pane is used.

Device Range
Device Range specifies a range of device addresses. When an alarm is from any of
the devices with an address in the range of device addresses, then that alarm is
listed in the Alarm List page. Alarms that do not match are not listed.
The device address you enter in the field labeled Start must be less than or equal
to the device address you enter in the field labeled End.
When the Device Range fields are blank then an alarm that is from any of the
devices from the source or sources is listed in the Alarm List page.

System
System specifies one or more system names. When an alarm is from any of the
objects that are associated with a system, then that alarm is listed in the Alarm
List page. Alarms that do not match are not listed.
When one or more systems are specified in the System field, then the source that
you selected in the Alarms section of the left navigation pane is superseded or
overridden by these systems, in the filter.

Object
Object specifies some text that you want to match with object information such as
the object name, the object type or the object reference. The matching is case-
insensitive.
When an alarm is from a matching object, then that alarm is listed in the Alarm
List page. Alarms that do not match are not listed.
Some examples:
AV2* selects alarms from all AV objects with instances that starts with AV2,
such as AV2, AV21, AV232 on so on.
AV2 selects alarms from AV2 objects only
5600.AV* selects alarms from all AV objects on device 5600
*107 selects alarms from all objects with instance number or object name
that ends in 107

140 enteliWEB 4.20 Operator Guide


Edition 1.0
Active Alarm List Details and Tasks

You can enter multiple items that are comma-separated in the Object field. When
multiple items are entered, an alarm that matches one or more item is listed.

Filter Attributes
The filter attributes described in the following sections are displayed in the
Manage Filters dialog.

Add to Quickbar
Select Add to Quickbar when you want the filter to be accessible from the
quickbar.
To remove the filter from the quickbar, clear this attribute from the filter.
A filter that is subscribed to users must have Add to Quickbar selected to allow
the subscribed users to apply it.

Exclude from Alarm Notification


Select Exclude from Alarm Notification when you don't want alarm annunciations
for alarm notifications that match the filter.
When you select this attribute, you don't see these annunciations regardless of
which if any filter is currently in effect on the Alarm Lists page.
To resume the annunciations, clear this attribute from the filter.

Subscribe Filter For


The Subscribe Filter For attribute is displayed only for administrative users.
Subscribe Filter For allows an administrative user to subscribe individuals and
groups of users to the filter, so that the filter is displayed as a selection on the
subscribed users' Quickbars. Subscribed users can apply the filter but they can't
change the filter.
When selected, Subscribe Filter For also gives an administrative user the option
to enable individual user and groups to receive email for alarm or alert
notifications that match the filter, regardless of any other filter that is currently in
effect on the Alarm Lists page. A user's email address is specified in the user
settings email address.

Subscribe to Email
The Subscribe to Email setting is available to a user who is not a member of a
group with Manage Alarms permission.

© 2021 Delta Controls Inc. 141


Active Alarm List Details and Tasks

Select Subscribe to Email when you want alarm or alert notifications that match
the filter to be emailed to you. The email messages are sent to the address you
specify in your user information settings.
When you select this attribute, the alarm or alert notifications that match the filter
are emailed to you regardless of any other filter that is currently in effect on the
Alarm Lists page.
To stop receiving email, clear this attribute from the filter.

Send Email When Alarm is Acknowledged


Select Send Email When Alarm is Acknowledged when you want enteliWEB to
send an email notification for the acknowledge action when an alarm is
acknowledged. Otherwise, no email message is sent for the acknowledge action.

Alarm Details

Alarm Flags
An alarm flag is an attribute that you can assign to one or more selected alarms.
Typically, an alarm flag is used to mark a critical alarm or to assist you to
implement a workflow for managing certain types of alarms.
Alarm flags have no inherent meaning to enteliWEB. They do, however, provide
additional options that you can use in a filter.
The following alarm flags are built-in to enteliWEB:
l Nuisance
l Important
l Needs Repair
l Under Repair

Assign To
Assign To specifies an enteliWEB user that you can assign one or more selected
alarms to. By assigning an alarm to a user, you can implement a workflow for
managing certain types of alarms.

Notes
Notes lets you add comments about one or more selected alarms.
Notes are included in the email message for this alarm.

142 enteliWEB 4.20 Operator Guide


Edition 1.0
Active Alarm List Details and Tasks

The Alarm Flags, Assign To assignments, and Notes information that you enter for
an alarm are saved by enteliWEB. Then, when the same alarm occurs again and is
listed on the alarms list, the Alarm Flags, Assign To, and Notes from the previous
occurrence of that alarm are displayed.

Alarm Acknowledge Dialog


The alarm acknowledge dialog is displayed when you acknowledge one or more
alarms. It lets you enter a brief message to describe your acknowledge action. The
alarm acknowledge message is optional; it can remain blank.
The alarm acknowledge message is recorded in the log in the acknowledge
record. The message can be viewed in the Comment field of the details for the
acknowledge record in the log.

Alarm and Alert List Tasks


Tasks on this page apply to alarms and to alerts.

Alarm and Alert List Tasks

Selecting the Source for Alarms or Alerts in Alarm and Alert List
1. In the left navigation pane in the Alarms section, navigate the tree view to
locate the source you want to list the alarms or alerts for.
2. Select the source. The Alarm List page opens to display the alarms or alerts
from the selected source.

Sorting the Alarm List


To sort by monitored object, click the column with Monitored Object heading.
To sort by date and time of most recent alarm notification, click the column with
Date heading.
To sort by alarm group priority, click column with ! heading.

Refreshing the Alarm List


Click at the bottom of the page to refresh the alarm list immediately.
Select Auto Refresh at the bottom of the page to cause the alarm list to be
refreshed automatically.

© 2021 Delta Controls Inc. 143


Active Alarm List Details and Tasks

Updating the Alarm List

Select Update Alarm List from the Command list. All alarms in the BACnet
Server's alarm table are deleted. The BACnet Server uploads all alarms from the
source devices and objects.
This command is displayed only for users who are members of a group with
Manage Alarms permission.

Deleting one or more Alarms from the Alarm List


This function is available only for users who are members of a group with Manage
Alarms permission.

1. On the left Alarms section, expand Network and click the site name that
contains the alarms you're interested in.
2. Select the alarm or alarms you want to delete from the Alarm List page.
3. Select Delete Alarm from the Command list or press the Delete key on
your keyboard. A confirmation dialog opens.
4. Click Yes to delete the selected alarms from the alarm list
The deleted alarms are no longer viewable by any user.

Deleting An Alarm Affects The Alarm List Only.


When you delete an alarm from the alarm list, you are deleting it from
enteliWEB's internal list of active alarms. You are not acknowledging the
alarm and you are not changing the alarm state of the source object.
Therefore, when you update the alarm list, the alarms that you deleted
are listed again on the alarm list.

Viewing Details about the Monitored Object


Click the monitored object name. The monitored object name is in bold type on the
top line of the alarm entry in the alarm list. The corresponding object page opens.

Viewing Details about the Event Enrollment (EV) Object


Click the event enrollment name. The event enrollment name is on the top line of
the alarm entry in the alarm list. The corresponding object page opens.

144 enteliWEB 4.20 Operator Guide


Edition 1.0
Active Alarm List Details and Tasks

Acknowledging Alarms Tasks

Acknowledging an Alarm

1. On the left Alarms section, expand Network and click the site name that
contains the alarms you're interested in.

2. Select the alarm you want to acknowledge. Only an alarm that displays
can be acknowledged.
3. Click Acknowledge in the Flags, Notes and Assign To pane,
Or

Select Acknowledge from the Command list,


Or

Click
4. The Acknowledge Message dialog opens. Enter a brief message to describe
your acknowledge action. The acknowledge message is optional, it can
remain blank.
Click Acknowledge to save the message and to send an acknowledge
indication to the device.
5. See Verifying that an Alarm Acknowledgment is Confirmed.
You can also acknowledge alarms from the notification history window.

Verifying that an Alarm Acknowledgment is Confirmed


You can verify that the acknowledgment is confirmed by the device as follows:
OK Result

l is displayed at the top of the page.


l A notification stating "Acknowledgment confirmed by device ..." is received
from the device and listed in the notification history. When the alarm you
selected to acknowledge displayed multiple prior to being acknowledged,
then there will be a separate notification for each .
l Refresh and review the alarm list:
l When the acknowledgment means that the alarm is no longer active,
then the alarm is removed from the alarm list.

© 2021 Delta Controls Inc. 145


Active Alarm List Details and Tasks

l When the alarm remains active after the acknowledgment, then the
alarm remains on the alarm list but the is removed.
l The confirmation is recorded in the History pane.
Error Result

When acknowledgment failed, then the error banner is displayed at the


top of the page.

Acknowledging Multiple Alarms

1. On the left Alarms section, expand Network and click the site name that
contains the alarms you're interested in.
2. Identify the alarms you want to acknowledge by selecting the corresponding
checkboxes. Only alarms that display can be acknowledged.
3. Click Acknowledge in the Flags, Notes and Assign To pane,
Or

Select Acknowledge from the Command list.


4. The Acknowledge dialog opens. Enter a brief message to describe your
acknowledge action. The acknowledge message is optional, it can remain
blank. The message is recorded for all alarms that are acknowledged.
5. Click Acknowledge to save the message and to confirm the acknowledge
action.
6. See Verifying that an Alarm Acknowledgment is Confirmed.

Acknowledging All Alarms

1. On the left Alarms section, expand Network and click the site name that
contains the alarms you're interested in.

2. Select Acknowledge All from the Command list.


3. The Acknowledge dialog opens. The title bar displays the number of alarms
that will be acknowledged. Enter a brief message to describe your
acknowledge action. The acknowledge message is optional, it can remain
blank. The message is recorded for all alarms that are acknowledged.
4. Click Acknowledge to save the message and to confirm the acknowledge
action.
5. See Verifying that an Alarm Acknowledgment is Confirmed.

146 enteliWEB 4.20 Operator Guide


Edition 1.0
Active Alarm List Details and Tasks

Alarm Details Tasks

Adding an Alarm Flag to an Alarm

1. On the left Alarms section, expand Network and click the site name that
contains the alarms you're interested in.
2. Select the alarm you want to add the flag to. The alarm details are displayed.
3. Select the flag or flags that you want to add to the alarm.
4. Click Save. See Saving Alarm Details to understand how the result of the
save operation is displayed.

Assigning an Alarm to a User

1. On the left Alarms section, expand Network and click the site name that
contains the alarms you're interested in.
2. Select the alarm you want to assign. The alarm details are displayed.
3. Select the user you want to assign the alarm to, from the Assign To list of
users.
4. Click Save. See Saving Alarm Details to understand how the result of the
save operation is displayed.

Adding a Note to an Alarm

1. On the left Alarms section, expand Network and click the site name that
contains the alarms you're interested in.
2. Select the alarm you want to add the note to. The alarm details are displayed.
3. Enter the text into the Notes field.
4. Click Save. See Saving Alarm Details to understand how the result of the
save operation is displayed.

Saving Alarm Details


The result of the save operation is indicated by a banner at the top of the alarm
page.
When the save is successful, then the confirmation banner is displayed
at the top of the page. Also, Observe the History pane.
When the save is not successful, then the error banner is displayed at
the top of the page.

© 2021 Delta Controls Inc. 147


Active Alarm List Details and Tasks

Search Tasks

Search, Filter and Quickbar Filters Are Logically ANDed


When multiple filters are activated, then the alarm list displays only the
active alarms that meet the filter settings of all of the activated filters.
That is, search, filter and quickbar are logically ANDed.

Searching the Alarm List

1. On the left Alarms section, expand Network and click the site name that
contains the alarms you're interested in.
2. In the Search field, enter the characters that you want to search for in the
listed active alarms.
Using the asterisk "*" character for a wildcard search is not supported in the
Search field. To perform a wildcard search for objects, use the Object field in
the Advanced filter.
3. Press Enter to start the search. The alarm list is updated to list the active
alarms that match the active filters.

Clearing a Search
1. Delete the characters in the Search field.
2. Press Enter. The alarm list is updated to list all active alarms, or, when a
filter is active, to list the active alarms that match the filter.

Filter Tasks

Creating and Applying a Filter


1. On the left Alarms section, expand Network or Alerts, and click the
site name, Energy or System to open the list of alarms or alerts.
2. Click Filter. The Filter dialog opens.
3. Select the filter settings you want, in the Filter dialog. See Filter Dialog for a
description of the filter settings.
4. Click Apply. The alarm list is updated to display only the alarms that match
the active filters.

148 enteliWEB 4.20 Operator Guide


Edition 1.0
Active Alarm List Details and Tasks

To indicate that the listed alarms is a filtered view, the Filter button
changes to Filtered.
5. To save the filter, see Saving a Filter for procedure.
To cancel or reset the filter, see Resetting or Canceling a Filter for
procedure.

Creating and Applying an Advanced Filter

1. On the left Alarms section, expand Network or Alerts, and click the
site name, Energy or System to open the list of alarms or alerts.
2. Click Filter. The Filter dialog opens.
3. Select the filter settings you want, in the Filter dialog. See Filter Dialog for a
description of the filter settings.
4. Click Advanced Filter Scope. The advanced filter dialog opens.
5. Select the advanced filter settings you want, in the Advanced Filter Scope
dialog. See Advanced Filter for a description of the advanced filter settings.
6. Click Apply. The alarm list is updated to display only the alarms that match
the active filters. The alarm source you chose in the left navigation pane is
ignored or overridden when you choose items in the advanced filter.

To indicate that the listed alarms is a filtered view, the Filter button
changes to Filtered.
7. To save the filter, see Saving a Filter for procedure.
To cancel or reset the filter, see Resetting or Canceling a Filter for
procedure.

Saving a Filter
1. On the left Alarms section, expand Network or Alerts, and click the
site name, Energy or System to open the list of alarms or alerts.
2. Create a filter. See Creating and Applying a Filter or Creating and Applying an
Advanced Filter for procedure.
3. Click Save Filter. The Add New Filter dialog opens.
4. Enter a name for the filter, in the Name field.
5. Click Save to save the filter. When you open the Manage Filters dialog, this
filter is listed under your username.

© 2021 Delta Controls Inc. 149


Active Alarm List Details and Tasks

To cancel or reset the filter, see Resetting or Canceling a Filter for


procedure.

To select the filter attributes that you want to be in effect for this filter, click
Manage Filters and select the attributes. See Filter Attributes for information
about the filter attributes.

Managing and Changing a Saved Filter


1. On the left Alarms section, expand Network or Alerts, and click the
site name, Energy or System to open the list of alarms or alerts.
2. Click Manage Filters. The Manage Filters dialog opens.
3. Select the filter you want to change from the list of filters under your
username.
4. Change the filter settings and attributes and click Apply.

Resetting or Canceling a Filter


Reset or cancel filters that have been applied but not saved.

1. Click Filtered. The Filter dialog opens.


2. Click Reset Filters to remove all the settings from the Filter dialog and the
Advanced Filter Scope dialog. The alarm list is updated to display all active
alarms or to list the active alarms that match the active filters on the
quickbar. The Filter dialog remains open.

The Filtered button changes to Filter.


Click Cancel to remove all the settings from the Filter dialog and the
Advanced Filter Scope dialog, and to close the Filter dialog. The alarm list is
updated to display all active alarms or to list the active alarms that match the
active filters on the quickbar.

The Filtered button changes to Filter.

Deleting a Saved Filter

On the left Alarms section, expand Network or Alerts, and click the site
name, Energy or System to open the list of alarms or alerts.

Click Manage Filters. The Manage Filters dialog opens.


Select the filter you want to delete from the list of filters that are listed under your
username, and then click Delete.

150 enteliWEB 4.20 Operator Guide


Edition 1.0
Active Alarm List Details and Tasks

The filter is deleted from your list of filters and it is removed from the quickbar.

Quickbar Tasks

Adding a Filter to the Quickbar


1. On the left Alarms section, expand Network or Alerts, and click the
site name, Energy or System to open the list of alarms or alerts.
2. Click Manage Filters. The Manage Filters dialog opens.
3. Select the filter you want to add to the quickbar, from the list of filters that
are listed under your username.
4. Select Add to Quickbar to display this filter on the quickbar.
5. Click Apply. is displayed for the filter in the Quickbar column of the
Manage Filters dialog.
6. Close the Manage Filters dialog. The filter is on the quickbar.

Activating a Filter on the Quickbar


Select the adjacent checkbox to activate the filter. An activated filter is
highlighted, as for example Today's Alarms.
The alarm list is updated to display only the alarms that match the active filters.

Removing a Filter from the Quickbar


1. On the left Alarms section, expand Network or Alerts, and click the
site name, Energy or System to open the list of alarms or alerts.
2. Click Manage Filters. The Manage Filters dialog opens.
3. Select the filter you want to remove from the quickbar, from the list of filters
that are listed under your username.
4. Clear the check mark from Add to Quickbar to remove this filter from the
quickbar.
5. Click Apply. is no longer displayed for the filter in the Quickbar column of
the Manage Filters dialog.
6. Close the Manage Filters dialog. The filter is no longer on the quickbar.

© 2021 Delta Controls Inc. 151


Active Alarm List Details and Tasks

Saving to File Tasks

Saving Alarm List to PDF File/Alarm List Report

1. On the left Alarms section, expand Network and click the site name that
contains the alarms you're interested in.
2. Create and apply the filter for the alarm notifications that you want to capture
in the PDF file. See Creating and Applying a Filter or Creating and Applying
an Advanced Filter for procedure.
3. Click . The PDF file is saved to your browser's download destination. Now
you can print the document.

Saving Alarm List to CSV File

1. On the left Alarms section, expand Network and click the site name that
contains the alarms you're interested in.
2. Create and apply the filter for the alarm notifications that you want to capture
in the CSV file. See Creating and Applying a Filter or Creating and Applying an
Advanced Filter for procedure.
3. Click . The CSV file is saved to your browser's download destination.

Delimiters used in CSV file are based on locale of user who downloads
the samples. User who imports the CSV into Excel must use same locale.

Email Tasks for Non-administrative Users


A non-administrative user is a user who is a member of a group with access to the
Alarms section of the left pane navigation tree but without Manage Alarms
permission.

Before you begin, ensure an enteliWEB administrative user has


configured enteliWEB to send email.

Emailing Alarm Notifications to Yourself

1. On the left Alarms section, expand Network and click the site name that
contains the alarms you're interested in.

152 enteliWEB 4.20 Operator Guide


Edition 1.0
Active Alarm List Details and Tasks

2. Click Manage Filters. The Manage Filters dialog opens.


The dialog lists the filters that you created and it lists other filters that have
been subscribed to you by an administrative user.
3. Select the filter you want to receive email notifications for, from the list of
filters that are listed under your username, that is, a filter that you created.
4. Select Subscribe to Email to have the alarm notifications that match the filter
sent to you by email. The email is sent to the address that is specified in your
personal user settings.
5. Click Apply to save the filter. is displayed for the filter in the Subscription
column.

Stopping Alarm Notifications Emails to Yourself

1. On the left Alarms section, expand Network and click the site name that
contains the alarms you're interested in.

2. Click Manage Filters. The Manage Filters dialog opens.


3. Select the filter you want to stop email notifications from, from the list of
filters that are listed under your username, that is, a filter that you created.
4. Clear the checkbox for Subscribe to Email.

5. Click Apply to update the filter. is no longer displayed for the filter in the
Subscription column.
You will no longer receive emails about alarm notifications that match the
filter.

Stopping Alarm Notification When Alarm is Acknowledged Emails to Yourself

1. On the left Alarms section, expand Network and click the site name that
contains the alarms you're interested in.

2. Click Manage Filters. The Manage Filters dialog opens.


3. Select the filter that you want to stop the alarm acknowledged emails for,
from the list of filters.
4. In the area labeled Attributes, clear the checkbox labeled Send Email When
Alarm is Acknowledged.
5. Click Apply to update the filter. The in the Email When Acknowledged
column is removed, for the filter you selected.

© 2021 Delta Controls Inc. 153


Active Alarm List Details and Tasks

Notifications Tasks

Disabling Annunciation of Alarm Notifications

1. On the left Alarms section, expand Network and click the site name that
contains the alarms you're interested in.

2. Click Manage Filters. The Manage Filters dialog opens.


3. Select the filter you want to disable alarm notifications for, from the list of
filters that are listed under your username.
4. Select Exclude from Alarm Notification to disable the following annunciations
for the alarm notifications that match the filter.
l Popup notification
l Sound notification
l Alarm notification indicator
l Alarm graphics

5. Click Apply. is displayed for the filter in the Exclude Notifications column.

Enabling Annunciation of Alarm Notifications

1. On the left Alarms section, expand Network and click the site name that
contains the alarms you're interested in.

2. Click Manage Filters. The Manage Filters dialog opens.


3. Select the filter you want to enable alarm notifications for, from the list of
filters that are listed under your username.
4. Clear Exclude from Alarm Notification to enable annunciations for the alarm
notifications that match the filter.

5. Click Apply. is no longer displayed for the filter in the Exclude


Notifications column.
You will now receive alarm annunciations about alarm notifications that
match the filter.

Showing and Hiding the Notification History Window


To show the notification history window, click the alarm notification indicator:

or . The notification history window opens.

154 enteliWEB 4.20 Operator Guide


Edition 1.0
Active Alarm List Details and Tasks

To hide the notification history window, click the alarm notification indicator. To
hide the notification history window, it must not be pinned.

Pinning and Unpinning the Notification History Window


The notification history window can be pinned to remain visible and persist as the
user moves from page to page in enteliWEB. When it is not pinned, the notification
history window closes when it loses user focus.
To pin the notification history window, click
To unpin the notification history window, click

Viewing Alarm Notification Details in Notification History Window


1. Open the notification history window. See Showing and Hiding the Notification
History Window for procedure.
2. Click the color square that is associated with the alarm notification you want
to view the details for. The details pop-up window opens.

Acknowledging an Alarm in Notification History Window


1. Open the notification history window. See Showing and Hiding the Notification
History Window for procedure.
2. Click for the alarm notification you want to acknowledge. The
Acknowledge Message dialog opens.
3. Enter a brief message to describe your acknowledge action. The
acknowledge message is optional, it can remain blank.
Click Acknowledge to save the message and to confirm the acknowledge
action.
4. A notification stating "Acknowledgment confirmed by device ..." is received
from the device and listed in the notification history window.

Clearing All Notifications from the Notification History Window


1. Open the notification history window. See Showing and Hiding the Notification
History Window for procedure.
2. Click Dismiss All. All notifications are removed from the window. If the
window is not pinned, then it closes.

© 2021 Delta Controls Inc. 155


Active Alarm List Details and Tasks

Dismiss All Does Not Affect the Alarm List


Dismiss All does not alter the alarm list. It doesn't delete active alarms. It
doesn't acknowledge active alarms. Dismiss All is a convenience to the
user who wants to remove the notifications from the notification history
window.

Viewing Alarm Graphic Associated with Alarm Notification


enteliWEB provides the following ways for you to open an alarm graphic.
l
On the notification pop-up, click . The alarm graphic opens.
l
On the notification in the notification history log, click . The alarm graphic
opens.
l In the Related Items pane, click the item that is labeled "Graphic".

156 enteliWEB 4.20 Operator Guide


Edition 1.0
Totalizers
Analog Totalizer (AT) Object Concepts
About the Analog Totalizer Object
The Analog Totalizer (AT) object calculates the accumulated quantity of a
measured variable over time according to that measured variable's rate of
change. For example, by using an Analog Totalizer object you can determine how
many liters of fluid have passed a flow-measuring station in one week.

Monitoring Parameters
The AT object page presents the following information to allow you to monitor the
operation of the totalizer.

Value Bar
The Value Bar displays the object's present value and the object's mode.
In Auto mode, the present value represents the accumulated quantity of the
measured variable since the AT object was reset.
In Manual mode, the present value represents the accumulated quantity of the
measured variable when the object was set to Manual mode or to the value that
was entered manually.

Start Time
Start Time displays the date and time when the AT object's accumulated value was
reset to zero. Start Time indicates when the AT object started to accumulate its
current value.

COV Minimum Increment


Change Of Value Minimum Increment displays the minimum amount of change in
the AT object's present value that is required to cause a sample to be recorded in
a trend log and to cause a COV data exchange message to be sent.

Monitored Object
Monitored Object specifies the object that provides the measured variable that is
to be accumulated or totalized. Monitored Object must be one of the following

© 2021 Delta Controls Inc. 157


Totalizers

object types: Analog Input, Analog Output, Analog Value or Pulse Input object.

Binary Totalizer (BT) Object Concepts


About the Binary Totalizer Object
The Binary Totalizer (BT) object accumulates the amount of time that a binary
object is in its active state. For example, by using a BT object you can totalize
equipment runtime.

Monitoring Parameters
The BT object page presents the following information to allow you to monitor the
operation of the totalizer.

Value Bar
The Value Bar displays the object's present value and the object's mode.
In Auto mode, the present value represents the accumulated time in hours that a
binary object has been in its active state since the BT object was reset.
In Manual mode, the present value represents the accumulated time that a binary
object has been active when the object was set to Manual mode or to the value
that was entered manually.

Number of <active state name> State Changes


Number of State Changes displays the number of times that the monitored object
has transitioned to its active state since the BT object was reset. <active state
name> is replaced by the name of the active state.
The active state name is the active state name of the object that is configured as
Monitored Object.

Since
Since displays the date and time when the BT object was reset and the
accumulated time was reset to zero .

COV Minimum Increment


Change Of Value Minimum Increment displays the minimum amount of time in
hours that the monitored object has to remained in its active state to cause a

158 enteliWEB 4.20 Operator Guide


Edition 1.0
Totalizers

sample to be recorded in a trend log and to cause a COV data exchange message
to be sent.

© 2021 Delta Controls Inc. 159


Control Loops
Control Loop Object
For analog control applications, an analog output (such as an actuator position or
drive speed) is modulated to make an input (such as temperature, airflow, or
pressure) equal to its setpoint.
Analog control is accomplished with a Proportional-Integral-Derivative (PID)
control loop. The BACnet standard specifies the standard Loop object for PID
feedback control. Delta's software provides this function in an object called the
Control Loop (CO) object.

Monitoring Parameters
The CO object page presents the following information to allow you to monitor the
operation of the control loop.

Value Bar
The Value Bar displays the object's present value and the object's mode: Auto,
Manual .

Auto Mode
In Auto mode, the CO object's present value is the control loop output that is
calculated according to the configuration of the CO object.

Input Source
Input Source displays the name of the object that provides the input value being
monitored by the CO object.

Input Value
Input Value displays the value being received from the Input Source by the CO
object.
Input Value is displayed to the same precision that it is on the referenced AI
object's page.

Setpoint Source
Setpoint Object displays the name of the object that provides the setpoint being
monitored by the CO object when you are using a setpoint that varies such as from

160 enteliWEB 4.20 Operator Guide


Edition 1.0
Control Loops

a schedule or from a wall stat setpoint adjust.


When the text "Fixed" is displayed, the setpoint source is not an AI or AV object.
Instead, the source is a fixed value that is configured in the CO object.

Setpoint Value
Setpoint Value displays the value being received from the Setpoint Source by the
CO object or the fixed value set by the CO object.

COV Minimum Increment


COV Minimum Increment specifies the minimum amount of change in the object's
present value that is required to cause a Change Of Value notification event.
COV Minimum Increment can be specified by up to six significant digits. It is not
affected by the object's Decimal_Places property.
The COV Minimum Increment property is used in conjunction with trending or for
COV data exchange configuration.

Real-Time Control Loop Performance


The Real-Time Control Loop Performance graph plots input, output and setpoint
dynamically as they respond to the CO object control loop.

© 2021 Delta Controls Inc. 161


Optimum Start
Optimum Start (OS) Object Concepts
About the Optimum Start Object
Most facilities have predictable occupancy patterns. The mechanical equipment is
scheduled to run during the occupied times of day. Typically, however, the
equipment should be started prior to scheduled occupancy time to allow the
occupied spaces to be comfortable when occupants arrive.
As an alternative to starting the equipment at a fixed time prior to occupancy, you
can use the Optimum Start (OS) object. The OS object calculates the optimum time
prior to occupancy to start the equipment such that the space reaches the comfort
levels required when the occupants arrive. By starting the equipment at the
optimum time instead of a fixed time, the startup time is minimized and therefore
energy consumption is reduced.
The OS object calculates the optimum start time every day. The calculation takes
into account the following information:
l The OS object's operational history over the past three days
l Outdoor temperature
l Scheduled occupancy time
l Indoor temperature
l Target indoor temperature
l Extended periods of unoccupied time, such as weekends or holidays, prior to
the scheduled occupancy time
When both heating and cooling optimum start are required, create two OS objects.

Optimum Start Calculation


The OS object calculates an optimum start time that allows a heating or cooling
system to reach a target temperature in a cost-effective way. The OS object
calculates optimum start time based on its past performance, indoor temperature
and an occupancy schedule. As well, the calculation includes safeguards such as a
maximum start time and temperature deadband to ensure proper start times.
Outdoor air temperature and extended unoccupied periods can optionally
influence the start time. The OS object maintains a history of the previous three
days to allow it to determine an average temperature change per hour.

162 enteliWEB 4.20 Operator Guide


Edition 1.0
Optimum Start

When the OS object achieves its target temperature before the scheduled
occupancy time, it remains On until the referenced schedule transitions to On or
occupied. The OS object transitions to Off when the referenced schedule
transitions to On or occupied.

OS Object Assumption About When Scheduled Occupancy Starts


The OS object assumes that the first Off-to-On transition of the day
indicates the scheduled occupancy time. After this first Off-to-On
transition, the OS object ignores the other Off-to-On transitions for that
day.

History
The History section of the OS object page displays the results of the three most
recent active periods for the OS object. The information is presented in a tabular
format and a chart format.

History Table
Example History Table

Indoor Outdoor Target Indoor Rate


On Off Status
°F °F °F °F °F/hr
9/12/12
7:00:11
5:22 59.6 0 Off 70 66.9499 4.49996
AM
AM
9/11/12
7:00:21
5:38 61 0 Off 70 69.3999 6.14625
AM
AM
9/10/12
6:39:06 Achieve
5:21 61.55 0 70 70.1499 6.61387
AM d
AM

The data in the history table are as follows:


On

Date and time when the OS object transitioned to the On state at the calculated
optimal start time.

© 2021 Delta Controls Inc. 163


Optimum Start

Indoor

Indoor temperature when the OS object transitioned to the On state.


Outdoor

Outdoor temperature when the OS object transitioned to the On state. An outdoor


temperature of zero indicates that outdoor influence was not included in the
optimum start time calculation.
Off

Date and time when the OS object transitioned to the Off state, at the scheduled
occupancy time.
Status

OS object status at the scheduled occupancy time when the OS object transitioned
to the Off state. See the Control Information, Status section, above for details
about OS object status.
Target

Target indoor temperature to be achieved by the OS object at the scheduled


occupancy time.
Indoor

Indoor temperature when the OS object transitioned to the Off state at the
scheduled occupancy time.
Rate

Heating or cooling rate, in degrees per hour, that was achieved during the OS
object's On state.

History Chart
The history chart displays in line graph format, the data in the history table. The
history chart lets you understand at a glance, the recent performance of the OS
object.
The chart below plots the data from the example table above.

164 enteliWEB 4.20 Operator Guide


Edition 1.0
Optimum Start

Optimum Start History Chart

Legend

1 - Temperature - the y axis is the indoor temperature


2 - On - Date and time when the OS object transitioned to the On state at the
calculated optimal start time.
3 - Deadband - the blue shaded area indicates the deadband that surrounds
the target temperature.
4 - Off - Date and time when the OS object transitioned to the Off state, at the
scheduled occupancy time.
5 - Target Temperature - Target indoor temperature to be achieved by the OS
object at the scheduled occupancy time.

Monitoring Parameters
The OS object page presents the following information to allow you to monitor the
operation of optimum start.

Value Bar
The Value Bar displays the object's present state and the object's mode.
In Auto mode, the present state is On when the OS object is actively involved in
heating or cooling the building and Off when it is not active.
In Manual mode, the present state is the manually selected value.

© 2021 Delta Controls Inc. 165


Optimum Start

Status
Status displays the phase of operation of the OS object, as follows:

Heating Start
The OS object is causing the space to be warmed in preparation for scheduled
occupancy.

Cooling Start
The OS object is causing the space to be cooled in preparation for scheduled
occupancy.

Achieved
The OS object has caused the space to reach its target temperature before the
scheduled occupancy time.

Off
The OS object is not participating in temperature control of the space. In the
history table, a status of Off indicates that the target temperature was met exactly
at the scheduled occupancy time or that the OS object under-achieved the target
temperature at the scheduled occupancy time.

Fault
The OS object is in fault.

Start Type
Start Type displays Heating when the OS object is configured to warm the space
during the object's active state.
Start Type displays Cooling when the OS object is configured to cool the space
during the object's active state.

Target Temperature
Target Temperature displays the space temperature that the OS object is
expected to achieve prior to scheduled occupancy.

Indoor Temperature
Indoor Temperature displays the space temperature when the OS status is
Heating Start, Cooling Start or Achieved. When the OS object is inactive, Indoor

166 enteliWEB 4.20 Operator Guide


Edition 1.0
Optimum Start

Temperature is not displayed.

Schedule
Schedule displays the name of the schedule object that provides the occupancy
times to the OS object.

Schedule Next On at
Schedule Next On at displays the time when the next scheduled occupancy period
starts.

Time to Next Schedule On


Time to Next Schedule On displays the time remaining in hours and minutes until
the next scheduled occupancy period starts.

© 2021 Delta Controls Inc. 167


Reports
Reports Concepts
Report Features
enteliWEB's reports includes energy reports, building automation reports and
access control reports.
The Reports feature has the following capabilities:
l Run the report on operator command or automatically at a scheduled time
l Email report results as PDF
l Save report results to a file in Excel, PDF, PowerPoint or Word format
l Maintain a history of when report was run
l Save multiple report configurations and add links to report in the Reports
section of the left navigation pane.
l Add reports to a dashboard using the Reports Links widget.

Access Control Reports

Version 3 Access Control Reports


For information about Version 3 access control reports, see Version 3 Access
Control Reports Concepts.

O3 Access Reports
For information about O3 Access reports, see O3 Access Reports Concepts.

Building Automation Reports


For information about building automation reports, see Building Automation
Reports Concepts.

Energy Reports
For information about energy reports, see Energy Reports Concepts.

Reports Tasks
Tasks on this page assume you are viewing a report page.

168 enteliWEB 4.20 Operator Guide


Edition 1.0
Reports

Creating a Report

Creating an Access Control Report


To learn how to create a Version 3 access control report, see Creating a Version 3
Access Control Report.
To learn how to create an O3 Access report, see Creating an O3 Access Control
Report.

Creating a Building Automation Report


To learn how to create a building automation report, see Creating a Building
Automation Report.

Creating an Energy Report


To learn how to create an energy report, see Creating an Energy Report.

Scheduling a Report
Set up enteliWEB to generate a specific report automatically on a specific date, or
periodically.
1. Open Reports in the left pane navigation tree and select a saved report.
2. On the top right side of the screen, click Schedule. The Schedule a Report
page opens.
3. See the Help for the Schedule a Report page for information about
scheduling a report.

You can also schedule reports by going to > Report Scheduling > Schedule a
Report.

Deleting a Report
1. In the Reports section of the left pane navigation tree, click the saved report
you want to delete. The report opens in the right pane.
2. Click Delete. A confirmation dialog opens.
3. Click Yes to delete the report. The link to the report is removed from the
Reports section of the left pane navigation tree.

Managing Report History


enteliWEB saves a copy of the results in the Report History log, every time you run
a report or when a scheduled report is run.

© 2021 Delta Controls Inc. 169


Reports

To view the results of previous reports:


1. In the Reports section of the left pane navigation tree, click the saved report
you want to view the report history. The report opens in the right pane.

2. On the top right side of the screen click Report History and select the
report by date and time that you want to view from the list.

To delete the results of a previous report, click Report History, point to


the report you want to delete from the list and click Delete.
When a scheduled report is set up to be emailed after it is generated, the report is
not saved in the Report History log if you choose to delete the report after it is
emailed.
When you select a report from the Report History and instead of the report, you
see the following text:
Report instance Not Found
This report was generated but the files are no longer on the server.
It indicates that the report you selected was a scheduled report that was set up to
not be saved.

Exporting a Report

For best results when exporting to Excel, in the Edit Report Format
dialog, remove the Show in Groups setting and make the column that was
used for the grouping visible.

1. In the Reports section of the left pane navigation tree, click the saved report
you want to export and run it, or select the report from the report history list.
The report opens in the right pane.
2. On the top right side of the screen, click the button that corresponds to the
format you want the exported report to be saved to, from the following
formats:
Excel
PDF
PowerPoint
Word
3. Your browser downloads the report to a file in your downloads destination.

170 enteliWEB 4.20 Operator Guide


Edition 1.0
Reports

Emailing a Report
1. Configure an email server for enteliWEB.
2. In the Reports section of the left pane navigation tree, click the saved report
you want to send by email and run it, or select the report from the report
history list. The report opens in the right pane.
3. On the top right side of the screen, click Email. The Email dialog opens.
4. Enter the email address of the recipient you want to send the report to.
5. Click OK. enteliWEB attempts to send the report by email.
When the email is sent successfully, a dialog is displayed with the message:
Email sent successfully.
When the email is not sent successfully, a dialog is displayed with the
message: Failed to send email.

Copying a Report
1. In the Reports section of the left pane navigation tree, click the saved report
you want to copy. The report opens in the right pane.
2. Click Copy. The Copy dialog opens.
3. Enter a unique name for the copy of the report.
4. Click OK. A link to the copy of the report is added in the Reports section of
the left pane navigation tree. The copy of the report is displayed in the right
pane.

Modifying the Report Setup


To modify the look of the report:
1. In the Reports section of the left pane navigation tree, click the report you
want to modify.
2. In Report Format click to open the Edit Report Format dialog.
The Edit Report Format dialog lets you hide columns, change the sort order or
organize the data into meaningful groups.
See the individual report help topics for more details about the Edit Report Format
dialog.

© 2021 Delta Controls Inc. 171


Energy Management Reports
Energy Reports Concepts
About Energy Reports
enteliWEB's Energy Management add-on includes over ten types of reports that
you can use to visualize and capture a snapshot of energy and resource
consumption and demand data that reside in the enteliWEB database for the
areas, regions, buildings and meters that you have configured.

Which Report Do I Want?


The following table summarized the content of each report.

Report Name Consumption Demand Baseline Target


Consumption
Consumption by Meter
Consumption by Time
Consumption Comparison
Consumption Target
Contribution Comparison
Cost Ranking
Cumulative Consumption
Daily Average
Degree Days
Load Duration
Single Meter Occupancy

Occupied
Report Name Temperature Cost
Unoccupied
Consumption
Consumption by Meter

172 enteliWEB 4.20 Operator Guide


Edition 1.0
Energy Management Reports

Occupied
Report Name Temperature Cost
Unoccupied
Consumption by Time
Consumption Comparison
Consumption Target
Contribution Comparison
Cost Ranking
Cumulative Consumption
Daily Average
Degree Days
Load Duration
Single Meter Occupancy

What is a Meter Group?


The concept of meter group is important to understand in the context of reports. A
meter group is a mechanism that you can use for organizing the Area/Meter List
for the type of report you want to generate.
When you want the data from more than one meter to be included in the report as
a single entity, then the meters must be in the same group in the Area/Meter List.
The report configuration dialog lets you create a meter group and to add areas,
buildings, regions, and meters to it.
Each report has a limitation as to the maximum number of areas, buildings,
regions, and meters that are included in the report.

What Meters are Included in a Report?


A report includes data from the meters that you specify in the Area/Meter List.
But the question is, which meters?
The answer is that each report follows its own rules as to which areas, buildings,
regions, and meters it selects from the Area/Meter List.
For a report to contain the information you want, you must configure the
Area/Meter List according to those rules.

© 2021 Delta Controls Inc. 173


Energy Management Reports

The rules for each type of report are described in the Meters Included section on
the help page for each report. To view a report's help page, select the report you
are interested in from the Report Name column of the Which Report do I Want
table.

Consumption Report
About the Consumption Report
For a single meter, area, building, region or meter group, the Consumption report
lets you view the following energy data over time:
l energy consumption or production. Production energy data is represented in
the report as negative consumption values.
l peak demand
l minimum demand for one year for a single meter, area, building, region, or
meter group
The report also contains the average monthly temperatures for the selected year,
when temperature data is available.
When baseline and target data are available then they are also included in the
report.
The results are presented as a bar chart and in tabular format, in increments of
one month.

Meters Included
If there are no groups in the Area/Meter List, then the first meter in the list is
included in the report.
If there are one or more groups in the Area/Meter List, then the first group, area
or meter is included in the report.

Limitations
Only data from one group, area or meter is included in the report.
If you want to see data from multiple groups, areas, or meters, use the
Consumption by Meter report or Consumption by Time report.

174 enteliWEB 4.20 Operator Guide


Edition 1.0
Energy Management Reports

Report Parameters

Area/Meter List
The Area/Meter List specifies the areas, buildings, regions, and meters that you
want the report to include data for.
The Consumption report is limited to the maximum number of meters indicated in
Limitations.

Meter Group
Meter Group lets you specify an empty group for the of Area/Meter List. You can
then add arbitrary areas, buildings, regions, and meters to that group. The report
is generated by grouping the data of the items in a group.
To learn how to create a meter group, see Creating a Meter Group.

Report Name
Report Name specifies the name of the link that appears in the Energy Reports
section of enteliWEB's left pane tree view under Consumption, when you save your
report.
Report Name specifies the subject text of the email message when the report is
sent by email.

Report Title
Report Title specifies the text that appears as the title of the report.

Meter Type
Meter Type specifies the type of energy or resource that the report includes data
for.
When you change Meter Type, you are forced to specify the Area/Meter List again.

Site
Site specifies the site name that you want to appear on the report for site.
Site can be any arbitrary name. It does not have to be the same as a site that is
configured into enteliWEB.

Year - Date Configuration


Year in the Date Configuration area specifies the year for which the consumption
data is reported.

© 2021 Delta Controls Inc. 175


Energy Management Reports

Date/Time Format
Date/Time Format specifies the format of the date and time that is displayed in
the upper right corner of the report.

Year - Baseline
Year in the Baseline area specifies the year that is considered to be the baseline
data in the report.

Consumption by Meter Report


About the Consumption by Meter Report
The Consumption by Meter report lets you view both consumption and demand
data for multiple meters, areas, buildings, regions and meter groups. The data is
organized by meter for a given date range. You can also include data from
production meters which are represented in the report as negative consumption
values.
See Consumption by Time report for similar data organized by time.
For each meter the report includes the following data:
l Total consumption or production.
l Consumption or production during occupied hours
l Consumption or production during unoccupied hours
l Maximum, minimum and average demand
The occupied and unoccupied time periods are configured during the configuration
for the report.
The report results are presented as a vertical bar chart and in tabular format. The
demand data is presented in tabular format.

Meters Included
The Consumption by Meter report examines the Area/Meter List and includes the
data from the meter or meters from each item in the list. When it encounters an
item that contains no meters, it ignored that item and moves on to the next item in
the list.
When the item is a meter, then that meter is included in the report.
When the item is an area, building or region, then the child meters of that parent
are included in the report.

176 enteliWEB 4.20 Operator Guide


Edition 1.0
Energy Management Reports

When the item is a meter group, then the meters in that group are included in the
report.

Limitations
Up to nine meters, areas, buildings, regions, or meter groups can be included in
the report. Subsequent items in the Area/Meter List are ignored.

Report Parameters

Area/Meter List
The Area/Meter List specifies the areas, buildings, regions, and meters that you
want the report to include data for.
The Consumption by Meter report is limited to the maximum number of items
indicated in Limitations.

Meter Group
Meter Group lets you specify an empty group for the of Area/Meter List. You can
then add arbitrary areas, buildings, regions, and meters to that group. The report
is generated by grouping the data of the items in a group.
To learn how to create a meter group, see Creating a Meter Group.

Report Name
Report Name specifies the name of the link that appears in the Reports section of
enteliWEB's left pane tree view under Consumption by Meter, when you save your
report.
Report Name specifies the subject text of the email message when the report is
sent by email.

Report Title
Report Title specifies the text that appears as the title of the report.

Meter Type
Meter Type specifies the type of energy or resource that the report includes data
for.
When you change Meter Type, you are forced to specify the Area/Meter List again.

Site
Site specifies the site name that you want to appear on the report for site.

© 2021 Delta Controls Inc. 177


Energy Management Reports

Site can be any arbitrary name. It does not have to be the same as a site that is
configured into enteliWEB.

Date Range
Date Range specifies the time period for the data over which the consumption and
demand is reported.
When Custom is selected, the From and To fields are displayed.

From - Date Configuration


From specifies the date when the custom date range begins.

To - Date Configuration
To specifies the date when the custom date range ends.

Date/Time Format
Date/Time Format specifies the format of the date and time that is displayed in
the upper right corner of the report.

From - Occupancy
From specifies the time of day when the occupied period begins for occupied days.

To - Occupancy
To specifies the time of day when the occupied period ends for occupied days.

Days - Occupancy
Days specifies the day or days of the week that are considered to be occupied days
for the report. Choose All, Weekdays or Weekends from the list or select Other to
allow you to specify the exact weekday or days you want to be the occupied days.
Choosing no occupied days does not work.

Consumption by Time Report


About the Consumption by Time Report
The Consumption by Time report lets you view both consumption and demand data
for multiple meters, areas, buildings, regions and meter groups. The data is
organized by time for a given date range. You can also include data from

178 enteliWEB 4.20 Operator Guide


Edition 1.0
Energy Management Reports

production meters which are represented in the report as negative consumption


values.
See Consumption by Meter report for similar data organized by meter.
For each time period and for each meter the report includes the following data:
l Total consumption or production
l Consumption or production during occupied hours
l Consumption or production during unoccupied hours
l Maximum, minimum and average demand
The occupied and unoccupied time periods are configured during the configuration
for the report.
The report results are presented as a stacked vertical-bar chart and in tabular
format. The demand data is presented in tabular format.

Meters Included
The Consumption by Time report examines the Area/Meter List and includes the
data from the meter or meters from each item in the list. When it encounters an
item that contains no meters, it ignored that item and moves on to the next item in
the list.
When the item is a meter, then that meter is included in the report.
When the item is an area, building or region, then the child meters of that parent
are included in the report.
When the item is a meter group, then the meters in that group are included in the
report.

Limitations
Up to nine meters, areas, buildings, regions or meter groups can be included in
the report. Subsequent items in the Area/Meter List are ignored.

Report Parameters

Area/Meter List
The Area/Meter List specifies the areas, buildings, regions, and meters that you
want the report to include data for.
The Consumption by Time report is limited to the maximum number of items
indicated in Limitations.

© 2021 Delta Controls Inc. 179


Energy Management Reports

Meter Group
Meter Group lets you specify an empty group for the of Area/Meter List. You can
then add arbitrary areas, buildings, regions, and meters to that group. The report
is generated by grouping the data of the items in a group.
To learn how to create a meter group, see Creating a Meter Group.

Report Name
Report Name specifies the name of the link that appears in the Reports section of
enteliWEB's left pane tree view under Consumption by Time, when you save your
report.
Report Name specifies the subject text of the email message when the report is
sent by email.

Report Title
Report Title specifies the text that appears as the title of the report.

Meter Type
Meter Type specifies the type of energy or resource that the report includes data
for.
When you change Meter Type, you are forced to specify the Area/Meter List again.

Site
Site specifies the site name that you want to appear on the report for site.
Site can be any arbitrary name. It does not have to be the same as a site that is
configured into enteliWEB.

Date Range
Date Range specifies the time period for the data over which the consumption and
demand data are reported.
When Custom is selected, the From and To fields are displayed.

From - Date Configuration


From specifies the date when the custom date range begins.

To - Date Configuration
To specifies the date when the custom date range ends.

180 enteliWEB 4.20 Operator Guide


Edition 1.0
Energy Management Reports

Group by
Group by specifies time intervals within the Date Range over which the
consumption is summed to provide a data point in the report.

Date/Time Format
Date/Time Format specifies the format of the date and time that is displayed in
the report.

From - Occupancy
From specifies the time of day when the occupied period begins for occupied days.

To - Occupancy
To specifies the time of day when the occupied period ends for occupied days.

Days - Occupancy
Days specifies the day or days of the week that are considered to be occupied days
for the report. Choose All, Weekdays or Weekends from the list or select Other to
allow you to specify the exact weekday or days you want to be the occupied days.
Choosing no occupied days does not work.

Consumption Comparison Report


About the Consumption Comparison Report
The Consumption Comparison report lets you view a comparison of the energy or
resource consumption of multiple meters, areas, buildings, regions and meter
groups.
The Consumption Comparison report contains consumption datapoints. No
demand, baseline, or target data is included. You can also include data from
production meters which are represented in the report as negative consumption
values.
For areas, buildings, regions and meter groups, the results compare the
calculated total consumptions for each time interval. The consumption of the
individual meters in each area, building, region and meter group are not shown in
these results.
The results can be reported in year, month, week or day intervals of comparison.

© 2021 Delta Controls Inc. 181


Energy Management Reports

Meters Included
The Consumption Comparison report examines the Area/Meter List and includes
the data from the meter or meters from each item in the list. When it encounters
an item that contains no meters, it ignored that item and moves on to the next
item in the list.
When the item is a meter, then that meter is included in the report.
When the item is an area, building or region, then the child meters of that parent
are included in the report.
When the item is a meter group, then the meters in that group are included in the
report.

Limitations
Up to 9 meters, areas, buildings, regions or meter groups can be included in the
report. The 10th and subsequent items in the Area/Meter List are ignored.

Report Parameters

Area/Meter List
The Area/Meter List specifies the areas, buildings, regions, and meters that you
want the report to include data for.
The Consumption Comparison report is limited to the maximum number of items
indicated in Limitations.

Meter Group
Meter Group lets you specify an empty group for the of Area/Meter List. You can
then add arbitrary areas, buildings, regions, and meters to that group. The report
is generated by grouping the data of the items in a group.
To learn how to create a meter group, see Creating a Meter Group.

Report Name
Report Name specifies the name of the link that appears in the Reports section of
enteliWEB's left pane tree view under Consumption Comparison, when you save
your report.
Report Name specifies the subject text of the email message when the report is
sent by email.

182 enteliWEB 4.20 Operator Guide


Edition 1.0
Energy Management Reports

Report Title
Report Title specifies the text that appears as the title of the report.

Meter Type
Meter Type specifies the type of energy or resource that the report includes data
for.
When you change Meter Type, you are forced to specify the Area/Meter List again.

Site
Site specifies the site name that you want to appear on the report for site.
Site can be any arbitrary name. It does not have to be the same as a site that is
configured into enteliWEB.

Date Range
Date Range specifies the time period for the data over which the comparison is
reported.
When Custom is selected, the From and To fields are displayed.

From - Date Configuration


From specifies the date when the custom date range begins.

To - Date Configuration
To specifies the date when the custom date range ends.

Group by
Group by specifies time intervals within the Date Range over which the
consumption is summed to provide a data point in the report.

Date/Time Format
Date/Time Format specifies the format of the date and time that is displayed in
the report.

© 2021 Delta Controls Inc. 183


Energy Management Reports

Consumption Target Report


About the Consumption Target Report
The Consumption Target report compares cumulative consumption data to target
data for multiple meters, areas, buildings, regions and meter groups, for a
specified time period.
For proper results, you must enter target data for the meters you want to include
in the report.
The consumption results are presented as a stacked area chart and in tabular
format. The target data is presented as a dashed line on the chart and in tabular
format.
The Consumption Target report extrapolates the target data to match the time
period you select for the report.

Meters Included
The Consumption Target report examines the Area/Meter List and includes the
data from the meter or meters from each item in the list. When it encounters an
item that contains no meters, it ignored that item and moves on to the next item in
the list.
When the item is a meter, then that meter is included in the report.
When the item is an area, building or region, then the child meters of that parent
are included in the report.
When the item is a meter group, then the meters in that group are included in the
report.

Limitations
Consumption data from up to 9 meters, areas, buildings, regions or meter groups
can be included in the report. The 10th and subsequent items in the Area/Meter
List are ignored.

Report Parameters

Area/Meter List
The Area/Meter List specifies the areas, buildings, regions, and meters that you
want the report to include data for.

184 enteliWEB 4.20 Operator Guide


Edition 1.0
Energy Management Reports

The Consumption Target report is limited to the maximum number of items


indicated in Limitations.

Meter Group
Meter Group lets you specify an empty group for the of Area/Meter List. You can
then add arbitrary areas, buildings, regions, and meters to that group. The report
is generated by grouping the data of the items in a group.
To learn how to create a meter group, see Creating a Meter Group.

Report Name
Report Name specifies the name of the link that appears in the Reports section of
enteliWEB's left pane tree view under Consumption Target, when you save your
report.
Report Name specifies the subject text of the email message when the report is
sent by email.

Report Title
Report Title specifies the text that appears as the title of the report.

Meter Type
Meter Type specifies the type of energy or resource that the report includes data
for.
When you change Meter Type, you are forced to specify the Area/Meter List again.

Site
Site specifies the site name that you want to appear on the report for site.
Site can be any arbitrary name. It does not have to be the same as a site that is
configured into enteliWEB.

Date Range
Date Range specifies the time period for the data over which the consumption
data is reported.
Select Custom when you want to specify a date range that is not covered by the
other options in the list.

From - Date Configuration


From specifies the date when the custom date range begins.

© 2021 Delta Controls Inc. 185


Energy Management Reports

To - Date Configuration
To specifies the date when the custom date range ends.

Group by
Group by specifies time intervals within the Date Range over which the
consumption is summed to provide a data point in the report.
Group by also affects how the target data is extrapolated to allow for an accurate
comparison for the time interval selected.

Date/Time Format
Date/Time Format specifies the format of the date and time that is displayed in
the report.

Contribution Comparison Report


About the Contribution Comparison Report
The Contribution Comparison report allows you compare the consumption or
production data between multiple meters, areas, buildings, regions or meter
groups as a percentage of the total consumption or production.
The comparison can be by year, month, week or day. The day or days of the week
that are included in the report can be selected.
The results are presented as a pie chart and in tabular format.

Meters Included
The Contribution Comparison report examines the Area/Meter List and includes
the data from the meter or meters from each item in the list. When it encounters
an item that contains no meters, it ignored that item and moves on to the next
item in the list.
When the item is a meter, then that meter is included in the report.
When the item is an area, building or region, then the child meters of that parent
are included in the report.
When the item is a meter group, then the meters in that group are included in the
report.

186 enteliWEB 4.20 Operator Guide


Edition 1.0
Energy Management Reports

Limitations
Up to 9 meters, areas, buildings, regions or meter groups can be included in the
report. The 10th and subsequent items in the Area/Meter List are ignored.

Report Parameters

Area/Meter List
The Area/Meter List specifies the areas, buildings, regions, and meters that you
want the report to include data for.
The Contribution Comparison report is limited to the maximum number of items
indicated in Limitations.

Meter Group
Meter Group lets you specify an empty group for the of Area/Meter List. You can
then add arbitrary areas, buildings, regions, and meters to that group. The report
is generated by grouping the data of the items in a group.
To learn how to create a meter group, see Creating a Meter Group.

Report Name
Report Name specifies the name of the link that appears in the Reports section of
enteliWEB's left pane tree view under Contribution Comparison, when you save
your report.
Report Name specifies the subject text of the email message when the report is
sent by email.

Report Title
Report Title specifies the text that appears as the title of the report.

Meter Type
Meter Type specifies the type of energy or resource that the report includes data
for.
When you change Meter Type, you are forced to specify the Area/Meter List again.

Site
Site specifies the site name that you want to appear on the report for site.
Site can be any arbitrary name. It does not have to be the same as a site that is
configured into enteliWEB.

© 2021 Delta Controls Inc. 187


Energy Management Reports

Measurement Direction
Select Production if you are comparing production data and select Consumption if
you are comparing consumption data.

Date Range
Date Range specifies the time period for the data over which the comparison is
reported.
When Custom is selected, the From and To fields are displayed.

From - Date Configuration


From specifies the date when the custom date range begins.

To - Date Configuration
From specifies the date when the custom date range ends.

Days
Days specifies which day or days of the week are included in the report. Choose
All, Weekdays or Weekends from the list or select Other to allow you to specify the
exact weekday or days you want in the report.

Date/Time Format
Date/Time Format specifies the format of the date and time that is displayed in
the upper right corner of the report.

Cost Ranking Report


About the Cost Ranking Report
The Cost Ranking report lets you view the costs associated with the consumption
and demand data for multiple meters, areas, buildings, regions and meter groups,
for a specified time period and in specified time intervals.
For proper results you must configure the rate schedule and rate engine for the
meters you want to include in the report.
The cost results for the sum of consumption and demand costs are presented as a
vertical bar chart. The cost results for consumption and demand are presented
separately in tabular format.

188 enteliWEB 4.20 Operator Guide


Edition 1.0
Energy Management Reports

Meters Included
The Cost Ranking report examines the Area/Meter List and includes the data from
the meter or meters from each item in the list. When it encounters an item that
contains no meters, it ignored that item and moves on to the next item in the list.
When the item is a meter, then that meter is included in the report.
When the item is an area, building or region, then the child meters of that parent
are included in the report.
When the item is a meter group, then the meters in that group are included in the
report.

Limitations
Consumption and demand data from up to 9 meters, areas, buildings, regions or
meter groups can be included in the report. The 10th and subsequent items in the
Area/Meter List are ignored.

Report Parameters

Area/Meter List
The Area/Meter List specifies the areas, buildings, regions, and meters that you
want the report to include data for.
The Cost Ranking report is limited to the maximum number of items indicated in
Limitations.

Meter Group
Meter Group lets you specify an empty group for the of Area/Meter List. You can
then add arbitrary areas, buildings, regions, and meters to that group. The report
is generated by grouping the data of the items in a group.
To learn how to create a meter group, see Creating a Meter Group.

Report Name
Report Name specifies the name of the link that appears in the Reports section of
enteliWEB's left pane tree view under Cost Ranking, when you save your report.
Report Name specifies the subject text of the email message when the report is
sent by email.

Report Title
Report Title specifies the text that appears as the title of the report.

© 2021 Delta Controls Inc. 189


Energy Management Reports

Meter Type
Meter Type specifies the type of energy or resource that the report includes data
for.
When you change Meter Type, you are forced to specify the Area/Meter List again.

Site
Site specifies the site name that you want to appear on the report for site.
Site can be any arbitrary name. It does not have to be the same as a site that is
configured into enteliWEB.

Date Range
Date Range specifies the time period for the data over which the costs are
reported.
Select Custom when you want to specify a date range that is not covered by the
other options in the list.

From - Date Configuration


To specifies the date when the custom date range begins.

To - Date Configuration
From specifies the date when the custom date range ends.

Date/Time Format
Date/Time Format specifies the format of the date and time that is displayed in
the report.

Cumulative Consumption Report


About the Cumulative Consumption Report
The Cumulative Consumption report lets you view the cumulative consumption for
multiple meters, areas, buildings, regions and meter groups, for a specified time
period and in specified time intervals.
The consumption results are presented as a stacked area chart and in tabular
format.

190 enteliWEB 4.20 Operator Guide


Edition 1.0
Energy Management Reports

Meters Included
The Cumulative Consumption report examines the Area/Meter List and includes
the data from the meter or meters from each item in the list. When it encounters
an item that contains no meters, it ignored that item and moves on to the next
item in the list.
When the item is a meter, then that meter is included in the report.
When the item is an area, building or region, then the child meters of that parent
are included in the report.
When the item is a meter group, then the meters in that group are included in the
report.

Limitations
Consumption data from up to 9 meters, areas, buildings, regions or meter groups
can be included in the report. The 10th and subsequent items in the Area/Meter
List are ignored.

Report Parameters

Area/Meter List
The Area/Meter List specifies the areas, buildings, regions, and meters that you
want the report to include data for.
The Cumulative Consumption report is limited to the maximum number of items
indicated in Limitations.

Meter Group
Meter Group lets you specify an empty group for the of Area/Meter List. You can
then add arbitrary areas, buildings, regions, and meters to that group. The report
is generated by grouping the data of the items in a group.
To learn how to create a meter group, see Creating a Meter Group.

Report Name
Report Name specifies the name of the link that appears in the Reports section of
enteliWEB's left pane tree view under Cumulative Consumption, when you save
your report.
Report Name specifies the subject text of the email message when the report is
sent by email.

© 2021 Delta Controls Inc. 191


Energy Management Reports

Report Title
Report Title specifies the text that appears as the title of the report.

Meter Type
Meter Type specifies the type of energy or resource that the report includes data
for.
When you change Meter Type, you are forced to specify the Area/Meter List again.

Site
Site specifies the site name that you want to appear on the report for site.
Site can be any arbitrary name. It does not have to be the same as a site that is
configured into enteliWEB.

Group by
Group by specifies time interval in the Date Range over which the consumption is
summed to provide a data point in the report.

Date Range
Date Range specifies the time period for the data over which the consumption
data is reported.
Select Custom when you want to specify a date range that is not covered by the
other options in the list.

From - Date Configuration


From specifies the date when the custom date range begins.

To - Date Configuration
To specifies the date when the custom date range ends.

Date/Time Format
Date/Time Format specifies the format of the date and time that is displayed in
the report.

192 enteliWEB 4.20 Operator Guide


Edition 1.0
Energy Management Reports

Daily Average Report


About the Daily Average Report
The Daily Average report lets you compare the average demand for multiple
meters, areas, buildings or regions, or meter groups over a 24-hour period.
The Rollup parameter lets you set the time interval in minutes over which the
demand is averaged and presented as a data point on the report.
The Baseline parameters lets you add baseline data to the report.
The results are presented as a line chart and in tabular format.

Meters Included

This report uses demand datapoints only.

The Daily Average report examines the Area/Meter List and includes the data from
the meter or meters from each item in the list. When it encounters an item that
contains no meters, it ignored that item and moves on to the next item in the list.
When the item is a meter, then that meter is included in the report.
When the item is an area, building or region, then the child meters of that parent
are included in the report.
When the item is a meter group, then the meters in that group are included in the
report.

Limitations
Demand data from up to 8 meters, areas, buildings, regions or meter groups can
be included in the report. The ninth and subsequent items in the Area/Meter List
are ignored.

Report Parameters

Area/Meter List
The Area/Meter List specifies the areas, buildings, regions, and meters that you
want the report to include data for.
The Daily Average report is limited to the maximum number of items indicated in
Limitations.

© 2021 Delta Controls Inc. 193


Energy Management Reports

Meter Group
Meter Group lets you specify an empty group for the of Area/Meter List. You can
then add arbitrary areas, buildings, regions, and meters to that group. The report
is generated by grouping the data of the items in a group.
To learn how to create a meter group, see Creating a Meter Group.

Report Name
Report Name specifies the name of the link that appears in the Reports section of
enteliWEB's left pane tree view under Daily Average, when you save your report.
Report Name specifies the subject text of the email message when the report is
sent by email.

Report Title
Report Title specifies the text that appears as the title of the report.

Meter Type
Meter Type specifies the type of energy or resource that the report includes data
for.
When you change Meter Type, you are forced to specify the Area/Meter List again.

Site
Site specifies the site name that you want to appear on the report for site.
Site can be any arbitrary name. It does not have to be the same as a site that is
configured into enteliWEB.

Rollup Minutes
Rollup Minutes specifies the time interval in minutes over which the demand is
averaged for each data point on the report.

Date Range
Date Range specifies the time period for the data over which the average demand
is reported.
When Custom is selected, the From and To fields are displayed.

From - Date Configuration


From specifies the date when the custom date range begins.

194 enteliWEB 4.20 Operator Guide


Edition 1.0
Energy Management Reports

To - Date Configuration
To specifies the date when the custom date range ends.

Days
Days specifies which day or days of the week are included in the report. Choose
All, Weekdays or Weekends from the list or select Other to allow you to specify the
exact weekday or days you want in the report.

Date/Time Format
Date/Time Format specifies the format of the date and time that is displayed in
the upper right corner of the report.

Period - Baseline
Period displays the date range for the baseline data. When you specify Date Range
then Period adjusts automatically to match.

Offset By - Baseline
Offset By specifies the time period by which the baseline date range precedes the
date range for the current data.
For example, when Date Range is set to Previous Month and you want to show
baseline data for the same month of the previous year, then set Offset By to 12
months.
When Offset By is set to Other, the Starting Date field is displayed.

Starting Date - Baseline


Starting Date field is displayed when baseline Offset By field is set to Other.
Starting Date lets you specify the exact date for the beginning of the baseline data.

Degree Days Report


About the Degree Days Report
The Degree Days report lets you calculate heating and cooling degree days for a
specified date range and for a specified base temperature.
The results are presented as a line chart and in tabular format.

© 2021 Delta Controls Inc. 195


Energy Management Reports

Degree days are a form of weather data, calculated from readings of outside air
temperature. Heating degree days and cooling degree days are used extensively in
calculations relating to building energy consumption.
Heating degree days are a measure of how much and for how long the outside air
temperature was below the base temperature. The base temperature of a building
is the temperature below which the building needs to be heated.
Cooling degree days are a measure of how much and for how long the outside air
temperature was above the base temperature. The base temperature of a building
is the temperature above which the building needs to be cooled.

Outdoor Air Temperature Sample Rate


For best results, OAT samples should be taken at 15 minute intervals.
The OAT datapoint is imported, normalized and interpolated to 5 minute samples.

Meters Included
This report requires a single outdoor air temperature datapoint. No energy
meters are required or included in the report.

Limitations
Only 1 area and the data from the outdoor air temperature datapoint associated
with that area is used. When multiple areas each with an outdoor air temperature
datapoint are configured in Selected Area/Meter list, the report is based on one of
the outdoor air temperature datapoints.

Report Parameters

Selected Area/Meter List


The Selected Area/Meter List specifies the area, building, or region to which the
outdoor temperature datapoint is associated.
The Degree Days report is limited to the maximum number of outdoor
temperature datapoints indicated in Limitations.

Meter Group
It is not necessary to create a meter group for this report because the report uses
only one OAT datapoint.
To learn how to create a meter group, see Creating a Meter group.

196 enteliWEB 4.20 Operator Guide


Edition 1.0
Energy Management Reports

Report Name
Report Name specifies the name of the link that appears in the Reports section of
enteliWEB's left pane tree view under Degree Days, when you save your report.
Report Name specifies the subject text of the email message when the report is
sent by email.

Report Title
Report Title specifies the text that appears as the title of the report.

Site
Site specifies the site name that you want to appear on the report for site.
Site can be any arbitrary name. It does not have to be the same as the name of a
site that is configured into enteliWEB.

Base Temperature
Base Temperature specifies the outdoor temperature below which the building
needs to be heated and above which the building needs to be cooled.
The unit for Base Temperature is specified by Outdoor Temp on the Base Units
Configuration page.

Meter Type
No energy meters are required or included in the report. The Meter Type setting
has no effect on the degree-day report.

Date Range
Date Range specifies the time period for the data over which the degree days are
reported.
Select Custom when you want to specify a date range that is not covered by the
other options in the list.

From - Date Configuration


From specifies the date when the custom date range begins.

To - Date Configuration
To specifies the date when the custom date range ends.

© 2021 Delta Controls Inc. 197


Energy Management Reports

Group by
Group by specifies time intervals within the Date Range over which the degree
days are summed to provide a data point in the report.

Date/Time Format
Date/Time Format specifies the format of the date and time that is displayed in
the report.

Load Duration Report


About the Load Duration Report
The Load Duration report lets you identify loads that exceed a specified load level
or load mark. This report can used, for example, to analyze the results of load
shed strategies.
The Load Duration report displays the amount of time in hours that demand was
at various levels, over the specified date range.
The results are presented as a line chart and in tabular format. The specified load
mark is indicated by a horizontal dashed line.

Meters Included

This report uses demand datapoints only.

The Daily Average report examines the Area/Meter List and includes the data from
the meter or meters from each item in the list. When it encounters an item that
contains no meters, it ignored that item and moves on to the next item in the list.
When the item is a meter, then that meter is included in the report.
When the item is an area, building or region, then the child meters of that parent
are included in the report.
When the item is a meter group, then the meters in that group are included in the
report.

Limitations
Demand data from up to 8 meters, areas, buildings, regions or meter groups can
be included in the report. The ninth and subsequent items in the Area/Meter List
are ignored.

198 enteliWEB 4.20 Operator Guide


Edition 1.0
Energy Management Reports

Report Parameters

Area/Meter List
The Area/Meter List specifies the areas, buildings, regions, and meters that you
want the report to include data for.
The Load Duration report is limited to the maximum number of items indicated in
Limitations.

Meter Group
Meter Group lets you specify an empty group for the of Area/Meter List. You can
then add arbitrary areas, buildings, regions, and meters to that group. The report
is generated by grouping the data of the items in a group.
To learn how to create a meter group, see Creating a Meter Group.

Report Name
Report Name specifies the name of the link that appears in the Reports section of
enteliWEB's left pane tree view under Load Duration, when you save your report.
Report Name specifies the subject text of the email message when the report is
sent by email.

Report Title
Report Title specifies the text that appears as the title of the report.

Meter Type
Meter Type specifies the type of energy or resource that the report includes data
for.
When you change Meter Type, you are forced to specify the Area/Meter List again.

Site
Site specifies the site name that you want to appear on the report for site.
Site can be any arbitrary name. It does not have to be the same as a site that is
configured into enteliWEB.

Load Step
Load Step specifies the incremental amount of energy or resource demand for
which the time is summed to provide a data point in the report. For example, to
report the amount of time for every 5 kW increment in demand, set Load Step to 5.

© 2021 Delta Controls Inc. 199


Energy Management Reports

The unit of measure for Load Step is the same as for the type of energy or
resource that you specified for Meter Type.

Load Mark
Load Mark specifies the position of a horizontal dashed line on the report.
Typically, this line is interpreted as a demand load level or threshold you don't
want to exceed.
The unit of measure for Load Mark is the same as for the type of energy or
resource that you specified for Meter Type.

Date Range
Date Range specifies the time period for the data over which the demand is
reported.
When Custom is selected, the From and To fields are displayed.

From - Date Configuration


From specifies the date when the custom date range begins.

To - Date Configuration
To specifies the date when the custom date range ends.

Days
Days specifies which day or days of the week are included in the report. Choose
All, Weekdays or Weekends from the list or select Other to allow you to specify the
exact weekday or days you want in the report.

Date/Time Format
Date/Time Format specifies the format of the date and time that is displayed in
the upper right corner of the report.

Period - Baseline
Period displays the date range for the baseline data. When you specify Date Range
then Period adjusts automatically to match.

Offset By - Baseline
Offset By specifies the time period by which the baseline date range precedes the
date range for the current data.

200 enteliWEB 4.20 Operator Guide


Edition 1.0
Energy Management Reports

For example, when Date Range is set to Previous Month and you want to show
baseline data for the same month of the previous year, then set Offset By to 12
months.
When Offset By is set to Other, the Starting Date field is displayed.

Starting Date - Baseline


Starting Date field is displayed when baseline Offset By field is set to Other.
Starting Date lets you specify the exact date for the beginning of the baseline data.

Single Meter Occupancy Report


About the Single Meter Occupancy Report
The Single Meter Occupancy report lets you view the consumption and demand
data for 1 meter, area, building, region or meter group, for a specified time period
and in specified time intervals.
For the meter, area, building, region or meter group, the report includes the
following data:
l Total consumption
l Consumption during occupied hours
l Consumption during unoccupied hours
l Demand during occupied hours
l Demand during unoccupied hours
l Baseline during occupied hours
l Baseline during unoccupied hours
The consumption results are presented as a stacked vertical-bar chart and in
tabular format.
The demand results are presented as a line chart and in tabular format.

What meters are included


If there are no groups in the Area/Meter List, then the first meter in the list is
included in the report. If there are one or more groups in the Area/Meter List,
then the first group, area, or meter is included in the report.

Limitations
Data from one group, area, or meter is included in the report.

© 2021 Delta Controls Inc. 201


Energy Management Reports

Report Parameters

Area/Meter List
The Area/Meter List specifies the areas, buildings, regions, and meters that you
want the report to include data for.
The Single Meter Occupancy report is limited to the maximum number of items
indicated in Limitations.

Meter Group
Meter Group lets you specify an empty group for the of Area/Meter List. You can
then add arbitrary areas, buildings, regions, and meters to that group. The report
is generated by grouping the data of the items in a group.
To learn how to create a meter group, see Creating a Meter Group.

Report Name
Report Name specifies the name of the link that appears in the Reports section of
enteliWEB's left pane tree view under Single Meter Occupancy, when you save
your report.
Report Name specifies the subject text of the email message when the report is
sent by email.

Report Title
Report Title specifies the text that appears as the title of the report.

Meter Type
Meter Type specifies the type of energy or resource that the report includes data
for.
When you change Meter Type, you are forced to specify the Area/Meter List again.

Site
Site specifies the site name that you want to appear on the report for site.
Site can be any arbitrary name. It does not have to be the same as a site that is
configured into enteliWEB.

Date Range
Date Range specifies the time period for the data over which the data is reported.

202 enteliWEB 4.20 Operator Guide


Edition 1.0
Energy Management Reports

Select Custom when you want to specify a date range that is not covered by the
other options in the list.

From - Date Configuration


From specifies the date when the custom date range begins.

To - Date Configuration
To specifies the date when the custom date range ends.

Days - Date Configuration


Days specifies which day or days of the week are included in the report. Choose
All, Weekdays or Weekends from the list or select Other to allow you to specify the
exact weekday or days you want in the report.

Group by - Date Configuration


Group by specifies time intervals within the Date Range over which the
consumption is summed to provide a data point in the report.

Date/Time Format
Date/Time Format specifies the format of the date and time that is displayed in
the report.

From - Occupancy
From specifies the time of day when the occupied period begins for occupied days.

To - Occupancy
To specifies the time of day when the occupied period ends for occupied days.

Days - Occupancy
Days specifies the day or days of the week that are considered to be occupied days
for the report. Choose All, Weekdays or Weekends from the list or select Other to
allow you to specify the exact weekday or days you want to be the occupied days.
Choosing no occupied days does not work.

Period - Baseline
Period displays the date range for the baseline data. When you specify Date Range
then Period adjusts automatically to match.

© 2021 Delta Controls Inc. 203


Energy Management Reports

Offset By - Baseline
Offset By specifies the time period by which the baseline date range precedes the
date range for the current data.
For example, when Date Range is set to Previous Month and you want to show
baseline data for the same month of the previous year, then set Offset By to 12
months.
When Offset By is set to Other, the Starting Date field is displayed.

Starting Date - Baseline


Starting Date field is displayed when baseline Offset By field is set to Other.
Starting Date lets you specify the exact date for the beginning of the baseline data.

Energy Reports Tasks


Tasks on this page assume you are viewing an energy report page

Creating an Energy Report


For information about the configuration fields referred to in this procedure, see
the applicable report description page, as follows: Consumption Report,
Consumption by Meter Report, Consumption by Time Report, Consumption
Comparison Report, Consumption Target Report, Contribution Comparison
Report, Cost Ranking Report, Cumulative Consumption Report, Daily Average
Report, Load Duration Report, or Single Meter Occupancy Report.
1. In the Reports section of the left pane navigation tree, click the type of report
you want to create. The blank report template opens in the right pane.
2. Set Meter Type to the type of energy or resource data you want in the report.
3. If you plan to use one or more meter groups in the Selected Area/Meter List,
create them now. See Creating a Meter Group for the procedure.
4. Click to open the Area/Meter List.
5. Drag the meters, areas, buildings and regions you want for the report into
the Selected Area/Meter List.
The order that items are arranged in the Selected Area/Meter List
determines which meters are included in the report. On the applicable report
description page, see the Meters Included section for the report type you are
configuring, for information about what meters are included in the report.

204 enteliWEB 4.20 Operator Guide


Edition 1.0
Energy Management Reports

Meters for which access is denied are listed in the Area/Meter List, but you
are prevented from adding them to the Selected Area/Meter List.
6. Enter the Report Name, Report Title and Site information.
7. Set Date Range to a large time interval such as Year-to-Date. Set Group by to
Week or longer time interval.
8. Click Run to generate the report. When the report is displayed, review it
and make any changes you need to achieve your intended result.
9. Click Save to save the report and to add a link to the report in the Reports
section of the left pane navigation tree.

Creating a Degree Day Report


For information about the configuration fields referred to in this procedure, see
Degree Days Report.
1. In the Reports section of the left pane navigation tree, click Degree Days. The
blank report template opens in the right pane.
2. Set Meter Type to any of the types of energy that is metered. The areas,
buildings and regions are enabled in the Area/Meter List.
3. Drag the one area, building and region with the one outdoor air temperature
datapoint that you want for the report into the Selected Area/Meter List.
4. Enter the Report Name, Report Title and Site information.
5. Enter Date Configuration and other fields that pertain to the type of report
you are configuring.
6. Click Run to generate the report. When the report is displayed, review it
and make any changes you need to achieve your intended result.
7. Click Save to save the report and to add a link to the report in the Reports
section of the left pane navigation tree.

Creating a Meter Group


1. In the area titled Selected Area/Meter List, right-click the text Area/Meter
List. The Create button is displayed.
2. Click Create. A Meter Group folder titled New Group is added to the
Selected Area/Meter List.
3. Rename the Meter Group folder to suit your needs.

© 2021 Delta Controls Inc. 205


Building Automation (BAS) Reports Concepts
About Building Automation Reports
enteliWEB's Building Automation reports includes many types of reports allow you
to create and tailor reports that contain information obtained from devices,
objects and object properties on a site's BACnet network. You can report on one or
more sites.
Building Automation reports can be used for troubleshooting and for recording
information for future reference.

Offline Devices
Objects from devices that are offline are included in the report. No information is
provided for those objects.
In the report, objects from offline devices are indicated with red-colored text.

Calibration Report
About the Calibration Report
The Calibration report lets you list AI objects that are calibrated, for a given site.
An AI object is calibrated when the value of its Calibration property is not zero.
AI objects that are not calibrated are not included in the report.

Limitations
The report includes Delta devices only because Calibration is a Delta proprietary
object property.
The report's object filter limits the object types that you can include in this report.
The report is limited to 7000 records.

Report Parameters

Report Name
Report Name specifies the name of the link that appears in the Building
Automation section of enteliWEB's left pane tree view under Calibration, when you
save your report.

206 enteliWEB 4.20 Operator Guide


Edition 1.0
Building Automation (BAS) Reports Concepts

Report Name specifies the subject text of the email message when the report is
sent by email.

Report Title
Report Title specifies the text that appears as the title of the report.

Sites
The Sites field specifies the name of one or more enteliWEB sites that the report
includes information about.

Device Range
Device Range specifies the devices, by device address range, that you want to
include in the report.

Date/Time Format
Date/Time Format specifies the format you want to use in the report to display
date and time information.

Object Filter
Object Filter specifies one or more filter rules that define the objects and object
properties that you want to include in the report.

Commissioning Sheets Report


About the Commissioning Sheets Report
The Commissioning Sheets report lets you generate a comprehensive report for
input and output objects that are not commissioned. The report includes many
areas for you to make notes about the commissioning of each object.

Limitations
The object filter limits the object types that you can include in this report.
The report is limited to 7000 records.

© 2021 Delta Controls Inc. 207


Building Automation (BAS) Reports Concepts

Report Parameters

Report Name
Report Name specifies the name of the link that appears in the Building
Automation section of enteliWEB's left pane tree view under Commissioning
Sheets, when you save your report.
Report Name specifies the subject text of the email message when the report is
sent by email.

Report Title
Report Title specifies the text that appears as the title of the report.

Site
Site specifies the name of the enteliWEB site that the report includes information
about.

Device Range
Device Range specifies the devices, by device address range, that you want to
include in the report.

Date/Time Format
Date/Time Format specifies the format you want to use in the report to display
date and time information.

Object Filter
Object Filter specifies one or more filter rules that define the objects and object
properties that you want to include in the report.

Decommissioned and Fault Report


About the Decommissioned and Fault Report
The Decommissioned and Fault report lets you list objects that are not
commissioned or are in fault, for a given site.

Limitations
The report's object filter limits the object types that you can include in this report.
The report is limited to 7000 records.

208 enteliWEB 4.20 Operator Guide


Edition 1.0
Building Automation (BAS) Reports Concepts

Report Parameters

Report Name
Report Name specifies the name of the link that appears in the Building
Automation section of enteliWEB's left pane tree view under Decommissioned and
Fault, when you save your report.
Report Name specifies the subject text of the email message when the report is
sent by email.

Report Title
Report Title specifies the text that appears as the title of the report.

Sites
The Sites field specifies the name of one or more enteliWEB sites that the report
includes information about.

Device Range
Device Range specifies the devices, by device address range, that you want to
include in the report.

Date/Time Format
Date/Time Format specifies the format you want to use in the report to display
date and time information.

Object Filter
Object Filter specifies one or more filter rules that define the objects and object
properties that you want to include in the report.

Input Points Report


Input Points Report
The Input Points report lets you list AI, BI, MI and PI objects and important
associated information, for a given site.

Limitations
The report includes the PI object for Delta devices only as it is a Delta proprietary
object type.

© 2021 Delta Controls Inc. 209


Building Automation (BAS) Reports Concepts

The report's object filter limits the object types that you can include in this report.
The report is limited to 7000 records.

Report Parameters

Report Name
Report Name specifies the name of the link that appears in the Building
Automation section of enteliWEB's left pane tree view under Input Points, when
you save your report.
Report Name specifies the subject text of the email message when the report is
sent by email.

Report Title
Report Title specifies the text that appears as the title of the report.

Sites
The Sites field specifies the name of one or more enteliWEB sites that the report
includes information about.

Device Range
Device Range specifies the devices, by device address range, that you want to
include in the report.

Date/Time Format
Date/Time Format specifies the format you want to use in the report to display
date and time information.

Object Filter
Object Filter specifies one or more filter rules that define the objects and object
properties that you want to include in the report.

Objects in Manual Report


About the Objects in Manual Report
The Objects in Manual report lets you create a report about objects that are in
permanent or timed override, that is, are in manual, for a given site.

210 enteliWEB 4.20 Operator Guide


Edition 1.0
Building Automation (BAS) Reports Concepts

The Objects in Manual report includes information about the objects that you
specify with the Object Filter.
The Objects in Manual report includes information from the enteliWEB Log related
to the objects that you specify with the object filter.
The logic applied by the report to find applicable information in the Log is as
follows:
l Search the Log for records about objects that are in manual, for objects
specified with the object filter. Search is restricted to the time interval
specified by Date Range.
l Include information from the most recent record in the Log that shows the
object being set to manual
The information from the Log records that is included in the report is the
username of the user who set the object to manual and the date and time when
the object was set to manual.
Information from the Archive portion of the Log is not included in the report.

Limitations
The report is limited to 7000 records.

Report Parameters

Report Name
Report Name specifies the name of the link that appears in the Building
Automation section of enteliWEB's left pane tree view under Objects in Manual,
when you save your report.
Report Name specifies the subject text of the email message when the report is
sent by email.

Report Title
Report Title specifies the text that appears as the title of the report.

Sites
The Sites field specifies the name of one or more enteliWEB sites that the report
includes information about.

© 2021 Delta Controls Inc. 211


Building Automation (BAS) Reports Concepts

Device Range
Device Range specifies the devices, by device address range, that you want to
include in the report.

Date/Time Format
Date/Time Format specifies the format you want to use in the report to display
date and time information.

Object Filter
Object Filter specifies one or more filter rules that define the objects and object
properties that you want to include in the report.

Log Filter
Date Range

Date Range specifies the time interval for the records in the Log that are searched
for objects being set to manual, for objects specified by the Object Filter.
Information from records that occurred in the time interval is included in the
report. The time interval ends with the date and time that the report was
generated.
Information about objects in manual in records that occurred outside of the time
interval is not included in the report.
Include Objects Not Modified By enteliWEB

When Include Objects Not Modified By enteliWEB is selected, then all objects in
manual, for the objects specified by the object filter, whether or not there is a
record in the Log for the object being set to manual, are included in the report.
When Include Objects Not Modified By enteliWEB is not selected, then objects in
manual, for the objects specified by the object filter, for which there is no record
in the Log, within the specified date range, are not included in the report.

Object Query Report


About the Object Query Report
The Object Query report lets you create an ad hoc report that meets your exact
needs.

212 enteliWEB 4.20 Operator Guide


Edition 1.0
Building Automation (BAS) Reports Concepts

You are not limited as to the object types or object properties that you include in
the report.

Limitations
The report is limited to 7000 records.

Report Parameters

Report Name
Report Name specifies the name of the link that appears in the Building
Automation section of enteliWEB's left pane tree view under Object Query, when
you save your report.
Report Name specifies the subject text of the email message when the report is
sent by email.

Report Title
Report Title specifies the text that appears as the title of the report.

Sites
The Sites field specifies the name of one or more enteliWEB sites that the report
includes information about.

Device Range
Device Range specifies the devices, by device address range, that you want to
include in the report.

Date/Time Format
Date/Time Format specifies the format you want to use in the report to display
date and time information.

Object Filter
Object Filter specifies one or more filter rules that define the objects and object
properties that you want to include in the report.

© 2021 Delta Controls Inc. 213


Building Automation (BAS) Reports Concepts

Output Points Report


About the Output Points Report
The Output Points report lets you list AO, BO, LO and MO objects and important
associated information, for a given site.

Limitations
The report's object filter limits the object types that you can include in this report.
The report is limited to 7000 records.

Report Parameters

Report Name
Report Name specifies the name of the link that appears in the Building
Automation section of enteliWEB's left pane tree view under Output Points, when
you save your report.
Report Name specifies the subject text of the email message when the report is
sent by email.

Report Title
Report Title specifies the text that appears as the title of the report.

Sites
The Sites field specifies the name of one or more enteliWEB sites that the report
includes information about.

Device Range
Device Range specifies the devices, by device address range, that you want to
include in the report.

Date/Time Format
Date/Time Format specifies the format you want to use in the report to display
date and time information.

Object Filter
Object Filter specifies one or more filter rules that define the objects and object
properties that you want to include in the report.

214 enteliWEB 4.20 Operator Guide


Edition 1.0
Building Automation (BAS) Reports Concepts

Trend Log Report


About the Trend Log Report
The Trend Log report lets you configure a chart with one or more plots of TL
object samples and a table of TL object samples.
The Trend Log report lets you report across multiple sites.

Limitations
This report is limited to TL objects only.
Up to eight TL objects can be included.
Values of datatype Bitstring cannot be recognized and displayed correctly in the
report.
When you want to generate a trend log report with a chart when a large number of
samples is involved, see Plotting Large Number of Samples for limitations.

Report Parameters

Report Name
Report Name specifies the name of the link that appears in the Building
Automation section of enteliWEB's left pane tree view under Trend Log, when you
save your report.
Report Name specifies the subject text of the email message when the report is
sent by email.

Report Title
Report Title specifies the text that appears as the title of the report.

Trend Setup
Trend Setup specifies the TL objects for the source of samples that are plotted in
the chart and lets you specify which Y axis is associated with each TL object.
Up to eight TL objects can be included.

Date Configuration
Date Configuration specifies the time period for the TL objects samples that are
plotted and over which the Statistics are derived.

© 2021 Delta Controls Inc. 215


Building Automation (BAS) Reports Concepts

Date Range
When Custom is selected, the From and To fields are displayed.

From - Date Configuration


From specifies the date and time when the custom range begins.

To - Date Configuration
To specifies the date and time when the custom range ends.

Date/Time Format
Date/Time Format specifies the format you want to use in the report to display
date and time information.

Sample Configuration

Sample Roll Up
Sample Roll Up is an optional setting that lets you specify how the TL objects
samples data for the plot are rolled up or aggregated over a specified time
interval. You can perform one of three types of aggregation calculations to arrive
at the roll up value that is plotted.

The roll up capability is applicable only for TL objects that obtain sample
data from analog objects. Roll up doesn't work for TL objects that obtain
sample from binary or multi-state objects.

Interval
Interval specifies the time interval over which the aggregation function operates.

Aggregation Function
The aggregation function operates over the samples in Interval to calculate a
value of more significant meaning or measurement.
Min - lowest value of all samples in Interval
Max - highest value of all samples in Interval
Average - arithmetic mean value of all samples in Interval

216 enteliWEB 4.20 Operator Guide


Edition 1.0
Building Automation (BAS) Reports Concepts

Decimal Precision
Decimal Precision specifies the number of digits that follow the decimal point, in
the range from 0 to 10 digits, in the samples included in the report.

Report Format

Chart options
Show Chart

Select Show Chart when you want the report to include a plot of the samples or
aggregated data.

It is recommended that you do not select Show Chart when generating a


report with a large number of samples. Attempting to generate a report
with a chart for a large number of samples will take a long time and may
not succeed.

When Show Chart is not selected then the report shows the information in tabular
form.
Show Markers

Select Show Markers when you want the plotted samples to be indicated by
markers.
Select Show Chart to enable Show Markers.
When the number of samples is greater than 3,000, markers are not displayed,
even when Show Markers is selected.
Show Tooltip

Select Show Tooltip when you want the value of a plotted sample to be displayed
when you hover the mouse pointer over a marker.
Select Show Chart to enable Show Tooltip.
When the number of samples is greater than 10,000, tooltips are not displayed,
even when Show Tooltip is selected.
Y1 Axis Label

Y1 Axis Label specifies the text for the label shown on the chart for the Y1 axis.

© 2021 Delta Controls Inc. 217


Building Automation (BAS) Reports Concepts

Y2 Axis Label

Y2 Axis Label specifies the text for the label shown on the chart for the Y2 axis.

Show Statistics
Select Show Statistics when you want the report to include a table of minimum,
maximum and average data over the specified date range.

Plotting a Large Number of Samples


Generating a report with a chart for a large number of samples will take a long
time and may not succeed.
To avoid failing to generate a report with a chart when a large number of samples
is involved, the report generator behaves as follows.
l When the number of samples is greater than 3,000, markers are not
displayed, even when Show Markers is selected.
l When the number of samples is greater than 10,000, tooltips are not
displayed, even when Show Tooltip is selected.
In some cases, the report generator becomes stuck in the loading state and never
finishes. To reduce the possibility of this happening, it is recommended that you
increase the heap memory available for Birtrunner as described in Max Memory
and Min Memory for Birtrunner Process.
If you want to generate a report with a chart for a large number of samples then it
is recommended that the heap memory available for Birtrunner is increased, as
described in Max Memory and Min Memory for Birtrunner Process.

Advanced Object Filter

The following advanced object filter information applies to the object


filter used by BAS reports and to the advanced object filter used by the
Object List.

An advanced object filter specifies the object types, object instances, object
properties and comparison operators that determines what information is
included in the report or in the object list.
An advanced object filter consists of one or more filters. When there is more than
one filter specified, enteliWEB performs a logical OR of the filters when it
generates the report or the Object List page.

218 enteliWEB 4.20 Operator Guide


Edition 1.0
Building Automation (BAS) Reports Concepts

An advanced object filter is defined by the following parameters.

Object Type
Object Type specifies the object types that you want to include in the report or on
the Object List page.
For a report, the list of object types available to choose from includes only those
types that are applicable to the purpose of the report.
For the object list, the list of object types available to choose from includes all
object types.
IP lists input object types. Input object types are AI, BI, MI, PC and PI objects.
OP lists output object types. Output object types are AO, BO, MO and LO objects.

Instance Range
Instance Range specifies one or more object instance numbers or a range of
instance numbers that you want to include in the report or on the Object List page,
for the object types you specify.

Property
Property includes one or more property rules.
When one object type is specified, all properties are listed including
subproperties.
When multiple object types are specified, properties that are common to all
specified object types are listed. Sub-properties are not including.
When wildcard object type is specified, all properties are listed. Sub-properties
are not including.
When you enter a property name, only alphabetic characters, numbers and *_-.[ ]
are accepted.

Rule
A rule specifies the object properties and property values that must be present to
include the object types and instances in the report or the Object List page.
The rules engine supports the following comparison operators.
= equal
> greater than
>= greater than or equal

© 2021 Delta Controls Inc. 219


Building Automation (BAS) Reports Concepts

< less than


<= less than or equal
<> not equal
Rules can be logically ANDed or ORed.
The rules engine supports rules with the following types of arguments.

Property Value Example Rule


Numeric value
Objects with COV_Increment greater than or equal
to 15
String value
Objects with temperature in their object name
Date and time value
Date format: yyyy-mm-dd
example: 2017-02-14
Time format:
HH:mm:ss.hh where hh is
Use the EV object's time of transition. For example,
hundredths of a second,
searching for event transitions that occurred during
example: 07:35:15.00
a certain time frame.
Combined date and time
format: yyyy-mm-
ddTHH:mm:ss.hh where T
is a separator character
NULL value

Output objects that don't have a control source.


Technically, it should be all 16 priority array
elements = NULL when there is no control source.
Priority 5, 8 and 10 are the common priority levels
that are used for the control source.

220 enteliWEB 4.20 Operator Guide


Edition 1.0
Building Automation (BAS) Reports Concepts

Property Value Example Rule


Don't care
Objects that have the COV_Increment property
regardless of its value.
That is, add a COV_Increment column to the Object
List page.
Group element

For object type = EV, objects that are configured for


the Out of Range algorithm and with the high limit
parameter greater than or equal to 5.
Union element

Union value
For object type = SCH, binary schedules that are in
the Off state.
Specific array index
Objects with state1 as the first entry in the State_
Text array.
Not supported: unspecified array index, for example,
State_Text[] = Off.

Building Automation Reports Tasks


Tasks on this page assume you are viewing a building automation report page

Creating a Building Automation Report


For information about the configuration fields referred to in this procedure, see
the applicable report description page, as follows: Calibration Report,
Commissioning Sheets Report, Decommissioned and Fault Report, Input Points

© 2021 Delta Controls Inc. 221


Building Automation (BAS) Reports Concepts

Report, Object Query Report, Objects in Manual Report, Output Points Report, or
Trend Log Report.
1. In the Building Automation section of the left pane navigation tree, click the
type of report you want to create. The blank report template opens in the
right pane.
2. Enter a Report Name.
3. Option: modify the Report Title.
4. Select the Site.
5. Enter a Device Range.
6. Select the Date/Time Format for the date and time that appears on the
report.
7. Option: click to modify or click to add to the Object Filter.
8. Select Hide Offline Devices as required.
9. Option: change the Report Orientation.
10. Option: click to modify or add to the Report Format.
11. Click Run to generate the report. When the report is displayed, review it
and make any changes you need to achieve your intended result.
12. Click Save to save the report and to add a link to the report in the Building
Automation section of the left pane navigation tree.

Objects from devices that are offline are included in the report and are
indicated with red-colored text. No information is provided for those
objects.

Creating a Trend Log Report


For information about the configuration fields referred to in this procedure, see
Trend Log Report.
1. In the Building Automation section of the left pane navigation tree, click
Trend Log. The blank report template opens in the right pane.
2. Enter a Report Name.
3. Optionally, modify the Report Title.
4. Select the TL objects that you want to include in the report, in the Trend
Setup area.
5. Configure the Date Range.

222 enteliWEB 4.20 Operator Guide


Edition 1.0
Building Automation (BAS) Reports Concepts

6. Select the Date/Time Format for the date and time that appears on the report
7. Option: configure the Sample Roll Up.
The roll up capability is applicable only for TL objects that obtain sample data
from analog objects. Roll up doesn't work for TL objects that obtain sample
from binary or multi-state objects.
8. Configure the Chart Options.
9. Option: change the Report Orientation.
10. Click Run to generate the report. When the report is displayed, review it
and make any changes you need to achieve your intended result.
11. Click Save to save the report and to add a link to the report in the Building
Automation section of the left pane navigation tree.

© 2021 Delta Controls Inc. 223


Version 3 Access Control Reports
Information on this page pertains to Version 3 access control.

About Version 3 Access Control Reports


enteliWEB's Version 3 (V3) access control reports allow you to create and tailor
reports that contain information obtained from access control activity, such as
card presentation and door events, on a site's BACnet network.
In the left pane navigation tree, indicates Version 3 access reports.
Access control reports can be used by security personnel to review card user
activity.

An access control report is limited to 8001 events. When your report filter
returns more than 8000 events, only 8001 events are included in the
report. The report indicates that it is limited by a message in red text.

There are five kinds of V3 access control reports available in enteliWEB:


l Card Access Activity. This report lets you list door and card user events
based on time.
l Card Access Activity by Card User. This report lists card user events by card
user name.
l Card User Activity by Door. This report lets you list card user events by door
name.
l Door Activity. This report lists door events by door name. You can also filter
by card user and event type.
l Transactions by Event Type. Allows you to list access control events by event
type.

Card Access Activity Report


The Card Access Activity report is a feature of a V3 access control system.

Card Access Activity Report


The Card Access Activity report lets you list door and card user events in
chronological order.

224 enteliWEB 4.20 Operator Guide


Edition 1.0
Version 3 Access Control Reports

Filters for card users, doors and event type allow you to narrow the report based
on your specific interest.

Limitations
The report is limited to 8000 events.

Report Parameters

Report Name
Report Name specifies the name of the link that appears in the Access Control
section of enteliWEB's left pane tree view under Card Access Activity, when you
save your report.
Report Name specifies the subject text of the email message when the report is
sent by email.

Report Title
Report Title specifies the text that appears as the title of the report.

Site
Site specifies the name of the enteliWEB site that the report includes information
about.

Report Orientation
Choose between landscape or portrait page orientation.

Date/Time Format
Date/Time Format specifies the format you want to use in the report to display
date and time information.

Date Range
Date Range specifies the time interval for events that you want to include in the
report.

Card Users
Card Users specifies a filter to allow you to narrow the report to the card users
that you are interested in viewing events for.

To add a new filter, click the icon. To remove a filter, click the icon. The
report has a default filter All (*) that adds all the card users to the report.

© 2021 Delta Controls Inc. 225


Version 3 Access Control Reports

Doors
Doors specifies a filter to allow you to narrow the report to the access control
doors that you are interested in viewing events for.

To add a new filter, click the icon. To remove a filter, click the icon. The
report has a default filter All (*) that adds all the access control doors to the
report.

Event Types
Event Types specifies a filter to allow you to narrow the report to the door and
card user events that you are interested in viewing.

To modify the filter, click the icon. The report has a default filter All (*) that
adds all event types to the report.

Card Number
Card Number specifies the one card number that you are interested in viewing
events for.

Site Code
Site Code specifies the one site code that you are interested in viewing events for

Card Access Activity by Card User Report


The Card Access Activity by Card User report is a feature of a V3 access control
system.

Card Access Activity by Card User Report


The Card Access Activity by Card User report lets you list card user events sorted
and grouped by card user name.
Filters for card users, doors and event type allow you to narrow the report based
on your specific interest.

Limitations
The report is limited to 8000 events.

226 enteliWEB 4.20 Operator Guide


Edition 1.0
Version 3 Access Control Reports

Report Parameters

Report Name
Report Name specifies the name of the link that appears in the Access Control
section of enteliWEB's left pane tree view under Card Access Activity by Card
User, when you save your report.
Report Name specifies the subject text of the email message when the report is
sent by email.

Report Title
Report Title specifies the text that appears as the title of the report.

Site
Site specifies the name of the enteliWEB site that the report includes information
about.

Report Orientation
Choose between landscape or portrait page orientation.

Date/Time Format
Date/Time Format specifies the format you want to use in the report to display
date and time information.

Date Range
Date Range specifies the time interval for events that you want to include in the
report.

Card Users
Card Users specifies a filter to allow you to narrow the report to the card users
that you are interested in viewing events for.

To add a new filter, click the . To modify an existing filter, click the icon. To
remove a filter, click the icon.

Doors
Doors specifies a filter to allow you to narrow the report to the access control
doors that you are interested in viewing events for.

© 2021 Delta Controls Inc. 227


Version 3 Access Control Reports

To add a new filter, click the icon. To remove a filter, click the icon. The
report has a default filter All (*) that adds all the access control doors to the
report.

Event Types
Event Types specifies a filter to allow you to narrow the report to the card user
events that you are interested in viewing.

To modify an existing filter, click the icon. The report has a default filter All (*)
that adds all the event types to the report.

Card Number
Card Number specifies the one card number that you are interested in viewing
events for.

Site Code
Site Code specifies the one site code that you are interested in viewing events for.

Card User Activity by Door Report


The Card Access Activity by Door report is a feature of a V3 access control system.

Card User Activity by Door Report


The Card User Activity by Door report lets you list card user events sorted and
grouped by access control door name.
Filters for card users, doors and event type allow you to narrow the report based
on your specific interest.
The Card User Activity by Door report lets you select from both door and card user
event types only.

Limitations
The report is limited to 8000 events.

Report Parameters

Report Name
Report Name specifies the name of the link that appears in the Access Control
section of enteliWEB's left pane tree view under Card Access Activity by Door,

228 enteliWEB 4.20 Operator Guide


Edition 1.0
Version 3 Access Control Reports

when you save your report.


Report Name specifies the subject text of the email message when the report is
sent by email.

Report Title
Report Title specifies the text that appears as the title of the report.

Site
Site specifies the name of the enteliWEB site that the report includes information
about.

Report Orientation
Choose between landscape or portrait page orientation.

Date/Time Format
Date/Time Format specifies the format you want to use in the report to display
date and time information.

Date Range
Date Range specifies the time interval for events that you want to include in the
report.

Card Users
Card Users specifies a filter to allow you to narrow the report to the card users
that you are interested in viewing events for.

To add a new filter, click the icon. To remove a filter, click the icon. The
report has a default filter All (*) that adds all the card users to the report.

Doors
Doors specifies a filter to allow you to narrow the report to the access control
doors that you are interested in viewing events for.

To add a new filter, click the . To modify an existing filter, click the icon. To
remove a filter, click the icon.

Event Types
Event Types specifies a filter to allow you to narrow the report to the door and
card user events that you are interested in viewing.

© 2021 Delta Controls Inc. 229


Version 3 Access Control Reports

To modify an existing filter, click the icon. The report has a default filter All (*)
that adds all the event types to the report.

Card Number
Card Number specifies the one card number that you are interested in viewing
events for.

Site Code
Site Code specifies the one site code that you are interested in viewing events for.

Door Activity Report


The Door Activity report is a feature of a V3 access control system.

Door Activity Report


The Door Activity report lets you list door events sorted and grouped by access
control door name.
Filters for card users, doors and event type allow you to narrow the report based
on your specific interest.
The Door Activity report lets you select from door event types only.

Limitations
The report is limited to 8000 events.

Report Parameters

Report Name
Report Name specifies the name of the link that appears in the Access Control
section of enteliWEB's left pane tree view under Door Activity, when you save your
report.
Report Name specifies the subject text of the email message when the report is
sent by email.

Report Title
Report Title specifies the text that appears as the title of the report.

230 enteliWEB 4.20 Operator Guide


Edition 1.0
Version 3 Access Control Reports

Site
Site specifies the name of the enteliWEB site that the report includes information
about.

Report Orientation
Choose between landscape or portrait page orientation.

Date/Time Format
Date/Time Format specifies the format you want to use in the report to display
date and time information.

Date Range
Date Range specifies the time interval for events that you want to include in the
report.

Card Users
Card Users specifies a filter to allow you to narrow the report to the card users
that you are interested in viewing events for.

To add a new filter, click the icon. To remove a filter, click the icon. The
report has a default filter All (*) that adds all the card users to the report.

Doors
Doors specifies a filter to allow you to narrow the report to the access control
doors that you are interested in viewing events for.

To add a new filter, click the icon. To remove a filter, click the icon. The
report has a default filter All (*) that adds all the access control doors to the
report.

Event Types
Event Types specifies a filter to allow you to narrow the report to the door events
that you are interested in viewing.

To modify an existing filter, click the icon. The report has a default filter All (*)
that adds all the event types to the report.

Card Number
Card Number specifies the one card number that you are interested in viewing
events for.

© 2021 Delta Controls Inc. 231


Version 3 Access Control Reports

Site Code
Site Code specifies the one site code that you are interested in viewing events for.

Transactions by Event Type Report


The Transactions by Event Type report is a feature of a V3 access control system.

Transactions by Event Type Report


The Transactions by Event Type report lets you list access control events sorted
and grouped by event type.
The Transactions by Event Type report lets you select from all possible event
types.
Filters for card users, doors and event type allow you to narrow the report based
on your specific interest.

Limitations
The report is limited to 8000 events.

Report Parameters

Report Name
Report Name specifies the name of the link that appears in the Access Control
section of enteliWEB's left pane tree view under Transactions by Event Type, when
you save your report.
Report Name specifies the subject text of the email message when the report is
sent by email.

Report Title
Report Title specifies the text that appears as the title of the report.

Site
Site specifies the name of the enteliWEB site that the report includes information
about.

Report Orientation
Choose between landscape or portrait page orientation.

232 enteliWEB 4.20 Operator Guide


Edition 1.0
Version 3 Access Control Reports

Date/Time Format
Date/Time Format specifies the format you want to use in the report to display
date and time information.

Date Range
Date Range specifies the time interval for events that you want to include in the
report.

Card Users
Card Users specifies a filter to allow you to narrow the report to the card users
that you are interested in viewing events for.

To add a new filter, click the icon. To remove a filter, click the icon. The
report has a default filter All (*) that adds all the card users to the report.

Doors
Doors specifies a filter to allow you to narrow the report to the access control
doors that you are interested in viewing events for.

To add a new filter, click the icon. To remove a filter, click the icon. The
report has a default filter All (*) that adds all the access control doors to the
report.

Event Types
Event Types specifies a filter to allow you to narrow the report to the access
control events that you are interested in viewing.

To modify an existing filter, click the icon. The report has a default filter All (*)
that adds all the event types to the report.

Card Number
Card Number specifies the one card number that you are interested in viewing
events for.

Site Code
Site Code specifies the one site code that you are interested in viewing events for.

© 2021 Delta Controls Inc. 233


Version 3 Access Control Reports

Version 3 Access Control Reports Tasks


Tasks on this page assume you are viewing a Version 3 (V3) access control report
page.

An access control report is limited to 8001 events. When your report filter
returns more than 8000 events, only 8001 events are included in the
report. The report indicates that it is limited by a message in red text.

Creating a Version 3 (V3) Access Control Report


1. In the Access Control section of the left pane navigation tree, click the type of
report you want to create. The blank report template opens in the right pane.
2. Enter a Report Name.
3. Option: modify the Report Title.
4. Select the Site.
5. Select the Date/Time Format.
6. Select a Date Range.
7. Option: click to modify or click to add to Card Users. See Finding a
Card User by Name and Finding a Card User by Keyword for details.
8. Option: click to modify or click to add to Doors. See Finding a Door by
Name and Finding a Door by Keyword for details.
9. Option: click to modify or click to add to Event Types. See Selecting
Event Types for details.
10. Option: add or modify a Card Number.
11. Option: add or modify a Site Code.
12. Option: change the Report Orientation.
13. Option: Modify the look of the report. In Report Format, click to open the
Edit Report Format dialog.
14. Click Run to generate the report. When the report is displayed, review it
and make any changes you need to achieve your intended result.
15. Click Save to save the report and to add a link to the report in the Access
Control section of the left pane navigation tree.

234 enteliWEB 4.20 Operator Guide


Edition 1.0
Version 3 Access Control Reports

Finding a Card User by Name


A report for card users that are selected by name includes events for those card
users only.
1. In the Find Card Users dialog, select Find and Select by Name.
2. Enter a partial card user name to narrow down the list of card users.
3. Select one or more card users from the list.
4. Click OK.

Finding a Card User by Keyword


A report for card users that are identified by keyword includes events for all card
users with the keyword in their name. When you add card users with names that
match the keyword, they will be included in the report.
1. In the Find Card Uses dialog, select Find by Keyword.
2. Enter a partial card user name to narrow down the list of card users. For
keyword rules, see Find by Keyword Rules.
3. Click OK when the list contains only the card users that you want to include
in the report.

Finding a Door by Name


1. In the Find Doors dialog, select Find and Select by Name.
2. Enter a partial door name to narrow down the list of doors.
3. Select one or more doors from the list.
4. Click OK.

Finding a Door by Keyword


A report for doors that are identified by keyword includes events for all doors with
the keyword in their name. When you add a door with a name that matches the
keyword, it will be included in the report.
1. In the Doors dialog, select Find by Keyword.
2. Enter a partial door name to narrow down the list of doors. For keyword
rules, see Find by Keyword Rules.
3. Click OK when the list contains only the doors that you want to include in the
report.

© 2021 Delta Controls Inc. 235


Version 3 Access Control Reports

Selecting Event Types


The event types available depend on whether you are creating a by card user or a
by door report. The Transactions by Event Type report lets you select from all
possible event types.
1. In the Select Event Types dialog, select the types of events that you want to
include in the report.
2. Click OK.

236 enteliWEB 4.20 Operator Guide


Edition 1.0
O3 Access Control Reports
Information on this page pertains to the O3 Access system.

About O3 Access Control Reports


enteliWEB's O3 Access reports allow you to create and tailor reports that contain
information obtained from access control activity, such as credential presentation
and access door events, on a site's BACnet network.
The access control reports can be used by security personnel to review access
user activity or determine who has access to specific doors.

In the left pane navigation tree, indicates O3 Access reports.

An O3 Access control report is limited to 8000 events.

There are three kinds of O3 Access control reports available in enteliWEB:


l Access Report. This report lets you list door and card user events by card
user name, time or by door name.
l Who Has Access Report. This report lets you list card users by the doors they
have access to, and the allowed access times.
l Who Is In. This report lets you find out who has entered and exited a space
based on their card reader scans.

O3 Access Control Reports Tasks


The O3 Access Control reports are part of the Delta O3 Access Control system.
The reports extract and present information created in the O3 Access dashboards.

Before You Begin


The O3 Access Control reports discussed in this help topic are only available when
enteliSYNC is installed and running on the enteliWEB server.
Configure the EVC7 object on every controller that generates O3 access events by
adding the enteliWEB server as a specific destination. This must be the
workstation address for the enteliWEB server that receives the access events.
Avoid using BROADCAST as a destination.

© 2021 Delta Controls Inc. 237


O3 Access Control Reports

Creating an Access Report for O3 Access Control System


The Access Report lists door and card user events by card user name, time, or by
door name.
1. In the Reports section of the left pane navigation tree, click Access Control to
expand the node, and then click Access Report. The blank report template
opens in the right pane.
2. Enter a Report Name.
3. If you want, modify the Report Title.
4. Select the Site.
5. Select the Report Orientation.
6. Select the Date/Time Format.
7. Select a Date Range.
8. Select a Time Range.
9. Select the Days to include in the report.
10. If you want, adjust the Max Results value and select Most Recent or Least
Recent.
11. To filter by Access Role, Access User, or User Status, click to open the
filter settings or click to modify them. See Finding an Access User by
Name and Finding an Access User by Keyword for more details.
12. To further refine the Access User(s) filter, next to Extended User Information,
click to open the filter settings or click to modify them. Select a
boolean operator in Condition Operator to create a logical relationship
between the Access User(s) and Extended User Information filters. See
Extended Info section in the O3 Access report help topic for more details.
13. To filter by Access Doors(s), click to open the filter settings or click to
modify them. See Finding an Access Door by Name and Finding an Access
Door by Keyword for more details.
14. To include only specific event types, next to Event Types, click to modify
the list of event types. See Selecting Event Types for details.
15. To modify the look of the report, in Report Format, click to modify the
report format settings.
16. Click Run to generate the report. When the report is displayed, review it
and make any changes you need to achieve your intended result.
17. Click Save to save the report and to add a link to the report in the Access
Control / Access Report section of the left pane navigation tree.

238 enteliWEB 4.20 Operator Guide


Edition 1.0
O3 Access Control Reports

Creating a Who Has Access Report for O3 Access Control System


The Who Has Access Report lists card users by the doors they have access to and
the allowed access times.
1. In the Reports section of the left pane navigation tree, click Access Control to
expand the node, and then click Who Has Access Report. The blank report
template opens in the right pane.
2. Enter a Report Name.
3. If you want, modify the Report Title.
4. Select the Site.
5. Select the Report Orientation.
6. To filter by Access User(s), click to open the filter settings or click to
modify them. See Finding an Access User by Name and Finding an Access
User by Keyword for more information.
7. You can further refine the list of access users by creating a filter using
Extended User Information. Click to open the filter settings or click to
modify them. Select a boolean operator in Condition Operator to create a
logical relationship between the Access User(s) and Extended User
Information filters. See Extended Info section in the O3 Access report help
topic for more details.
8. To filter by Access Doors(s), click to open the filter settings or click to
modify them. See Finding an Access Door by Name and Finding an Access
Door by Keyword for more information.
9. To modify the look of the report, in Report Format, click to modify the
report format settings.
10. Click Run to generate the report. When the report is displayed, review it
and make any changes you need to achieve your intended result.
11. Click Save to save the report and to add a link to the report in the Access
Control / Access Report section of the left pane navigation tree.

Creating a Who Is In Access Report for O3 Access Control System


The Who Is In report shows who has entered or exited a space based on their last
card reader scan.
1. In the Reports section of the left pane navigation tree, click Access Control to
expand the node, and then click Who Is In. The blank report template opens
in the right pane.
2. Enter a Report Name.

© 2021 Delta Controls Inc. 239


O3 Access Control Reports

3. If you want, modify the Report Title.


4. Select the Site.
5. Select the Report Orientation.
6. Select the Date Range to enter a reporting period.
7. Select the Time Range to further filter the events that occurred during the
reporting period.
8. To filter by Access Role(s), click to open the filter settings or click to
modify them.
9. You can further refine the list of access roles by creating a filter using
Extended User Information. Click to open the filter settings or click to
modify them. Select a boolean operator in Condition Operator to create a
logical relationship between the Access Role(s) and Extended User
Information filters. See Extended Info section in the O3 Access report help
topic for more details.
10. To filter by Entry Access Door(s), click to open the filter settings or click
to modify them. See Finding an Access Door by Name and Finding an
Access Door by Keyword for more details.
11. If you want, click to modify the Entry Event Type(s). The default selected
event types are typical ones generated by card reader scans.
12. To filter by Exit Access Door(s), click to open the filter settings or click
to modify them. See Finding an Access Door by Name and Finding an Access
Door by Keyword for more details.
13. If you want, click to modify the Exit Event Type(s). The default selected
event types are typical ones generated by card reader scans.
14. To modify the look of the report, in Report Format, click to modify the
report format settings.
15. Click Run to generate the report. When the report is displayed, review it
and make any changes you need to achieve your intended result.
16. Click Save to save the report and to add a link to the report in the Access
Control / Access Report section of the left pane navigation tree.

Finding an Access User by Name

A report for access users that are selected by name includes events for
those access users only.

240 enteliWEB 4.20 Operator Guide


Edition 1.0
O3 Access Control Reports

1. In the Find Access Users dialog, select Find and Select by Name.
2. Enter a partial access user name to narrow down the list of access users.
3. Select one or more access users from the list.
4. Click OK.

Finding an Access User by Keyword

A report for access users that are identified by keyword includes events
for all access users with the keyword in their name. Any access user with
a name that matches the keyword is included in the report.

1. In the Find Access Users dialog, select Find by Keyword.


2. Enter a partial access user name to narrow down the list of access users. For
keyword rules, see Find by Keyword Rules.
3. Click OK when the list contains only the access users that you want to include
in the report.

Finding an Access Door by Name


1. In the Find Access Doors dialog, select Find and Select by Name.
2. Enter a partial door name to narrow down the list of doors.
3. Select one or more doors from the list.
4. Click OK.

Finding an Access Door by Keyword

A report for doors that are identified by keyword includes events for all
doors with the keyword in their name. When you add a door with a name
that matches the keyword, it will be included in the report.

1. In the Access Doors dialog, select Find by Keyword.


2. Enter a partial door name to narrow down the list of doors. For keyword
rules, see Find by Keyword Rules.
3. Click OK when the list contains only the doors that you want to include in the
report.

© 2021 Delta Controls Inc. 241


O3 Access Control Reports

Selecting Event Types


1. In the Select Event Types dialog, select the types of events that you want to
include in the report.
2. Click OK.

242 enteliWEB 4.20 Operator Guide


Edition 1.0
Document Revision History

Document Revision History


Edition Date Description
1.0 December 2021 First publication to support enteliWEB version 4.20.

© 2021 Delta Controls Inc. 243


www.deltacontrols.com

You might also like

pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy