Skip to Content

Wiki source code of 7. Events Setup

Version 59.1 by Lana on 2025/12/11 01:15
Hide last authors
Lana 2.2 1 = CONTENT =
2
3 = 1. INTRODUCTION =
4
5 CENTO is a multifunctional software platform for data collection, processing and display. This Manual describes the user tool in CENTO "Events".
6
7 It is assumed that the user is already familiar with the basic elements of the CENTO interface after reading the "User Manual" instructions.
8
9 "Events" in CENTO are designed to increase the observability of system operation by tracking changes in the system status and process equipment, logging events, and notifying users. Events help the personnel to timely react to changes in the technological process and system operation. To achieve these goals, CENTO offers user notification and acknowledgement features alongside event logging.
10
Lana 2.3 11 = 2. CENTO EVENTS =
12
Lana 4.2 13 == 2.1. Event editor ==
14
15 To go to the **Event editor**, select the item in the main menu:
16
17 Settings > Events > Event editor.
18
19 [[image:Screenshot 2025-12-10 at 21.28.44.png]]
20
21 Fig. 2.1 - Event editor in the CENTO menu
22
23 Figure 2.2. shows the interface of the **Event editor.**
24
25 [[image:Screenshot 2025-12-10 at 21.29.15.png]]
Lana 6.2 26
27 Fig. 2.2 - Event editor
28
29 The **Event editor** page provides the option to:
30
Lana 10.2 31 1. Add a new event to the system [[image:Screenshot 2025-12-10 at 21.29.51.png||height="21" width="74"]]
Lana 13.2 32 1. Activate [[image:Screenshot 2025-12-10 at 21.30.26.png||height="20" width="108"]] or disable [[image:Screenshot 2025-12-10 at 21.30.54.png||height="20" width="103"]] selected events
Lana 7.3 33 1. (((
Lana 10.2 34 Edit [[image:Screenshot 2025-12-10 at 21.32.53.png||height="25" width="24"]], copy [[image:Screenshot 2025-12-10 at 21.33.40.png||height="26" width="26"]], and delete [[image:Screenshot 2025-12-10 at 21.34.05.png||height="27" width="27"]]in the "Actions" column
Lana 7.3 35 )))
36 1. (((
Lana 13.2 37 Delete any number of events [[image:Screenshot 2025-12-10 at 21.35.15.png||height="22" width="125"]]
Lana 7.3 38 )))
Lana 12.2 39 1. (((
40 Edit the number of records to be displayed
41 )))
42 1. (((
Lana 13.2 43 Search for events of interest by filtering [[image:Screenshot 2025-12-10 at 21.36.03.png||height="32" width="33"]] (the filter is located to the right of the table headings)
Lana 12.2 44 )))
Lana 13.2 45 1. (((
Lana 14.2 46 Edit event configuration [[image:Screenshot 2025-12-10 at 21.36.56.png||height="22" width="86"]]
Lana 13.2 47 )))
Lana 14.2 48 1. (((
49 Adjust the setpoint text [[image:Screenshot 2025-12-10 at 21.37.32.png||height="23" width="122"]]
50 )))
Lana 6.2 51
Lana 14.2 52 == 2.2. Creating and editing an event in web-interface ==
Lana 13.2 53
Lana 14.2 54
Lana 16.2 55 An event can be created manually and automatically. Events are automatically created when the setpoint parameter is enabled. For a detailed description, refer to the "Setup Manual".
Lana 14.2 56
Lana 16.2 57 The text of setpoints can be edited in the **Event editor** interface.
58
59 To do this, click on the button [[image:Screenshot 2025-12-10 at 21.38.47.png||height="22" width="119"]]. After that, the **Setpoint editing** window opens (see Fig. 2.3), where the wording of the setpoints for Triggering and/or Return can be modified, such as Upper/Lower warning limit, Upper/Lower alarm limit, and Upper/Lower physical limit.
60
61 One or more variables can be specified in the setpoint triggering message:
62
63 * ~{~{.tag_name}} - tag name;
64 * ~{~{.tag_code}} - tag code;
65 * ~{~{.tag_id}} - tag ID;
66 * ~{~{.tag_code_or_id}} - tag code, if the code is empty, then its ID;
67 * ~{~{.tag_limit}} - setpoint value;
68 * ~{~{.tag_unit}} - tag units;
69 * ~{~{.device_name}} - name of the device to which the tag is linked.
70
71 IMPORTANT: if {figure brackets} or dots are missing when writing these parameters, a validation error will occur.
72
Lana 18.2 73 If a parameter with an error (non-existent parameter) is entered, for example: ~{~{.tag_name_2}}, the Operating journal will receive an event of the following type: [[image:Screenshot 2025-12-10 at 21.39.52.png||height="18" width="18"]] **< no value> > 10**.
Lana 16.2 74
Lana 18.2 75 [[image:Screenshot 2025-12-10 at 21.40.35.png]]
76
Lana 19.2 77 Fig. 2.3 - Setpoint editing page
78
79 To create a new event, click on the button [[image:Screenshot 2025-12-10 at 21.41.09.png||height="24" width="96"]].
80
81 Only an authorized user with appropriate rights can create and edit events.
82
83 Fig. 2.4. shows the page for creating a new event.
84
Lana 21.2 85 [[image:Screenshot 2025-12-10 at 21.41.54.png]]
Lana 19.2 86
Lana 21.2 87 Fig. Event editor: creation page
88
89 The** Event editor** window contains the following fields:
90
91 **Identifier **contains the sequence number of the event (filled in automatically), can be changed if necessary.
92
93 **Name **is a field for entering the name of the event.
94
95 **Object **field is used to add an object from the CENTO Information Model (IM), to which the event refers (see "Information Model Setup Manual"). The IM object is selected from the IM drop-down tree.
96
97 **Device **is** **the device to which the event refers is added in this field. The device is selected from the drop-down device tree.
98
99 **Event type **switches the event type between "Single" and "With return" [[image:Screenshot 2025-12-10 at 21.42.53.png||height="27" width="135"]].
100
Lana 22.2 101 There are two types of events in CENTO – single and with return events. For system objects, there may be important state that the user should see in the active status (e.g., "Ground in a network with isolated neutral", "Switching on a sectionalizer", "Opening the emergency exit door"). Events reporting this important state are opening events. Events reporting the end of an important object state are closing events. These two types of events are events with return. **Events with return should ALWAYS be paired: the second event ALWAYS closes the first one. **Events in the active state are displayed in a separate tab of the operational log and disappear from there after triggering the closing event. Other events (regardless of their importance) are single events.
Lana 21.2 102
Lana 22.2 103 **Tags **field requires to specify the ID of the telemetering tag to which the event belongs;
Lana 21.2 104
Lana 22.2 105 **Message **is the message text that should be output when the event is triggered;
106
107 **Formula **field is used to enter a formula that describes the condition for the event to be triggered. Clicking on [[image:Screenshot 2025-12-10 at 21.43.51.png||height="28" width="163"]] will open the list of formulas for forming the event. Description of formulas is given in the Appendix.
108
109 **Dead time, (ms)** field specifies the delay time for the event to be generated in milliseconds. It helps prevent false events, such as those caused by frequent device polling failures due to poor communication.
110
111 **Type** is** **a drop-down list used to specify the importance or category of the event.
112
113 **Acknowledgement **is a switch to activate the function of user acknowledgement of event notification;
114
Lana 24.2 115 **Sound **field is used to select a sound for notification. The drop-down list contains those sounds that are loaded through the Sound Editor (see item 3). The selected sound can be listened to using the button [[image:Screenshot 2025-12-10 at 21.44.31.png||height="24" width="27"]] to the right of the "Sound" field.
Lana 22.2 116
Lana 24.2 117 **Before acknowledgement** is a switch to play the selected sound before the event is acknowledged;
Lana 22.2 118
Lana 24.2 119 **Sound repeats **field is used to set the number of repetitions of sound playback when the event occurs.
120
121 **Warning! **Modern browsers block playback of sounds in a browser by default, so sound alerts may not be played. To allow CENTO to play sounds in the browser, follow the steps below (an example is given for Chrome):
122
Lana 24.3 123 ~1. Left click to the left of the address bar (see Fig. 2.5).
Lana 24.2 124
Lana 24.3 125 2. Select "Site settings".
126
Lana 24.2 127 [[image:Screenshot 2025-12-10 at 21.45.18.png]]
128
Lana 24.3 129 Fig. 2.5 - Site settings
Lana 24.2 130
Lana 24.3 131 3. In the opened window, go to Privacy and security → Site settings → Additional permissions → Content → Additional content settings → Sound, and select Allow (see Fig. 2.6).
Lana 24.2 132
Lana 26.2 133 [[image:Screenshot 2025-12-10 at 21.48.19.png]]
Lana 24.3 134
Lana 26.2 135 Fig. 2.6 - Allow sound
136
137 4. Refresh the CENTO page.
138
Lana 28.2 139 After filling in all the required fields, click [[image:Screenshot 2025-12-10 at 21.48.55.png||height="25" width="70"]] and update the configuration (see Fig. 2.7).
Lana 26.2 140
Lana 28.2 141 [[image:Screenshot 2025-12-10 at 21.49.27.png]]
Lana 26.2 142
Lana 28.2 143 Fig. 2.7 - Update  configuration
144
145 If selecting **With return** in the Event type, the **Event editor** window displays additional fields with the general heading **With return** (see Fig. 2.8). These fields are the same as those used for the **Single** event type.
146
147 [[image:Screenshot 2025-12-10 at 21.49.59.png]]
148
149 Fig. 2.8 - With return event editor window
150
Lana 29.2 151 == 2.3. Creating and editing events using Excel ==
Lana 28.2 152
Lana 29.2 153 Events can be configured using Excel files. This function is available on the page /CENTO/web/ui/configuration_loader/index (Settings > Configuration Files) (see Fig. 2.9).
Lana 28.2 154
Lana 29.2 155 [[image:Screenshot 2025-12-10 at 21.51.04.png]]
156
157 Fig. 2.9 - Import/Export configuration file page
158
Lana 31.2 159 To configure events, download the events.xlsx file by clicking the button [[image:Screenshot 2025-12-10 at 21.51.37.png||height="28" width="97"]], then fill in the appropriate cells in the new line of the table in the **Events** tab (see Fig. 2.10).
Lana 29.2 160
Lana 31.2 161 [[image:Screenshot 2025-12-10 at 21.52.08.png]]
162
163 Fig. 2.10 - Events tab in the events.xslx file
164
165 To create an event, fill in the following columns:
166
167 **Event ID **is an event unique number.
168
169 **Name **is the name of the event.
170
171 **Event type **is one_position or two_position event.
172
173 **Event status **is responsible for the event status: 1 - event is enabled, 0 - event is disabled.
174
175 **Device ID **is a device identifier to which the event refers.
176
177 **The device** is not required to be filled in, it is generated when downloading an Excel file to help with debugging (displays the path of the linked device).
178
Lana 32.2 179 **Object ID **is an IM object identifier to which the event refers.
Lana 31.2 180
Lana 32.2 181 **Object** does not need to be filled in, it is generated when downloading an Excel file to help in debugging (displays the path of the linked object).
Lana 7.2 182
Lana 32.2 183 **Tags **is a tag (parameter) Identifier to which the event refers.
184
185 **Formula** defines the condition under which the event is to be triggered. Description of formulas is given in the Appendix.
186
187 **Dead time, ms **is a field to enter the delay time, in milliseconds, for the event to be triggered.
188
189 **Event type code **is a code, which is entered according to the **Event type** directory using a separate tab in this file.
190
191 **Event type name **is a name of the event type, the field is filled in automatically when uploading-downloading the configuration file.
192
193 **Message **is a message text that should be displayed in the logs when the event is triggered.
194
195 **Acknowledgement **is responsible for the event acknowledgement. True - acknowledgement is enabled, False - acknowledgement is disabled.
196
197 **Sound ID **specifies an ID of a sound file loaded through the sound editor.
198
199 **Sound name **is a name of the sound file, the field is filled in automatically when loading-unloading the configuration file.
200
201 **Repeat count **is used to set the number of repetitions of sound playback when the event is triggered.
202
203 **Infinity repeat **is responsible for repeating the sound until the user acknowledges the event. True - infinite repetition is enabled, False - infinite repetition is disabled.
204
205 After all required fields are filled in, the file should be uploaded using the button [[image:Screenshot 2025-12-10 at 21.53.38.png||height="22" width="77"]] on the **Import/Export configuration file** page (see Fig. 2.9). In the window that appears (see Fig. 2.11), select the filled in events.xlsx file. The system will automatically validate the file to ensure it is correctly filled in and formatted (see Fig. 2.12).
206
Lana 35.2 207 [[image:Screenshot 2025-12-10 at 21.54.07.png||height="234" width="379"]]
Lana 32.2 208
Lana 35.2 209 Fig. 2.11 - Upload configuration file window
Lana 32.2 210
Lana 35.2 211 [[image:Screenshot 2025-12-10 at 21.54.41.png||height="413" width="477"]]
212
213 Fig. 2.12 - Validating the configuration file
214
215 If errors are detected, they will be displayed in the file upload window. After all errors are eliminated, the **Write configuration** button will become available.
216
217 After uploading the file, the configuration should be refreshed to apply the changes (see Fig. 2.7).
218
219 To make working with events more convenient, CENTO provides the option to edit the event configuration partially using Excel.
220
Lana 36.3 221 To do this, on the page /CENTO/web/ui/event_editor/index (menu item Settings > Events > Event editor (see Fig. 2.1 - Fig. 2.2), search for an events using the filtering [[image:Screenshot 2025-12-10 at 21.55.29.png||height="24" width="25"]], then click on the button [[image:Screenshot 2025-12-10 at 21.55.55.png||height="25" width="95"]]and select **Download** in the drop-down list. After that, the file events.xlsx will be downloaded to the PC, containing only the filtered events from the **Events editor**.
Lana 35.2 222
Lana 36.2 223 Actions when filling/editing the columns of the Excel table are similar to the actions during uploading from the** Import/Export configuration file** menu (see Fig. 2.9 - Fig. 2.10).
Lana 35.2 224
Lana 36.2 225 NOTE: when adding a new event, crossing **Event ID** is unacceptable as an incomplete event configuration is unloaded. The new **ID** should not match the existing one in the system (configuration).
226
Lana 36.3 227 To upload the changes made to the file, click on the button [[image:Screenshot 2025-12-10 at 21.55.55.png||height="25" width="95"]] select **Upload** from the drop-down list. Events that were not taken into account when downloading the Excel file will remain unchanged
Lana 36.2 228
Lana 36.3 229 IMPORTANT: partial upload/download is not compatible with previously downloaded Excel files. If an Excel file was downloaded using an earlier version of the service (prior to the introduction of the partial upload/download feature), it cannot be uploaded back - an error message saying "Version incompatibility" appears.
Lana 36.2 230
Lana 36.3 231 == 2.4. Flashing on the diagram ==
232
233 The flashing of an object on the diagram can be configured in the following ways:
234
Lana 37.2 235 **~1. Flashing by tag**
Lana 36.3 236
237 This method is relevant if the system does not have and does not plan to customize the information model.
238
239 To customize the flashing of a diagram object by tag:
240
Lana 37.2 241 A) Set up an event that will contain the formula, for example, connection loss (ti40027171 != 1) or restoration of connection (ti40027171 == 1) with the device (see Fig. 2.13). The formula can refer not only to the device status, any tags registered in the system can be applied here, in this example, the device status is used as a special case. For more details on the available formulas and expressions, please refer to the** Setup Manual. **
Lana 36.3 242
Lana 37.2 243 [[image:Screenshot 2025-12-10 at 21.58.43.png]]
Lana 36.3 244
Lana 39.2 245 Fig. 2.13 - Event for tag flashing
Lana 37.2 246
Lana 39.2 247 B) Create a calculated tag with the formula [devstatusNN], where NN is the device id (see Figure 2.14). The binding to devstatus is used for example. The tag to be used for the designated purpose may get the value from the real device or may be based on other tags.
Lana 37.2 248
Lana 39.2 249 [[image:Screenshot 2025-12-10 at 21.59.17.png]]
250
251 Fig. 2.14 - Calculated tag to create tag flashing on the diagram
252
253 C) Set up an object on the diagram, in the rules of which the calculated tag from point b will be applied (see Fig. 2.15).
254
255 [[image:Screenshot 2025-12-10 at 21.59.53.png]]
256
Lana 40.2 257 Figure 2.15 - Example rules with the tag created in step b.
Lana 39.2 258
Lana 40.2 259 D) After saving the diagram and updating the configuration, if the status of the NN device changes, the system will start it flashing on the diagram until acknowledged.
Lana 39.2 260
Lana 40.2 261 **2. Flashing by the information model object**
262
263 For this method to work, the information model should be configured, and the required information model object should be selected in the event setting (**Object** field). In this case, the diagram object should be active (see more details in the "Diagrams Development Manual") and bound to the information model object selected in the event.
264
265 Let us consider an example of this solution.
266
267 A) Create an event with the selected object of the information model in the **Object** field (see Fig. 2.15).[[image:Screenshot 2025-12-10 at 22.01.01.png]]
268
Lana 41.2 269 Fig. 2.15 - Creating an event with the information model object.
Lana 40.2 270
Lana 41.2 271 B) Create an active object on the diagram bound to the object of the information model, which was selected in the event settings (see Fig. 2.16).
272
273 [[image:Screenshot 2025-12-10 at 22.02.05.png]]
274
275 Fig. 2.16 - Creating a diagram object bound to the information model.
276
Lana 42.2 277 = 3. NOTIFICATIONS SETTINGS =
Lana 41.2 278
Lana 42.2 279 == 3.1. Creating and editing notifications ==
Lana 41.2 280
Lana 42.2 281 CENTO has the function to notify users about an event triggered via e-mail.
282
283 To configure notifications, go to the /CENTO/web/ui/notifications_configuration/index page (menu item Settings > Events > Notifications (see Fig. 2.1). The configuration of the mail server is described in the "Setup Manual, Mail servers".
284
285
286 [[image:Screenshot 2025-12-10 at 22.03.45.png]]
287
Lana 43.2 288 Fig. 3.1 - Notifications interface
289
290 In the interface presented, the user has the ability to:
291
292 ~1. Create notifications;
293
294 2. Edit notifications.
295
296 The notification table has the following columns.
297
298 1. **Name **is the name of the notification.
299 1. **Emails **are the e-mail addresses that have been configured to receive notifications.
300 1. **Dispatch period **is the time of the day allowed for sending notifications.
301 1. **Iteration period** is the minimum time interval between notifications, meaning notifications cannot be sent to the recipient more frequently than this set period.
302 1. **Operation threshold **is the number of event triggers required before a notification is sent.
303 1. **State **is on/off.
Lana 45.2 304 1. **Actions** are operations available to the user that can be performed in response to an event (edit [[image:Screenshot 2025-12-10 at 22.05.05.png||height="25" width="27"]], copy [[image:Screenshot 2025-12-10 at 22.05.32.png||height="26" width="26"]], delete [[image:Screenshot 2025-12-10 at 22.05.55.png||height="26" width="23"]]).​​​​​​​
Lana 43.2 305
Lana 45.2 306
307
Lana 6.2 308
Lana 40.2 309
310