The Alert Function enables the creation of powerful and flexible Alerts that can respond to a wide variety of different events.
The Alert State contains a group of
AlertDefinition objects - each of which defines a rule which - when met - will fire the Alert.
The Alert Definition uses a Predicate - the same boolean function as is used as in filters - which has a type (e.g. GreaterThan) and, optionally, inputs (e.g. 100)
Developers can easily provide their own Custom Predicates to create bespoke validation rules.
For more information see Predicate.
Using a Query
In more advanced scenarios (e.g. if you want the Alert Definition to look not only at the cell being edited but also at other values in the row) you can, additionally, use a Query.
When this is added, the Alert will only be fired if both the Predicate and the Query return true.
Alerts trigger both as the result of direct user edits in the Grid and as data ticks in the underlying data source
MessageType of the Alert sets what type of of Message is displayed (and the colour will vary accordingly). The available values are:
Success - (default colour is green)
Info - (default colour is blue)
Warning - (default colour is amber)
Error - (default colour is red)
The primary options for displaying an Alert include:
Display a Popup - useful for very important Alerts
Colour the Cell where the data changed that triggered the Alert (based on the Alert's
Jump to Cell so that the Grid will immediately show the row which contains the cell that triggered the Alert
Show the Alert details in a Div element (that you specify in Container Options)
The previous way of doing this - via
AlertDisplayDivproperty in Alert State - is deprecated
All Alerts when triggered will display (and update the count) in the Alert Toolbar and Alert Tool Panel.
Additionally, all Alerts will fire the AlertFired event (the contents of which will be also sent to the console).
Alert Definition Scope
Like many objects in AdapTable, Alert uses Scope to determine where an Alert should be applied.
The Scope can be one, some or all columns, or it can be all columns of a particular DataType (or DataTypes).
Alerts includes the following UI Elements:
Popup - Shows a list of existing Alerts with Edit and Delete buttons. Plus an Add button to start the Alerts Wizard which facilitates the creation and editing of Alerts.
Toolbar - Updates when an Alert is triggered; contains an info button which when clicked gives full details of each Alert.
Tool Panel - Same as Toolbar above.
Context Menu Item -
Clear AlertMenu Item opens clears a Cell if it has been coloured by an Alert (only visible if selected cell if one which has triggered a Live Alert and has been coloured by it).
Alerts Entitlement Rules:
Full: Everything is available to the User
Hidden: Everything is hidden from the User and any Alerts supplied in Predefined Config will be ignored.
ReadOnly: Alerts will trigger as normal but users cannot not edit or delete them, nor create others.
Alert Predefined Config
The Alert section of AdapTable State enables Alert Definitions to be provided at design-time.
These Alerts will be triggered automatically when their Predicate property evaluates as true.
Can we show Alerts in the System Tray?
Not at the moment but that is something we hope to have available soon for those users who access AdapTable in the OpenFin container.
I dont want my Alerts to pop-up. Can I prevent that?
Yes, when you create an Alert Definition you can stipulate, among other things, whether the Alert will popup. See Alert State for the full Alert Definition.
What is the difference between the Alert and the Reminder functions?
Reminders are, indeed, similar to Alerts but there are 2 key differences:
- the message is hard-coded rather than dynamically derived from the nature of the data change and they
- reminders are triggered, not when something changes in the Grid, but according to a Schedule set by the User when creating the Reminder.