Skip to Content

Wiki source code of 7. Events Setup

Last modified by Iaroslav Platonov on 2026/06/09 11:03
Hide last authors
Iaroslav Platonov 65.1 1 {{html clean="false"}}
2 <style>
3 .doc-content h1::before,.doc-content h2::before,
4 .doc-content h3::before,.doc-content h4::before,
5 .doc-content h5::before,.doc-content h6::before { content:none !important; display:none !important; }
6 .doc-content { counter-reset:none !important; }
7 #rn-prog { position:fixed;top:0;left:0;height:3px;width:0;background:#005AB4;z-index:9999;pointer-events:none; }
8 .doc-wrap { position:relative; }
9 .doc-content { margin-right:224px;border-left:1px solid #E8E8E8;border-right:1px solid #E8E8E8;padding:0 32px; }
10 .doc-toc { position:absolute;top:0;right:0;width:200px;font-size:12.5px;line-height:1.55;padding:20px 0 20px 16px; }
11 .doc-toc.is-fixed { position:fixed;width:200px;overflow-y:auto;z-index:10; }
12 .toc-header { display:flex;justify-content:space-between;align-items:center;margin-bottom:10px; }
13 .toc-header strong { font-size:13px;font-weight:700;color:#222; }
14 .toc-toggle { background:none;border:none;cursor:pointer;color:#555;font-size:14px;padding:0 2px;line-height:1; }
15 .toc-toggle:hover { color:#222; }
16 .doc-toc ul { list-style:none;margin:0;padding:0; }
17 .doc-toc li { margin:0; }
18 .doc-toc a { display:block;padding:3px 0;color:#555;text-decoration:none;border-left:2px solid transparent;transition:color .12s; }
19 .doc-toc a:hover { color:#222;text-decoration:underline; }
20 .doc-toc a.toc-on { color:#222;font-weight:700;border-left:2px solid #005AB4;padding-left:5px; }
21 .tl1 > a { font-weight:600;color:#222; }
22 .tl2 > a { padding-left:14px; }
23 .tl3 > a { padding-left:26px;font-size:12px; }
24 .doc-content h2 { font-size:1.15em;font-weight:700;color:#222;margin:36px 0 10px 0;display:flex;align-items:baseline;gap:7px;scroll-margin-top:16px; }
25 .doc-content h3 { font-size:1em;font-weight:700;color:#222;margin:22px 0 8px 0;display:flex;align-items:baseline;gap:6px;scroll-margin-top:16px; }
26 .doc-content h4 { font-size:.93em;font-weight:700;color:#222;margin:14px 0 6px 0;scroll-margin-top:16px; }
27 .doc-content p { font-size:.93em;color:#333;line-height:1.75;margin:0 0 12px 0; }
28 .doc-content ul,.doc-content ol { font-size:.93em;color:#333;line-height:1.75;margin:0 0 12px 0;padding-left:24px; }
29 .doc-content li { margin-bottom:4px; }
30 .doc-content strong { color:#222; }
31 .doc-content code { background:#f5f5f5;border:1px solid #E8E8E8;border-radius:3px;padding:1px 5px;font-family:Menlo,Monaco,Consolas,"Courier New",monospace;font-size:.82em;color:#222;line-height:1; }
32 .anchor-icon { color:#E8E8E8;text-decoration:none;opacity:0;transition:opacity .15s;vertical-align:middle;margin-left:4px;display:inline-flex;align-items:center; }
33 h2:hover .anchor-icon,h3:hover .anchor-icon { opacity:1; }
34 .anchor-icon:hover { color:#005AB4; }
35 .note { border-radius:6px;padding:12px 16px;margin:14px 0;border:1px solid transparent; }
36 .note-info { background:#e1f1f9 !important;border-color:#b3d4ee !important;border-left:4px solid #005AB4 !important; }
37 .note-warning { background:#fff4ec !important;border-color:#f5cba7 !important;border-left:4px solid #DD5600 !important; }
38 .note-tip { background:#e5f3df !important;border-color:#b7dba5 !important;border-left:4px solid #73A839 !important; }
39 .note-hd { font-weight:700;font-size:.85em;display:flex;align-items:center;gap:5px;margin-bottom:5px; }
40 .note-info .note-hd { color:#003d80 !important; }
41 .note-warning .note-hd { color:#a03d00 !important; }
42 .note-tip .note-hd { color:#3d6b1a !important; }
43 .note-body { font-size:.875em;color:#222 !important;line-height:1.65; }
44 .section-index { list-style:disc;padding-left:20px;margin:0 0 20px 0; }
45 .section-index li { margin-bottom:12px; }
46 .section-index li a { color:#005AB4;font-weight:600;font-size:.93em;text-decoration:underline; }
47 .section-index li p { margin:3px 0 0 0;font-size:.875em;color:#333;line-height:1.6; }
48 .parent-topic { font-size:.82em;color:#555;margin:18px 0 24px 0;border-top:1px solid #E8E8E8;padding-top:10px; }
49 .parent-topic a { color:#005AB4; }
50 img.inline-icon { display:inline-block;height:28px;width:auto;vertical-align:middle;border:1px solid #E8E8E8;border-radius:4px;margin:0 3px;box-shadow:0 1px 2px rgba(0,0,0,.08); }
51 img.inline-icon-sm { display:inline-block;height:20px;width:auto;vertical-align:middle;border:1px solid #E8E8E8;border-radius:3px;margin:0 3px;box-shadow:0 1px 2px rgba(0,0,0,.08); }
52 .fig { margin:12px auto 24px auto;width:fit-content;max-width:100%; }
53 .fig img { border-radius:4px 4px 0 0;border:1px solid #E8E8E8;display:block;cursor:zoom-in;max-width:100%;box-shadow:0 1px 4px rgba(0,0,0,.10);transition:box-shadow .15s; }
54 .fig img:hover { box-shadow:0 3px 12px rgba(0,90,180,.18); }
55 .fig-cap { font-size:.78em;color:#555;margin:0;padding:5px 8px;background:#f5f5f5;border:1px solid #E8E8E8;border-top:none;border-radius:0 0 4px 4px;display:block;width:100%;box-sizing:border-box; }
56 #rn-lb { display:none;position:fixed;inset:0;z-index:9998;background:rgba(0,0,0,.8);cursor:zoom-out;align-items:center;justify-content:center; }
57 #rn-lb.open { display:flex; }
58 #rn-lb-wrap { position:relative;cursor:default;max-width:92vw;max-height:90vh; }
59 #rn-lb-wrap img { max-width:100%;max-height:90vh;border-radius:5px;display:block; }
60 #rn-lb-x { position:absolute;top:-13px;right:-13px;background:#005AB4;color:#fff;width:26px;height:26px;border-radius:50%;border:none;cursor:pointer;font-size:15px;display:flex;align-items:center;justify-content:center; }
61 #rn-lb-cap { position:fixed;bottom:18px;left:50%;transform:translateX(-50%);color:#ddd;font-size:.78em;background:rgba(0,0,0,.55);padding:3px 12px;border-radius:14px;pointer-events:none; }
62 #rn-top { position:fixed;bottom:60px;right:60px;z-index:9997;width:36px;height:36px;border-radius:50%;background:#005AB4;color:#fff;border:none;cursor:pointer;display:flex;align-items:center;justify-content:center;opacity:0;transform:translateY(8px);transition:opacity .22s,transform .22s;pointer-events:none;box-shadow:0 2px 8px rgba(0,90,180,.3); }
63 #rn-top.on { opacity:1;transform:translateY(0);pointer-events:auto; }
64 #rn-top:hover { background:#0066cc; }
65 .rn-toast { position:fixed;bottom:66px;right:24px;z-index:9999;background:#222;color:#fff;font-size:.74em;padding:4px 11px;border-radius:4px;pointer-events:none;opacity:0;transition:opacity .18s; }
66 .rn-toast.on { opacity:1; }
67 .rn-table { width:100%;border-collapse:collapse;margin:8px 0 18px 0;font-size:.82em; }
68 .rn-table th { background:#f5f5f5;text-align:left;padding:7px 10px;font-size:.78em;font-weight:700;text-transform:uppercase;letter-spacing:.04em;color:#555;border-bottom:2px solid #E8E8E8; }
69 .rn-table td { padding:7px 10px;border-bottom:1px solid #E8E8E8;color:#333;vertical-align:top;line-height:1.6; }
70 .rn-table tr:last-child td { border-bottom:none; }
71 .rn-table tr:hover td { background:#f5f5f5; }
72 .rn-table code { background:#f0f0f0;border:1px solid #ddd;border-radius:3px;padding:1px 4px;font-size:.88em;font-family:Menlo,Monaco,Consolas,monospace; }
73 .tbl-wrap { overflow-x:auto;margin:8px 0 18px 0; }
74 .var-badge { display:inline-block;font-family:Menlo,Monaco,Consolas,monospace;font-size:.8em;background:#deeaf7;color:#005AB4;border:1px solid #b3d4ee;border-radius:3px;padding:1px 6px; }
75 </style>
Lana 2.2 76
Iaroslav Platonov 65.1 77 <div id="rn-prog"></div>
78 <div id="rn-lb">
79 <div id="rn-lb-wrap">
80 <button id="rn-lb-x" onclick="closeLightbox()">&#10005;</button>
81 <img id="rn-lb-img" src="" alt=""/>
82 </div>
83 <div id="rn-lb-cap"></div>
84 </div>
85 <button id="rn-top" onclick="window.scrollTo({top:0,behavior:'smooth'})" title="Back to top">
86 <svg width="14" height="14" viewBox="0 0 16 16" fill="currentColor"><path d="M8 4l5 5H3z"/></svg>
87 </button>
88 <div class="rn-toast" id="rn-toast">Link copied &#10003;</div>
Lana 63.1 89
Iaroslav Platonov 65.1 90 <div class="doc-wrap">
91 <div class="doc-content">
Lana 2.2 92
Iaroslav Platonov 65.1 93 <ul class="section-index">
94 <li><a href="#s-intro">1. Introduction</a>
95 <p>Overview of the Events tool — purpose, capabilities, and key concepts.</p></li>
96 <li><a href="#s-events">2. CENTO Events</a>
97 <p>Event editor, creating and editing events via UI or Excel, and flashing on diagrams.</p></li>
98 <li><a href="#s-notifications">3. Notifications Settings</a>
99 <p>Configuring email notifications, filter logic, and notification delivery examples.</p></li>
100 <li><a href="#s-sound-editor">4. Sound Editor</a>
101 <p>Uploading and managing .mp3 sound files for event alerts.</p></li>
102 <li><a href="#s-examples">5. Examples of Event Setup</a>
103 <p>Practical examples: events on tag value change and device status change.</p></li>
104 <li><a href="#s-annex">Appendix: Formula Reference</a>
105 <p>Variables and operators available in event condition formulas.</p></li>
106 </ul>
Lana 2.2 107
108
Iaroslav Platonov 65.1 109 <h2 id="s-intro">1. Introduction<a class="anchor-icon" href="javascript:void(0)" onclick="copyAnchor('s-intro')" title="Copy link"><svg width="12" height="12" viewBox="0 0 16 16" fill="currentColor"><path d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"/></svg></a></h2>
Lana 2.2 110
Iaroslav Platonov 65.1 111 <p>CENTO is a multifunctional software platform for data collection, processing, and display. This manual describes the <strong>Events</strong> user tool in CENTO.</p>
Lana 2.3 112
Iaroslav Platonov 65.1 113 <p>It is assumed that the user is already familiar with the basic elements of the CENTO interface after reading the User Manual.</p>
Lana 4.2 114
Iaroslav Platonov 65.1 115 <p>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 personnel react in a timely manner to changes in the technological process and system operation. To achieve these goals, CENTO provides user notification and acknowledgement features alongside event logging.</p>
Lana 4.2 116
Iaroslav Platonov 65.1 117 <h2 id="s-events">2. CENTO Events<a class="anchor-icon" href="javascript:void(0)" onclick="copyAnchor('s-events')" title="Copy link"><svg width="12" height="12" viewBox="0 0 16 16" fill="currentColor"><path d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"/></svg></a></h2>
Lana 4.2 118
Iaroslav Platonov 65.1 119 <h3 id="s-event-editor">2.1. Event editor<a class="anchor-icon" href="javascript:void(0)" onclick="copyAnchor('s-event-editor')" title="Copy link"><svg width="12" height="12" viewBox="0 0 16 16" fill="currentColor"><path d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"/></svg></a></h3>
Lana 4.2 120
Iaroslav Platonov 65.1 121 <p>To open the <strong>Event editor</strong>, select from the main menu: <strong>Settings &rarr; Events &rarr; Event editor</strong>.</p>
Lana 4.2 122
Iaroslav Platonov 65.1 123 <div class="fig">
124 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.28.44.png" alt="Event editor in the CENTO menu" style="max-width:100%;" onclick="openLightbox(this)"/>
125 <p class="fig-cap">Figure 2.1. Event editor in the CENTO menu</p>
126 </div>
Lana 4.2 127
Iaroslav Platonov 65.1 128 <p>Figure 2.2 shows the <strong>Event editor</strong> interface.</p>
Lana 6.2 129
Iaroslav Platonov 65.1 130 <div class="fig">
131 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.29.15.png" alt="Event editor" style="max-width:100%;" onclick="openLightbox(this)"/>
132 <p class="fig-cap">Figure 2.2. Event editor</p>
133 </div>
Lana 6.2 134
Iaroslav Platonov 65.1 135 <p>The <strong>Event editor</strong> page provides the following capabilities:</p>
136 <ol>
137 <li>Add a new event to the system <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.29.51.png" alt="Add event"/></li>
138 <li>Activate <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.30.26.png" alt="Activate"/> or disable <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.30.54.png" alt="Disable"/> selected events</li>
139 <li>Edit <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.32.53.png" alt="Edit"/>, copy <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.33.40.png" alt="Copy"/>, and delete <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.34.05.png" alt="Delete"/> in the <strong>Actions</strong> column</li>
140 <li>Delete any number of events at once <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.35.15.png" alt="Delete selected"/></li>
141 <li>Edit the number of records displayed</li>
142 <li>Search for events by filtering <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.36.03.png" alt="Filter"/> (the filter is located to the right of the table headings)</li>
143 <li>Edit event configuration <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.36.56.png" alt="Edit configuration"/></li>
144 <li>Adjust setpoint text <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.37.32.png" alt="Adjust setpoint text"/></li>
145 </ol>
Lana 6.2 146
147
Iaroslav Platonov 65.1 148 <h3 id="s-event-create">2.2. Creating and editing an event in the web interface<a class="anchor-icon" href="javascript:void(0)" onclick="copyAnchor('s-event-create')" title="Copy link"><svg width="12" height="12" viewBox="0 0 16 16" fill="currentColor"><path d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"/></svg></a></h3>
Lana 13.2 149
Iaroslav Platonov 65.1 150 <p>An event can be created manually or automatically. Events are automatically created when the setpoint parameter is enabled. For a detailed description, refer to the Setup Manual.</p>
Lana 14.2 151
Iaroslav Platonov 65.1 152 <p>The text of setpoints can be edited in the <strong>Event editor</strong> interface. Click the button <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.38.47.png" alt="Adjust setpoint text"/>. The <strong>Setpoint editing</strong> window opens (Figure 2.3), where the wording of setpoints for Triggering and/or Return can be modified, including Upper/Lower warning limit, Upper/Lower alarm limit, and Upper/Lower physical limit.</p>
Lana 14.2 153
Iaroslav Platonov 65.1 154 <p>One or more variables can be specified in the setpoint triggering message:</p>
155 <ul>
156 <li><code>{{.tag_name}}</code> &mdash; tag name</li>
157 <li><code>{{.tag_code}}</code> &mdash; tag code</li>
158 <li><code>{{.tag_id}}</code> &mdash; tag ID</li>
159 <li><code>{{.tag_code_or_id}}</code> &mdash; tag code, or ID if the code is empty</li>
160 <li><code>{{.tag_limit}}</code> &mdash; setpoint value</li>
161 <li><code>{{.tag_unit}}</code> &mdash; tag units</li>
162 <li><code>{{.device_name}}</code> &mdash; name of the device the tag is linked to</li>
163 </ul>
Lana 16.2 164
165
Iaroslav Platonov 65.1 166 <div class="note note-warning"><div class="note-hd"><span>&#9888;</span> Important</div><div class="note-body">If curly braces or dots are missing when writing these parameters, a validation error will occur. If a non-existent parameter is entered (e.g. <code>{{.tag_name_2}}</code>), the Operating Journal will receive an event of the form: <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.39.52.png" alt="error icon"/> <strong>&lt;no value&gt; &gt; 10</strong>.</div></div>
Lana 16.2 167
Iaroslav Platonov 65.1 168 <div class="fig">
169 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.40.35.png" alt="Setpoint editing page" style="max-width:100%;" onclick="openLightbox(this)"/>
170 <p class="fig-cap">Figure 2.3. Setpoint editing page</p>
171 </div>
Lana 16.2 172
Iaroslav Platonov 65.1 173 <p>To create a new event, click the button <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.41.09.png" alt="Add new event"/>. Only an authorized user with appropriate rights can create and edit events.</p>
Lana 16.2 174
Iaroslav Platonov 65.1 175 <p>Figure 2.4 shows the event creation page.</p>
Lana 16.2 176
Iaroslav Platonov 65.1 177 <div class="fig">
178 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.41.54.png" alt="Event editor: creation page" style="max-width:100%;" onclick="openLightbox(this)"/>
179 <p class="fig-cap">Figure 2.4. Event editor: creation page</p>
180 </div>
Lana 18.2 181
Iaroslav Platonov 65.1 182 <p>The <strong>Event editor</strong> window contains the following fields:</p>
183 <ul>
184 <li><strong>Identifier</strong> &mdash; the sequence number of the event (filled in automatically); can be changed if needed.</li>
185 <li><strong>Name</strong> &mdash; the name of the event.</li>
186 <li><strong>Object</strong> &mdash; an object from the CENTO Information Model (IM) to which the event refers. The IM object is selected from a drop-down tree.</li>
187 <li><strong>Device</strong> &mdash; the device to which the event refers, selected from the drop-down device tree.</li>
188 <li><strong>Event type</strong> &mdash; switches the event type between &ldquo;Single&rdquo; and &ldquo;With return&rdquo; <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.42.53.png" alt="Event type switch"/>.</li>
189 <li><strong>Tags</strong> &mdash; the ID of the telemetering tag to which the event belongs.</li>
190 <li><strong>Message</strong> &mdash; the message text output when the event is triggered.</li>
191 <li><strong>Formula</strong> &mdash; the condition for the event to be triggered. Click <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.43.51.png" alt="Formula list"/> to open the list of available formulas (see Appendix).</li>
192 <li><strong>Dead time (ms)</strong> &mdash; delay time in milliseconds before the event is generated. Helps prevent false events caused by intermittent communication failures.</li>
193 <li><strong>Type</strong> &mdash; a drop-down list for the importance or category of the event.</li>
194 <li><strong>Acknowledgement</strong> &mdash; a switch to enable user acknowledgement of event notification.</li>
195 <li><strong>Sound</strong> &mdash; selects a sound for notification from those loaded in the Sound Editor (see section 4). The selected sound can be previewed using the button <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.44.31.png" alt="Play sound"/> to the right of the &ldquo;Sound&rdquo; field.</li>
196 <li><strong>Before acknowledgement</strong> &mdash; a switch to play the selected sound until the event is acknowledged.</li>
197 <li><strong>Sound repeats</strong> &mdash; number of repetitions of sound playback when the event occurs.</li>
198 </ul>
Lana 19.2 199
200
Iaroslav Platonov 65.1 201 <div class="note note-warning"><div class="note-hd"><span>&#9888;</span> Important</div><div class="note-body"><strong>Modern browsers block sound playback by default.</strong> To allow CENTO to play sounds in Chrome:<ol style='margin:6px 0 0 0;padding-left:18px;'><li>Left-click to the left of the address bar (Figure 2.5) and select <strong>Site settings</strong>.</li><li>Go to <strong>Privacy and security &rarr; Site settings &rarr; Additional permissions &rarr; Sound</strong> and select <strong>Allow</strong> (Figure 2.6).</li><li>Refresh the CENTO page.</li></ol></div></div>
Lana 19.2 202
Iaroslav Platonov 65.1 203 <div class="fig">
204 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.45.18.png" alt="Site settings — opening permissions" style="max-width:100%;" onclick="openLightbox(this)"/>
205 <p class="fig-cap">Figure 2.5. Site settings — opening permissions</p>
206 </div>
Lana 19.2 207
Iaroslav Platonov 65.1 208 <div class="fig">
209 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.48.19.png" alt="Allowing sound playback for the site" style="max-width:100%;" onclick="openLightbox(this)"/>
210 <p class="fig-cap">Figure 2.6. Allowing sound playback for the site</p>
211 </div>
Lana 19.2 212
Iaroslav Platonov 65.1 213 <p>After filling in all required fields, click <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.48.55.png" alt="Save"/> and update the configuration (Figure 2.7).</p>
Lana 21.2 214
Iaroslav Platonov 65.1 215 <div class="fig">
216 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.49.27.png" alt="Update configuration" style="max-width:100%;" onclick="openLightbox(this)"/>
217 <p class="fig-cap">Figure 2.7. Update configuration</p>
218 </div>
Lana 21.2 219
Iaroslav Platonov 65.1 220 <div class="note note-info"><div class="note-hd"><span>&#8505;</span> Note</div><div class="note-body">There are two event types in CENTO: <strong>Single</strong> and <strong>With return</strong>. Events with return are used for important persistent states (e.g. &ldquo;Ground fault in isolated-neutral network&rdquo;). The <em>opening event</em> reports the state start; the <em>closing event</em> reports its end. <strong>Events with return must always be paired</strong> &mdash; the second event always closes the first. Active (unclosed) events are shown in a separate tab of the operational log.</div></div>
Lana 21.2 221
Iaroslav Platonov 65.1 222 <p>When <strong>With return</strong> is selected as the event type, the Event editor displays additional fields with the heading <strong>With return</strong> (Figure 2.8). These fields are identical to those for the Single event type.</p>
Lana 21.2 223
Iaroslav Platonov 65.1 224 <div class="fig">
225 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.49.59.png" alt="Event editor with &ldquo;With return&rdquo; type" style="max-width:100%;" onclick="openLightbox(this)"/>
226 <p class="fig-cap">Figure 2.8. Event editor with &ldquo;With return&rdquo; type</p>
227 </div>
Lana 21.2 228
Iaroslav Platonov 65.1 229 <h3 id="s-event-excel">2.3. Creating and editing events using Excel<a class="anchor-icon" href="javascript:void(0)" onclick="copyAnchor('s-event-excel')" title="Copy link"><svg width="12" height="12" viewBox="0 0 16 16" fill="currentColor"><path d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"/></svg></a></h3>
Lana 21.2 230
Iaroslav Platonov 65.1 231 <p>Events can be configured using Excel files. This function is available at <strong>Settings &rarr; Configuration Files</strong> (Figure 2.9).</p>
Lana 21.2 232
Iaroslav Platonov 65.1 233 <div class="fig">
234 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.51.04.png" alt="Import/Export configuration file page" style="max-width:100%;" onclick="openLightbox(this)"/>
235 <p class="fig-cap">Figure 2.9. Import/Export configuration file page</p>
236 </div>
Lana 21.2 237
Iaroslav Platonov 65.1 238 <p>To configure events, download the <code>events.xlsx</code> file by clicking <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.51.37.png" alt="Download"/>, then fill in the appropriate cells in a new row in the <strong>Events</strong> tab (Figure 2.10).</p>
Lana 21.2 239
Iaroslav Platonov 65.1 240 <div class="fig">
241 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.52.08.png" alt="Events tab in events.xlsx" style="max-width:100%;" onclick="openLightbox(this)"/>
242 <p class="fig-cap">Figure 2.10. Events tab in events.xlsx</p>
243 </div>
Lana 22.2 244
Iaroslav Platonov 65.1 245 <p>Fill in the following columns to create an event:</p>
246 <ul>
247 <li><strong>Event ID</strong> &mdash; unique event number. Must not duplicate existing IDs in the system.</li>
248 <li><strong>Name</strong> &mdash; event name.</li>
249 <li><strong>Event type</strong> &mdash; <code>one_position</code> or <code>two_position</code>.</li>
250 <li><strong>Event status</strong> &mdash; <code>1</code> = enabled, <code>0</code> = disabled.</li>
251 <li><strong>Device ID</strong> &mdash; device identifier the event refers to.</li>
252 <li><strong>Device</strong> &mdash; auto-generated when downloading; shows the device path for debugging. Do not fill in manually.</li>
253 <li><strong>Object ID</strong> &mdash; IM object identifier the event refers to.</li>
254 <li><strong>Object</strong> &mdash; auto-generated when downloading; shows the object path for debugging. Do not fill in manually.</li>
255 <li><strong>Tags</strong> &mdash; tag (parameter) ID the event refers to.</li>
256 <li><strong>Formula</strong> &mdash; condition for triggering the event (see Appendix).</li>
257 <li><strong>Dead time, ms</strong> &mdash; delay time in milliseconds before event generation.</li>
258 <li><strong>Event type code</strong> &mdash; code from the <strong>Event type</strong> directory in the separate tab of this file.</li>
259 <li><strong>Event type name</strong> &mdash; filled in automatically when uploading/downloading.</li>
260 <li><strong>Message</strong> &mdash; message text displayed in logs when the event is triggered.</li>
261 <li><strong>Acknowledgement</strong> &mdash; <code>True</code> = enabled, <code>False</code> = disabled.</li>
262 <li><strong>Sound ID</strong> &mdash; ID of a sound file loaded through the Sound Editor.</li>
263 <li><strong>Sound name</strong> &mdash; filled in automatically when uploading/downloading.</li>
264 <li><strong>Repeat count</strong> &mdash; number of sound repetitions when the event is triggered.</li>
265 <li><strong>Infinity repeat</strong> &mdash; <code>True</code> = repeat until acknowledged, <code>False</code> = use repeat count.</li>
266 </ul>
Lana 22.2 267
268
Iaroslav Platonov 65.1 269 <p>After filling in all required fields, upload the file using the <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.53.38.png" alt="Upload"/> button on the Import/Export configuration file page (Figure 2.9). In the dialog (Figure 2.11), select the filled-in <code>events.xlsx</code>. The system will automatically validate the file (Figure 2.12).</p>
Lana 22.2 270
Iaroslav Platonov 65.1 271 <div class="fig">
272 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.54.07.png" alt="Upload configuration file window" style="max-width:100%;" onclick="openLightbox(this)"/>
273 <p class="fig-cap">Figure 2.11. Upload configuration file window</p>
274 </div>
Lana 22.2 275
Iaroslav Platonov 65.1 276 <div class="fig">
277 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.54.41.png" alt="Validating the configuration file" style="max-width:100%;" onclick="openLightbox(this)"/>
278 <p class="fig-cap">Figure 2.12. Validating the configuration file</p>
279 </div>
Lana 22.2 280
Iaroslav Platonov 65.1 281 <p>If errors are detected, they will be displayed in the upload window. After all errors are corrected, the <strong>Write configuration</strong> button becomes available. After uploading, refresh the configuration to apply changes (see Figure 2.7).</p>
Lana 22.2 282
Iaroslav Platonov 65.1 283 <div class="note note-info"><div class="note-hd"><span>&#8505;</span> Note</div><div class="note-body">For <strong>partial editing</strong>, CENTO also allows downloading and uploading only a filtered subset of events. In the Event editor, filter for the events of interest using <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.55.29.png" alt="Filter"/>, then click <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.55.55.png" alt="Config"/> and select <strong>Download</strong>. The downloaded <code>events.xlsx</code> will contain only the filtered events. To upload changes, click the same button and select <strong>Upload</strong>. Events not included in the download will remain unchanged.</div></div>
Lana 24.2 284
Iaroslav Platonov 65.1 285 <div class="note note-warning"><div class="note-hd"><span>&#9888;</span> Important</div><div class="note-body">Partial upload/download is <strong>not compatible</strong> with Excel files downloaded using an earlier version of the service. Attempting to upload an old file will result in a &ldquo;Version incompatibility&rdquo; error. When adding a new event, the new Event ID must not match any existing ID in the system.</div></div>
Lana 24.2 286
Iaroslav Platonov 65.1 287 <h3 id="s-event-flash">2.4. Flashing on the diagram<a class="anchor-icon" href="javascript:void(0)" onclick="copyAnchor('s-event-flash')" title="Copy link"><svg width="12" height="12" viewBox="0 0 16 16" fill="currentColor"><path d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"/></svg></a></h3>
Lana 24.2 288
Iaroslav Platonov 65.1 289 <p>An object on a mimic diagram can be configured to flash (blink) when an event is active. There are two methods:</p>
Lana 24.3 290
Iaroslav Platonov 65.1 291 <h4>Method 1: Flashing by tag</h4>
Lana 24.2 292
Iaroslav Platonov 65.1 293 <p>Use this method if the information model is not configured or not planned. Steps:</p>
294 <ol>
295 <li>
296 <strong>Set up an event</strong> with the triggering formula, for example, connection loss
297 (<code>ti40027171 != 1</code>) or restoration (<code>ti40027171 == 1</code>) — any tag
298 registered in the system can be used (Figure 2.13).
299 </li>
300 <li>
301 <strong>Create a calculated tag</strong> with the formula <code>[devstatusNN]</code> where
302 NN is the device ID (Figure 2.14). The tag to be used for the designated purpose may get
303 its value from a real device or may be based on other tags.
304 </li>
305 <li>
306 <strong>Set up an object on the diagram</strong>, referencing the calculated tag from step 2
307 in its rules (Figure 2.15).
308 </li>
309 <li>
310 After saving the diagram and updating the configuration, if the status of the NN device
311 changes, the system will start flashing the bound diagram object until it is acknowledged.
312 </li>
313 </ol>
Lana 24.2 314
315
Iaroslav Platonov 65.1 316 <div class="fig">
317 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.58.43.png" alt="Event configured for tag-based flashing" style="max-width:100%;" onclick="openLightbox(this)"/>
318 <p class="fig-cap">Figure 2.13. Event configured for tag-based flashing</p>
319 </div>
Lana 24.3 320
Iaroslav Platonov 65.1 321 <div class="fig">
322 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.59.17.png" alt="Calculated tag for diagram flashing" style="max-width:100%;" onclick="openLightbox(this)"/>
323 <p class="fig-cap">Figure 2.14. Calculated tag for diagram flashing</p>
324 </div>
Lana 26.2 325
Iaroslav Platonov 65.1 326 <div class="fig">
327 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2021.59.53.png" alt="Diagram object rules referencing the calculated tag" style="max-width:100%;" onclick="openLightbox(this)"/>
328 <p class="fig-cap">Figure 2.15. Diagram object rules referencing the calculated tag</p>
329 </div>
Lana 26.2 330
Iaroslav Platonov 65.1 331 <h4>Method 2: Flashing by information model object</h4>
Lana 26.2 332
Iaroslav Platonov 65.1 333 <p>For this method, the information model must be configured and the required IM object must be selected in the event's <strong>Object</strong> field. The diagram object must be <em>active</em> (see the Diagrams Development Manual) and bound to the same IM object. Steps:</p>
334 <ol>
335 <li><strong>Create an event</strong> with the IM object selected in the <strong>Object</strong> field (Figure 2.16).</li>
336 <li><strong>Create an active diagram object</strong> bound to the same IM object (Figure 2.17).</li>
337 </ol>
Lana 26.2 338
Lana 28.2 339
Iaroslav Platonov 65.1 340 <div class="fig">
341 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2022.01.01.png" alt="Creating an event with an information model object" style="max-width:100%;" onclick="openLightbox(this)"/>
342 <p class="fig-cap">Figure 2.16. Creating an event with an information model object</p>
343 </div>
Lana 28.2 344
Iaroslav Platonov 65.1 345 <div class="fig">
346 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2022.02.05.png" alt="Diagram object bound to the information model" style="max-width:100%;" onclick="openLightbox(this)"/>
347 <p class="fig-cap">Figure 2.17. Diagram object bound to the information model</p>
348 </div>
Lana 28.2 349
Iaroslav Platonov 65.1 350 <h2 id="s-notifications">3. Notifications Settings<a class="anchor-icon" href="javascript:void(0)" onclick="copyAnchor('s-notifications')" title="Copy link"><svg width="12" height="12" viewBox="0 0 16 16" fill="currentColor"><path d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"/></svg></a></h2>
Lana 28.2 351
Iaroslav Platonov 65.1 352 <h3 id="s-notif-create">3.1. Creating and editing notifications<a class="anchor-icon" href="javascript:void(0)" onclick="copyAnchor('s-notif-create')" title="Copy link"><svg width="12" height="12" viewBox="0 0 16 16" fill="currentColor"><path d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"/></svg></a></h3>
Lana 28.2 353
Iaroslav Platonov 65.1 354 <p>CENTO can notify users about triggered events via email. To configure notifications, go to <strong>Settings &rarr; Events &rarr; Notifications</strong>. Mail server configuration is described in the Setup Manual, Mail Servers.</p>
Lana 28.2 355
Iaroslav Platonov 65.1 356 <div class="fig">
357 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2022.03.45.png" alt="Notifications interface" style="max-width:100%;" onclick="openLightbox(this)"/>
358 <p class="fig-cap">Figure 3.1. Notifications interface</p>
359 </div>
Lana 29.2 360
Iaroslav Platonov 65.1 361 <p>The notification table contains the following columns:</p>
362 <ol>
363 <li><strong>Name</strong> &mdash; notification name.</li>
364 <li><strong>Emails</strong> &mdash; email addresses configured to receive notifications.</li>
365 <li><strong>Dispatch period</strong> &mdash; the time of day allowed for sending notifications.</li>
366 <li><strong>Iteration period</strong> &mdash; minimum time interval between notifications (notifications cannot be sent more frequently than this period).</li>
367 <li><strong>Operation threshold</strong> &mdash; number of event triggers required before a notification is sent.</li>
368 <li><strong>State</strong> &mdash; on/off.</li>
369 <li><strong>Actions</strong> &mdash; edit <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2022.05.05.png" alt="Edit"/>, copy <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2022.05.32.png" alt="Copy"/>, delete <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2022.05.55.png" alt="Delete"/>.</li>
370 </ol>
Lana 29.2 371
372
Iaroslav Platonov 65.1 373 <p>To create a new notification, click <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2022.06.27.png" alt="Create notification"/>. Only an authorized user with appropriate permissions can create and edit notifications.</p>
Lana 31.2 374
Iaroslav Platonov 65.1 375 <div class="fig">
376 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2022.07.01.png" alt="Notifications: creation page" style="max-width:100%;" onclick="openLightbox(this)"/>
377 <p class="fig-cap">Figure 3.2. Notifications: creation page</p>
378 </div>
Lana 31.2 379
Iaroslav Platonov 65.1 380 <p>Fill in the following fields in the <strong>Notification settings</strong> tab:</p>
381 <ul>
382 <li><strong>Name</strong> &mdash; notification name.</li>
383 <li><strong>State</strong> &mdash; enables or disables the notification.</li>
384 <li><strong>Operation threshold</strong> &mdash; number of event triggers required before a notification is sent.</li>
385 <li><strong>Dispatch period</strong> &mdash; the time of day allowed for sending notifications.</li>
386 <li><strong>Iteration period</strong> &mdash; minimum time interval between notifications.</li>
387 <li><strong>Delay (s)</strong> &mdash; accumulation window starting from the first event before the notification is sent.</li>
388 <li><strong>E-mail server</strong> &mdash; mail server for sending notifications (configured in Settings &rarr; Email servers).</li>
389 <li><strong>Recipients</strong> &mdash; email addresses of notification recipients.</li>
390 </ul>
Lana 31.2 391
392
Iaroslav Platonov 65.1 393 <p>In the <strong>Event selection</strong> tab (Figure 3.3), tick the events required for notification in the left column and click <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2022.08.29.png" alt="Move right"/> to move them to the right column. To remove events, mark them in the right column and click <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2022.08.55.png" alt="Move left"/>.</p>
Lana 31.2 394
Iaroslav Platonov 65.1 395 <div class="fig">
396 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2022.07.55.png" alt="Event selection tab" style="max-width:100%;" onclick="openLightbox(this)"/>
397 <p class="fig-cap">Figure 3.3. Event selection tab</p>
398 </div>
Lana 31.2 399
Iaroslav Platonov 65.1 400 <p>After filling in all fields, click <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2022.09.48.png" alt="Save"/> and update the configuration.</p>
Lana 31.2 401
Iaroslav Platonov 65.1 402 <h3 id="s-notif-logic">3.2. Notification operation<a class="anchor-icon" href="javascript:void(0)" onclick="copyAnchor('s-notif-logic')" title="Copy link"><svg width="12" height="12" viewBox="0 0 16 16" fill="currentColor"><path d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"/></svg></a></h3>
Lana 31.2 403
Iaroslav Platonov 65.1 404 <p>There are three filter types that control when notifications are sent:</p>
405 <ol>
406 <li><strong>Operation threshold</strong></li>
407 <li><strong>Iteration period</strong></li>
408 <li><strong>Dispatch period</strong></li>
409 </ol>
Lana 31.2 410
411
Iaroslav Platonov 65.1 412 <p>When configured without any restrictions, a notification is sent whenever any of the configured events is triggered.</p>
Lana 7.2 413
Iaroslav Platonov 65.1 414 <h4>Operation threshold</h4>
Lana 32.2 415
Iaroslav Platonov 65.1 416 <p>A notification is triggered when the total number of triggered events in the notification reaches the configured threshold. If the threshold is 0, the notification is generated immediately after any event triggers, provided the other filters allow it.</p>
Lana 32.2 417
Iaroslav Platonov 65.1 418 <h4>Iteration period</h4>
Lana 32.2 419
Iaroslav Platonov 65.1 420 <p>The iteration period starts from the time the last notification was triggered. It is set in days and hours. If set to 0 days 0 hours, notifications are generated and sent immediately when the other filter conditions are met.</p>
Lana 32.2 421
Iaroslav Platonov 65.1 422 <h4>Dispatch period</h4>
Lana 32.2 423
Iaroslav Platonov 65.1 424 <p>If set to 0:00&ndash;24:00, notifications can be sent at any time of day. If set to a specific time (e.g. 8:00), notifications are batched and sent once at that time. The dispatch period can only be set within a single calendar day.</p>
Lana 32.2 425
Iaroslav Platonov 65.1 426 <div class="fig">
427 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2022.11.07.png" alt="Logic of filter settings when generating notifications" style="max-width:100%;" onclick="openLightbox(this)"/>
428 <p class="fig-cap">Figure 3.4. Logic of filter settings when generating notifications</p>
429 </div>
Lana 32.2 430
Iaroslav Platonov 65.1 431 <h4>Changing notification settings</h4>
Lana 32.2 432
Iaroslav Platonov 65.1 433 <p>When notification settings are changed at any time:</p>
434 <ul>
435 <li>The <strong>operation threshold counter</strong> is preserved but the notification will not trigger until the next event after the threshold is reached.</li>
436 <li>The <strong>iteration period</strong> is reset.</li>
437 </ul>
Lana 32.2 438
439
Iaroslav Platonov 65.1 440 <p>Examples:</p>
441 <ol>
442 <li>Threshold = 5, 3 events triggered. User increases threshold to 10 &rarr; notification fires after 7 more events (total 10).</li>
443 <li>Threshold = 10, 7 events triggered. User reduces threshold to 5 &rarr; notification fires after the next event (total 8 triggered events).</li>
444 <li>Iteration period = 10 hours, last notification sent 2 hours ago. Settings changed &rarr; iteration period resets and notification fires on the next event trigger.</li>
445 <li>Threshold = 10, notification has 3 events, event #1 triggered twice. User deletes event #1 from notification. When total reaches 10, notification is sent without event #1&rsquo;s messages.</li>
446 </ol>
Lana 32.2 447
448
Iaroslav Platonov 65.1 449 <div class="fig">
450 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2022.12.07.png" alt="Notification with operation threshold" style="max-width:100%;" onclick="openLightbox(this)"/>
451 <p class="fig-cap">Figure 3.5. Notification with operation threshold</p>
452 </div>
Lana 32.2 453
Iaroslav Platonov 65.1 454 <div class="fig">
455 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2022.12.39.png" alt="Notification with dispatch period" style="max-width:100%;" onclick="openLightbox(this)"/>
456 <p class="fig-cap">Figure 3.6. Notification with dispatch period</p>
457 </div>
Lana 32.2 458
Iaroslav Platonov 65.1 459 <div class="fig">
460 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2022.13.08.png" alt="Notification with all restrictions active" style="max-width:100%;" onclick="openLightbox(this)"/>
461 <p class="fig-cap">Figure 3.7. Notification with all restrictions active</p>
462 </div>
Lana 35.2 463
Iaroslav Platonov 65.1 464 <h2 id="s-sound-editor">4. Sound Editor<a class="anchor-icon" href="javascript:void(0)" onclick="copyAnchor('s-sound-editor')" title="Copy link"><svg width="12" height="12" viewBox="0 0 16 16" fill="currentColor"><path d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"/></svg></a></h2>
Lana 35.2 465
Iaroslav Platonov 65.1 466 <p>Sound notifications are managed at <strong>Settings &rarr; Events &rarr; Sound editor</strong>.</p>
Lana 35.2 467
Iaroslav Platonov 65.1 468 <div class="fig">
469 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2022.13.46.png" alt="Sound Editor page" style="max-width:100%;" onclick="openLightbox(this)"/>
470 <p class="fig-cap">Figure 4.1. Sound Editor page</p>
471 </div>
Lana 35.2 472
Iaroslav Platonov 65.1 473 <p>The Sound Editor shows a table with the following columns: <strong>ID</strong>, <strong>Name</strong>, <strong>File name</strong>, <strong>Uploaded</strong> (date), and <strong>Actions</strong> (edit, play, delete).</p>
Lana 35.2 474
Iaroslav Platonov 65.1 475 <div class="note note-info"><div class="note-hd"><span>&#8505;</span> Note</div><div class="note-body">The Sound Editor only supports <strong>.mp3</strong> files.</div></div>
Lana 35.2 476
Iaroslav Platonov 65.1 477 <p>To add a new sound, click <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2022.14.32.png" alt="Add new sound"/>. In the pop-up (Figure 4.2), specify the name, select or drag-and-drop the .mp3 file, and click <img class="inline-icon" src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2022.15.48.png" alt="Upload"/>.</p>
Lana 35.2 478
Iaroslav Platonov 65.1 479 <div class="fig">
480 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2022.15.12.png" alt="New sound upload window" style="max-width:100%;" onclick="openLightbox(this)"/>
481 <p class="fig-cap">Figure 4.2. New sound upload window</p>
482 </div>
Lana 36.2 483
Iaroslav Platonov 65.1 484 <div class="note note-warning"><div class="note-hd"><span>&#9888;</span> Important</div><div class="note-body">If CENTO is open in multiple browser tabs (e.g. Sound Editor in one tab, a mimic diagram in another), the old sound will continue to play on the diagram tab after changing the sound in the editor. The new sound will play only after the user interacts with the diagram tab (e.g. clicking the mouse).</div></div>
Lana 36.2 485
Iaroslav Platonov 65.1 486 <h2 id="s-examples">5. Examples of Event Setup<a class="anchor-icon" href="javascript:void(0)" onclick="copyAnchor('s-examples')" title="Copy link"><svg width="12" height="12" viewBox="0 0 16 16" fill="currentColor"><path d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"/></svg></a></h2>
Lana 36.2 487
Iaroslav Platonov 65.1 488 <p>The following examples use the web interface on the event creation page described in section 2.2.</p>
Lana 36.3 489
Iaroslav Platonov 65.1 490 <h4>Example 1: Event on tag value change</h4>
Lana 36.3 491
Iaroslav Platonov 65.1 492 <div class="fig">
493 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2022.17.31.png" alt="Event setup on tag value change" style="max-width:100%;" onclick="openLightbox(this)"/>
494 <p class="fig-cap">Figure 5.1. Event setup on tag value change</p>
495 </div>
Lana 36.3 496
Iaroslav Platonov 65.1 497 <p>Figure 5.1 shows the event <em>Switch position f.1.1 (1QF1)</em> configured as a one-position event bound to an IM object and a device. The formula <code>ti11013008 == 2</code> triggers the event when tag 11013008 equals 2. Dead time is 0 (no delay), acknowledgement is enabled, and the default sound plays 5 times.</p>
Lana 36.3 498
Iaroslav Platonov 65.1 499 <h4>Example 2: Event on device status change (with return)</h4>
Lana 36.3 500
Iaroslav Platonov 65.1 501 <div class="fig">
502 <img src="https://wiki.centosoftware.com/xwiki/bin/download/CENTO%20Manuals/6.%20Events%20Setup/WebHome/Screenshot%202025-12-10%20at%2022.19.25.png" alt="Event setup on device status change" style="max-width:100%;" onclick="openLightbox(this)"/>
503 <p class="fig-cap">Figure 5.2. Event setup on device status change</p>
504 </div>
Lana 36.3 505
Iaroslav Platonov 65.1 506 <p>Figure 5.2 shows a paired event with return. Two notifications are configured:</p>
507 <ol>
508 <li>
509 <strong>Lost connection with Mikrotik SW1.2</strong> &mdash; formula
510 <code>(devstatus100 == 3) AND (devprevstatus100 != 3)</code>, meaning device ID 100
511 just entered error status. Dead time = 3000 ms; alarm type with acknowledgement;
512 sound plays until acknowledged.
513 </li>
514 <li>
515 <strong>Restored connection with Mikrotik SW1.2</strong> &mdash; formula
516 <code>(devstatus100 == 1) AND (devprevstatus100 != 1)</code>, meaning device ID 100
517 just returned to normal status. Informational type; no acknowledgement required;
518 sound plays 3 times.
519 </li>
520 </ol>
Lana 36.3 521
Lana 37.2 522
Iaroslav Platonov 65.1 523 <h2 id="s-annex">Appendix: Formula Reference<a class="anchor-icon" href="javascript:void(0)" onclick="copyAnchor('s-annex')" title="Copy link"><svg width="12" height="12" viewBox="0 0 16 16" fill="currentColor"><path d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"/></svg></a></h2>
Lana 37.2 524
Iaroslav Platonov 65.1 525 <p>Formulas can include arithmetic operations, conditions, mathematical and special functions, and pre-calculated measurements (up to three levels of nesting).</p>
Lana 39.2 526
Iaroslav Platonov 65.1 527 <div class="tbl-wrap">
528 <table class="rn-table">
529 <caption style="text-align:left;font-size:.8em;color:#555;padding:6px 0;font-weight:700;">Table A.1 &mdash; Variables in formulas</caption>
530 <thead>
531 <tr>
532 <th style="min-width:160px;">Variable</th>
533 <th>Description</th>
534 </tr>
535 </thead>
536 <tbody>
537 <tr><td><code>[tiN]</code></td><td>Current value of tag with ID&nbsp;N</td></tr>
538 <tr><td><code>[prevN]</code></td><td>Previous value of the tag with ID&nbsp;N</td></tr>
539 <tr><td><code>[statusN]</code></td><td>Current status of tag with ID&nbsp;N</td></tr>
540 <tr><td><code>[prevstatusN]</code></td><td>Previous status of tag with ID&nbsp;N</td></tr>
541 <tr><td><code>[lasttimeN]</code></td><td>Current timestamp of the tag with ID&nbsp;N</td></tr>
542 <tr><td><code>[beforetimeN]</code></td><td>Previous timestamp of the tag with ID&nbsp;N</td></tr>
543 <tr><td><code>[devstatusN]</code></td><td>Current device status: 0&nbsp;= disabled; 1&nbsp;= normal; 2&nbsp;= at least one TI with abnormal quality; 3&nbsp;= polling error (unavailable); 4&nbsp;= manual input; 7&nbsp;= waiting for data</td></tr>
544 <tr><td><code>[devprevstatusN]</code><br><code>[prevdevstatusN]</code></td><td>Previous device status (same status codes as above)</td></tr>
545 <tr><td><code>[devlastdtN]</code></td><td>Time when the latest device data was received</td></tr>
546 <tr><td><code>[devpingtimeN]</code></td><td>Response time (ms) to ICMP ping of device&nbsp;N</td></tr>
547 <tr><td><code>[connectedN]</code></td><td>Connection with device&nbsp;N restored</td></tr>
548 <tr><td><code>[!connectedN]</code></td><td>Connection with device&nbsp;N is lost</td></tr>
549 </tbody>
550 </table>
551 </div>
Lana 39.2 552
553
Iaroslav Platonov 65.1 554 <div class="tbl-wrap">
555 <table class="rn-table">
556 <caption style="text-align:left;font-size:.8em;color:#555;padding:6px 0;font-weight:700;">Table A.2 &mdash; Operators in formulas</caption>
557 <thead>
558 <tr>
559 <th style="min-width:80px;">Operator</th>
560 <th>Description</th>
561 <th>Example</th>
562 <th>Result</th>
563 </tr>
564 </thead>
565 <tbody>
566 <tr><td><code>+</code></td><td>Addition</td><td><code>5 + 5</code></td><td>10</td></tr>
567 <tr><td><code>-</code></td><td>Subtraction</td><td><code>5 - 3</code></td><td>2</td></tr>
568 <tr><td><code>*</code></td><td>Multiplication</td><td><code>0.01 * [val]</code></td><td>0.01 &times; val</td></tr>
569 <tr><td><code>/</code></td><td>Division</td><td><code>[val] / 1000</code></td><td>val / 1000</td></tr>
570 <tr><td><code>%</code></td><td>Modulo (remainder)</td><td><code>10 % 3</code></td><td>1</td></tr>
571 <tr><td><code>=</code></td><td>Assigns a value to a tag</td><td><code>[ti123] = 5</code></td><td>5</td></tr>
572 <tr><td><code>==</code></td><td>Equal (returns true/false)</td><td><code>2 == 2</code></td><td>true</td></tr>
573 <tr><td><code>&lt;, &gt;, &lt;=, &gt;=</code></td><td>Arithmetic comparison</td><td><code>2 &gt;= 3</code></td><td>false</td></tr>
574 <tr><td><code>&amp;&amp;</code>, <code>&amp;</code>, <code>AND</code>, <code>and</code></td><td>Logical AND</td><td><code>(devstatus1==1) AND (devstatus2==1)</code></td><td>true if both</td></tr>
575 <tr><td><code>||</code>, <code>|</code>, <code>OR</code>, <code>or</code></td><td>Logical OR</td><td><code>(devstatus1==3) OR (devstatus2==3)</code></td><td>true if either</td></tr>
576 </tbody>
577 </table>
578 </div>
Lana 39.2 579
580
Iaroslav Platonov 65.1 581 <div class="parent-topic">Parent topic: <a href="[[CENTO Manuals>>doc:CENTO Manuals.WebHome]]">CENTO Manuals</a></div>
Lana 39.2 582
Iaroslav Platonov 65.1 583 </div><!-- /doc-content -->
Lana 40.2 584
Iaroslav Platonov 65.1 585 <nav class="doc-toc">
586 <div class="toc-header">
587 <strong>On This Page</strong>
588 <button class="toc-toggle" id="toc-tog" title="Collapse">&laquo;</button>
589 </div>
590 <ul id="toc-list">
591 <li class="tl1"><a href="#s-intro" data-toc>1. Introduction</a></li>
592 <li class="tl1"><a href="#s-events" data-toc>2. CENTO Events</a></li>
593 <li class="tl2"><a href="#s-event-editor" data-toc>2.1. Event editor</a></li>
594 <li class="tl2"><a href="#s-event-create" data-toc>2.2. Creating events (UI)</a></li>
595 <li class="tl2"><a href="#s-event-excel" data-toc>2.3. Creating events (Excel)</a></li>
596 <li class="tl2"><a href="#s-event-flash" data-toc>2.4. Flashing on diagram</a></li>
597 <li class="tl1"><a href="#s-notifications" data-toc>3. Notifications</a></li>
598 <li class="tl2"><a href="#s-notif-create" data-toc>3.1. Creating notifications</a></li>
599 <li class="tl2"><a href="#s-notif-logic" data-toc>3.2. Notification logic</a></li>
600 <li class="tl1"><a href="#s-sound-editor" data-toc>4. Sound Editor</a></li>
601 <li class="tl1"><a href="#s-examples" data-toc>5. Examples</a></li>
602 <li class="tl1"><a href="#s-annex" data-toc>Appendix: Formulas</a></li>
603 </ul>
604 </nav>
Lana 40.2 605
Iaroslav Platonov 65.1 606 </div><!-- /doc-wrap -->
Lana 40.2 607
Iaroslav Platonov 65.1 608 <script>
609 (function(){
610 var bar=document.getElementById('rn-prog');
611 var top=document.getElementById('rn-top');
612 window.addEventListener('scroll',function(){
613 var d=document.documentElement;
614 var pct=d.scrollTop/(d.scrollHeight-d.clientHeight);
615 bar.style.width=(pct*100)+'%';
616 d.scrollTop>280?top.classList.add('on'):top.classList.remove('on');
617 },{passive:true});
618 var links=Array.from(document.querySelectorAll('[data-toc]'));
619 var secs=links.map(function(a){return{el:document.getElementById(a.getAttribute('href').slice(1)),a:a};}).filter(function(s){return s.el;});
620 var busy=false;
621 var obs=new IntersectionObserver(function(entries){
622 if(busy)return;
623 entries.forEach(function(e){
624 if(!e.isIntersecting)return;
625 var i=secs.findIndex(function(s){return s.el===e.target;});
626 if(i<0)return;
627 secs.forEach(function(s){s.a.classList.remove('toc-on');});
628 secs[i].a.classList.add('toc-on');
629 var toc=document.querySelector('.doc-toc');
630 var link=secs[i].a;
631 toc.scrollTop=link.offsetTop-toc.offsetTop-toc.clientHeight/2+link.clientHeight/2;
632 });
633 },{rootMargin:'-8% 0px -60% 0px',threshold:0});
634 secs.forEach(function(s){obs.observe(s.el);});
635 links.forEach(function(a){
636 a.addEventListener('click',function(e){
637 var id=a.getAttribute('href').slice(1);
638 var el=document.getElementById(id);
639 if(!el)return;
640 e.preventDefault();
641 busy=true;
642 secs.forEach(function(s){s.a.classList.remove('toc-on');});
643 a.classList.add('toc-on');
644 el.scrollIntoView({behavior:'smooth',block:'start'});
645 setTimeout(function(){busy=false;},900);
646 });
647 });
648 var tocList=document.getElementById('toc-list');
649 var togBtn=document.getElementById('toc-tog');
650 var collapsed=false;
651 togBtn&&togBtn.addEventListener('click',function(){
652 collapsed=!collapsed;
653 tocList.style.display=collapsed?'none':'';
654 togBtn.textContent=collapsed?'»':'«';
655 });
656 var lb=document.getElementById('rn-lb');
657 var lbI=document.getElementById('rn-lb-img');
658 var lbC=document.getElementById('rn-lb-cap');
659 window.openLightbox=function(img){lbI.src=img.src;lbI.alt=img.alt;lbC.textContent=img.alt;lb.classList.add('open');document.body.style.overflow='hidden';};
660 window.closeLightbox=function(){lb.classList.remove('open');document.body.style.overflow='';};
661 lb.addEventListener('click',function(e){if(e.target===lb)closeLightbox();});
662 document.addEventListener('keydown',function(e){if(e.key==='Escape')closeLightbox();});
663 var toast=document.getElementById('rn-toast');
664 var t;
665 window.copyAnchor=function(id){
666 var url=location.href.split('#')[0]+'#'+id;
667 if(navigator.clipboard)navigator.clipboard.writeText(url).catch(function(){});
668 else{var x=document.createElement('textarea');x.value=url;document.body.appendChild(x);x.select();document.execCommand('copy');document.body.removeChild(x);}
669 toast.classList.add('on');clearTimeout(t);t=setTimeout(function(){toast.classList.remove('on');},1600);
670 };
671 (function(){
672 var toc=document.querySelector('.doc-toc');
673 var wrap=document.querySelector('.doc-wrap');
674 if(!toc||!wrap)return;
675 var navbar=document.querySelector('.navbar,nav.navbar,#topBar,header');
676 var navH=navbar?navbar.offsetHeight:0;
677 var footer=document.querySelector('footer,.xwikifooter,#xwikifooter,.bottombar,.sticky-container');
678 function update(){
679 var wr=wrap.getBoundingClientRect();
680 if(wr.top<=navH){
681 var footerTop=footer?footer.getBoundingClientRect().top:window.innerHeight;
682 var h=Math.max(0,Math.min(window.innerHeight,footerTop)-navH);
683 toc.classList.add('is-fixed');toc.style.top=navH+'px';toc.style.left=(wr.right-200)+'px';toc.style.height=h+'px';
684 }else{toc.classList.remove('is-fixed');toc.style.top=toc.style.left=toc.style.height='';}
685 }
686 requestAnimationFrame(function(){requestAnimationFrame(function(){update();window.addEventListener('scroll',update,{passive:true});window.addEventListener('resize',update,{passive:true});});});
687 })();
688 })();
689 </script>
690 {{/html}}