Package org.camunda.automator.bpmnengine.camunda7

Class BpmnEngineCamunda7

java.lang.Object

org.camunda.automator.bpmnengine.camunda7.BpmnEngineCamunda7

All Implemented Interfaces:

BpmnEngine

public class BpmnEngineCamunda7
extends Object
implements BpmnEngine

connection to a Camunda 7 server. This is one object created by the engine, and then one "init() " call. After, all methods are call in a multi-threads environment

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	BpmnEngineCamunda7.ExternalCallBack	Call back asynchronous

Nested classes/interfaces inherited from interface org.camunda.automator.bpmnengine.BpmnEngine

BpmnEngine.ProcessDescription, BpmnEngine.RegisteredTask, BpmnEngine.TaskDescription

Field Summary

Fields

Modifier and Type	Field	Description
static final int	SEARCH_MAX_SIZE

Constructor Summary

Constructors

Constructor	Description
BpmnEngineCamunda7(String serverUrl, String userName, String password, boolean logDebug)	P
BpmnEngineCamunda7(ConfigurationBpmEngine engineConfiguration, ConfigurationBpmEngine.BpmnServerDefinition serverDefinition)

Method Summary

Modifier and Type	Method	Description
void	connection()
long	countNumberOfProcessInstancesCreated(String processName, io.camunda.operate.search.DateFilter startDate, io.camunda.operate.search.DateFilter endDate)
long	countNumberOfProcessInstancesEnded(String processName, io.camunda.operate.search.DateFilter startDate, io.camunda.operate.search.DateFilter endDate)
long	countNumberOfTasks(String processId, String taskId)
String	createProcessInstance(String processId, String starterEventId, Map<String,Object> variables)
String	deployBpmn(File processFile, ScenarioDeployment.Policy policy)	Deploy a BPMN file (may contains multiple processes)
void	disconnection()
void	endProcessInstance(String processInstanceId, boolean cleanAll)	we finish with this processinstanceid, engine can clean it
void	executeServiceTask(String serviceTaskId, String userId, Map<String,Object> variables)	Execute a service task
void	executeUserTask(String userTaskId, String userId, Map<String,Object> variables)
String	getSignature()	return the signature of the engine, to log it for example
ConfigurationBpmEngine.CamundaEngine	getTypeCamundaEngine()
Map<String,Object>	getVariables(String processInstanceId)	Get variables of a process instanceId
int	getWorkerExecutionThreads()
void	init()	init the engine.
boolean	isReady()	Engine is ready.
BpmnEngine.RegisteredTask	registerServiceTask(String workerId, String topic, Duration lockTime, Object jobHandler, FixedBackoffSupplier backoffSupplier)
List<BpmnEngine.ProcessDescription>	searchProcessInstanceByVariable(String processId, Map<String,Object> filterVariables, int maxResult)	Search process instance by a variable content
List<String>	searchServiceTasks(String processInstanceId, String serviceTaskId, String topic, int maxResult)	Search service task
List<BpmnEngine.TaskDescription>	searchTasksByProcessInstanceId(String processInstanceId, String taskId, int maxResult)	Search task.
List<String>	searchUserTasks(String userTaskId, int maxResult)	Return a list of task
List<String>	searchUserTasksByProcessInstance(String processInstanceId, String userTaskId, int maxResult)
void	turnHighFlowMode(boolean hightFlowMode)

Methods inherited from class java.lang.Object

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

Field Details

SEARCH_MAX_SIZE

public static final int SEARCH_MAX_SIZE

See Also:

• Constant Field Values

Constructor Details

BpmnEngineCamunda7

public BpmnEngineCamunda7(ConfigurationBpmEngine engineConfiguration,
 ConfigurationBpmEngine.BpmnServerDefinition serverDefinition)

BpmnEngineCamunda7

public BpmnEngineCamunda7(String serverUrl,
 String userName,
 String password,
 boolean logDebug)

P

Parameters:

serverUrl - is "http://localhost:8080/engine-rest"

Method Details

init

public void init()

Description copied from interface: BpmnEngine

init the engine. This method will

Specified by:

init in interface BpmnEngine

connection

public void connection()
                throws AutomatorException

Specified by:

connection in interface BpmnEngine

Throws:

AutomatorException

disconnection

public void disconnection()
                   throws AutomatorException

Specified by:

disconnection in interface BpmnEngine

Throws:

AutomatorException

isReady

public boolean isReady()

Engine is ready. If not, a connection() method must be call

Specified by:

isReady in interface BpmnEngine

Returns:

createProcessInstance

public String createProcessInstance(String processId,
 String starterEventId,
 Map<String,Object> variables)
                             throws AutomatorException

Specified by:

createProcessInstance in interface BpmnEngine

Parameters:

processId - Process ID (BPMN ID : ExpenseNode)

starterEventId - BPMN ID (startEvent)

variables - List of variables to create the process instance

Returns:

a processInstanceId

Throws:

AutomatorException - in case of error

endProcessInstance

public void endProcessInstance(String processInstanceId,
 boolean cleanAll)
                        throws AutomatorException

Description copied from interface: BpmnEngine

we finish with this processinstanceid, engine can clean it

Specified by:

endProcessInstance in interface BpmnEngine

Parameters:

processInstanceId - Process instance Id to clean

cleanAll - if true, the process instance must be clean.

Throws:

AutomatorException - in case of error

searchUserTasksByProcessInstance

public List<String> searchUserTasksByProcessInstance(String processInstanceId,
 String userTaskId,
 int maxResult)
                                              throws AutomatorException

Specified by:

searchUserTasksByProcessInstance in interface BpmnEngine

Parameters:

processInstanceId - Process Instance Id

userTaskId - BPMN Id (Review)

maxResult - maximum result to return.

Returns:

list of taskId

Throws:

AutomatorException - in case of error

searchUserTasks

public List<String> searchUserTasks(String userTaskId,
 int maxResult)
                             throws AutomatorException

Description copied from interface: BpmnEngine

Return a list of task

Specified by:

searchUserTasks in interface BpmnEngine

Parameters:

userTaskId - userTaskId

maxResult - maxResult returned

Returns:

list of TaskId

Throws:

AutomatorException

executeUserTask

public void executeUserTask(String userTaskId,
 String userId,
 Map<String,Object> variables)
                     throws AutomatorException

Specified by:

executeUserTask in interface BpmnEngine

Parameters:

userTaskId - BPMN Id (Review)

userId - User id who executes the task

variables - variable to update

Throws:

AutomatorException - in case of error

registerServiceTask

public BpmnEngine.RegisteredTask registerServiceTask(String workerId,
 String topic,
 Duration lockTime,
 Object jobHandler,
 FixedBackoffSupplier backoffSupplier)

Specified by:

registerServiceTask in interface BpmnEngine

Parameters:

workerId - workerId

topic - topic to register

lockTime - lock time for the job

jobHandler - C7: must implement ExternalTaskHandler. C8: must implement JobHandler

backoffSupplier - backOffStrategy

Returns:

searchServiceTasks

public List<String> searchServiceTasks(String processInstanceId,
 String serviceTaskId,
 String topic,
 int maxResult)
                                throws AutomatorException

Search service task

Specified by:

searchServiceTasks in interface BpmnEngine

Parameters:

processInstanceId - processInstance

serviceTaskId - task name

topic - topic to search the task

maxResult - number of result

Returns:

the list of TaskId found according the criteria

Throws:

AutomatorException - any error during search

executeServiceTask

public void executeServiceTask(String serviceTaskId,
 String userId,
 Map<String,Object> variables)
                        throws AutomatorException

Description copied from interface: BpmnEngine

Execute a service task

Specified by:

executeServiceTask in interface BpmnEngine

Parameters:

serviceTaskId - BPMN ID (Review)

userId - Worker who execute the task

variables - variable to updates

Throws:

AutomatorException - in case of error

searchTasksByProcessInstanceId

public List<BpmnEngine.TaskDescription> searchTasksByProcessInstanceId(String processInstanceId,
 String taskId,
 int maxResult)
                                                                throws AutomatorException

Description copied from interface: BpmnEngine

Search task.

Specified by:

searchTasksByProcessInstanceId in interface BpmnEngine

Parameters:

processInstanceId - filter on the processInstanceId. may be null

taskId - filter on the taskId

maxResult - maximum Result

Returns:

List of task description

Throws:

AutomatorException - in case of error

searchProcessInstanceByVariable

public List<BpmnEngine.ProcessDescription> searchProcessInstanceByVariable(String processId,
 Map<String,Object> filterVariables,
 int maxResult)
                                                                    throws AutomatorException

Description copied from interface: BpmnEngine

Search process instance by a variable content

Specified by:

searchProcessInstanceByVariable in interface BpmnEngine

Parameters:

processId - BPMN Process ID

filterVariables - Variable name

maxResult - maxResult

Returns:

list of ProcessInstance which match the filter

Throws:

AutomatorException - in case of error

getVariables

public Map<String,Object> getVariables(String processInstanceId)
                                throws AutomatorException

Description copied from interface: BpmnEngine

Get variables of a process instanceId

Specified by:

getVariables in interface BpmnEngine

Parameters:

processInstanceId - the process instance ID

Returns:

variables attached to the process instance ID

Throws:

AutomatorException - in case of error

countNumberOfProcessInstancesCreated

public long countNumberOfProcessInstancesCreated(String processName,
 io.camunda.operate.search.DateFilter startDate,
 io.camunda.operate.search.DateFilter endDate)
                                          throws AutomatorException

Specified by:

countNumberOfProcessInstancesCreated in interface BpmnEngine

Throws:

AutomatorException

countNumberOfProcessInstancesEnded

public long countNumberOfProcessInstancesEnded(String processName,
 io.camunda.operate.search.DateFilter startDate,
 io.camunda.operate.search.DateFilter endDate)
                                        throws AutomatorException

Specified by:

countNumberOfProcessInstancesEnded in interface BpmnEngine

Throws:

AutomatorException

countNumberOfTasks

public long countNumberOfTasks(String processId,
 String taskId)
                        throws AutomatorException

Specified by:

countNumberOfTasks in interface BpmnEngine

Throws:

AutomatorException

deployBpmn

public String deployBpmn(File processFile,
 ScenarioDeployment.Policy policy)
                  throws AutomatorException

Description copied from interface: BpmnEngine

Deploy a BPMN file (may contains multiple processes)

Specified by:

deployBpmn in interface BpmnEngine

Parameters:

processFile - process to deploy

policy - policy to deploy the process

Returns:

the deploymentId

Throws:

AutomatorException - in case of error

getTypeCamundaEngine

public ConfigurationBpmEngine.CamundaEngine getTypeCamundaEngine()

Specified by:

getTypeCamundaEngine in interface BpmnEngine

getSignature

public String getSignature()

Description copied from interface: BpmnEngine

return the signature of the engine, to log it for example

Specified by:

getSignature in interface BpmnEngine

Returns:

signature of the engine

getWorkerExecutionThreads

public int getWorkerExecutionThreads()

Specified by:

getWorkerExecutionThreads in interface BpmnEngine

turnHighFlowMode

public void turnHighFlowMode(boolean hightFlowMode)

Specified by:

turnHighFlowMode in interface BpmnEngine