Process and Rules category — Events page

A 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.

This tab includes four buttons and a tabular display.

• Click Debug Log to display the Event Debug Report.

  To verify that an event definition responds to the correct stimulus with the specified action, use the Debug icon (see below) on any listed event definition to enable debugging. The Event Debug Report lists all event actions caught by the debugger, displaying information about the event definition and work item involved. Hover over the information icon at the left of any row to see further information about the work item.

• Click Export Event Definitions to create a Product rule that includes the event definitions you see in the display, and their activities and When rules. The Product rule is created in the EventProcessing-Internal RuleSet. Each user has a unique name for the event definition export Product rule: if you export a second time, the system overwrites any existing Product rule of the same name.

  Use the Export tab to export the Product rule from the EventProcessing-Internal RuleSet. You can then import it into another PRPC system.

• Click to review events reported by the Really Simple Syndication (RSS) feed to the Pega Event Actions Feed, or to an RSS feed reader you designate.

• Click the Refresh icon at the top right of the screen to redraw the tabular display with current data.

The tabular display lists these values for each event definition in the current application.

Column	Description
Event	The name assigned by the user who created the event.
Event ID	The unique ID for the event.
Description	The description provided by the user who created the event.
Applies To	The type of work items to which the event applies.
Enabled	A check mark indicates that this event is enabled, or active.
Subscribed	A checkmark indicates that you have subscribed to this event definition.
Change Subscription	Click the subscription icon to manage your subscription to this event definition. See Case Management Portal — My Events tab — Creating and subscribing to business events.
Debug	Click the debug icon to display the Debug dialog. See below.

Create an Event Definition

You cannot create an Event Definition from the Events landing page. Composite portals, such as the Case Management Portal, include functionality for creating new Event Definitions. See Case Management Portal — My Events tab — Creating and subscribing to business events.

Update an Event Definition

To review or update an event definition, click the Event Definition Name or Description to display the Update Event Definition form. Click the Edit button to switch to edit mode. See Case Management Portal — My Events tab — Creating and subscribing to business events for information on your options in this form.

Debug an Event Definition

You may want to verify that the business event definition catches the correct event and initiates the correct action in response. To test the event definition, use the debugging features:

1. Select a work item to test with, and note its work item ID.
2. In the list of existing business event definitions, select a row, then click theicon in the Debug column to display the Debug form. Enter the work item ID in the Debug Info for Item field, and click Submit.
3. Perform an action on the work item that should be noticed by the event definition. For example, if the event definition is watching for a "create or update" event, advance the work item in its flow or update its data.
4. Click the Debug Log button to display the Event Debug Report.
5. If the event definition is correctly configured, and if the system performed an action on the selected work item that stimulates the event definition, an entry appears in this report.

For each row, the report displays the

• Event Definition ID
• Event Definition Name
• Event Object ID
• Work Item ID
• When the event was triggered
  

The Event Log 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.

For each recorded event, the log displays the following information:

Column	Description
Event Type	The log displays the event type, in the form pxAttachmentAdded or pxInstanceUpdated.
Event Name	The name of the event definition.
Event ID	The event ID, in the form pxEVENT-NNNNN.
Event Primary Class	The class of the work item triggering the event definition.
Work Object Updated	The ID of the work item updated.
Action Status	The result of the event: either Success or an error code.
Action Type	The action type generated. The options are pxCallFlow, pxNotifySubscribers, or pxCallActivity.
Action Rule	Lists the action rule used by the event definition.
Time of action execution	Indicates when the event definition generated its action.