| Previous | Next |  | Contents | Index | Glossary

## To Create an Event Activity

1. Select the item type that you want to create an event for in the navigator tree, then choose New Event from the Edit menu. Define your event activity in the Activity property page that appears.

2. An event activity must have an Internal Name (all uppercase and no leading/trailing spaces) and a Display Name, which is the translatable name that appears in your process diagram. Use the description to provide an explanation about this activity.

> Attention: To update the internal name for an activity once it is defined, you must use a special SQL script called wfchact.sql. You should only use this script to correct errors in an activity's internal name during design time. Do not use this script to rename activities that are involved in running instances of processes. See: Wfchact.sql.

> Caution: Do not include colons ":" or leading/trailing spaces in your internal name.

3. Choose an icon that identifies your activity. You can use any icon, as long as the icon is stored in a .ico file, to symbolize the action of an activity. See: Adding Custom Icons to Oracle Workflow.

Choose Browse to view the icon files listed in the workflow icons subdirectory.

You can also drag and drop icon files from the Windows Explorer or File Manager onto an activity in your navigator tree to assign that icon to the activity.

4. Select the Event Action for the activity.

- Receive--Receive an event from the Business Event System.

- Raise--Raise an event to the Business Event System.

- Send--Send an event directly from one Event agent to another agent without re-raising the event to the Business Event System.

> Note: Depending on the event action you select, you may need to define item type attributes for some or all of the following event details:

- Event Name

- Event Key

- Event Message

- Event Data

- Out Agent

- To Agent

> When you include the event activity as a node in a process, you can use the item type attributes to specify where to store or retrieve the required event detail information for that node. The item type attributes that you use for event details must be associated with the same item type that the event activity itself is associated with. See: To Define an Item Type or Activity Attribute and To Define Event Details for an Event Node.

5. If you are defining a Receive event activity, you can optionally enter an Event Filter to specify the event that the activity can receive.

- To allow only a specified event for the activity, enter the full internal event name.

> Note: You can only specify an individual event as the event filter. The event filter cannot be an event group.

- To allow any event for the activity, leave the Event Filter field blank.

See: To Define an Event.

6. Enter an optional cost for the activity. For event activities with the event actions Raise or Send, you can use the cost to defer long running activities to a background engine. See: Activity Cost.

7. Choose Apply to save your changes.

8. Select the Details tab to display and modify the optional details of the activity. See: To Define Optional Activity Details.

9. Select the Roles tab page to specify the roles that have access to this function activity. (This functionality will be supported in a future release.)

10. Select the Access tab page to set the access levels allowed to modify this event. See: Allowing Access to an Object.

11. The event activity now appears beneath Events in the navigator tree. You can review or edit the properties of this activity at any time by double-clicking on the activity in the navigator tree or by selecting the activity and choosing Properties from the Edit menu or by pressing Enter on your keyboard.

### See Also

To Copy an Activity

| Previous | Next |  | Contents | Index | Glossary