Package org.flowable.cmmn.engine.impl

Class CmmnTaskServiceImpl

java.lang.Object

org.flowable.common.engine.impl.service.CommonServiceImpl<C>

org.flowable.common.engine.impl.service.CommonEngineServiceImpl<CmmnEngineConfiguration>

org.flowable.cmmn.engine.impl.CmmnTaskServiceImpl

All Implemented Interfaces:

CmmnTaskService

public class CmmnTaskServiceImpl
extends CommonEngineServiceImpl<CmmnEngineConfiguration>
implements CmmnTaskService

Author:

Joram Barrez

Field Summary

Fields inherited from class org.flowable.common.engine.impl.service.CommonEngineServiceImpl

commandExecutor

Fields inherited from class org.flowable.common.engine.impl.service.CommonServiceImpl

configuration

Constructor Summary

Constructors

Constructor	Description
CmmnTaskServiceImpl(CmmnEngineConfiguration engineConfiguration)

Method Summary

Modifier and Type	Method	Description
void	activateTask(String taskId, String userId)	Activates the task.
void	addGroupIdentityLink(String taskId, String groupId, String identityLinkType)	Involves a group with a task.
void	addUserIdentityLink(String taskId, String userId, String identityLinkType)	Involves a user with a task.
void	bulkSaveTasks(Collection<Task> taskList)
void	claim(String taskId, String userId)	Claim responsibility for a task: the given user is made assignee for the task.
void	complete(String taskId)
void	complete(String taskId, String userId)
void	complete(String taskId, String userId, Map<String,Object> variables)
void	complete(String taskId, String userId, Map<String,Object> variables, Map<String,Object> transientVariables)
void	complete(String taskId, Map<String,Object> variables)
void	complete(String taskId, Map<String,Object> variables, Map<String,Object> transientVariables)
void	completeTaskWithForm(String taskId, String formDefinitionId, String outcome, String userId, Map<String,Object> variables)
void	completeTaskWithForm(String taskId, String formDefinitionId, String outcome, String userId, Map<String,Object> variables, boolean localScope)
void	completeTaskWithForm(String taskId, String formDefinitionId, String outcome, String userId, Map<String,Object> variables, Map<String,Object> transientVariables)
void	completeTaskWithForm(String taskId, String formDefinitionId, String outcome, Map<String,Object> variables)
void	completeTaskWithForm(String taskId, String formDefinitionId, String outcome, Map<String,Object> variables, boolean localScope)
void	completeTaskWithForm(String taskId, String formDefinitionId, String outcome, Map<String,Object> variables, Map<String,Object> transientVariables)
TaskBuilder	createTaskBuilder()	Create a builder for the task
TaskCompletionBuilder	createTaskCompletionBuilder()	Create a completion builder for the task
TaskQuery	createTaskQuery()
void	delegateTask(String taskId, String userId)	Delegates the task to another user.
void	deleteGroupIdentityLink(String taskId, String groupId, String identityLinkType)	Removes the association between a group and a task for the given identityLinkType.
void	deleteTask(String taskId)	Deletes the given task, not deleting historic information that is related to this task.
void	deleteTask(String taskId, boolean cascade)	Deletes the given task.
void	deleteTask(String taskId, String deleteReason)	Deletes the given task, not deleting historic information that is related to this task..
void	deleteTasks(Collection<String> taskIds)	Deletes all tasks of the given collection, not deleting historic information that is related to these tasks.
void	deleteTasks(Collection<String> taskIds, boolean cascade)	Deletes all tasks of the given collection.
void	deleteTasks(Collection<String> taskIds, String deleteReason)	Deletes all tasks of the given collection, not deleting historic information that is related to these tasks.
void	deleteUserIdentityLink(String taskId, String userId, String identityLinkType)	Removes the association between a user and a task for the given identityLinkType.
List<IdentityLink>	getIdentityLinksForTask(String taskId)	Retrieves the IdentityLinks associated with the given task.
List<Task>	getSubTasks(String parentTaskId)	The list of subtasks for this parent task
FormInfo	getTaskFormModel(String taskId)
FormInfo	getTaskFormModel(String taskId, boolean ignoreVariables)
Object	getVariable(String taskId, String variableName)	get a variables and search in the task scope and if available also the execution scopes.
<T> T	getVariable(String taskId, String variableName, Class<T> variableClass)	get a variables and search in the task scope and if available also the execution scopes.
VariableInstance	getVariableInstance(String taskId, String variableName)	The variable.
VariableInstance	getVariableInstanceLocal(String taskId, String variableName)	The variable for a task.
Map<String,VariableInstance>	getVariableInstances(String taskId)	All variables visible from the given task scope (including parent scopes).
Map<String,VariableInstance>	getVariableInstances(String taskId, Collection<String> variableNames)	The variable values for all given variableNames, takes all variables into account which are visible from the given task scope (including parent scopes).
Map<String,VariableInstance>	getVariableInstancesLocal(String taskId)	All variable values that are defined in the task scope, without taking outer scopes into account.
Map<String,VariableInstance>	getVariableInstancesLocal(String taskId, Collection<String> variableNames)	The variable values for all given variableNames that are defined in the given task's scope.
List<VariableInstance>	getVariableInstancesLocalByTaskIds(Set<String> taskIds)	get all variables and search only in the task scope.
Object	getVariableLocal(String taskId, String variableName)	checks whether or not the task has a variable defined with the given name.
<T> T	getVariableLocal(String taskId, String variableName, Class<T> variableClass)	checks whether or not the task has a variable defined with the given name.
Map<String,Object>	getVariables(String taskId)	get all variables and search in the task scope and if available also the execution scopes.
Map<String,Object>	getVariables(String taskId, Collection<String> variableNames)	get values for all given variableNames and search only in the task scope.
Map<String,Object>	getVariablesLocal(String taskId)	get all variables and search only in the task scope.
Map<String,Object>	getVariablesLocal(String taskId, Collection<String> variableNames)	get a variable on a task
boolean	hasVariable(String taskId, String variableName)	checks whether or not the task has a variable defined with the given name, in the task scope and if available also the execution scopes.
boolean	hasVariableLocal(String taskId, String variableName)	checks whether or not the task has a variable defined with the given name, local task scope only.
Task	newTask()
Task	newTask(String taskId)
void	removeVariable(String taskId, String variableName)	Removes the variable from the task.
void	removeVariableLocal(String taskId, String variableName)	Removes the variable from the task (not considering parent scopes).
void	removeVariables(String taskId, Collection<String> variableNames)	Removes all variables in the given collection from the task.
void	removeVariablesLocal(String taskId, Collection<String> variableNames)	Removes all variables in the given collection from the task (not considering parent scopes).
void	resolveTask(String taskId)	Marks that the assignee is done with this task and that it can be send back to the owner.
void	resolveTask(String taskId, Map<String,Object> variables)	Marks that the assignee is done with this task providing the required variables and that it can be sent back to the owner.
void	resolveTask(String taskId, Map<String,Object> variables, Map<String,Object> transientVariables)	Similar to CmmnTaskService.resolveTask(String, Map), but allows to set transient variables too.
void	saveTask(Task task)
void	setAssignee(String taskId, String userId)	Changes the assignee of the given task to the given userId.
void	setDueDate(String taskId, Date dueDate)	Changes the due date of the task
void	setOwner(String taskId, String userId)	Transfers ownership of this task to another user.
void	setPriority(String taskId, int priority)	Changes the priority of the task.
void	setVariable(String taskId, String variableName, Object value)	set variable on a task.
void	setVariableLocal(String taskId, String variableName, Object value)	set variable on a task.
void	setVariables(String taskId, Map<String,? extends Object> variables)	set variables on a task.
void	setVariablesLocal(String taskId, Map<String,? extends Object> variables)	set variables on a task.
void	startProgress(String taskId, String userId)	Starts the progress on the task.
void	suspendTask(String taskId, String userId)	Suspends the task.
void	unclaim(String taskId)	A shortcut to CmmnTaskService.claim(java.lang.String, java.lang.String) with null user in order to unclaim the task

Methods inherited from class org.flowable.common.engine.impl.service.CommonEngineServiceImpl

getCommandExecutor, setCommandExecutor

Methods inherited from class org.flowable.common.engine.impl.service.CommonServiceImpl

getConfiguration

Methods inherited from class java.lang.Object

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

Constructor Details

CmmnTaskServiceImpl

public CmmnTaskServiceImpl(CmmnEngineConfiguration engineConfiguration)

Method Details

newTask

public Task newTask()

Specified by:

newTask in interface CmmnTaskService

newTask

public Task newTask(String taskId)

Specified by:

newTask in interface CmmnTaskService

saveTask

public void saveTask(Task task)

Specified by:

saveTask in interface CmmnTaskService

bulkSaveTasks

public void bulkSaveTasks(Collection<Task> taskList)

Specified by:

bulkSaveTasks in interface CmmnTaskService

claim

public void claim(String taskId,
 String userId)

Description copied from interface: CmmnTaskService

Claim responsibility for a task: the given user is made assignee for the task. The difference with CmmnTaskService.setAssignee(String, String) is that here a check is done if the task already has a user assigned to it. No check is done whether the user is known by the identity component.

Specified by:

claim in interface CmmnTaskService

Parameters:

taskId - task to claim, cannot be null.

userId - user that claims the task. When userId is null the task is unclaimed, assigned to no one.

unclaim

public void unclaim(String taskId)

Description copied from interface: CmmnTaskService

A shortcut to CmmnTaskService.claim(java.lang.String, java.lang.String) with null user in order to unclaim the task

Specified by:

unclaim in interface CmmnTaskService

Parameters:

taskId - task to unclaim, cannot be null.

startProgress

public void startProgress(String taskId,
 String userId)

Description copied from interface: CmmnTaskService

Starts the progress on the task.

Specified by:

startProgress in interface CmmnTaskService

Parameters:

taskId - task to start progress, cannot be null.

userId - user that starts progress for the task.

suspendTask

public void suspendTask(String taskId,
 String userId)

Description copied from interface: CmmnTaskService

Suspends the task. No check is done whether the user is known by the identity component.

Specified by:

suspendTask in interface CmmnTaskService

Parameters:

taskId - task to suspend, cannot be null.

userId - user that suspends the task.

activateTask

public void activateTask(String taskId,
 String userId)

Description copied from interface: CmmnTaskService

Activates the task. No check is done whether the user is known by the identity component.

Specified by:

activateTask in interface CmmnTaskService

Parameters:

taskId - task to activate, cannot be null.

userId - user that activates the task.

complete

public void complete(String taskId)

Specified by:

complete in interface CmmnTaskService

complete

public void complete(String taskId,
 String userId)

Specified by:

complete in interface CmmnTaskService

complete

public void complete(String taskId,
 Map<String,Object> variables)

Specified by:

complete in interface CmmnTaskService

complete

public void complete(String taskId,
 String userId,
 Map<String,Object> variables)

Specified by:

complete in interface CmmnTaskService

complete

public void complete(String taskId,
 Map<String,Object> variables,
 Map<String,Object> transientVariables)

Specified by:

complete in interface CmmnTaskService

complete

public void complete(String taskId,
 String userId,
 Map<String,Object> variables,
 Map<String,Object> transientVariables)

Specified by:

complete in interface CmmnTaskService

completeTaskWithForm

public void completeTaskWithForm(String taskId,
 String formDefinitionId,
 String outcome,
 Map<String,Object> variables)

Specified by:

completeTaskWithForm in interface CmmnTaskService

completeTaskWithForm

public void completeTaskWithForm(String taskId,
 String formDefinitionId,
 String outcome,
 String userId,
 Map<String,Object> variables)

Specified by:

completeTaskWithForm in interface CmmnTaskService

completeTaskWithForm

public void completeTaskWithForm(String taskId,
 String formDefinitionId,
 String outcome,
 Map<String,Object> variables,
 Map<String,Object> transientVariables)

Specified by:

completeTaskWithForm in interface CmmnTaskService

completeTaskWithForm

public void completeTaskWithForm(String taskId,
 String formDefinitionId,
 String outcome,
 String userId,
 Map<String,Object> variables,
 Map<String,Object> transientVariables)

Specified by:

completeTaskWithForm in interface CmmnTaskService

completeTaskWithForm

public void completeTaskWithForm(String taskId,
 String formDefinitionId,
 String outcome,
 Map<String,Object> variables,
 boolean localScope)

Specified by:

completeTaskWithForm in interface CmmnTaskService

completeTaskWithForm

public void completeTaskWithForm(String taskId,
 String formDefinitionId,
 String outcome,
 String userId,
 Map<String,Object> variables,
 boolean localScope)

Specified by:

completeTaskWithForm in interface CmmnTaskService

createTaskCompletionBuilder

public TaskCompletionBuilder createTaskCompletionBuilder()

Description copied from interface: CmmnTaskService

Create a completion builder for the task

Specified by:

createTaskCompletionBuilder in interface CmmnTaskService

Returns:

task completion builder

delegateTask

public void delegateTask(String taskId,
 String userId)

Description copied from interface: CmmnTaskService

Delegates the task to another user. This means that the assignee is set and the delegation state is set to DelegationState.PENDING. If no owner is set on the task, the owner is set to the current assignee of the task.

Specified by:

delegateTask in interface CmmnTaskService

Parameters:

taskId - The id of the task that will be delegated.

userId - The id of the user that will be set as assignee.

resolveTask

public void resolveTask(String taskId)

Description copied from interface: CmmnTaskService

Marks that the assignee is done with this task and that it can be send back to the owner. Can only be called when this task is DelegationState.PENDING delegation. After this method returns, the delegationState is set to DelegationState.RESOLVED.

Specified by:

resolveTask in interface CmmnTaskService

Parameters:

taskId - the id of the task to resolve, cannot be null.

resolveTask

public void resolveTask(String taskId,
 Map<String,Object> variables)

Description copied from interface: CmmnTaskService

Marks that the assignee is done with this task providing the required variables and that it can be sent back to the owner. Can only be called when this task is DelegationState.PENDING delegation. After this method returns, the delegationState is set to DelegationState.RESOLVED.

Specified by:

resolveTask in interface CmmnTaskService

variables - When no task exists with the given id.

resolveTask

public void resolveTask(String taskId,
 Map<String,Object> variables,
 Map<String,Object> transientVariables)

Description copied from interface: CmmnTaskService

Similar to CmmnTaskService.resolveTask(String, Map), but allows to set transient variables too.

Specified by:

resolveTask in interface CmmnTaskService

deleteTask

public void deleteTask(String taskId)

Description copied from interface: CmmnTaskService

Deletes the given task, not deleting historic information that is related to this task.

Specified by:

deleteTask in interface CmmnTaskService

Parameters:

taskId - The id of the task that will be deleted, cannot be null. If no task exists with the given taskId, the operation is ignored.

deleteTasks

public void deleteTasks(Collection<String> taskIds)

Description copied from interface: CmmnTaskService

Deletes all tasks of the given collection, not deleting historic information that is related to these tasks.

Specified by:

deleteTasks in interface CmmnTaskService

Parameters:

taskIds - The id's of the tasks that will be deleted, cannot be null. All id's in the list that don't have an existing task will be ignored.

deleteTask

public void deleteTask(String taskId,
 boolean cascade)

Description copied from interface: CmmnTaskService

Deletes the given task.

Specified by:

deleteTask in interface CmmnTaskService

Parameters:

taskId - The id of the task that will be deleted, cannot be null. If no task exists with the given taskId, the operation is ignored.

cascade - If cascade is true, also the historic information related to this task is deleted.

deleteTasks

public void deleteTasks(Collection<String> taskIds,
 boolean cascade)

Description copied from interface: CmmnTaskService

Deletes all tasks of the given collection.

Specified by:

deleteTasks in interface CmmnTaskService

Parameters:

taskIds - The id's of the tasks that will be deleted, cannot be null. All id's in the list that don't have an existing task will be ignored.

cascade - If cascade is true, also the historic information related to this task is deleted.

deleteTask

public void deleteTask(String taskId,
 String deleteReason)

Description copied from interface: CmmnTaskService

Deletes the given task, not deleting historic information that is related to this task..

Specified by:

deleteTask in interface CmmnTaskService

Parameters:

taskId - The id of the task that will be deleted, cannot be null. If no task exists with the given taskId, the operation is ignored.

deleteReason - reason the task is deleted. Is recorded in history, if enabled.

deleteTasks

public void deleteTasks(Collection<String> taskIds,
 String deleteReason)

Description copied from interface: CmmnTaskService

Deletes all tasks of the given collection, not deleting historic information that is related to these tasks.

Specified by:

deleteTasks in interface CmmnTaskService

Parameters:

taskIds - The id's of the tasks that will be deleted, cannot be null. All id's in the list that don't have an existing task will be ignored.

deleteReason - reason the task is deleted. Is recorded in history, if enabled.

getTaskFormModel

public FormInfo getTaskFormModel(String taskId)

Specified by:

getTaskFormModel in interface CmmnTaskService

getTaskFormModel

public FormInfo getTaskFormModel(String taskId,
 boolean ignoreVariables)

Specified by:

getTaskFormModel in interface CmmnTaskService

setPriority

public void setPriority(String taskId,
 int priority)

Description copied from interface: CmmnTaskService

Changes the priority of the task. Authorization: actual owner / business admin

Specified by:

setPriority in interface CmmnTaskService

Parameters:

taskId - id of the task, cannot be null.

priority - the new priority for the task.

setDueDate

public void setDueDate(String taskId,
 Date dueDate)

Description copied from interface: CmmnTaskService

Changes the due date of the task

Specified by:

setDueDate in interface CmmnTaskService

Parameters:

taskId - id of the task, cannot be null.

dueDate - the new due date for the task

createTaskQuery

public TaskQuery createTaskQuery()

Specified by:

createTaskQuery in interface CmmnTaskService

getSubTasks

public List<Task> getSubTasks(String parentTaskId)

Description copied from interface: CmmnTaskService

The list of subtasks for this parent task

Specified by:

getSubTasks in interface CmmnTaskService

getVariables

public Map<String,Object> getVariables(String taskId)

Description copied from interface: CmmnTaskService

get all variables and search in the task scope and if available also the execution scopes. If you have many variables and you only need a few, consider using CmmnTaskService.getVariables(String, Collection) for better performance.

Specified by:

getVariables in interface CmmnTaskService

getVariablesLocal

public Map<String,Object> getVariablesLocal(String taskId)

Description copied from interface: CmmnTaskService

get all variables and search only in the task scope. If you have many task local variables and you only need a few, consider using CmmnTaskService.getVariablesLocal(String, Collection) for better performance.

Specified by:

getVariablesLocal in interface CmmnTaskService

getVariables

public Map<String,Object> getVariables(String taskId,
 Collection<String> variableNames)

Description copied from interface: CmmnTaskService

get values for all given variableNames and search only in the task scope.

Specified by:

getVariables in interface CmmnTaskService

getVariablesLocal

public Map<String,Object> getVariablesLocal(String taskId,
 Collection<String> variableNames)

Description copied from interface: CmmnTaskService

get a variable on a task

Specified by:

getVariablesLocal in interface CmmnTaskService

getVariable

public Object getVariable(String taskId,
 String variableName)

Description copied from interface: CmmnTaskService

get a variables and search in the task scope and if available also the execution scopes.

Specified by:

getVariable in interface CmmnTaskService

getVariable

public <T> T getVariable(String taskId,
 String variableName,
 Class<T> variableClass)

Description copied from interface: CmmnTaskService

get a variables and search in the task scope and if available also the execution scopes.

Specified by:

getVariable in interface CmmnTaskService

hasVariable

public boolean hasVariable(String taskId,
 String variableName)

Description copied from interface: CmmnTaskService

checks whether or not the task has a variable defined with the given name, in the task scope and if available also the execution scopes.

Specified by:

hasVariable in interface CmmnTaskService

getVariableLocal

public Object getVariableLocal(String taskId,
 String variableName)

Description copied from interface: CmmnTaskService

checks whether or not the task has a variable defined with the given name.

Specified by:

getVariableLocal in interface CmmnTaskService

getVariableLocal

public <T> T getVariableLocal(String taskId,
 String variableName,
 Class<T> variableClass)

Description copied from interface: CmmnTaskService

checks whether or not the task has a variable defined with the given name.

Specified by:

getVariableLocal in interface CmmnTaskService

getVariableInstancesLocalByTaskIds

public List<VariableInstance> getVariableInstancesLocalByTaskIds(Set<String> taskIds)

Description copied from interface: CmmnTaskService

get all variables and search only in the task scope.

Specified by:

getVariableInstancesLocalByTaskIds in interface CmmnTaskService

hasVariableLocal

public boolean hasVariableLocal(String taskId,
 String variableName)

Description copied from interface: CmmnTaskService

checks whether or not the task has a variable defined with the given name, local task scope only.

Specified by:

hasVariableLocal in interface CmmnTaskService

setVariable

public void setVariable(String taskId,
 String variableName,
 Object value)

Description copied from interface: CmmnTaskService

set variable on a task. If the variable is not already existing, it will be created in the most outer scope. This means the process instance in case this task is related to an execution.

Specified by:

setVariable in interface CmmnTaskService

setVariableLocal

public void setVariableLocal(String taskId,
 String variableName,
 Object value)

Description copied from interface: CmmnTaskService

set variable on a task. If the variable is not already existing, it will be created in the task.

Specified by:

setVariableLocal in interface CmmnTaskService

setVariables

public void setVariables(String taskId,
 Map<String,? extends Object> variables)

Description copied from interface: CmmnTaskService

set variables on a task. If the variable is not already existing, it will be created in the most outer scope. This means the process instance in case this task is related to an execution.

Specified by:

setVariables in interface CmmnTaskService

setVariablesLocal

public void setVariablesLocal(String taskId,
 Map<String,? extends Object> variables)

Description copied from interface: CmmnTaskService

set variables on a task. If the variable is not already existing, it will be created in the task.

Specified by:

setVariablesLocal in interface CmmnTaskService

removeVariable

public void removeVariable(String taskId,
 String variableName)

Description copied from interface: CmmnTaskService

Removes the variable from the task. When the variable does not exist, nothing happens.

Specified by:

removeVariable in interface CmmnTaskService

removeVariableLocal

public void removeVariableLocal(String taskId,
 String variableName)

Description copied from interface: CmmnTaskService

Removes the variable from the task (not considering parent scopes). When the variable does not exist, nothing happens.

Specified by:

removeVariableLocal in interface CmmnTaskService

removeVariables

public void removeVariables(String taskId,
 Collection<String> variableNames)

Description copied from interface: CmmnTaskService

Removes all variables in the given collection from the task. Non existing variable names are simply ignored.

Specified by:

removeVariables in interface CmmnTaskService

removeVariablesLocal

public void removeVariablesLocal(String taskId,
 Collection<String> variableNames)

Description copied from interface: CmmnTaskService

Removes all variables in the given collection from the task (not considering parent scopes). Non existing variable names are simply ignored.

Specified by:

removeVariablesLocal in interface CmmnTaskService

getVariableInstance

public VariableInstance getVariableInstance(String taskId,
 String variableName)

Description copied from interface: CmmnTaskService

The variable. Searching for the variable is done in all scopes that are visible to the given task (including parent scopes). Returns null when no variable value is found with the given name.

Specified by:

getVariableInstance in interface CmmnTaskService

Parameters:

taskId - id of task, cannot be null.

variableName - name of variable, cannot be null.

Returns:

the variable or null if the variable is undefined.

getVariableInstanceLocal

public VariableInstance getVariableInstanceLocal(String taskId,
 String variableName)

Description copied from interface: CmmnTaskService

The variable for a task. Returns the variable when it is set for the task (and not searching parent scopes). Returns null when no variable is found with the given name.

Specified by:

getVariableInstanceLocal in interface CmmnTaskService

Parameters:

taskId - id of task, cannot be null.

variableName - name of variable, cannot be null.

Returns:

the variable or null if the variable is undefined.

getVariableInstances

public Map<String,VariableInstance> getVariableInstances(String taskId)

Description copied from interface: CmmnTaskService

All variables visible from the given task scope (including parent scopes).

Specified by:

getVariableInstances in interface CmmnTaskService

Parameters:

taskId - id of task, cannot be null.

Returns:

the variable instances or an empty map if no such variables are found.

getVariableInstances

public Map<String,VariableInstance> getVariableInstances(String taskId,
 Collection<String> variableNames)

Description copied from interface: CmmnTaskService

The variable values for all given variableNames, takes all variables into account which are visible from the given task scope (including parent scopes).

Specified by:

getVariableInstances in interface CmmnTaskService

Parameters:

taskId - id of taskId, cannot be null.

variableNames - the collection of variable names that should be retrieved.

Returns:

the variables or an empty map if no such variables are found.

getVariableInstancesLocal

public Map<String,VariableInstance> getVariableInstancesLocal(String taskId)

Description copied from interface: CmmnTaskService

All variable values that are defined in the task scope, without taking outer scopes into account. If you have many task local variables and you only need a few, consider using CmmnTaskService.getVariableInstancesLocal(String, Collection) for better performance.

Specified by:

getVariableInstancesLocal in interface CmmnTaskService

Parameters:

taskId - id of task, cannot be null.

Returns:

the variables or an empty map if no such variables are found.

getVariableInstancesLocal

public Map<String,VariableInstance> getVariableInstancesLocal(String taskId,
 Collection<String> variableNames)

Description copied from interface: CmmnTaskService

The variable values for all given variableNames that are defined in the given task's scope. (Does not searching parent scopes).

Specified by:

getVariableInstancesLocal in interface CmmnTaskService

Parameters:

taskId - id of taskId, cannot be null.

variableNames - the collection of variable names that should be retrieved.

Returns:

the variables or an empty map if no such variables are found.

setAssignee

public void setAssignee(String taskId,
 String userId)

Description copied from interface: CmmnTaskService

Changes the assignee of the given task to the given userId. No check is done whether the user is known by the identity component.

Specified by:

setAssignee in interface CmmnTaskService

Parameters:

taskId - id of the task, cannot be null.

userId - id of the user to use as assignee.

setOwner

public void setOwner(String taskId,
 String userId)

Description copied from interface: CmmnTaskService

Transfers ownership of this task to another user. No check is done whether the user is known by the identity component.

Specified by:

setOwner in interface CmmnTaskService

Parameters:

taskId - id of the task, cannot be null.

userId - of the person that is receiving ownership.

addUserIdentityLink

public void addUserIdentityLink(String taskId,
 String userId,
 String identityLinkType)

Description copied from interface: CmmnTaskService

Involves a user with a task. The type of identity link is defined by the given identityLinkType.

Specified by:

addUserIdentityLink in interface CmmnTaskService

Parameters:

taskId - id of the task, cannot be null.

userId - id of the user involve, cannot be null.

identityLinkType - type of identityLink, cannot be null.

addGroupIdentityLink

public void addGroupIdentityLink(String taskId,
 String groupId,
 String identityLinkType)

Description copied from interface: CmmnTaskService

Involves a group with a task. The type of identityLink is defined by the given identityLink.

Specified by:

addGroupIdentityLink in interface CmmnTaskService

Parameters:

taskId - id of the task, cannot be null.

groupId - id of the group to involve, cannot be null.

identityLinkType - type of identity, cannot be null.

deleteGroupIdentityLink

public void deleteGroupIdentityLink(String taskId,
 String groupId,
 String identityLinkType)

Description copied from interface: CmmnTaskService

Removes the association between a group and a task for the given identityLinkType.

Specified by:

deleteGroupIdentityLink in interface CmmnTaskService

Parameters:

taskId - id of the task, cannot be null.

groupId - id of the group to involve, cannot be null.

identityLinkType - type of identity, cannot be null.

deleteUserIdentityLink

public void deleteUserIdentityLink(String taskId,
 String userId,
 String identityLinkType)

Description copied from interface: CmmnTaskService

Removes the association between a user and a task for the given identityLinkType.

Specified by:

deleteUserIdentityLink in interface CmmnTaskService

Parameters:

taskId - id of the task, cannot be null.

userId - id of the user involve, cannot be null.

identityLinkType - type of identityLink, cannot be null.

getIdentityLinksForTask

public List<IdentityLink> getIdentityLinksForTask(String taskId)

Description copied from interface: CmmnTaskService

Retrieves the IdentityLinks associated with the given task. Such an IdentityLink informs how a certain identity (eg. group or user) is associated with a certain task (eg. as candidate, assignee, etc.)

Specified by:

getIdentityLinksForTask in interface CmmnTaskService

createTaskBuilder

public TaskBuilder createTaskBuilder()

Description copied from interface: CmmnTaskService

Create a builder for the task

Specified by:

createTaskBuilder in interface CmmnTaskService

Returns:

task builder