Try OpenEdge Now
skip to main content
Developing BPM Applications with Developer Studio
Using alerts : Defining an alert
 

Defining an alert

You can define new alerts in the Alerts tab.
To define an alert:
1. Load the Business Process (SPT) for which you want to define the alert.
2. From the Alerts tab, click Add.
The New Alert wizard appears.
3. From the first page of the New Alert wizard, you can specify the alert name, severity, and description of the alert.
a. Type the name of the alert in the Name box. The name can only include alphanumeric characters and underscore (“_”). Do not start the alert name with a numeric character. The name for an Alert should not exceed 64 characters.
b. Select an option from the Severity drop-down list; options are: Critical, High, Medium, and Low. The Severity indicates to the alert recipients the urgency with which they should respond to the Alert.
c. Enter a description (optional) of the alert in the Description box. This will enable other users of the application in BPM Designer to determine the intent of the alert.
4. Click Next. From the second page of the New Alert wizard, you can define a condition that activates the alert when the condition is satisfied.
a. To define an alert condition, click Condition to open the Condition dialog box.
b. Select a dataslot from the drop-down list on the left. Only CHARACTER, INTEGER, INT64, LOGICAL, and DATETIME-TZ dataslot types are listed.
c. Select an operator. To complete defining the condition, select a dataslot from the drop-down list on the right or enter a value.
d. To add another condition, click and select And or Or option from the drop-down list. To remove a condition, click .
e. Click the Advanced option to go to the advanced mode where you can create a condition by adding specific dataslots or by entering (or copy-paste) a condition.
f. To verify the expression’s validity, click Validate in basic or advanced mode, and the “Validation successful” message appears.
5. Click Next. You can use the third page of the New Alert wizard to specify the alert message.
In the Message box, enter the content of the message that you want the alert recipients to see when they open the Alert. You can enter static or dynamic values in the message. For dynamic values, you can use dataslots (${dataslot_name} or ${@System_dataslot}). Press CTRL+SPACE to view the list of dataslots in the process. Select the dataslot to be added and press ENTER to add the dataslot in the Message box. For example, a message reading “Vacation request of ${days} has been filed by ${@CREATOR}” will use the days dataslot (a dataslot in the User category) and the @CREATOR dataslot (a System category dataslot) to obtain dynamic values for the number of days and the name of the person who filed the vacation request at runtime.
Note: If you use a System dataslot, it must be prefixed with “@”.
6. Click Next to define the recipients of the alert.
a. Click Add to open the Performer dialog box, which lists performers of type, "User" and "Group" (group of sub-type, "All") in the process.
You cannot add queues, groups of type "Any," or comma-separated lists of multiple performers as alert recipients.
b. Select a single (or multiple) performer and click OK to assign your selected user or group as the alert recipient.
To delete a recipient, select the recipient and click Remove.
7. Click Finish to add the defined alert to the Alerts tab.