# Configure Signal Alerts

Learn how to configure _Signal Alert Rule Sets_ and _Signal Alert Rules_ for the Signal Alert Rule Engine.

## About Signal Alerts

The Signal Alert Rule Engine runs against _Statistical Data_ records within a given _Signal Reporting Period_ to determine whether the associated _Product-Event Combination_ (PEC) qualifies as a potential signal.

When the Signal Alert Rule Engine runs, Vault evaluates all active _Signal Alert Rule Sets_ associated with a _Signal Product Profile_ with the _Safety Database_ source. A _Signal Alert Rule Set_ defines a group of _Signal Alert Rules_. A _Signal Alert Rule_ defines a rule using an expression. Safety Signal provisions rules that meet the industry standard and you can configure custom rules to suit your business needs.

After configuring signal alerts, see <a href="/en/lr/808066/">Run & Review Signal Alerts</a> for more information on how to use this feature.

## Prerequisites

Before configuring this feature, you must <a href="/en/lr/808069/">enable the Signal Alert Rule Engine</a> in your Vault and <a href="/en/lr/808068/">configure _Signal Product Profiles_</a>.

## Configure Signal Alert Rule Sets

Follow the steps below to configure _Signal Alert Rule Sets_:
1. Navigate to **Business Admin > Objects > Signal Alert Rule Sets**.
2. Select **Create**.
3. Complete the following information:
    * **Signal Alert Rule Set Name**: Enter a name for the _Signal Alert Rule Set_.
    * (Optional) **API Name**: Enter an API name for the _Signal Alert Rule Set_.
4. Select **Save**.
5. Expand all sections.
6. [Configure _Signal Alert Rules_][1].
7. [Link a _Signal Alert Rule Set_ with a _Signal Product Profile_][2].

### Configure Signal Alert Rules

Follow the steps below to configure _Signal Alert Rules_:
1. Navigate to **Business Admin > Objects > Signal Alert Rules** or **Business Admin > Objects > Signal Alert Rule Sets > [applicable Signal Alert Rule Set] > Signal Alert Rules** section.
2. Select **Create**.
3. Complete the following information:
    * **Signal Alert Rule Name**: Enter a name for the _Signal Alert Rule_.
    * (Optional) **API Name**: Enter an API name for the _Signal Alert Rule_.
    * (Optional) **Description**: Enter a description for the _Signal Alert Rule_.
    * **Expression**: Enter an expression using operators and values. See the [table below][3] for _Signal Alert Rule_ expressions that meet industry standards. For guidance on writing expressions according to your business needs, use Vault's <a href="/en/lr/52324/">Formula Reference Guide</a> and <a href="/en/lr/44478/">Configuring Formula Fields on Objects</a>. \
    Field values in this expression must exist on the _Statistical Data_ object, otherwise an error will occur when you save the _Signal Alert Rule_ record.
    * **Signal Alert Rule Set**: If creating the rule from a _Signal Alert Rule Set_, Vault sets this field automatically. Otherwise, select a _Signal Alert Rule Set_ from the drop-down or select the **Advanced Search** (<img class="inline" src="https://platform.veevavault.help/assets/images/saf-binoculars-icon.png" alt="binoculars-icon" style="" />) icon to use filters and refine your search.
    * **Alert Category**: Select a picklist value. If a value does not exist for the _Signal Alert Rule_, you can optionally [create a new alert category][4]. You can select one (1) value only.
4. Select **Save**.

|Expression|Industry-Standard Signal Alert|
|--- |--- |
|`listed__v = false`|If the PEC is not listed on the _<a href="/en/lr/752951/#listedness">Case Assessment</a>_, the rule passes.|
|`eb05__v >= 2`|If the EB05 score is greater than or equal to two (2), the rule passes.|
{:#industry-standard-expressions-table}

### Link a Signal Alert Rule Set with a Signal Product Profile

A _Signal Product Profile_ is associated with a _Signal Reporting Period_. Link the _Signal Alert Rule Set_ with the applicable _Signal Product Profile_ in order for Vault to evaluate this rule set until the end of the reporting period. You can do this in the following ways:
* Add the _Signal Alert Rule Set_ directly on the _Signal Product Profile_.
* Create a _Signal Alert Rule Set Product Profile_.

To add the _Signal Alert Rule Set_ to a _Signal Product Profile_:
1. Navigate to **Business Admin > Objects > Signal Product Profiles > [Signal Product Profile]**.
2. Expand the **Alert Rule Sets** section.
3. Select **Add**.
4. Add the applicable **Signal Alert Rule Sets** from the list or use the search bar and filters to refine your search.
5. Select **OK**.

To create a _Signal Alert Rule Set Product Profile_:
1. Navigate to **Business Admin > Objects > Signal Alert Rule Set Product Profiles**.
2. Select **Create**.
3. Complete the following information:
    * **Name**: Enter a name for the _Signal Alert Rule Set Product Profile_.
    * **Signal Alert Rule Set**: Select an option from the drop-down or select the **Advanced Search** icon to use filters and refine your search.
    * **Signal Product Profile**: Select an option from the drop-down or select the **Advanced Search** icon to use filters and refine your search.
4. Select **Save**.

## Create Alert Categories

After you configure custom _Signal Alert Rules_, you can optionally configure additional signal alert categories, which Vault assigns to the rules that are met. Alert categories provide more detail about the _Signal Alert Rule_ that was met for the users reviewing _Statistical Data_ records.

To do this:
1. Navigate to **Business Admin > Picklists > Signal Alert Category**.
2. In the _Picklist Values_ section, select **Create**.
3. In the _Create Picklist Value_ dialog, enter a picklist value for the new _Signal Alert Category_.
4. Select **Save** or **Save + Create** to save the value and create another.
5. Optional: Select **Reorder** to organize the list of values by dragging and dropping them and then select **Save**.

## Test the Signal Alert Rule Engine

After performing the configuration on this page, you can test the alert rules and rule sets by <a href="/en/lr/808066/#manually-run-the-signal-alert-rule-engine">manually running the Signal Alert Rule Engine</a>.

[1]: #configure-signal-alert-rules
[2]: #link-a-signal-alert-rule-set-with-a-signal-product-profile
[3]: #industry-standard-expressions-table
[4]: #create-alert-categories