de.aristaflow.adept2.model.execution

Interface ExecutionFactory

public interface ExecutionFactory

To offer the possibility that each application can provide its own execution and termination context objects that fit the application's needs best a factory has to be provided that loads the corresponding implementations. This interface describes the methods to be implemented by the factory.

Author:

Andreas Lanz The factory is also used to create new EBPInstance objects.
Since executable business process instance objects themselves are never used the factory offers only methods to create the subclass objects ActivityInstance and LightWeightProcessInstance. The factory methods require all properties which belong directly to an EBP instance object., Martin Jurisch, Marco Waimer

Method Summary

Modifier and Type	Method and Description
ActivityConfiguration	createActivityConfiguration(Configuration configuration) Creates a new ActivityConfiguration based on the designated configuration, that is, the returned configuration contains the very same entries and no value will be retrieved from a parameter or the process configuration.
ActivityInstance	createActivityInstance(java.util.UUID id, java.lang.String processTypeName, java.lang.String processTemplateVersion, java.lang.String processTemplateName, java.lang.String processInstanceName, java.lang.String executableComponentDescriptionName, java.lang.String operationName, java.lang.String configurationSetName, java.lang.String activityName, java.lang.String name, java.lang.String description, java.lang.String implementationClass, java.util.Map<ActivityConstants.ActivityModelEntityType,java.util.List<java.lang.String>> separatedClassPaths, ClassLoaderUsage classLoaderUsage, byte[] systemComponentSignature, java.lang.String guiContextId, ExecutionControlProperties executionControlProperties, boolean supportsViewOnly, java.util.UUID iconId, java.util.Map<ActivityConstants.LocallyOverrideableActivityAttribute,ActivityConstants.ActivityModelEntityType> attributeOrigins, ActivityConfiguration configuration, java.util.Set<ProcessModelParameter> inputParameters, java.util.Set<ProcessModelParameter> outputParameters, ParameterDataContext attachedDataContext, java.lang.String groupName, java.lang.String groupExecutionContext, PluginDataContainer pluginData, java.util.Map<java.lang.String,java.lang.String> userAttributes) Creates an ActivityInstance object
Configuration	createConfigurationWrapper(Configuration configuration, java.lang.String id) Creates a new de.aristaflow.adept2.model.common.Configuration for the designated org.apache.commons.configuration2.Configuration which allows to merge process model configurations (for instance of activities) and runtime configurations (for instance from property files).
DecisionActivityInstance	createDecisionActivityInstance(ActivityInstance activityInstance, ProcessModelParameter decisionParameter, java.util.Collection<DecisionStatement> decisionStatements) Creates a DecisionActivityInstance object.
Enquiry	createEnquiry(QualifiedAgent originator, java.util.Set<QualifiedAgent> recipients, java.lang.String question) Create an Enquiry object.
Enquiry	createEnquiry(QualifiedAgent originator, java.util.Set<QualifiedAgent> recipients, java.lang.String question, java.lang.String reply, QualifiedAgent replier) Create an Enquiry object.
ExecutableInstance	createExecutableInstance(Instance instance) Creates a new ExecutableInstance from the given instance.
ExecutableInstance	createExecutableInstance(Instance instance, ExecutableInstance executableInstance) Creates a new ExecutableInstance from the given instance having the designated template and the additional attributes; additional with respect to the difference between a ChangeableInstance and an ExecutableInstance.
ExecutableInstance	createExecutableInstance(java.util.UUID instanceID, java.util.UUID logID, java.lang.String instanceName, boolean modified, java.util.UUID baseTemplateID, Template template, QualifiedAgent supervisorAgent, QualifiedAgent initiatorAgent, EBPInstanceReference parentReference, long creationTime, java.util.Map<java.lang.Integer,ProcessConstants.NodeState> nodeStates, java.util.Map<java.lang.Integer,ProcessConstants.ExecutionMode> executionModes, java.util.Map<java.lang.Integer,java.lang.Integer> nodeIterations, java.util.Map<java.lang.Integer,java.util.List<java.util.UUID>> nodeLWPInstanceIDs, java.util.Map<java.lang.Integer,QualifiedAgent> nodePerformingAgents, java.util.Map<java.lang.Integer,java.util.List<Enquiry>> currentEnquiries, java.util.Map<java.lang.Integer,Enquiry> repliedEnquiries, java.net.URI[] instanceTerminationCallbackURIs, java.util.Map<java.lang.Integer,java.net.URI[]> runtimeManagerURIs, java.util.Map<java.lang.String,java.util.Set<java.lang.String>> supportedPlugins, java.util.Map<java.lang.String,PluginData> pluginData, java.util.Map<java.lang.String,java.lang.String> userAttributes) Deprecated. Use createExecutableInstanceLwpIts(UUID, UUID, String, boolean, UUID, Template, QualifiedAgent, QualifiedAgent, EBPInstanceReference, long, Map, Map, Map, Map, Map, Map, Map, URI[], Map, Map, Map, Map) instead.
ExecutableInstance	createExecutableInstance(java.util.UUID instanceID, java.util.UUID logID, java.lang.String instanceName, boolean modified, java.util.UUID baseTemplateID, Template template, QualifiedAgent supervisorAgent, QualifiedAgent initiatorAgent, EBPInstanceReference parentReference, long creationTime, java.util.Map<java.lang.Integer,ProcessConstants.NodeState> nodeStates, java.util.Map<java.lang.Integer,ProcessConstants.ExecutionMode> executionModes, java.util.Map<java.lang.Integer,java.lang.Integer> nodeIterations, java.util.Map<java.lang.Integer,java.util.List<java.util.UUID>> nodeLWPInstanceIDs, java.util.Map<java.lang.Integer,QualifiedAgent> nodePerformingAgents, java.util.Map<java.lang.String,java.util.Set<java.lang.String>> supportedPlugins, java.util.Map<java.lang.String,PluginData> pluginData, java.util.Map<java.lang.String,java.lang.String> userAttributes) Deprecated. Use createExecutableInstanceLwpIts(UUID, UUID, String, boolean, UUID, Template, QualifiedAgent, QualifiedAgent, EBPInstanceReference, long, Map, Map, Map, Map, Map, Map, Map, Map) instead.
ExecutableInstance	createExecutableInstance(java.util.UUID instanceID, java.util.UUID logID, java.lang.String instanceName, java.util.UUID baseTemplateID, Template template, QualifiedAgent supervisorAgent, QualifiedAgent initiatorAgent, EBPInstanceReference parentReference, long creationTime) Creates a new executable instance without the need to specify all the details.
ExecutableInstance	createExecutableInstanceLwpIts(java.util.UUID instanceId, java.util.UUID logId, java.lang.String instanceName, boolean modified, java.util.UUID baseTemplateId, Template template, QualifiedAgent supervisorAgent, QualifiedAgent initiatorAgent, EBPInstanceReference parentReference, long creationTime, java.util.Map<java.lang.Integer,ProcessConstants.NodeState> nodeStates, java.util.Map<java.lang.Integer,ProcessConstants.ExecutionMode> executionModes, java.util.Map<java.lang.Integer,java.lang.Integer> nodeIterations, java.util.Map<java.lang.Integer,java.util.Map<java.lang.Integer,java.util.List<java.util.UUID>>> nodeLwpInstanceIds, java.util.Map<java.lang.Integer,QualifiedAgent> nodePerformingAgents, java.util.Map<java.lang.Integer,java.util.List<Enquiry>> currentEnquiries, java.util.Map<java.lang.Integer,Enquiry> repliedEnquiries, java.net.URI[] instanceTerminationCallbackUris, java.util.Map<java.lang.Integer,java.net.URI[]> runtimeManagerUris, java.util.Map<java.lang.String,java.util.Set<java.lang.String>> supportedPlugins, java.util.Map<java.lang.String,PluginData> pluginData, java.util.Map<java.lang.String,java.lang.String> userAttributes) Creates an ExecutableInstance object.
ExecutableInstance	createExecutableInstanceLwpIts(java.util.UUID instanceId, java.util.UUID logId, java.lang.String instanceName, boolean modified, java.util.UUID baseTemplateId, Template template, QualifiedAgent supervisorAgent, QualifiedAgent initiatorAgent, EBPInstanceReference parentReference, long creationTime, java.util.Map<java.lang.Integer,ProcessConstants.NodeState> nodeStates, java.util.Map<java.lang.Integer,ProcessConstants.ExecutionMode> executionModes, java.util.Map<java.lang.Integer,java.lang.Integer> nodeIterations, java.util.Map<java.lang.Integer,java.util.Map<java.lang.Integer,java.util.List<java.util.UUID>>> nodeLwpInstanceIds, java.util.Map<java.lang.Integer,QualifiedAgent> nodePerformingAgents, java.util.Map<java.lang.String,java.util.Set<java.lang.String>> supportedPlugins, java.util.Map<java.lang.String,PluginData> pluginData, java.util.Map<java.lang.String,java.lang.String> userAttributes) Creates an ExecutableInstance object.
LightWeightProcessInstance	createLightWeightProcessInstance(java.util.UUID templateId, java.lang.String processTypeName, java.lang.String processTemplateVersion, java.lang.String processTemplateName, java.lang.String processInstanceName, java.lang.String name, java.lang.String description, java.util.UUID iconId, ExecutionControlProperties executionControlProperties, Configuration configuration, java.util.Set<ProcessModelParameter> inputParameters, java.util.Set<ProcessModelParameter> outputParameters, ParameterDataContext dataContext, java.lang.String groupName, java.lang.String groupExecutionContext, PluginDataContainer pluginData, java.util.Map<java.lang.String,java.lang.String> userAttributes, boolean fork, boolean isEmbedded) Create a LightWeightProcessInstance object.
MergingConfiguration	createMergingConfiguration(Configuration initialConfiguration) Creates a new MergingConfiguration with the designated initial configuration.
ParameterDataContext	createParameterDataContext(java.util.Map<java.lang.String,ProcessConstants.AdeptDataType> types, java.util.Map<java.lang.String,java.io.Serializable> parameters) Create a ParameterDataContext object.
ExecutableBusinessProcessInstance	createTopLevelProcessInstance(java.util.UUID templateId, java.lang.String processTypeName, java.lang.String processTemplateVersion, java.lang.String processTemplateName, java.lang.String processInstanceName, java.lang.String name, java.lang.String description, java.util.UUID iconId, ExecutionControlProperties executionControlProperties, Configuration configuration, java.util.Set<ProcessModelParameter> inputParameters, java.util.Set<ProcessModelParameter> outputParameters, ParameterDataContext dataContext, java.lang.String groupName, java.lang.String groupExecutionContext, PluginDataContainer pluginData, java.util.Map<java.lang.String,PluginData> addPluginData, java.util.Map<java.lang.String,java.lang.String> userAttributes) Create a top-level process instance object.
ExecutableBusinessProcessInstance	createTopLevelProcessInstance(java.util.UUID templateId, java.lang.String processTypeName, java.lang.String processTemplateVersion, java.lang.String processTemplateName, java.lang.String processInstanceName, java.lang.String name, java.lang.String description, java.util.UUID iconId, ExecutionControlProperties executionControlProperties, Configuration configuration, java.util.Set<ProcessModelParameter> inputParameters, java.util.Set<ProcessModelParameter> outputParameters, ParameterDataContext dataContext, java.lang.String groupName, java.lang.String groupExecutionContext, PluginDataContainer pluginData, java.util.Map<java.lang.String,java.lang.String> userAttributes) Create a top-level process instance object.
ExecutionContext	getExecutionContext(QualifiedAgent agent, DataContainer dataContainer, java.util.Map<java.lang.String,java.util.Set<java.lang.String>> supportedPlugins, java.util.Map<java.lang.String,PluginData> pluginData, java.util.Map<java.lang.String,java.lang.String> userAttributes) Returns an execution context for a top-level instance its fields initialised with the provided values.
ExecutionContext	getExecutionContext(QualifiedAgent agent, ExecutableBusinessProcessInstance ebpInstance, DataContainer dataContainer, Enquiry currentEnquiry, Enquiry repliedEnquiry, java.util.Map<java.lang.String,java.util.Set<java.lang.String>> supportedPlugins, java.util.Map<java.lang.String,PluginData> pluginData, java.util.Map<java.lang.String,java.lang.String> userAttributes) Returns an application related execution context for production mode its fields initialised with the provided values.
ExecutionContext	getExecutionContext(QualifiedAgent agent, ExecutableBusinessProcessInstance ebpInstance, DataContainer dataContainer, ProcessConstants.ExecutionMode executionMode, boolean resume, Enquiry currentEnquiry, Enquiry repliedEnquiry, java.util.Map<java.lang.String,java.util.Set<java.lang.String>> supportedPlugins, java.util.Map<java.lang.String,PluginData> pluginData, java.util.Map<java.lang.String,java.lang.String> userAttributes) Returns an application related execution context its fields initialised with the provided values.

Method Detail

getExecutionContext

ExecutionContext getExecutionContext(QualifiedAgent agent,
                                     DataContainer dataContainer,
                                     java.util.Map<java.lang.String,java.util.Set<java.lang.String>> supportedPlugins,
                                     java.util.Map<java.lang.String,PluginData> pluginData,
                                     java.util.Map<java.lang.String,java.lang.String> userAttributes)

Returns an execution context for a top-level instance its fields initialised with the provided values.

Parameters:

agent - The agent starting the process instance.

dataContainer - The data container providing input (and later) output parameters.

supportedPlugins - Mapping from extensionPointID to pluginIDs. This may be null.

pluginData - Mapping from pluginID to plugin data. This may be null.

userAttributes - The user attributes of the instance. This may be null.

Returns:

The execution context implementation having the designated attributes.

getExecutionContext

ExecutionContext getExecutionContext(QualifiedAgent agent,
                                     ExecutableBusinessProcessInstance ebpInstance,
                                     DataContainer dataContainer,
                                     ProcessConstants.ExecutionMode executionMode,
                                     boolean resume,
                                     Enquiry currentEnquiry,
                                     Enquiry repliedEnquiry,
                                     java.util.Map<java.lang.String,java.util.Set<java.lang.String>> supportedPlugins,
                                     java.util.Map<java.lang.String,PluginData> pluginData,
                                     java.util.Map<java.lang.String,java.lang.String> userAttributes)

Returns an application related execution context its fields initialised with the provided values.

Parameters:

agent - The user agent

ebpInstance - The executable business process instance to execute

dataContainer - the related data container

executionMode - The mode of execution

resume - Whether to resume the execution of the activity.

currentEnquiry - The current enquiry

repliedEnquiry - The replied enquiry

supportedPlugins - Mapping from extensionPointID to pluginIDs. This may be null.

pluginData - Mapping from pluginID to plugin data. This may be null.

userAttributes - The user attributes of the instance. This may be null.

Returns:

The execution context implementation having the designated attributes.

getExecutionContext

ExecutionContext getExecutionContext(QualifiedAgent agent,
                                     ExecutableBusinessProcessInstance ebpInstance,
                                     DataContainer dataContainer,
                                     Enquiry currentEnquiry,
                                     Enquiry repliedEnquiry,
                                     java.util.Map<java.lang.String,java.util.Set<java.lang.String>> supportedPlugins,
                                     java.util.Map<java.lang.String,PluginData> pluginData,
                                     java.util.Map<java.lang.String,java.lang.String> userAttributes)

Returns an application related execution context for production mode its fields initialised with the provided values.

Parameters:

agent - the user agent

ebpInstance - the activity to execute

dataContainer - the related dataContainer

currentEnquiry - The current enquiry

repliedEnquiry - The replied enquiry

supportedPlugins - Mapping from extensionPointID to pluginIDs. This may be null.

pluginData - Mapping from pluginID to plugin data. This may be null.

userAttributes - The user attributes of the instance. This may be null.

Returns:

The execution context implementation having the designated attributes.

createExecutableInstance

@Deprecated
ExecutableInstance createExecutableInstance(java.util.UUID instanceID,
                                                        java.util.UUID logID,
                                                        java.lang.String instanceName,
                                                        boolean modified,
                                                        java.util.UUID baseTemplateID,
                                                        Template template,
                                                        QualifiedAgent supervisorAgent,
                                                        QualifiedAgent initiatorAgent,
                                                        EBPInstanceReference parentReference,
                                                        long creationTime,
                                                        java.util.Map<java.lang.Integer,ProcessConstants.NodeState> nodeStates,
                                                        java.util.Map<java.lang.Integer,ProcessConstants.ExecutionMode> executionModes,
                                                        java.util.Map<java.lang.Integer,java.lang.Integer> nodeIterations,
                                                        java.util.Map<java.lang.Integer,java.util.List<java.util.UUID>> nodeLWPInstanceIDs,
                                                        java.util.Map<java.lang.Integer,QualifiedAgent> nodePerformingAgents,
                                                        java.util.Map<java.lang.String,java.util.Set<java.lang.String>> supportedPlugins,
                                                        java.util.Map<java.lang.String,PluginData> pluginData,
                                                        java.util.Map<java.lang.String,java.lang.String> userAttributes)

Deprecated. Use createExecutableInstanceLwpIts(UUID, UUID, String, boolean, UUID, Template, QualifiedAgent, QualifiedAgent, EBPInstanceReference, long, Map, Map, Map, Map, Map, Map, Map, Map) instead.

Creates an ExecutableInstance object. This method resembles ProcessModelFactory.createInstance(UUID, UUID, String, boolean, UUID, Template, QualifiedAgent, QualifiedAgent, EBPInstanceReference, long, Map, Map, Map, Map, Map, Map, Map, Map).

Parameters:

instanceID - The logical ID of the instance. Instance.getID()

logID - The log ID of the instance. Instance.getLogID()

instanceName - The name of the instance. Instance.getName()

modified - Whether the instance is modified Instance.isModified()

baseTemplateID - The ID of the base template.

template - The underlying template of the instance. Instance.getTemplate()

supervisorAgent - The supervisor agent of the instance. Instance.getSupervisorAgent()

initiatorAgent - The initiator agent of the instance. Instance.getInitiatorAgent()

parentReference - The reference to the parent process (in case of a subprocess) Instance.getParentEBPReference()

creationTime - The creation time of the instance.

nodeStates - The node states of the instance nodes. Instance.getNodeState(int)

executionModes - The execution mode of the instance nodes. Instance.getExecutionMode(int)

nodeIterations - The iteration of the instance nodes. Instance.getNodeIteration(int)

nodeLWPInstanceIDs - The instanceIDs of the process started by the instance nodes. Instance.getNodeLWPInstanceID(int)

nodePerformingAgents - The performing agents of the instance nodes. Instance.getPerformingAgent(int)

supportedPlugins - Mapping from extensionPointID to pluginIDs.

pluginData - Mapping from pluginID to plugin data.

userAttributes - The user attributes of the instance.

Returns:

A new ExecutableInstance object.

createExecutableInstanceLwpIts

ExecutableInstance createExecutableInstanceLwpIts(java.util.UUID instanceId,
                                                  java.util.UUID logId,
                                                  java.lang.String instanceName,
                                                  boolean modified,
                                                  java.util.UUID baseTemplateId,
                                                  Template template,
                                                  QualifiedAgent supervisorAgent,
                                                  QualifiedAgent initiatorAgent,
                                                  EBPInstanceReference parentReference,
                                                  long creationTime,
                                                  java.util.Map<java.lang.Integer,ProcessConstants.NodeState> nodeStates,
                                                  java.util.Map<java.lang.Integer,ProcessConstants.ExecutionMode> executionModes,
                                                  java.util.Map<java.lang.Integer,java.lang.Integer> nodeIterations,
                                                  java.util.Map<java.lang.Integer,java.util.Map<java.lang.Integer,java.util.List<java.util.UUID>>> nodeLwpInstanceIds,
                                                  java.util.Map<java.lang.Integer,QualifiedAgent> nodePerformingAgents,
                                                  java.util.Map<java.lang.String,java.util.Set<java.lang.String>> supportedPlugins,
                                                  java.util.Map<java.lang.String,PluginData> pluginData,
                                                  java.util.Map<java.lang.String,java.lang.String> userAttributes)

Creates an ExecutableInstance object. This method resembles ProcessModelFactory.createInstanceLwpIts(UUID, UUID, String, boolean, UUID, Template, QualifiedAgent, QualifiedAgent, EBPInstanceReference, long, Map, Map, Map, Map, Map, Map, Map, Map) .

Parameters:

instanceId - The logical ID of the instance. Instance.getID()

logId - The log ID of the instance. Instance.getLogID()

instanceName - The name of the instance. Instance.getName()

modified - Whether the instance is modified Instance.isModified()

baseTemplateId - The ID of the base template.

template - The underlying template of the instance. Instance.getTemplate()

supervisorAgent - The supervisor agent of the instance. Instance.getSupervisorAgent()

initiatorAgent - The initiator agent of the instance. Instance.getInitiatorAgent()

parentReference - The reference to the parent process (in case of a subprocess) Instance.getParentEBPReference()

creationTime - The creation time of the instance.

nodeStates - The node states of the instance nodes. Instance.getNodeState(int)

executionModes - The execution mode of the instance nodes. Instance.getExecutionMode(int)

nodeIterations - The iteration of the instance nodes. Instance.getNodeIteration(int)

nodeLwpInstanceIds - The instanceIDs of the process started by the instance nodes provided for each node and each iteration. Instance.getNodeLWPInstanceID(int, int)

nodePerformingAgents - The performing agents of the instance nodes. Instance.getPerformingAgent(int)

supportedPlugins - Mapping from extensionPointID to pluginIDs.

pluginData - Mapping from pluginID to plugin data.

userAttributes - The user attributes of the instance.

Returns:

A new ExecutableInstance object.

createExecutableInstance

@Deprecated
ExecutableInstance createExecutableInstance(java.util.UUID instanceID,
                                                        java.util.UUID logID,
                                                        java.lang.String instanceName,
                                                        boolean modified,
                                                        java.util.UUID baseTemplateID,
                                                        Template template,
                                                        QualifiedAgent supervisorAgent,
                                                        QualifiedAgent initiatorAgent,
                                                        EBPInstanceReference parentReference,
                                                        long creationTime,
                                                        java.util.Map<java.lang.Integer,ProcessConstants.NodeState> nodeStates,
                                                        java.util.Map<java.lang.Integer,ProcessConstants.ExecutionMode> executionModes,
                                                        java.util.Map<java.lang.Integer,java.lang.Integer> nodeIterations,
                                                        java.util.Map<java.lang.Integer,java.util.List<java.util.UUID>> nodeLWPInstanceIDs,
                                                        java.util.Map<java.lang.Integer,QualifiedAgent> nodePerformingAgents,
                                                        java.util.Map<java.lang.Integer,java.util.List<Enquiry>> currentEnquiries,
                                                        java.util.Map<java.lang.Integer,Enquiry> repliedEnquiries,
                                                        java.net.URI[] instanceTerminationCallbackURIs,
                                                        java.util.Map<java.lang.Integer,java.net.URI[]> runtimeManagerURIs,
                                                        java.util.Map<java.lang.String,java.util.Set<java.lang.String>> supportedPlugins,
                                                        java.util.Map<java.lang.String,PluginData> pluginData,
                                                        java.util.Map<java.lang.String,java.lang.String> userAttributes)

Deprecated. Use createExecutableInstanceLwpIts(UUID, UUID, String, boolean, UUID, Template, QualifiedAgent, QualifiedAgent, EBPInstanceReference, long, Map, Map, Map, Map, Map, Map, Map, URI[], Map, Map, Map, Map) instead.

Creates an ExecutableInstance object. This method is used for the xml import of an executable instance.

Parameters:

instanceID - The logical ID of the instance. Instance.getID()

logID - The log ID of the instance. Instance.getLogID()

instanceName - The name of the instance. Instance.getName()

modified - Whether the instance is modified Instance.isModified()

baseTemplateID - The ID of the base template.

template - The underlying template of the instance. Instance.getTemplate()

supervisorAgent - The supervisor agent of the instance. Instance.getSupervisorAgent()

initiatorAgent - The initiator agent of the instance. Instance.getInitiatorAgent()

parentReference - The reference to the parent process (in case of a subprocess) Instance.getParentEBPReference()

creationTime - The creation time of the instance.

nodeStates - The node states of the instance nodes. Instance.getNodeState(int)

executionModes - The execution mode of the instance nodes. Instance.getExecutionMode(int)

nodeIterations - The iteration of the instance nodes. Instance.getNodeIteration(int)

nodeLWPInstanceIDs - The instanceIDs of the process started by the instance nodes. Instance.getNodeLWPInstanceID(int)

nodePerformingAgents - The performing agents of the instance nodes. Instance.getPerformingAgent(int)

currentEnquiries - The current enquiries of the instance nodes.

repliedEnquiries - The replied enquiries of the instance nodes.

instanceTerminationCallbackURIs - The instance termination callback URIs of the instance.

runtimeManagerURIs - The runtime manager URIs of the instance nodes.

supportedPlugins - Mapping from extensionPointID to pluginIDs.

pluginData - Mapping from pluginID to plugin data.

userAttributes - The user attributes of the instance.

Returns:

A new ExecutableInstance object.

createExecutableInstanceLwpIts

ExecutableInstance createExecutableInstanceLwpIts(java.util.UUID instanceId,
                                                  java.util.UUID logId,
                                                  java.lang.String instanceName,
                                                  boolean modified,
                                                  java.util.UUID baseTemplateId,
                                                  Template template,
                                                  QualifiedAgent supervisorAgent,
                                                  QualifiedAgent initiatorAgent,
                                                  EBPInstanceReference parentReference,
                                                  long creationTime,
                                                  java.util.Map<java.lang.Integer,ProcessConstants.NodeState> nodeStates,
                                                  java.util.Map<java.lang.Integer,ProcessConstants.ExecutionMode> executionModes,
                                                  java.util.Map<java.lang.Integer,java.lang.Integer> nodeIterations,
                                                  java.util.Map<java.lang.Integer,java.util.Map<java.lang.Integer,java.util.List<java.util.UUID>>> nodeLwpInstanceIds,
                                                  java.util.Map<java.lang.Integer,QualifiedAgent> nodePerformingAgents,
                                                  java.util.Map<java.lang.Integer,java.util.List<Enquiry>> currentEnquiries,
                                                  java.util.Map<java.lang.Integer,Enquiry> repliedEnquiries,
                                                  java.net.URI[] instanceTerminationCallbackUris,
                                                  java.util.Map<java.lang.Integer,java.net.URI[]> runtimeManagerUris,
                                                  java.util.Map<java.lang.String,java.util.Set<java.lang.String>> supportedPlugins,
                                                  java.util.Map<java.lang.String,PluginData> pluginData,
                                                  java.util.Map<java.lang.String,java.lang.String> userAttributes)

Creates an ExecutableInstance object. This method is used for the xml import of an executable instance.

Parameters:

instanceId - The logical ID of the instance. Instance.getID()

logId - The log ID of the instance. Instance.getLogID()

instanceName - The name of the instance. Instance.getName()

modified - Whether the instance is modified Instance.isModified()

baseTemplateId - The ID of the base template.

template - The underlying template of the instance. Instance.getTemplate()

supervisorAgent - The supervisor agent of the instance. Instance.getSupervisorAgent()

initiatorAgent - The initiator agent of the instance. Instance.getInitiatorAgent()

parentReference - The reference to the parent process (in case of a subprocess) Instance.getParentEBPReference()

creationTime - The creation time of the instance.

nodeStates - The node states of the instance nodes. Instance.getNodeState(int)

executionModes - The execution mode of the instance nodes. Instance.getExecutionMode(int)

nodeIterations - The iteration of the instance nodes. Instance.getNodeIteration(int)

nodeLwpInstanceIds - The instanceIDs of the process started by the instance nodes provided for each node and each iteration. Instance.getNodeLWPInstanceID(int, int)

nodePerformingAgents - The performing agents of the instance nodes. Instance.getPerformingAgent(int)

currentEnquiries - The current enquiries of the instance nodes.

repliedEnquiries - The replied enquiries of the instance nodes.

instanceTerminationCallbackUris - The instance termination callback URIs of the instance.

runtimeManagerUris - The runtime manager URIs of the instance nodes.

supportedPlugins - Mapping from extensionPointID to pluginIDs.

pluginData - Mapping from pluginID to plugin data.

userAttributes - The user attributes of the instance.

Returns:

A new ExecutableInstance object.

createExecutableInstance

ExecutableInstance createExecutableInstance(java.util.UUID instanceID,
                                            java.util.UUID logID,
                                            java.lang.String instanceName,
                                            java.util.UUID baseTemplateID,
                                            Template template,
                                            QualifiedAgent supervisorAgent,
                                            QualifiedAgent initiatorAgent,
                                            EBPInstanceReference parentReference,
                                            long creationTime)

Creates a new executable instance without the need to specify all the details.

Parameters:

instanceID - The ID of the instance to be created.

logID - The log ID of the instance to be created.

instanceName - The name of the instance to be created.

baseTemplateID - The ID of the base template.

template - The template the created instance is based on.

supervisorAgent - The supervisor of the created instance.

initiatorAgent - The agent who started/created the instance.

parentReference - If the instance to create is a subprocess instance it expects the reference to the activity the subprocess instance is assigned to, otherwise it expects NULL.

creationTime - The creation time of the instance.

Returns:

A new ExecutableInstance object.

createExecutableInstance

ExecutableInstance createExecutableInstance(Instance instance)

Creates a new ExecutableInstance from the given instance.
Note that you will loose information when calling this method for replacing an ExecutableInstance! If you have an old executable instance for the designated instance, use createExecutableInstance(Instance, ExecutableInstance).

Parameters:

instance - the instance form which the executable instance is to be created from

Returns:

A new ExecutableInstance object.

createExecutableInstance

ExecutableInstance createExecutableInstance(Instance instance,
                                            ExecutableInstance executableInstance)

Creates a new ExecutableInstance from the given instance having the designated template and the additional attributes; additional with respect to the difference between a ChangeableInstance and an ExecutableInstance.

Parameters:

instance - The instance form which the executable instance is to be created from

executableInstance - The executable instance that contains the additional attributes of an ExecutableInstance a normal instance does not provide.

Returns:

A new ExecutableInstance object.

createActivityInstance

ActivityInstance createActivityInstance(java.util.UUID id,
                                        java.lang.String processTypeName,
                                        java.lang.String processTemplateVersion,
                                        java.lang.String processTemplateName,
                                        java.lang.String processInstanceName,
                                        java.lang.String executableComponentDescriptionName,
                                        java.lang.String operationName,
                                        java.lang.String configurationSetName,
                                        java.lang.String activityName,
                                        java.lang.String name,
                                        java.lang.String description,
                                        java.lang.String implementationClass,
                                        java.util.Map<ActivityConstants.ActivityModelEntityType,java.util.List<java.lang.String>> separatedClassPaths,
                                        ClassLoaderUsage classLoaderUsage,
                                        byte[] systemComponentSignature,
                                        java.lang.String guiContextId,
                                        ExecutionControlProperties executionControlProperties,
                                        boolean supportsViewOnly,
                                        java.util.UUID iconId,
                                        java.util.Map<ActivityConstants.LocallyOverrideableActivityAttribute,ActivityConstants.ActivityModelEntityType> attributeOrigins,
                                        ActivityConfiguration configuration,
                                        java.util.Set<ProcessModelParameter> inputParameters,
                                        java.util.Set<ProcessModelParameter> outputParameters,
                                        ParameterDataContext attachedDataContext,
                                        java.lang.String groupName,
                                        java.lang.String groupExecutionContext,
                                        PluginDataContainer pluginData,
                                        java.util.Map<java.lang.String,java.lang.String> userAttributes)

Creates an ActivityInstance object

Parameters:

id -

processTypeName - The name of the process type of the activity.

processTemplateVersion - The logical version of the process template of the activity. This may be null.

name - The name of the activity template. ExecutableBusinessProcessInstance.getName()

inputParameters - The input parameters of the activity template.

outputParameters - The output parameters of the activity template.

executionControlProperties - The execution control properties ExecutableBusinessProcessInstance.getExecutionControlProperties()

operationName - The name of the application operation the activity instance represents. AbstractActivity.getOperationName()

userAttributes - User defined Attributes for the activity instance.

description - The description of the activity instance. ExecutableBusinessProcessInstance.getDescription()

guiContextId - The GUI context for the activity instance AbstractActivity.getGUIContextID()

pluginData - Mapping from pluginID to plugin data

processInstanceName - The process instance name

processTemplateName - The process template name ExecutableBusinessProcessInstance.getProcessTemplateName()

executableComponentDescriptionName -

configurationSetName -

activityName -

implementationClass -

separatedClassPaths -

classLoaderUsage -

systemComponentSignature -

supportsViewOnly - The support view only flag

iconId -

attributeOrigins -

configuration -

attachedDataContext -

groupName - The name of the group ExecutableBusinessProcessInstance.getGroupName().

groupExecutionContext - The execution context of the group ExecutableBusinessProcessInstance.getGroupExecutionContext().

Returns:

A new ActivityInstance object.

createDecisionActivityInstance

DecisionActivityInstance createDecisionActivityInstance(ActivityInstance activityInstance,
                                                        ProcessModelParameter decisionParameter,
                                                        java.util.Collection<DecisionStatement> decisionStatements)

Creates a DecisionActivityInstance object.

Parameters:

activityInstance - The superior activity instance that contains the standard data for the decision activity instance ActivityInstance

decisionParameter - The decision parameter of the decision activity instance DecisionActivityInstance.getDecisionParameter()

decisionStatements - The decision statements of the decision activity instance DecisionActivityInstance.getDecisionStatements()

Returns:

A new DecisionActivityInstance object

createLightWeightProcessInstance

LightWeightProcessInstance createLightWeightProcessInstance(java.util.UUID templateId,
                                                            java.lang.String processTypeName,
                                                            java.lang.String processTemplateVersion,
                                                            java.lang.String processTemplateName,
                                                            java.lang.String processInstanceName,
                                                            java.lang.String name,
                                                            java.lang.String description,
                                                            java.util.UUID iconId,
                                                            ExecutionControlProperties executionControlProperties,
                                                            Configuration configuration,
                                                            java.util.Set<ProcessModelParameter> inputParameters,
                                                            java.util.Set<ProcessModelParameter> outputParameters,
                                                            ParameterDataContext dataContext,
                                                            java.lang.String groupName,
                                                            java.lang.String groupExecutionContext,
                                                            PluginDataContainer pluginData,
                                                            java.util.Map<java.lang.String,java.lang.String> userAttributes,
                                                            boolean fork,
                                                            boolean isEmbedded)

Create a LightWeightProcessInstance object.

Parameters:

templateId - The references template ID of the lightweight process instance. LightWeightProcessInstance.getTemplateID()

processTypeName - The name of the process type of the activity.

processTemplateVersion - The logical version of the process template of the activity. This may be null.

name - The name of the lightweight process instance. ExecutableBusinessProcessInstance.getName()

executionControlProperties - the execution control properties ExecutableBusinessProcessInstance.getExecutionControlProperties()

description - the description of the light weight process instance. ExecutableBusinessProcessInstance.getDescription()

inputParameters - The input parameters of the lightweight process instance. ExecutableBusinessProcessInstance.getParameters(de.aristaflow.adept2.model.globals.ActivityConstants.AccessType READ)

outputParameters - The output parameters of the lightweight process instance. ExecutableBusinessProcessInstance.getParameters(de.aristaflow.adept2.model.globals.ActivityConstants.AccessType WRITE)

userAttributes - User defined Attributes for the lightweight process instance.

dataContext - The input data context for the lightweight process instance. ExecutableBusinessProcessInstance.getAttachedDataContext()

processInstanceName - The process instance name ExecutableBusinessProcessInstance.getProcessInstanceName()

processTemplateName - The process template name ExecutableBusinessProcessInstance.getProcessTemplateName()

iconId -

configuration -

groupName - The name of the group ExecutableBusinessProcessInstance.getGroupName().

groupExecutionContext - The execution context of the group ExecutableBusinessProcessInstance.getGroupExecutionContext().

pluginData -

fork - Whether the process will be started as fork.

isEmbedded - Whether the process is embedded. LightWeightProcessInstance.isEmbedded()

Returns:

A new LightWeightProcessInstance object.

createTopLevelProcessInstance

ExecutableBusinessProcessInstance createTopLevelProcessInstance(java.util.UUID templateId,
                                                                java.lang.String processTypeName,
                                                                java.lang.String processTemplateVersion,
                                                                java.lang.String processTemplateName,
                                                                java.lang.String processInstanceName,
                                                                java.lang.String name,
                                                                java.lang.String description,
                                                                java.util.UUID iconId,
                                                                ExecutionControlProperties executionControlProperties,
                                                                Configuration configuration,
                                                                java.util.Set<ProcessModelParameter> inputParameters,
                                                                java.util.Set<ProcessModelParameter> outputParameters,
                                                                ParameterDataContext dataContext,
                                                                java.lang.String groupName,
                                                                java.lang.String groupExecutionContext,
                                                                PluginDataContainer pluginData,
                                                                java.util.Map<java.lang.String,java.lang.String> userAttributes)

Create a top-level process instance object.

Parameters:

templateId -

processTypeName -

processTemplateVersion -

processTemplateName -

processInstanceName -

name -

description -

iconId -

executionControlProperties -

configuration -

inputParameters -

outputParameters -

dataContext -

groupName - The name of the group ExecutableBusinessProcessInstance.getGroupName().

groupExecutionContext - The execution context of the group ExecutableBusinessProcessInstance.getGroupExecutionContext().

pluginData -

userAttributes -

Returns:

A new top-level process instance object.

createTopLevelProcessInstance

ExecutableBusinessProcessInstance createTopLevelProcessInstance(java.util.UUID templateId,
                                                                java.lang.String processTypeName,
                                                                java.lang.String processTemplateVersion,
                                                                java.lang.String processTemplateName,
                                                                java.lang.String processInstanceName,
                                                                java.lang.String name,
                                                                java.lang.String description,
                                                                java.util.UUID iconId,
                                                                ExecutionControlProperties executionControlProperties,
                                                                Configuration configuration,
                                                                java.util.Set<ProcessModelParameter> inputParameters,
                                                                java.util.Set<ProcessModelParameter> outputParameters,
                                                                ParameterDataContext dataContext,
                                                                java.lang.String groupName,
                                                                java.lang.String groupExecutionContext,
                                                                PluginDataContainer pluginData,
                                                                java.util.Map<java.lang.String,PluginData> addPluginData,
                                                                java.util.Map<java.lang.String,java.lang.String> userAttributes)

Create a top-level process instance object.

Parameters:

templateId -

processTypeName -

processTemplateVersion -

processTemplateName -

processInstanceName -

name -

description -

iconId -

executionControlProperties -

configuration -

inputParameters -

outputParameters -

dataContext -

groupName - The name of the group ExecutableBusinessProcessInstance.getGroupName().

groupExecutionContext - The execution context of the group ExecutableBusinessProcessInstance.getGroupExecutionContext().

pluginData -

addPluginData -

userAttributes -

Returns:

A new top-level process instance object.

createParameterDataContext

ParameterDataContext createParameterDataContext(java.util.Map<java.lang.String,ProcessConstants.AdeptDataType> types,
                                                java.util.Map<java.lang.String,java.io.Serializable> parameters)

Create a ParameterDataContext object.

Parameters:

types - A mapping from a parameter name to a data type.

parameters - A mapping from a parameter name to a parameter value.

Returns:

A new ParameterDataContext object.

createEnquiry

Enquiry createEnquiry(QualifiedAgent originator,
                      java.util.Set<QualifiedAgent> recipients,
                      java.lang.String question)

Create an Enquiry object.

Parameters:

originator - The initiator of the enquiry.

recipients - The recipients of the enquiry.

question - The reason for the enquiry.

Returns:

An enquiry object that is initialised with the given parameters.

createEnquiry

Enquiry createEnquiry(QualifiedAgent originator,
                      java.util.Set<QualifiedAgent> recipients,
                      java.lang.String question,
                      java.lang.String reply,
                      QualifiedAgent replier)

Create an Enquiry object.

Parameters:

originator - The initiator of the enquiry.

recipients - The recipients of the enquiry.

question - The reason for the enquiry.

reply - The reply for the enquiry.

replier - The agent that replied the enquiry.

Returns:

An enquiry object that is initialised with the given parameters.

createConfigurationWrapper

Configuration createConfigurationWrapper(Configuration configuration,
                                         java.lang.String id)

Creates a new de.aristaflow.adept2.model.common.Configuration for the designated org.apache.commons.configuration2.Configuration which allows to merge process model configurations (for instance of activities) and runtime configurations (for instance from property files).

Parameters:

configuration - The org.apache.commons.configuration2.Configuration to be wrapped by a de.aristaflow.adept2.model.common.Configuration.

id - The ID of this configuration for usage in check reports.

Returns:

A new de.aristaflow.adept2.model.common.Configuration wrapping the designated org.apache.commons.configuration2.Configuration.

createMergingConfiguration

MergingConfiguration createMergingConfiguration(Configuration initialConfiguration)

Creates a new MergingConfiguration with the designated initial configuration.

Parameters:

initialConfiguration - The initial configuration for the created MergingConfiguration. This must not be null.

Returns:

A new MergingConfiguration with the designated initial configuration

createActivityConfiguration

ActivityConfiguration createActivityConfiguration(Configuration configuration)

Creates a new ActivityConfiguration based on the designated configuration, that is, the returned configuration contains the very same entries and no value will be retrieved from a parameter or the process configuration.

Parameters:

configuration - The configuration to convert to an activity configuration. This must not be null.

Returns:

A new ActivityConfiguration based on the designated configuration.