Oracle Workflow Guide
Release 2.6.2

Part Number A95265-02
Previous Next       Contents Index Glossary
         Previous  Next          Contents  Index  Glossary

AbortProcess

PL/SQL Syntax

procedure AbortProcess

    (itemtype in varchar2,
     itemkey in varchar2,
     process in varchar2 default '',
     result in varchar2 default eng_force);

Java Syntax

public static boolean abortProcess

    (WFContext wCtx,
     String itemType,
     String itemKey,
     String process,
     String result)

Description

Aborts process execution and cancels outstanding notifications. The process status is considered COMPLETE, with a result specified by the result argument. Also, any outstanding notifications or subprocesses are set to a status of COMPLETE with a result of force, regardless of the result argument.

Arguments (input)

wCtx Workflow context information. Required for the Java method only. See: Oracle Workflow Context.
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. See: CreateProcess.
process An optional argument that allows the selection of a particular subprocess for that item type. Provide the process activity's label name. If the process activity label name does not uniquely identify the subprocess you can precede the label name with the internal name of its parent process. For example, <parent_process_internal_name>:<label_name>. If this argument is null, the top level process for the item is aborted. This argument defaults to null.
result A status assigned to the aborted process. The result must be one of the values defined in the process Result Type, or one of the following standard engine values:
eng_exception
eng_timeout
eng_force
eng_mail
eng_null
This argument defaults to "eng_force".
Example

The following code excerpt shows an example of how to call abortProcess() in a Java program. The example code is from the WFTest.java program.

// abort process, should see status COMPLETE with result 
// code force
System.out.println("Abort Process ..." + iType + "/" + 
    iKey);
if (!WFEngineAPI.abortProcess(ctx, iType, iKey, pr, null))
{
  System.out.println("Seemed to have problem aborting...");
  WFEngineAPI.showError(ctx);
}


         Previous  Next          Contents  Index  Glossary


Oracle
Copyright © 2002 Oracle Corporation.

All Rights Reserved.