Events and Notifications Framework PeopleBook

Getting Started with PeopleSoft Events and Notifications Framework

This chapter provides an overview of the PeopleSoft Events and Notifications Framework and discusses implementation information.

PeopleSoft Events and Notifications Framework Overview

The PeopleSoft Events and Notifications framework provides three features that can be configured and used to monitor business processes and create messages when unusual situations or errors occur within a PeopleSoft process or table. These messages can be routed to different users (PeopleSoft or non-PeopleSoft) to prompt the user to resolve the issue. Links can take the user directly to the page for correction or resolution. The three features are:

Events
Notifications
Alerts

Events

Events is a feature and framework that enables you to define, implement, and run business logic for business events.

Using the Events framework, you can define the business events that the system raises when you change certain data in application components or run certain PeopleTools Application Engine processes. You can also define the event handlers that the Events framework executes to react to these specific event instances. Raising an event is the act of creating an event instance. If an event is raised, the Events framework automatically executes the business logic for the registered event handlers of the event.

Events allow you to:

Isolate, automatically process, and monitor the business logic asynchronously.
Define your own business events and build your own event handlers for these events with minimal impact to the delivered code.
Troubleshoot based on detail provided in the Event Monitor.

Notifications and Alerts

The notifications feature enables you to monitor the transaction flow and alert your organization to any errors, changes, and stalled transactions.

With notifications and alerts, you can:

Monitor PeopleSoft processes and receive notifications when exceptions are found.
Scan PeopleSoft tables using PeopleSoft Query and receive notifications when exceptions are found.
Use the Notification Dashboard to monitor messages and link to the PeopleSoft page where you can review or correct the issue.
Receive notifications to your email account.
Receive notifications to your PeopleSoft worklist.
Pass messages to a third-party system using the XML format.
Create a custom action for a notification using an PeopleSoft application class.

Events and Notifications Framework Implementation

Many PeopleSoft applications are delivered with pre-defined events and notifications. Refer to your specific application for implementation details.

PeopleSoft Setup Manager enables you to review a list of setup tasks for your organization for the products that you are implementing. The setup tasks include the components that you must set up, listed in the order in which you must enter data into the component tables, and links to the corresponding PeopleBook documentation.

Other Sources of Information

In the planning phase of your implementation, take advantage of all PeopleSoft sources of information, including the installation guides, table-loading sequences, data models, and business process maps.

Implementing Events

To implement Event Manager into your application processing:

Step	Reference
1. Identify the business events that drive the execution of your business logic and, if necessary, define a new event.	See Defining and Registering Events.
2. Write the event handlers in PeopleTools Application Designer to execute the business logic that is specific to the event.	See Creating Event Handlers.
3. Register the event handlers to the event through the Event Registry component.	See Defining and Registering Events.
4. Test your event and its registered event handlers.	See Testing an Event Handler.

Implementing Notifications

To implement notifications:

Step	Reference
1. Add your process name and category to the Notification Registry page.	See Setting Up the Notification Registry.
2. Create a message context record to pass all transactional data through the message framework.	All context records must include the EOEN_LOG_KEY subrecord. Any additional transactional fields can be added to the context record.
3. Implement the EOEN interface object within your application process by using the EOEN_MVC:EOEN_MODEL.EOEN_INTERFACE class.	See Modifying PeopleSoft Processes to Create Notifications.

Implementing Alerts

Use these steps to implement alerts:

Step	Reference
1. Define the query to use with the alert.	See Defining PeopleSoft Queries in the Alert Setup Component.
2. Define the Alert Setup	See Defining PeopleSoft Queries in the Alert Setup Component.
3. Run the Alert process.	See Running the Alerts Process.