Interface Task

All Known Implementing Classes:
TaskEntity

public interface Task
Represents one task for a human user.
Author:
Joram Barrez
  • Field Details

  • Method Details

    • getId

      String getId()
      DB id of the task.
    • getName

      String getName()
      Name or title of the task.
    • setName

      void setName(String name)
      Name or title of the task.
    • getDescription

      String getDescription()
      Free text description of the task.
    • setDescription

      void setDescription(String description)
      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()
      The userId of the person that is responsible for this task. This is used when a task is delegated.
    • setOwner

      void setOwner(String owner)
      The userId of the person that is responsible for this task. This is used when a task is delegated.
    • getAssignee

      String getAssignee()
      The userId of the person to which this task is assigned or delegated.
    • setAssignee

      void setAssignee(String assignee)
      The userId of the person to which this task is assigned or delegated.
    • getDelegationState

      DelegationState getDelegationState()
      The current DelegationState for this task.
    • setDelegationState

      void setDelegationState(DelegationState delegationState)
      The current DelegationState 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

      void setCaseInstanceId(String caseInstanceId)
      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 fire TaskListener.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

      void setDueDate(Date dueDate)
      Change due date of the task.
    • getFollowUpDate

      Date getFollowUpDate()
      Follow-up date of the task.
    • setFollowUpDate

      void setFollowUpDate(Date followUpDate)
      Change follow-up date of the task.
    • delegate

      void delegate(String userId)
      delegates this task to the given user and sets the delegationState to DelegationState.PENDING. If no owner is set on the task, the owner is set to the current assignee of the task.
    • setParentTaskId

      void setParentTaskId(String parentTaskId)
      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 to TaskQuery.initializeFormKeys(), it will throw a BadUserRequestException.

      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 to TaskQuery.initializeFormKeys(), it will throw a BadUserRequestException.

      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

      void setTenantId(String tenantId)
      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

      void setTaskState(String taskState)
      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