Designer > Business Event Processing > Defining an Event in the Process Deployment Descriptor
  

Defining an Event in the Process Deployment Descriptor

Defining an Event in the Process Deployment Descriptor
If desired, you can define a process-specific event to be used in event processing. This type of event is based on a specific process activity or link. An event definition includes a BPEL object plus one or more life cycle states, such as executed or faulted, and can optionally include data from an indexed property that is available when the event occurs.
You define a process event in the Eventing tab of the Process Deployment Descriptor Editor.
Defining a process-related event is optional. If desired, you can use system-defined events. For details, see Using System-Defined Events.
To define a process-related event:
  1. 1. Create a new Process Deployment Descriptor, described in Creating a Process Deployment Descriptor File.
  2. 2. If desired, define one or more indexed properties. An indexed property of a process variable can be used in the definition of an event. For details, see Adding Indexed Properties.
  3. 3. Select the Eventing tab in the PDD Editor.
  4. 4. Select Add.
  5. 5. In the Event Definition dialog, type in a Service Name for an event. This is the name of the event-action service that responds to this event. See Creating an Event-Action BPEL Process.
  6. 6. In the Location picklist, select a BPEL object, such as an activity or link. For example select an activity: process/flow/extensionActivity/peopleActivity[@name='PlaceOrder']
  7. In the Location picklist, select a BPEL object, such as an activity or link.
    For convenience, select the Dialog button to open the Find Business Event Source dialog. This dialog displays named activities and links; that is, activities and links for which you replaced the generic label (such as receive or l2) with a meaningful name. Use wildcards to locate an activity or link name.
  8. 7. Select one or more activity states to trigger the event. For a description of states, see Activity States Event Properties Task States and Task Event Types. For example, select executed.
  9. 8. If desired, add a business property mapped to an existing index property. A business property allows you to return the data value that exists in a variable at the activity state selected for the event. For example, you can find all faulting processes where the customerId is 101. To add a business property:
    1. a. In the Business Properties panel, select Add.
    2. b. In the Indexed Properties column, select the pick arrow to select an indexed property created on the Indexed Properties tab of the PDD.
    3. c. In the Business Alias column, select Property Name and notice that the indexed property name appears.