RuleBasedAlertDefinition

View as Markdown

Alert that fires when data matches a rule in the given column scope

TypeScript
export interface RuleBasedAlertDefinition extends
Extends

AlertDefinitionBase

Properties

PropertyTypeDescription
AlertFormstring |AlertButtonFormForm to display in Alert with buttons and inputs
AlertPropertiesRuleAlertPropertiesProperties which set what happens when the Alert is triggered (notification and grid behaviours)
RulestringAdapTableQL boolean expression deciding when the Alert is triggered.

The kind is inferred from the text: a per-row rule such as
[price] > 100, an aggregated rule such as SUM{[notional]} > 1000000,
or a live (observable) rule such as CHANGE_COUNT{[price], WITHIN(5m)} >= 3.
ScopeColumnScopeWhere Alert can be triggered: one, some or all columns or DataTypes
TriggerPolicyAlertTriggerPolicyWhen a live rule (one reading change history — CHANGE_COUNT[price],
WITHIN(5m) = 3 — or the clock) fires. Live rules are re-evaluated on
data changes and on window expiry alike, and fire only on the transition
from false to true (per row, or once for a grid-level rule). Ignored for
every other rule.
IsReadOnlybooleanSets Entity to ReadOnly (overwriting a Strategy Entitlement of 'Full')
IsSuspendedbooleanSuspends (i.e. turns off) an Adaptable Object

Property Details

AlertForm

Form to display in Alert with buttons and inputs

TypeScript
AlertForm?: string | AlertButtonForm;
Property Value

string |AlertButtonForm

AlertProperties

Properties which set what happens when the Alert is triggered (notification and grid behaviours)

TypeScript
AlertProperties?: RuleAlertProperties;
Property Value

RuleAlertProperties

Rule

AdapTableQL boolean expression deciding when the Alert is triggered.

The kind is inferred from the text: a per-row rule such as [price] > 100, an aggregated rule such as SUM{[notional]} > 1000000, or a live (observable) rule such as CHANGE_COUNT{[price], WITHIN(5m)} >= 3.

TypeScript
Rule: string;
Property Value

string

Scope

Where Alert can be triggered: one, some or all columns or DataTypes

TypeScript
Scope: ColumnScope;
Property Value

ColumnScope

TriggerPolicy

When a live rule (one reading change history — CHANGE_COUNT[price], WITHIN(5m) = 3 — or the clock) fires. Live rules are re-evaluated on data changes and on window expiry alike, and fire only on the transition from false to true (per row, or once for a grid-level rule). Ignored for every other rule.

TypeScript
TriggerPolicy?: AlertTriggerPolicy;
Property Value

AlertTriggerPolicy

IsSuspended

Inherited from SuspendableObject

Suspends (i.e. turns off) an Adaptable Object

TypeScript
IsSuspended?: boolean;
Property Value

boolean

IsReadOnly

Inherited from AdaptableObject

Sets Entity to ReadOnly (overwriting a Strategy Entitlement of 'Full')

TypeScript
IsReadOnly?: boolean;
Property Value

boolean