You can terminate a process instance by using the Java
API and web service API. When terminated, a process instance no
longer performs actions. One reason to terminate a process instance
is that it is no longer applicable. Assume, for example, that a
long-lived process requires a bank manager’s input. However, because
the bank manager is not available and cannot respond to the process instance,
the process instance keeps running while waiting for the bank manager’s
input. During that time period, a potential bank customer withdraws their
mortgage application, resulting in the bank manager’s input being
unnecessary. As a result, the process instance can be terminated.
Summary of steps
To terminate a process instance, perform the following
tasks:
Include project files.
Create a ProcessManager Client API object.
Terminate the process instance.
Include project files
Include necessary files into your development
project. If you are creating a client application by using Java,
include the necessary JAR files. If you are using web services,
make sure that you include the proxy files.
Create a ProcessManager Client API object
Before you can programmatically
terminate a process instance, you must create a ProcessManager object.
Terminate the process instance
To terminate a process instance,
ensure that it is a valid process instance. If you attempt to terminate
a process instance that does not exist or was previously terminated,
a run-time exception is generated. To successfully terminate a process
instance, you require the process invocation identifier that can
be obtained when invoking a long-lived process by using the Invocation
API.
Terminate a process instance by using the ProcessManager
API (Java):
Include project files
Include client JAR files,
such as adobe-workflow-client-sdk.jar, in your Java project’s class
path.
Create a ProcessManager Client API object
Create a ServiceClientFactory object that
contains connection properties.
Create a ProcessManager object by using
its constructor and passing a ServiceClientFactory object.
Terminate the process instance
Terminate a process
instance by invoking the ProcessManager object’s terminateProcess method
and passing a string value that specifies the process invocation
identifier value. This value can be obtained when invoking the process
by using the Invocation API.
Terminating process instances using the web service API
Terminate a process instance by using the ProcessManager
API (web service):
Include project files
Create a Microsoft
.NET client assembly that consumes the ProcessManager service WSDL.
To create a proxy object that lets you invoke its operations by using
Base64 encoding, specify this WSDL definition:
Using the Microsoft .NET client assembly, create a ProcessManagerService object
by invoking its default constructor.
Set the ProcessManagerService object’s Credentials data member
with a System.Net.NetworkCredential value that specifies
the user name and password value.
Terminate the process instance
Terminate a process
instance by invoking the ProcessManager object’s terminateProcess method
and passing a string value that specifies the process invocation
identifier value. This value can be obtained when invoking a process
by using the Invocation API.