| Oracle Workflow API Reference Release 2.6.3 Part Number B10286-02 |
|
|
|
|
| ||
| Previous | Next | Contents | Index | Glossary |
procedure CompleteActivityInternalName
(itemtype in varchar2,
itemkey in varchar2,
activity in varchar2,
result in varchar2);
Description
Notifies the Workflow Engine that the specified activity has been completed for a particular item. This procedure requires that the activity currently has a status of 'Notified'. An optional activity completion result can also be passed. The result can determine what transition the process takes next.
CompleteActivityInternalName() is similar to CompleteActivity() except that CompleteActivityInternalName() identifies the activity to be completed by the activity's internal name, while CompleteActivity() identifies the activity by the activity node label name. You should only use CompleteActivityInternalName() when you do not know the activity node label name. If you do know the activity node label name, use CompleteActivity() instead. See: CompleteActivity.
Note: Unlike CompleteActivity(), you cannot use CompleteActivityInternalName() to start a process. Also, you cannot use CompleteActivityInternalName() with a synchronous process.
When CompleteActivityInternalName() is executed, there must be exactly one instance of the specified activity with a status of 'Notified'. If there are multiple instances of the activity with 'Notified' statuses, the process enters an 'ERROR' state.
Arguments (input)
| itemtype | A valid item type. |
| itemkey | A string generated from the application object's primary key. The string uniquely identifies the item within an item type. The item type and key together identify the process. |
| activity | The internal name of the activity that is completed. If the activity internal name does not uniquely identify the subprocess you can precede the activity internal name with the internal name of its parent process. For example, <parent_process_internal_name>:<activity_internal_ name>. |
| result | An optional activity completion result. Possible values are determined by the process activity's Result Type, or one of the engine standard results. See: AbortProcess. |
| Previous | Next | Contents | Index | Glossary |
