org.imixs.workflow.engine.adapters

Class ParticipantAdapter

java.lang.Object

org.imixs.workflow.engine.adapters.ParticipantAdapter

All Implemented Interfaces:

Serializable, Adapter, GenericAdapter

@Named
public class ParticipantAdapter
extends Object
implements GenericAdapter, Serializable

The ParticipantHandler is a generic adapter class responsible to update the ACL and Owernship of a workitem. The CID Bean updates the following Items

• $writeAccess
• $readAccess
• $owner
• $participants

The read and write access for a workitem can be defined by the BPMN model with the ACL Properties of the Imixs-BPMN modeler.

By defining an CDI alternative an application can overwrite the behavior of this bean.

Version:

1.0.0

Author:

rsoika

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected WorkflowService	workflowService

Constructor Summary

Constructors

Constructor and Description
ParticipantAdapter() Default Constructor
ParticipantAdapter(WorkflowService workflowService) CDI Constructor to inject WorkflowService

Method Summary

Modifier and Type	Method and Description
ItemCollection	execute(ItemCollection document, ItemCollection event)
void	mergeFieldList(ItemCollection documentContext, List valueList, List<String> fieldList) This method merges the values of fieldList into valueList and test for duplicates.
void	mergeRoles(List valueList, List sourceList, ItemCollection documentContext) This method merges the role names from a SourceList into a valueList and removes duplicates.
void	setWorkflowService(WorkflowService workflowService)
List<?>	uniqueList(List<Object> valueList) This method removes duplicates and null values from a vector.
ItemCollection	updateACL(ItemCollection workitem, ItemCollection event, ItemCollection nextTask) This method updates the $readAccess and $writeAccess attributes of a WorkItem depending to the configuration of a Activity Entity.
ItemCollection	updateOwner(ItemCollection adocumentContext, ItemCollection adocumentActivity, ItemCollection nextTask) changes the $Owner attribute depending to the activityentity or processEntity The method prevents the field '$owner' of the documentcontext in case that $owner is part of the
ItemCollection	updateParticipants(ItemCollection workitem) Update the $PARTICIPANTS.

Methods inherited from class java.lang.Object

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

Field Detail

workflowService

protected WorkflowService workflowService

Constructor Detail

ParticipantAdapter

public ParticipantAdapter()

Default Constructor

ParticipantAdapter

@Inject
public ParticipantAdapter(WorkflowService workflowService)

CDI Constructor to inject WorkflowService

Parameters:

workflowService -

Method Detail

execute

public ItemCollection execute(ItemCollection document,
                              ItemCollection event)
                       throws AdapterException

Specified by:

execute in interface Adapter

Throws:

AdapterException

setWorkflowService

public void setWorkflowService(WorkflowService workflowService)

updateParticipants

public ItemCollection updateParticipants(ItemCollection workitem)

Update the $PARTICIPANTS.

Parameters:

workitem -

Returns:

updateACL

public ItemCollection updateACL(ItemCollection workitem,
                                ItemCollection event,
                                ItemCollection nextTask)
                         throws PluginException

This method updates the $readAccess and $writeAccess attributes of a WorkItem depending to the configuration of a Activity Entity. The method evaluates the new model flag keyupdateacl. If 'false' then acl will not be updated.

Throws:

PluginException

updateOwner

public ItemCollection updateOwner(ItemCollection adocumentContext,
                                  ItemCollection adocumentActivity,
                                  ItemCollection nextTask)
                           throws PluginException

changes the $Owner attribute depending to the activityentity or processEntity The method prevents the field '$owner' of the documentcontext in case that $owner is part of the

Throws:

PluginException

mergeFieldList

public void mergeFieldList(ItemCollection documentContext,
                           List valueList,
                           List<String> fieldList)

This method merges the values of fieldList into valueList and test for duplicates. If an entry of the fieldList is a single key value, than the values to be merged are read from the corresponding documentContext property e.g. 'namTeam' -> maps the values of the documentContext property 'namteam' into the valueList If an entry of the fieldList is in square brackets, than the comma separated elements are mapped into the valueList e.g. '[user1,user2]' - maps the values 'user1' and 'user2' int the valueList. Also Curly brackets are allowed '{user1,user2}'

Parameters:

valueList -

fieldList -

uniqueList

public List<?> uniqueList(List<Object> valueList)

This method removes duplicates and null values from a vector.

Parameters:

valueList - - list of elements

mergeRoles

public void mergeRoles(List valueList,
                       List sourceList,
                       ItemCollection documentContext)
                throws PluginException

This method merges the role names from a SourceList into a valueList and removes duplicates. The AddaptText event is fired so a client can adapt a role name.

Parameters:

valueList -

sourceList -

Throws:

PluginException