This example creates a runtime task that uses an interface that
is part of the calling application. For example, the runtime task is created
in a Java snippet of a business process and uses an interface from the process
application.
Why and when to perform this task
The example runs only inside the context of the calling enterprise
application, for which the resources are loaded.
Steps for this task
- Access the ClientTaskFactory and create a resource set to contain
the definitions of the new task model.
ClientTaskFactory factory = ClientTaskFactory.newInstance();
// specify the context class loader so that following resources are found
ResourceSet resourceSet = factory.createResourceSet
( Thread.currentThread().getContextClassLoader() );
- Access the WSDL definition and the descriptions of your operations.
Specify the path within the containing package JAR file.
Definition definition = factory.loadWSDLDefinition( resourceSet,
"com/ibm/workflow/metaflow/interface.wsdl" );
PortType portType = definition.getPortType(
new QName( definition.getTargetNamespace(), "doItPT" ) );
Operation operation = portType.getOperation
("doIt", (String)null, (String)null);
- Create the EMF model of your new human task.
If you
are creating a task instance, a valid-from date (UTCDate) is not required.
TTask humanTask = factory.createTTask( resourceSet,
TTaskKinds.HTASK_LITERAL,
"TestTask",
new UTCDate( "2005-01-01T00:00:00" ),
"http://www.ibm.com/task/test/",
portType,
operation );
This
step initializes the properties of the task model with default values.
- Modify the properties of your human task model.
// use the methods from the com.ibm.wbit.tel package, for example,
humanTask.setBusinessRelevance( TBoolean, YES_LITERAL );
// retrieve the task factory to create or modify composite task elements
TaskFactory taskFactory = factory.getTaskFactory();
// specify escalation settings
TVerb verb = taskFactory.createTVerb();
verb.setName("John");
// create escalationReceiver and add verb
TEscalationReceiver escalationReceiver =
taskFactory.createTEscalationReceiver();
escalationReceiver.setVerb(verb);
// create escalation and add escalation receiver
TEscalation escalation = taskFactory.createTEscalation();
escalation.setEscalationReceiver(escalationReceiver);
- Create the task model that contains all the resource definitions.
TaskModel taskModel = ClientTaskFactory.createTaskModel( resourceSet );
- Validate the task model and correct any validation problems that
are found.
ValidationProblem[] validationProblems = taskModel.validate();
- Create the runtime task instance or template.
Use
the HumanTaskManagerService interface to create the task instance or the task
template. You must provide an application name that contains the data type
definitions so that they can be accessed.
- The following snippet creates a task instance:
task.createTask( taskModel, "WorkflowApplication", "HTM" );
- The following snippet creates a task template:
task.createTaskTemplate( taskModel, "WorkflowApplication" );
Result
If a runtime task instance is created, it can now be started. If
a runtime task template is created, you can now create task instances from
the template.