Vous êtes sur la page 1sur 1720

10 Licensing Introduction

10.1 Licensing Overview

10.1 Licensing Overview


Building Operation is free-to-download software that is available for all to download
and install. However, you need valid licenses to use Building Operation. The number
of users of the software is limited to the number of licenses owned by the customer.

10.1.1 License System


When setting up a new Building Operation system, you need to consider the size of
the system, its structure, and the number of licenses to order and distribute.
For more information, see section 10.2 License System on page 210.

10.1.2 License Management


A Building Operation license system consists of, for example, a License Server,
WorkStation with client tools, and the Enterprise Server. The number of each
component varies depending on the system size and architecture.
For more information, see section 10.3 License Management on page 212.

10.1.3 Service and Maintenance


The license policy in Building Operation is strictly controlled and is sensitive to any
changes on the License Server, both hardware and software.
For more information, see section 10.4 Service and Maintenance on page 214.

04-17005-03-en, October 2015 System


209
10 Licensing Introduction
10.2 License System

10.2 License System


When setting up a new Building Operation system, you need to consider the size of
the system, its structure, and the number of licenses to order and distribute.
Place the License Server on a dedicated computer owned by the customer. When
you need to repair or move a network license, the request must come from the
License Server that was used to activate the license.
Locate the License Server and the Enterprise Server on the same server to avoid
unexpected license problems caused by network problems. Use the address
@localhost so the Enterprise Server cannot connect to the License server through
the network.
Ensure that the License Server has access to the Internet and to the local area
network. The Internet access is only necessary when performing tasks that require
communication with the License Activation Server, hosted by Schneider Electric,
such as activating or returning licenses on your License Server. Instant access to
the local area network ensures that licensed WorkStations, client tools, and
Enterprise Servers can smoothly check out and check in licenses.

Note
For security reasons, the Internet access can be disconnected when
communication with the License Activation Server is not needed.

10.2.1 License Activation Server


The License Activation Server is the server controlled by Schneider Electric to
manage the activation of licenses on customers License Servers. The License
Activation Server also handles return commissions. All communication between the
License Server and the License Activation Server is managed through the License
Administrator.

10.2.2 License Server


The License Server manages the administration of network licenses. A
SmartStruxure solution system running with network licenses must contain at least
one License Server.
For more information, see section 13.1 License Server on page 271.

10.2.3 License Administrator


The License Administrator administers the activation, return, and repair of licenses.
For more information, see section 13.14 License Administrator on page 292.

System 04-17005-03-en, October 2015


210
10 Licensing Introduction
10.2 License System

10.2.4 Licenses
Building Operation uses two types of licenses: the network license and the local
license. Network licenses are the most common type of license in Building
Operation. With network licenses, only the number of licenses that are used at the
same time are required. The local license is often time limited and used to test and
run a system that is under construction.
For more information, see section 10.6 Licenses on page 217.

04-17005-03-en, October 2015 System


211
10 Licensing Introduction
10.3 License Management

10.3 License Management


A Building Operation license system consists of, for example, a License Server,
WorkStation with client tools, and the Enterprise Server. The number of each
component varies depending on the system size and architecture.
In this example, the License Server and Enterprise Server are located on the same
computer. Several WorkStations check out licenses from the License Server
through the local area network. Network licenses are activated on the License
Server by the License Activation Server that is controlled by Schneider Electric.

Figure: WorkStation system with License Server and Enterprise Server on same computer
and WorkStation in separate computers, one computer with client tool.

10.3.1 License System Installation and Configuration


Schneider Electric recommends that you install the license server framework before
other Building Operation software or SmartStruxure server devices. The license
server installation is included in the License Administrator license package. During
the installation of WorkStation or Enterprise Server, the installation software asks for
the address to the license server.
For more information, see section 4.3 Installation Example on page 75.

System 04-17005-03-en, October 2015


212
10 Licensing Introduction
10.3 License Management

10.3.2 Network License Management


When you activate a license, the license is transferred from the License Activation
Server to your License Server. When activating a license, details about the
transaction and registration details are stored with the license on the License
Server.
For more information, see section 11.2 Network License Management on page
237.

10.3.3 Local License Management


A local license is activated from a license file with the extension .asr. Local licenses
must be activated to a dedicated WorkStation or Enterprise Server computer. The
local license cannot be distributed and shared between different computers as the
network license can.
For more information, see section 11.11 Local License Management on page
257.

04-17005-03-en, October 2015 System


213
10 Licensing Introduction
10.4 Service and Maintenance

10.4 Service and Maintenance


The license policy in Building Operation is strictly controlled and is sensitive to any
changes on the License Server, both hardware and software.

10.4.1 License Service Maintenance


Building Operation licenses are controlled by license policies regarding the
transaction of licenses. Therefore, it is important that a replacement or reinstallation
of the license server is carefully planned.
For more information, see section 13.13 License Server Maintenance on page
289.

10.4.2 License Maintenance


Before you move a network license, you have to return the license to the License
Activation Server. If the license is not correctly returned before changes are made
on the License Server, the license can become broken or lost.
For more information, see section 10.5 License Maintenance on page 216.

10.4.3 Diagnostics
In License Administrator, Diagnostics view, you can view information about all local
licenses and network licenses located on the License Server. This information is
essential for the product support service or when troubleshooting. To forward the
information to a troubleshooter who does not have access to your system, paste
the information in an e-mail message.

System 04-17005-03-en, October 2015


214
10 Licensing Introduction
10.4 Service and Maintenance

Figure: Diagnostic list with information about all licenses located on the License server,
WorkStation or Enterprise Server.

04-17005-03-en, October 2015 System


215
10 Licensing Introduction
10.5 License Maintenance

10.5 License Maintenance


Before you move a network license, you have to return the license to the License
Activation Server. If the license is not correctly returned before changes are made
on the License Server, the license can become broken or lost.

10.5.1 Local License Removal


Local licenses, activated from license files cannot be returned or reused.
You cannot reactivate a removed local license.
To remove a local license, you use the License Administrator on the WorkStation or
Enterprise Server where the local license is activated.

10.5.2 Network License Return


To return a network license means that a license is transferred from the License
Server back to the License Activation Server. A returned network license, located
on the License Activation Server, is not available for the WorkStation or Enterprise
Server to check out.
For more information, see section 11.4 Network License Return on page 241.

10.5.3 Lost License


If the License Server, WorkStation, or Enterprise Server physically crash and you
cannot retain activated licenses, the licenses are lost. Activated licenses cannot be
reactivated by the License Activation Server.
For more information, see section 10.11 Lost License on page 225.

10.5.4 License Repair


A license can in several ways become damaged. Use the License Administrator to
repair a damaged network license on the License Server where the damaged
license is located. Local licenses cannot be repaired. Instead you have to remove
the damaged local licenses and reactivate the licenses from new license files.
For more information, see section 10.12 License Repair on page 226.

10.5.5 License Backup


Schneider Electric recommends backing up the License Server files on a regular
basis. To back up the license files, copy all files in the folder to an external resource.
This backup is primarily intended for cases when hardware or the operating system
malfunctions.
For more information, see section 10.13 License Backup on page 227.

System 04-17005-03-en, October 2015


216
10 Licensing Introduction
10.6 Licenses

10.6 Licenses
Building Operation uses two types of licenses: the network license and the local
license. Network licenses are the most common type of license in Building
Operation. With network licenses, only the number of licenses that are used at the
same time are required. The local license is often time limited and used to test and
run a system that is under construction.
The Building Operation license policy consists of the following licenses:

Table: Building Operation Licenses


License File Name Description

Client Station client.station Use this license to start and


run WorkStation.

Client tool licenses client.graphiceditor This license product group


consists of several products,
client.script each required to run the
client.functionblock.view corresponding client tool.
Licensing of WorkPlace Tech
is included with the Script
Editor license.

Enterprise Server server.enterprise.base Use this license to start and


run an Enterprise Server.

License files used to activate time-limited local licenses can be distributed under
certain circumstances.
For more information, see section 11.10 Local Licenses on page 256.
For more information on how to order licenses, please contact your Building
Operation vendor.

10.6.1 End User License Agreement


When installing Building Operation, make sure that you agree with the Schneider
Electric terms and conditions. For operators or other positions that do not install the
software, please refer to the End User License Agreement (EULA) document
distributed by Schneider Electric.

10.6.2 Local Licenses


A local license installs on the client or License Server from a license file with the
extension .asr. The local license is bound to the computer and cannot be shared.
The license file used to activate local licenses can only be used once per computer
and is typically time-limited.
For more information, see section 11.10 Local Licenses on page 256.

04-17005-03-en, October 2015 System


217
10 Licensing Introduction
10.6 Licenses

10.6.3 Network Licenses


Network licenses are distributed from the License Server. The License Server
shares a predetermined number of simultaneous instances that are available
network-wide. To start licensed clients and SmartStruxure servers using network
licenses, the required number of licenses have to be available on the License
Server.
For more information, see section 11.1 Network Licenses on page 233.

10.6.4 Time-Limited Licenses


A time-limited license is a license that gives license rights for a predetermined
period of time, usually 30 days. When the time period is over, the license expires.
These licenses are distributed as local licenses.

Note
To avoid critical stops, purchase permanent licenses before the time limited-
licenses expire.

10.6.5 Permanent License


A permanent license does not expire.

Note
To avoid critical stops, purchase permanent licenses before the time limited-
licenses expire.

10.6.6 License Selection Process


When a licensed WorkStation, client tool, or Enterprise Server starts, it first checks if
a local license is available. If a local license is not available or has expired, the
WorkStation or Enterprise Server checks out a network license from a License
Server. If no license is available, the WorkStation, client tool, or Enterprise Server
does not start.
For more information, see section 10.9 License Selection Process on page 222.

System 04-17005-03-en, October 2015


218
10 Licensing Introduction
10.7 Viewing Activated Licenses

10.7 Viewing Activated Licenses


You view all the activated licenses on the License Server, WorkStation, or
Enterprise Server.
For more information, see section 10.6 Licenses on page 217.

To view activated licenses


1. In License Administrator, click the Licenses view.

All licenses activated on the License Server, WorkStation, or Enterprise Server are
listed.

04-17005-03-en, October 2015 System


219
10 Licensing Introduction
10.8 Editing Registration Details

10.8 Editing Registration Details


You must add your registration details before licenses can be activated. The
registration details are written to the license details when a license is activated.

Note
You need to enter the customer details before a licenses is activated.
Only English letters are allowed in the license details.

For more information, see section 13.14 License Administrator on page 292.

To edit registration details


1. In License Administrator, click the Registration Details view.

2. In the License owner box, type the name of the organization that owns the
license.
3. In the Industry box, select the license owners field of business.
4. In the Type of project boxes, select the proposed field of application for the
license.
5. In the Name box, type the name of the account manager that supplied the
license.
6. In the E-mail box, type the e-mail address to the account manager that
supplied the license.
Continued on next page

System 04-17005-03-en, October 2015


220
10 Licensing Introduction
10.8 Editing Registration Details

7. In the Telephone number box, type the telephone number to the account
manager that supplied the license.

8. Click OK.
9. Click Yes.

Any changes in the registration details updates all activated licenses on the License
Server.

Note
The customer details must be edited or updated individually on all License
Servers.

04-17005-03-en, October 2015 System


221
10 Licensing Introduction
10.9 License Selection Process

10.9 License Selection Process


When a licensed WorkStation, client tool, or Enterprise Server starts, it first checks if
a local license is available. If a local license is not available or has expired, the
WorkStation or Enterprise Server checks out a network license from a License
Server. If no license is available, the WorkStation, client tool, or Enterprise Server
does not start.

Figure: The Building Operation selection process flow for which license to use, local or
network license.

System 04-17005-03-en, October 2015


222
10 Licensing Introduction
10.10 Order Information Request

10.10 Order Information Request


To receive order information from the License Activation Server, you need the
Entitlement ID of the order. The entitlement ID is the designation that represents
the license purchased by the customer. This ID is included in the Entitlement
Certificate that is sent by e-mail when an order is approved.
For more information on how to order a license, contact your local Building
Operation vendor.

Figure: Entitle Certificate with entitlement ID

Figure: Work flow when requesting order information

04-17005-03-en, October 2015 System


223
10 Licensing Introduction
10.10 Order Information Request

Table: Request Order Information


Number Description

1 The Entitlement ID, which contains the


licenses to activate, is entered into the
License Administrator.

2 The License Administrator sends the


entitlement ID to the License Activation
Server.

3 The License Activation Server sends the


order information to the License
Administrator.

The order information contains information about all licenses included in the
Entitlement Certificate.

System 04-17005-03-en, October 2015


224
10 Licensing Introduction
10.11 Lost License

10.11 Lost License


If the License Server, WorkStation, or Enterprise Server physically crash and you
cannot retain activated licenses, the licenses are lost. Activated licenses cannot be
reactivated by the License Activation Server.
To regain lost licenses when no backup exits, contact the Building Operation
product support. Product support performs a manual return of the lost licenses on
the License Activation Server. Once the licenses are manually returned, you can
reactivate them on a new License Server by using the original entitlement ID of the
licenses.

04-17005-03-en, October 2015 System


225
10 Licensing Introduction
10.12 License Repair

10.12 License Repair


A license can in several ways become damaged. Use the License Administrator to
repair a damaged network license on the License Server where the damaged
license is located. Local licenses cannot be repaired. Instead you have to remove
the damaged local licenses and reactivate the licenses from new license files.
Licenses can be damaged by the following actions:
Copying licenses from one system to another. This is an illegal action.
Restoring a License Server backup.
Adjusting the system clock to an earlier time.
Restoring the system to correct system problems or roll back changes.
Changing the Enterprise Server, License Server or WorkStation hardware
component.

Note
Repairing a network license requires access to the Internet.
You are only allowed to repair a license four times a year.
All repair actions are registered by the Activation Server and are traceable.

Figure: Damaged network license

System 04-17005-03-en, October 2015


226
10 Licensing Introduction
10.13 License Backup

10.13 License Backup


Schneider Electric recommends backing up the License Server files on a regular
basis. To back up the license files, copy all files in the folder to an external resource.
This backup is primarily intended for cases when hardware or the operating system
malfunctions.
Backed up licenses can only be restored on the same License Server that the files
were backed up from. If you plan to move the licenses to another License Servers,
you first have to return the licenses to the License Activtation Server and then
activate them on the new License Server.
The License Server files are located in the following locations:
Windows 7 and Windows 8.1: \ProgramData\FLEXnet
Windows Server 2008 and Windows Server 2012: \ProgramData\FLEXnet
Licenses restored from a backup can be considered damaged by the License
Server. For more information, see section 10.12 License Repair on page 226.

04-17005-03-en, October 2015 System


227
10 Licensing Introduction
10.14 Backing Up Licenses

10.14 Backing Up Licenses


You back up licenses to easily restore them if something unexpected happens.
For more information, see section 10.13 License Backup on page 227.

To back up licenses
1. Close all Building Operation applications, such as License Administrator,
WorkStation, and Enterprise Server.
2. On the License Server, browse to the folder:
Windows 7 and Windows 8.1: \ProgramData\FLEXnet
Windows Server 2008 and Windows Server 2012:
\ProgramData\FLEXnet
3. Copy all files in the FLEX-net folder that start with taclic_ and paste the files
onto your external backup resource.

System 04-17005-03-en, October 2015


228
10 Licensing Introduction
10.15 Restoring Licenses

10.15 Restoring Licenses


You restore the license data from a backup to restore a corrupt or non-functioning
License Server.
For more information, see section 10.13 License Backup on page 227.

To restore licenses
1. Close all Building Operation applications, such as License Administrator,
WorkStation, and Enterprise Server.
2. On the License Server, browse to the the folder:
Windows 7 and Windows 8.1: \ProgramData\FLEXnet\
Windows Server 2008 and Windows Server 2012:
\ProgramData\FLEXnet\
3. Paste all your backed up files to the FLEX-net folder.

Note
You may need to repair restored licenses before you check out
the restored licenses. For more information, see section 11.9
Repairing a Network License on page 254.

You now restart the License Server so you can check out the restored licenses. For
more information, see section 13.4 Restarting the License Server on page 274.

04-17005-03-en, October 2015 System


229
11 Type of Licenses

Topics
Network Licenses
Network License Management
Network Licenses Activation
Network License Return
Activating Network Licenses
Removing a Local License or Returning a Network License
Network License Upgrade
Upgrading Network Licenses
Repairing a Network License
Local Licenses
Local License Management
Activating a Local License
11 Type of Licenses
11.1 Network Licenses

11.1 Network Licenses


Network licenses are distributed from the License Server. The License Server
shares a predetermined number of simultaneous instances that are available
network-wide. To start licensed clients and SmartStruxure servers using network
licenses, the required number of licenses have to be available on the License
Server.

04-17005-03-en, October 2015 System


233
11 Type of Licenses
11.1 Network Licenses

Figure: A network license is activated on a License Server and can be checked out by any
computer in the network.

System 04-17005-03-en, October 2015


234
11 Type of Licenses
11.1 Network Licenses

To check out a network license from a License Server, you have to define the
License Server address where network licenses are available for checkout. You
define the address to the License Server when installing the licensed product. You
edit the License Server address either in the Windows registry or in License
Administrator, on the computer or SmartStruxure server that hosts the licensed
product.
A checked out network license is not physically moved to the client or
SmartStruxure server. The checked out license is allocated in the License Server
until the license is released by the client or SmartStruxure server.
When a licensed WorkStation, Enterprise Server, or client tool starts and no local
licenses are activated, the WorkStation or Enterprise Server searches the License
Server for an available network license. If an available network license is found, the
licensed product checks out the license and starts. If no licenses are available, the
licensed product does not start. When the application is closed, the license is
checked in on the License Server.

Figure: The WorkStation checks out license from the License Server.

Note
On the SmartStruxure server running both the License Server and the
Enterprise Server, use the address @localhost so the Enterprise Server does
not connect to the License Server through the network.

04-17005-03-en, October 2015 System


235
11 Type of Licenses
11.1 Network Licenses

Figure: License Server and Enterprise Server on same computer. The Enterprise Server
checks out license from the License Server that is defined in the shared License
Administrator.

System 04-17005-03-en, October 2015


236
11 Type of Licenses
11.2 Network License Management

11.2 Network License Management


When you activate a license, the license is transferred from the License Activation
Server to your License Server. When activating a license, details about the
transaction and registration details are stored with the license on the License
Server.
The examples in these sections are adaptable on all Building Operation systems
including the systems where License Server, WorkStation, and Enterprise Server
are located on the same computer.
The license activation procedure consists of four steps:
Request order information
Activate network license on License Server
Configure Enterprise Servers address to the License Server
Configure WorkStations address to the License Server

11.2.1 Order Information Request


To receive order information from the License Activation Server, you need the
Entitlement ID of the order. The entitlement ID is the designation that represents
the license purchased by the customer. This ID is included in the Entitlement
Certificate that is sent by e-mail when an order is approved.
For more information, see section 10.10 Order Information Request on page 223.

11.2.2 Network Licenses Activation


To activate a network license means that a license is transferred from the License
Activation Server, hosted by Schneider Electric, to your License Server. Once
activated, the network license is available for use.
For more information, see section 11.3 Network Licenses Activation on page 239.

11.2.3 Enterprise Server Address Configuration


After licenses are activated on the License Server, you configure the Enterprise
Server connection to the License Server. The address to the License Server is
defined either during the installation of Enterprise Server, through License
Administrator, or Windows registry.
For more information, see section 12.1 Enterprise Server Address Configuration
on page 263.

04-17005-03-en, October 2015 System


237
11 Type of Licenses
11.2 Network License Management

11.2.4 WorkStation and Client Tools Address


Configuration
After licenses are activated on the License Server you have to configure the
Workstation and its client tools connection to the License Server, where licenses
are available for check out. The address to the License Server is defined either
during the installation of WorkStation, through License Administrator, or Windows
registry.
For more information, see section 12.2 WorkStation and Client Tools Address
Configuration on page 265.

11.2.5 Network License Upgrade


When a new license version is released it is recommended that you upgrade your
old versions. Customers that have signed up for the Building Operation
Maintenance Subscription are automatically notified about the new upgrade and
can directly activate the newest version. If your organization does not have the
Building Operation Maintenance Subscription, contact your Building Operation
vendor to place an upgrade order.
For more information, see section 11.7 Network License Upgrade on page 248.

System 04-17005-03-en, October 2015


238
11 Type of Licenses
11.3 Network Licenses Activation

11.3 Network Licenses Activation


To activate a network license means that a license is transferred from the License
Activation Server, hosted by Schneider Electric, to your License Server. Once
activated, the network license is available for use.

Figure: Activation of network license on License Server by the License Activation Server
Use the License Administrator to activate a network license. When activating a
network license, the License Administrator on the receiving computer requests and
administrates the activation.

04-17005-03-en, October 2015 System


239
11 Type of Licenses
11.3 Network Licenses Activation

Figure: Work flow when activating licenses on License Server

Table: Activation of Licenses on License Server


Number Description

1 To activate a license, the registration details


need to be correctly entered.

2 The License Administrator sends an


activation request to the License Activation
Server. The activation request contains
information about the registration details and
the license to activate.

3 License Activation Server activates the


requested licenses on the License Server.
The registration details and the transaction
information are stored with the license on the
License Server.

The activated licenses are now available on the License Server. Before the License
Server can distribute the network licenses, the License Server has to be restarted.

System 04-17005-03-en, October 2015


240
11 Type of Licenses
11.4 Network License Return

11.4 Network License Return


To return a network license means that a license is transferred from the License
Server back to the License Activation Server. A returned network license, located
on the License Activation Server, is not available for the WorkStation or Enterprise
Server to check out.
When returning a license, all the licenses that were activated in the same session
are also returned. For example, if seven licenses are activated in the same activation
transaction, a single license cannot be returned to the License Activation Server.
To once again activate the returned licenses, use the entitlement ID that contains
the returned licenses.
This workflow describes the return transaction of licenses from a License Server to
the License Activation Server.

Figure: Returning a license from License Server to the License Activation Server

Table: Returning Licenses from License Server to the License Activation Server
Number Description

1 In the License Administrator, select the


licenses to return.

2 The License Administrator returns the


licenses to the License Activation Server.

04-17005-03-en, October 2015 System


241
11 Type of Licenses
11.4 Network License Return

Number Description

Note
All licenses that were activated in same transaction are returned to the
License Activation Server.

System 04-17005-03-en, October 2015


242
11 Type of Licenses
11.5 Activating Network Licenses

11.5 Activating Network Licenses


You activate network licenses, from the License Activation Server, to make network
licenses for WorkStations, Enterprise Servers and client tools available
networkwide.

Note
This procedure requires that an order is placed and the entitlement certificate
is received. For more information on how to place an order, contact your
Building Operation vendor.

For more information, see section 10.6 Licenses on page 217.

To activate network licenses


1. In License Administrator, click the Licenses view.

2. On the Licenses toolbar, click the Add license from entitlement ID button
.
Continued on next page

04-17005-03-en, October 2015 System


243
11 Type of Licenses
11.5 Activating Network Licenses

3. In the Enter license entitlement ID box, type the entitlement ID that


contains the licenses to activate.

Note
The entitlement ID is printed on the entitlement certificate.

4. Click OK.
5. In the Activate column, select the number of license to activate.

6. Click Activate.
Continued on next page

System 04-17005-03-en, October 2015


244
11 Type of Licenses
11.5 Activating Network Licenses

7. Click Close.

8. Click Restart now to restart the License Server and activate the network
license.

The activated licenses are now available on the License Server.

04-17005-03-en, October 2015 System


245
11 Type of Licenses
11.6 Removing a Local License or Returning a Network License

11.6 Removing a Local License or Returning


a Network License
You remove local licenses or return network licenses to the License Activation
Server. For example, you can clean up expired licenses from the Licenses view or
move network licenses to another License Server.

Note
You cannot reactivate a removed local license.
When you return a license to the License Activation Server, all the licenses
that were activated in the same transaction with that license are also
returned.

To remove a local license or return a network license


1. In License Administrator, click the Licenses view.

2. Select the local license to remove or the network license to return.

3. On the Licenses toolbar, click the Remove/return license button .


Continued on next page

System 04-17005-03-en, October 2015


246
11 Type of Licenses
11.6 Removing a Local License or Returning a Network License

4. Click Yes.

5. Click Close.

6. Click Restart now, to apply the changes to the License Server.

04-17005-03-en, October 2015 System


247
11 Type of Licenses
11.7 Network License Upgrade

11.7 Network License Upgrade


When a new license version is released it is recommended that you upgrade your
old versions. Customers that have signed up for the Building Operation
Maintenance Subscription are automatically notified about the new upgrade and
can directly activate the newest version. If your organization does not have the
Building Operation Maintenance Subscription, contact your Building Operation
vendor to place an upgrade order.
You activate the upgrade by using the same Entitlement ID as you used when
you first activated the licenses on your License Server. Before licenses with the new
version are activated, all licenses with the older version included in the Entitlement
Certification are returned to the License Activation Server.

Note
You cannot reactivate a returned license that has an old version.

Figure: License upgrade

Table: License Upgrade


Number Description

1 The Entitlement Certificate, which contains


the licenses to upgrade, is entered into the
License Administrator.

System 04-17005-03-en, October 2015


248
11 Type of Licenses
11.7 Network License Upgrade

Continued
Number Description

2 All licenses with old versions are returned to


the License Activation Server.

3 Licenses with the new version are activated


on the License Server.

04-17005-03-en, October 2015 System


249
11 Type of Licenses
11.8 Upgrading Network Licenses

11.8 Upgrading Network Licenses


You upgrade your licenses when new versions are released, for example, to get
access to new licensed features.
For more information, see section 11.7 Network License Upgrade on page 248.

To upgrade network licenses


1. In License Administrator, click the Licenses view.

Continued on next page

System 04-17005-03-en, October 2015


250
11 Type of Licenses
11.8 Upgrading Network Licenses

2. On the Licenses toolbar, click the Add license from entitlement ID button
.

3. In the Enter license entitlement ID box, type the entitlement ID that


contains the licenses to upgrade.

Note
The entitlement ID is printed on the entitlement certificate.

4. Click OK.
Continued on next page

04-17005-03-en, October 2015 System


251
11 Type of Licenses
11.8 Upgrading Network Licenses

5. In the Activate column, select the number of licenses with the new version to
activate.

Note
All licenses with old versions that are activated on the License
Server with this entitlement ID are returned.

6. Click Activate.
7. Click Yes to confirm that all network licenses with the old version, included in
the entitlement, are returned to the License Activation Server.

Continued on next page

System 04-17005-03-en, October 2015


252
11 Type of Licenses
11.8 Upgrading Network Licenses

8. Click Close.

9. Click Restart now, to restart the License Server and make the upgraded
licenses available for checkout.

04-17005-03-en, October 2015 System


253
11 Type of Licenses
11.9 Repairing a Network License

11.9 Repairing a Network License


You repair damaged network licenses so they become available to check out by
WorkStations, client tools, and Enterprise Servers.
For more information, see section 10.12 License Repair on page 226.

To repair a network license


1. In License Administrator, click the Licenses view.
2. Select the network license that you want to repair.

3. On the Licenses toolbar, click the Repair license button .


4. Click Yes.

Continued on next page

System 04-17005-03-en, October 2015


254
11 Type of Licenses
11.9 Repairing a Network License

5. Click Close.

6. Click Restart now, to restart the License Server and make the repaired
licenses available for checkout.

The license is now repaired and available to be checked out.

04-17005-03-en, October 2015 System


255
11 Type of Licenses
11.10 Local Licenses

11.10 Local Licenses


A local license installs on the client or License Server from a license file with the
extension .asr. The local license is bound to the computer and cannot be shared.
The license file used to activate local licenses can only be used once per computer
and is typically time-limited.

Figure: A local license is activated on the computer that will use it and cannot be shared
with other computers.
For more information on how to order additional licenses, please contact your
Schneider Electric vendor.

Note
After removing a local license, you must restart the computer or server before a
similar network license can be checked out.

System 04-17005-03-en, October 2015


256
11 Type of Licenses
11.11 Local License Management

11.11 Local License Management


A local license is activated from a license file with the extension .asr. Local licenses
must be activated to a dedicated WorkStation or Enterprise Server computer. The
local license cannot be distributed and shared between different computers as the
network license can.
For more information, see section 11.10 Local Licenses on page 256.
For more information on how to order additional license files or license files for client
tools, please contact your Building Operation vendor.

11.11.1 Local License Activation


Use the License Administrator on the WorkStation or Enterprise Server depending
of where to activate the local license.

Figure: Activation of local license on a WorkStation with a local license file

04-17005-03-en, October 2015 System


257
11 Type of Licenses
11.12 Activating a Local License

11.12 Activating a Local License


You activate a local license on a WorkStation, client tool, or Enterprise Server
computer, to have as a substitute until you have set up a Building Operation system
with available network licenses.
For more information, see section 11.10 Local Licenses on page 256.

Note
Plan the license management carefully and purchase licenses early to avoid
unexpected operational stops caused by expired time limit.
For more information on how to order local licenses for client tools, please
contact your Building Operation vendor.

For more information, see section 10.6 Licenses on page 217.

To activate a local license


1. In License Administrator, click the Licenses view.

2. On the Licenses toolbar, click the Add license from file button .
Continued on next page

System 04-17005-03-en, October 2015


258
11 Type of Licenses
11.12 Activating a Local License

3. Select the license file and then click Open.

4. Click Close.

Continued on next page

04-17005-03-en, October 2015 System


259
11 Type of Licenses
11.12 Activating a Local License

5. Click Restart now to restart the License Server and activate the local license.

The local license is now activated and the WorkStation, client tool or Enterprise
Server can start.

System 04-17005-03-en, October 2015


260
12 Licensing Configuration and
Diagnostics

Topics
Enterprise Server Address Configuration
WorkStation and Client Tools Address Configuration
Viewing Diagnostic Information
Copying Diagnostics to the Clipboard
12 Licensing Configuration and Diagnostics
12.1 Enterprise Server Address Configuration

12.1 Enterprise Server Address


Configuration
After licenses are activated on the License Server, you configure the Enterprise
Server connection to the License Server. The address to the License Server is
defined either during the installation of Enterprise Server, through License
Administrator, or Windows registry.

Figure: Enterprise Server configuration and check out/in of Enterprise Server network
license

Table: Enterprise Server Configuration


Number Description

1 Configure the Enterprise Server address to


the License Server.

2 Remove any activated local licenses.

3 When the Enterprise Server starts, it


automatically checks out an Enterprise
Server network license from the License
Server.

When the Enterprise Server starts, it automatically checks out an available network
license from a License Server. A checked out network license is not physically
moved to or activated on the Enterprise Server. The license remains in the License
Server but is allocated to the dedicated Enterprise Server. The license is therefore
not available for other SmartStruxure servers to check out.

04-17005-03-en, October 2015 System


263
12 Licensing Configuration and Diagnostics
12.1 Enterprise Server Address Configuration

Note
If the Enterprise Server does not start, refer to the Enterprise Server log for
more information. For more information, see section 15.8 Viewing Enterprise
Server System Log on page 318.

System 04-17005-03-en, October 2015


264
12 Licensing Configuration and Diagnostics
12.2 WorkStation and Client Tools Address Configuration

12.2 WorkStation and Client Tools Address


Configuration
After licenses are activated on the License Server you have to configure the
Workstation and its client tools connection to the License Server, where licenses
are available for check out. The address to the License Server is defined either
during the installation of WorkStation, through License Administrator, or Windows
registry.

Figure: WorkStation configuration and check in/out of client station network license and
client tool network licenses

Table: WorkStation Configuration


Number Description

1 Configure the WorkStation and client tool


address to the License Server.

2 Remove any activated local licenses.

3 When you logon to WorkStation or start a


client tool, the required license is
automatically checked out from the License
Server.

A checked out network license is not physically moved to or activated on


WorkStation. The client station and client tool licenses remain in the License Server
but are allocated to the dedicated WorkStation. The license is therefore not
available for other WorkStations to check out.

04-17005-03-en, October 2015 System


265
12 Licensing Configuration and Diagnostics
12.3 Viewing Diagnostic Information

12.3 Viewing Diagnostic Information


You view all licenses and the license details located on the License Server,
WorkStation, client tool, or Enterprise Server. This diagnostic information is helpful
when you are troubleshooting.
For more information, see section 10.4 Service and Maintenance on page 214.

To view diagnostic information


1. In License Administrator, click the Diagnostics view.

2. On the Diagnostics toolbar, click the Refresh the list button .

The diagnostics list is now populated with all licenses and license details located on
the License Server, WorkStation, client tool, or Enterprise Server.

System 04-17005-03-en, October 2015


266
12 Licensing Configuration and Diagnostics
12.4 Copying Diagnostics to the Clipboard

12.4 Copying Diagnostics to the Clipboard


You copy the diagnostics information to your clipboard and then paste the
information into a document or E-mail message.
For more information, see section 10.4 Service and Maintenance on page 214.

To copy the diagnostics to the clipboard


1. In License Administrator, click the Diagnostics view.

2. On the Diagnostics toolbar, click the Refresh the list button .

3. On the Diagnostics toolbar, click the Copy to clipboard button .


The diagnostics information is now on the clipboard so you can paste it into a
document or E-mail.

04-17005-03-en, October 2015 System


267
13 License Server and License
Administrator

Topics
License Server
Starting the License Server
Stopping the License Server
Restarting the License Server
Flexnet License Administrator, License Server Manager
Accessing Flexnet lmadmin
Changing the Flexnet lmadmin License Server Manager Port
Number
License Server Address
Configuring the Address to the License Server
License Server Reset
Resetting the License Server
Configuring License Server Recovery Settings
License Server Maintenance
License Administrator
Starting License Administrator
13 License Server and License Administrator
13.1 License Server

13.1 License Server


The License Server manages the administration of network licenses. A
SmartStruxure solution system running with network licenses must contain at least
one License Server.
The License Server is designed to not require user intervention. The License Server
is a Microsoft Windows service named Building Operation License Server. Because
of the lack of user interface and graphical notifications that display the status of the
License Server, it is recommended that you configure the License Server to
automatically restart if it unexpectedly stops. For more information, see section
13.12 Configuring License Server Recovery Settings on page 287.
You use the License Administrator to activate network licenses on the License
Server. The network licenses are then checked out from the License Server by
WorkStation, editors, or Enterprise Server. For more information, see section 13.14
License Administrator on page 292.

13.1.1 Flexnet License Manager, License Server


Manager
The License Server can be managed through a web-based administration tool
called FLEXnet License Administrator. You use the Administration part of the tool to
view system information and administer License Server user accounts, alerts, and
other configuration.
The FLEXnet License Administrator web page is hosted by the License Server. You
use a web browser to connect to the web page via HTTP or HTTPS. The default
protocol is HTTP through port 8888, that is on the License Server host itself:
http://localhost:8888. The default user name is "admin" and the default password is
"admin".
The License Server files are located in the following locations:
Windows 7and Windows 8.1: \ProgramData\FLEXnet
Windows Server 2008 and Windows Server 2012: \ProgramData\FLEXnet
For more information, see section 13.5 Flexnet License Administrator, License
Server Manager on page 275.

04-17005-03-en, October 2015 System


271
13 License Server and License Administrator
13.2 Starting the License Server

13.2 Starting the License Server


You manually start the License Server, if the service does not start automatically
with the operating system.
For more information, see section 13.1 License Server on page 271.

To start the License Server


1. On the License Server, open the Service management console.

Note
In Windows, open the Run dialog box and type services.msc.

2. Right-click Building Operation License Server.

3. Select Start.
For more information about the Service management console, please refer to the
operating system manufacturers manual.

System 04-17005-03-en, October 2015


272
13 License Server and License Administrator
13.3 Stopping the License Server

13.3 Stopping the License Server


You manually stop the License Server, if the service is running.
For more information, see section 13.1 License Server on page 271.

To stop the License Server


1. On the License Server computer, open the Service management console.
2. Right-click Building Operation License Server.

3. Select Stop.
For more information about the Service management console, please refer to the
operating system manufacturers manual.

04-17005-03-en, October 2015 System


273
13 License Server and License Administrator
13.4 Restarting the License Server

13.4 Restarting the License Server


You manually restart the License Server, for example, if the License Server stops to
respond or licenses on the License Server have been restored.
For more information, see section 13.1 License Server on page 271.

To restart the License Server


1. On the License Server, open the Service management console.

Note
In Windows, open the Run dialog box and type services.msc.

2. Right-click Building Operation License Server.

3. Select Restart.
For more information about the Service management console, please refer to the
operating system manufacturers manual.

System 04-17005-03-en, October 2015


274
13 License Server and License Administrator
13.5 Flexnet License Administrator, License Server Manager

13.5 Flexnet License Administrator, License


Server Manager
The License Server can be managed through a web-based administration tool
called FLEXnet License Administrator. You use the Administration part of the tool to
view system information and administer License Server user accounts, alerts, and
other configuration.
The FLEXnet License Administrator web page is hosted by the License Server. You
use a web browser to connect to the web page via HTTP or HTTPS. The default
protocol is HTTP through port 8888, that is on the License Server host itself:
http://localhost:8888. The default user name is "admin" and the default password is
"admin".
The Flexnet License Administrator has two main parts: Dashboard and
Administration. Use the Dashboard to view the status and information of the
licenses that are activated on the License Server. Alerts, such as status and expiring
licenses, are reported in the Alert pane.

Figure: FLEXnet License Administrator, Dashboard part.


Use the Administrator part to view the System information and administer Flexnet
License Administrator user accounts, alerts, License Server configuration, or vendor
daemon configuration.

04-17005-03-en, October 2015 System


275
13 License Server and License Administrator
13.5 Flexnet License Administrator, License Server Manager

Figure: FLEXnet License Administrator, Administration part.


For more information about FLEXnet License Administrator, click the FLEXnet

License Administrator Help button .

13.5.1 License Server Port Number


With a default installation, the License Server port range is set to 27000-27009. A
valid number is any unused port between 0 and 64000.

System 04-17005-03-en, October 2015


276
13 License Server and License Administrator
13.5 Flexnet License Administrator, License Server Manager

Figure: FLEXnet License Administrator, License Server Configuration


If the License Server uses other ports than the default port range 27000-27009, the
port has to be added in front of the @ in the License Server address on the
WorkStation, Enterprise Server, or Client tools.

For more information, click FLEXnet License Administrator Help button .

13.5.2 FLEXnet License Administrator Port Number


The port number to the FLEXnet License Administrator is configured in the file
server.xml located on the License Server. The path to the file is: C:\Program
Files\Schneider Electric StruxureWare\Building Operation x.x\License Server\conf,
where x.x is the version number. The port attribute is found within the webServer
tag.

Figure: The port attribute is embedded in the webServer tag.

04-17005-03-en, October 2015 System


277
13 License Server and License Administrator
13.6 Accessing Flexnet lmadmin

13.6 Accessing Flexnet lmadmin


You access Flexnet lmadmin to configure the settings of the License Server, for
example, change the port number to the License Server.
For more information, see section 13.5 Flexnet License Administrator, License
Server Manager on page 275.

To access Flexnet lmadmin


1. On a computer that has access to the network where the License Server to
configure is located, open a web browser.
2. In the address field, type the License Server IP or network. End the address
with colon and then the port number.

Note
Flexnet lmadmin has the HTTP protocol through port 8888 set as
the default. For example: http://162.192.10.1:8888
The default user name and password is: admin.

For more information, click the Flexnet lmadmin Help button .

System 04-17005-03-en, October 2015


278
13 License Server and License Administrator
13.7 Changing the Flexnet lmadmin License Server Manager Port Number

13.7 Changing the Flexnet lmadmin License


Server Manager Port Number
You change the port number of the Flexnet lmadmin License Server Manager if the
default port 8888 is dedicated to other application or blocked by your firewall.
For more information, see section 13.5 Flexnet License Administrator, License
Server Manager on page 275.

To change the Flexnet lmadmin License Server Manager port


number
1. On the License Server, open the folder \Program Files\Schneider
Electric StruxureWare\Building Operation x.x\License Server\conf,
where x.x is the version number.
2. Open the file server.xml with Notepad or other text or code editor.
3. In the Port attribute within the webServer tag, type the number to an
available port.

4. Save the file and close the editor.


5. Restart the License Server.
To access the Flexnet lmadmin License Server Manager, open a web browser and
type in the address to the License Server with the new port number.

04-17005-03-en, October 2015 System


279
13 License Server and License Administrator
13.8 License Server Address

13.8 License Server Address


During the installation of License Administrator on WorkStations or Enterprise
Servers, you need to type the network address to the License Server where
network licenses are available for check out. The address to the License Server can
later be entered or edited through License Administrator or directly in the Windows
registry of the computer or Enterprise Server that hosts the licensed product.
The License Server address is stored in the Windows registry key:
HKEY_LOCAL_MACHINE\SOFTWARE\Schneider Electric\StruxureWare\License
Administrator\TACLIC_LICENSE_FILE.
The address to a License Server must begin with @ and is either a hostname or IP
address. If the communication to the License Server is through a port other than the
default port range 27000-27009, the port number is defined in front of the @, Port-
number@hostname.

Table: Example of License Server Address


Address Description

19650@localhost Connects to localhost through port 19650

@server2c.schneider-electric.com Connects to License Server


server2c.schneider-electric.com through a
port in the default port range 27000-27009

14650@192.166.248.2 Connects to License Server 192.166.248.2


through port 14650

To separate License Server addresses in License Administrator, use a semicolon.

System 04-17005-03-en, October 2015


280
13 License Server and License Administrator
13.8 License Server Address

Figure: Example of License Server addresses in License Administrator


In this example, @localhost refers to this computer, through port 19650. For
example if a License Server and an Enterprise Server are located on the same
computer, the network address of the Enterprise Server to the License Server is
recommended to be @localhost.

04-17005-03-en, October 2015 System


281
13 License Server and License Administrator
13.9 Configuring the Address to the License Server

13.9 Configuring the Address to the License


Server
You configure the address to the License Server so the Enterprise Server,
WorkStation, or client tool knows where to find available licenses to check out.

Note
Before a WorkStation or Enterprise Server starts to check out network
licenses from a License Server, the local license in use must be removed. For
more information, see section 11.6 Removing a Local License or Returning a
Network License on page 246.

For more information, see section 11.2 Network License Management on page
237.

To configure the address to the License Server


1. In License Administrator, click the Licenses server address view.
Continued on next page

System 04-17005-03-en, October 2015


282
13 License Server and License Administrator
13.9 Configuring the Address to the License Server

2. In the License server address box, type @ and then type the address to
the License Server.

Note
The address must begin with an @.
If you use a port other than the default port of 27000, type the
port number in front of @. For example, 567@localhost.
Use a semicolon to separate addresses to different License
Servers.

3. Click Save.
Next time a WorkStation, client tool, or Enterprise Server starts, it checks out
available network licenses from a defined License Server.

Note
The License Server address is configured individually on all WorkStations and
Enterprise Servers.

04-17005-03-en, October 2015 System


283
13 License Server and License Administrator
13.10 License Server Reset

13.10 License Server Reset


If problems with the License Server or activated licenses occur, you may have to
reset the License Server. All details about activated licenses on the License Server
are compiled in files that start with "taclic" and has the .data extension. The file
name string after "taclic" can differ. An example of the License Server file name is
taclic_00249e00_tsf.data. The license details files are created the first time a license
is activated on the License Server. By deleting the files you reset the License Server.
The license files are located in the following locations:
Windows 7 and Windows 8.1: \ProgramData\FLEXnet
Windows Server 2008 and Windows Server 2012: \ProgramData\FLEXnet
Before deleting the License Server files, you have to return all activated network
licenses to the License Activation Server.

Note
If you delete the License Server files, all activated network licenses are lost.

System 04-17005-03-en, October 2015


284
13 License Server and License Administrator
13.11 Resetting the License Server

13.11 Resetting the License Server


You reset the License Server if it does not work correctly.

Caution
Return all the licenses to the License Activation Server before you reset the
License Server. Resetting the License Server erases the licenses on the
License Server.

For more information, see section 13.10 License Server Reset on page 284.

To reset the License Server


1. In License Administrator, click the Licenses view.
2. Select all network licenses.

3. On the Licenses toolbar, click the Remove/return license button .


Continued on next page

04-17005-03-en, October 2015 System


285
13 License Server and License Administrator
13.11 Resetting the License Server

4. Click Yes.

5. Click Close.

6. Close all running Building Operation programs.


7. Stop the License Server.
8. In the License Server application folder, remove all .data files that start with
taclic:
Windows 7 and Windows 8.1: \ProgramData\FLEXnet
Windows Server 2008 and Windows Server 2012:
\ProgramData\FLEXnet
9. Start the License Server.
10. Reactivate the returned network licenses.
When you reactivate all returned network licenses, new License Server .data files
are created together with the activation of the first license.

System 04-17005-03-en, October 2015


286
13 License Server and License Administrator
13.12 Configuring License Server Recovery Settings

13.12 Configuring License Server Recovery


Settings
You configure the License Server recovery settings to ensure that the License
Server restarts if it unexpectedly stops.
For more information, see section 13.1 License Server on page 271.

To configure the license server recovery settings


1. On the license server, open the Service management console.

Note
In Windows, open the Run dialog box and type services.msc.

2. Right-click Building Operation License Server.

3. Select Properties.
Continued on next page

04-17005-03-en, October 2015 System


287
13 License Server and License Administrator
13.12 Configuring License Server Recovery Settings

4. Click the Recovery tab.

5. In the First failure box, select Restart the Service.


6. In the Second failure box, select Restart the Service.
7. In the Subsequent failures box, select Restart the Service.
8. Click OK.

System 04-17005-03-en, October 2015


288
13 License Server and License Administrator
13.13 License Server Maintenance

13.13 License Server Maintenance


Building Operation licenses are controlled by license policies regarding the
transaction of licenses. Therefore, it is important that a replacement or reinstallation
of the license server is carefully planned.

13.13.1 License Server Address Change


If the License Server is assigned a new network address, all WorkStations and
Enterprise Servers must be updated with the new address.

13.13.2 License Server Reinstallation


When reinstalling a License Server, the licenses on the License Server are not
affected. All you have to do is to uninstall the License Server and then reinstall it.
The licenses on the License Server do not have to be returned to the License
Activation Server.

13.13.3 License Server Replacement


Before replacing the License Server hardware, return the licenses to the License
Activation Server and then activate the licenses on the new License Server.
You can also use this workflow when relocating licenses to another License Server.

04-17005-03-en, October 2015 System


289
13 License Server and License Administrator
13.13 License Server Maintenance

Figure: Replacing the License Server or moving licenses

Table: Replace of Licenses or Move of Licenses


Number Description

1 All licenses, located on the old License


Server, are returned to the License
Activation Server.

2 The License Activation Server activates the


licenses on the new License Server using the
entitlement ID that originally was used to
activate the licenses.

Make sure that the new License Server has the same network address as the
former License Server. If a new network address is assigned, update all
WorkStations and Enterprise Servers with the address to the new License Server.

System 04-17005-03-en, October 2015


290
13 License Server and License Administrator
13.13 License Server Maintenance

13.13.4 License Server Reset


If problems with the License Server or activated licenses occur, you may have to
reset the License Server. All details about activated licenses on the License Server
are compiled in files that start with "taclic" and has the .data extension. The file
name string after "taclic" can differ. An example of the License Server file name is
taclic_00249e00_tsf.data. The license details files are created the first time a license
is activated on the License Server. By deleting the files you reset the License Server.
For more information, see section 13.10 License Server Reset on page 284.

04-17005-03-en, October 2015 System


291
13 License Server and License Administrator
13.14 License Administrator

13.14 License Administrator


The License Administrator administers the activation, return, and repair of licenses.

13.14.1 Registration Details


Before the first network license is activated on the License Server, details about the
customers organization and the contact information of the account manager must
be entered. The registration details are written to the license details when a license
is activated. Building Operation automatically saves these registration details and
reuses the details the next time a license is activated.

Note
Only English letters are allowed in the license details.

If you change the registration details, the changes are applied to all licenses located
on the License Server.

Note
To ensure that all the licenses have the same information, the registration
details must be updated on all License Servers in the Building Operation
system.

13.14.2 License Server Address


During the installation of License Administrator on WorkStations or Enterprise
Servers, you need to type the network address to the License Server where
network licenses are available for check out. The address to the License Server can
later be entered or edited through License Administrator or directly in the Windows
registry of the computer or Enterprise Server that hosts the licensed product.
For more information, see section 13.8 License Server Address on page 280.

System 04-17005-03-en, October 2015


292
13 License Server and License Administrator
13.15 Starting License Administrator

13.15 Starting License Administrator


You start License Administrator to administer the licenses on the License Server
and define the address to the License Servers for all licensed Building Operation
products.
For more information, see section 13.14 License Administrator on page 292.

To start License Administrator


1. Click Start, point to All Programs, and then click Schneider Electric
StruxureWare.
2. Click Building Operation x.x.
3. Click Building Operation License Administrator.
4. Click Yes to confirm that you want to run License Administrator.

04-17005-03-en, October 2015 System


293
14 Licensing User Interface

Topics
Registration Details View
Licenses View
Licenses View Toolbar
Licenses View Icons
Licenses View Columns
Add License Dialog Box
License Activation Dialog Box
License Progress Dialog Box
License Server Address View
Diagnostics View
14 Licensing User Interface
14.1 Registration Details View

14.1 Registration Details View


Use the Registration Details view to edit the contact information for the license
owner and the account manger that supplied the license. The registration details
are written to the license details when a license is activated.

Note
Only English letters are allowed in the license details.

Figure: Registration details view

Table: Registration Details View


Component Description

License owner Type the name of the organization that


purchased the license.

Industry Select the end users field of business.

Type of project Select the proposed fields of application for


the license.

Name Type the name of the account manager that


supplied the license.

E-mail Type the e-mail address of the account


manager that supplied the license.

04-17005-03-en, October 2015 System


297
14 Licensing User Interface
14.1 Registration Details View

Continued
Component Description

Telephone number Type the phone number of the account


manager that supplied the license.

System 04-17005-03-en, October 2015


298
14 Licensing User Interface
14.2 Licenses View

14.2 Licenses View


Use the Licenses view to activate, remove, repair, or list activated licenses on the
License Server.

Figure: Licenses view

Table: Licenses View


Number Description

Use the Licenses view toolbar to activate or


remove licenses. For more information, see
section 14.3 Licenses View Toolbar on
page 300.

Use the Licenses view columns to view


information about activated licenses. For
more information, see section 14.5
Licenses View Columns on page 302.

Use the Licenses view icons to get


information on different licenses and status.
For more information, see section 14.4
Licenses View Icons on page 301.

04-17005-03-en, October 2015 System


299
14 Licensing User Interface
14.3 Licenses View Toolbar

14.3 Licenses View Toolbar


Use the Licenses view toolbar to activate, remove, or repair licenses on the
License Server.

Table: Licenses View Toolbar


Button Description

Add license from entitlement ID


Click to activate a license on the License
Server with an entitlement ID.

Add license from file


Click to activate a license on the License
Server from a license file.

Remove/return license
Click to remove local licenses or return
network licenses to the License Activation
Server.

Repair license
Click to repair a damaged network license.

System 04-17005-03-en, October 2015


300
14 Licensing User Interface
14.4 Licenses View Icons

14.4 Licenses View Icons


Use the Licenses view icons to get information on different licenses and status.

Table: Licenses View Icons


Icon Description

Network License
Indicates that the license is a network license
located on the License Server.

Local License
Indicates that the license is a local license
located on a server or computer.

Damaged Local License


Indicates that a local license is damaged.
Local licenses can not be repaired.

Damaged Network License


Indicates that a network license is damaged
and needs to be repaired.

04-17005-03-en, October 2015 System


301
14 Licensing User Interface
14.5 Licenses View Columns

14.5 Licenses View Columns


Use the Licenses view columns to view information about activated licenses.
Column Description

Product Displays the name of the license product.

Version Displays the version number of the licenses.

Quantity Displays the amount of licenses that are


activated.

Status Displays the current license status.

Location Displays whether the license is a local or


network license.

Expiration date Displays the date when the license expires.

Creation date Displays the date when the local license file
that was used to activate the local license
was created, or the date when the network
license was activated on the License Server.

System 04-17005-03-en, October 2015


302
14 Licensing User Interface
14.6 Add License Dialog Box

14.6 Add License Dialog Box


Use the Add license dialog box to activate licenses from the License Activation
Server with an entitlement ID.

Figure: Add license dialog box

Table: Add License Dialog Box


Component Description

Enter license entitlement ID Type the entitlement ID of the order from


which you want to activate licenses. The
entitlement ID is found on the entitlement
certificate.

04-17005-03-en, October 2015 System


303
14 Licensing User Interface
14.7 License Activation Dialog Box

14.7 License Activation Dialog Box


Use the License Activation dialog box to list and to activate licenses from an
entitlement.

Figure: License activation dialog box

Table: License Activation Dialog Box


Component Description

Network License
Indicates that network licenses are available
to activate on the License Server.

Local License
Indicates that local licenses are available to
activate on the License Server or computer.

Product Displays the name of the license.

Version Displays the version number of the license.

Location Displays whether the license is a local


license or a network license.

Quantity Displays the number of licenses tha are


available to activate.

Activate (column) Select the number of licenses to activate.

System 04-17005-03-en, October 2015


304
14 Licensing User Interface
14.7 License Activation Dialog Box

Continued
Component Description

Activate (button) Click to activate the selected number of


licenses.

04-17005-03-en, October 2015 System


305
14 Licensing User Interface
14.8 License Progress Dialog Box

14.8 License Progress Dialog Box


Use the License Progress dialog box to view the progress when activating or
removing licenses.

Figure: License progress dialog box

Table: License Progress Dialog Box


Component Description

Network License
Indicates that network licenses are activated
or returned.

Local License
Indicates that local licenses are activated or
removed.

Product Displays the name of the license.

Version Displays the version number of the license.

Quantity Displays the number of licenses to activate


or return.

Progress Displays the progress of the license


activation or return.

Status Displays the status of the activation or


return.

System 04-17005-03-en, October 2015


306
14 Licensing User Interface
14.9 License Server Address View

14.9 License Server Address View


Use the License Server Address view to specify the address to the License
Server.

Figure: License Server address view

Table: License Server Address View


Component Description

License server address Type the address to the License Server


where licenses are available for check out.
The address must begin with @. To define a
port number other than the default port
range 27000-27009, type the port number in
front of the @, Port-number@Address. Use a
semicolon to separate addresses.

04-17005-03-en, October 2015 System


307
14 Licensing User Interface
14.10 Diagnostics View

14.10 Diagnostics View


Use the Diagnostics view to list the licenses with license details located on the
License Server, or local on a WorkStation or Enterprise Server.

Figure: Diagnostic view

Table: Diagnostics View


Button Description

Refresh the list


Click to populate or refresh the diagnostic
list.

Copy to clipboard
Click to copy the diagnostics information to
the clipboard.

System 04-17005-03-en, October 2015


308
15 Software Administrator

Topics
Software Administrator
Starting Software Administrator
Configuring Server Port Settings
Starting the Enterprise Server Windows Service
Stopping the Enterprise Server Windows Service
Restarting the Server Windows Service
Enterprise Server System Log
Viewing Enterprise Server System Log
Software Administrator Enterprise Server View
15 Software Administrator
15.1 Software Administrator

15.1 Software Administrator


The Software Administrator installs with the Enterprise Server and the Project
Configuration Server installation package. You use the Software Administrator to
start and stop the servers services and configure the ports of the Enterprise Server,
or the Project Configuration Server.
Other server settings, for example e-mail service, time, and time zone settings are
configured through WorkStation or WorkStation for Projects.

15.1.1 Service
The Enterprise Server and the Project Configuration Server runs in the background
as a Windows service. You start and stop the server services through the Software
Administrator or Windows Service. Before shutting down the server, make sure the
stop does not negatively affect your site or project.

15.1.2 Ports
The Enterprise Server uses HTTP and TCP protocols to communicate with other
servers and clients. The Project Configuration Server uses the HTTPS protocol. In
the Software Administrator, you configure the port number of each protocol the
servers listens to when communicating through a specific protocol.
To configure a protocol port number, you first have to stop the running Enterprise
Server or Project Configuration Server services.

Note
Port changes you have made using Software Administrator are not automatically
updated in the Communication view for SmartStruxure servers.

15.1.3 Database Location


In the Software Administrator, you find the path to the location where the Enterprise
Server and the Project Configuration Server writes and stores data and objects that
are created by either the Enterprise Server, the Project Configuration Server, or the
user.

15.1.4 Enterprise Server System Log


The Enterprise Server System log contains events logged by the Enterprise Server.
Examples of logged events are start up sequence, port settings, failures, run time,
and current server status.

04-17005-03-en, October 2015 System


311
15 Software Administrator
15.2 Starting Software Administrator

15.2 Starting Software Administrator


You start Software Administrator to be able to configure the port settings of the
Enterprise Server or the Project Configuration Server.
For more information, see section 15.1 Software Administrator on page 311.

To start Software Administrator


1. Click Start, point to All Programs, and then click Schneider Electric
StruxureWare.
2. Click Building Operation x.x.
3. Click Building Operation Software Administrator.
4. Click Yes, to confirm that you want to run Software Administrator.

System 04-17005-03-en, October 2015


312
15 Software Administrator
15.3 Configuring Server Port Settings

15.3 Configuring Server Port Settings


You configure server HTTP, HTTPS, and TCP ports to define the communication of
the different protocols. In Software Administrator, you can configure either the ports
of the Enterprise Server or the Project Configuration Server.
For more information, see section 15.1 Software Administrator on page 311.

To configure server ports


1. In Software Administrator, click the tab of the Enterprise Server or the
Project Configuration Server.

2. Click Stop Service.


3. In the HTTP Port box, type the port number that the server listens to when
communicating through the Hypertext Transfer Protocol.
4. In the HTTPS Port box, type the port number that the server listens to when
communicating through the Hypertext Transfer Secure Protocol.
5. In the TCP Port box, type the port number that the server listens to when
communicating through the Transmission Control Protocol.
6. Click Start Service.
7. Click OK.

04-17005-03-en, October 2015 System


313
15 Software Administrator
15.4 Starting the Enterprise Server Windows Service

15.4 Starting the Enterprise Server Windows


Service
You start the server manually in case you previously have stopped it.

Important
Ensure that you have a working and available license. A working license is
required to start the server. For more information, see section 10.6 Licenses on
page 217.

Note
An Enterprise Server is automatically started when installed and when
Windows is started.

For more information, see section 15.1 Software Administrator on page 311.

To start the Enterprise Server Windows service


1. In the Software Administrator, click the tab of the Enterprise Server.
2. Click Start Service.

System 04-17005-03-en, October 2015


314
15 Software Administrator
15.5 Stopping the Enterprise Server Windows Service

15.5 Stopping the Enterprise Server


Windows Service
You stop the Enterprise Server to configure the port settings or to repair,
upgrade, or reinstall the Enterprise Server.
For more information, see section 15.1 Software Administrator on page 311.

To stop the Enterprise Server Windows service


1. In Software Administrator, click Stop Service.

04-17005-03-en, October 2015 System


315
15 Software Administrator
15.6 Restarting the Server Windows Service

15.6 Restarting the Server Windows Service


You restart the Enterprise Server or the Project Configuration Server Windows
service to reset or apply new settings.

Important
Ensure that you have a working and available Enterprise Server license. A working
license is required to start the Enterprise Server. For more information, see
section 10.6 Licenses on page 217.

For more information, see section 15.1 Software Administrator on page 311.

To restart the server Windows service


1. In the Software Administrator, click the tab of the server that you want to
restart.
2. Click Stop Service.
3. Click Start Service.

System 04-17005-03-en, October 2015


316
15 Software Administrator
15.7 Enterprise Server System Log

15.7 Enterprise Server System Log


The Enterprise Server System log contains events logged by the Enterprise Server.
Examples of logged events are start up sequence, port settings, failures, run time,
and current server status.
The log is displayed in the SoftWare Administrator dialog box. The log can also be
found in the db, database folder, in the Enterprise folder.

04-17005-03-en, October 2015 System


317
15 Software Administrator
15.8 Viewing Enterprise Server System Log

15.8 Viewing Enterprise Server System Log


You view logged server events in the Enterprise Server system log to troubleshoot
server problems that are traced to the Enterprise Server.
For more information, see section 15.7 Enterprise Server System Log on page
317.

To view the Enterprise Server system log


1. In Software Administrator, click the Enterprise Server tab.
2. In the System box, view the events in the system log.
3. Click OK.

System 04-17005-03-en, October 2015


318
15 Software Administrator
15.9 Software Administrator Enterprise Server View

15.9 Software Administrator Enterprise


Server View
Use the Enterprise Server view to start and stop the Enterprise Server service
and configure the ports of the Enterprise Server.

Table: Enterprise Server View


Component Description

Status Displays the current status of the Enterprise


Server Windows service.

Start Service Click to start the Enterprise Server.

Stop Service Click to stop the Enterprise Server.

HTTP Port Type the port number that the Enterprise


Server listens to when communicating
through the Hypertext Transfer Protocol.

HTTPS Port Type the port number that the Enterprise


Server listens to when communicating
through the Hypertext Transfer Protocol
Secure.

TCP Port Type the port number that the Enterprise


Server listens to when communicating
through the Transmitting Control Protocol.

System Displays the system log.

Path Displays the path to the folder where the


Enterprise Server database and other
objects created by the Enterprise Server or
users are stored.

A warning indicates that you entered a


conflicting port number or that the service is
stopping.

04-17005-03-en, October 2015 System


319
16 Localization Language and
Units

Topics
Regional and Language Overview
Configuring Regional Settings
Language Packages
Changing the WorkStation Language
Adding a Language in WebStation
Changing the Language in WebStation
Value Presentation
Units
Changing the WorkStation Measurement System
Adding or Changing a Unit and Prefix for a Value
Metric Prefixes
Precision Format
Adding a Unit Conversion Exception
Removing a Unit Conversion Exception
Delta Temperature Conversion
16 Localization Language and Units
16.1 Regional and Language Overview

16.1 Regional and Language Overview


By default, WorkStation presents language, date, time, currency, unit, and decimals
according to the regional settings of the users operating system.
The date, time, or value format can differ between clients that have the same
language and cultural convention.
For example, a user customizes the French date setting to yyyy-mm-dd in the
operating system. The next time WorkStation starts on this client, all dates are
displayed as yyyy-mm-dd instead of the French standard dd/mm/yyyy. Other
clients with French original settings still display dates with the French standard
dd/mm/yyyy.

16.1.1 Language and Translation Packages


Building Operation supports several different languages. To be able to install a new
language you need a language pack.
For more information, see section 16.3 Language Packages on page 325.

16.1.2 Value Presentation


Building Operation handles values and numbers with the highest precision. By
default, the unit of a value is converted according to the regional settings of the
users operating system.
For more information, see section 16.7 Value Presentation on page 329.

16.1.3 Time and Time Zone


A time zone is a region on the earth that has a uniform standard time, usually
referred to as the local time. Local time is the UTC time plus the current time zone
offset for the considered location. Some time zones also have an offset called DST
added during the summer period. The DST offset is typically +1 hour.
For more information, see section 17.1 Time and Time Zone on page 347.

04-17005-03-en, October 2015 System


323
16 Localization Language and Units
16.2 Configuring Regional Settings

16.2 Configuring Regional Settings


You change the default presentation of date, units of measure, language, time, and
time zone in WorkStation or Enterprise Server by changing your operating system
regional settings.
For more information, see section 16.1 Regional and Language Overview on page
323.

To change regional settings


1. Close all Building Operation-related applications.
2. For more information on how to change the regional settings, please refer to
the manufacturers manual for the operating system.
Next time WorkStation starts, the new regional settings are used.

System 04-17005-03-en, October 2015


324
16 Localization Language and Units
16.3 Language Packages

16.3 Language Packages


Building Operation supports several different languages. To be able to install a new
language you need a language pack.

16.3.1 Languages in WorkStation and WorkStation


for Projects
At the main installation, WorkStation, SmartStruxure Servers, and Project
Configuration Server contain English and languages that are avalable at the time.
To support a language, WorkStation needs the specific language package.
You can change the display language from within WorkStation. The changes take
effect when you restart WorkStation.

Note
When no language has been actively selected in WorkStation, the language
given by the regional settings of the computer's operating system apply
provided that the language package for that language is installed.
If the language package for the language given by the regional setting is not
installed, the WorkStation user interface is displayed in English.
In Windows Control Panel, you can check whether or not a language
package is installed on the computer.

The language packages are version sensitive, the version of the language package
must correspond with the version of WorkStation or WorkStation for Projects. If you
upgrade your current WorkStation or WorkStation for Projects, you must also
upgrade your language package version.
WorkStation, WorkStation for Projects, and servers are built on a multilingual
language platform that supports all characters included in the Basic Multilingual
Plan, http://unicode.org.

16.3.2 Languages in WebStation


The default language in WebStation is English but this can be changed. The
language pack for the language has to be installed on the SmartStruxure server you
are connected to using WebStation. Changing the language settings in WebStation
only affects the language in your web browser.
The language setting uses session cookies. When you clear the web browser's
cache so that the cookie is deleted, you have to change the language once again.
You can change back to the original language or another language if the language
pack for the selected language is installed on the server you are connected to.
To be able to install a language pack on the SmartStruxure server or Project
Configuration Server, you need the language pack file supplied by Schneider
Electric.

04-17005-03-en, October 2015 System


325
16 Localization Language and Units
16.4 Changing the WorkStation Language

16.4 Changing the WorkStation Language


You change the language in WorkStation to view the WorkStation user interface in a
different language.
For more information, see section 16.3 Language Packages on page 325.

To change the WorkStation language


1. On the Tools menu, point to Language, and then select language.
2. In the Change language dialog box, click Yes to restart the computer
immediately.

Note
You need to restart the program for the changes to take effect.

The WorkStation user interface is displayed in the selected language.

System 04-17005-03-en, October 2015


326
16 Localization Language and Units
16.5 Adding a Language in WebStation

16.5 Adding a Language in WebStation


You add a language to WebStation so that the user is able to change to this
language.

Important
To add a language in WebStation, you must log on with a user account that
belongs to a user account group that has the property May access device
configuration selected in the Policies view.

Note
When a SmartStruxure server is upgraded, the language pack in WebStation
must be added once again.

For more information, see section 16.3 Language Packages on page 325.

To add a language in WebStation


1. In WebStation, log on to the SmartStruxure server you want to add the
language to.
2. On the main toolbar, on the Settings menu, click Add or remove
language.
3. Click Add.
4. Browse to the language pack .zip file for the language you want to add.
5. Click Open.
6. Click OK.

04-17005-03-en, October 2015 System


327
16 Localization Language and Units
16.6 Changing the Language in WebStation

16.6 Changing the Language in WebStation


You change the language in WebStation to adapt WebStation to a new region.
For more information, see the Regional Settings topic on WebHelp.

To change the language in WebStation


1. In WebStation, on the Main toolbar, click Settings.
2. Click Change regional settings.
3. Select the language you want to use.
4. Click OK.

System 04-17005-03-en, October 2015


328
16 Localization Language and Units
16.7 Value Presentation

16.7 Value Presentation


Building Operation handles values and numbers with the highest precision. By
default, the unit of a value is converted according to the regional settings of the
users operating system.

16.7.1 Units
Building Operation supports both the SI metric system and the US Customary
System for units of measurement.
There are four optional ways to display units:
As MS Windows
As configured in object
International System of Units (Metric)
United States Customary Units (US)
For more information, see section 16.8 Units on page 330.

16.7.2 Metric Prefixes


WorkStation supports the metric prefix range from yocta (10-24) to yotta (1024). The
use of a prefix is optional and is defined together with the unit.
For more information, see section 16.11 Metric Prefixes on page 336.

16.7.3 Precision Format


Values in Building Operation are stored in the Building Operation database with all
input decimals. If a stored value consists of more decimals than the operating
system is defined to display, the value is rounded off according to the operating
system settings before it is displayed in WorkStation.
For more information, see section 16.12 Precision Format on page 337.

04-17005-03-en, October 2015 System


329
16 Localization Language and Units
16.8 Units

16.8 Units
Building Operation supports both the SI metric system and the US Customary
System for units of measurement.
There are four optional ways to display units:
As MS Windows
As configured in object
International System of Units (Metric)
United States Customary Units (US)
For example, the temperature 42,82 C is stored in Building Operation. A
WorkStation on an operating system with the US Customary System converts the
temperature and displays it as 109.08 F.
As MS Windows
By default, values are converted into the unit given by the regional settings of the
operating system.
As configured in object
Units displayed as configured in the object means that no conversion is done. The
unit the user selected when creating, for example, a trend log is displayed
regardless of regional settings. When this option is selected, the unit conversion
exceptions feature is disabled.
International System of Units (Metric)
Values displayed in International System of Units means that the values are
converted into metric unit regardless of the unit the object was given when created.
United States Customary Units (US)
Values displayed in United States Customary Units means that the values are
converted into US unit regardless of the unit the object was given when created.
When you select a different unit system, the values are converted immediately.
Values are not converted in the following WorkStation screens:
Alarms and trend logs in wizards
Customized alarm views
Alarm and trend log properties panes

16.8.1 Delta Temperature Conversion


Important
Building Operation converts the unit of a variable independent of its context.
To correctly convert a delta temperature, the unit of the delta value must
belong to the unit category Temperature Diff.

System 04-17005-03-en, October 2015


330
16 Localization Language and Units
16.8 Units

The conversion between Celsius and Fahrenheit or Fahrenheit and Kelvin is not a
simple coefficient (multiplier) like other unit categories as for example length,
pressure, currency, and Energy. Due to the conversion formula when for example
converting an absolute Fahrenheit temperature to Celsius, TF=TC x 9/5 + 32, you
have both a multiplier and an offset to consider. To correctly convert a delta
temperature from Fahrenheit to Celsius you have to use the formula DTF = 9/5
DTC.
For more information, see section 16.15 Delta Temperature Conversion on page
343.

04-17005-03-en, October 2015 System


331
16 Localization Language and Units
16.9 Changing the WorkStation Measurement System

16.9 Changing the WorkStation


Measurement System
You can change the WorkStation measurement system to display values in different
units of measure.
For more information, see section 16.8 Units on page 330.

To change the WorkStation measurement system


1. On the Tools menu, point to Measurement system, and then select
measurement system.
(In FM: TaskClosing) The units of measure are immediately converted into the units
of measure of the selected measurement system.

System 04-17005-03-en, October 2015


332
16 Localization Language and Units
16.10 Adding or Changing a Unit and Prefix for a Value

16.10 Adding or Changing a Unit and Prefix


for a Value
You define and change the unit and its prefix for a value to ensure that the value is
correct calculated.
For more information, see section 16.8 Units on page 330.

To add or change a unit and prefix for a value


1. In WorkStation, in the System Tree pane, select the value or point you want
to configure.
2. On the File menu, click Properties.

3. Click the Value Configuration button .

Continued on next page

04-17005-03-en, October 2015 System


333
16 Localization Language and Units
16.10 Adding or Changing a Unit and Prefix for a Value

4. Select the Configured box that is in front of the Unit box.

5. In the Unit box, click the Browse button .


6. Select the unit.

Continued on next page

System 04-17005-03-en, October 2015


334
16 Localization Language and Units
16.10 Adding or Changing a Unit and Prefix for a Value

7. In the Prefix box, select the prefix of the unit.


8. Click Select.
9. In the Value dialog box, click OK.
10. In the Properties dialog box, click OK.

04-17005-03-en, October 2015 System


335
16 Localization Language and Units
16.11 Metric Prefixes

16.11 Metric Prefixes


WorkStation supports the metric prefix range from yocta (10-24) to yotta (1024). The
use of a prefix is optional and is defined together with the unit.
10n Decimal Prefix Symbol

10-24 0.000 000 000 000 yocto y


000 000 000 001

10-21 0.000 000 000 000 zepto z


000 000 001

10-18 0.000 000 000 000 atto a


000 001

10-15 0.000 000 000 000 femto f


001

10-12 0.000 000 000 001 pico p

10-9 0.000 000 001 nano n

10-6 0.000 001 micro

10-3 0.001 milli m

- - - -

103 1 000 kilo K

106 1 000 000 mega M

109 1 000 000 000 giga G

1012 1 000 000 000 000 tera T

1015 1 000 000 000 000 peta P


000

1018 1 000 000 000 000 exa E


000 000

1021 1 000 000 000 000 zetta Z


000 000 000

1024 1 000 000 000 000 yotta Y


000 000 000 000

If a value has, for example, kilo as prefix, it is presented in WorkStation with the k-
prefix independent of the number of decimals. When conversion of a unit that has a
prefix, WorkStation removes the prefix and presents the converted value in the
operating system settings default measurement unit without the prefix.
For example, A value of 15 is created with the unit set to meter and with the milli
prefix (10-3), which gives 15 millimeter. A WorkStation on an operating system with
US Customary converts the value to 0.016 yards. This is because of the milli prefix
(10-3) is removed and the Building Operation US customary default length unit is
yard.

System 04-17005-03-en, October 2015


336
16 Localization Language and Units
16.12 Precision Format

16.12 Precision Format


Values in Building Operation are stored in the Building Operation database with all
input decimals. If a stored value consists of more decimals than the operating
system is defined to display, the value is rounded off according to the operating
system settings before it is displayed in WorkStation.
For example, you enter the length 6.5282 m (21.4179 ft) to a variable in Building
Operation. When you press Enter or OK, the value changes to 6.53 m (21.41 ft).
This becouse of your operating system, in this example, is defined to display only
two decimals The input value 6.5282 m (21.4179 ft) is stored in the Building
Operation database but is round off to 6.53 m (21.41 ft) when it is displayed.

Note
The rounded value is only a display value and is not used by Building
Operation in calculations or other operations.

If an integer value exceeds 12 digits (1012), both positive and negative numbers,
WorkStation displays the value in scientific notation. The number of digits for a
decimal number before it is displayed in scientific notation is decided by the regional
settings of the operating system settings where WorkStation is installed.

04-17005-03-en, October 2015 System


337
16 Localization Language and Units
16.13 Adding a Unit Conversion Exception

16.13 Adding a Unit Conversion Exception


You add unit conversion exceptions to override the selected unit conversion
system. If you have selected to display units as configured in object, the unit
conversion exceptions feature is disabled.
For more information, see section 16.8 Units on page 330.

To add a unit conversion exception


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Domain.
4. In the Domains list, select a domain for the unit conversion exception.
5. Click Unit Conversion Exceptions.
Continued on next page

System 04-17005-03-en, October 2015


338
16 Localization Language and Units
16.13 Adding a Unit Conversion Exception

6. Click Add .

7. In the Unit Selection dialog box, select the unit for which you want a
conversion exception.

8. Click Select.
Continued on next page

04-17005-03-en, October 2015 System


339
16 Localization Language and Units
16.13 Adding a Unit Conversion Exception

9. In the SI Display Unit column, select the unit to be displayed in an SI metric


system.

10. In the US Display Unit column, select the unit to be displayed in a US


customary system.

11. Click Save .


The unit conversion exception takes effect immediately unless unit conversion is
disabled.

System 04-17005-03-en, October 2015


340
16 Localization Language and Units
16.14 Removing a Unit Conversion Exception

16.14 Removing a Unit Conversion Exception


You remove unit conversion exceptions to return to the selected unit conversion
system.
For more information, see section 16.8 Units on page 330.

To remove a unit conversion exception


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Domain.
4. In the Domains list, select the domain where you want to remove a unit
conversion exception.
5. Click Unit Conversion Exceptions.
Continued on next page

04-17005-03-en, October 2015 System


341
16 Localization Language and Units
16.14 Removing a Unit Conversion Exception

6. Select the unit conversion exception you want to remove.

7. Click Remove .

8. Click Save .

System 04-17005-03-en, October 2015


342
16 Localization Language and Units
16.15 Delta Temperature Conversion

16.15 Delta Temperature Conversion


The conversion between Celsius and Fahrenheit or Fahrenheit and Kelvin is not a
simple coefficient (multiplier) like other unit categories as for example length,
pressure, currency, and Energy. Due to the conversion formula when for example
converting an absolute Fahrenheit temperature to Celsius, TF=TC x 9/5 + 32, you
have both a multiplier and an offset to consider. To correctly convert a delta
temperature from Fahrenheit to Celsius you have to use the formula DTF = 9/5
DTC.
If you set a delta temperature to a unit within the unit category Temperature,
Building Operation incorrectly converts the value as an absolute temperature. By
setting the delta temperature to a unit within the unit category Temperature Diff,
Building Operation correctly converts the delta value.

Proof
Temperature A: 23C (73.4F)
Temperature B: -18C (-0.4F)
Diff Temperature = Temperature B - Temperature A
-18C - 23C = 41C
-0.4F - 73.4F = 73.8F

Incorrect delta conversion


Inccorrect conversion of a delta temperature from Celsius to Fahrenheit, when the
unit of the value in Building Operation is set to C.
TF=TC x 9/5 + 32:
41C x 9/5 + 32= 108.8F
The correct delta value is 73.8F, not 108.8F .

Correct delta conversion


Correct conversion of a delta temperature from Celsius to Fahrenheit, when the unit
of the value in Building Operation is set to DC.
DTF=DTC x 9/5:
D41C x 9/5= D73.8F
The conversion results in the correct delta value of 73.8F.

Note
By default, units are converted automatically depending on your operating
system's regional settings. You can also select to display values in units
according to the International System of Units (SI), the United States Customary
Units (US), or as configured in the connected objects, that is, the original unit of
the value. For more information, see section 16.8 Units on page 330.

Important
Building Operation converts the unit of a variable independent of its context.
To correctly convert a delta temperature, the unit of the delta value must
belong to the unit category Temperature Diff.

04-17005-03-en, October 2015 System


343
17 Localization Time and Time
Zone

Topics
Time and Time Zone
Lead and Shadow Relationship
Time and Time Zone Configuration in WorkStation
Time and Time Zone Configuration in Enterprise Server
Time and Time Zone Configuration in Automation Server
Changing the Time Zone of a SmartStruxure Server
Creating a Custom Time Zone of a SmartStruxure Server
Configuring Enterprise Server and WorkStation Date and
Time
Synchronizing the SmartStruxure Server Device Clock
Manually Changing the SmartStruxure Server Device Time
and Date
Network Time
Synchronize Network Time Settings
Synchronizing Time Settings on Multiple SmartStruxure
Server Devices
Synchronize Time Zone Settings
Synchronizing Time Zone Settings on Multiple
SmartStruxure Server Devices
17 Localization Time and Time Zone
17.1 Time and Time Zone

17.1 Time and Time Zone


A time zone is a region on the earth that has a uniform standard time, usually
referred to as the local time. Local time is the UTC time plus the current time zone
offset for the considered location. Some time zones also have an offset called DST
added during the summer period. The DST offset is typically +1 hour.

17.1.1 Network Time


Consistent date and timestamping across a network is critical for system wide
access control, security, communications, scheduling, alarms, and events. Network
time uses the NTP protocol that provides the correct current UTC time.
For more information, see section 17.11 Network Time on page 362.

17.1.2 Time and Time Zone Configuration in


WorkStation
In WorkStation, all times are by default displayed in local time. This means that a
time, independent of its source, is displayed in the same time zone as the operating
system on which WorkStation is installed. By configuring the operating system time
and time zone settings, you configure how times are displayed in WorkStation. For
more information, please refer to the manufacturers manual for the operating
system.
For more information, see section 17.3 Time and Time Zone Configuration in
WorkStation on page 350.

17.1.3 Time and Time Zone Configuration in


Enterprise Server
The Enterprise Server time and date settings are configured through the operating
system settings on which the Enterprise Server is installed. The time zone offset,
configured through the Enterprise Server, is added by Building Operation to the
UTC time. The Enterprise Server time zone settings are therefore independent of
the operating system time zone settings.
For more information, see section 17.4 Time and Time Zone Configuration in
Enterprise Server on page 351.

17.1.4 Time and Time Zone Configuration in


SmartStruxure Server Device
To adjust the SmartStruxure server device time, time zone, and DST, you have to
access the SmartStruxure server device through a WorkStation.
For more information, see section 17.5 Time and Time Zone Configuration in
Automation Server on page 352.

04-17005-03-en, October 2015 System


347
17 Localization Time and Time Zone
17.2 Lead and Shadow Relationship

17.2 Lead and Shadow Relationship


For some objects on the SmartStruxure server device, for example the time zone
object and schedule object, you can establish a lead and shadow relationship. You
can also establish lead and shadow relationships between graphic elements. A
shadow object automatically synchronizes settings from its connected lead object.
A lead and shadow relationship can only be established between objects of the
same kind.
For example, an Enterprise Server and three individual Automation Servers are
located in same time zone region. Instead of individually configuring all the servers
time zone, a lead and shadow relationship is established. The Enterprise Server is
the lead object and the three Automation Servers are shadow objects. With this
relationship, the Enterprise Server time zone settings are reflected and used by the
three Automation Servers.

Figure: Changes in the lead object are automatically reflected in the connected shadow
objects
When you set up a lead and shadow relationship, you define which object is the
lead object in the properties of the shadow object. For example, to synchronize an
Automation Server object with an Enterprise Server object, you define the lead
object, in this case the Enterprise Server object, in the properties of the Automation
Server.

System 04-17005-03-en, October 2015


348
17 Localization Time and Time Zone
17.2 Lead and Shadow Relationship

A server on a higher level, such as an Enterprise Server, typically acts as the lead.
However, a lead and shadow relationship can be established between two
SmartStruxure server devices.

17.2.1 Synchronize Network Time Settings


You can establish a lead and shadow relationship to synchronize the time on all
your SmartStruxure server devices with the same network time server. The Date
and Time object on the lead server contains the network time server addresses that
are inherited by shadow servers.
For more information, see section 17.12 Synchronize Network Time Settings on
page 364.

17.2.2 Synchronize Time Zone Settings


You can establish a lead and shadow relationship to synchronize the time zone
settings on all your SmartStruxure servers. The Time Zone object on the lead server
contains the time zone settings that are inherited by shadow servers.
For more information, see section 17.14 Synchronize Time Zone Settings on page
368.

17.2.3 Synchronize Schedules and Calendars


When you configure a schedule that controls events in a single part of a building,
you might also want the same events to occur in other areas of the building. You
can establish a lead and shadow relationship to synchronize the events in
schedules and dates in calendars.
For more information, see section 47.13 Schedule and Calendar Synchronization
on page 1528.

17.2.4 Set Inheritance Between Graphic Elements


When you design a graphic, you might want to apply the same properties on
several graphic elements. You can establish a lead and shadow relationship to
apply a property of one element on one or several other elements located deeper
down in the hierarchy.

04-17005-03-en, October 2015 System


349
17 Localization Time and Time Zone
17.3 Time and Time Zone Configuration in WorkStation

17.3 Time and Time Zone Configuration in


WorkStation
In WorkStation, all times are by default displayed in local time. This means that a
time, independent of its source, is displayed in the same time zone as the operating
system on which WorkStation is installed. By configuring the operating system time
and time zone settings, you configure how times are displayed in WorkStation. For
more information, please refer to the manufacturers manual for the operating
system.

Figure: WorkStation displays all times as local time, according to the operating system
settings on which WorkStation is installed.
For example, a WorkStation in Athens surveys a SmartStruxure server device in
New York. WorkStation in Athens has a Greek operating system, which is
configured to Eastern European Summer Time (UTC +2h) with +1h DST offset. The
New York SmartStruxure server device triggers an alarm at 07:43 Eastern time.
WorkStation instantly reports the alarm but presents the alarm with the timestamp
14:43 which is the local time in Greece.
Some features in WorkStation, such as trend log and schedule, allow you to change
the displayed time to UTC or server local time.

17.3.1 Server Time in WorkStation


The exception in WorkStation is the Local Date & Time property for the time on a
SmartStruxure server device where the time is displayed in local server time and not
in the perspective of WorkStation and its operating system.

System 04-17005-03-en, October 2015


350
17 Localization Time and Time Zone
17.4 Time and Time Zone Configuration in Enterprise Server

17.4 Time and Time Zone Configuration in


Enterprise Server
The Enterprise Server time and date settings are configured through the operating
system settings on which the Enterprise Server is installed. The time zone offset,
configured through the Enterprise Server, is added by Building Operation to the
UTC time. The Enterprise Server time zone settings are therefore independent of
the operating system time zone settings.

Figure: The Enterprise Server uses the operating system clock on which the server is
installed. Time zone offset and DST are then added by Building Operation to the UTC
time.
To adjust your operating system clock, refer to your manufacturers manual for the
operating system. The Enterprise Server time zone is configured on the Enterprise
Server through WorkStation

Note
The Date and Time synchronization for Automation Server do not
affect the Enterprise Server clock. For more information, see section 17.12
Synchronize Network Time Settings on page 364.

04-17005-03-en, October 2015 System


351
17 Localization Time and Time Zone
17.5 Time and Time Zone Configuration in Automation Server

17.5 Time and Time Zone Configuration in


Automation Server
To adjust the SmartStruxure server device time, time zone, and DST, you have to
access the SmartStruxure server device through a WorkStation.
When adjusting the server clock, you can either set the time manually or you can
refer to a network time server that automatically synchronizes the clock. Beside
predefined time zones, you can also customize the SmartStruxure server device
time zone settings.
When adjusting the SmartStruxure server device time through WorkStation, it is the
SmartStruxure server device operating system clock you adjust. Building Operation
has a transparent layer above the SmartStruxure server device operating system
which manages the information about the time zone and DST time offset.

Figure: The Automation Server uses the operating system clock to which Building
Operation adds the time zone offset and DST
Instead of configuring the time of each SmartStruxure server device, you can create
a lead and shadow relationship that makes it possible to configure several
SmartStruxure server devices through a single Enterprise Server.

System 04-17005-03-en, October 2015


352
17 Localization Time and Time Zone
17.6 Changing the Time Zone of a SmartStruxure Server

17.6 Changing the Time Zone of a


SmartStruxure Server
You change the time zone of a SmartStruxure server to adjust the UTC offset
according to the region where the SmartStruxure server is located.
For more information, see section 17.4 Time and Time Zone Configuration in
Enterprise Server on page 351.

To change the time zone of a SmartStruxure server


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Network time and time zones.


Continued on next page

04-17005-03-en, October 2015 System


353
17 Localization Time and Time Zone
17.6 Changing the Time Zone of a SmartStruxure Server

4. Select Predefined time zone and then select the time zone the
SmartStruxure server is located in.

5. On the File menu, click Save.


If your time zone is not listed, you can create and configure a custom time zone.

System 04-17005-03-en, October 2015


354
17 Localization Time and Time Zone
17.7 Creating a Custom Time Zone of a SmartStruxure Server

17.7 Creating a Custom Time Zone of a


SmartStruxure Server
If your time zone is not listed in Predefined time zone, you create and configure
a custom time zone for the SmartStruxure server.
For more information, see section 17.1 Time and Time Zone on page 347.

To customize a time zone of a SmartStruxure server


1. On the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Network time and time zones.


Continued on next page

04-17005-03-en, October 2015 System


355
17 Localization Time and Time Zone
17.7 Creating a Custom Time Zone of a SmartStruxure Server

4. Select Custom time zone.

5. In the Description box, type a description of the time zone.


6. In the UTC offset box, select in hours and minutes the time zone offset from
UTC.

Note
The UTC offset is positive east of Greenwich. For example, the
time offset for Eastern Time is UTC -05:00 hours.

7. Select This custom time zone uses daylight saving time to have the
time zone automatically updated for daylight saving time.
8. In the Time adjustment box, select the daylight saving time offset in
minutes.
9. In the Start column, select the month, week, day, and time the daylight saving
time starts.
10. In the End column, select the month, week, day, and time the daylight saving
time ends.

11. Click the Save button .

System 04-17005-03-en, October 2015


356
17 Localization Time and Time Zone
17.8 Configuring Enterprise Server and WorkStation Date and Time

17.8 Configuring Enterprise Server and


WorkStation Date and Time
You adjust the date and time of an Enterprise Server or WorkStation through the
operating system where the Enterprise Server or client is installed.
For more information, see section 17.3 Time and Time Zone Configuration in
WorkStation on page 350.

To configure the Enterprise Server and WorkStation date and


time
1. Close all Building Operation-related applications.
2. For more information on how to adjust the date and time, refer to the
manufacturers manual for the operating system.

Note
The time zone settings for an Enterprise Server are configured through
WorkStation and not the operating system.

04-17005-03-en, October 2015 System


357
17 Localization Time and Time Zone
17.9 Synchronizing the SmartStruxure Server Device Clock

17.9 Synchronizing the SmartStruxure Server


Device Clock
You configure the SmartStruxure server device to synchronize its clock with a
network time server.
For more information, see section 17.11 Network Time on page 362.

To synchronize the SmartStruxure server device clock


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the server.

3. Click Network time and time zones.


Continued on next page

System 04-17005-03-en, October 2015


358
17 Localization Time and Time Zone
17.9 Synchronizing the SmartStruxure Server Device Clock

4. In the SmartStruxure server device Date & time view, select Network time
synchronization.

5. In the Primary time server box, type the address to the primary time server
that you want to synchronize the SmartStruxure server device clock with.
6. In the Secondary time server box, type the address to the time server that
you want to synchronize the SmartStruxure server device clock with if the
primary time server is not available.

7. Click the Save button .

04-17005-03-en, October 2015 System


359
17 Localization Time and Time Zone
17.10 Manually Changing the SmartStruxure Server Device Time and Date

17.10 Manually Changing the SmartStruxure


Server Device Time and Date
You manually adjust the SmartStruxure server device clock if it is not synchronized
with a network time server.

Note
The Date & Time view displays the local time in the perspective of the
SmartStruxure server device time zone settings and not in the perspective of
WorkStation.

For more information, see section 17.5 Time and Time Zone Configuration in
Automation Server on page 352.

To manually change the SmartStruxure server device time and


date
1. On the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server device.

3. Click Network time and time zones.


Continued on next page

System 04-17005-03-en, October 2015


360
17 Localization Time and Time Zone
17.10 Manually Changing the SmartStruxure Server Device Time and Date

4. In the SmartStruxure server device Date & time view, select Manually
adjust date & time.

5. In the Local date & time boxes, enter the date and time of the
SmartStruxure server device.

6. Click the Save button .

04-17005-03-en, October 2015 System


361
17 Localization Time and Time Zone
17.11 Network Time

17.11 Network Time


Consistent date and timestamping across a network is critical for system wide
access control, security, communications, scheduling, alarms, and events. Network
time uses the NTP protocol that provides the correct current UTC time.

17.11.1 Network Time on WorkStation and Enterprise


Server
The network time settings on WorkStation and Enterprise Server are configured
through the operating system settings on which WorkStation or Enterprise Server is
installed. For more information on how to configure network time settings, refer to
the manufacturers manual for the operating system.

17.11.2 Network Time Server on a SmartStruxure


Server Device
To configure SmartStruxer server device network time settings, you have to log on
to the SmartStruxure server device through WorkStation. When logged in, the
SmartStruxure server device has a Date & Time view where you configure the
network time server addresses.
When configuring the SmartStruxure server device network time server address,
you can define two time server addresses: primary time server and secondary time
server. If the SmartStruxure server device fails to connect to the primary time server,
it tries to synchronize its clock with the secondary.

17.11.3 Authenticated Network Time Servers


To increase the security of your system, you can use authenticated network time.
By using authenticated network time, you decrease the risk that someone will
tamper with your time setting.
To be able to use authenticated network time, you connect your SmartStruxure
server to an authenticated time server. You need the secure key ID and and key
value password that is provided by the authenticated time server administrator.
You can use the lead/shadow relationship to transfer the authenticated time server
setting and its secure key ID and key value password from the lead server or you
can configure the secure time server manually on your SmartStruxure server. When
you use the lead/shadow relationship the Enterprise Server transfers the setting for
the time server to the SmartStruxure server device. The SmartStruxure server
device then uses the authenticated time server configuration to go online and get
the correct time from the secure time server.

System 04-17005-03-en, October 2015


362
17 Localization Time and Time Zone
17.11 Network Time

Figure: The lead and shadow relationship.

04-17005-03-en, October 2015 System


363
17 Localization Time and Time Zone
17.12 Synchronize Network Time Settings

17.12 Synchronize Network Time Settings


You can establish a lead and shadow relationship to synchronize the time on all
your SmartStruxure server devices with the same network time server. The Date
and Time object on the lead server contains the network time server addresses that
are inherited by shadow servers.

Figure: The Date and Time object is found in the server System, Time Settings folder.
The date and time lead object is configured through the Control Panel - Network
time and time zones on the Enterprise Server.
The Network time synchronization on shadow Automation Servers option
on the Enterprise Server contains the addresses that are inherited by all shadow
SmartStruxure server devices. If you disable this option, established shadow and
lead relationships consist but the shadow SmartStruxure server devices do not
synchronize their network time server addresses with the lead Enterprise Server.
Instead, the SmartStruxure server devices use their own time settings.

Note
The addresses in the Automation Server - Date & Time do not affect the
Enterprise Server time and date settings. For more information, see section
17.11 Network Time on page 362.

System 04-17005-03-en, October 2015


364
17 Localization Time and Time Zone
17.13 Synchronizing Time Settings on Multiple SmartStruxure Server Devices

17.13 Synchronizing Time Settings on Multiple


SmartStruxure Server Devices
You define the primary and secondary network time server settings for connected
shadow SmartStruxure server devices on the Enterprise Server.
For more information, see section 17.12 Synchronize Network Time Settings on
page 364.

To synchronize time settings on multiple SmartStruxure server


devices
1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the Enterprise Server.

3. Click Network time and time zones.


Continued on next page

04-17005-03-en, October 2015 System


365
17 Localization Time and Time Zone
17.13 Synchronizing Time Settings on Multiple SmartStruxure Server Devices

4. In the Enterprise Server Date & Time view, under Network time
synchronization on shadow Automation Servers, click Enable.

5. In the Primary time server box, type the address to the time server that you
want to synchronize the shadow SmartStruxure server devices' clocks with.
6. In the Secondary time server box, type the address to the time server that
you want to synchronize shadow SmartStruxure server devices' clocks with if
the primary time server is not available.
7. If you are using Authenticated Network Time, select Authenticated
Network time synchronization and enter the Key id and the Key value for
the time servers.
8. On the File menu, click Save.
9. In the Search box, type Date and Time to search for the date and time object
on all connected SmartStruxure server devices in your SmartStruxure solution
system.

10. Click the Search button .


11. In the Search view, select the SmartStruxure server devices with the time
and date you want to synchronize with the Enterprise Server time server
settings.

12. Click the Show/Hide Property Grid button .


Continued on next page

System 04-17005-03-en, October 2015


366
17 Localization Time and Time Zone
17.13 Synchronizing Time Settings on Multiple SmartStruxure Server Devices

13. Click the Time tab.

14. In the Lead object box, enter /[Enterprise Server Name]/System/Time


Settings/Date and Time.
15. On the File menu, click Save.

04-17005-03-en, October 2015 System


367
17 Localization Time and Time Zone
17.14 Synchronize Time Zone Settings

17.14 Synchronize Time Zone Settings


You can establish a lead and shadow relationship to synchronize the time zone
settings on all your SmartStruxure servers. The Time Zone object on the lead server
contains the time zone settings that are inherited by shadow servers.

Figure: Time Xone object on an Enterprise Server


The time zone lead object is configured through the Control Panel - Network
time and time zone, on the Enterprise Server.

System 04-17005-03-en, October 2015


368
17 Localization Time and Time Zone
17.15 Synchronizing Time Zone Settings on Multiple SmartStruxure Server Devices

17.15 Synchronizing Time Zone Settings on


Multiple SmartStruxure Server Devices
You define the time zone settings for connected shadow SmartStruxure server
devices by changing the lead Enterprise Server time zone settings.
For more information, see section 17.14 Synchronize Time Zone Settings on page
368.

To synchronize the time zone settings on multiple


SmartStruxure server devices
1. In WorkStation, in the Search box, type Time Zone to search for the time
zone object on all connected SmartStruxure server devices in your
SmartStruxure solution system.

2. Click the Search button .


3. In the Search view, select the SmartStruxure server devices with the time
zone you want to synchronize with the Enterprise Server time zone settings.

4. Click the Show/Hide Property Grid button .


5. Click the Zone Info tab.

6. In the Lead object box, enter /[Enterprise Server Name]/System/Time


Settings/Time Zone.
7. On the File menu, click Save.

04-17005-03-en, October 2015 System


369
18 Localization User Interface

Topics
Unit Selection Dialog Box
Date and Time Properties Basic Tab
Date and Time Properties Time Tab
Time Zone Properties Basic Tab
Time Zone Properties Zone Info Tab
Enterprise Server Date & Time View
SmartStruxure Server Device Date & Time View
Add or Remove Languages Dialog Box
Unit Conversion Exceptions View
18 Localization User Interface
18.1 Unit Selection Dialog Box

18.1 Unit Selection Dialog Box


Use the Unit Selection dialog box to define the unit and metric prefix of a value.

Figure: Unit sekection dialog box

Table: Unit Selection Dialog Box


Component Description

Filter Type the name of the category or unit you


are searching for.

Units Select the category and unit of the value.

Prefix Select the prefix of the unit.

Selected unit Displays the defined unit with prefix.

04-17005-03-en, October 2015 System


373
18 Localization User Interface
18.2 Date and Time Properties Basic Tab

18.2 Date and Time Properties Basic Tab


Use the Basic tab to configure the properties of the Time object.

Figure: Basic tab

System 04-17005-03-en, October 2015


374
18 Localization User Interface
18.3 Date and Time Properties Time Tab

18.3 Date and Time Properties Time Tab


Use the Time tab to configure the network time server addresses or establish a
lead and shadow relationship on SmartStruxure servers.

Figure: Time tab

Table: Time Tab


Component Description

Use external NTP server Select Enabled to define the primary and
secondary NTP server addresses for
connected shadow SmartStruxure server
devices.

NTP Server 1 Type the address to the primary time server


to which the shadow SmartStruxure server
devices date and time object synchronizes
its clock.

NTP Server 2 Type the address to the secondary time


server to which the shadow SmartStruxure
server devices date and time object
synchronizes its clock.

Lead object Enter the object that acts as the lead for this
object.

04-17005-03-en, October 2015 System


375
18 Localization User Interface
18.3 Date and Time Properties Time Tab

Continued
Component Description

NTP Server 1 Key Id Type the ID of the authentication key for the
primary time server.

NTP Server 2 Key Id Type the ID of the authentication key for the
secondary time server.

Password Type the password for the primary time


server.

Confirm Password Type the password for the primary time


server again.

Password Type the password for the secondary time


server.

Confirm Password Type the password for the secondary time


server again.

Authenticate Network Time Select if you want to use authenticated


Synchronization network time synchronizing.

System 04-17005-03-en, October 2015


376
18 Localization User Interface
18.4 Time Zone Properties Basic Tab

18.4 Time Zone Properties Basic Tab


Use the Basic tab to configure the properties of the Time zone object.

Figure: Basic tab

04-17005-03-en, October 2015 System


377
18 Localization User Interface
18.5 Time Zone Properties Zone Info Tab

18.5 Time Zone Properties Zone Info Tab


Use the Zone Info tab to configure the time zone settings or establish a lead and
shadow relationship on SmartStruxure servers.

Figure: Zone info tab

Table: Zone Info Tab


Component Description

Time zone Select the time zone the SmartStruxure


server belongs to.

Use custom time zone Select Enabled to configure and use a


custom time zone.

Lead object Enter the object that acts as the lead for this
object.

System 04-17005-03-en, October 2015


378
18 Localization User Interface
18.5 Time Zone Properties Zone Info Tab

Continued
Component Description

Description Type a description or name for the


customized time zone DST settings.

GMT offset - hours Select the time difference the time zone has
from GMT in hours.

GMT offset - minutes Select the time difference the time zone has
from GMT in minutes.

Daylight saving time Select Enable if the custom time zone uses
daylight saving time.

DST Delta (Minutes) Select the time adjustment, in minutes, for


the daylight saving time.

DST Start Month Select the month that daylight saving time
starts.

DST Start Week Select the week of the month that daylight
saving time starts.

DST Start Day Select the day of the week that daylight
saving time starts.

DST Start Hour Select the hour of the day that daylight
saving time starts.

DST Start Minute Select the minute of the hour that daylight
saving time starts.

DST End Month Select the month that daylight saving time
ends.

DST End Week Select the week that daylight saving time
ends.

DST End Day Select the day of the week that daylight
saving time ends.

DST End Hour Select the hour of the day that daylight
saving time ends.

DST End Minute Select the minute of the hour that daylight
saving time ends.

04-17005-03-en, October 2015 System


379
18 Localization User Interface
18.6 Enterprise Server Date & Time View

18.6 Enterprise Server Date & Time View


Use the Date & Time view to configure shadow SmartStruxure server device
network time settings, and the time zone of the Enterprise Server.

Figure: Date & time view

Table: Date & Time View


Component Description

Network time synchronization Select to define the primary and secondary


network time server addresses for
connected shadow SmartStruxure server
device.

Enable Select to define the primary and secondary


network time server addresses for
connected shadow SmartStruxure server
device.

Authenticate Network time Select if you want to use authenticated


synchronization network time synchronizing.

System 04-17005-03-en, October 2015


380
18 Localization User Interface
18.6 Enterprise Server Date & Time View

Continued
Component Description

Primary time server Type the address to the primary time server
to which the shadow SmartStruxure server
devices date and time object synchronizes
its clock.

Secondary time server Type the address to the secondary time


server to which the shadow SmartStruxure
server devices date and time object
synchronizes its clock.

Key id Type the ID of the authentication key for the


primary time server.

Key id Type the ID of the authentication key for the


secondary time server.

Key value Type the password for the primary time


server.

Key value Type the password for the secondary time


server.

Manually adjust date & time Select to use manual date and time
configuration for connected shadow
SmartStruxure server devices.

Disable Select to disable all SmartStruxure server


device date and time shadow relationships
and use the SmartStruxure server device
own date and time configurations.

Predefined time zone Select the time zone the SmartStruxure


server belongs to.

Custom time zone Select to manually define the SmartStruxure


server time zone.

Description Type a description or name for the


customized time zone DST settings.

UTC offset Select the time difference the time zone has
from UTC in the hours and minutes boxes.

This custom time zone uses daylight Select to enable the daylight saving time
saving time settings for the custom time zone.

Time adjustment Select the time adjustment, in minutes, for


the daylight saving time.

Month - Start Select the month that daylight saving time


starts.

Week - Start Select the week of the month that daylight


saving time starts.

Day - Start Select the day of the week that daylight


saving time starts.

04-17005-03-en, October 2015 System


381
18 Localization User Interface
18.6 Enterprise Server Date & Time View

Continued
Component Description

Time - Start Select the time that daylight saving time


starts.

Month - End Select the month that daylight saving time


ends.

Week - End Select the week that daylight saving time


ends.

Day - End Select the day of the week that daylight


saving time ends.

Time - End Select the time that daylight saving time


ends.

System 04-17005-03-en, October 2015


382
18 Localization User Interface
18.7 SmartStruxure Server Device Date & Time View

18.7 SmartStruxure Server Device Date &


Time View
Use the Automation Server - Date & Time view to configure the SmartStruxure
server device time and time zone.

Figure: Date & Time view

Table: Date & Time View


Component Description

Network time synchronization Select to synchronize the SmartStruxure


server device clock with a network time
server.

Authenticate Network time Select if you want to use authenticated


synchronization network time synchronizing.

Primary time server Type the address to the primary time server
to which the shadow SmartStruxure server
devices date and time object synchronizes
its clock.

04-17005-03-en, October 2015 System


383
18 Localization User Interface
18.7 SmartStruxure Server Device Date & Time View

Continued
Component Description

Secondary time server Type the address to the secondary time


server to which the shadow SmartStruxure
server devices date and time object
synchronizes its clock.

Key id Type the ID of the authentication key for the


primary time server.

Key id Type the ID of the authentication key for the


secondary time server.

Key value Type the password for the primary time


server.

Key value Type the password for the secondary time


server.

Manually adjust date & time Select to manually set the SmartStruxure
server device clock.

Local date & time Enter the date and time you want to set the
SmartStruxure server device clock to. This
time is displayed in SmartStruxure server
device local time.

Predefined time zone Select the time zone the SmartStruxure


server belongs to.

Custom time zone Select to manually define the SmartStruxure


server time zone.

Description Type a description or name for the


customized time zone DST settings.

UTC offset Select the time difference the time zone has
from UTC in the hours and minutes boxes.

This custom time zone uses daylight Select to enable the daylight saving time
saving time settings for the custom time zone.

Time adjustment Select the time adjustment, in minutes, for


the daylight saving time.

Month - Start Select the month that daylight saving time


starts.

Week - Start Select the week of the month that daylight


saving time starts.

Day - Start Select the day of the week that daylight


saving time starts.

Time - Start Select the time that daylight saving time


starts.

Month - End Select the month that daylight saving time


ends.

System 04-17005-03-en, October 2015


384
18 Localization User Interface
18.7 SmartStruxure Server Device Date & Time View

Continued
Component Description

Week - End Select the week that daylight saving time


ends.

Day - End Select the day of the week that daylight


saving time ends.

Time- End Select the time that daylight saving time


ends.

04-17005-03-en, October 2015 System


385
18 Localization User Interface
18.8 Add or Remove Languages Dialog Box

18.8 Add or Remove Languages Dialog Box


Use the Add or remove languages dialog box to add or remove language that
can be selected in WebStation.

Figure: Add or remove languages dialog box

Table: Add or Remove Languages Dialog Box


Component Description

Add Click to add a language to the list. For more


information, see section 16.3 Language
Packages on page 325.

Remove Click to remove the selected language. For


more information, see section 16.3
Language Packages on page 325.

System 04-17005-03-en, October 2015


386
18 Localization User Interface
18.9 Unit Conversion Exceptions View

18.9 Unit Conversion Exceptions View


Use the Unit Conversion Exceptions view to override regional settings within a
domain.

Figure: Unit Conversion Exceptions view

Component Description

Add
Click to add a unit conversion exception to
the list.

Remove
Click to remove a unit conversion exception
from the list.

Show/Hide Group Box


Click to display the Show/Hide Group box to
group and sort objects. For more
information, see the Group and Sort Objects
topic on WebHelp.

Quick filter Enter a word or a character to filter on. For


more information, see section 49.6 Quick
Filter on page 1571.

Configured Unit Enter the configured unit that is to trigger a


conversion exception. The configured unit is
the unit that is native to the value/object
before being localized by any operating
system.

SI Display Unit Enter how the configured unit is to be


displayed in an SI metric system.

US Display Unit Enter how the configured unit is to be


displayed in a US customary system.

04-17005-03-en, October 2015 System


387
18 Localization User Interface
18.9 Unit Conversion Exceptions View

Component Description

Note
Users in a domain become subjects to added unit conversion exceptions the next
time they log on.

System 04-17005-03-en, October 2015


388
19 User Account Management

Topics
User Account Management Overview
Opening the Account Management Control Panel
User Accounts and User Account Groups
Creating a User Account
Editing a User Account Profile
Renaming a User Account
Disabling a User Account
Enabling a Disabled User Account
Setting an Expiration Date for a User Account
Removing the Expiration Date for a User Account
Deleting a User Account
Automatic Logoff
Setting the Automatic Logoff Time
19 User Account Management
19.1 User Account Management Overview

19.1 User Account Management Overview


When logging on to a SmartStruxure server or Project Configuration Server you
have to authenticate yourself by using a valid user account, the user account has to
belong to the same domain as the server you log on to.
The user account has to be a member of at least one user account group or be
mapped through an active directory user account group. To restrict the user,
software permissions are added to the user account group or to the individual user
account. One or more customized workspaces can be connected to the user
account group.
When logging on to the SmartStruxure server that acts as the domain controller, in
this example an Enterprise Server, you have access to all SmartStruxure servers in
the domain without using additional log on. If you log on to an individual
SmartStruxure server, in this example a Automation Server, you have no access to
other SmartStruxure servers in the domain.

Figure: To log on to a Building Operation SmartStruxure server you have to use a valid
user account that is located in the same domain as the SmartStruxure server.
Building Operation considers a user account valid when:
The user account exists
The user account is not disabled or expired
The user account belongs to a user account group or mapped active directory
user group

04-17005-03-en, October 2015 System


391
19 User Account Management
19.1 User Account Management Overview

The user account group belongs to a domain


The user account has defined software permissions, either defined on the
individual account or inherited from the user account group

19.1.1 User Accounts and User Account Groups


A user account can be a member of one or more user account groups and belongs
to a particular domain.
For more information, see section 19.3 User Accounts and User Account Groups
on page 395.

19.1.2 Domains
A Building Operation domain contains user accounts, user account groups,
software permissions, workspaces, and one or several SmartStruxure servers. The
SmartStruxure server that hosts and administers the domain is called the domain
controller.
For more information, see section 21.1 Domains on page 459.

19.1.3 Software Permissions


Software Permissions are used to control user activities in a software application.
For example, you can set up these permissions to manage the type of data and
commands the user has permission to within a workspace, panel, or domain.
Software permissions comprise path permissions and command permissions.
For more information, see section 22.1 Software Permissions on page 483.

19.1.4 Log on Methods


Building Operation provides two methods to log on to the system. Either you log on
as a Windows User with your Windows Active Directory user account or as Building
Operation user with your Building Operation user account.
For more information, see section 21.2 Log On Methods on page 462.

19.1.5 Workspace Management


The workspace defines the content and layout of WorkStation. The content and
layout of the workspace can be adapted to users or user account groups different
tasks.
For more information, see section 24.1 Workspace Management on page 537.

System 04-17005-03-en, October 2015


392
19 User Account Management
19.1 User Account Management Overview

19.1.6 Automatic Logoff


The automatic logoff function makes it possible for the system to automatically log
off a user after a specified time of inactivity.
For more information, see section 19.12 Automatic Logoff on page 419.

19.1.7 Guest Log On in WebStation


A guest log on is used if you want the user to get immediate access to Building
Operation using WebStation.
For more information, see section 21.3 Guest Log On in WebStation on page 463.

04-17005-03-en, October 2015 System


393
19 User Account Management
19.2 Opening the Account Management Control Panel

19.2 Opening the Account Management


Control Panel
You open the Account Management control panel in the Work area to create and
configure Building Operation objects.
For more information, see section 49.4 Control Panel on page 1569.

To open the Account Management control panel


1. On the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.

System 04-17005-03-en, October 2015


394
19 User Account Management
19.3 User Accounts and User Account Groups

19.3 User Accounts and User Account


Groups
A user account can be a member of one or more user account groups and belongs
to a particular domain.

User Accounts
A user account uniquely identifies a user to the system. When setting up user
accounts, keep the following points in mind:
Configure as few settings as possible at the user account level.
Assign a required user name and password, which the system uses for
identification and authentication purposes. For more information, see section
23.1 Password Administration on page 521.
The user account is unique within the domain it belongs to. For example, an
admin user account is located in Domain A. This account cannot be used to
administrate Domain B. For more information, see section 21.1 Domains on
page 459.
Manage accounts at the domain level using a default administrator account.
For more information, see section 21.11 Administration Accounts in
SmartStruxure Server Local Domain on page 480.
Track user activity at the user-account level. For more information, see section
25.2 Audit Trailing of User Activity on page 582.

User Account Groups


A User Account Group can contain both user accounts and other user account
groups. To facilitate the creation and administration of users, assign software
permissions and workspaces to user account groups instead of individual user
accounts.
In this example, Paul is a member of the Janitor group and the Administrator group.
His account inherits the software permissions and workspaces of both groups.
Susan is a member of the Administrator group and inherits the software
permissions and workspaces of the Administrator group.

04-17005-03-en, October 2015 System


395
19 User Account Management
19.3 User Accounts and User Account Groups

Figure: A user account belongs to a domain and is a member of one or more user account
groups

Note
Although user accounts are members of user account groups, they are not
physically stored in user account groups. Instead, user accounts and user
account groups are parallel entities so that individual accounts can be
members of one or more groups.

19.3.1 Windows Active Directory User Groups


You can map Windows Active Directory groups to Building Operation user account
groups if Building Operation runs on a network that uses this directory to manage
users and user account groups. A Building Operation user account group that
includes a Windows account group can be member of another Building Operation
user account group.
For more information, see section 20.1 Windows Active Directory User Groups on
page 425.

System 04-17005-03-en, October 2015


396
19 User Account Management
19.3 User Accounts and User Account Groups

19.3.2 WorkStation Account Management


As a WorkStation administrator, you can change passwords, track user activities,
validate accounts, and set up user and user and user group accounts.
For more information, see section 25.1 WorkStation Account Management on
page 581.

04-17005-03-en, October 2015 System


397
19 User Account Management
19.4 Creating a User Account

19.4 Creating a User Account


You create and configure a user account for each person requiring access to
Building Operation.
For more information, see section 19.3 User Accounts and User Account Groups
on page 395.

To create a user account


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

System 04-17005-03-en, October 2015


398
19 User Account Management
19.4 Creating a User Account

4. In the Domain box, select the domain the account is to be created in.

5. In the User Accounts area, click Add.


6. In the Name box, type a name for the user account.

7. In the Description box, type a description.


8. Click Next.
Continued on next page

04-17005-03-en, October 2015 System


399
19 User Account Management
19.4 Creating a User Account

9. In the First name box, type the user's name.

10. In the Middle name box, type the user's middle name.
11. In the Last name box, type the user's last name.
12. In the Home email address box, type the user's email address.
13. In the Work email address, type the users work email address.
14. In the Expires on box, enter a date and time when the user account expires
or leave these fields empty if you do not want the user account to expire.
15. In the Password box, type a password for the user.

16. In the Confirm Password box, type the password again.


17. Click Create.
18. Click OK.

System 04-17005-03-en, October 2015


400
19 User Account Management
19.5 Editing a User Account Profile

19.5 Editing a User Account Profile


You edit the profile information of a user account so that it is up-to-date with the
user's current situation.
For more information, see section 19.3 User Accounts and User Account Groups
on page 395.

To edit a user account profile


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

04-17005-03-en, October 2015 System


401
19 User Account Management
19.5 Editing a User Account Profile

4. In the Domain list box, select the domain the user account belongs to.

5. In the User Accounts list box, select the user account you want to edit the
profile information.
6. Click Summary.
7. Click the Profile tab.
8. Edit the user account profile information.

Continued on next page

System 04-17005-03-en, October 2015


402
19 User Account Management
19.5 Editing a User Account Profile

9. Click the Save button .

04-17005-03-en, October 2015 System


403
19 User Account Management
19.6 Renaming a User Account

19.6 Renaming a User Account


You rename a user account, for example, to update the user account according to
a user's new name. Renaming the account does not affect the account's
membership in user account groups.
For more information, see section 19.3 User Accounts and User Account Groups
on page 395.

To rename a user account


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

System 04-17005-03-en, October 2015


404
19 User Account Management
19.6 Renaming a User Account

4. Click List users.

5. Select the user account you want to rename.

6. On the Edit menu, click Rename.


7. In the Object Name box, type a new name for the user account.

8. Click OK.

04-17005-03-en, October 2015 System


405
19 User Account Management
19.7 Disabling a User Account

19.7 Disabling a User Account


You disable a user account to prevent the user from accessing WorkStation.
For more information, see section 19.3 User Accounts and User Account Groups
on page 395.

To disable a user account


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

Continued on next page

System 04-17005-03-en, October 2015


406
19 User Account Management
19.7 Disabling a User Account

3. Click Account management.

4. In the Domain list, select the domain the user account belongs to.
5. In the User Accounts list, select the user account you want to disable.
6. Click Summary.
Continued on next page

04-17005-03-en, October 2015 System


407
19 User Account Management
19.7 Disabling a User Account

7. In the Disabled box, select True to disable the account.

8. Click the Save button .

System 04-17005-03-en, October 2015


408
19 User Account Management
19.8 Enabling a Disabled User Account

19.8 Enabling a Disabled User Account


You enable a disabled user account to give the user access to WorkStation.
For more information, see section 19.3 User Accounts and User Account Groups
on page 395.

To enable a disabled user account


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

Continued on next page

04-17005-03-en, October 2015 System


409
19 User Account Management
19.8 Enabling a Disabled User Account

3. Click Account management.

4. In the Domain list, select the domain the user account belongs to.
5. In the User Accounts list, select the user account.
6. Click Summary.
Continued on next page

System 04-17005-03-en, October 2015


410
19 User Account Management
19.8 Enabling a Disabled User Account

7. In the Disabled box, select False to enable the account.

8. Click the Save button .

04-17005-03-en, October 2015 System


411
19 User Account Management
19.9 Setting an Expiration Date for a User Account

19.9 Setting an Expiration Date for a User


Account
You set an expiration date for an account to limit the time period a user has access
to WorkStation.
For more information, see section 19.3 User Accounts and User Account Groups
on page 395.

To set an expiration date for a user account


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

System 04-17005-03-en, October 2015


412
19 User Account Management
19.9 Setting an Expiration Date for a User Account

4. In the Domain list, select the domain the user account belongs to.

5. In the User Accounts list, select the user account.


6. Click Summary.
Continued on next page

04-17005-03-en, October 2015 System


413
19 User Account Management
19.9 Setting an Expiration Date for a User Account

7. In the Expires on boxes, select the date and the time when you want the
user account to expire.

8. Click the Save button .

System 04-17005-03-en, October 2015


414
19 User Account Management
19.10 Removing the Expiration Date for a User Account

19.10 Removing the Expiration Date for a


User Account
You remove the expiration date for a user account so that there is no time limit for
how long a user can access WorkStation.
For more information, see section 19.3 User Accounts and User Account Groups
on page 395.

To remove the expiration date for a user account


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

04-17005-03-en, October 2015 System


415
19 User Account Management
19.10 Removing the Expiration Date for a User Account

4. In the Domain list, select the domain the user account belongs to.

5. In the User Accounts list, select the user account.


6. Click Summary.
7. In the Expires on boxes, remove the date and time settings for the account.

8. Click the Save button .

System 04-17005-03-en, October 2015


416
19 User Account Management
19.11 Deleting a User Account

19.11 Deleting a User Account


You delete a user account, for example, if an employee has left the company. All
references to other Building Operation objects are deleted.
For more information, see section 19.3 User Accounts and User Account Groups
on page 395.

To delete a user account


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

04-17005-03-en, October 2015 System


417
19 User Account Management
19.11 Deleting a User Account

4. In the Domain list box, select the domain the user account belongs to.

5. In the User Accounts list box, select the user account you want to delete.

6. Click the Delete button .


7. In the Confirm Delete dialog box, click Yes.

System 04-17005-03-en, October 2015


418
19 User Account Management
19.12 Automatic Logoff

19.12 Automatic Logoff


The automatic logoff function makes it possible for the system to automatically log
off a user after a specified time of inactivity.
Inactivity means that no user-initiated activity using the mouse or keyboard has
been made. However, if a user has has started a large task in Workstation, for
example an import or a large copy and paste, the user is still considered to be
active as long as the process is ongoing in Workstation.
The automatic logoff function increases security and ensures that WorkStation
users do not occupy licenses they are not using.
When a user is logged off by the automatic logoff function all settings that are not
saved are lost.
The automatic logoff time is set at user group level. If a user belongs to more than
one group, the automatic logoff time for the user is defined by the group that has
the longest automatic logoff time.
For example, a user belongs to two groups: a group with the automatic logoff time
of five minutes and a group with the automatic log off time of 15 minutes. The
automatic logoff time for the user is 15 minutes.
If a user is belongs to a group that does not have the automatic log off function
enabled, the user is never logged off.
The default local admin account is logged off after ten minutes of inactivity. You
cannot change this setting.

04-17005-03-en, October 2015 System


419
19 User Account Management
19.13 Setting the Automatic Logoff Time

19.13 Setting the Automatic Logoff Time


Use the automatic logoff function to avoid access by unauthorized users and
ensure that WorkStation users do not occupy a license they are not using.
For more information, see section 19.12 Automatic Logoff on page 419.

To set the automatic logoff time


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


4. In the Server list, select the SmartStruxure server containing the user account
group you want to set the auto log off time for.
5. In the Domain list, select the domain the user account group belongs to.

Continued on next page

System 04-17005-03-en, October 2015


420
19 User Account Management
19.13 Setting the Automatic Logoff Time

6. In the User Account Groups list, select the user account group.
7. Click Policies.

8. Select Automatic logoff and then select the number of minutes a user in the
user account group can be idle before being logged off.

04-17005-03-en, October 2015 System


421
20 User Account Groups

Topics
Windows Active Directory User Groups
Creating a User Account Group
Editing the Description of a User Account Group
Adding a User Account to a User Account Group
Removing a User Account from a User Account Group
Reviewing the User Account Group Memberships for a User
Account
Adding a User Account Group to a User Account Group
Removing a User Account Group from another User Account
Group
Reviewing the User Account Group Memberships for a User
Account Group
Preventing a Group of Users from Exiting WorkStation
Enabling a Group of Users to Exit WorkStation
Deleting a User Account Group
20 User Account Groups
20.1 Windows Active Directory User Groups

20.1 Windows Active Directory User Groups


You can map Windows Active Directory groups to Building Operation user account
groups if Building Operation runs on a network that uses this directory to manage
users and user account groups. A Building Operation user account group that
includes a Windows account group can be member of another Building Operation
user account group.
Mapping Windows Active Directory account groups to Building Operation user
account groups has advantages both for administrators and operators.
Administrators can manage the user accounts in the Windows Active Directory,
rather than managing the accounts in two places. Any changes are instantly
implemented to the mapped Building Operation user account group. Operators
only have to remember the Windows login. Once logged in to a Windows user
account that is mapped to a Building Operation account, the user is authenticated
to access WorkStation without having to log in a second time.

Note
Windows Active Directory account groups can only be mapped on
SmartStruxure servers such as Enterprise Servers, which are based upon
Microsoft Windows operating system. SmartStruxure server devices cannot
map Windows Active Directory groups.

For example, the Windows Active Directory user account groups Main Admin and
Main User are mapped to the Building Operation user account groups
Administrators and External Users. The External Users user account group is a
member of the Operator user account group. The Administrators account group,
which is a member of the External Users, inherits access to the Operator
workspace.

Important
If several Windows Active Directory account groups have the same name, any
Building Operation user account group mapped to one of these groups will also
be mapped to the other Windows Active Directory account groups with the same
name.

04-17005-03-en, October 2015 System


425
20 User Account Groups
20.1 Windows Active Directory User Groups

Figure: Windows Active Directory user account groups mapped to WorkStation user
account groups
The default account for running the Enterprise Server service is the Windows Local
System account. The Windows Local System account has sufficient permissions for
accessing the Active Directory by default.
Make sure that the Enterprise Server service account has sufficient access
permissions to read all user groups necessary in all locations in the Active Directory
in order to be able to log on to the Enterprise Server using the Windows
authentication.

System 04-17005-03-en, October 2015


426
20 User Account Groups
20.2 Creating a User Account Group

20.2 Creating a User Account Group


You create a user account group to make it easier to manage users who require the
same software permissions and workspaces.
For more information, see section 22.2 Software Permissions and User Account
Groups on page 485.

To create a user account group


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

04-17005-03-en, October 2015 System


427
20 User Account Groups
20.2 Creating a User Account Group

4. In the Domain box, select the domain where you want to create the user
account group.

5. In the User Account Groups area, click Add.


6. In the Name box, type a name for the user account group.

7. In the Description box, type a description for the user account group.
8. Click Next.
Continued on next page

System 04-17005-03-en, October 2015


428
20 User Account Groups
20.2 Creating a User Account Group

9. In the Select from box, select a user account group to auto select the user
accounts belonging to that group in the Available User Accounts list.

10. In the Available User Accounts list, select the user accounts you want to
add to the user account group.

11. Click the Add button .


12. Click Next.
Continued on next page

04-17005-03-en, October 2015 System


429
20 User Account Groups
20.2 Creating a User Account Group

13. In the Select from box, select a user account group to auto select the
workspaces assigned to that group in the Selected Workspaces list box.

14. In the Available Workspaces box, select the workspaces you want to add
to the user account group.

15. Click the Add button .


16. Click Next.
Continued on next page

System 04-17005-03-en, October 2015


430
20 User Account Groups
20.2 Creating a User Account Group

17. Select Allow members to close WorkStation if you want the users in the
user account group to be able to close the WorkStation software.

18. Select Log user actions of group members if you want to activate
logging for the users in the user account group.
19. Select Allow members to change password if you want the users in the
user account group to be able to change their own passwords.
20. Select Allow members to access AS Web Configuration if you want the
users in the user account group to be able to log on to SmartStruxure server
devices' Web configuration sites.
21. In the Automatic logoff box, select a time if you want the users in the user
account group to be logged off after a defined time of inactivity. For more
information, see section 19.12 Automatic Logoff on page 419.

22. Click the refresh button to populate the Windows group name box
with Windows Active Directory user account groups.

Note
To connect a Windows Active Directory user account group to a
Building Operation user account group, you need to establish the
connection between the Building Operation domain and Active
Directory Windows domain. For more information, see section 21.4
Creating and Configuring a Domain on page 464.
Windows Active Directory account groups can only be mapped on
SmartStruxure servers such as Enterprise Servers, which are based
upon Microsoft Windows operating system. SmartStruxure server
devices cannot map Windows Active Directory groups.

23. In the Windows group name box, select the Windows Active Directory user
account group you want to map to the Building Operation user account
group.
24. Click Create.

04-17005-03-en, October 2015 System


431
20 User Account Groups
20.3 Editing the Description of a User Account Group

20.3 Editing the Description of a User


Account Group
You edit the description of a user account group to reflect changes in the
organization.
For more information, see section 19.3 User Accounts and User Account Groups
on page 395.

To edit the description of a user account group


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

System 04-17005-03-en, October 2015


432
20 User Account Groups
20.3 Editing the Description of a User Account Group

4. In the Domain list, select the domain the user account group belongs to.

5. In the User Account Groups list, select the user account group you want to
edit the description for.
6. Click Summary.

7. In the Description box, type a new description for the user account group.

8. Click the Save button .

04-17005-03-en, October 2015 System


433
20 User Account Groups
20.4 Adding a User Account to a User Account Group

20.4 Adding a User Account to a User


Account Group
You add a user account to a user account group to add software permissions and
workspaces to a user.
For more information, see section 19.3 User Accounts and User Account Groups
on page 395.

To add a user account to a user account group


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

System 04-17005-03-en, October 2015


434
20 User Account Groups
20.4 Adding a User Account to a User Account Group

4. In the Domain list, select the domain the user account belongs to.

5. In the User Accounts list, select the user account you wish to add to a user
account group.
6. Click Group membership.
Continued on next page

04-17005-03-en, October 2015 System


435
20 User Account Groups
20.4 Adding a User Account to a User Account Group

7. In the Available User Account Groups list, select a user account group

and click the Add button .

8. On the File menu, click Save.

System 04-17005-03-en, October 2015


436
20 User Account Groups
20.5 Removing a User Account from a User Account Group

20.5 Removing a User Account from a User


Account Group
You remove a user account from a user account group to limit the users
permissions to objects and commands.
For more information, see section 19.3 User Accounts and User Account Groups
on page 395.

To remove a user account from a user account group


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

04-17005-03-en, October 2015 System


437
20 User Account Groups
20.5 Removing a User Account from a User Account Group

4. In the Domain list, select the domain the user account belongs to.

5. In the User Accounts list, select the user account.


6. Click Group membership.
Continued on next page

System 04-17005-03-en, October 2015


438
20 User Account Groups
20.5 Removing a User Account from a User Account Group

7. In the Selected User Account Groups list, select the user account group

you want to remove, and click the Remove button .

8. Click the Save button .

04-17005-03-en, October 2015 System


439
20 User Account Groups
20.6 Reviewing the User Account Group Memberships for a User Account

20.6 Reviewing the User Account Group


Memberships for a User Account
You review the user account group membership for a user account to determine
where a user account inherits its settings, either through direct or indirect
membership in user account groups.
For more information, see section 19.3 User Accounts and User Account Groups
on page 395.

To review the group memberships for a user account


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account Management.


Continued on next page

System 04-17005-03-en, October 2015


440
20 User Account Groups
20.6 Reviewing the User Account Group Memberships for a User Account

4. In the Domain list, select the domain the user account belongs to.

5. In the User Account list, select the user account.


6. Click Group membership.

04-17005-03-en, October 2015 System


441
20 User Account Groups
20.7 Adding a User Account Group to a User Account Group

20.7 Adding a User Account Group to a User


Account Group
You add an user account group to a user account group to easier administrate the
settings for a group of users. User account groups inherit the settings of the user
account groups they are members of.
For more information, see section 19.3 User Accounts and User Account Groups
on page 395.

To add a user account group to a user account group


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

System 04-17005-03-en, October 2015


442
20 User Account Groups
20.7 Adding a User Account Group to a User Account Group

4. In the Domain list, select the domain the user account group belongs to.

5. In the User Account Groups list, select the user account group.
6. Click Group membership.
Continued on next page

04-17005-03-en, October 2015 System


443
20 User Account Groups
20.7 Adding a User Account Group to a User Account Group

7. In the Available User Account Groups list, select the user account group

you want to add the user account group to and click the Add button .

8. Click the Save button .

System 04-17005-03-en, October 2015


444
20 User Account Groups
20.8 Removing a User Account Group from another User Account Group

20.8 Removing a User Account Group from


another User Account Group
You remove a user account group from a user account group, for example, if the
user account group does not anymore meet the required software permission.
For more information, see section 19.3 User Accounts and User Account Groups
on page 395.

To remove a user account group from another user account


group
1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

04-17005-03-en, October 2015 System


445
20 User Account Groups
20.8 Removing a User Account Group from another User Account Group

4. In the Domain list, select the domain the user account group belongs to.

5. In the User Account Groups list, select the user account group.
6. Click Group membership.
Continued on next page

System 04-17005-03-en, October 2015


446
20 User Account Groups
20.8 Removing a User Account Group from another User Account Group

7. In the Selected User Account Groups list, select the user account group
you are removing the user account group from and click the Remove button

8. Click the Save button .

04-17005-03-en, October 2015 System


447
20 User Account Groups
20.9 Reviewing the User Account Group Memberships for a User Account Group

20.9 Reviewing the User Account Group


Memberships for a User Account Group
You review the user account group memberships for a user account group as a
way of determining where a user account inherits its settings through direct or
indirect membership in user account groups.
For more information, see section 19.3 User Accounts and User Account Groups
on page 395.

To review the user account group memberships for a user


account group
1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

System 04-17005-03-en, October 2015


448
20 User Account Groups
20.9 Reviewing the User Account Group Memberships for a User Account Group

4. In the Domain list, select the domain the user account group belongs to.

5. In the User Account Groups list, select the user account group.
6. Click Group Membership.

04-17005-03-en, October 2015 System


449
20 User Account Groups
20.10 Preventing a Group of Users from Exiting WorkStation

20.10 Preventing a Group of Users from


Exiting WorkStation
You prevent a group of users from exiting WorkStation to make sure that
WorkStation is not closed on a permanent Building Operation system computer.
This feature must be disabled for all user account groups the user is a member of.
For more information, see section 19.3 User Accounts and User Account Groups
on page 395.

To prevent a group of users from exiting WorkStation


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

System 04-17005-03-en, October 2015


450
20 User Account Groups
20.10 Preventing a Group of Users from Exiting WorkStation

4. In the Domain list, select the domain the user account group belongs to.

5. In the User Account Groups list, select the user account group.
6. Click Policies.
7. Clear the Allow members to close WorkStation box.

8. Click the Save button .

04-17005-03-en, October 2015 System


451
20 User Account Groups
20.11 Enabling a Group of Users to Exit WorkStation

20.11 Enabling a Group of Users to Exit


WorkStation
You enable a group of users to exit WorkStation. To enable a user to exit
WorkStation you only have to configure one of the user account groups that the
user is member of.
For more information, see section 19.3 User Accounts and User Account Groups
on page 395.

To enable a group of users to exit WorkStation


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

System 04-17005-03-en, October 2015


452
20 User Account Groups
20.11 Enabling a Group of Users to Exit WorkStation

4. In the Domain list, select the domain the user account group belongs to.

5. In the User Account Groups list, select the user account group.
6. Click Policies.
7. Select the Allow members to close WorkStation box.

8. Click the Save button .

04-17005-03-en, October 2015 System


453
20 User Account Groups
20.12 Deleting a User Account Group

20.12 Deleting a User Account Group


You delete a user account group to reflect changes in the way users are set up and
assigned software permissions.
For more information, see section 19.3 User Accounts and User Account Groups
on page 395.

To delete a user account group


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

System 04-17005-03-en, October 2015


454
20 User Account Groups
20.12 Deleting a User Account Group

4. In the Domain list, select the domain the user account group belongs to.

5. In the User Account Groups list, select the user account group you want to
delete.

6. Click the Delete button .


7. In the Confirm Delete dialog box, click Yes.

04-17005-03-en, October 2015 System


455
21 Domains

Topics
Domains
Log On Methods
Guest Log On in WebStation
Creating and Configuring a Domain
Editing the Windows Domain Name
Editing the Description of a Domain
Editing the Maximum Logon Attempts
Assigning a SmartStruxure Server Device to a Domain
Removing a SmartStruxure Server Device from a Domain
Deleting a Domain
Administration Accounts in SmartStruxure Server Local
Domain
21 Domains
21.1 Domains

21.1 Domains
A Building Operation domain contains user accounts, user account groups,
software permissions, workspaces, and one or several SmartStruxure servers. The
SmartStruxure server that hosts and administers the domain is called the domain
controller.
Normally, a user account or user account group that is a member of a domain that
hosts several Building Operation servers has access to all servers within the domain
without additional logon. The user account or user account group can have
restricted path permissions preventing the user to access the servers.
You can set up domains in several ways. You can have a communication domain
that only contains Building Operation servers and another domain that contains
users, workspaces, and software permissions. Or you can have a combined
domain that manages both servers and users.

Note
A Building Operation server can belong to more than one domain.

For example, a Building Operation system consists of two domains, the Inner City
domain and the Outer city domain. The user Larry has a user account in the Inner
City domain. The Inner City domain contains several Enterprise Servers and
Automation Servers. One of the Automation Servers belongs to both the Inner City
domain and the Outer City domain. Larry cannot access the servers in the Outer
City domain, except for the shared Automation Server.

04-17005-03-en, October 2015 System


459
21 Domains
21.1 Domains

Figure: Building Operation domain and its components.

Note
You cannot change the name of a domain that is shared between SmartStruxure
servers.

21.1.1 Windows Active Directory Domain


If your domain controller is within a network that has a Windows Active Directory,
you can establish a connection between your Building Operation domain and the
Windows Active Directory. This connection enables inherited user account groups
from the Windows Active Directory to Building Operation, and allows users to log on
to WorkStation with their Windows user accounts.

System 04-17005-03-en, October 2015


460
21 Domains
21.1 Domains

Important
If the Windows Active Directory name is changed, you have to manually update
the change in Building Operation.

Building Operation supports Fully Qualified Domain Name (FQDN) and NetBIOS
name. The NetBIOS name is displayed in the Log on screen even if FQDN is used
as a log on method.

21.1.2 Server Local Domain


By default, all servers have a local domain that includes a local administrator
account, administrator user account group, and administrator workspace. The local
domain of a server cannot hold a Building Operation multiserver system. When
logging on to the local domain of a server, you access only the unique server.
A local domain and its content cannot be deleted, edited or include other Building
Operation servers.

21.1.3 Administration Accounts in Server Local


Domain
You can manage user accounts on a domain controller by logging on to the local
domain of the SmartStruxure server, using the local administrator and local reports
administrator accounts.
For more information, see section 21.11 Administration Accounts in SmartStruxure
Server Local Domain on page 480.

04-17005-03-en, October 2015 System


461
21 Domains
21.2 Log On Methods

21.2 Log On Methods


Building Operation provides two methods to log on to the system: as a Windows
user or as a Building Operation user.

21.2.1 Log On as a Windows User


If you are logged on with a Windows user account that is mapped in Building
Operation to the Windows Active Directory user account group that you belong to,
you can select a SmartStruxure server and log on in a single sign-on. For more
information, see the Logging on to WorkStation using your Windows Credentials
topic on WebHelp.
You can also log on using another Windows account that is mapped in Building
Operation. For more information, see the Logging on to WorkStation as another
Windows User topic on WebHelp.

21.2.2 Log On as a Building Operation User


When logging on as a Building Operation user, you authenticate yourself with a
Building Operation account user name and password. For more information, see
the Logging on to WorkStation as a Building Operation User topic on WebHelp.
You also select which Building Operation domain and SmartStruxure server that
you want to access. For more information, see section 19.3 User Accounts and
User Account Groups on page 395.
With a Building Operation user account, you can also connect directly to the local
domain of a SmartStruxure server. For more information, see section 21.11
Administration Accounts in SmartStruxure Server Local Domain on page 480.

21.2.3 Password Administration


As a WorkStation administrator, you can change users passwords, force users to
change their passwords at next logon, or enable and disable the ability of users to
change their passwords.
For more information, see section 23.1 Password Administration on page 521.

System 04-17005-03-en, October 2015


462
21 Domains
21.3 Guest Log On in WebStation

21.3 Guest Log On in WebStation


A guest log on is used if you want the user to get immediate access to Building
Operation using WebStation.
When using a guest logon for WebStation, the user does not have to provide a user
name or password. Anyone who tries to access the system is logged on
automatically if the guest log on is used.
The guest log on is created using WorkStation and must be named GUEST and use
the password GUEST. The guest log on is valid for the domain it is created on. The
guest log on can be added to any user group in the system.
The guest account can be used immediately after you have created it. But if you
have logged on to WebStation before you created the guest account, you have to
clear cookies in the browser to log on automatically using the guest account.

04-17005-03-en, October 2015 System


463
21 Domains
21.4 Creating and Configuring a Domain

21.4 Creating and Configuring a Domain


You create a domain to group SmartStruxure servers, users, and user groups in
one domain so that all users and user groups of the domain have access to all
SmartStruxure servers within the domain. You can connect the domain to a
Windows Active Directory domain to make user accounts from the Windows Active
Directory accessible to Building Operation, and to allow users to log on
to WorkStation with their Windows user account.
For more information, see section 21.1 Domains on page 459.

To create and configure a domain


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Domain.
Continued on next page

System 04-17005-03-en, October 2015


464
21 Domains
21.4 Creating and Configuring a Domain

4. Click Add.

5. In the Name box, type a name for the domain.

6. In the Description box, type a description for the domain.


7. Click Next.
8. In the Windows domain name box, type the name of a Windows Active
Directory domain to connect the domain to a Windows domain.

Note
The Windows domain name box is case sensitive. The name
must be spelled exactly as the name of the Windows Active
Directory domain.

Continued on next page

04-17005-03-en, October 2015 System


465
21 Domains
21.4 Creating and Configuring a Domain

9. Click Next.
10. In the Available Servers box, select the SmartStruxure servers that you
want to connect to the domain.

Note
The Domain Members page appears only if there are any
SmartStruxure servers available to connect to the domain.

Continued on next page

System 04-17005-03-en, October 2015


466
21 Domains
21.4 Creating and Configuring a Domain

11. Click the Add button .


12. Click Next.
13. In the Maximum logon attempts box, enter the number of failed logon
attempts allowed for users belonging to the domain before their user accounts
are temporarily disabled.

14. Click Create.

04-17005-03-en, October 2015 System


467
21 Domains
21.5 Editing the Windows Domain Name

21.5 Editing the Windows Domain Name


In order for members of the Windows Active Directory to be mapped into the
Building Operation user management system, you edit the Windows domain name
to match the Windows domain name established by the customers IT department.
For more information, see section 21.1 Domains on page 459.

To edit the Windows domain name


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Domain.
Continued on next page

System 04-17005-03-en, October 2015


468
21 Domains
21.5 Editing the Windows Domain Name

4. In the Domains box, select the domain that you want to edit.

5. Click Summary.
6. In the Windows domain name box, type the name of the Windows Active
Directory domain you want to connect to.

7. Click the Save button .

04-17005-03-en, October 2015 System


469
21 Domains
21.6 Editing the Description of a Domain

21.6 Editing the Description of a Domain


You edit the description of a domain to specify what the domain is used for.
For more information, see section 21.1 Domains on page 459.

To edit the description of a domain


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Domain.
Continued on next page

System 04-17005-03-en, October 2015


470
21 Domains
21.6 Editing the Description of a Domain

4. In the Domains box, select the domain for which you wish to edit the
description.

5. Click Summary.
6. In the Description box, type a description for the domain.

7. Click the Save button .

04-17005-03-en, October 2015 System


471
21 Domains
21.7 Editing the Maximum Logon Attempts

21.7 Editing the Maximum Logon Attempts


You edit the maximum logon attempts to increase or decrease the number of times
a user can fail logging on to the system before the user account is locked. Domain
settings, such as Maximum Logon Attempts, apply to every user that belongs to the
domain.
For more information, see section 21.1 Domains on page 459.

To edit the maximum logon attempts


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Domain.
Continued on next page

System 04-17005-03-en, October 2015


472
21 Domains
21.7 Editing the Maximum Logon Attempts

4. In the Domains box, select the domain that you want to edit.

5. Click Policies.
6. In the Maximum logon attempts box, enter a new number.

7. On the File menu, click the Save.

04-17005-03-en, October 2015 System


473
21 Domains
21.8 Assigning a SmartStruxure Server Device to a Domain

21.8 Assigning a SmartStruxure Server


Device to a Domain
You assign a SmartStruxure server device to a domain in the live system to extend
your current domain.
For more information, see section 21.1 Domains on page 459.

To assign a SmartStruxure server device to a domain


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Domain.
Continued on next page

System 04-17005-03-en, October 2015


474
21 Domains
21.8 Assigning a SmartStruxure Server Device to a Domain

4. In the Domains list, select the domain you are adding a SmartStruxure server
device to.

5. Click Domain members.

6. In the Available Servers list, select a server and click the Add button .

7. Click the Save button .

04-17005-03-en, October 2015 System


475
21 Domains
21.9 Removing a SmartStruxure Server Device from a Domain

21.9 Removing a SmartStruxure Server


Device from a Domain
You remove a SmartStruxure server device from a domain, for example, limit the
Building Operation system to only hold SmartStruxure servers in use.
For more information, see section 21.1 Domains on page 459.

To remove a SmartStruxure server device from a domain


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure Server.

3. Click Domain.
Continued on next page

System 04-17005-03-en, October 2015


476
21 Domains
21.9 Removing a SmartStruxure Server Device from a Domain

4. In the Domains list, select a domain.

5. Click Domain members.


6. In the Selected Servers list, select the SmartStruxure server device, and

click the Remove button .

7. Click the Save button .

04-17005-03-en, October 2015 System


477
21 Domains
21.10 Deleting a Domain

21.10 Deleting a Domain


You delete a domain that is not anymore necessary in the Building Operation
system.
For more information, see section 21.1 Domains on page 459.

Note
You cannot delete the default local domain that was installed with the system.
You cannot restore a domain that you have deleted.

To delete a domain
1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Domain.
Continued on next page

System 04-17005-03-en, October 2015


478
21 Domains
21.10 Deleting a Domain

4. In the Domain list, select the domain you are deleting.

5. Click the Delete button .


6. Click Yes.

7. In the Confirm Delete dialog box, click Yes.

04-17005-03-en, October 2015 System


479
21 Domains
21.11 Administration Accounts in SmartStruxure Server Local Domain

21.11 Administration Accounts in


SmartStruxure Server Local Domain
You can manage user accounts on a domain controller by logging on to the local
domain of the SmartStruxure server, using the local administrator and local reports
administrator accounts.

21.11.1 Admin Account


Each SmartStruxure Server has a local administrator account, named admin. This
account is preferably used to log on to the SmartStruxure Server the first time to
create a new domain with an administration account. To manage and administrate
the new domain, it is recommended that you log on to the domain with your domain
administration account.
The local administrator account cannot be changed or deleted.

21.11.2 Reports Administrator Account


SystemReportsService is the user account for the Reporting Agent service. The
account allows the Reporting Agent service to log on to the Enterprise Server. This
user account is set up during the installation of the Enterprise Server and
WorkStation and does not require any configuration.
For more information, see the WebReports User Accounts topic on WebHelp.

System 04-17005-03-en, October 2015


480
22 Software Permissions

Topics
Software Permissions
Software Permissions and User Account Groups
Software Permission Rules
Path Permissions
Path Permissions Example
Command Permissions
Assigning Software Permissions to a User Account
Editing the Software Permissions of a User Account
Removing Software Permissions from a User Account
Assigning Software Permissions to a User Account Group
Editing the Software Permissions of a User Account Group
Removing Software Permissions from a User Account Group
Context-Sensitive Path Permissions
Configuring Permissions to a Path
Edit Permissions Dialog Box
22 Software Permissions
22.1 Software Permissions

22.1 Software Permissions


Software Permissions are used to control user activities in a software application.
For example, you can set up these permissions to manage the type of data and
commands the user has permission to within a workspace, panel, or domain.
Software permissions comprise path permissions and command permissions.
If no software permissions are configured for a user account or its belonging user
account group, the user has no access to Building Operation.

Note
When creating a new user account, the account has by default no
permissions to access Building Operation.
Any changes to a software permission settings of a user or user group are
applied next time the user logs on.

22.1.1 Path Permissions


Path permissions give a user or user account group basic permissions to the
objects defined in a path. The permission level set on a path applies to all sub levels
unless you set a new permission level for a sub level.
For more information, see section 22.4 Path Permissions on page 488.

22.1.2 Command Permissions


To make the system even more flexible and useful, you can assign a user account
group special command permissions. Use the command permission to control
exceptions from path permissions that allow or deny actions on specific
commands.
For more information, see section 22.6 Command Permissions on page 493.

22.1.3 Software Permission Rules


Software permissions provide members of user account groups with certain rights
and privileges.
For more information, see section 22.3 Software Permission Rules on page 487.

22.1.4 Software Permissions and User Account


Groups
A user account group assembles both user accounts and other user account
groups with similar interests. By using a well planned strategy for your user account
groups, you easily apply software permissions and polices to multiple user
accounts.

04-17005-03-en, October 2015 System


483
22 Software Permissions
22.1 Software Permissions

For more information, see section 22.2 Software Permissions and User Account
Groups on page 485.

22.1.5 Software Permissions Summary


Similar to branches on a tree, software permissions direct users down a particular
path in Building Operation. Along this path or branch, users can be granted
permission to a set of read/write commands that control what they see and do. For
example, an operator uses only a few objects on the WorkStation System Tree,
such as Alarms and trend charts to acknowledge an alarm and survey the system.
The operator has therefore access to those object, while other objects and
commands that are not within the operator's responsibility are hidden.

System 04-17005-03-en, October 2015


484
22 Software Permissions
22.2 Software Permissions and User Account Groups

22.2 Software Permissions and User Account


Groups
A user account group assembles both user accounts and other user account
groups with similar interests. By using a well planned strategy for your user account
groups, you easily apply software permissions and polices to multiple user
accounts.
For optimal efficiency, assign software permissions to user account groups rather
than individual user accounts, wherever possible. Using this approach, you can
associate user accounts to at least one user account group for controlled
permission to Building Operation applications. For instance, you can group
software permissions with user accounts based on common tasks and
responsibilities
You create user accounts groups and then apply one or more software
permissions. For example, create a user account for Paul and associate him with
the two user account groups: Administrators and Janitors. Paul inherits the
software permissions of both user account groups. You can also set up general
policies for the user accounts that are members to the user account group. For
example, you can enable or disable the ability of group members to change their
passwords or to close the User Interface. For more information, see section 22.1
Software Permissions on page 483.

Figure: Users inherit the user account group permissions of which they are members
Paul and Susan are members of the Janitor user account group, which includes an
Operator workspace and a set of software permissions. The Janitor group is also a
member of the Operator group. Therefore, the Janitor group inherits the settings
and workspaces of the Operator group. In other words, Paul and Susan share the
software permissions of both the Janitor and the Operator groups, and have access
to the Operator and Janitor workspaces.

04-17005-03-en, October 2015 System


485
22 Software Permissions
22.2 Software Permissions and User Account Groups

Figure: Software permissions and workspaces are assigned to user account groups

System 04-17005-03-en, October 2015


486
22 Software Permissions
22.3 Software Permission Rules

22.3 Software Permission Rules


Software permissions provide members of user account groups with certain rights
and privileges.
Building Operation uses the following basic rules to interpret software permission
priorities:
The path permission settings of lower branches overrule the settings of higher
branches within a user account group.
For example, a user account group has the Read permission to the path
/Trend_Logs and Full Access permission to the subbranch /Trend_Charts.
Users in the user account group have permission to modify the objects in the
/Trend_Charts but can only view the objects in the superior /Trend_Logs.
If the path /System has the permission level Read, and the subbranch /Alarms
has the permission level Full Access, the users in the group have full access to
the objects in the /Alarms path.
The highest permission rule wins between user account groups.
For example, if a user has inherited the permission to accept an alarm from one
group, this overrules settings from other groups that deny the user the
permission to acknowledge alarms.
The software permissions for a single user account overrule the permissions of
any inherited user account group permissions.
The path permission rules also apply to the basic commands Create, Copy,
Paste, Cut, Move, Rename, and Delete. For example, you only need the Read
path permission level to copy an object but you need the Full Access path
permission level to paste an object. See the table for more details.

Figure: Required permission levels to perform the basic commands.

04-17005-03-en, October 2015 System


487
22 Software Permissions
22.4 Path Permissions

22.4 Path Permissions


Path permissions give a user or user account group basic permissions to the
objects defined in a path. The permission level set on a path applies to all sub levels
unless you set a new permission level for a sub level.
The following permissions can be set for a path:
No Access: Users cannot navigate to or modify any of the objects in the path.
Read: Users can navigate to the objects but cannot modify them.
Full Access: Users can navigate to and modify the objects.
Example
A user has the permission Full Access to the folder Building A. The user account
group also has Read permissions to the folder Building B, but No access to the
subfolders of Building B. Therefore the user has permission to navigate and modify
the objects in the Building A folder, but only permission to view the objects in the
Building B main folder.

Figure: Path permission levels in Building Operation

22.4.1 Path Permissions Example


A user account group has the permission Full Access to the Enterprise Server and
No Access to the Servers folder on the Enterprise Server. A single user account has
Full Access permissions to Automation Server 1, but No Access to Automation
Servers 2 and 3. The No Access permission on the Servers folders makes it
possible to give specific user accounts access to specific Automation Servers in
that folder.
For more information, see section 22.5 Path Permissions Example on page 490.

System 04-17005-03-en, October 2015


488
22 Software Permissions
22.4 Path Permissions

22.4.2 Context-Sensitive Path Permissions


You can manage permissions by configuring the permissions for a given user
account or user group to a certain object in the System Tree pane or List View and
below that object, for example, a folder and its contents.
For more information, see section 22.13 Context-Sensitive Path Permissions on
page 512.

04-17005-03-en, October 2015 System


489
22 Software Permissions
22.5 Path Permissions Example

22.5 Path Permissions Example


A user account group has the permission Full Access to the Enterprise Server and
No Access to the Servers folder on the Enterprise Server. A single user account has
Full Access permissions to Automation Server 1, but No Access to Automation
Servers 2 and 3. The No Access permission on the Servers folders makes it
possible to give specific user accounts access to specific Automation Servers in
that folder.

Figure: Path permissions to SmartStruxure servers on different levels in Building


Operation
The path permission rules rely on the actual path string with the name of the
SmartStruxure server or folder. If you change the name of a SmartStruxure server or
folder, users that earlier had permission are denied access. For example, a user
group has full access to the folder LABB. The folder is renamed to Laboratory B.
The users that had access to the LABB folder do not have access to the Laboratory
B folder or its subfolders.

Note
The local admin account is always granted access on the local SmartStruxure
server. For more information, see section 21.11 Administration Accounts in
SmartStruxure Server Local Domain on page 480.

System 04-17005-03-en, October 2015


490
22 Software Permissions
22.5 Path Permissions Example

Figure: If you change the name of server or folder, you also have to configure the path
permission to the folder.
The System folder and its subfolders, except the Domains folder, are always
accessible to a user even when the path permission for the folders is set to No
Access. This means that a user can always at least navigate and view the objects in
the System Tree and its subfolders.

Note
The Domains folder is the only folder within the System folder with restricted
access for users with the path permission No Access.

04-17005-03-en, October 2015 System


491
22 Software Permissions
22.5 Path Permissions Example

Figure: The Domains folder is the only folder of the System subfolders that can be
restricted by the path permission.

System 04-17005-03-en, October 2015


492
22 Software Permissions
22.6 Command Permissions

22.6 Command Permissions


To make the system even more flexible and useful, you can assign a user account
group special command permissions. Use the command permission to control
exceptions from path permissions that allow or deny actions on specific
commands.
You can set the following permissions for a command:
No Setting: No Setting is the default command permission setting. No settings
means that the path permission, for the folder where the object is located,
decides whether the user has permission to modify the object or not.
Deny: Users are not allowed to use the command.
Allow: Users are allowed to use the command.
For example, you allow a user account group to only add comments to trend log
records. All other command permissions for trend logs are set to Deny. Users with
this command permissions can comment on existing records but are not allowed to
perform other actions such as add records or clear the trend log. This assumes that
the users have path permission to access the trend logs.

Figure: The user account group only has permission to read and comment trend log
objects
Another example could be that a user account group has the path permission Full
Access to a folder that contains BacNet objects. To prevent the users in the user
account group from updating the BacNet firmware, you set the command
permission for this action to Deny. All other command permissions are set to No
Settings. Due to the Full Access path permission, the users can perform all
commands on BacNet devices, beside updating the firmware.

04-17005-03-en, October 2015 System


493
22 Software Permissions
22.6 Command Permissions

Figure: The user account group has full permission to open and modify BacNet objects,
beside performing firmware update
A third example could be that a user account group has the path permission Read
to the Enterprise Server. To enable the users in the user account group to perform
all commands on trend logs in the system, you add the path permission Full Access
to the folder containing trend logs and set all the command permissions on the
Trends category to Allow.
Building Operation software permissions follow a series of permission rules. You
can use these permission rules to manage the type of data and commands the user
has access to within a workspace, panel, or domain. For more information, see
section 22.1 Software Permissions on page 483.

System 04-17005-03-en, October 2015


494
22 Software Permissions
22.7 Assigning Software Permissions to a User Account

22.7 Assigning Software Permissions to a


User Account
You assign a user account individual path permissions to overrule the settings
inherited from the user account groups the user account is a member of.

Note
To facilitate the administration of users and software permissions, it is
recommended that you assign software permissions to groups rather than to
individual user accounts.
You cannot assign command permissions to an individual user, only path
permissions.

For more information, see section 22.4 Path Permissions on page 488.

To assign software permissions to a user account


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

04-17005-03-en, October 2015 System


495
22 Software Permissions
22.7 Assigning Software Permissions to a User Account

4. In the Domain list, select the domain the user account belongs to.

5. In the User Accounts list, select the user account you wish to assign path
permissions.
6. Click Software Permissions.
7. Drag the folder or object to which you want to grant the user account access
to the Path list.

Continued on next page

System 04-17005-03-en, October 2015


496
22 Software Permissions
22.7 Assigning Software Permissions to a User Account

8. Click the path you created, and select a permission level in the Permission
drop-down list.

9. Click the Save button .

04-17005-03-en, October 2015 System


497
22 Software Permissions
22.8 Editing the Software Permissions of a User Account

22.8 Editing the Software Permissions of a


User Account
You edit the permission level of a path or command that has been assigned to an
individual user account to configure the user's access in the Building Operation
system.

Note
You cannot assign command permissions to an individual user, only path
permissions.

For more information, see section 22.4 Path Permissions on page 488.

To edit the software permissions of a user account


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

System 04-17005-03-en, October 2015


498
22 Software Permissions
22.8 Editing the Software Permissions of a User Account

4. In the Domain list box, select the domain the user account belongs to.

5. In the User Accounts list box, select the user account for which you want to
edit path permissions.
6. Click Software permissions.
7. Select the path for which you want to edit the user account permissions.

Continued on next page

04-17005-03-en, October 2015 System


499
22 Software Permissions
22.8 Editing the Software Permissions of a User Account

8. In the Permission column, select a new permission level.

9. Click the Save button .

System 04-17005-03-en, October 2015


500
22 Software Permissions
22.9 Removing Software Permissions from a User Account

22.9 Removing Software Permissions from a


User Account
You remove a user account's individual path permission to remove the permission
to a folder or an object the user account no longer is to have permissions to.
For more information, see section 22.4 Path Permissions on page 488.

To remove software permissions from a user account


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

04-17005-03-en, October 2015 System


501
22 Software Permissions
22.9 Removing Software Permissions from a User Account

4. In the Domain list, select the domain the user account belongs to.

5. In the User Accounts list, select the user account whose path permissions
you want to remove.
6. Click Software Permissions.
7. In the Path list, select the path whose permissions you want to remove from
the user account.

8. Click the Remove button .

System 04-17005-03-en, October 2015


502
22 Software Permissions
22.10 Assigning Software Permissions to a User Account Group

22.10 Assigning Software Permissions to a


User Account Group
You assign software permissions to user account groups for controlling user
activities and access in Building Operation.
For more information, see section 22.2 Software Permissions and User Account
Groups on page 485.

To assign software permissions to a user account group


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

04-17005-03-en, October 2015 System


503
22 Software Permissions
22.10 Assigning Software Permissions to a User Account Group

4. In the Domain box, select a domain for the user account group.

5. In the User Account Groups box, select a user account group.


6. In the User Account Group area, click Software permissions.
7. Drag the folder or object to which you want to grant the user account group
access to the Path list.

Continued on next page

System 04-17005-03-en, October 2015


504
22 Software Permissions
22.10 Assigning Software Permissions to a User Account Group

8. In the Permission box, select a permission level for the path.

9. In the Category column, select a category that you want to configure


permissions for.
10. In the Command column, select a command.
Continued on next page

04-17005-03-en, October 2015 System


505
22 Software Permissions
22.10 Assigning Software Permissions to a User Account Group

11. In the Permission box for the command, select a permission level.

12. On the File menu, click Save.

System 04-17005-03-en, October 2015


506
22 Software Permissions
22.11 Editing the Software Permissions of a User Account Group

22.11 Editing the Software Permissions of a


User Account Group
You edit the permission level of a path or command that has been assigned to an
individual user account group to configure the user account group's access in the
SmartStruxure solution.
For more information, see section 22.2 Software Permissions and User Account
Groups on page 485.

To edit the software permissions of a user account group


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

04-17005-03-en, October 2015 System


507
22 Software Permissions
22.11 Editing the Software Permissions of a User Account Group

4. In the Domain box, select the domain the user account group belongs to.

5. In the User Account Groups box, select the user account group for which
you want to edit the software permissions.
6. Click Software permissions.
7. Select the path for which you want to edit the user account permissions.

Continued on next page

System 04-17005-03-en, October 2015


508
22 Software Permissions
22.11 Editing the Software Permissions of a User Account Group

8. In the Permission box, select a permission level for the path.

9. In the Category column, select a category that you want to configure


permissions for.
10. In the Command column, select a command.
11. In the Permission box for the command, select a permission level.

12. Click the Save button .

04-17005-03-en, October 2015 System


509
22 Software Permissions
22.12 Removing Software Permissions from a User Account Group

22.12 Removing Software Permissions from a


User Account Group
You remove a user account goup's path permission to remove the permission to a
folder or an object the user account group no longer is to have permissions to.
For more information, see section 22.2 Software Permissions and User Account
Groups on page 485.

To remove software permissions from a user account group


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

System 04-17005-03-en, October 2015


510
22 Software Permissions
22.12 Removing Software Permissions from a User Account Group

4. In the Domain list, select the domain the user account group belongs to.

5. In the User Account Groups list, select the user account group whose path
permissions you want to remove.
6. Click Software Permissions.
7. In the Path list, select the path whose permissions you want to remove from
the user account group.

8. Click the Remove button .

04-17005-03-en, October 2015 System


511
22 Software Permissions
22.13 Context-Sensitive Path Permissions

22.13 Context-Sensitive Path Permissions


You can manage permissions by configuring the permissions for a given user
account or user group to a certain object in the System Tree pane or List View and
below that object, for example, a folder and its contents.
You need to have the required permissions to be able to view and configure user
account or user group permissions to an object.
When you configure the permissions to an object, the user account and user
groups that have permissions to the object are listed. You can add user accounts or
user groups that you want to grant permissions to the object.
You can manually configure the permissions a user account or user group has to an
object. You can also configure the object to inherit its permissons from a path
above the object in the System Tree pane or List View. When you configure an
object to inherit its permissions, you get an indication in the user interface that the
permissions are inherited and also the specific permission level the user account or
user group has to the object. You cannot configure an object to inherit the
permissions from a path above this object unless you have permissions to that
path.

System 04-17005-03-en, October 2015


512
22 Software Permissions
22.14 Configuring Permissions to a Path

22.14 Configuring Permissions to a Path


You configure the permissions users or user groups have to a path to grant or limit
permissions to that path.
For more information, see section 22.13 Context-Sensitive Path Permissions on
page 512.

To configure permissions to a path


1. Select the object in the System Tree pane or List View.
2. On the Actions menu, click Edit permissions.
3. Click the Add users and groups button.

Continued on next page

04-17005-03-en, October 2015 System


513
22 Software Permissions
22.14 Configuring Permissions to a Path

4. Select the users and groups that you want grant permissions to the object and
its contents.

Continued on next page

System 04-17005-03-en, October 2015


514
22 Software Permissions
22.14 Configuring Permissions to a Path

5. Click the Add button

6. Click OK.
Continued on next page

04-17005-03-en, October 2015 System


515
22 Software Permissions
22.14 Configuring Permissions to a Path

7. Configure the permission level for the user or group.

8. Click OK.
The user or group is granted a certain level of permissions or denied permissions to
the selected object and its contents.

System 04-17005-03-en, October 2015


516
22 Software Permissions
22.15 Edit Permissions Dialog Box

22.15 Edit Permissions Dialog Box


Use the Edit Permissions dialog box to grant or limit the permissions users or
user groups have to a path.

Figure: Edit Permissions dialog box

Table: Edit Permissions Dialog Box


Component Description

Path Displays the path of the selected object.

Quick filter Use the quick filter to filter on the user or


user group whose permissions you want to
configure or on a specific permission level.
For more information, see section 49.6
Quick Filter on page 1571.

Name Select the user account or user account


group whose permissions you want to
configure.

Permission Select the permission level to the specific


path. For more information, see section 22.3
Software Permission Rules on page 487.

Account type: Users Select the user account whose path


permission level to the specific path you
want to configure.

Account type: Groups Select the user account group whose path
permission level to the specific path you
want to configure.

04-17005-03-en, October 2015 System


517
22 Software Permissions
22.15 Edit Permissions Dialog Box

Continued
Component Description

Add users and groups Click to open the Users and Groups dialog
box where you select the user accounts or
user account groups that you want to grant
permissions or whose permissions you want
to limit. For more information, see section
33.95 Users and Groups Dialog Box on
page 1071.

System 04-17005-03-en, October 2015


518
23 Login Configuration

Topics
Password Administration
Editing a User Account Password
Allowing Users to Change their Password
Changing Your Password
Changing the Password for Local Administrator Accounts
Turning off Remember Me On This Computer
Forcing a User to Change the Password at Next Logon
Preventing Users from Changing Their Passwords
Resetting the Administrator Password
23 Login Configuration
23.1 Password Administration

23.1 Password Administration


As a WorkStation administrator, you can change users passwords, force users to
change their passwords at next logon, or enable and disable the ability of users to
change their passwords.
Passwords are managed at the user account group level. Building Operation
applies password changes to all user accounts that belong to the user account
group.

Note
If you are an administrator and have forgotten your password, contact the
Building Operation support team.

04-17005-03-en, October 2015 System


521
23 Login Configuration
23.2 Editing a User Account Password

23.2 Editing a User Account Password


You edit the password for a user account to give a user that has been locked out of
the system by exceeding the number of allowed failed logon attempts a new
password.
For more information, see section 23.1 Password Administration on page 521.

To edit a user account password


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

System 04-17005-03-en, October 2015


522
23 Login Configuration
23.2 Editing a User Account Password

4. In the Domain list box, select the domain the user account to belongs to.

5. In the User Accounts list box, select the user account for which you wish to
change the password.
6. Click Summary.
7. On the Summary tab, in the Password box, type the new password.

8. In the Confirm Password box, confirm the password by retyping it.

9. Click the Save button .

04-17005-03-en, October 2015 System


523
23 Login Configuration
23.3 Allowing Users to Change their Password

23.3 Allowing Users to Change their


Password
You allow a group of users to change their password. The default setting is that all
users can change their password.
For more information, see section 22.2 Software Permissions and User Account
Groups on page 485.

To allow users to change their password


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

System 04-17005-03-en, October 2015


524
23 Login Configuration
23.3 Allowing Users to Change their Password

4. In the Domain list, select the domain the user account group belongs to.

5. In the User Account Groups list, select a user account group.


6. Click Policies.
7. Select the May change Password box.

8. Click the Save button .

04-17005-03-en, October 2015 System


525
23 Login Configuration
23.4 Changing Your Password

23.4 Changing Your Password


You change your Building Operation user password on a regular basis to keep your
information secure.

To change your password


1. In WorkStation, on the File menu, click Change Password.
2. In the Old Password box, type your current password.

3. In the New password box, type your new password.


4. In the Confirm password box, type your new password again.
5. Click OK.

System 04-17005-03-en, October 2015


526
23 Login Configuration
23.5 Changing the Password for Local Administrator Accounts

23.5 Changing the Password for Local


Administrator Accounts
You change the password for the local administrator (admin) accounts on the
SmartStruxure servers to prevent unauthorized access.
For more information, see section 23.1 Password Administration on page 521.

To change password for local administrator accounts


1. In WorkStation or WorkStation for Projects, in the Search box, type admin
to search for the local administrator account on all SmartStruxure servers in
your SmartStruxure solution system.

2. Click the Search button .


3. In the Search view, select the local administrator accounts you want to
change the password for.

4. Click the Show/Hide Property Grid button .


Continued on next page

04-17005-03-en, October 2015 System


527
23 Login Configuration
23.5 Changing the Password for Local Administrator Accounts

5. Click the Basic tab.

6. In the Password box, type the new password.


7. In the Confirm Password box, type the password again.
8. On the File menu, click Save.

System 04-17005-03-en, October 2015


528
23 Login Configuration
23.6 Turning off Remember Me On This Computer

23.6 Turning off Remember Me On This


Computer
You turn off Remember me on this computer to clear the information you have
stored in the Building Operation WorkStation window. For example, you want to be
able to use different accounts when logging on, or log on to different SmartStruxure
server in the domain.
For more information, see section 21.2 Log On Methods on page 462.

To turn off Remember me on this Computer


1. In WorkStation, on the File menu, select Log Off.
2. In the Building Operation WorkStation window, clear Remember me
on this computer.

3. Log on again to activate the change.

04-17005-03-en, October 2015 System


529
23 Login Configuration
23.7 Forcing a User to Change the Password at Next Logon

23.7 Forcing a User to Change the Password


at Next Logon
You force a user to change the password at next logon to increase the security, for
example, when distributing a user account to a new user.
For more information, see section 23.1 Password Administration on page 521.

To force a user to change the password at next logon


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

System 04-17005-03-en, October 2015


530
23 Login Configuration
23.7 Forcing a User to Change the Password at Next Logon

4. In the Domain list box, select the domain the user account belongs to.

5. In the User Accounts list, select the user account.


6. Click Summary.
7. In the Force password change box, select True to force the user to
change the password at next logon.

8. Click the Save button .


The Force password change box is automatically set to False when the user
changes their password.

04-17005-03-en, October 2015 System


531
23 Login Configuration
23.8 Preventing Users from Changing Their Passwords

23.8 Preventing Users from Changing Their


Passwords
You prevent a group of users from changing their passwords.
For more information, see section 23.1 Password Administration on page 521.

To prevent users from changing their passwords


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

System 04-17005-03-en, October 2015


532
23 Login Configuration
23.8 Preventing Users from Changing Their Passwords

4. In the Domain list box, select the domain the user account group belongs to.

5. In the User Account Groups list box, select the user account group.
6. Click Policies.
7. Clear the May change Password box.

8. Click the Save button .

04-17005-03-en, October 2015 System


533
23 Login Configuration
23.9 Resetting the Administrator Password

23.9 Resetting the Administrator Password


You reset the administrator password, if you are an administrator. For example if
you have locked yourself out of WorkStation. Schneider Electric Buildings support
team provides you with a temporary password for logging on to Building Operation
and changing your administrator password.
For more information, see section 23.1 Password Administration on page 521.

Note
To authenticate yourself to the Schneider Electric Buildings support team,
you have to state your user name and password, the unique session ID (from
the failed logon attempt), and the domain you tried to log on to. To show the
session ID you need to press SHIFT and click the WorkStation icon in the
WorkStation logon dialog box.

To reset the administrator password


1. Contact Schneider Electric Support and get a temporary password.
2. In WorkStation, log on using the temporary password.
3. Change your password.

System 04-17005-03-en, October 2015


534
24 Workspaces

Topics
Workspace Management
Predefined Workspaces
Workspace Components and Customization
Workspace Customization
Workspace Content References
Creating a Workspace
Editing the Layout of a Workspace
Editing the Description of a Workspace
Adding a Component to a Workspace
Removing a Component from a Workspace
Editing a Workspace Component
Adding a Workspace to a User Account Group
Removing a Workspace from a User Account Group
Reviewing the Workspace Memberships for a User Account
Group
Panel Components
Creating a Panel
Editing a Panel
WebStation in Kiosk Mode
Configuring WebStation to Run in Kiosk Mode
24 Workspaces
24.1 Workspace Management

24.1 Workspace Management


The workspace defines the content and layout of WorkStation. The content and
layout of the workspace can be adapted to users or user account groups different
tasks.
You can create different workspaces for different user categories and link them to
user account groups. A user has access to all workspaces linked to the user
account groups in which the user is a member. This way, users can easily switch
workspaces during a work session. For example, Paul, a member of the
Administrators and Janitors user account groups, has access to the Administrator
workspace and Janitor workspace.

Figure: Users gain access to the workspaces linked to their user account groups
If a user account or user account group is assigned to more than one workspace,
WorkStation asks you to select a default workspace at the first log on. The next
time you log on to Building Operation on the same computer, your default
workspace is automatically displayed. Once logged in, you can change your default
workspace settings.

24.1.1 Predefined Workspaces


Some workspace layouts are included in the Building Operation main installation
and cannot be deleted or edited. Those workspaces are located in the local domain
of the SmartStruxure server.
For more information, see section 24.2 Predefined Workspaces on page 539.

04-17005-03-en, October 2015 System


537
24 Workspaces
24.1 Workspace Management

24.1.2 Workspace Components and Customization


A workspace consists of panes, windows, and a work area that can be customized
to suit a user's specific needs. Dialog boxes are presented on top of the
workspace.
For more information, see section 24.3 Workspace Components and
Customization on page 540.

24.1.3 WebStation in Kiosk Mode


You can configure to run WebStation in Internet Explorer in kiosk mode if you want
to limit the users access to toolbar and shortcuts in Internet Explorer.
For more information, see section 24.18 WebStation in Kiosk Mode on page 575.

System 04-17005-03-en, October 2015


538
24 Workspaces
24.2 Predefined Workspaces

24.2 Predefined Workspaces


Some workspace layouts are included in the Building Operation main installation
and cannot be deleted or edited. Those workspaces are located in the local domain
of the SmartStruxure server.

Table: Predefined Workspaces


Predefined Workspaces Description

System Default Workspace The System Default Workspace displays if


there is no workspace available for users
that log on to WorkStation. For example,
Building Operation uses this workspace
when the user account group the user
belongs to has no workspaces associated
with it, or the user's default workspace is
deleted by the system administrator.

Administration Workspace The Administration Workspace displays if


there is no other workspace available for
administrators logging on to WorkStation.
The purpose of the Administration
workspace is to ensure that users with
administrator rights always have access to
all properties and functions.

Engineering Workspace In addition to the System Default Workspace


and Administration Workspace that are
installed when Building Operation is installed,
you also have the option to install a
predefined engineering workspace. The
purpose of the Engineering workspace is to
configure WorkStation, view events and
alarms.

04-17005-03-en, October 2015 System


539
24 Workspaces
24.3 Workspace Components and Customization

24.3 Workspace Components and


Customization
A workspace consists of panes, windows, and a work area that can be customized
to suit a user's specific needs. Dialog boxes are presented on top of the
workspace.

Figure: Workspace components


WorkStation positions panes at the edges of the main window. You can lock,
release, and move these components to another location. You can also display and
stack several panes on top of each other.
Building Operation provides several predefined workspace panes, which are
accessible through the View menu:
System Tree pane
Watch
Events
Alarms

24.3.1 Workspace Customization


You customize the workspace layout to control access and suit the specific
requirements of a user account group. For example, you hide or show panes and
toolbars. You can save a workspace layout on the SmartStruxure server. In this
case, the layout becomes the default workspace layout for all users in the user
account group the workspace belongs to. Workspaces are task oriented, which
means that a user can switch workspaces during a single WorkStation session.

System 04-17005-03-en, October 2015


540
24 Workspaces
24.3 Workspace Components and Customization

For more information, see section 24.4 Workspace Customization on page 542.

24.3.2 Workspace Content References


Workspace content references are used to customize the workspace by referring
the content you want to display in the workspace panes and Work Area window.
For more information, see section 24.5 Workspace Content References on page
543.

24.3.3 Panel Components


You use a panel to combine different viewable windows, for example, a graphic,
trend chart, report, or another panel into a seamless view. A panel consists of one
or several panes and one work area. The panel is available through the System
Tree pane and opens as a window in the work area of the current workspace.
For more information, see section 24.15 Panel Components on page 569.

04-17005-03-en, October 2015 System


541
24 Workspaces
24.4 Workspace Customization

24.4 Workspace Customization


You customize the workspace layout to control access and suit the specific
requirements of a user account group. For example, you hide or show panes and
toolbars. You can save a workspace layout on the SmartStruxure server. In this
case, the layout becomes the default workspace layout for all users in the user
account group the workspace belongs to. Workspaces are task oriented, which
means that a user can switch workspaces during a single WorkStation session.
You can configure a workspace to contain a limited number of views to which users
have access. Specifically, you can add, edit, move, or remove the following panes
and windows:
Graphics
Alarms, Events, and Watch
Basic and Advanced Schedules
Function Block Programs
Trend Log Lists and Charts
Work Areas
Calendars
Panels
System Tree
For example, you can create a workspace that only displays an Alarms pane along
with a graphic in the work area representing a building.

Workspace Path, Object, and Command Customization


Software permissions limit the paths, objects, and commands that are available in a
workspace. For example, a user with No Access permissions for a particular path
cannot see any of the path objects displayed in the System Tree pane. A user with
Read permissions for a path can see the path objects but cannot issue any
commands because these objects are not made available. For more information,
see section 22.1 Software Permissions on page 483.For more information, see
Software Permissions
Workspaces and software permissions are linked to user account groups.
Therefore, a user inherits the workspaces and permissions of all groups to which
the user is a member. For more information, see section 22.2 Software
Permissions and User Account Groups on page 485.Software Permissions and
User Account Groups

System 04-17005-03-en, October 2015


542
24 Workspaces
24.5 Workspace Content References

24.5 Workspace Content References


Workspace content references are used to customize the workspace by referring
the content you want to display in the workspace panes and Work Area window.
When you add a content reference to a workspace, you refer the object in one of
the following ways:
System absolute: This option creates a path that refers to a specific object or
property in the system. The full address is enclosed in the path and the path
starts from the root level of the system. For example, the path /Server
1/University X/Building A/Graphic1 refers to a graphic named Graphic1 in the
folder Building A under the folder University X on Server 1. This option means
that the content of the workspace will be the same regardless of which server
you are logged on to.
Server absolute: This option creates a path that refers to a specific object or
property on a server. The address to the server is enclosed in the path and the
path starts from the root level of the server the user is logged on to. For
example, the reference ~/Building A/Alarm View1 refers to an Alarm View in the
folder Building A on the server the used is logged on to. This option means that
the content of the workspace depends on the server you are logged on to.
Relative: This option creates a path that is relative to the target. The path starts
from the current location and is relative to that location. Relative paths behave
like the server absolute option when it comes to workspace components. For
example, ../../Graphics/Graphic1 refers to a graphic named Graphic1 in the
Graphics folder one level up. This option means that the content of the
workspace depends on the server you are logged on to.

04-17005-03-en, October 2015 System


543
24 Workspaces
24.6 Creating a Workspace

24.6 Creating a Workspace


You create a customized workspace so that the WorkStation windows and panes
are tailored to meet the operational needs of a user or a user account group.
For more information, see section 24.3 Workspace Components and
Customization on page 540.

To create a workspace
1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

System 04-17005-03-en, October 2015


544
24 Workspaces
24.6 Creating a Workspace

4. In the Domain box, select the domain where you want to create the
workspace.

5. In the Workspaces area, click Add.


6. In the Name box, type a name for the workspace.

7. In the Description box, type a description for the workspace.


8. Click Next.
Continued on next page

04-17005-03-en, October 2015 System


545
24 Workspaces
24.6 Creating a Workspace

9. Select Visible to display the standard toolbars and menus in the workspace.

10. In the Root path (Applies to Address Bar and System Tree) box, type
the path to the folder that you want to be the root folder for the System Tree
and the Address bar.

11. Click the Add button to add panes to the workspace.


12. In the object type list, select the type of pane you want to add to the Work
area.

Continued on next page

System 04-17005-03-en, October 2015


546
24 Workspaces
24.6 Creating a Workspace

13. In the Name box, type a name for the pane.


14. In the Description box, type a description for the pane.
15. Click Next.
16. In the Default dock position box, select the location of the pane for display
in the WorkStation window.

17. In the Default visibility box, select Hidden to make the pane available only
from the View menu and not open in the Work area.
18. In the Display name box, type the name to be displayed on the pane.
19. In the Initial path box, enter the path to the object you want to display in the
pane.
20. Click Create.
21. In the Workspace wizard, click Create.

04-17005-03-en, October 2015 System


547
24 Workspaces
24.7 Editing the Layout of a Workspace

24.7 Editing the Layout of a Workspace


You edit the layout of a workspace to arrange the panes in the Work area to meet
the operational needs of a user or a user group.
For more information, see section 24.3 Workspace Components and
Customization on page 540.

To edit the layout of a workspace


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

System 04-17005-03-en, October 2015


548
24 Workspaces
24.7 Editing the Layout of a Workspace

4. In the Domain box, select the domain the workspace belongs to.

5. In the Workspaces box, select the workspace you want to edit.


6. Click Edit Layout.
Continued on next page

04-17005-03-en, October 2015 System


549
24 Workspaces
24.7 Editing the Layout of a Workspace

7. In the workspace, resize the frames and adjust the dock positions of the
panes.

8. On the File menu, click Save to save and exit the layout editor.

System 04-17005-03-en, October 2015


550
24 Workspaces
24.8 Editing the Description of a Workspace

24.8 Editing the Description of a Workspace


You edit the description of a workspace to specify what the workspace is used for.
For more information, see section 24.1 Workspace Management on page 537.

To edit the description of a workspace


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

04-17005-03-en, October 2015 System


551
24 Workspaces
24.8 Editing the Description of a Workspace

4. In the Domain box, select the domain the workspace belongs to.

5. In the Workspaces list, select the workspace.


6. Click Summary.
7. In the Description box, type a new description for the workspace.

8. Click the Save button .

System 04-17005-03-en, October 2015


552
24 Workspaces
24.9 Adding a Component to a Workspace

24.9 Adding a Component to a Workspace


You add a component to a workspace to extend the content and usage of the
workspace.
For more information, see section 24.1 Workspace Management on page 537.

To add a component to a workspace


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

04-17005-03-en, October 2015 System


553
24 Workspaces
24.9 Adding a Component to a Workspace

4. In the Domain box, select the domain the workspace belongs to.

5. In the Workspaces list, select the workspace.


6. Click Content.
7. Click Add.

Continued on next page

System 04-17005-03-en, October 2015


554
24 Workspaces
24.9 Adding a Component to a Workspace

8. Select the type of component you want to add to the workspace.

9. In the Name box, type a name for the component.


10. In the Location box, change the location of the component you are adding if
you do not want to save the component at the default location.
11. In the Description box, type a description for the component.
12. Click Next.
Continued on next page

04-17005-03-en, October 2015 System


555
24 Workspaces
24.9 Adding a Component to a Workspace

13. In the Default dock position box, select the dock position of the
component.

14. In the Default visibility box, select Visible to display the graphic in the
workspace.
15. In the Display name box, type the name to be displayed on the pane.
16. In the Initial path box, select the System Tree location of the component to
add to the workspace.
17. Click Create.

System 04-17005-03-en, October 2015


556
24 Workspaces
24.10 Removing a Component from a Workspace

24.10 Removing a Component from a


Workspace
You remove a component from a workspace to reduce components and the usage
of the workspace.
For more information, see section 24.1 Workspace Management on page 537.

To remove a component from a workspace


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

04-17005-03-en, October 2015 System


557
24 Workspaces
24.10 Removing a Component from a Workspace

4. In the Domain box, select the domain the workspace belongs to.

5. In the Workspaces list, select the workspace you want to configure.


6. Click Content.
7. In the Components list, select the component you want to remove from the
workspace.

Continued on next page

System 04-17005-03-en, October 2015


558
24 Workspaces
24.10 Removing a Component from a Workspace

8. Click the Remove button .

9. Click the Save button .

04-17005-03-en, October 2015 System


559
24 Workspaces
24.11 Editing a Workspace Component

24.11 Editing a Workspace Component


You edit the workspace components to adapt the usage of the workspace.
For more information, see section 24.1 Workspace Management on page 537.

To edit a workspace component


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

System 04-17005-03-en, October 2015


560
24 Workspaces
24.11 Editing a Workspace Component

4. In the Domain box, select the domain the workspace belongs to.

5. In the Workspaces list, select the workspace.


6. Click Content.
7. In the Components list, select the component you want to edit.

8. Click the Edit button .


Continued on next page

04-17005-03-en, October 2015 System


561
24 Workspaces
24.11 Editing a Workspace Component

9. Edit the workspace component properties.

10. Click the Save button .

System 04-17005-03-en, October 2015


562
24 Workspaces
24.12 Adding a Workspace to a User Account Group

24.12 Adding a Workspace to a User Account


Group
You add a workspace to a user account group to make the workspace available to
the users that are members of the user account group.
For more information, see section 24.3 Workspace Components and
Customization on page 540.

To add a workspace to a user account group


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

04-17005-03-en, October 2015 System


563
24 Workspaces
24.12 Adding a Workspace to a User Account Group

4. In the Domain list, select the domain the user account group belongs to.

5. In the User Account Groups list, select the user account group you want to
add a workspace to.
6. Click Workspaces.
7. In the Available Workspaces list, select the workspace you want to add to

the user account group and click the Add button .

8. Click the Save button .

System 04-17005-03-en, October 2015


564
24 Workspaces
24.13 Removing a Workspace from a User Account Group

24.13 Removing a Workspace from a User


Account Group
You remove a workspace from a user account group so that it no longer is available
to the users belonging to the user account group.
For more information, see section 24.1 Workspace Management on page 537.

To remove a workspace from a user account group


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

04-17005-03-en, October 2015 System


565
24 Workspaces
24.13 Removing a Workspace from a User Account Group

4. In the Domain box, select the domain the workspace belongs to.

5. In the Workspaces list, select the workspace.


6. Click User Account Groups.
7. In the Selected User Account Groups list, select the user account group

you want to remove the workspace from, and click the Remove button .

8. Click the Save button .

System 04-17005-03-en, October 2015


566
24 Workspaces
24.14 Reviewing the Workspace Memberships for a User Account Group

24.14 Reviewing the Workspace Memberships


for a User Account Group
You review the workspace memberships for a user account group to determin if the
user account group, for example, needs additional workspaces.
For more information, see section 24.1 Workspace Management on page 537.

To review the workspace memberships for a user account


group
1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

04-17005-03-en, October 2015 System


567
24 Workspaces
24.14 Reviewing the Workspace Memberships for a User Account Group

4. In the Domain list, select the domain the user account group belongs to.

5. In the User Account Groups list, select the user account group.
6. Click Workspaces.

System 04-17005-03-en, October 2015


568
24 Workspaces
24.15 Panel Components

24.15 Panel Components


You use a panel to combine different viewable windows, for example, a graphic,
trend chart, report, or another panel into a seamless view. A panel consists of one
or several panes and one work area. The panel is available through the System
Tree pane and opens as a window in the work area of the current workspace.

Figure: Example of panel components


In the procedure when creating a panel, you link existing objects to the panes or
workspace that is added within the panel. Therefore you have to first create the
object, for example a trend chart, before you add or rather link in the object into the
panel. You can define whether to show or hide a pane's toolbar.

Note
A panel can not contain a System Tree.
A maximum of six levels of panels are allowed in a single pane, the
recommendation for a good user experience is to only use three levels.

In a graphic or in the content of a pane or work area, you can create links that point
to a panel. By using panels you simply streamline the information you want to
present to the user. For example, you have a graphic that represents a room. In the
room illustration you add a fan symbol to which you link a panel containing panes
and a work area that displays the current room airflow and temperature.

04-17005-03-en, October 2015 System


569
24 Workspaces
24.16 Creating a Panel

24.16 Creating a Panel


You create panels to customize framing in a workspace. For example, panels can
display particular graphics or menus that are visible as frames in the WorkStation
Work area.
For more information, see section 24.15 Panel Components on page 569.

To create a panel
1. In WorkStation, in the System Tree pane, select in the folder where you want
to create the panel.
2. On the File menu, click New, and then Panel.
3. In the Name box, type a name for the panel.

4. In the Description box, type a description for the panel.


5. Click Next.
Continued on next page

System 04-17005-03-en, October 2015


570
24 Workspaces
24.16 Creating a Panel

6. Click the Add button to add an object to the panel.you add an object to
the panel.

7. In the object type list, select the type of panel component you want to add.

8. In the Name box, type a name for the component.


9. In the Description box, type a description for the panel component.
10. Click Next.
Continued on next page

04-17005-03-en, October 2015 System


571
24 Workspaces
24.16 Creating a Panel

11. In the Show toolbar box, select Yes to show the toolbar of the component.

12. In the Default dock position box, select where the component should be
located.
13. In the Default visibility box, select Visible to show the component in the
panel by default.
14. In the Display name box, type the name to be displayed on the pane.
15. In the Initial path box, enter the path to the object you are adding to the
panel.

Continued on next page

System 04-17005-03-en, October 2015


572
24 Workspaces
24.16 Creating a Panel

16. Click Create.


17. In the Work area initial path box, enter the initial object that displays when
viewing this panel.
18. In the Show toolbars box, select Yes to display the toolbar for the object
listed in the initial path.

19. Click Create.

04-17005-03-en, October 2015 System


573
24 Workspaces
24.17 Editing a Panel

24.17 Editing a Panel


You edit the properties of the panel and the components included in the panel to
rearange its appearance.
For more information, see section 24.15 Panel Components on page 569.

To edit a panel
1. In WorkStation, in the System Tree pane, select the panel you want to edit.
2. On the File menu, click Properties.
3. Edit the properties of the panel.

4. Click OK.
5. Click Close.

System 04-17005-03-en, October 2015


574
24 Workspaces
24.18 WebStation in Kiosk Mode

24.18 WebStation in Kiosk Mode


You can configure to run WebStation in Internet Explorer in kiosk mode if you want
to limit the users access to toolbar and shortcuts in Internet Explorer.
When kiosk mode is used the toolbar, menus and right-click menus are disabled.
Most keyboard shortcuts, such as alt + F4, to close Internet Explorer will still work.
Use the guest log on if you want the user to get immediate access to WebStation in
kiosk mode. For more information, see section 21.3 Guest Log On in WebStation
on page 463.

24.18.1 Configure WebStation to Run in Kiosk Mode


To be able to run WebStation in kiosk mode, you decide which object in
WebStation the users' will have access to, such as a graphic, a viewer, or a panel.
The easiest way to configure WebStation to run in kiosk mode is to create a
shortcut to Internet Explorer and add the command for kiosk mode (-k).
After you have created the shortcut, you open the object in WebStation you want
the users' to have access to. Then you copy the full address to the object and paste
it, within quotation marks, after the command k in the target box in the Shortcut
tab in the properties dialog box of the Shortcut.
The syntax in the Target box in the properties dialog box in the shortcut will looks
like this:

04-17005-03-en, October 2015 System


575
24 Workspaces
24.18 WebStation in Kiosk Mode

Figure: The properties dialog for a shortcut opening WebStation in kiosk mode.

System 04-17005-03-en, October 2015


576
24 Workspaces
24.19 Configuring WebStation to Run in Kiosk Mode

24.19 Configuring WebStation to Run in Kiosk


Mode
You configure WebStation to run in kiosk mode when you want the user to access
only a single object in your system, without any toolbars.
For more information, see section 24.18 WebStation in Kiosk Mode on page 575.

To configure WebStation to run in kiosk mode


1. Right-click on the desktop, point to New, and click Shortcut.
2. In the Type the location of the item box, click Browse.
3. In the Browse for File or Folders box, browse to iexplore.
4. Click OK.
5. Add "-k" after the address to iexplore.

6. Click Next.
7. In the Type name for this shortcut box, type the name, for example
WebStation in Kiosk Mode.
8. Click Finish.
9. Log on to WebStation using the same account as you want to use for the
kiosk mode.
10. Open the object you want WebStation to display in kiosk mode.
11. Copy the address in the address field.
12. Right-click the Shortcut and click Properties.
Continued on next page

04-17005-03-en, October 2015 System


577
24 Workspaces
24.19 Configuring WebStation to Run in Kiosk Mode

13. Click Shortcut.


14. Paste the address, within quotation marks, in the Target box after the
command -k.

15. Click OK.

System 04-17005-03-en, October 2015


578
25 Audit Trails

Topics
WorkStation Account Management
Audit Trailing of User Activity
Disabling Audit Trail for a Group of Users
Enabling Audit Trail for a Group of Users
Viewing an Audit Trail Log
WorkStation Account Validation
25 Audit Trails
25.1 WorkStation Account Management

25.1 WorkStation Account Management


As a WorkStation administrator, you can change passwords, track user activities,
validate accounts, and set up user and user and user group accounts.

25.1.1 Audit Trailing of User Activity


An audit trail tracks all actions of a user that has logged on to the system. For
example, you can view when a user logged on or off WorkStation, what commands
the user made, and if the user changed or removed an object. Not all user actions
are logged. For example, the system does not log user interface navigation and
workspace switching.
For more information, see section 25.2 Audit Trailing of User Activity on page 582.

25.1.2 WorkStation Account Validation


Building Operation stores all account information centrally in a user database, which
contains information about software permissions, user account memberships,
workspaces, and domains.
For more information, see section 25.6 WorkStation Account Validation on page
589.

04-17005-03-en, October 2015 System


581
25 Audit Trails
25.2 Audit Trailing of User Activity

25.2 Audit Trailing of User Activity


An audit trail tracks all actions of a user that has logged on to the system. For
example, you can view when a user logged on or off WorkStation, what commands
the user made, and if the user changed or removed an object. Not all user actions
are logged. For example, the system does not log user interface navigation and
workspace switching.
For each user action, the system logs the following information:
User name and domain name
Date and time of the logged action
Path of the object that was changed
Type of action, such as Object created
Old values and new values
The audit trailing log shown in WorkStation is simple a filtered Event view that
shows user related events. You can limit the number of events that are shown in the
Audit trail log:
Select a time span
Select how many of the most recent events to view.

Note
The system retains a user's historic audit trail even if the user is deleted from
the system.
Audit trailing is enabled by default.

Audit Trail Configuration at the User Account Group Level


Audit trailing is enabled and disabled at the user account group level in the user
account group policies. The default setting is that audit trail is enabled.
A user inherits the settings from all user account groups the user is a member of. To
activate audit trailing for a user, enable audit trailing for one of the user account
groups the user is a member of. To disable audit trail logging for a user, you must
disable audit trail logging for all user account groups that the user is a member of.
In addition, you can enable audit trailing as a policy in a user account group.

Figure: The Policies tab with audit trailing enabled

System 04-17005-03-en, October 2015


582
25 Audit Trails
25.3 Disabling Audit Trail for a Group of Users

25.3 Disabling Audit Trail for a Group of


Users
You disable audit trail for a group of users that do not need auditing, such as users
who can only view the objects in the system. To disable audit trail for a user, you
must disable audit trail for all user account groups the user is, directly or indirectly, a
member of. Audit trail is by default enabled.

Note
The system retains a user's historic audit trail even if the user is deleted from
the system.
Audit trailing is enabled by default.

For more information, see section 25.2 Audit Trailing of User Activity on page 582.

To disable audit trail for a group of users


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

04-17005-03-en, October 2015 System


583
25 Audit Trails
25.3 Disabling Audit Trail for a Group of Users

4. In the Domain list, select the domain the user account group belongs to.

5. In the User Account Groups list, select the user account group.
6. Click Policies.
7. Clear the Enable Audit Trailing box.

8. Click the Save button .

System 04-17005-03-en, October 2015


584
25 Audit Trails
25.4 Enabling Audit Trail for a Group of Users

25.4 Enabling Audit Trail for a Group of


Users
You enable audit trail for a group of users to be able to trace their actions and
activities. To enable audit trail for a user, it is enough that audit trail is enabled for
one of the user account groups the user is a member of. The feature is by default
enabled.
For more information, see section 25.2 Audit Trailing of User Activity on page 582.

To enable audit trail for a group of users


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

04-17005-03-en, October 2015 System


585
25 Audit Trails
25.4 Enabling Audit Trail for a Group of Users

4. In the Domain list, select the domain the user account group belongs to.

5. In the User Account Groups list, select a user account group.


6. Click Policies.
7. On the Policies tab, select Enable Audit Trailing.

8. Click the Save button .

System 04-17005-03-en, October 2015


586
25 Audit Trails
25.5 Viewing an Audit Trail Log

25.5 Viewing an Audit Trail Log


You open an audit trail log to view the activities of a specific user.
For more information, see section 25.2 Audit Trailing of User Activity on page 582.

To view an audit trail log


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Account management.


Continued on next page

04-17005-03-en, October 2015 System


587
25 Audit Trails
25.5 Viewing an Audit Trail Log

4. In the Domain list, select the domain the user account belongs to.

5. In the User Accounts list, select the user account.


6. Click Audit Trailing Events.

7. In the Show Events box, select an interval of events to view.

8. Click the Refresh button .

System 04-17005-03-en, October 2015


588
25 Audit Trails
25.6 WorkStation Account Validation

25.6 WorkStation Account Validation


Building Operation stores all account information centrally in a user database, which
contains information about software permissions, user account memberships,
workspaces, and domains.

Account Validation
When you log on to WorkStation you have to quote your user name and password
together with the domain and SmartStruxure server you want to log on to. Building
Operation confirms that you are using a valid user account and verifies that correct
password is used. Building Operation also authenticates access to workspaces
associated with your user account group memberships. After validation, Building
Operation retrieves your software permissions and stores them in a user token,
valid for this log on session.

Note
User name, password, and domain name are case sensitive.

WorkStation User Token


A user token remains active as long as you are logged onto WorkStation. Any
changes to your software permissions during your current sessions take effect the
next time you log on.

04-17005-03-en, October 2015 System


589
26 User Management User
Interface

Topics
User Management System Tree Icons
Domain Properties
Profile Properties
Workspace Properties
Pane Properties
Panel Properties
Building Operation WorkStation Window
Domain Control Panel
Account Management Control Panel
Select Default Workspace Window
Change Password Dialog Box
Domain Wizard Authentication Page
Domain Wizard Domain Members Page
Domain Wizard Domain Policies Page
Domain Summary Tab
Domain Policies Tab
Domain Domain Members Tab
User Account Summary Tab
User Account Group Membership Tab
User Account Profile Tab
User Account Software Permissions Tab
User Account Audit Trailing Events Tab
User Account Group Properties
User Account Properties
User Account Group Wizard Users Belonging to this Group
Page
User Account Group Wizard Workspaces Belonging to this
Group Page
User Account Group Wizard Windows Group Name and
Group Policies Page
User Account Group Summary Tab
User Account Group Policies Tab
User Account Group Group Membership Tab
User Account Group Software Permissions Tab
User Account Group Workspaces Tab
User Account Wizard General Page
User Account Wizard Member Of Page
User Account Management Folder Properties
Workspace Wizard Workspace Configuration Page
Workspace Wizard Pane Configuration Page
Workspace Summary Tab
Workspace Content Tab
Workspace Members Tab
Edit Layout Workspace
Panel Wizard Panel Configuration Page
Domains Properties
Local Properties
Work Area Window Properties
Create Work Area Window Wizard Name Page
Windows User Group Dialog Box
26 User Management User Interface
26.1 User Management System Tree Icons

26.1 User Management System Tree Icons


Use the User Management System Tree icons to get information on the objects in
the System Tree pane.

Table: User Management Icons


Icon Description

Panel
Indicates the object is a panel. For more
information, see section 24.15 Panel
Components on page 569.

Folder of User Accounts


Indicates that the folder contains user
accounts. For more information, see section
19.3 User Accounts and User Account
Groups on page 395.

User Account
Indicates that the object is a user account.
For more information, see section 19.3 User
Accounts and User Account Groups on
page 395.

Domain
Indicates that the object is a domain. For
more information, see section 21.1
Domains on page 459.

User Account Groups


Indicates that the object is a user account
group. For more information, see section
19.3 User Accounts and User Account
Groups on page 395.

Workspace
Indicates that the object is a workspace. For
more information, see section 24.1
Workspace Management on page 537.

04-17005-03-en, October 2015 System


595
26 User Management User Interface
26.2 Domain Properties

26.2 Domain Properties


Use the Domain properties to configure the properties of a domain.

Figure: Domain properties

Table: Domain Properties


Component Description

Maximum logon attempts Select the maximum number of failed logon


attempts that a user can make before
WorkStation is temporarily locked.

Password Type the password SmartStruxure servers


internally use to enhance the SmartStruxure
server communication security in the
domain.

Confirm Password Type the password SmartStruxure servers


internally use to enhance the SmartStruxure
server communication security in the
domain.

System 04-17005-03-en, October 2015


596
26 User Management User Interface
26.2 Domain Properties

Continued
Component Description

Windows domain name Type the name of the Windows domain


where the Windows Active directory is
located from which you want to map user
account groups. For more information, see
section 20.1 Windows Active Directory User
Groups on page 425.

04-17005-03-en, October 2015 System


597
26 User Management User Interface
26.3 Profile Properties

26.3 Profile Properties


Use the Profile properties to edit the information about the user the account
belongs to.

Figure: Profile properties

Table: Profile Properties


Component Description

First name Type the first name of the user.

Middle name Type the middle name of the user.

Last name Type the last name of the user.

Home email address Type the email address of the user.

Work email address Type the work email address of the user.

System 04-17005-03-en, October 2015


598
26 User Management User Interface
26.4 Workspace Properties

26.4 Workspace Properties


Use the Workspace properties to configure the properties of a workspace.

Figure: Workspace properties

Table: Workspace Properties


Component Description

Add
Click to add a pane to the workspace. For
more information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

Edit
Click to edit a workspace pane. For more
information, see section 26.5 Pane
Properties on page 601.

Remove
Click to remove a workspace pane.

04-17005-03-en, October 2015 System


599
26 User Management User Interface
26.4 Workspace Properties

Continued
Component Description

Menu Select Visible to show the menu in the


workspace.

Toolbar Select Visible to show the toolbar in the


workspace.

Address bar Select Visible to show the address bar in


the workspace.

Status bar Select Visible to show the status bar in the


workspace.

Search bar Select Visible to show the search bar in the


workspace.

History bar Select Visible to show the history bar in the


workspace.

Root path Enter the path for the workspace


component.

System 04-17005-03-en, October 2015


600
26 User Management User Interface
26.5 Pane Properties

26.5 Pane Properties


Use the Pane properties to configure the settings of the pane.

Figure: Pane properties

Table: Pane Properties


Component Description

Show toolbar Select Yes to show the toolbars for the pane
component.

Default dock position Select where to place the pane in the


workspace.

Default visibility Select Hidden to hide the pane.

Dipslay name Type the pane name that is to be displayed.


Display name is available only in
Workstation.

Initial path Enter the path to the pane component.

04-17005-03-en, October 2015 System


601
26 User Management User Interface
26.6 Panel Properties

26.6 Panel Properties


Use the Panel properties to configure the properties of a panel.

Figure: Panel properties

Table: Panel Properties


Component Description

Work area initial path Enter the path, for example a graphical link,
that points to the panel.

Show toolbars Select Yes to show the toolbars of the


panel.

Add
Click to add a pane component to the panel.
For more information, see section 50.27
Create Object Wizard Naming the Object
Page on page 1634.

Edit
Click to edit a pane component. For more
information, see section 26.5 Pane
Properties on page 601.

System 04-17005-03-en, October 2015


602
26 User Management User Interface
26.6 Panel Properties

Continued
Component Description

Remove
Click to remove a panel component.

04-17005-03-en, October 2015 System


603
26 User Management User Interface
26.7 Building Operation WorkStation Window

26.7 Building Operation WorkStation


Window
Use the Building Operation WorkStation window to log on to WorkStation.

Figure: Building Operation WorkStation

Table: Building Operation WorkStation


Component Description

User name Click to log on to WorkStation using the


Windows credentials of the current Windows
account. For more information, see section
19.3 User Accounts and User Account
Groups on page 395.

Password Type the password.

Domain Type the name of the domain that you want


to log on to. If you do not enter a domain,
you are logged on to the local domain. For
more information, see section 21.1
Domains on page 459.

System 04-17005-03-en, October 2015


604
26 User Management User Interface
26.7 Building Operation WorkStation Window

Continued
Component Description

Server Select the Server hypertext transfer protocol


option for communication with the
SmartStruxure server.
Enter a SmartStruxure server name or an IP
address for the SmartStruxure server you
want to log on to.

Log on as Click to log on to WorkStation as a different


Windows user or using a Building Operation
account. For more information, see section
19.3 User Accounts and User Account
Groups on page 395.

Remember me on this computer Select to save the entered information. The


information is automatically filled in the next
time you log on.

Log on Click to log on to WorkStation.

Click here to learn more about Click to open the WebHelp home page. For
Building Operation more information, see the WebHelp
Overview topic on WebHelp.

04-17005-03-en, October 2015 System


605
26 User Management User Interface
26.8 Domain Control Panel

26.8 Domain Control Panel


Use the Domain Control Panel to create and configure domains.

Table: Domain Control Panel


Component Description

Server Displays the SmartStruxure server that acts


as domain controller.

Domains Select a domain to edit.

Add Click to create a new domain. For more


information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

Delete Click to delete a domain.

List domains Click to view all domains in the List View.

Unit Conversion Exceptions Click to enter unit conversion exceptions for


the selected domain.

Account management Click to open the Account Management


Control Panel. For more information, see
section 26.9 Account Management Control
Panel on page 607.

Summary Click to open the Summary tab for the


domain. For more information, see section
26.15 Domain Summary Tab on page
615.

Policies Click to open the Policies tab where you edit


the policies of the domain. For more
information, see section 26.16 Domain
Policies Tab on page 616.

Domain members Click to open the Domain members tab


where you add and remove SmartStruxure
servers from the domain. For more
information, see section 26.17 Domain
Domain Members Tab on page 617.

System 04-17005-03-en, October 2015


606
26 User Management User Interface
26.9 Account Management Control Panel

26.9 Account Management Control Panel


Use the Account Management Control Panel to create and configure user
account groups, user accounts, and workspaces.

Figure: Account management control panel

Table: Account Management Control Panel


Component Description

Server Displays the selected SmartStruxure server.

Domain Select a domain. The domain you logged


onto is the default domain.

User Accounts Select a user account.

Add (user account) Click to add a new user account. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

Delete (user account) Click to delete a user account. For more


information, see section 50.31 Confirm
Delete Dialog Box on page 1639.

List users Click to open the user accounts list view


where you can select a user account. For
more information, see section 49.3 List
View on page 1568.

04-17005-03-en, October 2015 System


607
26 User Management User Interface
26.9 Account Management Control Panel

Continued
Component Description

Summary (user account) Click to open the user accounts Summary


tab with information about the user account,
such as expiration date an the password for
the user account. For more information, see
section 26.18 User Account Summary
Tab on page 618.

Group membership (user account) Click to open the Group Membership tab
where you can edit the group membership of
the selected user account. For more
information, see section 26.19 User
Account Group Membership Tab on page
619.

Software permissions (user account) Click to open the Software Permissions tab
where you can edit or assign individual
software permissions to the selected user
account. For more information, see section
26.21 User Account Software
Permissions Tab on page 622.

Audit trailing events Click to open the Audit Trailing Events tab
where you can view the user triggered
events for the selected user account. For
more information, see section 26.22 User
Account Audit Trailing Events Tab on
page 623.

User Account Groups Select a user account group.

Add (user account groups) Click to add a new user account group. For
more information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

Delete (user account group) Click to delete a user account group. For
more information, see section 50.31
Confirm Delete Dialog Box on page 1639.

List groups (user account groups) Click to open the user account groups list
view where you can select a user account
group. For more information, see section
49.3 List View on page 1568.

Summary (user account groups) Click to open the user account groups
Summary tab where you can edit the
description of the group. For more
information, see section 26.28 User
Account Group Summary Tab on page
634.

Group membership (user account Click to open the Group Membership tab
groups) where you can edit the groups membership
in other groups, and add and remove user
accounts. For more information, see section
26.30 User Account Group Group
Membership Tab on page 636.

System 04-17005-03-en, October 2015


608
26 User Management User Interface
26.9 Account Management Control Panel

Continued
Component Description

Software permissions Click to open the Software Permissions tab


where you can edit the software permissions
of the user account group. For more
information, see section 26.31 User
Account Group Software Permissions
Tab on page 638.

Workspaces (user account groups) Click to open the Workspaces tab where
you edit the workspace membership settings
for a user account group. For more
information, see section 26.32 User
Account Group Workspaces Tab on page
640.

Policies Click to open the Policies tab where you can


edit the policies of the user account group.
For more information, see section 26.29
User Account Group Policies Tab on
page 635.

Workspaces Select a workspace.

Add (workspaces) Click to add a new workspace. For more


information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

Delete (workspaces) Click to delete a workspace. For more


information, see section 50.31 Confirm
Delete Dialog Box on page 1639.

List workspaces Click to open the Workspace menu where


you can select a workspace. For more
information, see section 49.3 List View on
page 1568.

Summary (workspaces) Click to open the workspace Summary tab


where you can edit the description of the
workspace. For more information, see
section 26.38 Workspace Summary Tab
on page 648.

User account groups (workspaces) Click to open the workspace Members tab
where you edit the group membership of the
workspace. For more information, see
section 26.40 Workspace Members Tab
on page 651.

Content Click to open the Content tab where you edit


the content of the workspace. For more
information, see section 26.39
Workspace Content Tab on page 649.

Edit layout Click to open the view where you edit the
layout of the workspace. For more
information, see section 26.41 Edit Layout
Workspace on page 652.

04-17005-03-en, October 2015 System


609
26 User Management User Interface
26.10 Select Default Workspace Window

26.10 Select Default Workspace Window


Use the Select Default Workspace window to select the workspace you want to
open by default when you log on to WorkStation.

Figure: Select default workspace window

Table: Select Default Workspace Window


Component Description

Select Default Workspace Select a default workspace in the list of


workspaces available to you.

System 04-17005-03-en, October 2015


610
26 User Management User Interface
26.11 Change Password Dialog Box

26.11 Change Password Dialog Box


Use the Change Password dialog box to change your password.

Figure: Change Password dialog box

Table: Change Password Dialog Box


Component Description

Old password Type your old password.

New password Type your new password.

Confirm password Type your new password again.

Show password rules Click to show the password rules.

04-17005-03-en, October 2015 System


611
26 User Management User Interface
26.12 Domain Wizard Authentication Page

26.12 Domain Wizard Authentication Page


Use the Authentication page to map the Building Operation domain to a
Windows Active Directory domain.

Figure: Authentication page

Table: Authentication Page


Component Description

Windows domain name Type the name of the Windows domain


where the Windows Active directory is
located from which you want to map user
account groups. For more information, see
section 20.1 Windows Active Directory User
Groups on page 425.

System 04-17005-03-en, October 2015


612
26 User Management User Interface
26.13 Domain Wizard Domain Members Page

26.13 Domain Wizard Domain Members


Page
Use the Domain Members page to add SmartStruxure server device to the
domain.

Figure: Domain members page

Table: Domain Members Page


Component Description

Available Servers List of all available SmartStruxure server


device.

Servers that are members of this List of all SmartStruxure server device in the
Domain domain.

Add All
Click to add all available SmartStruxure
server device to the domain.

Add
Click to add a SmartStruxure server device
to the domain.

Remove
Click to remove a SmartStruxure server
device from the domain.

Remove All
Click to remove all SmartStruxure server
device from the domain.

04-17005-03-en, October 2015 System


613
26 User Management User Interface
26.14 Domain Wizard Domain Policies Page

26.14 Domain Wizard Domain Policies Page


Use the Domain Policies page to enter domain polices that are applicable to all
user accounts in the domain.

Figure: Domain policies page

Table: Domain Policies page


Component Description

Maximum logon attempts Select the maximum number of failed logon


attempts that a user can make before
WorkStation is temporarily locked.

System 04-17005-03-en, October 2015


614
26 User Management User Interface
26.15 Domain Summary Tab

26.15 Domain Summary Tab


Use the Summary tab to edit the description and domain controller password for a
domain.

Figure: Summary tab

Table: Summary Tab


Component Description

Description Type a description of the object.

Windows domain name Type the name of the Windows domain


where the Windows Active directory is
located from which you want to map user
account groups. For more information, see
section 20.1 Windows Active Directory User
Groups on page 425.

Domain Controller Displays the path and name of the domain


controller.

04-17005-03-en, October 2015 System


615
26 User Management User Interface
26.16 Domain Policies Tab

26.16 Domain Policies Tab


Use the Policies tab to edit the policies for the domain. For example, the number
of failed logon attempts a user can make before the account is temporarily locked.

Figure: Policies tab

Table: Policies tab


Component Description

Maximum logon attempts Enter the maximum number of failed logon


attempts a user can make before the users
account is temporarily locked.

System 04-17005-03-en, October 2015


616
26 User Management User Interface
26.17 Domain Domain Members Tab

26.17 Domain Domain Members Tab


Use the Domain Members tab to add and remove SmartStruxure servers to and
from the domain.

Figure: Doamin members tab

Table: Domain Members Tab


Component Description

Available Servers List of all available SmartStruxure servers.

Servers that are members of this List of all SmartStruxure server in the
Domain domain.

Add All
Click to add all available SmartStruxure
server to the domain.

Add
Click to add a SmartStruxure server to the
domain.

Remove
Click to remove a SmartStruxure server from
the domain.

Remove All
Click to remove all SmartStruxure server
from the domain.

04-17005-03-en, October 2015 System


617
26 User Management User Interface
26.18 User Account Summary Tab

26.18 User Account Summary Tab


Use the Summary tab to edit the basic settings for a user account. For example,
you can enable or disable the user account, or change the password for the
account.

Figure: Summary tab

Table: Summary Tab


Component Description

Expires on Enter an expiration date and time for the


user account. By default, there is no
expiration date for the account.

Disabled Select True to disable the user account.

Force password change Select True to force the user to change


password after the initial logon.

Password Type the password again.

Confirm password Type the password again.

System 04-17005-03-en, October 2015


618
26 User Management User Interface
26.19 User Account Group Membership Tab

26.19 User Account Group Membership Tab


Use the Group Membership tab to edit the group membership settings for a user
account.

Figure: Group membership tab

Table: Group Membership Tab


Component Description

Available User Account Groups Lists available user account groups the
account can be a member of.

Selected User Account Groups Lists the user account groups the account is
a member of.

Add all
Click to connect all available user account
groups to the user account.

Add
Click to connect a user account group to the
user account.

04-17005-03-en, October 2015 System


619
26 User Management User Interface
26.19 User Account Group Membership Tab

Continued
Component Description

Remove
Click to remove a user account group from
the user account.

Remove all
Click to remove all user account groups from
the user account.

Workspace Workspaces the user account has access


to.

Owner The user account groups a workspace is a


member of.

System 04-17005-03-en, October 2015


620
26 User Management User Interface
26.20 User Account Profile Tab

26.20 User Account Profile Tab


Use the Profile tab to edit the information about the user the account belongs to.

Figure: Profile tab

Table: Profile Tab


Component Description

First name Type the first name of the user.

Middle name Type the middle name of the user.

Last name Type the last name of the user.

Home email address Type the email address of the user.

Work email address Type the work email address of the user.

04-17005-03-en, October 2015 System


621
26 User Management User Interface
26.21 User Account Software Permissions Tab

26.21 User Account Software Permissions


Tab
Use the Software Permissions tab to enter individual path permissions for a user
account.

Note
To simplify the task of administering software permissions, it is recommended
that you assign software permissions to user account groups rather than user
accounts.

Figure: Software permissions tab

Table: Software Permissions Tab


Component Description

Add
Click to add a new path to the list of paths
that the user account can access.

Path The paths the user account has access to.

Permission Click to assign a permission level to a path


you have selected.

Owner The owners of the paths the user has access


to. The owner can be a user account group
the account is a member of, or the actual
user account.

Delete
Click to remove a path you have selected.

System 04-17005-03-en, October 2015


622
26 User Management User Interface
26.22 User Account Audit Trailing Events Tab

26.22 User Account Audit Trailing Events


Tab
Use the Audit Trailing Events tab to monitor the events triggered by the actions
of a user.

Figure: Audit trailing events tab

Table: Audit Trailing Events Tab


Component Description

Group box
Click to display the Show/Hide Group box to
group and sort objects. For more
information, see the Group and Sort Objects
topic on WebHelp.

Show Events Select an available option for limiting the


events displayed.

Refresh
Click to refresh the Audit Trailing Events list.

Filter Enter a word or a character to filter on. For


more information, see section 49.6 Quick
Filter on page 1571.

04-17005-03-en, October 2015 System


623
26 User Management User Interface
26.23 User Account Group Properties

26.23 User Account Group Properties


Use the User Account Group properties dialog box to configure the properties of
a user account group.

Figure: User account group properties

Table: User Account Group Properties


Component Description

Allow members to close WorkStation Select to let users log off and close
WorkStation.

Log user actions of group members Select to enable audit trailing for users
belonging to this group.

Allow members to access Application Select to enable users to access the Web
Server Web Configuration Configuration where you configure the
settings of an Automation Server.

Allow members to access security Select to enable users to access security


configuration configuration.

System 04-17005-03-en, October 2015


624
26 User Management User Interface
26.23 User Account Group Properties

Continued
Component Description

Windows group name Select the Windows Active Directory user


account group that you want to map to this
Building Operation user account group. For
more information, see section 20.1
Windows Active Directory User Groups on
page 425.

04-17005-03-en, October 2015 System


625
26 User Management User Interface
26.24 User Account Properties

26.24 User Account Properties


Use the User Account properties dialog box to configure the properties of a user
account.

Figure: User account properties

Table: User Account Properties


Component Description

Click to create a new user profile. For more


information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

Click to edit a user profile. For more


information, see section 26.3 Profile
Properties on page 598.

Click to remove a user profile.

Disabled Select True to disable the user account.

Force password change Select True to force the user to change


password after the initial logon.

System 04-17005-03-en, October 2015


626
26 User Management User Interface
26.24 User Account Properties

Continued
Component Description

Password Type the password again.

Confirm Password Type the password again.

Expires on Enter an expiration date and time for the


user account. By default, there is no
expiration date for the account.

System of measurement Displays the system of measurement for the


user account.

04-17005-03-en, October 2015 System


627
26 User Management User Interface
26.25 User Account Group Wizard Users Belonging to this Group Page

26.25 User Account Group Wizard Users


Belonging to this Group Page
Use the Users Belonging to this Group page to add users to the group.

Figure: Users belonging to this group page

Table: Users Belonging to this Group Page


Component Description

Select from Select a group with user accounts you want


to include in the group.

Available User Accounts Lists available user accounts.

Selected User Accounts Lists user accounts that are members of the
user account group.

Add all
Click to add all user accounts to the user
account group.

Add
Click to add a user account to the user
account group.

Remove
Click to remove a user account from the user
account group.

System 04-17005-03-en, October 2015


628
26 User Management User Interface
26.25 User Account Group Wizard Users Belonging to this Group Page

Continued
Component Description

Remove all
Click to remove all user accounts from the
user account group.

04-17005-03-en, October 2015 System


629
26 User Management User Interface
26.26 User Account Group Wizard Workspaces Belonging to this Group Page

26.26 User Account Group Wizard


Workspaces Belonging to this Group
Page
Use the Workspaces Belonging to this Group page to add workspaces to the
group.

Figure: Workspaces belonging to this group page

Table: Workspaces Belonging to this Group Page


Component Description

Select from Select a user account group with


workspaces you want to include in the user
account group.

Selected Workspaces Lists available workspaces.

Available Workspaces Lists the workspaces that are added to the


user account group.

Add all
Click to add all available workspaces to the
user account group.

Add
Click to add a workspace to the user
account group.

System 04-17005-03-en, October 2015


630
26 User Management User Interface
26.26 User Account Group Wizard Workspaces Belonging to this Group Page

Continued
Component Description

Remove
Click to remove a workspace from the user
account group.

Remove all
Click to remove all workspaces from the user
account group.

04-17005-03-en, October 2015 System


631
26 User Management User Interface
26.27 User Account Group Wizard Windows Group Name and Group Policies Page

26.27 User Account Group Wizard Windows


Group Name and Group Policies Page
Use the Windows Group Name and Group Policies page to map a Windows
Active Directory and enter policies for the group.

Figure: Windows group name and group policies page

Table: Windows Group Name and Group Policies Page


Component Description

User interactivity Select to let users log off and close


WorkStation.

Audit trailing Select to enable audit trailing for users


belonging to this group.

Password Select to allow members of this user


account group to change their password.
Not applicable if the user account group is
mapped to a Windows Active Directory user
account group.

Web configuration Select to enable users to access the Web


Configuration where you configure the
settings of a SmartStruxure server device.
For more information, see the SmartStruxure
Server Device Web Configuration Page topic
on WebHelp.

Automatic logoff Select to log off users in this group after a


defined time of inactivity. For more
information, see section 19.12 Automatic
Logoff on page 419.

System 04-17005-03-en, October 2015


632
26 User Management User Interface
26.27 User Account Group Wizard Windows Group Name and Group Policies Page

Continued
Component Description

Windows group name Select the Windows Active Directory user


account group that you want to map to this
Building Operation user account group. For
more information, see section 20.1
Windows Active Directory User Groups on
page 425.

04-17005-03-en, October 2015 System


633
26 User Management User Interface
26.28 User Account Group Summary Tab

26.28 User Account Group Summary Tab


Use the Summary tab to edit the description of a user account group.

Figure: Summary tab

Table: Summary Tab


Component Description

Description Type a description of the object.

Windows Domain Displays the name of the Windows domain


this user account group is mapped to.

Windows group name Select the Windows Active Directory user


account group that you want to map to this
Building Operation user account group. For
more information, see section 20.1
Windows Active Directory User Groups on
page 425.

System 04-17005-03-en, October 2015


634
26 User Management User Interface
26.29 User Account Group Policies Tab

26.29 User Account Group Policies Tab


Use the Policies tab to edit the policy settings for a user account group.

Figure: Policies tab

Table: Policies Tab


Component Description

Allow members to close WorkStation Select to let users log off and close
WorkStation.

Log user actions of group members Select to enable audit trailing for users
belonging to this group.

Allow members to change password Select to enable users to change their


passwords.

Allow members to access Automation Select to enable users to access the Web
Server Web Configuration Configuration where you configure the
settings of a SmartStruxure server device.
For more information, see the SmartStruxure
Server Device Web Configuration Page topic
on WebHelp.

Automatic logoff Select to log off users in this group after a


defined time of inactivity. For more
information, see section 19.12 Automatic
Logoff on page 419.

04-17005-03-en, October 2015 System


635
26 User Management User Interface
26.30 User Account Group Group Membership Tab

26.30 User Account Group Group


Membership Tab
Use the Group Membership tab to edit the group membership settings of a user
account group.

Figure: Group membership tab

Table: Group Membership Tab


Component Description

Available User Accounts Lists available user accounts that can be


added to the user account group.

Selected User Accounts Lists user accounts that have been added to
the user account group.

Available User Account Groups Lists user account groups that can be added
to the user account group.

Selected User Account Groups Lists user account groups that have been
added to the user account group.

Add all
Click to add all available user accounts or
user account groups to the list of selected
user accounts or user account groups.

System 04-17005-03-en, October 2015


636
26 User Management User Interface
26.30 User Account Group Group Membership Tab

Continued
Component Description

Add
Click to add the user account or user
account group to the list of selected user
accounts or user account groups.

Remove
Click to remove the user account or user
account group from the list of selected user
accounts or user account groups.

Remove all
Click to remove all user accounts or user
account groups from the list of selected user
accounts or user account groups.

04-17005-03-en, October 2015 System


637
26 User Management User Interface
26.31 User Account Group Software Permissions Tab

26.31 User Account Group Software


Permissions Tab
Use the Software Permissions tab to add software permissions to a user
account group by adding paths and assigning command permissions to the group.

Figure: Software permissions tab

Table: Software Permissions Tab


Component Description

Add
Click to add the path to which you want to
add software permissions.

Path Displays the paths that have been defined


for the user account group.

Permission Select a permission level for the path.

Owner Displays the user account group the path


has been added to.

Delete
Click to remove a path. For more
information, see section 50.31 Confirm
Delete Dialog Box on page 1639.

Category Click a category to display the commands


included in the category.

Command Displays all commands for the category.

Permission Select a permission level for a command.

System 04-17005-03-en, October 2015


638
26 User Management User Interface
26.31 User Account Group Software Permissions Tab

Continued
Component Description

Command Displays all commands that are available to


the user account group members.

Permission Select a permission level for the command.

Owner Displays the user account groups the


commands have been added to.

04-17005-03-en, October 2015 System


639
26 User Management User Interface
26.32 User Account Group Workspaces Tab

26.32 User Account Group Workspaces Tab


Use the Workspaces tab to edit the workspace membership settings for a user
account group.

Figure: Workspaces tab

Table: Workspaces Tab


Component Description

Available Workspaces Lists workspaces that are available to add to


the user account group.

Selected Workspaces Lists workspaces that are available to add to


the user account group.

Add all
Click to add all available workspaces to the
user account group.

Add
Click to add a workspace to the user
account group.

Remove
Click to remove a workspace from the user
account group.

Remove all
Click to remove all workspaces from the user
account group.

System 04-17005-03-en, October 2015


640
26 User Management User Interface
26.33 User Account Wizard General Page

26.33 User Account Wizard General Page


Use the General page to enter information about the user the account belongs to,
and a password for the account.

Figure: General page

Table: General Page


Component Description

First name Type the first name of the user.

Middle name Type the middle name of the user.

Last name Type the last name of the user.

Home email address Type the email address of the user.

Work email address Type the work email address of the user.

Expires on Enter an expiration date and time for the


user account. By default, there is no
expiration date for the account.

Password Type the password again.

Confirm Password Type the password again.

04-17005-03-en, October 2015 System


641
26 User Management User Interface
26.34 User Account Wizard Member Of Page

26.34 User Account Wizard Member Of Page


Use the Member Of page to make the user account a member of an existing user
account group.

Figure: Member of page

Table: Member of Page


Component Description

Select from Select a user account that is member of the


user account group you want to connect
your user account.

Available User Accounts Groups Lists available user account groups.

Selected User Accounts Groups Lists user account groups that are
connected to the user account group.

Add all
Click to add all user account groups to the
user account.

Add
Click to add a user account group to the
user account.

Remove
Click to remove a user account group from
the user account.

System 04-17005-03-en, October 2015


642
26 User Management User Interface
26.34 User Account Wizard Member Of Page

Continued
Component Description

Remove all
Click to remove all user account groups from
the user account.

04-17005-03-en, October 2015 System


643
26 User Management User Interface
26.35 User Account Management Folder Properties

26.35 User Account Management Folder


Properties
Use the User Account Management Folder Properties view or dialog box to
configure and view the general and object-reference properties. For more
information, see section 50.34 General Properties Basic Tab on page 1642.

Figure: User Account management folder properties

System 04-17005-03-en, October 2015


644
26 User Management User Interface
26.36 Workspace Wizard Workspace Configuration Page

26.36 Workspace Wizard Workspace


Configuration Page
Use the Workspace configuration page to add, edit, and remove workspace
components.

Figure: Workspace configuration page

Table: Workspace Configuration Page


Component Description

Menu Select Visible to show the menu in the


workspace.

Address bar Select Visible to show the address bar in


the workspace.

Search bar Select Visible to show the search bar in the


workspace.

Toolbar Select Visible to show the toolbar in the


workspace.

Status bar Select Visible to show the status bar in the


workspace.

History bar Select Visible to show the history bar in the


workspace.

Root path (Applies to Address Bar and Enter the path to the workspace component.
System Tree)

04-17005-03-en, October 2015 System


645
26 User Management User Interface
26.36 Workspace Wizard Workspace Configuration Page

Continued
Component Description

Listed components Lists the standard components included in


the workspace. Select a component and
click the Add, Edit or Remove button.

Click to add a new component to the


workspace. For more information, see
section 50.27 Create Object Wizard
Naming the Object Page on page 1634.

Click to edit a component. The workspace


properties pane is displayed. For more
information, see section 26.5 Pane
Properties on page 601.

Click to remove a component.

System 04-17005-03-en, October 2015


646
26 User Management User Interface
26.37 Workspace Wizard Pane Configuration Page

26.37 Workspace Wizard Pane


Configuration Page
Use the Pane configuration page to determine the layout of the component you
are adding to the workspace.

Figure: Pane configuration page

Table: Pane Configuration Page


Component Description

Show toolbar Select No to hide the component toolbar.

Default dock position Select a default dock position in the


workspace for the component.

Default visibility Select Hidden to hide the component.

Display name Type the pane name that is to be displayed.


Display name is available only in
WorkStation.

Initial path Click to change the location of the


component. For more information, see
section 26.36 Workspace Wizard
Workspace Configuration Page on page
645.

04-17005-03-en, October 2015 System


647
26 User Management User Interface
26.38 Workspace Summary Tab

26.38 Workspace Summary Tab


Use the Summary tab to edit the description of the workspace.

Figure: Summary tab

Table: Summary Tab


Component Description

Name Displays the name of the workspace.

Description Displays the description of the workspace.

Location Displays the location of the workspace.

System 04-17005-03-en, October 2015


648
26 User Management User Interface
26.39 Workspace Content Tab

26.39 Workspace Content Tab


Use the Content tab to edit the content and layout of a workspace.

Figure: Content tab

Table: Content Tab


Component Description

Menu Select Visible to show the menu in the


workspace.

Address bar Select Visible to show the address bar in


the workspace.

Search bar Select Visible to show the search bar in the


workspace.

Toolbar Select Visible to show the toolbar in the


workspace.

Status bar Select Visible to show the status bar in the


workspace.

History bar Select Visible to show the history bar in the


workspace.

Root path (Applies to Address Bar and Displays the path to the basic node of the
System Tree) workspace. For more information, see
section 24.5 Workspace Content
References on page 543.

04-17005-03-en, October 2015 System


649
26 User Management User Interface
26.39 Workspace Content Tab

Continued
Component Description

Add
Click to open the Create Object Wizard,
where you add a new component to the
workspace. For more information, see
section 50.27 Create Object Wizard
Naming the Object Page on page 1634.

Edit
Click to edit a pane. For more information,
see section 26.5 Pane Properties on page
601.

Remove
Click to remove a component.

System 04-17005-03-en, October 2015


650
26 User Management User Interface
26.40 Workspace Members Tab

26.40 Workspace Members Tab


Use the Members tab to edit the workspace user account group associations.

Figure: Members tab

Table: Members tab


Component Description

Available User Account Groups Lists user account groups that are available
to be connected to the workspace.

Selected User Account Groups Lists user account groups that are
connected to the workspace.

Add all
Click to connect all available user account
groups to the workspace.

Add
Click to connect a user account group to the
workspace.

Remove
Click to disconnect a user account group
from the workspace.

Remove all
Click to disconnect all user account groups
from the workspace.

04-17005-03-en, October 2015 System


651
26 User Management User Interface
26.41 Edit Layout Workspace

26.41 Edit Layout Workspace


Use the Edit Layout Workspace to edit the layout of a workspace. You can also
move and resize panes and panels and save the changes.

Figure: Edit layout workspace

Table: Edit Layout Workspace


Button Description

Save
Click to store and close the workspace
layout.

System 04-17005-03-en, October 2015


652
26 User Management User Interface
26.42 Panel Wizard Panel Configuration Page

26.42 Panel Wizard Panel Configuration


Page
Use the Panel Configuration page to add components to the panel.

Figure: Panel configuration page

Table: Panel Configuration Page


Component Description

Add
Click to add a new component to the panel.
For more information, see section 50.27
Create Object Wizard Naming the Object
Page on page 1634.

Edit
Click to edit the properties of a component.
For more information, see section 26.5
Pane Properties on page 601.

Remove
Click to remove a component from the
panel.

Work area initial path Click to enter the path for the Work area
component.

Show toolbars Select Yes to show the toolbars for the


Work area component.

04-17005-03-en, October 2015 System


653
26 User Management User Interface
26.43 Domains Properties

26.43 Domains Properties


Use the Domains properties to configure the Building Operation domains.

Figure: Domains properties

Table: Domains Properties


Component Description

Default Logon Domain Select the domain the user logs on to by


default. For more information, see section
21.1 Domains on page 459.

System 04-17005-03-en, October 2015


654
26 User Management User Interface
26.44 Local Properties

26.44 Local Properties


Use the Local properties to configure the local Building Operation domain.

Figure: Local properties

Table: Local Properties


Component Description

Maximum logon attempts Enter the maximum number of failed logon


attempts a user can make before the users
account is temporarily locked.

04-17005-03-en, October 2015 System


655
26 User Management User Interface
26.45 Work Area Window Properties

26.45 Work Area Window Properties


Use the Work Area Window Properties view or dialog box to view or edit the path
of the default object to be presented in the Work Area.

Figure: Work Area Window properties

Table: Work Area Window Properties


Property Description

Initial path Displays the path of the default object


presented the Work Area Window. For more
information, see section 24.3 Workspace
Components and Customization on page
540.

System 04-17005-03-en, October 2015


656
26 User Management User Interface
26.46 Create Work Area Window Wizard Name Page

26.46 Create Work Area Window Wizard


Name Page
Use the Name page to enter the path to the default object to be presented in the
Work Area Window.

Figure: Name page properties

Table: Name Page Properties


Property Description

Initial path Enter the path of the default object to be


presented the Work Area Window.
For more information, see section 24.3
Workspace Components and
Customization on page 540.

04-17005-03-en, October 2015 System


657
26 User Management User Interface
26.47 Windows User Group Dialog Box

26.47 Windows User Group Dialog Box


Use the Windows User Group dialog box to view or change the users added to the
group.

Figure: Windows User Group

Table: Windows User Group


Component Description

Quick filter Enter a word or a character to filter on. For


more information, see section 49.6 Quick
Filter on page 1571.

List Select the users you want to add to the


group. For more information, see section
20.1 Windows Active Directory User
Groups on page 425.

System 04-17005-03-en, October 2015


658
27 Connect Agent

Topics
Connect Agent
Configuring Connect Agent Settings
Transferring System and Crash Information
27 Connect Agent
27.1 Connect Agent

27.1 Connect Agent


Connect Agent is the service that runs along with the Enterprise Server to collect
and transfer system information and crash information of SmartStruxure servers
(Enterprise Server and SmartStruxure server devices attached to it). The system
information of the Enterprise Server and all the attached SmartStruxure server
devices is backed up at regular intervals and stored in the Enterprise Server. The
Connect Agent service then removes the PII (Personally Identifiable Information)
from the latest backup and the processed information is sent to the Connect
storage server.
To transfer the crash information and system information, the Connect Agent
service Log on needs to meet the following conditions:
sufficient user rights to access system folders and internet
Internet proxy settings, if required
Port number 22 available to access the following URLs:
servercd.smartstruxure.schneider-electric.com
serversi.smartstruxure.schneider-electric.com
Connect Agent can collect and transfer system information and crash information
only when the site administrator or the end-user provides consent to allow
Schneider Electric to receive system diagnostic and performance data of the
system. For more information, see the Providing Your Consent on Sharing System
Information topic on WebHelp.
To enable the Connect Agent function, set Enable system information
transfer and Enable crash information transfer to True. For more
information, see section 27.2 Configuring Connect Agent Settings on page 662.

04-17005-03-en, October 2015 System


661
27 Connect Agent
27.2 Configuring Connect Agent Settings

27.2 Configuring Connect Agent Settings


You configure the Connect Agent Settings to enable the agent to transfer the
system information and crash information of the SmartStruxure servers to the
Connect storage server.
For more information, see section 27.1 Connect Agent on page 661.

To configure Connect Agent Settings


1. In WorkStation, in the System Tree pane, expand the System folder.
2. Expand the Connect Settings folder and select Connect Agent Settings.
3. On the File menu, click Properties.
4. In the Enable system information transfer box, select True.

5. In the Enable crash information transfer box, select True.


6. Click the Advanced tab.
Continued on next page

System 04-17005-03-en, October 2015


662
27 Connect Agent
27.2 Configuring Connect Agent Settings

7. In the Days between transfers box, select how often you want the
Connect Agent to transfer the system data to the Connect storage server.

8. In Maximum bandwidth box, select the maximum bandwidth at which the


system information can be transfered. If '0' is selected, the system information
is transfered at maximum bandwidth.

04-17005-03-en, October 2015 System


663
27 Connect Agent
27.3 Transferring System and Crash Information

27.3 Transferring System and Crash


Information
The system information and crash information can be scheduled to transfer at
regular intervals in days (default is 30 days) from the time the system is installed.
For Connect Agent to transfer the crash information and system information, the
Connect Agent service Log on needs to meet the following conditions:
Sufficient user rights to access system folders and internet
Internet proxy settings, if required
Port number 22 available to access the following URLs:
servercd.smartstruxure.schneider-electric.com
serversi.smartstruxure.schneider-electric.com
To test whether Port number 22 is available to access the above URLs, use PuTTY
with SSH. These URLs do not respond to a ping but the address gets resolved and
with PuTTY you can then get to the Log On prompt.
The user (site administrator or end-user) needs to provide consent to collect the
information. For more information, see the Providing Your Consent on Sharing
System Information topic on WebHelp.
The Connect Agent settings need to be configured for the crash information and
system information to be transferred. For more information, see section 27.2
Configuring Connect Agent Settings on page 662.

27.3.1 System Information


The system information of the Enterprise Server and all the attached SmartStruxure
server devices is backed up at regular intervals and stored in the Enterprise Server.
The Connect Agent service then removes the PII (Personally Identifiable Information)
from the latest backup and the processed information is sent to the Connect
storage server.
You can find the system information log file SE.SBO.S2ConnectESAgentLog at
location C:\Program Files (x86)\Schneider Electric
StruxureWare\Building Operation 1.6\S2ConnectAgent\bin

27.3.2 Crash Information


Crash dump is generated only for Enterprise Server and takes 2 to 3 minutes to
produce. It is then zipped in the C:\ProgramData\Schneider Electric
StruxureWare\Building Operation 1.6\Enterprise Server\db\Crash
information folder. When the crash information is successfully zipped, the .done
file is created. After the .done file is created, the Connect Agent service restarts the
Enterprise Server. After few minutes, the Connect Agent service then sends the zip
file to the Connect storage server. After successful transfer of the zip file, the
Connect Agent service deletes the zip file.
The actual crash dumps gets generated in the C:\ProgramData\Schneider
Electric StruxureWare\Building Operation 1.6\Enterprise
Server\db\logs folder.

System 04-17005-03-en, October 2015


664
27 Connect Agent
27.3 Transferring System and Crash Information

You can find the crash information log file


SE.SBO.S2ConnectESCrashAgentLog at location C:\Program Files
(x86)\Schneider Electric StruxureWare\Building Operation
1.6\S2ConnectAgent\bin

04-17005-03-en, October 2015 System


665
28 Connect Agent User Interface

Topics
Connect Agent Settings - Basic Tab
Connect Agent Settings - Advanced Tab
28 Connect Agent User Interface
28.1 Connect Agent Settings - Basic Tab

28.1 Connect Agent Settings - Basic Tab


Use the Basic dialog box to configure the settings of Connect Agent to enable the
transfer of system information and crash information of the SmartStruxure servers
to the Connect storage server.

Figure: Basic tab

Table: Basic Tab


Component Description

Enable system information transfer Select True to enable the Connect Agent
service to transfer system information to the
Connect storage server.

Enable crash information transfer Select True to enable the Connect Agent
service to transfer crash information to the
Connect storage server.

04-17005-03-en, October 2015 System


669
28 Connect Agent User Interface
28.2 Connect Agent Settings - Advanced Tab

28.2 Connect Agent Settings - Advanced Tab


Use the Advanced tab to configure the advanced settings of Connect Agent.

Figure: Advanced tab

Table: Advanced Tab


Component Description

Days between transfers Select how often you want the Connect
Agent to transfer the system data to the
Connect storage server.

Maximum bandwidth Select the bandwidth at which the system


information is to be transfered. If '0' is
selected, the system information is
transfered at maximum bandwidth.

System 04-17005-03-en, October 2015


670
29 Alarms Introduction

Topics
Alarms Overview
Alarm States
Alarm Functions
Alarm Objects in Multiple Servers
Alarms Pane and Alarm View Customization
Styling the Alarm States in the Alarms Pane and Alarm
Views
Displaying Alarm View on an Alarm
Alarm Filter Conditions
Creating a Filtered Alarm View
Filter Condition Wildcards
Alarm Handling Issues
Editing a Standard Alarm View Filter
29 Alarms Introduction
29.1 Alarms Overview

29.1 Alarms Overview


You use an alarm to monitor a variable and to alert you if the monitored variable
matches the configured alarm conditions.
You can configure an alarm to send a message to a specified user or user group
when the alarm is triggered or force the user that acknowledges the alarm to write a
cause note. You can also configure the alarm to flash and play a sound when it is
triggered.
Suppose you want to monitor the temperature of a freezer protector on a
compressor. You create an alarm that triggers when the temperature drops too low.
A message is automatically sent to an assigned operator who acknowledges the
alarm and corrects the problem.

Figure: Triggered, reset, and acknowledged alarms presented in Alarms pane

29.1.1 Alarm States


An alarm is always in a certain alarm state. The state of the alarm is presented in the
alarm properties, in the Alarms pane, or in the Alarm Views.
For more information, see section 29.2 Alarm States on page 675.

29.1.2 Alarm Types


An alarm compares the value from a monitored variable with the conditions of the
alarm. Different types of alarms handle different types of variables and different
forms of evaluation.
For more information, see section 30.1 Alarm Types on page 699.

29.1.3 Alarm Functions


You can monitor variables and configure the alarms in many different ways. You
can, for example, connect the alarm to a shunt variable, add dead band to the
alarm limit, or configure the priority of the alarm.
For more information, see section 29.3 Alarm Functions on page 676.

04-17005-03-en, October 2015 System


673
29 Alarms Introduction
29.1 Alarms Overview

29.1.4 Alarm Objects in Multiple Servers


In a multi-server system, you create alarm objects on the Enterprise Server. These
objects, such as checklists and action notes, are inherited by the SmartStruxure
server devices that are connected to that Enterprise Server. The copies on the
connected SmartStruxure server devices are read-only, so in order to edit them you
must edit their source objects on the Enterprise Server. One advantage with this is
that you can display the objects and their content on the SmartStruxure server
devices even if the Enterprise Server goes offline.
For more information, see section 29.4 Alarm Objects in Multiple Servers on page
679.

29.1.5 Alarms Pane and Alarm View Customization


You use the Alarms pane and the Alarm View to view and administer alarms. When
an alarm is triggered, it is displayed in the Alarms pane or Alarm Views together with
information about the alarm. You can edit the Alarm View filter to display the Alarm
View only when certain alarms are triggered. You can create and use more than one
Alarm View. The Alarms pane and each Alarm View can be customized with an
alarm filter to show information that is relevant to the user who supervises the
alarms. Customized settings are lost when you perform a system upgrade.
For more information, see section 29.5 Alarms Pane and Alarm View
Customization on page 680.

29.1.6 Alarm Filter Conditions


Alarm filter conditions are used to set up the conditions for the alarms you want to
be displayed in an Alarms pane or an Alarm View. You also use alarm filter
conditions to determine the conditions that have to be met before a sum alarm is
triggered, an email notification is sent, a write to file notification is written, or an
alarm is automatically assigned to a user.
For more information, see section 29.8 Alarm Filter Conditions on page 685.

29.1.7 Mass Create


You use the mass create feature to create multiple identical alarms or trend logs for
different objects, instead of creating the alarms or trend logs one by one. From
trend logs, you can mass create extended trend logs.
For more information, see section 42.1 Mass Create on page 1393.

System 04-17005-03-en, October 2015


674
29 Alarms Introduction
29.2 Alarm States

29.2 Alarm States


An alarm is always in a certain alarm state. The state of the alarm is presented in the
alarm properties, in the Alarms pane, or in the Alarm Views.

Table: Alarm States


Alarm State Description

Normal state Idle state where the alarm monitors the


variable. Normal state = 0.

Alarm state When an alarm is triggered, the state of the


alarm changes from the normal state to
alarm state. Alarm state = 1.

Acknowledge state A user or user group has acknowledged the


alarm. Acknowledged state = 2.

Reset state The monitored variable has returned to a


value that is within the normal condition of
the alarm, but the alarm has to be
acknowledged by a user before the alarm
returns to normal state. Reset state = 3.

Disable state You can disable an alarm when the alarm is


triggered by faulty reasons, the alarm
toggles between the alarm state and reset
state, or maintenance will trigger the alarm.
Disabled state = 4.
A Disabled alarm can be hidden in the
Alarms pane or Alarm Views. To reset the
alarm, you have to show hidden alarms and
then enable it. When you show disabled
alarms, enabled alarms are hidden.

Fault state If a BACnet device reports values that it


knows are not trustworthy, the monitoring
alarm is put in fault state. Fault state = 5.

You can configure the alarm in different ways whether or not a user has to
acknowledge the alarm before it returns to normal state.
For more information, see section 31.14 Acknowledgements on page 828.

29.2.1 Alarm Handling Issues


When an alarm is triggered it appears in the alarm list. You can acknowledge,
disable, or hide alarms in the alarm list. An acknowledged alarm disappears from
the alarm list when it has been reset to normal state.
For more information, see section 29.11 Alarm Handling Issues on page 695.

04-17005-03-en, October 2015 System


675
29 Alarms Introduction
29.3 Alarm Functions

29.3 Alarm Functions


You can monitor variables and configure the alarms in many different ways. You
can, for example, connect the alarm to a shunt variable, add dead band to the
alarm limit, or configure the priority of the alarm.

29.3.1 Time Delay


Time delay prevents unintentional activation-deactivation cycles. You can delay the
time before the alarm is triggered when the alarm state goes from normal state to
alarm state and when it goes from alarm state to reset state.
For more information, see section 31.1 Time Delay on page 813.

29.3.2 Shunt Variable


A shunt variable is a binary value that works as an on/off switch for the alarm.
For more information, see section 31.3 Shunt Variables on page 815.

29.3.3 Deadband
Deadband is an area of the alarm range where no reset action occurs. The purpose
of the deadband is to prevent unintentional activation-deactivation cycles.
For more information, see section 31.5 Deadband on page 817.

29.3.4 Alarm Messages


When configuring the alarm, you can write a message that displays in the Alarms
pane, Events pane, Alarm Views, and Event Views when an alarm is triggered or
reset.
For more information, see section 31.6 Alarm Messages on page 818.

29.3.5 Priority
When configuring an alarm, you define the priority of the alarm. The priority is used
to inform the operator of the importance of the triggered alarm. The priority is
displayed in the Alarms pane, Events pane, Alarm Views, and Event Views.
For more information, see section 31.8 Priority on page 820.

System 04-17005-03-en, October 2015


676
29 Alarms Introduction
29.3 Alarm Functions

29.3.6 Categories
You can group together alarms in categories to simplify the identification of the
alarm. When the alarm is triggered, the category name is displayed together with
the alarm in the Alarms pane, Events pane, Alarm Views, and Event Views.
For more information, see section 31.10 Categories on page 822.

29.3.7 Acknowledgement
When an alarm is triggered, you acknowledge the alarm to indicate to other users
that you have responded to the alarm and intend to troubleshoot the problem that
caused the alarm. The name of the user that acknowledges the alarm is displayed
in the Alarms pane, Events pane, Alarm Views, and Event Views.
For more information, see section 31.14 Acknowledgements on page 828.

29.3.8 User Actions


You can add information when handling a trigger alarm. For example, you can add
a comment to the alarm or open an action note that is connected to the alarm.
When configuring an alarm, you can force the user to perform different actions
when handling a triggered alarm.
For more information, see section 31.19 User Actions on page 836.

29.3.9 Notifications
User notifications are used for notifying users or user groups that a certain alarm
event has occurred in the system. The notification contains a prewritten message
that is either sent in an email or written to a text file. When setting up the notification,
you write the message and then configure the conditions that execute the writing or
sending action.
For more information, see section 31.27 Notifications on page 848.

29.3.10 Automatic Assignment


A triggered alarm can be automatically assigned to a specific user or user group
that is most suited to correct the problem. An assigned alarm indicates to other
users that someone is working with the problem that caused the alarm. The name
of the user that is assigned to the alarm and the assignment status are displayed in
the Alarms pane, Events pane, Alarm Views and Event Views.
For more information, see section 31.38 Automatic Assignments on page 873.

04-17005-03-en, October 2015 System


677
29 Alarms Introduction
29.3 Alarm Functions

29.3.11 Unit of Measure in Alarms


When creating an alarm, the alarm limit and deadband values inherit the unit of the
monitored variable. You can change the unit of the alarm to any unit within the same
unit category as the monitored variable.

Note
You cannot define a unit to an alarm that monitors a unitless variable.

For more information, see section 31.40 Unit of Measure in Alarms on page 877.

29.3.12 Attachments
You can add attachments to alarm objects, except system information alarms. An
attachment is a link pointing to an object in the system, such as a report, a voice
message, or a trend chart. When an alarm is triggered that has an attachment, a
paperclip icon is displayed in the Alarms pane and Alarm Views. It is also possible to
configure the attachment to display when the alarm is triggered.

System 04-17005-03-en, October 2015


678
29 Alarms Introduction
29.4 Alarm Objects in Multiple Servers

29.4 Alarm Objects in Multiple Servers


In a multi-server system, you create alarm objects on the Enterprise Server. These
objects, such as checklists and action notes, are inherited by the SmartStruxure
server devices that are connected to that Enterprise Server. The copies on the
connected SmartStruxure server devices are read-only, so in order to edit them you
must edit their source objects on the Enterprise Server. One advantage with this is
that you can display the objects and their content on the SmartStruxure server
devices even if the Enterprise Server goes offline.

Note
When an Enterprise Server is connected to a SmartStruxure server device, all
existing checklists, action notes, cause notes, and categories on SmartStruxure
server device are removed and replaced with the objects from the Enterprise
Server.

04-17005-03-en, October 2015 System


679
29 Alarms Introduction
29.5 Alarms Pane and Alarm View Customization

29.5 Alarms Pane and Alarm View


Customization
You use the Alarms pane and the Alarm View to view and administer alarms. When
an alarm is triggered, it is displayed in the Alarms pane or Alarm Views together with
information about the alarm. You can edit the Alarm View filter to display the Alarm
View only when certain alarms are triggered. You can create and use more than one
Alarm View. The Alarms pane and each Alarm View can be customized with an
alarm filter to show information that is relevant to the user who supervises the
alarms. Customized settings are lost when you perform a system upgrade.
In the Alarms pane and Alarm Views, you can also open a detailed view to inspect
all properties for a selected alarm.

Figure: The Alarms pane


Through Control Panel, you can customize the appearance of different alarm states
that are displayed in the Alarms pane and Alarm Views. For example, you can
change the font style, font size, background color, and font color.
You can also configure the alarm to flash or play a sound when it is triggered.

29.5.1 Standard Alarm View Filter and Layout


A standard layout defines the columns that are included in the Alarms pane, Events
pane, Alarm View, or Event View, the order in which they are displayed, whether or
not the alarms or events are grouped in any way and whether they are displayed in
an ascending or descending order. A standard filter defines the conditions that have
to be met before the alarms or events are displayed in the pane or a View. The
standard layout and filter is saved for the pane or View to which you made the
changes. The standard layout and filter is displayed for all users in the Building
Operation system.
For more information, see the Standard Alarm View Filter and Layout topic on
WebHelp.

System 04-17005-03-en, October 2015


680
29 Alarms Introduction
29.6 Styling the Alarm States in the Alarms Pane and Alarm Views

29.6 Styling the Alarm States in the Alarms


Pane and Alarm Views
You style the appearance of the different alarm states in the Alarms pane and Alarm
Views to easily separate the alarm states from each other.
For more information, see section 29.5 Alarms Pane and Alarm View
Customization on page 680.

To style the alarm states in the Alarms pane and Alarm Views
1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel, click Alarm appearance.

3. In the Alarm Styles view, double-click the alarm state you want to style.

Continued on next page

04-17005-03-en, October 2015 System


681
29 Alarms Introduction
29.6 Styling the Alarm States in the Alarms Pane and Alarm Views

4. In the Font box, click the Browse button.

5. Select the font, font style, and font size that you want to use in the Alarms
pane and Alarm Views.

6. Click OK.
7. In the Background color box, click the Browse button.
Continued on next page

System 04-17005-03-en, October 2015


682
29 Alarms Introduction
29.6 Styling the Alarm States in the Alarms Pane and Alarm Views

8. Select the color for the background of the alarm state row.

9. Click OK.
10. In the Font color box, click the Browse button.
11. Select the color for the font of the alarm state text.
12. Click OK.

13. Click the Save button .

04-17005-03-en, October 2015 System


683
29 Alarms Introduction
29.7 Displaying Alarm View on an Alarm

29.7 Displaying Alarm View on an Alarm


You configure an Alarm View to automatically open in a new window when an alarm
is triggered.

To display Alarm View on an alarm


1. In the Alarms pane, right-click anywhere.
2. Point to Alarm view settings.
3. Select Display alarm view to automatically open the Alarm View when an
alarm is triggered.

System 04-17005-03-en, October 2015


684
29 Alarms Introduction
29.8 Alarm Filter Conditions

29.8 Alarm Filter Conditions


Alarm filter conditions are used to set up the conditions for the alarms you want to
be displayed in an Alarms pane or an Alarm View. You also use alarm filter
conditions to determine the conditions that have to be met before a sum alarm is
triggered, an email notification is sent, a write to file notification is written, or an
alarm is automatically assigned to a user.
You filter on a condition category and then select the sub conditions for that
category.
Examples:
You filter on Type and then select Alarm Record if you only want Building
Operation Alarms to be displayed in the Alarms pane or Alarm View.
You filter on Type and then select Extended System Alarm Record and
Simple System Alarm Record if you only want Building Operation system
alarms to be displayed in the Alarms pane or Alarm View.

Note
To edit the filter conditions of an alarm, assignment, or notification, you have to
open the alarm, assignment, or notification by clicking it.

Table: Alarm Filter Conditions


Component Description

Acknowledge time Enter the property to filter by the time and


date the alarm was acknowledged.

Acknowledged by Type the property to filter by the name of the


user that acknowledged the alarm.
Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

Acknowledgement required Select the property to filter BACnet alarms


by whether the notification requires
acknowledgement. True specifies that an
acknowledgement is required.

Alarm state Select the property to filter alarms by the


present state of the alarm.

Alarm text Type the property to filter alarms by the


alarm messages that are added to the alarm.
Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

Assigned state Select the property to filter alarms that have


been assigned to and accepted by any user
or group.

Assigned to domain Type the property to filter alarms by the


domain of the user or group that the alarm is
assigned to. Wildcards can be used. For
more information, see section 34.8 Filter
Condition Wildcards on page 1102.

04-17005-03-en, October 2015 System


685
29 Alarms Introduction
29.8 Alarm Filter Conditions

Continued
Component Description

Assigned to ID Type the property to filter alarms by the ID of


the user or group that the alarm is assigned
to. Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

Assigned to name Type the property to filter alarms by the


name of the user or group that the alarm is
assigned to. Wildcards can be used. For
more information, see section 34.8 Filter
Condition Wildcards on page 1102.

BACnet alarm type Select the property to filter alarms by the


BACnet alarm that monitors a variable within
a BACnet network.

BACnet notification Enter the property to filter alarms by the


BACnet Notification Class of the event.

BACnet notification type Select the property to filter alarms by the


BACnet notification, whether the notification
is an event or an alarm.

Basic evaluation state Select the property to filter alarms by the


current evaluation state of the alarm. True
indicates that the alarm is triggered.

Category Type the property to filter alarms by the


category name of the alarm. Wildcards can
be used. For more information, see section
34.8 Filter Condition Wildcards on page
1102.

Command value Enter the property to filter alarms by the


value that was commanded.

Confirmed notification Select the property to filter alarms by the


request requires acknowledgement, by the
recipient's computer.

Count Enter the property to filter alarms by the


number of times the alarm has toggled
between the alarm and reset state.

Deadband Enter the property to filter alarms by the


deadband value of the alarm.

Device name Type the property to filter events by the


name of the I/NET device that generated the
alarm. Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

Disabled by Select the property to filter alarms by the


name of the user who disabled the alarm.

System 04-17005-03-en, October 2015


686
29 Alarms Introduction
29.8 Alarm Filter Conditions

Continued
Component Description

Disabled cause Select the property to filter alarms by the


cause for disabling the alarm. An alarm is
either disabled by user, shunt variable, or if
the alarm is incorrectly configured.

Error limit Enter the property to filter alarms by the


difference limit that was exceeded.

Evaluation state Select the property to filter alarms by the


present evaluation state of the alarm. For
example, Upper limit alarm is displayed
when the monitored value reaches the upper
alarm limit.

Event from state Select the property to filter alarms by the


BACnet From State. The From State
indicates the Event State of the object prior
to the occurrence of the event that initiated
the notification.

EWS ID Type the property to filter alarms by the ID


the alarm has on the external system.
Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

EWS source ID Type the property to filter alarms by the


external ID of the object that generated the
alarm. Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

Exceeded limit Enter the property to filter alarms by the limit


that was exceeded.

Exceeding value Enter the property to filter alarms by the


value that exceeded a limit.

Feedback value Enter the property to filter alarms by the


value that differs from the Command value.

First name Type the property to filter alarms by the first


name of the individual whose key/card was
used at the I/NET door point. Wildcards can
be used. For more information, see section
34.8 Filter Condition Wildcards on page
1102.

Hidden Select the property to filter alarms by the


visible status. True is displayed when the
object is hidden.

Individual Enter the property to filter alarms by the


individual number of the individual whose
key/card was used at the I/NET door point.

04-17005-03-en, October 2015 System


687
29 Alarms Introduction
29.8 Alarm Filter Conditions

Continued
Component Description

INET Address Type the system address of the I/NET point,


or station address of the I/NET host or
controller, that generated the event.

Last name Type the property to filter alarms by the last


name of the individual whose key/card was
used at the I/NET door point. Wildcards can
be used. For more information, see section
34.8 Filter Condition Wildcards on page
1102.

Logging Select the property to filter alarms by


whether or not associated alarm events are
generated and recorded in the Event log.

Message text Select the property to filter alarms by a


message of up to 64 characters that has
been assigned to the I/NET point.

Monitored variable Type the property to filter alarms by the


monitored variable. Wildcards can be used.
For more information, see section 34.8 Filter
Condition Wildcards on page 1102.

New mode Enter the property to filter alarms by the new


mode of the referenced object.

New state Enter the property to filter alarms by the new


state of the referenced property.

New value Type the property to filter alarms by the new


value of the referenced property. Wildcards
can be used. For more information, see
section 34.8 Filter Condition Wildcards on
page 1102.

Operation expected Enter the property to filter alarms by the next


operation requested by the referenced
object.

Possible operator actions Select the property to filter alarms by the


possible actions one can perform on the
record, given permissions.

Previous alarm state Select the property to filter alarms by the


previous state of the alarm.

Priority Enter the property to filter alarms by the


current priority level of the alarm state.

Process ID Enter the property to filter alarms by the


unique process ID in the receiving device for
which a BACnet notification is intended.

System 04-17005-03-en, October 2015


688
29 Alarms Introduction
29.8 Alarm Filter Conditions

Continued
Component Description

Referenced bit string Type the property to filter alarms by the new
value of the referenced bit string property.
Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

Referenced value Enter the property to filter alarms by the


value of the referenced property.

Setpoint value Enter the property to filter alarms by the


value of the reference variable.

Sigma event parameters Type the property to filter alarms by the


Sigma event parameter. Wildcards can be
used. For more information, see section 34.8
Filter Condition Wildcards on page 1102.

Sigma event type Select the property to filter alarms by the


Sigma event type.

Source Type the property to filter alarms by the path


of the source object. Wildcards can be used.
For more information, see section 34.8 Filter
Condition Wildcards on page 1102.

Source name Type the property to filter alarms by the


external name of the object that generated
the alarm. Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

Source server Type the property to filter alarms by the path


where the alarm is located. Wildcards can be
used. For more information, see section 34.8
Filter Condition Wildcards on page 1102.

Station name Type the name assigned to the I/NET


controller from which the event originated.

Status flags Select the property to filter alarms by the


status flag.

System alarm ID Select the property to filter alarms by the


alarm ID generated by the system.

Tenant Enter the property to filter alarms by the


tenant number of the individual whose
key/card was used at the I/NET door point.

Timestamp Enter the property to filter alarms by the time


and date.

Triggered time Enter the property to filter alarms by the time


and date of the last state transfer from
normal state to alarm state.

Type Select the property to filter alarms by the


type of the object.

04-17005-03-en, October 2015 System


689
29 Alarms Introduction
29.8 Alarm Filter Conditions

Continued
Component Description

Value at change Type the property to filter alarms by the value


of the monitored variable. Wildcards can be
used. For more information, see section 34.8
Filter Condition Wildcards on page 1102.

Filter condition wildcards


A wildcard is one or more characters used to simplify the process of setting up filter
conditons. You use wildcards to subsitute characters or combinations of characters
in object properties, such as names or descriptions. For example, instead of setting
up five filter conditions for values with names beginning with a, b, c, d, or e, you can
set up one single filter condition for values with a name beginning with any of the
characters in the range [a-e].
For more information, see section 34.8 Filter Condition Wildcards on page 1102.

System 04-17005-03-en, October 2015


690
29 Alarms Introduction
29.9 Creating a Filtered Alarm View

29.9 Creating a Filtered Alarm View


You create an Alarm View to apply an alarm filter that displays only those alarms the
user needs to see.
For more information, see section 29.5 Alarms Pane and Alarm View
Customization on page 680.

To create a filtered Alarm View


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where you want to create the Alarm View.
2. On the File menu, point to New and then click View.
3. In the object type list, click Alarm View.

4. In the Name box, type a name for the Alarm View.


5. In the Description box, type a description for the Alarm View.
6. Click Create.
7. In the System Tree pane, select the Alarm View you created.
8. On the Actions menu, click Edit standard Alarm View filter to filter the
Alarm View.
Continued on next page

04-17005-03-en, October 2015 System


691
29 Alarms Introduction
29.9 Creating a Filtered Alarm View

9. Click the Add condition button and select a condition type.

10. Type the condition for the filter.

11. Click the Add row button to add another condition of the same type.
12. Type the condition for the filter.

Tip
You can add different condition types by clicking the Add

condition button . For example, you can filter on


categories, alarm state, and alarm text.

13. Click OK.

System 04-17005-03-en, October 2015


692
29 Alarms Introduction
29.10 Filter Condition Wildcards

29.10 Filter Condition Wildcards


A wildcard is one or more characters used to simplify the process of setting up filter
conditons. You use wildcards to subsitute characters or combinations of characters
in object properties, such as names or descriptions. For example, instead of setting
up five filter conditions for values with names beginning with a, b, c, d, or e, you can
set up one single filter condition for values with a name beginning with any of the
charachters in the range [a-e].

Table: Wildcard Characters


Character Description

* Use to match any combination of


characters, including no character

? Use to match any one character exactly

[ Use to begin a SET, that is, a number of


characters or a range

] Use to end a SET

[] Use to match any one character specified


within the SET, that is, enclosed by the
brackets

! Use to exclude the characters or range(s) of


a SET

- Use in a range within a SET: 0-9, a-z, A-Z

\ Use to ignore the wildcard character and


search for it as any other character

Any other character has to match exactly.


You can specify any number of characters or a range within brackets. In this case,
the filter includes one character specified within the brackets and any number of
characters specified outside the brackets.
Examples:
*at - Matches "at" and all objects ending with "at"
?t - Matches all two-character objects ending with "t"
[CB]at - Matches "Cat" and "Bat", that is, objects beginning with any one character
specified within the SET and ending with "at"
[A-C]at - Matches "Aat", "Bat", and "Cat"
[CB][au]t - Matches "Cat", "Cut", "Bat", and "But"
[!a-b0-1q]at - Matches all three-character objects ending with 'at' except "aat",
"bat", "0at", "1at" and "qat"
\\ - Matches "\"
b\\t - Matches b\t

04-17005-03-en, October 2015 System


693
29 Alarms Introduction
29.10 Filter Condition Wildcards

Table: Wildcard Availability for Different Features


Feature * ? [b] [a-c] [\]] [!a-c]

Alarm View Yes Yes Not Not Not Not


Filter available available available available
Conditions

Event View Yes Yes Yes Yes Not Not


Filter available available
Conditions

Sum Alarm Yes Yes Yes Yes Yes Yes


Filter
Conditions

Notification Yes Yes Yes Yes Yes Yes


s Filter
Condition

Assignmen Yes Yes Yes Yes Yes Yes


ts Filter
Conditions

System 04-17005-03-en, October 2015


694
29 Alarms Introduction
29.11 Alarm Handling Issues

29.11 Alarm Handling Issues


When an alarm is triggered it appears in the alarm list. You can acknowledge,
disable, or hide alarms in the alarm list. An acknowledged alarm disappears from
the alarm list when it has been reset to normal state.
When the alarm database is lost after an upgrade or is corrupt after a
SmartStruxure server crash, all alarms are re-evaluated. The alarms that are still
active are resent to the alarm database. However, the information that an alarm has
been acknowledged, disabled, or hidden is lost and you have repeat the operation
you performed on the alarm before the data loss.
When an alarm has been triggered and reset to normal state without having been
acknowledged, the alarm remains in the alarm list until it is acknowledged. If the
alarm is lost, an alarm refresh does not make the alarm reappear in the alarm list.
The alarm is reset and has no alarm state to send.
Most system information alarms are only messages. These alarms cannot be in an
alarm state, thus, an alarm refresh does not make the system information alarms
reappear in the alarm list.

04-17005-03-en, October 2015 System


695
29 Alarms Introduction
29.12 Editing a Standard Alarm View Filter

29.12 Editing a Standard Alarm View Filter


You edit a Standard Alarm View filter to make a Alarms pane and Alarm View filter
accessible to all users.
For more information, see the Standard Alarm View Filter and Layout topic on
WebHelp.

To edit a Standard Alarm View filter


1. In the Alarms pane or an Alarm View, right-click anywhere in the Alarms pane
or Alarm View, point to Alarm view settings and then click Edit Standard
Alarm View filter.

2. Click Add condition .


3. Select the condition you want to add to the Standard Alarm View filter.

4. Select the sub condition that has to be met before the alarm is displayed in the
Alarms pane or Alarm View.
5. Click OK.
The Standard Alarm View filter is accessible to all users and for the changed Alarms
pane or Alarm View the next time the users opens the Alarms pane or Alarm View.

System 04-17005-03-en, October 2015


696
30 Alarm Types

Topics
Alarm Types
Change of State Alarms
Creating a Change of State Alarm
Configuring a Change of State Alarm
Multistate Alarms
Creating a Multistate Alarm
Configuring a Multistate Alarm
Matching Text String Alarms
Creating a Matching Text String Alarm
Configuring a Matching Text String Alarm
Variable Status Alarms
Creating a Variable Status Alarm
Configuring a Variable Status Alarm
Out of Range Alarms
Creating an Out of Range Alarm
Configuring an Out of Range Alarm
Out of Reference Range Alarms
Creating an Out of Reference Range Alarm
Configuring an Out of Reference Range Alarm
Sum Alarms
Creating a Sum Alarm
Configuring a Sum Alarm
Enumeration Alarms
Creating an Enumeration Alarm
Configuring an Enumeration Alarm
System Information Alarms
System Information Alarms List
Configuring the Description of an Alarm
30 Alarm Types
30.1 Alarm Types

30.1 Alarm Types


An alarm compares the value from a monitored variable with the conditions of the
alarm. Different types of alarms handle different types of variables and different
forms of evaluation.
Alarms can monitor values from external sources, such as LonWorks and BACnet
devices, as well as values from SmartStruxure servers. Some alarms are also based
on system information, such as device restart or network status.

30.1.1 Change of State Alarms


The change of state alarm monitors the state changes of digital variables. You
configure the alarm to trigger when the variable changes its state to true or to false.
For more information, see section 30.2 Change of State Alarms on page 702.

30.1.2 Out of Range Alarms


When setting up an out of range alarm, you configure the normal range of the
monitored variable. If the variable goes below the lower limit or above the upper limit
of the normal range, the alarm is triggered.
For more information, see section 30.14 Out of Range Alarms on page 749.

30.1.3 Out of Reference Range Alarms


The out of reference range alarm monitors variable movements comparing to a
reference variable. By setting an upper deviation limit and lower deviation limit, you
configure the tolerance the monitored variable can vary from the reference variable
before the alarm is triggered. The upper alarm limit of the monitored variable is
equal to the reference point current value plus the upper deviation limit. The lower
alarm limit of the monitored variable is equal to the reference point current value
minus the lower deviation limit.
For more information, see section 30.17 Out of Reference Range Alarms on page
763.

30.1.4 Multistate Alarms


The multistate alarm monitors a variable and triggers the alarm if the variable is
between the configured alarm range or equal to a single value. You can add several
ranges or single values to trigger the alarm.
For more information, see section 30.5 Multistate Alarms on page 715.

04-17005-03-en, October 2015 System


699
30 Alarm Types
30.1 Alarm Types

30.1.5 Matching Text String Alarms


A matching text string alarm evaluates if the monitored value equals the given text
strings.
For more information, see section 30.8 Matching Text String Alarms on page 727.

30.1.6 Variable Status Alarms


The variable status alarm monitors the status of a variable. The alarm is triggered
when the value of the monitored variable is either forced or overridden. If you
configure the alarm to trigger on both force and override, the alarm is triggered
immediately when the variable changes to one of the two statuses.
For more information, see section 30.11 Variable Status Alarms on page 738.

30.1.7 Sum Alarms


A sum alarm can be seen as a collection of alarms that have one or several
common denominators. The conditions you use to filter out which alarms the sum
alarm monitors are the same conditions you use to filter the Alarms pane or an
Alarm View. You can use wildcards when setting up filter conditions. For more
information, see section 34.8 Filter Condition Wildcards on page 1102.
For more information, see section 30.20 Sum Alarms on page 777.

30.1.8 Enumeration Alarms


An enumeration is a variable with labeled values; different variables have different
enumerations. When configuring an enumeration alarm, you configure the variable
and its enumerations to monitor.
For more information, see section 30.23 Enumeration Alarms on page 788.

30.1.9 System Information Alarms


System information alarms monitor system entities, such as online status for
SmartStruxure server devices or field devices. The system information alarms are
generated by Building Operation. Users cannot create new system alarms. The
possible causes of a system alarm are gathered in an enumeration called System
alarm ID. When a system alarm is triggered, the cause of the alarm is indicated in
the System alarm ID column in the Alarms pane or Alarm View. Some system
alarms have additional information in the Alarm text column.
For more information, see section 30.26 System Information Alarms on page 799.

System 04-17005-03-en, October 2015


700
30 Alarm Types
30.1 Alarm Types

30.1.10 EcoStruxure Web Service Alarm Item


The EcoStruxure Web Service alarm item is a representation of an alarm on an
EcoStruxure Web Service. The alarm item is automatically created when you host
an EcoStruxure Web Service alarm on your system.
For more information, see the EcoStruxure Web Service Alarm Item topic on
WebHelp.

04-17005-03-en, October 2015 System


701
30 Alarm Types
30.2 Change of State Alarms

30.2 Change of State Alarms


The change of state alarm monitors the state changes of digital variables. You
configure the alarm to trigger when the variable changes its state to true or to false.

Figure: Change of state alarm when the monitored variable goes true

Figure: Change of state alarm when the monitored variable goes false
For example, you set up a change of state alarm that monitors a ventilation fan. If
the fan breaks or stops working, the alarm is triggered.
You can configure the change of state alarms using shunt variable and time delay.
For more information, see section 29.3 Alarm Functions on page 676.

System 04-17005-03-en, October 2015


702
30 Alarm Types
30.3 Creating a Change of State Alarm

30.3 Creating a Change of State Alarm


You create a change of state alarm to trigger an alarm when a variable, such as a
switch, is either true or false.
For more information, see section 30.2 Change of State Alarms on page 702.

To create a change of state alarm


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where you want to create the alarm.
2. On the File menu, point to New and then click Alarm.
3. In the object type list, select Change of State Alarm.

4. In the Name box, type a name for the alarm.


5. In the Description box, type a description for the alarm.
6. Click Next.
Continued on next page

04-17005-03-en, October 2015 System


703
30 Alarm Types
30.3 Creating a Change of State Alarm

7. Select the state of the monitored variable that triggers the alarm:
Click True to trigger the alarm when the monitored variable is equal to
True.
Click False to trigger the alarm when the monitored variable is equal to
False.

8. In the Monitored variable box, enter the variable that the alarm monitors.
9. In the Disable alarm box, select whether or not to create the alarm in
disabled mode.
10. Under Time Delay and Shunt Variables, in the Alarm delay box, enter
the time delay.
11. In the Reset delay box, enter the time delay.
12. Select Invert to have the alarm enabled when the first shunt variable is active.
13. In the Shunt variable 1 box, enter the binary variable that enables or
disables the alarm.
14. In the Operator list, select AND or OR to add logic between the first shunt
variable and the second shunt variable.
15. Select Invert to have the alarm enabled when the second shunt variable is
active.
Continued on next page

System 04-17005-03-en, October 2015


704
30 Alarm Types
30.3 Creating a Change of State Alarm

16. In the Shunt variable 2 box, enter the binary variable that enables or
disables the alarm.

17. Click Next.


Continued on next page

04-17005-03-en, October 2015 System


705
30 Alarm Types
30.3 Creating a Change of State Alarm

18. In the Alarm message box, type the message to display when the
monitored variable exceeds the alarm limit.

19. In the Reset message box, type the message to display when the alarm is
reset.
20. In the Alarm priority box, enter the priority for the alarm state.
21. Select the Same priority check box to let the Reset priority box inherit
the value in the Alarm priority box.
22. In the Reset priority box, enter the priority for the reset state.
23. Under Category and Alerts, in the Category box, enter a category for the
alarm.
24. Select the Flashing alert check box to make the alarm flash in the Alarms
pane and Alarm Views when it is triggered.
Continued on next page

System 04-17005-03-en, October 2015


706
30 Alarm Types
30.3 Creating a Change of State Alarm

25. Select the Audible alert check box to make the alarm sound when it is
triggered.

26. Click Next.


Continued on next page

04-17005-03-en, October 2015 System


707
30 Alarm Types
30.3 Creating a Change of State Alarm

27. Select the type of acknowledgement to use:


Click No when the alarm does not need to be acknowledged.
Click Single when the alarm needs to be acknowledged in the alarm
state.
Click Extended when the alarm needs to be acknowledged in the alarm
state and the reset state.

28. In the Cause note group box, enter a cause note group that you want to
connect to the alarm.
29. In the Action note group box, enter an action note group that you want to
connect to the alarm.
30. In the Checklist box, enter a checklist that you want to connect to the alarm.
31. Select the When acknowledging an alarm: Comment check box to force
the user to add a comment to the alarm before the alarm can be
acknowledged.
32. Select the When acknowledging an alarm: Cause note check box to
force the user to edit the connected cause note before the alarm can be
acknowledged.
33. Select the When acknowledging an alarm: Action note check box to
force the user to edit the connected action note before the alarm can be
acknowledged.
34. Select the When acknowledging an alarm: Checklist check box to force
the user to go through the connected checklist before the alarm can be
acknowledged.
Continued on next page

System 04-17005-03-en, October 2015


708
30 Alarm Types
30.3 Creating a Change of State Alarm

35. Under Required User Actions, select the check boxes for Comment,
Cause note, and Action note to specify how the user should respond to
the listed actions.

36. Click Next.


Continued on next page

04-17005-03-en, October 2015 System


709
30 Alarm Types
30.3 Creating a Change of State Alarm

37. Click the Add attachment button to add an attachment.

38. In the Select Object dialog box, select the object you want to attach to the
alarm.
39. Click Select.
40. On the Attachment page, in the Display on alarm column, select the
check box to automatically open the attachment when the alarm is triggered.

41. Click Create.

System 04-17005-03-en, October 2015


710
30 Alarm Types
30.4 Configuring a Change of State Alarm

30.4 Configuring a Change of State Alarm


You configure the properties of a change of state alarm to meet the unique needs of
your site.
For more information, see section 30.2 Change of State Alarms on page 702.

To configure a change of state alarm


1. In WorkStation, in the System Tree pane, select the change of state alarm
you want to configure.
2. On the File menu, click Properties.
3. Edit the basic settings:
Property Description

Type Displays the alarm type of the alarm.

Name Displays the name of the alarm.

Description Type to change the description of the


alarm.

04-17005-03-en, October 2015 System


711
30 Alarm Types
30.4 Configuring a Change of State Alarm

4. Edit the alarm trigger properties:


Property Description

Trigger value Select True to trigger the alarm when the


monitored variable is equal to True.
Select False to trigger the alarm when
the monitored variable is equal to False.

Montiored variable Enter the path to the variable that is


monitored by the alarm.

Disable alarm Select to disable the alarm, for example,


before deployment.

Alarm state Displays the present state of the alarm.


For more information, see section 29.2
Alarm States on page 675.

Alarm delay (s) Enter the time, in seconds, the alarm has
to be within the alarm criteria before the
alarm is triggered.

Reset delay (s) Enter the time, in seconds, the alarm has
to be within the reset criteria before the
alarm state is changed from alarm to
reset.

Shunt variable 1 Enter the shunt variable that is used to


enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the
shunt value is inactive. For more
information, see section 31.3 Shunt
Variables on page 815.

Operator Select AND or OR to add logic between


the first and the second shunt variable.
For more information, see section 31.3
Shunt Variables on page 815.

Shunt variable 2 Enter the second shunt variable that is


used to enable or disable the alarm. For
more information, see section 31.3
Shunt Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the
shunt value is inactive. For more
information, see section 31.3 Shunt
Variables on page 815.

System 04-17005-03-en, October 2015


712
30 Alarm Types
30.4 Configuring a Change of State Alarm

5. Edit the presentation properties:


Property Description

Alarm message Type the message to display when the


alarm is in Alarm state.
For more information, see section 31.6
Alarm Messages on page 818.

Reset message Type the message to display when the


alarm is reset.

Alarm priority Enter the priority level of the alarm.

Reset priority Select to set all priorities to the same


value.

Same priority Select to set all priorities to the same


value.

Category Enter the category that the alarm belongs


to.

Flashing alert Select to make the alarm row flash in the


Alarms pane and Alarm Views when the
alarm is triggered.

Audible alert Select to make the alert audible when the


alarm is triggered.

6. Edit the user action properties:


Property Description

Acknowledgement type Select the type of acknowledgement for


the alarm.

Cause note group Enter the cause note group that is used
by the alarm.

Action note group Enter the action note group that is used
by the alarm.

Checklist Enter the checklist that belongs to the


alarm.

When acknowledging an alarm Select what actions the user has to


perform when acknowledging an alarm.

Required user action Select what actions the user has to


perform when any of the listed events
occur.

04-17005-03-en, October 2015 System


713
30 Alarm Types
30.4 Configuring a Change of State Alarm

7. Edit the attachment properties:


Property Description

Add attachment
Click to add an attachment to the alarm.
For more information, see section 31.21
Alarm Attachments on page 839.

Remove attachment
Click to remove an attachment.

Navigate to
Click to open the attachment that is
selected in the attachment list.

Display on alarm Select to display the attachment when the


alarm is triggered.

8. Click OK.

System 04-17005-03-en, October 2015


714
30 Alarm Types
30.5 Multistate Alarms

30.5 Multistate Alarms


The multistate alarm monitors a variable and triggers the alarm if the variable is
between the configured alarm range or equal to a single value. You can add several
ranges or single values to trigger the alarm.

Note
The trigger values and the monitored variable must be integer.

Figure: Multistate alarm triggers an alarm when the monitored variable goes inside the
configured range or a single value.
For example, you have a function block program with an output variable that
generates integer values for different states. By using a multistate alarm, you can
monitor a specific value or several value ranges.
You can configure multistate alarms using shunt variable and time delay. For more
information, see section 29.3 Alarm Functions on page 676.

04-17005-03-en, October 2015 System


715
30 Alarm Types
30.6 Creating a Multistate Alarm

30.6 Creating a Multistate Alarm


You create a multistate alarm to trigger an alarm when a variable is within a set
range.

To create a multistate alarm


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where you want to create the alarm.
2. On the File menu, point to New and then click Alarm.
3. In the object type list, select Multistate Alarm.

4. In the Name box, type a name for the alarm.


5. In the Description box, type a description for the alarm.
6. Click Next.

7. Click the button.


Continued on next page

System 04-17005-03-en, October 2015


716
30 Alarm Types
30.6 Creating a Multistate Alarm

8. Click between to change the interval to a specific value.

9. Click the Set unit button to add a unit to the alarm limits and deadband.

Note
To define a unit of the alarm, the monitored variable must have a
defined unit.

Continued on next page

04-17005-03-en, October 2015 System


717
30 Alarm Types
30.6 Creating a Multistate Alarm

10. In the Unit selection dialog box, select a unit.

11. In the Prefix box, select a prefix for the unit.


12. Click Select.
13. Under Trigger alarm when variable is box, in the number boxes, enter the
interval or the specific value of the monitored variable that triggers the alarm.
14. Click Add row to add another interval or specific value to the alarm criteria.
15. In the Monitored variable box, enter the variable that the alarm is to
monitor.
16. In the Disable alarm box, select whether or not to create the alarm in
disabled mode.
17. In the Alarm delay box, enter the time delay before the alarm is triggered.
18. In the Reset delay box, enter the time delay before the alarm is reset.
19. Select Invert to have the alarm enabled when the first shunt variable is active.
20. In the Shunt variable 1 box, enter the binary variable that enables or
disables the alarm.
21. In the Operator list, select AND or OR to add logic between the first shunt
variable and the second shunt variable.
22. Select Invert to have the alarm enabled when the second shunt variable is
active.
23. In the Shunt variable 2 box, enter the binary variable that enables or
disables the alarm.
Continued on next page

System 04-17005-03-en, October 2015


718
30 Alarm Types
30.6 Creating a Multistate Alarm

24. Click Next.


25. In the Alarm message box, enter the message to display when the
monitored variable goes with or is equal to the alarm limits.

26. In the Reset message box, enter the message to display when the alarm is
reset.
27. In the Alarm priority box, enter the priority of the alarm when the monitored
variable triggers the alarm.
28. Select the Same priority check box to let all priorities inherit the value in the
Alarm priority box.
29. In the Reset priority box, enter the priority of the alarm when it is reset.
30. In the Category box, enter the category that the alarm belongs to.
31. Select Flashing alert to make the alarm flash in the Alarms pane and Alarm
Views when it is triggered.
32. Select Audible alert to make the alarm sound when it is triggered.
33. Click Next.
Continued on next page

04-17005-03-en, October 2015 System


719
30 Alarm Types
30.6 Creating a Multistate Alarm

34. Select how the user has to acknowledge the alarm.


Select No when the alarm does not need to be acknowledged.
Select Single when the alarm needs to be acknowledged once, either in
the alarm state or reset state.
Select Extended when the alarm needs to be acknowledged in both the
alarm state and the reset state.

35. In the Cause note group box, select the cause note group that you want to
connect to the alarm.
36. In the Action note group box, select the action note group that you want to
connect to the alarm.
37. In the Checklist box, select the checklist that you want to connect to the
alarm.
38. Select the When acknowledging an alarm: Comment check box to force
the user to add a comment to the alarm before the alarm can be
acknowledged.
Continued on next page

System 04-17005-03-en, October 2015


720
30 Alarm Types
30.6 Creating a Multistate Alarm

39. Select the When acknowledging an alarm: Cause note check box to
force the user to edit the connected cause note before the alarm can be
acknowledged.
40. Select the When acknowledging an alarm: Action note check box to
force the user to edit the connected action note before the alarm can be
acknowledged.
41. Select the When acknowledging an alarm: Checklist check box to force
the user to go through the connected checklist before the alarm can be
acknowledged.
42. Under Required user actions, select the check boxes for Comment,
Cause note, and Action note to specify how the user should respond to
the listed actions.
43. Click Next.

44. Click the Add attachment button to add an attachment to the alarm.

Continued on next page

04-17005-03-en, October 2015 System


721
30 Alarm Types
30.6 Creating a Multistate Alarm

45. In the Select Object dialog box, select the object you want to attach to the
alarm and then click Select.

46. In the Attachment page, in the Display on alarm column, select the check
box to automatically open the attachment when the alarm is triggered.
47. Click Create.

System 04-17005-03-en, October 2015


722
30 Alarm Types
30.7 Configuring a Multistate Alarm

30.7 Configuring a Multistate Alarm


You configure the properties of a multistate alarm to meet the unique needs of your
site.
For more information, see section 30.5 Multistate Alarms on page 715.

To configure a multistate alarm


1. In WorkStation, in the System Tree pane, select the multistate alarm you
want to configure.
2. On the File menu, click Properties.
3. Edit the basic settings:
Property Description

Type Displays the alarm type of the alarm.

Name Displays the name of the alarm.

Description Type to change the description of the


alarm.

04-17005-03-en, October 2015 System


723
30 Alarm Types
30.7 Configuring a Multistate Alarm

4. Edit the alarm trigger properties:


Property Description

Trigger alarm when variable is Select the value that triggers the alarm.

Add row
Click to add another alarm condition that
triggers the alarm.

Remove row
Click to remove an alarm condition.

Montiored variable Enter the path to the variable that is


monitored by the alarm.

Disable alarm Select to disable the alarm, for example,


before deployment.

Alarm state Displays the present state of the alarm.


For more information, see section 29.2
Alarm States on page 675.

Disabled cause Displays the cause for the alarm being


disabled:
Shunt variable means that the
alarm has been disabled by a shunt
variable
User means that the alarm has
been disabled by the user
System means that the alarm has
been disabled by the system

Alarm delay (s) Enter the time, in seconds, the alarm has
to be within the alarm criteria before the
alarm is triggered.

Reset delay (s) Enter the time, in seconds, the alarm has
to be within the reset criteria before the
alarm state is changed from alarm to
reset.

Shunt variable 1 Enter the shunt variable that is used to


enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the
shunt value is inactive. For more
information, see section 31.3 Shunt
Variables on page 815.

Operator Select AND or OR to add logic between


the first and the second shunt variable.
For more information, see section 31.3
Shunt Variables on page 815.

Continued on next page

System 04-17005-03-en, October 2015


724
30 Alarm Types
30.7 Configuring a Multistate Alarm

Continued
Property Description
Shunt variable 2 Enter the second shunt variable that is
used to enable or disable the alarm. For
more information, see section 31.3
Shunt Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the
shunt value is inactive. For more
information, see section 31.3 Shunt
Variables on page 815.

5. Edit the presentation properties:


Property Description

Alarm message Type the message to display when the


alarm is in Alarm state.
For more information, see section 31.6
Alarm Messages on page 818.

Reset message Type the message to display when the


alarm is reset.

Alarm priority Enter the priority level of the alarm.

Reset priority Select to set all priorities to the same


value.

Same priority Select to set all priorities to the same


value.

Category Enter the category that the alarm belongs


to.

Flashing alert Select to make the alarm row flash in the


Alarms pane and Alarm Views when the
alarm is triggered.

Audible alert Select to make the alert audible when the


alarm is triggered.

04-17005-03-en, October 2015 System


725
30 Alarm Types
30.7 Configuring a Multistate Alarm

6. Edit the user action properties:


Property Description

Acknowledgement type Select the type of acknowledgement for


the alarm.

Cause note group Enter the cause note group that is used
by the alarm.

Action note group Enter the action note group that is used
by the alarm.

Checklist Enter the checklist that belongs to the


alarm.

When acknowledging an alarm Select what actions the user has to


perform when acknowledging an alarm.

Required user action Select what actions the user has to


perform when any of the listed events
occur.

7. Edit the attachment properties:


Property Description

Add attachment
Click to add an attachment to the alarm.
For more information, see section 31.21
Alarm Attachments on page 839.

Remove attachment
Click to remove an attachment.

Navigate to
Click to open the attachment that is
selected in the attachment list.

Display on alarm Select to display the attachment when the


alarm is triggered.

8. Click OK.

System 04-17005-03-en, October 2015


726
30 Alarm Types
30.8 Matching Text String Alarms

30.8 Matching Text String Alarms


A matching text string alarm evaluates if the monitored value equals the given text
strings.

Note
The text string is case sensitive and must be written exactly as the monitored
variable text output.
Wildcards cannot be used in the text string.

For example, a script program inside a b3 Continuum system generates text strings
that you want to monitor. You configure the matching text string alarm to trigger an
alarm when a certain string is sent from the device.
Matching text string alarms can be configured using shunt variable and time delay.
For more information, see section 29.3 Alarm Functions on page 676.

04-17005-03-en, October 2015 System


727
30 Alarm Types
30.9 Creating a Matching Text String Alarm

30.9 Creating a Matching Text String Alarm


You create a matching text string alarm to trigger an alarm when a variable is equal
to one or more text strings.

To create a matching text string alarm


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where you want to create the alarm.
2. On the File menu, point to New and then click Alarm.
3. In the object type list, select Matching Text String Alarm.

4. In the Name box, type a name for the alarm.


5. In the Description box, type a description for the alarm.
6. Click Next.
Continued on next page

System 04-17005-03-en, October 2015


728
30 Alarm Types
30.9 Creating a Matching Text String Alarm

7. Under Trigger alarm when variable is, in the equals to box, type the text
string that has to match with the monitored variable text output to trigger the
alarm.

Note
The text string is case sensitive and must be written exactly as
the monitored variable text output.
Wildcards cannot be used in the text string.

8. Click the Add row button to add another text string.


9. In the Monitored variable box, enter the variable that the alarm monitors.
10. In the Disable alarm box, select whether or not to create the alarm in
disabled mode.
11. In the Alarm delay box, enter the time delay before the alarm is triggered.
12. In the Reset delay box, enter the time delay before the alarm is reset.
13. Select Invert to have the alarm enabled when the first shunt variable is active.
14. In the Shunt variable 1 box, enter the binary variable that enables or
disables the alarm.
15. In the Operator list, select AND or OR to add logic between the first shunt
variable and the second shunt variable.
16. Select Invert to have the alarm enabled when the second shunt variable is
active.
17. In the Shunt variable 2 box, enter the binary variable that enables or
disables the alarm
Continued on next page

04-17005-03-en, October 2015 System


729
30 Alarm Types
30.9 Creating a Matching Text String Alarm

18. Click Next.


19. In the Alarm message box, enter the message to display when the
monitored variable goes with or is equal to the alarm limits.

20. In the Reset message box, enter the message to display when the alarm is
reset.
21. In the Alarm priority box, enter the priority of the alarm when the monitored
variable triggers the alarm.
22. Select the Same priority check box to let all priorities inherit the value in the
Alarm priority box.
23. In the Reset priority box, enter the priority of the alarm when it is reset.
24. In the Category box, enter the category that the alarm belongs to.
25. Select Flashing alert to make the alarm flash in the Alarms pane and Alarm
Views when it is triggered.
26. Select Audible alert to make the alarm sound when it is triggered.
27. Click Next.
Continued on next page

System 04-17005-03-en, October 2015


730
30 Alarm Types
30.9 Creating a Matching Text String Alarm

28. Select how the user has to acknowledge the alarm:


Select No when the alarm does not need to be acknowledged.
Select Single when the alarm needs to be acknowledged once, either in
the alarm state or reset state.
Select Extended when the alarm needs to be acknowledged in both the
alarm state and the reset state.

29. In the Cause note group box, select the cause note group that you want to
connect to the alarm.
30. In the Action note group box, select the action note group that you want to
connect to the alarm.
31. In the Checklist box, select the checklist that you want to connect to the
alarm.
32. Select the When acknowledging an alarm: Comment check box to force
the user to add a comment to the alarm before the alarm can be
acknowledged.
Continued on next page

04-17005-03-en, October 2015 System


731
30 Alarm Types
30.9 Creating a Matching Text String Alarm

33. Select the When acknowledging an alarm: Cause note check box to
force the user to edit the connected cause note before the alarm can be
acknowledged.
34. Select the When acknowledging an alarm: Action note check box to
force the user to edit the connected action note before the alarm can be
acknowledged.
35. Select the When acknowledging an alarm: Checklist check box to force
the user to go through the connected checklist before the alarm can be
acknowledged.
36. Under Required user actions, select the check boxes for Comment,
Cause note, and Action note to force the user to act on the listed actions.
37. Click Next.

38. To add an attachment to the alarm, click the Add attachment button .

Continued on next page

System 04-17005-03-en, October 2015


732
30 Alarm Types
30.9 Creating a Matching Text String Alarm

39. In the Select Object dialog box, select the object you want to attach to the
alarm and then click Select.

40. In the Attachment page, in the Display on alarm column, select the check
box to automatically open the attachment when the alarm is triggered.
41. Click Create.

04-17005-03-en, October 2015 System


733
30 Alarm Types
30.10 Configuring a Matching Text String Alarm

30.10 Configuring a Matching Text String


Alarm
You configure the properties of a matching text string alarm to meet the unique
needs of your site.
For more information, see section 30.8 Matching Text String Alarms on page 727.

To configure a matching text string alarm


1. In WorkStation, in the System Tree pane, select the matching text string
alarm you want to configure.
2. On the File menu, click Properties.
3. Edit the basic settings:
Property Description

Type Displays the alarm type of the alarm.

Name Displays the name of the alarm.

Description Type to change the description of the


alarm.

System 04-17005-03-en, October 2015


734
30 Alarm Types
30.10 Configuring a Matching Text String Alarm

4. Edit the alarm trigger properties:


Property Description

Trigger alarm when variable is Select the value that triggers the alarm.

Add row
Click to add another alarm condition that
triggers the alarm.

Remove row
Click to remove an alarm condition.

Montiored variable Enter the path to the variable that is


monitored by the alarm.

Disable alarm Select to disable the alarm, for example,


before deployment.

Alarm state Displays the present state of the alarm.


For more information, see section 29.2
Alarm States on page 675.

Disabled cause Displays the cause for the alarm being


disabled:
Shunt variable means that the
alarm has been disabled by a shunt
variable
User means that the alarm has
been disabled by the user
System means that the alarm has
been disabled by the system

Alarm delay (s) Enter the time, in seconds, the alarm has
to be within the alarm criteria before the
alarm is triggered.

Reset delay (s) Enter the time, in seconds, the alarm has
to be within the reset criteria before the
alarm state is changed from alarm to
reset.

Shunt variable 1 Enter the shunt variable that is used to


enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the
shunt value is inactive. For more
information, see section 31.3 Shunt
Variables on page 815.

Operator Select AND or OR to add logic between


the first and the second shunt variable.
For more information, see section 31.3
Shunt Variables on page 815.

Continued on next page

04-17005-03-en, October 2015 System


735
30 Alarm Types
30.10 Configuring a Matching Text String Alarm

Continued
Property Description
Shunt variable 2 Enter the second shunt variable that is
used to enable or disable the alarm. For
more information, see section 31.3
Shunt Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the
shunt value is inactive. For more
information, see section 31.3 Shunt
Variables on page 815.

5. Edit the presentation properties:


Property Description

Alarm message Type the message to display when the


alarm is in Alarm state.
For more information, see section 31.6
Alarm Messages on page 818.

Reset message Type the message to display when the


alarm is reset.

Alarm priority Enter the priority level of the alarm.

Reset priority Select to set all priorities to the same


value.

Same priority Select to set all priorities to the same


value.

Category Enter the category that the alarm belongs


to.

Flashing alert Select to make the alarm row flash in the


Alarms pane and Alarm Views when the
alarm is triggered.

Audible alert Select to make the alert audible when the


alarm is triggered.

System 04-17005-03-en, October 2015


736
30 Alarm Types
30.10 Configuring a Matching Text String Alarm

6. Edit the user action properties:


Property Description

Acknowledgement type Select the type of acknowledgement for


the alarm.

Cause note group Enter the cause note group that is used
by the alarm.

Action note group Enter the action note group that is used
by the alarm.

Checklist Enter the checklist that belongs to the


alarm.

When acknowledging an alarm Select what actions the user has to


perform when acknowledging an alarm.

Required user action Select what actions the user has to


perform when any of the listed events
occur.

7. Edit the attachment properties:


Property Description

Add attachment
Click to add an attachment to the alarm.
For more information, see section 31.21
Alarm Attachments on page 839.

Remove attachment
Click to remove an attachment.

Navigate to
Click to open the attachment that is
selected in the attachment list.

Display on alarm Select to display the attachment when the


alarm is triggered.

8. Click OK.

04-17005-03-en, October 2015 System


737
30 Alarm Types
30.11 Variable Status Alarms

30.11 Variable Status Alarms


The variable status alarm monitors the status of a variable. The alarm is triggered
when the value of the monitored variable is either forced, overridden or offline. If you
configure the alarm to trigger on all statuses, the alarm is triggered immediately
when the variable changes to one of the statuses.
The override status indicates that the value of a variable is adjusted by the I/O
hardware, and is not the measured value. For more information, see the Output
Override Status topic on WebHelp.
The force status indicates that the value of a variable is adjusted by the software,
and is not the measured value. For more information, see the Force and Unforce
Buttons topic on WebHelp.
The offline status indicates that the status of the monitored variable is offline.
For example, you can use the variable status alarm to get a notification when a
technician overrides the variable on an I/O module.
You can configure the variable status alarms using shunt variable and time delay.
For more information, see section 29.3 Alarm Functions on page 676.

Monitored Value in Alarms Pane or Alarm View


The Value at change column, in the Alarms pane or Alarm View, displays the value
of the monitored variable when the alarm changed state. For a variable status
alarm, the Value at change column displays the status of the monitored variable:
(Blank: Neither forced, overridden, nor offline)
Forced
Overridden
Offline
Any combination of forced, overridden, and offline

Figure: The text in the Value at change column shows that the status of the variable is
forced

System 04-17005-03-en, October 2015


738
30 Alarm Types
30.12 Creating a Variable Status Alarm

30.12 Creating a Variable Status Alarm


You create a variable status alarm to trigger an alarm when the status of a variable
is changed to override or force.

To create a variable status alarm


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where you want to create the alarm.
2. On the File menu, point to New and then click Alarm.
3. In the object type list, select Variable Status Alarm.

4. In the Name box, type a name for the alarm.


5. In the Description box, type a description for the alarm.
6. Click Next.
Continued on next page

04-17005-03-en, October 2015 System


739
30 Alarm Types
30.12 Creating a Variable Status Alarm

7. Select Forced to trigger the alarm when the monitored variable status
changes to force.

8. Select Overridden to trigger the alarm when the monitored variable status
changes to override.
9. Select Offline to trigger the alarm when the device with the monitored
variable is offline.
10. In the Monitored variable box, enter the variable that the alarm monitors.
11. In the Disable alarm box, select whether or not to create the alarm in
disabled mode.
12. In the Alarm delay box, enter the time delay before the alarm is triggered.
13. In the Reset delay box, enter the time delay before the alarm is reset.
14. Select Invert to have the alarm enabled when the first shunt variable is active.
15. In the Shunt variable 1 box, enter the binary variable that enables or
disables the alarm.
16. In the Operator list, select AND or OR to add logic between the first shunt
variable and the second shunt variable.
17. Select Invert to have the alarm enabled when the second shunt variable is
active.
18. In the Shunt variable 2 box, enter the binary variable that enables or
disables the alarm.
19. Click Next.
Continued on next page

System 04-17005-03-en, October 2015


740
30 Alarm Types
30.12 Creating a Variable Status Alarm

20. In the Alarm message box, enter the message to display when the
monitored variable goes with or is equal to the alarm limits.

21. In the Reset message box, enter the message to display when the alarm is
reset.
22. In the Alarm priority box, enter the priority of the alarm when the monitored
variable triggers the alarm.
23. Select the Same priority check box to let all priorities inherit the value in the
Alarm priority box.
24. In the Reset priority box, enter the priority of the alarm when it is reset.
25. In the Category box, enter the category that the alarm belongs to.
26. Select Flashing alert to make the alarm flash in the Alarms pane and Alarm
Views when it is triggered.
27. Select Audible alert to make the alarm sound when it is triggered.
28. Click Next.
Continued on next page

04-17005-03-en, October 2015 System


741
30 Alarm Types
30.12 Creating a Variable Status Alarm

29. Select how the user has to acknowledge the alarm.


Select No when the alarm does not need to be acknowledged.
Select Single when the alarm needs to be acknowledged once, either in
the alarm state or reset state.
Select Extended when the alarm needs to be acknowledged in both the
alarm state and the reset state.

30. In the Cause note group box, select the cause note group that you want to
connect to the alarm.
31. In the Action note group box, select the action note group that you want to
connect to the alarm.
32. In the Checklist box, select the checklist that you want to connect to the
alarm.
33. Select the When acknowledging an alarm: Comment check box to force
the user to add a comment to the alarm before the alarm can be
acknowledged.
Continued on next page

System 04-17005-03-en, October 2015


742
30 Alarm Types
30.12 Creating a Variable Status Alarm

34. Select the When acknowledging an alarm: Cause note check box to
force the user to edit the connected cause note before the alarm can be
acknowledged.
35. Select the When acknowledging an alarm: Action note check box to
force the user to edit the connected action note before the alarm can be
acknowledged.
36. Select the When acknowledging an alarm: Checklist check box to force
the user to go through the connected checklist before the alarm can be
acknowledged.
37. Under Required user actions, select the check boxes for Comment,
Cause note, and Action note to force the user to act on the listed actions.
38. Click Next.

39. Click the Add attachment button to add an attachment to the alarm.

Continued on next page

04-17005-03-en, October 2015 System


743
30 Alarm Types
30.12 Creating a Variable Status Alarm

40. In the Select Object dialog box, select the object you want to attach to the
alarm and then click Select.

41. In the Attachment page, in the Display on alarm column, select the check
box to automatically open the attachment when the alarm is triggered.
42. Click Create.

System 04-17005-03-en, October 2015


744
30 Alarm Types
30.13 Configuring a Variable Status Alarm

30.13 Configuring a Variable Status Alarm


You configure the properties of a variable status alarm to meet the unique needs of
your site.
For more information, see section 30.11 Variable Status Alarms on page 738.

To configure a variable status alarm


1. In WorkStation, in the System Tree pane, select the variable status alarm
you want to configure.
2. On the File menu, click Properties.
3. Edit the basic settings:
Property Description

Type Displays the alarm type of the alarm.

Name Displays the name of the alarm.

Description Type to change the description of the


alarm.

04-17005-03-en, October 2015 System


745
30 Alarm Types
30.13 Configuring a Variable Status Alarm

4. Edit the alarm trigger properties:


Property Description

Trigger when variable is Select the statuses of the monitored


variable that trigger the alarm.
Forced means that the alarm is
triggered when the monitored
variable status is forced. For more
information, see the Force and
Unforce Buttons topic on WebHelp.
Overridden means that the alarm
is triggered when the monitored
variable status is overridden. For
more information, see the Output
Override Status topic on WebHelp.
Offline means that the alarm is
triggered when the monitored
variable is off line.

Montiored variable Enter the path to the variable that is


monitored by the alarm.

Disable alarm Select to disable the alarm, for example,


before deployment.

Alarm state Displays the present state of the alarm.


For more information, see section 29.2
Alarm States on page 675.

Disabled cause Displays the cause for the alarm being


disabled:
Shunt variable means that the
alarm has been disabled by a shunt
variable
User means that the alarm has
been disabled by the user
System means that the alarm has
been disabled by the system

Alarm delay (s) Enter the time, in seconds, the alarm has
to be within the reset criteria before the
alarm state is changed from alarm to
reset.

Reset delay (s) Enter the time, in seconds, the alarm has
to be within the alarm criteria before the
alarm is triggered.

Shunt variable 1 Enter the shunt variable that is used to


enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the
shunt value is inactive. For more
information, see section 31.3 Shunt
Continued on next page

System 04-17005-03-en, October 2015


746
30 Alarm Types
30.13 Configuring a Variable Status Alarm

Continued
Property Description
Variables on page 815.

Operator Select AND or OR to add logic between


the first and the second shunt variable.
For more information, see section 31.3
Shunt Variables on page 815.

Shunt variable 2 Enter the second shunt variable that is


used to enable or disable the alarm. For
more information, see section 31.3
Shunt Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the
shunt value is inactive. For more
information, see section 31.3 Shunt
Variables on page 815.

5. Edit the presentation properties:


Property Description

Alarm message Type the message to display when the


alarm is in Alarm state.
For more information, see section 31.6
Alarm Messages on page 818.

Reset message Type the message to display when the


alarm is reset.

Alarm priority Enter the priority level of the alarm.

Reset priority Select to set all priorities to the same


value.

Same priority Select to set all priorities to the same


value.

Category Enter the category that the alarm belongs


to.

Flashing alert Select to make the alarm row flash in the


Alarms pane and Alarm Views when the
alarm is triggered.

Audible alert Select to make the alert audible when the


alarm is triggered.

04-17005-03-en, October 2015 System


747
30 Alarm Types
30.13 Configuring a Variable Status Alarm

6. Edit the user action properties:


Property Description

Acknowledgement type Select the type of acknowledgement for


the alarm.

Cause note group Enter the cause note group that is used
by the alarm.

Action note group Enter the action note group that is used
by the alarm.

Checklist Enter the checklist that belongs to the


alarm.

When acknowledging an alarm Select what actions the user has to


perform when acknowledging an alarm.

Required user action Select what actions the user has to


perform when any of the listed events
occur.

7. Edit the attachement properties:


Property Description

Add attachment
Click to add an attachment to the alarm.
For more information, see section 31.21
Alarm Attachments on page 839.

Remove attachment
Click to remove an attachment.

Navigate to
Click to open the attachment that is
selected in the attachment list.

Display on alarm Select to display the attachment when the


alarm is triggered.

8. Click OK.

System 04-17005-03-en, October 2015


748
30 Alarm Types
30.14 Out of Range Alarms

30.14 Out of Range Alarms


When setting up an out of range alarm, you configure the normal range of the
monitored variable. If the variable goes below the lower limit or above the upper limit
of the normal range, the alarm is triggered.

Figure: Out of range alarm triggers an alarm when the monitored variable goes outside the
configured range.
For example, you set up an out of range alarm that monitors the temperature in a
server room. The alarm is triggered when the temperature goes outside the range of
20 C to 25 C (68 F to 77 F).
You can configure out of range alarms using shunt variable, time delay, and
deadband. For more information, see section 29.3 Alarm Functions on page 676.

04-17005-03-en, October 2015 System


749
30 Alarm Types
30.15 Creating an Out of Range Alarm

30.15 Creating an Out of Range Alarm


You create an out of range alarm to trigger an alarm when a variable, such as a
temperature, is not within its specified range.
For more information, see section 30.14 Out of Range Alarms on page 749.

To create an out of range alarm


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where you want to create the alarm.
2. On the File menu, point to New and then click Alarm.
3. In the object type list, select Out of Range Alarm.

4. In the Name box, type a name for the alarm.


5. In the Description box, type a description for the alarm.
6. Click Next.
Continued on next page

System 04-17005-03-en, October 2015


750
30 Alarm Types
30.15 Creating an Out of Range Alarm

7. In the Upper limit box, enter an upper limit for the alarm.

8. In the Lower limit box, enter a lower limit for the alarm.
9. In the Deadband box, enter a deadband for the alarm.
10. In the Monitored variable box, enter the variable that the alarm monitors.

11. Click the Set unit button to enter or change the unit of measure for the
alarm limits and deadband.

Note
If the monitored value has a unit of measurement defined, the
alarm limits and deadband are assigned that unit by default.

Continued on next page

04-17005-03-en, October 2015 System


751
30 Alarm Types
30.15 Creating an Out of Range Alarm

12. Select the unit of measure.

13. In the Prefix box, select a prefix for the unit.


14. Click Select.
15. In the Disable alarm box, select whether or not to create the alarm in
disabled mode.
16. Under Time Delay and Shunt Variables, in the Alarm delay box, enter
the time delay.
17. In the Reset delay box, enter the time delay.
18. Select Invert to have the alarm enabled when the first shunt variable is active.
19. In the Shunt variable 1 box, enter the digital variable that enables or
disables the alarm.
20. In the Operator list, select AND or OR to add logic between the first shunt
variable and the second shunt variable.
21. Select Invert to have the alarm enabled when the second shunt variable is
active.
Continued on next page

System 04-17005-03-en, October 2015


752
30 Alarm Types
30.15 Creating an Out of Range Alarm

22. In the Shunt variable 2 box, enter the digital variable that enables or
disables the alarm.

23. Click Next.


Continued on next page

04-17005-03-en, October 2015 System


753
30 Alarm Types
30.15 Creating an Out of Range Alarm

24. In the Messages area, in the Above upper limit message box, type the
message to display when the alarm exceeds the upper limit.

25. In the Below lower limit message box, type the message to display when
the alarm falls below the lower limit.
26. In the Reset message box, type the message to display when the alarm is
reset.
27. In the Priorities area, in the Above upper limit priority box, enter the
priority for the upper limit of the alarm state.
28. Select the Same priority check box to let all priorities inherit the value in the
Above upper limit priority box.
29. In the Below lower limit priority box, enter the priority for the lower limit of
the alarm state.
30. In the Reset priority box, enter the priority for the reset state.
31. Under Category and Alerts, in the Category box, enter a category for the
alarm.
32. Select the Flashing alert check box to make the alarm flash in the Alarms
pane and Alarm Views when it is triggered.
Continued on next page

System 04-17005-03-en, October 2015


754
30 Alarm Types
30.15 Creating an Out of Range Alarm

33. Select the Audible alert check box to make the alarm sound when it is
triggered.

34. Click Next.


Continued on next page

04-17005-03-en, October 2015 System


755
30 Alarm Types
30.15 Creating an Out of Range Alarm

35. Select the type of acknowledgement to use:


Click No when the alarm does not need to be acknowledged.
Click Single when the alarm needs to be acknowledged in the alarm
state.
Click Extended when the alarm needs to be acknowledged in the alarm
state and the reset state.

36. In the Cause note group box, enter the cause note group that you want to
connect to the alarm.
37. In the Action note group box, enter the action note group that you want to
connect to the alarm.
38. In the Checklist box, enter the checklist that you want to connect to the
alarm.
39. Select the When acknowledging an alarm: Comment check box to force
the user to add a comment to the alarm before the alarm can be
acknowledged.
40. Select the When acknowledging an alarm: Cause note check box to
force the user to edit the connected cause note before the alarm can be
acknowledged.
41. Select the When acknowledging an alarm: Action note check box to
force the user to edit the connected action note before the alarm can be
acknowledged.
42. Select the When acknowledging an alarm: Checklist check box to force
the user to go through the connected checklist before the alarm can be
acknowledged.
Continued on next page

System 04-17005-03-en, October 2015


756
30 Alarm Types
30.15 Creating an Out of Range Alarm

43. Under Required User Actions, select the check boxes for Comment,
Cause note, and Action note to force the user to act on the listed actions.

44. Click Next.


Continued on next page

04-17005-03-en, October 2015 System


757
30 Alarm Types
30.15 Creating an Out of Range Alarm

45. Click the Add attachment button to add an attachment.

46. In the Select Object dialog box, select the object you want to attach to the
alarm.
47. Click Select.
48. On the Attachment page, in the Display on alarm column, select the
check box to automatically open the attachment when the alarm is triggered.

49. Click Create.

System 04-17005-03-en, October 2015


758
30 Alarm Types
30.16 Configuring an Out of Range Alarm

30.16 Configuring an Out of Range Alarm


You configure the properties of an out of range alarm to meet the unique needs of
your site.
For more information, see section 30.14 Out of Range Alarms on page 749.

To configure an out of range alarm


1. In WorkStation, in the System Tree pane, select the out of range alarm you
want to configure.
2. On the File menu, click Properties.
3. Edit the basic settings:
Property Description

Type Displays the alarm type of the alarm.

Name Displays the name of the alarm.

Description Type to change the description of the


alarm.

04-17005-03-en, October 2015 System


759
30 Alarm Types
30.16 Configuring an Out of Range Alarm

4. Edit the alarm trigger properties:


Property Description

Upper limit Enter the highest value the monitored


variable can increase to before the alarm
is triggered.

Lower limit Enter the lowest value the monitored


variable can decrease to before the alarm
is triggered.

Deadband Enter the range the monitored variable


has to pass within the normal range
before the alarm is reset.

Monitored variable Enter the path to the variable that is


monitored by the alarm.

Disable alarm Select to disable the alarm, for example,


before deployment.

Alarm state Displays the present state of the alarm.


For more information, see section 29.2
Alarm States on page 675.

Disabled cause Displays the cause for the alarm being


disabled:
Shunt variable means that the
alarm has been disabled by a shunt
variable
User means that the alarm has
been disabled by the user
System means that the alarm has
been disabled by the system

Alarm delay (s) Enter the time, in seconds, the alarm has
to be within the alarm criteria before the
alarm is triggered.

Reset delay (s) Enter the time, in seconds, the alarm has
to be within the reset criteria before the
alarm state is changed from alarm to
reset.

Shunt variable 1 Enter the shunt variable that is used to


enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the
shunt value is inactive. For more
information, see section 31.3 Shunt
Variables on page 815.

Operator Select AND or OR to add logic between


the first and the second shunt variable.
For more information, see section 31.3
Continued on next page

System 04-17005-03-en, October 2015


760
30 Alarm Types
30.16 Configuring an Out of Range Alarm

Continued
Property Description
Shunt Variables on page 815.

Shunt variable 2 Enter the second shunt variable that is


used to enable or disable the alarm. For
more information, see section 31.3
Shunt Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the
shunt value is inactive. For more
information, see section 31.3 Shunt
Variables on page 815.

5. Edit the presentation properties:


Property Description

Above upper limit message Type the message to display when the
variable exceeds the upper limit of the
alarm.

Below lower limit message Type the message to display when the
variable falls below the lower limit.

Reset message Type the message to display when the


alarm is reset.

Above upper limit priority Enter the priority level of the alarm when
the variable exceeds the upper limit.

Below lower limit priority Enter the priority level of the alarm when
the variable falls below the lower limit.

Reset priority Enter the priority level of the alarm when it


is reset.

Same priority Select to set all priorities to the same


value.

Category Enter the category that the alarm belongs


to.

Flashing alert Select to make the alarm row flash in the


Alarms pane and Alarm Views when the
alarm is triggered.

Audible alert Select to make the alert audible when the


alarm is triggered.

04-17005-03-en, October 2015 System


761
30 Alarm Types
30.16 Configuring an Out of Range Alarm

6. Edit the user action properties:


Property Description

Acknowledgement type Select the type of acknowledgement for


the alarm.

Cause note group Enter the cause note group that is used
by the alarm.

Action note group Enter the action note group that is used
by the alarm.

Checklist Enter the checklist that belongs to the


alarm.

When acknowledging an alarm Select what actions the user has to


perform when acknowledging an alarm.

Required user action Select what actions the user has to


perform when any of the listed events
occur.

7. Edit the attachment properties:


Property Description

Add attachment
Click to add an attachment to the alarm.
For more information, see section 31.21
Alarm Attachments on page 839.

Remove attachment
Click to remove an attachment.

Navigate to
Click to open the attachment that is
selected in the attachment list.

Display on alarm Select to display the attachment when the


alarm is triggered.

8. Click OK.

System 04-17005-03-en, October 2015


762
30 Alarm Types
30.17 Out of Reference Range Alarms

30.17 Out of Reference Range Alarms


The out of reference range alarm monitors variable movements comparing to a
reference variable. By setting an upper deviation limit and lower deviation limit, you
configure the tolerance the monitored variable can vary from the reference variable
before the alarm is triggered. The upper alarm limit of the monitored variable is
equal to the reference point current value plus the upper deviation limit. The lower
alarm limit of the monitored variable is equal to the reference point current value
minus the lower deviation limit.

Note
An out of range alarm with upper deviation limit, lower deviation limit, and
deadband set to zero must meticulously follow the reference variable to not
trigger the alarm.

Figure: Out of reference alarm triggers an alarm when the monitored variable goes outside
the upper or lower deviation limit of the reference variable.
For example, you have a reference variable that is designed to follow the optimal
room temperature in a office. By connecting the reference variable and the variable
from a thermistor, placed in the office, to an out of reference range alarm, you can
set up the alarm to trigger when the temperature differs more than 5 C (41F) from
the reference variable.
You can configure out of reference range alarms using shunt variable, time delay,
and deadband. For more information, see section 29.3 Alarm Functions on page
676.

04-17005-03-en, October 2015 System


763
30 Alarm Types
30.18 Creating an Out of Reference Range Alarm

30.18 Creating an Out of Reference Range


Alarm
You create an out of reference range alarm to trigger an alarm when a variable,
such as a temperature, differs from a reference value.

To create an out of reference range alarm


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where you want to create the alarm.
2. On the File menu, point to New and then click Alarm.
3. In the object type list, select Out of Reference Range Alarm.

4. In the Name box, type a name for the alarm.


5. In the Description box, type a description for the alarm.
6. Click Next.
Continued on next page

System 04-17005-03-en, October 2015


764
30 Alarm Types
30.18 Creating an Out of Reference Range Alarm

7. In the Upper deviation limit box, enter the upper limit the monitored
variable is allowed to deviate from the reference variable before the alarm is
triggered.

8. In the Lower deviation limit box, enter the lower limit the monitored variable
is allowed to deviate from the reference variable before the alarm is triggered.
9. In the Deadband box, enter the range the monitored variable has to pass
within the normal range before the alarm is reset.
10. In the Monitored variable box, enter the variable that the alarm monitors.

11. Click the Set unit button to select the unit of measure for the alarm limits
and deadband.

Note
If the monitored value has a unit of measurement defined, the
alarm limits and deadband are assigned that unit by default.

Continued on next page

04-17005-03-en, October 2015 System


765
30 Alarm Types
30.18 Creating an Out of Reference Range Alarm

12. Select the unit of measure.

13. In the Prefix box, select a prefix for the unit.


14. Click Select.
15. In the Reference variable box, enter the reference variable to compare with
the monitored variable.
16. In the Disable alarm box, select whether or not to create the alarm in
disabled mode.
17. Under Time delay and shunt variable, in the Alarm delay box, enter the
time delay before the alarm is triggered.
18. In the Reset delay box, enter the time delay before the alarm is reset.
19. Select Invert to have the alarm enabled when the first shunt variable is active.
Continued on next page

System 04-17005-03-en, October 2015


766
30 Alarm Types
30.18 Creating an Out of Reference Range Alarm

20. In the Shunt variable 1 box, enter the digital variable that enables or
disables the alarm.

21. In the Operator list, select AND or OR to add logic between the first shunt
variable and the second shunt variable.
22. Select Invert to have the alarm enabled when the second shunt variable is
active.
23. In the Shunt variable 2 box, enter the digital variable that enables or
disables the alarm.
24. Click Next.
Continued on next page

04-17005-03-en, October 2015 System


767
30 Alarm Types
30.18 Creating an Out of Reference Range Alarm

25. In the Messages area, in the Above upper limit message box, type the
message to display when the monitored variable exceeds the upper alarm
limit.

26. In the Below lower limit message box, type the message to display when
the monitored variable falls below the lower alarm limit.
27. In the Reset message box, type the message to display when the alarm is
reset.
28. In the Priorities area, in the Above upper limit priority box, enter the
priority of the alarm when the monitored variable exceeds the upper alarm
limit.
29. Select the Same priority check box to let all priorities inherit the value in the
Above upper limit priority box.
30. In the Below lower limit priority box, enter the priority of the alarm when
the monitored variable falls bellow the lower alarm limit.
31. In the Reset priority box, enter the priority for alarm when it is reset.
32. Under Category and Alerts, in the Category box, enter the category that
the alarm belongs to.
33. Select Flashing alert to make the alarm flash in the Alarms pane and Alarm
Views when it is triggered.
Continued on next page

System 04-17005-03-en, October 2015


768
30 Alarm Types
30.18 Creating an Out of Reference Range Alarm

34. Select Audible alert to make a sound when the alarm is triggered.

35. Click Next.


Continued on next page

04-17005-03-en, October 2015 System


769
30 Alarm Types
30.18 Creating an Out of Reference Range Alarm

36. Select the type of acknowledgement to use:


Click No when the alarm does not need to be acknowledged.
Click Single when the alarm needs to be acknowledged once, either in
the alarm state or reset state.
Click Extended when the alarm needs to be acknowledged in both the
alarm state and the reset state.

37. In the Cause note group box, enter the cause note group that you want to
connect to the alarm.
38. In the Action note group box, enter the action note group that you want to
connect to the alarm.
39. In the Checklist box, enter the checklist that you want to connect to the
alarm.
40. Select the When acknowledging an alarm: Comment check box to force
the user to add a comment to the alarm before the alarm can be
acknowledged.
41. Select the When acknowledging an alarm: Cause note check box to
force the user to edit the connected cause note before the alarm can be
acknowledged.
42. Select the When acknowledging an alarm: Action note check box to
force the user to edit the connected action note before the alarm can be
acknowledged.
43. Select the When acknowledging an alarm: Checklist check box to force
the user to go through the connected checklist before the alarm can be
acknowledged.
Continued on next page

System 04-17005-03-en, October 2015


770
30 Alarm Types
30.18 Creating an Out of Reference Range Alarm

44. Under Required user actions, select the check boxes for Comment,
Cause note, and Action note to force the user to act on the listed actions.

45. Click Next.


Continued on next page

04-17005-03-en, October 2015 System


771
30 Alarm Types
30.18 Creating an Out of Reference Range Alarm

46. Click the Add attachment button to add an attachment to the alarm.

47. In the Select Object dialog box, select the object you want to attach to the
alarm and then click Select.
48. On the Attachment page, in the Display on alarm column, select the
check box to automatically open the attachment when the alarm is triggered.
49. Click Create.

System 04-17005-03-en, October 2015


772
30 Alarm Types
30.19 Configuring an Out of Reference Range Alarm

30.19 Configuring an Out of Reference Range


Alarm
You configure the properties of a out of reference range alarm to meet the unique
needs of your site.
For more information, see section 30.17 Out of Reference Range Alarms on page
763.

To configure an out of reference range alarm


1. In WorkStation, in the System Tree pane, select the out of reference range
alarm you want to configure.
2. On the File menu, click Properties.
3. Edit the basic settings:
Property Description

Type Displays the alarm type of the alarm.

Name Displays the name of the alarm.

Description Type to change the description of the


alarm.

04-17005-03-en, October 2015 System


773
30 Alarm Types
30.19 Configuring an Out of Reference Range Alarm

4. Edit the alarm trigger properties:


Property Description

Upper limit Enter the highest value the monitored


variable can increase to before the alarm
is triggered.

Lower limit Enter the lowest value the monitored


variable can decrease to before the alarm
is triggered.

Deadband Enter the range the monitored variable


has to pass within the normal range
before the alarm is reset.

Monitored variable Enter the path to the variable that is


monitored by the alarm.

Reference variable Enter the reference variable that is


compared with the monitored variable.

Disable alarm Select to disable the alarm, for example,


before deployment.

Alarm state Displays the present state of the alarm.


For more information, see section 29.2
Alarm States on page 675.

Disabled cause Displays the cause for the alarm being


disabled:
Shunt variable means that the
alarm has been disabled by a shunt
variable
User means that the alarm has
been disabled by the user
System means that the alarm has
been disabled by the system

Alarm delay (s) Enter the time, in seconds, the alarm has
to be within the alarm criteria before the
alarm is triggered.

Reset delay (s) Enter the time, in seconds, the alarm has
to be within the reset criteria before the
alarm state is changed from alarm to
reset.

Shunt variable 1 Enter the shunt variable that is used to


enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the
shunt value is inactive. For more
information, see section 31.3 Shunt
Variables on page 815.

Continued on next page

System 04-17005-03-en, October 2015


774
30 Alarm Types
30.19 Configuring an Out of Reference Range Alarm

Continued
Property Description
Operator Select AND or OR to add logic between
the first and the second shunt variable.
For more information, see section 31.3
Shunt Variables on page 815.

Shunt variable 2 Enter the second shunt variable that is


used to enable or disable the alarm. For
more information, see section 31.3
Shunt Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the
shunt value is inactive. For more
information, see section 31.3 Shunt
Variables on page 815.

5. Edit the presentation properties:


Property Description

Above upper limit message Type the message to display when the
variable exceeds the upper limit of the
alarm.

Below lower limit message Type the message to display when the
variable falls below the lower limit.

Reset message Type the message to display when the


alarm is reset.

Above upper limit priority Enter the priority level of the alarm when
the variable exceeds the upper limit.

Below lower limit priority Enter the priority level of the alarm when
the variable falls below the lower limit.

Reset priority Enter the priority level of the alarm when it


is reset.

Same priority Select to set all priorities to the same


value.

Category Enter the category that the alarm belongs


to.

Flashing alert Select to make the alarm row flash in the


Alarms pane and Alarm Views when the
alarm is triggered.

Audible alert Select to make the alert audible when the


alarm is triggered.

04-17005-03-en, October 2015 System


775
30 Alarm Types
30.19 Configuring an Out of Reference Range Alarm

6. Edit the user action properties:


Property Description

Acknowledgement type Select the type of acknowledgement for


the alarm.

Cause note group Enter the cause note group that is used
by the alarm.

Action note group Enter the action note group that is used
by the alarm.

Checklist Enter the checklist that belongs to the


alarm.

When acknowledging an alarm Select what actions the user has to


perform when acknowledging an alarm.

Required user action Select what actions the user has to


perform when any of the listed events
occur.

7. Edit the attachment properties:


Property Description

Add attachment
Click to add an attachment to the alarm.
For more information, see section 31.21
Alarm Attachments on page 839.

Remove attachment
Click to remove an attachment.

Navigate to
Click to open the attachment that is
selected in the attachment list.

Display on alarm Select to display the attachment when the


alarm is triggered.

8. Click OK.

System 04-17005-03-en, October 2015


776
30 Alarm Types
30.20 Sum Alarms

30.20 Sum Alarms


A sum alarm can be seen as a collection of alarms that have one or several
common denominators. The conditions you use to filter out which alarms the sum
alarm monitors are the same conditions you use to filter the Alarms pane or an
Alarm View. You can use wildcards when setting up filter conditions. For more
information, see section 34.8 Filter Condition Wildcards on page 1102.
For example, when an alarm is triggered you want to light a red operating lamp.
Instead of connecting all alarms in the system to the indication lamp, you create a
sum alarm and connect it to the indication lamp. You reduce the amount of alarms
by configuring the sum alarm to only trigger when alarms with a certain priority and
category are triggered.

04-17005-03-en, October 2015 System


777
30 Alarm Types
30.21 Creating a Sum Alarm

30.21 Creating a Sum Alarm


You create a sum alarm to monitor alarms with one or more common
denominators. The alarm is triggered when one of the monitored alarms changes its
state to alarm state.

To create a sum alarm


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where you want to create the alarm.
2. On the File menu, point to New and then click Alarm.
3. In the object type list, select Sum Alarm.

4. In the Name box, type a name for the alarm.


5. In the Description box, type a description for the alarm.
6. Click Next.
Continued on next page

System 04-17005-03-en, October 2015


778
30 Alarm Types
30.21 Creating a Sum Alarm

7. Click the Add condition button to add a denominators that sort out the
alarms to monitor.

8. Enter the necessary information to specify the option that sorts out the alarms
to monitor.
9. In the Disable alarm box, select whether or not to create the alarm in
disabled mode.
10. In the Alarm delay box, enter the time delay before the alarm is triggered.
11. In the Reset delay box, enter the time delay before the alarm is reset.
12. Select Invert to have the alarm enabled when the first shunt variable is active.
13. In the Shunt variable 1 box, enter the binary variable that enables or
disables the alarm.
14. In the Operator list, select AND or OR to add logic between the first shunt
variable and the second shunt variable.
15. Select Invert to have the alarm enabled when the second shunt variable is
active.
16. In the Shunt variable 2 box, enter the binary variable that enables or
disables the alarm.
17. Click Next.
Continued on next page

04-17005-03-en, October 2015 System


779
30 Alarm Types
30.21 Creating a Sum Alarm

18. In the Alarm message box, enter the message to display when the
monitored variable goes with or is equal to the alarm limits.

19. In the Reset message box, enter the message to display when the alarm is
reset.
20. In the Alarm priority box, enter the priority of the alarm when the monitored
variable triggers the alarm.
21. Select the Same priority check box to let all priorities inherit the value in the
Alarm priority box.
22. In the Reset priority box, enter the priority of the alarm when it is reset.
23. In the Category box, enter the category that the alarm belongs to.
24. Select Flashing alert to make the alarm flash in the Alarms pane and Alarm
Views when it is triggered.
25. Select Audible alert to make the alarm sound when it is triggered.
26. Click Next.
Continued on next page

System 04-17005-03-en, October 2015


780
30 Alarm Types
30.21 Creating a Sum Alarm

27. Select how the user has to acknowledge the alarm.


Select No when the alarm does not need to be acknowledged.
Select Single when the alarm needs to be acknowledged once, either in
the alarm state or reset state.
Select Extended when the alarm needs to be acknowledged in both the
alarm state and the reset state.

28. In the Cause note group box, select the cause note group that you want to
connect to the alarm.
29. In the Action note group box, select the action note group that you want to
connect to the alarm.
30. In the Checklist box, select the checklist that you want to connect to the
alarm.
31. Select the When acknowledging an alarm: Comment check box to force
the user to add a comment to the alarm before the alarm can be
acknowledged.
Continued on next page

04-17005-03-en, October 2015 System


781
30 Alarm Types
30.21 Creating a Sum Alarm

32. Select the When acknowledging an alarm: Cause note check box to
force the user to edit the connected cause note before the alarm can be
acknowledged.
33. Select the When acknowledging an alarm: Action note check box to
force the user to edit the connected action note before the alarm can be
acknowledged.
34. Select the When acknowledging an alarm: Checklist check box to force
the user to go through the connected checklist before the alarm can be
acknowledged.
35. Under Required user actions, select the check boxes for Comment,
Cause note, and Action note to force the user to act on the listed actions.
36. Click Next.

37. Click the Add attachment button to add an attachment to the alarm.

Continued on next page

System 04-17005-03-en, October 2015


782
30 Alarm Types
30.21 Creating a Sum Alarm

38. In the Select Object dialog box, select the object you want to attach to the
alarm and then click Select.

39. In the Attachment page, in the Display on alarm column, select the check
box to automatically open the attachment when the alarm is triggered.
40. Click Create.

04-17005-03-en, October 2015 System


783
30 Alarm Types
30.22 Configuring a Sum Alarm

30.22 Configuring a Sum Alarm


You configure the properties of a sum alarm to meet the unique needs of your site.
For more information, see section 30.20 Sum Alarms on page 777.

To configure a sum alarm


1. In WorkStation, in the System Tree pane, select the sum alarm you want to
configure.
2. On the File menu, click Properties.
3. Edit the basic settings:
Property Description

Type Displays the alarm type of the alarm.

Name Displays the name of the alarm.

Description Type to change the description of the


alarm.

System 04-17005-03-en, October 2015


784
30 Alarm Types
30.22 Configuring a Sum Alarm

4. Edit the alarm trigger properties:


Property Description

Add condition
Select the alarm filter conditions for the
alarms you want to include.

Remove condition
Remove the alarm filter conditions for the
alarms you want exclude.

Add row
Click to add an additional row with the
same condition.

Remove row
Click to remove a condition row.

Clear all
Click to clear the selected conditions.

Disable alarm Select to disable the alarm, for example,


before deployment.

Alarm state Displays the present state of the alarm.


For more information, see section 29.2
Alarm States on page 675.

Matching alarms count Displays the number of alarms that


currently meet the criteria of the sum
alarm.

Alarm delay (s) Enter the time, in seconds, the alarm has
to be within the alarm criteria before the
alarm is triggered.

Reset delay (s) Enter the time, in seconds, the alarm has
to be within the reset criteria before the
alarm state is changed from alarm to
reset.

Shunt variable 1 Enter the shunt variable that is used to


enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the
shunt value is inactive. For more
information, see section 31.3 Shunt
Variables on page 815.

Operator Select AND or OR to add logic between


the first and the second shunt variable.
For more information, see section 31.3
Shunt Variables on page 815.

Continued on next page

04-17005-03-en, October 2015 System


785
30 Alarm Types
30.22 Configuring a Sum Alarm

Continued
Property Description
Shunt variable 2 Enter the second shunt variable that is
used to enable or disable the alarm. For
more information, see section 31.3
Shunt Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the
shunt value is inactive. For more
information, see section 31.3 Shunt
Variables on page 815.

5. Edit the presentation properties:


Property Description

Alarm message Type the message to display when the


alarm is in Alarm state.
For more information, see section 31.6
Alarm Messages on page 818.

Reset message Type the message to display when the


alarm is reset.

Alarm priority Enter the priority level of the alarm.

Reset priority Select to set all priorities to the same


value.

Same priority Select to set all priorities to the same


value.

Category Enter the category that the alarm belongs


to.

Flashing alert Select to make the alarm row flash in the


Alarms pane and Alarm Views when the
alarm is triggered.

Audible alert Select to make the alert audible when the


alarm is triggered.

System 04-17005-03-en, October 2015


786
30 Alarm Types
30.22 Configuring a Sum Alarm

6. Edit the user action properties:


Property Description

Acknowledgement type Select the type of acknowledgement for


the alarm.

Cause note group Enter the cause note group that is used
by the alarm.

Action note group Enter the action note group that is used
by the alarm.

Checklist Enter the checklist that belongs to the


alarm.

When acknowledging an alarm Select what actions the user has to


perform when acknowledging an alarm.

Required user action Select what actions the user has to


perform when any of the listed events
occur.

7. Edit the attachment properties:


Property Description

Add attachment
Click to add an attachment to the alarm.
For more information, see section 31.21
Alarm Attachments on page 839.

Remove attachment
Click to remove an attachment.

Navigate to
Click to open the attachment that is
selected in the attachment list.

Display on alarm Select to display the attachment when the


alarm is triggered.

8. Click OK.

04-17005-03-en, October 2015 System


787
30 Alarm Types
30.23 Enumeration Alarms

30.23 Enumeration Alarms


An enumeration is a variable with labeled values; different variables have different
enumerations. When configuring an enumeration alarm, you configure the variable
and its enumerations to monitor.
For example, you create an enumeration alarm that monitors the reliability variable
of an I/O point. The alarm is configured to trigger when the reliability variable has an
enumeration that indicates the value generated by the I/O point is unreliable.

Figure: Alarm wizard example when creating an enumeration alarm that monitors the
reliability enumeration value of an I/O variable.
Enumeration alarms can be configured using shunt variable and time delay. For
more information, see section 29.3 Alarm Functions on page 676.

System 04-17005-03-en, October 2015


788
30 Alarm Types
30.24 Creating an Enumeration Alarm

30.24 Creating an Enumeration Alarm


You create an enumeration alarm to monitor the enumerations of a variable.

To create an enumeration alarm


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where you want to create the alarm.
2. On the File menu, point to New and then click Alarm.
3. In the object type list, select Enumeration Alarm.

4. In the Name box, type a name for the alarm.


5. In the Description box, type a description for the alarm.
6. Click Next.
Continued on next page

04-17005-03-en, October 2015 System


789
30 Alarm Types
30.24 Creating an Enumeration Alarm

7. In the Monitored variable box, enter the object and its enumeration type
that the alarm monitors.

8. Under Trigger alarm when variable is, select the enumeration options of
the enumeration type that triggers the alarm.
9. In the Disable alarm box, select whether or not to create the alarm in
disabled mode.
10. In the Alarm delay box, enter the time delay before the alarm is triggered.
11. In the Reset delay box, enter the time delay before the alarm is reset.
12. Select Invert to have the alarm enabled when the first shunt variable is active.
13. In the Shunt variable 1 box, enter the binary variable that enables or
disables the alarm.
14. In the Operator list, select AND or OR to add logic between the first shunt
variable and the second shunt variable.
15. Select Invert to have the alarm enabled when the second shunt variable is
active.
16. In the Shunt variable 2 box, enter the binary variable that enables or
disables the alarm.
17. Click Next.
Continued on next page

System 04-17005-03-en, October 2015


790
30 Alarm Types
30.24 Creating an Enumeration Alarm

18. In the Alarm message box, enter the message to display when the
monitored variable goes with or is equal to the alarm limits.

19. In the Reset message box, enter the message to display when the alarm is
reset.
20. In the Alarm priority box, enter the priority of the alarm when the monitored
variable triggers the alarm.
21. Select the Same priority check box to let all priorities inherit the value in the
Alarm priority box.
22. In the Reset priority box, enter the priority of the alarm when it is reset.
23. In the Category box, enter the category that the alarm belongs to.
24. Select Flashing alert to make the alarm flash in the Alarms pane and Alarm
Views when it is triggered.
25. Select Audible alert to make the alarm sound when it is triggered.
26. Click Next.
Continued on next page

04-17005-03-en, October 2015 System


791
30 Alarm Types
30.24 Creating an Enumeration Alarm

27. Select how the user has to acknowledge the alarm.


Select No when the alarm does not need to be acknowledged.
Select Single when the alarm needs to be acknowledged once, either in
the alarm state or reset state.
Select Extended when the alarm needs to be acknowledged in both the
alarm state and the reset state.

28. In the Cause note group box, select the cause note group that you want to
connect to the alarm.
29. In the Action note group box, select the action note group that you want to
connect to the alarm.
30. In the Checklist box, select the checklist that you want to connect to the
alarm.
31. Select the When acknowledging an alarm: Comment check box to force
the user to add a comment to the alarm before the alarm can be
acknowledged.
Continued on next page

System 04-17005-03-en, October 2015


792
30 Alarm Types
30.24 Creating an Enumeration Alarm

32. Select the When acknowledging an alarm: Cause note check box to
force the user to edit the connected cause note before the alarm can be
acknowledged.
33. Select the When acknowledging an alarm: Action note check box to
force the user to edit the connected action note before the alarm can be
acknowledged.
34. Select the When acknowledging an alarm: Checklist check box to force
the user to go through the connected checklist before the alarm can be
acknowledged.
35. Under Required User Actions, select the check boxes for Comment,
Cause note, and Action note to force the user to act on the listed actions.
36. Click Next.

37. Click the Add attachment button to add an attachment to the alarm.

Continued on next page

04-17005-03-en, October 2015 System


793
30 Alarm Types
30.24 Creating an Enumeration Alarm

38. In the Select Object dialog box, select the object you want to attach to the
alarm and then click Select.

39. In the Attachment page, in the Display on alarm column, select the check
box to automatically open the attachment when the alarm is triggered.
40. Click Create.

System 04-17005-03-en, October 2015


794
30 Alarm Types
30.25 Configuring an Enumeration Alarm

30.25 Configuring an Enumeration Alarm


You configure the properties of an enumeration alarm to meet the unique needs of
your site.
For more information, see section 30.23 Enumeration Alarms on page 788.

To configure an enumeration alarm


1. In WorkStation, in the System Tree pane, select the enumeration alarm you
want to configure.
2. On the File menu, click Properties.
3. Edit the basic settings:
Property Description

Type Displays the alarm type of the alarm.

Name Displays the name of the alarm.

Description Type to change the description of the


alarm.

04-17005-03-en, October 2015 System


795
30 Alarm Types
30.25 Configuring an Enumeration Alarm

4. Edit the alarm trigger properties:


Property Description

Trigger alarm when variable is Select the enumeration values that trigger
the alarm.

Montiored variable Enter the variable together with the


enumeration to monitor.

Disable alarm Select to disable the alarm, for example,


before deployment.

Alarm state Displays the present state of the alarm.


For more information, see section 29.2
Alarm States on page 675.

Disabled cause Select to disable the alarm, for example,


before deployment.

Alarm delay (s) Enter the time, in seconds, the alarm has
to be within the reset criteria before the
alarm state is changed from alarm to
reset.

Reset delay (s) Enter the time, in seconds, the alarm has
to be within the alarm criteria before the
alarm is triggered.

Shunt variable 1 Enter the shunt variable that is used to


enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the
shunt value is inactive. For more
information, see section 31.3 Shunt
Variables on page 815.

Operator Select AND or OR to add logic between


the first and the second shunt variable.
For more information, see section 31.3
Shunt Variables on page 815.

Shunt variable 2 Enter the second shunt variable that is


used to enable or disable the alarm. For
more information, see section 31.3
Shunt Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the
shunt value is inactive. For more
information, see section 31.3 Shunt
Variables on page 815.

System 04-17005-03-en, October 2015


796
30 Alarm Types
30.25 Configuring an Enumeration Alarm

5. Edit the presentation properties:


Property Description

Alarm message Type the message to display when the


alarm is in Alarm state.
For more information, see section 31.6
Alarm Messages on page 818.

Reset message Type the message to display when the


alarm is reset.

Alarm priority Enter the priority level of the alarm.

Reset priority Select to set all priorities to the same


value.

Same priority Select to set all priorities to the same


value.

Category Enter the category that the alarm belongs


to.

Flashing alert Select to make the alarm row flash in the


Alarms pane and Alarm Views when the
alarm is triggered.

Audible alert Select to make the alert audible when the


alarm is triggered.

6. Edit the user action properties:


Property Description

Acknowledgement type Select the type of acknowledgement for


the alarm.

Cause note group Enter the cause note group that is used
by the alarm.

Action note group Enter the action note group that is used
by the alarm.

Checklist Enter the checklist that belongs to the


alarm.

When acknowledging an alarm Select what actions the user has to


perform when acknowledging an alarm.

Required user action Select what actions the user has to


perform when any of the listed events
occur.

04-17005-03-en, October 2015 System


797
30 Alarm Types
30.25 Configuring an Enumeration Alarm

7. Edit the attachment properties:


Property Description

Add attachment
Click to add an attachment to the alarm.
For more information, see section 31.21
Alarm Attachments on page 839.

Remove attachment
Click to remove an attachment.

Navigate to
Click to open the attachment that is
selected in the attachment list.

Display on alarm Select to display the attachment when the


alarm is triggered.

8. Click OK.

System 04-17005-03-en, October 2015


798
30 Alarm Types
30.26 System Information Alarms

30.26 System Information Alarms


System information alarms monitor system entities, such as online status for
SmartStruxure server devices or field devices. The system information alarms are
generated by Building Operation. Users cannot create new system alarms. The
possible causes of a system alarm are gathered in an enumeration called System
alarm ID. When a system alarm is triggered, the cause of the alarm is indicated in
the System alarm ID column in the Alarms pane or Alarm View. Some system
alarms have additional information in the Alarm text column.
For example, a Building Operation system information alarm notifies the user when
a Xenta device becomes offline.
System information alarms have the category 'System Alarm'. If a System
information alarm has an alarm text, this texts always begins with System alarm:.
System information alarms are usually handled similarly to other alarms. After
acknowledging a system information alarm, the cause of the alarm must be
corrected before the alarm state changes to reset and then returns to normal state.

Figure: System information alarm acknowledgement loop where the alarm is


acknowledged in alarm state

04-17005-03-en, October 2015 System


799
30 Alarm Types
30.26 System Information Alarms

Figure: System information alarm acknowledgement loop where the alarm is


acknowledged in reset state
Simple system alarms are system alarms with a simplified state handling. When you
acknowledge a simple system alarm, it disappears from the Alarms pane,
regardless of the current alarm state. For example, a simple system alarm notifies
the user when a SmartStruxure server or field device performs a warm start.

System 04-17005-03-en, October 2015


800
30 Alarm Types
30.26 System Information Alarms

Figure: Simple system alarm acknowledgement loop where the alarm is acknowledged in
alarm state

04-17005-03-en, October 2015 System


801
30 Alarm Types
30.27 System Information Alarms List

30.27 System Information Alarms List


You use System Information Alarm IDs to filter the content of the Alarms pane or an
Alarm View. You also use System Information Alarm IDs to set up notifications that
are sent to a recipient when a specific alarm condition is met.

30.27.1 A-D
Listed below are the System Information Alarms with IDs that begin with the letters
A-D.
A B C D

A log data transfer BACnet did not start Can not enable Database file is
was missed archiving corrupt

A log sample was BACnet server failure Cannot verify lead Database update
missed object status failed

Alarm signal trigger Bad lead object Communication Defective protocol


buffer full reference failed implementation

Archive directory Bad lead object type Communication Device address


does not exist! failed Authentication changed
error

Archive directory Blacklisted device Communication Device offline


does not exist! detected failed Authorization
Retrying in 5 minutes! error

Archive path must be Communication Duplicate device


set to enable failed Configuration address
archiving error

Archiving canceled Communication Duplicate device


due to configuration failed Domain is not identifier
change available

Archiving failed Communication Duplicate device


because of an failed Hostname is name
ongoing operation invalid

Archiving is not Communication Duplicate network


enabled failed Unexpected identifier
Server fullpath

Communication Duplicate of local


failed Unexpected network
Server type

Communication
failed Version
Mismatch

Corrupt backup set is


detected

System 04-17005-03-en, October 2015


802
30 Alarm Types
30.27 System Information Alarms List

Continued
A B C D

CWS Alarm Poll


failed

CWS Browse failed

CWS GetHistory
failed

CWS GetObject
failed

CWS Method Error

CWS Value Poll failed

30.27.2 E-L
Listed below are the System Information Alarms with IDs that begin with the letters
E-L.
E F I L

Email service Failed to create Incorrect lead object Local administrator


configuration error object back-reference account has empty
or default password

Email service failed to Failed to initialize Invalid archive path Log full
connect to SMTP references
server

Email service failed to Failure backing up Invalid archiving Log stopped


login to SMTP server server database format because it is full

Email service failed to Failure restoring Invalid device Log variable error
send message server database address

Email service no Failure retrieving Invalid device Logging started


recipient email backup set from identifier
address remote server

Email service no File I/O error IO driver Logging stopped


sender and recipient unexpectedly timed
email address out

Email service no IO error when


sender email address generating archive

Error in log definition IO error when writing


to archive temporary

Error in retrieving IO error, cannot write


Xenta device Trend to archive directory!
Log data

04-17005-03-en, October 2015 System


803
30 Alarm Types
30.27 System Information Alarms List

Continued
E F I L

Error - Upgrade using IO error, cannot write


DFU mode to archive directory!
Retrying in 5 minutes!

IO error, not enough


space left in the
archive directory!

IO error, not enough


space left in the
archive directory!
Retrying in 5 minutes!

IO module offline

IP connection offline

30.27.3 M-NW8 R
Listed below are the System Information Alarms with IDs that begin with the letters
M-NW8 R.
M Ne - No NW8 A-D NW8 E-R

Module type NETWORK 8000 NW8 Application NW8 EEprom


mismatch message error 1 checksum error

NETWORK 8000 NW8 Application NW8 EEprom


message end error 16 memory error

Network offline NW8 Application NW8 Freeze error


error 2

New application NW8 Application NW8 Hot water


program error 4 potentiometer

No file name set NW8 Application NW8 Induction


modified auxilary
potentiometer

No valid Blueprint File NW8 AS1 diagnostic NW8 Joins LCM


network event

Not enough flash NW8 ASD message NW8 Joins network


memory for log event

Not enough RAM NW8 AT1 diagnostic NW8 Leaves LCM


memory for log network event

NW8 AT2 diagnostic NW8 Leaves network


event

NW8 Command NW8 Leaves/joins


failure LCM network

System 04-17005-03-en, October 2015


804
30 Alarm Types
30.27 System Information Alarms List

Continued
M Ne - No NW8 A-D NW8 E-R

NW8 Configuration NW8 Leaves/joins


error network

NW8 Damper range NW8 Maximum flow


error potentiometer

NW8 Database NW8 Minimum flow


initialized potentiometer

NW8 Database NW8 Missing


modified changeover input

NW8 Device cold NW8 No U-Link


reset communication

NW8 Device reset NW8 Press sensor

NW8 Device warm NW8 Pressure error


reset

NW8 Duct NW8 RAM failure


temperature

NW8 Duct NW8 Relay failure


temperature out of
range

30.27.4 NW8 R
Listed below are the System Information Alarms with IDs that begin with NW8 R.
NW8 Relay failure NW8 Relay failure NW8 Relay failure NW8 Relay failure
01-12 13-24 25-36 37-48

NW8 Relay failure 01 NW8 Relay failure 13 NW8 Relay failure 25 NW8 Relay failure 37

NW8 Relay failure 02 NW8 Relay failure 14 NW8 Relay failure 26 NW8 Relay failure 38

NW8 Relay failure 03 NW8 Relay failure 15 NW8 Relay failure 27 NW8 Relay failure 39

NW8 Relay failure 04 NW8 Relay failure 16 NW8 Relay failure 28 NW8 Relay failure 40

NW8 Relay failure 05 NW8 Relay failure 17 NW8 Relay failure 29 NW8 Relay failure 41

NW8 Relay failure 06 NW8 Relay failure 18 NW8 Relay failure 30 NW8 Relay failure 42

NW8 Relay failure 07 NW8 Relay failure 19 NW8 Relay failure 31 NW8 Relay failure 43

NW8 Relay failure 08 NW8 Relay failure 20 NW8 Relay failure 32 NW8 Relay failure 44

NW8 Relay failure 09 NW8 Relay failure 21 NW8 Relay failure 33 NW8 Relay failure 45

NW8 Relay failure 10 NW8 Relay failure 22 NW8 Relay failure 34 NW8 Relay failure 46

04-17005-03-en, October 2015 System


805
30 Alarm Types
30.27 System Information Alarms List

Continued
NW8 Relay failure NW8 Relay failure NW8 Relay failure NW8 Relay failure
01-12 13-24 25-36 37-48

NW8 Relay failure 11 NW8 Relay failure 23 NW8 Relay failure 35 NW8 Relay failure 47

NW8 Relay failure 12 NW8 Relay failure 24 NW8 Relay failure 36 NW8 Relay failure 48

30.27.5 NW8 Ro-NW8 Z


Listed below are the System Information Alarms with IDs that begin with NW8.
NW8 Ro - Se NW8 Sensor NW8 Sensor NW8 Se - Z
failure GCS 01-10 failure GCS 21-31

NW8 ROM failure NW8 Sensor failure NW8 Sensor failure NW8 Sensor input
GCS 01 GCS 21 failure

NW8 Sensor failure NW8 Sensor failure NW8 Sensor failure NW8 Setpoint out of
end GCS 02 GCS 22 range

NW8 Sensor failure NW8 Sensor failure NW8 Space setpoint


GCS 03 GCS 23

NW8 Sensor failure NW8 Sensor failure NW8 Space


GCS 04 GCS 24 temperature

NW8 Sensor failure NW8 Sensor failure NW8 System fault 32


GCS 05 GCS 25

NW8 Sensor failure NW8 Sensor failure NW8 UI diagnostic


GCS 06 GCS 26

NW8 Sensor failure NW8 Sensor failure NW8 UI1 diagnostic


GCS 07 GCS 27

NW8 Sensor failure NW8 Sensor failure NW8 UI2 diagnostic


GCS 08 GCS 28

NW8 Sensor failure NW8 Sensor failure NW8 UI3 diagnostic


GCS 09 GCS 29

NW8 Sensor failure NW8 Sensor failure NW8 UI4 diagnostic


GCS 10 GCS 30

NW8 Sensor failure NW8 UI5 diagnostic


GCS 31

NW8 UI6 diagnostic

NW8 UI7 diagnostic

NW8 UI8 diagnostic

NW8 Unrecognized
command

System 04-17005-03-en, October 2015


806
30 Alarm Types
30.27 System Information Alarms List

Continued
NW8 Ro - Se NW8 Sensor NW8 Sensor NW8 Se - Z
failure GCS 01-10 failure GCS 21-31

NW8 Zone
temperature out of
range

30.27.6 P-S
Listed below are the System Information Alarms with IDs that begin with the letters
P-S.
P Se-Sh Si-Sy

Parser failed See gap after 0x200 Sigma system schedule


executed

Port offline Serial port in use Signal alarm

Server configuration error Signal Event

Server not restarted Backup SNMP send trap failure


in process

Server not restarted Other Subnet offline

Server not restarted Restore System cold start


in process

Server offline System cold start initiated by


operator

Server restarted System factory reset

Shadow update failed System warm start

System warm start initiated


by operator

30.27.7 T-X
Listed below are the System Information Alarms with IDs that begin with the letters
T-X.
T U W X

Task 1 CPU limit Unable to access Web server failure X509 certificate error
reached, disabling lead object
real time priority

Task 2 CPU limit Unable to access Wrong alarm unit Xenta central
reached, disabling shadow object schedule update
real time priority failure

04-17005-03-en, October 2015 System


807
30 Alarm Types
30.27 System Information Alarms List

Continued
T U W X

Task period Unhandled buffer Xenta schedule


extended ready notification update failure

Too many log Unit is locked


definitions

Unit is unlocked

System 04-17005-03-en, October 2015


808
30 Alarm Types
30.28 Configuring the Description of an Alarm

30.28 Configuring the Description of an Alarm


You configure the description of an alarm to make it easier to identify the object.

To configure the description of an alarm


1. In WorkStation, in the System Tree pane, select the alarm you want to
configure.
2. Click the Basic Settings tab.
3. In the Description box, type a description for the object.

4. Click the Save button .

04-17005-03-en, October 2015 System


809
31 Alarm Functions

Topics
Time Delay
Configuring the Delay Time of an Alarm
Shunt Variables
Editing the Shunt Variables
Deadband
Alarm Messages
Configuring the Alarm Message of an Alarm
Priority
Configuring the Priority of an Alarm
Categories
Creating a Category
Configuring the Category of an Alarm
Editing a Category
Acknowledgements
Configuring the Acknowledgement Type of an Alarm
No Acknowledgement
Single Acknowledgement
Extended Acknowledgement
User Actions
Configuring Forced User Action
Alarm Attachments
Adding an Attachment to an Alarm
Adding an Attachment to Multiple Alarms
Copying Attachments to Multiple Alarms
Removing Attachments from an Alarm
Removing Attachments from Multiple Alarms
Notifications
Client Notifications
Email Notifications
SNMP Notifications
Write to File Notifications
Creating a Client Notification
Creating an Email Notification
Creating an SNMP Notification
Setting Up a Write to File Notification
Selecting the Schneider Electric Email Server for Email
Notifications
Substitution Codes for Notifications
Automatic Assignments
Creating an Automatic Assignment
Unit of Measure in Alarms
Configuring the Limits of an Alarm
Configuring the Flashing of an Alarm
Configuring the Audibility of an Alarm
Configuring the Audibility of an Alarm in Reset State
31 Alarm Functions
31.1 Time Delay

31.1 Time Delay


Time delay prevents unintentional activation-deactivation cycles. You can delay the
time before the alarm is triggered when the alarm state goes from normal state to
alarm state and when it goes from alarm state to reset state.
For example, an out of range alarm is configured with a 2 second time delay before
the alarm is triggered, and a 3 second time delay before the alarm is reset. The
monitored variable alarm exceeds the upper limit for 1 second before it returns to a
value below the upper limit, but this does not trigger the alarm. The alarm is
triggered when the variable has been in alarm state for more than 2 seconds. When
the problem is corrected, the alarm must remain in normal state for longer than 3
seconds to reset.

Figure: Alarm with time delay


Time delay can be added to all Building Operation alarms except for system
information alarms.

04-17005-03-en, October 2015 System


813
31 Alarm Functions
31.2 Configuring the Delay Time of an Alarm

31.2 Configuring the Delay Time of an Alarm


You configure the time delay of an alarm to meet the unique needs of your site.

To configure the delay time of an alarm


1. In WorkStation, in the System Tree pane, select the alarm object you want to
configure.
2. Click the Alarm Trigger tab.
3. In the Alarm delay box, enter the time delay before an alarm is triggered.

4. In the Reset delay box, enter the time delay before an alarm is reset.
5. In the Changes have been made dialog box, click Yes to save the
changes.

System 04-17005-03-en, October 2015


814
31 Alarm Functions
31.3 Shunt Variables

31.3 Shunt Variables


A shunt variable is a binary value that works as an on/off switch for the alarm.
When an alarm is shunted the alarm stops evaluating, that is, no longer listens to
the alarm trigger that can cause the alarm to change state. If the alarm is in Normal
or Acknowledged state when it is shunted, the alarm changes to Disabled state. If
the alarm is in Alarm or Reset state when it is shunted, it remains in that state. When
you acknowledge a shunted alarm it changes to Disabled state. When a shunted
alarm is unshunted, the alarm starts evaluating again, that is, starts to listen to the
alarm trigger that can cause the alarm to change state.
You can invert the shunt variable, which means that the alarm is shunted when the
shunt variable is set to False.
You can set two shunt variables for every type of Building Operation alarm. You
combine the two shunt variables by using a shunt operator with AND or OR logic
instead of writing a program to handle the logic.
Examples:
When the flow from a pump exceeds the configured limit, an alarm is triggered. The
alarm is only relevant if the pump is switched on. To enable the alarm only when the
pump is switched on, you set a shunt variable on the alarm.
When a pump is switched off, an alarm is triggered. You can invert the shunt
variable so that the alarm is enabled when the pump is switched on.

04-17005-03-en, October 2015 System


815
31 Alarm Functions
31.4 Editing the Shunt Variables

31.4 Editing the Shunt Variables


You add or edit the shunt variables connected to an alarm, to enable or disable the
alarm.

To edit the shunt variables


1. In the System Tree pane, select the alarm for the shunt variables you want to
edit.
2. Click the Alarm Trigger tab.
3. Select Invert if you want to invert the shunt variable.
4. In the Shunt variable 1 box, enter a digital variable that is used as a shunt
variable.

5. Select an AND or OR operator if you want to add a second shunt variable.


6. Select Invert to invert the second shunt variable.
7. In the Shunt variable 2 box, enter a digital variable that is used as a shunt
variable.

8. Click the Save button .

System 04-17005-03-en, October 2015


816
31 Alarm Functions
31.5 Deadband

31.5 Deadband
Deadband is an area of the alarm range where no reset action occurs. The purpose
of the deadband is to prevent unintentional activation-deactivation cycles.
For example, an out of range alarm has an upper limit of 10 and the deadband is 2.
The monitored variable must be equal to or fall below 8 (10-2) before the triggered
alarm is reset.

Figure: The monitored variable has to reach the limit of the deadband before the alarm is
reset.
Deadband can be set for out of range alarms and out of reference range alarms.

04-17005-03-en, October 2015 System


817
31 Alarm Functions
31.6 Alarm Messages

31.6 Alarm Messages


When configuring the alarm, you can write a message that displays in the Alarms
pane, Events pane, Alarm Views, and Event Views when an alarm is triggered or
reset.
For example, you configure a multistate range alarm to display the text The unit is
too hot when the alarm is triggered and The unit temperature is back to normal
when the alarm is reset.
In the alarm message you can use substitution codes to spell out current object
values. Substitution codes are usually used to spell out current object values.

Table: Alarm Message Substitution Codes


Component Description

@(F) Displays the full path of the monitored


variable.

@(O) Displays the monitored variable name.

@(P) Displays the monitored property.

@(V) Displays the value of the monitored variable


at the time of the state change.

For example, you create an alarm that is monitoring a temperature object named
T64. You write an alarm message that says: The point @(O) is too hot. When the
temperature value increases to 35, the alarm is triggered. The alarm with its alarm
message is presented in the Alarms pane and Alarm Views: The point T64 is too
hot.

System 04-17005-03-en, October 2015


818
31 Alarm Functions
31.7 Configuring the Alarm Message of an Alarm

31.7 Configuring the Alarm Message of an


Alarm
You configure the text of the alarm message that displays when the alarm is
triggered.

To configure the alarm message of an alarm


1. In WorkStation, in the System Tree pane, select the alarm you want to
configure.
2. Click the Presentation tab.
3. Under Alarm message, type the alarm message for the different alarm
criterias.

4. In the Changes have been made dialog box, click Yes to save the
changes.

04-17005-03-en, October 2015 System


819
31 Alarm Functions
31.8 Priority

31.8 Priority
When configuring an alarm, you define the priority of the alarm. The priority is used
to inform the operator of the importance of the triggered alarm. The priority is
displayed in the Alarms pane, Events pane, Alarm Views, and Event Views.
You can configure different priority levels for different states in the alarm. The default
priority number of an alarm is 100. However, you can change this number to any
integer between 0 and 999. You define what is high priority and what is low priority.
For example, you create two alarms, alarm A and B. Alarm A is more critical than
Alarm B. Therefore, it is given a higher priority level when the alarm is triggered but a
lower priority if the alarm is reset. When both alarms are triggered at the same time,
the priority levels of the alarms can guide the operator towards which alarm to work
with first. When the problem that triggered the alarm with highest priority is
corrected, the alarm goes to the reset state that has a lower priority than the
second alarm.

System 04-17005-03-en, October 2015


820
31 Alarm Functions
31.9 Configuring the Priority of an Alarm

31.9 Configuring the Priority of an Alarm


You configure the priority level of the different alarm states to meet the unique
needs of your site.

To configure the priority of an alarm


1. In WorkStation, in the System Tree pane, select the alarm you want to
configure.
2. Click the Presentation tab.
3. Under Priorities, select the Same priority check box to enter the same
priority.

4. In the Priorities boxes, enter the priority for each alarm state.
5. In the Changes have been made dialog box, click Yes to save the
changes.

04-17005-03-en, October 2015 System


821
31 Alarm Functions
31.10 Categories

31.10 Categories
You can group together alarms in categories to simplify the identification of the
alarm. When the alarm is triggered, the category name is displayed together with
the alarm in the Alarms pane, Events pane, Alarm Views, and Event Views.
For example, you create a category called Building A and add all alarms
represented in the building to this category. Another example could be that you
create a category called Door alarm and select this category for every door alarm
in the system.

System 04-17005-03-en, October 2015


822
31 Alarm Functions
31.11 Creating a Category

31.11 Creating a Category


You create a category to group alarms so that alarms are more easily identified.
For more information, see section 31.10 Categories on page 822.

To create a category
1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Categories.

4. Click the Categories tab, and then click the Add category button .
Continued on next page

04-17005-03-en, October 2015 System


823
31 Alarm Functions
31.11 Creating a Category

5. In the Name box, type the name of the new category.

6. In the Description box, type a description for the category.


7. Click OK.
8. On the File menu, click Save.

System 04-17005-03-en, October 2015


824
31 Alarm Functions
31.12 Configuring the Category of an Alarm

31.12 Configuring the Category of an Alarm


You configure a different category for an alarm to meet the unique needs of your
site.

To configure the category of an alarm


1. In WorkStation, in the System Tree pane, select the alarm you want to
configure.
2. Click the Presentation tab.
3. In the Category box, enter a category for the alarm.

4. Click the Save button .

04-17005-03-en, October 2015 System


825
31 Alarm Functions
31.13 Editing a Category

31.13 Editing a Category


You edit an existing category to change the name or the descriptions of the
categories that alarms can be a member of, and to simplify the identification of
alarms in the system.

To edit a category
1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Categories.
4. In the Categories tab, select the category you want to edit.

Continued on next page

System 04-17005-03-en, October 2015


826
31 Alarm Functions
31.13 Editing a Category

5. Click the Edit category button .

Note
To permanently remove a category from the categories list, click

the Remove category button .

6. In the Edit Category dialog box, in the Name box, type a name for the
category.

7. In the Description box, type a description for the category


8. Click OK.

9. Click the Save button .

04-17005-03-en, October 2015 System


827
31 Alarm Functions
31.14 Acknowledgements

31.14 Acknowledgements
When an alarm is triggered, you acknowledge the alarm to indicate to other users
that you have responded to the alarm and intend to troubleshoot the problem that
caused the alarm. The name of the user that acknowledges the alarm is displayed
in the Alarms pane, Events pane, Alarm Views, and Event Views.
Alarms can be configured to be acknowledged in different ways. The transition
between alarm states depends on the Basic evaluation property of the alarm.

31.14.1 No Acknowledge
When you select the acknowledgment type No acknowledgement, the triggered
alarm returns to normal state and disappears from the alarm view when the
monitored variable no longer meets the criteria to trigger the alarm. You select this
user action when the user only needs to see a status and does not need to take any
action on the alarm, for example, to see if a space is occupied or not.
For more information, see section 31.16 No Acknowledgement on page 830.

31.14.2 Single Acknowledge


When you select the acknowledgment type Single acknowledgment, the user
needs to acknowledge the alarm in the alarm view before the alarm returns to
normal state and disappears from the alarm view.
For more information, see section 31.17 Single Acknowledgement on page 832.

31.14.3 Extended Acknowledge


When you select the acknowledgement type Extended acknowledgment, the user
needs to acknowledge the alarm in the alarm view in reset state, before the alarm
returns to normal state and disappears from the alarm view.
For more information, see section 31.18 Extended Acknowledgement on page
834.

31.14.4 System Information Alarms


No acknowledgement type can be set for simple system alarms. You have to
acknowledge the alarm to send it back to Normal state. If you do not acknowledge
the alarm, it remains in Alarm state. For more information, see section 30.26
System Information Alarms on page 799.

31.14.5

System 04-17005-03-en, October 2015


828
31 Alarm Functions
31.15 Configuring the Acknowledgement Type of an Alarm

31.15 Configuring the Acknowledgement


Type of an Alarm
You configure the properties of an alarm to meet the unique needs of your site.

To configure the acknowledgement type of an alarm


1. In WorkStation, in the System Tree pane, select the alarm you want to
configure.
2. Click the User Action tab.
3. Select the Aknowledgement type:
Click No when the alarm does not need to be acknowledged.
Click Single when the alarm needs to be acknowledged in the alarm
state.
Click Extended when the alarm needs to be acknowledged in the alarm
state and the reset state.

4. In the Changes have been made dialog box, click Yes to save the
changes.

04-17005-03-en, October 2015 System


829
31 Alarm Functions
31.16 No Acknowledgement

31.16 No Acknowledgement
When you select the acknowledgment type No acknowledgement, the triggered
alarm returns to normal state and disappears from the alarm view when the
monitored variable no longer meets the criteria to trigger the alarm. You select this
user action when the user only needs to see a status and does not need to take any
action on the alarm, for example, to see if a space is occupied or not.

Figure: No acknowledgement loop where the alarm does not have to be acknowledged
before the alarm returns to normal state.
The user can acknowledge the alarm in the alarm view to let other users know that
the alarm has been noted. The acknowledgment is optional and the alarm does not
require an acknowledgement to return to normal state.

System 04-17005-03-en, October 2015


830
31 Alarm Functions
31.16 No Acknowledgement

Figure: No acknowledgement loop where the alarm is acknowledged before it returns to


normal state.

04-17005-03-en, October 2015 System


831
31 Alarm Functions
31.17 Single Acknowledgement

31.17 Single Acknowledgement


When you select the acknowledgment type Single acknowledgment, the user
needs to acknowledge the alarm in the alarm view before the alarm returns to
normal state and disappears from the alarm view.
If the user acknowledges the alarm when it is in alarm state, the alarm is set to
acknowledged state. When the problem that triggered the alarm is corrected, that is
when the monitored variable no longer meets the criteria to trigger the alarm, the
alarm returns to normal state.

Figure: Single acknowledgement loop where the alarm is acknowledged in alarm state
If the user did not acknowledge the alarm when it was in alarm state, and the
monitored variable no longer meets the criteria to trigger the alarm, the alarm is set
to reset state. The user needs to acknowledge the alarm in reset state to make it
return to normal state. In this case, the alarm can toggle between alarm state and
reset state several times before a user acknowledges the alarm.

System 04-17005-03-en, October 2015


832
31 Alarm Functions
31.17 Single Acknowledgement

Figure: Single acknowledgement loop where the alarm is acknowledged in reset state

04-17005-03-en, October 2015 System


833
31 Alarm Functions
31.18 Extended Acknowledgement

31.18 Extended Acknowledgement


When you select the acknowledgement type Extended acknowledgment, the user
needs to acknowledge the alarm in the alarm view in reset state, before the alarm
returns to normal state and disappears from the alarm view.
If the user acknowledges the alarm when it is in alarm state, the alarm is set to
acknowledged state. When the problem that triggered the alarm is corrected, that is
when the monitored variable no longer meets the criteria to trigger the alarm, the
alarm is set to reset state. The user needs to acknowledge the alarm in reset state
to make it return to normal state.

Figure: Extended acknowledgement loop where the alarm reset state has to be
acknowledged before the alarm returns to normal state
If the user did not acknowledge the alarm when it was in alarm state and the
monitored variable no longer meets the criteria to trigger the alarm, the alarm is set
to reset state. The user needs to acknowledge the alarm in reset state to make it
return to normal state. In this case, the alarm can toggle between alarm state and
reset state several times before a user acknowledges the alarm.

System 04-17005-03-en, October 2015


834
31 Alarm Functions
31.18 Extended Acknowledgement

Figure: Extended acknowledgement loop where the alarm toggles between alarm state
and reset state

04-17005-03-en, October 2015 System


835
31 Alarm Functions
31.19 User Actions

31.19 User Actions


You can add information when handling a trigger alarm. For example, you can add
a comment to the alarm or open an action note that is connected to the alarm.
When configuring an alarm, you can force the user to perform different actions
when handling a triggered alarm.
You can add several comments and connect cause notes, action notes, and
checklist items to a single alarm.

Note
When an Enterprise Server is connected to a SmartStruxure server device, all
existing checklists, action notes, cause notes, and categories on SmartStruxure
server device are removed and replaced with the objects from the Enterprise
Server.

31.19.1 Comments
Use comments to save written information about an alarm. Comments can be
added and viewed at any time. A comment is automatically tagged with the user
name and a time and date stamp. Useful comments could be the cause of the
alarm and how it was taken care of. Information like this can be of great help the
next time the same alarm is triggered.
For more information, see section 32.1 Comments on page 885.

31.19.2 Cause Notes


A cause note specifies the problem that caused the alarm. Cause notes are
grouped by category, with possible alarm causes listed in each group. When an
alarm is triggered, you can easily report the causes that triggered the alarm by
selecting the predefined choices.
For more information, see section 32.2 Cause Notes on page 886.

31.19.3 Action Notes


Action notes are grouped by category, with possible actions that may correct the
problem listed in each category. An action note specifies the actions that you used
to correct the problem that caused the alarm.
For more information, see section 32.6 Action Notes on page 892.

31.19.4 Checklists
A checklist is a set of steps that guides the user to which action to take when an
alarm is triggered. If an alarm goes to normal state, the corresponding checklist is
also reset and each step has to be checked again.
For more information, see section 32.10 Checklists on page 898.

System 04-17005-03-en, October 2015


836
31 Alarm Functions
31.19 User Actions

31.19.5 Summary of User Actions


Table: User Actions
User Action Description Use

Comments User added written Use comments to save


information to a triggered written information to an
alarm. alarm. For example, what
triggered the alarm or how
was the alarm solved.

Cause Notes A predefined list of the Use the cause notes to easily
problems that can have report the cause that
caused the alarm. triggered the alarm.

Action Notes A predefined list of possible Use the action notes to easily
actions that can correct the report the actions that were
problem. taken to correct the problem
that triggered the alarm.

Checklists A predefined list of steps that Use the checklist to navigate


guides the user to solve the the user step-by-step to
problem that can have solve the problem.
triggered the alarm.

04-17005-03-en, October 2015 System


837
31 Alarm Functions
31.20 Configuring Forced User Action

31.20 Configuring Forced User Action


You force the user to perform certain actions when working with alarms to meet the
unique needs of your site.

To configure forced user actions


1. In WorkStation, in the System Tree pane, select the alarm you want to
configure.
2. Click the User Action tab.
3. Under Required user action, select the check boxes for Comment,
Cause note, and Action note to force the user to act on the listed actions.

4. In the Changes have been made dialog box, click Yes to save the
changes.

System 04-17005-03-en, October 2015


838
31 Alarm Functions
31.21 Alarm Attachments

31.21 Alarm Attachments


You can add attachments to alarm objects, except System Information alarms. An
attachment is a link pointing to an object in the system. When an alarm that has an
attachment is triggered, a paperclip icon is displayed in the Alarms pane and Alarm
Views. It is also possible to configure the attachment to display when the alarm is
triggered.
An attachment can be: a voice message, a report, a trend chart, a schedule, a
Microsoft Word file, a PDF file, a video recording, or a pop-up window that contains
information regarding the alarm.
You can add the same attachment or set of attachments to multiple alarms in a
single operation. You can also delete the attachments that belong to multiple
alarms in a single operation. If you add an attachment that already has been
attached to an alarm, the later attachment is added as a duplicate.
In WebStation, you can open attachments that refer to objects in the system. In
WorkStation, you can also open other types of attachments, provided that the
program or editor associated with the attachment is locally installed on your
computer. For example, if the attachment is a PDF file, you can open the file if
Adobe Reader or a similar program is installed on your computer.

04-17005-03-en, October 2015 System


839
31 Alarm Functions
31.22 Adding an Attachment to an Alarm

31.22 Adding an Attachment to an Alarm


You add an attachment, for example a .pdf file or a trend log, to assist the user
when diagnosing or solving the problem that caused the alarm.
For more information, see section 31.21 Alarm Attachments on page 839.

To add an attachment to an alarm


1. In WorkStation, in the Alarm View of the alarm, click the Attachment tab.

2. Click the Add button .

Continued on next page

System 04-17005-03-en, October 2015


840
31 Alarm Functions
31.22 Adding an Attachment to an Alarm

3. In the Select Object dialog box, browse to the item you want to attach to the
alarm.

4. Click Select.
(In FM: TaskClosing) The selected attachment appears in the Attachment list of the
alarm and is attached when the alarm is triggered.

04-17005-03-en, October 2015 System


841
31 Alarm Functions
31.23 Adding an Attachment to Multiple Alarms

31.23 Adding an Attachment to Multiple


Alarms
You add an attachment, for example a .pdf file or trend log, to assist the user when
diagnosing or solving the problem that caused an alarm.
For more information, see section 31.21 Alarm Attachments on page 839.

To add an attachment to multiple alarms


1. In WorkStation, in the list view, select the alarms to which you want to add the
alarm attachment.

2. On the Actions menu, point to Advanced.


3. Click Add attachment.
Continued on next page

System 04-17005-03-en, October 2015


842
31 Alarm Functions
31.23 Adding an Attachment to Multiple Alarms

4. Select the item that you want to attach to the alarms.

5. Click Select.
6. Click Yes if you want the attachment to display when the alarm is triggered.

The attachment is added to all selected alarms.

04-17005-03-en, October 2015 System


843
31 Alarm Functions
31.24 Copying Attachments to Multiple Alarms

31.24 Copying Attachments to Multiple


Alarms
You copy alarm attachments from one alarm to one or several other alarms where
you want the same set of alarm attachments.
For more information, see section 31.21 Alarm Attachments on page 839.

To copy attachments to multiple alarms


1. In WorkStation, in the list view, select the alarms where you want to paste the
alarm attachments.

2. On the Actions menu, point to Advanced.


3. Click Copy attachments from.
Continued on next page

System 04-17005-03-en, October 2015


844
31 Alarm Functions
31.24 Copying Attachments to Multiple Alarms

4. In the list view, select the alarm from which you want to copy the alarm
attachments.

All the selected target alarms get copies of the alarm attachments from the source
alarm.

04-17005-03-en, October 2015 System


845
31 Alarm Functions
31.25 Removing Attachments from an Alarm

31.25 Removing Attachments from an Alarm


You remove an attachment from an alarm to meet the unique needs of your site
For more information, see section 29.3 Alarm Functions on page 676.

To remove an attachment from an alarm


1. In the System Tree pane, select the alarm object from which you want to
remove an attachment.
2. In the Attachment view, select the attachment you want to remove.

Note

Click the Navigate to button to open the selected


attachment in a new dialog box.

3. Click the Remove attachment button to permanently remove the


attachment from the list.

4. Click the Save button .

System 04-17005-03-en, October 2015


846
31 Alarm Functions
31.26 Removing Attachments from Multiple Alarms

31.26 Removing Attachments from Multiple


Alarms
You remove all alarm attachments, for example, .pdf files or a trend logs that are no
longer relevant for assisting you when diagnosing or solving the problem that
caused an alarm.
For more information, see section 31.21 Alarm Attachments on page 839.

To remove attachments from multiple alarms


1. In WorkStation, in the list view, select the alarms from which you want to
remove all alarm attachments.

2. On the Actions menu, point to Advanced.


3. Click Remove all attachments.
4. Click Yes to verify that you want to remove the alarm attachments.

All alarm attachments are removed from the selected alarms.

04-17005-03-en, October 2015 System


847
31 Alarm Functions
31.27 Notifications

31.27 Notifications
Alarm notifications are used for notifying users or user groups that a certain alarm
event has occurred in the system. The notification contains a prewritten message
that can be displayed as a popup message, sent as an email, sent to an SNMP
manager, or written to a text file. When setting up the notification, you write the
message and then configure the conditions that execute the notification action.
When writing the text message, you can use substitution codes to add current
system information. For more information, see section 31.37 Substitution Codes
for Notifications on page 869.
If you want a schedule condition to be met before the notification is displayed, you
can add a schedule to the notification.
For example, you only want an email to be sent on weekends. You set the active
value to match the value of a multistate schedule when the notification is to be
active.

31.27.1 Client Notifications


The client notification is displayed as a system tray popup in WorkStation. Client
notifications are displayed when an alarm state change that matches the configured
alarm filter condition occurs and the logged on user is authorized to view the alarm.
For more information, see section 31.28 Client Notifications on page 850.

31.27.2 Email Notifications


The email notification is sent by email through the SMTP protocol when the
configured alarm filter condition is met. If the recipient is a user account, the user
account has to be authorized to view the alarm. You can either use a predefined
SMTP server provided by Schneider Electric or use your own SMTP server.
For more information, see section 31.29 Email Notifications on page 851.

31.27.3 SNMP Notifications


SNMP alarms are typically used when the alarm receiver does not have access to
Building Operation software or when a central unit, for example the IT department,
want to collect alarms from different sources in one place.
For more information, see section 31.30 SNMP Notifications on page 852.

31.27.4 Write to File Notifications


The write to file notification is written to a text file when the configured alarm filter
condition is met.
For more information, see section 31.31 Write to File Notifications on page 853.

System 04-17005-03-en, October 2015


848
31 Alarm Functions
31.27 Notifications

31.27.5 Substitution Codes for Notifications


Substitution codes are codes that represent a dynamic value and are preferably
used to spell out the current object values.
For more information, see section 31.37 Substitution Codes for Notifications on
page 869.

04-17005-03-en, October 2015 System


849
31 Alarm Functions
31.28 Client Notifications

31.28 Client Notifications


The client notification is displayed as a system tray popup in WorkStation. Client
notifications are displayed when an alarm state change that matches the configured
alarm filter condition occurs and the logged on user is authorized to view the alarm.
The client notification message and display conditions are configured in the Client
Notification View or in the Client Notification wizard. For more information, see
section 33.81 Client Notification View on page 1043.

System 04-17005-03-en, October 2015


850
31 Alarm Functions
31.29 Email Notifications

31.29 Email Notifications


The email notification is sent by email through the SMTP protocol when the
configured alarm filter condition is met. If the recipient is a user account, the user
account has to be authorized to view the alarm. You can either use a predefined
SMTP server provided by Schneider Electric or use your own SMTP server.
On the SmartStruxure server where the email notification is triggered, you need to
enter a sender email address to connect to and send email notifications through the
Schneider Electric Email Server. For more information, see section 31.36 Selecting
the Schneider Electric Email Server for Email Notifications on page 867.
You can send email notifications to recipients whose user accounts reside on the
same SmartStruxure server as the email notification. Make sure that the recipients
of the email notifications have user accounts with permissions to handle the alarm
that triggered the notification.
For example, you create an email notification with the message "An alarm is
triggered in building C, please acknowledge immediately". You configure the
notification to be sent to a security group's email address when any alarm in
building C is triggered. For more information, see section 33.84 Email Notification
View on page 1049..
You can send the email notification to multiple recipients by adding a semi-colon
between the email addresses without any blank space, or by selecting a user or
user group. By selecting a user group, you make sure that the notifications are sent
to the Building Operation users who are members of the group at any given time.

Note
If the SmartStruxure server fails to send an email notification, this is indicated by a
system information alarm. For more information, see section 30.26 System
Information Alarms on page 799..

04-17005-03-en, October 2015 System


851
31 Alarm Functions
31.30 SNMP Notifications

31.30 SNMP Notifications


SNMP alarms are typically used when the alarm receiver does not have access to
Building Operation software or when a central unit, for example the IT department,
want to collect alarms from different sources in one place.
You can send alarms as SNMP traps from any SmartStruxure server using the
SNMP version 3 protocol. The SmartStruxure server can send one or many traps
depending on the setting. Alarms from a SmartStruxure server device in a multi-
server network can also be sent from the Enterprise Server.
You can configure the SNMP trap to send the original message in the alarm using
the substitution codes or you can configure the notification to send a message
adapted to the specific notification.
Using the filter function, you can select the alarm you want to send. If no conditions
are set in the filter, all alarms in the system are sent using the SNMP traps when
they are triggered. The filter function also makes it possible to add conditions like
alarm text, triggered time, or device name.
Alarms send using SNMP trap is written in the event log.
SNMP is also used to send information regarding the status of a SmartStruxure
server device. For more information, see the SmartStruxure Server Device topic on
WebHelp..

System 04-17005-03-en, October 2015


852
31 Alarm Functions
31.31 Write to File Notifications

31.31 Write to File Notifications


The write to file notification is written to a text file when the configured alarm filter
condition is met.
If the text file already exists, a new row is added with the notification. If the file does
not exist, a new text file is created. If your database is stored on an Enterprise
Server, the text file is saved in the notification folder in the database folder. In
Software Administrator, you can see where the Enterprise Server database folder is
stored. For more information, see section 15.1 Software Administrator on page
311.. If your database is stored on a SmartStruxure server device, you have to use
a Secure Copy Program to access the text file in the SmartStruxure server device's
file system at var/sbo/db/notifications.
You can use the write to file notification, for example, to trigger a third-party
software program that sends an SMS to a recipient when a specific text-string is
written to the file by a SmartStruxure server. For more information, see section
33.90 Write to File Notification View on page 1062.For more information, see
Write to File Notification View

04-17005-03-en, October 2015 System


853
31 Alarm Functions
31.32 Creating a Client Notification

31.32 Creating a Client Notification


You create a client notification to display a message when an alarm state has
changed.
For more information, see section 31.28 Client Notifications on page 850.

To create a client notification


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where you want to create the client notification.
2. On the File menu, point to New and then click Notification.
3. In the object type list, select Client Notification.

4. In the Name box, type a name for the client notification.


5. In the Description box, type a description for the client notification.
6. Click Next.
Continued on next page

System 04-17005-03-en, October 2015


854
31 Alarm Functions
31.32 Creating a Client Notification

7. In the Status box, select Enabled to activate the client notification.

8. Enter a schedule or other multistate variable to activate the client notification:


In the Schedule box, enter the schedule or other multistate variable that
contains the value that activates the client notification.
In the Active value box, enter the value, generated by the connected
schedule or other multistate variable, that activates the client notification.
9. In the Text box, type the notification message, which can include substitution
codes. For more information, see section 31.37 Substitution Codes for
Notifications on page 869.
10. In the Notify on transition to boxes, select the alarm status that generates
the client notification.

11. Click the Add condition button and select the condition type that
triggers the client notification.
12. Type the condition for the client notification.

13. Click the Add row button to add another condition of the same type.
14. Type the condition for the client notification.
15. Click Create.

04-17005-03-en, October 2015 System


855
31 Alarm Functions
31.33 Creating an Email Notification

31.33 Creating an Email Notification


You create an email notification to send an email message when an alarm event
occurs.
For more information, see section 31.29 Email Notifications on page 851.

To create an email notification


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where you want to create the notification.
2. On the File menu, point to New and then click Notification.
3. In the object type list, select Email Notification.

4. In the Name box, type a name for the email notification.


5. In the Description box, type a description for the notification.
6. Click Next.
Continued on next page

System 04-17005-03-en, October 2015


856
31 Alarm Functions
31.33 Creating an Email Notification

7. In the Status box, select Enabled to activate the email notification.

8. Enter a schedule or other multistate variable to activate the notification:


In the Schedule box, enter the schedule or other multistate variable that
contains the value that activates the notification.
In the Active value box, enter the value, generated by the connected
schedule or other multistate variable, that activates the notification.
9. In the To users and groups box, click the browse button to open the dialog
box where you select the users or user groups to whom the email notification
is sent.

Important
You can only select users or user groups that reside on the same
SmartStruxure server as the email notification.

Continued on next page

04-17005-03-en, October 2015 System


857
31 Alarm Functions
31.33 Creating an Email Notification

10. In the Domain box, select the domain that the users or user groups belong
to.

11. Select the users or user groups to whom the email notification is sent.
12. Click Add.
13. Click OK.
14. In the To email address box, type the email address of any additional
recipient of the email messages.

Note
You can send the notification to multiple email recipients by adding a
semi-colon without any space between the email addresses.

15. In the Subject box, type the subject of the email message.
16. In the Text box, type the notification message, which can include substitution
codes. For more information, see section 31.37 Substitution Codes for
Notifications on page 869.
17. In the Notify on transition to boxes, select the alarm status that generates
the notification.
Continued on next page

System 04-17005-03-en, October 2015


858
31 Alarm Functions
31.33 Creating an Email Notification

18. Click the Add condition button and select the condition type that
triggers the email notification.

19. Type the condition for the email notification.

20. Click the Add row button to add another condition of the same type.
21. Type the condition for the email notification.

Tip
You can add different condition types by clicking the Add

condition button . For example, you can filter on


categories, alarm state, and alarm text.

Continued on next page

04-17005-03-en, October 2015 System


859
31 Alarm Functions
31.33 Creating an Email Notification

22. Click Create.

System 04-17005-03-en, October 2015


860
31 Alarm Functions
31.34 Creating an SNMP Notification

31.34 Creating an SNMP Notification


You create an SNMP notification so that an SNMP user is notified when an alarm is
triggered.
For more information, see section 31.30 SNMP Notifications on page 852.

To create an SNMP notification


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where you want to create the SNMP Notification.
2. On the File menu, point to New and then click Notification.
3. In the object type list, select SNMP Notification.

4. In the Name box, type a name for the SNMP notification.


5. In the Description box, type a description for the SNMP notification.
6. Click Next.
Continued on next page

04-17005-03-en, October 2015 System


861
31 Alarm Functions
31.34 Creating an SNMP Notification

7. In the Status box, select Enabled to activate the SNMP notification


immediately.

8. Enter a schedule or other multistate variable to activate the SNMP notification:


In the Schedule box, enter the schedule or other multistate variable that
contains the value that activates the SNMP notification.
In the Active value box, enter the value, generated by the connected
schedule or other multistate variable, that activates the SNMP notification.
9. In the Address box, type the address to the SNMP manager that receives the
SNMP notification.
10. In the Port box, type the port that the SNMP manager uses to receive the
SNMP notification.
11. In the User name box, type the user name of the user on the SNMP
manager that receives the notification.
12. In the Text box, type the text content or the substitution code for the text
content the notification is to have when sent.
13. In the Security level list, select the security level.
14. In the Authentication protocol list, select the authentication protocol.
15. In the Authentication password box, type the password.
16. In the Confirm password box, type the password again.
17. In the Privacy encryption protocol list, select the encryption protocol.
18. In the Privacy password box, type the privacy password.
19. In the Confirm password box, type the password again.
Continued on next page

System 04-17005-03-en, October 2015


862
31 Alarm Functions
31.34 Creating an SNMP Notification

20. In the Notify on transition to boxes, select the alarm status that generates
the notification.

21. Click the Add condition button and select the condition type that triggers
the SNMP notification.

04-17005-03-en, October 2015 System


863
31 Alarm Functions
31.35 Setting Up a Write to File Notification

31.35 Setting Up a Write to File Notification


You set up a write to file notification to write a message in a text file when a certain
alarm event occurs.
For more information, see section 31.27 Notifications on page 848.

To set up a write to file notification


1. In WorkStation, in the System Tree pane, select the folder or server where
you want to create the notification.
2. On the File menu, point to New and then click Notification.
3. Select Write to File Notification.

4. In the Name box, type a name for the notification.


5. In the Description box, type a description for the notification.
6. Click Next.
Continued on next page

System 04-17005-03-en, October 2015


864
31 Alarm Functions
31.35 Setting Up a Write to File Notification

7. In the Status box, select Enable to activate the write to file notification.

8. In the Notify on transition to boxes, select the alarm status for when to
generate the notification.
9. In the File name box, type the name of the file where the message is written.

Note
If a file already exists with this name, the system writes the
message in the end of the file. If it does not exist, the system
creates a new file..
The file is located in the database folder. For more information,
see section 15.1 Software Administrator on page 311.

10. In the Text box, type the message that is written to the notification file.

Note
You can use substitution codes to let the system automatically
write system information in the notification message.

11. In the Active value box, enter the multistate value that activates the
notification.
12. In the Schedule box, enter the schedule or other multistate variable that
contains the value that is used to activate the notification.

13. Click the Add condition button to set up the events that generate the
writing action and select an event category.
Continued on next page

04-17005-03-en, October 2015 System


865
31 Alarm Functions
31.35 Setting Up a Write to File Notification

14. Enter the settings of the event category that generate the writing action.

Note
You can add several event categories to specify when to write
the notification.

15. Click the Add row button to add another condition of the same type.
16. Click Create.

System 04-17005-03-en, October 2015


866
31 Alarm Functions
31.36 Selecting the Schneider Electric Email Server for Email Notifications

31.36 Selecting the Schneider Electric Email


Server for Email Notifications
You configure a SmartStruxure server to connect to and send Email notifications
through the Schneider Electric Email Server, which is an SMTP server hosted by
Schneider Electric.

Note
Any available SMTP server can be used to send Email notifications. For more
information, see the Selecting and Specifying an Email Server for Email
Notifications topic on WebHelp.

For more information, see the SmartStruxure Server Communication topic on


WebHelp.

To select the Schneider Electric Email server for Email


notifications
1. In WorkStation, in the System Tree pane, select the SmartStruxure server
that you want to configure.
2. On the File menu, click Properties.
3. Click the Email tab.
Continued on next page

04-17005-03-en, October 2015 System


867
31 Alarm Functions
31.36 Selecting the Schneider Electric Email Server for Email Notifications

4. In the Select email server box, select Schneider Electric Email Server
to use the SMTP server hosted by Schneider Electric.

5. In the Sender email box, type a sender address for the email messages that
are generated by this email server. The sender email address is the receiver of
replies.
6. In the Maximum queue size box, enter the maximum number of email
messages that is allowed in the queue.
7. In the Response time-out box, enter the number of seconds the
SmartStruxure server waits for response when communicating with the email
server.
8. In the Maximum retry count box, enter the number of attempts to send an
email that are performed before abandoning the email message.
9. In the Retry time box, enter the number of minutes between each attempt.
10. In the Host box, confirm that the Schneider Electric Email Server address is
smtpservice.tac.com.
11. In the Port box, confirm that the port number is 25.
12. Click OK.

System 04-17005-03-en, October 2015


868
31 Alarm Functions
31.37 Substitution Codes for Notifications

31.37 Substitution Codes for Notifications


Substitution codes represent the information you want to display in a notification
when an alarm is triggered. The information is dynamically filled in from the alarm
that triggered the notification.
The substitution codes for email notification texts can be used in the email subject
and message. For write to file notifications, the substitution codes can be used in
the message but not in the file name. A substitution code for notifications has the
form @([property]) where [property] is replaced by one of the alarm properties.
For example, you configure a write to file notification that is sent when an alarm is
triggered. For notification text, you write "The room became too hot at
@(TriggeredTimestamp)". If the alarm is triggered at the time 2015-02-12 13:51:36,
the notification file will contain the text: "The room became too hot at 2015-02-12
13:51:36."

Table: Substitution Codes for Notifications


Code Description

@(AcknowledgedBy) Writes the user that acknowledged the


alarm.

@(AcknowledgeTime) Writes the time the alarm was


acknowledged.

@(AckRequired) Writes an indicator if the BACnet alarm


requires acknowledgement.

@(AlarmState) Writes the present state of the alarm.

@(AlarmText) Writes the alarm messages that are added


to the alarm.

@(AssignedID) Writes the unique ID of the user the alarm is


assigned to.

@(AssignedState) Writes the current assigned state the alarm


is in. The possible values are Unassigned,
Assigned, and Accepted.

@(AssignedTo) Writes the name of the user or group that the


alarm is assigned to.

@(AssignedToDomain) Writes the domain of the user or group that


the alarm is assigned to.

@(BACnetEventType) Writes the BACnet event type for this alarm.

@(BACnetNotificationType) Writes whether the BACnet notification was


an alarm or event.

@(BasicEvaluationState) Writes if the alarm is active or not.

@(Category) Writes the category name of the alarm.

@(CommandValue) Writes the value which was commanded for


a BACnet command failure alarm.

04-17005-03-en, October 2015 System


869
31 Alarm Functions
31.37 Substitution Codes for Notifications

Continued
Code Description

@(ConfirmedNotification) Writes an indication whether a BACnet


notification was issued as a confirmed or
unconfirmed BACnet message.

@(Count) Writes the number of times the alarm has


toggled between the alarm and reset states.

@(Deadband) Writes the value of the deadband used for


limit checking for BACnet out of range
alarms.

@(DeviceName) Writes the name of the I/NET device that


generated the event.

@(DisabledCause) Writes the cause of the alarm being


disabled. An alarm can be disabled by User,
Shunt variable, and System. If the alarm isn't
configured correctly it can be disabled by
System.

@(ErrorLimit) Writes the difference limit that was exceeded


for BACnet floating limit alarms.

@(EvaluationState) Writes the present evaluation state of the


alarm. For example, Upper limit alarm is
displayed when the monitored value reaches
the upper alarm limit.

@(EventFromState) Writes the event state of the object prior to


the occurence of the alarm condition for
BACnet alarms.

@(CWSid) Writes the EcoStruxure Web Service


identification of the alarm on the external
system.

@(CWSSourceId) Writes the EcoStruxure Web Service


identification of the external object that
generated the alarm.

@(ExceededLimit) Writes the value of the limit that was


exceeded for BACnet out of range alarms.

@(ExceedingValue) Writes the value that exceeded a limit for


BACnet out of range alarms.

@(FeedbackValue) Writes the value that differs from the


commanded value for a BACnet command
failure alarm.

@(FirstName) Writes the first name of the individual whose


key/card was used at the I/NET door point.

@(Hidden) Writes the visible status of an object. False


is displayed when the object is shown.

System 04-17005-03-en, October 2015


870
31 Alarm Functions
31.37 Substitution Codes for Notifications

Continued
Code Description

@(IndivNdx) Writes the individual number of the individual


whose key/card was used at the I/NET door
point.

@(LastName) Writes the last name of the individual whose


key/card was used at the I/NET door point.

@(Logging) Writes whether the alarm should be logged


or not.

@(MessageText) Writes the text of an I/NET action or dispatch


message, if there is one.

@(MonitoredObject->DESCR) Writes the description property of the


monitored object. This requires that a
MonitoredVariable is configured.

@(MonitoredObject->NAME) Writes the name property of the monitored


object. This requires that a
MonitoredVariable is configured.

@(MonitoredObject->NOTE1) Writes the note 1 property of the monitored


object. This requires that a
MonitoredVariable is configured.

@(MonitoredObject->NOTE2) Writes the note 2 property of the monitored


object. This requires that a
MonitoredVariable is configured.

@(MonitoredValue) Writes the value that caused the alarm to


become active or inactive.

@(MonitoredVariable) Writes the path of the monitored variable.

@(NewMode) Writes the new mode of the monitored


object for a BACnet change of value alarm.

@(NewState) Writes the new state of the monitored object


for a BACnet change of state or change of
life safety alarm.

@(NewValue) Writes the new value of the monitored


property for a BACnet change of value
alarm.

@(NotificationClass) Writes the distribution information of an


alarm notification within a BACnet system.

@(OperationExpected) Writes the next operation requested by the


monitored object for a BACnet change of life
safety alarm.

@(PossibleOperatorActions) Writes the possible actions one can perform


on the record, given permissions.

@(PreviousAlarmState) Writes the previous alarm state.

04-17005-03-en, October 2015 System


871
31 Alarm Functions
31.37 Substitution Codes for Notifications

Continued
Code Description

@(Priority) Writes the current priority level of the alarm


state.

@(ProcessId) Writes the process identifier configured by


the notification for a BACnet alarm.

@(ReferencedBitString) Writes the new value of the monitored


bitstring property for a BACnet change of
bitstring alarm.

@(SEQNO) Writes the sequence number of the record.

@(SetpointValue) Writes the value of the setpoint when the


alarm condition occured for a BACnet
floating limit alarm.

@(Source) Writes the path of the source object.

@(SourceName) Writes the name of the source object that


generated the alarm.

@(SourceObject->DESCR) Writes the description property of the source


object.

@(SourceObject->NAME) Writes the name property of the source


object.

@(SourceObject->NOTE1) Writes the note 1 property of the source


object.

@(SourceObject->NOTE2) Writes the note 2 property of the source


object.

@(SourceServer) Writes the path to the server where the


source object is located.

@(StatusFlags) Writes the status flag of the object.

@(SystemAlarmId) Writes the alarm ID generated by the system.

@(TenantNdx) Writes the tenant number of the individual


whose key/card was used at the I/NET door
point.

@(TimeStamp) Writes the time and date when the event


was generated.

@(TriggeredTimestamp) Writes the time and date of the state transfer


from normal state to alarm state.

@(TYPE) Writes the record type.

System 04-17005-03-en, October 2015


872
31 Alarm Functions
31.38 Automatic Assignments

31.38 Automatic Assignments


A triggered alarm can be automatically assigned to a specific user or user group
that is most suited to correct the problem. An assigned alarm indicates to other
users that someone is working with the problem that caused the alarm. The name
of the user that is assigned to the alarm and the assignment status are displayed in
the Alarms pane, Events pane, Alarm Views and Event Views.
You can create automatic assignments for recipients whose user accounts reside
on the same SmartStruxure server as the automatic assignment.
When creating an automatic assignment, you configure the condition that needs to
occur before Building Operation sends the assignment request. For example, a
condition could be when any alarm in a specific category group changes its state
from normal state to alarm state.
You can apply a schedule or other multistate variable to enable or disable the
automatic assignment. This multistate variable could be used to assign an alarm to
different users depending on the time. The variable you connect to the assignment
must contain an active value greater than zero.
For example, a schedule is configured to generate the value 2 between 06:30-
18:00 and the value 4 between 18:00-06:30. The schedule is connected to two
assignments with the same conditions. One assignment sends an assignment
request to the ordinary operator when the schedule generates value 2. The other
assignment is active when the schedule generates value 4, and sends the
assignment request to the night watch. If an alarm is triggered at 20:00 that fulfills
the condition of the two assignments, an assign request is automatically sent to the
night watch.

04-17005-03-en, October 2015 System


873
31 Alarm Functions
31.39 Creating an Automatic Assignment

31.39 Creating an Automatic Assignment


You create an automatic assignment to automatically assign alarms to a specific
user or user group.
For more information, see section 31.38 Automatic Assignments on page 873.

To create an automatic assignment


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where you want to create the assignment.
2. On the File menu, point to New and then click Assignment.
3. In the Name box, type a name for the assignment.

4. In the Description box, type a description for the assignment.


5. Click Next.
Continued on next page

System 04-17005-03-en, October 2015


874
31 Alarm Functions
31.39 Creating an Automatic Assignment

6. In the Status box, select Enabled to activate the assignment.

7. Enter a schedule or other multistate variable to activate the notification:


In the Schedule box, enter the schedule or other multistate variable that
contains the value that activates the assignment.
In the Active value box, enter the value, generated by the connected
schedule or other multistate variable, that activates the assignment.
8. In the Assigned to box, click the browse button to open the dialog box
where you select the user or user group that is to receive the assignment
request.

Important
You can only select users or user groups that reside on the same
Enterprise Server or Automation Server as the automatic assignment.

Continued on next page

04-17005-03-en, October 2015 System


875
31 Alarm Functions
31.39 Creating an Automatic Assignment

9. In the Domain box, select the domain that the users or user groups belong
to.

10. Select the users or user groups that are to receive the assignment request.
11. Click Add.
12. Click OK.

13. Click the Add Condition button to set up the conditions that generate
the assignment.
14. Enter the settings of the condition.

Tip
You can add several assignment conditions to specify when to write
the assignment.

15. Click the Add row button to add another condition of the same condition
type.
16. Click Create.

System 04-17005-03-en, October 2015


876
31 Alarm Functions
31.40 Unit of Measure in Alarms

31.40 Unit of Measure in Alarms


When creating an alarm, the alarm limit and deadband values inherit the unit of the
monitored variable. You can change the unit of the alarm to any unit within the same
unit category as the monitored variable.

Note
You cannot define a unit to an alarm that monitors a unitless variable.

If the unit of a monitored variable is replaced by a unit within the same unit category
as the unit of the alarm, Building Operation automatically handles the conversion. If
the unit of the monitored variable is replaced by a unit that belongs to another unit
category, the alarm is disabled by Building Operation. Building Operation triggers a
system alarm to notify that the alarm is disabled due to an impossible unit
conversion.

04-17005-03-en, October 2015 System


877
31 Alarm Functions
31.41 Configuring the Limits of an Alarm

31.41 Configuring the Limits of an Alarm


You configure the limits of an alarm to adjust when an alam triggers or resets.

To configure the limits of an alarm


1. In WorkStation, in the System Tree pane, select the alarm you want to
configure.
2. Click the Alarm Trigger tab.
3. In the Alarm limit boxes, enter the limits for the alarm.

4. In the Changes have been made dialog box, click Yes to save the
changes.

System 04-17005-03-en, October 2015


878
31 Alarm Functions
31.42 Configuring the Flashing of an Alarm

31.42 Configuring the Flashing of an Alarm


You configure an alarm to flash in the Alarms pane and Alarm view when it is
triggered, so that the operator can see the alarm more easily.

To configure the flashing of an alarm


1. In WorkStation, in the System Tree pane, select the alarm you want to
configure.
2. Click the Presentation tab.
3. Select Flashing to make the alarm flash in the Alarms pane and Alarm Views
when it is triggered.

4. Click the Save button .

04-17005-03-en, October 2015 System


879
31 Alarm Functions
31.43 Configuring the Audibility of an Alarm

31.43 Configuring the Audibility of an Alarm


You configure an alarm to make a sound when it is triggered so that the operator
can hear the alarm.

To configure the audibility of an alarm


1. In WorkStation, in the System Tree pane, select the alarm you want to
configure.
2. Click the Presentation tab.
3. Select Audible alert to make the alarm sound when it is triggered.

4. Click the Save button .

System 04-17005-03-en, October 2015


880
31 Alarm Functions
31.44 Configuring the Audibility of an Alarm in Reset State

31.44 Configuring the Audibility of an Alarm in


Reset State
You configure an alarm to make a sound when it is in reset state and alarm state so
that the operator can hear the alarm.

To configure the audibility of an alarm in reset state


1. In WorkStation, in the System Tree pane, select the alarm you want to
configure.
2. Click the Presentation tab.
3. Select Audible alert to make the alarm sound when it is triggered.

4. Click the Save button


5. In the computer file system, locate the file named
SE.SBO.WorkStation.exe.config in the folder where WorkStation is installed.
6. Open the SE.SBO.WorkStation.exe.config file in a text editor.
Continued on next page

04-17005-03-en, October 2015 System


881
31 Alarm Functions
31.44 Configuring the Audibility of an Alarm in Reset State

7. On the row saying: <add key="AudibleAlertOnResetState"


value="false"/>, replace the word "false" with "true" to make the alert
audible when an alarm is in reset state.

8. On the File menu, click Save to save the changes you made to the file.
9. Restart WorkStation.

System 04-17005-03-en, October 2015


882
32 User Actions

Topics
Comments
Cause Notes
Creating a Cause Note
Editing a Cause Note
Adding a Cause Note to an Alarm
Action Notes
Creating an Action Note
Editing an Action Note
Adding an Action Note to an Alarm
Checklists
Creating a Checklist
Editing a Checklist
Adding a Checklist to an Alarm
32 User Actions
32.1 Comments

32.1 Comments
Use comments to save written information about an alarm. Comments can be
added and viewed at any time. A comment is automatically tagged with the user
name and a time and date stamp. Useful comments could be the cause of the
alarm and how it was taken care of. Information like this can be of great help the
next time the same alarm is triggered.

Figure: A comment is added to a triggered alarm


Writing a comment is either voluntary or mandatory. You can configure the alarm so
the user is required to write a comment when certain events occur, such as when
an alarm is disabled.

04-17005-03-en, October 2015 System


885
32 User Actions
32.2 Cause Notes

32.2 Cause Notes


A cause note specifies the problem that caused the alarm. Cause notes are
grouped by category, with possible alarm causes listed in each group. When an
alarm is triggered, you can easily report the causes that triggered the alarm by
selecting the predefined choices.

Figure: Cause Notes dialog box


Reporting the cause of the alarm is either voluntary or mandatory. You can
configure the alarm so the user is required to report the causes when certain events
occur, such as when an alarm is disabled.
Cause notes can be of great use the next time the same alarm is triggered or when
extracting alarm statistics.

System 04-17005-03-en, October 2015


886
32 User Actions
32.3 Creating a Cause Note

32.3 Creating a Cause Note


You create a cause note to connect it to an alarm, and to simplify the reporting of
the causes that triggered the alarm.
For more information, see section 32.2 Cause Notes on page 886.

To create a cause note


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Cause notes.

4. In the Cause notes view, click the Add cause note button .

Continued on next page

04-17005-03-en, October 2015 System


887
32 User Actions
32.3 Creating a Cause Note

5. In the Add Cause Note dialog box, in the Name box, type the name of the
new cause note.

6. In the Group name box, type a name to create a new group or select an
existing group that the new cause note belongs to.
7. In the Description box, type a description for the cause note.
8. Click OK.

9. Click the Save button .

System 04-17005-03-en, October 2015


888
32 User Actions
32.4 Editing a Cause Note

32.4 Editing a Cause Note


You edit an existing cause note to change the name or the descriptions, or add the
cause note to another cause note group.

To edit a cause note


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Cause notes.


4. In the Cause notes view, select the cause note you want to edit.

Continued on next page

04-17005-03-en, October 2015 System


889
32 User Actions
32.4 Editing a Cause Note

5. Click the Edit cause note button .

Note
To permanently remove a cause note from the cause notes list,

click the Remove cause note button .

6. In the Edit Cause Note dialog box, in the Name box, type a name for the
cause note.

7. In the Group name box, type a name to create a new group or select an
existing group.
8. In the Description box, type a description for the cause note
9. Click OK.

10. Click the Save button .

System 04-17005-03-en, October 2015


890
32 User Actions
32.5 Adding a Cause Note to an Alarm

32.5 Adding a Cause Note to an Alarm


You add a cause note to an alarm to report the cause of the alarm.
For more information, see section 32.2 Cause Notes on page 886.

To add a cause note to an alarm


1. In WorkStation, in the System Tree pane, select the alarm object to which
you want to add a cause note.
2. In the User action view, in the Cause note group box, enter the cause
note you want to add to the alarm.

3. Click the Save button .


To add a cause note to an alarm you must have created one in advance and
defined its content.

04-17005-03-en, October 2015 System


891
32 User Actions
32.6 Action Notes

32.6 Action Notes


Action notes are grouped by category, with possible actions that may correct the
problem listed in each category. An action note specifies the actions that you used
to correct the problem that caused the alarm.

Figure: Action Notes dialog box


Reporting the actions that were taken is either voluntary or mandatory. You can
configure the alarm so the user is required to report the actions when certain events
occur, such as when an alarm is disabled.
Action notes can be of great use the next time the same alarm is triggered or when
extracting alarm statistics.

System 04-17005-03-en, October 2015


892
32 User Actions
32.7 Creating an Action Note

32.7 Creating an Action Note


You create an action note to connect it to an alarm, and to simplify the reporting of
actions taken when correcting the problem that triggered the alarm.
For more information, see section 32.6 Action Notes on page 892.

To create an action note


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Action notes.

4. In the Action notes view, click the Add action note button .

Continued on next page

04-17005-03-en, October 2015 System


893
32 User Actions
32.7 Creating an Action Note

5. In the Add Action Note dialog box, in the Name box, type the name of the
new action note.

6. In the Group name box, type a name to create a new group or select an
existing group.
7. In the Description box, type a description for the action note.
8. Click OK.

9. Click the Save button .

System 04-17005-03-en, October 2015


894
32 User Actions
32.8 Editing an Action Note

32.8 Editing an Action Note


You edit an existing action note to change the name or the descriptions, or to add
the action note to another group.

To edit an action note


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Action notes.


4. In the Action notes view, select the action note you want to edit.

Continued on next page

04-17005-03-en, October 2015 System


895
32 User Actions
32.8 Editing an Action Note

5. Click the Edit action note button .

Note
To permanently remove an action note from the action notes list,

click the Remove action note button .

6. In the Edit Action Note dialog box, in the Name box, type a name for the
action note.

7. In the Group name box, type a name to create a new group or select an
existing group.
8. In the Description box, type a description for the action note.
9. Click OK.

10. Click the Save button .

System 04-17005-03-en, October 2015


896
32 User Actions
32.9 Adding an Action Note to an Alarm

32.9 Adding an Action Note to an Alarm


You add an action note to an alarm to troubleshoot and report the problem that
triggered the alarm.
For more information, see section 32.6 Action Notes on page 892.

To add an action note to an alarm


1. In WorkStation, in the System Tree pane, select the alarm object to which
you want to add an action note.
2. In the User action view, in the Action note group box, enter the action
note you want to add to the alarm.

3. Click the Save button .


To add a checklist to an alarm you must have created one in advance and defined
its content.

04-17005-03-en, October 2015 System


897
32 User Actions
32.10 Checklists

32.10 Checklists
A checklist is a set of steps that guides the user to which action to take when an
alarm is triggered. If an alarm goes to normal state, the corresponding checklist is
also reset and each step has to be checked again.

Figure: Checklist dialog box


Checklists can be voluntary or mandatory. You can force the user to check each
step in the checklist before the alarm can be acknowledged.

System 04-17005-03-en, October 2015


898
32 User Actions
32.11 Creating a Checklist

32.11 Creating a Checklist


You create a checklist to connect it to an alarm, and to guide the user when
troubleshooting a triggered alarm.
For more information, see section 32.10 Checklists on page 898.

To create a checklist
1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Checklists.

4. In the Checklist view, click the Add checklist button .

Continued on next page

04-17005-03-en, October 2015 System


899
32 User Actions
32.11 Creating a Checklist

5. In the Add Checklist dialog box, in the Name box, type the name of the new
checklist.

6. In the Description box, type a description for the checklist.

7. Click the Add step button .


8. In the Add Checklist Step dialog box, in the Name box, type the text for the
step to create.

9. Click OK.

Note
You can add several steps to the checklist.

10. In the Add Checklist dialog box, click OK.

11. Click the Save button .

System 04-17005-03-en, October 2015


900
32 User Actions
32.12 Editing a Checklist

32.12 Editing a Checklist


You edit a checklist to change the description of a step, or to rearrange the step
order.

To edit a checklist
1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Checklists.
Continued on next page

04-17005-03-en, October 2015 System


901
32 User Actions
32.12 Editing a Checklist

4. In the Checklist view, click the Edit checklist button .

Note
To permanently remove a checklist, click the Remove

checklist button .

5. In the Edit Checklist dialog box, in the Name box, type the name of the new
checklist.

6. In the Description box, type a description for the checklist.

7. Select a step in the checklist and click the Edit step button to edit the
checklist step.

Note
In the Edit checklist step dialog box you can add new steps
to the checklist by clicking the Add step button, or remove

existing steps by clicking the Remove step button .

Continued on next page

System 04-17005-03-en, October 2015


902
32 User Actions
32.12 Editing a Checklist

8. In the Edit checklist step dialog box, in the Name box, type the new text
for the step.
9. Click OK.

10. Select a step in the checklist and click the Move step up button to
move the step upwards in the checklist.

11. Select a step in the checklist and click the Move step down button to
move the step downwards in the checklist.
12. In the Edit Checklist dialog box, click OK.

13. Click the Save button .

04-17005-03-en, October 2015 System


903
32 User Actions
32.13 Adding a Checklist to an Alarm

32.13 Adding a Checklist to an Alarm


You add a checklist to an alarm to troubleshoot the problem that triggered the
alarm.
For more information, see section 32.10 Checklists on page 898.

To add a checklist to an alarm


1. In WorkStation, in the System Tree pane, select the alarm object to which
you want to add a checklist.
2. In the User Action view, in the Checklist box, enter the checklist you want
to add to the alarm.

3. Click the Save button .


To add a cause note to an alarm you must have created one in advance and
defined its content.

System 04-17005-03-en, October 2015


904
33 Alarms User Interface

Topics
Alarms Pane and Alarm View
Alarms Pane and Alarm View Toolbar
Alarms Pane and Alarm View Icons
Alarm and Event Detail View
Add/Remove Columns Dialog Box (Alarms)
Add/Remove Conditions Dialog Box (Alarms)
Alarm System Tree Icons
Change of State Alarm Properties Basic Tab
Change of State Alarm Properties Advanced Tab
Enumeration Alarm Properties Basic Tab
Enumeration Alarm Properties Advanced Tab
Matching Text String Alarm Properties Basic Tab
Matching Text String Alarm Properties Advanced Tab
Multistate Alarm Properties Basic Tab
Multistate Alarm Properties Advanced Tab
Out of Range Alarm Properties Basic Tab
Out of Range Alarm Properties Advanced Tab
Out of Reference Range Alarm Properties Basic Tab
Out of Reference Range Alarm Properties Advanced Tab
Sum Alarm Properties Basic Tab
Sum Alarm Properties Advanced Tab
Variable Status Alarm Properties Basic Tab
Variable Status Alarm Properties Advanced Tab
Function Block Program Internal Alarm Properties - Basic
Tab
Function Block Program Internal Alarm Properties -
Advanced Tab
Create Alarm Wizard Presentation Page
Create Alarm Wizard User Action Page
Create Alarm Wizard Attachment Page
Create Change of State Alarm Wizard Alarm Trigger Page
Create Multistate Alarm Wizard Alarm Trigger Page
Create Matching Text String Alarm Wizard Alarm Trigger
Page
Create Out of Range Alarm Wizard Alarm Trigger Page
Create Out of Reference Range Alarm Wizard Alarm
Trigger Page
Create Sum Alarm Wizard Alarm Trigger Page
Create Enumeration Alarm Wizard Alarm Trigger Page
Create Variable Status Alarm Wizard Alarm Trigger Page
Create Attachment Wizard Configure Attachment Page
Alarm Trigger Properties - Basic Tab
Alarm Trigger Properties Range Tab
Alarm Trigger Properties Value tab
Alarm Trigger Properties Value tab
Attachment Properties
Alarm Control Panel Properties
User Action Properties
Alarm Styles View
Alarm Styles Properties
Acknowledged Style Properties
Alarm Style Properties
Disabled Style Properties
Fault Style Properties
Reset Style Properties
Alarm Control Panel Categories View
Add Category Dialog Box
Edit Category Dialog Box
Category Properties
Categories Properties
Alarm Control Panel Cause Notes View
Add Cause Note Dialog Box
Edit Cause Note Dialog Box
Cause Notes Properties
Cause Note Group Properties
Cause Note Properties
Alarm Control Panel Action Notes View
Add Action Note Dialog Box
Edit Action Note Dialog Box
Action Notes Properties
Action Note Group Properties
Action Note Properties
Alarm Control Panel Checklists View
Add Checklist Dialog Box
Edit Checklist Dialog Box
Add Checklist Step Dialog Box
Edit Checklist Step Dialog Box
Checklists Properties
Checklist Properties
Checklist Step Properties
Alarm Basic Settings View
Select Conditions Dialog Box Alarm Filter Properties
Select Conditions Dialog Box (Alarms User Filter)
Create Client Notification Wizard Client Notification Page
Client Notification View
Client Notification Properties
Create Email Notification Wizard Email Notification Page
Email Notification View
Email Notification Properties
Create SNMP Notification Wizard SNMP Notification Page
SNMP Notification View
SNMP Notification Properties
Create Write to File Notification Wizard Write to File Notification
Page
Write to File Notification View
Write to File Notification Properties
Create Assignment Wizard Assignment Page
Assignment View
Assignment Properties
Users and Groups Dialog Box
Alarm View Properties
Progress View
Alarm Handling Properties
Alarms Pane Shortcut Menu
Alarms Pane Shortcut Menu - Alarm View Settings Submenu
33 Alarms User Interface
33.1 Alarms Pane and Alarm View

33.1 Alarms Pane and Alarm View


Use the Alarms pane and Alarm View to survey and manage alarms.

Figure: Alarms pane

Table: Alarms Pane and Alarm View


Number Description

Use the toolbar to acknowledge, hide, show


and comment alarms. For more information,
see section 33.2 Alarms Pane and Alarm
View Toolbar on page 910.

Use the columns to sort, show, and hide


information about the triggered alarms. For
more information, see the Add/Remove
Columns Dialog Box topic on WebHelp.

Use the list to get information about a


triggered alarm and its current status. For
more information, see section 33.3 Alarms
Pane and Alarm View Icons on page 912.

04-17005-03-en, October 2015 System


909
33 Alarms User Interface
33.2 Alarms Pane and Alarm View Toolbar

33.2 Alarms Pane and Alarm View Toolbar


Use the Alarms pane and Alarm View toolbar to manage the alarms.

Table: Alarms Pane and Alarm View Toolbar


Button Description

Acknowledge
Click to acknowledge alarm state or reset
state.
For more information, see the Alarm
Acknowledgements topic on WebHelp.

Enable alarm
Click to enable the alarm. If the alarm state
changed, for example, from alarm state to
normal state during the time the alarm was
disabled, the alarm is given the new state
once it is enabled.
For more information, see the Disable and
Enable Alarms topic on WebHelp.

Disable alarm
Click to disable the alarm. The alarm is
inactivated and cannot be acknowledged or
reset until it is enabled.
For more information, see the Disable and
Enable Alarms topic on WebHelp.

Unhide alarm
Click to show the alarm.
For more information, see the Hide and
Show Alarms topic on WebHelp.

Hide alarm
Click to hide the alarm in the Alarms pane or
Alarm View. The alarm is still logged in the
Event log.
For more information, see the Hide and
Show Alarms topic on WebHelp.

Add comment
Click to add a comment to the alarm.
For more information, see the Alarm
Comments topic on WebHelp.

Add cause note


Click to add a cause note to the alarm.
For more information, see the Cause Notes
topic on WebHelp.

System 04-17005-03-en, October 2015


910
33 Alarms User Interface
33.2 Alarms Pane and Alarm View Toolbar

Continued
Button Description

Add action note


Click to add an action note to the alarm.
For more information, see the Action Notes
topic on WebHelp.

Checklist
Click to view the checklist for the alarm.
For more information, see the Checklists
topic on WebHelp.

Show disabled alarms


Click to toggle between showing and hiding
disabled alarms.
For more information, see the Disable and
Enable Alarms topic on WebHelp.

Show hidden alarms


Click to toggle between hiding alarms and
showing hidden alarms.
For more information, see the Hide and
Show Alarms topic on WebHelp.

Go to alarm object
Click to open the settings of the alarm in the
Work Area.

Group box
Click to display the Show/Hide Group box to
group and sort objects. For more
information, see the Group and Sort Objects
topic on WebHelp.

Edit user filter


Click to select the conditions for the
temporary alarm display in the Alarms pane.
When you close the view, the filter conditions
are lost. For more information, see section
29.8 Alarm Filter Conditions on page 685.

Favorites (in WorkStation)


Click to open the Favorites menu where you
select, add and manage favorites.

Detail view
Click to display detailed information about all
properties of a selected event, in an added
view. For more information, see section 33.4
Alarm and Event Detail View on page 913.
For more information, see the Alarm and
Event Details topic on WebHelp.

04-17005-03-en, October 2015 System


911
33 Alarms User Interface
33.3 Alarms Pane and Alarm View Icons

33.3 Alarms Pane and Alarm View Icons


Use the alarm state icons in the Alarms pane and Alarm View to get information
about the state of the alarms.

Table: Alarms Pane and Alarm View Icons


Icon Description

Normal
Indicates that the alarm is idle and the
variable the alarm monitors does not satisfy
the configured alarm criteria. For more
information, see section 29.2 Alarm States
on page 675.

Alarm
Indicates that an alarm is triggered. For more
information, see section 29.2 Alarm States
on page 675.

Acknowledged
Indicates that a user has acknowledged the
alarm. The problem that caused the alarm
has not been corrected. For more
information, see section 29.2 Alarm States
on page 675.

Reset
Indicates that the problem that caused the
alarm is corrected. A user needs to
acknowledge the alarm to change the alarm
state to normal. For more information, see
section 29.2 Alarm States on page 675.

Disabled
Indicates that the alarm is disabled by a
user. Disabled alarms are by default hidden
in the Alarms pane and Alarm View. For
more information, see section 29.2 Alarm
States on page 675.

Fault
Indicates that the value reported from
hardware, such as a BACnet device, is not
trustworthy. For more information, see
section 29.2 Alarm States on page 675.

Attachment
Indicates that the alarm has an object
attached. For more information, see section
31.21 Alarm Attachments on page 839.

System 04-17005-03-en, October 2015


912
33 Alarms User Interface
33.4 Alarm and Event Detail View

33.4 Alarm and Event Detail View


Use the Detail view to view all properties of a selected alarm or event.

Figure: Detail view (here, in the Alarms pane)

Table: Alarm and Event Detail View


Component Description

Quick filter Enter a word or a character to filter on. For


more information, see section 49.6 Quick
Filter on page 1571.

Property Displays all possible columns of the selected


alarm or event.

Value Displays the value.

04-17005-03-en, October 2015 System


913
33 Alarms User Interface
33.5 Add/Remove Columns Dialog Box (Alarms)

33.5 Add/Remove Columns Dialog Box


(Alarms)
Use the Add/Remove Columns dialog box to add or remove columns from the
Alarms pane or an alarm view.

Figure: Add/Remove Columns dialog box

Table: Add/Remove Columns Dialog Box


Component Description

Acknowledge time Select to display the time and date when the
alarm was acknowledged. For more
information, see the Alarm
Acknowledgements topic on WebHelp.

Acknowledged by Select to display the name of the individual


who acknowledged the alarm. For more
information, see the Alarm
Acknowledgements topic on WebHelp.

Acknowledgement required Select to display the required


acknowledgement to acknowledge the
alarm. For more information, see the Alarm
Acknowledgements topic on WebHelp.

Alarm state Select to display the state of the alarm. For


more information, see section 29.2 Alarm
States on page 675.

Alarm text Select to display the alarm message that is


added to the alarm. For more information,
see section 31.6 Alarm Messages on page
818.

System 04-17005-03-en, October 2015


914
33 Alarms User Interface
33.5 Add/Remove Columns Dialog Box (Alarms)

Continued
Component Description

Assigned state Select to display the assigned state of the


alarm. For more information, see the Alarm
Assignments topic on WebHelp.

Assigned to domain Select to display the domain of the user or


user group that an alarm is assigned to. For
more information, see section 21.1
Domains on page 459.

Assigned to ID Select to display the ID of the user or group


that an alarm was assigned to.

Assigned to name Select to display the name of the user or


user group that an alarm has been assigned
to.

BACnet alarm type Select to display the BACnet alarm type of


the alarm that monitored a variable within a
BACnet network.

BACnet notification Select to display the distribution information


of an alarm notification within a BACnet
system

BACnet notification type Select to display the distribution information


type of an alarm notification within a BACnet
system..

Basic evaluation state Select to display the basic evaluation state of


an alarm. The value True indicates that an
alarm is triggered.

Category Select to display the alarm category name.

Command value Select to display the value that was


commanded.

Confirmed notification Select to display whether or not the Building


Operation server that received transmission
of data has sent a confirmation to the
sending device that the data has been
received.

Count Select to display the number of times an


alarm has toggled between the alarm and
reset state. For more information, see the
Count topic on WebHelp.

Deadband Select to display the deadband value of the


alarm.

Device name Select to display the name of the I/NET


device that generated the alarm.

Disabled by Select to display the name of the user who


disabled the alarm.

04-17005-03-en, October 2015 System


915
33 Alarms User Interface
33.5 Add/Remove Columns Dialog Box (Alarms)

Continued
Component Description

Disabled cause Select to display the cause for disabling the


alarm. An alarms can be disabled by a user,
a shunt variable, or, if incorrectly configured,
by the system.

Error limit Select to display the difference limit that was


exceeded.

Evaluation state Select to display the evaluation state of an


alarm. For example, Upper limit alarm is
displayed if the monitored variable reached
the upper alarm limit.

Event from state Select to display the event state after the
occurrence that initiated the notification.

EWS ID Select to display the EcoStruxure Web


Service identification of the alarm in the
external system.

EWS source ID Select to display the EcoStruxure Web


Service identification of the external object
that generated the alarm.

Exceeded limit Select to display the limit that was


exceeded.

Exceeding value Select to display the value that exceeded the


limit.

Feedback value Select to display the value that differs from


the Command value.

First name Select to display the first name of the


individual whose key/card was used at the
I/NET door point.

Hidden Select to display the visible status of an


object. False is displayed when an object is
shown.

Individual Select to display the individual number of the


individual whose key/card was used at the
I/NET door point.

Last name Select to display the last name of the


individual whose key/card was used at the
I/NET door point.

Logging Select to display whether or not associated


alarm events are generated and recorded in
the event log.

Message text Select to display the text of an I/NET action


or dispatch message, if there is one.

Monitored variable Select to display the path of the monitored


variable.

System 04-17005-03-en, October 2015


916
33 Alarms User Interface
33.5 Add/Remove Columns Dialog Box (Alarms)

Continued
Component Description

New mode Select to display the new mode of the


referenced object.

New state Select to display the new state of the


referenced object.

New value Select to display the new value of the


referenced property.

Operation expected Select to display the next operation


requested by the referenced object.

Possible operator actions Select to display the actions available to the


operator.

Previous alarm state Select to display the previous alarm state of


an alarm.

Priority Select to display the priority of an alarm.

Process ID Not used.

Reference bit string Select to display the new value of the


referenced bitstring property.

Sequence number Select to display the alarm sequence


number on the present Building Operation
server.

Setpoint value Select to display the value of the reference


variable.

Sigma event parameters Select to display parameters of the Sigma


event that generated the alarm.

Sigma event type Select to display the type of Sigma event


that generated the alarm.

Source Select to display path of the source object.

Source name Select to display the name of the source


object.

Source server Select to display the server path of the


source object.

Status flags Select to display the status flag of the object.

System alarm ID Select to display the alarm ID generated by


the system.

Tenant Select to display tenant number of the


individual whose key/card was used at the
I/NET door point.

Timestamp Select to display the time and date when the


alarm was generated.

04-17005-03-en, October 2015 System


917
33 Alarms User Interface
33.5 Add/Remove Columns Dialog Box (Alarms)

Continued
Component Description

Triggered time Select to filter alarms by the time and date


the alarm went from normal state to alarm
state.

Type Select to display the alarm type. For more


information, see section 50.34 General
Properties Basic Tab on page 1642.

Value at change Select to display the value the monitored


variable had when the alarm was triggered.

System 04-17005-03-en, October 2015


918
33 Alarms User Interface
33.6 Add/Remove Conditions Dialog Box (Alarms)

33.6 Add/Remove Conditions Dialog Box


(Alarms)
Use the Add/Remove Conditions dialog box to add or remove conditions from
the Alarms pane or an Alarm View.

Figure: Add/Remove Conditions dialog box

Table: Add/Remove Conditions Dialog Box


Component Description

Acknowledge time Select to filter by the time and date the alarm
was acknowledged.

Acknowledged by Select to filter by the name of the user that


acknowledged the alarm. Wildcards can be
used. For more information, see section 34.8
Filter Condition Wildcards on page 1102.

Acknowledgement required Select to filter BACnet alarms by whether the


notification requires acknowledgement.
True specifies that an acknowledgement is
required.

Alarm state Select to filter alarms by the present state of


the alarm.

Alarm text Select to filter alarms by the alarm messages


that are added to the alarm. Wildcards can
be used. For more information, see section
34.8 Filter Condition Wildcards on page
1102.

04-17005-03-en, October 2015 System


919
33 Alarms User Interface
33.6 Add/Remove Conditions Dialog Box (Alarms)

Continued
Component Description

Assigned state Select to filter alarms that have been


assigned to and accepted by any user or
group.

Assigned to domain Select to filter alarms by the domain of the


user or group that the alarm is assigned to.
Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

Assigned to ID Select to filter alarms by the ID of the user or


group that the alarm is assigned to.
Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

Assigned to name Select to filter alarms by the name of the


user or group that the alarm is assigned to.
Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

BACnet alarm type Select to filter alarms by the BACnet alarm


that monitors a variable within a BACnet
network.

BACnet notification Select to filter alarms by the BACnet


Notification Class of the event.

BACnet notification type Select to filter alarms by the BACnet


notification, whether the notification is an
event or an alarm.

Basic evaluation state Select to filter alarms by the current


evaluation state of the alarm. True indicates
that the alarm is triggered.

Category Select to filter alarms by the category name


of the alarm. Wildcards can be used. For
more information, see section 34.8 Filter
Condition Wildcards on page 1102.

Command value Select to filter alarms by the value that was


commanded.

Confirmed notification Select to filter alarms by the request requires


acknowledgement, by the recipient's
computer.

Count Select to filter alarms by the number of times


the alarm has toggled between the alarm
and reset state.

Deadband Select to filter alarms by the deadband value


of the alarm.

System 04-17005-03-en, October 2015


920
33 Alarms User Interface
33.6 Add/Remove Conditions Dialog Box (Alarms)

Continued
Component Description

Device name Select to filter events by the name of the


I/NET device that generated the alarm.
Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

Disabled by Select the property to filter alarms by the


name of the user who disabled the alarm.

Disabled cause Select the property to filter alarms by the


cause for disabling the alarm. An alarm is
either disabled by user, shunt variable, or if
the alarm is incorrectly configured.

Error limit Select to filter alarms by the difference limit


that was exceeded.

Evaluation state Select to filter alarms by the present


evaluation state of the alarm. For example,
Upper limit alarm is displayed when the
monitored value reaches the upper alarm
limit.

Event from state Select to filter alarms by the BACnet From


State. The From State indicates the Event
State of the object prior to the occurrence of
the event that initiated the notification.

EWS ID Select to filter alarms by the ID the alarm has


on the external system. Wildcards can be
used. For more information, see section 34.8
Filter Condition Wildcards on page 1102.

EWS source ID Select to filter alarms by the external ID of


the object that generated the alarm.
Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

Exceeded limit Select to filter alarms by the limit that was


exceeded.

Exceeding value Select to filter alarms by the value that


exceeded a limit.

Feedback value Select to filter alarms by the value that differs


from the Command value.

First name Select to filter alarms by the first name of the


individual whose key/card was used at the
I/NET door point. Wildcards can be used.
For more information, see section 34.8 Filter
Condition Wildcards on page 1102.

Hidden Select to filter alarms by the visible status.


True is displayed when the object is hidden.

04-17005-03-en, October 2015 System


921
33 Alarms User Interface
33.6 Add/Remove Conditions Dialog Box (Alarms)

Continued
Component Description

Individual Select to filter alarms by the individual


number of the individual whose key/card
was used at the I/NET door point.

Last name Select to filter alarms by the last name of the


individual whose key/card was used at the
I/NET door point. Wildcards can be used.
For more information, see section 34.8 Filter
Condition Wildcards on page 1102.

Logging Select to filter alarms by whether or not


associated alarm events are generated and
recorded in the Event log.

Message text Select to filter alarms by a message of up to


64 characters that has been assigned to the
I/NET point.

Monitored variable Select to filter alarms by the monitored


variable. Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

New mode Select to filter alarms by the new mode of


the referenced object.

New state Select to filter alarms by the new state of the


referenced property.

New value Select to filter alarms by the new value of the


referenced property. Wildcards can be used.
For more information, see section 34.8 Filter
Condition Wildcards on page 1102.

Operation expected Select to filter alarms by the next operation


requested by the referenced object.

Possible operator actions Select to filter alarms by the possible actions


one can perform on the record, given
permissions.

Previous alarm state Select to filter alarms by the previous state of


the alarm.

Priority Select to filter alarms by the current priority


level of the alarm state.

Process ID Select to filter alarms by the unique process


ID in the receiving device for which a BACnet
notification is intended.

Referenced bit string Select to filter alarms by the new value of the
referenced bit string property. Wildcards can
be used. For more information, see section
34.8 Filter Condition Wildcards on page
1102.

System 04-17005-03-en, October 2015


922
33 Alarms User Interface
33.6 Add/Remove Conditions Dialog Box (Alarms)

Continued
Component Description

Referenced value Select to filter alarms by the value of the


referenced property.

Setpoint value Select to filter alarms by the value of the


reference variable.

Sigma event parameters Select to filter alarms by the Sigma event


parameter. Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

Sigma event type Select to filter alarms by the Sigma event


type.

Source Select to filter alarms by the path of the


source object. Wildcards can be used. For
more information, see section 34.8 Filter
Condition Wildcards on page 1102.

Source name Select to filter alarms by the external name of


the object that generated the alarm.
Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

Source server Select to filter alarms by the path where the


alarm is located. Wildcards can be used. For
more information, see section 34.8 Filter
Condition Wildcards on page 1102.

Status flags Select to filter alarms by the status flag.

System alarm ID Select to filter alarms by the alarm ID


generated by the system.

Tenant Select to filter alarms by the tenant number


of the individual whose key/card was used at
the I/NET door point.

Timestamp Select to filter alarms by the time and date.

Triggered time Select to filter alarms by the time and date of


the last state transfer from normal state to
alarm state.

Type Select to filter alarms by the type of the


object.

Value at change Select to filter alarms by the value of the


monitored variable. Wildcards can be used.
For more information, see section 34.8 Filter
Condition Wildcards on page 1102.

04-17005-03-en, October 2015 System


923
33 Alarms User Interface
33.7 Alarm System Tree Icons

33.7 Alarm System Tree Icons


This section describes the icons in WorkStation.
Icon Description

Alarm control panel


Contains the alarm handling and alarm style
objects. For more information, see section
29.1 Alarms Overview on page 673.
Alarm
Indicates that the object is an alarm. For
more information, see section 30.1 Alarm
Types on page 699.

Alarm handling
Indicates alarm handling objects that can be
connected to an alarm. For more
information, see section 29.3 Alarm
Functions on page 676.

Disabled alarm
Indicates that the alarm has been disabled.
The icon is displayed regardless of how the
larm got disabled. For more information, see
section 29.1 Alarms Overview on page
673.

Action note
Indicates the object is an action note. For
more information, see section 32.6 Action
Notes on page 892.

Category
Indicates the object is a category that you
can use to group together alarms. For more
information, see the Categories topic on
WebHelp.

Cause note
Indicates the object is a cause note. For
more information, see section 32.2 Cause
Notes on page 886.

Checklists
Indicates the object is a checklist. For more
information, see section 32.10 Checklists
on page 898.

Alarm style
Indicates the object controls the visual style
of an alarm state in the Alarms pane and
Alarm Views. For more information, see
section 29.5 Alarms Pane and Alarm View
Customization on page 680.

System 04-17005-03-en, October 2015


924
33 Alarms User Interface
33.7 Alarm System Tree Icons

Continued
Icon Description

Assignment
Indicates the object is an assignment. For
more information, see section 31.38
Automatic Assignments on page 873.

Notification
Indicates the object is an E-mail notification
or a Write to file notification. For more
information, see section 31.27
Notifications on page 848.

04-17005-03-en, October 2015 System


925
33 Alarms User Interface
33.8 Change of State Alarm Properties Basic Tab

33.8 Change of State Alarm Properties


Basic Tab
Use the Basic tab to view or edit the basic properties of a change of state alarm.

Figure: Basic tab

Table: Basic Tab


Component Description

Alarm state Displays the present state of the alarm. For


more information, see section 29.2 Alarm
States on page 675.

Basic evaluation state Displays False when the alarm is in its


normal state.

Evaluation state Displays the present evaluation state of the


alarm. For example, Upper limit alarm is
displayed when the monitored value reaches
the upper alarm limit.

System 04-17005-03-en, October 2015


926
33 Alarms User Interface
33.8 Change of State Alarm Properties Basic Tab

Continued
Component Description

Disabled cause Displays the cause for the alarm being


disabled:
Shunt variable means that the alarm
has been disabled by a shunt variable
User means that the alarm has been
disabled by the user
System means that the alarm has
been disabled by the system

Reset delay (s) Enter the time, in seconds, the alarm has to
be within the reset criteria before the alarm
state is changed from alarm to reset.

Alarm delay (s) Enter the time, in seconds, the alarm has to
be within the alarm criteria before the alarm
is triggered.

Shunt variable 1 Enter the shunt variable that is used to


enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert shunt value 1 Select to invert the shunt value, that is,
enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Shunt operator Select AND or OR to add logic between the


first and the second shunt variable. For more
information, see section 31.3 Shunt
Variables on page 815.

Shunt variable 2 Enter the second shunt variable that is used


to enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert shunt value 2 Select to invert the shunt value, that is,
enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Alarm message Type the message to display when the alarm


is triggered.

Alarm priority Enter the priority level of the alarm.

Reset message Type the message to display when the alarm


is reset.

Reset priority Enter the priority level of the alarm when it is


reset.

04-17005-03-en, October 2015 System


927
33 Alarms User Interface
33.8 Change of State Alarm Properties Basic Tab

Continued
Component Description

Monitored variable Enter the path to the variable that is


monitored by the alarm.

Trigger value Select True to trigger the alarm when the


monitored value changes to true.

System 04-17005-03-en, October 2015


928
33 Alarms User Interface
33.9 Change of State Alarm Properties Advanced Tab

33.9 Change of State Alarm Properties


Advanced Tab
Use the Advanced tab to change the alarm properties of a change of state alarm.

Figure: Advanced tab

Table: Advanced Tab


Component Description

Acknowledgement type Select the type of acknowledgement for the


alarm.

Flashing alert Select to display a flashing alert in the Alarms


pane and the Alarm Views when the alarm is
triggered.

Audible alert Select to make an audible alert when the


alarm is triggered.

Category Enter the category that the alarm belongs to.

Cause note group Enter the cause note group that is used by
the alarm.

04-17005-03-en, October 2015 System


929
33 Alarms User Interface
33.9 Change of State Alarm Properties Advanced Tab

Continued
Component Description

Action note group Enter the action note group that is used by
the alarm.

Checklist Enter the checklist that belongs to the alarm.

Checklist required Select to force the user to check each step


in the checklist before the alarm can be
acknowledged.

Disable alarm Select to disable the alarm, for example,


before deployment.

Prefix for alarm source name Type a prefix that is added to the beginning
of the source name property of an alarm
record.

Edit
(Action Requirements)
Click to open the property pane where you
edit the selected user action. For more
information, see section 33.44 User Action
Properties on page 999.

Add
(Attachments)
Click to open the Create Object: Attachment
wizard, where you add an attachment. For
more information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

Edit
(Attachments)
Click to open the property pane where you
configure the attachment. For more
information, see section 33.42 Attachment
Properties on page 997.

Remove
(Attachments)
Click to remove an attachment that is
connected to the alarm.

System 04-17005-03-en, October 2015


930
33 Alarms User Interface
33.10 Enumeration Alarm Properties Basic Tab

33.10 Enumeration Alarm Properties Basic


Tab
Use the Basic tab to view or edit the basic properties of an enumeration alarm.

Figure: Basic tab

Table: Basic Tab


Component Description

Alarm state Displays the present state of the alarm. For


more information, see section 29.2 Alarm
States on page 675.

Basic evaluation state Displays False when the alarm is in its


normal state.

Evaluation state Displays the present evaluation state of the


alarm. For example, Upper limit alarm is
displayed when the monitored value reaches
the upper alarm limit.

04-17005-03-en, October 2015 System


931
33 Alarms User Interface
33.10 Enumeration Alarm Properties Basic Tab

Continued
Component Description

Disabled cause Displays the cause for the alarm being


disabled:
Shunt variable means that the alarm
has been disabled by a shunt variable
User means that the alarm has been
disabled by the user
System means that the alarm has
been disabled by the system

Reset delay (s) Enter the time, in seconds, the alarm has to
be within the reset criteria before the alarm
state is changed from alarm to reset.

Alarm delay (s) Enter the time, in seconds, the alarm has to
be within the alarm criteria before the alarm
is triggered.

Shunt variable 1 Enter the shunt variable that is used to


enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert shunt value 1 Select to invert the shunt value, that is,
enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Shunt operator Select AND or OR to add logic between the


first and the second shunt variable. For more
information, see section 31.3 Shunt
Variables on page 815.

Shunt variable 2 Enter the second shunt variable that is used


to enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert shunt value 2 Select to invert the shunt value, that is,
enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Monitored variable Enter the path to the variable that is


monitored by the alarm.

Add
Click to create a new alarm trigger item,
either an integer or range value. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

System 04-17005-03-en, October 2015


932
33 Alarms User Interface
33.10 Enumeration Alarm Properties Basic Tab

Continued
Component Description

Edit
Click to edit the alarm trigger item. For more
information, see section 33.39 Alarm
Trigger Properties Range Tab on page
994.

Remove
Click to remove an alarm trigger item.

Alarm message Type the message to display when the alarm


is triggered.

Alarm priority Enter the priority level of the alarm.

Reset message Type the message to display when the alarm


is reset.

Reset priority Enter the priority level of the alarm when it is


reset.

04-17005-03-en, October 2015 System


933
33 Alarms User Interface
33.11 Enumeration Alarm Properties Advanced Tab

33.11 Enumeration Alarm Properties


Advanced Tab
Use the Advanced tab to change the alarm properties of an enumeration alarm.

Figure: Advanced tab

Table: Advanced Tab


Component Description

Acknowledgement type Select the type of acknowledgement for the


alarm.

Flashing alert Select to display a flashing alert in the Alarms


pane and the Alarm Views when the alarm is
triggered.

Audible alert Select to make an audible alert when the


alarm is triggered.

Category Enter the category that the alarm belongs to.

Cause note group Enter the cause note group that is used by
the alarm.

System 04-17005-03-en, October 2015


934
33 Alarms User Interface
33.11 Enumeration Alarm Properties Advanced Tab

Continued
Component Description

Action note group Enter the action note group that is used by
the alarm.

Checklist Enter the checklist that belongs to the alarm.

Checklist required Select to force the user to check each step


in the checklist before the alarm can be
acknowledged.

Disable alarm Select to disable the alarm, for example,


before deployment.

Prefix for alarm source name Type a prefix that is added to the beginning
of the source name property of an alarm
record.

Edit
(Action Requirements)
Click to open the property pane where you
edit the selected user action. For more
information, see section 33.44 User Action
Properties on page 999.

Add
(Attachments)
Click to open the Create Object: Attachment
wizard, where you add an attachment. For
more information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

Edit
(Attachments)
Click to open the property pane where you
configure the attachment. For more
information, see section 33.42 Attachment
Properties on page 997.

Remove
(Attachments)
Click to remove an attachment that is
connected to the alarm.

04-17005-03-en, October 2015 System


935
33 Alarms User Interface
33.12 Matching Text String Alarm Properties Basic Tab

33.12 Matching Text String Alarm Properties


Basic Tab
Use the Basic tab to view or edit the basic properties of a matching text string
alarm.

Figure: Basic tab

Table: Basic Tab


Component Description

Alarm state Displays the present state of the alarm. For


more information, see section 29.2 Alarm
States on page 675.

Basic evaluation state Displays False when the alarm is in its


normal state.

Evaluation state Displays the present evaluation state of the


alarm. For example, Upper limit alarm is
displayed when the monitored value reaches
the upper alarm limit.

System 04-17005-03-en, October 2015


936
33 Alarms User Interface
33.12 Matching Text String Alarm Properties Basic Tab

Continued
Component Description

Disabled cause Displays the cause for the alarm being


disabled:
Shunt variable means that the alarm
has been disabled by a shunt variable
User means that the alarm has been
disabled by the user
System means that the alarm has
been disabled by the system

Reset delay (s) Enter the time, in seconds, the alarm has to
be within the reset criteria before the alarm
state is changed from alarm to reset.

Alarm delay (s) Enter the time, in seconds, the alarm has to
be within the alarm criteria before the alarm
is triggered.

Shunt variable 1 Enter the shunt variable that is used to


enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert shunt value 1 Select to invert the shunt value, that is,
enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Shunt operator Select AND or OR to add logic between the


first and the second shunt variable. For more
information, see section 31.3 Shunt
Variables on page 815.

Shunt variable 2 Enter the second shunt variable that is used


to enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert shunt value 2 Select to invert the shunt value, that is,
enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Alarm message Type the message to display when the alarm


is triggered.

Alarm priority Enter the priority level of the alarm.

Reset message Type the message to display when the alarm


is reset.

Reset priority Enter the priority level of the alarm when it is


reset.

04-17005-03-en, October 2015 System


937
33 Alarms User Interface
33.12 Matching Text String Alarm Properties Basic Tab

Continued
Component Description

Monitored variable Enter the path to the variable that is


monitored by the alarm.

Add
Click to create a new alarm trigger item. For
more information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

Edit
Click to edit the alarm trigger item. For more
information, see section 33.39 Alarm
Trigger Properties Range Tab on page
994.

Remove
Click to remove an alarm trigger item.

System 04-17005-03-en, October 2015


938
33 Alarms User Interface
33.13 Matching Text String Alarm Properties Advanced Tab

33.13 Matching Text String Alarm Properties


Advanced Tab
Use the Advanced tab to change the alarm properties of a matching text string
alarm.

Figure: Advanced tab

Table: Advanced Tab


Component Description

Acknowledgement type Select the type of acknowledgement for the


alarm.

Flashing alert Select to display a flashing alert in the Alarms


pane and the Alarm Views when the alarm is
triggered.

Audible alert Select to make an audible alert when the


alarm is triggered.

Category Enter the category that the alarm belongs to.

Cause note group Enter the cause note group that is used by
the alarm.

04-17005-03-en, October 2015 System


939
33 Alarms User Interface
33.13 Matching Text String Alarm Properties Advanced Tab

Continued
Component Description

Action note group Enter the action note group that is used by
the alarm.

Checklist Enter the checklist that belongs to the alarm.

Checklist required Select to force the user to check each step


in the checklist before the alarm can be
acknowledged.

Disable alarm Select to disable the alarm, for example,


before deployment.

Prefix for alarm source name Type a prefix that is added to the beginning
of the source name property of an alarm
record.

Edit
(Action Requirements)
Click to open the property pane where you
edit the selected user action. For more
information, see section 33.44 User Action
Properties on page 999.

Add
(Attachments)
Click to open the Create Object: Attachment
wizard, where you add an attachment. For
more information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

Edit
(Attachments)
Click to open the property pane where you
configure the attachment. For more
information, see section 33.42 Attachment
Properties on page 997.

Remove
(Attachments)
Click to remove an attachment that is
connected to the alarm.

System 04-17005-03-en, October 2015


940
33 Alarms User Interface
33.14 Multistate Alarm Properties Basic Tab

33.14 Multistate Alarm Properties Basic Tab


Use the Basic tab to view or edit the basic properties of a multistate alarm.

Figure: Basic tab

Table: Basic Tab


Component Description

Alarm state Displays the present state of the alarm. For


more information, see section 29.2 Alarm
States on page 675.

Basic evaluation state Displays False when the alarm is in its


normal state.

Evaluation state Displays the present evaluation state of the


alarm. For example, Upper limit alarm is
displayed when the monitored value reaches
the upper alarm limit.

04-17005-03-en, October 2015 System


941
33 Alarms User Interface
33.14 Multistate Alarm Properties Basic Tab

Continued
Component Description

Disabled cause Displays the cause for the alarm being


disabled:
Shunt variable means that the alarm
has been disabled by a shunt variable
User means that the alarm has been
disabled by the user
System means that the alarm has
been disabled by the system

Reset delay (s) Enter the time, in seconds, the alarm has to
be within the reset criteria before the alarm
state is changed from alarm to reset.

Alarm delay (s) Enter the time, in seconds, the alarm has to
be within the alarm criteria before the alarm
is triggered.

Shunt variable 1 Enter the shunt variable that is used to


enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert shunt value 1 Select to invert the shunt value, that is,
enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Shunt operator Select AND or OR to add logic between the


first and the second shunt variable. For more
information, see section 31.3 Shunt
Variables on page 815.

Shunt variable 2 Enter the second shunt variable that is used


to enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert shunt value 2 Select to invert the shunt value, that is,
enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Monitored variable Enter the path to the variable that is


monitored by the alarm.

Click to create a new alarm trigger item,


either an integer or range value. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

System 04-17005-03-en, October 2015


942
33 Alarms User Interface
33.14 Multistate Alarm Properties Basic Tab

Continued
Component Description

Click to edit the alarm trigger item.


For more information, see section 33.39
Alarm Trigger Properties Range Tab on
page 994.
For more information, see section 33.40
Alarm Trigger Properties Value tab on
page 995.

Click to remove an alarm trigger item.

Alarm message Type the message to display when the alarm


is triggered.

Alarm priority Enter the priority level of the alarm.

Reset message Type the message to display when the alarm


is reset.

Reset priority Enter the priority level of the alarm when it is


reset.

04-17005-03-en, October 2015 System


943
33 Alarms User Interface
33.15 Multistate Alarm Properties Advanced Tab

33.15 Multistate Alarm Properties Advanced


Tab
Use the Advanced tab to change the alarm properties of a multistate alarm.

Figure: Advanced tab

Table: Advanced Tab


Component Description

Acknowledgement type Select the type of acknowledgement for the


alarm.

Flashing alert Select to display a flashing alert in the Alarms


pane and the Alarm Views when the alarm is
triggered.

Audible alert Select to make an audible alert when the


alarm is triggered.

Category Enter the category that the alarm belongs to.

Cause note group Enter the cause note group that is used by
the alarm.

System 04-17005-03-en, October 2015


944
33 Alarms User Interface
33.15 Multistate Alarm Properties Advanced Tab

Continued
Component Description

Action note group Enter the action note group that is used by
the alarm.

Checklist Enter the checklist that belongs to the alarm.

Checklist required Select to force the user to check each step


in the checklist before the alarm can be
acknowledged.

Disable alarm Select to disable the alarm, for example,


before deployment.

Prefix for alarm source name Type a prefix that is added to the beginning
of the source name property of an alarm
record.

Edit
(Action Requirements)
Click to open the property pane where you
edit the selected user action. For more
information, see section 33.44 User Action
Properties on page 999.

Add
(Attachments)
Click to open the Create Object: Attachment
wizard, where you add an attachment. For
more information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

Edit
(Attachments)
Click to open the property pane where you
configure the attachment. For more
information, see section 33.42 Attachment
Properties on page 997.

Remove
(Attachments)
Click to remove an attachment that is
connected to the alarm.

04-17005-03-en, October 2015 System


945
33 Alarms User Interface
33.16 Out of Range Alarm Properties Basic Tab

33.16 Out of Range Alarm Properties Basic


Tab
Use the Basic tab to view or edit the basic properties of an out of range alarm.

Figure: Basic tab

Table: Basic Tab


Component Description

Alarm state Displays the present state of the alarm. For


more information, see section 29.2 Alarm
States on page 675.

Basic evaluation state Displays False when the alarm is in its


normal state.

Evaluation state Displays the present evaluation state of the


alarm. For example, Upper limit alarm is
displayed when the monitored value reaches
the upper alarm limit.

System 04-17005-03-en, October 2015


946
33 Alarms User Interface
33.16 Out of Range Alarm Properties Basic Tab

Continued
Component Description

Disabled cause Displays the cause for the alarm being


disabled:
Shunt variable means that the alarm
has been disabled by a shunt variable
User means that the alarm has been
disabled by the user
System means that the alarm has
been disabled by the system

Shunt variable 1 Enter the shunt variable that is used to


enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert shunt value 1 Select to invert the shunt value, that is,
enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Shunt operator Select AND or OR to add logic between the


first and the second shunt variable. For more
information, see section 31.3 Shunt
Variables on page 815.

Shunt variable 2 Enter the second shunt variable that is used


to enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert shunt value 2 Select to invert the shunt value, that is,
enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Reset delay (s) Enter the time, in seconds, the alarm has to
be within the reset criteria before the alarm
state is changed from alarm to reset.

Alarm delay (s) Enter the time, in seconds, the alarm has to
be within the alarm criteria before the alarm
is triggered.

Above upper limit message Type the message to display when the
variable exceeds the upper limit of the alarm.

Above upper limit priority Enter the priority level of the alarm when the
variable exceeds the upper limit.

Below lower limit message Type the message to display when the
variable falls below the lower limit.

Below lower limit priority Enter the priority level of the alarm when the
variable falls below the lower limit.

04-17005-03-en, October 2015 System


947
33 Alarms User Interface
33.16 Out of Range Alarm Properties Basic Tab

Continued
Component Description

Reset message Type the message to display when the alarm


is reset.

Reset priority Enter the priority level of the alarm when it is


reset.

Monitored variable Enter the path to the variable that is


monitored by the alarm.

Lower limit Enter the lowest value the monitored variable


can decrease to before the alarm is
triggered.

Upper limit Enter the highest value the monitored


variable can increase to before the alarm is
triggered.

Deadband Enter the range the monitored variable has


to pass within the normal range before the
alarm is reset.

System 04-17005-03-en, October 2015


948
33 Alarms User Interface
33.17 Out of Range Alarm Properties Advanced Tab

33.17 Out of Range Alarm Properties


Advanced Tab
Use the Advanced tab for changing the alarm properties of an out of range alarm.

Figure: Advanced tab

Table: Advanced Tab


Component Description

Acknowledgement type Select the type of acknowledgement for the


alarm.

Flashing alert Select to display a flashing alert in the Alarms


pane and the Alarm Views when the alarm is
triggered.

Audible alert Select to make an audible alert when the


alarm is triggered.

Category Enter the category that the alarm belongs to.

Cause note group Enter the cause note group that is used by
the alarm.

04-17005-03-en, October 2015 System


949
33 Alarms User Interface
33.17 Out of Range Alarm Properties Advanced Tab

Continued
Component Description

Action note group Enter the action note group that is used by
the alarm.

Checklist Enter the checklist that belongs to the alarm.

Checklist required Select to force the user to check each step


in the checklist before the alarm can be
acknowledged.

Disable alarm Select to disable the alarm, for example,


before deployment.

Prefix for alarm source name Type a prefix that is added to the beginning
of the source name property of an alarm
record.

Edit
(Action Requirements)
Click to open the property pane where you
edit the selected user action. For more
information, see section 33.44 User Action
Properties on page 999.

Add
(Attachments)
Click to open the Create Object: Attachment
wizard, where you add an attachment. For
more information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

Edit
(Attachments)
Click to open the property pane where you
configure the attachment. For more
information, see section 33.42 Attachment
Properties on page 997.

Remove
(Attachments)
Click to remove an attachment that is
connected to the alarm.

System 04-17005-03-en, October 2015


950
33 Alarms User Interface
33.18 Out of Reference Range Alarm Properties Basic Tab

33.18 Out of Reference Range Alarm


Properties Basic Tab
Use the Basic tab to view or edit the basic properties of an out of reference range
alarm.

Figure: Basic tab

Table: Basic Tab


Component Description

Alarm state Displays the present state of the alarm. For


more information, see section 29.2 Alarm
States on page 675.

Basic evaluation state Displays False when the alarm is in its


normal state.

Evaluation state Displays the present evaluation state of the


alarm. For example, Upper limit alarm is
displayed when the monitored value reaches
the upper alarm limit.

04-17005-03-en, October 2015 System


951
33 Alarms User Interface
33.18 Out of Reference Range Alarm Properties Basic Tab

Continued
Component Description

Disabled cause Displays the cause for the alarm being


disabled:
Shunt variable means that the alarm
has been disabled by a shunt variable
User means that the alarm has been
disabled by the user
System means that the alarm has
been disabled by the system

Shunt variable 1 Enter the shunt variable that is used to


enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert shunt value 1 Select to invert the shunt value, that is,
enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Shunt operator Select AND or OR to add logic between the


first and the second shunt variable. For more
information, see section 31.3 Shunt
Variables on page 815.

Shunt variable 2 Enter the second shunt variable that is used


to enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert shunt value 2 Select to invert the shunt value, that is,
enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Reset delay (s) Enter the time, in seconds, the alarm has to
be within the reset criteria before the alarm
state is changed from alarm to reset.

Alarm delay (s) Enter the time, in seconds, the alarm has to
be within the alarm criteria before the alarm
is triggered.

Above upper limit message Type the message to display when the
variable exceeds the upper limit of the alarm.

Above upper limit priority Enter the priority level of the alarm when the
variable exceeds the upper limit.

Below lower limit message Type the message to display when the
variable falls below the lower limit.

Below lower limit priority Enter the priority level of the alarm when the
variable falls below the lower limit.

System 04-17005-03-en, October 2015


952
33 Alarms User Interface
33.18 Out of Reference Range Alarm Properties Basic Tab

Continued
Component Description

Reset message Type the message to display when the alarm


is reset.

Reset priority Enter the priority level of the alarm when it is


reset.

Monitored variable Enter the path to the variable that is


monitored by the alarm.

Reference variable Enter the reference variable that is compared


with the monitored variable.

Lower deviation limit Enter the lowest value the monitored variable
can decrease to before the alarm is
triggered.

Upper deviation limit Enter the highest value the monitored


variable can increase to before the alarm is
triggered.

Deadband Enter the range the monitored variable has


to pass within the normal range before the
alarm is reset.

04-17005-03-en, October 2015 System


953
33 Alarms User Interface
33.19 Out of Reference Range Alarm Properties Advanced Tab

33.19 Out of Reference Range Alarm


Properties Advanced Tab
Use the Advanced tab to change the alarm properties of an out of reference range
alarm.

Figure: Advanced tab

Table: Advanced Tab


Component Description

Acknowledgement type Select the type of acknowledgement for the


alarm.

Flashing alert Select to display a flashing alert in the Alarms


pane and the Alarm Views when the alarm is
triggered.

Audible alert Select to make an audible alert when the


alarm is triggered.

Category Enter the category that the alarm belongs to.

Cause note group Enter the cause note group that is used by
the alarm.

System 04-17005-03-en, October 2015


954
33 Alarms User Interface
33.19 Out of Reference Range Alarm Properties Advanced Tab

Continued
Component Description

Action note group Enter the action note group that is used by
the alarm.

Checklist Enter the checklist that belongs to the alarm.

Checklist required Select to force the user to check each step


in the checklist before the alarm can be
acknowledged.

Disable alarm Select to disable the alarm, for example,


before deployment.

Prefix for alarm source name Type a prefix that is added to the beginning
of the source name property of an alarm
record.

Edit
(Action Requirements)
Click to open the property pane where you
edit the selected user action. For more
information, see section 33.44 User Action
Properties on page 999.

Add
(Attachments)
Click to open the Create Object: Attachment
wizard, where you add an attachment. For
more information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

Edit
(Attachments)
Click to open the property pane where you
configure the attachment. For more
information, see section 33.42 Attachment
Properties on page 997.

Remove
(Attachments)
Click to remove an attachment that is
connected to the alarm.

04-17005-03-en, October 2015 System


955
33 Alarms User Interface
33.20 Sum Alarm Properties Basic Tab

33.20 Sum Alarm Properties Basic Tab


Use the Basic tab to view or edit the basic properties of a sum alarm.

Figure: Basic tab

Table: Basic Tab


Component Description

Alarm state Displays the present state of the alarm. For


more information, see section 29.2 Alarm
States on page 675.

Basic evaluation state Displays False when the alarm is in its


normal state.

Evaluation state Displays the present evaluation state of the


alarm. For example, Upper limit alarm is
displayed when the monitored value reaches
the upper alarm limit.

System 04-17005-03-en, October 2015


956
33 Alarms User Interface
33.20 Sum Alarm Properties Basic Tab

Continued
Component Description

Disabled cause Displays the cause for the alarm being


disabled:
Shunt variable means that the alarm
has been disabled by a shunt variable
User means that the alarm has been
disabled by the user
System means that the alarm has
been disabled by the system

Matching alarms count Displays the number of alarms that currently


meet the criteria of the sum alarm.

Reset delay (s) Enter the time, in seconds, the alarm has to
be within the reset criteria before the alarm
state is changed from alarm to reset.

Alarm delay (s) Enter the time, in seconds, the alarm has to
be within the alarm criteria before the alarm
is triggered.

Shunt variable 1 Enter the shunt variable that is used to


enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert shunt value 1 Select to invert the shunt value, that is,
enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Shunt operator Select AND or OR to add logic between the


first and the second shunt variable. For more
information, see section 31.3 Shunt
Variables on page 815.

Shunt variable 2 Enter the second shunt variable that is used


to enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert shunt value 2 Select to invert the shunt value, that is,
enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Alarm message Type the message to display when the alarm


is triggered.

Alarm priority Enter the priority level of the alarm.

Reset message Type the message to display when the alarm


is reset.

04-17005-03-en, October 2015 System


957
33 Alarms User Interface
33.20 Sum Alarm Properties Basic Tab

Continued
Component Description

Reset priority Enter the priority level of the alarm when it is


reset.

System 04-17005-03-en, October 2015


958
33 Alarms User Interface
33.21 Sum Alarm Properties Advanced Tab

33.21 Sum Alarm Properties Advanced Tab


Use the Advanced tab to change the alarm properties of a sum alarm.

Figure: Advanced tab

Table: Advanced Tab


Component Description

Acknowledgement type Select the type of acknowledgement for the


alarm.

Flashing alert Select to display a flashing alert in the Alarms


pane and the Alarm Views when the alarm is
triggered.

Audible alert Select to make an audible alert when the


alarm is triggered.

Category Enter the category that the alarm belongs to.

Cause note group Enter the cause note group that is used by
the alarm.

Action note group Enter the action note group that is used by
the alarm.

04-17005-03-en, October 2015 System


959
33 Alarms User Interface
33.21 Sum Alarm Properties Advanced Tab

Continued
Component Description

Checklist Enter the checklist that belongs to the alarm.

Checklist required Select to force the user to check each step


in the checklist before the alarm can be
acknowledged.

Disable alarm Select to disable the alarm, for example,


before deployment.

Prefix for alarm source name Type a prefix that is added to the beginning
of the source name property of an alarm
record.

Edit
(Action Requirements)
Click to open the property pane where you
edit the selected user action. For more
information, see section 33.44 User Action
Properties on page 999.

Add
(Attachments)
Click to open the Create Object: Attachment
wizard, where you add an attachment. For
more information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

Edit
(Attachments)
Click to open the property pane where you
configure the attachment. For more
information, see section 33.42 Attachment
Properties on page 997.

Remove
(Attachments)
Click to remove an attachment that is
connected to the alarm.

System 04-17005-03-en, October 2015


960
33 Alarms User Interface
33.22 Variable Status Alarm Properties Basic Tab

33.22 Variable Status Alarm Properties Basic


Tab
Use the Basic tab to view or edit the basic properties of a variable status alarm.

Figure: Basic tab

Table: Basic Tab


Component Description

Alarm state Displays the present state of the alarm. For


more information, see section 29.2 Alarm
States on page 675.

Basic evaluation state Displays False when the alarm is in its


normal state.

Evaluation state Displays the present evaluation state of the


alarm. For example, Upper limit alarm is
displayed when the monitored value reaches
the upper alarm limit.

04-17005-03-en, October 2015 System


961
33 Alarms User Interface
33.22 Variable Status Alarm Properties Basic Tab

Continued
Component Description

Disabled cause Displays the cause for the alarm being


disabled:
Shunt variable means that the alarm
has been disabled by a shunt variable
User means that the alarm has been
disabled by the user
System means that the alarm has
been disabled by the system

Reset delay (s) Enter the time, in seconds, the alarm has to
be within the reset criteria before the alarm
state is changed from alarm to reset.

Alarm delay (s) Enter the time, in seconds, the alarm has to
be within the alarm criteria before the alarm
is triggered.

Shunt variable 1 Enter the shunt variable that is used to


enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert shunt value 1 Select to invert the shunt value, that is,
enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Shunt operator Select AND or OR to add logic between the


first and the second shunt variable. For more
information, see section 31.3 Shunt
Variables on page 815.

Shunt variable 2 Enter the second shunt variable that is used


to enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert shunt value 2 Select to invert the shunt value, that is,
enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Alarm message Type the message to display when the alarm


is triggered.

Alarm priority Enter the priority level of the alarm.

Reset message Type the message to display when the alarm


is reset.

Reset priority Enter the priority level of the alarm when it is


reset.

System 04-17005-03-en, October 2015


962
33 Alarms User Interface
33.22 Variable Status Alarm Properties Basic Tab

Continued
Component Description

Monitored variable Enter the path to the variable that is


monitored by the alarm.

Trigger when variable is Select the statuses of the monitored variable


that trigger the alarm.
Forced means that the alarm is
triggered when the monitored variable
status is forced. For more information,
see the Force and Unforce Buttons
topic on WebHelp.
Overridden means that the alarm is
triggered when the monitored variable
status is overridden. For more
information, see the Output Override
Status topic on WebHelp.
Offline means that the alarm is
triggered when the monitored variable
is off line.

04-17005-03-en, October 2015 System


963
33 Alarms User Interface
33.23 Variable Status Alarm Properties Advanced Tab

33.23 Variable Status Alarm Properties


Advanced Tab
Use the Advanced tab to change the alarm properties of a variable status alarm.

Figure: Advanced tab

Table: Advanced Tab


Component Description

Acknowledgement type Select the type of acknowledgement for the


alarm.

Flashing alert Select to display a flashing alert in the Alarms


pane and the Alarm Views when the alarm is
triggered.

Audible alert Select to make an audible alert when the


alarm is triggered.

Category Enter the category that the alarm belongs to.

Cause note group Enter the cause note group that is used by
the alarm.

System 04-17005-03-en, October 2015


964
33 Alarms User Interface
33.23 Variable Status Alarm Properties Advanced Tab

Continued
Component Description

Action note group Enter the action note group that is used by
the alarm.

Checklist Enter the checklist that belongs to the alarm.

Checklist required Select to force the user to check each step


in the checklist before the alarm can be
acknowledged.

Disable alarm Select to disable the alarm, for example,


before deployment.

Prefix for alarm source name Type a prefix that is added to the beginning
of the source name property of an alarm
record.

Edit
(Action Requirements)
Click to open the property pane where you
edit the selected user action. For more
information, see section 33.44 User Action
Properties on page 999.

Add
(Attachments)
Click to open the Create Object: Attachment
wizard, where you add an attachment. For
more information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

Edit
(Attachments)
Click to open the property pane where you
configure the attachment. For more
information, see section 33.42 Attachment
Properties on page 997.

Remove
(Attachments)
Click to remove an attachment that is
connected to the alarm.

04-17005-03-en, October 2015 System


965
33 Alarms User Interface
33.24 Function Block Program Internal Alarm Properties - Basic Tab

33.24 Function Block Program Internal Alarm


Properties - Basic Tab
Use the Basic tab to view or edit the basic properties of a function block program
internal alarm. For more information, see section 50.34 General Properties Basic
Tab on page 1642.

Figure: Basic tab

Table: Basic Tab


Component Description

Alarm state Displays the present state of the alarm. For


more information, see section 29.2 Alarm
States on page 675.

Basic evaluation state Displays False when the alarm is in its


normal state.

Evaluation state Displays the present evaluation state of the


alarm. For example, Upper limit alarm is
displayed when the monitored value reaches
the upper alarm limit.

System 04-17005-03-en, October 2015


966
33 Alarms User Interface
33.24 Function Block Program Internal Alarm Properties - Basic Tab

Continued
Component Description

Disabled cause Displays the cause for the alarm being


disabled:
Shunt variable means that the alarm
has been disabled by a shunt variable
User means that the alarm has been
disabled by the user
System means that the alarm has
been disabled by the system

Delay to reset (s) Enter the time, in seconds, the alarm has to
be within the reset criteria before the alarm
state is changed from alarm to reset.

Delay to alarm (s) Enter the time, in seconds, the alarm has to
be within the alarm criteria before the alarm
is triggered.

Shunt variable 1 Enter the shunt variable that is used to


enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert shunt value 1 Select to invert the shunt value, that is,
enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Shunt operator Select AND or OR to add logic between the


first and the second shunt variable. For more
information, see section 31.3 Shunt
Variables on page 815.

Shunt variable 2 Enter the second shunt variable that is used


to enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert shunt value 2 Select to invert the shunt value, that is,
enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

04-17005-03-en, October 2015 System


967
33 Alarms User Interface
33.24 Function Block Program Internal Alarm Properties - Basic Tab

Continued
Component Description

Trigger value Select the statuses of the monitored variable


that trigger the alarm.
Forced means that the alarm is
triggered when the monitored variable
status is forced. For more information,
see the Force and Unforce Buttons
topic on WebHelp.
Overridden means that the alarm is
triggered when the monitored variable
status is overridden. For more
information, see the Output Override
Status topic on WebHelp.
Offline means that the alarm is
triggered when the monitored variable
is off line.

Monitored variable Enter the path to the variable that is


monitored by the alarm.

Alarm message Type the message to display when the alarm


is triggered.

Alarm priority Enter the priority level of the alarm.

Reset message Type the message to display when the alarm


is reset.

Reset priority Enter the priority level of the alarm when it is


reset.

System 04-17005-03-en, October 2015


968
33 Alarms User Interface
33.25 Function Block Program Internal Alarm Properties - Advanced Tab

33.25 Function Block Program Internal Alarm


Properties - Advanced Tab
Use the Advanced tab to change the alarm properties of a function block program
internal alarm.

Figure: Advanced tab

Table: Advanced Tab


Component Description

Acknowledgement type Select the type of acknowledgement for the


alarm.

Flashing alert Select True to make the alert flash in the


Alarms pane and Alarm Views when an
alarm is triggered.

Audible alert Select True to make the alert audible when


an alarm is triggered.

Category Enter the category that the alarm belongs to.

Cause note group Enter the cause note group that is used by
the alarm.

04-17005-03-en, October 2015 System


969
33 Alarms User Interface
33.25 Function Block Program Internal Alarm Properties - Advanced Tab

Continued
Component Description

Action note group Enter the action note group that is used by
the alarm.

Checklist Enter the checklist that belongs to the alarm.

Checklist required Select to force the user to check each step


in the checklist before the alarm can be
acknowledged.

Disable alarm Select to disable the alarm, for example,


before deployment.

Prefix for alarm source name Type a prefix that is added to the beginning
of the source name property of an alarm
record.

Edit
(Action requirements)
Click to open the property pane where you
edit the selected user action. For more
information, see section 33.44 User Action
Properties on page 999.

Add
(Attachments)
Click to open the Create Object: Attachment
wizard, where you add an attachment. For
more information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

Edit
(Attachments)
Click to open the property pane where you
configure the attachment. For more
information, see section 33.42 Attachment
Properties on page 997.

Remove
(Attachments)
Click to remove an attachment that is
connected to the alarm.

System 04-17005-03-en, October 2015


970
33 Alarms User Interface
33.26 Create Alarm Wizard Presentation Page

33.26 Create Alarm Wizard Presentation


Page
Use the Presentation page to configure the presentation settings of the alarm.

Figure: Presentation page

Table: Presentation Page


Component Description

Alarm message Displays the present state of the alarm. For


more information, see section 29.2 Alarm
States on page 675.

Above upper limit message Type the message to display when the
variable exceeds the upper limit of the alarm.

Below lower limit message Type the message to display when the
variable falls below the lower limit.

Reset message Type the message to display when the alarm


is reset.

Alarm priority Enter the priority level of the alarm.

Above upper limit priority Enter the priority level of the alarm when the
variable exceeds the upper limit.

Below lower limit priority Enter the priority level of the alarm when the
variable falls below the lower limit.

04-17005-03-en, October 2015 System


971
33 Alarms User Interface
33.26 Create Alarm Wizard Presentation Page

Continued
Component Description

Reset priority Enter the priority level of the alarm when it is


reset.
Enter the category that the alarm belongs to.

Same priority Select to set all priorities to the same value.

Category Enter the category that the alarm belongs to.

Flashing alert Select to make the alarm row flash in the


Alarms pane and Alarm Views when the
alarm is triggered.

Audible alert Select to make the alert audible when the


alarm is triggered.

System 04-17005-03-en, October 2015


972
33 Alarms User Interface
33.27 Create Alarm Wizard User Action Page

33.27 Create Alarm Wizard User Action


Page
Use the User Action page to force a user to actions that are connected to the
alarm.

Figure: User action page

Table: User Action Page


Component Description

Acknowledgement type Select the type of acknowledgement for the


alarm.
For more information, see section 31.14
Acknowledgements on page 828.

Cause note group Enter the cause note group that is used by
the alarm.

04-17005-03-en, October 2015 System


973
33 Alarms User Interface
33.27 Create Alarm Wizard User Action Page

Continued
Component Description

Action note group Enter the action note group that is used by
the alarm.

Checklist Enter the checklist that belongs to the alarm.

When acknowledging an alarm Select what actions the user has to perform
when acknowledging an alarm.

Required user action Select what actions the user has to perform
when any of the listed events occur.

System 04-17005-03-en, October 2015


974
33 Alarms User Interface
33.28 Create Alarm Wizard Attachment Page

33.28 Create Alarm Wizard Attachment


Page
Use the Attachment page to add attachments to the alarm.

Figure: Attachment page

Table: Attachment Page


Component Description

Add attachment
Click to add an attachment to the alarm.

Remove attachment
Click to remove an attachment.

Navigate to
Click to open the attachment that is selected
in the attachment list.

Display on alarm Select to display the attachment when the


alarm is triggered.

04-17005-03-en, October 2015 System


975
33 Alarms User Interface
33.29 Create Change of State Alarm Wizard Alarm Trigger Page

33.29 Create Change of State Alarm Wizard


Alarm Trigger Page
Use the Alarm Trigger page to configure the trigger settings of the change of
state alarm.

Figure: Change of state alarm trigger page

Table: Change of State Alarm Trigger Page


Component Description

True Select to trigger the alarm when the


monitored variable is equal to true.

False Select to trigger the alarm when the


monitored variable is equal to false.

Monitored variable Enter the path to the variable that is


monitored by the alarm.

Disable alarm Select to disable the alarm, for example,


before deployment.

Alarm delay Enter the time, in seconds, the alarm has to


be within the reset criteria before the alarm
state is changed from alarm to reset.

Reset delay Enter the time, in seconds, the alarm has to


be within the alarm criteria before the alarm
is triggered.

System 04-17005-03-en, October 2015


976
33 Alarms User Interface
33.29 Create Change of State Alarm Wizard Alarm Trigger Page

Continued
Component Description

Shunt variable 1 Enter the shunt variable that is used to


enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Operator Select AND or OR to add logic between the


first and the second shunt variable. For more
information, see section 31.3 Shunt
Variables on page 815.

Shunt variable 2 Enter the second shunt variable that is used


to enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

04-17005-03-en, October 2015 System


977
33 Alarms User Interface
33.30 Create Multistate Alarm Wizard Alarm Trigger Page

33.30 Create Multistate Alarm Wizard Alarm


Trigger Page
Use the Alarm Trigger page to configure the trigger settings of the multistate
alarm.

Figure: Multistate alarm trigger page

Table: Multistate Alarm Trigger Page


Component Description

Add row
Add row
Click to add another alarm condition that
triggers the alarm.

Remove row
Click to remove an alarm condition.

between Select a range. If the monitored variable is


within this range, the alarm is triggered.

equal to Select a value. If the monitored variable is


equal to this value, the alarm is triggered.

Monitored variable Enter the path to the variable that is


monitored by the alarm.

Disable alarm Displays the present state of the alarm. For


more information, see section 29.2 Alarm
States on page 675.

System 04-17005-03-en, October 2015


978
33 Alarms User Interface
33.30 Create Multistate Alarm Wizard Alarm Trigger Page

Continued
Component Description

Alarm delay Enter the time, in seconds, the alarm has to


be within the alarm criteria before the alarm
is triggered.

Reset delay Enter the time, in seconds, the alarm has to


be within the reset criteria before the alarm
state is changed from alarm to reset.

Shunt variable 1 Enter the shunt variable that is used to


enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Operator Select AND or OR to add logic between the


first and the second shunt variable. For more
information, see section 31.3 Shunt
Variables on page 815.

Shunt variable 2 Enter the second shunt variable that is used


to enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Set unit
Enter the unit of the alarm.

04-17005-03-en, October 2015 System


979
33 Alarms User Interface
33.31 Create Matching Text String Alarm Wizard Alarm Trigger Page

33.31 Create Matching Text String Alarm


Wizard Alarm Trigger Page
Use the Alarm Trigger page to configure the trigger settings of the matching text
string alarm.

Figure: Matching text string alarm trigger page

Table: Matching Text String Alarm Trigger Page


Component Description

Add row
Add row
Click to add another alarm condition that
triggers the alarm.

Remove row
Click to remove an alarm condition.

equal to Type a text string. When the monitored


variable matches this text string, the alarm is
triggered.

Monitored variable Enter the path to the variable that is


monitored by the alarm.

Disable alarm Select to disable the alarm, for example,


before deployment.

Alarm delay Enter the time, in seconds, the alarm has to


be within the alarm criteria before the alarm
is triggered.

System 04-17005-03-en, October 2015


980
33 Alarms User Interface
33.31 Create Matching Text String Alarm Wizard Alarm Trigger Page

Continued
Component Description

Reset delay Enter the time, in seconds, the alarm has to


be within the reset criteria before the alarm
state is changed from alarm to reset.

Shunt variable 1 Enter the shunt variable that is used to


enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Operator Select AND or OR to add logic between the


first and the second shunt variable. For more
information, see section 31.3 Shunt
Variables on page 815.

Shunt variable 2 Enter the second shunt variable that is used


to enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

04-17005-03-en, October 2015 System


981
33 Alarms User Interface
33.32 Create Out of Range Alarm Wizard Alarm Trigger Page

33.32 Create Out of Range Alarm Wizard


Alarm Trigger Page
Use the Alarm Trigger page to configure the trigger settings of the out of range
alarm.

Figure: Out of range alarm trigger page

Table: Out of Range Alarm Trigger Page


Component Description

Upper limit Enter the highest value the monitored


variable can increase to before the alarm is
triggered.

Lower limit Enter the lowest value the monitored variable


can decrease to before the alarm is
triggered.

Deadband Enter the range the monitored variable has


to pass within the normal range before the
alarm is reset.

Monitored variable Enter the path to the variable that is


monitored by the alarm.

Disable alarm Select to disable the alarm, for example,


before deployment.

Alarm delay Enter the time, in seconds, the alarm has to


be within the alarm criteria before the alarm
is triggered.

System 04-17005-03-en, October 2015


982
33 Alarms User Interface
33.32 Create Out of Range Alarm Wizard Alarm Trigger Page

Continued
Component Description

Reset delay Enter the time, in seconds, the alarm has to


be within the reset criteria before the alarm
state is changed from alarm to reset.

Shunt variable 1 Enter the shunt variable that is used to


enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Operator Select AND or OR to add logic between the


first and the second shunt variable. For more
information, see section 31.3 Shunt
Variables on page 815.

Shunt variable 2 Enter the second shunt variable that is used


to enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Set unit
Enter the unit of the alarm.

04-17005-03-en, October 2015 System


983
33 Alarms User Interface
33.33 Create Out of Reference Range Alarm Wizard Alarm Trigger Page

33.33 Create Out of Reference Range Alarm


Wizard Alarm Trigger Page
Use the Alarm Trigger page to configure the trigger settings of the out of
reference range alarm.

Figure: Out of reference range alarm trigger page

Table: Out of Reference Range Alarm Trigger Page


Component Description

Upper deviation limit Enter the upper limit the monitored variable
is allowed to deviate from the reference
variable before the alarm is triggered.

Lower deviation limit Enter the lower limit the monitored variable is
allowed to deviate from the reference
variable before the alarm is triggered.

Deadband Enter the range the monitored variable has


to pass within the normal range before the
alarm is reset.

Monitored variable Enter the path to the variable that is


monitored by the alarm.

Disable alarm Select to disable the alarm, for example,


before deployment.

Reference variable Enter the reference variable that is compared


with the monitored variable.

System 04-17005-03-en, October 2015


984
33 Alarms User Interface
33.33 Create Out of Reference Range Alarm Wizard Alarm Trigger Page

Continued
Component Description

Alarm delay Enter the time, in seconds, the alarm has to


be within the alarm criteria before the alarm
is triggered.

Reset delay Enter the time, in seconds, the alarm has to


be within the reset criteria before the alarm
state is changed from alarm to reset.

Shunt variable 1 Enter the shunt variable that is used to


enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Operator Select AND or OR to add logic between the


first and the second shunt variable. For more
information, see section 31.3 Shunt
Variables on page 815.

Shunt variable 2 Enter the second shunt variable that is used


to enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Set unit
Enter the unit of the alarm.

04-17005-03-en, October 2015 System


985
33 Alarms User Interface
33.34 Create Sum Alarm Wizard Alarm Trigger Page

33.34 Create Sum Alarm Wizard Alarm


Trigger Page
Use the Alarm Trigger page to configure the trigger settings of the sum alarm.

Figure: Sum Alarm trigger page

Table: Sum Alarm Trigger Page


Component Description

Add condition
Select the alarm filter conditions for the
alarms you want to include.
For more information, see section 29.8
Alarm Filter Conditions on page 685.
You can use wildcards when setting up filter
conditions. For more information, see
section 34.8 Filter Condition Wildcards on
page 1102.

Remove condition
Remove the alarm filter conditions for the
alarms you want exclude.

Add row
Click to add an additional row with the same
condition.

Remove row
Click to remove a condition row.

Clear all
Click to clear the selected conditions.

System 04-17005-03-en, October 2015


986
33 Alarms User Interface
33.34 Create Sum Alarm Wizard Alarm Trigger Page

Continued
Component Description

Alarm State Displays the alarm state of the alarm. For


more information, see section 29.2 Alarm
States on page 675.

Matching alarms count Displays the number of alarms that currently


meet the criteria of the sum alarm.

Disable alarm Select to disable the alarm, for example,


before deployment.

Alarm delay Enter the time, in seconds, the alarm has to


be within the alarm criteria before the alarm
is triggered.

Reset delay Enter the time, in seconds, the alarm has to


be within the reset criteria before the alarm
state is changed from alarm to reset.

Shunt variable 1 Enter the shunt variable that is used to


enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Operator Select AND or OR to add logic between the


first and the second shunt variable. For more
information, see section 31.3 Shunt
Variables on page 815.

Shunt variable 2 Enter the second shunt variable that is used


to enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

04-17005-03-en, October 2015 System


987
33 Alarms User Interface
33.35 Create Enumeration Alarm Wizard Alarm Trigger Page

33.35 Create Enumeration Alarm Wizard


Alarm Trigger Page
Use the Alarm Trigger page to configure the trigger settings of the enumeration
alarm.

Figure: Enumeration alarm trigger page

Table: Enumeration Alarm Trigger Page


Component Description

Trigger alarm when variable is Select the enumeration values that trigger
the alarm.

Monitored variable Enter the variable together with the


enumeration to monitor.

Disable alarm Select to disable the alarm, for example,


before deployment.

Alarm delay Enter the time, in seconds, the alarm has to


be within the alarm criteria before the alarm
is triggered.

Reset delay Enter the time, in seconds, the alarm has to


be within the reset criteria before the alarm
state is changed from alarm to reset.

Shunt variable 1 Enter the shunt variable that is used to


enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

System 04-17005-03-en, October 2015


988
33 Alarms User Interface
33.35 Create Enumeration Alarm Wizard Alarm Trigger Page

Continued
Component Description

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Operator Select AND or OR to add logic between the


first and the second shunt variable. For more
information, see section 31.3 Shunt
Variables on page 815.

Shunt variable 2 Enter the second shunt variable that is used


to enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

04-17005-03-en, October 2015 System


989
33 Alarms User Interface
33.36 Create Variable Status Alarm Wizard Alarm Trigger Page

33.36 Create Variable Status Alarm Wizard


Alarm Trigger Page
Use the Alarm Trigger page to configure the trigger settings of the variable status
alarm.

Figure: Variable status alarm trigger page

Table: Variable Status Alarm Trigger Page


Component Description

Forced Select to trigger the alarm when the


monitored variable status is forced. For more
information, see the Force and Unforce
Buttons topic on WebHelp.

Overridden Select to trigger the alarm when the


monitored variable status is overridden. For
more information, see the Output Override
Status topic on WebHelp.

Monitored variable Enter the path to the variable that is


monitored by the alarm.

Disable alarm Select to disable the alarm, for example,


before deployment.

Alarm delay Enter the time, in seconds, the alarm has to


be within the reset criteria before the alarm
state is changed from alarm to reset.

Reset delay Enter the time, in seconds, the alarm has to


be within the alarm criteria before the alarm
is triggered.

System 04-17005-03-en, October 2015


990
33 Alarms User Interface
33.36 Create Variable Status Alarm Wizard Alarm Trigger Page

Continued
Component Description

Shunt variable 1 Enter the shunt variable that is used to


enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

Operator Select AND or OR to add logic between the


first and the second shunt variable. For more
information, see section 31.3 Shunt
Variables on page 815.

Shunt variable 2 Enter the second shunt variable that is used


to enable or disable the alarm. For more
information, see section 31.3 Shunt
Variables on page 815.

Invert Select to invert the shunt value, that is,


enable the alarm when the shunt value is
active and disable the alarm when the shunt
value is inactive. For more information, see
section 31.3 Shunt Variables on page 815.

04-17005-03-en, October 2015 System


991
33 Alarms User Interface
33.37 Create Attachment Wizard Configure Attachment Page

33.37 Create Attachment Wizard Configure


Attachment Page
Use the Configure Attachment page to set up the attachment you want to
attach to the alarm.

Figure: Configure Attachment page

Table: Configure Attachment Page


Property Description

Object reference Enter the path to the item you want to attach
to the alarm.

Display on alarm Select True to automatically open and


display the attachment when the alarm is
triggered.

System 04-17005-03-en, October 2015


992
33 Alarms User Interface
33.38 Alarm Trigger Properties - Basic Tab

33.38 Alarm Trigger Properties - Basic Tab


Use the Alarm Trigger Properties view or dialog box to configure and view the
general and object-reference properties. For more information, see section 50.34
General Properties Basic Tab on page 1642.

Figure: AlarmTrigger Properties

04-17005-03-en, October 2015 System


993
33 Alarms User Interface
33.39 Alarm Trigger Properties Range Tab

33.39 Alarm Trigger Properties Range Tab


Use the Range tab to configure the range that triggers the alarm.

Figure: Range tab

Table: Range Tab


Component Description

First value Enter the lowest integer value of the range


that triggers the alarm.

Last value Enter the highest integer value of the range


that triggers the alarm.

System 04-17005-03-en, October 2015


994
33 Alarms User Interface
33.40 Alarm Trigger Properties Value tab

33.40 Alarm Trigger Properties Value tab


Use the Value tab to configure the integer that triggers the alarm.

Figure: Value tab

Table: Value Tab


Component Description

Value Enter the integer value that triggers the


alarm.

04-17005-03-en, October 2015 System


995
33 Alarms User Interface
33.41 Alarm Trigger Properties Value tab

33.41 Alarm Trigger Properties Value tab


Use the Value tab to type the text string that triggers the Matching text string
alarm.

Figure: Value tab

Table: Value Tab


Component Description

Value Type the text string that triggers the alarm.

System 04-17005-03-en, October 2015


996
33 Alarms User Interface
33.42 Attachment Properties

33.42 Attachment Properties


Use the Attachment properties to edit attachments and configure whether or not
the attachments are displayed when the alarm is triggered.

Figure: Attachment properties

Table: Attachment Properties


Component Description

Display on alarm Select True to automatically open and


display the attachment when the alarm is
triggered.

Object reference Enter the path to the item you want to attach
to the alarm.

04-17005-03-en, October 2015 System


997
33 Alarms User Interface
33.43 Alarm Control Panel Properties

33.43 Alarm Control Panel Properties


Use the Alarm Control Panel Properties to view the referenced lead object.

Figure: Alarm Control Panel properties

Table: Alarm Control Panel Properties


Property Description

Lead object Displays the referenced lead object from


which all configuration data is copied. For
more information, see section 17.2 Lead
and Shadow Relationship on page 348.

System 04-17005-03-en, October 2015


998
33 Alarms User Interface
33.44 User Action Properties

33.44 User Action Properties


Use the User Action properties dialog box to configure the mandatory or required
user actions items.

Figure: User action properties

Table: User Action Properties


Component Description

User action Displays the user action item you are


configuring.

Comment Select True to require the users to write a


comment when they perform this kind of
user action.

Action note Select True to require the users to add an


action note to this kind of user action.

Cause note Select True to require the users to report


the circumstances of this kind of user action.

04-17005-03-en, October 2015 System


999
33 Alarms User Interface
33.45 Alarm Styles View

33.45 Alarm Styles View


Use the Alarm Styles view to open the style properties of the different Alarm
states.

Figure: Alarm Styles view

Table: Alarm Styles View


Component Description

Acknowledged Style Click to select the style object that


configures the appearance of an
acknowledged alarm in the Alarms pane and
Alarm View. For more information, see
section 33.47 Acknowledged Style
Properties on page 1002.

Alarm Style Click to select the style object that


configures the appearance of a triggered
alarm in the Alarms pane and Alarm View.
For more information, see section 33.48
Alarm Style Properties on page 1003.

Disabled Style Click to select the style object that


configures the appearance of a disabled
alarm in the Alarms pane and Alarm View.
For more information, see section 33.49
Disabled Style Properties on page 1004.

Fault Style Click to select the style object that


configures the appearance of an alarm with
fault state in the Alarms pane and Alarm
View. For more information, see section
33.50 Fault Style Properties on page 1005.

Reset Style Click to select the style object that


configures the appearance of a reset alarm
in the Alarms pane and Alarm View. For
more information, see section 33.51 Reset
Style Properties on page 1006.

System 04-17005-03-en, October 2015


1000
33 Alarms User Interface
33.46 Alarm Styles Properties

33.46 Alarm Styles Properties


Use the Alarm Styles Properties view or dialog box to configure and view the
general and object-reference properties. For more information, see section 50.34
General Properties Basic Tab on page 1642.General and References Properties

Figure: Alarm Styles Properties

04-17005-03-en, October 2015 System


1001
33 Alarms User Interface
33.47 Acknowledged Style Properties

33.47 Acknowledged Style Properties


Use the Acknowledged Style properties to edit and view the colors and fonts of
alarms in Alarms pane and Alarm Views that are in acknowledged state.

Figure: Acknowledged Style properties

Table: Acknowledged Style Properties


Component Description

Font Enter the font to use for acknowledged


alarms in the Alarms pane and Alarm Views.

Background color Enter the background color of the row for


acknowledged alarms in the Alarms pane
and Alarm Views.

Font color Enter the font color to use for acknowledged


alarms in the Alarms pane and Alarm Views.

System 04-17005-03-en, October 2015


1002
33 Alarms User Interface
33.48 Alarm Style Properties

33.48 Alarm Style Properties


Use the Alarm Style properties to edit and view the colors and fonts of alarms in
Alarms pane and Alarm Views that are in Alarm state.

Figure: Alarm Style properties

Table: Alarm Style Properties


Component Description

Font Enter the font to use for triggered alarms in


the Alarms pane and Alarm Views.

Background color Enter the background color of the row for


triggered alarms in the Alarms pane and
Alarm Views.

Font color Enter the font color to use for triggered


alarms in the Alarms pane and Alarm Views.

04-17005-03-en, October 2015 System


1003
33 Alarms User Interface
33.49 Disabled Style Properties

33.49 Disabled Style Properties


Use the Disabled Style properties to edit and view the colors and fonts of alarms
in the Alarm pane and Alarm Views that are in Disabled state.

Figure: Disabled Style properties

Table: Disabled Style Properties


Component Description

Font Enter the font to use for disabled alarms in


the Alarms pane and Alarm Views.

Background color Enter the background color of the row for


disabled alarms in the Alarms pane and
Alarm Views.

Font color Enter the font color for disabled alarms in the
Alarms pane and Alarm Views.

System 04-17005-03-en, October 2015


1004
33 Alarms User Interface
33.50 Fault Style Properties

33.50 Fault Style Properties


Use the Fault Style properties to edit and view the colors and fonts of alarms in
the Alarms pane and Alarm Views that are in Fault state.

Figure: Fault Style properties

Table: Fault Style Properties


Component Description

Font Enter the font to use for faulty alarms in the


Alarms pane and Alarm Views.

Background color Enter the background color of the row for


faulty alarms in the Alarms pane and Alarm
Views.

Font color Enter the font color for faulty alarms in the
Alarms pane and Alarm Views.

04-17005-03-en, October 2015 System


1005
33 Alarms User Interface
33.51 Reset Style Properties

33.51 Reset Style Properties


Use the Reset Style properties to edit and view the colors and fonts of alarms in
the Alarms pane and Alarm Views that are in Reset state.

Figure: Reset Style properties

Table: Reset Style Properties


Component Description

Font Enter the font to use for reset alarms in the


Alarms pane and Alarm Views.

Background color Enter the background color to use for reset


alarms in the Alarms pane and Alarm Views.

Font color Enter the font color to use for reset alarms in
the Alarms pane and Alarm Views.

System 04-17005-03-en, October 2015


1006
33 Alarms User Interface
33.52 Alarm Control Panel Categories View

33.52 Alarm Control Panel Categories View


Use the Categories view to create, edit, and remove categories that can be
connected to an alarm.

Figure: Categories view

Table: Categories View


Button Description

Add category
Click to open the Add category dialog box
where you define the name and description
for a new category. For more information,
see section 33.53 Add Category Dialog
Box on page 1008.

Edit category
Click to open the Edit category dialog box
where you define the name and description
of an existing category. For more
information, see section 33.54 Edit
Category Dialog Box on page 1009.

Remove category
Click to remove a category.

Group box
Click to display the Show/Hide Group box to
group and sort objects. For more
information, see the Group and Sort Objects
topic on WebHelp.

04-17005-03-en, October 2015 System


1007
33 Alarms User Interface
33.53 Add Category Dialog Box

33.53 Add Category Dialog Box


Use the Add Category dialog box to add a category.

Figure: Add Category dialog box

Table: Add Category Dialog Box


Component Description

Name Type the name of the category.

Description Type a description of the category.

System 04-17005-03-en, October 2015


1008
33 Alarms User Interface
33.54 Edit Category Dialog Box

33.54 Edit Category Dialog Box


Use the Edit Category dialog box to edit the name or description of a category.

Figure: Edit Category dialog box

Table: Edit Category Dialog Box


Component Description

Name Type the name of the category.

Description Type a description of the category.

04-17005-03-en, October 2015 System


1009
33 Alarms User Interface
33.55 Category Properties

33.55 Category Properties


Use the Category Properties view or dialog box to configure and view the
general and object-reference properties. For more information, see section 50.34
General Properties Basic Tab on page 1642.

Figure: Category properties

System 04-17005-03-en, October 2015


1010
33 Alarms User Interface
33.56 Categories Properties

33.56 Categories Properties


Use the Categories Properties view or dialog box to add, edit and remove
categories and to view and configure the general properties of categories. For more
information, see section 50.34 General Properties Basic Tab on page 1642.

Figure: Categories properties

Table: Categories Properties


Property Description

Name Displays the category name. For more


information, see the Categories topic on
WebHelp.

Add
Click to open the Category wizard, where
you add a category.

Edit
Click to edit the properties of the selected
category. For more information, see section
33.55 Category Properties on page 1010.

04-17005-03-en, October 2015 System


1011
33 Alarms User Interface
33.56 Categories Properties

Continued
Property Description

Remove
Click to remove the selected category.

System 04-17005-03-en, October 2015


1012
33 Alarms User Interface
33.57 Alarm Control Panel Cause Notes View

33.57 Alarm Control Panel Cause Notes


View
Use the Cause Notes view to create, edit, and remove cause notes.

Figure: Cause Notes view

Table: Cause Notes View


Button Description

Add cause note


Click to open the Add cause note dialog
box where you define the name and
description for a new cause note. For more
information, see section 33.58 Add Cause
Note Dialog Box on page 1014.

Edit cause note


Click to open the Edit cause note dialog
box where you define the name and
description of an existing cause note. For
more information, see section 33.59 Edit
Cause Note Dialog Box on page 1015.
Click to edit a cause note.

Remove cause note


Click to remove a cause note.

Group box
Click to display the Show/Hide Group box to
group and sort objects. For more
information, see the Group and Sort Objects
topic on WebHelp.

Collapse all
Click to collapse the groups in the list to hide
underlying items.

Expand all
Click to expand the groups in the list to
display underlaying items.

04-17005-03-en, October 2015 System


1013
33 Alarms User Interface
33.58 Add Cause Note Dialog Box

33.58 Add Cause Note Dialog Box


Use the Add Cause Note dialog box to add a cause note.

Figure: Add Cause Note dialog box

Table: Add Cause Note Dialog Box


Component Description

Name Type the name of the cause note.

Group name Enter the cause note group the cause note
belongs to.

Description Type a description of the cause note.

System 04-17005-03-en, October 2015


1014
33 Alarms User Interface
33.59 Edit Cause Note Dialog Box

33.59 Edit Cause Note Dialog Box


Use the Edit Cause Note dialog box to edit a cause note.

Figure: Edit Cause Note dialog box

Table: Edit Cause Note Dialog Box


Component Description

Name Type the name of the cause note.

Group name Enter the group the cause note belongs to.

Description Type a description of the cause note.

04-17005-03-en, October 2015 System


1015
33 Alarms User Interface
33.60 Cause Notes Properties

33.60 Cause Notes Properties


Use the Cause Notes Properties view or dialog box to add, edit, and remove
cause note groups and to configure and view the general and object reference
properties. For more information, see section 50.34 General Properties Basic
Tab on page 1642.

Figure: Cause Notes properties

Table: Cause Notes Properties


Property Description

Name Displays the name of the cause note group.


For more information, see section 32.2
Cause Notes on page 886.

Add
Click to open the Cause Note Group wizard,
where you add a cause note group.

System 04-17005-03-en, October 2015


1016
33 Alarms User Interface
33.60 Cause Notes Properties

Continued
Property Description

Edit
Click to open the properties dialog box for
the selected cause note group, where you
edit the properties of the cause note group.
For more information, see section 33.61
Cause Note Group Properties on page
1018.

Remove
Click to remove the selected cause note
group.

04-17005-03-en, October 2015 System


1017
33 Alarms User Interface
33.61 Cause Note Group Properties

33.61 Cause Note Group Properties


Use the Cause Note Group Properties view or dialog box to view or edit the
properties of the Cause Note Group.

Figure: Cause Note Group properties

Table: Cause Note Group Properties


Property Description

Name Displays the name of the cause notes in the


cause note group. For more information, see
section 32.2 Cause Notes on page 886.

Add
Click to open the Cause Note wizard.

Edit
Click to open the properties dialog box for
the selected cause note. For more
information, see section 33.62 Cause Note
Properties on page 1019.

Remove
Click to remove the selected cause note.

System 04-17005-03-en, October 2015


1018
33 Alarms User Interface
33.62 Cause Note Properties

33.62 Cause Note Properties


Use the Cause Note Properties view or dialog box to type the display name of the
cause note and to configure and view the general and object references properties.
For more information, see section 50.34 General Properties Basic Tab on page
1642.

Figure: Cause Note properties

Table: Cause Note Properties


Property Description

Properties Type the display name of the cause note.


For more information, see section 32.2
Cause Notes on page 886.

04-17005-03-en, October 2015 System


1019
33 Alarms User Interface
33.63 Alarm Control Panel Action Notes View

33.63 Alarm Control Panel Action Notes


View
Use the Action Notes view to create, edit, and remove action notes.

Figure: Action Notes view

Table: Action Notes View


Button Description

Add action note


Click to open the Add action note dialog
box where you define the name and
description for a new action note. For more
information, see section 33.64 Add Action
Note Dialog Box on page 1021.

Edit action note


Click to open the Edit action note dialog
box where you define the name and
description of an existing action note. For
more information, see section 33.65 Edit
Action Note Dialog Box on page 1022.

Remove action note


Click to remove an action note.

Group box
Click to display the Show/Hide Group box to
group and sort objects. For more
information, see the Group and Sort Objects
topic on WebHelp.

Collapse all
Click to collapse the groups in the list to hide
underlying items.

Expand all
Click to expand the groups in the list to
display underlaying items.

System 04-17005-03-en, October 2015


1020
33 Alarms User Interface
33.64 Add Action Note Dialog Box

33.64 Add Action Note Dialog Box


Use the Add Action Note dialog box to add an action note.

Figure: Add Action Note dialog box

Table: Add Action Note Dialog Box


Component Description

Name Type the name of the action note.

Group name Enter the action note group the action note
belongs to.

Description Type a description of the action note.

04-17005-03-en, October 2015 System


1021
33 Alarms User Interface
33.65 Edit Action Note Dialog Box

33.65 Edit Action Note Dialog Box


Use the Edit Action Note dialog box to add an action note.

Figure: Edit Action Note dialog box

Table: Edit Action Note Dialog Box


Component Description

Name Type the name of the action note.

Group name Enter the action note group the action note
belongs to.

Description Type a description of the action note.

System 04-17005-03-en, October 2015


1022
33 Alarms User Interface
33.66 Action Notes Properties

33.66 Action Notes Properties


Use the Action Notes Properties view or dialog box to add, edit, and remove
action note groups and to configure and view the general and object-reference
properties. For more information, see section 50.34 General Properties Basic
Tab on page 1642.

Figure: Action Notes properties

Table: Action Notes Properties


Property Description

Name Displays the name of the action note group.


For more information, see section 32.6
Action Notes on page 892.

Add
Click to open the Action Note Group wizard,
where you add an action note group.

04-17005-03-en, October 2015 System


1023
33 Alarms User Interface
33.66 Action Notes Properties

Continued
Property Description

Edit
Click to open the properties dialog box for
the action note group, where you edit the
properties of the action note group. For
more information, see section 33.67 Action
Note Group Properties on page 1025.

Remove
Click to remove the selected action note
group.

System 04-17005-03-en, October 2015


1024
33 Alarms User Interface
33.67 Action Note Group Properties

33.67 Action Note Group Properties


Use the Action Note Group Properties view or dialog box to view or edit the
properties of the Action Note Group.

Figure: Action Note Group properties

Table: Action Note Group Properties


Property Description

Name Displays the name of the action notes in the


action note group. For more information, see
section 32.6 Action Notes on page 892.

Add
Click to open the Action Note wizard.

Edit
Click to open the properties dialog box for
the selected action note. For more
information, see section 33.68 Action Note
Properties on page 1026.

Remove
Click to remove the selected action note.

04-17005-03-en, October 2015 System


1025
33 Alarms User Interface
33.68 Action Note Properties

33.68 Action Note Properties


Use the Action Note Properties view or dialog box to type the display name of the
action note and to configure and view the general and object reference properties.
For more information, see section 50.34 General Properties Basic Tab on page
1642.

Figure: Action Note properties

Table: Action Note Properties


Property Description

Action note Type the display name of the action note.


For more information, see section 32.6
Action Notes on page 892.

System 04-17005-03-en, October 2015


1026
33 Alarms User Interface
33.69 Alarm Control Panel Checklists View

33.69 Alarm Control Panel Checklists View


Use the Checklists view to creat, edit, and remove checklists.

Figure: Checklists view

Table: Checklist View


Button Description

Add checklist
Click to open the Add checklist dialog box
where you define the checklist name,
description, and add or edit checklist steps.
For more information, see section 33.64
Add Action Note Dialog Box on page
1021.

Edit checklist
Click to open the Edit checklist dialog box
where you edit the checklist name,
description, and add or edit checklist steps.
For more information, see section 33.71
Edit Checklist Dialog Box on page 1030.

Remove checklist
Click to remove a checklist.

Group box
Click to display the Show/Hide Group box to
group and sort objects. For more
information, see the Group and Sort Objects
topic on WebHelp.

04-17005-03-en, October 2015 System


1027
33 Alarms User Interface
33.70 Add Checklist Dialog Box

33.70 Add Checklist Dialog Box


Use the Add Checklist dialog box to add, edit, or order the items of a checklist.

Figure: Checklist dialog box

Table: Checklist Dialog Box


Button Description

Name Type the name of the checklist.

Description Type a description of the checklist.

Add step
Click to open the Add checklist step
dialog box where you add a step to your
checklist. For more information, see section
33.72 Add Checklist Step Dialog Box on
page 1032.

Edit step
Click to open the Edit checklist step
dialog box where you edit a checklist step.
For more information, see section 33.73
Edit Checklist Step Dialog Box on page
1033.

Remove step
Click to remove the selected step from the
checklist.

System 04-17005-03-en, October 2015


1028
33 Alarms User Interface
33.70 Add Checklist Dialog Box

Continued
Button Description

Move step up
Click to move the selected step upwards in
the list.

Move step down


Click to move the selected step downwards
in the list.

04-17005-03-en, October 2015 System


1029
33 Alarms User Interface
33.71 Edit Checklist Dialog Box

33.71 Edit Checklist Dialog Box


Use the Edit Checklist dialog box to add, edit, or order the steps of a checklist.

Figure: Edit Checklist dialog box

Table: Edit Checklist Dialog Box


Button Description

Name Type the name of the checklist.

Description Type a description of the checklist.

Add step
Click to open the Add checklist step
dialog box where you add a step to your
checklist. For more information, see section
33.72 Add Checklist Step Dialog Box on
page 1032.

Edit step
Click to open the Edit checklist step
dialog box where you edit a checklist step.
For more information, see section 33.73
Edit Checklist Step Dialog Box on page
1033.

Remove step
Click to remove the selected step from the
checklist.

System 04-17005-03-en, October 2015


1030
33 Alarms User Interface
33.71 Edit Checklist Dialog Box

Continued
Button Description

Move step up
Click to move the selected step upwards in
the list.

Move step down


Click to move the selected step downwards
in the list.

04-17005-03-en, October 2015 System


1031
33 Alarms User Interface
33.72 Add Checklist Step Dialog Box

33.72 Add Checklist Step Dialog Box


Use the Add Checklist Step dialog box to add a new step to a checklist.

Figure: Add Checklist Step dialog box

Table: Add Checklist Step


Component Description

Name Type the name of the checklist step.

System 04-17005-03-en, October 2015


1032
33 Alarms User Interface
33.73 Edit Checklist Step Dialog Box

33.73 Edit Checklist Step Dialog Box


Use the Edit Checklist Step dialog box to edit a checklist step.

Figure: Edit Checklist Step dialog box

Table: Edit Checklist Step


Component Description

Name Type the name of the checklist step.

04-17005-03-en, October 2015 System


1033
33 Alarms User Interface
33.74 Checklists Properties

33.74 Checklists Properties


Use the Checklists Properties view or dialog box to add, edit, and remove
checklists.

Figure: Checklists properties

Table: Checklists Properties


Property Description

Name Dipsplays the name of the added checklists.


For more information, see section 32.10
Checklists on page 898.

Add
Click to open the Checklist wizard, where
you add new checklists.

Edit
Click to open the properties dialog box,
where you edit the properties of the selected
checklist. For more information, see section
33.75 Checklist Properties on page 1036.

System 04-17005-03-en, October 2015


1034
33 Alarms User Interface
33.74 Checklists Properties

Continued
Property Description

Remove
Click to remove the selected checklist.

04-17005-03-en, October 2015 System


1035
33 Alarms User Interface
33.75 Checklist Properties

33.75 Checklist Properties


Use the Checklist Properties view or dialog box to add, edit, and remove checklist
steps and to view and configure the general and references properties of the
checklist. For more information, see section 50.34 General Properties Basic Tab
on page 1642.

Figure: Checklist properties

Table: Checklist Properties


Property Description

Name Displays the name of the checklist steps that


have been added to the checklist. For more
information, see section 31.19 User
Actions on page 836.

Add
Click to start the Checklist Step wizard.

Edit
Click to edit the properties of the checklist
step. For more information, see section
33.76 Checklist Step Properties on page
1038.

System 04-17005-03-en, October 2015


1036
33 Alarms User Interface
33.75 Checklist Properties

Continued
Property Description

Remove
Click to remove the selected checklist step.

04-17005-03-en, October 2015 System


1037
33 Alarms User Interface
33.76 Checklist Step Properties

33.76 Checklist Step Properties


Use the Checklist Step Properties view or dialog to edit the displayed instruction
and the step position of the checklist step and to view and configure the general
and references properties of the checklist step. For more information, see section
50.34 General Properties Basic Tab on page 1642.

Figure: Checklist Step properites

Table: Checklist Step Properties


Property Description

Checklist step Displays the checklist step instruction. For


more information, see section 31.19 User
Actions on page 836.

Position Enter the position of the step on the


checklist.

System 04-17005-03-en, October 2015


1038
33 Alarms User Interface
33.77 Alarm Basic Settings View

33.77 Alarm Basic Settings View


Use the Basic Settings view to view the alarm name, alarm type, or edit the
comment to change the description of the alarm.

Figure: Basic Settings view

Table: Basic Settings View


Property Description

Alarm type Displays the type of the alarm object.

Name Displays the name of the alarm object.

Description Type a description that describes the alarm


object.

04-17005-03-en, October 2015 System


1039
33 Alarms User Interface
33.78 Select Conditions Dialog Box Alarm Filter Properties

33.78 Select Conditions Dialog Box Alarm


Filter Properties
Use the Select Conditions dialog box to make it easier for you to find specific
types of alarms.

Figure: Alarm filter condition properties

Table: Alarm Filter Conditions


Component Description

Add condition
Select the alarm filter conditions for the
alarms you want to include.
For more information, see section 29.8
Alarm Filter Conditions on page 685.

Remove condition
Remove the alarm filter conditions for the
alarms you want exclude.

Add row
Click to add an additional row with the same
condition.

Remove row
Click to remove a condition row.

Clear all
Click to clear the selected conditions.

System 04-17005-03-en, October 2015


1040
33 Alarms User Interface
33.79 Select Conditions Dialog Box (Alarms User Filter)

33.79 Select Conditions Dialog Box (Alarms


User Filter)
Use the Select Conditions dialog box to edit the custom alarm filter for the
logged on user.

Figure: Select Conditions dialog box

Table: Select Conditins Dialog Box


Component Description

Add condition
Select the alarm filter conditions for the
alarms you want to include.

Remove condition
Remove the alarm filter conditions for the
alarms you want exclude.

Clear all
Click to clear the selected conditions.

04-17005-03-en, October 2015 System


1041
33 Alarms User Interface
33.80 Create Client Notification Wizard Client Notification Page

33.80 Create Client Notification Wizard


Client Notification Page
Use the Client Notification page to set up the conditions for the client notification.

Figure: Client Notification page

Table: Client Notification Page


Property Description

Status Select Disabled to deactivate the


notification function.

Schedule Enter the schedule or other multistate


variable that contains the value that activates
the notification.

Active value Enter the value, generated by the connected


schedule or other multistate variable, that
activates the notification.

Text Type the text content or the substitution


code for the text content the notification is to
have when sent.

Notify on transition to Select the alarm condition that has to be met


before the notification is sent.

System 04-17005-03-en, October 2015


1042
33 Alarms User Interface
33.81 Client Notification View

33.81 Client Notification View


Use the Client Notification View to view and edit the settings of a client notification.

Figure: Client Notification view

Table: Client Notification View


Component Description

Name Type the name of the object to create.

Description Type a description that explains what the


object is used for.

Status Select Disabled to deactivate the


notification function.

Schedule Enter the schedule or other multistate


variable that contains the value that activates
the notification.

Active value Enter the value, generated by the connected


schedule or other multistate variable, that
activates the notification.

04-17005-03-en, October 2015 System


1043
33 Alarms User Interface
33.81 Client Notification View

Continued
Component Description

Text Type the text content or the substitution


code for the text content the notification is to
have when sent.

Notify on transition to Select the alarm condition that has to be met


before the notification is sent.

[Conditions list] Use the conditions list to add or remove


conditions for when the notification is to be
displayed or sent and to make condition
settings.

Add condition
Click to add a condition that has to be met
for the notification to be displayed or sent.

Remove condition
Click to remove a condition that has to be
met for the notification to be displayed or
sent.

Add row
Click to add a row to the condition.

Remove row
Click to remove the row from the condition.

Clear all
Click to clear the selected conditions.

System 04-17005-03-en, October 2015


1044
33 Alarms User Interface
33.82 Client Notification Properties

33.82 Client Notification Properties


Use the Client Notification Properties dialog to configure the client notificatin
message that is to be displayed when the alarm conditions are met.

Note
You can only edit filter conditions by clicking the notification.

Figure: Client Notification properties

Table: Client Notification Properties


Property Description

Status Select Disabled to deactivate the


notification function.

Schedule Enter the schedule or other multistate


variable that contains the value that activates
the notification.

Active Value Enter the value, generated by the connected


schedule or other multistate variable, that
activates the notification.

04-17005-03-en, October 2015 System


1045
33 Alarms User Interface
33.82 Client Notification Properties

Continued
Property Description

Text Type the text content or the substitution


code for the text content the notification is to
have when sent.

System 04-17005-03-en, October 2015


1046
33 Alarms User Interface
33.83 Create Email Notification Wizard Email Notification Page

33.83 Create Email Notification Wizard


Email Notification Page
Use the Email Notification page to set up the conditions for the email notification.

Figure: Email Notification page

Table: Email Notification page


Component Description

Status Select Disabled to deactivate the


notification function.

Schedule Enter the schedule or other multistate


variable that contains the value that activates
the notification.

Active value Enter the value, generated by the connected


schedule or other multistate variable, that
activates the notification.

To users and groups Click the browse button to open the Users
and Groups dialog box where you select
the Building Operation users or user groups
to whom the email notification is to be sent.
For more information, see section 33.95
Users and Groups Dialog Box on page
1071.

To email address Type the email address to the user or group


of users to whom the email notification is to
be sent.

04-17005-03-en, October 2015 System


1047
33 Alarms User Interface
33.83 Create Email Notification Wizard Email Notification Page

Continued
Component Description

Subject Type the subject text or the substitution


code for the subject text the email
notification is to have when sent.

Text Type the text content or the substitution


code for the text content the notification is to
have when sent.

Notify on transition to Select the alarm condition that has to be met


before the notification is sent.

[Conditions list] Use the conditions list to add or remove


conditions for when the notification is to be
displayed or sent and to make condition
settings.

Add condition
Click to add a condition that has to be met
for the notification to be displayed or sent.
For more information, see section 29.8
Alarm Filter Conditions on page 685.

Remove condition
Click to remove a condition that has to be
met for the notification to be displayed or
sent.

Add row
Click to add a row to the condition.

Remove row
Click to remove the row from the condition.

Clear all
Click to clear the selected conditions.

System 04-17005-03-en, October 2015


1048
33 Alarms User Interface
33.84 Email Notification View

33.84 Email Notification View


Use the Email Notification view to view and edit the settings of an email
notification.

Figure: Email Notification view

Table: Email Notification View


Component Description

Name Type the name of the object to create.

Description Type a description that explains what the


object is used for.

Status Select Disabled to deactivate the


notification function.

Schedule Enter the schedule or other multistate


variable that contains the value that activates
the notification.

Active value Enter the value, generated by the connected


schedule or other multistate variable, that
activates the notification.

04-17005-03-en, October 2015 System


1049
33 Alarms User Interface
33.84 Email Notification View

Continued
Component Description

To users and groups Click the browse button to open the Users
and Groups dialog box where you select
the Building Operation users or user groups
to whom the email notification is to be sent.
For more information, see section 33.95
Users and Groups Dialog Box on page
1071.

To email address Type the email address to the user or group


of users to whom the email notification is to
be sent.

Subject Type the subject text or the substitution


code for the subject text the email
notification is to have when sent.

Text Type the text content or the substitution


code for the text content the notification is to
have when sent.

Notify on transition to Select the alarm condition that has to be met


before the notification is sent.

[Conditions list] Use the conditions list to add or remove


conditions for when the notification is to be
displayed or sent and to make condition
settings.

Add condition
Click to add a condition that has to be met
for the notification to be displayed or sent.
For more information, see section 29.8
Alarm Filter Conditions on page 685.

Remove condition
Click to remove a condition that has to be
met for the notification to be displayed or
sent.

Add row
Click to add a row to the condition.

Remove row
Click to remove the row from the condition.

Clear all
Click to clear the selected conditions.

System 04-17005-03-en, October 2015


1050
33 Alarms User Interface
33.85 Email Notification Properties

33.85 Email Notification Properties


Use the Email Notification properties to configure the recipient address and the
content of the notification email.

Note
You can only edit filter conditions by clicking the notification.

Figure: Email notification properties

Table: Email Notification Properties


Component Description

Status Select Disabled to deactivate the


notification function.

Schedule Enter the schedule or other multistate


variable that contains the value that activates
the notification.

Active value Enter the value, generated by the connected


schedule or other multistate variable, that
activates the notification.

04-17005-03-en, October 2015 System


1051
33 Alarms User Interface
33.85 Email Notification Properties

Continued
Component Description

To users and groups Click the browse button to open the Users
and Groups dialog box where you select
the Building Operation users or user groups
to whom the email notification is to be sent.
For more information, see section 33.95
Users and Groups Dialog Box on page
1071.

To email address Type the email address to the user or group


of users to whom the email notification is to
be sent.

Subject Type the subject text or the substitution


code for the subject text the email
notification is to have when sent.

Text Type the text content or the substitution


code for the text content the notification is to
have when sent.

System 04-17005-03-en, October 2015


1052
33 Alarms User Interface
33.86 Create SNMP Notification Wizard SNMP Notification Page

33.86 Create SNMP Notification Wizard


SNMP Notification Page
Use the SNMP Notification page to configure an SNMP notification.

Figure: SNMP notification page

Table: SNMP Notification Page


Property Description

Status Select Disabled to deactivate the


notification function.

Schedule Enter the schedule or other multistate


variable that contains the value that activates
the notification.

Active value Enter the value, generated by the connected


schedule or other multistate variable, that
activates the notification.

Address Type the address to the SNMP manager that


receives the notification.

Port Type the port that is used by the SNMP


manager that receives the notification.

User name Type the user name of the user on the


SNMP manager that receives the
notification.

Text Type the text content or the substitution


code for the text content the notification is to
have when sent.

04-17005-03-en, October 2015 System


1053
33 Alarms User Interface
33.86 Create SNMP Notification Wizard SNMP Notification Page

Continued
Property Description

Security level Select the security level.

Authentication protocol Select the authentication level.

Authentication password Enter the password of the user on the SNMP


manager that is to receive the notification.

Confirm password Type the password again.

Privacy encryption protocol Enter the privacy encryption protocol of the


user on the SNMP manager that is to receive
the notification.

Privacy password Enter the privacy password used to encrypt


the message being sent.

Confirm password Type the password again.

Notify on transition to Select the alarm condition that has to be met


before the notification is sent.

[Conditions list] Use the conditions list to add or remove


conditions for when the notification is to be
displayed or sent and to make condition
settings.

Add condition
Click to add a condition that has to be met
for the notification to be displayed or sent.
For more information, see section 29.8
Alarm Filter Conditions on page 685.

Remove condition
Click to remove a condition that has to be
met for the notification to be displayed or
sent.

Add row
Click to add a row to the condition.

Remove row
Click to remove the row from the condition.

Clear all
Click to clear the selected conditions.

System 04-17005-03-en, October 2015


1054
33 Alarms User Interface
33.87 SNMP Notification View

33.87 SNMP Notification View


Use the SNMP Notification view to view or edit an SNMP notification.
For more information, see section 31.27 Notifications on page 848.

Figure: SNMP Notification view

04-17005-03-en, October 2015 System


1055
33 Alarms User Interface
33.87 SNMP Notification View

Table: SNMP Notification Basic Tab


Property Description

Status Select Disabled to deactivate the


notification function.

Schedule Enter the schedule or other multistate


variable that contains the value that activates
the notification.

Active value Enter the value, generated by the connected


schedule or other multistate variable, that
activates the notification.

Address Type the address to the SNMP manager that


receives the notification.

Port Type the port that is used by the SNMP


manager that receives the notification.

User name Type the user name of the user on the


SNMP manager that receives the
notification.

Text Type the text content or the substitution


code for the text content the notification is to
have when sent.

Security level Select the security level.

Authentication protocol Select the authentication level.

Authentication password Enter the password of the user on the SNMP


manager that is to receive the notification.

Confirm password Type the password again.

Privacy encryption protocol Enter the privacy encryption protocol of the


user on the SNMP manager that is to receive
the notification.

Privacy password Enter the privacy password used to encrypt


the message being sent.

Confirm password Type the password again.

Notify on transition to Select the alarm condition that has to be met


before the notification is sent.

[Conditions list] Use the conditions list to add or remove


conditions for when the notification is to be
displayed or sent and to make condition
settings.

Add condition
Click to add a condition that has to be met
for the notification to be displayed or sent.
For more information, see section 29.8
Alarm Filter Conditions on page 685.

System 04-17005-03-en, October 2015


1056
33 Alarms User Interface
33.87 SNMP Notification View

Continued
Property Description

Remove condition
Click to remove a condition that has to be
met for the notification to be displayed or
sent.

Add row
Click to add a row to the condition.

Remove row
Click to remove the row from the condition.

Clear all
Click to clear the selected conditions.

04-17005-03-en, October 2015 System


1057
33 Alarms User Interface
33.88 SNMP Notification Properties

33.88 SNMP Notification Properties


Use the SNMP Notification dialog box to edit an SNMP notification.

Note
You can only edit filter conditions by clicking the notification.

Figure: SNMP Notification properties

Table: SNMP Notification Properties


Property Description

Status Select Disabled to deactivate the


notification function.

Schedule Enter the schedule or other multistate


variable that contains the value that activates
the notification.

Active value Enter the value, generated by the connected


schedule or other multistate variable, that
activates the notification.

System 04-17005-03-en, October 2015


1058
33 Alarms User Interface
33.88 SNMP Notification Properties

Continued
Property Description

Address Type the address to the SNMP manager that


receives the notification.

Port Type the port that is used by the SNMP


manager that receives the notification.

User name Type the user name of the user on the


SNMP manager that receives the
notification.

Text Type the text content or the substitution


code for the text content the notification is to
have when sent.

Security level Select the security level.

Authentication protocol Select the authentication level.

Authentication password Enter the password of the user on the SNMP


manager that is to receive the notification.

Confirm password Type the password again.

Privacy encryption protocol Enter the privacy encryption protocol of the


user on the SNMP manager that is to receive
the notification.

Privacy password Enter the privacy password used to encrypt


the message being sent.

Confirm password Type the password again.

04-17005-03-en, October 2015 System


1059
33 Alarms User Interface
33.89 Create Write to File Notification Wizard Write to File Notification Page

33.89 Create Write to File Notification


Wizard Write to File Notification Page
Use the Write to File Notification page to set up the conditions for the write to file
notification.

Figure: Write to file Notification page

Table: Write to File Notification page


Component Description

Status Select Disabled to deactivate the write to


file notification function, that is, no
information is written to the file.

Notify on transition to Select the alarm condition that has to be met


before the notification is written to the file.

File name Type the name of the file in which the


notification is to be written. If the file does not
exist, a new file with this name is created.

Text Type the text content of the text file that is to


be sent when the conditions are met.

Active value Enter the value, generated by the connected


schedule or other multistate variable, that is
to activate this Write to file notification
object.

Schedule Enter the schedule or other multistate


variable that contains the value that is to be
used to activate the Write to file notification.

System 04-17005-03-en, October 2015


1060
33 Alarms User Interface
33.89 Create Write to File Notification Wizard Write to File Notification Page

Continued
Component Description

[Conditions list] Use the conditions list to add or remove


conditions for when the notification is to be
written to the file and to configure the
conditions.

Add condition
Click to add a condition that has to be met
for the notification to be written to the file.
For more information, see section 29.8
Alarm Filter Conditions on page 685.

Remove condition
Click to remove a condition that has to be
met for the notification to be written to the
file.

Add row
Click to add a row to the condition.

Remove row
Click to remove the row from the condition.

Clear all
Click to clear the selected conditions.

04-17005-03-en, October 2015 System


1061
33 Alarms User Interface
33.90 Write to File Notification View

33.90 Write to File Notification View


Use the Write to File Notification view to view and edit the settings of a write to file
notification.

Figure: Write to file notification view

Table: Write to File Notification View


Component Description

Name Type the name of the object to create.

Description Type a description that explains what the


object is used for.

Status Select Disabled to deactivate the write to


file notification function, that is, no
information is written to the file.

Notify on transition to Select the alarm condition that has to be met


before the notification is written to the file.

File name Type the name of the file in which the


notification is to be written. If the file does not
exist, a new file with this name is created.

Text Type the text content of the text file that is to


be sent when the conditions are met.

Active value Enter the value, generated by the connected


schedule or other multistate variable, that is
to activate this Write to file notification
object.

Schedule Enter the schedule or other multistate


variable that contains the value that is to be
used to activate the Write to file notification.

[Conditions list] Use the conditions list to add or remove


conditions for when the notification is to be
written to the file and to configure the
conditions.

System 04-17005-03-en, October 2015


1062
33 Alarms User Interface
33.90 Write to File Notification View

Continued
Component Description

Add condition
Click to add a condition that has to be met
for the notification to be written to the file.
For more information, see section 29.8
Alarm Filter Conditions on page 685.

Remove condition
Click to remove a condition that has to be
met for the notification to be written to the
file.

Add row
Click to add a row to the condition.

Remove row
Click to remove the row from the condition.

Clear all
Click to clear the selected conditions.

04-17005-03-en, October 2015 System


1063
33 Alarms User Interface
33.91 Write to File Notification Properties

33.91 Write to File Notification Properties


Use the Write to File Notification properties to configure the message and file
name.

Note
You can only edit filter conditions by clicking the notification.

Figure: Write to file notification properties

Table: Write to File Notification Properties


Component Description

File name Type the name of the file in which the


notification is to be written. If the file does not
exist, a new file with this name is created.

Text Type the text content of the text file that is to


be sent when the conditions are met.

Schedule Enter the schedule or other multistate


variable that contains the value that is to be
used to activate the Write to file notification.

System 04-17005-03-en, October 2015


1064
33 Alarms User Interface
33.91 Write to File Notification Properties

Continued
Component Description

Active value Enter the value, generated by the connected


schedule or other multistate variable, that is
to activate this Write to file notification
object.

Status Select Disabled to deactivate the write to


file notification function, that is, no
information is written to the file.

04-17005-03-en, October 2015 System


1065
33 Alarms User Interface
33.92 Create Assignment Wizard Assignment Page

33.92 Create Assignment Wizard


Assignment Page
Use the Assignment page to set the assignment conditions that have to be met for
the alarm to be assigned.

Figure: Assignment page

Table: Assignment Page


Component Description

Status Enter the schedule or other multistate


variable that contains the value that activates
the assignment.

Schedule Enter the schedule or other multistate


variable that contains the value that activates
the assignment.

Active value Enter the value, generated by the connected


schedule or other multistate variable, that is
to activate this assignment object.

Assigned to Click the browse button to open the Users


and Groups dialog box where you select
the Building Operation user or user group to
receive the assignment request. For more
information, see section 33.95 Users and
Groups Dialog Box on page 1071.

[Conditions list] Use the conditions list to add or remove


conditions for when the alarm is to be
assigned and to make condition settings.

System 04-17005-03-en, October 2015


1066
33 Alarms User Interface
33.92 Create Assignment Wizard Assignment Page

Continued
Component Description

Add condition
Click to add a condition that has to be met
for the alarm to get assigned to the recipient.
For more information, see section 29.8
Alarm Filter Conditions on page 685.

Remove condition
Click to remove a condition that has to be
met for the assignment to be sent to the
recipient.

Add row
Click to add a row to the condition.

Remove row
Click to remove the row from the condition.

Clear all
Click to clear the selected conditions.

04-17005-03-en, October 2015 System


1067
33 Alarms User Interface
33.93 Assignment View

33.93 Assignment View


Use the Assignment view to edit automatic alarm assignments.

Figure: Assignment view

Table: Assignment View


Component Description

Name Type the name of the object to create.

Description Type a description that explains what the


object is used for.

Status Select Disabled to deactivate the


assignment function.

Schedule Enter the schedule or other multistate


variable that contains the value that is to be
used to activate the assignment.

Active value Enter the value, generated by the connected


schedule or other multistate variable, that is
to activate this assignment object.

Assigned to Click the browse button to open the Users


and Groups dialog box where you select
the Building Operation user or user group to
receive the assignment request. For more
information, see section 33.95 Users and
Groups Dialog Box on page 1071.

System 04-17005-03-en, October 2015


1068
33 Alarms User Interface
33.93 Assignment View

Continued
Component Description

(Conditions list) Use the conditions list to add or remove


conditions for when the alarm is to be
assigned and to make condition settings.

Add condition
Click to add a condition that has to be met
for the alarm to get assigned to the recipient.
For more information, see section 29.8
Alarm Filter Conditions on page 685.

Remove condition
Click to remove a condition that has to be
met for the assignment to be sent to the
recipient.

Add row
Click to add a row to the condition.

Remove row
Click to remove the row from the condition.

Clear all
Click to clear the selected conditions.

04-17005-03-en, October 2015 System


1069
33 Alarms User Interface
33.94 Assignment Properties

33.94 Assignment Properties


Use the Assignment properties to configure which user or user group receives the
assignment request.

Figure: Assignment properties

Table: Assignment Properties


Component Description

Status Select Disabled to deactivate the


assignment function.

Schedule Enter the schedule or other multistate


variable that contains the value that is to be
used to activate the assignment.

Active value Enter the value, generated by the connected


schedule or other multistate variable, that is
to activate this assignment object.

Assigned to Click the browse button to open the Users


and Groups dialog box where you select
the Building Operation user or user group to
receive the assignment request. For more
information, see section 33.95 Users and
Groups Dialog Box on page 1071.

System 04-17005-03-en, October 2015


1070
33 Alarms User Interface
33.95 Users and Groups Dialog Box

33.95 Users and Groups Dialog Box


Use the Users and Groups dialog box to select the users or groups of users to
receive an email notification for an alarm, a recipient for an alarm assigment request,
or to select users or groups whose context-sensitive path permissions you want to
configure.

Important
You can only select users or user groups that reside on the same SmartStruxure
server as the email notification.

Figure: Users and Groups dialog box for email notifications

04-17005-03-en, October 2015 System


1071
33 Alarms User Interface
33.95 Users and Groups Dialog Box

Figure: Users and Groups dialog box for automatic alarm assignments

System 04-17005-03-en, October 2015


1072
33 Alarms User Interface
33.95 Users and Groups Dialog Box

Figure: Users and Groups dialog box for context-sensitive path permissions

Table: Users and Group Dialog Box


Component Description

Domain Select the domain the user or user group


belongs to.

Quick filter Use the quick filter to filter on the user or


user group to which you want to assign an
alarm. For more information, see section
49.6 Quick Filter on page 1571.

User account type: Users Select the user account to which you want
to send an email notification or send an
assignment request.

User account type: Groups Select the user account group to which you
want to send an email notification or send an
assignment request.

Add Use the Add button to add the user or user


group to the email notification or
assignment.

04-17005-03-en, October 2015 System


1073
33 Alarms User Interface
33.96 Alarm View Properties

33.96 Alarm View Properties


Use the Alarm View properties to configure and view the general and object
references properties. For more information, see section 50.34 General
Properties Basic Tab on page 1642.

Figure: Alarm properties

System 04-17005-03-en, October 2015


1074
33 Alarms User Interface
33.97 Progress View

33.97 Progress View


The Progress view displays information about time-consuming operations
between WorkStation and the SmartStruxure server.

Figure: The Progress view

Table: Progress View


Component Description

Operation Displays the name of the operation that is


being performed.

Name Displays the name of the object that the


operation is performed on.

Progress Displays the progress of the operation so


you can determine when the operation is
complete.

Status Displays the status of the operation.

Click to get details for the operation.

Close Click to close the Progress view dialog


box.

04-17005-03-en, October 2015 System


1075
33 Alarms User Interface
33.98 Alarm Handling Properties

33.98 Alarm Handling Properties


Use the Alarm Handling Properties view or dialog box to configure and view the
general and object-reference properties. For more information, see section 50.34
General Properties Basic Tab on page 1642.

Figure: Alarm Handling Properties

System 04-17005-03-en, October 2015


1076
33 Alarms User Interface
33.99 Alarms Pane Shortcut Menu

33.99 Alarms Pane Shortcut Menu


Use the Alarms pane shortcut menu to manage the alarms in the Alarms pane.

Figure: Alarms pane shortcut menu

Table: Alarms Pane Shortcut Menu


Command Description

Acknowledge Click to acknowledge the alarm state or


reset state.
For more information, see the Alarm
Acknowledgements topic on WebHelp.

Enable alarm Click to enable the alarm. If the alarm state


changed, for example from alarm state to
normal state during the time the alarm was
disabled, the alarm is given the new state
once it is enabled.
For more information, see the Disable and
Enable Alarms topic on WebHelp.

Disable alarm Click to disable the alarm. The alarm is


disabled and cannot be acknowledged or
reset until it is enabled.
For more information, see the Disable and
Enable Alarms topic on WebHelp.

Recheck Click to update the current alarm state.

04-17005-03-en, October 2015 System


1077
33 Alarms User Interface
33.99 Alarms Pane Shortcut Menu

Continued
Command Description

Unhide alarm Click to show the alarm.


For more information, see the Hide and
Show Alarms topic on WebHelp.

Hide alarm Click to hide the alarm from the Alarms


pane. The alarm is still logged in the event
log.
For more information, see the Hide and
Show Alarms topic on WebHelp.

Enable state-change logging Click to start logging an event each time the
alarm is changing its state.
For more information, see the Alarm State-
Change Logging topic on WebHelp.

Disable state-change logging Click to stop logging an event every time the
alarm is changing its state.
For more information, see the Alarm State-
Change Logging topic on WebHelp.

Self-assign Click to assign the alarm to yourself.


For more information, see the Alarm
Assignments topic on WebHelp.

Assign Click to assign the alarm to another user.


For more information, see the Alarm
Assignments topic on WebHelp.

Reject Click to reject the alarm.


For more information, see the Alarm
Assignments topic on WebHelp.

Accept Click to accept the alarm.


For more information, see the Alarm
Assignments topic on WebHelp.

Release Click to release an alarm that is assigned to


you.
For more information, see the Alarm
Assignments topic on WebHelp.

Add comment Click to add a comment to the alarm.


For more information, see the Alarm
Comments topic on WebHelp.

Add cause note Click to add a cause note to the alarm.


For more information, see the Cause Notes
topic on WebHelp.

System 04-17005-03-en, October 2015


1078
33 Alarms User Interface
33.99 Alarms Pane Shortcut Menu

Continued
Command Description

Add action note Click to add an action note to the alarm.


For more information, see the Action Notes
topic on WebHelp.

Checklist Click to view the checklist of the alarm.


For more information, see the Checklists
topic on WebHelp.

Turn off visual and audible alert Click to turn off visual and audible alert.

Attachments Click to open the file or document that is


attached to the alarm.
For more information, see section 31.21
Alarm Attachments on page 839.

Show alarm Click to open the settings of the alarm in the


Work area.

View history Click to view the history of an alarm in the


work area.

Alarm view settings Click to open the alarm view settings


submenu in WorkStation.

View Events Click to open the Event View in WebStation.


For more information, see the Events Pane
and Event View topic on WebHelp.

Alarm details Click to open the Alarm details dialog box


in WebStation.
For more information, see the Alarm Details
Dialog Box topic on WebHelp.

Alarm view settings Click to open the Alarm view settings


submenu where you can make a number of
Alarm View settings for the current Alarms
pane or Alarm View. For more information,
see section 33.100 Alarms Pane Shortcut
Menu - Alarm View Settings Submenu on
page 1080.

04-17005-03-en, October 2015 System


1079
33 Alarms User Interface
33.100 Alarms Pane Shortcut Menu - Alarm View Settings Submenu

33.100 Alarms Pane Shortcut Menu - Alarm


View Settings Submenu
Use the Alarm View Settings submenu to change the way alarms are presented.

Figure: Alarm view settings submenu

Table: Alarm View Settings Submenu


Command Description

Display Alarm View Displays an Alarm View in a new window


when an alarm is triggered. For more
information, see section 29.7 Displaying
Alarm View on an Alarm on page 684.

Edit Standard Alarm View filter Click to open the Select Conditions dialog
box, where you sort out the information in an
Alarms pane. For more information, see
section 33.78 Select Conditions Dialog
Box Alarm Filter Properties on page 1040.

Save as Standard Alarm View layout Click to save the current Alarms pane or
Alarm View layout as the Standard layout for
all users and for the Alarms pane or the
specific Alarm View.

Reset Standard Alarm View layout to Click to reset the Alarms pane or Alarm View
factory default standard layout to factory default.

Add/Remove columns Click to open the Add/Remove columns


dialog box to add or remove columns from
the Alarms pane. For more information, see
the Add/Remove Columns Dialog Box topic
on WebHelp.

Properties Click to open the Alarm View properties


dialog box to view and edit the properties of
the Alarm pane and Alarm View. For more
information, see section 33.96 Alarm View
Properties on page 1074.

Alarm state sort order Click to open the Alarm state sort order
dialog box to determine how alarms will be
sorted when the column State is used for
sorting the alarms in the Alarms pane. For
more information, see the Determining the
Alarm State Sort Order topic on WebHelp.

System 04-17005-03-en, October 2015


1080
33 Alarms User Interface
33.100 Alarms Pane Shortcut Menu - Alarm View Settings Submenu

Continued
Command Description

Detailed view Opens a detailed view for the selected alarm.


For more information, see section 33.4
Alarm and Event Detail View on page 913.

04-17005-03-en, October 2015 System


1081
34 Events

introduction to this topic

Topics
How Events Work
Events Pane and Event View Customization
Styling a Certain Event in the Events Pane or Event View
Event Filter Conditions
Applying an Event Filter
Applying an Event Time Filter
Creating a Filtered Event View
Filter Condition Wildcards
Viewing Events in This Branch
Viewing Events for Properties Bound to a Graphic
Viewing Events from the Watch Pane
34 Events
34.1 How Events Work

34.1 How Events Work


All system events, as well as information and circumstances, are recorded in the
Event log. These event records can be viewed in the Events pane or in an Event
View.
Events can tell you when someone logged on or off the system, when a setpoint
was changed, if a notification was written to a file, if an email notification was sent or
not and when an object was created. For example, Events can tell you when a trend
log or an alarm was created, and by whom. The event log also records when
SmartStruxure server devices were online or offline and when the software was
upgraded. The event log is useful for tracking down all information in your system.
To limit the events displayed in the WorkStation Events pane, you can use the time
interval filter or a number of other filters. An indicator tells you the number of
displayed events.
You can create and use more than one Event View. Each Event View and the
Events pane can be customized with an event filter to only show the information you
are interested in.
You can view all events that have been generated from one object in the system.
In WorkStation, you can also view all events for a branch. A branch can be, for
example, a folder or a network including all contents.
When you view Events in this branch, the events are based on the path of the
branch. This means that there is no complete list of historical events for objects that
have been moved into the branch. Historical events are also lost if the container has
been moved or renamed. Events for objects that has been removed or deleted from
the container are displayed.
In the Events view, you can also open a detailed view to inspect all properties for a
selected event.

Figure: Events pane in WorkStation (top) and WebStation (bottom)

04-17005-03-en, October 2015 System


1085
34 Events
34.1 How Events Work

34.1.1 Events Pane and Event View Customization


You can style certain events to bring out those that are of more interest than other
events listed in the Events pane and Event Views. To style a specific event, you first
have to create a condition that is associated with the events you want to style. An
event can be styled with a unique background color, font, and font color.
For more information, see section 34.2 Events Pane and Event View
Customization on page 1087.

34.1.2 Event Filter Conditions


Event filter conditions are used to set up the conditions for the events you want to
be displayed in the Events pane or an Event View.
For more information, see section 34.4 Event Filter Conditions on page 1091.

34.1.3 Archive Overview


Archiving is the process of preserving historical data, which is comprised of
selected events and extended trend logs. For example, some facilities are required
to maintain archives to comply with government regulations. Another example is in
secure facilities where they must maintain records of who logged in or who
changed setpoints. Archiving is not a backup function because archive data cannot
be imported back into the system.
For more information, see section 52.1 Archiving Overview on page 1695.

System 04-17005-03-en, October 2015


1086
34 Events
34.2 Events Pane and Event View Customization

34.2 Events Pane and Event View


Customization
You can style certain events to bring out those that are of more interest than other
events listed in the Events pane and Event Views. To style a specific event, you first
have to create a condition that is associated with the events you want to style. An
event can be styled with a unique background color, font, and font color.
For example, you can style all events where an alarm is acknowledged. To separate
this event from others you configure, change the background color to dark green
and the font color to white. All other events have the default style which is a white
background and black font color.

Figure: Events View with all acknowledged events and all events of a certain category
styled
If an event fulfills the condition criteria in more than one of the configured event
criteria, it is the event style with highest priority in the Events View Style dialog box
that is applied to the event.

04-17005-03-en, October 2015 System


1087
34 Events
34.3 Styling a Certain Event in the Events Pane or Event View

34.3 Styling a Certain Event in the Events


Pane or Event View
You style the appearance of an event in the Events pane or Event View to easily
detect the event when it occurs.
For more information, see section 34.2 Events Pane and Event View
Customization on page 1087.

To style a certain event in the Events pane or Event View


1. Click somewhere in the Events pane or Event View to make sure the pane or
dialog box is in focus.
2. On the Actions menu, click Edit the style of associated events.

3. Click the Add style button.

4. In the Condition box, click the Browse button.


Continued on next page

System 04-17005-03-en, October 2015


1088
34 Events
34.3 Styling a Certain Event in the Events Pane or Event View

5. In the Select Conditions dialog box, click the Add condition button
and select an event category.

6. Enter the settings of the event category associated with the event you want to
style.

Note
You can add several event categories to specify the event in
detail.

7. Click the Add row button to add another condition of the same type.
8. Click OK.
9. In the Event Styles dialog box, in the Background color box, click the
Browse button.
10. Select the color for the background of the event row in the Events pane or
Event View.

11. Click OK.


12. In the Font color box, click the Browse button.
13. Select the color for the font of the event in the Events pane or Event View.
14. Click OK.
Continued on next page

04-17005-03-en, October 2015 System


1089
34 Events
34.3 Styling a Certain Event in the Events Pane or Event View

15. In the Font box, click the Browse button.


16. In the Font dialog box, select the font, font style and size that you want to
display the certain event text in.
17. Click OK.
18. In the Event Styles dialog box, click OK.
You can add several event styles to different associated events.

System 04-17005-03-en, October 2015


1090
34 Events
34.4 Event Filter Conditions

34.4 Event Filter Conditions


Event filter conditions are used to set up the conditions for the events you want to
be displayed in the Events pane or an Event View.
You can use wildcards when setting up filter conditions. For more information, see
section 34.8 Filter Condition Wildcards on page 1102.

Table: Event Filter Conditions


Component Description

Acknowledge time Enter the property to filter events by the time


and date an alarm was acknowledged.

Alarm state Select the property to filter events by the


alarm state.

Alarm text Type the property to filter events by the


alarm message that was added to the alarm.
Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

Assigned state Select the property to filter events by the


assigned state the alarm had. The possible
values are Unassigned, Assigned and
Accepted.

Assigned to domain Type the property to filter events by the


domain of the user or group that an alarm
was assigned to. Wildcards can be used.
For more information, see section 34.8 Filter
Condition Wildcards on page 1102.

Assigned to ID Type the property to filter events by the ID of


the user or group that an alarm was
assigned to. Wildcards can be used. For
more information, see section 34.8 Filter
Condition Wildcards on page 1102.

Assigned to name Type the property to filter events by the


name of the user or group that an alarm was
assigned to. Wildcards can be used. For
more information, see section 34.8 Filter
Condition Wildcards on page 1102.

BACnet alarm type Select the property to filter events by the


BACnet alarm that monitored a variable
within a BACnet network.

Basic evaluation state Select the property to filter events by the


basic evaluation state of an alarm. The value
True indicates that an alarm was triggered.

Category Type the property to filter events by the


category name. Wildcards can be used. For
more information, see section 34.8 Filter
Condition Wildcards on page 1102.

04-17005-03-en, October 2015 System


1091
34 Events
34.4 Event Filter Conditions

Continued
Component Description

Command Type the property to filter events by the


executed command. Wildcards can be
used. For more information, see section 34.8
Filter Condition Wildcards on page 1102.

Comment Type the property to filter events by the


comment that was added to an alarm.
Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

Control source Type the property to filter events by the


initials of the controlling I/NET operator.
Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

Control state Select the property to filter events by the 4


bit I/NET state descriptor.

Count Enter the property to filter events by the


number of times an alarm has toggled
between the alarm and reset state.

Description Type the property to filter events by their


description. Wildcards can be used. For
more information, see section 34.8 Filter
Condition Wildcards on page 1102.

Device name Type the property to filter events by the


name of the I/NET device that generated the
event. Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

Disabled cause Select the property to filter events by the


cause for why the alarm was disabled. An
alarm can be disabled by user, shunt
variable and/or system (its disabled by
system if the alarm was incorrectly
configured).

Domain name Select the property to filter events by the


domain a user belonged to.

Evaluation state Select the property to filter events by the


evaluation state an alarm had. For example,
Upper limit alarm is displayed if the
monitored value reached the upper alarm
limit.

EWS ID Type the property to filter events by the id of


the event on the external system. Wildcards
can be used. For more information, see
section 34.8 Filter Condition Wildcards on
page 1102.

System 04-17005-03-en, October 2015


1092
34 Events
34.4 Event Filter Conditions

Continued
Component Description

EWS source ID Type the property to filter events by the id of


the external object that generated the event.
Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

EWS source name Type the property to filter events by the


name of the external object that generated
the event. Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

First name Type the property to filter events by the first


name of the individual whose key/card was
used at the I/NET door point. Wildcards can
be used. For more information, see section
34.8 Filter Condition Wildcards on page
1102.

Forced value Type the property to filter events by forced


values. Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

Group Type the property to filter events by the


name of the cause note or action note group
the user edited. Wildcards can be used. For
more information, see section 34.8 Filter
Condition Wildcards on page 1102.

Hidden Select the property to filter events by the


visible status an object had. False is
displayed when an object was shown.

Individual Enter the property to filter events by the


individual number of the individual whose
key/card was used at the I/NET door point.

INET address Type the property to filter events by the


system address of the point, or station
address of the host or controller that
generated the event. Wildcards can be used.
For more information, see section 34.8 Filter
Condition Wildcards on page 1102.

INET event type Select the property to filter events by the


I/NET event type.

Last name Type the property to filter events by the last


name of the individual whose key/card was
used at the I/NET door point. Wildcards can
be used. For more information, see section
34.8 Filter Condition Wildcards on page
1102.

04-17005-03-en, October 2015 System


1093
34 Events
34.4 Event Filter Conditions

Continued
Component Description

Link name Type the property to filter events by the


name assigned to the link of the device from
which the event originated. Wildcards can be
used. For more information, see section 34.8
Filter Condition Wildcards on page 1102.

Message text Type the property to filter events by the text


of an I/NET actio or dispatch message, if
there is one.

Monitored variable Type the property to filter events by path to


the monitored variable. Wildcards can be
used. For more information, see section 34.8
Filter Condition Wildcards on page 1102.

Note Type the property to filter events by their


note. Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

Previous alarm state Select the property to filter events by the


previous alarm state.

Priority Enter the property to filter events by the


priority an alarm had.

Sigma event parameters Type the property to filter events by the


Sigma event parameter. Wildcards can be
used. For more information, see section 34.8
Filter Condition Wildcards on page 1102.

Sigma event type Select the property to filter events by the


Sigma event type.

Source Type the property to filter events by the path


of the source object. Wildcards can be used.
For more information, see section 34.8 Filter
Condition Wildcards on page 1102.

Source name Type the property to filter events by the


name of the external object that generated
the event. Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

Source server Type the property to filter events by the


server path of the source object. Wildcards
can be used. For more information, see
section 34.8 Filter Condition Wildcards on
page 1102.

State Type the property to filter events by (up to) 4


text characters that represent the text state
of a discrete point or the unit description of
an analog point. Wildcards can be used. For
more information, see section 34.8 Filter
Condition Wildcards on page 1102.

System 04-17005-03-en, October 2015


1094
34 Events
34.4 Event Filter Conditions

Continued
Component Description

Station name Type the property to filter events by the


name assigned to the controller from which
the event originated. Wildcards can be used.
For more information, see section 34.8 Filter
Condition Wildcards on page 1102.

System alarm ID Select the property to filter events by the


alarm ID generated by the system.

System event ID Select the property to filter events by the


event ID generated by the system.

Tenant Enter the property to filter events by the


tenant number of the individual whose
key/card was used at the I/NET door point.

Timestamp Enter the property to filter events by the time


and date when the event was generated.

Triggered time Enter the property to filter events by the time


and date an alarm went from normal state to
alarm state.

Type Select the property to filter events by event


type.

Unique alarm ID Type the property to filter events by the


unique alarm ID of an alarm. Wildcards can
be used. For more information, see section
34.8 Filter Condition Wildcards on page
1102.

Unique user ID Type the property to filter events by the ID of


a user. Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

User action item Type the property to filter events of which


the user has edited checklist, cause note
group, or action note group items. Wildcards
can be used. For more information, see
section 34.8 Filter Condition Wildcards on
page 1102.

User name Type the property to filter events by the


name of the user that generated the event.
Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

Value after Type the property to filter events by the value


of an object after it was changed. Wildcards
can be used. For more information, see
section 34.8 Filter Condition Wildcards on
page 1102.

04-17005-03-en, October 2015 System


1095
34 Events
34.4 Event Filter Conditions

Continued
Component Description

Value at change Type the property to filter events by the value


the monitored variable had when the alarm
was triggered. Wildcards can be used. For
more information, see section 34.8 Filter
Condition Wildcards on page 1102.

Value before Type the property to filter events by the value


of an object before it was changed.
Wildcards can be used. For more
information, see section 34.8 Filter
Condition Wildcards on page 1102.

Zone Select the property to filter events by I/NET


security zone number associated with a
security event (0-63).

Filter condition wildcards


A wildcard is one or more characters used to simplify the process of setting up filter
conditons. You use wildcards to subsitute characters or combinations of characters
in object properties, such as names or descriptions. For example, instead of setting
up five filter conditions for values with names beginning with a, b, c, d, or e, you can
set up one single filter condition for values with a name beginning with any of the
characters in the range [a-e].
For more information, see section 34.8 Filter Condition Wildcards on page 1102.

System 04-17005-03-en, October 2015


1096
34 Events
34.5 Applying an Event Filter

34.5 Applying an Event Filter


You use an event filter to make the Events pane or Event View only display events
that are of interest.

To apply an event filter


1. In WorkStation, in the System Tree pane, select the Events pane or Event
View you want to filter.
2. On the Actions menu, click Edit Event Filter.

3. In the Select Conditions dialog box, click the Add condition button
and select an event category.

4. Enter the settings of the event category that generates the writing action.

Note
You can add multiple event types.

5. Click the Add row button to add another condition of the same type.

6. Click OK.

04-17005-03-en, October 2015 System


1097
34 Events
34.5 Applying an Event Filter

The event filter has been created and is now applied to the Events pane or Event
View.

System 04-17005-03-en, October 2015


1098
34 Events
34.6 Applying an Event Time Filter

34.6 Applying an Event Time Filter


You use the event time filter to limit the number of events displayed in the Events
pane or to narrow a search based on a particular time interval.
For more information, see section 34.1 How Events Work on page 1085.

To apply an event time filter


1. In WorkStation, open the Events pane.
2. Click the No time filter drop-down menu.
3. Select Time interval.

4. Enter the start time.


5. Enter the end time.
6. Click Apply.
(In FM: TaskClosing) The Events pane displays the events generated within the
selected time interval.

04-17005-03-en, October 2015 System


1099
34 Events
34.7 Creating a Filtered Event View

34.7 Creating a Filtered Event View


You create a new filtered Event View to monitor and handle events. By adding an
event filter you only display events that you are interested in.
For more information, see section 34.2 Events Pane and Event View
Customization on page 1087.

To create a filtered Event View


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where you want to create the event.
2. On the File menu, point to New and then click View.
3. In the object type list, click Event View.

4. In the Name box, type a name for the Event View.


5. In the Description box, type a description for the Event View.
6. Click Create.
7. In the System Tree pane, select the Event View that you want to add an
event filter to.
8. On the Actions menu, click Edit Event Filter.
Continued on next page

System 04-17005-03-en, October 2015


1100
34 Events
34.7 Creating a Filtered Event View

9. In the Select Conditions dialog box, click the Add Condition button
and select a condition.

10. Enter the settings of the condition.

Tip
You can add several event view conditions to specify when to write
the event view.

11. Click the Add row button to add another condition of the same type.
12. Click OK.

04-17005-03-en, October 2015 System


1101
34 Events
34.8 Filter Condition Wildcards

34.8 Filter Condition Wildcards


A wildcard is one or more characters used to simplify the process of setting up filter
conditons. You use wildcards to subsitute characters or combinations of characters
in object properties, such as names or descriptions. For example, instead of setting
up five filter conditions for values with names beginning with a, b, c, d, or e, you can
set up one single filter condition for values with a name beginning with any of the
charachters in the range [a-e].

Table: Wildcard Characters


Character Description

* Use to match any combination of


characters, including no character

? Use to match any one character exactly

[ Use to begin a SET, that is, a number of


characters or a range

] Use to end a SET

[] Use to match any one character specified


within the SET, that is, enclosed by the
brackets

! Use to exclude the characters or range(s) of


a SET

- Use in a range within a SET: 0-9, a-z, A-Z

\ Use to ignore the wildcard character and


search for it as any other character

Any other character has to match exactly.


You can specify any number of characters or a range within brackets. In this case,
the filter includes one character specified within the brackets and any number of
characters specified outside the brackets.
Examples:
*at - Matches "at" and all objects ending with "at"
?t - Matches all two-character objects ending with "t"
[CB]at - Matches "Cat" and "Bat", that is, objects beginning with any one character
specified within the SET and ending with "at"
[A-C]at - Matches "Aat", "Bat", and "Cat"
[CB][au]t - Matches "Cat", "Cut", "Bat", and "But"
[!a-b0-1q]at - Matches all three-character objects ending with 'at' except "aat",
"bat", "0at", "1at" and "qat"
\\ - Matches "\"
b\\t - Matches b\t

System 04-17005-03-en, October 2015


1102
34 Events
34.8 Filter Condition Wildcards

Table: Wildcard Availability for Different Features


Feature * ? [b] [a-c] [\]] [!a-c]

Alarm View Yes Yes Not Not Not Not


Filter available available available available
Conditions

Event View Yes Yes Yes Yes Not Not


Filter available available
Conditions

Sum Alarm Yes Yes Yes Yes Yes Yes


Filter
Conditions

Notification Yes Yes Yes Yes Yes Yes


s Filter
Condition

Assignmen Yes Yes Yes Yes Yes Yes


ts Filter
Conditions

04-17005-03-en, October 2015 System


1103
34 Events
34.9 Viewing Events in This Branch

34.9 Viewing Events in This Branch


You view events in this branch when you want to view all the events below a certain
branch in the system. A branch can be any object that can contain other objects,
for example, a folder or a network.
For more information, see section 34.1 How Events Work on page 1085.

To view events in this branch


1. In the System Tree pane, select the object that you want to view the events
for.
2. On the Actions menu, point to View and then click Events in this branch.
(In FM: TaskClosing) The events for the selected object and all its contents are
displayed in the work area.

System 04-17005-03-en, October 2015


1104
34 Events
34.10 Viewing Events for Properties Bound to a Graphic

34.10 Viewing Events for Properties Bound to


a Graphic
You can view events for the selected properties of objects bound to, for example,
components in a graphic or graphic elements.
For more information, see section 34.1 How Events Work on page 1085.

To view events for properties bound to a graphic


1. In WorkStation, in the System Tree pane, select the graphic bound to the
object containing the properties whose events you want to view.
2. In the Graphic View, right-click the component or element in the graphic
containing the bound object.
3. Point to View and then click Events.

4. In the Objects and properties list, select the property whose events you
want to view.
5. Click Open.
The events of the property are displayed in an Events View in the WorkStation work
area.

04-17005-03-en, October 2015 System


1105
34 Events
34.11 Viewing Events from the Watch Pane

34.11 Viewing Events from the Watch Pane


You can view events for properties selected in the Watch pane.
For more information, see section 34.1 How Events Work on page 1085.

To view events from the Watch pane


1. In WorkStation, in the System Tree pane, select the object with the property
whose events you want to view.
2. Drag the object containing the property to the Watch pane.
3. Select the property in the Watch pane.
4. Right-click the selection.
5. Point to View and then click Events.

6. In the Objects and properties list, select the property whose events you
want to view.
7. Click Open.
The events of the property are displayed in an Events View in the WorkStation work
area. If you are viewing the events for properties on a single object in the Watch
pane, the events are displayed in an Event View without showing the objects and
properties dialog box.

System 04-17005-03-en, October 2015


1106
35 Events User Interface

introduction to this topic

Topics
Events Pane and Event View
Events Pane and Event View Toolbar
Object-Specific Event View
Object-Specific Event View Toolbar
Event Styles Dialog Box
Event View Properties
Add/Remove Columns Dialog Box (Events)
Select Conditions Dialog Box Events Filter Properties
35 Events User Interface
35.1 Events Pane and Event View

35.1 Events Pane and Event View


Use the Events pane and Event Views to view system or individual point events.

Figure: Events pane with Details view

Table: Events Pane and Event View


Number Description

Use the Events pane and Event View toolbar


to stop or resume showing new events. For
more information, see section 35.2 Events
Pane and Event View Toolbar on page
1110.

Use the Events pane and Event View time


filter to filter out events that occured during
the selected time period.

Use the Events pane and Event View Quick


filter to enter a word to filter on. For more
information, see section 49.6 Quick Filter
on page 1571.

Use the Events pane and Event View


columns to sort, hide, or show information
about the events. For more information, see
the Add/Remove Columns Dialog Box topic
on WebHelp.

Use the Detail view to display all information


about a selected event.

04-17005-03-en, October 2015 System


1109
35 Events User Interface
35.2 Events Pane and Event View Toolbar

35.2 Events Pane and Event View Toolbar


Use the Events pane and Event View toolbar to manage the events.

Table: Events Pane and Event View Toolbar


Button Description

Pause
Click to stop showing new events in the
Events pane and Event View.

Resume
Click to start showing new events in the
Events pane and Event View.

Group box
Click to display the Show/Hide Group box to
group and sort objects. For more
information, see the Group and Sort Objects
topic on WebHelp.

Save current settings


Click to save the settings.

Event filter
Click to select the conditions for the event
display in the Events pane. For more
information, see section 35.8 Select
Conditions Dialog Box Events Filter
Properties on page 1121.

No time filter Select Time interval to set a time interval


filter on the events you want to display.

Quick filter Enter a word or a character to filter on. For


more information, see section 49.6 Quick
Filter on page 1571.

Detail view
Click to display detailed information about all
properties of a selected event, in an added
view. For more information, see section 33.4
Alarm and Event Detail View on page 913.

System 04-17005-03-en, October 2015


1110
35 Events User Interface
35.3 Object-Specific Event View

35.3 Object-Specific Event View


Use the Object-Specific Event View to view all events that are related to a
specific object.

Figure: Object-specific Event View

Table: Object-Specific Event View


Number Description

Use the Object Specific Events View toolbar


to administer which events to display. For
more information, see section 35.4 Object-
Specific Event View Toolbar on page 1112.

Use the Property menu to select the object


property you want to display.

Use the Object Specific Events View


columns to sort, hide, or show information
about the events. For more information, see
the Add/Remove Columns Dialog Box topic
on WebHelp.

Use the Show Events menu to select the


time interval or the number of events you
want to display.

04-17005-03-en, October 2015 System


1111
35 Events User Interface
35.4 Object-Specific Event View Toolbar

35.4 Object-Specific Event View Toolbar


Use the Object-Specific Event View toolbar to manage how to display events.

Table: Object-Specific Event View Toolbar


Object Description

Group box
Click to display the Show/Hide Group box to
group and sort objects. For more
information, see the Group and Sort Objects
topic on WebHelp.

Show Events Select the time span or the number of events


to display.

Refresh
Click to refresh the event list with the latest
events.

Quick filter Enter a word or a character to filter on. For


more information, see section 49.6 Quick
Filter on page 1571.

System 04-17005-03-en, October 2015


1112
35 Events User Interface
35.5 Event Styles Dialog Box

35.5 Event Styles Dialog Box


Use the Event Styles dialog box to edit the fonts and colors for different events in
the Events pane and Event View.

Figure: Event Style dialog box

Table: Event Style Dialog Box


Component Description

Add style
Click to add and configure a new event to
style.

Delete style
Click to remove an event style.

Move up
Click to increase the priority of an event.

Move down
Click to decrease the priority of an event.

Priority Enter the priority of the event to style.

Condition Enter the condition or conditions of the event


to style.

Background color Enter the background color of the row for


events in the Events pane and Event View
that fulfill the configured conditions.

04-17005-03-en, October 2015 System


1113
35 Events User Interface
35.5 Event Styles Dialog Box

Continued
Component Description

Font color Enter the font color to use for events in the
Events pane and Event View that fulfill
configured conditions.

Font Enter the font to use for events in the Events


pane and Event View that fulfill configured
conditions.

System 04-17005-03-en, October 2015


1114
35 Events User Interface
35.6 Event View Properties

35.6 Event View Properties


Use the Event View properties for viewing and editing the properties of the Events
pane and Event View.

Figure: Event View properties

Table: Event View Properties


Component Description

Number of records shown Enter the number of rows you want to list in
the Events pane or Event view. You can
enter any number between 1 and 5999.

Important
By default, the latest 1000 event records are displayed in the Event View.
Regardless of the number of event records in the database, you can display a
maximum of 5999 event records at a time in the Event View.
You can use the filter to display a different set of event records, maximum
5999 records at a time.

04-17005-03-en, October 2015 System


1115
35 Events User Interface
35.7 Add/Remove Columns Dialog Box (Events)

35.7 Add/Remove Columns Dialog Box


(Events)
Use the Add/Remove columns dialog box to add or remove columns from the
Events pane.

Figure: Add/Remove Columns dialog box

Table: Add/Remove Columns


Component Description

Acknowledge time Select to display the time and date when the
alarm was acknowledged. For more
information, see section 31.14
Acknowledgements on page 828.

Alarm state Select to display the alarm state. For more


information, see section 29.2 Alarm States
on page 675.

Alarm text Select to display the alarm message that


was added to the alarm. For more
information, see section 31.6 Alarm
Messages on page 818.

Assigned state Select to display the assigned state the


alarm had. For more information, see the
Alarm Assignment topic on WebHelp.

Assigned to domain Select to display the domain of the user or


group that an alarm was assigned to. For
more information, see section 21.1
Domains on page 459.

System 04-17005-03-en, October 2015


1116
35 Events User Interface
35.7 Add/Remove Columns Dialog Box (Events)

Continued
Component Description

Assigned to ID Select to display the ID of the user or group


that an alarm was assigned to.

Assigned to name Select to display the name of the user or


group that an alarm was assigned to. For
more information, see section 29.3 Alarm
Functions on page 676.

BACnet alarm type Select to display the BACnet alarm that


monitored a variable within a BACnet
network.

Basic evaluation state Select to display the basic evaluation state of


an alarm. The value True indicates that an
alarm was triggered.

Category Select to display the alarm category name.

Command Select to display the executed command.

Comment Select to display the comment that was


added to an alarm.

Control Source Select to display the initials of the controlling


I/NET operator.

Control State Select to display the 4 bit I/NET state


descriptor.

Count Select to display the number of times an


alarm has toggled between the alarm and
reset state. For more information, see the
Count topic on WebHelp.

Description Select to display the event description. For


more information, see section 50.34
General Properties Basic Tab on page
1642.

Device Name Select to display the name of the I/NET


device that generated the event.

Disabled cause Select to display the cause for why the alarm
was disabled. An alarm can be disabled by
user, shunt variable and/or system (its
disabled by system if the alarm was
incorrectly configured).

Domain name Select to display the domain a user


belonged to. For more information, see
section 21.1 Domains on page 459.

Evaluation State Select to display the evaluation state an


alarm had. For example, Upper limit alarm is
displayed if the monitored value reached the
upper alarm limit.

04-17005-03-en, October 2015 System


1117
35 Events User Interface
35.7 Add/Remove Columns Dialog Box (Events)

Continued
Component Description

EWS ID Select to display the EcoStruxure Web


Service identification of the event on the
external system.

EWS source ID Select to display the EcoStruxure Web


Service identification of the external object
that generated the event.

EWS source name Select to display the events ty the name of


the external object that generated the event.

First Name Select to display the first name of the


individual whose key/card was used at the
I/NET door point.

Forced value Select to display the forced values.

Group Select to display the name of the cause note


or action note group the user edited.

Hidden Select to display the visible status an object


had. False is displayed when an object was
shown.

Individual Select to display the individual number of the


individual whose key/card was used at the
I/NET door point.

INET Address Select to display the system address of the


point, or station address of the host or
controller that generated the event.

INET Event Type Select to display the I/NET event type.

Last Name Select to display the last name of the


individual whose key/card was used at the
I/NET door point.

LinkName Select to display the name assigned to the


link of the device from which the event
originated.

Message Text Select to display the text of an I/NET action


or dispatch message, if there is one.

Monitored variable Select to display the path of the monitored


variable.

Note Select to display event notes.

Previous alarm state Select to display the previous alarm state.

Priority Select to display the priority an alarm had.

Sequence number Select to display the event sequence


number on the present server.

System 04-17005-03-en, October 2015


1118
35 Events User Interface
35.7 Add/Remove Columns Dialog Box (Events)

Continued
Component Description

Sigma event parameters Select to display parameters of the Sigma


event.

Sigma event type Select to display the Sigma event type.

Source Select to display the path of the source


object.

Source server Select to display the server path of the


source object.

State Select to display the events in (up to) 4 text


characters that represent the text state of a
discrete point or the unit description of an
analog point.

StationName Select to display the name assigned to the


device from which the event originated.

System alarm ID Select to display the alarm ID generated by


the system.

System event ID Select to display the event ID generated by


the system.

Tenant Select to display the tenant number of the


individual whose key/card was used at the
I/NET door point.

Text Select to display the text messages in the E-


mail in a E-mail notification. For more
information, see section 31.27
Notifications on page 848.

Timestamp Select to display the time and date when the


event was generated.

Triggered time Select to filter events by the time and date an


alarm went from normal state to alarm state.

Type Select to display the event type. For more


information, see section 50.34 General
Properties Basic Tab on page 1642.

Unique alarm ID Select to display the ID of the alarm that


generated the event.

Unique user ID Select to display the ID of the user that


generated the event.

User action item Select to display events of which the user


has edited checklist, cause note group, or
action note group items.

User name Select to display the name of the user that


generated the event.. For more information,
see section 34.2 Events Pane and Event
View Customization on page 1087.

04-17005-03-en, October 2015 System


1119
35 Events User Interface
35.7 Add/Remove Columns Dialog Box (Events)

Continued
Component Description

Value after Select to display the value of an object after


it was changed.

Value at change Select to display the value the monitored


variable had when the alarm was triggered.

Value before Select to display the value of an object


before it was changed.

Zone Select to display the I/NET security zone


number associated with a security event (0-
63).

System 04-17005-03-en, October 2015


1120
35 Events User Interface
35.8 Select Conditions Dialog Box Events Filter Properties

35.8 Select Conditions Dialog Box Events


Filter Properties
Use the Select Conditions dialog box to make it easier to find a specific type of
event.

Figure: Event filter conditions

Table: Event Filter Properties


Component Description

Add condition
Click to customize the conditions to sort out
the events that are of interest.
For more information, see section 34.4
Event Filter Conditions on page 1091.

Remove condition
Click to remove an added condition.

Add row
Click to add an additional row with the same
condition.

Delete row
Click to remove a condition row.

Clear all
Click to clear the selected conditions.

04-17005-03-en, October 2015 System


1121
36 Trend Log Introduction

Topics
Trend Overview
Clearing a Trend Log
Editing or Commenting a Trend Log Record
Displaying the History of a Trend Log Record
Trend Units
Enabling a Trend Log
Disabling a Trend Log
Editing the Activation Method in a Trend Log
36 Trend Log Introduction
36.1 Trend Overview

36.1 Trend Overview


The function of a trend log is to log the variable that it is connected to and store the
records.
To be able to store larger amount of records, you connect an extended trend log.
The records of the trend log and the extended trend log can be presented
numerically in a trend log list or graphically in a trend chart. The records can also be
processed by a calculation method before they are presented.

04-17005-03-en, October 2015 System


1125
36 Trend Log Introduction
36.1 Trend Overview

Figure: Trend overview.

System 04-17005-03-en, October 2015


1126
36 Trend Log Introduction
36.1 Trend Overview

Note
A trend log that monitors an enumeration records the enumeration value and not
the enumeration definition.
For more information, see section 52.12 Event and Alarm Enumerations on
page 1720.
For more information, see section 52.15 Trend Log Enumerations on page
1740.

36.1.1 Trend Log Types


You use a trend log to collect data and then store the records. A record contains a
log value or an event as well as its time stamp and an optional comment. A trend
log can log an analog variable, a digital variable, or an integer variable.
For more information, see section 37.1 Trend Log Types on page 1139.

36.1.2 Trend Log Functions


All trend logs store records by using the circular storing principle; you can also
connect trends logs to external trend logs with larger storing capacity. For some
trend logs you can set up conditions that have to be fulfilled before the trend log
starts recording.
For more information, see section 38.1 Trend Log Functions on page 1215.

36.1.3 Trend Units


You can define the unit of a trend log when the trend log is created or on a
previously created trend log where no unit has been set.
For more information, see section 36.5 Trend Units on page 1132.

36.1.4 Trend Log List


The trend log list numerically displays the records of a trend log or an extended
trend log. The records of the trend log can be processed by a calculation method
before they are presented in the trend log list.
For more information, see section 40.1 Trend Log Lists on page 1299.

36.1.5 Trend Charts


A trend chart displays the records of a trend log or an extended trend log as a
series.
For more information, see section 39.1 Trend Charts on page 1241.

04-17005-03-en, October 2015 System


1127
36 Trend Log Introduction
36.1 Trend Overview

36.1.6 Move or Copy Trend Logs or Extended Trend


Logs
When moving or copying a trend log or extended trend log to another
SmartStruxure server, only the configuration of the trend log is transferred. If you
copy the trend log to another SmartStruxure server, all recorded values are
preserved in the original trend log while the copy on the other SmartStruxure server
does not contain any recorded values. If you move the trend log to another
SmartStruxure server, the configuration of the trend log is preserved but the record
values are lost.

Caution
Recorded values are lost when you move or copy a trend log to another
SmartStruxure server.

36.1.7 Mass Create


You use the mass create feature to create multiple identical alarms or trend logs for
different objects, instead of creating the alarms or trend logs one by one. From
trend logs, you can mass create extended trend logs.
For more information, see section 42.1 Mass Create on page 1393.

System 04-17005-03-en, October 2015


1128
36 Trend Log Introduction
36.2 Clearing a Trend Log

36.2 Clearing a Trend Log


You clear a trend log to remove all recorded values. This procedure does not clear
meter settings in the meter trend log.
For more information, see section 36.1 Trend Overview on page 1125.

Caution
Ensure that the recorded values are backed up or not needed. Clearing a
trend log permanently erases all records and events.

To clear a trend log


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where the trend log is located.
2. Select the trend log you want to clear
3. On the Actions menu, point to Activation, and then click Clear trend log.

4. In the Clear log dialog box, click Yes to confirm that you want to clear the
trend log.

The trend log is now cleared.

04-17005-03-en, October 2015 System


1129
36 Trend Log Introduction
36.3 Editing or Commenting a Trend Log Record

36.3 Editing or Commenting a Trend Log


Record
You edit or comment a trend log record through the trend log list, for example, to
correct a corrupt value or comment a specific record.

Note
When editing an extended trend log record, the changes do not affect
corresponding record in the connected trend log.

For more information, see section 40.1 Trend Log Lists on page 1299.

To edit a trend log record


1. In WorkStation, in the System Tree pane, select the trend log list you want to
edit.
2. Select the record you want to edit, and then click the Edit/comment trend

log record button .


3. In the Value box, type the new value.

4. In the Comment box, type a comment.


5. Click Save.

6. On the main toolbar, click the Refresh button .


The record is now edited, when the list is refreshed the new record with comment is
displayed. All edits are stored and you can display a records history.

System 04-17005-03-en, October 2015


1130
36 Trend Log Introduction
36.4 Displaying the History of a Trend Log Record

36.4 Displaying the History of a Trend Log


Record
You show the history of a trend log record, such as the original value as well as
edits, through the trend log list.
For more information, see section 40.1 Trend Log Lists on page 1299.

To display the history of a trend log record


1. In WorkStation, in the System Tree pane, select the trend log list you want to
show.
2. In the Trend log list, right-click a record, and then click Show history.

3. Click Close.

The dialog box displays all old values and which user that edited the record.

04-17005-03-en, October 2015 System


1131
36 Trend Log Introduction
36.5 Trend Units

36.5 Trend Units


You can define the unit of a trend log when the trend log is created or on a
previously created trend log where no unit has been set.
Do not change the unit of a surveyed variable to a unit outside the trend log unit
category. The trend log stops logging because of the conversion problem and data
is lost. A system alarm is triggered and the trend log record is given the status: A log
value was missed.
Extended trend logs get the initial unit of the connected trend log. If you change the
unit of the connected trend log, it does not affect the unit of the extended trend log.
If no unit has been set on the connected trend log, the extended trend log does not
get a unit. You can change the unit of an extended trend log.
By default, trend charts and trend log lists display the values according to the unit
that is defined in your operating system settings. You can select to display units in a
different unit system, or display units as configured in the connected objects.
For example, a variable that represents a temperature in Kelvin is surveyed by an
interval trend log. The trend log is configured to store the values in degrees
Fahrenheit. A trend log list and trend chart are connected to the trend log. If you
display the trend chart or trend log list on an operating system that uses the SI
metric system, the values in the trend log list and trend chart are converted and
displayed in degrees Celsius.

System 04-17005-03-en, October 2015


1132
36 Trend Log Introduction
36.5 Trend Units

Figure: In this setup the variable has the temperature unit Kelvin, recorded trend log
values are stored in Fahrenheit, and are displayed in Celsius.

04-17005-03-en, October 2015 System


1133
36 Trend Log Introduction
36.6 Enabling a Trend Log

36.6 Enabling a Trend Log


You enable trend log to start recording values.
For more information, see section 38.3 Activation Methods on page 1217.

To enable a trend log


1. In WorkStation, System Tree pane, select the folder or SmartStruxure server
where the trend log is located.
2. Select the trend log you want to enable.
3. On the Actions menu, point to Activation, and then click Enable trend
log.

The trend log is now enabled and starts recording when its start condition is fulfilled.

System 04-17005-03-en, October 2015


1134
36 Trend Log Introduction
36.7 Disabling a Trend Log

36.7 Disabling a Trend Log


You disable a trend log to stop recording values.
For more information, see section 38.3 Activation Methods on page 1217.

To disable a trend log


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where the trend log is located.
2. Select the trend log you want to disable
3. On the Actions menu, point to Activation, and then click Disable trend
log.

The trend log is now disabled.

04-17005-03-en, October 2015 System


1135
36 Trend Log Introduction
36.8 Editing the Activation Method in a Trend Log

36.8 Editing the Activation Method in a


Trend Log
You edit the activation method property to define the criteria that executes the trend
log to start recording.
For more information, see section 38.3 Activation Methods on page 1217.

To edit the activation method in a trend log


1. In WorkStation, in the System tree pane, select the folder or SmartStruxure
server where the trend log is located.
2. Select the trend log you want to configure.
3. On the File menu, click Properties.
4. In the Activation method box, select the new activation method.

5. Click OK.

System 04-17005-03-en, October 2015


1136
37 Trend Log Types

Topics
Trend Log Types
Interval Trend Logs
Interval Trend Log Delta
Creating an Interval Trend Log
Configuring an Interval Trend Log
Editing the Interval of an Interval Trend Log
Editing the Delta in an Interval Trend Log
Meter Trend Logs
Creating a Meter Trend Log and Associated Objects
Creating a Meter Trend Log
Managing Replacement of a Meter
Configuring a Meter Trend Log
Displaying Meter Change History
Change of Value Trend Logs
Creating a Change of Value Trend Log
Configuring a Change of Value Trend Log
Variable Triggered Trend Logs
Creating a Variable Triggered Trend Log
Configuring a Variable Triggered Trend Log
Manual Trend Logs
Creating a Manual Trend Log
Configuring a Manual Trend Log
Adding a Trend Log Record to a Manual Trend Log
Implicit Trend Logs
37 Trend Log Types
37.1 Trend Log Types

37.1 Trend Log Types


You use a trend log to collect data and then store the records. A record contains a
log value or an event as well as its time stamp and an optional comment. A trend
log can log an analog variable, a digital variable, or an integer variable.
For performance reasons and to make the trend log less sensitive to if a
SmartStruxure server device goes off line, it is recommended that you place trend
logs as closely to the logged variable as possible. Preferably on the SmartStruxure
server device where the logged variable is located. For example, if a sensor is
connected to an Automation Server, the trend log that records the temperature
should be placed on that Automation Server.
You can use extended trend logs to structure the log data and to store it where
there is greater storage capacity.
When you create a trend log, the wizard helps you create and set up an extended
trend log, a trend log list, and a trend chart as well as the chosen trend log type. For
more information, see section 36.1 Trend Overview on page 1125.

04-17005-03-en, October 2015 System


1139
37 Trend Log Types
37.1 Trend Log Types

Figure: Trend wizard flow chart

System 04-17005-03-en, October 2015


1140
37 Trend Log Types
37.1 Trend Log Types

37.1.1 Interval Trend Logs


The interval trend log collects data at a specific time interval. Each logged value is
stored as a record in the trend log. Use this trend log when the logging interval is
less than 1 hour.
For more information, see section 37.2 Interval Trend Logs on page 1143.

37.1.2 Meter Trend Logs


The meter trend log is a variable triggered trend log with extra functionality to
seamlessly handle consumption calculations independent of meter rollover or meter
exchange.
For more information, see section 37.8 Meter Trend Logs on page 1160.

37.1.3 Change of Value Trend Logs


The change of value trend log records the variable each time the difference
between the current value and the last log value exceeds the delta. Use the change
of value trend log to, for example, record a variable that has an unequal oscillation.
For more information, see section 37.14 Change of Value Trend Logs on page
1189.

37.1.4 Variable Triggered Trend Logs


The variable triggered trend log records the variable when the conditions of the
associated trigger variable are met. Use this type of trend log when the log interval
is scheduled to log monthly or yearly, or when another device is used to trigger the
log.
For more information, see section 37.17 Variable Triggered Trend Logs on page
1198.

37.1.5 Manual Trend Logs


The manual trend log records data that you manually enter. The manual trend log
does not log a variable. Use this type of trend log when values from offline devices
have to be manually registered to the trend log. For example, if you want to create a
trend log that monitors an electricity meter that cannot be connected to Building
Operation.
For more information, see section 37.20 Manual Trend Logs on page 1205.

04-17005-03-en, October 2015 System


1141
37 Trend Log Types
37.1 Trend Log Types

37.1.6 Implicit Trend Logs


The implicit log is a change of value trend log which monitors the IO variable and
records a new value if the variable exceeds the delta. Each log value is stored as a
record in the trend log. The delta is automatically defined by Building Operation
depending on the measured unit of the device that is connected to the IO port.
For more information, see section 37.24 Implicit Trend Logs on page 1212.

System 04-17005-03-en, October 2015


1142
37 Trend Log Types
37.2 Interval Trend Logs

37.2 Interval Trend Logs


The interval trend log collects data at a specific time interval. Each logged value is
stored as a record in the trend log. Use this trend log when the logging interval is
less than 1 hour.
You create interval trend logs using WorkStation or WebStation. In WorkStation,
you configure the properties of the interval trend log to meet the specific needs of
your site.
For example, in the figure below, the interval trend log records a variable every
minute. The records are printed in a trend chart. The interval trend log does not
record the values between the intervals.

04-17005-03-en, October 2015 System


1143
37 Trend Log Types
37.2 Interval Trend Logs

Figure: Interval trend log schematic.

System 04-17005-03-en, October 2015


1144
37 Trend Log Types
37.2 Interval Trend Logs

The interval trend log, which is not a variable triggered trend log, has the function to
start log records according to a given start condition. For more information, see
section 38.3 Activation Methods on page 1217.

37.2.1 Interval Trend Log Delta


An interval trend log with delta can reduce the storage of similar records, and may
not fill up the storage capacity as quickly as an interval trend log with no delta.
An interval trend log with delta checks the monitored value at each interval and
records the new value if it differs from the previously recorded value by more than
the delta. Delta is the difference between the current variable value and the last log
value. To log a variable according to the time interval, use a delta of zero.
For example, in the figure below, the interval trend log records a variable every
minute but only if the variable exceeds or falls below the delta of 3. The records are
printed in a trend chart. Notice that the interval trend log with delta does not record
the values between the intervals, or on intervals where the variable is within the
delta.

Note
To log a variable only according to the time interval, set Delta to zero.

04-17005-03-en, October 2015 System


1145
37 Trend Log Types
37.2 Interval Trend Logs

Figure: Interval trend log with delta schematic.

System 04-17005-03-en, October 2015


1146
37 Trend Log Types
37.2 Interval Trend Logs

If an interval trend log has a delta and a calculation method that uses periods, make
sure the period contains the required amount of records to generate a correct
calculation. If the value does not differ from the previously logged value by more
than the delta within the period, then none or too few values are recorded for the
calculation.

Note
Adapt the period so it contains the required amount of records to generate a
correct calculation.
If a calculation method is connected to an interval trend log with delta, make
sure that the period and delta are adapted for the calculation.

04-17005-03-en, October 2015 System


1147
37 Trend Log Types
37.3 Interval Trend Log Delta

37.3 Interval Trend Log Delta


An interval trend log with delta can reduce the storage of similar records, and may
not fill up the storage capacity as quickly as an interval trend log with no delta.
An interval trend log with delta checks the monitored value at each interval and
records the new value if it differs from the previously recorded value by more than
the delta. Delta is the difference between the current variable value and the last log
value. To log a variable according to the time interval, use a delta of zero.
For example, in the figure below, the interval trend log records a variable every
minute but only if the variable exceeds or falls below the delta of 3. The records are
printed in a trend chart. Notice that the interval trend log with delta does not record
the values between the intervals, or on intervals where the variable is within the
delta.

System 04-17005-03-en, October 2015


1148
37 Trend Log Types
37.3 Interval Trend Log Delta

Figure: Interval trend log delta schematic

04-17005-03-en, October 2015 System


1149
37 Trend Log Types
37.3 Interval Trend Log Delta

An interval trend log with delta can reduce the storage of similar records, and may
not fill up the storage capacity as fast as an interval trend log with no delta.
If an interval trend log has a delta and a calculation method that uses periods, make
sure the period contains the required amount of records to generate a correct
calculation. If the value does not differ from the previously logged value by more
than the delta within the period, then none or too few values are recorded for the
calculation. If you want to calculate the required number of log records for a trend
log, you multiply the number of log records in one day with the number of days you
want to record. For example, the interval of the trend log is set to 1 hour, which
gives 24 recorded values per day. A trend log configured to record at least one
month records 31 days. The number of log records = 24 X 31 = 744.

Note
Adapt the period so it contains the required amount of records to generate a
correct calculation.
If a calculation method is connected to an interval trend log with delta, make
sure that the period and delta are adapted for the calculation.

System 04-17005-03-en, October 2015


1150
37 Trend Log Types
37.4 Creating an Interval Trend Log

37.4 Creating an Interval Trend Log


You create an interval trend log to record a value of a variable at specified and
regularly occurring increments of time.
For more information, see section 37.2 Interval Trend Logs on page 1143.

To create an interval trend log


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where you want to create the trend log.
2. On the File menu, point to New and then click Trend.
3. In the object type list, select Interval Trend Log.

4. In the Name box, type a name for the trend log.


Continued on next page

04-17005-03-en, October 2015 System


1151
37 Trend Log Types
37.4 Creating an Interval Trend Log

5. In the Description box, type a description for the trend log.

6. Click Next.
7. In the Logged variable box, enter the variable that you want to log.

8. In the Delta box, enter the minimum value change that triggers a new record.

9. In the Unit box, click the browse button .


Continued on next page

System 04-17005-03-en, October 2015


1152
37 Trend Log Types
37.4 Creating an Interval Trend Log

10. Select a unit for the trend log values.

11. In the Prefix box, select the prefix of the unit.


12. Click Select.
13. In the Interval box, type the log frequency.
Continued on next page

04-17005-03-en, October 2015 System


1153
37 Trend Log Types
37.4 Creating an Interval Trend Log

14. In the Log size box, type the log size time to be stored before old values are
overwritten.

15. In the Clear when enabled box, select True to clear the trend log every
time the trend log is enabled.
Continued on next page

System 04-17005-03-en, October 2015


1154
37 Trend Log Types
37.4 Creating an Interval Trend Log

16. In the Activation method box, select the condition to start the trend log:
Select Always active to start recording values immediately after the
trend log is created.
Select Variable controlled and then enter a variable in the Activation
variable box to start recording values when the start variable is true.
Select Start at activation time and then enter the time in the
Activation time box to specify an exact time for the recording to begin.

17. Click Next.


Continued on next page

04-17005-03-en, October 2015 System


1155
37 Trend Log Types
37.4 Creating an Interval Trend Log

18. In the Extended Trend Log box, click the browse button to create an
extended trend log and connect it to the trend log.

19. In the Trend Log List box, click the browse button to create a trend log
list and connect it to the trend log.
20. In the Trend Chart box, click the browse button to either create a new
trend chart or connect the interval trend log to an existing trend chart.
21. Click Create.

System 04-17005-03-en, October 2015


1156
37 Trend Log Types
37.5 Configuring an Interval Trend Log

37.5 Configuring an Interval Trend Log


You configure the properties of an interval trend log to meet the unique needs of
your site.
For more information, see section 37.17 Variable Triggered Trend Logs on page
1198.

To configure an interval trend log


1. In WorkStation, in the System Tree pane, select the interval trend log you
want to configure.
2. On the File menu, click Properties.
3. Edit the properties:
Property Description

Status Displays the status of the trend log.

Enabled Displays True if the trend log is enabled.

Activation time Enter the absolute start time when Time


mode is set to Absolute. This time is the
leftmost point of the x-axis.

Activation method Select the method for starting the trend


log. For more information, see section
38.3 Activation Methods on page 1217.

Clear when enabled Select True to clear the trend log when it
is enabled.

Activation variable Enter the variable that is to start the trend


log.

Logged variable Enter the variable that you want to log.

Interval Type how often to log the variable, the


interval defines the time between two log
records.

Log size Select the log size to store before old


records are overwritten. The system adds
a 5% buffer for events registered for the
log.

Delta Select the minimum value change that


triggers a new record.

4. Click OK.

04-17005-03-en, October 2015 System


1157
37 Trend Log Types
37.6 Editing the Interval of an Interval Trend Log

37.6 Editing the Interval of an Interval Trend


Log
You edit the interval property of a trend log to increase or decrease the frequency of
records.
For more information, see section 37.4 Creating an Interval Trend Log on page
1151.

To edit the interval of an interval trend log


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where the trend log is located.
2. Select the trend log you want to configure.
3. On the File menu, click Properties.
4. In the Interval box, type the new value.

5. Click OK.

System 04-17005-03-en, October 2015


1158
37 Trend Log Types
37.7 Editing the Delta in an Interval Trend Log

37.7 Editing the Delta in an Interval Trend


Log
You edit the delta property of a trend log to increase or decrease the number of
recorded values.
For more information, see section 37.2 Interval Trend Logs on page 1143.

To edit the delta in an interval trend log


1. In WorkStation, in the System tree pane, select the folder or SmartStruxure
server where the trend log is located.
2. Select the trend log you want to configure.
3. On the File menu, click Properties.
4. In the Delta box, edit the value.

5. Click OK.

04-17005-03-en, October 2015 System


1159
37 Trend Log Types
37.8 Meter Trend Logs

37.8 Meter Trend Logs


The meter trend log is a variable triggered trend log with extra functionality to
seamlessly handle consumption calculations independent of meter rollover or meter
exchange.
For more information, see section 37.17 Variable Triggered Trend Logs on page
1198.
You create and configure meter trend logs using WorkStation.
For example, in the figure below, the meter trend log records a meter the 1st of
every month. In the middle of February the meter rolls over to 00000. A chart with
meter consumption calculation prints the consumption every month.

System 04-17005-03-en, October 2015


1160
37 Trend Log Types
37.8 Meter Trend Logs

Figure: Meter trend log

04-17005-03-en, October 2015 System


1161
37 Trend Log Types
37.8 Meter Trend Logs

When physically replacing an old meter with a new one, you have to configure the
meter trend log by adding the settings of the old meter and new meter in the
Manage replacement of meter dialog box in WorkStation. These settings are
the foundation to handle a meter rollover or calculating consumption though meter
replacement. For more information, see section 41.13 Manage Replacement of
Meter Dialog Box on page 1345.

Figure: Manage replacement of meter dialog box where you enter the values of the new
and old meter.

Note
In order for a meter rollover to be managed correctly in the meter trend log
and to ensure logging starts at the correct energy reading value, you enter
previous meter and new meter information in the Manage replacement of
meter dialog box. For more information, see section 37.11 Managing
Replacement of a Meter on page 1185.

System 04-17005-03-en, October 2015


1162
37 Trend Log Types
37.9 Creating a Meter Trend Log and Associated Objects

37.9 Creating a Meter Trend Log and


Associated Objects
You use the meter trend log to record the value of a meter and handle consumption
calculations independent of meter rollover and meter exchange.
For more information, see section 37.8 Meter Trend Logs on page 1160.

To create a meter trend log and associated objects


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where you want to create the trend log.
2. On the File menu, point to New and then click Trend.
3. In the object type list, select Meter Trend Log.

4. In the Name box, type a name for the trend log.


Continued on next page

04-17005-03-en, October 2015 System


1163
37 Trend Log Types
37.9 Creating a Meter Trend Log and Associated Objects

5. In the Description box, type a description for the trend log.

6. Click Next.
7. In the Logged variable box, enter the variable that you want to log.

8. In the Trigger variable box, enter the variable that triggers the log.

9. In the Unit box, click the browse button .


Continued on next page

System 04-17005-03-en, October 2015


1164
37 Trend Log Types
37.9 Creating a Meter Trend Log and Associated Objects

10. Select a unit for the trend log values.

11. In the Prefix box, select the prefix of the unit.


12. Click Select.
13. In the Trigger when box, select when to record the value of the logged
variable:
Select Change to true to record the value of the logged variable when
the trigger variable changes to true.
Select Change to false to record the value of the logged variable when
the trigger variable changes to false.
Select All changes to record the value of the logged variable anytime
the trigger variable changes state.
14. In the Log size box, enter the number of records to be recorded before old
ones are overwritten.
Continued on next page

04-17005-03-en, October 2015 System


1165
37 Trend Log Types
37.9 Creating a Meter Trend Log and Associated Objects

15. In the Clear when enabled box, select True to clear the trend log every
time the trend log is enabled.

16. Click Next.


17. In the Start time box, enter the time when the meter is installed.

18. In the Start value box, enter the value of the meter when it was installed.
19. In the Min value box, enter the first value of the meter when it rolls over.
Continued on next page

System 04-17005-03-en, October 2015


1166
37 Trend Log Types
37.9 Creating a Meter Trend Log and Associated Objects

20. In the Max value box, enter the last value of the meter before it rolls over.

21. Click Next.

22. In the Extended Trend Log box, click the browse button to create an
extended trend log and connect it to the trend log.

Continued on next page

04-17005-03-en, October 2015 System


1167
37 Trend Log Types
37.9 Creating a Meter Trend Log and Associated Objects

23. Click Create.

24. In the Name box, type a name for the extended trend log.

25. In the Location box, enter the path where to store the extended trend log.
Continued on next page

System 04-17005-03-en, October 2015


1168
37 Trend Log Types
37.9 Creating a Meter Trend Log and Associated Objects

26. In the Description box, type a description for the extended trend log.

27. Click Next.


28. In the Monitored trend log box, make sure that the meter log is entered.

Continued on next page

04-17005-03-en, October 2015 System


1169
37 Trend Log Types
37.9 Creating a Meter Trend Log and Associated Objects

29. In the Smart log box, select if you want to use smart log:
Select True to enable Building Operation software to automatically
optimize the transfer rate of records from the monitored trend log to the
extended trend log.
Select False to manually specify the percentage threshold at which the
trend log transfers its records to the extended trend log, and then select
the percentage in the Threshold box.
30. In the Maximum transfer interval box, select the maximum length of time
that can pass between transfers.
31. In the Log records box, enter the number of records to be stored before old
ones are overwritten.
32. In the Include in reports box, select True to make the extended trend log
available to WebReports, for example, to include the extended trend log in a
trend log comparison report.
33. In the Transfer trigger variable box, enter a trigger variable to force a
transfer of all records from the trend log to the extended trend log, for
example, to generate a complete report. For more information, see section
38.4 Extended Trend Logs on page 1221.

Continued on next page

System 04-17005-03-en, October 2015


1170
37 Trend Log Types
37.9 Creating a Meter Trend Log and Associated Objects

34. Click Create.

35. In the Trend Log List box, click the browse button to create a trend log
list and connect it to the trend log.
36. Click Create.

Continued on next page

04-17005-03-en, October 2015 System


1171
37 Trend Log Types
37.9 Creating a Meter Trend Log and Associated Objects

37. In the Name box, type a name for the trend log list.

38. In the Location box, enter the path where to store the trend log list.
39. In the Description box, type a description for the trend log list.

40. Click Next.


Continued on next page

System 04-17005-03-en, October 2015


1172
37 Trend Log Types
37.9 Creating a Meter Trend Log and Associated Objects

41. In the Display trend log box, confirm that the meter log is automatically
entered.

42. In the Log space (records) box, enter the maximum number of records to
display in the trend log.

Continued on next page

04-17005-03-en, October 2015 System


1173
37 Trend Log Types
37.9 Creating a Meter Trend Log and Associated Objects

43. Click Create.

44. In the Trend Chart box, click the browse button to create a new trend
chart and connect it to the existing trend log.
45. Click Create.

Continued on next page

System 04-17005-03-en, October 2015


1174
37 Trend Log Types
37.9 Creating a Meter Trend Log and Associated Objects

46. In the Name box, type a name for the trend chart.

47. In the Location box, enter the path where to store the trend chart.
48. In the Description box, type a description for the trend chart.

49. Click Next.


Continued on next page

04-17005-03-en, October 2015 System


1175
37 Trend Log Types
37.9 Creating a Meter Trend Log and Associated Objects

50. In the Time mode box, select the time mode for the trend chart:
Select Absolute (start and end time) and then enter a start time in the
Start time box and an end time in the End time box to manually specify
the x-axis start point and end point. For more information, see section
39.8 Trend Chart Axes on page 1261.
Select Relative (to current time) and then type the time span in the
Time span box to automatically adapt the x-axis of the chart to display
the current time as the rightmost value. For more information, see section
39.8 Trend Chart Axes on page 1261.

Continued on next page

System 04-17005-03-en, October 2015


1176
37 Trend Log Types
37.9 Creating a Meter Trend Log and Associated Objects

51. In the Auto scale left Y-axis box, select True to automatically adapt the y-
axis scale to the trend log series.

52. Under Series, click the Add button to display additional trend data in the
trend chart.
53. In the object type list, select Trend Log Series or Real Time Trend
Series.

54. In the Name box, type a name for the series.


Continued on next page

04-17005-03-en, October 2015 System


1177
37 Trend Log Types
37.9 Creating a Meter Trend Log and Associated Objects

55. In the Description box, type a description for the series.

56. Click Next.


57. In the Display variable box, enter the variable you want to display in the
trend chart.

58. In the Weight box, enter the line weight of the series.
Continued on next page

System 04-17005-03-en, October 2015


1178
37 Trend Log Types
37.9 Creating a Meter Trend Log and Associated Objects

59. In the Show markers box, select True to display a marker for each
recorded value.

60. Click Create.

Continued on next page

04-17005-03-en, October 2015 System


1179
37 Trend Log Types
37.9 Creating a Meter Trend Log and Associated Objects

61. Click Create.

62. Click Create.


The meter trend log is now connected to an extended trend log, a trend log list, and
a trend chart.

System 04-17005-03-en, October 2015


1180
37 Trend Log Types
37.10 Creating a Meter Trend Log

37.10 Creating a Meter Trend Log


You use the meter trend log to record the value of a meter and seamlessly handle
consumption calculations independent of meter rollover and meter exchange.
For more information, see section 37.8 Meter Trend Logs on page 1160.

To create a meter trend log


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where you want to create the trend log.
2. On the File menu, point to New, and then click Trend.
3. Select Meter Trend Log.

4. In the Name box, type a name for the trend log.


5. In the Description box, type a description.
6. Click Next.
Continued on next page

04-17005-03-en, October 2015 System


1181
37 Trend Log Types
37.10 Creating a Meter Trend Log

7. In the Logged variable box, enter the variable that you want to log.

8. In the Trigger variable box, enter the variable that triggers the log.

9. In the Unit box, click the browse button .


10. Select a unit for the trend log values.

Continued on next page

System 04-17005-03-en, October 2015


1182
37 Trend Log Types
37.10 Creating a Meter Trend Log

11. In the Prefix box, select the prefix of the unit.


12. Click Select.
13. In the Trigger when box, select when to record the value of the logged
variable.
Select Change to true to record the value of the logged variable when
the trigger variable changes to true.
Select Change to false to record the value of the logged variable when
the trigger variable changes to false.
Select All changes to record the the value of the logged variable
anytime the trigger variable changes state.
14. In the Log records box, select the number of records to be recorded before
old ones are overwritten.
15. In the Clear when enabled box, select True to clear the trend log every
time the trend log is enabled.
16. Click Next.
17. In the Start time box, enter the time when the meter is installed.

18. In the Start value box, enter the value of the meter when it was installed.
19. In the Meter constant box, enter the constant of the meter.
20. In the Min value box, enter the first value of the meter when it rolls over.
21. In the Max value box, enter the last value of the meter before it rolls over.
22. Click Next.
Continued on next page

04-17005-03-en, October 2015 System


1183
37 Trend Log Types
37.10 Creating a Meter Trend Log

23. In the Extended Trend Log box, click the Browse button to create an
extended trend log and connect it to the trend log.

24. In the Trend Log List box, click the Browse button to create a trend
log list and connect it to the trend log.

25. In the Trend Chart box, click the Browse button to either create a
new trend chart or connect the trend log to an existing trend chart.
26. Click Create.
The meter trend log is created in the selected folder.

Note
When a meter trend log is created, you need to add the current meter value.

System 04-17005-03-en, October 2015


1184
37 Trend Log Types
37.11 Managing Replacement of a Meter

37.11 Managing Replacement of a Meter


You have to manage the meter settings each time a meter is replaced.
For more information, see section 37.8 Meter Trend Logs on page 1160.

To manage replacement of a meter


1. In WorkStation, in the System Tree pane, select the meter trend log you
want to manage.
2. On the Actions menu, click Manage Meter.
3. In the End time box, enter the end time of the old meter. Preferably the time
when the meter is replaced.

4. In the End value box, type the value of the old meter when it was replaced.
5. In the Start time box, enter the time when the new meter is installed.
6. In the Start value box, type the current value of the new meter when it was
installed.
7. In the Meter constant box, type the constant of the new meter.

Important
New meter:
Type the constant of the new meter if unit conversion is not used
in the meter trend log, for example, the old meter trend log
counted in grams and the new one counts in kilos (103) type
1000.
If unit conversion is used in the meter trend log - do not change
the meter constant.

8. In the Min value box, type the first value of the new meter when it rolls over.
Continued on next page

04-17005-03-en, October 2015 System


1185
37 Trend Log Types
37.11 Managing Replacement of a Meter

9. In the Max value box, type the last value of the new meter before it rolls over.

10. Click OK.

System 04-17005-03-en, October 2015


1186
37 Trend Log Types
37.12 Configuring a Meter Trend Log

37.12 Configuring a Meter Trend Log


You configure the properties of a meter trend log to meet the unique needs of your
site.
For more information, see section 37.8 Meter Trend Logs on page 1160.

To configure a meter trend log


1. In WorkStation, in the System Tree pane, select the meter trend log you
want to configure.
2. On the File menu, click Properties.
3. Edit the properties:
Component Description

Status Displays the status of the trend log.

Enabled Displays True if the trend log is enabled.

Clear when enabled Select True to clear the trend log when it
is enabled.

Delta Select the minimum value change that


triggers a new record.

Logged variable Enter the variable that you want to log.

Trigger variable Enter the variable that triggers the trend


log to start recording.

Trigger when Select when you want the variable


recorded: when trigger variable changes
to true, changes to false, or all changes.
For more information, see section 37.17
Variable Triggered Trend Logs on page
1198.

Log size Select the log size to store before old


records are overwritten.

4. Click OK.

04-17005-03-en, October 2015 System


1187
37 Trend Log Types
37.13 Displaying Meter Change History

37.13 Displaying Meter Change History


You view, through a trend log list, all meter change events that are registered by the
meter trend log.

Note
The meter change history is only applicable for the meter trend log.

For more information, see section 37.8 Meter Trend Logs on page 1160.

To display meter change history


1. In WorkStation, in the System Tree pane, select the trend log list that is
connected to a meter trend log.
2. On the Trend Log List toolbar, click the Show list of meter change

events button .

3. Click Close.
It is important that all meter changes are registered in the Manage replacement
of meter dialog box.

System 04-17005-03-en, October 2015


1188
37 Trend Log Types
37.14 Change of Value Trend Logs

37.14 Change of Value Trend Logs


The change of value trend log records the variable each time the difference
between the current value and the last log value exceeds the delta. Use the change
of value trend log to, for example, record a variable that has an unequal oscillation.

Note
The change of value trend log is limited to 10 records per second.
Do not set the delta too small since this can quickly fill up the trend log.

For example, in the figure below, the change of value trend log records a variable
every time the variable exceeds or falls below the delta of 3. The records are printed
in a trend chart. Notice that the change of value trend log records the values
without any time perspective between the records.

04-17005-03-en, October 2015 System


1189
37 Trend Log Types
37.14 Change of Value Trend Logs

Figure: Change of value trend log schematic.

System 04-17005-03-en, October 2015


1190
37 Trend Log Types
37.14 Change of Value Trend Logs

The change of value trend log, which is not a variable triggered trend log, has the
function to start log records according to a given start condition. For more
information, see section 38.3 Activation Methods on page 1217.

04-17005-03-en, October 2015 System


1191
37 Trend Log Types
37.15 Creating a Change of Value Trend Log

37.15 Creating a Change of Value Trend Log


You create a change of value trend log to record the changes of a variable.
For more information, see section 37.14 Change of Value Trend Logs on page
1189.

To create a change of value trend log


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where you want to create the trend log.
2. On the File menu, point to New, and then click Trend.
3. In the object type list, select Change of Value Trend Log.

4. In the Name box, type a name for the trend log.


Continued on next page

System 04-17005-03-en, October 2015


1192
37 Trend Log Types
37.15 Creating a Change of Value Trend Log

5. In the Description box, type a description for the trend log.

6. Click Next.
7. In the Logged variable box, enter the variable you want to log.

8. In the Delta box, enter the minimum value change that triggers a new record.

9. In the Unit box, click the browse button .


Continued on next page

04-17005-03-en, October 2015 System


1193
37 Trend Log Types
37.15 Creating a Change of Value Trend Log

10. Select a unit for the trend log values.

11. In the Prefix box, select the prefix of the unit.


12. Click Select.
13. In the Log size box, enter the number of records to be stored before old
values are overwritten.
14. In the Clear when enabled box, select True to clear the trend log every
time the trend log is enabled.
Continued on next page

System 04-17005-03-en, October 2015


1194
37 Trend Log Types
37.15 Creating a Change of Value Trend Log

15. In the Activation method box, select the condition to start the trend log:
Select Always active to start recording values immediately after the
trend log is created.
Select Variable controlled and then enter a variable in the Activation
variable box to start recording values when the start variable goes on.
Select Activation at start time and then enter the time in the
Activation time box to specify an exact time for the recording to begin.

16. Click Next.


Continued on next page

04-17005-03-en, October 2015 System


1195
37 Trend Log Types
37.15 Creating a Change of Value Trend Log

17. In the Extended Trend Log box, click the browse button to create an
extended trend log and connect it to the trend log.

18. In the Trend Log List box, click the browse button to create a trend log
list and connect it to the trend log.
19. In the Trend Chart box, click the browse button to either create a new
trend chart or connect the trend log to an existing trend chart.
20. Click Create.

System 04-17005-03-en, October 2015


1196
37 Trend Log Types
37.16 Configuring a Change of Value Trend Log

37.16 Configuring a Change of Value Trend


Log
You configure the properties of a change of value trend log to meet the unique
needs of your site.
For more information, see section 37.14 Change of Value Trend Logs on page
1189.

To configure a change of value trend log


1. In WorkStation, in the System Tree pane, select the change of value trend
log you want to configure.
2. On the File menu, click Properties.
3. Edit the properties:
Property Description

Status Displays the status of the trend log.

Enabled Displays True if the trend log is enabled.

Activation time Enter the absolute start time when Time


mode is set to Absolute. This time is the
leftmost point of the x-axis.

Activation method Select the method for starting the trend


log. For more information, see section
38.3 Activation Methods on page 1217.

Clear when enabled Select True to clear the trend log when it
is enabled.

Activation variable Enter the variable that is to start the trend


log.

Logged variable Enter the variable that you want to log.

Delta Select the minimum value change that


triggers a new record.

Log size Select the log size to store before old


records are overwritten.

4. Click OK.

04-17005-03-en, October 2015 System


1197
37 Trend Log Types
37.17 Variable Triggered Trend Logs

37.17 Variable Triggered Trend Logs


The variable triggered trend log records the variable when the conditions of the
associated trigger variable are met. Use this type of trend log when the log interval
is scheduled to log monthly or yearly, or when another device is used to trigger the
log.
For example, in the figure below, the variable triggered trend log records a variable
every time the associated trigger variable, for example, a switch, changes to true.
The records are printed in a trend chart. Notice that the variable triggered trend log
records the variable without any perspective to time or delta.

System 04-17005-03-en, October 2015


1198
37 Trend Log Types
37.17 Variable Triggered Trend Logs

Figure: Variable triggered trend log schematic

04-17005-03-en, October 2015 System


1199
37 Trend Log Types
37.17 Variable Triggered Trend Logs

You can configure the trend log to collect data when the trigger value changes to
True, changes to False, or All changes.

Figure: Trigger variable changes to true

Figure: Trigger variable changes to false

Figure: Trigger variable all changes

System 04-17005-03-en, October 2015


1200
37 Trend Log Types
37.18 Creating a Variable Triggered Trend Log

37.18 Creating a Variable Triggered Trend


Log
You create a variable triggered trend log to record the variable according to the
changes of an associated trigger variable.
For more information, see section 37.2 Interval Trend Logs on page 1143.

To create a variable triggered trend log


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where you want to create the trend log.
2. On the File menu, point to New, and then click Trend.
3. Select Variable Triggered Trend Log.

4. In the Name box, type a name for the trend log.


5. In the Description box, type a description.
6. Click Next.
Continued on next page

04-17005-03-en, October 2015 System


1201
37 Trend Log Types
37.18 Creating a Variable Triggered Trend Log

7. In the Logged variable box, enter the variable you want to log.

8. In the Trigger variable box, enter the variable that triggers the log.

9. In the Unit box, click Browse button .


10. Select a unit for the trend log values.

Continued on next page

System 04-17005-03-en, October 2015


1202
37 Trend Log Types
37.18 Creating a Variable Triggered Trend Log

11. In the Prefix box, select the prefix of the unit.


12. Click Select.
13. In the Trigger when box, select Change to true to log the variable when
the trigger variable changes to true.
14. In the Log records box, select the number of records to be stored before old
ones are overwritten.
15. In the Clear when enabled box, select True to clear the trend log every
time the trend log is enabled.
16. Click Next.

17. In the Extended Trend Log box, click the Browse button to create an
extended trend log and connect it to the trend log.

18. In the Trend Log List box, click the Browse button to create a trend
log list and connect it to the trend log.

19. In the Trend Chart box, click the Browse button to either create a
new trend chart or connect the trend log to an existing trend chart.
20. Click Create.
The variable triggered trend log is created in the selected folder.

04-17005-03-en, October 2015 System


1203
37 Trend Log Types
37.19 Configuring a Variable Triggered Trend Log

37.19 Configuring a Variable Triggered Trend


Log
You configure the properties of a variable triggered trend log to meet the unique
needs of your site.
For more information, see section 37.17 Variable Triggered Trend Logs on page
1198.

To configure a variable triggered trend log


1. In WorkStation, in the System Tree pane, select the variable triggered trend
log you want to configure.
2. On the File menu, click Properties.
3. Edit the properties:
Component Description

Status Displays the status of the trend log.

Enabled Displays True if the trend log is enabled.

Clear when enabled Select True to clear the trend log when it
is enabled.

Delta Select the minimum value change that


triggers a new record.

Logged variable Enter the variable that you want to log.

Trigger variable Enter the variable that triggers the trend


log to start recording.

Trigger when Select when you want the variable


recorded: when trigger variable changes
to true, changes to false, or all changes.
For more information, see section 37.17
Variable Triggered Trend Logs on page
1198.

Log size Select the log size to store before old


records are overwritten.

4. Click OK.

System 04-17005-03-en, October 2015


1204
37 Trend Log Types
37.20 Manual Trend Logs

37.20 Manual Trend Logs


The manual trend log records data that you manually enter. The manual trend log
does not log a variable. Use this type of trend log when values from offline devices
have to be manually registered to the trend log. For example, if you want to create a
trend log that monitors an electricity meter that cannot be connected to Building
Operation.

04-17005-03-en, October 2015 System


1205
37 Trend Log Types
37.20 Manual Trend Logs

Figure: Manual trend log schematic.

System 04-17005-03-en, October 2015


1206
37 Trend Log Types
37.21 Creating a Manual Trend Log

37.21 Creating a Manual Trend Log


You create a manual trend log that records data that you manually enter.
For more information, see section 37.20 Manual Trend Logs on page 1205.

To create a manual trend log


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where you want to create the trend log.
2. On the File menu, point to New, and then click Trend.
3. Select Manual Trend Log.

4. In the Name box, type a name for the trend log.


5. In the Description box, type a description.
6. Click Next.
Continued on next page

04-17005-03-en, October 2015 System


1207
37 Trend Log Types
37.21 Creating a Manual Trend Log

7. In the Unit box, click browse button .

8. Select a unit for the trend log values.

9. In the Prefix box, select the prefix of the unit.


10. Click Select.
Continued on next page

System 04-17005-03-en, October 2015


1208
37 Trend Log Types
37.21 Creating a Manual Trend Log

11. Click Next.

12. In the Extended Trend Log box, click the Browse button to create an
extended trend log and connect it to the trend log.

13. In the Trend Log List box, click the Browse button to create a trend
log list and connect it to the trend log.

14. In the Trend Chart box, click the Browse button to either create a new
trend chart or connect the trend log to an existing trend chart.
15. Click Create.
The manual trend log is created in the selected folder. You have to manually add the
records to the manual trend log.

04-17005-03-en, October 2015 System


1209
37 Trend Log Types
37.22 Configuring a Manual Trend Log

37.22 Configuring a Manual Trend Log


You configure the properties of a manual trend log to meet the unique needs of your
site.
For more information, see section 37.20 Manual Trend Logs on page 1205.

To configure a manual trend log


1. In WorkStation, in the System Tree pane, select the manual trend log you
want to configure.
2. On the File menu, click Properties.
3. Edit the properties:
Component Description

Unit Enter the unit the trend log stores the


records in.

Click to open the configuration dialog box


where you configure the property. For
more information, see section 50.36
Configure Dialog Box - Configuration
Tab on page 1645.

4. Click OK.

System 04-17005-03-en, October 2015


1210
37 Trend Log Types
37.23 Adding a Trend Log Record to a Manual Trend Log

37.23 Adding a Trend Log Record to a Manual


Trend Log
You have to manually add records to a manual trend log.
For more information, see section 37.20 Manual Trend Logs on page 1205.

Note
The Add trend log record dialog box is only applicable to manual trend
logs.

To add a trend log record to a manual trend log


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where the trend log is located.
2. Select the manual trend log you want add a value to.
3. On the Actions menu, point to Modification, and then click Add log
record.
4. In the Time stamp box, type the time of the new value.

5. In the Data type box, select Number if the value is an integer or decimal.
6. In the Value box, type the value.
7. In the Comment box, type a comment.
8. Click Add record.
9. Click Close.
The record is now added to the trend log.

04-17005-03-en, October 2015 System


1211
37 Trend Log Types
37.24 Implicit Trend Logs

37.24 Implicit Trend Logs


The implicit log is a change of value trend log which monitors the IO variable and
records a new value if the variable exceeds the delta. Each log value is stored as a
record in the trend log. The delta is automatically defined by Building Operation
depending on the measured unit of the device that is connected to the IO port.

Note
The implicit log is not manually created as with the other trend logs in
WorkStation.

The implicit trend log exists on all IO points. When a device is connected to an IO
port, the implicit trend log is automatically configured and starts recording values.

Table: The Implicit Trend Log Delta for Different Units


Unit Delta

Temp 0.2 C (0.2 F)

Voltage 0.2 V

Current 0.3 mA

Resistance 200

The implicit trend log stores approximately 500 records before old records are
overwritten.

System 04-17005-03-en, October 2015


1212
38 Trend Log Functions

Topics
Trend Log Functions
Log Record Storage
Activation Methods
Extended Trend Logs
Creating an Extended Trend Log
Configuring an Extended Trend Log
Editing the Threshold Property of an Extended Trend Log
Editing the Maximum Transfer Interval Property of an
Extended Trend Log
Editing the Number of Log Records for a Trend Log
Editing an Extended Trend Log to be Included in Reports
Manually Transferring Records to the Extended Trend Log
Viewing Related Trends
Viewing Related Trends for Properties Bound to a Graphic
38 Trend Log Functions
38.1 Trend Log Functions

38.1 Trend Log Functions


All trend logs store records by using the circular storing principle; you can also
connect trends logs to external trend logs with larger storing capacity. For some
trend logs you can set up conditions that have to be fulfilled before the trend log
starts recording.

38.1.1 Log Record Storage


All trend logs use circular storing. How many records a trend log can store before
overwriting old ones depends on the trend log configuration.
For more information, see section 38.2 Log Record Storage on page 1216.

38.1.2 Activation Methods


The interval trend log and change of value trend log start recording values when the
configured activation method is fulfilled. On all trend logs, you can manually stop
recording values by disabling the trend log. To resume the recording, you enable
the trend log.
For more information, see section 38.3 Activation Methods on page 1217.

38.1.3 Extended Trend Logs


You use an extended trend log to transfer records from a trend log. An extended
trend log can be connected to a trend log or connected in a series to another
extended trend log. Only one extended trend log can be connected to a trend log.
For more information, see section 38.4 Extended Trend Logs on page 1221.

04-17005-03-en, October 2015 System


1215
38 Trend Log Functions
38.2 Log Record Storage

38.2 Log Record Storage


All trend logs use circular storing. How many records a trend log can store before
overwriting old ones depends on the trend log configuration.
For example, a trend log is configured to store 10 records. The logging starts and
the first record x1 is stored. After 10 records the trend log is full. The next record
x11 overwrites the oldest record which in our case is x1. The next logging x12
overwrites the oldest record x2, and so on.

Figure: Circular storing, schematic

System 04-17005-03-en, October 2015


1216
38 Trend Log Functions
38.3 Activation Methods

38.3 Activation Methods


The interval trend log and change of value trend log start recording values when the
configured activation method is fulfilled. On all trend logs, you can manually stop
recording values by disabling the trend log. To resume the recording, you enable
the trend log.

38.3.1 Always active


Use always active to have the trend log start recording values 10 seconds after the
log is created or enabled.

Figure: Activation method, Always active

38.3.2 Variable Controlled


Use variable controlled start to have the trend log start recording values when a
connected variable goes on. This variable can be a scheduled variable or a variable
from a switch.

04-17005-03-en, October 2015 System


1217
38 Trend Log Functions
38.3 Activation Methods

Figure: Activation method,, Variable controlled that does not follow the start variable.
Or you can choose to have the trend log stop recording when the start variable,
such as a fan, goes off. For example, you can use this feature to log the effective
time a fan is on.

System 04-17005-03-en, October 2015


1218
38 Trend Log Functions
38.3 Activation Methods

Figure: Activation method, Variable controlled that follows the start variable.

38.3.3 Start at activation time


Use start at activation time to have the trend log start recording values at a specified
time.

04-17005-03-en, October 2015 System


1219
38 Trend Log Functions
38.3 Activation Methods

Figure: Activation method, Start at activation time

System 04-17005-03-en, October 2015


1220
38 Trend Log Functions
38.4 Extended Trend Logs

38.4 Extended Trend Logs


You use an extended trend log to store records from a trend log. An extended trend
log can be connected to a trend log or connected in a series to another extended
trend log. Only one extended trend log can be connected to a trend log or another
extended trend log.
You create and configure extended trend logs from WorkStation.

Important
The extended trend log cannot log a variable.
The extended trend log gets the initial value of the connected trend log.
Do not connect more than one extended trend log to a trend log or another
extended trend log. If a trend log is connected to two or more extended trend
logs, critical conflicts can occur.
The extended trend log must have the same unit as the monitored trend log
to correctly display values.

04-17005-03-en, October 2015 System


1221
38 Trend Log Functions
38.4 Extended Trend Logs

Figure: Do not connect more than one extended trend log to a trend log or extended trend
log.
The extended trend log is often saved on an Enterprise Server with more storage
capacity than the SmartStruxure server device where the ordinary trend log is
saved. This extra storage capacity enables the Enterprise Server to store more
records before it overwrites old ones. The extended trend log can be viewed in a
trend log list or a trend chart.
You can configure the extended trend log to transfer data several ways: Smart log,
percentage, time interval, or force transfer.

Table: Extended Trend Log Transfer Criteria


Function Explanation

Smart log Automatically updates the transfer rate with


respect to the frequency of records, network
speed, and the capacity of the
SmartStruxure server that runs the trend log
and the extended trend log.

System 04-17005-03-en, October 2015


1222
38 Trend Log Functions
38.4 Extended Trend Logs

Continued
Function Explanation

Threshold Transfers records every time a specific


percentage threshold of records on the trend
log is reached.

Maximum transfer interval Transfers records at a specific time interval


even though the threshold or Smart log
condition is not reached.

Transfer trigger variable Transfers records when triggered by a


variable that changes state from false to
true, for example, a digital schedule. The
transfer takes place regardless of the
transfer threshold. This function can be used
to ensure that the extended trend log
contains all records, for example, to
generate a complete report at the end of
every month.

Force transfer Executed by the user to manually force a


transfer even though transfer threshold is not
reached.

04-17005-03-en, October 2015 System


1223
38 Trend Log Functions
38.4 Extended Trend Logs

Function Explanation

Figure: Extended trend log that transfers records from a trend log each time the trend log
exceeds a record volume of 20% or every hour.

System 04-17005-03-en, October 2015


1224
38 Trend Log Functions
38.4 Extended Trend Logs

When you edit a record in the extended trend log, the changes do not affect the
connected trend log. If you edit a record in the trend log, the changes are
transferred to the extended trend log next time a transfer occurs. You can edit both
the trend log and the corresponding record in the extended trend log, but the edit is
written twice in the extended trend log record under certain circumstances:
the record in the extended trend log is manually updated
the corresponding edit is transferred from the trend log to the extended trend
log
The trend log list or trend chart displays the last written value of an edited record.
Example 1: You edit a record in a trend log that is connected to an extended trend
log. The extended trend log is updated with the edited record. After the transfer,
you update the corresponding record in the extended trend log. The trend log list
and trend chart connected to the extended trend log display the last value of the
record, which in this case is the extended trend log edit.
Example 2: You edit a record in a trend log that is connected to an extended trend
log. Before the extended trend log is updated with the edited record, you edit the
corresponding record in the extended trend log. After a while the trend log transfers
its edited record to the extended trend log. The trend log list and trend chart
connected to the extended trend log display the edited trend log record value and
not the edited extended trend log record value. In this case, the trend log list and
trend chart display the last value that was written to the extended trend log, not the
last edited value.
You can view all edits, automatically transferred or manually added, in the record
history.

Important
If you import, export, copy, or paste an extended trend log connected to a trend
log, the reference to the connected trend log is lost.

38.4.1 Archive Overview


Archiving is the process of preserving historical data, which is comprised of
selected events and extended trend logs. For example, some facilities are required
to maintain archives to comply with government regulations. Another example is in
secure facilities where they must maintain records of who logged in or who
changed setpoints. Archiving is not a backup function because archive data cannot
be imported back into the system.
For more information, see section 52.1 Archiving Overview on page 1695.

04-17005-03-en, October 2015 System


1225
38 Trend Log Functions
38.5 Creating an Extended Trend Log

38.5 Creating an Extended Trend Log


You create an extended trend log to store log records for a longer period of time
and free up memory in the SmartStruxure server device. Extended trend logs are
also required for generating reports using Building Operation WebReports.
For more information, see section 38.4 Extended Trend Logs on page 1221.

To create an extended trend log


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where you want to create the extended trend log.
2. On the File menu, point to New and then click Trend.
3. In the object type list, select Extended Trend Log.

4. In the Name box, type a name for the extended trend log.
Continued on next page

System 04-17005-03-en, October 2015


1226
38 Trend Log Functions
38.5 Creating an Extended Trend Log

5. In the Description box, type a description for the extended log.

6. Click Next.
7. In the Monitored trend log box, enter the trend log that you want to transfer
records from.

Continued on next page

04-17005-03-en, October 2015 System


1227
38 Trend Log Functions
38.5 Creating an Extended Trend Log

8. In the Smart log box, select if you want to use smart log:
Select True to enable Building Operation software to automatically
optimize the transfer rate of records from the monitored trend log to the
extended trend log.
Select False to manually specify the percentage threshold at which the
trend log transfers its records to the extended trend log, and then select
the percentage in the Threshold box.
9. In the Maximum transfer interval box, select the maximum length of time
that can pass between transfers.
10. In the Log records box, enter the number of records to be stored before old
ones are overwritten.
11. In the Include in reports box, select True to make the extended trend log
available to WebReports.
12. In the Transfer trigger variable box, enter a trigger variable to force a
transfer of all records from the trend log to the extended trend log. For more
information, see section 38.4 Extended Trend Logs on page 1221.

13. Click Create.


The extended trend log is created and transfers and stores records from a trend
log.

System 04-17005-03-en, October 2015


1228
38 Trend Log Functions
38.6 Configuring an Extended Trend Log

38.6 Configuring an Extended Trend Log


You configure the properties of an extended trend log to meet the unique needs of
your site.
For more information, see section 38.4 Extended Trend Logs on page 1221.

To configure an extended trend log


1. In WorkStation, in the System Tree pane, select the extended trend log you
want to configure.
2. On the File menu, click Properties.
3. Edit the basic properties:
Component Description

Monitored trend log Enter the trend log that you want to
transfer records from.

Unit The unit of an extended trend log created


from the trend log wizard at the same
time as the connected trend log, inherts
the unit of measurement from the
connected trend log.
The unit of an extended trend log that is
manually connected to a trend log, needs
to be manually configured to use the
same unit of measurement as the
connected trend log.

Smart log Select True to optimize the transfer of


the monitored trend log to the extended
trend log.

Threshold Select the percentage threshold at which


the trend log transfers its records to the
extended trend log.

Maximum transfer interval Select the maximum length of time that


can pass between transfers from the
monitored trend log to the extended trend
log.

Log records Select the number of records to store


before old records are overwritten.

Include in reports Select True to include the extended


trend log data in reports.

Transfer trigger variable Enter a trigger variable to force a transfer


of all records from the trend log to the
extended trend log, for example, to
generate a complete report. For more
information, see section 38.4 Extended
Trend Logs on page 1221.

04-17005-03-en, October 2015 System


1229
38 Trend Log Functions
38.6 Configuring an Extended Trend Log

4. Click OK.

System 04-17005-03-en, October 2015


1230
38 Trend Log Functions
38.7 Editing the Threshold Property of an Extended Trend Log

38.7 Editing the Threshold Property of an


Extended Trend Log
You edit the threshold property to increase or decrease the percentage threshold of
records in the connected trend log.
For more information, see section 38.4 Extended Trend Logs on page 1221.

To edit the threshold property of an extended trend log


1. In WorkStation, in the System tree pane, select the folder or SmartStruxure
server where the trend log is located.
2. Select the extended trend log you want to configure.
3. On the File menu, click Properties.
4. In the Threshold box, select the new value.

5. Click OK.

04-17005-03-en, October 2015 System


1231
38 Trend Log Functions
38.8 Editing the Maximum Transfer Interval Property of an Extended Trend Log

38.8 Editing the Maximum Transfer Interval


Property of an Extended Trend Log
You edit the maximum transfer interval property to establish the time interval
between two transfers.
For more information, see section 38.4 Extended Trend Logs on page 1221.

To edit the maximum transfer interval property of an extended


trend log
1. In WorkStation, in the System tree pane, select the folder or SmartStruxure
server where the trend log is located.
2. Select the extended trend log you want to configure.
3. On the File menu, click Properties.
4. In the Maximum transfer interval box, select the new value.

5. Click OK.

System 04-17005-03-en, October 2015


1232
38 Trend Log Functions
38.9 Editing the Number of Log Records for a Trend Log

38.9 Editing the Number of Log Records for


a Trend Log
You increase or decrease the number of records to be stored in the trend log before
records are overwritten.
For more information, see section 38.2 Log Record Storage on page 1216.

To edit the number of log records for a trend log


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where the trend log is located.
2. Select the trend log you want to configure.
3. On the File menu, click Properties.
4. In the Log records box, enter the new value.

5. Click OK.

04-17005-03-en, October 2015 System


1233
38 Trend Log Functions
38.10 Editing an Extended Trend Log to be Included in Reports

38.10 Editing an Extended Trend Log to be


Included in Reports
You edit extended trend logs to be included in reports if you want trend log data to
appear in the reports.
For more information, see the How Reports Work topic on WebHelp.

To edit an extended trend log to be included in reports


1. In WorkStation, in the System tree pane, select the folder or SmartStruxure
server where the trend log is located.
2. Select the extended trend log you want to configure.
3. On the File menu, click Properties.
4. In the Include in Reports? box, select True.
The extended trend log is set up to be included in reports.

System 04-17005-03-en, October 2015


1234
38 Trend Log Functions
38.11 Manually Transferring Records to the Extended Trend Log

38.11 Manually Transferring Records to the


Extended Trend Log
You force a transfer of records from a trend log to its connected extended trend log
even though the set transfer threshold is not reached.
For more information, see section 38.4 Extended Trend Logs on page 1221.

To manually transfer records to the extended trend log


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where the extended trend log is located.
2. Select the extended trend log that you want to transfer records to.
3. On the Actions menu, point to Activation, and then click Force transfer.

The monitored trend log is now transferred to the extended trend log.

04-17005-03-en, October 2015 System


1235
38 Trend Log Functions
38.12 Viewing Related Trends

38.12 Viewing Related Trends


You can view the trends related to one or several selected objects or properties.

To view related trends


1. In WorkStation, in the System Tree pane, select the folder containing the
objects whose related trends you want to view.
2. In the List View, select the object or objects for which you want to view
related trends.
3. On the Actions menu, point to View and then click Trends.
4. In the Objects list, select the object whose related trends you want to view.
5. In the Trends list, select the trend you want to view.

6. Click Open.
The selected trend opens the WorkStation work area.

System 04-17005-03-en, October 2015


1236
38 Trend Log Functions
38.13 Viewing Related Trends for Properties Bound to a Graphic

38.13 Viewing Related Trends for Properties


Bound to a Graphic
You can view the trends related to one or several properties bound to, for example,
components in a graphic or elements in a graphic group.

To view related trends for properties bound to a graphic


1. In WorkStation, in the System Tree pane, select the graphic containing the
bound properties whose related trends you want to view.
2. In the Graphic View, right-click the component or element in the graphic
bound to the properties.
3. Point to View and then click Trends.

Continued on next page

04-17005-03-en, October 2015 System


1237
38 Trend Log Functions
38.13 Viewing Related Trends for Properties Bound to a Graphic

4. In the Objects list, select the object whose related trends you want to view.

5. In the Trends list, select the trend you want to view.


6. Click Open.
The selected trend opens in the WorkStation work area.

System 04-17005-03-en, October 2015


1238
39 Trend Charts

Topics
Trend Charts
Configuring a Trend Chart
Showing Trend Chart Grid Lines
Adding a Trend Log Series to a Trend Chart
Adding a Real-Time Trend Series to a Trend Chart
Editing the Trend Chart Settings
Activating Trend Chart Live Update
Trend Chart Axes
Scroll the Trend Chart X-Axis to the Current Time
Configuring the X-Axis with a Relative Time Span
Configuring the X-Axis with an Absolute Time Span
Manually Configuring the Y-Axis Scale
Automatically Configuring the Y-Axis Scale
Assigning a Series to a Y-Axis
Real-Time Plotting
Creating a Real-Time Plot Trend Chart
Creating a Trend Chart that Monitors a Variable in Real-
Time
Trend Chart Series
Creating a Trend Chart that Monitors a Trend Log Series
Attaching a Calculation Method to a Trend Chart Series
Time Zone Modes in a Trend Chart
Configuring the Trend Chart Time Zone
Temporary Trend Charts
Opening a Trend Log in a Temporary Trend Chart
Saving a Temporary Trend Chart
Floating Point Values NaN, INF, and INF
39 Trend Charts
39.1 Trend Charts

39.1 Trend Charts


A trend chart displays the records of a trend log or an extended trend log as a
series.
A trend chart series that presents a trend log is automatically updated with the
latest records, provided that Live update is activated. A trend chart series that
presents records from a field controller trend log needs to be refreshed manually.
There is no upper limitation of how many trend logs a trend chart can present.
However, the performance decreases as the number of displayed trend logs
increase. The records of the trend log can be processed by a calculation method
before they are presented in the trend chart.

04-17005-03-en, October 2015 System


1241
39 Trend Charts
39.1 Trend Charts

Figure: Trend chart, schematic


When a trend chart presents records live from an extended trend log, the latest
records of the connected trend log are frequently transferred to the extended trend
log. This decreases the delay that can occur when the extended trend log has to
wait for the transfer threshold to be reached before new records from the trend log
are transferred. With this method, the trend chart presents the latest records.

System 04-17005-03-en, October 2015


1242
39 Trend Charts
39.1 Trend Charts

Figure: An extended trend log, that presents in an opened live trend chart, frequently
transfers the latest records from the trend log to the extended trend log.

04-17005-03-en, October 2015 System


1243
39 Trend Charts
39.1 Trend Charts

If two extended trend logs are connected between the trend log and the trend
chart, the transfer that occurs when a trend chart presents records live only
transfers the records from the nearest extended trend log. The transfer threshold
rate between the trend log and the first connected trend log remains unaffected.

System 04-17005-03-en, October 2015


1244
39 Trend Charts
39.1 Trend Charts

Figure: Latest trend log record that does not present the same short latency in a live trend
chart when two extended trend logs are connected in a series between the trend log and
trend chart.

04-17005-03-en, October 2015 System


1245
39 Trend Charts
39.1 Trend Charts

When waiting for a new record, the trend chart draws a dotted line from the last
recorded value and forward. When a new value is recorded, the dotted line
between the last and the new record is replaced by a solid series of lines.

Figure: If no value is recorded, the trend chart draws a dotted line.

System 04-17005-03-en, October 2015


1246
39 Trend Charts
39.1 Trend Charts

39.1.1 Trend Chart Series


A series can be presented as a line, discrete line, digital, or bars. Series can be
presented in different colors and with different line weights.
For more information, see section 39.18 Trend Chart Series on page 1275.

39.1.2 Trend Chart Axes in WorkStation


The x-axis of the trend chart represents time. The time span of the axis can be set
with a fixed start and end time or with an end time relative to the present time. The
axis can be quick-scaled to show the last hour, last day, last month, or last year.
For more information, see section 39.8 Trend Chart Axes on page 1261.

39.1.3 Trend Chart Axes in WebStation


The x-axis of the trend chart represents time. The time span of the axis can be set
with a fixed start and end time or with an end time relative to the present time. The
axis can be quick-scaled to show the last hour, last day, last month, or last year.
For more information, see the Trend Chart Axes in WebStation topic on WebHelp.

39.1.4 Real-Time Plotting


The real-time plot is a variable displayed directly in the trend chart. The real-time
plot is an instant reflection of the variable, so the history of the real-time plot is lost
when the trend chart is closed. However, the history is not lost for I/O points that
have implicit logs where approximately 500 records of history are displayed.
For more information, see section 39.15 Real-Time Plotting on page 1269.

39.1.5 Time Zone Modes in a Trend Chart


In a trend chart, you can present the records of a trend log in different time zones:
local time or a predefined time zone.
For more information, see section 39.21 Time Zone Modes in a Trend Chart on
page 1283.

39.1.6 Calculation Methods


Use a calculation method to process the records of the trend log before presenting
them in a trend log list or a trend chart. The original records in the trend log are not
affected by the calculation method. The calculation method is applied to the trend
log records grouped by a specific time interval.
For more information, see section 40.7 Calculation Methods on page 1312.

04-17005-03-en, October 2015 System


1247
39 Trend Charts
39.1 Trend Charts

39.1.7 Temporary Trend Charts


To display a trend log without creating a new trend log list or trend chart, the trend
log can be displayed in a temporary list or chart.
For more information, see section 39.23 Temporary Trend Charts on page 1287.

39.1.8 Floating Point Values NaN, INF, and INF


In Building Operation, the floating point values Not a Number, positive infinity, or
negative infinity may be displayed in the Basic property tab, in a trend log list, or a
trend chart.
For more information, see section 39.26 Floating Point Values NaN, INF, and INF
on page 1290.

System 04-17005-03-en, October 2015


1248
39 Trend Charts
39.2 Configuring a Trend Chart

39.2 Configuring a Trend Chart


You configure the properties of a trend chart to meet the unique needs of your site.
For more information, see section 39.1 Trend Charts on page 1241.

To configure a trend chart


1. In WorkStation, in the System Tree pane, select the trend chart you want to
configure.
2. On the File menu, click Properties.
3. Click the Basic tab.
Continued on next page

04-17005-03-en, October 2015 System


1249
39 Trend Charts
39.2 Configuring a Trend Chart

4. Edit the basic properties:


Property Description

Time mode Select the time mode of the x-axis.

Start time Enter the absolute start time when Time


mode is set to Absolute. This time is the
leftmost point of the x-axis.

Time span Type the relative time span of the x-axis.

Time zone Select the time zone of the trend log list.
The mode is the perspective in which the
trend log is displayed.

Show nearest information for all Select True to show information on every
series series along a diagonal line.

Auto scale left y-axis Select True to activate auto scale and
have the left y-axis adapt itself to the
displayed series.

Left y-axis minimum Enter the minimum value of the left y-axis.

Left y-axis maximum Enter the maximum value of the left y-


axis.

Auto scale right y-axis Select True to activate auto scale and
have the right y-axis adapt itself to the
displayed series.

Right y-axis minimum Enter the minimum value of the right y-


axis.

Right y-axis maximum Enter the maximum value of the right y-


axis.

Show grid lines for X-axis Select True to show grid lines for the x-
axis.

Show grid lines for left Y-axis Select True to show gridlines for the left
y-axis originating from the y-axis scale.

Show grid lines for right Y-axis Select True to show gridlines for the right
y-axis originating from the y-axis scale.

Add
Click to add a series to the trend chart.
For more information, see section 50.27
Create Object Wizard Naming the
Object Page on page 1634.

Edit
Click to edit a selected series. For more
information, see section 41.23 Trend
Chart Series Properties on page 1364.

Remove

Continued on next page

System 04-17005-03-en, October 2015


1250
39 Trend Charts
39.2 Configuring a Trend Chart

Continued
Property Description
Click to remove a selected series.

5. Click the Series tab.


6. Edit the series properties.
7. Click OK.

04-17005-03-en, October 2015 System


1251
39 Trend Charts
39.3 Showing Trend Chart Grid Lines

39.3 Showing Trend Chart Grid Lines


You show the trend chart grid lines on the x-axis and the y-axis to make the chart
easier to read.
For more information, see section 41.20 Trend Chart Settings Dialog Box Axes
Tab on page 1359.

To show trend chart grid lines


1. In WorkStation, in the System Tree pane, select the trend chart you want to
configure.
2. On the Trend Chart toolbar, click the Open trend chart settings button

.
3. Below the Time zone box, select Show grid lines to show grid lines
originating from the x-axis scale.

4. Select Show left grid lines or Show right grid lines to show grid lines
originating from the y-axis scale.
5. Click OK.
Grid lines are now shown in the trend chart. Repeat the procedure to hide the grid
lines.

System 04-17005-03-en, October 2015


1252
39 Trend Charts
39.3 Showing Trend Chart Grid Lines

04-17005-03-en, October 2015 System


1253
39 Trend Charts
39.4 Adding a Trend Log Series to a Trend Chart

39.4 Adding a Trend Log Series to a Trend


Chart
You add a trend log series to a trend chart to compare trend data from different
logs or variables.
For more information, see section 39.18 Trend Chart Series on page 1275.

To add a trend log series to a trend chart


1. In WorkStation, in the System Tree pane, select the trend chart you want to
add a trend log series to.
2. In the System Tree pane, select the trend log you want to add.
3. Drag the trend log from the System Tree pane to the trend chart diagram.

4. Click Save.

System 04-17005-03-en, October 2015


1254
39 Trend Charts
39.5 Adding a Real-Time Trend Series to a Trend Chart

39.5 Adding a Real-Time Trend Series to a


Trend Chart
You add a real-time trend series to a trend chart to compare trend data from
different logs or variables.
For more information, see section 39.18 Trend Chart Series on page 1275.

To add a real-time trend series to a trend chart


1. In WorkStation, in the System Tree pane, select the trend chart you want to
add a trend series to.
2. On the File menu, click Properties.

3. Under Series Configuration Settings, click the Add button .

Continued on next page

04-17005-03-en, October 2015 System


1255
39 Trend Charts
39.5 Adding a Real-Time Trend Series to a Trend Chart

4. In the object type list, select Real Time Trend Series.

5. In the Name box, type a name for the series.


6. In the Description box, type a description for the series.

7. Click Next.
Continued on next page

System 04-17005-03-en, October 2015


1256
39 Trend Charts
39.5 Adding a Real-Time Trend Series to a Trend Chart

8. In the Display variable box, enter the path to the variable you want to
display in the trend chart.

9. In the Weight box, enter the line weight of the series.


10. In the Show markers box, select True to display a marker for each
recorded value.

Continued on next page

04-17005-03-en, October 2015 System


1257
39 Trend Charts
39.5 Adding a Real-Time Trend Series to a Trend Chart

11. Click Create.

12. Click OK.

System 04-17005-03-en, October 2015


1258
39 Trend Charts
39.6 Editing the Trend Chart Settings

39.6 Editing the Trend Chart Settings


You configure the scale of the trend chart axes, the presentation of series, and the
calculation method to make it easier to interpret the series, representing the trend
log records, in the trend chart.
For more information, see section 39.8 Trend Chart Axes on page 1261.

To edit the trend chart settings


1. In WorkStation, in the System Tree pane, select the trend chart.

2. On the Trend Chart toolbar, click Open trend chart settings button .
3. Edit the trend chart settings.

4. Click OK.

04-17005-03-en, October 2015 System


1259
39 Trend Charts
39.7 Activating Trend Chart Live Update

39.7 Activating Trend Chart Live Update


You activate the live update of a trend chart to automatically update the trend chart
with the latest records.
For more information, see section 39.1 Trend Charts on page 1241.

To activate trend chart live update


1. In WorkStation, in the System Tree pane, select the trend chart on which
you want to activate live update.
2. Select Live update.

System 04-17005-03-en, October 2015


1260
39 Trend Charts
39.8 Trend Chart Axes

39.8 Trend Chart Axes


The x-axis of the trend chart represents time. The time span of the axis can be set
with a fixed start and end time or with an end time relative to the present time. The
axis can be quick-scaled to show the last hour, last day, last month, or last year.

Figure: Absolute time span and relative time span, schematic


The y-axis refers to the measurement unit that the variable represents. The scale of
the y-axis can be set manually or by auto scale. You can configure the trend chart
to present series on one y-axis or two y-axes, one to the left and one to the right.
Use two y-axes to present series with different ranges in the same trend chart.

Figure: One y-axis and two y-axes, schematic


To make reading easier, grid lines can be shown in the trend chart. Grid lines can
be shown in both the x- and y-direction, independent of each other.

04-17005-03-en, October 2015 System


1261
39 Trend Charts
39.8 Trend Chart Axes

Figure: Grid lines, schematic

System 04-17005-03-en, October 2015


1262
39 Trend Charts
39.9 Scroll the Trend Chart X-Axis to the Current Time

39.9 Scroll the Trend Chart X-Axis to the


Current Time
You scroll the x-axis rightmost point for fast navigation to the current time. This is
useful when live update is disabled.
For more information, see section 39.8 Trend Chart Axes on page 1261.

To scoll the trend chart x-axis to current time


1. In WorkStation, in the System Tree pane, select the trend chart you want to
show.
2. On the Trend Chart navigation bar, click the Scroll to current client time

button .
The trend chart displays the trend chart with the clients current time as the
rightmost x-axis point.

04-17005-03-en, October 2015 System


1263
39 Trend Charts
39.10 Configuring the X-Axis with a Relative Time Span

39.10 Configuring the X-Axis with a Relative


Time Span
You set the trend chart time span of the x-axis relative to the series current end
point time to automatically adapt the trend chart to display the current time and the
latest records within the specific time span.
For more information, see section 39.8 Trend Chart Axes on page 1261.

To configure the x-axis with a relative time span


1. In WorkStation, in the System Tree pane, select the trend chart you want to
configure.

2. On the Trend Chart toolbar, click Open trend chart settings button .
3. In the Time mode box, select Relative (to current time).

4. In the Time span box, type the length of the x-axis to display before the
current time.
5. Click OK.
The x-axis is now configured with a relative time span.

System 04-17005-03-en, October 2015


1264
39 Trend Charts
39.11 Configuring the X-Axis with an Absolute Time Span

39.11 Configuring the X-Axis with an Absolute


Time Span
You configure the time span of a trend chart x-axis to display the records that are
recorded within a specific period of time.
For more information, see section 39.8 Trend Chart Axes on page 1261.

To configure the x-axis with an absolute time span


1. In WorkStation, in the System Tree pane, select the trend chart you want to
configure.
2. On the Trend Chart toolbar, click the Open trend chart settings button

.
3. In the Time mode box, select Absolute (start and end time).

4. In the Start time boxes, type the x-axis leftmost date and time.
5. In the End time boxes, type the x-axis rightmost date and time.
6. Click OK.
The x-axis is now configured with an absolute time span.

04-17005-03-en, October 2015 System


1265
39 Trend Charts
39.12 Manually Configuring the Y-Axis Scale

39.12 Manually Configuring the Y-Axis Scale


You manually configure the trend chart y-axis to have a fixed scale. The trend chart
has two y-axes, one to the left and one to the right. You can use this procedure to
scale both axes.
For more information, see section 39.8 Trend Chart Axes on page 1261.

To manually configure the y-axis scale


1. In WorkStation, in the System Tree pane, select the trend chart you want to
configure.
2. On the Trend Chart toolbar, click the Open trend chart settings button

.
3. Clear Auto scale left y-axis and Auto scale right y-axis.

4. In the Left y-axis minimum and Right y-axis minimum boxes, type the
minimum value of the y-axis.
5. In the Left y-axis maximum and Right y-axis maximum boxes, type the
maximum value of the y-axis.
6. Click OK.
The y-axis is now set with a fixed scale.

System 04-17005-03-en, October 2015


1266
39 Trend Charts
39.13 Automatically Configuring the Y-Axis Scale

39.13 Automatically Configuring the Y-Axis


Scale
You configure the trend chart to automatically scale the y-axis. The trend chart has
two y-axes, one to the left and one to the right. You can use this procedure to scale
both axes.
For more information, see section 39.8 Trend Chart Axes on page 1261.

To automatically configure the y-axis scale


1. In WorkStation, in the System Tree pane, select the trend chart you want to
configure.
2. On the Trend Chart toolbar, click the Open trend chart settings button

.
3. Select Auto Scale left y-axis and Auto Scale right y-axis.

4. Click OK.
The y-axis scale is now set automatically and updated with the presented series.

04-17005-03-en, October 2015 System


1267
39 Trend Charts
39.14 Assigning a Series to a Y-Axis

39.14 Assigning a Series to a Y-Axis


You assign a trend chart series to a y-axis to make the chart easier to read. When
using two axes, you can set different y-axis scales for the series.
For more information, see section 39.8 Trend Chart Axes on page 1261.

To assign a series to a y-axis


1. In WorkStation, in the System Tree pane, select the trend chart you want to
configure.
2. On the Trend Chart toolbar, click the Open trend chart settings button

.
3. Click the Series tab.

4. In the Data series box, select the series you want to assign to either the left
or the right axis.
5. In the Assigned to y-axis box, select an axis.
6. Click OK.
The series is now assigned to the left or right y-axis.

System 04-17005-03-en, October 2015


1268
39 Trend Charts
39.15 Real-Time Plotting

39.15 Real-Time Plotting


The real-time plot is a variable displayed directly in the trend chart. The real-time
plot is an instant reflection of the variable, so the history of the real-time plot is lost
when the trend chart is closed. However, the history is not lost for I/O points that
have implicit logs where approximately 500 records of history are displayed.

Figure: Real-time plot, schematic


A real-time plot trend chart updates and draws a solid series each time it registers
that the variable has a new value. If the variable remains on the same value, the
series is drawn as a dotted line.
When you save a real-time plot trend chart, a trend chart object is created that you
can reach from the System Tree pane.

Note
A real-time plot can only be displayed in a trend chart and not in a trend log
list.

04-17005-03-en, October 2015 System


1269
39 Trend Charts
39.16 Creating a Real-Time Plot Trend Chart

39.16 Creating a Real-Time Plot Trend Chart


You create a real-time plot trend chart to display a variable in real time.
For more information, see section 39.15 Real-Time Plotting on page 1269.

To create a real-time plot trend chart


1. In WorkStation, in the System Tree pane, select the variable you want to
display in a real-time plot trend chart.
2. On the Actions menu, point to View, and then click New Trend chart.

3. Click the Save button .


4. Browse to where you want to save the real-time plot trend chart.
5. Click Save.
By saving the real-time plot trend chart, a trend chart object is created in the
System Tree pane.

System 04-17005-03-en, October 2015


1270
39 Trend Charts
39.17 Creating a Trend Chart that Monitors a Variable in Real-Time

39.17 Creating a Trend Chart that Monitors a


Variable in Real-Time
You create a trend chart that monitories a variable in real-time, for example, to
access and check the current status of the variable.
For more information, see section 39.15 Real-Time Plotting on page 1269.

To create a trend chart that monitors a variable in real-time


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where you want to create the trend chart.
2. On the File menu, point to New and then click Trend.
3. Select Trend Chart.

4. In the Name box, type a name for the trend chart.


5. In the Description box, type a description.
6. Click Next.
Continued on next page

04-17005-03-en, October 2015 System


1271
39 Trend Charts
39.17 Creating a Trend Chart that Monitors a Variable in Real-Time

7. In the Time mode box, select Absolute to manually specify the x-axis start
and end point.

8. In the Start time box, type the absolute start time (the leftmost point of the x
axis).
9. In the End time box, type the absolute end time (the rightmost point of the x
axis).
10. In the Auto scale left y-axis box, select True so the y-axis adapts itself to
displayed series.

11. Click the Add button.


Continued on next page

System 04-17005-03-en, October 2015


1272
39 Trend Charts
39.17 Creating a Trend Chart that Monitors a Variable in Real-Time

12. Select Real Time Trend Series.

13. In the Name box, type a name for the series.


14. In the Description box, type a description.
15. Click Next.
16. In the Display variable box, enter the variable you want to display in the
trend chart.

17. In the Weight box, select the weight of the series.


Continued on next page

04-17005-03-en, October 2015 System


1273
39 Trend Charts
39.17 Creating a Trend Chart that Monitors a Variable in Real-Time

18. In the Show markers box, select True to display a marker for each
recorded.
19. Click Create.
20. In the Configure real-time trend series dialog box, click Create.
The real-time trend series trend chart is created in the selected folder.

System 04-17005-03-en, October 2015


1274
39 Trend Charts
39.18 Trend Chart Series

39.18 Trend Chart Series


A series can be presented as a line, discrete line, digital, or bars. Series can be
presented in different colors and with different line weights.

Figure: Types of series presentation, schematic


To make reading easier, records can be presented with markers. Markers can only
be shown for lines and discrete lines, not for digital or bars.

04-17005-03-en, October 2015 System


1275
39 Trend Charts
39.18 Trend Chart Series

Figure: Presentation with markers, schematic

System 04-17005-03-en, October 2015


1276
39 Trend Charts
39.19 Creating a Trend Chart that Monitors a Trend Log Series

39.19 Creating a Trend Chart that Monitors a


Trend Log Series
You create a trend chart that monitors trend log series. When creating a trend chart
from the trend log wizards last step, connect objects to the trend log step. The
procedure starts when naming the trend chart.
For more information, see section 39.1 Trend Charts on page 1241.

To Create a trend chart that monitors a trend log series


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where you want to create the trend chart.
2. On the File menu, point to New and then click Trend.
3. In the object type list, select Trend Chart.

4. In the Name box, type a name for the trend chart.


5. In the Description box, type a description for the trend chart.
6. Click Next.
Continued on next page

04-17005-03-en, October 2015 System


1277
39 Trend Charts
39.19 Creating a Trend Chart that Monitors a Trend Log Series

7. In the Time mode box, select Absolute to manually specify the x-axis start
and end point.

8. In the Start time box, type the absolute start time of the x-axis.
9. In the Time span box, type the relative time span of the x-axis in seconds.
10. In the Auto scale left y-axis box, select True so the y-axis adapts itself to
the displayed series.
11. Click Add.
Continued on next page

System 04-17005-03-en, October 2015


1278
39 Trend Charts
39.19 Creating a Trend Chart that Monitors a Trend Log Series

12. In the object type list, select Trend Log Series.

13. In the Name box, type a name for the series.


14. In the Description box, type a description for the series.
15. Click Next.
16. In the Display trend log box, enter the trend log you want to display in the
trend chart.

17. In the Weight box, select the weight of the series.


Continued on next page

04-17005-03-en, October 2015 System


1279
39 Trend Charts
39.19 Creating a Trend Chart that Monitors a Trend Log Series

18. In the Show markers box, select True to display a marker for each
recorded value.
19. In the Show events box, select True to display event symbols.
20. Click Create.
21. In the Configure Trend Chart dialog box, click Create.
The trend log series trend chart is created in the selected folder.

System 04-17005-03-en, October 2015


1280
39 Trend Charts
39.20 Attaching a Calculation Method to a Trend Chart Series

39.20 Attaching a Calculation Method to a


Trend Chart Series
You attach a calculation method to a trend chart series to process the recorded
values and present the result.
For more information, see section 40.7 Calculation Methods on page 1312.

To attach a calculation method to a trend chart series


1. In WorkStation, in the System Tree pane, select the trend chart you want to
attach a calculation method to.

2. On the Trend Chart toolbar, click Open trend chart settings button .
3. Click the Calculations tab.
4. In the Data series box, select the series you want to add a calculation
method to.

5. In the Calculation method box, select a calculation method.


6. Select Delta over period if the calculation method is a delta calculation with
periods.
Continued on next page

04-17005-03-en, October 2015 System


1281
39 Trend Charts
39.20 Attaching a Calculation Method to a Trend Chart Series

7. In the Period box, select the time span for which the calculation method is to
be executed.

Note
If Custom is selected in the Period box, enter a custom time
span for which the calculation method is to be executed in the
Custom period box and the time when you want the custom
period to start in the Custom period alignment boxes.
To calculate the required number of records for a trend log,
multiply the number of records in one day with the number of
days you want the trend log to record. For example, the interval
of the trend log is set to 1 hour, then this gives 24 recorded
values per day. The trend log should record at least one month
of recorded values equal to 31 days. For example, the number of
records = 24 x 31 = 744.

8. In the Custom period box, enter a custom time span for which the
calculation method is to be executed.
9. In the Custom period alignment boxes, enter the time when you want the
custom period to start.
10. Click OK.
A calculation method is now attached to the series.

System 04-17005-03-en, October 2015


1282
39 Trend Charts
39.21 Time Zone Modes in a Trend Chart

39.21 Time Zone Modes in a Trend Chart


In a trend chart, you can present the records of a trend log in different time zones:
local time or a predefined time zone.
A time zone is a region on the earth that has a uniform standard time, usually
referred to as the local time. Local time is the UTC time plus the current time zone
offset for the considered location. Some time zones also have an offset called DST
added during the summer period. The DST offset is typically +1 hour.
Before you set the time zone for a trend chart, you should consider these settings:
Computer clock settings
Regional settings
A computer clock displays time that has been set manually or by synchronizing to a
time server. The computer clock time shows local time. Regional time displays the
time of the selected location. Asynchronous computer clock time and regional time
are not uncommon and can cause, for example, unexpected time discrepancies
between time stamps on received values and the computer clock time.
To adjust the SmartStruxure server device time, time zone, and DST, you have to
access the SmartStruxure server device through a WorkStation.

39.21.1 Local Time


A trend chart presented in Local time displays trend logs with time stamps adjusted
for the client computer time zone.
The client computer does not consider the local time of the SmartStruxure server
where the variable is logged. The same variable logged on SmartStruxure servers in
different time zones is displayed with matching time stamps for corresponding
values.

04-17005-03-en, October 2015 System


1283
39 Trend Charts
39.21 Time Zone Modes in a Trend Chart

Figure: Local time zone, schematic

39.21.2 Predefined Time Zone


A trend chart presented in a predefined time zone displays trend logs in the time of
the selected time zone regardless of where the SmartStruxure server is located.
The same variable logged on SmartStruxure servers in different time zones are
displayed with adjusted time stamps for corresponding values. Use predefined time
zone when you need to compare trend logs on SmartStruxure servers located in
different time zones.

System 04-17005-03-en, October 2015


1284
39 Trend Charts
39.21 Time Zone Modes in a Trend Chart

Figure: Predefined time zone, schematic

04-17005-03-en, October 2015 System


1285
39 Trend Charts
39.22 Configuring the Trend Chart Time Zone

39.22 Configuring the Trend Chart Time Zone


You display the time of the records in local time, server time, or in the time of a
predefined time zone. By changing the time zone settings you make it easier to
interpret the time stamp.
For more information, see section 39.21 Time Zone Modes in a Trend Chart on
page 1283.

To configure the trend chart time zone mode


1. In WorkStation, in the System Tree pane, select the trend chart you want to
configure.
2. On the Trend Chart toolbar, click the Open trend chart settings button

.
3. In the Time zone box, select a time zone to display the trend chart time
stamps in:
Select Local time to display the time stamps in real time from the
perspective of the client.
Select a predfined time zone to display the time stamps in real time from
the perspective of the selected time zone.

4. Click OK.
The x-axis is now set according to the selected time zone.

System 04-17005-03-en, October 2015


1286
39 Trend Charts
39.23 Temporary Trend Charts

39.23 Temporary Trend Charts


To display a trend log without creating a new trend log list or trend chart, the trend
log can be displayed in a temporary list or chart.

Figure: Trend log displayed in a temporary trend log list and temporary trend chart

Note
You have to manually refresh the trend log list.

04-17005-03-en, October 2015 System


1287
39 Trend Charts
39.24 Opening a Trend Log in a Temporary Trend Chart

39.24 Opening a Trend Log in a Temporary


Trend Chart
You open a trend log as a temporary trend chart to view the recorded values
graphically. When you close the temporary trend chart, the chart is not saved.
For more information, see section 39.23 Temporary Trend Charts on page 1287.

To open a trend log in a temporary trend chart


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where the trend log is located.
2. Select the trend log you want to open as a temporary trend chart.
3. On the Actions menu, point to the View submenu and then click In Trend
Chart.
The temporary trend chart is displayed in the work area under a generic name.

System 04-17005-03-en, October 2015


1288
39 Trend Charts
39.25 Saving a Temporary Trend Chart

39.25 Saving a Temporary Trend Chart


You save temporary trend charts and trend log lists to make them available for
future use.

To save a temporary trend chart


1. In WorkStation, in the temporary trend chart you want to save, click the

Save button to create a trend chart.


2. Browse to the location where you want to save the trend chart.
3. In the Name box, type a name for the trend chart.
4. Click Save.

04-17005-03-en, October 2015 System


1289
39 Trend Charts
39.26 Floating Point Values NaN, INF, and INF

39.26 Floating Point Values NaN, INF, and


INF
In Building Operation, the floating point values Not a Number, positive infinity, or
negative infinity may be displayed in the Basic property tab, in a trend log list, or a
trend chart.
The IEEE standard for Floating-point Arithmetic representation is used for these
values:
NaN: A floating point value meaning Not a Number. Support for NaN is provided
for interoperability with other devices or systems that produce NaN values.
Positive Infinity or Negative Infinity: Floating point value, sometimes represented as
Infinity, Infinity, INF, or INF. Support for positive and negative infinity is provided
for interoperability with other devices or systems that produce these values.
Institute of Electrical and Electronics Engineers document IEEE 754.

39.26.1 Basic Property Tab and Watch Window


Certain object properties may display values representing Not a Number, positive
infinity, or negative infinity. These values are displayed in accordance with the
localization settings, observing capitalization and sign (positive or negative). The
presentations of these values with English localization are shown in the table and
examples below.

Table: Display of Values


Value Property Tab Watch Window
Presentation Presentation

Not a Number NaN NaN

Positive Infinity Infinity Infinity

Negative Infinity Infinity Infinity

In the Basic Property Tab


You can view property values representing Not a Number, positive infinity, or
negative infinity in the Basic property tab.

Figure: Example of NaN, Infinity, or Infinity Value Displayed in Basic Property Tab

System 04-17005-03-en, October 2015


1290
39 Trend Charts
39.26 Floating Point Values NaN, INF, and INF

In the Watch Window


You can monitor property values representing Not a Number, positive infinity, or
negative infinity in the Watch Window.

Figure: Example of NaN, Infinity, or Infinity Value Displayed in Watch Window

39.26.2 Trends
Property values representing Not a Number, positive infinity, or negative infinity
can be trended and displayed in the trend log and trend chart. The presentations of
these values with English localization are shown in the table and examples below.

Table: Presentation of Values


Value Trend Log Presentation Trend Chart
Presentation

Not a Number NaN NaN

Positive Infinity Infinity INF

Negative Infinity Infinity INF

In the Trend Log List


You can view the trend data in a trend log list. For more information, see section
40.1 Trend Log Lists on page 1299.

04-17005-03-en, October 2015 System


1291
39 Trend Charts
39.26 Floating Point Values NaN, INF, and INF

Figure: NaN, Infinity, and Infinity Displayed in Trend Log List

In Trend Charts
You can view the trend data in a trend chart. For more information, see section 39.1
Trend Charts on page 1241.
When you select the Line option for a trend chart, the values are plotted on a line
and displayed as abbreviations. You can view the complete value by hovering the
pointer over any of these values. In the example that follows, the trend chart
settings are set to Show markers so that it is easier to read the chart.

System 04-17005-03-en, October 2015


1292
39 Trend Charts
39.26 Floating Point Values NaN, INF, and INF

Figure: NaN, Infinity, and Infinity Displayed in Trend Chart

Component Displayed Value Tool Tip

INF

INF

NaN

The same series can be presented in different ways by selecting the Discrete
Line, Digital, or Bars option, as shown in the following examples. For more
information, see section 39.18 Trend Chart Series on page 1275.

04-17005-03-en, October 2015 System


1293
39 Trend Charts
39.26 Floating Point Values NaN, INF, and INF

Figure: Trend Chart with Discrete Line Display Option Selected

System 04-17005-03-en, October 2015


1294
39 Trend Charts
39.26 Floating Point Values NaN, INF, and INF

Figure: Trend Chart with Digital Display Option Selected

04-17005-03-en, October 2015 System


1295
39 Trend Charts
39.26 Floating Point Values NaN, INF, and INF

Figure: Trend Chart with Bars Display Option Selected

System 04-17005-03-en, October 2015


1296
40 Trend Log Lists

Topics
Trend Log Lists
Creating a Trend Log List
Configuring a Trend Log List
Time Zone Modes in a Trend Log List
Displaying the Trend Log List Time Stamps with Fractions
Configuring the Trend Log List Time Zone
Calculation Methods
Attaching a Calculation Method to a Trend Log List
Temporary Trend Log Lists
Opening a Trend Log in a Temporary Trend Log List
Saving a Temporary Trend Log List
40 Trend Log Lists
40.1 Trend Log Lists

40.1 Trend Log Lists


The trend log list numerically displays the records of a trend log or an extended
trend log. The records of the trend log can be processed by a calculation method
before they are presented in the trend log list.
The trend log list can only display one trend log at a time and must be manually
refreshed to display recently recorded values.

04-17005-03-en, October 2015 System


1299
40 Trend Log Lists
40.1 Trend Log Lists

Figure: Trend log list, schematic

System 04-17005-03-en, October 2015


1300
40 Trend Log Lists
40.1 Trend Log Lists

40.1.1 Time Zone Modes in a Trend Log List


In a trend log list, you can present the records of a trend log in different time zones:
local time zone, SmartStruxure server time zone, and UTC time zone.
For more information, see section 40.4 Time Zone Modes in a Trend Log List on
page 1306.

40.1.2 Calculation Methods


Use a calculation method to process the records of the trend log before presenting
them in a trend log list or a trend chart. The original records in the trend log are not
affected by the calculation method. The calculation method is applied to the trend
log records grouped by a specific time interval.
For more information, see section 40.7 Calculation Methods on page 1312.

40.1.3 Temporary Trend Log Lists


To display a trend log without creating a new trend log list or trend chart, the trend
log can be displayed in a temporary list or chart.
For more information, see section 40.9 Temporary Trend Log Lists on page 1319.

40.1.4 Floating Point Values NaN, INF, and -INF


In Building Operation, the floating point values Not a Number, positive infinity, or
negative infinity may be displayed in the Basic property tab, in a trend log list, or a
trend chart.
For more information, see section 39.26 Floating Point Values NaN, INF, and INF
on page 1290.

04-17005-03-en, October 2015 System


1301
40 Trend Log Lists
40.2 Creating a Trend Log List

40.2 Creating a Trend Log List


You create a trend log list to display records from a trend log.

Tip
If you are creating a trend log list from a trend log wizard, the procedure starts
when you name the trend log list.

For more information, see section 40.1 Trend Log Lists on page 1299.

To create a trend log list


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where you want to create the trend log list.
2. On the File menu, point to New and then click Trend.
3. In the object list, select Trend Log List.

4. In the Name box, type a name for the trend log list.
Continued on next page

System 04-17005-03-en, October 2015


1302
40 Trend Log Lists
40.2 Creating a Trend Log List

5. In the Description box, type a description for the trend log list.

6. Click Next.
7. In the Display trend log box, enter the trend log you want to display in the
trend log list.

Continued on next page

04-17005-03-en, October 2015 System


1303
40 Trend Log Lists
40.2 Creating a Trend Log List

8. In the Log space (records) box, enter the maximum number of rows to
display in the trend log.

9. Click Create.

System 04-17005-03-en, October 2015


1304
40 Trend Log Lists
40.3 Configuring a Trend Log List

40.3 Configuring a Trend Log List


You configure the properties of a trend log list to meet the unique needs of your
site.
For more information, see section 40.1 Trend Log Lists on page 1299.

To configure a trend log list


1. In WorkStation, in the System Tree pane, select the trend log list you want to
configure.
2. On the File menu, click Properties.
3. Edit the properties:
Component Description

Display trend log Enter the trend log to display in the trend
log list.

Log space (records) Select the maximum number of records


to display in the trend log list.

Show events Select True to display events in the trend


log list. This function does not hide events
in the list that contain a value or
comment. For example, when a record is
added, edited, or commented.

Time zone Select which time perspective to display


in the trend log. For more information, see
section 40.4 Time Zone Modes in a
Trend Log List on page 1306.

Calculation method Select a calculation method.

Delta over period Select True to apply a period to the delta


calculation method.

Period Select the time span for which the


calculation method is to be executed.

Custom period Enter a custom time span for which the


calculation method is to be executed.

Custom period alignment Enter the time when you want the custom
period to start.

4. Click OK.

04-17005-03-en, October 2015 System


1305
40 Trend Log Lists
40.4 Time Zone Modes in a Trend Log List

40.4 Time Zone Modes in a Trend Log List


In a trend log list, you can present the records of a trend log in different time zones:
local time zone, SmartStruxure server time zone, and UTC time zone.

40.4.1 Local Time Zone


Use local time zone to display the trend logs in real time from the perspective of the
client.
For example, a trend log in Moscow is monitored on a client in Tbilisi. The trend log
is recording at 8:00-13:00 local server time. 13:00 Moscow time is 14:00 Tbilisi
time, so the Tiblisi trend log displays 9:00-14:00 in the client trend log list.

Figure: Trend log list displayed on a client with local time zone.

40.4.2 Server Time Zone


Use server time zone to display in real time from the perspective of the
SmartStruxure server.
For example, a trend log in Moscow is monitored on a client in Tbilisi. The trend log
is recording at 8:00-13:00 local server time and this is how it is displayed in the
client trend log list.

System 04-17005-03-en, October 2015


1306
40 Trend Log Lists
40.4 Time Zone Modes in a Trend Log List

Figure: Trend log list displayed on a client with server time zone.

40.4.3 UTC Time Zone


Use UTC time zone to display the trend logs in the perspective of UTC.
For example, a trend log in Moscow is monitored on a client in Tbilisi. The trend log
is recording at 8:00-13:00 local server time. 8:00 Moscow time is 5:00 UTC time,
so the Tiblisi displays 5:00-10:00 in the trend log list.

04-17005-03-en, October 2015 System


1307
40 Trend Log Lists
40.4 Time Zone Modes in a Trend Log List

Figure: Trend log list displayed on a client with UTC time zone.

System 04-17005-03-en, October 2015


1308
40 Trend Log Lists
40.5 Displaying the Trend Log List Time Stamps with Fractions

40.5 Displaying the Trend Log List Time


Stamps with Fractions
You display the trend log list time stamps with fractions, to show the exact time
stamp when the value was recorded.
For more information, see section 40.1 Trend Log Lists on page 1299.

To display time stamps with fractions


1. In WorkStation, in the System Tree pane, select the trend log list you want to
display its time stamps in fractions.
2. On the Trend Log List toolbar, click the Show time stamps with fractions

button .
The time stamps in the trend log list are now shown with hundredths. Repeat the
procedure to hide the fractions.

04-17005-03-en, October 2015 System


1309
40 Trend Log Lists
40.6 Configuring the Trend Log List Time Zone

40.6 Configuring the Trend Log List Time


Zone
You change the time zone to display time stamps in the trend log in UTC or in the
perspective of the client or SmartStruxure server. By changing the time zone
settings you make it easier to interpret the time stamp.
For more information, see section 40.4 Time Zone Modes in a Trend Log List on
page 1306.

To configure the trend log list time zone


1. In WorkStation, in the System Tree pane, select the trend log list you want to
configure.
2. On the Trend log list toolbar, click the Open trend log list settings button

.
Continued on next page

System 04-17005-03-en, October 2015


1310
40 Trend Log Lists
40.6 Configuring the Trend Log List Time Zone

3. In the Time zone box, select a time zone to display the trend log list time
stamps in:
Select Local to display the time stamps in real time from the perspective
of the client.
Select Server to display the time stamps in real time from the
perspective of the SmartStruxure server.
Select UTC to display the time stamps in the real time in the perspective
of UTC.

4. Click OK.
The records in the trend log are now displayed in the selected time zone mode.

04-17005-03-en, October 2015 System


1311
40 Trend Log Lists
40.7 Calculation Methods

40.7 Calculation Methods


Use a calculation method to process the records of the trend log before presenting
them in a trend log list or a trend chart. The original records in the trend log are not
affected by the calculation method. The calculation method is applied to the trend
log records grouped by a specific time interval.
The following calculation methods are available:
Maximum
Minimum
Average
Sum
Delta
Delta over period
Meter consumption

Note
Adapt the period so it contains the required amount of records to generate a
correct calculation.
If a calculation method is connected to an interval trend log with delta, make
sure that the period and delta are adapted for the calculation.

40.7.1 Maximum
The maximum value of each period is presented.

Figure: Maximum calculation method, schematic

System 04-17005-03-en, October 2015


1312
40 Trend Log Lists
40.7 Calculation Methods

Important
If the log point is offline or no value is produced during the interval, no value is
displayed.

40.7.2 Minimum
The minimum value of each period is presented.

Figure: Minimum calculation method, schematic

Important
If the log point is offline or no value is produced during the interval, no value is
displayed.

40.7.3 Average
The average of the values in each period is calculated and presented.

04-17005-03-en, October 2015 System


1313
40 Trend Log Lists
40.7 Calculation Methods

Figure: Average calculation method, schematic

Important
If the log point is offline or no value is produced during the interval, no value is
displayed.

40.7.4 Sum
The sum of the values in each period is calculated and presented.

System 04-17005-03-en, October 2015


1314
40 Trend Log Lists
40.7 Calculation Methods

Figure: Sum calculation method, schematic

40.7.5 Delta
The change to the previous value is calculated and presented.

Figure: Delta calculation method, schematic

04-17005-03-en, October 2015 System


1315
40 Trend Log Lists
40.7 Calculation Methods

40.7.6 Delta over Period


The change over a period is calculated and presented. The value at the period limit
is often interpolated, based upon the last value in the old period and the first value in
the new period.

Figure: Delta over period calculation method, schematic

40.7.7 Meter Consumption


Meter consumption is a delta over period calculation with meter functionality. For
more information, see section 37.8 Meter Trend Logs on page 1160.

System 04-17005-03-en, October 2015


1316
40 Trend Log Lists
40.8 Attaching a Calculation Method to a Trend Log List

40.8 Attaching a Calculation Method to a


Trend Log List
You attach a calculation method to a trend log list to process the recorded values
and present the result.
For more information, see section 40.7 Calculation Methods on page 1312.

To attach a calculation method to a trend log list


1. In WorkStation, in the System Tree pane, select the trend log list you want to
attach a calculation method to.
2. On the Trend Log List toolbar, click the Open trend log list settings

button .
3. In the Calculation method box, select a calculation.

4. In the Delta over period box, select True if the calculation method is a delta
calculation with periods.
Continued on next page

04-17005-03-en, October 2015 System


1317
40 Trend Log Lists
40.8 Attaching a Calculation Method to a Trend Log List

5. In the Period box, select the time span for which the calculation method is to
be executed.

Note
If Custom is selected in the Period box, enter a custom time
span for which the calculation method is to be executed in the
Custom period box and the time when you want the custom
period to start in the Custom period alignment boxes.
To calculate the required number of records for a trend log,
multiply the number of records in one day with the number of
days you want the trend log to record. For example, the interval
of the trend log is set to 1 hour, then this gives 24 recorded
values per day. The trend log should record at least one month
of recorded values equal to 31 days. For example, the number of
records = 24 x 31 = 744.

6. In the Custom period box, enter a custom time span for which the
calculation method is to be executed.
7. In the Custom period alignment boxes, enter the time when you want the
custom period to start.
8. Click OK.
A calculation method is now attached to the trend log list.

System 04-17005-03-en, October 2015


1318
40 Trend Log Lists
40.9 Temporary Trend Log Lists

40.9 Temporary Trend Log Lists


To display a trend log without creating a new trend log list or trend chart, the trend
log can be displayed in a temporary list or chart.

Figure: Trend log displayed in a temporary trend log list and temporary trend chart

Note
You have to manually refresh the trend log list.

04-17005-03-en, October 2015 System


1319
40 Trend Log Lists
40.10 Opening a Trend Log in a Temporary Trend Log List

40.10 Opening a Trend Log in a Temporary


Trend Log List
You open a trend log in a temporary trend log list to view the recorded values in a
list. When you close the temporary trend log list, the list is not saved.
For more information, see section 40.9 Temporary Trend Log Lists on page 1319.

To open a trend log in a temporary trend log list


1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where the trend log is located.
2. Select the trend log you want to open as a temporary trend log list.
3. On the Actions menu, point to View and then click In Trend Log List.

(In FM: TaskClosing) The trend log list is displayed in the work area under a generic
name.

System 04-17005-03-en, October 2015


1320
40 Trend Log Lists
40.11 Saving a Temporary Trend Log List

40.11 Saving a Temporary Trend Log List


You save temporary trend charts and trend log lists to make them available for
future use.

To save a temporary trend log list


1. In WorkStation, in the temporary trend chart you want to save, click the

Save button to create a trend chart.


2. Browse to the location where you want to save the trend chart.
3. In the Name box, type a name for the trend chart.
4. Click Save.

04-17005-03-en, October 2015 System


1321
41 Trends User interface

Topics
Trend Log System Tree Icons
Actions Menu Activation Submenu
Actions Menu View Submenu
Actions Menu Modification Submenu
Interval Trend Log Properties
Meter Trend Log Properties
Change of Value Trend Log Properties
Variable Triggered Trend Log Properties
Manual Trend Log Properties
Extended Trend Log Properties
Trend Chart Properties
Trend Log List Properties
Manage Replacement of Meter Dialog Box
Meter Change History Dialog Box
Trend Chart View
Trend Chart Toolbar
Trend Chart Event Icons
Trend Chart Navigation Bar
Series Tab Shortcut Menu
Trend Chart Settings Dialog Box Axes Tab
Trend Chart Settings Dialog Box Series Tab
Trend Chart Settings Dialog Box Calculation Tab
Trend Chart Series Properties
Real Time Trend Series Properties
Trend Log List View
Add/Remove Columns Dialog Box (Trends)
Trend Log List Toolbar
Trend Log List Event Icons
Trend Log List Log Info View
Trend Log List Shortcut Menu
Add Trend Log Record Dialog Box
Edit/Comment Trend Log Record Dialog Box
Create Trend Log Wizard Configure Interval Trend Log
Page
Create Trend Log Wizard Configure Meter Trend Log Page
Create Trend Log Wizard Configure Change of Value
Trend Log Page
Create Trend Log Wizard Configure Variable Triggered
Trend Log
Create Trend Log Wizard Configure Manual Log Page
Create Trend Log Wizard Configure Extended Trend Log Page
Create Trend Log Wizard Configure Trend Chart Page
Create Trend Log Wizard Configure Real-Time Trend Series
Page
Create Trend Log Wizard Configure Trend Log Series Page
Create Trend Log Wizard Configure Trend Log List Page
Create Trend Log Wizard Connect Objects to the Trend Log
Page
Trend Log Wizard Initial Meter Settings Page
41 Trends User interface
41.1 Trend Log System Tree Icons

41.1 Trend Log System Tree Icons


This section describes the icons in WorkStation that relate to trend logs.

Table: Trend Log Icons in WorkStation


Icon Description

Trend log
Indicates the object is a trend log. For more
information, see the Trend Logs topic on
WebHelp.

Trend chart
Indicates the object is a trend chart. For
more information, see section 39.1 Trend
Charts on page 1241.

Trend log list


Indicates the object is a trend log list. For
more information, see section 40.1 Trend
Log Lists on page 1299.

04-17005-03-en, October 2015 System


1325
41 Trends User interface
41.2 Actions Menu Activation Submenu

41.2 Actions Menu Activation Submenu


Use the Activation submenu to enable, disable, or clear a trend log.

Figure: The trend log Actions menu, Activation submenu

Table: Activation Submenu


Command Description

Enable trend log Click to enable the trend log. The trend log
starts when the start condition is fulfilled.

Disable trend log Click to disable the trend log and stop all
recording activity.

Clear trend log Click to clear all the records from the trend
log.

Force transfer Click to manually forces the transfer of


records to the extended trend log.

System 04-17005-03-en, October 2015


1326
41 Trends User interface
41.3 Actions Menu View Submenu

41.3 Actions Menu View Submenu


Use the View submenu to display object related events, temporary trend charts, or
trend log lists.

Figure: Acations menu - View submenu

Table: Actions Menu View Submenu


Command Description

Contingency log chart Click to display a Contingency Log chart for


a Sigma object. For more information, see
the Viewing a Contingency Log Chart or List
topic on WebHelp.

Contingency log list Click to display a Contingency Log list for a


Sigma object. For more information, see the
Viewing a Contingency Log Chart or List
topic on WebHelp.

Events Click to open an Events pane that displays


the events related to a specific object. For
more information, see section 35.3 Object-
Specific Event View on page 1111.

Events in this branch Click to open an Events pane that displays


all events for the selected branch, for
example, a folder. For more information, see
section 34.1 How Events Work on page
1085.

Trends Click to view related trend objects. For more


information, see section 50.60 Objects and
Trends Dialog Box on page 1671.

In Trend Chart Click to open a trend log as a temporary


trend chart. For more information, see
section 39.23 Temporary Trend Charts on
page 1287.

In Trend Log List Click to open a trend log as a temporary


trend log list. For more information, see
section 40.9 Temporary Trend Log Lists on
page 1319.

Report Click to open a report.

Text Report Click to enable the selection of a Sigma text


report relating to the object selected. For
more information, see the Text Report View
topic on WebHelp.

04-17005-03-en, October 2015 System


1327
41 Trends User interface
41.3 Actions Menu View Submenu

Continued
Command Description

In Watch pane Use the In Watch pane submenu to select


the property of the variable you want to
monitor. For more information, see section
50.11 Actions Menu - View Submenu - In
Watch pane Submenu on page 1614.

System 04-17005-03-en, October 2015


1328
41 Trends User interface
41.4 Actions Menu Modification Submenu

41.4 Actions Menu Modification Submenu


Use the Modification submenu to add a value to a manual trend log.

Figure: The trend log Actions menu, Modification submenu

Table: Modification Submenu


Command Description

Add log record Click to open the Add log record dialog
box where you add values and comments to
a manual trend log. For more information,
see section 37.23 Adding a Trend Log
Record to a Manual Trend Log on page
1211.

04-17005-03-en, October 2015 System


1329
41 Trends User interface
41.5 Interval Trend Log Properties

41.5 Interval Trend Log Properties


Use the Interval Trend Log properties to configure the interval trend log.

Figure: Interval trend log properties

Table: Table Interval Trend Log Properties Pane


Property Description

Status Displays the status of the trend log.

Enabled Displays True if the trend log is enabled.

Activation time Enter the absolute start time when Time


mode is set to Absolute. This time is the
leftmost point of the x-axis.

Activation method Select the method for starting the trend log.
For more information, see section 38.3
Activation Methods on page 1217.

Clear when enabled Select True to clear the trend log when it is
enabled.

Activation variable Enter the variable that is to start the trend


log.

System 04-17005-03-en, October 2015


1330
41 Trends User interface
41.5 Interval Trend Log Properties

Continued
Property Description

Logged variable Enter the variable that you want to log.

Interval Type how often to log the variable, the


interval defines the time between two log
records.

Log size Select the log size to store before old


records are overwritten. The system adds a
5% buffer for events registered for the log.

Delta Select the minimum value change that


triggers a new record.

04-17005-03-en, October 2015 System


1331
41 Trends User interface
41.6 Meter Trend Log Properties

41.6 Meter Trend Log Properties


Use the Meter Trend Log properties to configure the meter trend log.

Figure: Meter trend log properties

Table: Meter Trend Log Properties


Component Description

Status Displays the status of the trend log.

Enabled Displays True if the trend log is enabled.

Clear when enabled Select True to clear the trend log when it is
enabled.

Delta Select the minimum value change that


triggers a new record.

Logged variable Enter the variable that you want to log.

Trigger variable Enter the variable that triggers the trend log
to start recording.

System 04-17005-03-en, October 2015


1332
41 Trends User interface
41.6 Meter Trend Log Properties

Continued
Component Description

Trigger when Select when you want the variable recorded:


when trigger variable changes to true,
changes to false, or all changes. For more
information, see section 37.17 Variable
Triggered Trend Logs on page 1198.

Log size Select the log size to store before old


records are overwritten.

04-17005-03-en, October 2015 System


1333
41 Trends User interface
41.7 Change of Value Trend Log Properties

41.7 Change of Value Trend Log Properties


Use the Change of Value Trend Log properties to configure the change of value
trend log.

Figure: Change of value trend log properties

Table: Change of Value Trend Log Properties


Property Description

Status Displays the status of the trend log.

Enabled Displays True if the trend log is enabled.

Activation time Enter the absolute start time when Time


mode is set to Absolute. This time is the
leftmost point of the x-axis.

Activation method Select the method for starting the trend log.
For more information, see section 38.3
Activation Methods on page 1217.

Clear when enabled Select True to clear the trend log when it is
enabled.

System 04-17005-03-en, October 2015


1334
41 Trends User interface
41.7 Change of Value Trend Log Properties

Continued
Property Description

Activation variable Enter the variable that is to start the trend


log.

Logged variable Enter the variable that you want to log.

Delta Select the minimum value change that


triggers a new record.

Log size Select the log size to store before old


records are overwritten.

04-17005-03-en, October 2015 System


1335
41 Trends User interface
41.8 Variable Triggered Trend Log Properties

41.8 Variable Triggered Trend Log


Properties
Use the Variable Triggered Trend Log properties to configure the variable
triggered trend log.

Figure: Variable triggered trend log properties

Table: Variable Triggered Trend Log Properties


Component Description

Status Displays the status of the trend log.

Enabled Displays True if the trend log is enabled.

Clear when enabled Select True to clear the trend log when it is
enabled.

Delta Select the minimum value change that


triggers a new record.

Logged variable Enter the variable that you want to log.

Trigger variable Enter the variable that triggers the trend log
to start recording.

System 04-17005-03-en, October 2015


1336
41 Trends User interface
41.8 Variable Triggered Trend Log Properties

Continued
Component Description

Trigger when Select when you want the variable recorded:


when trigger variable changes to true,
changes to false, or all changes. For more
information, see section 37.17 Variable
Triggered Trend Logs on page 1198.

Log size Select the log size to store before old


records are overwritten.

04-17005-03-en, October 2015 System


1337
41 Trends User interface
41.9 Manual Trend Log Properties

41.9 Manual Trend Log Properties


Use the Manual Trend Log properties to configure the manual trend log.

Figure: Manual trend log properties

Table: Manual Trend Log Properties


Component Description

Unit Enter the unit the trend log stores the


records in.

Click to open the configuration dialog box


where you configure the property. For more
information, see section 50.36 Configure
Dialog Box - Configuration Tab on page
1645.

System 04-17005-03-en, October 2015


1338
41 Trends User interface
41.10 Extended Trend Log Properties

41.10 Extended Trend Log Properties


Use the Extended Trend Log properties to configure the extended trend log.

Figure: Extended trend log properties

Table: Extended Trend Log Properties


Component Description

Monitored trend log Enter the trend log that you want to transfer
records from.

Unit Enter the unit the trend log stores the


records in.

Smart log Select True to optimize the transfer of the


monitored trend log to the extended trend
log.

Threshold Select the percentage threshold at which the


trend log transfers its records to the
extended trend log.

Maximum transfer interval Select the maximum length of time that can
pass between transfers from the monitored
trend log to the extended trend log.

04-17005-03-en, October 2015 System


1339
41 Trends User interface
41.10 Extended Trend Log Properties

Continued
Component Description

Log records Select the number of records to store before


old records are overwritten.

Include in reports Select True to include the extended trend


log data in reports.

Transfer trigger variable Enter a trigger variable to force a transfer of


all records from the trend log to the
extended trend log, for example, to generate
a complete report. For more information, see
section 38.4 Extended Trend Logs on
page 1221.

System 04-17005-03-en, October 2015


1340
41 Trends User interface
41.11 Trend Chart Properties

41.11 Trend Chart Properties


Use the Trend Chart Properties dialog box to configure the general properties of
the trend chart.

Figure: Trends chart properties

Table: Trend Chart Properties Table


Property Description

Time mode Select the time mode of the x-axis.

Start time Enter the absolute start time when Time


mode is set to Absolute. This time is the
leftmost point of the x-axis.

Time span Type the relative time span of the x-axis.

Time zone Select the time zone of the trend log list. The
mode is the perspective in which the trend
log is displayed.

Show nearest information for all Select True to show information on every
series series along a diagonal line.

04-17005-03-en, October 2015 System


1341
41 Trends User interface
41.11 Trend Chart Properties

Continued
Property Description

Auto scale left y-axis Select True to activate auto scale and have
the left y-axis adapt itself to the displayed
series.

Left y-axis minimum Enter the minimum value of the left y-axis.

Left y-axis maximum Enter the maximum value of the left y-axis.

Auto scale right y-axis Select True to activate auto scale and have
the right y-axis adapt itself to the displayed
series.

Right y-axis minimum Enter the minimum value of the right y-axis.

Right y-axis maximum Enter the maximum value of the right y-axis.

Show grid lines for X-axis Select True to show grid lines for the x-axis.

Show grid lines for left Y-axis Select True to show gridlines for the left y-
axis originating from the y-axis scale.

Show grid lines for right Y-axis Select True to show gridlines for the right y-
axis originating from the y-axis scale.

Add
Click to add a series to the trend chart. For
more information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

Edit
Click to edit a selected series. For more
information, see section 41.23 Trend Chart
Series Properties on page 1364.

Remove
Click to remove a selected series.

System 04-17005-03-en, October 2015


1342
41 Trends User interface
41.12 Trend Log List Properties

41.12 Trend Log List Properties


Use the Trend Log List properties to configure the trend log list.

Figure: Trend log list properties

Table: Trend Log List Properties


Component Description

Display trend log Enter the trend log to display in the trend log
list.

Log space (records) Select the maximum number of records to


display in the trend log list.

Show events Select True to display events in the trend


log list. This function does not hide events in
the list that contain a value or comment. For
example, when a record is added, edited, or
commented.

Time zone Select which time perspective to display in


the trend log. For more information, see
section 40.4 Time Zone Modes in a Trend
Log List on page 1306.

04-17005-03-en, October 2015 System


1343
41 Trends User interface
41.12 Trend Log List Properties

Continued
Component Description

Calculation method Select a calculation method.

Delta over period Select True to apply a period to the delta


calculation method.

Period Select the time span for which the


calculation method is to be executed.

Custom period Enter a custom time span for which the


calculation method is to be executed.

Custom period alignment Enter the time when you want the custom
period to start.

System 04-17005-03-en, October 2015


1344
41 Trends User interface
41.13 Manage Replacement of Meter Dialog Box

41.13 Manage Replacement of Meter Dialog


Box
Use the Manage replacement of meter dialog box to configure the meter
setting when a new meter is installed or replaced.

Note
The Manage replacement of meter dialog box only applies to meter
trend log.

Figure: Manage replacement of meter dialog box

Table: Manage Replacement of Meter Dialog Box


Component Description

End time Type the end time of the old meter,


preferably the time when the meter is
replaced.

End value Type the value the old meter has when it is
replaced.

Unit Displays the unit of the meter trend log.

Start time Type the time when the new meter is


installed.

Start value Type the current value of the new meter


when it was installed.

Meter constant Type the constant of the new meter. If the


meter counts in kilo (103) type 1000.

Min value Type the first value of the new meter after
roll-over.

04-17005-03-en, October 2015 System


1345
41 Trends User interface
41.13 Manage Replacement of Meter Dialog Box

Continued
Component Description

Max value Type the last value of the new meter before
roll-over.

System 04-17005-03-en, October 2015


1346
41 Trends User interface
41.14 Meter Change History Dialog Box

41.14 Meter Change History Dialog Box


Use the Meter Change History dialog box to display all meter changes together
with the replaced meters settings.

Note
The Meter Change History dialog box only applies to meter trend log.

Figure: Meter change history dialog box

Table: Meter Change History Dialog Box


Component Description

End time Displays the time when the old meter was
replaced.

End value Displays the value the old meter had when it
was replaced.

Unit Displays the unit of the old meter.

Start time Displays the time when the new meter was
installed.

Start value Displays the value of the new meter when it


was installed.

Meter constant Displays the constant of the new meter. If


the meter counts in kilo (103), the constant is
1000.

Min value Displays the first value of the new meter after
roll-over.

04-17005-03-en, October 2015 System


1347
41 Trends User interface
41.14 Meter Change History Dialog Box

Continued
Component Description

Max value Displays the last value of the new meter


before roll-over.

System 04-17005-03-en, October 2015


1348
41 Trends User interface
41.15 Trend Chart View

41.15 Trend Chart View


Use the Trend Chart view to graphically display trend log records and events.

Figure: Trend chart view

Table: Trend Chart View


Number Description

Use the trend chart toolbar to adjust the


visible trend chart area. For more
information, see section 41.16 Trend Chart
Toolbar on page 1351.

Use the Series tab shortcut menu to


manage the appearance of a trend log
series. For more information, see section
41.19 Series Tab Shortcut Menu on page
1357.

Use the trend log event icons to get


information about a specific record. For
more information, see section 41.17 Trend
Chart Event Icons on page 1353.

04-17005-03-en, October 2015 System


1349
41 Trends User interface
41.15 Trend Chart View

Continued
Number Description

Use the navigation bar to horizontally adjust


the visible trend chart area. For more
information, see section 41.18 Trend Chart
Navigation Bar on page 1356.

System 04-17005-03-en, October 2015


1350
41 Trends User interface
41.16 Trend Chart Toolbar

41.16 Trend Chart Toolbar


Use the Trend Chart toolbar to manage the trend chart and its series.

Table: Trend Chart Toolbar


Button Description

Reset zoom
Click to reset the trend chart to its original
size in the database.

Pointer
Click to point to log records in the trend
chart or to scroll vertically with the mouse
wheel.

Scroll trend chart vertical


Click to activate vertical scroll. Drag the chart
area upwards or downwards to scroll the y-
axis vertically.

Zoom in
Click to increase the scale of the trend chart
or drag to magnify an area in the trend chart.

Zoom out
Click to decrease the scale of the trend
chart.

Show one hour


Click to set the scale of the x-axis to one
hour.

Show one day


Click to set the scale of the x-axis to one
day.

Show one week


Click to set the scale of the x-axis to one
week.

Show one month


Click to set the scale of the x-axis to one
month.

Show one year


Click to set the scale of the x-axis to one
year.

Show nearest information on every


series
Click to show values of every trend chart
series at a specific time.

04-17005-03-en, October 2015 System


1351
41 Trends User interface
41.16 Trend Chart Toolbar

Continued
Button Description

Open trend chart settings


Opens the Trend chart settings dialog
box for the trend chart where you can
configure the trend chart series, axes, and
calculations.
For more information, see section 41.20
Trend Chart Settings Dialog Box Axes
Tab on page 1359.
For more information, see the Trend Chart
Settings Dialog Box Axis Tab topic on
WebHelp.

Save current settings


Click to save the settings you have done in
the trend chart in WebStation.

System 04-17005-03-en, October 2015


1352
41 Trends User interface
41.17 Trend Chart Event Icons

41.17 Trend Chart Event Icons


Use the Trend Chart event icons to get information on different trend log events.

Table: Trend chart event icons


Icon Description

Log was started


Indicates that the trend log started recording
values.

Log was stopped


Indicates that the trend log stopped
recording values.

The log is not configured


Indicates that the trend log is not correctly
configured or preferences are missing, so
the trend log cannot start recording values.

A log value was missed


Indicates that one or more records were
missed due to interrupted communication,
hardware failure, or software failure.

The log configuration was updated


Indicates that the settings of the trend log
were updated. The change is described in
the ToolTip of the event.

Record was added


Indicates that a record was manually added.
The new value is described in the event
ToolTip.

Record was edited


Indicates that a record was manually edited.
The change is described in the ToolTip of the
event.

Record was added and commented


Indicates that a record was manually added
and commented. The new value and
comment are described in the ToolTip of the
event.

Record was edited and commented


Indicates that a record was manually edited
and commented. The changes are
described in the ToolTip of the event.

04-17005-03-en, October 2015 System


1353
41 Trends User interface
41.17 Trend Chart Event Icons

Continued
Icon Description

Record was commented


Indicates that a record was commented. The
comment is shown in the ToolTip of the
event.

Log was cleared


Indicates that a trend log was cleared.

Meter was changed


Indicates that the meter was changed or that
the settings were configured. This icon only
applies to the meter trend log.

Values exist outside the viewable area


Indicates that values exist before the values
displayed in the trend chart area.

Values exist outside the viewable area


Indicates that values exist after the values
displayed in the trend chart area.

INF value was logged


Indicates that a positive Infinity value was
logged.

-INF value was logged


Indicates that a negative Infinity value was
logged.

NaN value was logged


Indicates that an unknown value ("Not a
Number") was logged.

Null value was logged


Indicates that a Null value was logged.

System clock changed


Indicates that the system date and time of
the SmartStruxure server where the trend
log is located has been changed. For more
information, see section 17.1 Time and
Time Zone on page 347.

System 04-17005-03-en, October 2015


1354
41 Trends User interface
41.17 Trend Chart Event Icons

Continued
Icon Description

Override
Indicates that the recorded value is
overridden by the hardware and is not the
measured value. For more information, see
the Output Override Status topic on
WebHelp.
Forced
Indicates that the recorded value is forced by
the software and is not the measured value.
For more information, see the Forced I/O
Point Values topic on WebHelp.

Log database restored


Indicates that the log database has been
restored and that, when the log restarts,
there can be a time gap in the log series.

Log reset by extended log


Indicates that the log has been cleared by
the extended trend log due to a log
database restore.

04-17005-03-en, October 2015 System


1355
41 Trends User interface
41.18 Trend Chart Navigation Bar

41.18 Trend Chart Navigation Bar


Use the Trend Chart navigation bar to horizontally scroll the trend chart.

Table: Trend Chart Navigation Bar


Component Description

Log start
Click to scroll back to the first value of the
trend chart in WorkStation.

Fast backward
Click to scroll fast backward.

Backward
Click to scroll back.

Live update Select to have the trend chart automatically


adjust itself according to the latest trend log
record in WorkStation.

Auto scroll
Click to have the trend chart automatically
adjust itself according to the latest trend log
record in WebStation.

Forward
Click to scroll forward.

Fast forward
Click to scroll fast forward.

Current time
Click to scroll forward to the latest value of
the trend chart in WorkStation.

System 04-17005-03-en, October 2015


1356
41 Trends User interface
41.19 Series Tab Shortcut Menu

41.19 Series Tab Shortcut Menu


Use the Series tab to open the series shortcut menu, where you can change the
presentation of series, show or hide events, markers, and series, bring to front and
remove series, as well as open the trend chart settings dialog box.
The series tabs are located at the bottom leftmost if there are series attached to the
left y-axis, and at the bottom rightmost if there are series attached to the right y-
axis.

Figure: Series tab with the series shortcut menu

Table: Series Tab with the Shortcut Menu


Component Description

Line Select to display the series as a line.

Discrete line Select to display the series as a discrete line.

Digital Select to display the series as a digital line.

Bars Select to display the series as bars.

Events Select to present the series with event


symbols.

Visible Select to hide or display the series in the


trend chart.

Markers Select to display a marker for each record.


Markers can only be shown for lines and
discrete lines, not for digital and bars.

Bring to front Click to display the series in front of the


others.

Remove series Click to remove series from the trend chart.

04-17005-03-en, October 2015 System


1357
41 Trends User interface
41.19 Series Tab Shortcut Menu

Continued
Component Description

Open trend chart settings Click to open the property dialog box for the
trend chart and its series.

System 04-17005-03-en, October 2015


1358
41 Trends User interface
41.20 Trend Chart Settings Dialog Box Axes Tab

41.20 Trend Chart Settings Dialog Box Axes


Tab
Use the Axes tab to configure the properties of the chart axes.

Figure: Axes tab

Table: Axes Tab


Component Description

Time mode Select the time mode of the x-axis.

Start time Enter the absolute start time when Time


mode is set to Absolute. This time is the
leftmost point of the x-axis.

End time Enter the absolute end time when Time


mode is set to Absolute (start time and
end time). This time is the rightmost point
of the x-axis.

Time span Type the relative time span of the x-axis


when Time mode is set to Relative (to
current time). The rightmost point of the x-
axis is the current time.

Time zone Select time zone for the trend chart. The
time zone is the displayed time perspective
of the trend log.

Show grid lines Select to show horizontal grid lines.

04-17005-03-en, October 2015 System


1359
41 Trends User interface
41.20 Trend Chart Settings Dialog Box Axes Tab

Continued
Component Description

Auto scale left y-axis Select to activate auto scale. The scale of
the left y-axis adapts itself to the displayed
series.

Left y-axis minimum Type the minimum value of the left y-axis.

Left y-axis maximum Type the maximum value of the left y-axis.

Show left grid lines Select to show grid lines on the left y-axis.

Auto scale right y-axis Select to activate auto scale. The scale of
the right y-axis adapts itself to the displayed
series.

Right y-axis minimum Type the minimum value of the right y-axis.

Right y-axis maximum Type the maximum value of the right y-axis.

Show right grid lines Select to show grid lines on the right y-axis.

System 04-17005-03-en, October 2015


1360
41 Trends User interface
41.21 Trend Chart Settings Dialog Box Series Tab

41.21 Trend Chart Settings Dialog Box


Series Tab
Use the Series tab to configure the properties of the series in the trend chart.

Figure: Trend chart settings - series tab

Table: Series Tab


Component Description

Display variable/trend log Displays the referenced variable or trend log.


To change the reference, browse to a
different variable or trend log.

Data series Displays all series in the trend chart. Select a


series to display its presentation properties.

Series presentation Select the presentation type of the series.

Assigned to y-axis Select Left to attach the series to the left y-


axis.

Weight Type the weight of the line. The value is a


value without correlation to any unit of
measure.

Show markers Select to display a marker for each record.


Markers can only be shown for lines and
discrete lines, not for digital and bars.

Show events Select to present the series with event


symbols.

04-17005-03-en, October 2015 System


1361
41 Trends User interface
41.21 Trend Chart Settings Dialog Box Series Tab

Continued
Component Description

Color Enter the color of the series.

System 04-17005-03-en, October 2015


1362
41 Trends User interface
41.22 Trend Chart Settings Dialog Box Calculation Tab

41.22 Trend Chart Settings Dialog Box


Calculation Tab
Use the Calculation tab to attach a calculation method to a series.

Figure: Calculations tab

Table: Calculations Tab


Component Description

Data series Displays all series in the trend chart. Select a


series to display its presentation properties.

Calculation method Select calculation method to calculate the


recorded values before displaying the series
in the trend chart.

Delta over period Select to apply a period to the delta


calculation method.

Period Select the time span for which the


calculation method is to be executed.

Custom period When Custom period is selected, enter a


custom time span for which the calculation
method is to be executed.

Custom period alignment When Custom period is selected, enter the


time when you want the custom period to
start.

04-17005-03-en, October 2015 System


1363
41 Trends User interface
41.23 Trend Chart Series Properties

41.23 Trend Chart Series Properties


Use the Trend Chart Series Properties dialog box to configure the properties of
the trend chart series.

Figure: Trend chart series properties

Table: Trend Chart Series Properties


Component Description

Display trend log Displays the path the trend log series is
connected to.

Y-axis Select Left to attach the series to the left y-


axis.

Series presentation Select the presentation of the series: line,


discrete line, binary, or bars.

Color Enter the color of the series.

Weight Enter the weight of the line. The line-weight


value is a value without correlation to any
unit of measure.

System 04-17005-03-en, October 2015


1364
41 Trends User interface
41.23 Trend Chart Series Properties

Continued
Component Description

Show markers Select True to show a marker for each


record. The marker can only be shown for
lines and discrete lines, not for digital and
bars.

Show events Select True to show event symbols in the


trend chart.

Calculation method Select the calculation method to calculate


the recorded values before displaying the
series in the trend chart.

Delta over period Select True to apply a period to the delta


calculation method.

Period Select the time span for which the


calculation method is to be executed.

Custom period Enter a custom time span for which the


calculation method is to be executed

Custom period alignment Enter the time when you want the custom
period to start.

04-17005-03-en, October 2015 System


1365
41 Trends User interface
41.24 Real Time Trend Series Properties

41.24 Real Time Trend Series Properties


Use the Basic tab to configure and view real time trend properties. For more
information, see section 50.34 General Properties Basic Tab on page 1642.

Figure: Real Time Series Properties - Basic tab

System 04-17005-03-en, October 2015


1366
41 Trends User interface
41.25 Trend Log List View

41.25 Trend Log List View


Use the Trend Log List view to view, edit, or export the records of a trend log.

Figure: Trend log list view

Table: Trend Log List View


Number Description

Use the trend log list toolbar to manage or


export trend log records. For more
information, see section 41.27 Trend Log
List Toolbar on page 1370.

Use the log info to get detailed information


about the trend log list. For more
information, see section 41.29 Trend Log
List Log Info View on page 1374.

Use the trend log list columns to sort the


trend log records. For more information, see
the Add/Remove Columns Dialog Box topic
on WebHelp.

Use the trend log list shortcut menu to edit,


add, or show the history of trend log
records. For more information, see section
41.30 Trend Log List Shortcut Menu on
page 1375.

04-17005-03-en, October 2015 System


1367
41 Trends User interface
41.25 Trend Log List View

Continued
Number Description

Use the trend log event icons to get


information about a specific record. For
more information, see section 41.28 Trend
Log List Event Icons on page 1372.

System 04-17005-03-en, October 2015


1368
41 Trends User interface
41.26 Add/Remove Columns Dialog Box (Trends)

41.26 Add/Remove Columns Dialog Box


(Trends)
Use the Add/Remove Columns dialog box to add or remove columns from the
trend log list.

Figure: Add/Remove Columns dialog box

Table: Add/Remove Columns Dialog Box


Component Descriptin

Comment Select to display the comment added by a


user or system. For more information, see
section 32.1 Comments on page 885.

Events Select to display any events that occurred.

Sample status Select to display the condition when the


sample was recorded.

Sequence number Select to display the event sequence


number on the present SmartStruxure
server.

Time stamp Select to display the time and date when the
event was generated.

User Select to display the user name that


generated the event.

Value Select to display the value.

04-17005-03-en, October 2015 System


1369
41 Trends User interface
41.27 Trend Log List Toolbar

41.27 Trend Log List Toolbar


Use the trend log list toolbar to manage the trend log list and records.

Figure: Trend log list with toolbar

Table: Trend Log List Toolbar


Button Description

Show/Hide group box


Click to open or close the column grouping
and sorting tool.

Events
Click to show or hide events in the trend log
list. This function does not hide events in the
list that contain a value or comment, such as
Record was added, Record was
edited, and Record was commented.
For more information, see section 41.28
Trend Log List Event Icons on page 1372.

Show time stamps with fractions


Click to show the time stamps with
hundredths.

Show decimal values


Click to display the values as decimals.

Show values as bitstrings


Click to display the values as bitstrings.

Show values as booleans


Click to display the values as booleans.

Add trend log record


Click to open the Add trend log record
dialog box where you can add one or more
values to the trend log. Refresh the trend log
list to see the added values. For more
information, see section 41.31 Add Trend
Log Record Dialog Box on page 1376.

System 04-17005-03-en, October 2015


1370
41 Trends User interface
41.27 Trend Log List Toolbar

Continued
Button Description

Edit/comment trend log record


Click to open the Edit/comment trend
log record dialog box, where you can edit
or comment a recorded value. For more
information, see section 41.32
Edit/Comment Trend Log Record Dialog
Box on page 1377.

Clear trend log


Click to clear all the records from the trend
log.

Export to .XML
Click to open the Export dialog box.

Export to .CSV
Click to open the Export dialog box.

Show list of meter change events


Click to open the Meter change history
dialog box, where the history of meter
changes is shown. For more information, see
section 41.14 Meter Change History Dialog
Box on page 1347.

Open trend log list settings


Click to open the Settings dialog box for
the trend log list, where you can configure
the trend log settings. For more information,
see section 41.12 Trend Log List
Properties on page 1343.

Log space (records) Type the maximum number of log records to


display in the trend log list.

Apply
Click to limit the number of log space
records to the number typed in the box.

04-17005-03-en, October 2015 System


1371
41 Trends User interface
41.28 Trend Log List Event Icons

41.28 Trend Log List Event Icons


Use the trend log list event icons to get information on different trend log events.

Table: Trend Log List Event Icons


Icon Description

Log was started


Indicates that the trend log started recording
values.

Log was stopped


Indicates that the trend log stopped
recording values.

The log is not configured


Indicates that the trend log is not correctly
configured or preferences are missing, so
the trend log cannot start recording values.

A log value was missed


Indicates that one or more records were
missed due to interrupted communication,
hardware failure, or software failure.

The log configuration was updated


Indicates that the settings of the trend log
were updated. The change is described in
the comment column of the table.

Record was added


Indicates that a record was manually added.

Record was edited


Indicates that a record was manually edited.

Record was added and commented


Indicates that a record was manually added
and commented. The new value and
comment are described in the ToolTip of the
event.

Record was edited and commented


Indicates that a record was manually edited
and commented. The changes are
described in the ToolTip of the event.

Record was commented


Indicates that a log record was commented.
The comment is displayed in the ToolTip of
the event and in the comment column of the
table.

System 04-17005-03-en, October 2015


1372
41 Trends User interface
41.28 Trend Log List Event Icons

Continued
Icon Description

Log was cleared


Indicates that a trend log was cleared.

Meter was changed


Indicates that the meter was changed or that
the settings were configured.
This event symbol only applies to the meter
trend log.

System clock changed


Indicates that the system date or time,
where the trend log is located, has been
changed. For more information, see section
17.1 Time and Time Zone on page 347.

Override
Indicates that the recorded value is
overridden by the hardware and is not the
measured value. For more information, see
the Output Override Status topic on
WebHelp.
Forced
Indicates that the recorded value is forced by
the software and is not the measured value.
For more information, see the Forced I/O
Values topic on WebHelp.

Log database restored


Indicates that the log database has been
restored and that, when the log restarts,
there can be a time gap in the log series.

Log reset by extended log


Indicates that the commands from the
extended trend log have been cleared from
the trend log.

04-17005-03-en, October 2015 System


1373
41 Trends User interface
41.29 Trend Log List Log Info View

41.29 Trend Log List Log Info View


When expanded, the Log Info view displays a summary of the data recorded in the
trend log list.

Note
The log info does not include records that are not displayed in the trend log
list. The log info data changes with the trend log when the trend log list is
refreshed or reopened.

Figure: Log info view

Table: Log Info View


Component Description

Log name The name of the log that is connected to the


trend log list.

Log unit The unit of the recorded values.

Calculation method The calculation method connected to the


trend log list, if any.

Start time The time of the first record in the trend log
list.

Highest value The highest value in the trend log list.

Average The average value of the trend log list.

Displayed trend log The trend log that is connected to the trend
log list.

Stop time The time of the last record in the trend log
list.

Lowest value The lowest value in the trend log list.

Number of records The number of records to be stored before


old records are overwritten.

System 04-17005-03-en, October 2015


1374
41 Trends User interface
41.30 Trend Log List Shortcut Menu

41.30 Trend Log List Shortcut Menu


Right-click a row in a trend log list to open the trend log list shortcut menu, where
you can edit a record, show the history of a record, or copy the trend log list data.

Figure: Trend log list shortcut menu

Table: Trend Log List Shortcut Menu


Component Description

Edit record Click to open the Edit/Comment trend


log record value dialog box where you
can edit values or add comments. For more
information, see section 41.31 Add Trend
Log Record Dialog Box on page 1376.

Show history Click to open the Edit/Comment trend


log value dialog box where you can edit
values or add comments. For more
information, see section 41.31 Add Trend
Log Record Dialog Box on page 1376.

Copy Click to copy the list data to the clipboard.

04-17005-03-en, October 2015 System


1375
41 Trends User interface
41.31 Add Trend Log Record Dialog Box

41.31 Add Trend Log Record Dialog Box


Use the Add trend log record dialog box to add a trend log record to a manual
trend log.

Note
The Add trend log record dialog box is only applicable to manual trend
logs.

Figure: Add trend log record dialog box

Table: Add Trend Log Record Dialog Box


Component Description

Time stamp Enter the time and date of the new record.

Value Type the value of the new record.

Comment Type a comment for the record.

System 04-17005-03-en, October 2015


1376
41 Trends User interface
41.32 Edit/Comment Trend Log Record Dialog Box

41.32 Edit/Comment Trend Log Record Dialog


Box
Use the Edit/comment trend log record dialog box to change a trend log value
in the trend log.

Figure: Edit/comment trend log record dialog box

Table: Edit/Comment Trend Log Record Dialog Box


Component Description

Time stamp Displays the time the value was recorded.

Value Type the new value of the record.

Comment Type a comment for the value.

04-17005-03-en, October 2015 System


1377
41 Trends User interface
41.33 Create Trend Log Wizard Configure Interval Trend Log Page

41.33 Create Trend Log Wizard Configure


Interval Trend Log Page
Use the Configure Interval Trend Log page to configure the settings of the
interval trend log.

Figure: Configure interval trend log page

Table: Configure Interval Trend Log Page


Component Description

Logged variable Enter the variable that you want to log.

Delta Select the minimum value change that


triggers a new record.

Unit Enter the unit of the records in the trend log


list. For more information, see section 36.5
Trend Units on page 1132.

Interval Type how often to log the variable, the


interval defines the time between two log
records.

Log size Select the log size to store before old


records are overwritten. The system adds a
5% buffer for events registered for the log.

Clear when enabled Select True to clear the trend log when it is
enabled.

Start condition Select the method of starting the trend log.


For more information, see section 38.3
Activation Methods on page 1217.

System 04-17005-03-en, October 2015


1378
41 Trends User interface
41.34 Create Trend Log Wizard Configure Meter Trend Log Page

41.34 Create Trend Log Wizard Configure


Meter Trend Log Page
Use the Configure Meter Trend Log page to configure the settings of the meter
trend log.

Figure: Configure meter trend log page

Table: Configure Meter Trend Log Page


Component Description

Logged variable Enter the variable that you want to log.

Trigger variable Enter the variable that triggers the trend log
to start recording.

Unit Enter the unit of the records in the trend log


list. For more information, see section 36.5
Trend Units on page 1132.

Trigger when Select when you want the variable recorded:


when trigger variable changes to true,
changes to false, or all changes. For more
information, see section 37.17 Variable
Triggered Trend Logs on page 1198.

Log size Select the log size to store before old


records are overwritten.

Clear when enabled Select True to clear the trend log when it is
enabled.

04-17005-03-en, October 2015 System


1379
41 Trends User interface
41.35 Create Trend Log Wizard Configure Change of Value Trend Log Page

41.35 Create Trend Log Wizard Configure


Change of Value Trend Log Page
Use the Configure Change of Value Trend Log page to configure the settings
of a change of value trend log.

Figure: Configure change of value trend log page

Table: Configure Change of Value Trend Log Page


Component Description

Logged variable Enter the variable that you want to log.

Delta Select the minimum value change that


triggers a new record.

Unit Enter the unit of the records in the trend log


list. For more information, see section 36.5
Trend Units on page 1132.

Log size Select the log size to store before old


records are overwritten.

Clear when enabled Select True to clear the trend log when it is
enabled.

Activation method Select the method for starting the trend log.
For more information, see section 38.3
Activation Methods on page 1217.

Activation time Type the start time of the trend log.

Activation variable Enter the variable that is to start the trend


log.

System 04-17005-03-en, October 2015


1380
41 Trends User interface
41.36 Create Trend Log Wizard Configure Variable Triggered Trend Log

41.36 Create Trend Log Wizard Configure


Variable Triggered Trend Log
Use the Configure Variable Triggered Trend Log page to configure the
settings of a variable triggered trend log.

Figure: Configure variable triggered trend log page

Table: Configure Variable Triggered Trend Log Page


Component Description

Logged variable Enter the variable that you want to log.

Trigger variable Enter the variable that triggers the trend log
to start recording.

Unit Enter the unit of the records in the trend log


list. For more information, see section 36.5
Trend Units on page 1132.

Trigger when Select when you want the variable recorded:


when trigger variable changes to true,
changes to false, or all changes. For more
information, see section 37.17 Variable
Triggered Trend Logs on page 1198.

Log size Select the log size to store before old


records are overwritten.

Clear when enabled Select True to clear the trend log when it is
enabled.

04-17005-03-en, October 2015 System


1381
41 Trends User interface
41.37 Create Trend Log Wizard Configure Manual Log Page

41.37 Create Trend Log Wizard Configure


Manual Log Page
Use the Configure Manual Log page to configure the settings of a manual log.

Figure: Configure manual log page

Table: Configure Manual Log Page


Component Description

Unit Enter the unit of the records in the trend log


list. For more information, see section 36.5
Trend Units on page 1132.

System 04-17005-03-en, October 2015


1382
41 Trends User interface
41.38 Create Trend Log Wizard Configure Extended Trend Log Page

41.38 Create Trend Log Wizard Configure


Extended Trend Log Page
Use the Configure Extended Trend Log page to configure the settings of the
extended trend log.

Figure: Configure extended trend log page

Table: Configure Extended Trend Log Page


Component Description

Monitored trend log Enter the trend log that you want to transfer
records from.

Smart log Select True to optimize the transfer of the


monitored trend log to the extended trend
log.

Maximum transfer interval Select the maximum length of time that can
pass between transfers from the monitored
trend log to the extended trend log.

Log records Select the number of records to store before


old records are overwritten.

Include in reports? Select True to include the extended trend


log data in reports.

Transfer trigger variable Enter a trigger variable to force a transfer of


all records from the trend log to the
extended trend log, for example, to generate
a complete report. For more information, see
section 38.4 Extended Trend Logs on
page 1221.

04-17005-03-en, October 2015 System


1383
41 Trends User interface
41.39 Create Trend Log Wizard Configure Trend Chart Page

41.39 Create Trend Log Wizard Configure


Trend Chart Page
Use the Configure Trend Chart page to configure the settings of the trend chart.

Figure: Configure trend chart page

Table: Configure Trend Chart Page


Component Description

Time mode Select the time mode of the x-axis.

Start time Enter the absolute start time when Time


mode is set to Absolute. This time is the
leftmost point of the x-axis.

Stop time Enter the absolute stop time when Time


mode is set to Absolute. This time is the
rightmost point of the x-axis.

Time span When time mode is set to Relative the


leftmost x-axis value is equal current time
minus Time span. Where the rightmost x-
axis value is current time.

Auto scale left Y-axis Select to activate auto scale. The scale of
the left y-axis adapts itself to the displayed
series.

Series Displays all series in the trend chart.

Add
Click to add a series to the trend chart. For
more information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

Edit
Click to edit a selected series. For more
information, see section 41.23 Trend Chart
Series Properties on page 1364.

Remove
Click to remove a selected series.

System 04-17005-03-en, October 2015


1384
41 Trends User interface
41.40 Create Trend Log Wizard Configure Real-Time Trend Series Page

41.40 Create Trend Log Wizard Configure


Real-Time Trend Series Page
Use the Configure real-time trend series page to add a series to the trend
chart that presents a variable in real-time.

Figure: Configure real-time trend series page

Table: Configure Real-Time Trend Series Page


Component Description

Display variable Enter the variable you want to present as a


series in the trend chart.

Weight Type the weight of the line. The value is a


value without correlation to any unit of
measure.

Show markers Select True to show a marker for each


record. The marker can only be shown for
lines and discrete lines, not for digital and
bars.

04-17005-03-en, October 2015 System


1385
41 Trends User interface
41.41 Create Trend Log Wizard Configure Trend Log Series Page

41.41 Create Trend Log Wizard Configure


Trend Log Series Page
Use the Configure Trend Log Series page to add a series to the trend chart that
presents a trend log.

Figure: Configure trend log series page

Table: Configure Trend Log Series Page


Component Description

Display trend log Enter the trend log you want to present as a
series in the trend chart.

Weight Type the weight of the line. The value is a


value without correlation to any unit of
measure.

Show markers Select True to show a marker for each


record. The marker can only be shown for
lines and discrete lines, not for digital and
bars.

Show events Select True to show event symbols in the


trend chart.

System 04-17005-03-en, October 2015


1386
41 Trends User interface
41.42 Create Trend Log Wizard Configure Trend Log List Page

41.42 Create Trend Log Wizard Configure


Trend Log List Page
Use the Configure Trend Log List page to create a trend log list that presents
the records from a trend log.

Figure: Configure trend log list page

Table: Configure Trend Log List Page


Component Description

Display trend log Enter the trend log you want to present in
the trend log list.

Log space (records) Select the maximum number of records to


display in the trend log list.

04-17005-03-en, October 2015 System


1387
41 Trends User interface
41.43 Create Trend Log Wizard Connect Objects to the Trend Log Page

41.43 Create Trend Log Wizard Connect


Objects to the Trend Log Page
Use the Connect Objects to the Trend Log page to connect the trend log to an
extended trend log, trend log list, or trend chart.

Figure: Connect objects to the trend log page

Table: Connect Objects to the Trend Log Page


Component Description

Extended Trend Log Click the browse button to start the wizard
to create an extended trend log and connect
it to the trend log.

Trend Log List Click the browse button to start the wizard
to create a trend log list and connect it to the
trend log.

Trend Chart Click the browse button to start the wizard


to connect the trend log to a new trend or a
existing trend chart.

System 04-17005-03-en, October 2015


1388
41 Trends User interface
41.44 Trend Log Wizard Initial Meter Settings Page

41.44 Trend Log Wizard Initial Meter


Settings Page
Use the Initial Meter Settings page to set the initial values for the meter trend log.

Figure: Initial meter settings page

Table: Initital Meter Settings page


Property Description

Start time Displays the time when the new meter was
installed.

Start value Displays the value of the new meter when it


was installed.

Min value Displays the first value of the new meter after
roll-over.

Max value Displays the last value of the new meter


before roll-over.

04-17005-03-en, October 2015 System


1389
42 Mass Create Alarms and
Trends

Topics
Mass Create
Mass Create Unit Management
Object or Property Variable Type
Suffix and Prefix
Mass Create Path Options
Mass Creating Alarms
Mass Creating Alarms Using the Search Method
Mass Creating Trend Logs
Mass Creating Trend Logs Using the Search Method
Mass Creating Extended Trend Logs
Mass Creating Extended Trend Logs Using the Search
Method
Mass Create Object Wizard Name Page
42 Mass Create Alarms and Trends
42.1 Mass Create

42.1 Mass Create


You use the mass create feature to create multiple identical alarms or trend logs for
different objects, instead of creating the alarms or trend logs one by one. From
trend logs, you can mass create extended trend logs.
The main principle in Building Operation is that what you can do from one object or
property, you can mass create from a number of selected objects or properties on a
one to one basis. For example, you have seven objects that you want to monitor
with seven interval trend logs. By selecting the objects and starting the ordinary
New Object wizard, you configure a generic interval trend log template. When
finishing the wizard Building Operation automatically creates seven identical interval
trend logs that monitor individual objects.

Figure: Mass creating identical trend logs from different variables.

42.1.1 Object or Property Variable Type


In Building Operation, you can create alarms or trend logs that are suitable for the
variable type you have selected.
For more information, see section 42.3 Object or Property Variable Type on page
1396.

04-17005-03-en, October 2015 System


1393
42 Mass Create Alarms and Trends
42.1 Mass Create

42.1.2 Suffix and Prefix


When you mass create objects you can specify a prefix and suffix that are added to
the created object name. The prefix is added before the name and the suffix is
added after.
For more information, see section 42.4 Suffix and Prefix on page 1398.

42.1.3 Mass Create Unit Management


You can only mass create alarms with identical units or no unit. When you mass
create trend logs, each trend log gets the same unit as the logged variable.
For more information, see section 42.2 Mass Create Unit Management on page
1395.

42.1.4 Mass Create from Properties with the Search


Method
Mass creating can be performed by either selecting objects in the object list or
selecting the objects or properties in a search result list. Using the search result list
is very convenient if you want to monitor a number of properties located in different
devices or folders. For example, you want to create enumeration alarms that
monitor the reliability property on several I/O points. The I/O points are located on
several SmartStruxure server devices By performing a search for the reliability
property you can select the points that you want to monitor in the search result list.

42.1.5 Mass Create Path Options


You have three options when deciding where to create new alarms, trend logs, and
extended trend logs:
The same folder as each selected object
A different folder, relative to the path of each selected object
A single folder for all created objects

System 04-17005-03-en, October 2015


1394
42 Mass Create Alarms and Trends
42.2 Mass Create Unit Management

42.2 Mass Create Unit Management


You can only mass create alarms with identical units or no unit. When you mass
create trend logs, each trend log gets the same unit as the logged variable.

Figure: Objects and properties with no unit are given the unit that is defined for the other
objects.

04-17005-03-en, October 2015 System


1395
42 Mass Create Alarms and Trends
42.3 Object or Property Variable Type

42.3 Object or Property Variable Type


In Building Operation, you can create alarms or trend logs that are suitable for the
variable type you have selected.
If you select objects or properties with different variable types, you can only mass
create alarms or trend logs that have these variable types in common. For example,
you want to create identical alarms for three analog variables and one multistate
variable. When starting the New Object wizard, Building Operation restricts you to
create out of range alarms, out of reference alarms, or variable status alarms. This
because of the multistate alarm is not suitable to analog variables.

Table: Suitable Alarms and Trend Logs for a Specific Variable Type
Type Alarm Trend Log

Analog variable Out of range alarm Interval trend log


Out of reference range Meter trend log
alarm
Change of value trend
Variable status alarm log
Variable triggered trend
log

Multistate variable Multistate alarm Interval trend log


Out of range alarm Meter trend log
Out of reference range Change of value trend
alarm log
Variable status alarm Variable triggered trend
log

Digital variable Change of state alarm Interval trend log


Out of range alarm Meter trend log
Out of reference range Change of value trend
alarm log
Variable status alarm Variable triggered trend
log

Enumeration variable Enumeration alarm Interval trend log


Multistate alarm Meter trend log
Out of range alarm Change of value trend
log
Out of reference range
alarm Variable triggered trend
log
Variable status alarm

String variable Matching text string A trend log can only monitor
alarm values, not text strings.
Variable status alarm

System 04-17005-03-en, October 2015


1396
42 Mass Create Alarms and Trends
42.3 Object or Property Variable Type

Type Alarm Trend Log

Note
A trend log that monitors an enumeration records the enumeration value and not
the enumeration definition.
For more information, see section 52.12 Event and Alarm Enumerations on
page 1720.
For more information, see section 52.15 Trend Log Enumerations on page
1740.

04-17005-03-en, October 2015 System


1397
42 Mass Create Alarms and Trends
42.4 Suffix and Prefix

42.4 Suffix and Prefix


When you mass create objects you can specify a prefix and suffix that are added to
the created object name. The prefix is added before the name and the suffix is
added after.
For example, you have six offices in Building B. Every office has a temperature
sensor that you want to log with an interval trend log. The sensors are named Office
x, where x is the room number. When mass creating the interval trend logs you add
the prefix Building B, and the suffix Interval Trend Log. Building Operation creates
the interval trend logs and names them Building B - Office x - Interval Trend log,
where x is the office number.

Figure: Mass created trend logs with prefix and suffix.

System 04-17005-03-en, October 2015


1398
42 Mass Create Alarms and Trends
42.5 Mass Create Path Options

42.5 Mass Create Path Options


You have three options when deciding where to create new alarms, trend logs, and
extended trend logs:
The same folder as each selected object
A different folder, relative to the path of each selected object
A single folder for all created objects
The same folder as each selected object
By default, the alarms, trend logs, and extended trend logs are created in the same
folder as each selected object. When you create all objects in the same folder as
each selected object, the objects end up in the same folder as the value they are
based on.

Figure: The same folder as each selected object


A different path, relative to each selected object
When you create all objects in a different folder, relative to the path of each selected
folder, you have to browse to a destination folder for one of the alarms or trend logs.
The path relationship between the connected variable of that alarm or trend log and
the alarm or trend log itself is then applied to the destination of all other alarms or
trend logs. If you select an invalid path, for example, by selecting a destination
folder for one alarm or trend log on a level that does not exist for all the selected
variables, it is not possible to create any alarms or trend logs.

04-17005-03-en, October 2015 System


1399
42 Mass Create Alarms and Trends
42.5 Mass Create Path Options

Figure: A different path, relative to each selected object


A single folder for all created objects
When you create all objects in a single folder, you can specify the folder in which
you want to create all the alarms, trend logs, and extended trend logs. When you
create all objects in a different folder relative to the path of each selected object, you
can specify where the new alarms trend logs, and extended trend logs are created
in relation to the connected variable. When you mass create alarms and trends by
selecting values and dragging them to a single folder in the System Tree pane, the
alarms and trends are created in the folder to which you drag the values.

System 04-17005-03-en, October 2015


1400
42 Mass Create Alarms and Trends
42.5 Mass Create Path Options

Figure: A single folder for all created objects

04-17005-03-en, October 2015 System


1401
42 Mass Create Alarms and Trends
42.6 Mass Creating Alarms

42.6 Mass Creating Alarms


You mass create alarms to create identical alarms for different objects, instead of
creating the alarms one by one.
For more information, see section 42.1 Mass Create on page 1393.

To mass create alarms


1. In Workstation, in the List View, select the objects that you want to create
alarms for.

2. On the File menu, point to New and then click Alarm.


3. In the object type list, select the alarm type you want to create.

4. In the Prefix box, type a label that is added in front of the name of the alarms.
Continued on next page

System 04-17005-03-en, October 2015


1402
42 Mass Create Alarms and Trends
42.6 Mass Creating Alarms

5. In the Suffix box, type a label that is added after the name of the alarms.
6. In the Description box, type a description for the alarms.
7. In the Destination box, enter the destination where you want to create the
alarms. If you use A different folder, relative to the selected object,
this destination applies to the first object in the list, and its path will work as a
pattern for the relative path that is applied to all the remaining objects.

Note
If the specified relative path pattern leads to an unavailable position
for any of the objects in the list, Next and Create are disabled.

8. If you use A different folder, relative to the selected object, verify that
the additional two lines show the resulting relative path pattern that you intend,
and the way this pattern applies to an example object in the list.

9. Click Next.
See the alarm procedures for detailed information on how to create and set up your
specific alarm type:
For more information, see section 30.6 Creating a Multistate Alarm on page
716.
For more information, see section 30.12 Creating a Variable Status Alarm on
page 739.
For more information, see section 30.24 Creating an Enumeration Alarm on
page 789.
For more information, see section 30.9 Creating a Matching Text String Alarm
on page 728.
For more information, see section 30.15 Creating an Out of Range Alarm on
page 750.
For more information, see section 30.18 Creating an Out of Reference Range
Alarm on page 764.
For more information, see section 30.3 Creating a Change of State Alarm on
page 703.

04-17005-03-en, October 2015 System


1403
42 Mass Create Alarms and Trends
42.7 Mass Creating Alarms Using the Search Method

42.7 Mass Creating Alarms Using the Search


Method
You use the search tool to find objects or properties that have the name or other
property in common. You then mass create identical alarms for these objects
instead of creating the alarms one by one for each object or property.
For more information, see section 42.1 Mass Create on page 1393.

To mass create alarms using the search method


1. In WorkStation, in the Search box, type the name or the property that the
objects have in common.

2. Click the Search button .


3. In the Search view, select the objects or properties you want to create alarms
for.

4. On the File menu, point to New and then click Alarm.


Continued on next page

System 04-17005-03-en, October 2015


1404
42 Mass Create Alarms and Trends
42.7 Mass Creating Alarms Using the Search Method

5. In the object type list, select the alarm type you want to create.

6. In the Prefix box, type a label that is added in front of the name of the alarms.
7. In the Suffix box, type a label that is added after the name of the alarms.
8. In the Description box, type a description for the alarms.
9. In the Destination box, select the destination where you want to create the
alarms. If you use A different folder, relative to the selected object,
this destination applies to the first object in the list, and its path will work as a
pattern for the relative path that is applied to all the remaining objects.

Note
If the specified relative path pattern leads to an unavailable position
for any of the objects in the list, Next and Create are disabled.

10. If you use A different folder, relative to the selected object, verify that
the additional line shows the resulting relative path pattern that you intend, and
the way this pattern applies to an example object in the list.

11. Click Next.

04-17005-03-en, October 2015 System


1405
42 Mass Create Alarms and Trends
42.7 Mass Creating Alarms Using the Search Method

See the alarm procedures for detailed information on how to create and set up your
specific alarm type:
For more information, see section 30.6 Creating a Multistate Alarm on page
716.
For more information, see section 30.12 Creating a Variable Status Alarm on
page 739.
For more information, see section 30.24 Creating an Enumeration Alarm on
page 789.
For more information, see section 30.9 Creating a Matching Text String Alarm
on page 728.
For more information, see section 30.15 Creating an Out of Range Alarm on
page 750.
For more information, see section 30.18 Creating an Out of Reference Range
Alarm on page 764.
For more information, see section 30.3 Creating a Change of State Alarm on
page 703.

System 04-17005-03-en, October 2015


1406
42 Mass Create Alarms and Trends
42.8 Mass Creating Trend Logs

42.8 Mass Creating Trend Logs


You use the mass create feature to create identical trend logs for different objects,
instead of creating the trend logs one by one.
For more information, see section 42.1 Mass Create on page 1393.

To mass create trend logs


1. In Workstation, in the List View, select the objects that you want to create
trend logs for.

2. On the File menu, point to New and then click Trend.


3. In the object type list, select the trend log you want to create.

4. In the Prefix box, type a label that is added in front of the name of the trend
logs.
Continued on next page

04-17005-03-en, October 2015 System


1407
42 Mass Create Alarms and Trends
42.8 Mass Creating Trend Logs

5. In the Suffix box, type a label that is added after the name of the trend logs.
6. In the Description box, type a description for the trend logs.
7. In the Destination box, enter the destination where you want to create the
trend logs. If you use A different folder, relative to the selected object,
this destination applies to the first object in the list, and its path works as a
pattern for the relative path that is applied to all the remaining objects.

Note
If the specified relative path pattern leads to an unavailable position
for any of the objects in the list, Next and Create are disabled.

8. Click Next.
See the trend log procedures for detailed information on how to create and set up
your specific trend log type:
For more information, see section 37.4 Creating an Interval Trend Log on
page 1151.
For more information, see section 37.15 Creating a Change of Value Trend
Log on page 1192.
For more information, see section 37.10 Creating a Meter Trend Log on
page 1181.
For more information, see section 37.18 Creating a Variable Triggered Trend
Log on page 1201.

System 04-17005-03-en, October 2015


1408
42 Mass Create Alarms and Trends
42.9 Mass Creating Trend Logs Using the Search Method

42.9 Mass Creating Trend Logs Using the


Search Method
You use the search tool to find objects or properties that have the name or other
property in common. You then mass create identical trend logs for these objects
instead of creating the trend logs one by one for each object or property.
For more information, see section 42.1 Mass Create on page 1393.

To mass create trend logs using the search method


1. In WorkStation, in the Search box, type the name or the property that the
objects have in common.

2. Click the Search button .


3. In the Search view, select the objects or properties you want to create trend
logs for.

4. On the File menu, point to New and then click Trend.


Continued on next page

04-17005-03-en, October 2015 System


1409
42 Mass Create Alarms and Trends
42.9 Mass Creating Trend Logs Using the Search Method

5. In the object type list, select the trend log you want to create.

6. In the Prefix box, type a label that is added in front of the name of the trend
logs.
7. In the Suffix box, type a label that is added after the name of the trend logs.
8. In the Description box, type a description for the trend logs.
9. In the Destination box, enter the destination where you want to create the
trend logs. If you use A different folder, relative to the selected object,
this destination applies to the first object in the list, and its path works as a
pattern for the relative path that is applied to all the remaining objects.

Note
If the specified relative path pattern leads to an unavailable position
for any of the objects in the list, Next and Create are disabled.

10. Click Next.


See the trend log procedures for detailed information on how to create and set up
your specific trend log type:
For more information, see section 37.4 Creating an Interval Trend Log on
page 1151.
For more information, see section 37.15 Creating a Change of Value Trend
Log on page 1192.
For more information, see section 37.10 Creating a Meter Trend Log on
page 1181.
For more information, see section 37.18 Creating a Variable Triggered Trend
Log on page 1201.

System 04-17005-03-en, October 2015


1410
42 Mass Create Alarms and Trends
42.10 Mass Creating Extended Trend Logs

42.10 Mass Creating Extended Trend Logs


You use the mass create feature to create identical extended trend logs from trend
logs, instead of creating the extended trend logs one by one.
For more information, see section 42.1 Mass Create on page 1393.

To mass create extended trend logs


1. In Workstation, in the List View, select the trend logs that you want to create
extended trend logs for.

2. On the File menu, point to New and then click Extended Trend Log.
3. In the Prefix box, type a label that is added in front of the name of the
extended trend logs.

4. In the Suffix box, type a label that is added after the name of the extended
trend logs.
Continued on next page

04-17005-03-en, October 2015 System


1411
42 Mass Create Alarms and Trends
42.10 Mass Creating Extended Trend Logs

5. In the Description box, type a description for the extended trend logs.
6. In the Destination box, enter the destination where you want to create the
trend logs. If you use A different folder, relative to the selected object,
this destination applies to the first object in the list, and its path works as a
pattern for the relative path that is applied to all the remaining objects.

Note
If the specified relative path pattern leads to an unavailable position
for any of the objects in the list, Next and Create are disabled.

7. Click Next.
For more information, see section 38.5 Creating an Extended Trend Log on page
1226.

System 04-17005-03-en, October 2015


1412
42 Mass Create Alarms and Trends
42.11 Mass Creating Extended Trend Logs Using the Search Method

42.11 Mass Creating Extended Trend Logs


Using the Search Method
You use the search tool to find trend logs that have the name or other property in
common. You then mass create identical extended trend logs for these trend logs
instead of creating the extended trend logs one by one for each trend log.
For more information, see section 42.1 Mass Create on page 1393.

To mass create extended trend logs using the search method


1. In WorkStation, in the Search box, type the name or the property that the
trend logs have in common.

2. Click the Search button .


3. In the Search view, select the trend logs you want to create extended trend
logs for.

4. On the File menu, point to New and then click Extended Trend Log.
Continued on next page

04-17005-03-en, October 2015 System


1413
42 Mass Create Alarms and Trends
42.11 Mass Creating Extended Trend Logs Using the Search Method

5. In the Prefix box, type a label that is added in front of the name of the
extended trend logs.

6. In the Suffix box, type a label that is added after the name of the extended
trend logs.
7. In the Description box, type a description for the extended trend logs.
8. In the Destination box, enter the destination where you want to create the
trend logs. If you use A different folder, relative to the selected object,
this destination applies to the first object in the list, and its path works as a
pattern for the relative path that is applied to all the remaining objects.

Note
If the specified relative path pattern leads to an unavailable position
for any of the objects in the list, Next and Create are disabled.

9. Click Next.
For more information, see section 38.5 Creating an Extended Trend Log on page
1226.

System 04-17005-03-en, October 2015


1414
42 Mass Create Alarms and Trends
42.12 Mass Create Object Wizard Name Page

42.12 Mass Create Object Wizard Name


Page
Use the Choosing the type and naming the object page to name the mass-created
objects.

Figure: Naming the object page

Table: Naming the Object Page


Property Description

Object type list Select the type of object you want to mass
create. For more information, see section
51.1 Object Types on page 1677.

Prefix Type a label that is added in front of the


object name. For more information, see
section 42.4 Suffix and Prefix on page
1398.

Suffix Type a label that is added after the object


name. For more information, see section
42.4 Suffix and Prefix on page 1398.

Description Type a description that explains what the


object is used for.

Destination Select the destination folder option where


you want to create the objects. For more
information, see section 42.5 Mass Create
Path Options on page 1399.

04-17005-03-en, October 2015 System


1415
42 Mass Create Alarms and Trends
42.12 Mass Create Object Wizard Name Page

Continued
Property Description

Location Displays the folder where the alarms or


trends are created.
If you create alarms or trends in a different
path, relative to each selected object, you
can browse in a different location.
For more information, see section 42.5
Mass Create Path Options on page 1399.

System 04-17005-03-en, October 2015


1416
43 Schedules Introduction

Topics
Schedules Overview
Schedule Bindings
Configuring a Schedule as a Shadow
43 Schedules Introduction
43.1 Schedules Overview

43.1 Schedules Overview


A schedule is a sequence of events that determines when essential events occur in
a building automation system: doors locking or unlocking, temperature raised or
lowered, or equipment turned on or off.
For example, the lighting in an office building needs to be automated to conserve
energy during non-business hours. To regulate the lights from Monday through
Friday, you create a weekly schedule that turns the lights on at 07:00 and switches
them off at 20:00. If there are any non-routine events, such as holidays, you can use
exception events to override the schedule and turn the lights off. For more
information, see section 46.7 Exception Events in WorkStation on page 1467.

43.1.1 Schedule Editor Overview


You use the Schedule Editor to create and manage schedule events for digital,
multistate, and analog schedules. The schedule events that you create can be
weekly events or exception events. A weekly event recurs on a weekly basis. An
exception event defines either a one-time change or a recurring change that
overrides the standard weekly events. In the Schedule Editor, you can view the
schedule events in Basic view or Advanced view.
For more information, see section 44.1 Schedule Editor Overview on page 1425.

43.1.2 Priorities
Priority is a number that corresponds to a preassigned level of importance. When
used in schedules, priority numbers range from one to sixteen. One is the most
important or highest priority and sixteen is the lowest priority.
For more information, see section 44.5 Priorities on page 1430.

43.1.3 Schedule Types


You can create three types of schedules: Digital, Multistate, or Analog. You create a
digital schedule if the schedule needs to control a device with two output states,
such as On or Off. You create a multistate schedule if the schedule needs to control
a device that has output states based on multiple states, such as low, medium, or
high. You create an analog schedule if the schedule controls a device that gauges
the output in real numbers.
For more information, see section 45.1 Schedule Types on page 1445.

43.1.4 Schedule Events


A schedule can have two types of events: weekly events and exception
events. Weekly events occur every week at specified times. Exception events occur
when the schedule deviates from the weekly schedule, such as during
holidays. Exception events override the weekly events when there is an overlap.
For more information, see section 46.1 Schedule Events on page 1459.

04-17005-03-en, October 2015 System


1419
43 Schedules Introduction
43.1 Schedules Overview

43.1.5 Calendars in WorkStation


A calendar is a list of dates. The calendar provides the schedule with the dates
when the exception events shall occur. To save time, you can reference a single
calendar rather than entering several exception events in a schedule.
For more information, see section 47.2 Calendars in WorkStation on page 1508.

43.1.6 Schedule and Calendar Synchronization


When you configure a schedule that controls events in a single part of a building,
you might also want the same events to occur in other areas of the building. You
can establish a lead and shadow relationship to synchronize the events in
schedules and dates in calendars.
For more information, see section 47.13 Schedule and Calendar Synchronization
on page 1528.

43.1.7 Schedule Bindings


A binding is a connection between two or more variables for data exchange. In its
simplest form, a binding consists of a source and a destination. The destination
reads the value from the source.
For more information, see section 43.2 Schedule Bindings on page 1421.

System 04-17005-03-en, October 2015


1420
43 Schedules Introduction
43.2 Schedule Bindings

43.2 Schedule Bindings


A binding is a connection between two or more variables for data exchange. In its
simplest form, a binding consists of a source and a destination. The destination
reads the value from the source.

Figure: Binding diagram


In Building Operation, you typically bind source values to destination properties in
objects such as programs, alarms, trend logs, and graphics. These objects
frequently need to use values that exist somewhere else in the system.

43.2.1 Binding Examples


Bindings are used in schedules the same way that bindings are used throughout
the system. You bind a schedule to a point in order to control the value with the
schedule. The following examples demonstrate the different uses of schedules and
bindings.

Analog Schedule
You bind an analog schedule to an analog output, such as a thermostat setpoint.
When the schedule dictates a change in temperature, the system sends the output
information to the setpoint for the thermostat to act on. For more information, see
section 45.10 Binding an Analog Value to an Analog Schedule on page 1455.

Digital Schedule
You bind a digital schedule to a digital output, such as a light switch. The system
will switch the light on or off depending on the value set in the schedule. For more
information, see section 45.4 Binding a Digital Value to a Digital Schedule on page
1448.

Multistate Schedule
You bind a multistate schedule to a multistate output, such as an air handler. When
the schedule dictates a change in air flow, the system will send the output
information to the air handler depending on the value of the state set in the
schedule. For more information, see section 45.7 Binding a Multistate Value to a
Multistate Schedule on page 1452.

04-17005-03-en, October 2015 System


1421
43 Schedules Introduction
43.3 Configuring a Schedule as a Shadow

43.3 Configuring a Schedule as a Shadow


You configure a schedule as a shadow to synchronize it with a schedule that
already contains all weekly events and exception events.
For more information, see section 47.13 Schedule and Calendar Synchronization
on page 1528.

To configure a schedule as a shadow


1. In WorkStation, in the System Tree pane, select the schedule you want to
configure as a shadow.
2. On the File menu, click Properties.
3. In the Lead object box, enter the schedule that you want to synchronize the
shadow schedule with.

4. Click OK.

System 04-17005-03-en, October 2015


1422
44 Schedule Editor

Topics
Schedule Editor Overview
Basic View of the Schedule Editor
Advanced View of the Schedule Editor
Time Zones
Priorities
Editing an Event Priority
Configuring a Time Value Pair for a Schedule
Setting the Time Increments in the Server Time Bar
Modifying a Time Value Bar in the Graphic View
Modifying a Schedule Using the Text View
Modifying a Schedule Using the Graphic View
Schedule Colors in WorkStation
44 Schedule Editor
44.1 Schedule Editor Overview

44.1 Schedule Editor Overview


You use the Schedule Editor to create and manage schedule events for digital,
multistate, and analog schedules. The schedule events that you create can be
weekly events or exception events. A weekly event recurs on a weekly basis. An
exception event defines either a one-time change or a recurring change that
overrides the standard weekly events. In the Schedule Editor, you can view the
schedule events in Basic view or Advanced view.

44.1.1 Basic View of the Schedule Editor


The Basic view of the Schedule Editor serves as a workspace to plan and design a
schedule. You use this editor to create, manage, and display weekly scheduled
events and exception events.
For more information, see section 44.2 Basic View of the Schedule Editor on page
1426.

44.1.2 Advanced View of the Schedule Editor


The Advanced view of the Schedule Editor has the features of the Basic view with
some additional capabilities. All the tasks that you can perform in the Basic view,
you can also perform in the Advanced view.
For more information, see section 44.3 Advanced View of the Schedule Editor on
page 1427.

44.1.3 Schedule Colors


A schedule has a color code so you can identify weekly events and exception
events at a glance. This color code can assist you when you are modifying your
schedule or trying to troubleshoot any problems.
For more information, see section 44.12 Schedule Colors in WorkStation on page
1440.

04-17005-03-en, October 2015 System


1425
44 Schedule Editor
44.2 Basic View of the Schedule Editor

44.2 Basic View of the Schedule Editor


The Basic view of the Schedule Editor serves as a workspace to plan and design a
schedule. You use this editor to create, manage, and display weekly scheduled
events and exception events.
You can also display the client time zone and the server time zone in the Basic view.
This is convenient if your SmartStruxure server is located in a time zone that is
different from the time zone where you are configuring the schedule. For more
information, see section 44.4 Time Zones on page 1429.
The following figure displays the schedule of the lights within the building. The
weekly events are in green and the exception event in blue. The values of the events
are also displayed. Monday, October 21 is an exception event so it does not follow
the same scheduled events as the rest of the week. The lights are off all day. For the
rest of the week, the lights turn on at 07:00 and turn off at 18:00.

Figure: Basic view of the Schedule Editor

System 04-17005-03-en, October 2015


1426
44 Schedule Editor
44.3 Advanced View of the Schedule Editor

44.3 Advanced View of the Schedule Editor


The Advanced view of the Schedule Editor has the features of the Basic view with
some additional capabilities. All the tasks that you can perform in the Basic view,
you can also perform in the Advanced view.
Unlike the Basic view, the Advanced view lists the exception and weekly events in
an event tree. In addition, there is a Combined option that displays all the weekly
and exception events for a selected date.
Two toggles provide additional options:
Mode: Switches between an editor or preview mode.
View: Switches between a graphical or text view.

Figure: Advanced view of the Schedule Editor

44.3.1 Mode
The Mode toggle provides the following capabilities:
Editor mode where you can view or edit a weekly event or an exception event.
Preview mode where you can preview (but not edit) all the weekly schedules
and exceptions for a selected date. However, only the effective weekly and
exception events display for that date. Typically, you see one weekly and one
exception event.

44.3.2 View
The View toggle provides the following capabilities:
Graphic View where you can view or edit a weekly event or an exception
event. For more information, see section 44.11 Modifying a Schedule Using
the Graphic View on page 1439.

04-17005-03-en, October 2015 System


1427
44 Schedule Editor
44.3 Advanced View of the Schedule Editor

Text View where you can define specific time sequences or to break down a
time value into hundredths of a second. For more information, see section
44.10 Modifying a Schedule Using the Text View on page 1437.

Figure: Text View

44.3.3 Combined
You can view all of the events for a selected date using both the Combined option
and Preview mode. Events can include exception and weekly events, and the
Default value. You can toggle the combined events between the Graphic View or
Text View.

Figure: Combined Events in Graphic View


For more information, see section 48.4 Advanced Schedule Editor Toolbar on
page 1534.

System 04-17005-03-en, October 2015


1428
44 Schedule Editor
44.4 Time Zones

44.4 Time Zones


When you create a schedule, the time zone of the SmartStruxure server that
contains the schedule determines the execution of the events. If the schedule is
copied to a SmartStruxure server in a different time zone, the specified dates and
times relate to the new time zone.
For example, a schedule with an event defined to start at 08:00 Eastern Standard
Time in a device located in Boston is copied to a device in London. The event would
start at 08:00 Greenwich Mean Time.
When working within a schedule, you can display two different time zones. Building
Operation also displays the time differential for the second time zone. For example,
if you are working in Eastern Standard Time, the Greenwich Mean Time shows a +5
time differential.

04-17005-03-en, October 2015 System


1429
44 Schedule Editor
44.5 Priorities

44.5 Priorities
Priority is a number that corresponds to a preassigned level of importance. When
used in schedules, priority numbers range from one to sixteen. One is the most
important or highest priority and sixteen is the lowest priority.

44.5.1 Exception Events


An exception event occurs instead of the scheduled weekly events for a single date,
date range, calculated date, or calendar reference.
Exception events always take precedence over weekly events. When two exception
events overlap, priorities can determine which event takes precedence over the
other. Generally, priorities resolve the following conflicts:
Two events with different priorities occur on the same day and time. In this
case, the higher priority takes control of the schedule.
For example, a schedule that is set at priority 14 controls a fan in an office area
at low speed during normal business hours. A Special Meeting event
scheduled at 11:00 is set at priority 12 for medium speed. Therefore, the
schedule adjusts the fan from low to medium for the meeting and ignores the
priority 14 event until the priority 12 event ends.
Two events with the same priority level occur on the same day and time. In this
case, the position in the Event tree determines which priority takes control of
the schedule. The position depends on when exception event was created.
In the following example, two exception events are set at Priority 12. Winter
Break was created first followed by Scout Meeting. Therefore, Winter Break
takes precedence over Scout meeting because that event was created first.

In the Advanced Schedule Editor, an event tree lists the exception events in
separate folders according to priority level. For example, an exception event set at
priority 10 is contained in a Priority 10 folder. If no priority is specified, Building
Operation places the event in the default folder, Priority 16. No event folders display
in the event tree if all exception events use the default priority. For more information,
see section 44.3 Advanced View of the Schedule Editor on page 1427.
By default, all exception events are set at priority 16, but you can change priority
level. For more information, see section 44.6 Editing an Event Priority on page
1432.

System 04-17005-03-en, October 2015


1430
44 Schedule Editor
44.5 Priorities

Schedule Colors
A schedule has a color code so you can identify weekly events and exception
events at a glance. This color code can assist you when you are modifying your
schedule or trying to troubleshoot any problems.
For more information, see section 44.12 Schedule Colors in WorkStation on page
1440.

04-17005-03-en, October 2015 System


1431
44 Schedule Editor
44.6 Editing an Event Priority

44.6 Editing an Event Priority


You edit an event priority to change the exception event to a higher or lower priority.

To edit an event priority


1. In WorkStation, in the System Tree pane, right click the schedule you want
to edit and click Open.
2. In the Work area, click the Basic view of the Schedule editor.
3. In the Event grid, select the exception event you want to edit.

4. On the Basic toolbar, click the Edit schedule event button .


Continued on next page

System 04-17005-03-en, October 2015


1432
44 Schedule Editor
44.6 Editing an Event Priority

5. In the Priority box, enter the priority level for the event.

6. Click OK.

04-17005-03-en, October 2015 System


1433
44 Schedule Editor
44.7 Configuring a Time Value Pair for a Schedule

44.7 Configuring a Time Value Pair for a


Schedule
You configure a time value pair to modify weekly or exception events in a Building
Operation schedule or BACnet schedule.
For more information, see section 44.3 Advanced View of the Schedule Editor on
page 1427.

To configure a time value pair for a schedule


1. In WorkStation, in the System Tree pane, select the schedule that you want
to modify.
2. Click the Advanced tab of the editor.
3. Expand the Exceptions or Weekly folder.
4. Right click on the time period that you want to modify and click Properties.

5. Modify the properties.


Component Description

Value Select the value associated with the event.

Start Time Select the hour, minutes, and seconds for the start time.

No End Time Select to have the event last all day.

End Time Select the hour, minutes, and seconds for the end time.

6. Click OK.

System 04-17005-03-en, October 2015


1434
44 Schedule Editor
44.8 Setting the Time Increments in the Server Time Bar

44.8 Setting the Time Increments in the


Server Time Bar
You set the time increments in the Server Time bar to adjust the time value bars in
the Graphic View.
For more information, see section 44.3 Advanced View of the Schedule Editor on
page 1427.

To set the time increments in the Server Time bar


1. In WorkStation, in the System Tree pane, select the schedule you want to
edit.
2. In the Work area, click the Advanced tab.

3. Click the Edit Schedule button .

4. Click the Graphic View button .


5. Right click on the Server Time bar, point to Snap To and select a time
segment.

6. Click the Save button .


You can modify a time value bar using the selected time increment. For more
information, see section 44.9 Modifying a Time Value Bar in the Graphic View on
page 1436.

04-17005-03-en, October 2015 System


1435
44 Schedule Editor
44.9 Modifying a Time Value Bar in the Graphic View

44.9 Modifying a Time Value Bar in the


Graphic View
You modify a time value bar in the Graphic View to shorten or lengthen a time span.
The ToolTip displays the SmartStruxure server time intervals, such as 15 minutes.
For more information, see section 44.3 Advanced View of the Schedule Editor on
page 1427.

To modify a time value bar in the Graphic View


1. In WorkStation, in the System Tree pane, select the schedule you want to
edit.
2. In the Work area, click the Advanced tab.
3. Click on a time value pair and drag the bar by the handles at either end to
shorten or lengthen the time span.

4. Click the Save button .

System 04-17005-03-en, October 2015


1436
44 Schedule Editor
44.10 Modifying a Schedule Using the Text View

44.10 Modifying a Schedule Using the Text


View
Use the Text View of the Advanced Schedule editor to edit specific time sequences
and break down a time value into hundredths of a second.
For more information, see section 44.3 Advanced View of the Schedule Editor on
page 1427.

To modify a schedule using the Text View


1. Select a schedule in the System Tree pane.
2. Click the Advanced tab of the Schedule Editor.

3. In the Schedule Event Tree, complete one of the following tasks:


To modify an exception, expand the Exceptions folder and Priority x
folder. Then, select an exception.
To modify a day, expand the Weekly folder and select a day.

4. Click the Text View button .


5. Right-click on the time period that you want to modify and click Properties.
Continued on next page

04-17005-03-en, October 2015 System


1437
44 Schedule Editor
44.10 Modifying a Schedule Using the Text View

6. Edit the properties.


Component Description

Hour Enter the hour when you want the Object property reference
set to Value. Use the time format that matches your Windows
regional settings.
Select Any hour if you want the Object property reference
set to Value at all times.

Minute Enter a number to set the time for Value to be written to the
property reference.

Second Enter a number to set the time for Value to be written to the
property reference.

Hundredths Enter a number to set the time for Value to be written to the
property reference.

Value Enter a value to write to the property reference at the scheduled


time, such as True.

7. Click OK.

8. Click the Save button .

System 04-17005-03-en, October 2015


1438
44 Schedule Editor
44.11 Modifying a Schedule Using the Graphic View

44.11 Modifying a Schedule Using the Graphic


View
Use the Graphic View of the Advanced Schedule editor to edit the properties of an
exception or weekly event.
For more information, see section 44.3 Advanced View of the Schedule Editor on
page 1427.

To modify a schedule using the Graphic View


1. Select a schedule in the System Tree pane.
2. Click the Advanced tab of the Schedule Editor.

3. In the Schedule Event Tree, choose one of the following tasks:


To modify an exception, expand the Exceptions folder and Priority x
folder. Then, select an exception.
To modify a day, expand the Weekly folder and select a day.

4. Click the Graphic View button .


5. Right-click on the time period that you want to modify and click Properties.
6. Edit the properties.
Component Description

Value Select the value associated with the event.

Start Time Select the hour, minutes, and seconds for the start time.

No End Time Select to have the event last all day.

End Time Select the hour, minutes, and seconds for the end time.

7. Click OK.

8. Click the Save button .

04-17005-03-en, October 2015 System


1439
44 Schedule Editor
44.12 Schedule Colors in WorkStation

44.12 Schedule Colors in WorkStation


A schedule has a color code so you can identify weekly events and exception
events at a glance. This color code can assist you when you are modifying your
schedule or trying to troubleshoot any problems.

44.12.1 Basic Schedule View


In the Event grid, weekly events and exception events display in distinct colors to
clearly identify them. Similar events that are next to each other are highlighted in
different shades of the same color so you can easily see the start and stop time. For
example, a meeting scheduled from 7:00 to 11:00 is dark green while the weekday
event from 11:00 to 15:15 is in light green. In the Calendar view, you can view the
weekly events and exception events across several months and the selected day in
black.

Figure: Basic Schedule Editor colors

Table: Basic Schedule Editor Colors


Color Description

Cream Event grid: default value

Green Event grid: weekly events

Blue Event grid: exception events

Light blue Calendar view: exception events

Black Calendar view: selected day

Priority Level Conflicts


The Event grid also highlights a conflict in dark blue if there are two exception
events that overlap on the same day and have different values, but are set at the
same priority level.

System 04-17005-03-en, October 2015


1440
44 Schedule Editor
44.12 Schedule Colors in WorkStation

Figure: Priority level conflict


For more information, see section 44.5 Priorities on page 1430.

44.12.2 Advanced Schedule View


In the Event gride, weekly and exception events are both green in the Advanced
Schedule. Events that are next to each other in the schedule are presented in
different intensities of green so you can easily see the start and stop time of these
events. In the Calendar view, you can view the weekly events and exception events
across several months and the selected day in dark blue.

Figure: Advanced Schedule Editor colors

04-17005-03-en, October 2015 System


1441
44 Schedule Editor
44.12 Schedule Colors in WorkStation

Table: Advanced Schedule Editor Colors


Color Description

Cream Event grid: default value

Green Event grid: weekly events

Blue Event grid: exception events

Light blue Calendar view: exception events

Dark blue Calendar view: selected day

System 04-17005-03-en, October 2015


1442
45 Schedule Types

Topics
Schedule Types
Digital Schedules
Creating a Digital Schedule
Binding a Digital Value to a Digital Schedule
Multistate Schedules
Creating a Multistate Schedule
Binding a Multistate Value to a Multistate Schedule
Analog Schedules
Creating an Analog Schedule
Binding an Analog Value to an Analog Schedule
45 Schedule Types
45.1 Schedule Types

45.1 Schedule Types


You can create three types of schedules: Digital, Multistate, or Analog. You create a
digital schedule if the schedule needs to control a device with two output states,
such as On or Off. You create a multistate schedule if the schedule needs to control
a device that has output states based on multiple states, such as low, medium, or
high. You create an analog schedule if the schedule controls a device that gauges
the output in real numbers.
You create schedules using WorkStation.

45.1.1 Analog Schedules


An analog schedule controls a device that gauges the output in real numbers. The
real numbers include positive or negative numbers, fractions, and decimal values.
For more information, see section 45.8 Analog Schedules on page 1453.

45.1.2 Digital Schedules


A digital schedule controls a device that has an on output state and an off output
state.
For more information, see section 45.2 Digital Schedules on page 1446.

45.1.3 Multistate Schedules


A multistate schedule controls a device that has output states based on integers or
positive whole numbers including zero.
For more information, see section 45.5 Multistate Schedules on page 1450.

04-17005-03-en, October 2015 System


1445
45 Schedule Types
45.2 Digital Schedules

45.2 Digital Schedules


A digital schedule controls a device that has an on output state and an off output
state.
For example, you can create a digital weekly schedule that is bound to a digital
output, such as a light switch. To turn on the lights Monday through Friday from
08:00 to 17:00, you can set the value to On when the schedule is active and Off
when the schedule is inactive.

Figure: Digital Schedule

System 04-17005-03-en, October 2015


1446
45 Schedule Types
45.3 Creating a Digital Schedule

45.3 Creating a Digital Schedule


You create a digital schedule to control the state of a digital value.
For more information, see section 45.2 Digital Schedules on page 1446.

To create a digital schedule


1. In WorkStation, in the System Tree pane, select the SmartStruxure server or
the folder where you want to create the schedule.
2. On the File menu, point to New and then click Schedule.
3. In the object type list, select Digital Schedule.

4. In the Name box, type a name for the schedule.


5. In the Description box, type a description for the schedule.
6. Click Create.
Now you can add events to the digital schedule and bind it to a digital value.

04-17005-03-en, October 2015 System


1447
45 Schedule Types
45.4 Binding a Digital Value to a Digital Schedule

45.4 Binding a Digital Value to a Digital


Schedule
You bind a digital value to a digital schedule so the variable status follows the
scheduled times.
For more information, see section 43.2 Schedule Bindings on page 1421.

To bind a digital value to a digital schedule


1. In WorkStation, in the System Tree pane, select the variable or value that
contains the digital value.
2. On the Actions menu, click Edit bindings.
3. In the Browser pane, select the folder that contains the digital schedule.

4. Select the digital schedule that you want to bind to the digital value.
Continued on next page

System 04-17005-03-en, October 2015


1448
45 Schedule Types
45.4 Binding a Digital Value to a Digital Schedule

5. Drag the digital schedule to the Binding column for the digital value.

6. On the File menu, click Save.

04-17005-03-en, October 2015 System


1449
45 Schedule Types
45.5 Multistate Schedules

45.5 Multistate Schedules


A multistate schedule controls a device that has output states based on integers or
positive whole numbers including zero.
For example, you can create a multistate weekly schedule that is bound to a
multistate value to control an air handler unit in an office building. To regulate the air
circulation Monday through Friday from 08:00 to 17:00, you can set the value to 2
(occupied) when the schedule is active and 1 (unoccupied) when the schedule is
inactive.

Figure: Multistate Schedule

System 04-17005-03-en, October 2015


1450
45 Schedule Types
45.6 Creating a Multistate Schedule

45.6 Creating a Multistate Schedule


You create a multistate schedule to control the state of a multistate value.
For more information, see section 45.5 Multistate Schedules on page 1450.

To create a multistate schedule


1. In WorkStation, in the System Tree pane, select the SmartStruxure server or
the folder where you want to create the schedule.
2. On the File menu, point to New and then click Schedule.
3. In the object type list, select Multistate Schedule.

4. In the Name box, type a name for the schedule.


5. In the Description box, type a description for the schedule.
6. Click Create.
Now you can add events to the multistate schedule and bind it to a multistate value.

04-17005-03-en, October 2015 System


1451
45 Schedule Types
45.7 Binding a Multistate Value to a Multistate Schedule

45.7 Binding a Multistate Value to a


Multistate Schedule
You bind a multistate value to a multistate schedule so the variable status follows
the scheduled times.
For more information, see section 43.2 Schedule Bindings on page 1421.

To bind a multistate value to a multistate schedule


1. In WorkStation, in the System Tree pane, select the program or folder that
contains the multistate value.
2. On the Actions menu, click Edit Bindings.
3. In the Browser pane, select the folder that contains the multistate schedule.

4. Select the multistate schedule that you want to bind to the multistate value.
5. Drag the multistate schedule to the Binding column for the multistate value.

6. On the main toolbar, click the Save button .

System 04-17005-03-en, October 2015


1452
45 Schedule Types
45.8 Analog Schedules

45.8 Analog Schedules


An analog schedule controls a device that gauges the output in real numbers. The
real numbers include positive or negative numbers, fractions, and decimal values.
For example, you can create an analog schedule to regulate a thermostat setpoint
in an office area. To control the temperature from 08:00 to 17:00, you can set the
value to 22 C (70 F) when the schedule is active and 16 C (62 F) when the
schedule is inactive.

Figure: Analog Schedule

04-17005-03-en, October 2015 System


1453
45 Schedule Types
45.9 Creating an Analog Schedule

45.9 Creating an Analog Schedule


You create an analog schedule to control the state of an analog value.
For more information, see section 45.8 Analog Schedules on page 1453.

To create an analog schedule


1. In WorkStation, in the System Tree pane, select the SmartStruxure server or
the folder.
2. On the File menu, point to New and then click Schedule.
3. In the object type list, select Analog Schedule.

4. In the Name box, type a name for the schedule.


5. In the Description box, type a description for the schedule.
6. Click Create.
Now you can add events to the analog schedule and bind the schedule to an
analog value.

System 04-17005-03-en, October 2015


1454
45 Schedule Types
45.10 Binding an Analog Value to an Analog Schedule

45.10 Binding an Analog Value to an Analog


Schedule
You bind an analog value to an analog schedule so the variable status follows the
scheduled times.
For more information, see section 43.2 Schedule Bindings on page 1421.

To bind an analog value to an analog schedule


1. In WorkStation, in the System Tree pane, select the program or folder that
contains the analog value.
2. On the Actions menu, click Edit bindings.
3. In the Browser pane, select the folder that contains the analog schedule.

4. Select the analog schedule that you want to bind to the analog value.
5. Drag the analog schedule to the Binding column for the analog value.

6. On the main toolbar, click the Save button .

04-17005-03-en, October 2015 System


1455
46 Schedule Events

Topics
Schedule Events
Displaying Client Time and Server Time in a Schedule
Deleting a Date List Entry from a Calendar
Weekly Events in WorkStation
Adding a Weekly Event
Editing a Weekly Event
Exception Events in WorkStation
Adding a Date Exception Event
Editing a Date Exception Event
Adding a Date Range Exception Event
Editing a Date Range Exception Event
Adding a Calculated Exception Event
Editing a Calculated Exception Event
Adding a Calendar Exception Event
Editing a Calendar Exception Event
Deleting an Exception Event from a Schedule
Adding a Weekly Event to a Xenta Schedule
Editing a Weekly Event in a Xenta Schedule
Deleting a Weekly Event from a Xenta Schedule
Adding an Exception Event to a Xenta Schedule
Editing an Exception Event in a Xenta Schedule
Deleting an Exception Event from a Xenta Schedule
46 Schedule Events
46.1 Schedule Events

46.1 Schedule Events


A schedule can have two types of events: weekly events and exception
events. Weekly events occur every week at specified times. Exception events occur
when the schedule deviates from the weekly schedule, such as during
holidays. Exception events override the weekly events when there is an overlap.
For each schedule except Xenta schedules, you can set a default value. The default
value goes into effect after the exception events and weekly events are complete or
relinquish control. For example, the weekly event for a fan ends at 17:00. The fan
ran at a value of 3 (high) throughout the event. There are no scheduled events after
the weekly event. Because you have assigned 0 as the default value, the fan adjusts
to the default value and turns to 0 (off). The value remains at 0 until the next
scheduled event.
Events occur in the following order of precedence:
Exception events
Weekly events
Default value
Xenta schedules do not have any default values.
Example:
The weekly event for a fan is set to '08:00 - 17:00'. An exception event is set to
'17:00 - 20:00' for a specific date. The exception event overrides the weekly event
so that the fan only runs from 17:00 to 20:00 on the specified date.
Xenta schedule events occur in the following order of precedence:
Exception events
Weekly events

46.1.1 Weekly Events in WorkStation


A weekly event occurs every week for an extended period of time on a regular
basis. You can schedule more than one weekly event for each day of the week.
For more information, see section 46.4 Weekly Events in WorkStation on page
1463.

46.1.2 Weekly Events in WebStation


A weekly event occurs every week for an extended period of time on a regular
basis. You can schedule more than one weekly event for each day of the week.
For more information, see the Weekly Events in WebStation topic on WebHelp.

46.1.3 Exception Events in WorkStation


An exception event occurs instead of the scheduled weekly events for a single date,
date range, calculated date, or calendar reference.

04-17005-03-en, October 2015 System


1459
46 Schedule Events
46.1 Schedule Events

For more information, see section 46.7 Exception Events in WorkStation on page
1467.

46.1.4 Exception Events in WebStation


An exception event occurs instead of the scheduled weekly events for a single date,
date range, calculated date, or calendar reference.
For more information, see the Exception Events in WebStation topic on WebHelp.

46.1.5 Priorities
Priority is a number that corresponds to a preassigned level of importance. When
used in schedules, priority numbers range from one to sixteen. One is the most
important or highest priority and sixteen is the lowest priority.
For more information, see section 44.5 Priorities on page 1430.

46.1.6 Time Zones


When you create a schedule, the time zone of the SmartStruxure server that
contains the schedule determines the execution of the events. If the schedule is
copied to a SmartStruxure server in a different time zone, the specified dates and
times relate to the new time zone.
For more information, see section 44.4 Time Zones on page 1429.

System 04-17005-03-en, October 2015


1460
46 Schedule Events
46.2 Displaying Client Time and Server Time in a Schedule

46.2 Displaying Client Time and Server Time


in a Schedule
You display the client time and the SmartStruxure server time of a schedule to
compare the client time with the server time. Schedule times are set according to
the server time.

To display client time and server time in a schedule


1. In WorkStation, in the System Tree pane, select the schedule.
2. In the Work area, click the Basic view.
3. Right-click the Server Time bar.

4. Click Show client time zone.


5. Click Show client time zone again to display the server time zone only.

04-17005-03-en, October 2015 System


1461
46 Schedule Events
46.3 Deleting a Date List Entry from a Calendar

46.3 Deleting a Date List Entry from a


Calendar
You delete a date list entry from a calendar to remove the entry from a schedule.

To delete a date list entry from a calendar


1. In WorkStation, in the System Tree pane, select the calendar.
2. In the work area, click the Calendar Editor view.

3. In the Date List, select an entry.

4. On the Calendar Editor toolbar, click the Delete button .


Repeat the procedure to delete additional date list entries.

System 04-17005-03-en, October 2015


1462
46 Schedule Events
46.4 Weekly Events in WorkStation

46.4 Weekly Events in WorkStation


A weekly event occurs every week for an extended period of time on a regular
basis. You can schedule more than one weekly event for each day of the week.

Figure: Weekly events in a Building Operation schedule


If there are any non-routine events, such as holidays, you can use exception events
to override the schedule. For more information, see section 46.7 Exception Events
in WorkStation on page 1467.

04-17005-03-en, October 2015 System


1463
46 Schedule Events
46.5 Adding a Weekly Event

46.5 Adding a Weekly Event


You add weekly events to a schedule to determine when the event is to regularly
occur. Weekly events always occur regularly unless overridden by an exception
event.
For more information, see section 46.4 Weekly Events in WorkStation on page
1463.

To add a weekly event


1. In WorkStation, in the System Tree pane, select the schedule you want to
add the weekly event to.
2. Click the Basic tab.
3. On the Basic Schedule Editor toolbar, click the View weekly schedule

events button .
4. In the grid, click the start time. Drag the cursor vertically to select the end time
and then horizontally to select all days for which the event should be valid.

5. On the File menu, click Save.

System 04-17005-03-en, October 2015


1464
46 Schedule Events
46.6 Editing a Weekly Event

46.6 Editing a Weekly Event


You edit a weekly event to change the information about a weekly event on a single
day.

To edit a weekly event


1. In WorkStation, in the System Tree pane, select the schedule you want to
edit.
2. In the Work area, click the Basic view.
3. In the Event grid, select the weekly event you want to edit.

4. On the Basic toolbar, click the Edit schedule event button .


Continued on next page

04-17005-03-en, October 2015 System


1465
46 Schedule Events
46.6 Editing a Weekly Event

5. Edit the properties.

Component Description

Event type Click Weekly to select a weekly event


type.

Days of week Select the days of the week that apply to


this schedule.

All Day Select All Day for an all day event.

Click to add a line to the Times and


values box.

Click to delete an entry from the Times


and values box.

6. Click Ok.

System 04-17005-03-en, October 2015


1466
46 Schedule Events
46.7 Exception Events in WorkStation

46.7 Exception Events in WorkStation


An exception event occurs instead of the scheduled weekly events for a single date,
date range, calculated date, or calendar reference.
For example, you create an exception event in March for an intense aerobics class
in the gym to open an air vent to 100 % from 06:30 to 17:00 every Wednesday in
March. This exception event takes precedence over the regularly scheduled weekly
Wednesday events.
When scheduling exception events, you can use four exception types to provide
flexibility and control in your schedule.

46.7.1 Date Exception Events


A single date exception event can occur on a single day, or you can use the options
for the event to occur on more than one day. The options such as Any year and
Any day provide flexibility. To schedule a single date event to take place every year
on October 31, you select the following single date options:
Year: Any year
Month: October
Day of month: 31
Day of week: Any day

46.7.2 Date Range Exception Events


A date range exception event is an event that lasts over a period of time. In addition
to a specific day of month, you can select Odd, Even, or Any month, and Any
day or Last day, to provide the flexibility to a date range. For example, to schedule
an exception event to occur annually from the last day of March to the last day of
April, select the following options for the start and end dates:

Start Date
Start year: Any year
Start month: March
Day of month: Last day
Day of week: Any day

End Date
Year: Any year
Month: April
Day of month: Last day
Day of week: Any day

04-17005-03-en, October 2015 System


1467
46 Schedule Events
46.7 Exception Events in WorkStation

46.7.3 Calculated Exception Events


A calculated date is an exception event that recurs. Other than a specific month and
week, you can select Any month and Any week or Last week, to provide
flexibility to a calculated date. For example, to schedule the Monday of the first
week of every month for an exception event, select the following options:
Month: Any month
Week of month: First week
Day of week: Monday

46.7.4 Calendar Exception Events


A calendar reference allows you to apply an exception event for all dates specified
in the calendar. For example, to schedule exception events for all holidays on a
calendar, you select the calendar you want to reference and the schedule will follow
the holidays created in the calendar.

System 04-17005-03-en, October 2015


1468
46 Schedule Events
46.8 Adding a Date Exception Event

46.8 Adding a Date Exception Event


You add a single date exception event to make an exception for a specific day in
the schedule, such as 10 December, 2013.
For more information, see section 46.7 Exception Events in WorkStation on page
1467.

To add a date exception event


1. In WorkStation, in the System Tree pane, select the schedule you want to
add the single date exception event to.
2. Click the Basic tab.
3. On the Basic Schedule Editor toolbar, click the New schedule event

button .
4. Click Exception.

5. In the Exception type box, click Single date.


Continued on next page

04-17005-03-en, October 2015 System


1469
46 Schedule Events
46.8 Adding a Date Exception Event

6. Select All Day if the exception event is to be on or off all day.


7. In the Start Time column, type a start time for the exception event.
8. In the End Time column, type an end time for the exception event.
9. In the Value column, select a value for the exception event.
10. In the Name box, type a name for the exception event.
11. In the Priority box, select a priority for the exception event to make it override
conflicting events with lower priorities.
12. In the Year box, select the year for the single date.
13. In the Month box, select the month for the single date.
14. In the Day of month, select a day of month for the single date.
15. In the Day of week box, select a weekday for the single date.

16. Click OK.


17. On the File menu, click Save.

System 04-17005-03-en, October 2015


1470
46 Schedule Events
46.9 Editing a Date Exception Event

46.9 Editing a Date Exception Event


You edit a date exception event to change the information about an exception
event.

To edit a date exception event


1. In WorkStation, in the System Tree pane, select the schedule you want to
edit.
2. In the Work area, click the Basic view.
3. In the Event grid, select the date exception event you want to edit.

Continued on next page

04-17005-03-en, October 2015 System


1471
46 Schedule Events
46.9 Editing a Date Exception Event

4. On the Basic toolbar, click the Edit schedule event button .

Continued on next page

System 04-17005-03-en, October 2015


1472
46 Schedule Events
46.9 Editing a Date Exception Event

5. Edit the properties.


Component Description

Event type Click Exception to display the exception types.

Exception type Select Single date for the exception type to apply to the
schedule.

Click to add a line to the Times and values box.

Click to delete an entry from the Times and values box.

All Day Select All Day for an all day event.

Name Type a name for the exception event.

Priority Select a priority number between 1 (highest priority) and 16


(lowest priority).

Year Select a year. You can use Any year as a valid entry.

Month Select a month for the exception event or Odd month, Even
month, Any month.

Day of month Select a value for the day of the month. You can use Any Day
and Last Day as valid entries.

Day of week Select a day of the week. Setting the value to Any Day ensures
consistency with the rest of the date specification, this is the
recommended setting.

6. Click OK.

04-17005-03-en, October 2015 System


1473
46 Schedule Events
46.10 Adding a Date Range Exception Event

46.10 Adding a Date Range Exception Event


You create a date range exception to schedule a date range event that takes
precedence over a scheduled weekly event.

To add a date range exception event


1. In WorkStation, in the System Tree pane, select the schedule you want to
add the date range exception event to.
2. Click the Basic view.

3. On the Basic toolbar, click the New schedule event button .


4. Under Event type, click Exception.

5. Under Exception type, click Date range.


6. Select All Day to have the event last all day.
7. In the Value box, enter a value.
Continued on next page

System 04-17005-03-en, October 2015


1474
46 Schedule Events
46.10 Adding a Date Range Exception Event

8. In the Name box, type a name for the exception.


9. In the Priority box, select a priority.
10. In the Year box, select a year for the start date and the end date.
11. In the Month box, select a month for the start date and end date.
12. In the Day of month box, select a day of the month for the start date and
end date.
13. In the Day of week box, select a day of the week for the start date and end
date.
14. Click OK.

04-17005-03-en, October 2015 System


1475
46 Schedule Events
46.11 Editing a Date Range Exception Event

46.11 Editing a Date Range Exception Event


You edit a date range exception event to change the information about an
exception event.

To edit a date range exception event


1. In WorkStation, in the System Tree pane, select the schedule you want to
edit.
2. In the Work area, click the Basic view.
3. In the Event grid, select the date range exception event you want to edit.

Continued on next page

System 04-17005-03-en, October 2015


1476
46 Schedule Events
46.11 Editing a Date Range Exception Event

4. On the Basic toolbar, click the Edit schedule event button .

Continued on next page

04-17005-03-en, October 2015 System


1477
46 Schedule Events
46.11 Editing a Date Range Exception Event

5. Edit the properties.


Property Description

Event type Click Exception to display the exception types.

Exception type Select Date range for the exception to apply to the schedule.

Click to add a line to the Times and values box.

Click to delete an entry from the Times and values box.

All Day Select All Day for an all day event.

Name Type a name for the event.

Priority Select a priority number between 1 (highest priority) and 16


(lowest priority).

Year Select a year. You can use Any year as a valid entry.

Month Select a month for the exception event or Odd month, Even
month, Any month.

Day of month Select a value for the day of the month. You can use Any Day
and Last Day as valid entries.

Day of week Select a day of the week. Setting the value to Any Day ensures
consistency with the rest of the date specification, this is the
recommended setting.

6. Click OK.

System 04-17005-03-en, October 2015


1478
46 Schedule Events
46.12 Adding a Calculated Exception Event

46.12 Adding a Calculated Exception Event


You create a calculated exception to schedule a recurring event that takes
precedence over a scheduled weekly event.

To add a calculated exception event


1. In WorkStation, in the System Tree pane, select the schedule you want to
add the calculated exception event to.
2. Click the Basic tab.

3. On the Basic toolbar, click the New schedule event button .


4. Under Event type, click Exception.

5. Under Exception type, click Calculated.


6. Select All Day to have the event last all day.
7. In the Name box, type a name for the exception.
Continued on next page

04-17005-03-en, October 2015 System


1479
46 Schedule Events
46.12 Adding a Calculated Exception Event

8. In the Priority box, enter a priority.


9. In the Month box, select a month.
10. In the Week of month box, select a week of the month.
11. In the Day of week box, select a day of the week.
12. Click OK.

System 04-17005-03-en, October 2015


1480
46 Schedule Events
46.13 Editing a Calculated Exception Event

46.13 Editing a Calculated Exception Event


You edit a calculated exception event to change the information about an exception
event.

To edit a calculated exception event


1. In WorkStation, in the System Tree pane, select the schedule you want to
edit.
2. In the Work area, click the Basic view.

3. In the Event grid, select the calculated exception event you want to edit.
Continued on next page

04-17005-03-en, October 2015 System


1481
46 Schedule Events
46.13 Editing a Calculated Exception Event

4. On the Basic toolbar, click the Edit schedule event button .

Continued on next page

System 04-17005-03-en, October 2015


1482
46 Schedule Events
46.13 Editing a Calculated Exception Event

5. Edit the properties.


Property Description

Event type Click Exception to display the exception types.

Exception type Select Calculated for an exception type to apply the schedule.

Click to add a line to the Times and values box.

Click to delete an entry from the Times and values box.

All Day Select All Day for an all day event.

Name Type a name for the event.

Priority Select a priority number between 1 (highest priority) and 16


(lowest priority).

Year Select a year. You can use Any year as a valid entry.

Month Select a month for the exception event or Odd month, Even
month, Any month.

Week of month Select a week of the month for the exception event or First
week, Second week, Third week, Fourth week, Last
week, Any week.
First week the first through the seventh day of the
month. The second week is then considered day of month
eight through fourteen and so on. Since the dates do not
necessarily correspond to the first row of the calendar, they
may include dates from both the first and second row of the
calendar.
Fifth week days 29 through 31 if they exist. It is always
less than seven days and is non-existent in February except
in a leap year.
Last week the last seven days of the month. It differs
from the Fifth week.

Day of week Select a day of the week. Setting the value to Any Day ensures
consistency with the rest of the date specification, this is the
recommended setting.

6. Click OK.

04-17005-03-en, October 2015 System


1483
46 Schedule Events
46.14 Adding a Calendar Exception Event

46.14 Adding a Calendar Exception Event


You add a calendar to the schedule to make an exception event for all dates
specified in the calendar.
For more information, see section 47.2 Calendars in WorkStation on page 1508.

To add a calendar exception event


1. In WorkStation, in the System Tree pane, select the schedule you want to
add the calendar to.
2. Click the Basic tab.
3. On the Basic Schedule Editor toolbar, click the New schedule event

button .
4. Click Exception.

5. Click Calendar.
6. Select All Day if the exception event is to be on or off all day.
Continued on next page

System 04-17005-03-en, October 2015


1484
46 Schedule Events
46.14 Adding a Calendar Exception Event

7. In the Start Time column, type a start time for the exception event.
8. In the End Time column, type an end time for the exception event.
9. In the Value column, select a value for the exception event.
10. In the Name box, type a name for the exception event.
11. In the Priority box, select a priority for the exception event to make it override
conflicting events with lower priorities.
12. In the Calendar box, enter the calendar that you want to add.

13. Click OK.


14. On the File menu, click Save.

Note
You cannot specify different times and values for each of the different dates.
All dates specified in the calendar must have the same times and values
assigned to them.

04-17005-03-en, October 2015 System


1485
46 Schedule Events
46.15 Editing a Calendar Exception Event

46.15 Editing a Calendar Exception Event


You edit a calendar exception event to change the information about an exception
event.

To edit a calendar exception event


1. In WorkStation, in the System Tree pane, select the schedule you want to
edit.
2. In the Work area, click the Basic view.
3. In the Event grid, select the calendar exception event you want to edit.

4. On the Basic toolbar, click the Edit schedule event button .


Continued on next page

System 04-17005-03-en, October 2015


1486
46 Schedule Events
46.15 Editing a Calendar Exception Event

5. Edit the properties.

Property Description

Event type Click Exception to display the exception types.

Exception type Select Calendar to initiate a calendar reference.

All Day Select All Day for an all day event.

Click to add a line to the Times and values box.

Click to delete an entry from the Times and values box.

Name Type a name for the event.

Priority Select a priority number between 1 (highest priority) and 16


(lowest priority).

Calendar Select a calendar to reference.

04-17005-03-en, October 2015 System


1487
46 Schedule Events
46.16 Deleting an Exception Event from a Schedule

46.16 Deleting an Exception Event from a


Schedule
You delete an exception event from a schedule when the exception is no longer
valid.

To delete an exception event from a schedule


1. In WorkStation, in the System Tree pane, select the schedule that you want
to modify.
2. Click the Advanced tab of the Schedule Editor.
3. In the Schedule Event Tree, expand the Exceptions folder.

4. Select the event and click the Delete button .

System 04-17005-03-en, October 2015


1488
46 Schedule Events
46.17 Adding a Weekly Event to a Xenta Schedule

46.17 Adding a Weekly Event to a Xenta


Schedule
You add weekly events to a Xenta schedule to determine when the event is to
regularly occur. Weekly events always occur regularly unless overridden by an
exception event.

Important
You cannot add, edit, or delete schedule events in a Xenta Schedule in
WorkStation when a Xenta Central schedule has been assigned to it.
The number of events a Xenta Central schedule can have is determined by the
Menta application.

For more information, see the Schedules for Xenta LonWorks Devices topic on
WebHelp.

To add a weekly event to a Xenta schedule


1. In WorkStation, in the System Tree pane, select the schedule to which you
want to add the weekly event.
Continued on next page

04-17005-03-en, October 2015 System


1489
46 Schedule Events
46.17 Adding a Weekly Event to a Xenta Schedule

2. In the Xenta Schedule editor, click the New button for a weekly event.

Continued on next page

System 04-17005-03-en, October 2015


1490
46 Schedule Events
46.17 Adding a Weekly Event to a Xenta Schedule

3. In the Time interval box, select the time range for the weekly event.

4. In the Start time box, enter the time when the weekly event starts.
5. In the End time box, enter the time when the weekly event ends.
6. Select the weekdays the weekly event is to be in service.
7. Click OK.

04-17005-03-en, October 2015 System


1491
46 Schedule Events
46.18 Editing a Weekly Event in a Xenta Schedule

46.18 Editing a Weekly Event in a Xenta


Schedule
You edit a weekly event to change the time range, start and stop time, or weekdays
of the weekly event.

Important
You cannot add, edit, or delete schedule events in a Xenta Schedule in
WorkStation when a Xenta Central schedule has been assigned to it.
The number of events a Xenta Central schedule can have is determined by the
Menta application.

For more information, see the Schedules for Xenta LonWorks Devices topic on
WebHelp.

To edit a weekly event in a Xenta schedule


1. In WorkStation, in the System Tree pane, select the schedule containing the
weekly event you want to edit.
Continued on next page

System 04-17005-03-en, October 2015


1492
46 Schedule Events
46.18 Editing a Weekly Event in a Xenta Schedule

2. In the Xenta Schedule editor, in the weekly event table, select the event and

click the Edit button .

Continued on next page

04-17005-03-en, October 2015 System


1493
46 Schedule Events
46.18 Editing a Weekly Event in a Xenta Schedule

3. In the Time interval box, select the time range the weekly event is to be in
service.

4. In the Start time box, enter the time when the weekly event starts.
5. In the End time box, enter the time when the weekly event ends.
6. Select the weekdays the weekly event starts.
7. Click OK.

System 04-17005-03-en, October 2015


1494
46 Schedule Events
46.19 Deleting a Weekly Event from a Xenta Schedule

46.19 Deleting a Weekly Event from a Xenta


Schedule
You delete a weekly event when the event is no longer to regularly occur.

Important
You cannot add, edit, or delete schedule events in a Xenta Schedule in
WorkStation when a Xenta Central schedule has been assigned to it.
The number of events a Xenta Central schedule can have is determined by the
Menta application.

For more information, see the Schedules for Xenta LonWorks Devices topic on
WebHelp.

To delete a weekly event from a Xenta schedule


1. In WorkStation, in the System Tree pane, select the schedule containing the
weekly event you want to delete.
2. In the Xenta Schedule editor, in the weekly event table, select the event and

click the Delete button .

04-17005-03-en, October 2015 System


1495
46 Schedule Events
46.20 Adding an Exception Event to a Xenta Schedule

46.20 Adding an Exception Event to a Xenta


Schedule
You add an exception event to configure an exception that is to apply instead of a
scheduled weekly event for a single date, date range, or a time pair.

Important
You cannot add, edit, or delete schedule events in a Xenta Schedule in
WorkStation when a Xenta Central schedule has been assigned to it.
The number of events a Xenta Central schedule can have is determined by the
Menta application.

Important
An added exception event overrides any weekly events for all of the selected
days.

For more information, see the Schedules for Xenta LonWorks Devices topic on
WebHelp.

To add an exception event to a Xenta schedule


1. In WorkStation, in the System Tree pane, select the schedule to which you
want to add the exception event.
Continued on next page

System 04-17005-03-en, October 2015


1496
46 Schedule Events
46.20 Adding an Exception Event to a Xenta Schedule

2. In the Xenta Schedule editor, click the New button for an exception
event.

Continued on next page

04-17005-03-en, October 2015 System


1497
46 Schedule Events
46.20 Adding an Exception Event to a Xenta Schedule

3. In the Time span box, select the time range the exception event is to be in
service.

4. In the Start date box, enter the date when the exception event starts.
5. In the End date box, enter the date when the exception event ends.
6. In the Start time box, enter the time when the exception event starts.
7. In the End time box, enter the time when the exception event ends.
8. Select the weekdays the exception event is to be in service.
9. Click OK.

System 04-17005-03-en, October 2015


1498
46 Schedule Events
46.21 Editing an Exception Event in a Xenta Schedule

46.21 Editing an Exception Event in a Xenta


Schedule
You edit an exception event to change the time range, start and stop date, start and
stop time, or weekdays of an exception event.

Important
You cannot add, edit, or delete schedule events in a Xenta Schedule in
WorkStation when a Xenta Central schedule has been assigned to it.
The number of events a Xenta Central schedule can have is determined by the
Menta application.

For more information, see the Schedules for Xenta LonWorks Devices topic on
WebHelp.

To edit an exception event in a Xenta schedule


1. In WorkStation, in the System Tree pane, select the schedule containing the
exception event you want to edit.
Continued on next page

04-17005-03-en, October 2015 System


1499
46 Schedule Events
46.21 Editing an Exception Event in a Xenta Schedule

2. In the Xenta Schedule editor, in the exception event table, select the event and

click the Edit button .

Continued on next page

System 04-17005-03-en, October 2015


1500
46 Schedule Events
46.21 Editing an Exception Event in a Xenta Schedule

3. In the Time span box, select the time range the exception event is to be in
service.

4. In the Start date box, enter the date when the exception event starts.
5. In the End date box, enter the date when the exception event ends.
6. In the Start time box, enter the time when the exception starts.
7. In the End time box, enter the time when the exception ends.
8. Select the weekdays the exception event starts.
9. Click OK.

04-17005-03-en, October 2015 System


1501
46 Schedule Events
46.22 Deleting an Exception Event from a Xenta Schedule

46.22 Deleting an Exception Event from a


Xenta Schedule
You delete an exception event when you no longer need the exception to make an
exception from a weekly event.

Important
You cannot add, edit, or delete schedule events in a Xenta Schedule in
WorkStation when a Xenta Central schedule has been assigned to it.
The number of events a Xenta Central schedule can have is determined by the
Menta application.

For more information, see the Schedules for Xenta LonWorks Devices topic on
WebHelp.

To delete an exception event from a Xenta schedule


1. In WorkStation, in the System Tree pane, select the schedule containing the
exception event you want to delete.
Continued on next page

System 04-17005-03-en, October 2015


1502
46 Schedule Events
46.22 Deleting an Exception Event from a Xenta Schedule

2. In the Xenta Schedule editor, in the exception event table, select the event and

click the Delete button .

04-17005-03-en, October 2015 System


1503
47 Calendars

Topics
Calendar Editor Overview
Calendars in WorkStation
Calendar Events
Creating a Calendar
Adding a Date Calendar Event
Adding a Date Range Calendar Event
Adding a Calculated Date Calendar Event
Configuring a Calendar as a Shadow
Storing Expired Calendar Events
Editing a Date Calendar Event
Editing a Date Range Calendar Event
Editing a Calculated Date Calendar Event
Schedule and Calendar Synchronization
47 Calendars
47.1 Calendar Editor Overview

47.1 Calendar Editor Overview


The Calendar Editor is the editor you use to create a date list of exception events.
The date list can include a single date, a date range, or a recurring date. You use
the calendar when creating a schedule that uses a Calendar Reference Exception.
You can apply one calendar to many schedules.
The following figure displays the calendar with all of the exception events in blue.
The exception events are also in a list view.

Figure: Calendar Editor Overview

04-17005-03-en, October 2015 System


1507
47 Calendars
47.2 Calendars in WorkStation

47.2 Calendars in WorkStation


A calendar is a list of dates. The calendar provides the schedule with the dates
when the exception events shall occur. To save time, you can reference a single
calendar rather than entering several exception events in a schedule.

Figure: Exception events in a calendar


Many schedules can make a reference to the calendar. You can define the group of
dates once rather than over and over again in multiple schedules, a potentially
tedious task if your building control system contains many schedules.

47.2.1 Calendar Editor Overview


You use the Calendar Editor to create a calendar that contains a date list of
exception events. The exception events can be a single date, a date range, or a
recurring date. By using a calendar, you specify all the exception events only one
time, rather than in each schedule. The calendar is then referenced to each of the
schedules and all exception dates are automatically designated in the schedules.
For more information, see section 47.1 Calendar Editor Overview on page 1507.

47.2.2 Calendar Events


The dates specified in a calendar are shown in the date list. You can specify dates
in a calendar by three different methods:
Date: a specific date

System 04-17005-03-en, October 2015


1508
47 Calendars
47.2 Calendars in WorkStation

Date range: a fixed period with a set start and stop date
Calculated date: a fixed period that repeats
For more information, see section 47.3 Calendar Events on page 1510.

04-17005-03-en, October 2015 System


1509
47 Calendars
47.3 Calendar Events

47.3 Calendar Events


The dates specified in a calendar are shown in the date list. You can specify dates
in a calendar by three different methods:
Date: a specific date
Date range: a fixed period with a set start and stop date
Calculated date: a fixed period that repeats

47.3.1 Date Calendar Events


A single date within a calendar is an entry that occurs once or every year on the
same date.
The following single date entry choices schedule an event on a single date, January
1, 2009:
Year - 2009
Month - January
Day of month - 1
Day of week - Any day
The following single date entry choices schedule an event on a single date every
year, January 1:
Year - Any Year
Month - January
Day of month - 1
Day of week - Any day
The following choices produce an error message:
A day, month, and year combination that does not coincide
An example is Friday, March 5, 2009. This date actually falls on a Thursday.
Any years past 2105
An explicit day that is out of range
An example is September 31 or February 29 in a non-leap year.

47.3.2 Date Range Calendar Events


You can include a date range in the date list. A date range is a series of days to
include in a calendar. An example of a date range is January 1, 2009 to January 31,
2009, which adds the entire month of January to the calendar as an event. You can
use this date range for a device, such as a thermostat, to behave differently for the
whole month of January.

System 04-17005-03-en, October 2015


1510
47 Calendars
47.3 Calendar Events

47.3.3 Calculated Calendar Events


You can include a calculated date on a date list. A calculated date has no set start
and stop date. For example, you use a calculated date to schedule the first week of
the even months on a Friday.

04-17005-03-en, October 2015 System


1511
47 Calendars
47.4 Creating a Calendar

47.4 Creating a Calendar


You create a calendar to specify exception dates, date ranges, or calculated dates.
Then you only reference the calendar to the each of the schedules. This way you
specify all the exception dates only one time.
For more information, see section 47.2 Calendars in WorkStation on page 1508.

To create a calendar
1. In WorkStation, in the System Tree pane, select the folder or SmartStruxure
server where you want to create the calendar.
2. On the File menu, point to New and then click Schedule.
3. In the object type list, select Calendar.

4. In the Name box, type a name for the calendar.


Continued on next page

System 04-17005-03-en, October 2015


1512
47 Calendars
47.4 Creating a Calendar

5. In the Description box, type a description for the calendar.

6. Click Create.
Now you can add dates, date ranges, or calculated dates to the calendar.

04-17005-03-en, October 2015 System


1513
47 Calendars
47.5 Adding a Date Calendar Event

47.5 Adding a Date Calendar Event


You add a date to a calendar to specify an exception date for a specific day, such
as 7 May, 2013.
For more information, see section 47.3 Calendar Events on page 1510.

To add a date calendar event


1. In WorkStation, in the System Tree pane, select the calendar you want to
add the exception to.
2. Click the Calendar Editor tab.

3. On the Calendar Editor toolbar, click the Add Date button .


4. In the Entry name box, type the name that you want to display on the date
list.

5. In the Year box, select the year for the date.


6. In the Month box, select the month for the date.
7. In the Day of month box, select the day for the date.
Continued on next page

System 04-17005-03-en, October 2015


1514
47 Calendars
47.5 Adding a Date Calendar Event

8. In the Day of week box, select the weekday for the date.

9. Click OK.
10. On the File menu, click Save.

04-17005-03-en, October 2015 System


1515
47 Calendars
47.6 Adding a Date Range Calendar Event

47.6 Adding a Date Range Calendar Event


You add a date range to a calendar to specify two or more consecutive days with a
specific start and end date, such as 19 March to 23 March, 2013.
For more information, see section 47.3 Calendar Events on page 1510.

To add a date range calendar event


1. In WorkStation, in the System Tree pane, select the calendar you want to
add the exception to.
2. Click the Calendar Editor tab.

3. On the Calendar Editor toolbar, click the Add Date Range button .
4. In the Entry name box, type the name that you want to display on the date
list.

5. In the Start year box, select the year for the start date.
6. In the Start month box, select the month for the start date.
7. In the Day of month box, select the day for the start date.
8. In the Day of week box, select the weekday for the start date.
9. In the Year box, select the year for the end date.
10. In the Month box, select the month for the end date.
11. In the Day of month box, select the day for the end date.
Continued on next page

System 04-17005-03-en, October 2015


1516
47 Calendars
47.6 Adding a Date Range Calendar Event

12. In the Day of week box, select the weekday for the end date.

13. Click OK.


14. On the File menu, click Save.

04-17005-03-en, October 2015 System


1517
47 Calendars
47.7 Adding a Calculated Date Calendar Event

47.7 Adding a Calculated Date Calendar


Event
You add a calculated date to specify a recurring event, such as Friday of the first
week of even months. Calculated dates are also used for events or holidays that do
not always fall on the same date each year.
For more information, see section 47.3 Calendar Events on page 1510.

To add a calculated date calendar event


1. In WorkStation, in the System Tree pane, select the calendar that you want
to add the exception dates to.
2. Click the Calendar Editor tab.

3. On the Calendar Editor toolbar, click the Add Calculated button .


4. In the Entry name box, type the name that you want to display on the date
list.

5. In the Month box, select a month for the calculated date.


6. In the Week of month box, select the week of month for the calculated date.
Continued on next page

System 04-17005-03-en, October 2015


1518
47 Calendars
47.7 Adding a Calculated Date Calendar Event

7. In the Day of week box, select a weekday for the calculated date.

8. Click OK.
9. On the File menu, click Save.

04-17005-03-en, October 2015 System


1519
47 Calendars
47.8 Configuring a Calendar as a Shadow

47.8 Configuring a Calendar as a Shadow


You configure a calendar as a shadow to synchronize it with a calendar that already
contains all exception dates, date ranges, or calculated dates, such as a holiday
calendar.

Note
Schedules cannot refer to a calendar located on another SmartStruxure
server. You need to create shadow calendars in all SmartStruxure servers
that contain schedules that are to refer to the calendar.

For more information, see section 47.13 Schedule and Calendar Synchronization
on page 1528.

To configure a calendar as a shadow


1. In WorkStation, in the System Tree pane, select the calendar you want to
configure as a shadow.
2. On the File menu, click Properties.
3. In the Lead object box, enter the calendar that you want to synchronize the
shadow calendar with.

4. Click OK.

System 04-17005-03-en, October 2015


1520
47 Calendars
47.9 Storing Expired Calendar Events

47.9 Storing Expired Calendar Events


You store expired events to keep an expired calendar event for future reference.

To store expired calendar events


1. In WorkStation, in the System Tree pane, select the calendar with the events
that you want to store.
2. In the File menu, click Properties.
3. In the Remove past events box, select False to keep all events. Selecting
True will remove events that are older than 60 days.

4. Click the Save button .

04-17005-03-en, October 2015 System


1521
47 Calendars
47.10 Editing a Date Calendar Event

47.10 Editing a Date Calendar Event


You edit a date calendar to change the information about a calendar event.

To edit a date calendar event


1. In WorkStation, in the System Tree pane, select the calendar you want to
edit.
2. Click the Calendar Editor tab.

3. In the date list, right-click the date calendar event you want to edit and click
Properties.
Continued on next page

System 04-17005-03-en, October 2015


1522
47 Calendars
47.10 Editing a Date Calendar Event

4. Edit the properties.

Component Description

Entry name Type an entry name for the calendar entry.

Year Select a year. You can use Any year as a valid entry.

Month Select a month for the exception event or Odd month, Even
month, Any month.

Day of month Select a value for the day of the month. You can use Any
Day and Last Day as valid entries.

Day of week Select a day of the week. Setting the value to Any Day
ensures consistency with the rest of the date specification,
this is the recommended setting.

5. Click OK.

04-17005-03-en, October 2015 System


1523
47 Calendars
47.11 Editing a Date Range Calendar Event

47.11 Editing a Date Range Calendar Event


You edit a date range calendar to change the information about a calendar event.

To edit a date range calendar event


1. In WorkStation, in the System Tree pane, select the calendar you want to
edit.
2. In Calendar Editor, select the date range calendar.

3. Right-click the date range calendar.


Continued on next page

System 04-17005-03-en, October 2015


1524
47 Calendars
47.11 Editing a Date Range Calendar Event

4. Edit the properties.

Component Description

Entry name Type an entry name for the calendar entry.

Start year Select a year. You can use Any year as a valid entry.

Start month Select a month for the exception event or Odd month, Even
month, Any month.

Day of month Select a value for the day of the month. You can use Any
Day and Last Day as valid entries.

Day of week Select a day of the week. Setting the value to Any Day
ensures consistency with the rest of the date specification,
this is the recommended setting.

Year Select a year. You can use Any year as a valid entry.

Month Select a month for the exception event or Odd month, Even
month, Any month.

5. Click OK.

04-17005-03-en, October 2015 System


1525
47 Calendars
47.12 Editing a Calculated Date Calendar Event

47.12 Editing a Calculated Date Calendar


Event
You edit a calculated date calendar to change the information about a calendar
event.

To edit a calculated date calendar event


1. In WorkStation, in the System Tree pane, select the calendar you want to
edit.
2. In Calendar Editor, select the calculated date calendar.

3. Right-click the calculated date calendar.


Continued on next page

System 04-17005-03-en, October 2015


1526
47 Calendars
47.12 Editing a Calculated Date Calendar Event

4. Edit the properties.

Component Description

Entry name Type an entry name for the calendar entry.

Month Select a month for the exception event or Odd month, Even
month, Any month.

Week of month Select a week of the month for the exception event or First
week, Second week, Third week, Fourth week, Last
week, Any week.
First week the first through the seventh day of the
month. Be aware that it does not necessarily correspond
to the first row of the calendar since it may include dates
from both the first and second row of the calendar.
Fifth week days 29 through 31 if they exist. It is
always less than seven days and is non-existent in
February except in a leap year.
Last week the last seven days of the month. It differs
from the Fifth week.

Day of week Select a day of the week. Setting the value to Any Day
ensures consistency with the rest of the date specification,
this is the recommended setting.

5. Click OK.

04-17005-03-en, October 2015 System


1527
47 Calendars
47.13 Schedule and Calendar Synchronization

47.13 Schedule and Calendar Synchronization


When you configure a schedule that controls events in a single part of a building,
you might also want the same events to occur in other areas of the building. You
can establish a lead and shadow relationship to synchronize the events in
schedules and dates in calendars.
For example, the building might require the same heating and lighting events on all
floors. Schedule A controls the events on the first floor, Schedule B on the second
floor, and Schedule C on the third floor. Using lead and shadow schedules, you can
configure one lead schedule, Schedule A, and reference it throughout the building
from Schedules B and C, the shadow schedules. When you create the shadow
schedule, you need to create the same schedule type as the lead schedule. For
example, if you want to create a shadow schedule and the lead schedule type is an
analog schedule, you need to create an analog shadow schedule.

Figure: Lead and shadow schedules


You use a lead schedule somewhat like a template. To change a property within the
shadow schedules, you make the change within the lead schedule. The changes
are then reflected in all of the shadow schedules. Only certain properties of the lead
schedule, however, are copied into the shadow schedule depending on the
property type. Some properties in a lead schedule, such as name and description,
are unique to the lead schedule and are not duplicated in the shadow schedule.
Other properties that are not specific to the lead schedule, such as effective period,
are always duplicated in the shadow schedule. These principles apply to lead
calendars and shadow calendars as well.
Building Operation supports lead and shadow schedules where exception events,
weekly events, and other configuration properties are duplicated in the shadow
schedules.
Building Operation also supports lead and shadow calendars where the date list is
duplicated in the shadow calendars.

System 04-17005-03-en, October 2015


1528
48 Schedules User Interface

Topics
Schedule Editor Basic View
Basic Schedule Editor Toolbar
Advanced Schedule Editor Graphic View
Advanced Schedule Editor Toolbar
Edit Effective Period Dialog Box
Edit Exception Dialog Box
Edit Time Value Period Dialog Box
Snap To Menu
Show Client Time Zone
Schedule Properties Basic Tab
Schedule Event Properties Dialog Box Weekly View
Schedule Event Properties Dialog Box Single Date
Exception View
Schedule Event Properties Dialog Box Date Range
Exception View
Schedule Event Properties Dialog Box Calculated
Exception View
Schedule Event Properties Dialog Box Calendar
Reference View
Calendar Editor View
Calendar Editor Toolbar
Calendar Properties Basic Tab
Edit Calendar Entry Dialog Box Add Date
Edit Calendar Entry Dialog Box Date Range
Edit Calendar Entry Dialog Box Calculated Date
Xenta Schedule Editor
Certificates Tab
Xenta Schedule Dialog Box
48 Schedules User Interface
48.1 Schedule Editor Basic View

48.1 Schedule Editor Basic View


Use the Basic view to create weekly and exception events for a schedule.

Figure: Basic Schedule Editor

Table: Basic Schedule Editor


Number Description

Calendar view
Displays the calendar with exception events in blue.

Schedule Events toggle


Displays either the combined (Weekly and Exception) events view or Weekly
events view.

Basic View toolbar


Displays the toolbar to manage schedules.

Event grid
Displays weekly and exception events in Graphic view.
An Unable to display events error message displays when there is any
scheduled event (weekly or exception) less than 5 minutes in length on a
particular day. To view or change this scheduled event, use the Text view
in the Advanced Tab. For more information, see section 44.10 Modifying a
Schedule Using the Text View on page 1437.

04-17005-03-en, October 2015 System


1531
48 Schedules User Interface
48.2 Basic Schedule Editor Toolbar

48.2 Basic Schedule Editor Toolbar


Use the Basic Schedule Editor toolbar to manage schedules.

Table: Basic Schedule Editor Toolbar


Button Description

New schedule event


Click to create a new schedule event.

Edit schedule events


Click to edit a selected event.

Delete
Click to delete events in the schedule.

View all schedule events


Click to display weekly and exception events for the selected week.

View weekly schedule events


Click to display weekly events.

System 04-17005-03-en, October 2015


1532
48 Schedules User Interface
48.3 Advanced Schedule Editor Graphic View

48.3 Advanced Schedule Editor Graphic


View
Use the Graphic view to graphically display the scheduled events.

Figure: Advanced Schedule Editor Graphic View

Table: Advanced Schedule Editor Graphic View


Number Description

Advanced view toolbar


Click the buttons to manage schedules. For more information, see section
48.4 Advanced Schedule Editor Toolbar on page 1534.

Schedule event tree


Displays weekly and exception events.

Client and server time bar


Displays the client time and the SmartStruxure server time.

Time value periods


Displays the beginning and end times and the values associated with the
scheduled events.

Calendar overview
Displays in blue the dates that contain exception events.

04-17005-03-en, October 2015 System


1533
48 Schedules User Interface
48.4 Advanced Schedule Editor Toolbar

48.4 Advanced Schedule Editor Toolbar


Use the Advanced Schedule Editor toolbar to manage schedules.

Table: Advanced Schedule Editor Toolbar


Icon Description

Edit Schedule
Click to enter edit mode.

Preview Events
Click to display all the configured events for a selected day.

Add Special Event


Click to insert exception events into a schedule.

Delete
Click to delete events in the schedule.

Graphic View
Click to configure events in graphic mode.

Text View
Click to configure events in the textual mode.

System 04-17005-03-en, October 2015


1534
48 Schedules User Interface
48.5 Edit Effective Period Dialog Box

48.5 Edit Effective Period Dialog Box


Use the Edit Effective Period dialog box to select the start and end dates of the
effective period, or to leave the default values so the schedule is always within the
effective period.

Figure: Edit Effective Period dialog box

Table: Edit Effective Period Dialog Box


Component Description

Start year Select the year that the effective period begins.

Start month Select the month that the effective period begins.

Day of month Select a value for the day of the month. You can use Any Day and Last
Day as valid entries.

Day of week Select a day of the week. Setting the value to Any Day ensures
consistency with the rest of the date specification, this is the
recommended setting.

Year Select a year. You can use Any year as a valid entry.

Month Select a month for the exception event or Odd month, Even month,
Any month.

04-17005-03-en, October 2015 System


1535
48 Schedules User Interface
48.6 Edit Exception Dialog Box

48.6 Edit Exception Dialog Box


Use the Edit Exception dialog box to add or edit an exception event in the
Advanced Schedule Editor.

Figure: Edit Exception dialog box

Table: Edit Exception Dialog Box


Component Description

Exception name Type a name for the exception event.

Exception Select a priority for the exception event. Valid values are from 1-16, 1
priority being the highest priority.

Period type Select a time category to associate with the schedule event.

Period object Enter the event associated with the period type.

System 04-17005-03-en, October 2015


1536
48 Schedules User Interface
48.7 Edit Time Value Period Dialog Box

48.7 Edit Time Value Period Dialog Box


Use the Edit Time Value Period dialog box to modify weekly or exception events
in the Advanced Schedule Editor.

Figure: Edit Time Value Period dialog box

Table: Edit Time Value Period Dialog Box


Component Description

Value Select the value associated with the event.

Start Time Select the hour, minutes, and seconds for the start time.

No End Time Select to have the event last all day.

End Time Select the hour, minutes, and seconds for the end time.

04-17005-03-en, October 2015 System


1537
48 Schedules User Interface
48.8 Snap To Menu

48.8 Snap To Menu


Use the Snap To menu to select the time increments to display in the Advanced
Schedule Editor when dragging a time value bar from the start to end time. The
default time increment is 15 minutes.

Figure: Snap To menu

System 04-17005-03-en, October 2015


1538
48 Schedules User Interface
48.9 Show Client Time Zone

48.9 Show Client Time Zone


Use Show client time zone to toggle between displaying the client time zone in
addition to the SmartStruxure server time zone in the Advanced Schedule Editor.

Figure: Show Client Time Zone

04-17005-03-en, October 2015 System


1539
48 Schedules User Interface
48.10 Schedule Properties Basic Tab

48.10 Schedule Properties Basic Tab


Use the Basic tab to display general and status information about the schedule. On
this tab, you can reference a lead schedule so you can reuse the events configured
in the lead schedule in several shadow schedules.

Figure: Basic tab

Table: Basic Tab


Component Description

Value Select the value associated with the event.

Previous transition time Displays the date and time the value most
recently changed.

Time since previous transition (min) Displays the amount of time in minutes that
has elapsed since the value last changed,
rounded to the next minute.

Next transition value Displays what the Value property will be


when it next changes.

Next transition time Displays the date and time the value will
change.

System 04-17005-03-en, October 2015


1540
48 Schedules User Interface
48.10 Schedule Properties Basic Tab

Continued
Component Description

Time to next transition (min) Displays the amount of time in minutes


before the value changes.

Following transition value Displays the subsequent value following the


next transition value.

Following transition time Displays the subsequent date and time


following the next transition time.

Time to following transition (min) Displays the amount of time in minutes


before the value changes to the following
transition value.

Remove past events Select True to enable the system to delete


events older than 72 hours.

Effective period Enter the range of time a schedule is in


service.

Default value Select the value of the schedule when there


are no events in effect.

Lead object Select a lead schedule to reference.

04-17005-03-en, October 2015 System


1541
48 Schedules User Interface
48.11 Schedule Event Properties Dialog Box Weekly View

48.11 Schedule Event Properties Dialog Box


Weekly View
Use the Weekly View in the Schedule Event Properties dialog box in the
Basic Schedule Editor to create a new weekly event for an existing schedule.

Figure: Schedule Event Properties dialog box - weekly view

Table: Schedule Event Properties Dialog Box Weekly View


Component Description

Event type Click Weekly to select a weekly event type.

Days of week Select the days of the week that apply to this
schedule.

Click to add a line to the Times and values


box.

Click to delete an entry from the Times and


values box.

System 04-17005-03-en, October 2015


1542
48 Schedules User Interface
48.11 Schedule Event Properties Dialog Box Weekly View

Continued
Component Description

All day Select All Day for an all day event.

04-17005-03-en, October 2015 System


1543
48 Schedules User Interface
48.12 Schedule Event Properties Dialog Box Single Date Exception View

48.12 Schedule Event Properties Dialog Box


Single Date Exception View
Use the Single Date Exception view in the Schedule Event Properties
dialog box to schedule a single date exception.

Figure: Schedule Event Properties dialog box - Single date exception view

Table: Schedule Event Properties Dialog Box Single Date Exception View
Component Description

Event type Click Exception to display the exception


types.

Exception type Select Single date for the exception type to


apply to the schedule.

Click to add a line to the Times and values


box.

System 04-17005-03-en, October 2015


1544
48 Schedules User Interface
48.12 Schedule Event Properties Dialog Box Single Date Exception View

Continued
Component Description

Click to delete an entry from the Times and


values box.

All Day Select All Day for an all day event.

Name Type a name for the exception event.

Priority Select a priority number between 1 (highest


priority) and 16 (lowest priority).

Year Select a year. You can use Any year as a


valid entry.

Month Select a month for the exception event or


Odd month, Even month, Any month.

Day of month Select a value for the day of the month. You
can use Any Day and Last Day as valid
entries.

Day of week Select a day of the week. Setting the value to


Any Day ensures consistency with the rest
of the date specification, this is the
recommended setting.

04-17005-03-en, October 2015 System


1545
48 Schedules User Interface
48.13 Schedule Event Properties Dialog Box Date Range Exception View

48.13 Schedule Event Properties Dialog Box


Date Range Exception View
Use the Date Range Exception view in the Schedule Event Properties
dialog box to schedule a date range exception.

Figure: Schedule Event Properties dialog box - Date range exception view

Table: Schedule Event Properties Dialog Box Date Range Exception View
Component Description

Event type Click Exception to display the exception


types.

Exception type Select Date range as an exception type to


apply to the schedule.

Click to add a line to the Times and values


box.

System 04-17005-03-en, October 2015


1546
48 Schedules User Interface
48.13 Schedule Event Properties Dialog Box Date Range Exception View

Continued
Component Description

Click to delete an entry from the Times and


values box.

All Day Select All Day for an all day event.

Name Type a name for the event.

Priority Select a priority number between 1 (highest


priority) and 16 (lowest priority).

Year Select a year. You can use Any year as a


valid entry.

Month Select a month for the exception event or


Odd month, Even month, Any month.

Day of month Select a value for the day of the month. You
can use Any Day and Last Day as valid
entries.

Day of week Select a day of the week. Setting the value to


Any Day ensures consistency with the rest
of the date specification, this is the
recommended setting.

04-17005-03-en, October 2015 System


1547
48 Schedules User Interface
48.14 Schedule Event Properties Dialog Box Calculated Exception View

48.14 Schedule Event Properties Dialog Box


Calculated Exception View
Use the Calculated Exception view in the Schedule Event Properties dialog
box to schedule recurring exceptions.

Figure: Schedule Event Properties dialog box - Calculated exception view

Table: Schedule Event Properties Dialog Box Calculated Exception View


Component Description

Event type Click Exception to display the exception


types.

Exception type Select Calculated for an exception type to


apply to the schedule.

Click to add a line to the Times and values


box.

System 04-17005-03-en, October 2015


1548
48 Schedules User Interface
48.14 Schedule Event Properties Dialog Box Calculated Exception View

Continued
Component Description

Click to delete an entry from the Times and


values box.

All Day Select All Day for an all day event.

Name Type a name for the event.

Priority Select a priority number between 1 (highest


priority) and 16 (lowest priority).

Year Displays Any Year which is the default for


the calculated exception view.

Month Select a month for the exception event or


Odd month, Even month, Any month.

Week of month Select a week of the month for the exception


event or First week, Second week,
Third week, Fourth week, Last week,
Any week.
First week the first through the
seventh day of the month. The second
week is then considered day of month
eight through fourteen and so on. Since
the dates do not necessarily
correspond to the first row of the
calendar, they may include dates from
both the first and second row of the
calendar.
Fifth week days 29 through 31 if
they exist. It is always less than seven
days and is non-existent in February
except in a leap year.
Last week the last seven days of the
month. It differs from the Fifth week.

Week of month Select a week of the month for the exception


event or First week, Second week,
Third week, Fourth week, Last week,
Any week.
First week the first through the
seventh day of the month. Be aware
that it does not necessarily correspond
to the first row of the calendar since it
may include dates from both the first
and second row of the calendar.
Fifth week days 29 through 31 if
they exist. It is always less than seven
days and is non-existent in February
except in a leap year.
Last week the last seven days of the
month. It differs from the Fifth week.

04-17005-03-en, October 2015 System


1549
48 Schedules User Interface
48.14 Schedule Event Properties Dialog Box Calculated Exception View

Continued
Component Description

Day of week Select a day of the week. Setting the value to


Any Day ensures consistency with the rest
of the date specification, this is the
recommended setting.

System 04-17005-03-en, October 2015


1550
48 Schedules User Interface
48.15 Schedule Event Properties Dialog Box Calendar Reference View

48.15 Schedule Event Properties Dialog Box


Calendar Reference View
Use the Calendar Reference view in the Schedule Event Properties dialog
box to reference a calendar to apply to your schedule.

Figure: Schedule Event Properties dialog box - Calendar reference view

Table: Schedule Event Properties Dialog Box Calendar Reference View


Component Description

Event type Click Exception to display the exception


types.

Exception type Select Calendar to initiate a calendar


reference.

Click to add a line to the Times and values


box.

04-17005-03-en, October 2015 System


1551
48 Schedules User Interface
48.15 Schedule Event Properties Dialog Box Calendar Reference View

Continued
Component Description

Click to delete an entry from the Times and


values box.

All Day Select All Day for an all day event.

Name Type a name for the event.

Priority Select a priority number between 1 (highest


priority) and 16 (lowest priority).

Calendar Select a calendar to reference.

System 04-17005-03-en, October 2015


1552
48 Schedules User Interface
48.16 Calendar Editor View

48.16 Calendar Editor View


Use the Calendar Editor view to manage the calendar events for the calendar.

Figure: Calendar Editor view

Table: Calendar Editor View


Number Description

Click to expand the list of calendar events that are included in the calendar.
For more information, see section 47.3 Calendar Events on page 1510.

Use the Calendar Editor toolbar to add and delete calendar events. For more
information, see section 48.17 Calendar Editor Toolbar on page 1554.

Select the year you want the calendar to display.

Click to scroll the calendar one month at the time.

Displays the calendar for the selected twelve-month period with the dates for
the calendar events shown in blue. For more information, see section 47.1
Calendar Editor Overview on page 1507.

04-17005-03-en, October 2015 System


1553
48 Schedules User Interface
48.17 Calendar Editor Toolbar

48.17 Calendar Editor Toolbar


Use the Calendar Editor toolbar to manage calendars.

Table: Calendar Editor Toolbar


Button Description

Add Date
Click to add an event that occurs on a single day. For more information, see
section 48.19 Edit Calendar Entry Dialog Box Add Date on page 1556.

Add Date Range


Click to add an event that contains a date range. For more information, see
section 48.20 Edit Calendar Entry Dialog Box Date Range on page
1557.

Add Calculated Date


Click to add an event that recurs on a regular basis. For more information,
see section 48.21 Edit Calendar Entry Dialog Box Calculated Date on
page 1558.

Delete
Click to delete events in the schedule.

System 04-17005-03-en, October 2015


1554
48 Schedules User Interface
48.18 Calendar Properties Basic Tab

48.18 Calendar Properties Basic Tab


Use the Basic tab to display general and status information about the calendar. On
this tab, you can reference a lead calendar so you can reuse the events configured
in the lead calendar in several shadow calendars.

Figure: Basic tab

Table: Basic Tab


Component Description

Value Displays True when the current date


matches the date specified in the calendar
entry in the Date List.

Remove past events Select True if you want to remove calendar


entries that are older than 60 days.

Lead object Select a lead calendar if you are creating a


shadow calendar.

04-17005-03-en, October 2015 System


1555
48 Schedules User Interface
48.19 Edit Calendar Entry Dialog Box Add Date

48.19 Edit Calendar Entry Dialog Box Add


Date
Use the Edit Calendar Entry dialog box to configure a calendar entry for a single
date exception event.

Figure: Edit Calendar Entry dialog box - add date

Table: Edit Calendar Entry Dialog Box Add Date


Component Description

Entry name Type an entry name for the calendar entry.

Year Select a Year for the date calendar entry. You can also use Any Year
as a valid entry.

Month Select a month for the exception event or Odd month, Even month,
Any month.

Day of month Select a value for the day of the month. You can use Any Day and
Last Day as valid entries.

Day of week Select a day of the week. Setting the value to Any Day ensures
consistency with the rest of the date specification, this is the
recommended setting.

System 04-17005-03-en, October 2015


1556
48 Schedules User Interface
48.20 Edit Calendar Entry Dialog Box Date Range

48.20 Edit Calendar Entry Dialog Box Date


Range
Use the Edit Calendar Entry dialog box to configure a date range calendar entry
for an exception event.

Figure: Edit Calendar Entry dialog box - date range

Table: Edit Calendar Entry Dialog Box Date Range


Component Description

Entry name Type an entry name for the calendar entry.

Start year Select a year. You can use Any year as a valid entry.

Start month Select a month for the exception event or Odd month, Even month,
Any month.

Day of month Select a value for the day of the month. You can use Any Day and
Last Day as valid entries.

Day of week Select a day of the week. Setting the value to Any Day ensures
consistency with the rest of the date specification, this is the
recommended setting.

Year Select a year. You can use Any year as a valid entry.

Month Select a month for the exception event or Odd month, Even month,
Any month.

04-17005-03-en, October 2015 System


1557
48 Schedules User Interface
48.21 Edit Calendar Entry Dialog Box Calculated Date

48.21 Edit Calendar Entry Dialog Box


Calculated Date
Use the Edit Calendar Entry dialog box to create a calendar entry for a recurring
exception event.

Figure: Edit Calendar Entry dialog box - calculated date

Table: Edit Calendar Entry Dialog Box Calculated Date


Component Description

Entry name Type an entry name for the calendar entry.

Month Select a month for the exception event or Odd month, Even month,
Any month.

Week of month Select a week of the month for the exception event or First week,
Second week, Third week, Fourth week, Last week, Any
week.
First week the first through the seventh day of the month. Be
aware that it does not necessarily correspond to the first row of
the calendar since it may include dates from both the first and
second row of the calendar.
Fifth week days 29 through 31 if they exist. It is always less
than seven days and is non-existent in February except in a leap
year.
Last week the last seven days of the month. It differs from the
Fifth week.

Day of week Select a day of the week. Setting the value to Any Day ensures
consistency with the rest of the date specification, this is the
recommended setting.

System 04-17005-03-en, October 2015


1558
48 Schedules User Interface
48.22 Xenta Schedule Editor

48.22 Xenta Schedule Editor


Use the Xenta Schedule Editor to view and configure weekly events and exception
events for a Xenta schedule.

Figure: Xenta Schedule editor

Table: Xenta Schedule Editor


Number Description

Weekly (Maximum) Displays the maximum number of weekly


events the schedule can have. For more
information, see the Number of Scheduled
Events for Xenta LonWorks Devices topic on
WebHelp.

Central weekly schedule/Central Enter a central weekly or exception schedule


exceptions schedule/Lead central reference, or enter a lead Xenta Central
schedule Schedule reference in a Xenta Central
schedule.

Lead central schedule Enter a lead Xenta Central Schedule


reference.

04-17005-03-en, October 2015 System


1559
48 Schedules User Interface
48.22 Xenta Schedule Editor

Continued
Number Description

New
Click to open the Xenta Schedule dialog box,
where you can add an event. For more
information, see section 48.24 Xenta
Schedule Dialog Box on page 1562.

Edit
Click to open the Xenta Schedule dialog box,
where you can edit an event. For more
information, see section 48.24 Xenta
Schedule Dialog Box on page 1562.

Delete
Click to delete a selected event.

Weekly event table Displays the weekly events for the Xenta
schedule or Xenta Central schedule.

Exceptions (Maximum) Displays the maximum number of


exceptions events the schedule can have.
For more information, see the Number of
Scheduled Events for Xenta LonWorks
Devices topic on WebHelp.

New
Click to open the Xenta Schedule dialog box,
where you can add an event. For more
information, see section 48.24 Xenta
Schedule Dialog Box on page 1562.

Edit
Click to open the Xenta Schedule dialog box,
where you can edit an event. For more
information, see section 48.24 Xenta
Schedule Dialog Box on page 1562.

Delete
Click to delete a selected event.

Exceptions event table Displays the exception events for the Xenta
schedule.

System 04-17005-03-en, October 2015


1560
48 Schedules User Interface
48.23 Certificates Tab

48.23 Certificates Tab


Use the Certificates tab to manage certificates.

Figure: Certificates tab

Table: Certificates Tab


Property Description

Server Select the server.

DNS/IP Address Displays the servers DNS or IP address.

Active Certificate Displays the servers active certificate.

Server Displays the name and location of the


selected server.

Address Displays the DNS address or the IP address


to the selected server.

Certificate list Displays available certificates for the


selected servers.

Manage Certificate Click to open the Manage Certificates


dialog box. For more information, see the
Manage Certificates Dialog Box topic on
WebHelp.

04-17005-03-en, October 2015 System


1561
48 Schedules User Interface
48.24 Xenta Schedule Dialog Box

48.24 Xenta Schedule Dialog Box


Use the Xenta Schedule dialog box to edit the exception start and stop date, time
interval, and weekday of a weekly or exception event.

Figure: Xenta Schedule dialog box

Table: Xenta Schedule Editor


Preperty Description

[Time span/On all day/Off all day menu] Click to select the time range the schedule
should be in service, or select On all day or
Off all day.

Start date/Stop date Enter the date range when the schedule
should be in service.

Start time/Stop time Enter the time range when the schedule
should be in service.

Result Displays the result of the selected time


range.

[List of weekdays] Select the weekdays the schedule should be


in service.

System 04-17005-03-en, October 2015


1562
49 WorkStation

Topics
WorkStation
System Tree Pane
List View
Control Panel
Opening Control Panel
Quick Filter
Hyperlinks
Creating a Hyperlink
Utilities
49 WorkStation
49.1 WorkStation

49.1 WorkStation
WorkStation is the interface where you supervise your Building Operation system. In
WorkStation you can also create, modify, and delete some of the objects that are
used to build a Building Operation system.

Important
Ensure that you have a working and available WorkStation license. A working
license is required to log on to WorkStation. For more information, see section
10.6 Licenses on page 217.

Figure: WorkStation and SmartStruxure server

49.1.1 Flexible Workspace


In WorkStation, you can optimize the workspace for every user. For example in a
big building complex, the janitor of Building A might only see Building A and the
associated alarms and trend logs, not the whole complex.
On the other hand, the administrators workspace lets them supervise all buildings in
the complex, their alarms and trend logs on the site.

04-17005-03-en, October 2015 System


1565
49 WorkStation
49.1 WorkStation

Figure: Different workspaces in WorkStation

49.1.2 User rights


The user rights in WorkStation are used to control what every user might do in the
system. Some users can view a trend log but not change the presentation. Others
users can change everything in a trend log, including values, and even create a new
trend log.

System 04-17005-03-en, October 2015


1566
49 WorkStation
49.2 System Tree Pane

49.2 System Tree Pane


The System Tree pane displays the tree structure of the system, depending upon
user rights or configuration. In System Tree pane you can view, create, delete,
copy, rename, and move objects. The System Tree pane can be collapsed and/or
filtered.

Figure: System Tree Pane in WorkStation

Filter in the System Tree Pane


You can choose to show or hide the presentation objects using the filter in the
System Tree pane.
The following objects are categorized as presentation objects:
Folders
Graphics
Panels
Trend Log Lists
Trend Charts
Schedules
Calendars
Alarm viewers
Event viewers
Saved Searches
SmartStruxure servers
Networks
Field Devices
Reports
All other objects are non-presentation objects.

04-17005-03-en, October 2015 System


1567
49 WorkStation
49.3 List View

49.3 List View


You can use the List View to navigate the system. You can also rename, copy,
and paste objects in the List View. Using the Quick filter, you can easily filter objects
in the list.
The List View is displayed in the work area in WorkStation.

Figure: The List View of a folder


The List View reflects the content and properties of the selected object. Therefore,
the List View looks different and contains different tabs depending on the object. In
the List View, you can see the total number of items in the selected object. A filter
icon is displayed when a filter is active.

Figure: The List View of an Enterprise Server object


You can group and sort the objects in the List View using the Group and sort
function. You can add or remove columns in the List View.

System 04-17005-03-en, October 2015


1568
49 WorkStation
49.4 Control Panel

49.4 Control Panel


The Control Panel gives you easy access to some of the common functions in
Building Operation.
To get back to the Control Panel when you have entered any of the functions, click

the Back button on the navigation toolbar.

Figure: Control Panel

04-17005-03-en, October 2015 System


1569
49 WorkStation
49.5 Opening Control Panel

49.5 Opening Control Panel


You use Control Panel to get easy access to some of the most used functions in
Building Operation.
For more information, see section 49.4 Control Panel on page 1569.

To open Control Panel


1. In WorkStation, on the Tools menu, click Control Panel.

System 04-17005-03-en, October 2015


1570
49 WorkStation
49.6 Quick Filter

49.6 Quick Filter


You use Quick filter to filter out the objects by their names from the list. You can
either type the name in the Quick filter box or drag an item from a column in the
Alarms pane, the Events pane, an Alarm view, or an Event view and drop it in the
Quick filter box.
For example, if you want to find all objects that are named temperature, just type
temp in the Quick filter box and only objects named temperature are displayed in
the list.

Figure: Filtering on characters in all visible columns


The Quick filter filters on everything that is visible in the columns in the List View. For
example, if you filter on 2 you do not get any hits. But if you add the columns Note
1 and value you get hits on the temperature, which is 21, the setpoint which is 20,
and the Note that the program controlling the fan is a model 22.

04-17005-03-en, October 2015 System


1571
49 WorkStation
49.6 Quick Filter

Figure: Quick filter filters on all visible columns in the view


Quick filter is used in the following components in WorkStation:
List View
Alarms pane
Alarm Views
Events pane
Event Views
Alarm or Event details views
Watch pane
Watch Views
Add/Remove columns dialog box
Create object wizard

System 04-17005-03-en, October 2015


1572
49 WorkStation
49.6 Quick Filter

Figure: The Quick filter is used in many components, such as the List View (upper right),
the Watch pane (bottom left), and the Add/Remove dialog box (center right).

04-17005-03-en, October 2015 System


1573
49 WorkStation
49.7 Hyperlinks

49.7 Hyperlinks
Building Operation supports hyperlinks. Hyperlinks can be added and displayed in
WorkStation. Hyperlinks can also be added in, for example, a graphic that is
displayed in WorkStation. In WorkStation, you can navigate on the web page in
same way as in a web browser.
Building Operation uses Microsoft Internet Explorer to present web pages. Plug-ins,
for example Flash and Java, have to be installed to be able to correctly display
pages that use these plug-ins.

Figure: Building Operation supports hyperlinks

System 04-17005-03-en, October 2015


1574
49 WorkStation
49.8 Creating a Hyperlink

49.8 Creating a Hyperlink


You create a hyperlink in WorkStation to get easy access to important information
on the Internet.
For more information, see section 49.7 Hyperlinks on page 1574.

To create a hyperlink
1. In WorkStation, in the System Tree pane, select the SmartStruxure server or
folder where you want to create the hyperlink.
2. On the File menu, point to New and then click Hyperlink.
3. In the Name box, type a name for the hyperlink.

4. In the Description box, type a description for the hyperlink.


5. Click Next.
6. In the URL box, type the URL for the hyperlink.

Important
You have to include http:// or https:// in the URL.

Continued on next page

04-17005-03-en, October 2015 System


1575
49 WorkStation
49.8 Creating a Hyperlink

7. Click Create.

System 04-17005-03-en, October 2015


1576
49 WorkStation
49.9 Utilities

49.9 Utilities
Building Operation is equipped with two types of utilities, Signal Generators and
Simple Math Operators. The utilities are used for testing, for example, trend logs
and alarms.

49.9.1 Signal Generator


Signal Generator is used to create a sinus, square or saw tooth curve. Signal
generator can also be used to generate a setpoint, an alarm or an event.

49.9.2 Simple Math Operators


Simple Math Operator is used to add, subtract, multiply and divide a one value from
another.

04-17005-03-en, October 2015 System


1577
50 WorkStation User Interface

Topics
Basic Functionality Icons in the System Tree Pane
File Menu
File Menu New Submenu
Edit Menu
Actions Menu
Actions Menu Activation Submenu
Actions Menu Advanced Submenu
Actions Menu Advanced Commands Submenu
Actions Menu Modification Submenu
Actions Menu View Submenu
Actions Menu - View Submenu - In Watch pane Submenu
Actions Menu Actions Submenu
Drag and Drop Context Menu
Drag and Drop Context Menu New Submenu
Watch Pane and Watch View
Watch Pane and Watch View Toolbar
Watch Select Property Dialog Box
Add/Remove Columns Dialog Box (Watch)
Tools Menu
Tools Menu - Measurement System Submenu
Options Dialog Box
Control Panel View
Progress View Advanced
Progress View Simple
Operation Details Dialog Box
Error Details Progress View
Create Object Wizard Naming the Object Page
Create Object Wizard Create Server from a Backup Set
Page
List View Toolbar
System Tree Pane Toolbar
Confirm Delete Dialog Box
Delete Object Dialog Box
Rename Object Dialog Box
General Properties Basic Tab
General Properties References Tab
Configure Dialog Box - Configuration Tab
Configure Dialog Box Operation Tab
Search Icons
Search View
Search View Toolbar
Search Toolbar
Add/Remove Columns Dialog Box (Search)
Select Folder Dialog Box
Select Types Dialog Box
Select Conditions Dialog Box
Add/Remove Columns Dialog Box (System Tree Pane)
Analog Value Properties
Digital Value Properties
Multistate Value Properties
String Value Properties
Signal Generator Dialog Box
Simple Math Operator Dialog Box
Create Hyperlink Wizard Assign the URL Page
Select Object Dialog Box
Select Object and Properties Dialog Box
Progress View
System Object Properties
System Control Panel Properties
Commit Page
Objects and Trends Dialog Box
Objects and Properties Dialog Box
Building Operation WorkStation Error
50 WorkStation User Interface
50.1 Basic Functionality Icons in the System Tree Pane

50.1 Basic Functionality Icons in the System


Tree Pane
This section describes the icons in WorkStation that relate to the System Tree pane.
Icon Description

Server
Indicates a SmartStruxure server. For more
information, see the SmartStruxure Server
Overview topic on WebHelp.

System
Indicates the System folder in a server. For
more information, see the SmartStruxure
Server Overview topic on WebHelp.

Servers
Indicates a folder for SmartStruxure server
devices.

Folder
Indicates a folder.

Tasks
Indicates a Task that is used to run a Script
program of a Function Block program. For
more information, see the Tasks topic on
WebHelp.

Archive settings
Archive setting icon as it is displayed in the
System Tree pane. For more information,
see section 52.1 Archiving Overview on
page 1695.

Search query
Indicates a saved search in the System Tree
and in the List View. For more information,
see section 54.1 Search Overview on page
1759.

System Control Panel


Indicates System Control Panel. For more
information, see section 49.4 Control Panel
on page 1569.

04-17005-03-en, October 2015 System


1583
50 WorkStation User Interface
50.2 File Menu

50.2 File Menu


Use the File menu to log off from the system, import and export information, print,
and create new objects.

Figure: The File menu

Command Description

New Click to open the New submenu where you


create new objects. For more information,
see section 50.3 File Menu New
Submenu on page 1586.

Open Click to open an object.

Open in new window Click to open the selected object in a new


window in the work area.

Save Click to save changes.

Log Off Click to log off WorkStation. Your session


ends and you are sent to the Welcome
Window where you can log in to Building
Operation with the same or another user
account. For more information, see section
26.7 Building Operation WorkStation
Window on page 604.

Change Password Click to open the Change Password


dialog box where you change your
password. For more information, see section
26.11 Change Password Dialog Box on
page 611.

Close Project Click to close an open project in


WorkStation for Projects.

System 04-17005-03-en, October 2015


1584
50 WorkStation User Interface
50.2 File Menu

Continued
Command Description

Export Click to open the Save As dialog box where


you export a solution to a file location on the
WorkStation file system.
The Export preview dialog box displays
when there are objects in the solution that
Building Operation cannot export from the
SmartStruxure server. Use this dialog box to
view multiple objects that the system can
and cannot export from the SmartStruxure
server. For more information, see the Export
Preview Dialog Box topic on WebHelp.

Import Click to open the Open dialog box where


you select a previously exported solution
that you want to import. After you select a
file, the Import dialog box displays.
The Import dialog box provides a summary
of information about the imported file and a
preview of the names and file structure of the
objects to be imported. For more
information, see the Import Dialog Box topic
on WebHelp.

LonWorks import Click to open the Import - LonWorks


submenu where you import resource files
(DRF kits) or device templates (XIF files).

Print Preview Click to preview a printout before printing.

Print Click to print the selected object.

Print Setup Click to adjust the print settings.

Properties Click to open the Properties dialog box


where you inspect or change properties for
the selected object. For more information,
see section 50.34 General Properties
Basic Tab on page 1642.

Shortcut Properties Displays the Properties dialog box for the


currently selected shortcut.

Exit Click to quit WorkStation.

04-17005-03-en, October 2015 System


1585
50 WorkStation User Interface
50.3 File Menu New Submenu

50.3 File Menu New Submenu


Use the New submenu to create new objects.

Figure: File menu - New submenu

Command Description

Alarm Click to open the Create Object wizard


where you create an alarm. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
An alarm monitors a variable and alerts you if
the monitored variable matches the
configured alarm conditions. For more
information, see section 29.1 Alarms
Overview on page 673.

Assignment Click to open the Create Object wizard


where you create an assignment. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
A triggered alarm can be automatically
assigned to a specific user or user group
that seems to be most suited to correct the
problem. For more information, see section
31.38 Automatic Assignments on page
873.

System 04-17005-03-en, October 2015


1586
50 WorkStation User Interface
50.3 File Menu New Submenu

Continued
Command Description

Application Click to open the Create Object wizard


where you create an application folder for a
hosted BACnet device. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

b3 device Click to open the Create Object wizard


where you create a b3 device on the MSTP
network. For more information, see section
50.27 Create Object Wizard Naming the
Object Page on page 1634.
b3 BACnet devices are a family of intelligent,
programmable, stand-alone devices that
provide Direct Digital Control of air handlers
and systems as well as individual terminal
units. For more information, see the b3
BACnet Device Controllers topic on
WebHelp.

BACnet device Click to open the Create Object wizard


where you create a BACnet device that is
hosted by the local SmartStruxure server.
For more information, see section 50.27
Create Object Wizard Naming the Object
Page on page 1634.

BACnet loop Click to open the Create Object wizard


where you create a BACnet loop that
represents a feedback control loop. For
more information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
You use a BACnet loop to create a feedback
system without manually creating or editing
Script code. For more information, see the
BACnet Objects and Properties topic on
WebHelp.

BACnet network Click to open the Create Object wizard


where you create a BACnet network that is
not directly connected to the SmartStruxure
server. For more information, see section
50.27 Create Object Wizard Naming the
Object Page on page 1634.
You use a BACnet network when you want
to host a device that is on a network that is
not directly connected to the SmartStruxure
server. For more information, see the
BACnet Networks topic on WebHelp.

04-17005-03-en, October 2015 System


1587
50 WorkStation User Interface
50.3 File Menu New Submenu

Continued
Command Description

BACnet notification Click to open the Create Object wizard


where you create a BACnet notification that
can be referenced by BACnet alarms and
objects configured for intrinsic alarming. For
more information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
For more information, see the BACnet
Alarms topic on WebHelp.

BACnet program Click to open the Create Object wizard


where you create a BACnet program and
upload the properties of a BACnet program
from a BACnet device into Building
Operation. For more information, see section
50.27 Create Object Wizard Naming the
Object Page on page 1634.

BACnet trend log Click to open the Create Object wizard


where you create a BACnet trend log that
monitors and records the trends of a
monitored property. For more information,
see section 50.27 Create Object Wizard
Naming the Object Page on page 1634.
A BACnet trend log is a property monitor for
a specific object. When certain conditions
are reached, a log is produced with the
property value and a date/time stamp. For
more information, see the BACnet Objects
and Properties topic on WebHelp.

BBMD Click to open the Create Object wizard


where you create a BBMD when you want
BACnet broadcast messages to be
communicated throughout an IP network.
For more information, see section 50.27
Create Object Wizard Naming the Object
Page on page 1634.
You create BBMDs on Ethernet-based
devices, such as Automation Servers, when
you want BACnet broadcast messages to
be communicated throughout an IP network.

BBMD BDT entry Click to open the Create Object wizard


where you create a BDT Entry for a BBMD.
For more information, see section 50.27
Create Object Wizard Naming the Object
Page on page 1634.
You create a BDT entry for to configure a
master table for a BBMD.

Change of Value Log Set Click to create a Change of Value Log Set
subfolder. For more information, see the Log
Sets topic on WebHelp.

System 04-17005-03-en, October 2015


1588
50 WorkStation User Interface
50.3 File Menu New Submenu

Continued
Command Description

Device Click to open the Create Object wizard


where you create a device. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

Document Click to open the Create Object wizard


where you create a document. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
A document is a container in which you can
upload a file for use in Building Operation.
You can upload all types of files including
reports, forms, images, and video clips. For
more information, see section 57.1
Documents Overview on page 1803.

Extended trend log Click to open the Create Object wizard


where you create an extended trend log. For
more information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
An extended trend log is used to upload and
store log records from a trend log in a device
where space is limited. For more information,
see section 38.4 Extended Trend Logs on
page 1221.

Folder Click to open the Create Object wizard


where you create a folder. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

Function Block Click to open the Create Object wizard


where you create a Function Block program.
For more information, see section 50.27
Create Object Wizard Naming the Object
Page on page 1634.
For more information, see the Function Block
Editor Overview topic on WebHelp.

Global Values Click to create a new Sigma global values


device. For more information, see the Global
Values topic on WebHelp.

Graphic Click to open the Create Object wizard


where you create a graphic. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
The created graphic is empty and has to be
edited. For more information, see the
Graphics Editor Overview topic on WebHelp.

04-17005-03-en, October 2015 System


1589
50 WorkStation User Interface
50.3 File Menu New Submenu

Continued
Command Description

Graphics folder Click to create a Sigma graphics subfolder.

Hyperlink Click to open the Create Object wizard


where you create a hyperlink. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
Hyperlinks are used to acces web pages on
the Internet. For more information, see
section 49.7 Hyperlinks on page 1574.

Interface Click to open the Create Object wizard


where you create an interface. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
The created interface can be a BACnet
interface, LonWorks interface, MicroNet
network, or Modbus interface/network.
For more information, see the BACnet
Interface topic on WebHelp.
For more information, see the LonWorks
Overview topic on WebHelp.
For more information, see the MicroNet
Network Protocols topic on WebHelp.
For more information, see the Modbus
Overview topic on WebHelp.
For more information, see the Web Services
Overview topic on WebHelp.

Interval Log Set Click to create an Interval Log Set subfolder.


For more information, see the Log Sets topic
on WebHelp.

IP network Click to open the Create Object wizard


where you create an IP network. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

LonWorks Network Opens the Create Object wizard, where


you create a LonWorks network. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

System 04-17005-03-en, October 2015


1590
50 WorkStation User Interface
50.3 File Menu New Submenu

Continued
Command Description

MicroNet Click to open the Create Object wizard,


where you create any one of three MicroNet
network types. For more information, see
section 50.27 Create Object Wizard
Naming the Object Page on page 1634.
MicroNet is a moderate-to-large scale
Building Management System. For more
information, see the MicroNet Network
Protocols topic on WebHelp.

MicroNet ARCNET Network Click to open the Create Object wizard,


where you create a MicroNet ARCNET
network. For more information, see section
50.27 Create Object Wizard Naming the
Object Page on page 1634.
An ARCNET network contains ARCNET
variant MicroNet devices. For more
information, see the ARCNET Networks
topic on WebHelp.

MicroNet NCP Network Click to open the Create Object wizard,


where you create a MicroNet NCP network.
For more information, see section 50.27
Create Object Wizard Naming the Object
Page on page 1634.
An NCP network is the Satchwell Native
Communications Protocol proprietary
network, containing NCP variant MicroNet
devices. For more information, see the NCP
Networks topic on WebHelp.

MicroNet SNP Network Click to open the Create Object wizard,


where you create a MicroNet SNP network.
For more information, see section 50.27
Create Object Wizard Naming the Object
Page on page 1634.
An SNP network is the Satchwell SatchNet
Pro proprietary network, containing SNP
variant MicroNet devices. For more
information, see the SNP Networks topic on
WebHelp.

Modbus Device Click to open the Create Object wizard


where you create an external slave device on
a serial Modbus (master) network, or a new
serial device on a Modbus TCP gateway. For
more information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
A Modbus device is any device that
conforms to the Modbus standard (for
example, a meter or a programmable logic
controller). For more information, see the
Modbus Devices topic on WebHelp.

04-17005-03-en, October 2015 System


1591
50 WorkStation User Interface
50.3 File Menu New Submenu

Continued
Command Description

Modbus Points Click to open the Create Object wizard


where you create a Modbus point within an
external device. For more information, see
section 50.27 Create Object Wizard
Naming the Object Page on page 1634.
A Modbus point is an analog, digital or
multistate input (or output) at a Modbus
device. For more information, see the Point
and Value Types topic on WebHelp.

Modbus TCP Device Click to open the Create Object wizard


where you create a Modbus TCP device. For
more information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
A Modbus TCP device is any Modbus device
on a Modbus TCP network. For more
information, see the Modbus Devices topic
on WebHelp.

Modbus Register Group Click to open the Create Object wizard


where you create a Modbus register group
within a Modbus device. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
A Modbus register group is a container
where Modbus registers can be polled as a
group by a Modbus polling device. For more
information, see the Modbus Register
Groups topic on WebHelp.

Modbus Value Click to open the Create Object wizard


where you create a Modbus value in a
Modbus interface. For more information, see
section 50.27 Create Object Wizard
Naming the Object Page on page 1634.
A Modbus value is an analog, digital or
multistate input (or output) at a Modbus
interface. For more information, see the
Point and Value Types topic on WebHelp.

MSTP network Click to open the Create Object wizard


where you create an MS/TP Network for
BACnet devices or b3 devices. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
Building Operation supports BACnet IP
networks and MS/TP networks. For more
information, see the BACnet Networks topic
on WebHelp.

System 04-17005-03-en, October 2015


1592
50 WorkStation User Interface
50.3 File Menu New Submenu

Continued
Command Description

Network Variable Click to open the Create Object wizard


where you create a network variable. For
more information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

Notification Click to open the Create Object wizard


where you create a notification. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
User notifications are used for notifying users
or user groups that a certain alarm event has
occurred in the system. Notifications are
delivered to the users as emails or written to
files outside Building Operation. For more
information, see section 31.27
Notifications on page 848.

Panel Click to open the Create Object wizard


where you create a panel. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
A panel can consist of one or several panes
and one work area with viewable objects, for
example graphics, trend charts, reports, or
another panel. For more information, see
section 24.15 Panel Components on page
569.

Point Click to open the Create Object wizard


where you create a BACnet input or output
point. For more information, see section
50.27 Create Object Wizard Naming the
Object Page on page 1634.
You can create BACnet points in a
SmartStruxure server and in a hosted
BACnet device. For more information, see
the BACnet Objects and Properties topic on
WebHelp.

Program Click to open the Create Object wizard


where you create a program. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
For more information, see the Function Block
Editor Overview topic on WebHelp.
For more information, see the Script Editor
Program Creation topic on WebHelp.

04-17005-03-en, October 2015 System


1593
50 WorkStation User Interface
50.3 File Menu New Submenu

Continued
Command Description

Report Click to open the Create Object wizard


where you create a report. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
Click to create a report. For more
information, see the WebReports Overview
topic on WebHelp.

Schedule Click to open the Create Object wizard


where you create a schedule. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
Schedules are used to determine when
essential events occur in a building
automation system. For more information,
see section 43.1 Schedules Overview on
page 1419.

Search Click to open the Create Object wizard


where you create a search. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
Search is used for searching for objects and
properties of objects in Building Operation.
For more information, see section 54.1
Search Overview on page 1759.

Segment Click to open the Create Object wizard


where you create a Sigma segment. For
more information, see the Sigma
Representation topic on WebHelp.

Server Click to open the Create Object wizard


where you create a SmartStruxure server.
For more information, see section 50.27
Create Object Wizard Naming the Object
Page on page 1634.

Shortcut Click to open the Create Object wizard


where you create a shortcut. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
A shortcut is a link to a SmartStruxure
server, folder, or other object and is simply a
pointer to an object which acts as if it is that
object. For more information, see section
55.5 Shortcut Creation on page 1788.

System 04-17005-03-en, October 2015


1594
50 WorkStation User Interface
50.3 File Menu New Submenu

Continued
Command Description

User Account Click to open the Create Object wizard


where you create a user account. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
A user account uniquely identifies a user to
the system. For more information, see
section 19.3 User Accounts and User
Account Groups on page 395.

Domain Click to open the Create Object wizard


where you create a domain. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
A domain contains of user accounts, user
account groups, software permissions,
workspaces and one or several
SmartStruxure servers. For more
information, see section 21.1 Domains on
page 459.

Text report Opens the Create Object wizard, where


you create a text report. For more
information, see the Creating a Text Report
topic on WebHelp.

Trend Click to open the Create Object wizard


where you create trend logs, trend log lists,
or trend charts. For more information, see
section 50.27 Create Object Wizard
Naming the Object Page on page 1634.
The function of a trend log is to log the
variable that it is connected to and store the
records. For more information, see section
36.1 Trend Overview on page 1125.

Trend log Click to open the Create Object wizard


where you create a trend log. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
The function of a trend log is to log the
variable that it is connected to and store the
records. For more information, see section
36.1 Trend Overview on page 1125.

04-17005-03-en, October 2015 System


1595
50 WorkStation User Interface
50.3 File Menu New Submenu

Continued
Command Description

User account group Click to open the Create Object wizard


where you create a user account group. For
more information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
A user account group can contain both user
accounts and other user account groups.
For more information, see section 19.3 User
Accounts and User Account Groups on
page 395.

Utility Click to open the Create Object wizard


where you create a utility. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
The utilities Signal Gererator and Simple
Math Operator are used for testing the
system. For more information, see section
49.9 Utilities on page 1577.

Value Click to open the Create Object wizard


where you create a value. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.

View Click to open the Create Object wizard


where you create an Event View, Alarm
View, or Watch View. For more information,
see section 50.27 Create Object Wizard
Naming the Object Page on page 1634.
Views are used to display information in a
easy way. For more information, see section
29.1 Alarms Overview on page 673.

Workspace Click to open the Create Object wizard


where you create a workspace. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.
A workspace is a configured layout and
selection of components that display in
WorkStation. For more information, see
section 24.3 Workspace Components and
Customization on page 540.

System 04-17005-03-en, October 2015


1596
50 WorkStation User Interface
50.4 Edit Menu

50.4 Edit Menu


Use the Edit menu for standard editing of objects.

Figure: Edit menu

Table: Edit Menu


Command Description

Cancel Click to cancel the latest command.

Refresh Click to refresh the selected object or


workspace.

Select all Click to select all objects.

Deselect all Click to deselect all objects.

Cut Click to cut the selected objects. The objects


are placed on the clipboard.

Copy Click to copy the selected objects. The


objects are placed on the clipboard.

Paste Click to paste a copied or cut object.

Paste as shortcut Pastes a shortcut to a (copied) folder or


object into the selected folder or
SmartStruxure server root.

Paste special Paste with the all external references intact.


For more information, see section 51.10
Move, Copy, Paste, Rename, and Delete
on page 1687.

Move Click to move an object to another location.


For more information, see section 51.10
Move, Copy, Paste, Rename, and Delete
on page 1687.

04-17005-03-en, October 2015 System


1597
50 WorkStation User Interface
50.4 Edit Menu

Continued
Command Description

Delete Click to open the Confirm delete dialog


box where you delete the selected object.
For more information, see section 50.31
Confirm Delete Dialog Box on page 1639.

Rename Click to rename the selected object.

Create shortcut Creates a new shortcut to a selected folder


or object into the same folder as the target.

System 04-17005-03-en, October 2015


1598
50 WorkStation User Interface
50.5 Actions Menu

50.5 Actions Menu


Use the Actions menu to carry out commands for objects selected in the System
Tree pane or a List View.

Figure: Action menu when a Function Block program is selected.

Table: Actions Menu


Command Description

Actions Use the Actions submenu to create manual


archives on an Enterprise Server. For more
information, see section 50.12 Actions
Menu Actions Submenu on page 1615.

Activation Use the Activation submenu to enable,


disable, force transfer, or clear a trend log.
For more information, see section 50.6
Actions Menu Activation Submenu on
page 1608.

Advanced Use the Advanced submenu to repair


references or communication after a
SmartStruxure server has been offline. For
more information, see section 50.7 Actions
Menu Advanced Submenu on page 1609.

Advanced commands Use the Advanced commands submenu


to execute commands for a device. For
more information, see section 50.8 Actions
Menu Advanced Commands Submenu
on page 1610.

Alarm enable Click to enable the Sigma Alarm.

Alarm inhibit Click to inhibit the Sigma Alarm.

Alarm Refresh Transfers all alarms buffered in the Xenta


device to the server. For more information,
see the Alarms for Xenta LonWorks Devices
topic on WebHelp.

b3 devices Use the b3 devices submenu to


automatically assign the node IDs and initiate
communication with devices on the MS/TP
network, or to update the firmware. For
more information, see the b3 BACnet Device
Properties Advanced Tab topic on
WebHelp.

04-17005-03-en, October 2015 System


1599
50 WorkStation User Interface
50.5 Actions Menu

Continued
Command Description

Backup Click to open the Backup Options dialog


box where you back up the selected server.
For more information, see section 64.5
Backup Options Dialog Box on page 1908.

Clear Status Clears the diagnostic data for the device or


local node. For more information, see the
LonWorks Device Properties Diagnostics
Tab topic on WebHelp.

Cold start Restarts the device and clears the RAM


memory. For more information, see the
Xenta LonWorks Device Restart topic on
WebHelp.

Cold start device Cold starts a hosted BACnet device. For


more information, see the Device Cold Start
and Warm Start topic on WebHelp.

Commission Opens the Commission Device wizard,


where you download settings and
parameters to the device.
For more information, see the Neuron ID and
Commission Settings Page topic on
WebHelp.
For more information, see the Actions
Menu Device Submenu topic on WebHelp.

Create Reports From WebReports Click to restore the Reports folder in the
System Tree. For more information, see the
Reports in WorkStation and the WebReports
Web Site topic on WebHelp.

Data Import Click to import the MicroNet import file. For


more information, see the Data Import topic
on WebHelp.

Data import Click to import Sigma data from the Sigma


server PC. For more information, see the
Sigma Data Import topic on WebHelp.

Decommission Deactivates the device in the network.

Deploy Starts a deploy of a SmartStruxure server


configuration to a server from Project
Configuration Server. For more information,
see the Deploy topic on WebHelp.

Device Use the Device submenu where you


manage your devices. For more information,
see the Actions Menu Device Submenu
topic on WebHelp.

System 04-17005-03-en, October 2015


1600
50 WorkStation User Interface
50.5 Actions Menu

Continued
Command Description

Device communication control Controls the device communications for


BACnet devices and the BACnet Interface,
and is primarily used for diagnostic
purposes.
For more information, see the Device
Communication and Diagnostics topic on
WebHelp.

Discover Devices Identifies the devices and objects on a


particular BACnet network, or an entire
BACnet internetwork. For more information,
see the BACnet Device Discovery topic on
WebHelp.

Download Downloads applications or BACnet networks


from the Building Operation server database.
For more information, see the EcoStruxure
Web Service Alarm Item topic on WebHelp.

Download device configuration Downloads the parameters from the


SmartStruxure server database to the
device.

Edit Opens the object for editing in the


appropriate editor.

Edit Alarm Click to display the properties for a Sigma


Alarm.

Edit Alarm 1 Click to display the properties for Sigma


Alarm 1.

Edit Alarm 2 Click to display the properties for Sigma


Alarm 2.

Edit Assignment Condition Click to open the Select conditions dialog


box, where you define when to send the
assignment. For more information, see
section 33.78 Select Conditions Dialog
Box Alarm Filter Properties on page 1040.

Edit bindings Click to open the Edit Bindings dialog box.


For more information, see the Bindings View
topic on WebHelp.

Edit cooling linear Click to display the properties for a Sigma


linear cooling optimizer.

Edit cooling logarithmic Click to display the properties for a Sigma


logarithmic cooling optimizer.

Edit heating linear Click to display the properties for a Sigma


linear heating optimizer.

Edit heating logarithmic Click to display the properties for a Sigma


logarithmic heating optimizer.

04-17005-03-en, October 2015 System


1601
50 WorkStation User Interface
50.5 Actions Menu

Continued
Command Description

Edit Event Filter Click to open the Select conditions dialog


box, where you edit an event filter to an
object. For more information, see section
35.8 Select Conditions Dialog Box Events
Filter Properties on page 1121.

Edit in spreadsheet Click to open Edit in spreadsheet where


you can quickly build and reuse a database
of I/O modules on the I/O bus. For more
information, see the Copying from MS Excel
to Spreadsheet View topic on WebHelp.

Edit Notification Condition Click to open the Select conditions dialog


box, where you define when to send the
alarm notification. For more information, see
section 33.78 Select Conditions Dialog
Box Alarm Filter Properties on page 1040.

Edit permissions Click to open the Edit Permissions dialog


box where you grant permissions or limit the
permissions users or user groups have to a
path. For more information, see section
22.15 Edit Permissions Dialog Box on
page 517.

Edit secondary input Click to display the properties for a


secondary input to a Sigma Setpoint Adjust
object.

Edit schedule Click to display the schedule editor or


calendar editor (as relevant).

Edit Standard Alarm View filter Click to open the Select conditions dialog
box, where you sort the information in an
Alarms pane. For more information, see
section 33.78 Select Conditions Dialog
Box Alarm Filter Properties on page 1040.

Edit Sum Alarm Condition Click to open the Select conditions dialog
box, where you configure the conditions that
determine which alarms the sum alarm
surveys. For more information, see section
33.78 Select Conditions Dialog Box Alarm
Filter Properties on page 1040.

Edit the style of associated events Click to open the Event styles dialog box
where you style the appearance of a specific
event in the Events pane. For more
information, see section 35.5 Event Styles
Dialog Box on page 1113.

Edit time extension Click to display the properties for a Sigma


Time Extension.

Host EWS Objects Click to host a remote EcoStruxure Web


Service object. For more information, see the
EcoStruxure Web Service Client topic on
WebHelp.

System 04-17005-03-en, October 2015


1602
50 WorkStation User Interface
50.5 Actions Menu

Continued
Command Description

Hours cancel limit 1 Click to prevent the generation of the next


totalization alarm for Limit 1 (like precancel,
except that you cannot later reinstate the
generation of the next Limit 1 totalization
alarm).

Hours cancel limit 2 Click to prevent the generation of the next


totalization alarm for Limit 2 (like precancel,
except that you cannot later reinstate the
generation of the next Limit 2 totalization
alarm).

Hours cancel limit 3 Click to prevent the generation of the next


totalization alarm for Limit 3 (like precancel,
except that you cannot later reinstate the
generation of the next Limit 3 totalization
alarm).

Hours precancel limit 1 Click to prevent the generation of the next


totalization alarm for Limit 1.

Hours precancel limit 2 Click to prevent the generation of the next


totalization alarm for Limit 2.

Hours precancel limit 3 Click to prevent the generation of the next


totalization alarm for Limit 3.

Hours reinstate limit 1 Click to reverse the effects of clicking Hours


precancel limit 1.

Hours reinstate limit 2 Click to reverse the effects of clicking Hours


precancel limit 2.

Hours reinstate limit 3 Click to reverse the effects of clicking Hours


precancel limit 3.

IO wiring list Click to open the IO Wiring List dialog box


where you print an I/O wiring list for the I/O
bus that describes which I/O points are
associated with each I/O module. For more
information, see the Print I/O Wiring List
Dialog Box topic on WebHelp.

Launch VisiSat Click to start VisiSat. For more information,


see the VisiSat Programming topic on
WebHelp.

Learn BDT Table Click to open the Learn BDT Table dialog
box where you learn the BACnet Broadcast
Device Table from one BBMD to another
BBMD. For more information, see the
Learning a BBMD Configuration from one
BBMD to Another topic on WebHelp.

Learn LCM Learns the blocks in the LCM. For more


information, see the Learn LCM Blocks topic
on WebHelp.

04-17005-03-en, October 2015 System


1603
50 WorkStation User Interface
50.5 Actions Menu

Continued
Command Description

LCM sync date time Sends the server's date and time to each
LCM device on the LCM network. For more
information, see the NETWORK 8000 LCMs
topic on WebHelp.

Manage IO bus Click to open the I/O Module


Management Tool dialog box where you
assign and unassign logical I/O modules,
correct the position of a module type, or
correct a module mismatch. For more
information, see the I/O Module
Management Tool Dialog Box topic on
WebHelp.

Manage Meter Click to open the Manage Meter dialog


box where you manage the settings of a new
meter. For more information, see section
41.13 Manage Replacement of Meter
Dialog Box on page 1345.

MNL Use the MNL submenu to open WorkPlace


Tech Monitor, to monitor or perform a task
on an MNL LonWorks device. For more
information, see the Actions Menu MNL
Submenu topic on WebHelp.

Modification Use the Modification submenu to modify a


trend log. For more information, see section
50.9 Actions Menu Modification
Submenu on page 1611.

Print IO module labels Click to open the Print IO Module Labels


dialog box where you print the placard of the
I/O module. For more information, see the
Print I/O Module Labels Dialog Box topic on
WebHelp.

Proxy Update Reads the configuration properties of the


block in the LCM. For more information, see
the NETWORK 8000 LCMs topic on
WebHelp.

Pulse start Click to generate a Digital Output pulse


lasting for the duration of the rising edge
setting in Sigma.

Pulse stop Click to generate a Digital Output pulse


lasting for the duration of the falling edge
setting in Sigma.

Refresh device identification Click to refresh the basic device identification


displayed in the properties of a Modbus
device. For more information, see the
Modbus Devices topic on WebHelp.

Removed from Network Removes an offline device object for a


physical device that was previously removed
from the network.

System 04-17005-03-en, October 2015


1604
50 WorkStation User Interface
50.5 Actions Menu

Continued
Command Description

Reset Resets the block in the LCM. For more


information, see the NETWORK 8000 LCMs
topic on WebHelp.

Reset IO module Resets the I/O module with its old


configuration. For more information, see the
I/O Modules topic on WebHelp.

Restore Click to open the Restore Options dialog


box where you restore the selected server,
or upload the configurations properties of an
external BACnet device to a device proxy.

Retrieve logged values Click to retrieve logged values from the


relevant Sigma controllers.

Revert to application value Click to use an NCI value from the device
application when downloading the device
configuration (NCI values) to an MNL
LonWorks device. For more information, see
the NCI Values topic on WebHelp.

Save To Save the selected backup to another


location in theSmartStruxure server device
database. For more information, see section
64.13 Backup Sets View on page 1918.

Send log set Click to send the selected log set to the
relevant Sigma controller.

Send log sets Click to send all log sets to the relevant
Sigma controllers.

Send ServicePin Sends service pin for the local node, so


other devices can identify the local node on
the network. For more information, see the
Discovering a Xenta Device topic on
WebHelp.

Send time sync now Manually forces the server to send out time
synch notifications to all the configured
recipients. For more information, see the
Manually Triggering the Time Recipients List
of a SmartStruxure Server topic on
WebHelp.

Sigma diagnostics Click to open the Sigma diagnostics


submenu, where you can retime a controller,
set a controller online, or select diagnostics
text reports. For more information, see the
Controller Diagnostics topic on WebHelp.

Teach Sends a selected BBMD configuration to all


other BBMDs in the system. For more
information, see the Teaching a BBMD
Configuration to Other BBMDs topic on
WebHelp.

04-17005-03-en, October 2015 System


1605
50 WorkStation User Interface
50.5 Actions Menu

Continued
Command Description

Temporary off Click to override a Sigma Time Schedule


object until the next scheduled ON time.

Temporary on Click to override a Sigma Time Schedule


object until the next scheduled OFF time.

Time sync Synchronizes the time between a hosted


device and the local server. For more
information, see the BACnet Device Time
Synchronization Recipients Tab topic on
WebHelp.

Update IO module firmware Click to open the Update IO Module


Firmware dialog box where you upgrade
the firmware for I/O modules. For more
information, see the Update I/O Module
Firmware Dialog Box topic on WebHelp.

Upload Uploads the application from the device to


the Building Operation server database.

Upload device configuration Uploads the parameters from the device to


the Building Operation server database.

Update Object list Updates the list of BACnet device objects.

Warm start Restarts a device without clearing the RAM


memory. For more information, see the
Xenta LonWorks Device Restart topic on
WebHelp.

Warm start device Restarts a BACnet hosted device without


clearing all configuration data, run-time data,
and the values of objects. For more
information, see the Device Cold Start and
Warm Start topic on WebHelp.

View Use the View menu to open a report, trend


chart, trend log list, or add a value to the
Watch pane. For more information, see
section 50.10 Actions Menu View
Submenu on page 1612.

View Action Notes Click to open an Events pane that displays


all events where an action note has been
added to the alarm. For more information,
see section 35.1 Events Pane and Event
View on page 1109.

View Cause Notes Click to open an Events pane that displays


all events where a cause note has been
added to the alarm. For more information,
see section 35.1 Events Pane and Event
View on page 1109.

System 04-17005-03-en, October 2015


1606
50 WorkStation User Interface
50.5 Actions Menu

Continued
Command Description

View Checklists Click to open an Events pane that displays


all events where a check list has been added
to the alarm. For more information, see
section 35.1 Events Pane and Event View
on page 1109.

View Comments Click to open an Events pane that displays


all events where a comment has been added
to the alarm. For more information, see
section 35.1 Events Pane and Event View
on page 1109.

View History Click to open an Events pane where all


history events of an alarm are displayed. For
more information, see section 35.1 Events
Pane and Event View on page 1109.

Wink Generates a response from the device, such


as flashing the power LED, so you can
identify the physical device. The device must
be connected, have its ID set, and support
the Wink function.

04-17005-03-en, October 2015 System


1607
50 WorkStation User Interface
50.6 Actions Menu Activation Submenu

50.6 Actions Menu Activation Submenu


Use the Activation submenu to enable, disable, or clear a trend log.

Figure: The trend log Actions menu, Activation submenu

Table: Activation Submenu


Command Description

Enable trend log Click to enable the trend log. The trend log
starts when the start condition is fulfilled.

Disable trend log Click to disable the trend log and stop all
recording activity.

Clear trend log Click to clear all the records from the trend
log.

Force transfer Click to manually forces the transfer of


records to the extended trend log.

System 04-17005-03-en, October 2015


1608
50 WorkStation User Interface
50.7 Actions Menu Advanced Submenu

50.7 Actions Menu Advanced Submenu


Use the Advanced submenu to repair communications or repair references.

Figure: The Actions menu - Advanced submenu

Command Description

Repair references Click to repair references when you have


moved, renamed, or deleted an object that
refers to another object that is offline. For
more information, see section 51.10 Move,
Copy, Paste, Rename, and Delete on page
1687.

Rebind Click to rebind a LonWorks network and


clear and recreate all LonWorks bindings.

Detect Subnet/Node conflicts Click to detect address conflicts in the


network. The command finds and presents
the neuron IDs of any online devices that
share the same subnet/node address.

Repair server communication Click to repair server communication after a


SmartStruxure server has been offline. For
more information, see the Repairing
SmartStruxure Server Communication topic
on WebHelp.

Add attachment Click to add an alarm attachment to one or


several alarms.

Copy attachments from Click to copy alarm attachments from one


alarm to one or several other alarms.

Remove all attachments Click to remove all alarm attachments from


one or several alarms.

04-17005-03-en, October 2015 System


1609
50 WorkStation User Interface
50.8 Actions Menu Advanced Commands Submenu

50.8 Actions Menu Advanced Commands


Submenu
Use the Advanced Commands submenu to execute functions on the selected
LonWorks device or Xenta device.

Figure: The Actions menu - Advanced Commands submenu

Table: Advanced Commands Submenu


Command Description

Wink Click to generate a response from the


device, such as flashing the power LED.

Clear Status Click to clear the diagnostic data for the


device or local node. For more information,
see the LonWorks Device Properties
Diagnostics Tab topic on WebHelp.

Warm Start Click to restart the device without clearing


the RAM memory. For more information, see
the Xenta LonWorks Device Restart topic on
WebHelp.

Cold Start Click to restart the device and clear the RAM
memory. For more information, see the
Xenta LonWorks Device Restart topic on
WebHelp.

Alarm Refresh Click to transfer all alarms buffered in the


physical Xenta device to Building Operation.
For more information, see the Alarms for
Xenta LonWorks Devices topic on WebHelp.

System 04-17005-03-en, October 2015


1610
50 WorkStation User Interface
50.9 Actions Menu Modification Submenu

50.9 Actions Menu Modification Submenu


Use the Modification submenu to add a value to a manual trend log.

Figure: The trend log Actions menu, Modification submenu

Table: Modification Submenu


Command Description

Add log record Click to open the Add log record dialog
box where you add values and comments to
a manual trend log. For more information,
see section 37.23 Adding a Trend Log
Record to a Manual Trend Log on page
1211.

04-17005-03-en, October 2015 System


1611
50 WorkStation User Interface
50.10 Actions Menu View Submenu

50.10 Actions Menu View Submenu


Use the View submenu to display object related events, temporary trend charts, or
trend log lists.

Figure: Acations menu - View submenu

Table: Actions Menu View Submenu


Command Description

Contingency log chart Click to display a Contingency Log chart for


a Sigma object. For more information, see
the Viewing a Contingency Log Chart or List
topic on WebHelp.

Contingency log list Click to display a Contingency Log list for a


Sigma object. For more information, see the
Viewing a Contingency Log Chart or List
topic on WebHelp.

Events Click to open an Events pane that displays


the events related to a specific object. For
more information, see section 35.3 Object-
Specific Event View on page 1111.

Events in this branch Click to open an Events pane that displays


all events for the selected branch, for
example, a folder. For more information, see
section 34.1 How Events Work on page
1085.

Trends Click to view related trend objects. For more


information, see section 50.60 Objects and
Trends Dialog Box on page 1671.

In Trend Chart Click to open a trend log as a temporary


trend chart. For more information, see
section 39.23 Temporary Trend Charts on
page 1287.

In Trend Log List Click to open a trend log as a temporary


trend log list. For more information, see
section 40.9 Temporary Trend Log Lists on
page 1319.

Report Click to open a report.

Text Report Click to enable the selection of a Sigma text


report relating to the object selected. For
more information, see the Text Report View
topic on WebHelp.

System 04-17005-03-en, October 2015


1612
50 WorkStation User Interface
50.10 Actions Menu View Submenu

Continued
Command Description

In Watch pane Use the In Watch pane submenu to select


the property of the variable you want to
monitor. For more information, see section
50.11 Actions Menu - View Submenu - In
Watch pane Submenu on page 1614.

04-17005-03-en, October 2015 System


1613
50 WorkStation User Interface
50.11 Actions Menu - View Submenu - In Watch pane Submenu

50.11 Actions Menu - View Submenu - In


Watch pane Submenu
Use the In Watch pane submenu to choose which property you want to monitor.

Figure: In Watch pane submenu

Command Description

Default properties Click to use the default property when you


monitor the variable.

Other Properties Click to open a dialog box where you select


the property of the variable you want to
monitor in the Watch pane.

System 04-17005-03-en, October 2015


1614
50 WorkStation User Interface
50.12 Actions Menu Actions Submenu

50.12 Actions Menu Actions Submenu


Use the Actions submenu to create manual archives on an Enterprise Server.

Figure: Actions Menu Actions submenu

Table: Actions Menu Actions Submenu


Command Description

Create archive(s) Creates a manual archive that is saved to a predefined path on the
now computer running WorkStation. For more information, see section
53.1 Archive Settings Manager Dialog Box on page 1745.

04-17005-03-en, October 2015 System


1615
50 WorkStation User Interface
50.13 Drag and Drop Context Menu

50.13 Drag and Drop Context Menu


Use the drag and drop context menu to copy, move, or create shortcuts for objects
selected in the List View or in the System Tree pane, and to mass create objects
selected in the List View.

Figure: Drag and drop context menu

Table: Drag and Drop Context Menu


Command Description

Copy Click to copy the objects selected in the List


View to the selected folder or object in the
System Tree pane.

New Click to open the New submenu where you


create or mass create alarms or trends
based on the selected value objects. For
more information, see section 50.14 Drag
and Drop Context Menu New Submenu
on page 1617.

Move Click to move the objects selected in the List


View to the selected folder or object in the
System Tree pane.

Create Shortcut Click to create a shortcut for the objects


selected in the List View to the selected
folder or object in the System Tree pane.

System 04-17005-03-en, October 2015


1616
50 WorkStation User Interface
50.14 Drag and Drop Context Menu New Submenu

50.14 Drag and Drop Context Menu New


Submenu
Use the New submenu to create new alarms or trends. By default, the alarms or
trends are created in the same folder as the value they are based on.

Figure: New submenu

Table: New Submenu


Command Description

Alarm Select to open the Create Object wizard or


the Mass Create Object wizard where you
create one or several alarms. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.. For more information, see
section 42.12 Mass Create Object Wizard
Name Page on page 1415.

Trend Select to open the Create Object wizard or


the Mass Create Object wizard where you
create one or several trends. For more
information, see section 50.27 Create
Object Wizard Naming the Object Page
on page 1634.. For more information, see
section 42.12 Mass Create Object Wizard
Name Page on page 1415.

04-17005-03-en, October 2015 System


1617
50 WorkStation User Interface
50.15 Watch Pane and Watch View

50.15 Watch Pane and Watch View


You can drag objects to the Watch pane or a Watch View to monitor their live
values and other properties, for example, to monitor the impact of a change you are
about to make in your system. Property changes are immediately displayed in the
Watch pane or Watch View. You can add and remove property columns in the
Watch pane or Watch View.
Dragging an object to the Watch pane or Watch View, you get different results
depending on whether you right-click and drag or left-click and drag:
Right-click and drag the object to the Watch pane or Watch View. When you
choose this method, you can select the properties you want to monitor.
Left-click and drag an object to the Watch pane or Watch View. When you
choose this method, the default property of the object is displayed.
The list of objects in the Watch pane is not saved when you log out of WorkStation
but you can save the lists of objects to the system and reopen it from the System
Tree. You can save the list of objects on the Watch View toolbar. The saved Watch
view is opened in the List View. You can right-click any object in the Watch pane or
a Watch View to view and edit the properties of that object. The Properties dialog
box displays the properties you have chosen to monitor in the Watch pane or
Watch View and also contains a link to the full properties of the object.
You can right-click an object in the Watch pane or Watch View and view the trends
related to the object.

Figure: Watch Pane

System 04-17005-03-en, October 2015


1618
50 WorkStation User Interface
50.16 Watch Pane and Watch View Toolbar

50.16 Watch Pane and Watch View Toolbar


Use the Watch pane and Watch View toolbar to manage the objects in the list.

Figure: Watch pane and Watch View toolbar

Table: Watch Pane Toolbar


Component Description

Remove from Watch Window


Click to remove a selected object from the
Watch pane.

Properties
Click to display the Properties of a selected
object.

Show/Hide Group Box


Click to display the Show/Hide Group box to
group and sort objects. For more
information, see the Group and Sort Objects
topic on WebHelp.

Save current settings


Click to save the current list of objects.

Quick filter Enter a word or a character to filter on. For


more information, see section 49.6 Quick
Filter on page 1571.

04-17005-03-en, October 2015 System


1619
50 WorkStation User Interface
50.17 Watch Select Property Dialog Box

50.17 Watch Select Property Dialog Box


Use the Watch Select Property dialog box to select the property of the variable you
want to monitor.

Figure: Select property dialog box

Component Description

Quick filter Enter a word or a character to filter on. For


more information, see section 49.6 Quick
Filter on page 1571.

System 04-17005-03-en, October 2015


1620
50 WorkStation User Interface
50.18 Add/Remove Columns Dialog Box (Watch)

50.18 Add/Remove Columns Dialog Box


(Watch)
Use the Add/Remove Columns dialog box to add or remove columns from the
Watch pane or a Watch View.

Figure: Add/Remove Columns dialog box

04-17005-03-en, October 2015 System


1621
50 WorkStation User Interface
50.19 Tools Menu

50.19 Tools Menu


Use the Tools menu to open Control Panel or make a number of user settings.

Figure: Tools menu

Table: Tools Menu


Command Description

Control Panel Click to open the Control Panel where you


get access to some of the most used
administration functions in Building
Operation, such as alarms, domains, user
accounts, backup and archiving, and
engineering. For more information, see
section 50.22 Control Panel View on page
1625.

Language Click to open the Language submenu


where you select a different WorkStation
language. For more information, see section
16.3 Language Packages on page 325.

Measurement system Click to open the Measurement system


submenu where you select a different local
measurement system. For more information,
see section 16.8 Units on page 330.

Options Click to open the Options dialog box where


you manage some local user settings. For
more information, see section 50.21
Options Dialog Box on page 1624.

System 04-17005-03-en, October 2015


1622
50 WorkStation User Interface
50.20 Tools Menu - Measurement System Submenu

50.20 Tools Menu - Measurement System


Submenu
Use the Measurement system submenu to set the local measurement system
preferences. For more information, see section 16.8 Units on page 330.

Figure: Measurement system submenu

Table: Measurement System Submenu


Command Description

As in Microsoft Windows Select to display the units in the system set


by the Regional Settings that are used on the
computer.For more information, see the
Regional Settings topic on WebHelp.

As configured in object Select to display the configured units of the


object. For more information, see section
16.8 Units on page 330.

International System of Units (Metric) Select to display the units as SI units. For
more information, see section 16.8 Units
on page 330..

United States Customary Units (US) Select to display the units as United States
Customary Units. For more information, see
section 16.8 Units on page 330.

04-17005-03-en, October 2015 System


1623
50 WorkStation User Interface
50.21 Options Dialog Box

50.21 Options Dialog Box


Use the Options dialog box to manage some local user settings.

Figure: Options dialog box

Table: Options Dialog Box


Component Description

Show same tab while navigating Click to open the same tab at all times when
between objects you navigate between objects. For more
information, see section 51.5 Object Tab
Display on page 1682.

Reset all user settings Click to reset your locally saved user setting.
For more information, see the
Personalization topic on WebHelp.

System 04-17005-03-en, October 2015


1624
50 WorkStation User Interface
50.22 Control Panel View

50.22 Control Panel View


Use the Control Panel to access some of the most used functions in Building
Operation.

Figure: Control Panel

Table: Control Panel


Component Description

Server Select the SmartStruxuer server you want to


work with.

Action notes Click to open Action notes. For more


information, see section 32.6 Action Notes
on page 892.

Categories Cick to open Categories. For more


information, see section 31.10 Categories
on page 822.

Cause notes Click to open Cause notes. For more


information, see section 32.2 Cause Notes
on page 886.

04-17005-03-en, October 2015 System


1625
50 WorkStation User Interface
50.22 Control Panel View

Continued
Component Description

Checklists Click to open Checklists. For more


information, see section 32.10 Checklists
on page 898.

Domain Click to open Domain. For more information,


see section 21.1 Domains on page 459.

Alarm appearances Click to open Alarm appearances. For more


information, see section 33.45 Alarm Styles
View on page 1000.

Account management Click to open Account management. For


more information, see section 19.3 User
Accounts and User Account Groups on
page 395.

Network time and time zones Click to open Network time and time zones.
For more information, see section 17.1
Time and Time Zone on page 347.

Communication Click to open Server Communication. For


more information, see the SmartStruxure
Server Communication topic on WebHelp.

Device discovery Click to open the Device discovery. For more


information, see the Device Discovery topic
on WebHelp.

Binding Templates Click to open Binding Templates. For more


information, see the Binding Templates topic
on WebHelp.

WorkPlace Tech Editor Click to open WorkPlace Tech Editor. For


more information, see the WorkPlace Tech
Editor topic on WebHelp.

LNS Plug-in Registration Click to open LNS Plug-in Registration. For


more information, see the LNS Plug-ins topic
on WebHelp.

Bindings Diagnostics Click to open Bindings Diagnostics. For


more information, see the Bindings
Management topic on WebHelp.

Backup Rules Click to open Backup Rules. For more


information, see section 59.1 Backup and
Restore Overview on page 1811.

Backup Sets Click to open Backup Sets. For more


information, see section 61.1 Backup Sets
on page 1839.

Backup and Restore Manager Click to open Backup and Restore Manager.
For more information, see section 59.2
Comparison of Backup and Restore
Methods on page 1813.

System 04-17005-03-en, October 2015


1626
50 WorkStation User Interface
50.22 Control Panel View

Continued
Component Description

Archiving Click to open Archive Settings. For more


information, see section 52.1 Archiving
Overview on page 1695.

Security Settings Click to open Security Manager. For more


information, see the Security Settings
Control Panel topic on WebHelp.

Communication Click to open Communication view. For


more information, see the Communication
View topic on WebHelp.

EWS Server Configuration Click to open the EcoStruxure Web Service


server configuration. For more information,
see the EcoStruxure Web Service Server
topic on WebHelp.

04-17005-03-en, October 2015 System


1627
50 WorkStation User Interface
50.23 Progress View Advanced

50.23 Progress View Advanced


The Advanced Progress View is displayed when you download and commission
objects in field devices in, for example LonWorks and BACnet, or when you deploy
a SmartStruxure server in Project Configuration Server.
The Progress view displays information about time-consuming operations between
WorkStation, WorkStation for Projects and a SmartStruxure server. You can also
see detailed information about what went wrong if the operation fails.

Figure: Advanced Progress view when an operation failed.

50.23.1 Detail View


The detailed information in the Progress view helps you to identify problems during
any operation.

System 04-17005-03-en, October 2015


1628
50 WorkStation User Interface
50.23 Progress View Advanced

Figure: Detailed information is displayed in the Error dialog.

04-17005-03-en, October 2015 System


1629
50 WorkStation User Interface
50.24 Progress View Simple

50.24 Progress View Simple


The Progress view displays information about time-consuming operations between
WorkStation and the SmartStruxure server. You can also see detailed information
about what went wrong if the operation fails.

50.24.1 Simple Progress View


The Simple Progress View is displayed when you create, rename, copy or move, an
object. If the operation is successful and very fast you may probably not notice the
Progress view at all.

Figure: Simple Progress view when an operation failed.

50.24.2 Detail View


The detailed information in the Progress view helps you to identify problems during
any operation.

System 04-17005-03-en, October 2015


1630
50 WorkStation User Interface
50.24 Progress View Simple

Figure: Detailed information is displayed in the Error dialog.

04-17005-03-en, October 2015 System


1631
50 WorkStation User Interface
50.25 Operation Details Dialog Box

50.25 Operation Details Dialog Box


The Operating details dialog box displays more detailed information on what
went wrong during the operation.

Figure: Failing Progress - Progress Manager dialog box

Table: Failing Progress - Progress Manager dialog box


Component Description

Path Displays the path to the object the operation


is performed on.

Type Displays the object type.

Operation details Dislays the time and text for the operation.

Error details Click to open the Error dialog box to get


more error details. For more information, see
section 50.26 Error Details Progress
View on page 1633.

Copy to clipboard Click to copy the information to the


clipboard.

System 04-17005-03-en, October 2015


1632
50 WorkStation User Interface
50.26 Error Details Progress View

50.26 Error Details Progress View


Use the Error dialog box to display more information about errors during the
operation.

Figure: Error dialog box.

Table: Error Details Progress View


Component Description

Previous Click to get to the previous error message.

Next Click to get to the next error message.

Copy to clipboard Click to copy the information to the


clipboard.

Close Click to close the dialog box.

04-17005-03-en, October 2015 System


1633
50 WorkStation User Interface
50.27 Create Object Wizard Naming the Object Page

50.27 Create Object Wizard Naming the


Object Page
Use the Naming the object page to set the basic properties for the object. For
objects with several types, you also select the object type.

Figure: Naming the object page

Table: Naming the Object Page


Component Description

(Object type list) Select the type of object you want to create.
For more information, see section 51.1
Object Types on page 1677.

Name Type the name of the object. For more


information, see section 51.2 Object
Names on page 1678.

Prefix Type a label that is added in front of the


object name. For more information, see
section 42.4 Suffix and Prefix on page
1398.

Suffix Type a label that is added after the object


name. For more information, see section
42.4 Suffix and Prefix on page 1398.

Location Enter the path to the location in the System


Tree where you want to create the object. By
default, the path to the selected folder or
object in the System Tree is displayed.

System 04-17005-03-en, October 2015


1634
50 WorkStation User Interface
50.27 Create Object Wizard Naming the Object Page

Continued
Component Description

Description Type a description that explains what the


object is used for.

04-17005-03-en, October 2015 System


1635
50 WorkStation User Interface
50.28 Create Object Wizard Create Server from a Backup Set Page

50.28 Create Object Wizard Create Server


from a Backup Set Page
Use the Create Server from a Backup Set page to create a SmartStruxure server
device from a Backup Set.

Figure: Create a SmartStruxure server device from a backup set page

Table: Create Server from a Backup Set page


Property Description

File Enter the path to the location of the Backup


Set from which you want to create the
SmartStruxure server device.

System 04-17005-03-en, October 2015


1636
50 WorkStation User Interface
50.29 List View Toolbar

50.29 List View Toolbar


Use the List View toolbar to navigate in a list, to group and sort objects in a list and
to view the properties of a selected object in a list.

Table: List View Toolbar


Button Description

Parent folder
Click to move up one folder.

Create Folder
Click to create a new folder.

Show/Hide Group Box


Click to display the Show/Hide Group box to
group and sort objects. For more
information, see the Group and Sort Objects
topic on WebHelp.

Show/Hide Property Grid


Click to display the Properties of a selected
object. For more information, see section
51.3 Object Properties on page 1679.

Quick filter Enter a word or a character to filter on. For


more information, see section 49.6 Quick
Filter on page 1571.

04-17005-03-en, October 2015 System


1637
50 WorkStation User Interface
50.30 System Tree Pane Toolbar

50.30 System Tree Pane Toolbar


Use the System Tree pane toolbar to filter objects in the System Tree pane.

Table: System Tree Toolbar


Button Description

Show/Hide non-presentation objects


Click to toggle between show and hide non-
presentaion objects. For more information,
see section 49.2 System Tree Pane on
page 1567.

Collapse All
Click to collapse the tree structure.

System 04-17005-03-en, October 2015


1638
50 WorkStation User Interface
50.31 Confirm Delete Dialog Box

50.31 Confirm Delete Dialog Box


Use the Confirm Delete dialog box to view how the object you are deleting is
referred to, and from, other objects. When you delete objects you are informed on
how the object is referred to, and from, other objects. The affected references will
not be deleted.

Figure: Confirm Delete dialog box

Table: Confirm Delete dialog box


Component Description

Keep references ... Select to keep references in other objects to


the object you want to delete.

Path Displays the path to the objects that is


affected by the object you want to delete.

Copy to clipboard Click to copy the information about the


affected references to the clipboard.

Yes Click to delete the object.

No Click to close the dialog box without deleting


the object.

04-17005-03-en, October 2015 System


1639
50 WorkStation User Interface
50.32 Delete Object Dialog Box

50.32 Delete Object Dialog Box


The Delete object dialog box is displayed when you try to delete an object you
are not allowed to delete.

Figure: Delete object dialog box

Table: Delete Object Dialog Box


Command Description

Apply to all selected objects Select to apply the same command to all
selected object(s).

Abort deletion Click Abort deletion to keep all objects.

Ignore Click Ignore to the delete the selected


objects and keep objects that you are not
allowed to delete.

System 04-17005-03-en, October 2015


1640
50 WorkStation User Interface
50.33 Rename Object Dialog Box

50.33 Rename Object Dialog Box


Use the Rename object dialog box to rename an object.

Figure: Rename object dialog box

Table: Rename Object Dialog Box


Component Description

Object Name Type the new name of the object.

04-17005-03-en, October 2015 System


1641
50 WorkStation User Interface
50.34 General Properties Basic Tab

50.34 General Properties Basic Tab


Use the Basic tab to configure and view the basic properties.

Figure: General properties basic tab

Table: General Properties


Component Description

Name Displays the name of the object.

Description Type a description that explains what the


object is used for.

Type Displays the object type that defines the


properties of the object.

Foreign address Displays the address to a non-Building


Operation device, for example a BACnet
device.

Modified Displays the date and time when the object


was last modified.

Note 1 Type text that you display in a graphic or use


when searching for the object.

System 04-17005-03-en, October 2015


1642
50 WorkStation User Interface
50.34 General Properties Basic Tab

Continued
Component Description

Note 2 Type text that you display in a graphic or use


when searching for the object.

Validation Select the validation status of the object to


keep track of which objects have passed or
failed the validation.

Executed by Indicates the object is executed by a BACnet


device. An empty field indicates the object is
executed by an Automation Server or
Enterprise Server.

04-17005-03-en, October 2015 System


1643
50 WorkStation User Interface
50.35 General Properties References Tab

50.35 General Properties References Tab


Use the References tab to view and navigate to referred objects.

Figure: General properties references tab

Table: General Properties References Tab


Property Description

References Displays the object's references to other


objects. Click on a reference to navigate to
the object the reference points to.

System 04-17005-03-en, October 2015


1644
50 WorkStation User Interface
50.36 Configure Dialog Box - Configuration Tab

50.36 Configure Dialog Box - Configuration


Tab
You can configure the unit for a value and force or change values.

Figure: Using the Configure dialog box and the Configuration tab you can change or set
units for values.

Component Description

Type Displays the object type. Read-only

Unit Displays the Unit. Select to change the unit.


For more information, see section 16.8
Units on page 330.

Init value Read-only.

Reference Read-only.

Forceable Select to make the value forcible. For more


information, see the Forced Values topic on
WebHelp.

Retain level Select how to handle values for warm start,


cold start, system events, and system
activities. For more information, see section
59.5 Retain Level on page 1818.

04-17005-03-en, October 2015 System


1645
50 WorkStation User Interface
50.36 Configure Dialog Box - Configuration Tab

Component Description

Using the Null checkbox, you can remove any value of a property. The Null
checkbox is available for all properties where the value can be removed. For
example, you can remove references from trend logs using the Null checkbox.
Values can be forced to a certain value. The true value from the system is displayed
in the Unforced value box.

System 04-17005-03-en, October 2015


1646
50 WorkStation User Interface
50.37 Configure Dialog Box Operation Tab

50.37 Configure Dialog Box Operation Tab


Use the Operation tab to force and release values and to check the unforced
value.

Figure: The Operation tab displaying both the forced and unforced value

Component Description

Value Enter the value that you want to use to


override the value of the property. For more
information, see the Forced Values topic on
WebHelp.

Force Click Force to force a value. For more


information, see the Forced Values topic on
WebHelp.

Unforce Click to release the forced value. For more


information, see the Forced Values topic on
WebHelp.

04-17005-03-en, October 2015 System


1647
50 WorkStation User Interface
50.38 Search Icons

50.38 Search Icons


This table describes the search icons.

Table: Search Icons


Icon Description

Search query
Indicates a saved search in the System Tree
pane and in the List View. For more
information, see section 54.1 Search
Overview on page 1759.

System 04-17005-03-en, October 2015


1648
50 WorkStation User Interface
50.39 Search View

50.39 Search View


Use the Search view to do the search settings, view the search results, and save
searches.

Figure: Search

Table: Search View


Component Descriptions

Use the Search toolbar to clear, save, and


update search settings .

Type the text you want to search for in the


Search box.

The Search result list displays search results.

Click the magnifier to start a search.

In folder Enter the folder where you want to search.

Include properties Select to include properties in your search.

Include subserver Select to include SmartStruxure subserver


devices in your search.

Stop if more than 1000 results Select to stop the search when the results
exceed 1000.

04-17005-03-en, October 2015 System


1649
50 WorkStation User Interface
50.39 Search View

Continued
Component Descriptions

Include types Enter the object types that you want to


include in the search.

Conditions Use Include conditions to enter the


conditions that you want to apply on the
object type properties.

System 04-17005-03-en, October 2015


1650
50 WorkStation User Interface
50.40 Search View Toolbar

50.40 Search View Toolbar


Use the Search view toolbar to save a search, group search results or clear
search criteria.

Table: Search View Toolbar


Button Description

Save search criteria


Click to save the search for future use.

Show/Hide group box


Click to display the Show/Hide Group box to
group and sort objects. For more
information, see the Group and Sort Objects
topic on WebHelp.

Show/Hide property grid


Click to display the Properties of a selected
object. For more information, see section
51.3 Object Properties on page 1679.

Clear search criteria


Click to clear all settings in the Search view.

04-17005-03-en, October 2015 System


1651
50 WorkStation User Interface
50.41 Search Toolbar

50.41 Search Toolbar


Use the Search basic toolbar to make a simple search on all objects.

Figure: Search basic toolbar

System 04-17005-03-en, October 2015


1652
50 WorkStation User Interface
50.42 Add/Remove Columns Dialog Box (Search)

50.42 Add/Remove Columns Dialog Box


(Search)
Use the Add/Remove Columns dialog box to add or remove columns to the
Search View.

Figure: Add/Remove Columns dialog box

04-17005-03-en, October 2015 System


1653
50 WorkStation User Interface
50.43 Select Folder Dialog Box

50.43 Select Folder Dialog Box


Use the Select Folder dialog box to select the folder where you want to search.

Figure: Select Folder dialog box

Table: Select Folder Dialog Box


Component Description

Path Displays the path to the selected folder.

System Tree Select the folder where you want to search.

System 04-17005-03-en, October 2015


1654
50 WorkStation User Interface
50.44 Select Types Dialog Box

50.44 Select Types Dialog Box


Use the Select types dialog box to select the object types you want to include in
the search.

Figure: Select types dialog box

Table: Select Types Dialog Box


Component Description

Object type tree Select the object type to search for.

Add type
Click to add the selected object type to the
search.

Remove type
Click to remove the selected object from to
the search.

Selected object types Displays the object types that are included in
the search.

Find type Type the name of the object type you want
to include.

04-17005-03-en, October 2015 System


1655
50 WorkStation User Interface
50.45 Select Conditions Dialog Box

50.45 Select Conditions Dialog Box


Use the Select Conditions dialog box to enter property criteria for the object
types that are included in the search.

Figure: Select conditions dialog box with the common properties for all object types.

Table: Select Conditions Dialog Box


Button Description

Click to add a condition.

Click to remove a condition.

System 04-17005-03-en, October 2015


1656
50 WorkStation User Interface
50.46 Add/Remove Columns Dialog Box (System Tree Pane)

50.46 Add/Remove Columns Dialog Box


(System Tree Pane)
Use the Add/Remove Columns dialog box to add or remove columns from the
view of objects, such as folders, in the System Tree pane. Depending on the object
you have selected in the System Tree pane, you get a different set of column
options.

Figure: Ad/Remove Columns dialog box

04-17005-03-en, October 2015 System


1657
50 WorkStation User Interface
50.47 Analog Value Properties

50.47 Analog Value Properties


Use the Analog Value properties dialog box to view or configure an analog value.

Figure: Analog value

Table: Analog Value


Property Description

Force Click to force a value. For more information,


see the Forced Values topic on WebHelp.

System 04-17005-03-en, October 2015


1658
50 WorkStation User Interface
50.48 Digital Value Properties

50.48 Digital Value Properties


Use the Digital Value properties dialog box to view or configure a digital value.

Figure: Digital value

Table: Digital Value


Property Description

Force Click to force a value. For more information,


see the Forced Values topic on WebHelp.

04-17005-03-en, October 2015 System


1659
50 WorkStation User Interface
50.49 Multistate Value Properties

50.49 Multistate Value Properties


Use the Multistate Value properties dialog box to view or configure a multistate
value.

Figure: Multistate value

Table: Multistate Value


Property Description

Force Click to force a value. For more information,


see the Forced Values topic on WebHelp.

System 04-17005-03-en, October 2015


1660
50 WorkStation User Interface
50.50 String Value Properties

50.50 String Value Properties


Use the String Value properties dialog box to view or configure a string value.

Figure: String value

Table: String Value


Property Description

Force Click to force a value. For more information,


see the Forced Values topic on WebHelp.

04-17005-03-en, October 2015 System


1661
50 WorkStation User Interface
50.51 Signal Generator Dialog Box

50.51 Signal Generator Dialog Box


Use the Signal Generator dialog box to configure a sinus, square or saw tooth
signal used for tests.

Figure: Signal generator dialog box

Component Description

Value Select the signal value and whether to force


or unforce the value.

Signal type Select the signal type, sinus, square, saw


tooth, setpoint, alarm, or event.

Cycle (s) Select the cycle in seconds.

Amplitude Select the amplitude.

System 04-17005-03-en, October 2015


1662
50 WorkStation User Interface
50.52 Simple Math Operator Dialog Box

50.52 Simple Math Operator Dialog Box


Use the Simple Math Operator dialog box to add, subtract, multiply, or divide
one value from another when you perform tests.

Figure: Simple math operator

Component Description

Operator Select the operator, add, subtract, multiply,


or divide.

In1 Input value 1.

In2 Input value 2.

Value Displays the calculated value.

04-17005-03-en, October 2015 System


1663
50 WorkStation User Interface
50.53 Create Hyperlink Wizard Assign the URL Page

50.53 Create Hyperlink Wizard Assign the


URL Page
Use the Assign the URL page to type the URL.

Figure: Assign the URL page

Table: Assign the URL Page


Component Description

URL Type the URL of the website including the


internet protocol http:// or https://.

System 04-17005-03-en, October 2015


1664
50 WorkStation User Interface
50.54 Select Object Dialog Box

50.54 Select Object Dialog Box


Use the Select Object dialog box to select objects.

Figure: Select object dialog box

Table: Select Object Dialog Box


Command Description

Lock path Select to lock the path and make it absolute.


For more information, see the Reference
Format topic on WebHelp.

Path Displays the path to the selected object.

04-17005-03-en, October 2015 System


1665
50 WorkStation User Interface
50.55 Select Object and Properties Dialog Box

50.55 Select Object and Properties Dialog Box


Use the Select Object and Properties dialog box to select an object and its
properties.

Figure: Select object and properties dialog box

Table: Select Object and Properties Dialog Box


Component Description

Lock path Select to lock the path and make it absolute.


For more information, see the Reference
Format topic on WebHelp.

Path Displays the path to the selected object.

System 04-17005-03-en, October 2015


1666
50 WorkStation User Interface
50.56 Progress View

50.56 Progress View


The Progress view displays information about time-consuming operations
between WorkStation and the SmartStruxure server.

Figure: The Progress view

Table: Progress View


Component Description

Operation Displays the name of the operation that is


being performed.

Name Displays the name of the object that the


operation is performed on.

Progress Displays the progress of the operation so


you can determine when the operation is
complete.

Status Displays the status of the operation.

Click to get details for the operation.

Close Click to close the Progress view dialog


box.

04-17005-03-en, October 2015 System


1667
50 WorkStation User Interface
50.57 System Object Properties

50.57 System Object Properties


Use the System Object Properties view or dialog box to configure and view the
general and object-reference properties. For more information, see section 50.34
General Properties Basic Tab on page 1642.

Figure: System Object Properties

System 04-17005-03-en, October 2015


1668
50 WorkStation User Interface
50.58 System Control Panel Properties

50.58 System Control Panel Properties


Use the System Control Panel Properties view or dialog box to configure and
view the general and object-reference properties. For more information, see section
50.34 General Properties Basic Tab on page 1642.

Figure: System Control Panel Properties

04-17005-03-en, October 2015 System


1669
50 WorkStation User Interface
50.59 Commit Page

50.59 Commit Page


The Commit Page displays the progress indication.

Figure: Commit page

Table: Commit Page


Component Description

[Progress bar] Displays the progress indication.

System 04-17005-03-en, October 2015


1670
50 WorkStation User Interface
50.60 Objects and Trends Dialog Box

50.60 Objects and Trends Dialog Box


Use the Objects and trends dialog box to view trend objects that are related to
one or several selected objects or object properties.

Figure: Objects and trends dialog box when you have selected only one object or property.

04-17005-03-en, October 2015 System


1671
50 WorkStation User Interface
50.60 Objects and Trends Dialog Box

Figure: Objects and trends dialog box when you have selected several objects, properties,
or graphic components or groups containing bound properties.

Table: Objects and Trends


Property Description

[Quick filter] Enter a word or a character to filter on. For


more information, see section 49.6 Quick
Filter on page 1571.

Objects Lists the available objects, for example, the


bound properties of a graphic component.

Trends Lists the trends related to the selected


object or property

Path Displays the path of the object, property, or


trend selected in the list.

System 04-17005-03-en, October 2015


1672
50 WorkStation User Interface
50.61 Objects and Properties Dialog Box

50.61 Objects and Properties Dialog Box


Use the Objects and properties dialog box to view events for properties of
objects bound to, for example, components in a graphic or several selected objects
in the Watch pane.

Figure: Objects and properties dialog box

Table: Objects and Properties Dialog Box


Component Description

[Quick filter] Enter a word or a character to filter on. For


more information, see section 49.6 Quick
Filter on page 1571.

Objects and properties Lists the selected properties per object. The
selection can be a component or group in a
graphic, or a selection in the Watch pane.

Path Displays the path of the property selected in


the list.

04-17005-03-en, October 2015 System


1673
50 WorkStation User Interface
50.62 Building Operation WorkStation Error

50.62 Building Operation WorkStation Error


Use the Building Operation WorkStation Error dialog box to send a file with
information about the cause of the crash to Schneider Electric.

Figure: Building Operation WorkStation Error

Table: Building Operation WorkStation Error


Component Description

More info Click to get more information on the cause of


the crash.

Copy to Clipboard Click to copy information about the cause of


the crash to the Windows clipboard.

Send report Click to send the crash report to Schneider


Electric.

Close program Click to close the program without sending


any crash report.

Continue Click to resume the program. This option is


only available when the program is able to
resume after a crash, which is not typically
the case.

System 04-17005-03-en, October 2015


1674
51 Building Operation Objects

Topics
Object Types
Object Names
Object Properties
Opening an Object in a New Window
Object Tab Display
Showing the Same Tab While Navigating Between Objects
Showing Non-Presentation Objects in the System Tree Pane
Multi-edit
Editing Multiple Objects
Move, Copy, Paste, Rename, and Delete
Deleting an Object
Renaming a Folder or Object
Creating a Folder
Copying a Folder or Object
51 Building Operation Objects
51.1 Object Types

51.1 Object Types


The Building Operation database is based on objects. Some objects are created
when the database in installed, others are created by the engineer. Depending on
the object type and your permission, you can configure objects in a many different
way.
Objects that are relevant for the user are presented in the System Tree pane and in
the List View. To ease recognition of objects, every object type is represented by an
icon.

04-17005-03-en, October 2015 System


1677
51 Building Operation Objects
51.2 Object Names

51.2 Object Names


All objects in the Building Operation database has to have a name. Building
Operation is case-sensitive and differentiates between upper and lowercase
characters. Two objects cannot be named in the same way in the same folder even
if the objects are of different types. For example, you cannot create an alarm
named Building A and a graphic named Building A in the same folder. However, if
you name the graphic Building a, with a lowercase a, you can create it in the same
folder as the alarm object Building A.
The following characters are not allowed in object names in Building Operation.
/
"
?
*
~
White space is not allowed in the beginning or the end of an objects name.
. (period) is not allowed in the beginning of an objects name.
There is no limitation of how many characters an object name can have. However,
some field devices retain their character limitations when they are added to Building
Operation database.

System 04-17005-03-en, October 2015


1678
51 Building Operation Objects
51.3 Object Properties

51.3 Object Properties


Every object in Building Operation has a lot of different properties. There are three
ways to access the properties of a selected object in WorkStation:
Properties tab
Properties Dialog box
Properties grid
All three methods displays the same properties.

Figure: The Properties tab for a trend log.


Properties can be of two different types: read only and read/write. Read only
properties are dimmed and cannot be changed. Read/write properties can be
changed by the operator.

04-17005-03-en, October 2015 System


1679
51 Building Operation Objects
51.3 Object Properties

The properties are sorted under different tabs in the properties tab/dialog/grid. The
number of tabs depends on the object. Some object have a lot of properties and
tabs, others have only one tab with only a few properties.

Figure: A SmartStruxure server object with three properties tabs (left) and a value with
only the basic properties tab.
A common tab for all objects is the Basic properties tab that contains general
properties as type, name and description.

System 04-17005-03-en, October 2015


1680
51 Building Operation Objects
51.4 Opening an Object in a New Window

51.4 Opening an Object in a New Window


You open an object in a new window to be able to display two or more objects at
the same time.
For more information, see the Window Menu topic on WebHelp.

To open an object in a new window


1. In WorkStation, in the System Tree pane, right-click the object you want to
open in the new window, and then click Open in new window.

04-17005-03-en, October 2015 System


1681
51 Building Operation Objects
51.5 Object Tab Display

51.5 Object Tab Display


You can make WorkStation open the same tab each time you navigate between
objects.
For example, you want to check all alarm messages in your alarms. The default
behavior in WorkStation is that the Basic Settings tab is displayed whenever you
click on an alarm object. You can have the system display the Presentation tab of
the Alarm object every time you click on an Alarm object.

System 04-17005-03-en, October 2015


1682
51 Building Operation Objects
51.6 Showing the Same Tab While Navigating Between Objects

51.6 Showing the Same Tab While


Navigating Between Objects
You have the system open the same tab whenever you open a new object to make
it easier to view the same properties of the objects.
For more information, see section 51.6 Showing the Same Tab While Navigating
Between Objects on page 1683.

To show the same tab while navigating between objects


1. In WorkStation, on the Tools menu, click Options.
2. Select Show same tab while navigating between objects.
3. Click OK.

04-17005-03-en, October 2015 System


1683
51 Building Operation Objects
51.7 Showing Non-Presentation Objects in the System Tree Pane

51.7 Showing Non-Presentation Objects in


the System Tree Pane
You use the Show/Hide non-presentation object filter to display non-
presentation objects in the System Tree pane. Typical non-presentation objects are
Plain English programs and Function Block programs, values, and alarms.
For more information, see section 49.2 System Tree Pane on page 1567.

To show non-presentation objects in the System Tree pane

1. Click the Show/Hide non-presentation objects button .

System 04-17005-03-en, October 2015


1684
51 Building Operation Objects
51.8 Multi-edit

51.8 Multi-edit
Use Multi-edit when you want to change a lot of property values at the same time.
For example, you want to change all setpoints from 22 to 20. You select all the
objects in the List View, open the Properties grid, and then change the value in the
Value box. After you click Save, the changes take effect.

Figure: Multiediting
The objects do not need to be of the same type to be edited. However, the
properties you want to edit have to be of the same type.

04-17005-03-en, October 2015 System


1685
51 Building Operation Objects
51.9 Editing Multiple Objects

51.9 Editing Multiple Objects


You can edit more than one object at the same time to save time.
For more information, see section 51.8 Multi-edit on page 1685.

To edit multiple objects


1. In WorkStation, in the List View, select the objects you want to edit.
2. On the List View toolbar, click Show/Hide Property Grid.
3. In the Property Grid, edit the property you want to change for all selected
objects.

4. Click the Save button .

System 04-17005-03-en, October 2015


1686
51 Building Operation Objects
51.10 Move, Copy, Paste, Rename, and Delete

51.10 Move, Copy, Paste, Rename, and Delete


You can move, copy, paste, rename, and delete objects from the Building
Operation database at any time. To help you identify the object references that are
affected when you delete an object, Building Operation displays a dialog box with
information about references.

Move
Move does not affect the references. When you move an object, that object still
references the same objects it referenced before you moved it. Objects referring to
a moved object still refer to the same object after the move. Object cannot be
moved between SmartStruxure servers however.

Paste
Paste removes all external references that are relative but keeps absolute and
locked references.

Paste Special
Paste Special does the same thing as Paste but with the added benefit of keeping
all of the external references.

Rename
Objects that are referring to each other do not lose their references if you change
the name of an object. Building Operation automatically updates any references
after you have renamed an object.

Delete
When deleting an object, you can select to keep the reference in other objects to
the object you want to delete. You can then add a new object with the same name
on the same location and all references are valid. This can be used if you, for
example want to replace an analog value with a digital value or a multistate value.

Offline
If some of the objects are offline during a rename or delete, the system cannot
update the references. In this case, the system informs you of the references that
cannot be updated. You can still complete the procedure, but you have to keep
track of the reference that are not updated. You can repair the references when the
offline object is online again.

Note
When changing the name of a folder or SmartStruxure server, you also have to
reconfigure users and user groups path permissions to this SmartStruxure server
or folder. For more information, see section 22.4 Path Permissions on page
488.

04-17005-03-en, October 2015 System


1687
51 Building Operation Objects
51.11 Deleting an Object

51.11 Deleting an Object


You delete unused objects from the database to get rid of unused objects or
objects you do not want.
For more information, see section 51.10 Move, Copy, Paste, Rename, and Delete
on page 1687.

To delete an object
1. In WorkStation, in the System Tree pane, select the object you want to
delete.
2. On the Edit menu, click Delete.
3. Select if you want to keep references in other object(s) to the object you
selected to delete.
4. Click Show references to see the affected references.
5. In the Confirm Delete dialog box, click Yes.

System 04-17005-03-en, October 2015


1688
51 Building Operation Objects
51.12 Renaming a Folder or Object

51.12 Renaming a Folder or Object


You rename a folder or object to make the name more suitable to your needs.

Note
When changing the name of a folder or SmartStruxure server, you also have to
reconfigure users and user groups path permissions to this SmartStruxure server
or folder. For more information, see section 22.4 Path Permissions on page
488.

Note
You cannot change the name of a domain that is shared between SmartStruxure
servers.

For more information, see section 51.10 Move, Copy, Paste, Rename, and Delete
on page 1687.

To rename a folder or object


1. In WorkStation, in the System Tree pane, select the folder or object you
want to rename.
2. On the Edit menu, click Rename.
3. In the Rename object dialog box, type the new name.
4. Click OK.

04-17005-03-en, October 2015 System


1689
51 Building Operation Objects
51.13 Creating a Folder

51.13 Creating a Folder


You create folders to organize your Building Operation database.
For more information, see the Xenta LonWorks Groups topic on WebHelp.

To create a folder
1. In WorkStation, in the System Tree pane, select the folder, SmartStruxure
server, or network where you want to create the folder.
2. On the File menu, point to New and then click Folder.
3. In the Name box, type a name for the folder.

4. In the Description box, type a description for the folder.


5. Click Create.

System 04-17005-03-en, October 2015


1690
51 Building Operation Objects
51.14 Copying a Folder or Object

51.14 Copying a Folder or Object


You copy a folder or object when you quickly want to create a new folder or object.

To copy a folder or object


1. In WorkStation, in the System Tree pane, select the folder or object you
want to copy.
2. On the Edit menu, click Copy.
3. In the System Tree pane, select the folder where you want to paste the
copied folder or object.
4. On the Edit menu, click Paste.

04-17005-03-en, October 2015 System


1691
52 Archive

Topics
Archiving Overview
Archiving SmartStruxure Server Compatibility
Enabling the Archiving Function and Defining the Archive
Folder
Archiving Formats and Storage
Manual and Scheduled Archiving
Manually Creating an Archive
Creating a Scheduled Archive
Removing Extended Trend Logs from the Archive
Removing Events from the Archive
Archive Folders, Files, and Names
Archive Log Contents
Event and Alarm Enumerations
System Alarm ID Enumerations
System Event ID Enumerations
Trend Log Enumerations
System Alarms For Archiving
52 Archive
52.1 Archiving Overview

52.1 Archiving Overview


Archiving is the process of preserving historical data, which is comprised of
selected events and extended trend logs. For example, some facilities are required
to maintain archives to comply with government regulations. Another example is in
secure facilities where they must maintain records of who logged in or who
changed setpoints. Archiving is not a backup function because archive data cannot
be imported back into the system.
Archiving is a function of an Enterprise Server. Therefore, you cannot archive data
on a standalone SmartStruxure server device. However, you can archive trend logs
and extended trend logs created on a SmartStruxure server device that are
monitored by extended trend logs created on an Enterprise Server.

Figure: Archiving overview

Important
The Enterprise Server Windows service runs under the System account of the
local machine, or a another custom account, where the Enterprise Server is
installed. If you plan to save the archive files to a network drive, make sure that the
System acccount or the custom account is given write access to this drive to
ensure that the archive process can validate the path and then save the files to
that location.

04-17005-03-en, October 2015 System


1695
52 Archive
52.1 Archiving Overview

52.1.1 Archive Log Files


The system archives historical data into two types of log files:
Event logs: All the selected alarm, user activity, and system events are archived
into one file.

Extended trend logs: The system archives data collected from selected
extended trend logs created on the Enterprise Server.

52.1.2 Archiving Formats and Storage


You generate an archive by selecting either a CSV or XML format. You can store the
archive in the default location or define a different location.
For more information, see section 52.4 Archiving Formats and Storage on page
1701.

52.1.3 Archive Folders, Files, and Names


The archving process creates uniquely named folders to identify the type of archive
(manual or scheduled) and the date on which the archive was performed. Each
folder includes the log files that were archived on that date.
For more information, see section 52.10 Archive Folders, Files, and Names on
page 1713.

52.1.4 Archiving Server Compatibility


You can configure archiving on an Enterprise Server.
For more information, see section 52.2 Archiving SmartStruxure Server
Compatibility on page 1698.

System 04-17005-03-en, October 2015


1696
52 Archive
52.1 Archiving Overview

52.1.5 System Alarms for Archiving


There are several default system alarms for archiving.
For more information, see section 52.16 System Alarms For Archiving on page
1742.

52.1.6 Manual and Scheduled Archiving


You can archive data as needed using manual methods or at predefined intervals
using a schedule.
For more information, see section 52.5 Manual and Scheduled Archiving on page
1702.

04-17005-03-en, October 2015 System


1697
52 Archive
52.2 Archiving SmartStruxure Server Compatibility

52.2 Archiving SmartStruxure Server


Compatibility
You can configure archiving on an Enterprise Server.
The following table lists the SmartStruxure servers that support archiving
capabilities.

Table: Archiving and SmartStruxure Server Compatibility Matrix


Server Runtime Description
Archiving?

Enterprise Yes You can configure and manage archiving on an


Server Enterprise Server.

SmartStruxure No You cannot configure or initiate archiving on a


server device SmartStruxure server device. The system only
archives data from trend logs or extended trend logs
on SmartStruxure server devices that are monitored
by extended trend logs on the Enterprise Server.

System 04-17005-03-en, October 2015


1698
52 Archive
52.3 Enabling the Archiving Function and Defining the Archive Folder

52.3 Enabling the Archiving Function and


Defining the Archive Folder
Prior to generating an archive, you activate the archiving function and define a path
to a directory on the Enterprise Server where you want to store the archives.
For more information, see section 52.1 Archiving Overview on page 1695.

To enable the archiving function and define the archive folder


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Archiving.
Continued on next page

04-17005-03-en, October 2015 System


1699
52 Archive
52.3 Enabling the Archiving Function and Defining the Archive Folder

4. Select Enabled.

5. In the Path box, type the path to the directory where you plan to store the
archive files.
6. Click Validate to confirm that the path is valid on the system.

A check mark displays if the system successfully validates the path.

7. Click the Save button .


You designate a different archive directory by typing a new location in the Path box
and then validating the path again.

System 04-17005-03-en, October 2015


1700
52 Archive
52.4 Archiving Formats and Storage

52.4 Archiving Formats and Storage


You generate an archive by selecting either a CSV or XML format. You can store the
archive in the default location or define a different location.

Table: Comparison of Archiving Formats


Method Description

CSV Comma Separated Values is a standard text file that stores spreadsheet or
database information in a simple table format. Each record is on a separate
line and each field within that record is separated by a delimiter, such as a
comma.

XML Extensible Markup Language is a markup language that defines a set of


rules for formatting documents. Primarily, XML is used to structure,
transport, and store data rather than to display data.

52.4.1 Archive Storage and Validation


By default, the system stores archive files in the Archives folder located in Program
Data/Schneider Electric StruxureWare/Building Operation <version>/Enterprise
Server/db. You can define a different path to store the archives on your file system,
such as a network drive or external memory device. To ensure that the new location
is valid, you can prompt the system to validate the path. For more information, see
section 52.3 Enabling the Archiving Function and Defining the Archive Folder on
page 1699.

04-17005-03-en, October 2015 System


1701
52 Archive
52.5 Manual and Scheduled Archiving

52.5 Manual and Scheduled Archiving


You can archive data as needed using manual methods or at predefined intervals
using a schedule.

Table: Comparison of Archiving Methods


Method Benefits

Manual Performed on an as-needed basis, for example, prior to upgrading an


Enterprise Server. When a Manual Archive is created, the temporary
archive data is not deleted.

Scheduled Automatically generated by the system at regularly scheduled intervals.


When a Scheduled Archive completes, the temporary archive data is
deleted.

Scheduled archiving is an automated way of preserving historical data. For


convenience, the system provides a default digital schedule, which is bound to the
Archive Manager. You can modify, but not delete, this Archive schedule. For more
information, see section 52.1 Archiving Overview on page 1695.

System 04-17005-03-en, October 2015


1702
52 Archive
52.6 Manually Creating an Archive

52.6 Manually Creating an Archive


You create an archive manually to preserve the historical data on an Enterprise
Server on an as-needed basis, such as before a system upgrade.
For more information, see section 52.5 Manual and Scheduled Archiving on page
1702.

To manually create an archive


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the Enterprise Server.

3. Click Archiving.
Continued on next page

04-17005-03-en, October 2015 System


1703
52 Archive
52.6 Manually Creating an Archive

4. Under Archive Settings, click Enabled.

5. Select the events that you want to include in the archive:


Alarm Events. Select to include high priority or off-normal events
(providing the alarms are pre-configured and active on the system.)
User Events. Select to include user-initiated events, such as value
overrides or configuration changes.
System Events. Select to include device-initiated events, such as time
stamps.

6. Click the Add extended trend logs button to add extended trend logs
to the archive.
Continued on next page

System 04-17005-03-en, October 2015


1704
52 Archive
52.6 Manually Creating an Archive

7. In the Include column, select the extended trend logs and click OK.

8. In the Output Type box, select the format you want to use for the archive:
CSV. This output generates data separated by a delimiter.
XML. This output generates data using a standard internet protocol.
9. In the Path box, type the path to an existing folder or server where you want
to store the archive files.
Continued on next page

04-17005-03-en, October 2015 System


1705
52 Archive
52.6 Manually Creating an Archive

10. Click Validate to confirm that the path is valid on the system.

A check mark displays if the system successfully validates the path.

11. Click the Save button .


12. Click Archive Now.
The archive is saved to the specified path.

System 04-17005-03-en, October 2015


1706
52 Archive
52.7 Creating a Scheduled Archive

52.7 Creating a Scheduled Archive


You configure the Archive settings and schedule on the Enterprise Server to
automate the archiving process.
For more information, see section 52.5 Manual and Scheduled Archiving on page
1702.

To create a scheduled archive


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the Enterprise Server.

3. Click Archiving.
Continued on next page

04-17005-03-en, October 2015 System


1707
52 Archive
52.7 Creating a Scheduled Archive

4. Under Archive Settings, click Enabled.

5. Select the events that you want to include in the archive:


Alarm Events: Select to include high priority or off-normal events
(providing the alarms are pre-configured and active on the system).
User Events: Select to include user-initiated events, such as value
overrides or configuration changes.
System Events: Select to include device-initiated events, such as time
stamps.

6. Click the Add extended trend logs button to add extended trend logs
to the archive.
Continued on next page

System 04-17005-03-en, October 2015


1708
52 Archive
52.7 Creating a Scheduled Archive

7. In the Include column, select the extended trend logs and click OK.

8. Under Archive Schedule, click Schedule to create recurring exception and


calendar events.
9. In the Output Type box, select the format you want to use for the archive:
CSV: This output generates data separated by a delimiter.
XML: This output generates data using a standard internet protocol.
10. In the Path box, type the path to an existing archive directory where you want
to store the archive files.
11. Click Validate to confirm that the path is valid on the system.
Continued on next page

04-17005-03-en, October 2015 System


1709
52 Archive
52.7 Creating a Scheduled Archive

A check mark displays if the system successfully validates the path.

12. When finished, click the Save button .

System 04-17005-03-en, October 2015


1710
52 Archive
52.8 Removing Extended Trend Logs from the Archive

52.8 Removing Extended Trend Logs from


the Archive
You remove extended trend logs that you do not want to include in the archive.
For more information, see section 52.1 Archiving Overview on page 1695.

To remove extended trend logs from the archive


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the Enterprise Server.

3. Click Archiving
4. Select the extended trend logs that you want to remove from the archive and
click the Remove extended trend logs button .

5. Click the Save button .

04-17005-03-en, October 2015 System


1711
52 Archive
52.9 Removing Events from the Archive

52.9 Removing Events from the Archive


You remove events that you do not want to include in the archive, such as User
Events.
For more information, see section 52.1 Archiving Overview on page 1695.

To remove events from the archive


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Archiving.
4. Clear the events that you want to remove from the archive.

5. Click the Save button .

System 04-17005-03-en, October 2015


1712
52 Archive
52.10 Archive Folders, Files, and Names

52.10 Archive Folders, Files, and Names


As part of the archive process, the system creates uniquely named archive files and
folders that identify the type of archive (manual or scheduled) and the date on which
the archive was performed.

Figure: Archives folder on Enterprise Server


By default, these folders are located in the Archives directory where the Enterprise
Server is installed. However, you can change the directory to another valid location.

52.10.1 Archive Folder Names


During the archive process, the system creates a new folder in the path specified in
the Archive Settings Manager. The system generates and then places the CSV or
XML files within this folder. To prevent accidental overwriting, the system uses the
Method_date.file extension format, which makes the folder name unique. For
example, if you manually generate an archive on April 11, 2012, the system creates
a folder named Manual_Archive20120411 (yyyymmdd). If you generate an archive
the following day, the system creates a new folder with the new date.

52.10.2 Archive System Resource Files


When archiving is enabled, the system creates resource files that collect the data
from the selected extended trend logs prior to archiving. The system names the files
using random hexadecimal characters, such as a2d9e877, and then places them in
the path specified in the Archive Settings Manager. These files should not be
deleted.

04-17005-03-en, October 2015 System


1713
52 Archive
52.10 Archive Folders, Files, and Names

52.10.3 File Names for Extended Trend Log Archives


The system names extended trend log archive files using the
Method_(Address)_date.file extension format. If you generate a manual archive in
CSV format for extended trend logs on on July 8, 2012, the system names the file,
Manual_Archive_(Server_1_<Extended_Trend_Log name>)_2012-07-01_2012-07-
08.csv.

52.10.4 File Names for Events Log Archives


The system names the event log archives using the Method_(EventLog)_date.file
extension format. If you manually generate an archive on April 11, 2012 for the
Alarm, User, and System events, the system names the archive file
Manual_Archive_(Server_1_System_Events_EventLog_EventRecords)_2012-04-
02_2012-04-11.csv.

52.10.5 Unique Archive File Names


If you generate more than one archive file on the same date, the system appends a
number to the end of each similarly named archive to ensure that the files are not
overwritten. For example, if you manually generate an archive named
Manual_(Server_1_System_Events_EventLog_EventRecords)_2012-04-02_2012-
04-11.csv and immediately generate another identical archive, the system names
the second archive,
Manual_(Server_1_System_Events_EventLog_EventRecords)_2012-04-02_2012-
04-11_1.csv. Using the appended number (_1), the system creates a unique name
for the second archive with the same method on the same date.

52.10.6 Archive Log Contents


You use a structured database editor to view archive information in rows and
columns, which may contain text strings, paths, identities, or enumeration values.
For more information, see section 52.11 Archive Log Contents on page 1715.

System 04-17005-03-en, October 2015


1714
52 Archive
52.11 Archive Log Contents

52.11 Archive Log Contents


You use a structured database editor to view archive information in rows and
columns, which may contain text strings, paths, identities, or enumeration values.

Figure: Archive data displayed in a spreadsheet editor

Note
The time stamps for each record in the archive file reflect the UTC rather than
local machine time.

52.11.1 Columns and Descriptions


The following table provides an overview of an archive file. The number and type of
columns that display varies with the log that is viewed. For example, trend logs have
a different set of column headers than event logs due to the data content.

Table: Archive Files Column and Descriptions


Column Description

AcknowledgeTime Displays the time and date when the alarm was
acknowledged.

AlarmState Displays the present alarm state.

AlarmText Displays the alarm message that was added to the alarm.

AssignedState Displays the assigned state the alarm had.

AssignedToDomain Displays the domain to which the user or group was


assigned.

AssignedToName Displays the name of the user or group to which an alarm


was assigned.

AssignedToUniqueUserId Displays the unique ID of the user or group to which an


alarm was assigned.

BACnetEventType Displays the BACnet event that occurred within a BACnet


network.

04-17005-03-en, October 2015 System


1715
52 Archive
52.11 Archive Log Contents

Continued
Column Description

BasicEvaluationState Displays the basic evaluation state of an alarm.

Category Displays the name of a category.

Command Displays the executed command.

Comment Displays the comment that was added to an alarm.

ControlDescr Displays the descriptive information about the I/NET


operator.

ControlSource Displays the initials of the controlling I/NET operator.

Count Displays the number of times the alarm has toggled


between the alarm and reset state.

CWSId Displays the ID of the EcoStruxure Web Service (EWS)


object.

CWSSourceId Displays the ID of the EWS source object.

CWSSourceName Displays the name and path of the EWS source object.

Description Displays a brief summary of the major features or


characteristics.

DeviceName Displays the name of an I/NET device that generated the


event.

DisabledCause Displays the reason why the alarm was disabled, such as a
shunt variable.

DomainName Displays the domain to which a user belongs.

EditTime Displays the time when the

EndTime Displays the time when the

EndValue Displays the

EvaluationState Displays the present evaluation state of the alarm, such as


Upper limit alarm.

Event Displays an event that occurred within the network.

EventGUID Displays the unique identity of the event.

FirstName Displays the first name of the individual whose key/card


was used at the I/NET door point.

ForcedValue Displays the forced value events.

GroupName Displays the name of the cause note or action note group
the user edited.

Hidden Displays the visible status of an object, such as False.

System 04-17005-03-en, October 2015


1716
52 Archive
52.11 Archive Log Contents

Continued
Column Description

InetAddr Displays the system address of the point, or station


address of the host or controller that generated the event.

IndivNdx Displays the number of the individual whose key/card was


used at the I/NET door point.

InetEventTypeId Displays the IDs of the I/NET event types generated by the
system.

ItemName Displays the name of the check list, cause note, or action
note group the user edited.

LastName Displays the last name of the individual whose key/card


was used at the I/NET door point.

LinkName Displays the name assigned to the link of the device from
which the event originated.

LogType Displays the

MaxValue Displays the

MessageText Displays the text of an I/NET action or dispatch message.


(Optional)

MeterConstant Displays the

MinValue Displays the

MonitoredValue Displays the path of the monitored variable.

MonitoredValueType Displays the type of monitored value that triggers an alarm,


such as Forced.

MonitoredVariable Displays the path of the monitored variable.

Note Displays the text entered into the Note 1 property.

OriginalSeqNo Displays the RefSeqNo collected from a trend log. This


number is only written on an extended trend log containing
records that were changed on the connected trend log.

OriginatedGUID Displays the unique identity of the source.

PreviousAlarmState Displays the previous alarm state.

Priority Displays the current priority of the alarm.

RefSeqNo Displays the unique sequence number of a record that has


been edited.

SEQNO Displays the sequence number of the record.

ServerOffline Displays the online/offline status of a SmartStruxure server.

Source Displays the name and path of the source object.

04-17005-03-en, October 2015 System


1717
52 Archive
52.11 Archive Log Contents

Continued
Column Description

SourceServer Displays the name and path of the source object.

StationName Displays the name assigned to the controller from which


the event originated.

StartTime Displays the

StartValue Displays the

Status Displays the

SystemAlarmId Displays the alarm ID generated by the system.

SystemEventId Displays the event ID generated by the system.

TenantNdx Displays the tenant number of the individual whose


key/card was used at the I/NET door point.

TextField Displays the information entered into the Text property.

TimeStamp Displays the date and time when the record was
generated.

TriggeredTimestamp Displays the time and date an alarm went from normal
state to alarm state.

TYPE Displays the object type that defines the properties of the
object.

UniqueAlarmId Displays the unique alarm ID of an alarm.

UniqueUserId Displays the unique identity number of a user.

Unit Displays the selected unit of a value, such as F


(Fahrenheit).

User Displays the user who generated the event.

UserName Displays the name of the user who generated the event.

Value Displays the

ValueAfter Displays the value of an object after it was changed.

ValueBefore Displays the value of an object before it was changed.

Zone Displays the I/NET security zone number associated with a


security event.

52.11.2 Event and Alarm Enumerations


An enumeration is a range of values representing a specific command or event.
For more information, see section 52.12 Event and Alarm Enumerations on page
1720.

System 04-17005-03-en, October 2015


1718
52 Archive
52.11 Archive Log Contents

52.11.3 Trend Log Enumerations


An enumeration is a range of values representing a specific command or event.
Trend log properties use two enumeration values: Events and Status.
For more information, see section 52.15 Trend Log Enumerations on page 1740.

04-17005-03-en, October 2015 System


1719
52 Archive
52.12 Event and Alarm Enumerations

52.12 Event and Alarm Enumerations


An enumeration is a range of values representing a specific command or event.
The following tables list the enumeration values for the supported alarm and event
properties.

52.12.1 Alarm State


The table lists the enumeration values for Alarm State.

Table: Alarm State


Enumeration Enumeration definition
value

0 Normal

1 Alarm

2 Acknowledged

3 Reset

4 Disabled

5 Fault

52.12.2 Assigned State


The table lists the enumeration values for Alarm State.

Table: Assigned State


Enumeration Enumeration definition
value

0 Unassigned

1 Assigned

2 Accepted

52.12.3 BACnet Alarm Type


The table lists the enumeration values for BACnet Alarm Type.

System 04-17005-03-en, October 2015


1720
52 Archive
52.12 Event and Alarm Enumerations

Table: BACnet Alarm Type


Enumeration Enumeration definition
Value

0 Change of bitstring

1 Change of state

2 Change of value

3 Command failure

4 Floating limit

5 Out of range

6 Complex event type

8 Change of life safety

9 Extended

10 Buffer ready

11 Unsigned range

52.12.4 Basic Evaluation State


The table lists the enumeration values for Basic Evaluation State.

Table: Basic Evaluation State


Enumeration Enumeration definition
value

0 False

1 True

52.12.5 Disabled Cause


The table lists the enumeration values for Disabled Cause.

Table: Disabled Cause


Enumeration Enumeration definition
value

1 Shunt variable

2 User

4 System

04-17005-03-en, October 2015 System


1721
52 Archive
52.12 Event and Alarm Enumerations

Enumeration Enumeration definition


value

52.12.6 Evaluation State


The table lists the enumeration values for Evaluation State.

Table: Evaluation State


Enumeration Enumeration definition
value

0 Normal

1 Off-normal alarm

2 Upper limit alarm

3 Lower limit alarm

4 Life safety alarm

5 Faulty alarm

52.12.7 Hidden
The table lists the enumeration values for Hidden.

Table: Hidden
Enumeration Enumeration definition
value

0 False

1 True

52.12.8 Previous Alarm State


The table lists the enumeration values for Previous Alarm State.

Table: Previous Alarm State


Enumeration Enumeration definition
value

0 Normal

1 Alarm

2 Acknowledged

System 04-17005-03-en, October 2015


1722
52 Archive
52.12 Event and Alarm Enumerations

Continued
Enumeration Enumeration definition
value

3 Reset

4 Disabled

5 Fault

52.12.9 System Alarm ID


The table lists the enumeration values for System Alarm ID. For more information,
see section 52.13 System Alarm ID Enumerations on page 1724.

52.12.10 System Event ID


The table lists the enumeration values for System Event ID. For more information,
see section 52.14 System Event ID Enumerations on page 1733.

04-17005-03-en, October 2015 System


1723
52 Archive
52.13 System Alarm ID Enumerations

52.13 System Alarm ID Enumerations


An enumeration is a range of values representing a specific command or event.
The table lists the enumeration values for System Alarm ID. For more information,
see section 52.12 Event and Alarm Enumerations on page 1720.

Table: System Alarm ID


Enumeration Enumeration definition
value

0 SmartStruxure server restarted

1 IO module offline

2 SmartStruxure server offline

4 E-mail service failed to connect to SMTP server

5 E-mail service failed to login to SMTP server

6 System cold start

7 System warm start

8 System factory reset

9 Device offline

a Signal alarm

b Cannot verify lead object status

c Duplicate of local network

d Duplicate network identifier

e Duplicate device identifier

f Invalid device identifier

10 Duplicate device address

11 Duplicate device name

12 Defective protocol implementation

13 BACnet did not start

14 Failed to create object

15 Failed to initialize references

16 Database update failed

17 A log sample was missed

18 A log data transfer was missed

System 04-17005-03-en, October 2015


1724
52 Archive
52.13 System Alarm ID Enumerations

Continued
Enumeration Enumeration definition
value

19 File I/O error

1a SmartStruxure server configuration error

1b Network offline

1c IP connection offline

1d Signal event

1e New application program

1f Parser failed

20 Unit is locked

21 Unit is unlocked

22 Logging started

23 Logging stopped

24 Log stopped because it is full

25 Log full

26 Not enough RAM memory for log

27 Too many log definitions

28 Error in log definition

29 Not enough flash memory for log

2a Log variable error

2b No valid Blueprint File

2c Unhandled buffer ready notification

2d Alarm signal trigger buffer full

2e Bad lead object reference

2f Bad lead object type

30 Shadow update failed

31 Unable to access lead object

32 Incorrect lead object back-reference

33 Unable to access shadow object

34 Server not restarted Backup in process

04-17005-03-en, October 2015 System


1725
52 Archive
52.13 System Alarm ID Enumerations

Continued
Enumeration Enumeration definition
value

25 Server not restarted Restore in process

36 Server not restarted Other

37 Failure retrieving backup set from remote server

38 Failure restoring server database

39 Failure backing up server database

3a E-mail service fail to send message

3b E-mail service configuration error

3c Port offline

3d Wrong alarm unit

3e BACnet server failure

3f Sigma system schedule executed

40 Subnet offline

41 Invalid device address

64 Invalid archive path

65 Archive path must be set to enable archiving

66 Archive directory does not exist! Retrying in 5 minutes!

67 Archive directory does not exist!

68 Can not enable archiving

69 Invalid archiving format

6a Archiving is not enabled

6b IO error when generating archive

6c IO error when writing to archive temporary

6d IO error, cannot write to archive directory!

6e IO error, cannot write to archive directory! Retrying in 5 minutes!

6f IO error, not enough space left in the archive directory!

70 IO error, not enough space left in the archive directory! Retrying in 5


minutes!

73 Archiving failed because of an ongoing operation

System 04-17005-03-en, October 2015


1726
52 Archive
52.13 System Alarm ID Enumerations

Continued
Enumeration Enumeration definition
value

74 Archiving canceled due to configuration change

100 Communication failed

101 Communication failed Configuration error

102 Communication failed Unexpected Server fullpath

103 Communication failed Unexpected Server type

104 Communication failed Authentication error

105 Communication failed Authorization error

106 Communication failed Domain is not available

107 Communication failed Hostname is invalid

108 Communication failed Version Mismatch

200 Task 1 CPU limit reached, disabling real time priority

201 Task 2 CPU limit reached, disabling real time priority

211 Email service no sender email address

212 Email service no recipient email address

213 Email service no sender and recipient email address

214 Task period extended

215 No file name set

216 Module type mismatch

217 Serial port in use

1f40 NETWORK 8000 message

1f41 NW8 Unrecognized command

1f42 NW8 Command failure

1f43 NW8 Leaves network event

1f44 NW8 Joins network event

1f45 NW8 ASD message

1f46 NW8 Leaves/joins network

1f4a NW8 Database initialized

1f4b NW8 ROM failure

04-17005-03-en, October 2015 System


1727
52 Archive
52.13 System Alarm ID Enumerations

Continued
Enumeration Enumeration definition
value

1f4c NW8 RAM failure

1f4d NW8 Freeze error

1f4e NW8 Database modified

1f4f NW8 Device warm reset

1f50 NW8 Device cold reset

1f51 NW8 AS1 diagnostic

1f52 NW8 AT1 diagnostic

1f53 NW8 AT2 diagnostic

1f54 NW8 UI diagnostic

1f55 NW8 UI1 diagnostic

1f56 NW8 UI2 diagnostic

1f57 NW8 UI3 diagnostic

1f58 NW8 UI4 diagnostic

1f59 NW8 UI5 diagnostic

1f5a NW8 UI6 diagnostic

1f5b NW8 UI7 diagnostic

1f5c NW8 UI8 diagnostic

1f5e NW8 Relay failure

1f5f NW8 Relay failure 01

1f60 NW8 Relay failure 02

1f61 NW8 Relay failure 03

1f62 NW8 Relay failure 04

1f63 NW8 Relay failure 05

1f64 NW8 Relay failure 06

1f65 NW8 Relay failure 07

1f66 NW8 Relay failure 08

1f67 NW8 Relay failure 09

1f68 NW8 Relay failure 10

System 04-17005-03-en, October 2015


1728
52 Archive
52.13 System Alarm ID Enumerations

Continued
Enumeration Enumeration definition
value

1f69 NW8 Relay failure 11

1f6a NW8 Relay failure 12

1f6b NW8 Relay failure 13

1f6c NW8 Relay failure 14

1f6d NW8 Relay failure 15

1f6e NW8 Relay failure 16

1f6f NW8 Relay failure 17

1f70 NW8 Relay failure 18

1f71 NW8 Relay failure 19

1f72 NW8 Relay failure 20

1f73 NW8 Relay failure 21

1f74 NW8 Relay failure 22

1f75 NW8 Relay failure 23

1f76 NW8 Relay failure 24

1f77 NW8 Relay failure 25

1f78 NW8 Relay failure 26

1f79 NW8 Relay failure 27

1f7a NW8 Relay failure 28

1f7b NW8 Relay failure 29

1f7c NW8 Relay failure 30

1f7d NW8 Relay failure 31

1f7e NW8 Relay failure 32

1f7f NW8 Relay failure 33

1f80 NW8 Relay failure 34

1f81 NW8 Relay failure 35

1f82 NW8 Relay failure 36

1f83 NW8 Relay failure 37

1f84 NW8 Relay failure 38

04-17005-03-en, October 2015 System


1729
52 Archive
52.13 System Alarm ID Enumerations

Continued
Enumeration Enumeration definition
value

1f85 NW8 Relay failure 39

1f86 NW8 Relay failure 40

1f87 NW8 Relay failure 41

1f88 NW8 Relay failure 42

1f89 NW8 Relay failure 43

1f8a NW8 Relay failure 44

1f8b NW8 Relay failure 45

1f8c NW8 Relay failure 46

1f8d NW8 Relay failure 47

1f8e NW8 Relay failure 48

1f90 NW8 Setpoint out of range

1f91 NW8 Duct temperature out of range

1f92 NW8 Zone temperature out of range

1f93 NW8 Device reset

1f94 NW8 Configuration error

1f95 NW8 Damper range error

1f96 NW8 Pressure error

1f97 NW8 EEprom memory error

1f98 NW8 Application modified

1f99 NW8 Missing changeover input

1f9a NW8 EEprom checksum error

1f9b NW8 Sensor input failure

1f9c NW8 System fault 32

1f9d NW8 No U-Link communication

1f9e NW8 Application error 1

1f9f NW8 Application error 2

1fa0 NW8 Application error 4

1fa1 NW8 Application error 16

System 04-17005-03-en, October 2015


1730
52 Archive
52.13 System Alarm ID Enumerations

Continued
Enumeration Enumeration definition
value

1fa4 NW8 Press sensor

1fa5 NW8 Duct temperature

1fa6 NW8 Minimum flow potentiometer

1fa7 NW8 Maximum flow potentiometer

1fa8 NW8 Hot water potentiometer

1fa9 NW8 Induction auxilary potentiometer

1faa NW8 Space setpoint

1fab NW8 Space temperature

1faf NW8 Sensor failure GCS 01

1fc3 NW8 Sensor failure GCS 02

1fd7 NW8 Sensor failure GCS 03

1feb NW8 Sensor failure GCS 04

1fff NW8 Sensor failure GCS 05

2013 NW8 Sensor failure GCS 06

2027 NW8 Sensor failure GCS 07

203b NW8 Sensor failure GCS 08

204f NW8 Sensor failure GCS 09

2063 NW8 Sensor failure GCS 10

2077 NW8 Sensor failure GCS 21

208b NW8 Sensor failure GCS 22

209f NW8 Sensor failure GCS 23

20b3 NW8 Sensor failure GCS 24

20c7 NW8 Sensor failure GCS 25

20db NW8 Sensor failure GCS 26

20ef NW8 Sensor failure GCS 27

2103 NW8 Sensor failure GCS 28

2117 NW8 Sensor failure GCS 29

212b NW8 Sensor failure GCS 30

04-17005-03-en, October 2015 System


1731
52 Archive
52.13 System Alarm ID Enumerations

Continued
Enumeration Enumeration definition
value

213f NW8 Sensor failure GCS 31

2150 NW8 Sensor failure end

2151 NW8 Leaves LCM network event

2152 NW8 Joins LCM network event

2153 NW8 Leaves/joins LCM network

2197 NETWORK 8000 message end

2198 CWS Method Error

2199 CWS Value Poll failed

219a CWS Alarm Poll failed

219b CWS Browse failed

219c CWS GetObject failed

219d CWS GetHistory failed

219e See gap after 0x200

System 04-17005-03-en, October 2015


1732
52 Archive
52.14 System Event ID Enumerations

52.14 System Event ID Enumerations


An enumeration is a range of values representing a specific command or event.
The table lists the enumeration values for System Event ID. For more information,
see section 52.12 Event and Alarm Enumerations on page 1720.

Table: System Event ID


Enumeration Enumeration definition
value

0 SmartStruxure server initialized

1 SmartStruxure server shutdown

2 User logged on

3 User logged off

4 Log on failed - account disabled

5 Log on failed - authentication

6 Log on failed - domain not found

7 Log on failed - domain controller unavailable

8 Log on failed - domain controller unavailable

9 Log on failed - no permissions

a Password changed

b Property changed

c Command executed

d IO module offline

e IO module online

f Object created

10 Object deleted

11 Objects imported

12 Objects deployed

13 Object moved

14 Object renamed

15 File notification sent

16 Email sent successfully

17 Object changed

04-17005-03-en, October 2015 System


1733
52 Archive
52.14 System Event ID Enumerations

Continued
Enumeration Enumeration definition
value

18 Log on failed - user not associated with a group

19 SmartStruxure server database backed up

1a SmartStruxure server database restored

1b Signal event

1c Forced value

1d New forced value

1e Unforce value

1f Log on failed - version mismatch

1f40 NETWORK 8000 message

1f41 NW8 Unrecognized command

1f42 NW8 Command failure

1f43 NW8 Leaves network event

1f44 NW8 Joins network event

1f45 NW8 ASD message

1f46 NW8 Leaves/joins network

1f4a NW8 Database initialized

1f4b NW8 ROM failure

1f4c NW8 RAM failure

1f4d NW8 Freeze error

1f4e NW8 Database modified

1f4f NW8 Device warm reset

1f50 NW8 Device cold reset

1f51 NW8 AS1 diagnostic

1f52 NW8 AT1 diagnostic

1f53 NW8 AT2 diagnostic

1f54 NW8 UI diagnostic

1f55 NW8 UI1 diagnostic

1f56 NW8 UI2 diagnostic

System 04-17005-03-en, October 2015


1734
52 Archive
52.14 System Event ID Enumerations

Continued
Enumeration Enumeration definition
value

1f57 NW8 UI3 diagnostic

1f58 NW8 UI4 diagnostic

1f59 NW8 UI5 diagnostic

1f5a NW8 UI6 diagnostic

1f5b NW8 UI7 diagnostic

1f5c NW8 UI8 diagnostic

1f5e NW8 Relay failure

1f5f NW8 Relay failure 01

1f60 NW8 Relay failure 02

1f61 NW8 Relay failure 03

1f62 NW8 Relay failure 04

1f63 NW8 Relay failure 05

1f64 NW8 Relay failure 06

1f65 NW8 Relay failure 07

1f66 NW8 Relay failure 08

1f67 NW8 Relay failure 09

1f68 NW8 Relay failure 10

1f69 NW8 Relay failure 11

1f6a NW8 Relay failure 12

1f6b NW8 Relay failure 13

1f6c NW8 Relay failure 14

1f6d NW8 Relay failure 15

1f6e NW8 Relay failure 16

1f6f NW8 Relay failure 17

1f70 NW8 Relay failure 18

1f71 NW8 Relay failure 19

1f72 NW8 Relay failure 20

1f73 NW8 Relay failure 21

04-17005-03-en, October 2015 System


1735
52 Archive
52.14 System Event ID Enumerations

Continued
Enumeration Enumeration definition
value

1f74 NW8 Relay failure 22

1f75 NW8 Relay failure 23

1f76 NW8 Relay failure 24

1f77 NW8 Relay failure 25

1f78 NW8 Relay failure 26

1f79 NW8 Relay failure 27

1f7a NW8 Relay failure 28

1f7b NW8 Relay failure 29

1f7c NW8 Relay failure 30

1f7d NW8 Relay failure 31

1f7e NW8 Relay failure 32

1f7f NW8 Relay failure 33

1f80 NW8 Relay failure 34

1f81 NW8 Relay failure 35

1f82 NW8 Relay failure 36

1f83 NW8 Relay failure 37

1f84 NW8 Relay failure 38

1f85 NW8 Relay failure 39

1f86 NW8 Relay failure 40

1f87 NW8 Relay failure 41

1f88 NW8 Relay failure 42

1f89 NW8 Relay failure 43

1f8a NW8 Relay failure 44

1f8b NW8 Relay failure 45

1f8c NW8 Relay failure 46

1f8d NW8 Relay failure 47

1f8e NW8 Relay failure 48

1f90 NW8 Setpoint out of range

System 04-17005-03-en, October 2015


1736
52 Archive
52.14 System Event ID Enumerations

Continued
Enumeration Enumeration definition
value

1f91 NW8 Duct temperature out of range

1f92 NW8 Zone temperature out of range

1f93 NW8 Device reset

1f94 NW8 Configuration error

1f95 NW8 Damper range error

1f96 NW8 Pressure error

1f97 NW8 EEprom memory error

1f98 NW8 Application modified

1f99 NW8 Missing changeover input

1f9a NW8 EEprom checksum error

1f9b NW8 Sensor input failure

1f9c NW8 System fault 32

1f9d NW8 No U-Link communication

1f9e NW8 Application error 1

1f9f NW8 Application error 2

1fa0 NW8 Application error 4

1fa1 NW8 Application error 16

1fa4 NW8 Press sensor

1fa5 NW8 Duct temperature

1fa6 NW8 Minimum flow potentiometer

1fa7 NW8 Maximum flow potentiometer

1fa8 NW8 Hot water potentiometer

1fa9 NW8 Induction auxilary potentiometer

1fab NW8 Space temperature

1faf NW8 Sensor failure GCS 01

1fc3 NW8 Sensor failure GCS 02

1fd7 NW8 Sensor failure GCS 03

1feb NW8 Sensor failure GCS 04

04-17005-03-en, October 2015 System


1737
52 Archive
52.14 System Event ID Enumerations

Continued
Enumeration Enumeration definition
value

1fff NW8 Sensor failure GCS 05

2013 NW8 Sensor failure GCS 06

2027 NW8 Sensor failure GCS 07

203b NW8 Sensor failure GCS 08

204f NW8 Sensor failure GCS 09

2063 NW8 Sensor failure GCS 10

2077 NW8 Sensor failure GCS 21

208b NW8 Sensor failure GCS 22

209f NW8 Sensor failure GCS 23

20b3 NW8 Sensor failure GCS 24

20c7 NW8 Sensor failure GCS 25

20db NW8 Sensor failure GCS 26

20ef NW8 Sensor failure GCS 27

2103 NW8 Sensor failure GCS 28

2117 NW8 Sensor failure GCS 29

212b NW8 Sensor failure GCS 30

213f NW8 Sensor failure GCS 31

2150 NW8 Sensor failure end

2151 NW8 Leaves LCM network event

2152 NW8 Joins LCM network event

2153 NW8 Leaves/joins LCM network

2197 NETWORK 8000 message end

2198 Trying to send email

219a Failed to send email

219b Deploy started

219c Deploy succeeded

219d Deploy failed

219e Learn started

System 04-17005-03-en, October 2015


1738
52 Archive
52.14 System Event ID Enumerations

Continued
Enumeration Enumeration definition
value

219f Learn succeeded

21a0 Learn failed

21a1 SmartStruxure server deployed

21a2 Deploy command queued

21a3 Learn command queued

21a4 Rebuild change-tracking data command queued

21a5 Rebuild change-tracking data started

2329 Modbus Incompatible to the group

232a Modbus User poll interval selected

232b Modbus Calculated poll interval selected

232c Modbus Group factorized

232d Modbus Group re-factorized

232e Modbus Illegal function code

232f Modbus Illegal data address

2330 Modbus Illegal data value

04-17005-03-en, October 2015 System


1739
52 Archive
52.15 Trend Log Enumerations

52.15 Trend Log Enumerations


An enumeration is a range of values representing a specific command or event.
Trend log properties use two enumeration values: Events and Status.

Table: Event
Enumeration Enumeration definition
value

0 Undefined

1 Log started

2 Log stopped

3 Data cleared

4 Log sample missed

5 Config updated

6 Missed upload

7 Time padding

8 Log unconfigured

9 System clock changed

10 Log status

11 Log interrupted

12 Null value

13 Log database restored

14 Log reset by extended log

Table: Status
Enumeration Enumeration definition
value

0 None

1 Offline

2 Forced

4 Invalid

8 Override

16 In alarm

System 04-17005-03-en, October 2015


1740
52 Archive
52.15 Trend Log Enumerations

Continued
Enumeration Enumeration definition
value

32 Fault

64 Out of service

04-17005-03-en, October 2015 System


1741
52 Archive
52.16 System Alarms For Archiving

52.16 System Alarms For Archiving


There are several default system alarms for archiving.

Table: Archiving System Alarms


System Alarm The system generates an alarm if

Archive Path Must Be Set To Enable The destination path for the archive file is not
Archiving defined.

Archiving Directory Does Not Exist The directory path is not valid.

Archiving Directory Does Not Exist, Retrying The directory path is not valid. The system
in 5 Minutes will restart the archive process in 5 minutes.

Cannot Enable Archiving The Archiving function is not enabled.

Invalid Archiving Format The archiving format is not supported.

Archiving Is Not Enabled Archiving is disabled when a manual archive


is initiated.

To Error, When Generating Archive There is a detected error during the archive
generation.

To Error, When Writing To Archive There is a detected error when the archive is
Temporary saved to a predefined directory.

To Error, Cannot Write To Archive Directory There is a detected error when the archive is
saved to a predefined directory.

To Error, Cannot Write To Archive Directory, There is a detected error when the archive is
Retry in 5 Minutes saved to a predefined directory. The system
will restart the archive process in 5 minutes.

To Error, Not Enough Space Left In The The destination directory does not have
Archive Directory enough storage space for the archive.

To Error, Not Enough Space Left In The The destination directory does not have
Archive Directory, Retrying in 5 Minutes enough storage space for the archive. The
system will restart the archive process in 5
minutes.

System 04-17005-03-en, October 2015


1742
53 Archive User Interface

Topics
Archive Settings Manager Dialog Box
Add Extended Trend Logs Dialog Box
Archiving Settings Properties Basic Tab
Archiving Settings Properties Content Tab
Archive Icons in the System Tree
Event Archive File
Trend Log Archive File
53 Archive User Interface
53.1 Archive Settings Manager Dialog Box

53.1 Archive Settings Manager Dialog Box


Use the Archive Settings Manager to archive events and extended and trend
logs on the Enterprise Server.

Figure: Archive Settings Manager dialog box

Table: Archive Settings Manager Dialog Box


Number Description

Enabled Select to activate the archiving function on the Enterprise Server. For more
information, see section 52.3 Enabling the Archiving Function and Defining the
Archive Folder on page 1699.

Disable Select to disable the archiving function on the Enterprise Server.


d

Archive Click to archive the selected historical data immediately. For more information,
Now see section 52.6 Manually Creating an Archive on page 1703.

Alarm Select to include Alarm events in the archive.


Events

User Select to include User events in the archive.


Events

System Select to include System events in the archive.


Events

04-17005-03-en, October 2015 System


1745
53 Archive User Interface
53.1 Archive Settings Manager Dialog Box

Continued
Number Description

Add Click the plus sign to add an extended trend log to the list.
extende
d trend
log icon

Remove Click the remove sign to delete an extended trend log to the list.
extende
d trend
log icon

Extende Select the logs that you want to include in the archive.
d Trend
Log

Archive Click Schedule to configure a schedule for archiving. For more information, see
Schedul section 52.5 Manual and Scheduled Archiving on page 1702.
e

Output Select an output type for the archive. For more information, see section 52.4
Type Archiving Formats and Storage on page 1701.

Path Type the path to the location where you want store the archive files. For more
information, see section 52.3 Enabling the Archiving Function and Defining the
Archive Folder on page 1699.

Validate
Click to validate that the path is valid. A green checkmark displays if the
system successfully validates the path.

System 04-17005-03-en, October 2015


1746
53 Archive User Interface
53.2 Add Extended Trend Logs Dialog Box

53.2 Add Extended Trend Logs Dialog Box


Use the Add Extended Trend Logs dialog box to include logs in an archive. The
system only lists the logs on the Enterprise Server that are not included the archive.

Figure: Add Extended Trend Logs dialog box

Table: Add Extended Trend Logs Dialog Box


Component Description

Click to include all the listed extended trend logs in the archive operation.

Click to exclude all the extended trend logs selected for the archive
operation.

Include Select the extended trend logs that you want to include in the archive.
For more information, see the Including Extended Trend Logs in an
Archive topic on WebHelp.

Extended Displays the name and the location of the extended trend log on the
Trend Log Enterprise Server.

04-17005-03-en, October 2015 System


1747
53 Archive User Interface
53.3 Archiving Settings Properties Basic Tab

53.3 Archiving Settings Properties Basic


Tab
Use the Basic tab to enable the archiving function, set delay, and select the format
of the archive file.

Figure: Archive Settings Basic properties tab

Table: Archive Settings Basic Tab


Component Description

Enabled Select True to activate the archiving


function.

Path Type the path to the location where you


want to create your archive.

IsValidPath Select True to indicate the objects have


passed the validation.

Output format Select the output format of the archive. For


more information, see section 52.4
Archiving Formats and Storage on page
1701.

System 04-17005-03-en, October 2015


1748
53 Archive User Interface
53.4 Archiving Settings Properties Content Tab

53.4 Archiving Settings Properties Content


Tab
Use the Content tab to add events and trend logs to the archive.

Figure: Archive Settings Content tab

Table: Archive Settings Basic Properties Tab


Component Description

Alarm Select True to include Alarm events in the


archive.

User Select True to include User events in the


archive.

System Select True to include System events in the


archive.

Logs Displays the logs you have selected to be


archived.

Add Click to add a new trend log to the archive.

Edit Click to change the trend log to be archived.

04-17005-03-en, October 2015 System


1749
53 Archive User Interface
53.5 Archive Icons in the System Tree

53.5 Archive Icons in the System Tree


Use the Archive icons to view information related to the archiving function.
For more information, see section 52.1 Archiving Overview on page 1695.

Table: Archive Icons


Icon Description

Indicates Archive Settings.

Indicates the Archive schedule. For more information, see section 48.1 Schedule
Editor Basic View on page 1531.

System 04-17005-03-en, October 2015


1750
53 Archive User Interface
53.6 Event Archive File

53.6 Event Archive File


Use the Event Archive to view all events that have passed during the running time
of the SmartStruxure server.

Figure: Event archive file

Table: Event Archive File


Column Description

TYPE Displays the object type that defines the


properties of the object.

SEQNO Displays the event sequence number.

TimeStamp Displays the date and time when the event


was generated.

Description Displays the description of the object.

EventGUID Displays the unique identity of the event.

OriginatedGUID Display the unique identity of the source.

Source Displays the path of the source object.

SourceServer Displays the path where the object is


located.

Note Displays the text added to the object in the


Note 1 property.

SystemEventId Displays the event identity generated by the


system. For more information, see section
52.12 Event and Alarm Enumerations on
page 1720.

DomainName Displays the domain the user belongs to.

UserName Display the name of the user that generated


the event.

UniqueUserId Displays the identity of the user that


generated the event.

ValueBefore Displays the value of an object before it was


changed.

ValueAfter Displays the value of an object after it was


changed.

04-17005-03-en, October 2015 System


1751
53 Archive User Interface
53.6 Event Archive File

Continued
Column Description

AssignedState Displays alarms that have been assigned to


and accepted by any user or group. For
more information, see section 52.12 Event
and Alarm Enumerations on page 1720.

MonitoredVariable Displays the path of the monitored variable

PreviousAlarmState Displays the previous alarm state. For more


information, see section 52.12 Event and
Alarm Enumerations on page 1720.

AlarmState Displays the present state of the alarm. For


more information, see section 52.12 Event
and Alarm Enumerations on page 1720.

TriggeredTimestamp Displays the time and date of the last state


transfer from normal state to alarm state.

EvaluationState Displays the present evaluation state of the


alarm. For more information, see section
52.12 Event and Alarm Enumerations on
page 1720.

MonitoredValue Displays the value of the monitored variable.

Priority Displays the current priority level of the alarm


state.

Count Displays the number of times the alarm has


toggled between the alarm and reset state.

AcknowledgeTime Displays the time and date when the alarm


was acknowledged.

BasicEvaluationState Displays the alarm state. False represents


the alarm is in normal state. For more
information, see section 52.12 Event and
Alarm Enumerations on page 1720.

Hidden Displays False if the object is shown. For


more information, see section 52.12 Event
and Alarm Enumerations on page 1720.

Category Displays the category name of the alarm.

DisabledCause Displays the cause of the disabled alarm. For


more information, see section 52.12 Event
and Alarm Enumerations on page 1720.

ServerOffline Displays the online status of the


SmartStruxure server. For more information,
see section 52.12 Event and Alarm
Enumerations on page 1720.

UniqueAlarmId Displays the unique identity of the alarm.

AlarmText Displays the alarm messages that are added


to the alarm.

System 04-17005-03-en, October 2015


1752
53 Archive User Interface
53.6 Event Archive File

Continued
Column Description

Command Displays the executed command that


generated the event.

AssignedToDomain Displays the domain the user or group that


the alarm is assigned to.

AssignedToName Displays the name of the user or group that


the alarm is assigned to.

AssignedToUniqueUserId Displays the ID of the user or group that the


alarm is assigned to.

GroupName Displays the name of the cause note or


action note that has been edited.

ItemName Displays the checklist, cause note group, or


action note group items that have been
edited.

BACnetEventType Displays the BACnet event. For more


information, see section 52.12 Event and
Alarm Enumerations on page 1720.

SystemAlarmId Displays the alarm ID generated by the


system when an alarm is triggered. For more
information, see section 52.12 Event and
Alarm Enumerations on page 1720.

Comment Displays the comment that has been added


to an alarm.

04-17005-03-en, October 2015 System


1753
53 Archive User Interface
53.7 Trend Log Archive File

53.7 Trend Log Archive File


Use the Trend Log Archive to view the history of a trend log.

Figure: Trend log archive file

Table: Trend Log Archive File


Column Description

TYPE Displays the object type that defines the


properties of the object.

SEQNO Displays the event sequence number.

TimeStamp Displays the date and time when a record or


event was generated.

RefSeqNo Displays the unique sequence number of a


record that has been edited.

OriginalSeqNo Displays the RefSeqNo collected from a


trend log. This number is only written on an
extended trend log that has records that
have been changed on the connected trend
log.

User Displays the user that generated the event.

Comment Displays the comment that was added to a


record when it was edited.

Event Displays if something is missing or


something unexpected happens. For more
information, see section 52.15 Trend Log
Enumerations on page 1740.

EndTime Displays the time when the old meter was


replaced.

EndValue Displays the value the old meter had when it


was replaced.

StartTime Displays the time when the new meter was


installed.

System 04-17005-03-en, October 2015


1754
53 Archive User Interface
53.7 Trend Log Archive File

Continued
Column Description

StartValue Displays the value of the new meter when it


was installed.

MeterConstant Displays the constant of the new meter. If


the meter counts in kilo (103), the constant is
1000.

MinValue Displays the first value of the new meter after


roll-over.

MaxValue Displays the last value of the new meter


before roll-over.

Value Displays the value of a record.

EditTime Displays the time of the record that is added


manually to a manual trend log.

LogType The type of the trend log that has been


edited.

Description Displays the trend log property that has been


configured.

Status Displays the status of the trend log. For more


information, see section 52.15 Trend Log
Enumerations on page 1740.

04-17005-03-en, October 2015 System


1755
54 Search

Topics
Search Overview
Simple Search
Performing a Search Using Simple Search
Saving a Search
Advanced Search
Properties Conditions Search
Searching for Objects Using Advanced Search
Setpoint Search Example
Non-Validated Programs Search Example
Searching for Forced Values
54 Search
54.1 Search Overview

54.1 Search Overview


Use Search in WorkStation to find and view objects in the database.
There are two different ways to search in WorkStation, Simple search and Advance
search. An Advanced search can be done on, for example on conditions or objects
types. An Advanced search can be saved for further use.
Search is case insensitive, which means that Search does not differ between upper
case and lower case. A search on "Fan" results with hits on both "fan" and "Fan".

54.1.1 Simple Search


Use Simple search to search all objects names and properties names. The search
results are displayed in a list.
For more information, see section 54.2 Simple Search on page 1760.

54.1.2 Advanced Search


Use the advanced search to filter and refine a search so you dont get too many
irrelevant results.
For more information, see section 54.5 Advanced Search on page 1764.

54.1.3 Saved Search


Frequently used searches including the settings can be saved and reused.
A Saved search is displayed in the System Tree pane and the List View. To perform
the search, open the Saved search from the System Tree pane or List View. The
search results are displayed in the work area (with collapsed Search criteria area).
A Saved search can be changed, renamed, and deleted.

Note
When you save a search, only the setting for the search is saved. The search
result is never saved.

04-17005-03-en, October 2015 System


1759
54 Search
54.2 Simple Search

54.2 Simple Search


Use Simple search to search all objects names and properties names. The search
results are displayed in a list.
Simple search searches for all object and property names. If you want to search for
a text string that are values of properties, for example text Note 1, Note 2, and
Description you have to use Advanced search and select the condition Note1,
Note 2, and Description.

Figure: Simple search toolbar and search result list

54.2.1 Wildcard Search


You can use wildcards in both Simple search and Advanced search. Use wildcards
to substitute characters or combinations of characters in a search.
Search supports three wildcards:
Asterisk (*) represents any combination of characters including white space. *
must be used if the text string you search for contains white space. For
example, if you want to search for object names as "temperature setpoint" or
"setpoint office" make sure that you use "*" in the end or in the beginning of the
word "setpoint".
Question mark (?) represents any single character.
Square brackets [] search for all characters that stands inside the brackets.
For example, if you want to find all objects and properties containing the word
Temperature, you start the search with an asterisk so that the search includes all
hits on objects like Outside Air Temperature where the asterisk represents the
words before "Temperature", in this case, Outside Air. You also have to end the
search text with an asterisk to include objects like Temperature Alarm where the
asterisk represents the word after "Temperature", in this case Alarm.
If you search on [a,b]*, you find all objects that begins with an a or a b.
You can also search on objects that start with numbers using square brackets. For
example, a search on [0-9]* finds all objects that starts with a number. A search on
[1,2,3]* finds all objects that starts with 1, 2, or 3.

System 04-17005-03-en, October 2015


1760
54 Search
54.2 Simple Search

Note
The Search box can never be empty. To perform a search, you have to enter
something in the Search box. If you want to search for all objects in a folder, enter
an asterisk (*).

54.2.2 Search Result List


The search result list can be sorted and grouped in a number of ways. You can also
add and remove columns from the list. Using the Property grid, you can also open
the properties for all objects in the list. For more information, see section 49.3 List
View on page 1568.

04-17005-03-en, October 2015 System


1761
54 Search
54.3 Performing a Search Using Simple Search

54.3 Performing a Search Using Simple


Search
You use Simple search to search for an object by its name.
For more information, see the Search View topic on WebHelp.

To perform a search using simple search


1. In WorkStation, in the Search box, enter the text you want to search for.

2. Click the Search button .


The search result is presented in the Search view list.

System 04-17005-03-en, October 2015


1762
54 Search
54.4 Saving a Search

54.4 Saving a Search


You save a search so you can reuse it later.
For more information, see section 54.1 Search Overview on page 1759.

To save a search
1. In WorkStation, on the Search toolbar, click the Save search criteria

button .
2. Enter the location where you want to save the search.
3. In the Name box, type a name.
4. Click Save.

04-17005-03-en, October 2015 System


1763
54 Search
54.5 Advanced Search

54.5 Advanced Search


Use the advanced search to filter and refine a search so you dont get too many
irrelevant results.
Applying a filter means that you set up rules that specify what kind of objects are
relevant to the search. These rules can be based on object types and object
properties.

54.5.1 Wildcard Search


You can use wildcards in both Simple search and Advanced search. Use wildcards
to substitute characters or combinations of characters in a search.
Search supports three wildcards:
Asterisk (*) represents any combination of characters including white space. *
must be used if the text string you search for contains white space. For
example, if you want to search for object names as "temperature setpoint" or
"setpoint office" make sure that you use "*" in the end or in the beginning of the
word "setpoint".
Question mark (?) represents any single character.
Square brackets [] search for all characters that stands inside the brackets.
For example, if you want to find all objects and properties containing the word
Temperature, you start the search with an asterisk so that the search includes all
hits on objects like Outside Air Temperature where the asterisk represents the
words before "Temperature", in this case, Outside Air. You also have to end the
search text with an asterisk to include objects like Temperature Alarm where the
asterisk represents the word after "Temperature", in this case Alarm.
If you search on [a,b]*, you find all objects that begins with an a or a b.
You can also search on objects that start with numbers using square brackets. For
example, a search on [0-9]* finds all objects that starts with a number. A search on
[1,2,3]* finds all objects that starts with 1, 2, or 3.

Note
The Search box can never be empty. To perform a search, you have to enter
something in the Search box. If you want to search for all objects in a folder, enter
an asterisk (*).

54.5.2 Object Types Search


You can select the object types that you want to include in the search. If you do not
select a type, all types are included. For example, if you want to search on all
graphics containing bindings named "temperature" you include only graphics in the
search. A search without the object type graphics selected results in a list with all
objects, such as values, graphics, and alarms named "temperature".

System 04-17005-03-en, October 2015


1764
54 Search
54.5 Advanced Search

54.5.3 Properties Conditions Search


You can set conditions on object properties that you want to include in the search.
For more information, see section 54.6 Properties Conditions Search on page
1766.

54.5.4 Setpoint Search Example


You want to search for all setpoints , that are over 22, in all offices. You know that
all setpoint are marked setpoint in some way, such as office setpoint, setpoint
office, and temperature setpoint. When the search is done, you want to save the
search so that you can use it again without making all settings for objects and
conditions.
For more information, see section 54.8 Setpoint Search Example on page 1771.

54.5.5 Non-Validated Programs Search Example


You want to find the programs that are not validated in your system. So you search
for all programs that have validation set to None or Failed.
For more information, see section 54.9 Non-Validated Programs Search Example
on page 1774.

54.5.6 Search Result List


The search result list can be sorted and grouped in a number of ways. You can also
add and remove columns from the list. Using the Property grid, you can also open
the properties for all objects in the list. For more information, see section 49.3 List
View on page 1568.

04-17005-03-en, October 2015 System


1765
54 Search
54.6 Properties Conditions Search

54.6 Properties Conditions Search

54.6.1 You can set conditions on object properties that you want to include in the search.

Figure: The Select Conditions dialog box when no object type is selected in the Include
types dialog box.
If you choose to include one or more object types in the search, you can select a
condition from the common properties for these object types. If no object type is
included in the search, you can select conditions from the general properties for all
object types.
If you include only one object in the search you can choose between all the
properties for that objects. For example, if you choose Alarm you can select from all
alarm properties in the Selection dialog box.
For example, to search for disabled alarms, you select alarm object type and then
select alarm state in the property list.

System 04-17005-03-en, October 2015


1766
54 Search
54.6 Properties Conditions Search

Figure: The properties available in the Select Conditions dialog box when alarm is
selected in the Include types dialog box.
The condition formats looks different depending on property type.

Combining condition groups


You can combine condition groups to better suit your search. The different
conditions groups can be combined in any way using "and" and "or".
For example, we want to find all analog values that contain "Setpoint" or
"setpoint" in their object names or descriptions. The objects we want to find have a
values over 20 or have been modified after 2013-02-25 00:00:00.
A search on these criteria looks like this:

04-17005-03-en, October 2015 System


1767
54 Search
54.6 Properties Conditions Search

Figure: You can combine different search criteria in conditions groups to further refine your
search.

Note
Strings in the Select Conditions dialog box are case sensitive, that is they differ
between upper and lower case. A description condition for the text string
"temperature" is not the same as "Temperature".

System 04-17005-03-en, October 2015


1768
54 Search
54.7 Searching for Objects Using Advanced Search

54.7 Searching for Objects Using Advanced


Search
You use this procedure to find objects in the database.
For more information, see section 54.1 Search Overview on page 1759.

To search for objects using advanced search


1. In WorkStation, on the WorkStation Toolbar menu, click the Search button

.
2. In the text box, type your search.

3. In the In folder box, select the folder where you want to start the search.
4. Select Include properties to include properties in the search.
5. Select Include subservers to include SmartStruxure subserver devices in
the search.
6. Select Stop if more than 1000 results to stop the search at 1,000 results.
7. In the Include types box, click the browser button if you want to include a
specified object type in your search.
Continued on next page

04-17005-03-en, October 2015 System


1769
54 Search
54.7 Searching for Objects Using Advanced Search

8. Select the object types you want to include in the search.

9. Click the Add type button .


10. Click OK.
11. In the Select Conditions box, click the Add conditions if you want to add
conditions for the search.

12. Click OK.

13. Click the Search button .


Search results are displayed in the Search result area.

System 04-17005-03-en, October 2015


1770
54 Search
54.8 Setpoint Search Example

54.8 Setpoint Search Example


You want to search for all setpoints , that are over 22, in all offices. You know that
all setpoint are marked setpoint in some way, such as office setpoint, setpoint
office, and temperature setpoint. When the search is done, you want to save the
search so that you can use it again without making all settings for objects and
conditions.
In the search field enter *setpoint*, this includes all objects containing setpoint. If
you enter only the word setpoint, without the asterisks (*) you do not find objects
named office setpoint or setpoint_office_1.
You only want to search in University X, not in University Y, therefore you limit the
search to University X. To do this you browse to University X in the In folder box.

Figure: he Search View when you want to search for the word temperature in all objects in
Unviversity X.
To avoid all other hits, for example graphics with links that are named "setpoint" you
have to filter on the object type Point. This is done in the Select types dialog box
under Advanced settings.

04-17005-03-en, October 2015 System


1771
54 Search
54.8 Setpoint Search Example

Figure: The Select types dialog box when you filter on Point.
If you perform a search now you find all object types that are Points and namned
"setpoints" in any way. To filter out only the setpoints with a value of 22 or more we
have to set up a condition using the Select Conditions dialog box. We set the value
to be greater than or equal to 22.

Figure: The Select Conditions dialog box when value is set to be between 22 and 100.
When all search criteria is set we perform the search. The result is presented in the
Search result list.

System 04-17005-03-en, October 2015


1772
54 Search
54.8 Setpoint Search Example

Figure: Search result and search criteria


To be able to use the search once again without going through all the settings once
agin we save the search with the name "Setpoints over 22".

Figure: The saved search "Setpoints over 22" in the System Tree pane.

04-17005-03-en, October 2015 System


1773
54 Search
54.9 Non-Validated Programs Search Example

54.9 Non-Validated Programs Search


Example
You want to find the programs that are not validated in your system. So you search
for all programs that have validation set to None or Failed.
You only want to search in University X, so you right-click University X and then click
Search. You want to find all programs that are not validated regardless of their
names. The Search box cannot be empty and you want to find all programs
regardless of their names so you have to enter an asterisk (*).

Figure: The Search View when you have entered an asterisk (') that finds all objects in
University X.
To narrow you search so that only program, Script or Function Block is found, you
have to add Programs in the Select types dialog box.

System 04-17005-03-en, October 2015


1774
54 Search
54.9 Non-Validated Programs Search Example

Figure: The Select types dialog box when all objet types of the categories Plain English
and Function Block is selected.
Then you select the conditions for the search in the Select Conditions dialog box.
We only want to find non-validated programs. Therefore we choose Validation from
the Add condition list, and then we select None and Failed, and click OK.

Figure: The validation conditions None and Failed is selected in the Select Condition
dialog box.
Then we perform the search.

04-17005-03-en, October 2015 System


1775
54 Search
54.9 Non-Validated Programs Search Example

Figure: The search result for all program in University X that are not validated
successfully.
To be able to use the search again without going through all the settings once more
we save the search with the name "Non-Validated Program Search".

System 04-17005-03-en, October 2015


1776
54 Search
54.10 Searching for Forced Values

54.10 Searching for Forced Values


You search for forced values to determine if the system runs normally and to reset
forced values. Manually overridden I/O points are not included in the search result.
For more information, see the Forced Values topic on WebHelp.
The forced values in the Building Operation system are displayed.

To search for forced values

1. In WorkStation, on the Toolbar, click the Search button .


2. In the text box, type your search.

Note
To search for all forced values, type '*'.

3. In the In folder box, select the folder where you want to start the search.
4. Expand Advanced settings.

Continued on next page

04-17005-03-en, October 2015 System


1777
54 Search
54.10 Searching for Forced Values

5. Select Include subservers to include SmartStruxure subserver devices in


the search.

Note
Only subservers running Building Operation version 1.5 or higher are
included in the search.

6. Select Stop if more than 1000 results to limit the search to 1,000 results.
7. Select Forced values only to search for forced values.

Continued on next page

System 04-17005-03-en, October 2015


1778
54 Search
54.10 Searching for Forced Values

8. In the Include types box, click the browser button if you want to include a
specified object type in your search. Select the object types you want to
include in the search.

9. Click the Add type button and select the object type.
10. Click OK.
11. In the Select Conditions box, click the browser button if you want to set a
conditions for the search.

12. Click the Add conditions button and select the condition you want to
use for the search.
13. Click OK.

14. Click the Search button .

04-17005-03-en, October 2015 System


1779
55 Shortcuts

Topics
Shortcuts Overview
Shortcut Functionality
Shortcut Targets
User Access to Shortcuts and Targets
Shortcut Creation
Shortcut Presentation
Viewing Shortcuts
Viewing Shortcut Properties
Creating a Shortcut
Configuring the Target of a Shortcut
55 Shortcuts
55.1 Shortcuts Overview

55.1 Shortcuts Overview


In Building Operation, you can create shortcuts to objects in the System Tree pane.
A shortcut is a link to a target SmartStruxure server, folder, or other object and is
simply a pointer to an object which acts as if it is that object.

Note
For the purposes of this discussion, examples of objects in the System Tree
pane are SmartStruxure servers, folders, graphics or points.

As an example, you might want to view, in one place, the open or closed state of
the security doors in all of six different buildings on a site. However, the digital input
objects representing door status (open/closed) are distributed throughout the
System Tree pane on a building-by-building basis. To implement the required view,
you could create a folder in a convenient place in the System Tree pane, and within
the folder, create shortcuts to all the (door status) digital input objects in all six
buildings.
As another example, you could create a shortcut to an existing SmartStruxure
server or folder complete with its internal objects.
You can create shortcuts in any SmartStruxure server or folder in the System Tree
pane (except for the System folder). You can also create shortcuts to other objects
(such as graphic objects) and points (such as analog and digital values).

55.1.1 Shortcut Functionality


When you click on a shortcut to an object in the System Tree pane, the appropriate
view for the target object (such as a graphic or a properties dialog box) is displayed.
If you view the Properties of a selected shortcut, the properties shown are always
those of the target object. However, if you view the Shortcut Properties of a
selected shortcut, the properties shown are those of the shortcut.
For more information, see section 55.2 Shortcut Functionality on page 1785.

55.1.2 Shortcut Targets


When you have created a shortcut in a folder or on a SmartStruxure server using
the File-New-Shortcut submenu or the context menu New-Shortcut option,
you must then also assign a target to the shortcut. It is not necessary to assign a
target to a shortcut after using any other shortcut creation method.
For more information, see section 55.3 Shortcut Targets on page 1786.

55.1.3 User Access to Shortcuts and Targets


The software permissions of a shortcut and its target object can be independently
configured to enable control of user group accessibility.
For more information, see section 55.4 User Access to Shortcuts and Targets on
page 1787.

04-17005-03-en, October 2015 System


1783
55 Shortcuts
55.1 Shortcuts Overview

55.1.4 Shortcut Creation


You can create a shortcut to a SmartStruxure server, folder or object anywhere in
the System Tree pane.
For more information, see section 55.5 Shortcut Creation on page 1788.

55.1.5 Shortcut Presentation


Shortcuts without targets and shortcuts to objects are non-presentation objects. By
default, non-presentation objects are not displayed in the System Tree, except
when selected by means of the System Tree filter. However, a shortcut with a
SmartStruxure server or a folder as a target is a presentation object and is always
displayed in the System Tree.
For more information, see section 55.6 Shortcut Presentation on page 1790.

System 04-17005-03-en, October 2015


1784
55 Shortcuts
55.2 Shortcut Functionality

55.2 Shortcut Functionality


When you click on a shortcut to an object in the System Tree pane, the appropriate
view for the target object (such as a graphic or a properties dialog box) is displayed.
If you view the Properties of a selected shortcut, the properties shown are always
those of the target object. However, if you view the Shortcut Properties of a
selected shortcut, the properties shown are those of the shortcut.
When you select a shortcut, the address bar shows the address of the shortcut and
the icon of the shortcut becomes highlighted. Also, the name displayed on the
window tab is that of the shortcut.
You can reference a shortcut as if it were the target object. For example, if you drag
a shortcut to the Watch pane, the target object is added to the Watch pane as if it
had been dropped there instead. This functionality also applies to other situations
such as logging and alarms.
Shortcut object commands that create new objects referencing the target (such as
a new alarm or trend log) create the new objects at the parent folder of the shortcut
(not the parent folder of the target).
Shortcuts are followed whenever a selection action is performed, except in the
following circumstances:
When the target value is Null
When exporting objects (the shortcut is exported, not the target)
When displaying the shortcut object properties using the Shortcut
Properties command in the context menu

04-17005-03-en, October 2015 System


1785
55 Shortcuts
55.3 Shortcut Targets

55.3 Shortcut Targets


When you have created a shortcut in a folder or on a SmartStruxure server using
the File-New-Shortcut submenu or the context menu New-Shortcut option,
you must then also assign a target to the shortcut. It is not necessary to assign a
target to a shortcut after using any other shortcut creation method.
When you delete a target object, the forward reference in all shortcuts referencing
that target object is removed. Also, the shortcut object icon changes to display the
shortcut overlay icon only (a small arrow in a square).
When you delete a shortcut object, the (backwards) reference held in the target
object is removed.
When you move a target object, the shortcuts referencing that target are updated
with the new target path in their (forward) target object reference. When you move a
shortcut object, the (backwards) reference held in the target object is updated with
the new path.
When you rename a target object, the shortcuts referencing that target are updated
with the new target path. If you rename a shortcut object, the (backwards)
reference held in the target object is updated with the new path.
When you duplicate a shortcut object, the (backwards) reference held in the
common target object is updated with the additional path to the new shortcut. For
more information, see section 55.10 Configuring the Target of a Shortcut on page
1794.

System 04-17005-03-en, October 2015


1786
55 Shortcuts
55.4 User Access to Shortcuts and Targets

55.4 User Access to Shortcuts and Targets


The software permissions of a shortcut and its target object can be independently
configured to enable control of user group accessibility.
Whenever these software permissions are set such that the user can see the target
object by means of the shortcut, the user has the same read/write access to the
shortcut as is set up for the target object.
The shortcut inherits all the commands of the target object type (but not all of these
commands act upon the target object).
Inherited commands applied at the shortcut operate on either the shortcut itself, or
on the target object, as listed in the following table:

Table: Inherited Command Application


Command applied at shortcut Command operates on

Delete Shortcut

Copy Shortcut

Move Shortcut

Rename Shortcut

Cut/Paste Shortcut

Shortcut properties Shortcut

Properties Target

Open Target

Add to Watch Target

Trend commands Target

Create Alarm Target

04-17005-03-en, October 2015 System


1787
55 Shortcuts
55.5 Shortcut Creation

55.5 Shortcut Creation


You can create a shortcut to a SmartStruxure server, folder or object anywhere in
the System Tree pane.
If you attempt to create another shortcut with the same name as an existing
shortcut within the same SmartStruxure server or folder, you will be prevented from
entering the duplicate name. If you attempt to drag-and-drop a shortcut to a
destination where a shortcut exists with the same name, you will be presented with
a dialog box explaining the other options available.
You can use more than one shortcut to refer to the same target object, but a
shortcut can only refer to one target object. The target object keeps track of all
shortcuts that refer to it (they behave as ordinary object references).
The following table shows the menu commands applicable to the creation of
shortcuts for some common System Tree pane objects.

Table: Menu Commands for Shortcut Creation


File- Context Context Context Edit Edit Other
New (right- (right- (right- menu menu
submen mouse) mouse) mouse)
u menu menu menu

Comma Shortcut New- Create Paste as Create Paste as Drag-


nd Shortcut shortcut shortcut shortcut shortcut and-drop

SmartSt Yes Yes No Yes Yes Yes Yes


ruxure
Server

Folder Yes Yes Yes Yes Yes Yes Yes

Point No No Yes Yes Yes Yes Yes

Graphic No No Yes Yes Yes Yes Yes

55.5.1 Shortcuts in SmartStruxure Servers and


Folders
You can create shortcuts in the root of a SmartStruxure server or in an existing
folder. A shortcut can reference objects in other SmartStruxure servers. The menu
commands applicable to the creation of shortcuts for SmartStruxure servers and
folders are shown in the table above.
If a shortcut object is created without specifying a target object, the (forward) target
object reference is removed.

System 04-17005-03-en, October 2015


1788
55 Shortcuts
55.5 Shortcut Creation

55.5.2 Shortcuts to Objects and Points


You can create shortcuts to objects or points (for example, a graphic or an analog
value) within a SmartStruxure server or folder. In these cases, the target object is
automatically displayed in the properties dialog box of the shortcut. The menu
commands applicable to the creation of shortcuts for some example objects and
points are shown in the table above.

04-17005-03-en, October 2015 System


1789
55 Shortcuts
55.6 Shortcut Presentation

55.6 Shortcut Presentation


Shortcuts without targets and shortcuts to objects are non-presentation objects. By
default, non-presentation objects are not displayed in the System Tree, except
when selected by means of the System Tree filter. However, a shortcut with a
SmartStruxure server or a folder as a target is a presentation object and is always
displayed in the System Tree.
When a shortcut is created in a SmartStruxure server or folder by means of the
File-New submenu or the New-Shortcut command of the Context menu, the
shortcut has no valid target. In this case, only the overlay icon (a small arrow in a
square) is displayed (because no target type is assigned).

Figure: Example of a shortcut without an assigned target


When a target is assigned, the overlay icon of the shortcut is added on top of the
icon of the target. For more information, see section 56.3 Shortcut Properties
Basic Tab on page 1799.
The following figure is an example of a shortcut for an analog value in the System
Tree:

Figure: Example of a shortcut to an analog value


When you click a shortcut, the address of the shortcut is displayed in the address
bar and the name of the shortcut is displayed in the the tab of the shortcut window.

System 04-17005-03-en, October 2015


1790
55 Shortcuts
55.7 Viewing Shortcuts

55.7 Viewing Shortcuts


You view shortcuts to objects in the System Tree pane when you want to see non-
presentation objects, for example Script or Function Block programs. By default,
non-presentation objects are hidden in the System Tree pane.
For more information, see section 55.6 Shortcut Presentation on page 1790.

To view shortcuts to objects


1. In the System Tree pane, click the Show/Hide non-presentation

objects button .
You can now view the properties of the shortcut(s).

04-17005-03-en, October 2015 System


1791
55 Shortcuts
55.8 Viewing Shortcut Properties

55.8 Viewing Shortcut Properties


You view the properties of a shortcut in order to confirm or change the target of the
shortcut.
For more information, see section 55.3 Shortcut Targets on page 1786.

To view the properties of a shortcut


1. In the System Tree pane, right-click the shortcut and then click Shortcut
Properties.

Note
You cannot view the properties of a shortcut by selecting the Properties
command. You must select the Shortcut Properties command.

System 04-17005-03-en, October 2015


1792
55 Shortcuts
55.9 Creating a Shortcut

55.9 Creating a Shortcut


You create a shortcut to an object or folder to provide a pointer that acts as if it is
that object or folder.
For more information, see section 55.5 Shortcut Creation on page 1788.

To create a shortcut
1. In WorkStation, in the System Tree pane, select the object you want to
create the shortcut for.
2. Right-click and drag the object to the SmartStruxure server or folder where
you want the shortcut.
3. Click Create Shortcut.

04-17005-03-en, October 2015 System


1793
55 Shortcuts
55.10 Configuring the Target of a Shortcut

55.10 Configuring the Target of a Shortcut


Shortcuts created using the File-New submenu or the Context menu New
command are not automatically configured with a target, therefore you must
configure the target manually.
For more information, see section 55.3 Shortcut Targets on page 1786.

To configure the target of a shortcut


1. In WorkStation, in the System Tree pane, right-click the shortcut object and
select Shortcut Properties.
2. Click the Basic tab.
3. Edit the basic properties:
Component Description

Target Enter the path of the target object (either


directly, or by way of the browse button

4. In the Select Object dialog box, select a Path Type option (if required).

5. Click Select.
6. Click OK.

System 04-17005-03-en, October 2015


1794
56 Shortcuts User Interface

Topics
Shortcuts Icon
Create Shortcut Wizard Shortcut Target Page
Shortcut Properties Basic Tab
56 Shortcuts User Interface
56.1 Shortcuts Icon

56.1 Shortcuts Icon


This section describes the icon in WorkStation that relates to shortcuts.

Table: Shortcuts Icon in Building Operation


Icon Description

Overlay Shortcut icon


Indicates a shortcut to an object in the
System Tree.

04-17005-03-en, October 2015 System


1797
56 Shortcuts User Interface
56.2 Create Shortcut Wizard Shortcut Target Page

56.2 Create Shortcut Wizard Shortcut


Target Page
Use the Shortcut target page to enter the target of the shortcut.

Figure: Shortcut target page

Table: Shortcut Target Page


Command Description

Shortcut target Enter the target of the shortcut.

System 04-17005-03-en, October 2015


1798
56 Shortcuts User Interface
56.3 Shortcut Properties Basic Tab

56.3 Shortcut Properties Basic Tab


Use the Basic tab to view shortcut properties or to change the path to the target
object in the System Tree pane.

Figure: Basic tab

Table: Basic Tab


Component Description

Target Enter the path of the target SmartStruxure


server, folder or object.

04-17005-03-en, October 2015 System


1799
57 Documents

Topics
Documents Overview
Creating a Document
57 Documents
57.1 Documents Overview

57.1 Documents Overview


A Document is a container in which you can upload (import) a file for use in Building
Operation. You can upload all types of files, including reports, forms, images, and
video clips.
When you open a Document, Building Operation starts the installed editor or viewer
associated with the file type. For example, you can open, edit, and save documents
associated with Microsoft Word. For more information, see the Opening a
Document topic on WebHelp.

Important
You can upload any file type, including .doc, .jpg, .pdf, or .txt, without size
restrictions. However, importing files larger than 17 MB to a SmartStruxuer server
device can result in an Insufficient Memory error.

Document creation
You can quickly create a Document by dragging a file from Windows Explorer to
WorkStation. You can also create a Document by using the Wizard. For more
information, see section 57.2 Creating a Document on page 1804.

Document attachment to other objects


After a Document is created and saved, you can attach the Document to another
Building Operation object, such as an Alarm. For instance, you can create an Alarm
Acknowledgement checklist and attach the checklist to a particular alarm.
Operators can review and complete the checklist using a standard Windows viewer
or editor, such as Notepad. For more information, see the [Reuse] Configuring
Attachments of an Alarm topic on WebHelp.
However, a Document is a separate entity so you cannot attach the Document
directly to another object. Instead, you make an attachment from a Building
Operation object to the Document.

Important
When you log off or are automatically logged off, any unsaved changes in the
document are not saved in the database. Make sure that you save changes in
open documents frequently.

04-17005-03-en, October 2015 System


1803
57 Documents
57.2 Creating a Document

57.2 Creating a Document


You create a document so that you can view, edit, and store files in WorkStation.
You can also attach documents to other Building Operation objects, such as
alarms.
For more information, see section 57.1 Documents Overview on page 1803.

To create a document
1. In Windows Explorer, select the file you want to import to WorkStation.
2. In WorkStation, drag the file to the SmartStruxure server or folder where you
want to create a document.

System 04-17005-03-en, October 2015


1804
58 Documents User Interface

Topics
Document Properties Basic Tab
New Document Wizard Import Document Page
58 Documents User Interface
58.1 Document Properties Basic Tab

58.1 Document Properties Basic Tab


Use the Basic tab to view the current information on a particular document
including the source file associated with the document. You can also import a
different source file.

Figure: Basic tab

Table: Basic Tab


Property Description

File Enter the file that you want to import to WorkStation.

04-17005-03-en, October 2015 System


1807
58 Documents User Interface
58.2 New Document Wizard Import Document Page

58.2 New Document Wizard Import


Document Page
Use the Import Document page to import a file to WorkStation. You can upload
all types of files including: reports, diagrams, note files, trend diagrams, voice
messages, images, and video clips.

Figure: Import document dialog box

Table: Import Document Dialog Box


Component Description

File Enter the file that you want to import to WorkStation.

System 04-17005-03-en, October 2015


1808
59 Backup and Restore

Topics
Backup and Restore Overview
Comparison of Backup and Restore Methods
Local Backup and Restore of SmartStruxure Servers
Remote Backup and Restore of SmartStruxure Server
Devices
Retain Level
Configuring the Retain Level
59 Backup and Restore
59.1 Backup and Restore Overview

59.1 Backup and Restore Overview


Backup and Restore assures that SmartStruxure server or Project Configuration
Server data can be restored after damage or loss due to hardware or software
failures, security threats, or application testing.
Building Operation provides backup and restore capabilities that preserve both
configuration and historical data on an as-needed or periodic basis.

59.1.1 Backup
Backup is the process of copying and storing data so that the copy can be used to
restore the primary source if a data loss occurs as well as to revert to an older
version. Ideally, SmartStruxure server or Project Configuration Server backups
should take place during non-business hours. In Building Operation, you can
perform backups on an individual SmartStruxure server and its devices, a group of
SmartStruxure servers and their devices, or a project.
Building Operation provides two backup options:
Configuration only: Useful for new installations, Building Operation backs up
the configuration database, which preserves a snapshot of the configuration
data for a particular date and time.
All data: Useful for existing systems, Building Operation backs up the
configuration data and historical data, which preserves a snapshot of the
configuration data for a particular date and includes a copy of the trend logs
and event logs.
For more information, see section 60.1 Backup on page 1823.

59.1.2 Restore
Restore is the process of restoring data to an original or former state. Using
Restore, you can revert to a previous snapshot of the SmartStruxure server data
despite any configuration changes made since the last backup. In Building
Operation, Restore is a manual process designed to avoid the accidental
overwriting of current SmartStruxure server data.
For more information, see section 63.1 Restore on page 1883.

59.1.3 BACnet Backup and Restore


BACnet Backup uses a binary file format to back up an entire device. Specifically,
BACnet Backups comprise the entire contents of the selected device, such as
associated objects, properties, bindings, historical data, and related proprietary
configuration data.
For more information, see the BACnet Backup and Restore topic on WebHelp.

04-17005-03-en, October 2015 System


1811
59 Backup and Restore
59.1 Backup and Restore Overview

59.1.4 Archiving Overview


Archiving is the process of preserving historical data, which is comprised of
selected events and extended trend logs. For example, some facilities are required
to maintain archives to comply with government regulations. Another example is in
secure facilities where they must maintain records of who logged in or who
changed setpoints. Archiving is not a backup function because archive data cannot
be imported back into the system.
For more information, see section 52.1 Archiving Overview on page 1695.

59.1.5 Comparison of Backup and Restore Methods


There are two Backup and Restore methods: Building Operation and BACnet. You
can select the backup and restore method that suits your SmartStruxure server
data storage and retrieval requirements.
For more information, see section 59.2 Comparison of Backup and Restore
Methods on page 1813.

System 04-17005-03-en, October 2015


1812
59 Backup and Restore
59.2 Comparison of Backup and Restore Methods

59.2 Comparison of Backup and Restore


Methods
There are two Backup and Restore methods: Building Operation and BACnet. You
can select the backup and restore method that suits your SmartStruxure server
data storage and retrieval requirements.
The following table contrasts the Building Operation and BACnet backup and
restore methods.

Table: Comparison of Building Operation and BACnet Backup and Restore


Method Purpose Description

Building Operation Backup Backs up configuration data Use this method to back up
and historical data SmartStruxure servers that
can include data from b3,
LonWorks, Network 8000,
I/NET, MicroNet, and
Modbus devices.
The b3 devices are
automatically backed up
whenever a SmartStruxure
server is backed up.
Therefore, b3 devices do not
need backing up using the
BACnet Backup method.

BACnet Backup Backs up configuration data Use this method to backup


primarily:
External devices
Routers
BACnet Backup and Restore
can also backup and restore
b3 devices that are
connected to either a b3CX
controller or external router.
However, BACnet backup
and restore cannot backup
b3 devices when the devices
are connected to a
SmartStruxure server device
that functions as a router. For
more information, see the
BACnet Backup and Restore
topic on WebHelp.

Building Operation Restore Restores a SmartStruxure Use this method to restore


server using configuration SmartStruxure servers that
data and historical data can include data from b3,
contained in a backup set LonWorks, Network 8000,
I/NET, MicroNet, and
Modbus devices.

Continued on next page

04-17005-03-en, October 2015 System


1813
59 Backup and Restore
59.2 Comparison of Backup and Restore Methods

Continued
Method Purpose Description

BACnet Restore Restores a device using Use this method to backup


configuration data contained primarily:
in a backup set (no historical
data) External devices
Routers

Tip
To restore archived data, use the Archiving feature rather than Restore method.
See For more information, see section 52.1 Archiving Overview on page 1695.

System 04-17005-03-en, October 2015


1814
59 Backup and Restore
59.3 Local Backup and Restore of SmartStruxure Servers

59.3 Local Backup and Restore of


SmartStruxure Servers
In WorkStation, you can log on to a SmartStruxure server directly to perform manual
backup and restore tasks.

59.3.1 Local Backup and Restore of a Standalone


SmartStruxure Server Devices
In WorkStation, you can log on to SmartStruxure server device to perform a manual
backup of the SmartStruxure server device data. If you have multiple standalone
SmartStruxure server devices, the Backup and Restore processes on one
SmartStruxure server device remain self-contained and, therefore, separate from
any another SmartStruxure server device on the network.

Figure: Backup and Restore for multiple standalone SmartStruxure Server Devices
The system only stores one backup file at a time on the SmartStruxure server
devices. If you import a backup set, the system overwrites the locally stored file with
the imported file. Therefore, you will only see one backup file in the Restore Options
dialog box when you log on to a SmartStruxure server device.

04-17005-03-en, October 2015 System


1815
59 Backup and Restore
59.3 Local Backup and Restore of SmartStruxure Servers

59.3.2 Local Backup and Restore of an Enterprise


Server
In WorkStation, you can log on to an Enterprise Server to perform a manual backup
of the Enterprise Server data. If you have multiple Enterprise Servers, the Backup
and Restore processes on one Enterprise Server remain self-contained and,
therefore, separate from any another Enterprise Server on the network.

Figure: Backup and Restore for multiple Enterprise Servers

System 04-17005-03-en, October 2015


1816
59 Backup and Restore
59.4 Remote Backup and Restore of SmartStruxure Server Devices

59.4 Remote Backup and Restore of


SmartStruxure Server Devices
When you log onto an Enterprise Server, you can perform remote backups of any
SmartStruxure server devices in the group. Whenever a backup occurs, the system
overwrites the locally stored file on the SmartStruxure server device with the new
backup file. The system then notifies the Enterprise Server that a new local
SmartStruxure server device backup file is available. The Enterprise Server then
fetches and stores this backup file in a separate directory on the hard drive.
The system only displays valid SmartStruxure server devices backup files in the
Restore Options dialog box that are stored on the Enterprise Server. In the event
that the backup file is damaged or lost, or not the one you want to use, you can
select a valid backup file to restore the SmartStruxure server device. The restore
operation overwrites the locally stored SmartStruxure server device backup file
located on the SmartStruxure server device with the selected backup file. For more
information, see section 63.4 Restoring a SmartStruxure Server Device from the
Enterprise Server on page 1888.

04-17005-03-en, October 2015 System


1817
59 Backup and Restore
59.5 Retain Level

59.5 Retain Level


In Building Operation, variable values are primarily stored in flash memory in order to
have their values survive power fail and server shutdown. However, values that are
often collected are only stored in the SDRAM memory. This is done to protect the
flash memory in the SmartStruxure server device.
Variables always have a retain level that controls if the value of the variable is
retained after a restart of the server. There are three retain levels. The following table
lists the retain levels and whether a variable is retained after cold start, warm start,
or power failure.
Retain level Cold start Warm start Power failure

No

Warm start x x

Cold start x x x

In addition, the retain level also defines if and when a variable value is saved in the
configuration database. A new value of a variable can either be configured by a user
or by an application, for example Function Block or Script.
User written variable values with warm start retained and cold start retained levels
are stored in the database. These variable values are part of a backup and restore
of the database.
Application written variable values with cold start retained levels are stored in the
database during certain activities, such as backup and export.
The following table lists what is retained based on the retain level, and system
events and activities.
System Events Retain level: No Retain level: Cold Retain level:
and Activities start Warm start

Cold start command Default value a Variable retains the Variable retains last
last value configured value configured by a
by either a user or an user. Values
application. If the configured by an
value has never been application are lost. If
configured by a user the value has never
or an application the been configured by a
value will be the user or an application
default value.a the value will be the
default value.a

Warm start Default value a Variable retains the Variable retains the
command last value configured last value configured
by either a user or an by either a user or an
application. If the application. If the
value has never been value has never been
configured by a user configured by a user
or an application the or an application the
value will be the value will be the
default value.a default value.a

System 04-17005-03-en, October 2015


1818
59 Backup and Restore
59.5 Retain Level

Continued
System Events Retain level: No Retain level: Cold Retain level:
and Activities start Warm start

Exporting & Default value a Variable retains the Variable retains last
Importing last value configured value configured by a
by either a user or an user. Values
application. If the configured by an
value has never been application are lost. If
configured by a user the value has never
or an application the been configured by a
value will be the user or an application
default value.a the value will be the
default value.a

Viewing Variable in Shows the last value Shows the last value Shows the last value
Building Operation configured by either a configured by either a configured by either a
user interface user or an application user or an user or an
application. application.

Backup & Restore Default value a Variable retains the Variable retains last
last value configured value configured by a
by either a user or an user. Values
application. If the configured by an
value has never been application are lost. If
configured by a user the value has never
or an application the been configured by a
value will be the user or an application
default value.a the value will be the
default value.a

Power loss and Default value a Variable retains the Variable retains the
restore last value configured last value configured
by either a user or an by either a user or an
application. If the application. If the
value has never been value has never been
configured by a user configured by a user
or an application the or an application the
value will be the value will be the
default value.a default value.a

Upgrade Default value a Variable retains the Variable retains the


last value configured last value configured
by either a user or an by either a user or an
application. If the application. If the
value has never been value has never been
configured by a user configured by a user
or an application the or an application the
value will be the value will be the
default value.a default value.a

a) Default value is the same value that the variable had when the system was installed.

Function Block
Function block objects have there own backup function. The backup function in
Function Block overrides the retain level in Building Operation. For more
information, see the Edit Block Dialog Box topic on WebHelp.

04-17005-03-en, October 2015 System


1819
59 Backup and Restore
59.6 Configuring the Retain Level

59.6 Configuring the Retain Level


Configure the retain level to control what happen to values when different system
events occurs.
For more information, see section 59.5 Retain Level on page 1818.

To configure the retain level


1. In WorkStation, in the System Tree pane, click the value.

2. Click the Configure button .


3. Select Retain level.

4. In the Retain level box, select the retain level.

System 04-17005-03-en, October 2015


1820
60 Backups

Topics
Backup
Types of Data
Backup Status
Checking the Backup Status of a SmartStruxure Server
Manual Backups
Mass Backup
Backing Up SmartStruxure Servers Manually
System Backup
60 Backups
60.1 Backup

60.1 Backup
Backup is the process of copying and storing data so that the copy can be used to
restore the primary source if a data loss occurs as well as to revert to an older
version. Ideally, SmartStruxure server or Project Configuration Server backups
should take place during non-business hours. In Building Operation, you can
perform backups on an individual SmartStruxure server and its devices, a group of
SmartStruxure servers and their devices, or a project.
Using WorkStation, you can back up data to the local drive of each installed
Building Operation server. Building Operation stores the files by date in a predefined
directory location on the server to which Workstation is connected. For more
information, see section 61.1 Backup Sets on page 1839.
Building Operation provides two backup options:
Configuration only: Useful for new installations, Building Operation backs up
the configuration database, which preserves a snapshot of the configuration
data for a particular date and time.
All data: Useful for existing systems, Building Operation backs up the
configuration data and historical data, which preserves a snapshot of the
configuration data for a particular date and includes a copy of the trend logs
and event logs.

60.1.1 Types of Data


In Building Operation, there are two types of data that are backed up: Historical and
Configuration.
For more information, see section 60.2 Types of Data on page 1825.

60.1.2 Backup Sets


Backup sets are compressed backup files used for restoring data. Building
Operation stores the local backup set for an Enterprise Server or SmartStruxure
server devices in the Local folder within the Backup sets folder.
The SmartStruxure server device stores only one backup set at a time, so each new
backup operation overwrites the previous backup set. However, an Enterprise
Server can store multiple backup sets locally.
For more information, see section 61.1 Backup Sets on page 1839.

60.1.3 Scheduled Backups


A scheduled backup is an automated way to back up data on a SmartStruxure
server. You can back up SmartStruxure servers individually using each
SmartStruxure servers local backup rule. You can also use backup rules to
synchronize the backups of all the SmartStruxure servers on your network.
For more information, see section 62.1 Scheduled Backups on page 1863.

04-17005-03-en, October 2015 System


1823
60 Backups
60.1 Backup

60.1.4 Manual Backups


Manual Backup is a non-automated process of copying and storing data on a
selected SmartStruxure server. You can use this option to create backups on an
as-needed basis. You can also manually restore the data at any time.
For more information, see section 60.5 Manual Backups on page 1828.

60.1.5 Mass Backup


Mass backup is a method of performing a manual, simultaneous backup of all the
SmartStruxure servers in the network, which is useful for capturing data at a critical
point, such as prior to an upgrade. You can choose which SmartStruxure servers
you want to back up along with the type of data for each.
For more information, see section 60.6 Mass Backup on page 1830.

60.1.6 System Backup


Before upgrading the system, it is strongly recommended that you archive the
historical data and back up the SmartStruxure servers to preserve the current data
and configurations. If you plan to upgrade WebReports, be sure to back up the
Reports database in SQL Server.
For more information, see section 60.8 System Backup on page 1834.

60.1.7 Backup Status


Backup Status displays the statuses of a SmartStruxure server: Ready, Backing up,
or Backup succeeded.
For more information, see section 60.3 Backup Status on page 1826.

System 04-17005-03-en, October 2015


1824
60 Backups
60.2 Types of Data

60.2 Types of Data


In Building Operation, there are two types of data that are backed up: Historical and
Configuration.
When deciding on the frequency of SmartStruxure server backups, you should take
into account the potential cost of recreating any historical or configuration data that
can change since the last backup. For example, you can perform an All data
backup back up a SmartStruxure server device weekly if multiple operators use
their WorkStations frequently. As a precaution, you can perform a Configuration
only backup before installing a new application or modifying the current
configuration.
The following table lists the types of data that you can back up and the purposes of
each.

Table: Backup Data


Type of Data Contents

Historical Includes trend logs and event logs stored on


a SmartStruxure server.

Configuration Includes configuration data comprised of


points, values, alarm objects, trend objects,
programs, graphics, and custom object type
data.
Also includes the configuration properties of
variables, such as Unit. Depending on the
retain level of the variable, some
configuration properties like Value are also
included in a backup. For more information,
see section 59.5 Retain Level on page
1818.

Note
Depending on the type of data, the system locks changes to the database while a
backup is in progress in different ways. For configuration changes, Building
Operation queues up the changes until the backup completes. For historical data
changes, Building Operation buffers the data based on the limits of the buffer
size.

Impact on Configuration Values and Variables


When you back up a SmartStruxure server specifying either Configuration only or All
data, Building Operation includes all the configuration values that are specified for
the SmartStruxure servers objects. If you restore the SmartStruxure server,
Building Operation restores these configuration values, which can overwrite any
changes made since the last backup.
When you back up a SmartStruxure server specifying either Configuration only or All
data, Building Operation includes all the configuration values that are specified for
the SmartStruxure servers objects. If you restore the SmartStruxure server,
Building Operation restores these configuration values, which can overwrite any
changes made since the last backup. For more information, see section 59.5
Retain Level on page 1818.

04-17005-03-en, October 2015 System


1825
60 Backups
60.3 Backup Status

60.3 Backup Status


Backup Status displays the statuses of a SmartStruxure server: Ready, Backing up,
or Backup succeeded.
If a backup does not succeed, the system displays a default alarm informing you of
the backup or SmartStruxure server issue. For more information, see the Backup
and Restore Alarms topic on WebHelp.

System 04-17005-03-en, October 2015


1826
60 Backups
60.4 Checking the Backup Status of a SmartStruxure Server

60.4 Checking the Backup Status of a


SmartStruxure Server
You check the backup status of a SmartStruxure server to view its backup status
and note the date and time of the last backup.
For more information, see section 60.3 Backup Status on page 1826.

To check the backup status of a SmartStruxure server


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. In the Backup and archiving area, click Backup and Restore Manager.
4. View the SmartStruxure server backup status or date and time of the last
successful backup.

04-17005-03-en, October 2015 System


1827
60 Backups
60.5 Manual Backups

60.5 Manual Backups


Manual Backup is a non-automated process of copying and storing data on a
selected SmartStruxure server. You can use this option to create backups on an
as-needed basis. You can also manually restore the data at any time.
You log on to one of the following SmartStruxure servers to initiate a manual
backup:
SmartStruxure server devices or Enterprise Server to perform a local backup.
For more information, see section 59.3 Local Backup and Restore of
SmartStruxure Servers on page 1815.
Enterprise Server to perform a remote backup of any SmartStruxure server
devices that are created under the Enterprise Server. For more information, see
section 59.4 Remote Backup and Restore of SmartStruxure Server Devices
on page 1817.

60.5.1 Backup Set Naming


For manual backups, the system initially names the backup set by combining the
SmartStruxure server name with the localized date and time of the machine running
WorkStation. For scheduled backups, however, the system combines the
SmartStruxure server name with the UTC time in the backup set name rather than
the local time.

Tip
The system also retains the UTC time of manually generated backups. To view
the UTC time rather than the localized time for a manual backup set, select the
Backup date property from the column selector of the Backup Sets List view.
For more information, see the Columns topic on WebHelp.

If you log on to the Enterprise Server in WorkStation to create a backup of the


SmartStruxure server device, the system automatically checks for identical backup
set names. If a name is found in the AS Archives folder, the system warns of a
potential duplication by highlighting the Backup set name prefix box or the
Backup set name suffix box in solid red. If you do not change the prefix or suffix,
the system displays a red box around the backup set in the Backup set name
column to indicate that there is an existing name. If you still do not change the
name, the system automatically appends an extended time stamp to prevent the
accidental overwriting. For more information, see the Duplicate Backup Set Names
in Multi-server Systems topic on WebHelp.

60.5.2 Local Backup and Restore of SmartStruxure


Servers
In WorkStation, you can log on to a SmartStruxure server directly to perform manual
backup and restore tasks.
For more information, see section 59.3 Local Backup and Restore of
SmartStruxure Servers on page 1815.

System 04-17005-03-en, October 2015


1828
60 Backups
60.5 Manual Backups

60.5.3 Remote Backup and Restore of SmartStruxure


Server Devices
When you log onto an Enterprise Server, you can perform remote backups of any
SmartStruxure server devices in the group. Whenever a backup occurs, the system
overwrites the locally stored file on the SmartStruxure server device with the new
backup file. The system then notifies the Enterprise Server that a new local
SmartStruxure server device backup file is available. The Enterprise Server then
fetches and stores this backup file in a separate directory on the hard drive.
For more information, see section 59.4 Remote Backup and Restore of
SmartStruxure Server Devices on page 1817.

04-17005-03-en, October 2015 System


1829
60 Backups
60.6 Mass Backup

60.6 Mass Backup


Mass backup is a method of performing a manual, simultaneous backup of all the
SmartStruxure servers in the network, which is useful for capturing data at a critical
point, such as prior to an upgrade. You can choose which SmartStruxure servers
you want to back up along with the type of data for each.
In smaller installations, a server group may include an Enterprise Server comprised
of one or more SmartStruxure server devices. In larger installations, multiple server
groups may include an Enterprise Server with a distinct set of SmartStruxure server
devices. In either case, the Enterprise Server is the hierarchical top SmartStruxure
server with one or more SmartStruxure server devices.

Figure: Mass backup of an Enterprise Server and SmartStruxure server devices


You log on to the Enterprise Server to create a mass backup. For more information,
see section 64.5 Backup Options Dialog Box on page 1908.

System 04-17005-03-en, October 2015


1830
60 Backups
60.7 Backing Up SmartStruxure Servers Manually

60.7 Backing Up SmartStruxure Servers


Manually
You back up multiple SmartStruxure servers manually to copy and store data that is
frequently updated.
For more information, see section 60.5 Manual Backups on page 1828.

To back up SmartStruxure servers manually


1. In WorkStation, in the System Tree pane, select the SmartStruxure server.
2. On the Actions menu, click Backup.
3. In the Backup set name prefix box, type some text at the beginning of the
file name that helps identify the backup set.

4. In the Backup set name suffix box, type some text at the end of the file
name that helps identify the backup set.
5. In the Include column, select the SmartStruxure servers that you want to

include in the backup, or click the Select All button to include all the
listed SmartStruxure servers in the backup.
6. In the Backup content column, select the type of data you want to back up
for each SmartStruxure server:
Select Configuration only to back up the configuration database and
custom object type data.
Select All data to back up the configuration, historical data, and custom
object type data.
Continued on next page

04-17005-03-en, October 2015 System


1831
60 Backups
60.7 Backing Up SmartStruxure Servers Manually

7. In the Backup set description column, type a brief description up to 255


characters to help identify the content of each backup.

8. Click the Synchronize Description button to add the same backup set
description entered for one SmartStruxure server to all the other backup sets.

9. Click the Synchronize Content button to add the same content type
chosen for one SmartStruxure server to all the other backup sets.

10. Click the Synchronize All button to add both the backup set
description and the content type chosen for one SmartStruxure server to all
the other backup sets.
11. Click Backup.
Continued on next page

System 04-17005-03-en, October 2015


1832
60 Backups
60.7 Backing Up SmartStruxure Servers Manually

12. Verify that the backups succeeded and click Close.

04-17005-03-en, October 2015 System


1833
60 Backups
60.8 System Backup

60.8 System Backup


Before upgrading the system, it is strongly recommended that you archive the
historical data and back up the SmartStruxure servers to preserve the current data
and configurations. If you plan to upgrade WebReports, be sure to back up the
Reports database in SQL Server.
The following diagram describes the recommended steps for archiving and backing
up a multi-server system running Building Operation software.

Figure: System archive and backup process overview

Table: System Archive and Backup Process Overview


Step Procedure Description

1 Archive system data Perform a manual archive of the system


historical data in the Enterprise Server.
(Archiving is not on SmartStruxure server
devices.) For more information, see section
52.6 Manually Creating an Archive on page
1703.

2 Back up current SmartStruxure Create an All data backup for the Enterprise
servers Server and each SmartStruxure server device.
The backups do not need to follow any
particular order. For more information, see
section 60.7 Backing Up SmartStruxure
Servers Manually on page 1831.

3 Save backup sets to an external Save the Enterprise Server and SmartStruxure
location server device backup sets (.xbk) to a safe
location on a file system that is external to the
Enterprise Server. For more information, see
section 61.2 Backup Set Storage and
Protection on page 1841.

System 04-17005-03-en, October 2015


1834
60 Backups
60.8 System Backup

Continued
Step Procedure Description

4 Back up current Reports For systems that include a Reports Server,


database back up the WebReports database. For more
information, see the Backing Up the
WebReports Database topic on WebHelp.
You can also back up the Reports database
folder to another location on the file system (not
the default source location in the C:\Program
Files\ directory).

04-17005-03-en, October 2015 System


1835
61 Backup Sets

Topics
Backup Sets
Backup Set Storage and Protection
Locating the Local Backup Path on the Enterprise Server
Copying an Enterprise Server Backup Set to WorkStation
Copying a SmartStruxure Server Device Backup Set to
WorkStation
Copying a Backup Set to the Enterprise Server Local
Directory
Backup Set Import from WorkStation
Importing a Backup Set to an Enterprise Server
Importing a Backup Set to SmartStruxure Server Device
Automatic Purge of Backup Sets
Configuring Purge Settings on an Enterprise Server
Deleting a Backup Set from the Enterprise Server
61 Backup Sets
61.1 Backup Sets

61.1 Backup Sets


Backup sets are compressed backup files used for restoring data. Building
Operation stores the local backup set for an Enterprise Server or SmartStruxure
server devices in the Local folder within the Backup sets folder.
The SmartStruxure server device stores only one backup set at a time, so each new
backup operation overwrites the previous backup set. However, an Enterprise
Server can store multiple backup sets locally.

Figure: Backup sets in the Local folder


Unlike a SmartStruxure server device, an Enterprise Server can store multiple local
and remote backup files. In multiple server sites, the Enterprise Server manages all
the SmartStruxure server devices in its group. Consequently, the backup set is
actually stored in two places: on the SmartStruxure server devices and on the
Enterprise Server. In the Backup sets folder of the installation directory, Building
Operation creates two directories:
ASArchives: Lists separate subfolders that reflect the name of each
SmartStruxure server device. Each subfolder contains the backup files for that
SmartStruxure server device.
LocalBackup: Lists all the local backup files for the Enterprise Server.

SmartStruxure Server Rename


Building Operation associates each backup set with a particular SmartStruxure
server name. Therefore, you should not rename a SmartStruxure server unless
absolutely necessary. If you do rename a SmartStruxure server, the previous
backup sets do not display in the Restore Options dialog box. You can view all the
backup sets that are stored locally on an Enterprise Server. For more information,
see section 61.3 Locating the Local Backup Path on the Enterprise Server on
page 1843.

Tip
Going forward, you must create new backups for the renamed SmartStruxure
server.

04-17005-03-en, October 2015 System


1839
61 Backup Sets
61.1 Backup Sets

61.1.1 Backup Set Storage and Protection


SmartStruxure servers store backup sets in their local directory. By design, the
average user may not easily locate these backup directories using a Windows-
based file system. For convenience, you can save backup sets stored on
SmartStruxure servers to WorkStation. After saving the backup set, you can also
copy the file to another backup storage location.
For more information, see section 61.2 Backup Set Storage and Protection on
page 1841.

61.1.2 Backup Set Import from WorkStation


You import a backup set from WorkStation to replace a lost or incomplete backup
set, or to add a backup set to a new SmartStruxure server.
For more information, see section 61.7 Backup Set Import from WorkStation on
page 1851.

61.1.3 Automatic Purge of Backup Sets


An Enterprise Server stores multiple local and remote backup sets. As a result,
these sets can consume much needed space on the Enterprise Server. To resolve
this problem, you can configure the Enterprise Server to remove outdated backup
sets.
For more information, see section 61.10 Automatic Purge of Backup Sets on
page 1855.

System 04-17005-03-en, October 2015


1840
61 Backup Sets
61.2 Backup Set Storage and Protection

61.2 Backup Set Storage and Protection


SmartStruxure servers store backup sets in their local directory. By design, the
average user may not easily locate these backup directories using a Windows-
based file system. For convenience, you can save backup sets stored on
SmartStruxure servers to WorkStation. After saving the backup set, you can also
copy the file to another backup storage location.
Saving a backup set to a storage location is a two-step process: saving the backup
set and then relocating the file to another location. First, you save the backup set to
WorkStation. Second, you copy the backup set from WorkStation to another
storage location on your network, such as a USB drive.

Figure: Copy backup set from a SmartStruxure server to a network drive

Uniquely Named Storage Directory


To save time, you can create a uniquely named directory in which to store your
saved backup sets for a particular SmartStruxure server. This unique folder name
can help you identify a particular Enterprise Server or SmartStruxure server devices
backup set, such as AS-1 Final Configuration Backup. Using this method, you can
easily locate the backup set on your network.

Backup Set Renaming


Scheduled backup sets have a unique file name and extension based on the date
stamp and software version. However, you can rename the backup set, if
necessary. For more information, see section 62.1 Scheduled Backups on page
1863.

04-17005-03-en, October 2015 System


1841
61 Backup Sets
61.2 Backup Set Storage and Protection

Backup Set Removal


You can remove backups sets in two ways:
Manually. You can delete backups sets using a browser. For more information,
see section 61.12 Deleting a Backup Set from the Enterprise Server on page
1858.
Periodically. You can configure the system to remove backup sets on a regular
basis. For more information, see section 61.10 Automatic Purge of Backup
Sets on page 1855.

System 04-17005-03-en, October 2015


1842
61 Backup Sets
61.3 Locating the Local Backup Path on the Enterprise Server

61.3 Locating the Local Backup Path on the


Enterprise Server
You locate the local backup folder on the Enterprise Server to view the stored
backup sets. The system displays the valid backup sets stored in this folder in the
Restore Options dialog box.
For more information, see section 61.2 Backup Set Storage and Protection on
page 1841.

To locate a local backup path on the Enterprise Server


1. In WorkStation, in the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the Enterprise server.

3. Click Backup and Restore Manager.


Continued on next page

04-17005-03-en, October 2015 System


1843
61 Backup Sets
61.3 Locating the Local Backup Path on the Enterprise Server

4. In the Backup sets path box, view the local backup path on the Enterprise
server.

System 04-17005-03-en, October 2015


1844
61 Backup Sets
61.4 Copying an Enterprise Server Backup Set to WorkStation

61.4 Copying an Enterprise Server Backup


Set to WorkStation
You save a backup set from an Enterprise Server to WorkStation so you can copy
the backup set to a different (remote) location.
For more information, see section 61.2 Backup Set Storage and Protection on
page 1841.

To copy an Enterprise Server backup set to WorkStation


1. On the Tools menu, select Control Panel.
2. On the Control Panel toolbar, select the Enterprise Server.

3. Click Backup Sets.


4. In the List View, open the Local folder.
Continued on next page

04-17005-03-en, October 2015 System


1845
61 Backup Sets
61.4 Copying an Enterprise Server Backup Set to WorkStation

5. Select the Enterprise Server backup set that you want to save to a different
location.

6. On the Actions menu, click Save To.


7. In the Save As dialog box, enter a storage location and click Save.
8. Make a note of the destination and click Close.

System 04-17005-03-en, October 2015


1846
61 Backup Sets
61.5 Copying a SmartStruxure Server Device Backup Set to WorkStation

61.5 Copying a SmartStruxure Server Device


Backup Set to WorkStation
You copy a SmartStruxure server device backup set to a file location on a PC
running WorkStation.

To copy a SmartStruxure server device backup set to


WorkStation
1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Backup Sets.


4. In the List View, open the Local folder for a SmartStruxure server device or
the AS Archives folder for an Enterprise Server.
5. If connected to the Enterprise Server, open the SmartStruxure server device
folder that contains the backup set.
Continued on next page

04-17005-03-en, October 2015 System


1847
61 Backup Sets
61.5 Copying a SmartStruxure Server Device Backup Set to WorkStation

6. Select the backup set that you want to save to a different location.

7. On the Actions menu, click Save To.


8. In the Save As dialog box, enter a storage location and click Save.
9. Make a note of the destination and click Close.

System 04-17005-03-en, October 2015


1848
61 Backup Sets
61.6 Copying a Backup Set to the Enterprise Server Local Directory

61.6 Copying a Backup Set to the Enterprise


Server Local Directory
You copy a backup set to the Local (db_backup) folder to restore the targeted
Enterprise Server.
For more information, see section 61.2 Backup Set Storage and Protection on
page 1841.

To copy a backup set to the Enterprise Server local directory


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the Enterprise server.

3. Click Backup and Restore Manager.


Continued on next page

04-17005-03-en, October 2015 System


1849
61 Backup Sets
61.6 Copying a Backup Set to the Enterprise Server Local Directory

4. In the Backup sets path box, copy the entire backup sets path of the
Enterprise Server.

5. Open a browser, such as Windows Explorer.


6. In the browser Address box, paste the backup sets path and press Enter.
7. In the db_backup folder, open the LocalBackup folder.

8. Right click the backup set that you want to copy and click Copy.
9. Navigate to the db_backup folder of the Enterprise Server that you want to
restore.
10. Paste the backup set into the LocalBackup folder of the targeted Enterprise
Server.

Note
If the LocalBackup folder does not appear within the db_backup
folder, you can create one using the exact name, LocalBackup.

You can now restore the Enterprise Server using this backup set. For more
information, see section 63.3 Restoring the SmartStruxure Server on page 1886.

System 04-17005-03-en, October 2015


1850
61 Backup Sets
61.7 Backup Set Import from WorkStation

61.7 Backup Set Import from WorkStation


You import a backup set from WorkStation to replace a lost or incomplete backup
set, or to add a backup set to a new SmartStruxure server. Building Operation
stores a local backup set for an Enterprise Server or SmartStruxure server devices
under the Local folder in the Backup Sets folder. However, the system handles the
storage of backup sets based on the type of SmartStruxure server. For example, a
SmartStruxure server device stores only one backup set at a time. Therefore, the
system overwrites the previous backup file with the latest file. If there is no file
present, Building Operation adds the backup set to the Local folder. In a multi-
server system, the Enterprise Server fetches and stores the latest backup set for
each SmartStruxure server device in a separate directory in the Backup Sets folder.
In addition, the system can store several backup sets for each SmartStruxure server
device as well as multiple backup sets for the Enterprise Server.

Figure: Import backup set from WorkStation to SmartStruxure Server Devices or


Enterprise Server
Importing is a three-step process: logging onto the SmartStruxure server, importing
the file, and then restoring the SmartStruxure server. First, you log onto a
SmartStruxure server in WorkStation. You then import the selected backup set from
a network storage area. Finally, you restore the SmartStruxure server.
You can only restore a SmartStruxure server using a backup set that was created
with the same software version on the same SmartStruxure server (including service
pack). To help identify the usable backup sets, the system displays the compatible
files in black text and the incompatible files in red text. If you select an incompatible
backup set to restore a SmartStruxure server, no backup set displays after
importing.

04-17005-03-en, October 2015 System


1851
61 Backup Sets
61.8 Importing a Backup Set to an Enterprise Server

61.8 Importing a Backup Set to an Enterprise


Server
You import a backup set from a network storage location to restore an Enterprise
Server, or to replace a lost or damaged backup set.
For more information, see section 61.7 Backup Set Import from WorkStation on
page 1851.

To import a backup set to an Enterprise Server


1. In WorkStation, in the System Tree pane, select the Enterprise Server.
2. On the Actions menu, click Restore.
3. Click Import Backup Set.

4. Select a backup set that is stored on a file system and click Open.
5. Click Yes, if you want to replace an existing backup set.

6. Click Close.
You can now restore the Enterprise Server with the imported backup set.

System 04-17005-03-en, October 2015


1852
61 Backup Sets
61.9 Importing a Backup Set to SmartStruxure Server Device

61.9 Importing a Backup Set to


SmartStruxure Server Device
You import a backup set from a network storage location to restore a replacement
SmartStruxure server device, or to replace a lost or damaged backup set.
For more information, see section 61.7 Backup Set Import from WorkStation on
page 1851.

To import a backup set to SmartStruxure Server Device


1. Log on to the SmartStruxure server device to which you want to import a
backup set.
2. In WorkStation, in the System Tree pane, select the SmartStruxure server
device.
3. On the Actions menu, click Restore.
4. Click Import Backup Set.

5. Click OK.

Continued on next page

04-17005-03-en, October 2015 System


1853
61 Backup Sets
61.9 Importing a Backup Set to SmartStruxure Server Device

6. Select a valid backup set that is stored on a file system and click Open.
7. Click Close.
You can now restore the SmartStruxure server device with the imported backup
set.

System 04-17005-03-en, October 2015


1854
61 Backup Sets
61.10 Automatic Purge of Backup Sets

61.10 Automatic Purge of Backup Sets


An Enterprise Server stores multiple local and remote backup sets. As a result,
these sets can consume much needed space on the Enterprise Server. To resolve
this problem, you can configure the Enterprise Server to remove outdated backup
sets.
You configure purge settings on an Enterprise Server, rather than SmartStruxure
server devices. For more information, see section 64.3 Backup and Restore
Manager on the Enterprise Server on page 1906.

Purge Configuration on an Enterprise Server


You can set the maximum number of local and remote backups that you want to
store at a given time on the Enterprise Server. The system compares two values:
the maximum number that you set for the Enterprise server and the date stamp on
each stored backup. Whenever a new backup is created, the most recent backup
set replaces the most outdated backup set. In other words, the system adds a file
and then deletes the oldest file to maintain the maximum number that you set for
the Enterprise server.

Local and Remote Purge Settings


You can manage automatic purging on an Enterprise Server by setting a maximum
number of files to store. There are two purge settings:
Local setting for the Enterprise Server: The local setting, Number of local
backup sets to store, manages the backups stored on an Enterprise Server.
Global setting for SmartStruxure server devices: The global setting, Number
of AS backup sets to store, manages all the backups stored on the
SmartStruxure server devices. You cannot configure each SmartStruxure
server device separately because the global setting affects all the
SmartStruxure server devices created under the Enterprise Server.
You can vary the number of local and remote backup sets that you store. For
example, you can configure the system to store a maximum of five local backup
sets for the Enterprise Server and two remote backup sets for each SmartStruxure
server device.

Enable/Disable Automatic Purging


By default, Building Operation enables automatic purging for both local (Enterprise
Server) and remote (SmartStruxure server devices) backup sets. However, you can
disable this feature to ensure that all manual and scheduled backup sets are
automatically stored on the Enterprise Server. For more information, see section
64.3 Backup and Restore Manager on the Enterprise Server on page 1906.

04-17005-03-en, October 2015 System


1855
61 Backup Sets
61.11 Configuring Purge Settings on an Enterprise Server

61.11 Configuring Purge Settings on an


Enterprise Server
You purge outdated backup sets to help reduce the resource constraints on an
Enterprise Server. You cannot configure these settings on a SmartStruxure server
device.
For more information, see section 61.10 Automatic Purge of Backup Sets on
page 1855.

To configure purge settings on an Enterprise Server


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the Enterprise Server.

3. In the Backup and archiving area, click Backup and Restore Manager.
Continued on next page

System 04-17005-03-en, October 2015


1856
61 Backup Sets
61.11 Configuring Purge Settings on an Enterprise Server

4. In the Number of Automation Server backup sets to store box, enter


the maximum number of backups that the Enterprise Server can store for
each SmartStruxure server device.

5. In the Number of local backup sets to store box, enter the maximum
number of backup sets that the system can store for the Enterprise Server.

6. Click the Save button .

04-17005-03-en, October 2015 System


1857
61 Backup Sets
61.12 Deleting a Backup Set from the Enterprise Server

61.12 Deleting a Backup Set from the


Enterprise Server
You delete a backup set from the db_backup folder of the Enterprise Server when
you no longer need the backup set.
For more information, see section 61.1 Backup Sets on page 1839.

To delete a backup set from the Enterprise Server


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the Enterprise server.

3. Click Backup and Restore Manager.


Continued on next page

System 04-17005-03-en, October 2015


1858
61 Backup Sets
61.12 Deleting a Backup Set from the Enterprise Server

4. In the Backup sets path box, copy the entire backup sets path of the
Enterprise Server.

5. Open a browser, such as Windows Explorer.


6. In the browser Address box, paste the backup sets path and press Enter.
7. In the db_backup folder, open the ASArchives or LocalBackup folder.

8. Right-click on the backup set that you want to delete and click Delete.
9. Click Yes to remove the backup set.

04-17005-03-en, October 2015 System


1859
62 Scheduled Backups

Topics
Scheduled Backups
Backup Rules
Creating a Backup Rule
Editing a Backup Rule
Deleting a Backup Rule
Removing a Lead Rule from a Backup Rule
Backup Schedules
Editing a Backup Schedule
Synchronized Backups
Synchronizing SmartStruxure Server Backups on a Network
62 Scheduled Backups
62.1 Scheduled Backups

62.1 Scheduled Backups


A scheduled backup is an automated way to back up data on a SmartStruxure
server. You can back up SmartStruxure servers individually using each
SmartStruxure servers local backup rule. You can also use backup rules to
synchronize the backups of all the SmartStruxure servers on your network.
As part of the scheduled backup process, Building Operation automatically
generates unique file names and extensions based on the UTC date stamp and
version number. However, you can change the file name after the automatic backup
is completed. You can also enter a unique file name when you back up a
SmartStruxure server manually. For more information, see section 60.5 Manual
Backups on page 1828.

Figure: Backup on an Enterprise Server

62.1.1 Backup Rules


In Building Operation, scheduled backups are managed by backup rules, which are
conditions that govern behavior. Similar to a scheduled task, a backup rule
performs a backup on a SmartStruxure server using three pieces of data: when the
backup occurs, what type of data will be backed up, and a comment describing the
purpose of the backup.

04-17005-03-en, October 2015 System


1863
62 Scheduled Backups
62.1 Scheduled Backups

For more information, see section 62.2 Backup Rules on page 1865.

62.1.2 Backup Schedules


Building Operation includes a digital schedule that is combined with a default
backup rule. Using this schedule and rule, the system automatically backs up all
data on a SmartStruxure server every Sunday at 01:00. You can change the
schedule settings for this backup rule, but you cannot delete the schedule and
select another.
For more information, see section 62.7 Backup Schedules on page 1874.

62.1.3 Synchronized Backups


A synchronized backup is a method of performing a recurring, simultaneous
backup of a selected number of SmartStruxure servers. You can use a lead and
shadow relationship to automate all the SmartStruxure server backups on your
network. Using this method, you configure and manage one lead backup rule on
one SmartStruxure server, which other backup rules can reference.
For more information, see section 62.9 Synchronized Backups on page 1877.

System 04-17005-03-en, October 2015


1864
62 Scheduled Backups
62.2 Backup Rules

62.2 Backup Rules


In Building Operation, scheduled backups are managed by backup rules, which are
conditions that govern behavior. Similar to a scheduled task, a backup rule
performs a backup on a SmartStruxure server using three pieces of data: when the
backup occurs, what type of data will be backed up, and a comment describing the
purpose of the backup.
Building Operation automatically backs up all data on a SmartStruxure server every
Sunday at 01:00. However, you can change the backup rule settings. For example,
you can change the type of data you want to back up.
You can create your own backup rules to complete different tasks on different
SmartStruxure servers. For example, you can create a backup rule that backs up all
data on the Enterprise Server twice a day rather than once a week based on the
default setting. In addition, you can set up another backup rule for one
SmartStruxure server, which acts as the lead, to manage a recurring backup for a
group of SmartStruxure servers. For more information, see section 64.8 Backup
Rules View on page 1912.

04-17005-03-en, October 2015 System


1865
62 Scheduled Backups
62.3 Creating a Backup Rule

62.3 Creating a Backup Rule


You create a backup rule on a SmartStruxure server to schedule periodic backups.
You can also set up this backup rule to follow a shadow schedule that references a
lead schedule managed on another SmartStruxure server.
For more information, see section 62.2 Backup Rules on page 1865.

To create a backup rule


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Backup Rules.


Continued on next page

System 04-17005-03-en, October 2015


1866
62 Scheduled Backups
62.3 Creating a Backup Rule

4. Click the Add backup rule button .

5. In the Name box, type a name for the backup rule.

6. In the Description box, type a description for the backup rule and click
Next.
Continued on next page

04-17005-03-en, October 2015 System


1867
62 Scheduled Backups
62.3 Creating a Backup Rule

7. In the Backup set description box, type a comment up to 255 characters


to help identify the content of the backup.

8. In the Backup content box, select the type of data you want to back up:
Select Configuration only to back up the configuration database and
custom object type data. For example, use this option to restore data to a
replaced server with the same name in the system.
Select All data to back up the configuration, historical, and custom
object type data. For example, use this option to preserve the
configuration and historical data for a specified date and time.
9. In the Lead rule box, enter a backup rule that references a lead schedule
managed on another SmartStruxure server.
10. In the Enabled box, select Yes to enable the backup rule.
11. Click Create.

System 04-17005-03-en, October 2015


1868
62 Scheduled Backups
62.4 Editing a Backup Rule

62.4 Editing a Backup Rule


You edit a backup rule on a SmartStruxure server to change the type of data that
you want to back up. You can also set up this backup rule to follow a shadow
schedule that references a lead schedule managed on another SmartStruxure
server.
For more information, see section 62.2 Backup Rules on page 1865.

To edit a backup rule


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Backup Rules.


Continued on next page

04-17005-03-en, October 2015 System


1869
62 Scheduled Backups
62.4 Editing a Backup Rule

4. Select a backup rule and then click the Edit backup rule button .

5. In the Backup set description box, type or modify the backup comment.

6. In the Backup content box, change the type of data you want to back up:
Select Configuration only to back up the configuration database and
custom object type data. For example, use this option to restore data to a
replaced SmartStruxure server with the same name in the system.
Select All data to back up the configuration, historical, and custom
object type data. For example, use this option to preserve the
configuration and historical data for a specified date and time.
7. In the Lead rule box, enter a backup rule that references a lead schedule
managed on another SmartStruxure server.
8. In the Enabled box, select Yes to enable the backup rule.
9. Click OK.

10. Click the Save button .

System 04-17005-03-en, October 2015


1870
62 Scheduled Backups
62.5 Deleting a Backup Rule

62.5 Deleting a Backup Rule


You delete a backup rule to remove the rule from the SmartStruxure server.
For more information, see section 62.2 Backup Rules on page 1865.

To delete a backup rule


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the SmartStruxure server.

3. Click Backup Rules.


Continued on next page

04-17005-03-en, October 2015 System


1871
62 Scheduled Backups
62.5 Deleting a Backup Rule

4. Select the backup rule and then click the Remove backup rule button .

5. Click Yes to delete the backup rule from the SmartStruxure server.

6. Click the Save button .

System 04-17005-03-en, October 2015


1872
62 Scheduled Backups
62.6 Removing a Lead Rule from a Backup Rule

62.6 Removing a Lead Rule from a Backup


Rule
You remove the lead and shadow relationship from a SmartStruxure server by
deleting the lead rule reference.
For more information, see section 62.2 Backup Rules on page 1865.

To remove a lead rule from a backup rule


1. In WorkStation, on the Tools menu, select Control Panel.
2. In the Servers box, select the SmartStruxure server where you want to
remove a lead rule from a backup rule.
3. In the Backup and archiving area, click Backup Rules.

4. Select the backup rule and click the Edit backup rule button .

5. In the Lead rule box, delete the lead backup rule, which removes the lead
and shadow relationship for the selected SmartStruxure server.

6. Click OK.

7. Click the Save button .

04-17005-03-en, October 2015 System


1873
62 Scheduled Backups
62.7 Backup Schedules

62.7 Backup Schedules


Building Operation includes a digital schedule that is combined with a default
backup rule. Using this schedule and rule, the system automatically backs up all
data on a SmartStruxure server every Sunday at 01:00. You can change the
schedule settings for this backup rule, but you cannot delete the schedule and
select another.

Figure: Backup on a standalone Automation Server


You can create a custom backup rule and then modify its schedule. For example,
you can create a backup rule that backs up all data on an Automation Server daily
at 02:00. For more information, see section 64.8 Backup Rules View on page
1912.

System 04-17005-03-en, October 2015


1874
62 Scheduled Backups
62.8 Editing a Backup Schedule

62.8 Editing a Backup Schedule


You edit a backup schedule, which is combined with a backup rule, to change the
frequency of the backup.
For more information, see section 62.7 Backup Schedules on page 1874.

To edit a backup schedule


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the Enterprise server.

3. Click Backup Rules.


Continued on next page

04-17005-03-en, October 2015 System


1875
62 Scheduled Backups
62.8 Editing a Backup Schedule

4. In the Schedule column, click the schedule that you want to modify.

5. Revise the schedule and then click the Save button .

System 04-17005-03-en, October 2015


1876
62 Scheduled Backups
62.9 Synchronized Backups

62.9 Synchronized Backups


A synchronized backup is a method of performing a recurring, simultaneous
backup of a selected number of SmartStruxure servers. You can use a lead and
shadow relationship to automate all the SmartStruxure server backups on your
network. Using this method, you configure and manage one lead backup rule on
one SmartStruxure server, which other backup rules can reference.

Figure: Synchronized recurring backup Lead/Shadow method


The system synchronizes all the shadow rules with the lead backup rule, and all the
shadow schedules with the lead schedule. For more information, see section 62.10
Synchronizing SmartStruxure Server Backups on a Network on page 1878.

04-17005-03-en, October 2015 System


1877
62 Scheduled Backups
62.10 Synchronizing SmartStruxure Server Backups on a Network

62.10 Synchronizing SmartStruxure Server


Backups on a Network
You synchronize all SmartStruxure server backups to increase efficiency by
centralizing the automated backup management on a single SmartStruxure server,
rather than across multiple SmartStruxure servers.
For more information, see section 62.9 Synchronized Backups on page 1877.

To synchronize SmartStruxure server backups on a network


1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the Enterprise Server.

3. Click Backup Rules.


Continued on next page

System 04-17005-03-en, October 2015


1878
62 Scheduled Backups
62.10 Synchronizing SmartStruxure Server Backups on a Network

4. In the Lead rule column, enter a backup rule that you want to use as the lead
rule for one or more SmartStruxure servers in the list.

Note
When you select a lead rule, the backup rule on a SmartStruxure
server becomes a shadow of the lead rule.

5. Click the Save button .

04-17005-03-en, October 2015 System


1879
63 Restore

Topics
Restore
Restored Data
Restoring the SmartStruxure Server
Restoring a SmartStruxure Server Device from the
Enterprise Server
SmartStruxure Server Device Replacement Using Restore
SmartStruxure Server Device Replacement Using Restore
Workflow
Duplicate SmartStruxure Server Device from a Backup Set
Duplicating a SmartStruxure Server Device Using Restore
63 Restore
63.1 Restore

63.1 Restore
Restore is the process of restoring data to an original or former state. Using
Restore, you can revert to a previous snapshot of the SmartStruxure server data
despite any configuration changes made since the last backup. In Building
Operation, Restore is a manual process designed to avoid the accidental
overwriting of current SmartStruxure server data.

63.1.1 Restored Data


Depending on what is contained in the backup file, you can restore different types
of data.
Configuration only: Building Operation restores the configuration database
and custom object type data. Any existing historical data is lost when you
select this option.
All data: Building Operation restores the configuration, historical, and custom
object types data.
For more information, see section 63.2 Restored Data on page 1884.

63.1.2 SmartStruxure Server Device Replacement


Using Restore
Backup and Restore assures that SmartStruxure server devices data can be
restored to a replacement SmartStruxure server device in the event of hardware
failure, or to the same SmartStruxure server device in the event of data loss. As a
precaution, you back up your SmartStruxure server devices regularly so that you
can use the most current backup to restore the SmartStruxure server devices data
to a replacement SmartStruxure server device. You also configure the new
SmartStruxure server device to match the name and the network settings of the
replaced SmartStruxure server device so the system can identify this SmartStruxure
server device when online.
For more information, see section 63.5 SmartStruxure Server Device Replacement
Using Restore on page 1890.

63.1.3 Duplicate SmartStruxure Server Device Using


Restore
You can use the Restore function to re-use the configuration data from a backup
set in a new standalone SmartStruxure server device. Rather than manually
configuring your preferred SmartStruxure server device configuration, you can save
time and configure the standalone SmartStruxure server device from a backup set.
The backup set used can originate from a SmartStruxure server device that is or
has been part of a multi-server configuration.
For more information, see section 63.7 Duplicate SmartStruxure Server Device
from a Backup Set on page 1895.

04-17005-03-en, October 2015 System


1883
63 Restore
63.2 Restored Data

63.2 Restored Data


Depending on what is contained in the backup file, you can restore different types
of data.
Configuration only: Building Operation restores the configuration database
and custom object type data. Any existing historical data is lost when you
select this option.
All data: Building Operation restores the configuration, historical, and custom
object types data.

Table: Types of Data and Content


Types of Data Content

Historical Includes Trend logs and Event logs stored on the SmartStruxure
server.

Configuration Includes points, values, alarm objects, trend objects, programs,


graphics, and custom object type data stored on the SmartStruxure
server.
Includes the configuration properties of variables, such as Unit.
Depending on the retain level of the variable; some configuration
properties like Value are also restored.

The SmartStruxure server name is part of the restore data. Therefore, if you rename
the SmartStruxure server after a backup, a restore process will revert back to the
previous SmartStruxure server name.

Impact on Configuration Values and Variables


When you back up the SmartStruxure server specifying either Configuration only or
All data, Building Operation includes all the configuration values that are specified
for the SmartStruxure servers objects. If you restore the SmartStruxure server,
Building Operation restores these configuration values, which can overwrite any
changes made since the last backup.
Building Operation does not include most variable settings in a backup.
Consequently, Building Operation cannot restore these variable settings. However,
the system does back up the cold-start retained variables.

Restore from the SmartStruxure Server Device


When you restore the SmartStruxure server device locally, the system retrieves the
current master backup set for that SmartStruxure server device. However, you
cannot select a particular backup set because the SmartStruxure server device
stores only one backup set at a time.

Restore from an Enterprise Server


Unlike the SmartStruxure server device, the Enterprise Server can store multiple
local and non-local backup sets. When you restore the Enterprise Server, you can
select a local backup set from a list of files to restore the Enterprise Server. In
multiple server sites, the Enterprise Server manages all the SmartStruxure server
devices in its group. In this configuration, the non-local backup sets are stored in
separate folders for each SmartStruxure server device.

System 04-17005-03-en, October 2015


1884
63 Restore
63.2 Restored Data

When you restore the SmartStruxure server device from the Enterprise Server, you
can select a particular backup set from a list of files that are stored for that
SmartStruxure server device. This restore method provides greater flexibility. For
more information, see section 63.4 Restoring a SmartStruxure Server Device from
the Enterprise Server on page 1888.

Restore status
The SmartStruxure server properties indicate if a restore was performed:
Enterprise Server. For more information, see the Enterprise Server Properties
Basic Tab topic on WebHelp.
SmartStruxure server device. For more information, see the SmartStruxure
Server Device Properties Basic Tab topic on WebHelp.

04-17005-03-en, October 2015 System


1885
63 Restore
63.3 Restoring the SmartStruxure Server

63.3 Restoring the SmartStruxure Server


You restore the SmartStruxure server to revert back to a previous snapshot of the
SmartStruxure server data.
For more information, see section 63.1 Restore on page 1883.

Important
If your system includes the Reports Server and the Enterprise Server, stop the
Reporting Agent service on the Reports Server first to prevent report generation
during a restore of the Enterprise Server. For more information, see the Stopping
a Windows Service topic on WebHelp.

To restore the SmartStruxure server


1. In WorkStation, in the System Tree pane, select the SmartStruxure server
that you want to restore.
2. On the Actions menu, click Restore.

Tip
Take manual control of any output points that could potentially
damage equipment before restoring the SmartStruxure server. If you
cannot disconnect the physical outputs, restore the SmartStruxure
server using a trusted restore file that will turn off/on the outputs
predictably and safely.

3. In the Available restore points list, select a backup set in black text, which
indicates that the backup set is compatible with the current version of the
SmartStruxure server.

Continued on next page

System 04-17005-03-en, October 2015


1886
63 Restore
63.3 Restoring the SmartStruxure Server

4. Select the type of data you want to restore:


Select Configuration only to restore only configuration and custom
object types' data.
Select All data to restore the configuration, historical, and custom object
types data.
5. Click Restore.
6. Click Yes.
7. Click Close.
If your system includes the Reports Server, the Reporting Agent Windows
service restarts automatically.

04-17005-03-en, October 2015 System


1887
63 Restore
63.4 Restoring a SmartStruxure Server Device from the Enterprise Server

63.4 Restoring a SmartStruxure Server


Device from the Enterprise Server
You log on to an Enterprise Server to restore a SmartStruxure server device.
For more information, see section 63.1 Restore on page 1883.

To restore a SmartStruxure server device from the Enterprise


Server
1. In WorkStation, in the System Tree pane, select the SmartStruxure server
device that you want to restore.
2. On the Actions menu, click Restore.

Tip
Take manual control of any output points that could potentially
damage equipment before restoring the SmartStruxure server
device. If you cannot disconnect the physical outputs, restore the
SmartStruxure server device using a trusted restore file that will turn
off/on the outputs predictably and safely.

3. In the Available restore points list, select a backup set in black text, which
indicates that the backup set is compatible with the current version of the
SmartStruxure server device.

4. Select the type of data you want to restore:


Select Configuration only to back up only configuration and custom
object types data.
Select All data to back up the configuration, historical, and custom
object types data
Continued on next page

System 04-17005-03-en, October 2015


1888
63 Restore
63.4 Restoring a SmartStruxure Server Device from the Enterprise Server

5. Click Restore.
6. Click Yes.
7. Click Close.

Note
After a restore, WorkStation may display several a SmartStruxure
server device events in the Events pane that occurred while the
restore was taking place. However, these events are not part of the
restored log data.

04-17005-03-en, October 2015 System


1889
63 Restore
63.5 SmartStruxure Server Device Replacement Using Restore

63.5 SmartStruxure Server Device


Replacement Using Restore
Backup and Restore assures that SmartStruxure server devices data can be
restored to a replacement SmartStruxure server device in the event of hardware
failure, or to the same SmartStruxure server device in the event of data loss. As a
precaution, you back up your SmartStruxure server devices regularly so that you
can use the most current backup to restore the SmartStruxure server devices data
to a replacement SmartStruxure server device. You also configure the new
SmartStruxure server device to match the name and the network settings of the
replaced SmartStruxure server device so the system can identify this SmartStruxure
server device when online.

Supported Cases of SmartStruxure Server Device Replacements


The following cases of SmartStruxure server device replacements are supported
using restore:
Replacing a SmartStruxure server device with a SmartStruxure server device of
the same SmartStruxure server device type
Replacing Automation Server with Automation Server Premium
To replace Automation Server with Automation Server Premium, you first need to
install the server software on the new Automation Server Premium before you can
restore the configuration data and historical data from the replaced Automation
Server. For more information, see the Uploading and Upgrading a SmartStruxure
Server Device topic on WebHelp.

Caution
If you replace Automation Server with Automation Server Premium, consider the
difference in RS-485 bias voltage between the two servers to avoid decreased
performance and reliability of the RS-485 network. For more information, see the
RS-485 Communications topic on WebHelp.

Note
You can reuse an Automation Server terminal base (TB-AS-W1) for an
Automation Server Premium module by removing the terminal block at the top of
the terminal base.

SmartStruxure Server Device Names


Typically, SmartStruxure server devices and WorkStations can acquire different
identifiers and user-assigned names. For example, SmartStruxure server device has
a network identifier, AS-000E00, which is used internally but is difficult to
remember. For convenience, you can also assign a descriptive SmartStruxure
server device name, such as Main Lobby-AS, to locate this SmartStruxure server
device in Building Operation. You may encounter these two names during
configuration.

System 04-17005-03-en, October 2015


1890
63 Restore
63.5 SmartStruxure Server Device Replacement Using Restore

Network Device Protocols


If your network uses static IP addresses or DNS server names, you need to apply a
valid IP address or fully qualified domain name to a replacement SmartStruxure
server device. Specifically, you use the static IP address or fully qualified domain
name to locate the new SmartStruxure server device on the network. To
reconfigure the default TCP/IP settings on the new SmartStruxure server device to
match those of the replaced SmartStruxure server devices, you use the Automation
Server Web Configuration utility.
If your network uses DHCP, a new SmartStruxure server device can automatically
acquire TCP/IP configuration information from a DHCP server. When acquired, you
use the fully qualified domain name rather than the IP address to locate the new
SmartStruxure server device on the network. By default, DHCP is turned off on
SmartStruxure server devices. To enable this and other network settings on the
new SmartStruxure server device, you use the Device Administrator. For more
information, see the SmartStruxure Server Device Upgrade topic on WebHelp.

Important
Make sure that you have a valid SmartStruxure server device backup set
before performing a restore. A backup set can contain either configuration
data only, or both configuration and historical data.

Standalone SmartStruxure Server Device Site


In a single SmartStruxure server device site, you log onto the SmartStruxure server
device in WorkStation to manage Backup and Restore operations. In this scenario,
you need to have a valid backup set to restore the SmartStruxure server device in
case the hardware fails or data is lost.
The SmartStruxure server device only stores one backup set at a time. Therefore,
you should create a backup set when the SmartStruxure server device is
functioning properly and then store this backup set in different location. You save
and store a backup set on your WorkStation PC or network drive. You then can
import this backup set to the SmartStruxure server device.

Multi-server Site
In a multi-server site, you can log onto an Enterprise Server in WorkStation to
manage backup and restore operations for all the SmartStruxure server devices in
the group. Unlike the SmartStruxure server device, which only stores one backup
set at a time, the Enterprise Server can store multiple backup sets for each
SmartStruxure server device. From the AS Archives folder, you can select a stored
backup set that was created when the SmartStruxure server device was functioning
properly.
To store a backup set in another location, you save a selected backup set to a
folder on your WorkStation PC or network drive. You then log onto the new
SmartStruxure server device to import this backup set to the local directory. If you
do not log off from the Enterprise Server, the system uses the most current backup
set stored on the Enterprise Server hard drive instead of the newly imported file on
the SmartStruxure server device. Therefore, be sure to log onto the SmartStruxure
server device before restoring the SmartStruxure server device in WorkStation. For
more information, see section 61.5 Copying a SmartStruxure Server Device
Backup Set to WorkStation on page 1847.

04-17005-03-en, October 2015 System


1891
63 Restore
63.5 SmartStruxure Server Device Replacement Using Restore

63.5.1 SmartStruxure Server Device Replacement


Using Restore Workflow
Use the workflow to duplicate the SmartStruxure server device from a backup set.
For more information, see section 63.6 SmartStruxure Server Device Replacement
Using Restore Workflow on page 1893.

System 04-17005-03-en, October 2015


1892
63 Restore
63.6 SmartStruxure Server Device Replacement Using Restore Workflow

63.6 SmartStruxure Server Device


Replacement Using Restore Workflow
Use the workflow to duplicate the SmartStruxure server device from a backup set.

Figure: Duplicate SmartStruxure server device using restore flowchart

Copy SmartStruxure server device Backup Set to WorkStation


Save the most current backup set of the SmartStruxure server device that you want
to replace to WorkStation.
For more information, see section 61.5 Copying a SmartStruxure Server Device
Backup Set to WorkStation on page 1847.

Add new SmartStruxure server device to network and configure


communication settings
Add the new SmartStruxure server device to the network and configure the IP
address.
For more information, see the Configuring a SmartStruxure Server Device to Use
DHCP topic on WebHelp.
For more information, see the Setting the SmartStruxure server device IP Address
topic on WebHelp.

Log on to SmartStruxure server device using WorkStation


For more information, see the Logging on to WorkStation as a Building Operation
User topic on WebHelp.

04-17005-03-en, October 2015 System


1893
63 Restore
63.6 SmartStruxure Server Device Replacement Using Restore Workflow

Import backup set


Import the backup set to the new SmartStruxure server device.
For more information, see section 61.9 Importing a Backup Set to SmartStruxure
Server Device on page 1853.

Restore new SmartStruxure server device using the imported


Backup Set
Restore the new SmartStruxure server device using the imported backup set.
For more information, see section 63.3 Restoring the SmartStruxure Server on
page 1886.

Tip
If the SmartStruxure server device does not go online, you can manually recreate
the SmartStruxure server device or restore the connections between the
Enterprise Server and the SmartStruxure server device. For more information, see
the Automation Server Remains Offline After Restore topic on WebHelp.

The Restore process automatically renames the SmartStruxure server device and
specifies the objects and properties that the SmartStruxure server device uses to
reestablish links and go online.

System 04-17005-03-en, October 2015


1894
63 Restore
63.7 Duplicate SmartStruxure Server Device from a Backup Set

63.7 Duplicate SmartStruxure Server Device


from a Backup Set
You can use the Restore function to re-use the configuration data from a backup
set in a new standalone SmartStruxure server device. Rather than manually
configuring your preferred SmartStruxure server device configuration, you can save
time and configure the standalone SmartStruxure server device from a backup set.
The backup set used can originate from a SmartStruxure server device that is or
has been part of a multi-server configuration.
To store a backup set in another location, you save a selected backup set to a
folder on your WorkStation PC or network drive.
For more information, see section 61.1 Backup Sets on page 1839.

Protocol Compatibility
The restore function to re-use configuration data from a backup set is supported for
all Building Operation supported protocols, except for BACnet and b3 BACnet.
Fieldbus device ID handling is fully supported for LonWorks, but not handled for
other protocols.

Note
You have to commission all LonWorks devices on the new SmartStruxure server
device after use of the restore function to re-use configuration data from a backup
set.

Multi-server Site
To create a new SmartStruxure server device in a multi-server configuration, using a
locally stored backup set, you need to make the backup set available for restore on
the multi-server system. You add a new SmartStruxure server device to the
Enterprise Server and select the backup set in the Create Object Wizard.
For more information, see the Creating a SmartStruxure server device from a
Backup Set topic on WebHelp.

Standalone SmartStruxure Server Device Site


You use a locally stored backup set to duplicate another SmartStruxure server
device configuration in a standalone SmartStruxure server device. You then import
the backup set to a client and restore to the new standalone SmartStruxure server
device.
For more information, see section 63.8 Duplicating a SmartStruxure Server Device
Using Restore on page 1898.

Password deleted on duplicated SmartStruxure device


When you duplicate a SmartStruxure device from a backup set all passwords are
deleted on the duplicate for security reasons. The only exception is the default
admin password. The administrator is forced to change the password at the first
logon at the duplicate. All users must be given new passwords by the administrator.

04-17005-03-en, October 2015 System


1895
63 Restore
63.7 Duplicate SmartStruxure Server Device from a Backup Set

63.7.1 Duplicate SmartStruxure Server Device from a


Backup Set Workflow
Use the following workflow to duplicate a SmartStruxure server device from a
backup set.

Figure: Duplicate SmartStruxure server device using restore flowchart

Backup a SmartStruxure server device


Backup a SmartStruxure server device that has the configuration you want to use in
the new standalone SmartStruxure server device.
For more information, see section 60.7 Backing Up SmartStruxure Servers
Manually on page 1831.

Copy backup set to local directory


Copy the backup set to a local directory.
For more information, see section 61.5 Copying a SmartStruxure Server Device
Backup Set to WorkStation on page 1847.

Log on to standalone SmartStruxure server device


Log on to a new standalone SmartStruxure server device.
For more information, see the Logging on to WorkStation as a Building Operation
User topic on WebHelp.

Import backup set


Import the backup set.

System 04-17005-03-en, October 2015


1896
63 Restore
63.7 Duplicate SmartStruxure Server Device from a Backup Set

For more information, see section 61.9 Importing a Backup Set to SmartStruxure
Server Device on page 1853.

Restore SmartStruxure server device using Restore configuration


with new IDs
Use the Restore configuration with new IDs function to duplicate the configuration
data from the imported backup set in the new standalone SmartStruxure server
device. The communication settings from the backup set are not duplicated.
For more information, see section 63.8 Duplicating a SmartStruxure Server Device
Using Restore on page 1898.

Important
When you restore a standalone SmartStruxure server device, you are logged off
and need to log on manually after the restore is complete.

04-17005-03-en, October 2015 System


1897
63 Restore
63.8 Duplicating a SmartStruxure Server Device Using Restore

63.8 Duplicating a SmartStruxure Server


Device Using Restore
You duplicate a SmartStruxure server from a backup set using Restore when you
want to reuse configuration data from a backup set in a standalone SmartStruxure
server device.

Note
The locally stored backup set and the SmartStruxure server device need to have
the same password.

For more information, see section 63.7 Duplicate SmartStruxure Server Device
from a Backup Set on page 1895.

To duplicate a SmartStruxure Server Device using restore


1. In WorkStation, in the System Tree pane, select the server where you want to
duplicate configuration data from a backup set.
2. On the Actions menu, click Restore.
3. In the Available restore points list, select the backup set.

4. Select Restore configuration with new IDs checkbox to re-use the


configuration data from the backup set in a new standalone SmartStruxure
server device.
5. Click Restore.
6. Click Yes.
Continued on next page

System 04-17005-03-en, October 2015


1898
63 Restore
63.8 Duplicating a SmartStruxure Server Device Using Restore

7. Click Close.

04-17005-03-en, October 2015 System


1899
64 Backup and Restore User
Interface

Topics
Backup and Restore Manager Properties (Enterprise
Server) Basic Tab
Backup and Restore Manager Properties (SmartStruxure
Server Devices) Basic Tab
Backup and Restore Manager on the Enterprise Server
Backup and Restore Manager on a SmartStruxure Server
Device
Backup Options Dialog Box
Create Object Wizard Configure Backup Rule Page
Backup Rule Properties Basic Tab
Backup Rules View
Backup Rules Toolbar
Backup Rules List
Backup Schedule Properties Basic Tab
Backup Set Properties Basic Tab
Backup Sets View
Backup Status Dialog Box
Control Panel Backup and Archiving
Backup Rule Dialog Box
Backup and Restore System Tree Icons
Restore Options Dialog Box
Restore Status Dialog Box
Backup and Restore Folder Properties
64 Backup and Restore User Interface
64.1 Backup and Restore Manager Properties (Enterprise Server) Basic Tab

64.1 Backup and Restore Manager Properties


(Enterprise Server) Basic Tab
Use the Basic tab to view the current backup and restore status of an Enterprise
Server. In addition, you can set the maximum number of local and remote backup
sets to store so the system can purge the outdated files.

Figure: Backup and Restore Manager properties for the Enteprise Server

Table: Backup and Restore Manager Properties (Enterprise Server) Basic Tab
Component Description

Backup folder Displays the storage location of the backup


set.

Backup and restore status Displays the current status, such as backing
up.

Last backup Displays the date and time of the last


successful backup.

Purge AS backup sets Select Yes to enable automatic purging of


remote SmartStruxure server device backup
files at the next backup.

Purge local backup sets Select Yes to enable automatic purging of


local Enterprise Server backup files at the
next backup.

Number of remote AS backup sets to store Enter the maximum number of backup sets
that the system can store for each
SmartStruxure server device.

04-17005-03-en, October 2015 System


1903
64 Backup and Restore User Interface
64.1 Backup and Restore Manager Properties (Enterprise Server) Basic Tab

Continued
Component Description

Number of local backup sets to store Enter the maximum number of backup sets
that the system can store for the Enterprise
Server.

System 04-17005-03-en, October 2015


1904
64 Backup and Restore User Interface
64.2 Backup and Restore Manager Properties (SmartStruxure Server Devices) Basic Tab

64.2 Backup and Restore Manager Properties


(SmartStruxure Server Devices) Basic
Tab
Use the Basic tab to view the current backup and restore status of a
SmartStruxure server device.

Figure: Backup and Restore Manager for the SmartStruxure server device

Table: Backup and Restore Manager Properties (SmartStruxure Server Devices)


Basic Tab
Component Description

Backup and restore Displays the current status, such as backing up.
status

Last backup Displays the date and time of the last successful backup.

Backup folder Displays the storage location of the backup set.

04-17005-03-en, October 2015 System


1905
64 Backup and Restore User Interface
64.3 Backup and Restore Manager on the Enterprise Server

64.3 Backup and Restore Manager on the


Enterprise Server
Use the Backup and Restore Manager to supervise the backup settings in the
Building Operation system. You can also open this view in any SmartStruxure server
to view current and past backup information.

Figure: Backup and Restore Manager on the Enterprise Server

Table: Backup and Restore Manager


Component Description

Status Displays the current backup status, such as


backing up.

Last backup Displays the date and time of the last


successful backup.

Backup sets path Displays the path to where the Enterprise


Server stores all SmartStruxure server
backups.

Enable Automation Server purge Select to enable the Enterprise Server to


purge the oldest backup of the
SmartStruxure server device automatically
when a new backup for that SmartStruxure
server device is stored.

Number of Automation Server backup sets Enter the maximum number of backups that
to store the Enterprise Server can store for each
SmartStruxure server device.

Enable Enterprise Server purge Select to enable the Enterprise Server to


purge the oldest backup automatically when
a new backup is stored.

Number of local backup sets to store Enter the maximum number of backups that
the system can store for the Enterprise
Server.

System 04-17005-03-en, October 2015


1906
64 Backup and Restore User Interface
64.4 Backup and Restore Manager on a SmartStruxure Server Device

64.4 Backup and Restore Manager on a


SmartStruxure Server Device
Use the Backup and Restore Manager to view the backup status of a
SmartStruxure server device.

Figure: Backup and Restore Manager on an Automation Server

Table: Backup and Restore Manager on a SmartStruxure server device


Component Description

Status Displays the current status, such as backing up.

Last backup Displays the date and time of the last successful backup.

04-17005-03-en, October 2015 System


1907
64 Backup and Restore User Interface
64.5 Backup Options Dialog Box

64.5 Backup Options Dialog Box


Use the Backup Options dialog box to select the SmartStruxure server and the
type of data that you want to back up. You can also enter a unique file name for the
backup set.

Figure: Backup Options dialog box

Table: Backup Options Dialog Box


Property Description

Backup set name prefix Type the text that you want to add to the
beginning of the file name to help identify the
backup set.

Backup set name suffix Type the text that you want to add to the
end of the file name to help identify the
backup set.

Click to include all the listed SmartStruxure


servers in the backup operation. You can
also manually include or exclude a
SmartStruxure server using the Include
check box.

Click to exclude all the SmartStruxure


servers selected for the backup operation.

Click to add the same backup set


description entered for one SmartStruxure
server to all the other backup sets, such as
Final Configuration.

Click to add the same content type chosen


for one SmartStruxure server to all the other
backup sets, such as Configuration only.

System 04-17005-03-en, October 2015


1908
64 Backup and Restore User Interface
64.5 Backup Options Dialog Box

Continued
Property Description

Click to add both the backup set desciption


and content type chosen for one
SmartStruxure server to all the other backup
sets, such as Final Configuration and
Configuration only.

Server name Displays the name of the SmartStruxure


server.

Include Select the SmartStruxure servers that you


want to include in the backup.

Backup set name Displays the name of the backup set that
you entered.

Backup content Select the type of data that you want to back
up for the SmartStruxure server:
All data: Backs up both the historical
and configuration databases, which are
useful for existing systems. This
combined data option protects the
configuration, historical data, and
custom object type data for a specified
date and time.
Configuration only: Backs up the
configuration database and custom
object type data, which are useful for
new installations. This data option
protects the configuration data for a
specified date and time.

Backup set description Type a backup comment up to 255


characters that helps identify the type,
content, or purpose of the scheduled
backup.

04-17005-03-en, October 2015 System


1909
64 Backup and Restore User Interface
64.6 Create Object Wizard Configure Backup Rule Page

64.6 Create Object Wizard Configure


Backup Rule Page
Use the Configure Backup Rule page to define the type of data that you want to
back up and configure a lead rule.

Figure: Configure Backup Rule page

Table: Configure Backup Rules Page


Property Description

Name Displays the name of the backup rule.

Backup set Type a description up to 255 characters that helps to identify the
description type and contents of the scheduled backup.

Backup content Select the type of data that you want to back up.

Lead rule Enter a backup rule that can act as a lead backup rule.

Enabled Select Yes to enable the backup rule.

System 04-17005-03-en, October 2015


1910
64 Backup and Restore User Interface
64.7 Backup Rule Properties Basic Tab

64.7 Backup Rule Properties Basic Tab


Use the Basic tab to view the properties of the backup rule that you create. You
can also add a description to help identify the purpose of the backup rule.

Figure: Basic tab

Table: Basic Tab


Component Description

Backup content Select the type of data that you want to back up.

Backup set description Type a description up to 255 characters that helps to


identify the type and contents of the scheduled backup.

Enabled Select Yes to enable the backup rule.

Lead rule Enter a backup rule that can act as a lead backup rule.

04-17005-03-en, October 2015 System


1911
64 Backup and Restore User Interface
64.8 Backup Rules View

64.8 Backup Rules View


Use the Backup rules view to add, edit, or remove backup rules. You can also
modify the backup schedule associated with the backup rule. In addition, you can
select a backup rule that can act as a lead rule.

Figure: Backup rules view

Table: Backup Rules View


Number Description

Use the Backup Rules toolbar to create, edit, or remove


backup sets. For more information, see section 64.9 Backup
Rules Toolbar on page 1913.

Use the Backup Rules list to modify backup schedules or set


up lead rules. For more information, see section 64.10 Backup
Rules List on page 1914.

System 04-17005-03-en, October 2015


1912
64 Backup and Restore User Interface
64.9 Backup Rules Toolbar

64.9 Backup Rules Toolbar


Use the Backup rules toolbar to add, edit, or remove backup rules.
Button Description

Add backup rule


Click to open the Create Object wizard where you create a backup
rule. For more information, see section 62.3 Creating a Backup Rule on
page 1866.

Edit backup rule


Click to open the Backup rule dialog box where you modify a backup
rule. For more information, see section 62.4 Editing a Backup Rule on
page 1869.

Remove backup rule


Click to delete a backup rule. For more information, see section 62.5
Deleting a Backup Rule on page 1871.

04-17005-03-en, October 2015 System


1913
64 Backup and Restore User Interface
64.10 Backup Rules List

64.10 Backup Rules List


Use the Backup rules list to select a lead rule or modify a backup schedule for a
backup rule.

Figure: Backup rules list view

Table: Backup Rules List View


Component Description

Name Displays the name of the backup rule.

Path Displays the location of the backup rule on the SmartStruxure server.

Lead rule Enter a backup rule that can act as a lead backup rule.

Schedule Click to open the Schedule Editor where you modify the backup
schedule contained in the backup rule. For more information, see
section 46.6 Editing a Weekly Event on page 1465.

System 04-17005-03-en, October 2015


1914
64 Backup and Restore User Interface
64.11 Backup Schedule Properties Basic Tab

64.11 Backup Schedule Properties Basic Tab


Use the Basic tab to change the type of data that you want to back up. You can
modify but not delete this backup schedule.

Figure: Basic tab

Table: Basic Tab


Component Description

Name Type the name of the object to create.

Description Type a description that explains what the object is used for.

Type Displays the schedule type.

Foreign Address

Modified Displays the date and time when the object was last modified.

Note 1 You can add text in the Note 1 and Note 2 boxes. The text in these
boxes are text strings and do not affect the object. The text in
these boxes can be used in a graphic or when searching.

04-17005-03-en, October 2015 System


1915
64 Backup and Restore User Interface
64.11 Backup Schedule Properties Basic Tab

Continued
Component Description

Note 2 You can add text in the Note 1 and Note 2 boxes. The text in these
boxes are text strings and do not affect the object. The text in
these boxes can be used in a graphic or when searching.

Validation Validation helps you to keep track of the object you have
validated. You can set the validation to None, Failed, and
Successful. The settings in this box are text strings and do not
affect the object. The settings can be used when searching.

References Displays the objects that refer to this object.

Value Select the value associated with the event.

Previous transition Displays the date and time the value most recently changed.
time

Time since Displays the amount of time in minutes that has elapsed since the
previous transition value last changed, rounded to the next minute.

Next transition Displays what the Value property will be when it next changes.
value

Time to next Displays the amount of time in minutes before the value changes.
transition

Following Displays the subsequent value following the next transition value.
transition value

Following Displays the subsequent date and time following the next transition
transition time time.

Time to following Displays the amount of time in minutes before the value changes to
transition the following transition value.

Remove past Select True to enable the system to delete events older than 72
events hours.

Effective period Enter the range of time a schedule is in service.

Default value Select the value of the schedule when there are no events in effect.

Lead object Select a lead schedule to reference.

System 04-17005-03-en, October 2015


1916
64 Backup and Restore User Interface
64.12 Backup Set Properties Basic Tab

64.12 Backup Set Properties Basic Tab


Use the Basic tab to view a read-only summary of the current backup set
information.

Figure: Basic tab

Table: Basic Tab


Component Description

Server revision Displays the software version of the


SmartStruxure server at the time the backup
took place.

Backup date Displays the date and time of the backup


set.

Backup content Select the type of data that you want to back
up.

Server type Displays the type of SmartStruxure server


that can be restored using this backup set.

04-17005-03-en, October 2015 System


1917
64 Backup and Restore User Interface
64.13 Backup Sets View

64.13 Backup Sets View


Use the Backup sets view to browse a list of backup sets on a SmartStruxure
server.

Figure: Backup Sets view

Table: Backup Sets View


Number Description

Use the List View toolbar to navigate in a list, to group and sort
objects in a list, and to view the properties of a selected object in
a list. For more information, see section 50.29 List View Toolbar
on page 1637.

Use the AS Archives folder to view the backup sets that belong
to a SmartStruxure server devices.

Use the Local folder to view the backup sets that belong to an
Enterprise Server.

System 04-17005-03-en, October 2015


1918
64 Backup and Restore User Interface
64.14 Backup Status Dialog Box

64.14 Backup Status Dialog Box


The Backup Status dialog box displays the progress and status of a manual
backup. Once the backup starts, the process cannot be stopped but you can close
this informational dialog box at any time.

Figure: Backup Status dialog box

Table: Backup Status Dialog Box


Component Description

Name Displays the name of the object.

Status Displays the current backup status.

Progress Displays the progress of the backup.

Note
The Backup Status dialog box does not appear during a scheduled backup.
However, you can open the Backup and Restore Manager from the Control Panel
on the Tools menu to view the current status of a scheduled backup.

04-17005-03-en, October 2015 System


1919
64 Backup and Restore User Interface
64.15 Control Panel Backup and Archiving

64.15 Control Panel Backup and Archiving


Use the Backup and Archiving options on the Control Panel to create new
backup rules, diagnose backup or restore issues, and view the current status of a
SmartStruxure server.

Figure: Control Panel Backup and archiving

Table: Control Panel Backup and Archiving


Component Description

Backup Rules Click to open the Backup Rules view where you manage
backup rules. You can also modify the backup schedule
associated with the backup rule. For more information, see
section 64.8 Backup Rules View on page 1912.

Backup Sets Click to open the Backup Sets view where you manage
backup sets. For more information, see section 64.13
Backup Sets View on page 1918.

Backup and Restore Click to open the Backup and Restore Manager where
Manager you view current backup and restore statuses and configure
Purge settings for an Enterprise Server. For more information,
see section 64.3 Backup and Restore Manager on the
Enterprise Server on page 1906.

Archiving Click to open the Archive Settings where you enable the
archiving function, set delay, and select the format of the
archive file. For more information, see section 53.3 Archiving
Settings Properties Basic Tab on page 1748.

System 04-17005-03-en, October 2015


1920
64 Backup and Restore User Interface
64.16 Backup Rule Dialog Box

64.16 Backup Rule Dialog Box


Use the Backup Rule dialog box to change the type of data contained in the
backup. You can also add a comment to identify the content or purpose of the
backup. In addition, you can enable or disable the backup rule.

Figure: Backup Rule dialog box

Table: Backup Rule Dialog Box


Component Description

Name Displays the name of the backup rule.

Backup set description Type a description up to 255 characters that helps to identify
the type and contents of the scheduled backup.

Backup content Select the type of data that you want to back up.

Lead rule Enter a backup rule that can act as a lead backup rule.

Enabled Select Yes to enable the backup rule.

04-17005-03-en, October 2015 System


1921
64 Backup and Restore User Interface
64.17 Backup and Restore System Tree Icons

64.17 Backup and Restore System Tree Icons


The following table describes the Backup and Restore icons in the System Tree.

Table: Backup and Restore System Tree Icons


Icon Description

Backup
Indicates one of the following backup and restore objects:
Backup rule. For more information, see section 60.1 Backup on page
1823.
Backup and Restore Manager. For more information, see section 64.3
Backup and Restore Manager on the Enterprise Server on page
1906.

Backup schedule
Indicates a backup schedule. For more information, see section 62.7
Backup Schedules on page 1874.

System 04-17005-03-en, October 2015


1922
64 Backup and Restore User Interface
64.18 Restore Options Dialog Box

64.18 Restore Options Dialog Box


Use the Restore Options dialog box to select a backup set and the type of data
that you want to restore. You can also import a backup set from a network storage
location and restore the SmartStruxure server, or duplicate a SmartStruxure server
from a backup set using Restore when you want to reuse configuration data from a
backup set in a standalone Automation Server.

Figure: Restore Options dialog box

Table: Restore Options Dialog Box


Component Description

Name Displays the name of the backup set for the selected SmartStruxure
server.

Created on Displays the date the backup set was created.

Description Displays a description of the backup set.

Configuration Select to restore only the configuration data and custom object type
only data. No historical data is restored.

All Data Select to restore the historical data, configuration data, and custom
(Configuration object type data.
and Historical)

Import Backup Click to import the backup set to a SmartStruxure server. In a multi-
Set server configuration, you can import both Automation Server and
Enterprise Server backup sets to the Enterprise Server.

04-17005-03-en, October 2015 System


1923
64 Backup and Restore User Interface
64.18 Restore Options Dialog Box

Continued
Component Description

Restore Select to duplicate the configuration data from the imported backup
configuration set in the new standalone Automation Server. The communication
with new IDs settings from the backup set will not be duplicated.
For more information, see section 63.7 Duplicate SmartStruxure
Server Device from a Backup Set on page 1895.

System 04-17005-03-en, October 2015


1924
64 Backup and Restore User Interface
64.19 Restore Status Dialog Box

64.19 Restore Status Dialog Box


The Restore Status dialog box displays the progress and status of a restore.
Once the restore starts, the process cannot be stopped but you can close this
informational dialog box at any time.

Figure: Restore Status dialog box

04-17005-03-en, October 2015 System


1925
64 Backup and Restore User Interface
64.20 Backup and Restore Folder Properties

64.20 Backup and Restore Folder Properties


Use the Backup and Restore Folder Properties view or dialog box to
configure and view the general properties.

Figure: Basic tab

System 04-17005-03-en, October 2015


1926
Schneider Electric | Buildings Division
www.schneider-electric.com/buildings

2015 Schneider Electric. All rights reserved.

04-17005-03-en
October 2015

Vous aimerez peut-être aussi