Optional: List the process templates to find the name
of the process you want to start. This step is optional if you
already know the name of the process.
ProcessTemplateData[] processTemplates = process.queryProcessTemplates
("PROCESS_TEMPLATE.EXECUTION_MODE =
PROCESS_TEMPLATE.EXECUTION_MODE.EXCECUTION_MODE_LONG_RUNNING",
"PROCESS_TEMPLATE.NAME",
new Integer(50),
(TimeZone)null);
The results are sorted
by name. The query returns an array containing the first 50 sorted templates
that can be started by the initiate method.
Start the process with an input message of the appropriate type. When you create the message, you must specify its message type name
so that the message definition is contained. If you specify a process-instance
name, it must not start with an underscore. If a process-instance name is
not specified, the process instance ID (PIID) in String format is used as
the name.
ProcessTemplateData template = processTemplates[0];
//create a message for the single starting receive activity
ClientObjectWrapper input = process.createMessage
(template.getID(),
template.getInputMessageTypeName());
DataObject myMessage = null;
if ( input.getObject()!= null && input.getObject() instanceof DataObject )
{
myMessage = (DataObject)input.getObject();
//set the strings in the message, for example, a customer name
myMessage.setString("CustomerName", "Smith");
}
//start the process
PIID piid = process.initiate(template.getName(), "CustomerOrder", input);
This action creates an instance, CustomerOrder,
and passes some customer data. When the process starts, the operation returns
the object ID of the new process instance to the caller.
The starter
of the process instance is set to the caller of the request. This person receives
a work item for the process instance. The process administrators, readers,
and editors of the process instance are determined and receive work items
for the process instance. The follow-on activity instances are determined.
These are started automatically or, if they are staff, receive, or pick activities,
work items are created for the potential owners.