com.ibm.task.api

Interface Task

All Superinterfaces:
java.io.Serializable
All known implementing classes:
TaskInstanceBean

  1. public interface Task
  2. extends java.io.Serializable
Accesses the properties of a task instance.

A task represents a piece of work. It contains all data that is necessary to get the job done. For example, a task that is associated to a group of potential owners allows a person that belongs to the group to claim the task, work on the task, and to complete the task.

Since:
7.0 - introduced in 5.1

Field Summary

Modifier and Type Field and Description
  1. static
  2. int
ASSIGNMENT_TYPE_PARALLEL
States that the task can be assigned to multiple persons in parallel.
  1. static
  2. int
ASSIGNMENT_TYPE_SINGLE
States that the task can only be assigned to a single person.
  1. static
  2. int
AUTH_NONE
States that no operations can be executed on the associated context.
  1. static
  2. int
AUTH_READER
States that operations can be executed on the associated context object that require Reader authority, for example, reading the properties of a process instance.
  1. static
  2. int
AUTO_DELETE_ON_COMPLETION
States that a completed task instance is deleted when the duration until deletion has passed.
  1. static
  2. int
AUTO_DELETE_ON_SUCCESSFUL_COMPLETION
States that the task instance is deleted when it reaches the FINISHED state.
  1. static
  2. java.lang.String
COPYRIGHT
  1. static
  2. int
HIERARCHY_POSITION_FOLLOW_ON_TASK
The task is a follow-on task in the task collaboration hierarchy.
  1. static
  2. int
HIERARCHY_POSITION_SUB_TASK
The task is a subtask in the task collaboration hierarchy.
  1. static
  2. int
HIERARCHY_POSITION_TOP_TASK
The task is a toplevel task in the task collaboration hierarchy.
  1. static
  2. int
INHERITED_AUTH_ADMINISTRATOR
States that administrator authorizations of all parent tasks in the parent task hierarchy are inherited by this subtask.
  1. static
  2. int
INHERITED_AUTH_ALL
States that, additionally to the administrators, all other authorizations for parent tasks in the parent task hierarchy are inherited as reader authorization by this subtask.
  1. static
  2. int
INHERITED_AUTH_NONE
States that no authorization is inherited from parent tasks by this subtask.
  1. static
  2. int
INVOKED_INSTANCE_TYPE_ACTIVITY
States that the task invoked an activity in a business process,
  1. static
  2. int
INVOKED_INSTANCE_TYPE_CHILD_PROCESS
States that the activity calls a long-running process that has "child" autonomy.
  1. static
  2. int
INVOKED_INSTANCE_TYPE_CHILD_TASK
States that the activity calls a stand-alone task that has "child" autonomy.
  1. static
  2. int
INVOKED_INSTANCE_TYPE_EVENT
States that the task invoked an activity in an event handler or an activity which is not yet ready to receive the event.
  1. static
  2. int
INVOKED_INSTANCE_TYPE_INLINE_TASK
States that the activity calls an inline human task.
  1. static
  2. int
INVOKED_INSTANCE_TYPE_NOT_SET
States that the activity does not call a process or inline task, or does not call a process or stand-alone task that have "child" autonomy.
  1. static
  2. int
INVOKED_INSTANCE_TYPE_PROCESS
States that the task invoked a business process,
  1. static
  2. int
INVOKED_INSTANCE_TYPE_TASK
States that the task invoked a stand-alone task.
  1. static
  2. int
KIND_ADMINISTRATIVE
States that the task is an administration task.
  1. static
  2. int
KIND_HUMAN
States that the task is created and processed by humans.
  1. static
  2. int
KIND_ORIGINATING
States that the task is a task whose service is invoked and tracked by the Human Task Manager.
  1. static
  2. int
KIND_PARTICIPATING
States that the task is processed by humans but tracked by the Human Task Manager.
  1. static
  2. int
KIND_WPC_STAFF_ACTIVITY
States that the task is processed by humans but controlled by the Business Flow Manager.
  1. static
  2. int
STATE_CLAIMED
States that the activity has been claimed.
  1. static
  2. int
STATE_EXPIRED
States that the activity ended because its allowed duration timed-out.
  1. static
  2. int
STATE_FAILED
States that the activity failed to execute.
  1. static
  2. int
STATE_FAILING
Deprecated.
  1. static
  2. int
STATE_FINISHED
States that the activity finished execution successfully.
  1. static
  2. int
STATE_FORWARDED
States that the task has been completed with a follow-on task.
  1. static
  2. int
STATE_INACTIVE
States that the activity has not yet been scheduled for execution.
  1. static
  2. int
STATE_PROCESSING_UNDO
Deprecated.
  1. static
  2. int
STATE_READY
States that the activity is ready to be started or claimed.
  1. static
  2. int
STATE_RUNNING
States that the activity is running.
  1. static
  2. int
STATE_SKIPPED
Deprecated.
  1. static
  2. int
STATE_STOPPED
Deprecated.
  1. static
  2. int
STATE_TERMINATED
States that the activity has been terminated because of an external or internal request.
  1. static
  2. int
STATE_TERMINATING
Deprecated.
  1. static
  2. int
STATE_WAITING
Deprecated.
  1. static
  2. int
SUBSTITUTION_POLICY_NO_SUBSTITUTION
States that no substitution should take place.
  1. static
  2. int
SUBSTITUTION_POLICY_SELECT_USER_IF_PRESENT
States that only present users should act for absent users.
  1. static
  2. int
SUBSTITUTION_POLICY_SUBSTITUTE_IF_ABSENT
States that substitutes should act for absent users.

Method Summary

Modifier and Type Method and Description
  1. java.util.Calendar
getActivationTime()
Returns the time the task instance is set into the ready state.
  1. ACOID
getApplicationDefaultsID()
Returns the ID of the application component that specifies the defaults for the task.
  1. java.lang.String
getApplicationName()
Returns the name of the application the task is part of.
  1. int
getAssignmentType()
Returns whether the task can be assigned to a single person only or to multiple persons in parallel.
  1. int
getAutoDeletionMode()
Returns whether the task instance is automatically or conditionally deleted when it reaches an end execution state.
  1. java.lang.String
getCalendarName()
Returns the name of the calendar used, for example, for expiration calculations.
  1. java.util.Calendar
getCompletionTime()
Returns the time when the task instance reached an end state.
  1. OID
getContainmentContextID()
Returns the ID of the context which embraces the task instance.
  1. int
getContextAuthorizationOfOwner()
Returns the authorization rights of the task owner to the associated context.
  1. java.lang.String
getCustomText1()
Returns the value of the inline custom property named InlineCustomProperty.CUSTOM_TEXT_1.
  1. java.lang.String
getCustomText2()
Returns the value of the inline custom property named InlineCustomProperty.CUSTOM_TEXT_2.
  1. java.lang.String
getCustomText3()
Returns the value of the inline custom property named InlineCustomProperty.CUSTOM_TEXT_3.
  1. java.lang.String
getCustomText4()
Returns the value of the inline custom property named InlineCustomProperty.CUSTOM_TEXT_4.
  1. java.lang.String
getCustomText5()
Returns the value of the inline custom property named InlineCustomProperty.CUSTOM_TEXT_5.
  1. java.lang.String
getCustomText6()
Returns the value of the inline custom property named InlineCustomProperty.CUSTOM_TEXT_6.
  1. java.lang.String
getCustomText7()
Returns the value of the inline custom property named InlineCustomProperty.CUSTOM_TEXT_7.
  1. java.lang.String
getCustomText8()
Returns the value of the inline custom property named InlineCustomProperty.CUSTOM_TEXT_8.
  1. java.lang.String
getDefinitionName()
Returns the name of the task definition in the TEL.
  1. java.lang.String
getDefinitionNamespace()
Returns the namespace of the task definition in the TEL.
  1. java.util.Calendar
getDeletionTime()
Returns the time when the task is deleted.
  1. java.lang.String
getDescription(java.util.Locale arg0)
Returns the description in the specified locale.
  1. java.lang.String
getDisplayName(java.util.Locale arg0)
Returns the display name in the specified locale.
  1. java.util.Calendar
getDueTime()
Returns the time when the task is due.
  1. java.lang.String
getDurationUntilDeleted()
Returns the duration that the task is kept after it has reached an end state.
  1. java.lang.String
getDurationUntilDue()
Returns the duration that may pass before the task becomes due.
  1. java.lang.String
getDurationUntilExpires()
Returns the duration when the task expires once it is activated.
  1. java.lang.String
getEventHandlerName()
Returns the name of the associated event handler.
  1. java.util.Calendar
getExpirationTime()
Returns the time when the task instance expires or has expired.
  1. java.util.Calendar
getFirstActivationTime()
Returns the time the task instance is set into the ready state for the first time.
  1. TKIID
getFollowOnTaskID()
Returns the object ID of the next task instance in a sequence.
  1. TKIID
getID()
Returns the object identifier.
  1. int
getInheritedAuthorization()
States for a subtask which kind of authorization is inherited from a parent task.
  1. java.lang.String
getInputMessageTypeName()
Returns the name of the input message type.
  1. OID
getInvokedInstanceID()
Returns the object ID of the invoked service, for example, the object ID of a process, an activity, or task instance.
  1. int
getInvokedInstanceType()
Returns the type of service called by this task, that is, describes the type of the object ID returned by getInvokedInstanceID.
  1. java.lang.String
getJNDINameOfCalendar()
Returns the JNDI name of a user-defined calendar.
  1. java.lang.String
getJNDINameOfStaffPluginProvider()
Returns the JNDI name of a user-defined people directory configuation.
  1. int
getKind()
Returns the kind of the task.
  1. java.util.Calendar
getLastModificationTime()
Returns the last time a property of the task instance changed.
  1. java.util.Calendar
getLastStateChangeTime()
Returns the last time the state of the task instance changed.
  1. java.util.List
getLocalesOfDescriptions()
Returns the locales of all descriptions.
  1. java.util.List
getLocalesOfDisplayNames()
Returns the locales of all display names.
  1. java.lang.String
getName()
Returns the name of the task instance.
  1. java.lang.String
getNamespace()
Returns the namespace that categorizes the task instance.
  1. java.lang.String
getOriginator()
Returns the user ID of the user that created the task instance or on whose behalf the task instance was created.
  1. java.lang.String
getOutputMessageTypeName()
Returns the name of the output message type.
  1. java.lang.String
getOwner()
Returns the owner of the task instance.
  1. OID
getParentContextID()
Returns the object ID of the parent context of the task instance.
  1. int
getPositionInHierarchy()
Returns the position in a possible task instance hierarchy.
  1. java.lang.Integer
getPriority()
Returns the priority of the task instance.
  1. java.util.Calendar
getResumptionTime()
Returns the resumption time of the task instance if the task instance is suspended and is to be resumed automatically.
  1. java.lang.String
getStarter()
Returns the starter of the task instance.
  1. java.util.Calendar
getStartTime()
Returns the time when execution of the task started.
  1. int
getState()
Returns the state of the task instance.
  1. int
getSubstitutionPolicy()
Returns the substitution policy that takes place when people assignments are performed.
  1. TKTID
getTaskTemplateID()
Returns the object ID of the task template this instance is derived from.
  1. java.lang.String
getTaskTemplateName()
Returns the name of the task template this instance is derived from.
  1. TKIID
getTopLevelTaskID()
Returns the object ID of the topmost task instance in a hierarchy of tasks.
  1. java.lang.String
getType()
Returns the type of the task.
  1. java.lang.String
getWorkBasketName()
Returns the name of the work basket the task belongs to.
  1. boolean
isAdHoc()
States whether the task has been created ad hoc.
  1. boolean
isBusinessRelevanceUpdateable()
Signals whether the business relevance property can be changed for the kind and current state of the object.
  1. boolean
isBusinessRelevant()
States whether the task is a business relevant or an "auxiliary" step.
  1. boolean
isChild()
States for stand-alone tasks whether the task instance runs dependently of its parent or not.
  1. boolean
isContextAuthorizationOfOwnerUpdateable()
Signals whether the context authorization property can be changed for the kind and current state of the object.
  1. boolean
isDeletionTimeUpdateable()
Signals whether the deletion time property can be changed for the kind and current state of the object.
  1. boolean
isDescriptionUpdateable()
Signals whether the description property can be changed for the kind and current state of the object.
  1. boolean
isDisplayNameUpdateable()
Signals whether the display name property can be changed for the kind and current state of the object.
  1. boolean
isDueTimeUpdateable()
Signals whether the due time property can be changed for the kind and current state of the object.
  1. boolean
isDurationUntilDeletedUpdateable()
Signals whether the duration until deleted property can be changed for the kind and current state of the object.
  1. boolean
isDurationUntilDueUpdateable()
Signals whether the duration until due property can be changed for the kind and current state of the object.
  1. boolean
isDurationUntilExpiresUpdateable()
Signals whether the duration until expires property can be changed for the kind and current state of the object.
  1. boolean
isEscalated()
States whether an escalation occurred.
  1. boolean
isEscalatedUpdateable()
Signals whether the isEscalated property can be changed for the kind and current state of the object.
  1. boolean
isEventHandlerNameUpdateable()
Signals whether the event handler name property can be changed for the kind and current state of the object.
  1. boolean
isExpirationTimeUpdateable()
Signals whether the expiration time property can be changed for the kind and current state of the object.
  1. boolean
isInline()
States whether the task is an inline task or not.
  1. boolean
isNamespaceUpdateable()
Signals whether the namespace property can be changed for the kind and current state of the object.
  1. boolean
isNameUpdateable()
Signals whether the name property can be changed for the kind and current state of the object.
  1. boolean
isParentContextIDUpdateable()
Signals whether the parent context ID property can be changed for the kind and current state of the object.
  1. boolean
isPriorityUpdateable()
Signals whether the priority property can be changed for the kind and current state of the object.
  1. boolean
isRead()
States whether the task instance is marked read.
  1. boolean
isReadUpdateable()
Signals whether the isRead property can be changed for the kind and current state of the object.
  1. boolean
isSupportsClaimIfSuspendedUpdateable()
Signals whether the supports claim suspended property can be changed for the kind and current state of the object.
  1. boolean
isSupportsDelegationUpdateable()
Signals whether the supports delegation property can be changed for the kind and current state of the object.
  1. boolean
isSupportsFollowOnTasksUpdateable()
Signals whether the supports follow on task property can be changed for the kind and current state of the object.
  1. boolean
isSupportsSubTasksUpdateable()
Signals whether the supports sub task property can be changed for the kind and current state of the object.
  1. boolean
isSuspended()
States whether the task instance is suspended or not.
  1. boolean
isTransferredToWorkBasket()
States whether the task instance had been transferred to some work basket.
  1. boolean
isTypeUpdateable()
Signals whether the type property can be changed for the kind and current state of the object.
  1. boolean
isWaitingForSubTask()
States whether the task is waiting for the completion of a subtask.
  1. boolean
isWorkBasketNameUpdateable()
Signals whether the work basket property can be changed for the kind and current state of the object.
  1. void
setBusinessRelevance(boolean businessRelevance)
Sets whether the task is a business relevant or an "auxiliary" step.
  1. void
setContextAuthorizationOfOwner(int contextAuthorization)
Sets the authorization rights of the task owner to the associated context.
  1. void
setDeletionTime(java.util.Calendar deletionTime)
Sets the time when the task is to be deleted.
  1. void
setDescription(java.lang.String description,java.util.Locale locale)
Sets the description in the specified locale.
  1. void
setDisplayName(java.lang.String displayName,java.util.Locale locale)
Sets the display name in the specified locale.
  1. void
setDueTime(java.util.Calendar dueTime)
Sets the time the task is expected to become due.
  1. void
setDurationUntilDeleted(java.lang.String durationUntilDeleted)
Sets the duration that passes until the task is deleted after it reached an end state.
  1. void
setDurationUntilDue(java.lang.String durationUntilDue)
Sets the duration the task is expected to become due.
  1. void
setDurationUntilExpires(java.lang.String durationUntilExpires)
Sets the duration that may pass until the task expires.
  1. void
setEscalated(boolean isEscalated)
Sets the escalation state of the task, that is, allows to manually escalate a task.
  1. void
setEventHandlerName(java.lang.String eventHandlerName)
Sets the name of the associated event handler.
  1. void
setExpirationTime(java.util.Calendar expirationTime)
Sets the time when the task expires.
  1. void
setName(java.lang.String name)
Sets the name of the task instance.
  1. void
setNamespace(java.lang.String namespace)
Sets the namespace for the task name and type properties.
  1. void
setParentContextID(OID parentContextID)
Sets the object ID of the parent context.
  1. void
setPriority(java.lang.Integer priority)
Sets the priority of the task instance.
  1. void
setRead(boolean isRead)
Marks the task instance as read.
  1. void
setSupportsClaimIfSuspended(boolean supportsClaimSuspended)
Sets whether the task can be claimed if it is suspended.
  1. void
setSupportsDelegation(boolean supportsDelegation)
Sets whether the task supports delegation, for example, by transferring work items.
  1. void
setSupportsFollowOnTasks(boolean supportsFollowOnTask)
Sets whether the task supports the creation of follow-on tasks.
  1. void
setSupportsSubTasks(boolean supportsSubTask)
Sets whether the task supports the creation of subtasks.
  1. void
setType(java.lang.String type)
Sets the type of the task instance.
  1. void
setWorkBasketName(java.lang.String workBasket)
Sets the name of the work basket the task belongs to.
  1. boolean
supportsAutomaticClaim()
States whether the task is claimed automatically when it becomes ready.
  1. boolean
supportsClaimIfSuspended()
States whether the task can be claimed even if it is suspended.
  1. boolean
supportsDelegation()
States whether the task supports delegation, for example, by transferring work items.
  1. boolean
supportsFollowOnTasks()
States whether the task supports the creation of follow-on tasks.
  1. boolean
supportsSubTasks()
States whether the task supports the creation of subtasks.

Field Detail

  1. static final java.lang.String COPYRIGHT
See Also:

STATE_FINISHED

  1. static final int STATE_FINISHED
States that the activity finished execution successfully.
See Also:

STATE_PROCESSING_UNDO

  1. static final int STATE_PROCESSING_UNDO
Deprecated.
States that the activity associated to the task is retried due to a transaction rollback and that the activity associated to the task waits for the microflow that it invokes to complete its compensation actions for the first invoke.
See Also:

STATE_SKIPPED

  1. static final int STATE_SKIPPED
Deprecated.
States that the activity associated to the task has been skipped because navigation followed a a different control path.
See Also:

STATE_FAILED

  1. static final int STATE_FAILED
States that the activity failed to execute.
See Also:

STATE_CLAIMED

  1. static final int STATE_CLAIMED
States that the activity has been claimed.
See Also:

STATE_TERMINATING

  1. static final int STATE_TERMINATING
Deprecated.
States that the activity associated to the task is terminating. The activity associated to the task is set to the Terminated execution state when all contained running or terminating activities end.
See Also:

STATE_RUNNING

  1. static final int STATE_RUNNING
States that the activity is running.
See Also:

STATE_TERMINATED

  1. static final int STATE_TERMINATED
States that the activity has been terminated because of an external or internal request.
See Also:

STATE_READY

  1. static final int STATE_READY
States that the activity is ready to be started or claimed.
See Also:

STATE_FORWARDED

  1. static final int STATE_FORWARDED
States that the task has been completed with a follow-on task.
See Also:

STATE_FAILING

  1. static final int STATE_FAILING
Deprecated.
States that the activity associated to the task is failing. The activity associated to the task is set to the Failed execution state when all contained running or terminating activities end.
See Also:

STATE_EXPIRED

  1. static final int STATE_EXPIRED
States that the activity ended because its allowed duration timed-out.
See Also:

STATE_INACTIVE

  1. static final int STATE_INACTIVE
States that the activity has not yet been scheduled for execution.
See Also:

STATE_WAITING

  1. static final int STATE_WAITING
Deprecated.
States that a receive or pick activity associated to the task is waiting for a corresponding event to occur.
See Also:

STATE_STOPPED

  1. static final int STATE_STOPPED
Deprecated.
States that the activity associated to the task is stopped because of a failure. A process administrator can repair the activity associated to the task by either calling forceRetry or forceComplete.
See Also:

KIND_PARTICIPATING

  1. static final int KIND_PARTICIPATING
States that the task is processed by humans but tracked by the Human Task Manager.
See Also:

KIND_HUMAN

  1. static final int KIND_HUMAN
States that the task is created and processed by humans.
See Also:

KIND_ADMINISTRATIVE

  1. static final int KIND_ADMINISTRATIVE
States that the task is an administration task.
See Also:

KIND_ORIGINATING

  1. static final int KIND_ORIGINATING
States that the task is a task whose service is invoked and tracked by the Human Task Manager.
See Also:

KIND_WPC_STAFF_ACTIVITY

  1. static final int KIND_WPC_STAFF_ACTIVITY
States that the task is processed by humans but controlled by the Business Flow Manager. (deprecated)
See Also:

AUTH_READER

  1. static final int AUTH_READER
States that operations can be executed on the associated context object that require Reader authority, for example, reading the properties of a process instance.
See Also:

AUTH_NONE

  1. static final int AUTH_NONE
States that no operations can be executed on the associated context.
See Also:

HIERARCHY_POSITION_SUB_TASK

  1. static final int HIERARCHY_POSITION_SUB_TASK
The task is a subtask in the task collaboration hierarchy.
See Also:

HIERARCHY_POSITION_FOLLOW_ON_TASK

  1. static final int HIERARCHY_POSITION_FOLLOW_ON_TASK
The task is a follow-on task in the task collaboration hierarchy.
See Also:

HIERARCHY_POSITION_TOP_TASK

  1. static final int HIERARCHY_POSITION_TOP_TASK
The task is a toplevel task in the task collaboration hierarchy.
See Also:

AUTO_DELETE_ON_SUCCESSFUL_COMPLETION

  1. static final int AUTO_DELETE_ON_SUCCESSFUL_COMPLETION
States that the task instance is deleted when it reaches the FINISHED state. If the task instance completes successfully, then it is deleted when the duration until deletion has passed. If the task instance did not complete successfully, it it is not deleted regardless of the specification of the duration until deletion.
See Also:

AUTO_DELETE_ON_COMPLETION

  1. static final int AUTO_DELETE_ON_COMPLETION
States that a completed task instance is deleted when the duration until deletion has passed.
See Also:

SUBSTITUTION_POLICY_NO_SUBSTITUTION

  1. static final int SUBSTITUTION_POLICY_NO_SUBSTITUTION
States that no substitution should take place. All users resolved by people assignment criteria are returned.
See Also:

SUBSTITUTION_POLICY_SUBSTITUTE_IF_ABSENT

  1. static final int SUBSTITUTION_POLICY_SUBSTITUTE_IF_ABSENT
States that substitutes should act for absent users. If all substitutes are absent or explicitely excluded by people assignment criteria, default people assignments are performed, for example, task administrators become potential owners.
See Also:

SUBSTITUTION_POLICY_SELECT_USER_IF_PRESENT

  1. static final int SUBSTITUTION_POLICY_SELECT_USER_IF_PRESENT
States that only present users should act for absent users. If all users and their subsitutes are absent or excluded by people assignment criteria, users originally resolved are returned.
See Also:

ASSIGNMENT_TYPE_PARALLEL

  1. static final int ASSIGNMENT_TYPE_PARALLEL
States that the task can be assigned to multiple persons in parallel.
See Also:

ASSIGNMENT_TYPE_SINGLE

  1. static final int ASSIGNMENT_TYPE_SINGLE
States that the task can only be assigned to a single person.
See Also:

INHERITED_AUTH_NONE

  1. static final int INHERITED_AUTH_NONE
States that no authorization is inherited from parent tasks by this subtask.
See Also:

INHERITED_AUTH_ADMINISTRATOR

  1. static final int INHERITED_AUTH_ADMINISTRATOR
States that administrator authorizations of all parent tasks in the parent task hierarchy are inherited by this subtask.
See Also:

INHERITED_AUTH_ALL

  1. static final int INHERITED_AUTH_ALL
States that, additionally to the administrators, all other authorizations for parent tasks in the parent task hierarchy are inherited as reader authorization by this subtask. For example, reader authorizations, potential_owner authorizations etc are all inherited as reader authorizations.
See Also:

INVOKED_INSTANCE_TYPE_PROCESS

  1. static final int INVOKED_INSTANCE_TYPE_PROCESS
States that the task invoked a business process,
See Also:

INVOKED_INSTANCE_TYPE_TASK

  1. static final int INVOKED_INSTANCE_TYPE_TASK
States that the task invoked a stand-alone task.
See Also:

INVOKED_INSTANCE_TYPE_CHILD_TASK

  1. static final int INVOKED_INSTANCE_TYPE_CHILD_TASK
States that the activity calls a stand-alone task that has "child" autonomy.
See Also:

INVOKED_INSTANCE_TYPE_NOT_SET

  1. static final int INVOKED_INSTANCE_TYPE_NOT_SET
States that the activity does not call a process or inline task, or does not call a process or stand-alone task that have "child" autonomy.
See Also:

INVOKED_INSTANCE_TYPE_EVENT

  1. static final int INVOKED_INSTANCE_TYPE_EVENT
States that the task invoked an activity in an event handler or an activity which is not yet ready to receive the event.
See Also:

INVOKED_INSTANCE_TYPE_ACTIVITY

  1. static final int INVOKED_INSTANCE_TYPE_ACTIVITY
States that the task invoked an activity in a business process,
See Also:

INVOKED_INSTANCE_TYPE_INLINE_TASK

  1. static final int INVOKED_INSTANCE_TYPE_INLINE_TASK
States that the activity calls an inline human task.
See Also:

INVOKED_INSTANCE_TYPE_CHILD_PROCESS

  1. static final int INVOKED_INSTANCE_TYPE_CHILD_PROCESS
States that the activity calls a long-running process that has "child" autonomy. The process containing this activity and the process called are both long-running.
See Also:

Method Detail

getID

  1. TKIID getID()
Returns the object identifier.

getState

  1. int getState()
Returns the state of the task instance. Possible states are: STATE_INACTIVE, STATE_READY, STATE_RUNNING, STATE_FINISHED, STATE_FAILED, STATE_TERMINATED, STATE_CLAIMED, STATE_EXPIRED, STATE_FORWARDED.

isSuspended

  1. boolean isSuspended()
States whether the task instance is suspended or not. Returns true when the task is suspended. Returns false when the task is not suspended.

isAdHoc

  1. boolean isAdHoc()
States whether the task has been created ad hoc. True states that the task has been created ad hoc. False states that the task has been derived from a task template.

isInline

  1. boolean isInline()
States whether the task is an inline task or not. True states that the task is an inline task. False states that the task is not an inline task.

getActivationTime

  1. java.util.Calendar getActivationTime( )
Returns the time the task instance is set into the ready state. If the task is not yet activated, null is returned. The activation time changes each time the task is set into the ready state, for example, when it is claimed and when the claim is cancelled.

getFirstActivationTime

  1. java.util.Calendar getFirstActivationTime( )
Returns the time the task instance is set into the ready state for the first time. If the task is not yet activated, null is returned.

getCompletionTime

  1. java.util.Calendar getCompletionTime( )
Returns the time when the task instance reached an end state. If the task instance is not yet completed, null is returned.

getLastModificationTime

  1. java.util.Calendar getLastModificationTime( )
Returns the last time a property of the task instance changed.

getLastStateChangeTime

  1. java.util.Calendar getLastStateChangeTime( )
Returns the last time the state of the task instance changed.

getExpirationTime

  1. java.util.Calendar getExpirationTime( )
Returns the time when the task instance expires or has expired. Returns null when there is no expiration time.

This time is either set explicitely or calculated from the duration until expiration time.


getOriginator

  1. java.lang.String getOriginator( )
Returns the user ID of the user that created the task instance or on whose behalf the task instance was created. For example, returns the starter of a BPEL process.

getStarter

  1. java.lang.String getStarter()
Returns the starter of the task instance. Returns null when a starter is not assigned or when the task is not an invocation aka originating task instance.

getOwner

  1. java.lang.String getOwner()
Returns the owner of the task instance. Returns null when an owner is not assigned.

getContainmentContextID

  1. OID getContainmentContextID()
Returns the ID of the context which embraces the task instance. This ID is used for task instance deletion. In other words, when the context is deleted, the task instance is also deleted. For example, a task instance associated to a BPEL process returns the containing process instance ID.

getParentContextID

  1. OID getParentContextID()
Returns the object ID of the parent context of the task instance. For example, the parent of a human task activity (staff activity), that is, the parent of the associated inline to-do task (participating task), is the object ID of the human task activity (AIID). The parent context ID of a subtask is the object ID of the parent task (TKIID). The parent context ID of a stand-alone task is the object ID of the associated application component (ACOID).

getName

  1. java.lang.String getName()
Returns the name of the task instance. Returns null if there is no name.

getKind

  1. int getKind()
Returns the kind of the task.

Possible values are: KIND_HUMAN, KIND_ORIGINATING, KIND_PARTICIPATING, KIND_ADMINISTRATIVE, KIND_WPC_STAFF_ACTIVITY.


getDisplayName

  1. java.lang.String getDisplayName( java.util.Locale arg0)
Returns the display name in the specified locale. Returns the display name in the default locale when a display name in the specified locale is not found.

If no locale is specified, the display name in the default locale is returned or any available display name, if there is only a single display name.

Parameters:
arg0 - The locale for which the display name is to be provided.

getLocalesOfDisplayNames

  1. java.util.List getLocalesOfDisplayNames( )
Returns the locales of all display names. Returns an empty list when there are no display names.

getDescription

  1. java.lang.String getDescription( java.util.Locale arg0)
Returns the description in the specified locale. Returns the description in the default locale when a description in the specified locale is not found.

If no locale is specified, the description in the default locale is returned or any available description, if there is only a single description. References to variable members specified as %variableName.memberName% are resolved.

Parameters:
arg0 - The locale for which the description is to be provided.

getLocalesOfDescriptions

  1. java.util.List getLocalesOfDescriptions( )
Returns the locales of all descriptions. Returns an empty list when there are no descriptions.

isBusinessRelevant

  1. boolean isBusinessRelevant()
States whether the task is a business relevant or an "auxiliary" step. A business relevant step can, for example, be logged into the audit trail.

getInputMessageTypeName

  1. java.lang.String getInputMessageTypeName( )
Returns the name of the input message type. Note that the structure of the input message type name is a QName.

getOutputMessageTypeName

  1. java.lang.String getOutputMessageTypeName( )
Returns the name of the output message type. Note that the structure of the output message type name is a QName.

getApplicationDefaultsID

  1. ACOID getApplicationDefaultsID( )
Returns the ID of the application component that specifies the defaults for the task. If the task is derived from a template, then the information in the template overwrites the defaults provided by the application component.

supportsAutomaticClaim

  1. boolean supportsAutomaticClaim( )
States whether the task is claimed automatically when it becomes ready. Note that the task is claimed automatically only when there is a single potential owner.

getCalendarName

  1. java.lang.String getCalendarName( )
Returns the name of the calendar used, for example, for expiration calculations. If not set, null is returned and the WebSphere default calendar is used. If a JNDI name for a user-defined calendar is specified, then the calendar name is the name of a method implementing that user-defined calendar - see getJNDINameOfCalendar.

For details on calendars refer to the WebSphere Application Server documentation.


getJNDINameOfCalendar

  1. java.lang.String getJNDINameOfCalendar( )
Returns the JNDI name of a user-defined calendar. If not set, null is returned and a WebSphere supported calendar is used - see getCalendarName.

For details on calendars refer to the WebSphere Application Server documentation.


getDueTime

  1. java.util.Calendar getDueTime()
Returns the time when the task is due. The due time is either set explicitely or calculated from the duration until due time.

If the due time is not set, null is returned.

Note that the task manager does not check whether a task is overdue. Instead, the escalation concept can be used to trigger notifications.


getDurationUntilDeleted

  1. java.lang.String getDurationUntilDeleted( )
Returns the duration that the task is kept after it has reached an end state. When the duration has passed, it gets deleted.

A specification TimerSpecification.DURATION_IMMEDIATE means that the task is deleted immediately. A specification TimerSpecification.DURATION_INFINITE means that the task is not deleted automatically. A specification TimerSpecification.DURATION_NOT_USED means that the deletion time is set explicitely - see setDeletionTime.

If not set, then stand-alone invocation or collaboration tasks are kept whereas stand-alone to-do tasks are deleted immediately. Collaboration, invocation, and to-do tasks are also known as human, originating, and participating tasks.

Inline tasks are always deleted together with their container, for example, the process instance.

Note that this setting is checked depending on the automatic deletion mode - AutoDeletionMode.


getDurationUntilDue

  1. java.lang.String getDurationUntilDue( )
Returns the duration that may pass before the task becomes due. See setDurationUntilDue or setDueTime.

A specification TimerSpecification.DURATION_IMMEDIATE means that the task is due immediately. A specification TimerSpecification.DURATION_INFINITE means that the task does not become due. A specification TimerSpecification.DURATION_NOT_USED means that the due time is set explicitely - see setDueTime.

This property is a WebSphere Application Server calendar expression according to the calendar referenced by its name and JNDI name.


getDurationUntilExpires

  1. java.lang.String getDurationUntilExpires( )
Returns the duration when the task expires once it is activated.

A specification TimerSpecification.DURATION_IMMEDIATE means that the task expires immediately. A specification TimerSpecification.DURATION_INFINITE means that the task does not expire. A specification TimerSpecification.DURATION_NOT_USED means that the expiration time is set explicitely - see setExpirationTime.

This property is a WebSphere Application Server calendar expression according to the calendar referenced by its name and JNDI name.


isEscalated

  1. boolean isEscalated()
States whether an escalation occurred. Refer to setEscalated for setting the value explicitely.

getJNDINameOfStaffPluginProvider

  1. java.lang.String getJNDINameOfStaffPluginProvider( )
Returns the JNDI name of a user-defined people directory configuation.

getNamespace

  1. java.lang.String getNamespace()
Returns the namespace that categorizes the task instance.

getPriority

  1. java.lang.Integer getPriority()
Returns the priority of the task instance. No special meaning is associated with this property. Escalations may, however, increase the priority of associated tasks. A caller can, for example, use it for sorting a list of tasks.

getStartTime

  1. java.util.Calendar getStartTime( )
Returns the time when execution of the task started. This is, for example, the time when a collaboration or to-do task is claimed or when an invocation task starts running.

supportsDelegation

  1. boolean supportsDelegation()
States whether the task supports delegation, for example, by transferring work items.

supportsSubTasks

  1. boolean supportsSubTasks()
States whether the task supports the creation of subtasks.

getTopLevelTaskID

  1. TKIID getTopLevelTaskID()
Returns the object ID of the topmost task instance in a hierarchy of tasks. If the current tasks instance is the topmost task instance itself, the object ID of the current task instance is returned.

getFollowOnTaskID

  1. TKIID getFollowOnTaskID()
Returns the object ID of the next task instance in a sequence. If there is no follow-on task instance, null is returned.

getTaskTemplateID

  1. TKTID getTaskTemplateID()
Returns the object ID of the task template this instance is derived from. Returns null when the task is not derived from a template.

getTaskTemplateName

  1. java.lang.String getTaskTemplateName( )
Returns the name of the task template this instance is derived from. Returns null when the task is not derived from a template.

getType

  1. java.lang.String getType()
Returns the type of the task. Returns null when there is no associated type.

isWaitingForSubTask

  1. boolean isWaitingForSubTask()
States whether the task is waiting for the completion of a subtask.

getContextAuthorizationOfOwner

  1. int getContextAuthorizationOfOwner( )
Returns the authorization rights of the task owner to the associated context.

Possible values are: AUTH_NONE, AUTH_READER.


supportsClaimIfSuspended

  1. boolean supportsClaimIfSuspended( )
States whether the task can be claimed even if it is suspended. True states that the task can be claimed if it is suspended. False states that the task cannot be claimed if it is suspended.

getEventHandlerName

  1. java.lang.String getEventHandlerName( )
Returns the name of the associated event handler. Returns null if there is no event handler.

getPositionInHierarchy

  1. int getPositionInHierarchy()
Returns the position in a possible task instance hierarchy.

Values are: HIERARCHY_POSITION_TOP_TASK, HIERARCHY_POSITION_SUB_TASK, HIERARCHY_POSITION_FOLLOW_ON_TASK.


getResumptionTime

  1. java.util.Calendar getResumptionTime( )
Returns the resumption time of the task instance if the task instance is suspended and is to be resumed automatically. If the task instance is not suspended or not to be resumed automatically, null is returned.
Since:
6.1.

getAutoDeletionMode

  1. int getAutoDeletionMode()
Returns whether the task instance is automatically or conditionally deleted when it reaches an end execution state. Refer to AutoDeletionMode for the possible deletion modes.

End execution states are STATE_FINISHED, STATE_FAILED, STATE_TERMINATED, or STATE_EXPIRED.

Note that the task instance is actually deleted depending on the duration until deletion specification - refer to getDurationUntilDeleted.

Since:
6.1.

getDefinitionName

  1. java.lang.String getDefinitionName( )
Returns the name of the task definition in the TEL.
Since:
6.1.

getDefinitionNamespace

  1. java.lang.String getDefinitionNamespace( )
Returns the namespace of the task definition in the TEL.
Since:
6.1.

getSubstitutionPolicy

  1. int getSubstitutionPolicy()
Returns the substitution policy that takes place when people assignments are performed.

Possible substitution policies are SUBSTITUTION_POLICY_NO_SUBSTITUTION, SUBSTITUTION_POLICY_SUBSTITUTE_IF_ABSENT, SUBSTITUTION_POLICY_SELECT_USER_IF_PRESENT.

Since:
6.1.

supportsFollowOnTasks

  1. boolean supportsFollowOnTasks()
States whether the task supports the creation of follow-on tasks.
Since:
6.1.

getApplicationName

  1. java.lang.String getApplicationName( )
Returns the name of the application the task is part of.
Since:
6.1.

isChild

  1. boolean isChild()
States for stand-alone tasks whether the task instance runs dependently of its parent or not. True states that the stand-alone task is a child of its parent. False states that the stand-alone task is no child of its parent. When there is no parent or when the task is an inline task, false is returned.
Since:
6.2.

getDeletionTime

  1. java.util.Calendar getDeletionTime( )
Returns the time when the task is deleted. The deletion time is either set explicitely or calculated from the duration until deletion time.

If the deletion time is not set, null is returned.

Since:
6.2.

getAssignmentType

  1. int getAssignmentType()
Returns whether the task can be assigned to a single person only or to multiple persons in parallel.

Possible assignment types are ASSIGNMENT_TYPE_SINGLE, ASSIGNMENT_TYPE_PARALLEL.

Since:
7.0.

getInheritedAuthorization

  1. int getInheritedAuthorization()
States for a subtask which kind of authorization is inherited from a parent task.

Possible values are INHERITED_AUTH_NONE, INHERITED_AUTH_ADMINISTRATOR, INHERITED_AUTH_ALL.

Since:
7.0.

getInvokedInstanceID

  1. OID getInvokedInstanceID()
Returns the object ID of the invoked service, for example, the object ID of a process, an activity, or task instance. Returns null for invoked services run by an IBM Websphere Process Server Version less than 7.0, when the task called is not an invocation task. or when the invoked service is unknown to the Human Task Manager.

You can use getInvokedInstanceType to determine whether the object ID returned is a PIID, AIID, or TKIID.

Since:
7.0.

getInvokedInstanceType

  1. int getInvokedInstanceType()
Returns the type of service called by this task, that is, describes the type of the object ID returned by getInvokedInstanceID. Using this method, you can determine whether a PIID, AIID, or TKIID is returned.

States INVOKED_INSTANCE_TYPE_NOT_SET when no object ID is returned by getInvokedInstanceID.

Since:
7.0.

isRead

  1. boolean isRead()
States whether the task instance is marked read. True states that the task is marked read. False states that the task is not marked read. Refer to setRead or setTaskRead for setting the value.
Since:
7.0.

isTransferredToWorkBasket

  1. boolean isTransferredToWorkBasket( )
States whether the task instance had been transferred to some work basket. True states that the task had been transferred to some work basket. False states that the task had not been transferred to some work basket.
Since:
7.0.

getWorkBasketName

  1. java.lang.String getWorkBasketName( )
Returns the name of the work basket the task belongs to. Returns null if the task does not belong to any work basket. Refer to setWorkBasketName for setting the value.
Since:
7.0.

getCustomText1

  1. java.lang.String getCustomText1( )
Returns the value of the inline custom property named InlineCustomProperty.CUSTOM_TEXT_1. Refer to setInlineCustomProperty for setting the value.
Since:
7.5.1.

getCustomText2

  1. java.lang.String getCustomText2( )
Returns the value of the inline custom property named InlineCustomProperty.CUSTOM_TEXT_2. Refer to setInlineCustomProperty for setting the value.
Since:
7.5.1.

getCustomText3

  1. java.lang.String getCustomText3( )
Returns the value of the inline custom property named InlineCustomProperty.CUSTOM_TEXT_3. Refer to setInlineCustomProperty for setting the value.
Since:
7.5.1.

getCustomText4

  1. java.lang.String getCustomText4( )
Returns the value of the inline custom property named InlineCustomProperty.CUSTOM_TEXT_4. Refer to setInlineCustomProperty for setting the value.
Since:
7.5.1.

getCustomText5

  1. java.lang.String getCustomText5( )
Returns the value of the inline custom property named InlineCustomProperty.CUSTOM_TEXT_5. Refer to setInlineCustomProperty for setting the value.
Since:
7.5.1.

getCustomText6

  1. java.lang.String getCustomText6( )
Returns the value of the inline custom property named InlineCustomProperty.CUSTOM_TEXT_6. Refer to setInlineCustomProperty for setting the value.
Since:
7.5.1.

getCustomText7

  1. java.lang.String getCustomText7( )
Returns the value of the inline custom property named InlineCustomProperty.CUSTOM_TEXT_7. Refer to setInlineCustomProperty for setting the value.
Since:
7.5.1.

getCustomText8

  1. java.lang.String getCustomText8( )
Returns the value of the inline custom property named InlineCustomProperty.CUSTOM_TEXT_8. Refer to setInlineCustomProperty for setting the value.
Since:
7.5.1.

setDisplayName

  1. void setDisplayName(java.lang.String displayName,
  2. java.util.Locale locale)
Sets the display name in the specified locale.

Parameters:
displayName - The new value of the display name.
locale - The locale for which the display name is set.

isDisplayNameUpdateable

  1. boolean isDisplayNameUpdateable( )
Signals whether the display name property can be changed for the kind and current state of the object.

setDescription

  1. void setDescription(java.lang.String description,
  2. java.util.Locale locale)
Sets the description in the specified locale.

Parameters:
description - The new value of the description.
locale - The locale for which the description is set.

isDescriptionUpdateable

  1. boolean isDescriptionUpdateable( )
Signals whether the description property can be changed for the kind and current state of the object.

setSupportsClaimIfSuspended

  1. void setSupportsClaimIfSuspended( boolean supportsClaimSuspended)
Sets whether the task can be claimed if it is suspended.

Parameters:
supportsClaimSuspended - An indication whether the task can be claimed even if it is suspended. True states that the task can be claimed if it is suspended. False states that the task cannot be claimed if it is suspended.

isSupportsClaimIfSuspendedUpdateable

  1. boolean isSupportsClaimIfSuspendedUpdateable( )
Signals whether the supports claim suspended property can be changed for the kind and current state of the object.

setContextAuthorizationOfOwner

  1. void setContextAuthorizationOfOwner( int contextAuthorization)
Sets the authorization rights of the task owner to the associated context.

Parameters:
contextAuthorization - The authorization rights of the task owner for the associated context.

Possible values are: AUTH_NONE, AUTH_READER.


isContextAuthorizationOfOwnerUpdateable

  1. boolean isContextAuthorizationOfOwnerUpdateable( )
Signals whether the context authorization property can be changed for the kind and current state of the object.

setName

  1. void setName(java.lang.String name)
Sets the name of the task instance.

Parameters:
name - The new name of the task instance.

isNameUpdateable

  1. boolean isNameUpdateable()
Signals whether the name property can be changed for the kind and current state of the object.

setNamespace

  1. void setNamespace(java.lang.String namespace)
Sets the namespace for the task name and type properties.

Parameters:
namespace - The new namespace of the task instance.

isNamespaceUpdateable

  1. boolean isNamespaceUpdateable()
Signals whether the namespace property can be changed for the kind and current state of the object.

setDurationUntilDue

  1. void setDurationUntilDue(java.lang.String durationUntilDue)
Sets the duration the task is expected to become due. The due time is calculated once the task reaches the ready state, or recalculated when the ready state is already reached or passed.

This value is also used when restarting the task instance.

Note that the due time is informal only and not used for scheduling.

Parameters:
durationUntilDue - The duration the task instance is expected to become due. The format of the duration depends on the calendar that is used and may, for example, be "5days". Additionally, TimerSpecification.DURATION_IMMEDIATE may be specified to indicate that the task is due immediately and TimerSpecification.DURATION_INFINITE to indicate that the task has no due time.

isDurationUntilDueUpdateable

  1. boolean isDurationUntilDueUpdateable( )
Signals whether the duration until due property can be changed for the kind and current state of the object.

setDueTime

  1. void setDueTime(java.util.Calendar dueTime)
Sets the time the task is expected to become due. Note that the due time is informal only and not used for scheduling.

Note, however, that updating this time prevents a duration until due to be calculated when restarting the task instance.

Parameters:
dueTime - The time when the task instance is expected to become due. Note that setting the due time to null is not accepted by the update method, that is, an exception will be thrown,
Since:
7.0.

isDueTimeUpdateable

  1. boolean isDueTimeUpdateable()
Signals whether the due time property can be changed for the kind and current state of the object.

setDurationUntilDeleted

  1. void setDurationUntilDeleted(java.lang.String durationUntilDeleted)
Sets the duration that passes until the task is deleted after it reached an end state. The deletion time is calculated once the task reaches an end state, or recalculated when the task is already in an end state.

This value is also used to set up a deletion timer when restarting the task instance.

Parameters:
durationUntilDeleted - The duration that passes until the task instance is deleted. The format of the duration depends on the calendar that is used and may, for example, be "5days". Additionally, TimerSpecification.DURATION_IMMEDIATE may be specified to indicate that the task is to be deleted immediately and TimerSpecification.DURATION_INFINITE to indicate that the task is deleted manually.

isDurationUntilDeletedUpdateable

  1. boolean isDurationUntilDeletedUpdateable( )
Signals whether the duration until deleted property can be changed for the kind and current state of the object.

setDeletionTime

  1. void setDeletionTime(java.util.Calendar deletionTime)
Sets the time when the task is to be deleted. See also getDeletionTime.

Note, however, that updating this time prevents a duration until deletion to be calculated when restarting the task instance. A deletion timer is then not set up.

Parameters:
deletionTime - The time when the task instance is automatically deleted. Note that setting the deletion time to null is not accepted by the update method, that is, an exception will be thrown,
Since:
7.0.

isDeletionTimeUpdateable

  1. boolean isDeletionTimeUpdateable( )
Signals whether the deletion time property can be changed for the kind and current state of the object.

setPriority

  1. void setPriority(java.lang.Integer priority)
Sets the priority of the task instance. No special meaning is associated with this property. But a caller can, for example, use it for sorting a list of tasks.

Parameters:
priority - The priority of the task instance.

isPriorityUpdateable

  1. boolean isPriorityUpdateable()
Signals whether the priority property can be changed for the kind and current state of the object.

setType

  1. void setType(java.lang.String type)
Sets the type of the task instance.

Parameters:
type - The type of the task instance.

isTypeUpdateable

  1. boolean isTypeUpdateable()
Signals whether the type property can be changed for the kind and current state of the object.

setSupportsDelegation

  1. void setSupportsDelegation(boolean supportsDelegation)
Sets whether the task supports delegation, for example, by transferring work items.

Parameters:
supportsDelegation - An indication whether the task instance supports delegation. True states that the task supports delegation. False states that the task does not support delegation.

isSupportsDelegationUpdateable

  1. boolean isSupportsDelegationUpdateable( )
Signals whether the supports delegation property can be changed for the kind and current state of the object.

setSupportsSubTasks

  1. void setSupportsSubTasks(boolean supportsSubTask)
Sets whether the task supports the creation of subtasks.

Parameters:
supportsSubTask - An indication whether the task instance supports the creation of subtasks. True states that the task supports the creation of subtasks. False states that the task does not support the creation of subtasks.

isSupportsSubTasksUpdateable

  1. boolean isSupportsSubTasksUpdateable( )
Signals whether the supports sub task property can be changed for the kind and current state of the object.

setBusinessRelevance

  1. void setBusinessRelevance(boolean businessRelevance)
Sets whether the task is a business relevant or an "auxiliary" step. A business relevant step can, for example, be logged into the audit trail.

Parameters:
businessRelevance - An indication whether the task instance is business relevant. True states that the task is business relevant. False states that the task is not business relevant.

isBusinessRelevanceUpdateable

  1. boolean isBusinessRelevanceUpdateable( )
Signals whether the business relevance property can be changed for the kind and current state of the object.

setEventHandlerName

  1. void setEventHandlerName(java.lang.String eventHandlerName)
Sets the name of the associated event handler.

Parameters:
eventHandlerName - The name of the event handler to be associated.

isEventHandlerNameUpdateable

  1. boolean isEventHandlerNameUpdateable( )
Signals whether the event handler name property can be changed for the kind and current state of the object.

setParentContextID

  1. void setParentContextID(OID parentContextID)
Sets the object ID of the parent context. The task must be a stand-alone task and cannot be a subtask or follow-on task.

Changing the parent context has no impact on the task instance itself. You may, however, use this property to group tasks for queries. For example, a process instance object ID (PIID) can group all stand-alone tasks that belong to the specified process instance.

Parameters:
parentContextID - The object ID of the parent context.

isParentContextIDUpdateable

  1. boolean isParentContextIDUpdateable( )
Signals whether the parent context ID property can be changed for the kind and current state of the object.

setSupportsFollowOnTasks

  1. void setSupportsFollowOnTasks(boolean supportsFollowOnTask)
Sets whether the task supports the creation of follow-on tasks.

Parameters:
supportsFollowOnTask - An indication whether the task instance supports the creation of follow-on tasks. True states that the task supports the creation of follow-on tasks. False states that the task does not support the creation of follow-on tasks.

isSupportsFollowOnTasksUpdateable

  1. boolean isSupportsFollowOnTasksUpdateable( )
Signals whether the supports follow on task property can be changed for the kind and current state of the object.

setDurationUntilExpires

  1. void setDurationUntilExpires(java.lang.String durationUntilExpires)
Sets the duration that may pass until the task expires. The expiration time is calculated once the task reaches the ready state, or recalculated when the ready state is already reached or passed.

This value is also used to set up an expiration timer when restarting the task instance.

Parameters:
durationUntilExpires - The duration that may pass until the task instance expires. The format of the duration depends on the calendar that is used and may, for example, be "5days". Additionally, TimerSpecification.DURATION_IMMEDIATE may be specified to indicate that the task expires immediately and TimerSpecification.DURATION_INFINITE to indicate that the task never expires.
Since:
7.0.

isDurationUntilExpiresUpdateable

  1. boolean isDurationUntilExpiresUpdateable( )
Signals whether the duration until expires property can be changed for the kind and current state of the object.

setExpirationTime

  1. void setExpirationTime(java.util.Calendar expirationTime)
Sets the time when the task expires. See also getExpirationTime.

Note, however, that updating this time prevents a duration until expires to be calculated when restarting the task instance. An expiration timer is not set up.

Parameters:
expirationTime - The time when the task instance expires. Note that setting the expiration time to null is not accepted by the update method, that is, an exception will be thrown,
Since:
7.0.

isExpirationTimeUpdateable

  1. boolean isExpirationTimeUpdateable( )
Signals whether the expiration time property can be changed for the kind and current state of the object.

setEscalated

  1. void setEscalated(boolean isEscalated)
Sets the escalation state of the task, that is, allows to manually escalate a task. Refer to isEscalated for reading the current value.

Parameters:
isEscalated - An indication whether the task instance should be escalated or not. True states that the task should be escalated. False states that the task should not be escalated.
Since:
7.0.

isEscalatedUpdateable

  1. boolean isEscalatedUpdateable()
Signals whether the isEscalated property can be changed for the kind and current state of the object.

setRead

  1. void setRead(boolean isRead)
Marks the task instance as read. Refer to isRead or getTaskRead for reading the current value.

Parameters:
isRead - An indication whether the task instance should be marked as read or not. True states that the task should be marked as read. False states that the task should not be marked as read.
Since:
7.0.

isReadUpdateable

  1. boolean isReadUpdateable()
Signals whether the isRead property can be changed for the kind and current state of the object.

setWorkBasketName

  1. void setWorkBasketName(java.lang.String workBasket)
Sets the name of the work basket the task belongs to. The isTransferredToWorkBasket property remains unchanged. Refer to getWorkBasketName for reading the current value.

Parameters:
workBasket - The name of the work basket to be associated. Null means that the task is no longer associated to any work basket.
Since:
7.0.

isWorkBasketNameUpdateable

  1. boolean isWorkBasketNameUpdateable( )
Signals whether the work basket property can be changed for the kind and current state of the object.