Package org.camunda.bpm.engine.task
Interface Task
- All Known Implementing Classes:
TaskEntity
public interface Task
Represents one task for a human user.
- Author:
- Joram Barrez
-
Field Summary
Modifier and TypeFieldDescriptionstatic final int
static final int
static final int
-
Method Summary
Modifier and TypeMethodDescriptionvoid
delegates this task to the given user and sets thedelegationState
toDelegationState.PENDING
.Provides the form binding reference to the Camunda Form for the task.Reference to the case definition or null if it is not related to a case.Reference to the path of case execution or null if it is not related to a case instance.Reference to the case instance or null if it is not related to a case instance.The date/time when this task was createdThe currentDelegationState
for this task.Free text description of the task.Due date of the task.Reference to the path of execution or null if it is not related to a process instance.Follow-up date of the task.Provides the form key for the task.getId()
DB id of the task.The date/time when this task was last updated.getName()
Name or title of the task.getOwner()
TheuserId
of the person that is responsible for this task.the parent task for which this task is a subtaskint
indication of how important/urgent this task is with a number between 0 and 100 where higher values mean a higher priority and lower values mean lower priority: [0..19] lowest, [20..39] low, [40..59] normal, [60..79] high [80..100] highestReference to the process definition or null if it is not related to a process.Reference to the process instance or null if it is not related to a process instance.The id of the activity in the process defining this task or null if this is not related to a processReturns the task's state.Returns the task's tenant id or null in case this task does not belong to a tenant.boolean
Returns if an attachment exists for the taskboolean
Signifies if a comment exists for the taskboolean
Indicated whether this task is suspended or not.void
setAssignee
(String assignee) void
setCaseInstanceId
(String caseInstanceId) The case instance id for which this task is associated for.void
setDelegationState
(DelegationState delegationState) The currentDelegationState
for this task.void
setDescription
(String description) Change the description of the taskvoid
setDueDate
(Date dueDate) Change due date of the task.void
setFollowUpDate
(Date followUpDate) Change follow-up date of the task.void
Name or title of the task.void
TheuserId
of the person that is responsible for this task.void
setParentTaskId
(String parentTaskId) the parent task for which this task is a subtaskvoid
setPriority
(int priority) indication of how important/urgent this task is with a number between 0 and 100 where higher values mean a higher priority and lower values mean lower priority: [0..19] lowest, [20..39] low, [40..59] normal, [60..79] high [80..100] highestvoid
setTaskState
(String taskState) Sets the task state for this task.void
setTenantId
(String tenantId) Sets the tenant id for this task.
-
Field Details
-
PRIORITY_MINIUM
static final int PRIORITY_MINIUM- See Also:
-
PRIORITY_NORMAL
static final int PRIORITY_NORMAL- See Also:
-
PRIORITY_MAXIMUM
static final int PRIORITY_MAXIMUM- See Also:
-
-
Method Details
-
getId
String getId()DB id of the task. -
getName
String getName()Name or title of the task. -
setName
Name or title of the task. -
getDescription
String getDescription()Free text description of the task. -
setDescription
Change the description of the task -
getPriority
int getPriority()indication of how important/urgent this task is with a number between 0 and 100 where higher values mean a higher priority and lower values mean lower priority: [0..19] lowest, [20..39] low, [40..59] normal, [60..79] high [80..100] highest -
setPriority
void setPriority(int priority) indication of how important/urgent this task is with a number between 0 and 100 where higher values mean a higher priority and lower values mean lower priority: [0..19] lowest, [20..39] low, [40..59] normal, [60..79] high [80..100] highest -
getOwner
String getOwner()TheuserId
of the person that is responsible for this task. This is used when a task isdelegated
. -
setOwner
TheuserId
of the person that is responsible for this task. This is used when a task isdelegated
. -
getAssignee
String getAssignee() -
setAssignee
-
getDelegationState
DelegationState getDelegationState()The currentDelegationState
for this task. -
setDelegationState
The currentDelegationState
for this task. -
getProcessInstanceId
String getProcessInstanceId()Reference to the process instance or null if it is not related to a process instance. -
getExecutionId
String getExecutionId()Reference to the path of execution or null if it is not related to a process instance. -
getProcessDefinitionId
String getProcessDefinitionId()Reference to the process definition or null if it is not related to a process. -
getCaseInstanceId
String getCaseInstanceId()Reference to the case instance or null if it is not related to a case instance. -
setCaseInstanceId
The case instance id for which this task is associated for. -
getCaseExecutionId
String getCaseExecutionId()Reference to the path of case execution or null if it is not related to a case instance. -
getCaseDefinitionId
String getCaseDefinitionId()Reference to the case definition or null if it is not related to a case. -
getCreateTime
Date getCreateTime()The date/time when this task was created -
getLastUpdated
Date getLastUpdated()The date/time when this task was last updated. All operations that fireTaskListener.EVENTNAME_UPDATE
count as an update to the task. Returns null if the task was never updated before (i.e. it was only created). -
getTaskDefinitionKey
String getTaskDefinitionKey()The id of the activity in the process defining this task or null if this is not related to a process -
getDueDate
Date getDueDate()Due date of the task. -
setDueDate
Change due date of the task. -
getFollowUpDate
Date getFollowUpDate()Follow-up date of the task. -
setFollowUpDate
Change follow-up date of the task. -
delegate
delegates this task to the given user and sets thedelegationState
toDelegationState.PENDING
. If no owner is set on the task, the owner is set to the current assignee of the task. -
setParentTaskId
the parent task for which this task is a subtask -
getParentTaskId
String getParentTaskId()the parent task for which this task is a subtask -
isSuspended
boolean isSuspended()Indicated whether this task is suspended or not. -
getFormKey
String getFormKey()Provides the form key for the task.NOTE: If the task instance is obtained through a query, this property is only populated in case the
TaskQuery.initializeFormKeys()
method is called. If this method is called without a prior call toTaskQuery.initializeFormKeys()
, it will throw aBadUserRequestException
.- Returns:
- the form key for this task
- Throws:
BadUserRequestException
- in case the form key is not initialized.
-
getCamundaFormRef
CamundaFormRef getCamundaFormRef()Provides the form binding reference to the Camunda Form for the task.NOTE: If the task instance is obtained through a query, this property is only populated in case the
TaskQuery.initializeFormKeys()
method is called. If this method is called without a prior call toTaskQuery.initializeFormKeys()
, it will throw aBadUserRequestException
.- Returns:
- the reference key, binding type and version (if type is
version
) - Throws:
BadUserRequestException
- in case the form key is not initialized.
-
getTenantId
String getTenantId()Returns the task's tenant id or null in case this task does not belong to a tenant.- Returns:
- the task's tenant id or null
- Since:
- 7.5
-
setTenantId
Sets the tenant id for this task.- Parameters:
tenantId
- the tenant id to set- Since:
- 7.5
-
getTaskState
String getTaskState()Returns the task's state.- Returns:
- the task's state
-
setTaskState
Sets the task state for this task.- Parameters:
taskState
- the taskState to set
-
hasAttachment
boolean hasAttachment()Returns if an attachment exists for the task -
hasComment
boolean hasComment()Signifies if a comment exists for the task
-