org.imixs.workflow.engine.plugins

Class SplitAndJoinPlugin

java.lang.Object

org.imixs.workflow.engine.plugins.AbstractPlugin

org.imixs.workflow.engine.plugins.SplitAndJoinPlugin

All Implemented Interfaces:

Plugin

public class SplitAndJoinPlugin
extends AbstractPlugin

The Imixs Split&Join Plugin provides functionality to create and update sub-process instances from a workflow event in an origin process. It is also possible to update the origin process from the sub-process instance. The plugin evaluates the txtactivityResult and the items with the following names: subprocess_create = create a new subprocess assigned to the current workitem subprocess_update = update an existing subprocess assigned to the current workitem origin_update = update the origin process assigned to the current workitem A subprocess will contain the $UniqueID of the origin process stored in the property $uniqueidRef. The origin process will contain a link to the subprocess stored in the property txtworkitemRef. So both workitems are linked together.

Version:

1.0

Author:

Ralph Soika

See Also:

http://www.imixs.org/doc/engine/plugins/splitandjoinplugin.html

Field Summary

Fields

Modifier and Type	Field and Description
static String	INVALID_FORMAT
static String	LINK_PROPERTY
static String	ORIGIN_UPDATE
static String	SUBPROCESS_CREATE
static String	SUBPROCESS_UPDATE

Fields inherited from class org.imixs.workflow.engine.plugins.AbstractPlugin

INVALID_ITEMVALUE_FORMAT, INVALID_PROPERTYVALUE_FORMAT

Constructor Summary

Constructors

Constructor and Description
SplitAndJoinPlugin()

Method Summary

Modifier and Type	Method and Description
protected void	addWorkitemRef(String aUniqueID, ItemCollection workitem) This methods adds a new workItem reference into a workitem
protected void	copyItemList(String items, ItemCollection source, ItemCollection target) This Method copies the fields defined in 'items' into the targetWorkitem.
protected void	createSubprocesses(List<String> subProcessDefinitions, ItemCollection originWorkitem) This method expects a list of Subprocess definitions and create for each definition a new subprocess.
ItemCollection	run(ItemCollection adocumentContext, ItemCollection adocumentActivity) The method evaluates the workflow activity result for items with name: subprocess_create subprocess_update origin_update For each item a corresponding processing cycle will be started.
protected void	updateOrigin(String originProcessDefinition, ItemCollection subprocessWorkitem) This method expects a single process definitions to update the origin process for a subprocess.
protected void	updateSubprocesses(List<String> subProcessDefinitions, ItemCollection originWorkitem) This method expects a list of Subprocess definitions and updates each matching existing subprocess.

Methods inherited from class org.imixs.workflow.engine.plugins.AbstractPlugin

close, getCtx, getWorkflowService, init, mergeFieldList, uniqueList

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

LINK_PROPERTY

public static final String LINK_PROPERTY

See Also:

Constant Field Values

INVALID_FORMAT

public static final String INVALID_FORMAT

See Also:

Constant Field Values

SUBPROCESS_CREATE

public static final String SUBPROCESS_CREATE

See Also:

Constant Field Values

SUBPROCESS_UPDATE

public static final String SUBPROCESS_UPDATE

See Also:

Constant Field Values

ORIGIN_UPDATE

public static final String ORIGIN_UPDATE

See Also:

Constant Field Values

Constructor Detail

SplitAndJoinPlugin

public SplitAndJoinPlugin()

Method Detail

run

public ItemCollection run(ItemCollection adocumentContext,
                          ItemCollection adocumentActivity)
                   throws PluginException,
                          AccessDeniedException,
                          ProcessingErrorException

The method evaluates the workflow activity result for items with name: subprocess_create subprocess_update origin_update For each item a corresponding processing cycle will be started.

Throws:

@throws - ProcessingErrorException

AccessDeniedException

PluginException

ProcessingErrorException

createSubprocesses

protected void createSubprocesses(List<String> subProcessDefinitions,
                                  ItemCollection originWorkitem)
                           throws AccessDeniedException,
                                  ProcessingErrorException,
                                  PluginException,
                                  ModelException

This method expects a list of Subprocess definitions and create for each definition a new subprocess. The reference of the created subprocess will be stored in the property txtworkitemRef of the origin workitem The definition is expected in the following format 1.0.0 100 20 namTeam,_sub_data home Both workitems are connected to each other. The subprocess will contain the $UniqueID of the origin process stored in the property $uniqueidRef. The origin process will contain a link to the subprocess stored in the property txtworkitemRef. The tag 'action' is optional and allows to overwrite the action result evaluated by the ResultPlugin.

Parameters:

subProcessDefinitions -

originWorkitem -

Throws:

AccessDeniedException

ProcessingErrorException

PluginException

ModelException

updateSubprocesses

protected void updateSubprocesses(List<String> subProcessDefinitions,
                                  ItemCollection originWorkitem)
                           throws AccessDeniedException,
                                  ProcessingErrorException,
                                  PluginException,
                                  ModelException

This method expects a list of Subprocess definitions and updates each matching existing subprocess. The definition is expected in the following format (were regular expressions are allowed) 1.0.0 100 20 namTeam,_sub_data Subprocesses and the origin process are connected to each other. The subprocess will contain the $UniqueID of the origin process stored in the property $uniqueidRef. The origin process will contain a link to the subprocess stored in the property txtworkitemRef.

Parameters:

subProcessDefinitions -

originWorkitem -

Throws:

AccessDeniedException

ProcessingErrorException

PluginException

ModelException

updateOrigin

protected void updateOrigin(String originProcessDefinition,
                            ItemCollection subprocessWorkitem)
                     throws AccessDeniedException,
                            ProcessingErrorException,
                            PluginException,
                            ModelException

This method expects a single process definitions to update the origin process for a subprocess. The origin workitem will be loaded by the $uniqueidRef stored in the subprocess The processing definition for the origin process is expected in the following format 20 namTeam,_sub_data

Parameters:

originProcessDefinition -

subprocessWorkitem -

Throws:

AccessDeniedException

ProcessingErrorException

PluginException

ModelException

copyItemList

protected void copyItemList(String items,
                            ItemCollection source,
                            ItemCollection target)

This Method copies the fields defined in 'items' into the targetWorkitem. Multiple values are separated with comma ','. In case a item name contains '|' the target field name will become the right part of the item name.

addWorkitemRef

protected void addWorkitemRef(String aUniqueID,
                              ItemCollection workitem)

This methods adds a new workItem reference into a workitem