de.aristaflow.adept2.core.worklistmanager

Interface DelegationHandling

public interface DelegationHandling

This interface supports user-defined delegation handling procedures. An implementing class is notified when a delegation is about to be performed. Based on the worklist item, the delegating client, the supervisors of the template and the instance and the initiator of the instance, a list of potential delegation recipients is created.
Each delegation handling procedure is identified by a (unique) name. This name is also found in the worklist items.
Since this interface does not need access other methods of the worklist manager, no SessionTokens are needed.

Author:

Ulrich Kreher

Method Summary

Modifier and Type	Method and Description
java.util.Set<QualifiedAgent>	getDelegationRecipients(WorklistItem item, QualifiedAgent delegatingAgent, QualifiedAgent templateSupervisor, QualifiedAgent instanceSupervisor, QualifiedAgent instanceInitiator, PolicyResolution orgModel) Gets a list of agents that the designated worklist item may be delegated to.
java.lang.String	getID() Gets the (unique) name of this delegation handling procedure to identify it as specified for a worklist item.

Method Detail

getID

java.lang.String getID()

Gets the (unique) name of this delegation handling procedure to identify it as specified for a worklist item.

Returns:

The (unique) name of this delegation handling procedure.

getDelegationRecipients

java.util.Set<QualifiedAgent> getDelegationRecipients(WorklistItem item,
                                                      QualifiedAgent delegatingAgent,
                                                      QualifiedAgent templateSupervisor,
                                                      QualifiedAgent instanceSupervisor,
                                                      QualifiedAgent instanceInitiator,
                                                      PolicyResolution orgModel)

Gets a list of agents that the designated worklist item may be delegated to. The decision may depend on the delegating agent, the supervisors of the template and the instance, the initiator of the instance as well as some arbitrary agent retrieved from the organisational model.

Parameters:

item - The worklist item to be delegated.

delegatingAgent - The agent who delegates the designated worklist item.

templateSupervisor - The supervisor of the process template which is referenced by the worklist item.

instanceSupervisor - The supervisor of the process instance which is referenced by the worklist item.

instanceInitiator - The initiator of the process instance which is referenced by the worklist item.

orgModel - The policy resolution of the organisational model manager the worklist manager uses to provide access to the organisational model.

Returns:

A collection of agents which the designated worklist item may be delegated to. This collection may be empty but must not be null.