Try OpenEdge Now
skip to main content
Business Process Portal User's Guide
Managing Alerts : Alerts from external application
 

Alerts from external application

In addition to Business Process Server, an external application can also send a JMS message with alert information to a Business Process Server queue. Messages sent to this queue are processed by Business Process Server. If the selector property in the message matches with the required value, then it is identified as an alert message. Business Process Server collects the required data values and publishes the alert. Once Business Process Server publishes the alert for the intended recipients, they can see it in their My Alerts page.
As external alerts are not associated with any Business Process Server application, they do not have any process context associated with the alert messages. Therefore, Business Process Server cannot support external alert messages with dataslots. However, Business Process Server supports alert messages with dataslots for alert messages defined in a Business Process Server application.

JMS message

The alert message must be sent in the specified structure to the Business Process Server queue. This message must contain the message selector property and message body. The message must be of type ObjectMessage, and a Map object must be set on that ObjectMessage.

Message property

The following Table 15 explains the message property details for the JMS message with alert information.
Table 15. JMS message properties details
Property name
Property value
Data type
messageName
PUBLISH_ALERT
java.lang.String
This property is mandatory, and must have the specified value.

Message body

The following Table 16 explains the message body details for the JMS message with alert information.
Table 16. JMS message body details
Property name
Property value
Data type
Comment
ALERT_NAME
Alert name
java.lang.String
The name of the alert.
APPLICATION_NAME
Name of the application sending alert
java.lang.String
You can use this property to group alerts with common origin/sender.
ALERT_MESSAGE
Alert message
java.lang.String
The alert message.
ALERT_SEVERITY
Severity value of the alert
java.lang.String
The severity of the alert. Valid values are CRITICAL, HIGH, MEDIUM, and LOW.
ALERT_RECIPIENT
List of recipients of the alert
java.util.List<String>
The list of valid Business Process Server users. These users can see the alert in their My Alerts page.
All the above properties are mandatory.
* Connecting to a Business Process Server to send alert message