Understanding business event definitions and event processing

Business event definitions allow users to monitor your applications by automatically detecting business conditions and triggering specified processes.

What is an Event Definition?

A business event definition monitors and responds to events of interest in your application that may not be easily represented as procedural steps in workflows, activities, and so on. Such events

• may occur at any time
• may occur or be initiated outside of your PRPC application
• may refer to patterns of events involving multiple changes to work items, classes, actors, and other objects

The business event definition comprises both the conditions and resulting actions of a business event. For example, the event condition could be whenever a work item in the Adjustments application becomes resolved with a status of Resolved-Writedown and the principal amount is more than $10,000. The related action could be that the system sends an email notification to a specific group of people.

Each business event definition has:

• a name: the name uniquely identifies the business event definition within the application of which it is a part.
• a work type: the work type can be any of the classes in your application that have associated starter flows.
• an event type: the event type is one of four values (listed below).

Internally, a business event definition is a work item of the work type PegaAccel-CEPSetup, identified by the reserved work item prefix pxEvent-.

Privileges

Two privileges, included in the Access of Role to Object PegaAccel-CEPSetup, affect use of this capability.

Privilege	Description
PegaAccel-CEPSetup.ViewEventDefinitions	Permits viewing business event definitions.
PegaAccel-CEPSetup.EditEventDeveloper	Permits creating and editing business event definitions.

This Access of Role to Object, and therefore these privileges, are included in the PRPC roles PegaRULES:SysAdm4 and PegaRULES:WorkMgr4.

Event Types

V6.2 contains four predefined event types which address commonly-needed situations. These event types are predefined in the PegaAccel-CEPSSetup.pyEventRuleType.

Internal value	Description
pxInstanceUpdated	The work item was updated.
pxAttachmentAdded	An attachment was added to the work item.
pxCorrespondenceGenerated	An item of correspondence was produced for the work item.
pxGoalOrDeadlineExceeded	A service level goal or service level deadline was not met.

Work Types and other Classes

Class	Description
PegaAccel-CEPSetup	All event definition work items are of this type
Pega-Event-System	When an event is generated the details are stored in an object of this type.

Agent(s)

	agent, event, subscription
	Understanding the Pega-EventProcessing agent Process and Rules category — Events landing page

To create a new event definition

See Case Manager portal — My Events tab — Creating and subscribing to business events and PDN article 26370 How to create and subscribe to business events.

Event Landing Page

Select > Process and Rules > Events to access the Events landing page. Two tabs are available:

• Event Definitions: this tab provides information about existing event definitions. Although you cannot create a new event definition from the landing page, you can update and debug existing event definitions.
• Event Logs: This tab records each occasion a business event responds to a change to a work item, or other stimulus, and generates an action. You can click any column heading to sort the display by the entries in that column. To see additional information, hover the mouse cursor over the SmartInfo icon at the left of any row. A SmartInfo display provides additional information.

See Process and Rules category — Events page.

Concepts