# Rules

## How Rules Work

*Rules* are the conditions that must be met for an alarm to be triggered.

Based on *rules*, you can configure in detail when an alarm should be triggered.

Rules are created for individual assets. A single attribute can be monitored per asset. With a rule, you set a limit value for this attribute. If the value of the monitored attribute rises or falls below/above this limit value, an alarm is created.

## Overview

<div data-full-width="true"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2F75HBsRFlyqie4vSFCCKD%2FBulk%20pausing%20rules%20(1).png?alt=media&#x26;token=46819db2-f421-4d3c-9731-b37d2e133111" alt=""><figcaption><p>Fig. 1 – The "Rules" menu with the rule overview</p></figcaption></figure></div>

<table data-full-width="true"><thead><tr><th width="72.33333333333331"></th><th width="181.79998779296875"></th><th></th></tr></thead><tbody><tr><td><strong>[A]</strong></td><td>"Rules" menu item</td><td>Click to open the alarm overview.</td></tr><tr><td><strong>[B]</strong></td><td>"Status" column</td><td>Shows whether the corresponding rule is currently paused or not.</td></tr><tr><td><strong>[C]</strong></td><td>"Priority" column</td><td>Shows the priority of an alarm.<br>This value is configured when a rule is created.</td></tr><tr><td><strong>[D]</strong></td><td>"Attribute" column</td><td>Shows which attribute the rule applies to.<br>This value is configured when a rule is created.</td></tr><tr><td><strong>[E]</strong></td><td>"Condition" column</td><td>Shows which value must be reached for an alarm to be created.<br>This value is configured when a rule is created.</td></tr><tr><td><strong>[F]</strong></td><td>"Type" column</td><td>Shows where the rule was created or where it comes from.</td></tr><tr><td><strong>[G]</strong></td><td>"Tags" column</td><td>Shows the selected tags for the rule.</td></tr><tr><td><strong>[H]</strong></td><td>"Alarm Text" column</td><td>Shows which message is displayed when an alarm is created.<br>Is configured when a rule is created.</td></tr><tr><td><strong>[I]</strong></td><td>"Active Rules" switch</td><td><ul><li>When this switch is <strong>ON</strong>: Active rules are displayed</li><li>When this switch is <strong>OFF</strong>: Active rules are not displayed</li></ul></td></tr><tr><td><strong>[I1]</strong></td><td>Number of "Active Rules"</td><td>Shows how many active rules are present</td></tr><tr><td><strong>[J]</strong></td><td>"Paused Rules" switch</td><td><ul><li>When this switch is <strong>ON</strong>: Paused rules are displayed</li><li>When this switch is <strong>OFF</strong>: Paused rules are not displayed</li></ul></td></tr><tr><td><strong>[J1]</strong></td><td>Number of "Paused Rules"</td><td>Shows how many paused rules are present</td></tr><tr><td><strong>[K]</strong></td><td>Sorting selection</td><td>Chooses whether rules are sorted functionally or geographically</td></tr><tr><td><strong>[L]</strong></td><td>Rule chains</td><td>Opens the rule chains page <a href="rule-chains">→ Rule chains</a></td></tr><tr><td><strong>[M]</strong></td><td>Bulk pause/start</td><td>Opens the window to start or pause multiple rules at once <a href="#pause-or-start-multiple-rules-at-once">↗ Pause or start multiple rules at once</a></td></tr><tr><td><strong>[N]</strong></td><td>Search</td><td>Click to open the search menu</td></tr><tr><td><strong>[O]</strong></td><td>Create new rule</td><td>Opens the control panel to create a new rule</td></tr><tr><td><strong>[P]</strong></td><td>Create new rule in asset</td><td>Opens the control panel to create a new rule directly for the corresponding asset</td></tr><tr><td><strong>[Q]</strong></td><td>Pause/activate all rules of an asset</td><td>Shows whether all rules of the asset are currently paused or active. Click to switch between the two states.</td></tr><tr><td><strong>[R]</strong></td><td>Pause/activate rule</td><td>Shows whether a rule is currently paused or active. Click to switch between the two states.</td></tr><tr><td><strong>[S]</strong></td><td>More options</td><td>Display more options.</td></tr><tr><td><strong>[T]</strong></td><td>Edit rule</td><td>Edit the respective rule. For available options <a href="rules/create-a-rule">-> see here</a></td></tr><tr><td><strong>[U]</strong></td><td>Go to</td><td>Opens the window to go to the corresponding elements</td></tr><tr><td><strong>[V]</strong></td><td>Duplicate</td><td>Creates a copy of the rule.</td></tr><tr><td><strong>[W]</strong></td><td>Add to bookmarks</td><td>Adds the rule to the bookmarks.</td></tr><tr><td><strong>[X]</strong></td><td>Delete rule</td><td>Delete the respective rule.<br><strong>⚠ Caution</strong>: When a rule is deleted, all corresponding <a href="../alert-center/alarms">↗ alarms</a> and entries in the <a href="../alert-center/alarms/alarm-statistics">↗ alarm history</a> are also deleted.</td></tr></tbody></table>

## Create a Rule

See chapter [-> Create a Rule.](https://docs.buildings.ability.abb/collection/platform/alarms-rules-and-escalations/rules/create-a-rule)

## Edit a Rule

Click on **\[O]** to edit a rule. The available options are the same as when a [-> rule is created.](https://docs.buildings.ability.abb/collection/platform/alarms-rules-and-escalations/rules/create-a-rule)

## Pause a Rule

Click on **\[N]** to pause a rule. As long as a rule is paused, no alarm is created if the conditions of this rule are met.

Click on **\[N]** again to activate the rule again.

## Pause or Start Multiple Rules at Once

<div align="center"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FNjPXDNqPg1WXtlBY00BH%2FBulk%20pausing%20rules%20(3).png?alt=media&#x26;token=e7f3c8de-6730-4852-96d4-d1067f9c831c" alt="" width="375"><figcaption></figcaption></figure></div>

1. **Navigate to rule management:** Go to *Rule Chains* and click on **\[M]** **Bulk pause/start**.
2. **Select action type:**
   * Select **\[M1]** **Pause rule** to pause rules.
   * Select **\[M2]** **Start rule** to activate rules.
3. **Use "Pause all" option (optional):** If all existing rules are to be paused, activate the option **\[M3]** **Pause all**.
4. **Select assets:** In the **\[M4]** field *Search asset*, enter the desired asset for which the rules are to be paused or started.
5. **Confirm action:** Click on **\[M5]** **Apply** to pause or start the selected rules. *If you want to cancel the action, click on **Cancel**.*

   ▷ The selected rules are paused or started depending on the selection.

## External Rules

Rules can also be created via external connections. These rules are marked with **"External"** in *Eliona*, can only be edited to a limited extent, and cannot be deleted.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FJb7H4rk763C6Bo8Yyghk%2FFrame%201863.png?alt=media&#x26;token=de699652-7153-4fc6-bfd7-0106d973f7c8" alt=""><figcaption></figcaption></figure>

Another type of rule are those created by the rule engine. These rules are marked accordingly and can neither be edited nor deleted.&#x20;

▷ *An attempt to edit such a rule will result in a direct redirection to the corresponding rule in the rule engine.*

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FOCUI8KFJii6jtZvh8bOd%2Fimage.png?alt=media&#x26;token=8c99d554-dc19-4e82-816a-05bce746c6c1" alt=""><figcaption></figcaption></figure>
