|Oracle Workflow Developer's Guide|
Part Number B10284-02
To Create an Event Activity
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, Oracle Workflow Administrator's Guide.
Caution: Do not include colons ":" or leading/trailing spaces in your internal name.
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:
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.
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.
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.)
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.
To create an event activity attribute that references an item type attribute, select the referenced item type attribute in the navigator tree, and hold down your mouse select button as you drag the item type attribute to your event activity. The Default Value region is automatically set to Item Attribute and references the originating item attribute.
When you include an event activity as a node in a process, you can assign a value to the event activity attribute that is specific to that node. See: To Define Activity Attribute Values
Note: A Raise event activity also automatically sets the item type and item key for the current workflow process in the parameter list for the event message. If the event message is later received by another process, the Workflow Engine uses that item type and item key to automatically set the process that raised the event as the parent for the process that receives the event. See: SetItemParent, Oracle Workflow API Reference.
To Copy an Activity
Copyright © 2003 Oracle Corporation.
All rights reserved.