This chapter describes how to define alert notifications and contacts in Oracle SOA Suite for healthcare integration. You can specify that certain people are alerted by email or text (SMS) when certain healthcare-related runtime or design-time events occur.
This chapter includes the following topics:
In healthcare integration, administrators and support personnel must know when certain events occur, such as changes to the healthcare configuration or errors that affect processing. Oracle SOA Suite for healthcare integration addresses this by allowing you to define contact information and associate each contact with specific events for which alerts are generated.
For example, if an error occurs during message processing or delivery, an email or text alert can be sent to the appropriate people so the issue can be handled immediately.
The alert notification feature for healthcare integration works in conjunction with the built-in notification framework of Oracle User Messaging Service (UMS) and Oracle SOA Suite human workflow services.
Configuring contacts and alerts involves the following steps:
For information about configuring User Messaging Service, see Oracle® Fusion Middleware Administering Oracle User Messaging Service.
If you are using SMS (text) notifications, you must specify the target servers for the SMPP driver for the User Messaging Service. Perform this task on the Oracle WebLogic Administration Console.
To deploy the SMPP driver
Workflow notification properties enable the notification feature for all notification types, and also define email addresses for the sending email account for the notifications.
To configure the workflow notification properties
Oracle UMS provides the underlying infrastructure for notifications. In order to use email notifications, you must configure email driver information for the UMS; in order to use SMS (text) notifications, you must configure SMPP driver information.
To configure Oracle User Messaging Service
In the healthcare integration user interface, you can define contacts and then subscribe each contact to multiple alerts for different types of events. The events that can generate an alert are listed in Table 10-1.
To define alerts and contacts
Table 10-1 Healthcare Integration Alert Events
Event | Description |
---|---|
Runtime Error |
Triggers an alert when an error occurs during inbound or outbound message processing, delivery to endpoints, or delivery to internal delivery channels. |
Endpoint Error |
Triggers an alert when an error occurs in the endpoint transport layer; for example, the TCP/IP server port is already in use. |
Endpoint Configuration |
Triggers an alert when changes are made to an endpoint's configuration, including enabling and disabling an endpoint. |
Endpoint Document Usage Change |
Triggers an alert when changes are made for a document definition associated with an endpoint. |
Repository Import and Export |
Triggers an alert when data is imported into or exported from the healthcare integration repository. |
Runtime Settings Modification |
Triggers an alert when changes are made to the any of the runtime properties listed on the Runtime Settings page. |
Purge Events |
Triggers an alert when:
|
You can view all of the alerts that are assigned to a specific contact from the Contacts list on the Alerts and Contacts page.
To view alerts for a contact
After you create a contact, you can remove it from the contact list if it is no longer required. If a contact no longer must receive alerts for an event, you can unsubscribe the contact from that event.
To Remove a Contact
Under the Designer tab of the healthcare integration user interface, click the Administration tab and then double-click Alerts and Contacts.
In the Contacts list, select the contact to delete, and then click Delete Currently Selected Contact (the red X in the upper right of the Contacts list).
If the contact is subscribed to any alerts, a confirmation dialog appears. Click OK to remove the contact.
The contact is removed from the Contacts list and is also removed from any events to which it was subscribed.
To Unsubscribe a Contact from an Alert