com.ibm.task.api

Interface HumanTaskManagerDelegate


  1. public interface HumanTaskManagerDelegate
HumanTaskManagerDelegate wraps the functions of the Human Task Manager API and hides the details of setting up the communication.

Field Summary

Modifier and Type Field and Description
  1. static
  2. java.lang.String
COPYRIGHT

Method Summary

Modifier and Type Method and Description
  1. java.util.List
bulkTransferWorkItem(ESIID[] esiids,int assignmentReason,java.lang.String fromOwner,java.lang.String toOwner)
Transfers the specified work items for the specified escalation instances using escalation instance IDs - each transfer operation is executed in a transaction on its own.
  1. java.util.List
bulkTransferWorkItem(java.lang.String[] identifiers,int assignmentReason,java.lang.String fromOwner,java.lang.String toOwner)
Transfers the specified work items for the specified escalation or task instances using escalation or task instance IDs - each transfer operation is executed in a transaction on its own.
  1. java.util.List
bulkTransferWorkItem(TKIID[] tkiids,int assignmentReason,java.lang.String fromOwner,java.lang.String toOwner)
Transfers the specified work items for the specified task instances using task instance IDs - each transfer operation is executed in a transaction on its own.
  1. ClientObjectWrapper
callTask(java.lang.String tkiid,ClientObjectWrapper input)
Synchronously executes a previously created invocation task instance using a string representation of the task instance ID.
  1. ClientObjectWrapper
callTask(TKIID tkiid,ClientObjectWrapper input)
Synchronously executes a previously created invocation task instance using the task instance ID.
  1. void
cancelClaim(java.lang.String tkiid)
Cancels the claim of a task instance using a string representation of the task instance ID.
  1. java.util.List
cancelClaim(java.lang.String[] identifiers)
Cancels the claim of the specified task instances using string representations of the task instance IDs.
  1. void
cancelClaim(java.lang.String tkiid,boolean keepTaskData)
Cancels the claim of a task instance and keeps any data that has been set using a string representation of the task instance ID.
  1. void
cancelClaim(TKIID tkiid)
Cancels the claim of a task instance using the task instance ID.
  1. java.util.List
cancelClaim(TKIID[] tkiids)
Cancels the claim of the specified task instances using task instance IDs.
  1. void
cancelClaim(TKIID tkiid,boolean keepTaskData)
Cancels the claim of a task instance and keeps any data that has been set using the task instance ID.
  1. ClientObjectWrapper
claim(java.lang.String tkiid)
Claims a ready to-do or collaboration task instance for user processing using a string representation of the task instance ID.
  1. java.util.List
claim(java.lang.String[] identifiers)
Claims ready to-do or collaboration task instances for user processing using string representations of task instance IDs.
  1. ClaimResult
claim(java.lang.String queryTableName,FilterOptions filterOptions,AuthorizationOptions authorizationOptions,java.util.List parameters,int maxRetryCount)
Claims a ready to-do or collaboration task instance contained in the specified query table.
  1. Task
claim(java.lang.String whereClause,java.lang.String orderByClause,java.util.TimeZone timeZone)
Claims some ready to-do or collaboration task instance for user processing.
  1. ClientObjectWrapper
claim(TKIID tkiid)
Claims a ready to-do or collaboration task instance for user processing using the task instance ID.
  1. java.util.List
claim(TKIID[] tkiids)
Claims ready to-do or collaboration task instances for user processing using task instance IDs.
  1. void
complete(java.lang.String tkiid)
Completes a claimed task instance using a string representation of the task instance ID.
  1. java.util.List
complete(java.lang.String[] tkiids)
Completes the specified task instances using string representations of the task instance IDs.
  1. void
complete(java.lang.String tkiid,ClientObjectWrapper output)
Completes a claimed task instance using a string representation of the task instance ID and passes the result of user processing.
  1. void
complete(java.lang.String tkiid,java.lang.String faultName,ClientObjectWrapper faultMessage)
Completes a claimed task instance using a string representation of the task instance ID and states the failing of user processing.
  1. void
complete(TKIID tkiid)
Completes a claimed task instance using the task instance ID.
  1. java.util.List
complete(TKIID[] tkiids)
Completes the specified task instances using task instance IDs.
  1. void
complete(TKIID tkiid,ClientObjectWrapper output)
Completes a claimed task instance using the task instance ID and passes the result of user processing.
  1. void
complete(TKIID tkiid,java.lang.String faultName,ClientObjectWrapper faultMessage)
Completes a claimed task instance using the task instance ID and states the failing of user processing.
  1. void
completeWithFollowOnTask(java.lang.String tkiid,java.lang.String followOnID,ClientObjectWrapper input)
Completes a task instance and starts a follow-on task using a string representation of the task instance ID.
  1. void
completeWithFollowOnTask(TKIID tkiid,TKIID followOnID,ClientObjectWrapper input)
Completes a task instance and starts a follow-on task using the task instance ID.
  1. void
completeWithNewFollowOnTask(java.lang.String tkiid,java.lang.String name,java.lang.String namespace,ClientObjectWrapper input)
Completes a task instance and creates and starts a follow-on task using a string representation of the task instance ID.
  1. void
completeWithNewFollowOnTask(java.lang.String tkiid,TaskModel taskModel,java.lang.String applicationName,ClientObjectWrapper input)
Completes a task instance and creates and starts an ad hoc follow-on task using a string representation of the task instance ID.
  1. void
completeWithNewFollowOnTask(TKIID tkiid,java.lang.String name,java.lang.String namespace,ClientObjectWrapper input)
Completes a task instance and creates and starts a follow-on task using the task instance ID.
  1. void
completeWithNewFollowOnTask(TKIID tkiid,TaskModel taskModel,java.lang.String applicationName,ClientObjectWrapper input)
Completes a task instance and creates and starts an ad hoc follow-on task using the task instance ID.
  1. ClientObjectWrapper
createAndCallTask(java.lang.String tktid,ClientObjectWrapper input)
Creates and synchronously executes an invocation task instance using a string representation of the task template ID.
  1. ClientObjectWrapper
createAndCallTask(java.lang.String name,java.lang.String namespace,ClientObjectWrapper input)
Creates and synchronously executes an invocation task instance.
  1. ClientObjectWrapper
createAndCallTask(TKTID tktid,ClientObjectWrapper input)
Creates and synchronously executes an invocation task instance using the task template ID.
  1. TKIID
createAndStartTask(java.lang.String tktid,ClientObjectWrapper input,ReplyHandlerWrapper replyHandler)
Creates and starts a task instance using a string representation of the task template ID.
  1. TKIID
createAndStartTask(java.lang.String name,java.lang.String namespace,ClientObjectWrapper input,ReplyHandlerWrapper replyHandler)
Creates and starts a task instance from the currently valid task template.
  1. TKIID
createAndStartTask(TaskModel taskModel,java.lang.String applicationName,java.lang.String parentContext,ClientObjectWrapper input,ReplyHandlerWrapper replyHandler)
Creates and starts a task from the specified task model.
  1. TKIID
createAndStartTask(TKTID tktid,ClientObjectWrapper input,ReplyHandlerWrapper replyHandler)
Creates and starts a task instance using the task template ID.
  1. TKIID
createAndStartTaskAsSubTask(java.lang.String tktid,java.lang.String parentTaskID,ClientObjectWrapper input)
Creates and starts a task instance as a subtask of the specified parent task instance using string representations of the task template and instance IDs.
  1. TKIID
createAndStartTaskAsSubTask(java.lang.String name,java.lang.String namespace,java.lang.String parentTaskID,ClientObjectWrapper input)
Creates and starts a task instance as a subtask of the specified parent task instance using a string representation of the parent task instance ID.
  1. TKIID
createAndStartTaskAsSubTask(java.lang.String name,java.lang.String namespace,TKIID parentTaskID,ClientObjectWrapper input)
Creates and starts a task instance as a subtask of the specified parent task instance using the parent task instance ID.
  1. TKIID
createAndStartTaskAsSubTask(TaskModel taskModel,java.lang.String applicationName,java.lang.String parentTaskID,ClientObjectWrapper input)
Creates and starts a task from the specified task model as a subtask of the specified parent task instance using a string representation of the task instance ID.
  1. TKIID
createAndStartTaskAsSubTask(TaskModel taskModel,java.lang.String applicationName,TKIID parentTaskID,ClientObjectWrapper input)
Creates and starts a task from the specified task model as a subtask of the specified parent task instance using the task instance ID.
  1. TKIID
createAndStartTaskAsSubTask(TKTID tktid,TKIID parentTaskID,ClientObjectWrapper input)
Creates and starts a task instance as a subtask of the specified parent task instance using task template and parent task instance IDs.
  1. ClientObjectWrapper
createFaultMessage(java.lang.String identifier,java.lang.String faultName)
Creates a fault message for a fault that is defined by the specified task instance or template using a string representation of the task instance or template ID.
  1. ClientObjectWrapper
createFaultMessage(TKIID tkiid,java.lang.String faultName)
Creates a fault message for a fault that is defined by the specified task instance using the task instance ID.
  1. ClientObjectWrapper
createFaultMessage(TKTID tktid,java.lang.String faultName)
Creates a fault message for a fault that is defined by the specified task template using the task template ID.
  1. ClientObjectWrapper
createInputMessage(java.lang.String identifier)
Creates an input message for the specified task instance or template using a string representation of the task instance or template ID.
  1. ClientObjectWrapper
createInputMessage(TKIID tkiid)
Creates an input message for the specified task instance using the task instance ID.
  1. ClientObjectWrapper
createInputMessage(TKTID tktid)
Creates an input message for the specified task template using the task template ID.
  1. ClientObjectWrapper
createMessage(java.lang.String tkiid,java.lang.String messageTypeName)
Deprecated. As of version 6.0, replaced by createInputMessage, createOutputMessage, and createFaultMessage.
  1. ClientObjectWrapper
createMessage(TKIID tkiid,java.lang.String messageTypeName)
Deprecated. As of version 6.0, replaced by createInputMessage, createOutputMessage, and createFaultMessage.
  1. ClientObjectWrapper
createOutputMessage(java.lang.String identifier)
Creates an output message for the specified task instance or template using a string representation of the task instance or template ID.
  1. ClientObjectWrapper
createOutputMessage(TKIID tkiid)
Creates an output message for the specified task instance using the task instance ID.
  1. ClientObjectWrapper
createOutputMessage(TKTID tktid)
Creates an output message for the specified task template using the task template ID.
  1. void
createStoredQuery(java.lang.String storedQueryName,java.lang.String selectClause,java.lang.String whereClause,java.lang.String orderByClause,java.lang.Integer threshold,java.util.TimeZone timeZone)
Creates a query definition and persistently stores it in the database.
  1. void
createStoredQuery(java.lang.String storedQueryName,java.lang.String selectClause,java.lang.String whereClause,java.lang.String orderByClause,java.lang.Integer threshold,java.util.TimeZone timeZone,java.util.List storedQueryProperties,java.lang.String clientType)
Creates a query definition and specifies properties to be stored together with the query.
  1. void
createStoredQuery(java.lang.String userID,java.lang.String storedQueryName,java.lang.String selectClause,java.lang.String whereClause,java.lang.String orderByClause,java.lang.Integer threshold,java.util.TimeZone timeZone,java.util.List storedQueryProperties,java.lang.String clientType)
Creates a query definition for the specified user.
  1. TKIID
createTask(java.lang.String tktid,ClientObjectWrapper input)
Creates a task instance using a string representation of the task template ID and optionally passes an input message.
  1. TKIID
createTask(java.lang.String name,java.lang.String namespace)
Creates a task instance from the currently valid task template.
  1. TKIID
createTask(java.lang.String name,java.lang.String namespace,ClientObjectWrapper input)
Creates a task instance from the currently valid task template and specifies an input message.
  1. TKIID
createTask(TaskModel taskModel,java.lang.String applicationName,java.lang.String parentContext)
Creates a task instance from the specified task model.
  1. TKIID
createTask(TaskModel taskModel,java.lang.String applicationName,java.lang.String parentContext,ClientObjectWrapper input)
Creates a task instance from the specified task model and specifies an input message.
  1. TKIID
createTask(TKTID tktid,ClientObjectWrapper input)
Creates a task instance using the task template ID and optionally passes an input message.
  1. TKTID
createTaskTemplate(TaskModel taskModel,java.lang.String applicationName)
Creates a task template from the specified task model.
  1. void
createWorkItem(ESIID esiid,int assignmentReason,java.lang.String userID)
Creates a user work item for the specified escalation instance using the escalation instance ID.
  1. void
createWorkItem(java.lang.String identifier,int assignmentReason,java.lang.String userID)
Creates a user work item for the specified task or escalation instance using a string representation of the task or escalation instance ID.
  1. void
createWorkItem(TKIID tkiid,int assignmentReason,java.lang.String userID)
Creates a user work item for the specified task instance using the task instance ID.
  1. void
delete(java.lang.String tkiid)
Deletes the specified task instance using a string representation of the task instance ID.
  1. void
delete(java.lang.String identifier,boolean deleteInstances)
Deletes the specified task template using a string representation of the task template ID.
  1. void
delete(TKIID tkiid)
Deletes the specified task instance using the task instance ID.
  1. void
delete(TKTID tktid,boolean deleteInstances)
Deletes the specified task template using the task template ID.
  1. void
deleteStoredQuery(java.lang.String storedQueryName)
Deletes the specified stored query.
  1. void
deleteStoredQuery(java.lang.String userID,java.lang.String storedQueryName)
Deletes the specified stored query for the specified user.
  1. void
deleteWorkItem(ESIID esiid,int assignmentReason,java.lang.String userID)
Deletes the specified user work item using the escalation instance ID.
  1. void
deleteWorkItem(java.lang.String identifier,int assignmentReason,java.lang.String userID)
Deletes the specified user work item using a string representation of the task or escalation instance ID.
  1. void
deleteWorkItem(TKIID tkiid,int assignmentReason,java.lang.String userID)
Deletes the specified user work item using the task instance ID.
  1. void
executeQuery(ExecutableQuery query)
Retrieves selected object properties persistently stored in the database using a predefined query object.
  1. java.util.List
findQueryTableMetaData(MetaDataOptions metaDataOptions)
Queries the meta data of query tables.
  1. boolean
getAbsence()
Deprecated. As of version 7.0, replaced by getUserSubstitutionDetail.

  1. boolean
getAbsence(java.lang.String userID)
Deprecated. As of version 7.0, replaced by getUserSubstitutionDetail.
  1. AIID
getActivityID(java.lang.String tkiid)
Retrieves the object ID of the activity instance associated to the specified task instance using a string representation of the task instance ID.
  1. AIID
getActivityID(TKIID tkiid)
Retrieves the object ID of the activity instance associated to the specified task instance using the task instance ID.
  1. java.util.List
getAllCustomProperties(java.lang.String identifier)
Retrieves all custom properties of the specified task template or task instance using a string representation of the object ID.
  1. java.util.List
getAllCustomProperties(TKIID tkiid)
Retrieves all custom properties of the specified task instance using the task instance ID.
  1. java.util.List
getAllCustomProperties(TKTID tktid)
Retrieves all custom properties of the specified task template using the task template ID.
  1. WorkItem[]
getAllWorkItems(ESIID esiid)
Returns all work item assignments associated to specified escalation instance using the escalation instance ID.
  1. WorkItem[]
getAllWorkItems(java.lang.String identifier)
Returns all work item assignments associated to specified task or escalation instance using a string representation of the task or escalation instance ID.
  1. WorkItem[]
getAllWorkItems(TKIID tkiid)
Returns all work item assignments associated to specified task instance using the task instance ID.
  1. ApplicationComponent
getApplicationComponent(ACOID acoid)
Retrieves the specified application component using the application component ID.
  1. ApplicationComponent
getApplicationComponent(java.lang.String acoid)
Retrieves the specified application component using a string representation of the application component ID.
  1. boolean[][]
getAvailableActionFlags(ESIID[] esiids)
Returns the actions that can be called for the specified escalation instances in their current state by the logged-on user using escalation instance IDs.
  1. boolean[][]
getAvailableActionFlags(java.lang.String[] identifiers)
Returns the actions that can be called for the specified tasks or escalations in their current state by the logged-on user using string representations of the task or escalation instance IDs.
  1. boolean[][]
getAvailableActionFlags(TKIID[] tkiids)
Returns the actions that can be called for the specified tasks in their current state by the logged-on user using task instance IDs.
  1. int[]
getAvailableActions(ESIID esiid)
Returns the actions that can be called in the current escalation instance state by the logged-on user using the escalation instance ID.
  1. int[]
getAvailableActions(ESTID estid)
Returns the actions that can be called in the current escalation template state by the logged-on user using the escalation template ID.
  1. int[]
getAvailableActions(java.lang.String identifier)
Returns the actions that can be called by the logged-on user for the specified task instance, task template, escalation instance, or escalation template using a string representation of the object ID.
  1. int[]
getAvailableActions(TKIID tkiid)
Returns the actions that can be called in the current task instance state by the logged-on user using the task instance ID.
  1. int[]
getAvailableActions(TKTID tktid)
Returns the actions that can be called in the current task template state by the logged-on user using the task template ID.
  1. BinaryCustomProperty
getBinaryCustomProperty(ESIID esiid,java.lang.String propertyName)
Retrieves the named binary custom property of the specified escalation instance using the escalation instance ID.
  1. BinaryCustomProperty
getBinaryCustomProperty(java.lang.String identifier,java.lang.String propertyName)
Retrieves the named binary custom property of the specified task or escalation instance using a string representation of the object ID.
  1. BinaryCustomProperty
getBinaryCustomProperty(TKIID tkiid,java.lang.String propertyName)
Retrieves the named binary custom property of the specified task instance using the task instance ID.
  1. java.util.List
getBinaryCustomPropertyNames(ESIID esiid)
Retrieves the names of all binary custom properties of the specified escalation instance using the escalation instance ID.
  1. java.util.List
getBinaryCustomPropertyNames(java.lang.String identifier)
Retrieves the names of all binary custom properties of the specified task or escalation instance using a string representation of the task or escalation instance ID.
  1. java.util.List
getBinaryCustomPropertyNames(TKIID tkiid)
Retrieves the names of all binary custom properties of the specified task instance using the task instance ID.
  1. java.util.List
getCustomProperties(ESIID esiid)
Retrieves the custom properties of the specified escalation instance using the escalation instance ID.
  1. java.util.List
getCustomProperties(ESTID estid)
Retrieves the custom properties of the specified escalation template using the escalation template ID.
  1. java.util.List
getCustomProperties(java.lang.String identifier)
Retrieves the custom properties of the specified task instance, task template, escalation instance, or escalation template using a string representation of the object ID.
  1. java.util.List
getCustomProperties(TKIID tkiid)
Retrieves all custom properties of the specified task instance using the task instance ID.
  1. java.util.List
getCustomProperties(TKTID tktid)
Retrieves the custom properties of the specified task template using the task template ID.
  1. java.lang.String
getCustomProperty(ESIID esiid,java.lang.String propertyName)
Retrieves the named custom property of the specified escalation instance using the escalation instance ID.
  1. java.lang.String
getCustomProperty(ESTID estid,java.lang.String propertyName)
Retrieves the named custom property of the specified escalation template using the escalation template ID.
  1. java.lang.String
getCustomProperty(java.lang.String identifier,java.lang.String propertyName)
Retrieves the named custom property of the specified task instance, task template, escalation instance, or escalation template using a string representation of the object ID.
  1. java.lang.String
getCustomProperty(TKIID tkiid,java.lang.String propertyName)
Retrieves the named custom property of the specified task instance using the task instance ID.
  1. java.lang.String
getCustomProperty(TKTID tktid,java.lang.String propertyName)
Retrieves the named custom property of the specified task template using the task template ID.
  1. java.util.List
getCustomPropertyInfo(int objectType,java.lang.String nameFilter,java.lang.Integer threshold)
Retrieves information about custom properties of the specified object types.
  1. java.util.List
getCustomPropertyNames(ESIID esiid)
Retrieves the names of all custom properties of the specified escalation instance using the escalation instance ID.
  1. java.util.List
getCustomPropertyNames(ESTID estid)
Retrieves the names of all custom properties of the specified escalation template using the escalation template ID.
  1. java.util.List
getCustomPropertyNames(java.lang.String identifier)
Retrieves the names of all custom properties of the specified task instance, task template, escalation instance, or escalation template using a string representation of the object ID.
  1. java.util.List
getCustomPropertyNames(TKIID tkiid)
Retrieves the names of all custom properties of the specified task instance using the task instance ID.
  1. java.util.List
getCustomPropertyNames(TKTID tktid)
Retrieves the names of all custom properties of the specified task template using the task template ID.
  1. java.lang.String
getDocumentation(ESIID esiid,java.util.Locale locale)
Retrieves the documentation of the specified escalation instance using the escalation instance ID.
  1. java.lang.String
getDocumentation(ESTID estid,java.util.Locale locale)
Retrieves the documentation of the specified escalation template using the escalation template ID.
  1. java.lang.String
getDocumentation(java.lang.String identifier,java.util.Locale locale)
Retrieves the documentation of the specified object using a string representation of the object ID.
  1. java.lang.String
getDocumentation(TKIID tkiid,java.util.Locale locale)
Retrieves the documentation of the specified task instance using the task instance ID.
  1. java.lang.String
getDocumentation(TKTID tktid,java.util.Locale locale)
Retrieves the documentation of the specified task template using the task template ID.
  1. Escalation
getEscalation(ESIID esiid)
Retrieves the specified escalation instance using the escalation instance ID.
  1. Escalation
getEscalation(java.lang.String esiid)
Retrieves the specified escalation instance using a string representation of the escalation instance ID.
  1. Escalation
getEscalation(java.lang.String tkiid,java.lang.String escalationName)
Retrieves the specified escalation instance using a string representation of the associated task instance ID and the escalation name.
  1. Escalation
getEscalation(TKIID tkiid,java.lang.String escalationName)
Retrieves the specified escalation instance using the associated task instance ID and the escalation name.
  1. EscalationInfo
getEscalationInfo(java.lang.String tkiid)
Retrieves information about all escalations of the specified task instance using a string representation of the task instance ID.
  1. EscalationInfo
getEscalationInfo(TKIID tkiid)
Retrieves information about all escalations of the specified task instance using the task instance ID.
  1. EscalationTemplate
getEscalationTemplate(ESTID estid)
Retrieves the specified escalation template using the escalation template ID.
  1. EscalationTemplate
getEscalationTemplate(java.lang.String estid)
Retrieves the specified escalation template using a string representation of the escalation template ID.
  1. ClientObjectWrapper
getFaultMessage(java.lang.String tkiid)
Retrieves the fault message of the specified task instance using a string representation of the task instance ID.
  1. ClientObjectWrapper
getFaultMessage(TKIID tkiid)
Retrieves the fault message of the specified task instance using the task instance ID.
  1. java.util.List
getFaultNames(java.lang.String identifier)
Retrieves the fault names defined for the specified task instance or template using a string representation of the task instance or template ID.
  1. java.util.List
getFaultNames(TKIID tkiid)
Retrieves the fault names defined for the specified task instance using the task instance ID.
  1. java.util.List
getFaultNames(TKTID tktid)
Retrieves the fault names defined for the specified task template using the task template ID.
  1. java.util.List
getGroupDetails(java.lang.String[] groupNames,java.lang.String[] groupProperties,java.lang.String[] userProperties,java.lang.String[] subGroupProperties,java.lang.Integer threshold)
Returns details about the specified groups.
  1. java.lang.String[]
getGroupNames()
Returns the names of groups the logged-on user is part of.
  1. HtmConfiguration
getHtmConfiguration()
Returns configuration settings of the Human Task Manager.
  1. InlineCustomProperty
getInlineCustomProperty(java.lang.String identifier,java.lang.String propertyName)
Retrieves the named inline custom property of the specified task template or task instance using string representations of the object IDs.
  1. InlineCustomProperty
getInlineCustomProperty(TKIID tkiid,java.lang.String propertyName)
Retrieves the named inline custom property of the specified task instance using the task instance ID.
  1. InlineCustomProperty
getInlineCustomProperty(TKTID tktid,java.lang.String propertyName)
Retrieves the named inline custom property of the specified task template using the task template ID.
  1. ClientObjectWrapper
getInputMessage(java.lang.String tkiid)
Retrieves the input message of the specified task instance using a string representation of the task instance ID.
  1. ClientObjectWrapper
getInputMessage(TKIID tkiid)
Retrieves the input message of the task instance using the task instance ID.
  1. java.lang.String
getMessageTextOfException(java.util.Locale locale,java.lang.String messageKey,java.lang.Object[] variableValues)
Retrieves the message text associated to the specified message key and locale.
  1. int
getOperationMode()
Indicates whether the Human Task Manager database is used as an archive.
  1. ClientObjectWrapper
getOutputMessage(java.lang.String tkiid)
Retrieves the output message of the specified task instance using a string representation of the ID.
  1. ClientObjectWrapper
getOutputMessage(TKIID tkiid)
Retrieves the output message of the specified task instance using the task instance ID.
  1. PIID
getProcessID(java.lang.String tkiid)
Retrieves the object ID of the BPEL process instance that contains the specified task instance using a string representation of the task instance ID.
  1. PIID
getProcessID(TKIID tkiid)
Retrieves the object ID of the BPEL process instance that contains the specified task instance using the task instance ID.
  1. QueryTableMetaData
getQueryTableMetaData(java.lang.String queryTableName,java.util.Locale locale)
Returns the meta data of the specified query table.
  1. StoredQuery
getStoredQuery(int kind,java.lang.String storedQueryName)
Retrieves the specified private or public stored query definition.
  1. StoredQuery
getStoredQuery(java.lang.String storedQueryName)
Retrieves the specified stored query definition.
  1. StoredQuery
getStoredQuery(java.lang.String userID,java.lang.String storedQueryName)
Retrieves the specified stored query definition for the specified user.
  1. java.lang.String[]
getStoredQueryNames()
Retrieves the names of stored queries that are persistently stored in the database.
  1. java.lang.String[]
getStoredQueryNames(int kind)
Retrieves the names of private or public stored queries that are persistently stored in the database.
  1. java.lang.String[]
getStoredQueryNames(java.lang.String userID)
Retrieves the names of stored queries that are persistently stored in the database for the specified user.
  1. java.util.List
getSubstitutes()
Deprecated. As of version 7.0, replaced by getUserSubstitutionDetail.

  1. java.util.List
getSubstitutes(java.lang.String userID)
Deprecated. As of version 7.0, replaced by getUserSubstitutionDetail.
  1. java.util.List
getSubTaskIDs(java.lang.String tkiid)
Retrieves the object IDs of all task instances that are subtasks of the specified task instance using a string representation of the task instance ID.
  1. java.util.List
getSubTaskIDs(TKIID tkiid)
Retrieves the object IDs of all task instances that are subtasks of the specified task instance using the task instance ID.
  1. Task
getTask(java.lang.String tkiid)
Retrieves the specified task instance using a string representation of the task instance ID.
  1. Task
getTask(TKIID tkiid)
Retrieves the specified task instance using the task instance ID.
  1. Task
getTaskAndMarkRead(java.lang.String tkiid)
Retrieves the specified task instance using a string representation of the task instance ID and marks the task as read.
  1. Task
getTaskAndMarkRead(TKIID tkiid)
Retrieves the specified task instance using the task instance ID and marks the task as read.
  1. java.util.List
getTaskHistory(java.lang.String tkiid)
Retrieves the history events associated to the specified task instance using a string representation of the task instance ID.
  1. java.util.List
getTaskHistory(TKIID tkiid)
Retrieves the history events associated to the specified task instance using the task instance ID.
  1. boolean
getTaskRead(java.lang.String tkiid)
States whether the specified task instance is marked read using a string representation of the task instance ID.
  1. boolean
getTaskRead(TKIID tkiid)
States whether the specified task instance is marked read using the task instance ID.
  1. TaskTemplate
getTaskTemplate(java.lang.String tktid)
Retrieves the specified task template using a string representation of the task template ID.
  1. TaskTemplate
getTaskTemplate(TKTID tktid)
Retrieves the specified task template using the task template ID.
  1. CustomClientSettings
getUISettings(java.lang.String identifier)
Retrieves client interface settings for the specified task instance or template using a string representation of the object ID.
  1. CustomClientSettings
getUISettings(TKIID tkiid)
Retrieves client interface settings for the specified task instance using the task instance ID.
  1. CustomClientSettings
getUISettings(TKTID tktid)
Retrieves client interface settings for the specified task template using the task template ID.
  1. java.util.List
getUserDetails(java.lang.String[] userIDs,java.lang.String[] userProperties)
Retrieves details about the specified users.
  1. StaffResultSet
getUsersInRole(java.lang.String identifier,int role)
Retrieves the users that are members of the specified role for the specified task instance or template using a string representation of the task instance or template ID.
  1. StaffResultSet
getUsersInRole(TKIID tkiid,int role)
Retrieves the users that are members of the specified role for the specified task using the task instance ID.
  1. StaffResultSet
getUsersInRole(TKTID tktid,int role)
Retrieves the users that are members of the specified role for the specified task template using the task template ID.
  1. UserSubstitutionDetail
getUserSubstitutionDetail()
Retrieves absence and substitution details about the logged-on user.
  1. UserSubstitutionDetail
getUserSubstitutionDetail(java.lang.String userID)
Retrieves absence and substitution details about the specified user.
  1. WorkItem[]
getWorkItems(ESIID esiid)
Returns the work item assignments for the logged-on user and the specified escalation instance using the escalation instance ID.
  1. WorkItem[]
getWorkItems(java.lang.String identifier)
Returns the work item assignments for the logged-on user and the specified task or escalation instance using a string representation of the task or escalation instance ID.
  1. WorkItem[]
getWorkItems(TKIID tkiid)
Returns the work item assignments for the logged-on user and the specified task instance using the task instance ID.
  1. boolean
isSystemAdministrator()
States whether the logged-on user is a system administrator for the Human Task Manager component.
  1. boolean
isSystemMonitor()
States whether the logged-on user is a task system monitor for the Human Task Manager component.
  1. boolean
isUserInRole(java.lang.String identifier,java.lang.String userID,int role)
States whether the specified user is a member of the specified role for the specified task instance or template using a string representation of the task instance or template ID.
  1. boolean
isUserInRole(TKIID tkiid,java.lang.String userID,int role)
States whether the specified user is a member of the specified role for the specified task instance using the task instance ID.
  1. boolean
isUserInRole(TKTID tktid,java.lang.String userID,int role)
States whether the specified user is a member of the specified role for the specified task template using the task template ID.
  1. QueryResultSet
query(int kind,java.lang.String storedQueryName,java.lang.Integer skipTuples,java.lang.Integer threshold,java.util.List parameters)
Performs the specified public or private stored query.
  1. QueryResultSet
query(java.lang.String storedQueryName,java.lang.Integer skipTuples)
Deprecated. As of version 6.0.2, replaced by query(Sting storedQueryName, Integer skipTuples, List parameters),
  1. QueryResultSet
query(java.lang.String storedQueryName,java.lang.Integer skipTuples,java.lang.Integer threshold)
  1. QueryResultSet
query(java.lang.String storedQueryName,java.lang.Integer skipTuples,java.lang.Integer threshold,java.util.List parameters)
Performs the specified stored query and specifies values for parameters in the where-clause.
  1. QueryResultSet
query(java.lang.String storedQueryName,java.lang.Integer skipTuples,java.util.List parameters)
Performs the specified stored query, specifies values for the parameters in the where-clause, and returns the qualifying object properties.
  1. QueryResultSet
query(java.lang.String userID,java.lang.String storedQueryName,java.lang.Integer skipTuples,java.lang.Integer threshold,java.util.List parameters)
Performs the specified private stored query of the specified user.
  1. QueryResultSet
query(java.lang.String selectClause,java.lang.String whereClause,java.lang.String orderByClause,java.lang.Integer skipTuples,java.lang.Integer threshold,java.util.TimeZone timeZone)
Retrieves selected object properties persistently stored in the database and allows for retrieving a specified set of data only.
  1. QueryResultSet
query(java.lang.String selectClause,java.lang.String whereClause,java.lang.String orderByClause,java.lang.Integer threshold,java.util.TimeZone timeZone)
Retrieves selected object properties persistently stored in the database.
  1. QueryResultSet
queryAll(java.lang.String selectClause,java.lang.String whereClause,java.lang.String orderByClause,java.lang.Integer skipTuples,java.lang.Integer threshold,java.util.TimeZone timeZone)
Retrieves selected object properties of all objects persistently stored in the database and allows for retrieving a specified set of data only.
  1. EntityResultSet
queryEntities(java.lang.String queryTableName,FilterOptions filterOptions,AuthorizationOptions authorizationOptions,java.util.List parameters)
Queries entities using the specified query table.
  1. int
queryEntityCount(java.lang.String queryTableName,FilterOptions filterOptions,AuthorizationOptions authorizationOptions,java.util.List parameters)
Counts qualifying entities of a potential query for entities.
  1. int
queryRowCount(java.lang.String queryTableName,FilterOptions filterOptions,AuthorizationOptions authorizationOptions,java.util.List parameters)
Counts qualifying objects of a potential query table query.
  1. RowResultSet
queryRows(java.lang.String queryTableName,FilterOptions filterOptions,AuthorizationOptions authorizationOptions,java.util.List parameters)
Queries attributes using the specified query table.
  1. TaskTemplate[]
queryTaskTemplates(java.lang.String whereClause,java.lang.String orderByClause,java.lang.Integer threshold,java.util.TimeZone timeZone)
Retrieves task templates that are persistently stored in the database.
  1. StaffResultSet
resolveStaffQuery(java.lang.String parameterizedPeopleAssignmentCriteria,java.lang.String jndiNameOfStaffPluginProvider,int substitutionPolicy,java.util.Map contextVariables)
Tentatively resolves the specified people assignment criteria and returns the qualifying users or groups.
  1. void
restart(java.lang.String tkiid,ClientObjectWrapper input,boolean keepResultMessages)
Restarts the specified task instance using a string representation of the task instance ID.
  1. void
restart(TKIID tkiid,ClientObjectWrapper input,boolean keepResultMessages)
Restarts the specified task instance using the task instance ID.
  1. void
resume(java.lang.String tkiid)
Resumes the execution of the specified suspended collaboration or to-do task instance using a string representation of the task instance ID.
  1. void
resume(TKIID tkiid)
Resumes the execution of the specified suspended collaboration or to-do task instance using the task instance ID.
  1. java.util.List
searchGroupDetails(java.lang.String searchCondition,java.lang.String[] groupProperties,java.lang.String[] userProperties,java.lang.String[] subGroupProperties,java.lang.Integer threshold)
Returns details about the groups searched for.
  1. java.util.List
searchUserDetails(java.lang.String searchCondition,java.lang.String[] userProperties,java.lang.Integer threshold)
Returns details about the users searched for.
  1. void
setAbsence(boolean absence)
Deprecated. As of version 7.0, replaced by setUserSubstitutionDetail.
  1. void
setAbsence(java.lang.String userID,boolean absence)
Deprecated. As of version 7.0, replaced by setUserSubstitutionDetail.
  1. void
setBinaryCustomProperty(ESIID esiid,BinaryCustomProperty property)
Stores custom-specific binary values for the specified escalation instance using the escalation instance ID.
  1. void
setBinaryCustomProperty(java.lang.String identifier,BinaryCustomProperty property)
Stores custom-specific binary values for the specified task or escalation instance using a string representation of the task or escalation instance ID.
  1. void
setBinaryCustomProperty(TKIID tkiid,BinaryCustomProperty property)
Stores custom-specific binary values for the specified task instance using the task instance ID.
  1. void
setCustomProperties(java.lang.String tkiid,java.util.List customProperties)
Stores custom-specific values for the specified task instance using a string representation of the task instance ID.
  1. void
setCustomProperties(TKIID tkiid,java.util.List customProperties)
Stores custom-specific values for the specified task instance using the task instance ID.
  1. void
setCustomProperty(ESIID esiid,java.lang.String propertyName,java.lang.String propertyValue)
Stores custom-specific values for the specified escalation instance.
  1. java.util.List
setCustomProperty(java.lang.String[] tkiids,java.lang.String propertyName,java.lang.String propertyValue)
Stores custom-specific values for the specified task instances using string representations of the task instance IDs.
  1. void
setCustomProperty(java.lang.String identifier,java.lang.String propertyName,java.lang.String propertyValue)
Stores custom-specific values for the specified task or escalation instance using a string representation of the object ID.
  1. java.util.List
setCustomProperty(TKIID[] tkiids,java.lang.String propertyName,java.lang.String propertyValue)
Stores custom-specific values for the specified task instances using task instance IDs.
  1. void
setCustomProperty(TKIID tkiid,java.lang.String propertyName,java.lang.String propertyValue)
Stores custom-specific values for the specified task instance.
  1. void
setFaultMessage(java.lang.String tkiid,java.lang.String faultName,ClientObjectWrapper faultMessage)
Stores the specified fault message for the specified task instance into the database using a string representation of the task instance ID.
  1. void
setFaultMessage(TKIID tkiid,java.lang.String faultName,ClientObjectWrapper faultMessage)
Stores the specified fault message for the specified task instance into the database using the task instance ID.
  1. void
setInlineCustomProperties(java.lang.String tkiid,java.util.List customProperties)
Stores custom-specific values for the specified task instance using a string representation of the task instance ID.
  1. void
setInlineCustomProperties(TKIID tkiid,java.util.List customProperties)
Stores custom-specific values for the specified task instance using the task instance ID.
  1. java.util.List
setInlineCustomProperty(java.lang.String[] tkiids,InlineCustomProperty property)
Stores a custom-specific value for the specified task instances using string representations of the task instance IDs.
  1. void
setInlineCustomProperty(java.lang.String tkiid,InlineCustomProperty property)
Stores a custom-specific value for the specified task instance using a string representation of the task instance ID.
  1. java.util.List
setInlineCustomProperty(TKIID[] tkiids,InlineCustomProperty property)
Stores a custom-specific value for the specified task instances using task instance IDs.
  1. void
setInlineCustomProperty(TKIID tkiid,InlineCustomProperty property)
Stores a custom specific value for the specified task instance using the task instance ID.
  1. void
setInputMessage(java.lang.String tkiid,ClientObjectWrapper inputMessage)
Stores the input message of the specified task instance into the database using a string representation of the task instance ID.
  1. void
setInputMessage(TKIID tkiid,ClientObjectWrapper inputMessage)
Stores the input message of the specified task instance into the database using the task instance ID.
  1. void
setOutputMessage(java.lang.String tkiid,ClientObjectWrapper outputMessage)
Stores the output message of the specified task instance into the database using a string representation of the task instance ID.
  1. void
setOutputMessage(TKIID tkiid,ClientObjectWrapper outputMessage)
Stores the output message of the specified task instance into the database using the task instance ID.
  1. void
setSubstitutes(java.util.List substitutes)
Deprecated. As of version 7.0, replaced by setUserSubstitutionDetail.
  1. void
setSubstitutes(java.lang.String userID,java.util.List substitutes)
Deprecated. As of version 7.0, replaced by setUserSubstitutionDetail.
  1. void
setTaskRead(java.lang.String tkiid,boolean newValue)
Specifies whether the specified task instance is to be marked as read using a string representation of the task instance ID.
  1. void
setTaskRead(TKIID tkiid,boolean newValue)
Specifies whether the specified task instance is to be marked as read using the task instance ID.
  1. void
setUserSubstitutionDetail(java.lang.String userID,UserSubstitutionDetail substitutionDetail)
Sets absence and substitution details for the specified user.
  1. void
setUserSubstitutionDetail(UserSubstitutionDetail substitutionDetail)
Sets absence and substitution details for the logged-on user.
  1. void
startTask(java.lang.String tkiid,ClientObjectWrapper input,ReplyHandlerWrapper replyHandler)
Asynchronously executes a previously created task using a string representation of the task instance ID.
  1. void
startTask(TKIID tkiid,ClientObjectWrapper input,ReplyHandlerWrapper replyHandler)
Asynchronously executes a previously created task using the task instance ID.
  1. void
startTaskAsSubTask(java.lang.String tkiid,java.lang.String parentTaskID,ClientObjectWrapper input)
Executes a previously created task as a subtask of the specified parent task instance using a string representation of the task instance ID.
  1. void
startTaskAsSubTask(TKIID tkiid,TKIID parentTaskID,ClientObjectWrapper input)
Executes a previously created task as a subtask of the specified parent task instance using the task instance ID.
  1. void
startTaskTemplate(java.lang.String tktid)
This method starts a task template that has been created at Runtime using a string representation of the task template ID.
  1. void
startTaskTemplate(TKTID tktid)
This method starts a task template that has been created at Runtime using the task template ID.
  1. void
stopTaskTemplate(java.lang.String tktid)
This method stops a task template that has been created at Runtime using a string representation of the task template ID.
  1. void
stopTaskTemplate(TKTID tktid)
This method stops a task template that has been created at Runtime using the task template ID.
  1. void
suspend(java.lang.String tkiid)
Suspends the specified collaboration or to-do task instance using a string representation of the task instance ID.
  1. void
suspend(java.lang.String tkiid,java.util.Calendar deadline)
Suspends the specified collaboration or to-do task instance until the specified point in time is reached using a string representation of the task instance ID.
  1. void
suspend(java.lang.String tkiid,int duration)
Suspends the specified collaboration or to-do task instance for the specified number of seconds using a string representation of the task instance ID.
  1. void
suspend(java.lang.String tkiid,java.lang.String duration)
Suspends the specified collaboration or to-do task instance for the specified duration using a string representation of the task instance ID.
  1. void
suspend(TKIID tkiid)
Suspends the specified collaboration or to-do task instance using the task instance ID.
  1. void
suspend(TKIID tkiid,java.util.Calendar deadline)
Suspends the specified collaboration or to-do task instance until the specified point in time is reached using the task instance ID.
  1. void
suspend(TKIID tkiid,int duration)
Suspends the specified collaboration or to-do task instance for the specified number of seconds using the task instance ID.
  1. void
suspend(TKIID tkiid,java.lang.String duration)
Suspends the specified collaboration or to-do task instance for the specified duration using the task instance ID.
  1. void
suspendAndCancelClaim(java.lang.String tkiid,java.util.Calendar deadline,boolean keepTaskData)
Suspends the specified collaboration or to-do task instance until the specified point in time is reached, and cancels the claim of the task instance when execution is resumed using a string representation of the task instance ID.
  1. void
suspendAndCancelClaim(java.lang.String tkiid,int duration,boolean keepTaskData)
Suspends the specified collaboration or to-do task instance for the specified number of seconds and cancels the claim of the task instance when execution is resumed using a string representation of the task instance ID.
  1. void
suspendAndCancelClaim(java.lang.String tkiid,java.lang.String duration,boolean keepTaskData)
Suspends the specified collaboration or to-do task instance for the specified duration and cancels the claim of the task instance when execution is resumed using a string representation of the task instance ID.
  1. void
suspendAndCancelClaim(TKIID tkiid,java.util.Calendar deadline,boolean keepTaskData)
Suspends the specified collaboration or to-do task instance until the specified point in time is reached, and cancels the claim of the task instance when execution is resumed using the task instance ID.
  1. void
suspendAndCancelClaim(TKIID tkiid,int duration,boolean keepTaskData)
Suspends the specified collaboration or to-do task instance for the specified number of seconds and cancels the claim of the task instance when execution is resumed using the task instance ID.
  1. void
suspendAndCancelClaim(TKIID tkiid,java.lang.String duration,boolean keepTaskData)
Suspends the specified collaboration or to-do task instance for the specified duration and cancels the claim of the task instance when execution is resumed using the task instance ID.
  1. void
terminate(java.lang.String tkiid)
Terminates the specified task instance using a string representation of the task instance ID.
  1. void
terminate(TKIID tkiid)
Terminates the specified task instance using the task instance ID.
  1. java.util.List
transferToWorkBasket(java.lang.String[] tkiids,java.lang.String workBasketName)
Transfers the specified task instances to the specified work basket using string representations of the task instance IDs.
  1. java.util.List
transferToWorkBasket(TKIID[] tkiids,java.lang.String workBasketName)
Transfers the specified task instances to the specified work basket using task instance IDs.
  1. java.util.List
transferWorkItem(ESIID[] esiids,int assignmentReason,java.lang.String fromOwner,java.lang.String toOwner)
Transfers the specified work items for the specified escalation instances using escalation instance IDs.
  1. void
transferWorkItem(ESIID esiid,int assignmentReason,java.lang.String fromOwner,java.lang.String toOwner)
Transfers the specified work item for the specified escalation instance using the escalation instance ID.
  1. java.util.List
transferWorkItem(java.lang.String[] identifiers,int assignmentReason,java.lang.String fromOwner,java.lang.String toOwner)
Transfers the specified work items for the specified escalation or task instances using string representations of escalation or task instance IDs.
  1. void
transferWorkItem(java.lang.String identifier,int assignmentReason,java.lang.String fromOwner,java.lang.String toOwner)
Transfers the specified work item using a string representation of the task or escalation instance ID.
  1. java.util.List
transferWorkItem(TKIID[] tkiids,int assignmentReason,java.lang.String fromOwner,java.lang.String toOwner)
Transfers the specified work items for the specified task instances using task instance IDs.
  1. void
transferWorkItem(TKIID tkiid,int assignmentReason,java.lang.String fromOwner,java.lang.String toOwner)
Transfers the specified work item for the specified task instance using the task instance ID.
  1. void
triggerEscalation(ESIID esiid)
Manually triggers the specified escalation instance using the escalation instance ID.
  1. void
triggerEscalation(java.lang.String esiid)
Manually triggers the specified escalation instance using a string representation of the escalation instance ID.
  1. void
update(Escalation escalation)
Updates a persistently stored escalation instance.
  1. void
update(java.lang.String tkiid,TaskModel taskModel,java.lang.String applicationName,java.lang.String parentContext,ClientObjectWrapper input)
Updates a task instance that has been created at Runtime using a string representation of the task instance ID.
  1. void
update(Task task)
Updates a persistently stored task instance.
  1. void
update(TKIID tkiid,TaskModel taskModel,java.lang.String applicationName,java.lang.String parentContext,ClientObjectWrapper input)
Updates a task instance that has been created at Runtime using the task instance ID.

Field Detail

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

Method Detail

executeQuery

  1. void executeQuery(ExecutableQuery query)
  2. throws CommunicationException
  3. ParameterNullException
  4. WorkItemManagerException
  5. UnexpectedFailureException
Retrieves selected object properties persistently stored in the database using a predefined query object.

Parameters:
query - The query specification

Throws:
Since:
6.0

bulkTransferWorkItem

  1. java.util.List bulkTransferWorkItem( java.lang.String[] identifiers,
  2. int assignmentReason,
  3. java.lang.String fromOwner,
  4. java.lang.String toOwner)
  5. throws ArchiveUnsupportedOperationException
  6. IdWrongFormatException
  7. IdWrongTypeException
  8. InvalidAssignmentReasonException
  9. ParameterNullException
  10. UserDoesNotExistException
  11. WorkItemManagerException
  12. UnexpectedFailureException
  13. CommunicationException
Transfers the specified work items for the specified escalation or task instances using escalation or task instance IDs - each transfer operation is executed in a transaction on its own.

This method is particularly suitable in cases where processing large numbers of tasks or escalations is required, and where the application is not concerned that the transfer happens as part of an enclosing global transaction.

When work items of a task instance are transferred, then the caller must be an owner, starter, originator, or administrator of the task instances. The task can be escalated. suspended, or waiting for subtasks.

When work items of an escalation instance are transferred, then the caller must be an administrator of the associated task instances. Escalation-receiver work items can be transferred when the task is escalated, that is, the escalation is in the escalated state.

The following specific rules apply for the transfer of work items:

  • Work items assigned to "everybody" cannot be transferred.
  • The owner of a task instance can transfer the "owner" work item to a potential owner or an administrator of the task instance.
  • The starter of a task instance can transfer the "starter" work item to a potential starter or an administrator of the task instance. A "starter" work item can be transferred in the expired, terminated, finished, failed, and running state.
  • The originator of a task instance can transfer the "originator" work item to a potential instance creator or an administrator of the task instance.
  • The originator of a task instance can transfer a "potential starter" work item to any person. A "potential starter" work item can be transferred in the inactive state.
  • The administrator of a task instance can transfer all work items to any person. A "starter" work item can be transferred in the expired, terminated, finished, failed, and running state. A "potential starter" work item can be transferred in the inactive state. A "reader" or "administrator" work item can be transferred in all but the inactive state. A "potential owner" or "editor" work item can be transferred in the ready or claimed state. An "escalation receiver" work item can be transferred in the ready, running, or claimed state.

This method is not supported in archive mode.

Parameters:
identifiers - An array of escalation instance or task instance IDs that are used to identify the work items to be transferred.
assignmentReason - The reason why the work item is assigned - refer to the work item assignment reasons.
fromOwner - The user ID or the name of the group the work item currently belongs to.
toOwner - The user ID or the name of the group the work item is to be transferred to. Work items can be transferred from a user to a user or from a group of users to a group of users. If a user work item is transferred, it is checked whether the user transferred to exists but the check may be executed case insensitively. The check can be suppressed by setting the 'SupportVirtualUserIdsForPeopleAssignments' custom property of the Human Task Manager configuration to 'true'.

Returns:
List - A list of TaskResult objects, one for every transfer operation that failed. Refer to TaskResult to view the TaskResult properties. Returns an empty list when all transfers executed successfully.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

bulkTransferWorkItem

  1. java.util.List bulkTransferWorkItem( ESIID[] esiids,
  2. int assignmentReason,
  3. java.lang.String fromOwner,
  4. java.lang.String toOwner)
  5. throws ArchiveUnsupportedOperationException
  6. IdWrongFormatException
  7. InvalidAssignmentReasonException
  8. ParameterNullException
  9. UserDoesNotExistException
  10. WorkItemManagerException
  11. UnexpectedFailureException
  12. CommunicationException
Transfers the specified work items for the specified escalation instances using escalation instance IDs - each transfer operation is executed in a transaction on its own.

This method is particularly suitable in cases where processing large numbers of escalations is required, and where the application is not concerned that the transfer happens as part of an enclosing global transaction.

The caller must be an administrator of the associated task instances. Escalation-receiver work items can be transferred when the task is escalated, that is, the escalation is in the escalated state. An e-mail is not sent to the user or group that receives the transferred work item.

This method is not supported in archive mode.

Parameters:
esiids - Array of escalation instance IDs that are used to identify the work items to be transferred.
assignmentReason - The reason why the work item is assigned - refer to the work item assignment reasons.
fromOwner - The user ID or the name of the group the work item currently belongs to.
toOwner - The user ID or the name of the group the work item is to be transferred to. Work items can be transferred from a user to a user or from a group of users to a group of users. If a user work item is transferred, it is checked whether the user transferred to exists but the check may be executed case insensitively. The check can be suppressed by setting the 'SupportVirtualUserIdsForPeopleAssignments' custom property of the Human Task Manager configuration to 'true'.

Returns:
List - A list of EscalationResult objects, one for every transfer operation that failed. Refer to EscalationResult to view the EscalationResult properties. Returns an empty list when all transfers executed successfully.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

bulkTransferWorkItem

  1. java.util.List bulkTransferWorkItem( TKIID[] tkiids,
  2. int assignmentReason,
  3. java.lang.String fromOwner,
  4. java.lang.String toOwner)
  5. throws ArchiveUnsupportedOperationException
  6. IdWrongFormatException
  7. InvalidAssignmentReasonException
  8. ParameterNullException
  9. UserDoesNotExistException
  10. WorkItemManagerException
  11. UnexpectedFailureException
  12. CommunicationException
Transfers the specified work items for the specified task instances using task instance IDs - each transfer operation is executed in a transaction on its own.

This method is particularly suitable in cases where processing large numbers of tasks is required, and where the application is not concerned that the transfer happens as part of an enclosing global transaction.

The caller must be an owner, starter, originator, or administrator of the task instances. The task can be escalated. suspended, or waiting for subtasks.

The following specific rules apply for the transfer of work items:

  • Work items assigned to "everybody" cannot be transferred.
  • The owner of a task instance can transfer the "owner" work item to a potential owner or an administrator of the task instance.
  • The starter of a task instance can transfer the "starter" work item to a potential starter or an administrator of the task instance. A "starter" work item can be transferred in the expired, terminated, finished, failed, and running state.
  • The originator of a task instance can transfer the "originator" work item to a potential instance creator or an administrator of the task instance.
  • The originator of a task instance can transfer a "potential starter" work item to any person. A "potential starter" work item can be transferred in the inactive state.
  • The administrator of a task instance can transfer all work items to any person. A "starter" work item can be transferred in the expired, terminated, finished, failed, and running state. A "potential starter" work item can be transferred in the inactive state. A "reader" or "administrator" work item can be transferred in all but the inactive state. A "potential owner" or "editor" work item can be transferred in the ready or claimed state.

This method is not supported in archive mode.

Parameters:
tkiids - An array of task instance IDs that are used to identify the work items to be transferred.
assignmentReason - The reason why the work item is assigned - refer to the work item assignment reasons.
fromOwner - The user ID or the name of the group the work item currently belongs to.
toOwner - The user ID or the name of the group the work item is to be transferred to. Work items can be transferred from a user to a user or from a group of users to a group of users. If a user work item is transferred, it is checked whether the user transferred to exists but the check may be executed case insensitively. The check can be suppressed by setting the 'SupportVirtualUserIdsForPeopleAssignments' custom property of the Human Task Manager configuration to 'true'.

Returns:
List - A list of TaskResult objects, one for every transfer operation that failed. Refer to TaskResult to view the TaskResult properties. Returns an empty list when all transfers executed successfully.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

callTask

  1. ClientObjectWrapper callTask(java.lang.String tkiid,
  2. ClientObjectWrapper input)
  3. throws ArchiveUnsupportedOperationException
  4. AdministratorCannotBeResolvedException
  5. ApplicationVetoException
  6. CannotCreateWorkItemException
  7. FaultReplyException
  8. IdWrongFormatException
  9. IdWrongTypeException
  10. InvalidLengthException
  11. NotAuthorizedException
  12. ObjectDoesNotExistException
  13. SCAServiceAccessFailureException
  14. SCAServiceResultErrorException
  15. SchedulingFailedException
  16. WrongKindException
  17. WrongMessageTypeException
  18. WrongStateException
  19. UnexpectedFailureException
  20. CommunicationException
Synchronously executes a previously created invocation task instance using a string representation of the task instance ID. An input message can be passed to specify initial values for the task.

An invocation task instance is also known as originating task instance.

This method returns only when the execution of the task finishes with the result of execution. If a fault occurs, an exception is thrown. The service that is called must be a two-way operation. Otherwise, SCAServiceAccessFailureException is thrown.

The task instance must be a stand-alone task in the inactive state. The caller must be a potential starter, the originator, or an administrator of the task instance.

The action associated to this method is TaskActions.CALLTASK.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID that is used to identify the task instance.
input - The input message. The object wrapped by the ClientObjectWrapper must be serializable.

Returns:
ClientObjectWrapper - The output message that denotes the result of execution.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

callTask

  1. ClientObjectWrapper callTask(TKIID tkiid,
  2. ClientObjectWrapper input)
  3. throws ArchiveUnsupportedOperationException
  4. AdministratorCannotBeResolvedException
  5. ApplicationVetoException
  6. CannotCreateWorkItemException
  7. FaultReplyException
  8. IdWrongFormatException
  9. InvalidLengthException
  10. NotAuthorizedException
  11. ObjectDoesNotExistException
  12. SCAServiceAccessFailureException
  13. SCAServiceResultErrorException
  14. SchedulingFailedException
  15. WrongKindException
  16. WrongMessageTypeException
  17. WrongStateException
  18. UnexpectedFailureException
  19. CommunicationException
Synchronously executes a previously created invocation task instance using the task instance ID. An input message can be passed to specify initial values for the task.

An invocation task instance is also known as originating task instance.

This method returns only when the execution of the task finishes with the result of execution. If a fault occurs, an exception is thrown. The service that is called must be a two-way operation. Otherwise, SCAServiceAccessFailureException is thrown.

The task instance must be a stand-alone task in the inactive state. The caller must be a potential starter, the originator, or an administrator of the task instance.

The action associated to this method is TaskActions.CALLTASK.

This method is not supported in archive mode.

Parameters:
tkiid - The task instance ID that is used to identify the task instance.
input - The input message. The object wrapped by the ClientObjectWrapper must be serializable.

Returns:
ClientObjectWrapper - The output message that denotes the result of execution.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

cancelClaim

  1. void cancelClaim(java.lang.String tkiid)
  2. throws ApplicationVetoException
  3. ArchiveUnsupportedOperationException
  4. IdWrongFormatException
  5. IdWrongTypeException
  6. NotAuthorizedException
  7. ObjectDoesNotExistException
  8. WrongKindException
  9. WrongStateException
  10. UnexpectedFailureException
  11. CommunicationException
Cancels the claim of a task instance using a string representation of the task instance ID.

The task instance must have been claimed. It can be escalated.

The task instance is returned to the ready state. Any previously stored output or fault message is deleted.

The caller must be the owner or an administrator of the task instance.

The action associated to this method is TaskActions.CANCELCLAIM.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID that is used to identify the task instance.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.0 Throws an ApplicationFailedException when the application refuses to execute the method.
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

cancelClaim

  1. void cancelClaim(TKIID tkiid)
  2. throws ApplicationVetoException
  3. ArchiveUnsupportedOperationException
  4. IdWrongFormatException
  5. NotAuthorizedException
  6. ObjectDoesNotExistException
  7. WrongKindException
  8. WrongStateException
  9. UnexpectedFailureException
  10. CommunicationException
Cancels the claim of a task instance using the task instance ID.

The task instance must have been claimed. It can be escalated.

The task instance is returned to the ready state. Any previously stored output or fault message is deleted.

The caller must be the owner or an administrator of the task instance.

The action associated to this method is TaskActions.CANCELCLAIM.

This method is not supported in archive mode.

Parameters:
tkiid - The task instance ID that is used to identify the task instance.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.0 Throws an ApplicationFailedException when the application refuses to execute the method.
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

cancelClaim

  1. void cancelClaim(java.lang.String tkiid,
  2. boolean keepTaskData)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. IdWrongFormatException
  6. IdWrongTypeException
  7. NotAuthorizedException
  8. ObjectDoesNotExistException
  9. WrongKindException
  10. WrongStateException
  11. UnexpectedFailureException
  12. CommunicationException
Cancels the claim of a task instance and keeps any data that has been set using a string representation of the task instance ID.

The task instance must have been claimed. It can be escalated.

The task instance is returned to the ready state. If specified, any previously stored output or fault message is kept.

The caller must be the owner or an administrator of the task instance.

The action associated to this method is TaskActions.CANCELCLAIM.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID that is used to identify the task instance.
keepTaskData - Specifies whether data saved for the claimed task instance is to be kept. True states that any output or fault message set is to be kept. False states that any output or fault message set is to be deleted.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

cancelClaim

  1. void cancelClaim(TKIID tkiid,
  2. boolean keepTaskData)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. IdWrongFormatException
  6. NotAuthorizedException
  7. ObjectDoesNotExistException
  8. WrongKindException
  9. WrongStateException
  10. UnexpectedFailureException
  11. CommunicationException
Cancels the claim of a task instance and keeps any data that has been set using the task instance ID.

The task instance must have been claimed. It can be escalated.

The task instance is returned to the ready state. If specified, any previously stored output or fault message is kept.

The caller must be the owner or an administrator of the task instance.

The action associated to this method is TaskActions.CANCELCLAIM.

This method is not supported in archive mode.

Parameters:
tkiid - The task instance ID that is used to identify the task instance.
keepTaskData - Specifies whether data saved for the claimed task instance is to be kept. True states that any output or fault message set is to be kept. False states that any output or fault message set is to be deleted.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

cancelClaim

  1. java.util.List cancelClaim(java.lang.String[] identifiers)
  2. throws ArchiveUnsupportedOperationException
  3. IdWrongFormatException
  4. IdWrongTypeException
  5. UnexpectedFailureException
  6. CommunicationException
Cancels the claim of the specified task instances using string representations of the task instance IDs.

The task instances must have been claimed. They can be escalated.

The task instances are returned to the ready state. Any previously stored output or fault message is deleted.

The caller must be the owner or an administrator of the task instances.

The action associated to this method is TaskActions.CANCELCLAIM.

This method is not supported in archive mode.

Parameters:
identifiers - An array of task instance IDs that are used to identify the task instances to be released.

Returns:
List - A list of TaskResult objects, one for every task instance specified. Refer to TaskResult.

If a single cancelClaim operation fails because any of the following exceptions has been thrown, then the result object contains the respective exception. Otherwise, the TaskException property is null.

  • com.ibm.task.api.ApplicationVetoException
  • com.ibm.task.api.NotAuthorizedException
  • com.ibm.task.api.ObjectDoesNotExistException
  • com.ibm.task.api.WrongKindException
  • com.ibm.task.api.WrongStateException
If any of these exceptions is thrown, processing continues. If another exception is thrown, a rollback of the global transaction is enforced, and all cancelClaim operations are undone.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

cancelClaim

  1. java.util.List cancelClaim(TKIID[] tkiids)
  2. throws ArchiveUnsupportedOperationException
  3. IdWrongFormatException
  4. UnexpectedFailureException
  5. CommunicationException
Cancels the claim of the specified task instances using task instance IDs.

The task instances must have been claimed. They can be escalated.

The task instances are returned to the ready state. Any previously stored output or fault message is deleted.

The caller must be the owner or an administrator of the task instances.

The action associated to this method is TaskActions.CANCELCLAIM.

This method is not supported in archive mode.

Parameters:
tkiids - An array of task instance IDs that are used to identify the task instances to be released.

Returns:
List - A list of TaskResult objects, one for every task instance specified. Refer to TaskResult.

If a single cancelClaim operation fails because any of the following exceptions has been thrown, then the result object contains the respective exception. Otherwise, the TaskException property is null.

  • com.ibm.task.api.ApplicationVetoException
  • com.ibm.task.api.NotAuthorizedException
  • com.ibm.task.api.ObjectDoesNotExistException
  • com.ibm.task.api.WrongKindException
  • com.ibm.task.api.WrongStateException
If any of these exceptions is thrown, processing continues. If another exception is thrown, a rollback of the global transaction is enforced, and all cancelClaim operations are undone.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

claim

  1. ClientObjectWrapper claim(java.lang.String tkiid)
  2. throws ApplicationVetoException
  3. ArchiveUnsupportedOperationException
  4. CannotCreateWorkItemException
  5. IdWrongFormatException
  6. IdWrongTypeException
  7. NotAuthorizedException
  8. ObjectDoesNotExistException
  9. SchedulingFailedException
  10. WrongKindException
  11. WrongStateException
  12. UnexpectedFailureException
  13. CommunicationException
Claims a ready to-do or collaboration task instance for user processing using a string representation of the task instance ID. The task instance can be escalated but only suspended when the 'supportsClaimIfSuspended' property is set. The collaboration task instance must be stand-alone.

Collaboration and to-do task instances are also known as human and participating task instances.

The caller must be a potential owner or an administrator of the task instance.

The state of the task instance is changed to claimed. Refer to complete for information on how to complete a task instance.

The action associated to this method is TaskActions.CLAIM.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID that is used to identify the task instance to be claimed.

Returns:
ClientObjectWrapper - The input message of the claimed task instance.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.0 Throws an ApplicationFailedException when the application refuses to execute the method.
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

claim

  1. ClientObjectWrapper claim(TKIID tkiid)
  2. throws ApplicationVetoException
  3. ArchiveUnsupportedOperationException
  4. CannotCreateWorkItemException
  5. IdWrongFormatException
  6. NotAuthorizedException
  7. ObjectDoesNotExistException
  8. SchedulingFailedException
  9. WrongKindException
  10. WrongStateException
  11. UnexpectedFailureException
  12. CommunicationException
Claims a ready to-do or collaboration task instance for user processing using the task instance ID. The task instance can be escalated but only suspended when the 'supportsClaimIfSuspended' property is set. The collaboration task instance must be stand-alone.

Collaboration and to-do task instances are also known as human and participating task instances.

The caller must be a potential owner or an administrator of the task instance.

The state of the task instance is changed to claimed. Refer to complete for information on how to complete a task instance.

The action associated to this method is TaskActions.CLAIM.

This method is not supported in archive mode.

Parameters:
tkiid - The object ID of the task instance to be claimed.

Returns:
ClientObjectWrapper - The input message of the claimed task instance.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.0 Throws an ApplicationFailedException when the application refuses to execute the method.
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

claim

  1. Task claim(java.lang.String whereClause,
  2. java.lang.String orderByClause,
  3. java.util.TimeZone timeZone)
  4. throws ArchiveUnsupportedOperationException
  5. CannotCreateWorkItemException
  6. SchedulingFailedException
  7. WorkItemManagerException
  8. UnexpectedFailureException
  9. CommunicationException
Claims some ready to-do or collaboration task instance for user processing. The task instance can be escalated.

Collaboration and to-do task instances are also known as human and participating task instances.

The task instance that is claimed is identified by the specified where- and order-by-clauses. The first task instance is claimed that qualifies under these conditions, that is not suspended, and for which the caller is a potential owner or administrator.

Refer to complete for information on how to complete a task instance.

The action associated to this method is TaskActions.CLAIM.

This method is not supported in archive mode.

Parameters:
whereClause - The search condition to be applied to the query domain. The search condition is used to filter the set of ready and not suspended task instances that can be claimed by the logged-on user. Its syntax is an SQL where-clause. The following rules apply:
  • Specify object ID constants as ID('string-rep-of-oid').
  • Specify timestamp constants as TS('yyyy-mm-ddThh:mm:ss') or as CURRENT_DATE for comparisons with the current date.
    The date and time parts of a TS definition are optional; either the date or the time must be specified. If no date part of a TS definition is specified, the current date is taken. Optional time values that are not specified are set to zero. The timestamp is 24 hours based. For example, TS('16:04') is the same as TS('2002-12-24T16:04:00') provided that the current date is December 24th, 2002.
    If a date part of a TS definition is specified, the year must consist of 4 letters; the month and day specifications are optional. Missing month and day specifications are set to 01. For example, specifying TS('2003') is the same as specifying TS('2003-01-01T00:00:00').
  • Specify binary constants as BIN('UTF-8 string').
  • Use constants instead of integer enumerations. For example, instead of specifying a task state expression "TASK.STATE=2" , specify "TASK.STATE=TASK.STATE.STATE_READY".

If a filter is not to be applied, null must be specified.

orderByClause - Sorts the query result set by the values of the columns you identify. The orderby-clause sorts the set of qualifying ready and not suspended tasks. Its syntax is an SQL order-by-clause. Each comma separated part of the order-by-clause must specify a property from the published views - see the InfoCenter for details.

If you identify more that one property, the query result set is ordered by the values of the first property you identify, then by the values of the second property, and so on.

If sort criteria are not to be applied, null must be specified.

Note that sort criteria are applied on the server, that is, the locale of the server is used for sorting.

timeZone - Specifies the time zone of the timestamp constants in the whereClause respectively the time zone for the timestamp values returned. If a timezone is not specified, UTC is assumed.

Returns:
Task - The task instance that is claimed. If there is no ready and not suspended task instance for the logged-on user, null is returned. Refer to Task to view the task instance properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

claim

  1. ClaimResult claim(java.lang.String queryTableName,
  2. FilterOptions filterOptions,
  3. AuthorizationOptions authorizationOptions,
  4. java.util.List parameters,
  5. int maxRetryCount)
  6. throws ApplicationVetoException
  7. ArchiveUnsupportedOperationException
  8. CannotCreateWorkItemException
  9. InvalidParameterException
  10. NotAuthorizedException
  11. ObjectDoesNotExistException
  12. ParameterNullException
  13. SchedulingFailedException
  14. WrongKindException
  15. UnexpectedFailureException
  16. TaskException
  17. CommunicationException
Claims a ready to-do or collaboration task instance contained in the specified query table. The primary query table must be TASK.

Collaboration and to-do task instances are also known as human and participating task instances.

The task instance that is claimed is identified by the options defined for the query table and the authorization and filter options specified for this request. The first task instance is claimed that qualifies under these conditions. The caller must be a potential owner or an administrator of the claimed task instance.

Note that, for best performance reasons, you should specify at least the conditions "KIND IN (KIND_PARTICIPATING, KIND_HUMAN) AND STATE=STATE_READY" on the primary query table TASK when modeling the query table.

Refer to complete for information on how to complete a task instance.

The action associated to this method is TaskActions.CLAIM.

This method is not supported in archive mode.

Parameters:
queryTableName - The name of the query table.
filterOptions - The filter options to be applied in addition to any filters defined for the query table. Refer to FilterOptions.
authorizationOptions - The authorization options to be applied in addition to any authorization specifications defined for the query table.

Authorization options can be specified for predefined query tables that contain instance data or for composite query tables that define a primary query table which contains instance data and that use instance-based authorization. If authorization options are specified for query tables that do not contain instance but template data, a NotAuthorizedException is thrown. They are ignored for supplemental query tables.

System administrators and monitors can use the AdminAuthorizationOptions to run queries that need special authorization, for example, to run a query on behalf of another user. These options must be specified when the query is run on predefined query tables. When the query is run on composite query tables and the primary view contains template data, administrative options must be specified if role-based authorization is required. When specified for a predefined query table that contains instance data or for a composite query table with a primary view that contains instance data, then all data contained in the query table is returned.

Refer to AuthorizationOptions or AdminAuthorizationOptions.

parameters - A list of Parameter objects to set values for parameters used in query table filters and selection criteria. Refer to Parameter.
maxRetryCount - In case of concurrency conflicts, specifies how often claiming a task should be retried. For example, if the first task instance that qualifies cannot be claimed because it is just claimed by another user, then a retry count of 1 specifies that the next qualifying task instance should be claimed. If also unsuccessful, the claiming process ends.

If claiming should not be retried, 0 must be specified. If there are less qualifying task instances than the mayRetryCount, all qualifying task instances are tried to be claimed if necessary.

Returns:
ClaimResult - The result of the claim. Refer to ClaimResult for details.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

Change History

Release Modification
7.0.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

claim

  1. java.util.List claim(java.lang.String[] identifiers)
  2. throws ArchiveUnsupportedOperationException
  3. CannotCreateWorkItemException
  4. IdWrongFormatException
  5. IdWrongTypeException
  6. SchedulingFailedException
  7. UnexpectedFailureException
  8. CommunicationException
Claims ready to-do or collaboration task instances for user processing using string representations of task instance IDs. The task instances can be escalated but only suspended when the 'supportsClaimIfSuspended' property is set. The collaboration task instance must be stand-alone.

Collaboration and to-do task instances are also known as human and participating task instances.

The caller must be a potential owner or an administrator of the task instances.

The states of the task instances are changed to claimed. Refer to complete for information on how to complete a task instance.

The action associated to this method is TaskActions.CLAIM.

This method is not supported in archive mode.

Parameters:
identifiers - An array of task instance IDs that are used to identify the task instances to be claimed.

Returns:
List - A list of ClaimResult objects, one for every task instance specified. Refer to ClaimResult.

If a single claim operation fails because any of the following exceptions has been thrown, then the result object contains the respective exception. Otherwise, the TaskException property is null.

  • com.ibm.task.api.ApplicationVetoException
  • com.ibm.task.api.NotAuthorizedException
  • com.ibm.task.api.ObjectDoesNotExistException
  • com.ibm.task.api.WrongKindException
  • com.ibm.task.api.WrongStateException
If any of these exceptions is thrown, processing continues. If another exception is thrown, a rollback of the global transaction is enforced, and all claim operations are undone.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a SchedulingFailedException when scheduling a task failed.

claim

  1. java.util.List claim(TKIID[] tkiids)
  2. throws ArchiveUnsupportedOperationException
  3. CannotCreateWorkItemException
  4. IdWrongFormatException
  5. SchedulingFailedException
  6. UnexpectedFailureException
  7. CommunicationException
Claims ready to-do or collaboration task instances for user processing using task instance IDs. The task instances can be escalated but only suspended when the 'supportsClaimIfSuspended' property is set. The collaboration task instance must be stand-alone.

Collaboration and to-do task instances are also known as human and participating task instances.

The caller must be a potential owner or an administrator of the task instances.

The states of the task instances are changed to claimed. Refer to complete for information on how to complete a task instance.

The action associated to this method is TaskActions.CLAIM.

This method is not supported in archive mode.

Parameters:
tkiids - An array of task instance IDs that are used to identify the task instances to be claimed.

Returns:
List - A list of ClaimResult objects, one for every task instance specified. Refer to ClaimResult.

If a single claim operation fails because any of the following exceptions has been thrown, then the result object contains the respective exception. Otherwise, the TaskException property is null.

  • com.ibm.task.api.ApplicationVetoException
  • com.ibm.task.api.NotAuthorizedException
  • com.ibm.task.api.ObjectDoesNotExistException
  • com.ibm.task.api.WrongKindException
  • com.ibm.task.api.WrongStateException
If any of these exceptions is thrown, processing continues. If another exception is thrown, a rollback of the global transaction is enforced, and all claim operations are undone.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a SchedulingFailedException when scheduling a task failed.

complete

  1. void complete(java.lang.String tkiid)
  2. throws ApplicationVetoException
  3. ArchiveUnsupportedOperationException
  4. IdWrongFormatException
  5. IdWrongTypeException
  6. NotAuthorizedException
  7. ObjectDoesNotExistException
  8. ParallelRoutingTaskException
  9. SchedulingFailedException
  10. WrongKindException
  11. WrongStateException
  12. UnexpectedFailureException
  13. CommunicationException
Completes a claimed task instance using a string representation of the task instance ID.

The task instance must be in the claimed state. It can be escalated. The caller must be the owner or an administrator of the task instance.

Completion of a task instance means that user processing has finished. If user processing completed successfully, the task instance is put into the finished state.

If user processing did not complete successfully, that is, if a fault message is set, the task instance is put into the failed state.

The action associated to this method is TaskActions.COMPLETE.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID that is used to identify the task instance to be completed.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.0 Throws an ApplicationFailedException when the application refuses to execute the method.
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when completion of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

complete

  1. void complete(TKIID tkiid)
  2. throws ApplicationVetoException
  3. ArchiveUnsupportedOperationException
  4. IdWrongFormatException
  5. NotAuthorizedException
  6. ObjectDoesNotExistException
  7. ParallelRoutingTaskException
  8. SchedulingFailedException
  9. WrongKindException
  10. WrongStateException
  11. UnexpectedFailureException
  12. CommunicationException
Completes a claimed task instance using the task instance ID.

The task instance must be in the claimed state. It can be escalated. The caller must be the owner or an administrator of the task instance.

Completion of a task instance means that user processing has finished. If user processing completed successfully, the task instance is put into the finished state.

If user processing did not complete successfully, that is, if a fault message is set, the task instance is put into the failed state.

The action associated to this method is TaskActions.COMPLETE.

This method is not supported in archive mode.

Parameters:
tkiid - The object ID to identify the task instance to be completed.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.0 Throws an ApplicationFailedException when the application refuses to execute the method.
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when completion of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

complete

  1. void complete(java.lang.String tkiid,
  2. ClientObjectWrapper output)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. IdWrongFormatException
  6. IdWrongTypeException
  7. NotAuthorizedException
  8. ObjectDoesNotExistException
  9. ParallelRoutingTaskException
  10. ParameterNullException
  11. SchedulingFailedException
  12. WrongKindException
  13. WrongMessageTypeException
  14. WrongStateException
  15. UnexpectedFailureException
  16. CommunicationException
Completes a claimed task instance using a string representation of the task instance ID and passes the result of user processing.

The task instance must be in the claimed state. It can be escalated. The caller must be the owner or an administrator of the task instance.

The action associated to this method is TaskActions.COMPLETE.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID that is used to identify the task instance to be completed.
output - The output message that denotes the successful result of processing. Note that an object wrapped by the ClientObjectWrapper must be serializable.

Any previously set output or fault message is ignored.

Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.0 Throws an ApplicationFailedException when the application refuses to execute the method.
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when completion of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

complete

  1. void complete(TKIID tkiid,
  2. ClientObjectWrapper output)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. IdWrongFormatException
  6. NotAuthorizedException
  7. ObjectDoesNotExistException
  8. ParallelRoutingTaskException
  9. ParameterNullException
  10. SchedulingFailedException
  11. WrongKindException
  12. WrongMessageTypeException
  13. WrongStateException
  14. UnexpectedFailureException
  15. CommunicationException
Completes a claimed task instance using the task instance ID and passes the result of user processing.

The task instance must be in the claimed state. It can be escalated. The caller must be the owner or an administrator of the task instance.

The action associated to this method is TaskActions.COMPLETE.

This method is not supported in archive mode.

Parameters:
tkiid - The object ID to identify the task instance to be completed.
output - The output message that denotes the successful result of processing. Note that an object wrapped by the ClientObjectWrapper must be serializable.

Any previously set output or fault message is ignored.

Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.0 Throws an ApplicationFailedException when the application refuses to execute the method.
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when completion of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

complete

  1. void complete(java.lang.String tkiid,
  2. java.lang.String faultName,
  3. ClientObjectWrapper faultMessage)
  4. throws ApplicationVetoException
  5. ArchiveUnsupportedOperationException
  6. IdWrongFormatException
  7. IdWrongTypeException
  8. InvalidQNameException
  9. NotAuthorizedException
  10. ObjectDoesNotExistException
  11. ParallelRoutingTaskException
  12. ParameterNullException
  13. SchedulingFailedException
  14. WrongKindException
  15. WrongMessageTypeException
  16. WrongStateException
  17. UnexpectedFailureException
  18. CommunicationException
Completes a claimed task instance using a string representation of the task instance ID and states the failing of user processing.

The task instance must be in the claimed state. It can be escalated. The caller must be the owner or an administrator of the task instance.

Completion of a task instance means that user processing finished. A fault message is passed to state the unsuccessful execution of user processing. The task instance is put into the failed state.

The action associated to this method is TaskActions.COMPLETE.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID that is used to identify the task instance to be completed.
faultName - A fault name to state unsuccessful processing. The fault name must point to a fault that is defined for the task. Refer to getFaultNames.
faultMessage - The fault message. Not that the object wrapped by the ClientObjectWrapper must be serializable.

Any previously set output or fault message is ignored.

Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.0 Throws an ApplicationFailedException when the application refuses to execute the method.
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when completion of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

complete

  1. void complete(TKIID tkiid,
  2. java.lang.String faultName,
  3. ClientObjectWrapper faultMessage)
  4. throws ApplicationVetoException
  5. ArchiveUnsupportedOperationException
  6. IdWrongFormatException
  7. InvalidQNameException
  8. NotAuthorizedException
  9. ObjectDoesNotExistException
  10. ParallelRoutingTaskException
  11. ParameterNullException
  12. SchedulingFailedException
  13. WrongKindException
  14. WrongMessageTypeException
  15. WrongStateException
  16. UnexpectedFailureException
  17. CommunicationException
Completes a claimed task instance using the task instance ID and states the failing of user processing.

The task instance must be in the claimed state. It can be escalated. The caller must be the owner or an administrator of the task instance.

Completion of a task instance means that user processing finished. A fault message is passed to state the unsuccessful execution of user processing. The task instance is put into the failed state.

The action associated to this method is TaskActions.COMPLETE.

This method is not supported in archive mode.

Parameters:
tkiid - The object ID to identify the task instance to be completed.
faultName - A fault name to state unsuccessful processing. The fault name must point to a fault that is defined for the task. Refer to getFaultNames.
faultMessage - The fault message. Note that the object wrapped by the ClientObjectWrapper must be serializable.

Any previously set output or fault message is ignored.

Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.0 Throws an ApplicationFailedException when the application refuses to execute the method.
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when completion of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

complete

  1. java.util.List complete(java.lang.String[] tkiids)
  2. throws ArchiveUnsupportedOperationException
  3. IdWrongFormatException
  4. IdWrongTypeException
  5. ParallelRoutingTaskException
  6. SchedulingFailedException
  7. UnexpectedFailureException
  8. CommunicationException
Completes the specified task instances using string representations of the task instance IDs.

The task instances must be in the claimed state. They can be escalated. The caller must be the owner or an administrator of the task instances.

Completion of a task instance means that user processing has finished. If user processing completed successfully, the task instance is put into the finished state.

If user processing did not complete successfully, that is, if a fault message has been set, the task instance is put into the failed state.

The action associated to this method is TaskActions.COMPLETE.

This method is not supported in archive mode.

Parameters:
tkiids - An array of task instance IDs that identify the task instances to be completed

Returns:
List - A list of TaskResult objects, one for every task instance specified. Refer to TaskResult.

If a single complete operation fails because any of the following exceptions has been thrown, then the result object contains the respective exception. Otherwise, the TaskException property is null.

  • com.ibm.task.api.ApplicationVetoException
  • com.ibm.task.api.NotAuthorizedException
  • com.ibm.task.api.ObjectDoesNotExistException
  • com.ibm.task.api.WrongKindException
  • com.ibm.task.api.WrongStateException
If any of these exceptions is thrown, processing continues. If another exception is thrown, a rollback of the global transaction is enforced, and all complete operations are undone.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when completion of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

complete

  1. java.util.List complete(TKIID[] tkiids)
  2. throws ArchiveUnsupportedOperationException
  3. IdWrongFormatException
  4. ParallelRoutingTaskException
  5. SchedulingFailedException
  6. UnexpectedFailureException
  7. CommunicationException
Completes the specified task instances using task instance IDs.

The task instances must be in the claimed state. They can be escalated. The caller must be the owner or an administrator of the task instances.

Completion of a task instance means that user processing has finished. If user processing completed successfully, the task instance is put into the finished state.

If user processing did not complete successfully, that is, if a fault message has been set, the task instance is put into the failed state.

The action associated to this method is TaskActions.COMPLETE.

This method is not supported in archive mode.

Parameters:
tkiids - An array of task instance IDs that identify the task instances to be completed

Returns:
List - A list of TaskResult objects, one for every task instance specified. Refer to TaskResult.

If a single complete operation fails because any of the following exceptions has been thrown, then the result object contains the respective exception. Otherwise, the TaskException property is null.

  • com.ibm.task.api.ApplicationVetoException
  • com.ibm.task.api.NotAuthorizedException
  • com.ibm.task.api.ObjectDoesNotExistException
  • com.ibm.task.api.ParameterNullException
  • com.ibm.task.api.WrongKindException
  • com.ibm.task.api.WrongStateException
If any of these exceptions is thrown, processing continues. If another exception is thrown, a rollback of the global transaction is enforced, and all complete operations are undone.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when completion of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

completeWithFollowOnTask

  1. void completeWithFollowOnTask(java.lang.String tkiid,
  2. java.lang.String followOnID,
  3. ClientObjectWrapper input)
  4. throws AdministratorCannotBeResolvedException
  5. ApplicationVetoException
  6. ArchiveUnsupportedOperationException
  7. CannotCreateWorkItemException
  8. FaultMessageDefinitionDoesNotMatchException
  9. FollowOnTasksNotSupportedException
  10. IdWrongFormatException
  11. IdWrongTypeException
  12. InvalidLengthException
  13. NotAuthorizedException
  14. UserDoesNotExistException
  15. ObjectDoesNotExistException
  16. OutputMessageDefinitionDoesNotMatchException
  17. ParallelRoutingTaskException
  18. SCAServiceAccessFailureException
  19. SCAServiceResultErrorException
  20. SchedulingFailedException
  21. WrongKindException
  22. WrongMessageTypeException
  23. WrongStateException
  24. UnexpectedFailureException
  25. CommunicationException
Completes a task instance and starts a follow-on task using a string representation of the task instance ID.

The task instance that is completed must be in the claimed state. It can be escalated. As a result of this call, it is set into the forwarded state. If a reply handler is specified, it is called when the last follow-on task in a possible chain is finished.

The task instance that is started as follow-on task must be in the inactive state. It can be a collaboration or stand-alone invocation task. Escalation or deletion timer settings of the completed task become active.

Collaboration and invocation task instances are also known as human and originating task instances.

The output and fault message definitions of the completed and the follow-on task must be of the same type. The types of the input messages may differ. Any output or fault message stored persistently is automatically passed to the follow-on task. The input message is passed if it is of the same type and if not specified otherwise - see the input parameter below.

The caller must be the owner or an administrator of the task instance that is to be completed and must be allowed to at least read the follow-on task.

The action associated to this method is TaskActions.COMPLETEWITHFOLLOWONTASK.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID that is used to identify the task instance to be completed.
followOnID - A string representation of the task instance ID that is used to identify the task instance that is to follow.
input - An optional input message for the follow-on task. If not specified, the input message of the completed task is passed to the follow-on task provided that they are of the same type.

Note that an object wrapped by the ClientObjectWrapper must be serializable.

Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when completion of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

completeWithFollowOnTask

  1. void completeWithFollowOnTask(TKIID tkiid,
  2. TKIID followOnID,
  3. ClientObjectWrapper input)
  4. throws AdministratorCannotBeResolvedException
  5. ApplicationVetoException
  6. ArchiveUnsupportedOperationException
  7. CannotCreateWorkItemException
  8. FaultMessageDefinitionDoesNotMatchException
  9. FollowOnTasksNotSupportedException
  10. IdWrongFormatException
  11. InvalidLengthException
  12. NotAuthorizedException
  13. UserDoesNotExistException
  14. ObjectDoesNotExistException
  15. OutputMessageDefinitionDoesNotMatchException
  16. ParallelRoutingTaskException
  17. SCAServiceAccessFailureException
  18. SCAServiceResultErrorException
  19. SchedulingFailedException
  20. WrongKindException
  21. WrongMessageTypeException
  22. WrongStateException
  23. UnexpectedFailureException
  24. CommunicationException
Completes a task instance and starts a follow-on task using the task instance ID.

The task instance that is completed must be in the claimed state. It can be escalated. As a result of this call, it is set into the forwarded state. If a reply handler is specified, it is called when the last follow-on task in a possible chain is finished.

The task instance that is started as follow-on task must be in the inactive state. It can be a collaboration or stand-alone invocation task. Escalation or deletion timer settings of the completed task become active.

Collaboration and invocation task instances are also known as human and originating task instances.

The output and fault message definitions of the completed and the follow-on task must be of the same type. The types of the input messages may differ. Any output or fault message stored persistently is automatically passed to the follow-on task. The input message is passed if it is of the same type and if not specified otherwise - see the input parameter below.

The caller must be the owner or an administrator of the task instance that is to be completed and must be allowed to at least read the follow-on task.

The action associated to this method is TaskActions.COMPLETEWITHFOLLOWONTASK.

This method is not supported in archive mode.

Parameters:
tkiid - The object ID to identify the task instance to be completed.
followOnID - The object ID to identify the task instance that is to follow.
input - An optional input message for the follow-on task. If not specified, the input message of the completed task is passed to the follow-on task provided that they are of the same type.

Note that an object wrapped by the ClientObjectWrapper must be serializable.

Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when completion of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

completeWithNewFollowOnTask

  1. void completeWithNewFollowOnTask( java.lang.String tkiid,
  2. java.lang.String name,
  3. java.lang.String namespace,
  4. ClientObjectWrapper input)
  5. throws AdministratorCannotBeResolvedException
  6. ApplicationVetoException
  7. ArchiveUnsupportedOperationException
  8. CannotCreateWorkItemException
  9. FaultMessageDefinitionDoesNotMatchException
  10. FollowOnTasksNotSupportedException
  11. IdWrongFormatException
  12. IdWrongTypeException
  13. InvalidApplicationStateException
  14. InvalidLengthException
  15. NotAuthorizedException
  16. UserDoesNotExistException
  17. ObjectDoesNotExistException
  18. OutputMessageDefinitionDoesNotMatchException
  19. ParallelRoutingTaskException
  20. ParameterNullException
  21. SCAServiceAccessFailureException
  22. SCAServiceResultErrorException
  23. SchedulingFailedException
  24. WrongKindException
  25. WrongMessageTypeException
  26. WrongStateException
  27. UnexpectedFailureException
  28. CommunicationException
Completes a task instance and creates and starts a follow-on task using a string representation of the task instance ID.

The task instance that is completed must be in the claimed state. It can be escalated. As a result of this call, it is set into the forwarded state. If a reply handler is specified, it is called when the last follow-on task in a possible chain is finished.

The task instance that is created and started as follow-on task must be a collaboration or stand-alone invocation task. Escalation or deletion timer settings of the completed task become active.

Collaboration and invocation task instances are also known as human and originating task instances.

The output and fault message definitions of the completed and the follow-on task must be of the same type. The types of the input messages may differ. Any output or fault message stored persistently is automatically passed to the follow-on task. The input message is passed if it is of the same type and if not specified otherwise - see the input parameter below.

The caller must be the owner or an administrator of the completed task instance. The caller must be a potential instance creator or an administrator of the task template.

The action associated to this method is TaskTemplateActions.COMPLETEWITHNEWFOLLOWONTASK.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID that is used to identify the task instance to be completed.
name - The name of the task template from which an instance is to be created as follow-on task. The currently valid template is then instantiated.
namespace - The namespace of the task template.
input - An optional input message for the follow-on task. If not specified, the input message of the completed task is passed to the follow-on task provided that they are of the same type.

Note that an object wrapped by the ClientObjectWrapper must be serializable.

Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when completion of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

completeWithNewFollowOnTask

  1. void completeWithNewFollowOnTask( TKIID tkiid,
  2. java.lang.String name,
  3. java.lang.String namespace,
  4. ClientObjectWrapper input)
  5. throws AdministratorCannotBeResolvedException
  6. ApplicationVetoException
  7. ArchiveUnsupportedOperationException
  8. CannotCreateWorkItemException
  9. FaultMessageDefinitionDoesNotMatchException
  10. FollowOnTasksNotSupportedException
  11. IdWrongFormatException
  12. InvalidApplicationStateException
  13. InvalidLengthException
  14. NotAuthorizedException
  15. UserDoesNotExistException
  16. ObjectDoesNotExistException
  17. OutputMessageDefinitionDoesNotMatchException
  18. ParallelRoutingTaskException
  19. ParameterNullException
  20. SCAServiceAccessFailureException
  21. SCAServiceResultErrorException
  22. SchedulingFailedException
  23. WrongKindException
  24. WrongMessageTypeException
  25. WrongStateException
  26. UnexpectedFailureException
  27. CommunicationException
Completes a task instance and creates and starts a follow-on task using the task instance ID.

The task instance that is completed must be in the claimed state. It can be escalated. As a result of this call, it is set into the forwarded state. If a reply handler is specified, it is called when the last follow-on task in a possible chain is finished.

The task instance that is created and started as follow-on task must be a collaboration or stand-alone invocation task. Escalation or deletion timer settings of the completed task become active.

Collaboration and invocation task instances are also known as human and originating task instances.

The output and fault message definitions of the completed and the follow-on task must be of the same type. The types of the input messages may differ. Any output or fault message stored persistently is automatically passed to the follow-on task. The input message is passed if it is of the same type and if not specified otherwise - see the input parameter below.

The caller must be the owner or an administrator of the completed task instance. The caller must be a potential instance creator or an administrator of the task template.

The action associated to this method is TaskTemplateActions.COMPLETEWITHNEWFOLLOWONTASK.

This method is not supported in archive mode.

Parameters:
tkiid - The object ID to identify the task instance to be completed.
name - The name of the task template from which an instance is to be created as follow-on task. The currently valid template is then instantiated.
namespace - The namespace of the task template.
input - An optional input message for the follow-on task. If not specified, the input message of the completed task is passed to the follow-on task provided that they are of the same type.

Note that an object wrapped by the ClientObjectWrapper must be serializable.

Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when completion of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

completeWithNewFollowOnTask

  1. void completeWithNewFollowOnTask( java.lang.String tkiid,
  2. TaskModel taskModel,
  3. java.lang.String applicationName,
  4. ClientObjectWrapper input)
  5. throws AdministratorCannotBeResolvedException
  6. ApplicationVetoException
  7. ArchiveUnsupportedOperationException
  8. CannotCreateWorkItemException
  9. FaultMessageDefinitionDoesNotMatchException
  10. FollowOnTasksNotSupportedException
  11. IdWrongFormatException
  12. IdWrongTypeException
  13. InvalidLengthException
  14. NotAuthorizedException
  15. UserDoesNotExistException
  16. ObjectDoesNotExistException
  17. OutputMessageDefinitionDoesNotMatchException
  18. ParallelRoutingTaskException
  19. ParameterNullException
  20. SchedulingFailedException
  21. TaskDeploymentException
  22. TELValidationException
  23. WrongKindException
  24. WrongMessageTypeException
  25. WrongStateException
  26. UnexpectedFailureException
  27. CommunicationException
Completes a task instance and creates and starts an ad hoc follow-on task using a string representation of the task instance ID.

The task instance that is completed must be in the claimed state. It can be escalated. As a result of this call, it is set into the forwarded state. If a reply handler is specified, it is called when the last follow-on task in a possible chain is finished.

The task instance that is created and started as follow-on task must be a collaboration or stand-alone invocation task. Escalation or deletion timer settings of the completed task become active.

Collaboration and invocation task instances are also known as human and originating task instances.

The output and fault message definitions of the completed and the follow-on task must be of the same type. The types of the input messages may differ. Any output or fault message stored persistently is automatically passed to the follow-on task. The input message is passed if it is of the same type and if not specified otherwise - see the input parameter below.

The caller must be the owner or an administrator of the completed task instance. The caller must have potential-instance-creator rights on the associated application component which is inherited from the completed task instance.

The action associated to this method is TaskTemplateActions.COMPLETEWITHNEWFOLLOWONTASK.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID that is used to identify the task instance to be completed.
taskModel - The model that describes the task template from which a follow-on task is to be created at Runtime.
applicationName - The name of the enterprise application that contains the message or business calendar definitions used in the TaskModel. If the message definitions are simple types only or if you do not use a business calendar, null may be specified.
input - An optional input message for the follow-on task. If not specified, the input message of the completed task is passed to the follow-on task provided that they are of the same type.

Note that an object wrapped by the ClientObjectWrapper must be serializable.

Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when completion of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

completeWithNewFollowOnTask

  1. void completeWithNewFollowOnTask( TKIID tkiid,
  2. TaskModel taskModel,
  3. java.lang.String applicationName,
  4. ClientObjectWrapper input)
  5. throws AdministratorCannotBeResolvedException
  6. ApplicationVetoException
  7. ArchiveUnsupportedOperationException
  8. CannotCreateWorkItemException
  9. FaultMessageDefinitionDoesNotMatchException
  10. FollowOnTasksNotSupportedException
  11. IdWrongFormatException
  12. InvalidLengthException
  13. NotAuthorizedException
  14. UserDoesNotExistException
  15. ObjectDoesNotExistException
  16. OutputMessageDefinitionDoesNotMatchException
  17. ParallelRoutingTaskException
  18. ParameterNullException
  19. SchedulingFailedException
  20. TaskDeploymentException
  21. TELValidationException
  22. WrongKindException
  23. WrongMessageTypeException
  24. WrongStateException
  25. UnexpectedFailureException
  26. CommunicationException
Completes a task instance and creates and starts an ad hoc follow-on task using the task instance ID.

The task instance that is completed must be in the claimed state. It can be escalated. As a result of this call, it is set into the forwarded state. If a reply handler is specified, it is called when the last follow-on task in a possible chain is finished.

The task instance that is created and started as follow-on task must be a collaboration or stand-alone invocation task. Escalation or deletion timer settings of the completed task become active.

Collaboration and invocation task instances are also known as human and originating task instances.

The output and fault message definitions of the completed and the follow-on task must be of the same type. The types of the input messages may differ. Any output or fault message stored persistently is automatically passed to the follow-on task. The input message is passed if it is of the same type and if not specified otherwise - see the input parameter below.

The caller must be the owner or an administrator of the completed task instance. The caller must have potential-instance-creator rights on the associated application component which is inherited from the completed task instance.

The action associated to this method is TaskTemplateActions.COMPLETEWITHNEWFOLLOWONTASK.

This method is not supported in archive mode.

Parameters:
tkiid - The object ID to identify the task instance to be completed.
taskModel - The model that describes the task template from which a follow-on task is to be created at Runtime.
applicationName - The name of the enterprise application that contains the message or business calendar definitions used in the TaskModel. If the message definitions are simple types only or if you do not use a business calendar, null may be specified.
input - An optional input message for the follow-on task. If not specified, the input message of the completed task is passed to the follow-on task provided that they are of the same type.

Note that an object wrapped by the ClientObjectWrapper must be serializable.

Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when completion of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

createAndCallTask

  1. ClientObjectWrapper createAndCallTask( java.lang.String tktid,
  2. ClientObjectWrapper input)
  3. throws AdministratorCannotBeResolvedException
  4. ApplicationVetoException
  5. ArchiveUnsupportedOperationException
  6. CannotCreateWorkItemException
  7. FaultReplyException
  8. IdWrongFormatException
  9. IdWrongTypeException
  10. InvalidApplicationStateException
  11. InvalidLengthException
  12. NotAuthorizedException
  13. ObjectDoesNotExistException
  14. SCAServiceAccessFailureException
  15. SCAServiceResultErrorException
  16. SchedulingFailedException
  17. WrongKindException
  18. WrongMessageTypeException
  19. WrongStateException
  20. UnexpectedFailureException
  21. CommunicationException
Creates and synchronously executes an invocation task instance using a string representation of the task template ID. An input message can be passed to specify initial values for the task.

Note that an invocation task instance is also known as originating task instance.

This method returns only when the execution of the task finishes with the result of execution. If a fault occurs, an exception is thrown. The service that is called must be a two-way operation. Otherwise, SCAServiceAccessFailureException is thrown.

The caller must be a potential instance creator or an administrator of the task template.

The action associated to this method is TaskTemplateActions.CREATEANDCALLTASK.

This method is not supported in archive mode.

Parameters:
tktid - The string representation of a task template ID from which an instance is to be created and executed. A WrongStateException is thrown when the specified task template is stopped.
input - The input message. Note that the object wrapped by the ClientObjectWrapper must be serializable.

Returns:
ClientObjectWrapper - The output message to state the result of execution.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.5

createAndCallTask

  1. ClientObjectWrapper createAndCallTask( TKTID tktid,
  2. ClientObjectWrapper input)
  3. throws AdministratorCannotBeResolvedException
  4. ApplicationVetoException
  5. ArchiveUnsupportedOperationException
  6. CannotCreateWorkItemException
  7. FaultReplyException
  8. IdWrongFormatException
  9. InvalidApplicationStateException
  10. InvalidLengthException
  11. NotAuthorizedException
  12. ObjectDoesNotExistException
  13. SCAServiceAccessFailureException
  14. SCAServiceResultErrorException
  15. SchedulingFailedException
  16. WrongKindException
  17. WrongMessageTypeException
  18. WrongStateException
  19. UnexpectedFailureException
  20. CommunicationException
Creates and synchronously executes an invocation task instance using the task template ID. An input message can be passed to specify initial values for the task.

Note that an invocation task instance is also known as originating task instance.

This method returns only when the execution of the task finishes with the result of execution. If a fault occurs, an exception is thrown. The service that is called must be a two-way operation. Otherwise, SCAServiceAccessFailureException is thrown.

The caller must be a potential instance creator or an administrator of the task template.

The action associated to this method is TaskTemplateActions.CREATEANDCALLTASK.

This method is not supported in archive mode.

Parameters:
tktid - The task template ID of the task template from which an instance is to be created and executed. A WrongStateException is thrown when the specified task template is stopped.
input - The input message. Note that the object wrapped by the ClientObjectWrapper must be serializable.

Returns:
ClientObjectWrapper - The output message to state the result of execution.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.5

createAndCallTask

  1. ClientObjectWrapper createAndCallTask( java.lang.String name,
  2. java.lang.String namespace,
  3. ClientObjectWrapper input)
  4. throws AdministratorCannotBeResolvedException
  5. ApplicationVetoException
  6. ArchiveUnsupportedOperationException
  7. CannotCreateWorkItemException
  8. FaultReplyException
  9. InvalidApplicationStateException
  10. InvalidLengthException
  11. NotAuthorizedException
  12. ObjectDoesNotExistException
  13. ParameterNullException
  14. SCAServiceAccessFailureException
  15. SCAServiceResultErrorException
  16. SchedulingFailedException
  17. WrongKindException
  18. WrongMessageTypeException
  19. WrongStateException
  20. UnexpectedFailureException
  21. CommunicationException
Creates and synchronously executes an invocation task instance. An input message can be passed to specify initial values for the task.

An invocation task instance is also known as originating task instance.

This method returns only when the execution of the task finishes with the result of execution. If a fault occurs, an exception is thrown. The service that is called must be a two-way operation. Otherwise, SCAServiceAccessFailureException is thrown.

The caller must be a potential instance creator or an administrator of the task template.

The action associated to this method is TaskTemplateActions.CREATEANDCALLTASK.

This method is not supported in archive mode.

Parameters:
name - The name of the task template from which an instance is to be created and executed. The currently valid template is then instantiated. A WrongStateException is thrown when the currently valid template is stopped.
namespace - The namespace of the task template.
input - The input message. Note that the object wrapped by the ClientObjectWrapper must be serializable.

Returns:
ClientObjectWrapper - The output message to state the result of execution.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

createAndStartTask

  1. TKIID createAndStartTask(java.lang.String tktid,
  2. ClientObjectWrapper input,
  3. ReplyHandlerWrapper replyHandler)
  4. throws AdministratorCannotBeResolvedException
  5. ApplicationVetoException
  6. ArchiveUnsupportedOperationException
  7. CannotCreateWorkItemException
  8. IdWrongFormatException
  9. IdWrongTypeException
  10. InvalidApplicationStateException
  11. InvalidLengthException
  12. NotAuthorizedException
  13. ObjectDoesNotExistException
  14. ParallelRoutingTaskException
  15. SCAServiceAccessFailureException
  16. SCAServiceResultErrorException
  17. SchedulingFailedException
  18. WrongKindException
  19. WrongMessageTypeException
  20. WrongStateException
  21. UnexpectedFailureException
  22. CommunicationException
Creates and starts a task instance using a string representation of the task template ID.

The caller must be a potential instance creator or an administrator of the task template. The caller becomes the originator of the task. When the task is an invocation aka originating task, then the caller also becomes the starter of the task.

The action associated to this method is TaskTemplateActions.CREATEANDSTARTTASK.

This method is not supported in archive mode.

Parameters:
tktid - The string representation of the task template ID from which an instance is to be created and started. A WrongStateException is thrown when the specified task template is stopped.
input - The input message. Note that the object wrapped by the ClientObjectWrapper must be serializable.
replyHandler - The reply handler to be used in order to send the result of execution automatically back to the caller. "null" must be specified if no reply handler is to be used.

Returns:
TKIID - The task instance ID of the task created.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.5

createAndStartTask

  1. TKIID createAndStartTask(TKTID tktid,
  2. ClientObjectWrapper input,
  3. ReplyHandlerWrapper replyHandler)
  4. throws AdministratorCannotBeResolvedException
  5. ApplicationVetoException
  6. ArchiveUnsupportedOperationException
  7. CannotCreateWorkItemException
  8. IdWrongFormatException
  9. InvalidApplicationStateException
  10. InvalidLengthException
  11. NotAuthorizedException
  12. ObjectDoesNotExistException
  13. ParallelRoutingTaskException
  14. SCAServiceAccessFailureException
  15. SCAServiceResultErrorException
  16. SchedulingFailedException
  17. WrongKindException
  18. WrongMessageTypeException
  19. WrongStateException
  20. UnexpectedFailureException
  21. CommunicationException
Creates and starts a task instance using the task template ID.

The caller must be a potential instance creator or an administrator of the task template. The caller becomes the originator of the task. When the task is an invocation aka originating task, then the caller also becomes the starter of the task.

The action associated to this method is TaskTemplateActions.CREATEANDSTARTTASK.

This method is not supported in archive mode.

Parameters:
tktid - The task template ID from which an instance is to be created and started. A WrongStateException is thrown when the specified task template is stopped.
input - The input message. Note that the object wrapped by the ClientObjectWrapper must be serializable.
replyHandler - The reply handler to be used in order to send the result of execution automatically back to the caller. "null" must be specified if no reply handler is to be used.

Returns:
TKIID - The task instance ID of the task created.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.5

createAndStartTask

  1. TKIID createAndStartTask(java.lang.String name,
  2. java.lang.String namespace,
  3. ClientObjectWrapper input,
  4. ReplyHandlerWrapper replyHandler)
  5. throws AdministratorCannotBeResolvedException
  6. ApplicationVetoException
  7. ArchiveUnsupportedOperationException
  8. CannotCreateWorkItemException
  9. InvalidApplicationStateException
  10. InvalidLengthException
  11. NotAuthorizedException
  12. UserDoesNotExistException
  13. ObjectDoesNotExistException
  14. ParallelRoutingTaskException
  15. ParameterNullException
  16. SCAServiceAccessFailureException
  17. SCAServiceResultErrorException
  18. SchedulingFailedException
  19. WrongKindException
  20. WrongMessageTypeException
  21. WrongStateException
  22. UnexpectedFailureException
  23. CommunicationException
Creates and starts a task instance from the currently valid task template.

The caller must be a potential instance creator or an administrator of the task template. The caller becomes the originator of the task. When the task is an invocation aka originating task, then the caller also becomes the starter of the task.

The action associated to this method is TaskTemplateActions.CREATEANDSTARTTASK.

This method is not supported in archive mode.

Parameters:
name - The name of the task template from which an instance is to be created and started. The currently valid template is then instantiated. A WrongStateException is thrown when the currently valid template is stopped.
namespace - The namespace of the task template.
input - The input message. Note that the object wrapped by the ClientObjectWrapper must be serializable.
replyHandler - The reply handler to be used in order to send the result of execution automatically back to the caller. "null" must be specified if no reply handler is to be used.

Returns:
TKIID - The task instance ID of the task created.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when starting of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

createAndStartTask

  1. TKIID createAndStartTask(TaskModel taskModel,
  2. java.lang.String applicationName,
  3. java.lang.String parentContext,
  4. ClientObjectWrapper input,
  5. ReplyHandlerWrapper replyHandler)
  6. throws AdministratorCannotBeResolvedException
  7. ApplicationVetoException
  8. ArchiveUnsupportedOperationException
  9. CannotCreateWorkItemException
  10. IdWrongTypeException
  11. InvalidLengthException
  12. NotAuthorizedException
  13. UserDoesNotExistException
  14. ObjectDoesNotExistException
  15. ParallelRoutingTaskException
  16. ParameterNullException
  17. SchedulingFailedException
  18. WrongMessageTypeException
  19. UnexpectedFailureException
  20. TaskDeploymentException
  21. TELValidationException
  22. CommunicationException
Creates and starts a task from the specified task model.

The caller must have potential-instance-creator rights on the associated application component. The caller becomes the originator of the new task.

The action associated to this method is TaskTemplateActions.CREATEANDSTARTTASK.

This method is not supported in archive mode.

Parameters:
taskModel - The model that describes the task instance to be created at Runtime.
applicationName - The name of the enterprise application that contains the message or business calendar definitions used in the TaskModel. If the message definitions are simple types only or if you do not use a business calendar, null may be specified.
parentContext - The object ID (ACOID) or the name of the application component to be associated with the newly created task instance.
input - The input message. Note that the object wrapped by the ClientObjectWrapper must be serializable.
replyHandler - The reply handler to be used in order to send the result of execution automatically back to the caller. "null" must be specified if no reply handler is to be used.

Returns:
TKIID - The task instance ID of the task created and run.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when starting of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

createAndStartTaskAsSubTask

  1. TKIID createAndStartTaskAsSubTask( java.lang.String tktid,
  2. java.lang.String parentTaskID,
  3. ClientObjectWrapper input)
  4. throws AdministratorCannotBeResolvedException
  5. ApplicationVetoException
  6. ArchiveUnsupportedOperationException
  7. CannotCreateWorkItemException
  8. IdWrongFormatException
  9. IdWrongTypeException
  10. InvalidApplicationStateException
  11. InvalidLengthException
  12. NotAuthorizedException
  13. ObjectDoesNotExistException
  14. ParallelRoutingTaskException
  15. SCAServiceAccessFailureException
  16. SCAServiceResultErrorException
  17. SchedulingFailedException
  18. SubTasksNotSupportedException
  19. WrongKindException
  20. WrongMessageTypeException
  21. WrongStateException
  22. UnexpectedFailureException
  23. CommunicationException
Creates and starts a task instance as a subtask of the specified parent task instance using string representations of the task template and instance IDs. The parent task instance is then waiting for the completion of the subtask. It can only be completed when all subtasks came to an end.

The subtask created must be a collaboration or stand-alone invocation task. An invocation task must be derived from a task template that has not been created at Runtime. The parent task instance must be a collaboration or to-do task in the claimed state. It can be escalated or already waiting for a subtask. It can, however, not be suspended.

Note that collaboration, invocation, and to-do task instances are also known as human, originating, and participating task instances.

A subtask can only be created when the parent task supports subtask creation - refer to Task to view the task instance properties.

The caller must be a potential instance creator or an administrator of the subtask template and an owner or administrator of the parent task instance. The caller becomes the originator of the subtask. When the subtask is an invocation aka originating task, then the caller also becomes the starter of the task.

The action associated to this method is TaskTemplateActions.CREATEANDSTARTTASKASSUBTASK.

This method is not supported in archive mode.

Parameters:
tktid - The string representation of the task template ID from which the subtask is to be created and started. A WrongStateException is thrown when the specified task template is stopped.
parentTaskID - The string representation of the task instance ID that identifies the parent task instance.
input - The input message. Note that the object wrapped by the ClientObjectWrapper must be serializable.

Returns:
TKIID - The task instance ID of the subtask created.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.5

createAndStartTaskAsSubTask

  1. TKIID createAndStartTaskAsSubTask( TKTID tktid,
  2. TKIID parentTaskID,
  3. ClientObjectWrapper input)
  4. throws AdministratorCannotBeResolvedException
  5. ApplicationVetoException
  6. ArchiveUnsupportedOperationException
  7. CannotCreateWorkItemException
  8. IdWrongFormatException
  9. InvalidApplicationStateException
  10. InvalidLengthException
  11. NotAuthorizedException
  12. ObjectDoesNotExistException
  13. ParallelRoutingTaskException
  14. SCAServiceAccessFailureException
  15. SCAServiceResultErrorException
  16. SchedulingFailedException
  17. SubTasksNotSupportedException
  18. WrongKindException
  19. WrongMessageTypeException
  20. WrongStateException
  21. UnexpectedFailureException
  22. CommunicationException
Creates and starts a task instance as a subtask of the specified parent task instance using task template and parent task instance IDs. The parent task instance is then waiting for the completion of the subtask. It can only be completed when all subtasks came to an end.

The subtask created must be a collaboration or stand-alone invocation task. An invocation task must be derived from a task template that has not been created at Runtime. The parent task instance must be a collaboration or to-do task in the claimed state. It can be escalated or already waiting for a subtask. It can, however, not be suspended.

Note that collaboration, invocation, and to-do task instances are also known as human, originating, and participating task instances.

A subtask can only be created when the parent task supports subtask creation - refer to Task to view the task instance properties.

The caller must be a potential instance creator or an administrator of the subtask template and an owner or administrator of the parent task instance. The caller becomes the originator of the subtask. When the subtask is an invocation aka originating task, then the caller also becomes the starter of the task.

The action associated to this method is TaskTemplateActions.CREATEANDSTARTTASKASSUBTASK.

This method is not supported in archive mode.

Parameters:
tktid - The task template ID from which the subtask is to be created and started. A WrongStateException is thrown when the specified task template is stopped.
parentTaskID - The task instance ID that identifies the parent task instance.
input - The input message. Note that the object wrapped by the ClientObjectWrapper must be serializable.

Returns:
TKIID - The task instance ID of the subtask created.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.5

createAndStartTaskAsSubTask

  1. TKIID createAndStartTaskAsSubTask( java.lang.String name,
  2. java.lang.String namespace,
  3. java.lang.String parentTaskID,
  4. ClientObjectWrapper input)
  5. throws AdministratorCannotBeResolvedException
  6. ApplicationVetoException
  7. ArchiveUnsupportedOperationException
  8. CannotCreateWorkItemException
  9. IdWrongFormatException
  10. IdWrongTypeException
  11. InvalidApplicationStateException
  12. InvalidLengthException
  13. NotAuthorizedException
  14. UserDoesNotExistException
  15. ObjectDoesNotExistException
  16. ParallelRoutingTaskException
  17. ParameterNullException
  18. SCAServiceAccessFailureException
  19. SCAServiceResultErrorException
  20. SchedulingFailedException
  21. SubTasksNotSupportedException
  22. WrongKindException
  23. WrongMessageTypeException
  24. WrongStateException
  25. UnexpectedFailureException
  26. CommunicationException
Creates and starts a task instance as a subtask of the specified parent task instance using a string representation of the parent task instance ID. The parent task instance is then waiting for the completion of the subtask. It can only be completed when all subtasks came to an end.

The subtask created must be a collaboration or stand-alone invocation task. An invocation task must be derived from a task template that has not been created at Runtime. The parent task instance must be a collaboration or to-do task in the claimed state. It can be escalated or already waiting for a subtask. It can, however, not be suspended.

Note that collaboration, invocation, and to-do task instances are also known as human, originating, and participating task instances.

A subtask can only be created when the parent task supports subtask creation - refer to Task to view the task instance properties.

The caller must be a potential instance creator or an administrator of the subtask template and an owner or administrator of the parent task instance. The caller becomes the originator of the subtask. When the subtask is an invocation aka originating task, then the caller also becomes the starter of the task.

The action associated to this method is TaskTemplateActions.CREATEANDSTARTTASKASSUBTASK.

This method is not supported in archive mode.

Parameters:
name - The name of the task template from which the subtask is to be created and started. The currently valid template is then instantiated. A WrongStateException is thrown when the currently valid template is stopped.
namespace - The namespace of the task template.
parentTaskID - A string representation of the task instance ID that identifies the parent task instance.
input - The input message. Note that the object wrapped by the ClientObjectWrapper must be serializable.

Returns:
TKIID - The task instance ID of the subtask created.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when starting of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

createAndStartTaskAsSubTask

  1. TKIID createAndStartTaskAsSubTask( java.lang.String name,
  2. java.lang.String namespace,
  3. TKIID parentTaskID,
  4. ClientObjectWrapper input)
  5. throws AdministratorCannotBeResolvedException
  6. ApplicationVetoException
  7. ArchiveUnsupportedOperationException
  8. CannotCreateWorkItemException
  9. IdWrongFormatException
  10. InvalidApplicationStateException
  11. InvalidLengthException
  12. NotAuthorizedException
  13. UserDoesNotExistException
  14. ObjectDoesNotExistException
  15. ParallelRoutingTaskException
  16. ParameterNullException
  17. SCAServiceAccessFailureException
  18. SCAServiceResultErrorException
  19. SchedulingFailedException
  20. SubTasksNotSupportedException
  21. WrongKindException
  22. WrongMessageTypeException
  23. WrongStateException
  24. UnexpectedFailureException
  25. CommunicationException
Creates and starts a task instance as a subtask of the specified parent task instance using the parent task instance ID. The parent task instance is then waiting for the completion of the subtask. It can only be completed when all subtasks came to an end.

The subtask created must be a collaboration or stand-alone invocation task. An invocation task must be derived from a task template that has not been created at Runtime. The parent task instance must be a collaboration or to-do task in the claimed state. It can be escalated or already waiting for a subtask. It can, however, not be suspended.

Note that collaboration, invocation, and to-do task instances are also known as human, originating, and participating task instances.

A subtask can only be created when the parent task supports subtask creation - refer to Task to view the task instance properties.

The caller must be a potential instance creator or an administrator of the subtask template and an owner or administrator of the parent task instance. The caller becomes the originator of the subtask. When the subtask is an invocation aka originating task, then the caller also becomes the starter of the task.

The action associated to this method is TaskTemplateActions.CREATEANDSTARTTASKASSUBTASK.

This method is not supported in archive mode.

Parameters:
name - The name of the task template from which the subtask is to be created and started. The currently valid template is then instantiated. A WrongStateException is thrown when the currently valid template is stopped.
namespace - The namespace of the task template.
parentTaskID - The task instance ID that identifies the parent task instance.
input - The input message. Note that the object wrapped by the ClientObjectWrapper must be serializable.

Returns:
TKIID - The task instance ID of the subtask created.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when starting of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

createAndStartTaskAsSubTask

  1. TKIID createAndStartTaskAsSubTask( TaskModel taskModel,
  2. java.lang.String applicationName,
  3. java.lang.String parentTaskID,
  4. ClientObjectWrapper input)
  5. throws AdministratorCannotBeResolvedException
  6. ApplicationVetoException
  7. ArchiveUnsupportedOperationException
  8. CannotCreateWorkItemException
  9. IdWrongFormatException
  10. IdWrongTypeException
  11. InvalidLengthException
  12. NotAuthorizedException
  13. UserDoesNotExistException
  14. ObjectDoesNotExistException
  15. ParallelRoutingTaskException
  16. ParameterNullException
  17. SCAServiceAccessFailureException
  18. SCAServiceResultErrorException
  19. SchedulingFailedException
  20. SubTasksNotSupportedException
  21. TaskDeploymentException
  22. TELValidationException
  23. WrongMessageTypeException
  24. WrongKindException
  25. WrongStateException
  26. UnexpectedFailureException
  27. CommunicationException
Creates and starts a task from the specified task model as a subtask of the specified parent task instance using a string representation of the task instance ID. The parent task instance is then waiting for the completion of the subtask. It can only be completed when all subtasks came to an end.

The subtask created must be a collaboration or stand-alone invocation task. The parent task instance must be a collaboration or to-do task in the claimed state.

Collaboration, invocation, and to-do task instances are also known as human, originating, and participating task instances.

A subtask can only be created when the parent task supports subtask creation - refer to Task to view the task instance properties.

The caller must have potential-instance-creator rights on the associated application component and be an owner or administrator of the parent task instance. The caller becomes the originator of the subtask. When the subtask is an invocation aka originating task, then the caller also becomes the starter of the task. The subtask inherits the context of the parent.

The action associated to this method is TaskTemplateActions.CREATEANDSTARTTASKASSUBTASK.

This method is not supported in archive mode.

Parameters:
taskModel - The model that describes the subtask to be created at Runtime.
applicationName - The name of the enterprise application that contains the message or business calendar definitions used in the TaskModel. If the message definitions are simple types only or if you do not use a business calendar, null may be specified.
parentTaskID - Astring representation of the task instance ID that identifies the parent task instance.
input - The input message. Note that the object wrapped by the ClientObjectWrapper must be serializable.

Returns:
TKIID - The task instance ID of the subtask created and run.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when starting of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

createAndStartTaskAsSubTask

  1. TKIID createAndStartTaskAsSubTask( TaskModel taskModel,
  2. java.lang.String applicationName,
  3. TKIID parentTaskID,
  4. ClientObjectWrapper input)
  5. throws AdministratorCannotBeResolvedException
  6. ApplicationVetoException
  7. ArchiveUnsupportedOperationException
  8. CannotCreateWorkItemException
  9. IdWrongFormatException
  10. InvalidLengthException
  11. NotAuthorizedException
  12. UserDoesNotExistException
  13. ObjectDoesNotExistException
  14. ParallelRoutingTaskException
  15. ParameterNullException
  16. SCAServiceAccessFailureException
  17. SCAServiceResultErrorException
  18. SchedulingFailedException
  19. SubTasksNotSupportedException
  20. TaskDeploymentException
  21. TELValidationException
  22. WrongMessageTypeException
  23. WrongKindException
  24. WrongStateException
  25. UnexpectedFailureException
  26. CommunicationException
Creates and starts a task from the specified task model as a subtask of the specified parent task instance using the task instance ID. The parent task instance is then waiting for the completion of the subtask. It can only be completed when all subtasks came to an end.

The subtask created must be a collaboration or stand-alone invocation task. The parent task instance must be a collaboration or to-do task in the claimed state.

Collaboration, invocation, and to-do task instances are also known as human, originating, and participating task instances.

A subtask can only be created when the parent task supports subtask creation - refer to Task to view the task instance properties.

The caller must have potential-instance-creator rights on the associated application component and be an owner or administrator of the parent task instance. The caller becomes the originator of the subtask. When the subtask is an invocation aka originating task, then the caller also becomes the starter of the task. The subtask inherits the context of the parent.

The action associated to this method is TaskTemplateActions.CREATEANDSTARTTASKASSUBTASK.

This method is not supported in archive mode.

Parameters:
taskModel - The model that describes the subtask to be created at Runtime.
applicationName - The name of the enterprise application that contains the message or business calendar definitions used in the TaskModel. If the message definitions are simple types only or if you do not use a business calendar, null may be specified.
parentTaskID - The task instance ID that identifies the parent task instance.
input - The input message. Note that the object wrapped by the ClientObjectWrapper must be serializable.

Returns:
TKIID - The task instance ID of the subtask created and run.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when starting of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

createFaultMessage

  1. ClientObjectWrapper createFaultMessage( java.lang.String identifier,
  2. java.lang.String faultName)
  3. throws ArchiveUnsupportedOperationException
  4. IdWrongFormatException
  5. IdWrongTypeException
  6. InvalidQNameException
  7. NotAuthorizedException
  8. ObjectDoesNotExistException
  9. ParameterNullException
  10. WrongKindException
  11. WrongStateException
  12. UnexpectedFailureException
  13. CommunicationException
Creates a fault message for a fault that is defined by the specified task instance or template using a string representation of the task instance or template ID. This method creates a message that can be used when unsuccessfully completing a task instance - refer to complete.

The task instance or template must be a to-do, collaboration, or invocation task. Collaboration, to-do, and invocation tasks are also known as human, participating, and originating tasks.

The task instance can be in any state. The task template must be started.

The action associated to this method is TaskTemplateActions.CREATEFAULTMESSAGE or TaskActions.CREATEFAULTMESSAGE.

This method is not supported in archive mode.

Parameters:
identifier - A string representation of the task instance or template ID that is used to identify the task instance or template.
faultName - The name of the fault for which a message is to be created. The fault name must identify a fault that is defined for the task instance or template. Refer to getFaultNames(TKIID) or to getFaultNames(TKTID).

Returns:
ClientObjectWrapper - The message created. An empty client object wrapper is returned, when the specified fault cannot be found for the task instance.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Supports task templates.

createFaultMessage

  1. ClientObjectWrapper createFaultMessage( TKTID tktid,
  2. java.lang.String faultName)
  3. throws ArchiveUnsupportedOperationException
  4. IdWrongFormatException
  5. ObjectDoesNotExistException
  6. ParameterNullException
  7. WrongKindException
  8. WrongStateException
  9. UnexpectedFailureException
  10. CommunicationException
Creates a fault message for a fault that is defined by the specified task template using the task template ID. This method creates a message that can be used when unsuccessfully completing a task instance derived from the specified template - refer to complete.

The task template must be a to-do, collaboration, or invocation task. Collaboration, to-do, and invocation tasks are also known as human, participating, and originating tasks.

The task template must be started.

The action associated to this method is TaskTemplateActions.CREATEFAULTMESSAGE.

This method is not supported in archive mode.

Parameters:
tktid - The task template ID that is used to identify the task template.
faultName - The name of the fault for which a message is to be created. The fault name must identify a fault that is defined for the task template. Refer to getFaultNames.

Returns:
ClientObjectWrapper - The message created. An empty client object wrapper is returned, when the specified fault cannot be found for the task instance.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

Change History

Release Modification
7.0.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

createFaultMessage

  1. ClientObjectWrapper createFaultMessage( TKIID tkiid,
  2. java.lang.String faultName)
  3. throws ArchiveUnsupportedOperationException
  4. IdWrongFormatException
  5. InvalidQNameException
  6. NotAuthorizedException
  7. ObjectDoesNotExistException
  8. ParameterNullException
  9. WrongKindException
  10. WrongStateException
  11. UnexpectedFailureException
  12. CommunicationException
Creates a fault message for a fault that is defined by the specified task instance using the task instance ID. This method creates a message that can be used when unsuccessfully completing a task - refer to complete.

The task instance must be a to-do, collaboration, or invocation task. Collaboration, to-do, and invocation task instances are also known as human, participating, and originating task instances.

The task instance can be in any state.

The action associated to this method is TaskActions.CREATEFAULTMESSAGE.

This method is not supported in archive mode.

Parameters:
tkiid - The task instance ID that is used to identify the task instance.
faultName - The name of the fault for which a message is to be created. The fault name must identify a fault that is defined for the task instance. Refer to getFaultNames.

Returns:
ClientObjectWrapper - The message created. An empty client object wrapper is returned, when the specified fault cannot be found for the task instance.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 The task instance can be in any state.

createInputMessage

  1. ClientObjectWrapper createInputMessage( java.lang.String identifier)
  2. throws ArchiveUnsupportedOperationException
  3. IdWrongFormatException
  4. IdWrongTypeException
  5. NotAuthorizedException
  6. ObjectDoesNotExistException
  7. WrongKindException
  8. WrongStateException
  9. UnexpectedFailureException
  10. CommunicationException
Creates an input message for the specified task instance or template using a string representation of the task instance or template ID. For example, create a message that can be used when starting a task.

The task template must be started.

The action associated to this method is TaskTemplateActions.CREATEINPUTMESSAGE or TaskActions.CREATEINPUTMESSAGE.

This method is not supported in archive mode.

Parameters:
identifier - A string representation of the task instance or template ID that is used to identify the task instance or template.

Returns:
ClientObjectWrapper - The message created. An empty client object wrapper is returned, when the task does not expect an input message.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 The task template must be started. The task instance can be in any state.

createInputMessage

  1. ClientObjectWrapper createInputMessage( TKIID tkiid)
  2. throws ArchiveUnsupportedOperationException
  3. IdWrongFormatException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. WrongKindException
  7. WrongStateException
  8. UnexpectedFailureException
  9. CommunicationException
Creates an input message for the specified task instance using the task instance ID. For example, create a message that can be used when starting a task.

The action associated to this method is TaskActions.CREATEINPUTMESSAGE.

This method is not supported in archive mode.

Parameters:
tkiid - The task instance ID that is used to identify the task instance.

Returns:
ClientObjectWrapper - The message created. An empty client object wrapper is returned, when the task does not expect an input message.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 The task instance can be in any state.

createInputMessage

  1. ClientObjectWrapper createInputMessage( TKTID tktid)
  2. throws ArchiveUnsupportedOperationException
  3. IdWrongFormatException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. WrongKindException
  7. WrongStateException
  8. UnexpectedFailureException
  9. CommunicationException
Creates an input message for the specified task template using the task template ID. For example, create a message that can be used when starting a task.

The task template must be started.

The action associated to this method is TaskTemplateActions.CREATEINPUTMESSAGE.

This method is not supported in archive mode.

Parameters:
tktid - The task template ID that is used to identify the task template.

Returns:
ClientObjectWrapper - The message created. An empty client object wrapper is returned, when an input message is not expected.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 The task template must be started.

createMessage

  1. ClientObjectWrapper createMessage( java.lang.String tkiid,
  2. java.lang.String messageTypeName)
  3. throws ArchiveUnsupportedOperationException
  4. IdWrongFormatException
  5. IdWrongTypeException
  6. NotAuthorizedException
  7. ObjectDoesNotExistException
  8. ParameterNullException
  9. UnexpectedFailureException
  10. CommunicationException
Deprecated. As of version 6.0, replaced by createInputMessage, createOutputMessage, and createFaultMessage.
Creates a message defined by the specified task instance using a string representation of the task instance ID. For example, create a message that can be used when completing a task.

The caller must have at least reader authority for the task instance.

This method is not supported in archive mode.

Parameters:
tkiid - A String representation of the task instance ID that is used to identify the task instance for which a message is to be created.
messageTypeName - The name of the message type for which a message is to be created.

Returns:
ClientObjectWrapper - The message created. An empty client object wrapper is returned, when the specified message type cannot be found.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

createMessage

  1. ClientObjectWrapper createMessage( TKIID tkiid,
  2. java.lang.String messageTypeName)
  3. throws ArchiveUnsupportedOperationException
  4. IdWrongFormatException
  5. NotAuthorizedException
  6. ObjectDoesNotExistException
  7. ParameterNullException
  8. UnexpectedFailureException
  9. CommunicationException
Deprecated. As of version 6.0, replaced by createInputMessage, createOutputMessage, and createFaultMessage.
Creates a message defined by the specified task instance using the task instance ID. For example, create a message that can be used to complete a task instance.

The caller must have at least reader authority for the task instance.

This method is not supported in archive mode.

Parameters:
tkiid - The object ID of the task instance for which a message is to be created.
messageTypeName - The name of the message type for which a message is to be created.

Returns:
ClientObjectWrapper - The message created. An empty client object wrapper is returned, when the specified message type cannot be found.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

createOutputMessage

  1. ClientObjectWrapper createOutputMessage( java.lang.String identifier)
  2. throws ArchiveUnsupportedOperationException
  3. IdWrongFormatException
  4. IdWrongTypeException
  5. NotAuthorizedException
  6. ObjectDoesNotExistException
  7. WrongKindException
  8. WrongStateException
  9. UnexpectedFailureException
  10. CommunicationException
Creates an output message for the specified task instance or template using a string representation of the task instance or template ID. For example, creates a message that can be used when completing a task instance.

The task instance or template must be a to-do, collaboration, or invocation task. Collaboration, to-do, and invocation tasks are also known as human, participating, and originating tasks.

The task instance can be in any state. The task template must be started.

The action associated to this method is TaskTemplateActions.CREATEOUTPUTMESSAGE or TaskActions.CREATEOUTNPUTMESSAGE.

This method is not supported in archive mode.

Parameters:
identifier - A string representation of the task instance or template ID that is used to identify the task instance or template.

Returns:
ClientObjectWrapper - The message created. An empty client object wrapper is returned, when the task does not return an output message.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Supports task templates.

createOutputMessage

  1. ClientObjectWrapper createOutputMessage( TKTID tktid)
  2. throws ArchiveUnsupportedOperationException
  3. IdWrongFormatException
  4. ObjectDoesNotExistException
  5. WrongKindException
  6. WrongStateException
  7. UnexpectedFailureException
  8. CommunicationException
Creates an output message for the specified task template using the task template ID. For example, creates a message that can be used when completing a task derived from the task template.

The task template must be a to-do, collaboration, or invocation task. Collaboration, to-do, and invocation tasks are also known as human, participating, and originating tasks.

The task template must be started.

The action associated to this method is TaskTemplateActions.CREATEOUTPUTMESSAGE.

This method is not supported in archive mode.

Parameters:
tktid - The task template ID that is used to identify the task template.

Returns:
ClientObjectWrapper - The message created. An empty client object wrapper is returned, when the task does not return an output message.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

Change History

Release Modification
7.0.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

createOutputMessage

  1. ClientObjectWrapper createOutputMessage( TKIID tkiid)
  2. throws ArchiveUnsupportedOperationException
  3. IdWrongFormatException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. WrongKindException
  7. WrongStateException
  8. UnexpectedFailureException
  9. CommunicationException
Creates an output message for the specified task instance using the task instance ID. For example, creates a message that can be used when completing a task instance.

The task instance must be a to-do, collaboration, or invocation task. Collaboration, to-do, and invocation task instances are also known as human, participating, and originating task instances.

The task instance can be in any state.

The action associated to this method is TaskActions.CREATEOUTPUTMESSAGE.

This method is not supported in archive mode.

Parameters:
tkiid - The task instance ID that is used to identify the task instance.

Returns:
ClientObjectWrapper - The message created. An empty client object wrapper is returned, when the task does not return an output message.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 The task instance can be in any state.

createStoredQuery

  1. void createStoredQuery(java.lang.String storedQueryName,
  2. java.lang.String selectClause,
  3. java.lang.String whereClause,
  4. java.lang.String orderByClause,
  5. java.lang.Integer threshold,
  6. java.util.TimeZone timeZone)
  7. throws InvalidLengthException
  8. NotAuthorizedException
  9. ParameterNullException
  10. StoredQueryNameNotUniqueException
  11. UnexpectedFailureException
  12. CommunicationException
Creates a query definition and persistently stores it in the database. If this method is called by a task system administrator, then a stored query is created that is available for public usage. If this method is called by a regular user, then a stored query is created that is privately available for the logged-on user.

A stored query represents a set of selected object properties. The number of tuples in the set can be restricted by a filter or threshold. When executing the stored query, that set can additionally be restricted by specifying a starting tuple parameter.

To allow for the re-use of stored queries, parameters can be specified in the where-clause so that, for example, the owner of tasks can be specified when the stored query is executed.

Besides defining filtering criteria, sort criteria can be defined that are applied on the server. Sorting on the server means that the locale of the server is used.

Specify the parameters of the query definition, the select-, where-, and order-by-clause, using SQL based on the published views. Execution of the query can thus be shifted to SQL and becomes portable and optimizable.

Note, however, when you use a combination of the order-by-clause, threshold, or skipTuples parameters, the tuples returned depend on your database system. For example, some database systems order all records and then return the requested number of tuples. Other database systems first take the requested number of tuples and then apply the order criteria.

The domain of the query, that is, the SQL from-clause, is determined automatically. In principle, all properties of objects are selectable for which you own a work item or which can be transitively reached via your work item. As a rule of thumb, all objects except task templates can be reached via work items. This means that you cannot use task template properties only but that you must specify a non task template property in the select- or where-clause.

Note that a task system administrator has special rights and can retrieve information on objects associated to other users. When the stored query is executed by a task system administrator, the selected properties of all objects for which there are work items are returned, no matter whether there is a personally owned work item or another user's work item.

Although stored query definitions are stored persistently, object properties contained in the result set are assembled dynamically when they are queried. Refer to query for the execution of stored queries.

When a stored query definition needs to be updated, it must be deleted and recreated - refer to deleteStoredQuery for the deletion of stored queries.

Parameters:
storedQueryName - The name of the stored query to be created; must not be greater than 64 bytes in UTF-8 format. The name must be unique.
selectClause - Describes the query result that is returned when the stored query is executed. Its syntax is an SQL select-clause.

It either declares a list of names that identify the object properties (columns of the result) to be returned or it specifies the COUNT keyword. Aggregation functions like AVG, SUM, MIN, and MAX are not supported.

Each part of the select-clause separated by a comma must specify a property from the published views - see the InfoCenter for details.

To select properties of name-value pairs like custom properties, add a one-digit suffix (0-9) to the view name. For example, "TASK_CPROP1.STRING_VALUE, TASK_CPROP2.STRING_VALUE".

To count the number of potentially qualifying tuples, use the COUNT keyword. For example, to count the number of task instance IDs that satisfy the where-clause, specify a select-clause such as "COUNT(DISTINCT TASK.TKIID)". If you use the more generic "COUNT(*)", then you must specify a where-clause so that the tuples to be counted can be determined. For example, to count all tasks, specify a where-clause such as "TASK.TKIID=TASK.TKIID" that always evaluates to true.

A selectClause must not be greater than 512 bytes in UTF-8 format.

The QueryResultSet contains columns in the same order as specified in the selectClause. If tuples are to be counted, an int value is returned (row 1, column 1).

whereClause - Specifies the search condition that is applied when the stored query is executed. Its syntax is an SQL where-clause. The following rules apply:
  • Specify object ID constants as ID('string-rep-of-oid').
  • Specify timestamp constants as TS('yyyy-mm-ddThh:mm:ss') or as CURRENT_DATE for comparisons with the current date.
    The date and time parts of a TS definition are optional; either the date or the time must be specified. If no date part of a TS definition is specified, the current date is taken. Optional time values that are not specified are set to zero. The timestamp is 24 hours based. For example, TS('16:04') is the same as TS('2002-12-24T16:04:00') provided that the current date is December 24th, 2002.
    If a date part of a TS definition is specified, the year must consist of 4 letters; the month and day specifications are optional. Missing month and day specifications are set to 01. For example, specifying TS('2003') is the same as specifying TS('2003-01-01T00:00:00').
  • Specify binary constants as BIN('UTF-8 string').
  • Use constants instead of integer enumerations. For example, instead of specifying a task instance state expression "TASK.STATE=2" , specify "TASK.STATE=TASK.STATE.STATE_READY".
  • Duplicate apostrophes (') in comparising values. For example, "TASK_CPROP.STRING_VALUE='d''automatisation'".
  • To specify a where clause that refers to properties of name-value pairs, like custom properties, add a one-digit suffix (0-9) to the view name.
    For example, to have only tuples returned where a task custom property "prop1" has the value "v1" or where a task custom property "prop2" has the value v2", the where clause can look like "TASK_CPROP1.NAME='prop1' AND TASK_CPROP1.STRING_VALUE='v1' OR TASK_CPROP2.NAME='prop2' AND TASK_CPROP2.STRING_VALUE = 'v2'". For performance reasons, you should not use more than one "OR" construct; use "IN" instead.
    For example, to retrieve the values of custom properties "prop1" and "prop2" of all task instances, the select clause can look like "DISTINCT TASK.TKIID, TASK_CPROP1.STRING_VALUE, TASK_CPROP2.STRING_VALUE" and the where-clause "TASK_CPROP1.NAME = 'prop1' AND TASK_CPROP2.NAME = 'prop2'".
  • Specify parameters as @param followed by a number suffix. The number of the first parameter must be 1, of the second 2, and so on. For example, "TASK_CPROP.NAME = '@param1'".
    The same parameter can be used multiple times. Parameters are replaced by strings when the stored query is executed - see query.

If a filter is not to be applied, null must be specified.

A whereClause must not be greater than 2047 bytes in UTF-8 format.

orderByClause - Orders the result of the stored query execution by the values of the columns you identify. Its syntax is an SQL order-by-clause. Each part of the order-by-clause separated by a comma must specify a property from the published views.

If you identify more that one property, the stored query execution result is ordered by the values of the first property you identify, then by the values of the second property, and so on.

If sort criteria are not to be applied, null must be specified. An orderByClause must not be greater than 254 bytes in UTF-8 format.

Note that sort criteria are applied on the server, that is, the locale of the server is used for sorting.

threshold - The maximum number of stored query execution result tuples to be returned from the server to the client. If a threshold is not to be applied, null must be specified.
timeZone - Specifies the time zone of the timestamp constants in the whereClause respectively the time zone for the timestamp values returned. If a timezone is not specified, UTC is assumed.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.0.2 Can create a private stored query.

createStoredQuery

  1. void createStoredQuery(java.lang.String storedQueryName,
  2. java.lang.String selectClause,
  3. java.lang.String whereClause,
  4. java.lang.String orderByClause,
  5. java.lang.Integer threshold,
  6. java.util.TimeZone timeZone,
  7. java.util.List storedQueryProperties,
  8. java.lang.String clientType)
  9. throws InvalidLengthException
  10. InvalidParameterException
  11. ParameterNullException
  12. StoredQueryNameNotUniqueException
  13. UnexpectedFailureException
  14. CommunicationException
Creates a query definition and specifies properties to be stored together with the query. If this method is called by a task system administrator, then a stored query is created that is available for public usage. If this method is called by a regular user, then a stored query is created that is privately available for the calling logged-on user.

A stored query represents a set of selected object properties. The number of tuples in the set can be restricted by a filter or threshold. When executing the stored query, that set can additionally be restricted by specifying a starting tuple parameter.

To allow for the re-use of stored queries, parameters can be specified in the where-clause so that, for example, the owner of tasks can be specified when the stored query is executed.

Besides defining filtering criteria, sort criteria can be defined that are applied on the server. This means that the locale of the server is used for sorting.

Specify the parameters of the query definition, the select-, where-, and order-by-clause, using SQL based on the published views. Execution of the query can thus be shifted to SQL and becomes portable and optimizable.

Note, however, when you use a combination of the order-by-clause, threshold, or skipTuples parameters, the tuples returned depend on your database system. For example, some database systems order all records and then return the requested number of tuples. Other database systems first take the requested number of tuples and then apply the order criteria.

The domain of the query, that is, the SQL from-clause, is determined automatically. In principle, all properties of objects are selectable for which you own a work item or which can be transitively reached via your work item. As a rule of thumb, all objects except task templates can be reached via work items. This means that you cannot use task template properties only but that you must specify a non task template property in the select- or where-clause.

Note that a task system administrator has special rights and can retrieve information on objects associated to other users. When the stored query is executed by a task system administrator, the selected properties of all objects for which there are work items are returned, no matter whether there is a personally owned work item or another user's work item.

Although stored query definitions are stored persistently, object properties contained in the result set are assembled dynamically when they are queried. Refer to query for the execution of stored queries.

When a stored query definition needs to be updated, it must be deleted and recreated - refer to deleteStoredQuery for the deletion of stored queries.

Parameters:
storedQueryName - The name of the stored query to be created; must not be greater than 64 bytes in UTF-8 format. The name must be unique.
selectClause - Describes the query result that is returned when the stored query is executed. Its syntax is an SQL select-clause.

It either declares a list of names that identify the object properties (columns of the result) to be returned or it specifies the COUNT keyword. Aggregation functions like AVG, SUM, MIN, and MAX are not supported.

Each part of the select-clause separated by a comma must specify a property from the published views - see the InfoCenter for details.

To select properties of name-value pairs like custom properties, add a one-digit suffix (0-9) to the view name. For example, "TASK_CPROP1.STRING_VALUE, TASK_CPROP2.STRING_VALUE".

To count the number of potentially qualifying tuples, use the COUNT keyword. For example, to count the number of task instance IDs that satisfy the where-clause, specify a select-clause such as "COUNT(DISTINCT TASK.TKIID)". If you use the more generic "COUNT(*)", then you must specify a where-clause so that the tuples to be counted can be determined. For example, to count all tasks, specify a where-clause such as "TASK.TKIID=TASK.TKIID" that always evaluates to true.

A selectClause must not be greater than 512 bytes in UTF-8 format.

The QueryResultSet contains columns in the same order as specified in the selectClause. If tuples are to be counted, an int value is returned (row 1, column 1).

whereClause - Specifies the search condition that is applied when the stored query is executed. Its syntax is an SQL where-clause. The following rules apply:
  • Specify object ID constants as ID('string-rep-of-oid').
  • Specify timestamp constants as TS('yyyy-mm-ddThh:mm:ss') or as CURRENT_DATE for comparisons with the current date.
    The date and time parts of a TS definition are optional; either the date or the time must be specified. If no date part of a TS definition is specified, the current date is taken. Optional time values that are not specified are set to zero. The timestamp is 24 hours based. For example, TS('16:04') is the same as TS('2002-12-24T16:04:00') provided that the current date is December 24th, 2002.
    If a date part of a TS definition is specified, the year must consist of 4 letters; the month and day specifications are optional. Missing month and day specifications are set to 01. For example, specifying TS('2003') is the same as specifying TS('2003-01-01T00:00:00').
  • Specify binary constants as BIN('UTF-8 string').
  • Use constants instead of integer enumerations. For example, instead of specifying a task instance state expression "TASK.STATE=2" , specify "TASK.STATE=TASK.STATE.STATE_READY".
  • Duplicate apostrophes (') in comparising values. For example, "TASK_CPROP.STRING_VALUE='d''automatisation'".
  • To specify a where clause that refers to properties of name-value pairs, like custom properties, add a one-digit suffix (0-9) to the view name.
    For example, to have only tuples returned where a task custom property "prop1" has the value "v1" or where a task custom property "prop2" has the value v2", the where clause can look like "TASK_CPROP1.NAME='prop1' AND TASK_CPROP1.STRING_VALUE='v1' OR TASK_CPROP2.NAME='prop2' AND TASK_CPROP2.STRING_VALUE = 'v2'". For performance reasons, you should not use more than one "OR" construct; use "IN" instead.
    For example, to retrieve the values of custom properties "prop1" and "prop2" of all task instances, the select clause can look like "DISTINCT TASK.TKIID, TASK_CPROP1.STRING_VALUE, TASK_CPROP2.STRING_VALUE" and the where-clause "TASK_CPROP1.NAME = 'prop1' AND TASK_CPROP2.NAME = 'prop2'".
  • Specify parameters as @param followed by a number suffix. The number of the first parameter must be 1, of the second 2, and so on. For example, "TASK_CPROP.NAME = '@param1'".
    The same parameter can be used multiple times. Parameters are replaced by strings when the stored query is executed - see query.

If a filter is not to be applied, null must be specified.

A whereClause must not be greater than 2047 bytes in UTF-8 format.

orderByClause - Orders the result of the stored query execution by the values of the columns you identify. Its syntax is an SQL order-by-clause. Each part of the order-by-clause separated by a comma must specify a property from the published views.

If you identify more that one property, the stored query execution result is ordered by the values of the first property you identify, then by the values of the second property, and so on.

If sort criteria are not to be applied, null must be specified. An orderByClause must not be greater than 254 bytes in UTF-8 format.

Note that sort criteria are applied on the server, that is, the locale of the server is used for sorting.

threshold - The maximum number of stored query execution result tuples to be returned from the server to the client. If a threshold is not to be applied, null must be specified.
timeZone - Specifies the time zone of the timestamp constants in the whereClause respectively the time zone for the timestamp values returned. If a timezone is not specified, UTC is assumed.
storedQueryProperties - Specifies user-defined properties to be attached to the stored query. Must be a list of StoredQueryProperty objects - see StoredQueryProperty. If no properties are to be attached, null must be passed.
clientType - A user-defined client type to specify the creator of the stored query, for example, Web, Portal, or Custom. The client type must not be greater than 128 bytes in UTF-8 format.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

createStoredQuery

  1. void createStoredQuery(java.lang.String userID,
  2. java.lang.String storedQueryName,
  3. java.lang.String selectClause,
  4. java.lang.String whereClause,
  5. java.lang.String orderByClause,
  6. java.lang.Integer threshold,
  7. java.util.TimeZone timeZone,
  8. java.util.List storedQueryProperties,
  9. java.lang.String clientType)
  10. throws InvalidLengthException
  11. InvalidParameterException
  12. NotAuthorizedException
  13. ParameterNullException
  14. StoredQueryNameNotUniqueException
  15. UnexpectedFailureException
  16. CommunicationException
Creates a query definition for the specified user.

A regular user can only create stored queries that are available for his personal usage. A task system administrator can create stored queries that are available for public usage or for the usage of the specified person.

A stored query represents a set of selected object properties. The number of tuples in the set can be restricted by a filter or threshold. When executing the stored query, that set can additionally be restricted by specifying a starting tuple parameter.

To allow for the re-use of stored queries, parameters can be specified in the where-clause so that, for example, the owner of tasks can be specified when the stored query is executed.

Besides defining filtering criteria, sort criteria can be defined that are applied on the server. This means that the locale of the server is used for sorting.

Specify the parameters of the query definition, the select-, where-, and order-by-clause, using SQL based on the published views. Execution of the query can thus be shifted to SQL and becomes portable and optimizable.

Note, however, when you use a combination of the order-by-clause, threshold, or skipTuples parameters, the tuples returned depend on your database system. For example, some database systems order all records and then return the requested number of tuples. Other database systems first take the requested number of tuples and then apply the order criteria.

The domain of the query, that is, the SQL from-clause, is determined automatically. In principle, all properties of objects are selectable for which you own a work item, or which can be transitively reached via your work item. As a rule of thumb, all objects except task templates can be reached via work items. This means that you cannot use task template properties only but that you must specify a non task template property in the select- or where-clause.

Note that a task system administrator has special rights and can retrieve information on objects associated to other users. When the stored query is executed by a task system administrator, the selected properties of all objects for which there are work items are returned, no matter whether there is a personally owned work item or another user's work item.

Although stored query definitions are stored persistently, object properties contained in the result set are assembled dynamically when they are queried. Refer to query for the execution of stored queries.

When a stored query definition needs to be updated, it must be deleted and recreated - refer to deleteStoredQuery for the deletion of stored queries.

Parameters:
userID - The name of a user who is to become the owner of the stored query. Null means that a public stored query is created.
storedQueryName - The name of the stored query to be created; must not be greater than 64 bytes in UTF-8 format. The name must be unique.
selectClause - Describes the query result that is returned when the stored query is executed. Its syntax is an SQL select-clause.

It either declares a list of names that identify the object properties (columns of the result) to be returned or it specifies the COUNT keyword. Aggregation functions like AVG, SUM, MIN, and MAX are not supported.

Each part of the select-clause separated by a comma must specify a property from the published views - see the InfoCenter for details.

To select properties of name-value pairs like custom properties, add a one-digit suffix (0-9) to the view name. For example, "TASK_CPROP1.STRING_VALUE, TASK_CPROP2.STRING_VALUE".

To count the number of potentially qualifying tuples, use the COUNT keyword. For example, to count the number of task instance IDs that satisfy the where-clause, specify a select-clause such as "COUNT(DISTINCT TASK.TKIID)". If you use the more generic "COUNT(*)", then you must specify a where-clause so that the tuples to be counted can be determined. For example, to count all tasks, specify a where-clause such as "TASK.TKIID=TASK.TKIID" that always evaluates to true.

A selectClause must not be greater than 512 bytes in UTF-8 format.

The QueryResultSet contains columns in the same order as specified in the selectClause. If tuples are to be counted, an int value is returned (row 1, column 1).

whereClause - Specifies the search condition that is applied when the stored query is executed. Its syntax is an SQL where-clause. The following rules apply:
  • Specify object ID constants as ID('string-rep-of-oid').
  • Specify timestamp constants as TS('yyyy-mm-ddThh:mm:ss') or as CURRENT_DATE for comparisons with the current date.
    The date and time parts of a TS definition are optional; either the date or the time must be specified. If no date part of a TS definition is specified, the current date is taken. Optional time values that are not specified are set to zero. The timestamp is 24 hours based. For example, TS('16:04') is the same as TS('2002-12-24T16:04:00') provided that the current date is December 24th, 2002.
    If a date part of a TS definition is specified, the year must consist of 4 letters; the month and day specifications are optional. Missing month and day specifications are set to 01. For example, specifying TS('2003') is the same as specifying TS('2003-01-01T00:00:00').
  • Specify binary constants as BIN('UTF-8 string').
  • Use constants instead of integer enumerations. For example, instead of specifying a task instance state expression "TASK.STATE=2" , specify "TASK.STATE=TASK.STATE.STATE_READY".
  • Duplicate apostrophes (') in comparising values. For example, "TASK_CPROP.STRING_VALUE='d''automatisation'".
  • To specify a where clause that refers to properties of name-value pairs, like custom properties, add a one-digit suffix (0-9) to the view name.
    For example, to have only tuples returned where a task custom property "prop1" has the value "v1" or where a task custom property "prop2" has the value v2", the where clause can look like "TASK_CPROP1.NAME='prop1' AND TASK_CPROP1.STRING_VALUE='v1' OR TASK_CPROP2.NAME='prop2' AND TASK_CPROP2.STRING_VALUE = 'v2'". For performance reasons, you should not use more than one "OR" construct; use "IN" instead.
    For example, to retrieve the values of custom properties "prop1" and "prop2" of all task instances, the select clause can look like "DISTINCT TASK.TKIID, TASK_CPROP1.STRING_VALUE, TASK_CPROP2.STRING_VALUE" and the where-clause "TASK_CPROP1.NAME = 'prop1' AND TASK_CPROP2.NAME = 'prop2'".
  • Specify parameters as @param followed by a number suffix. The number of the first parameter must be 1, of the second 2, and so on. For example, "TASK_CPROP.NAME = '@param1'".
    The same parameter can be used multiple times. Parameters are replaced by strings when the stored query is executed - see query.

If a filter is not to be applied, null must be specified.

A whereClause must not be greater than 2047 bytes in UTF-8 format.

orderByClause - Orders the result of the stored query execution by the values of the columns you identify. Its syntax is an SQL order-by-clause. Each part of the order-by-clause separated by a comma must specify a property from the published views.

If you identify more that one property, the stored query execution result is ordered by the values of the first property you identify, then by the values of the second property, and so on.

If sort criteria are not to be applied, null must be specified. An orderByClause must not be greater than 254 bytes in UTF-8 format.

Note that sort criteria are applied on the server, that is, the locale of the server is used for sorting.

threshold - The maximum number of stored query execution result tuples to be returned from the server to the client. If a threshold is not to be applied, null must be specified.
timeZone - Specifies the time zone of the timestamp constants in the whereClause respectively the time zone for the timestamp values returned. If a timezone is not specified, UTC is assumed.
storedQueryProperties - Specifies user-defined properties to be attached to the stored query. Must be a list of StoredQueryProperty objects - see StoredQueryProperty. If no properties are to be attached, null must be passed.
clientType - A user-defined client type to specify the creator of the stored query, for example, Web, Portal, or Custom. The client type must not be greater than 128 bytes in UTF-8 format.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

createTask

  1. TKIID createTask(java.lang.String tktid,
  2. ClientObjectWrapper input)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. CannotCreateWorkItemException
  6. IdWrongFormatException
  7. IdWrongTypeException
  8. InvalidApplicationStateException
  9. InvalidLengthException
  10. NotAuthorizedException
  11. ObjectDoesNotExistException
  12. WrongKindException
  13. WrongMessageTypeException
  14. WrongStateException
  15. UnexpectedFailureException
  16. CommunicationException
Creates a task instance using a string representation of the task template ID and optionally passes an input message.

The caller must be a potential instance creator or an administrator of the task template. The task must not be inline.

The action associated to this method is TaskTemplateActions.CREATETASK.

This method is not supported in archive mode.

Parameters:
tktid - The string representation of the task template ID from which an instance is to be created.
input - The input message to be used when the task is run. The object wrapped by the ClientObjectWrapper must be serializable.

Returns:
TKIID - The object ID of the task instance created.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.5

createTask

  1. TKIID createTask(TKTID tktid,
  2. ClientObjectWrapper input)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. CannotCreateWorkItemException
  6. IdWrongFormatException
  7. InvalidApplicationStateException
  8. InvalidLengthException
  9. NotAuthorizedException
  10. ObjectDoesNotExistException
  11. WrongKindException
  12. WrongMessageTypeException
  13. WrongStateException
  14. UnexpectedFailureException
  15. CommunicationException
Creates a task instance using the task template ID and optionally passes an input message.

The caller must be a potential instance creator or an administrator of the task template. The task must not be inline.

The action associated to this method is TaskTemplateActions.CREATETASK.

This method is not supported in archive mode.

Parameters:
tktid - The task template ID from which an instance is to be created.
input - The input message to be used when the task is run. The object wrapped by the ClientObjectWrapper must be serializable.

Returns:
TKIID - The object ID of the task instance created.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.5

createTask

  1. TKIID createTask(java.lang.String name,
  2. java.lang.String namespace)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. CannotCreateWorkItemException
  6. InvalidApplicationStateException
  7. InvalidLengthException
  8. NotAuthorizedException
  9. ObjectDoesNotExistException
  10. ParameterNullException
  11. WrongKindException
  12. WrongStateException
  13. UnexpectedFailureException
  14. CommunicationException
Creates a task instance from the currently valid task template.

The caller must be a potential instance creator or an administrator of the task template. The task must not be inline.

The action associated to this method is TaskTemplateActions.CREATETASK.

This method is not supported in archive mode.

Parameters:
name - The name of the task template from which an instance is to be created.
namespace - The namespace of the task template.

Returns:
TKIID - The object ID of the task instance created.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

createTask

  1. TKIID createTask(java.lang.String name,
  2. java.lang.String namespace,
  3. ClientObjectWrapper input)
  4. throws ApplicationVetoException
  5. ArchiveUnsupportedOperationException
  6. CannotCreateWorkItemException
  7. InvalidApplicationStateException
  8. InvalidLengthException
  9. NotAuthorizedException
  10. ObjectDoesNotExistException
  11. ParameterNullException
  12. WrongKindException
  13. WrongStateException
  14. UnexpectedFailureException
  15. CommunicationException
Creates a task instance from the currently valid task template and specifies an input message.

The caller must be a potential instance creator or an administrator of the task template. The task must not be inline.

The action associated to this method is TaskTemplateActions.CREATETASK.

This method is not supported in archive mode.

Parameters:
name - The name of the task template from which an instance is to be created.
namespace - The namespace of the task template.
input - The input message to be used when the task is run. The object wrapped by the ClientObjectWrapper must be serializable.

Returns:
TKIID - The object ID of the task instance created.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

createTask

  1. TKIID createTask(TaskModel taskModel,
  2. java.lang.String applicationName,
  3. java.lang.String parentContext)
  4. throws ApplicationVetoException
  5. ArchiveUnsupportedOperationException
  6. CannotCreateWorkItemException
  7. IdWrongTypeException
  8. InvalidLengthException
  9. NotAuthorizedException
  10. ObjectDoesNotExistException
  11. ParameterNullException
  12. UnexpectedFailureException
  13. TaskDeploymentException
  14. TELValidationException
  15. CommunicationException
Creates a task instance from the specified task model.

The caller must have potential-instance-creator rights on the associated application component.

The action associated to this method is TaskTemplateActions.CREATETASK.

This method is not supported in archive mode.

Parameters:
taskModel - The model that describes the task instance to be created at Runtime.
applicationName - The name of the enterprise application that contains the message or business calendar definitions used in the TaskModel. If the message definitions are simple types only or if you do not use a business calendar, null may be specified.
parentContext - The object ID (ACOID) or the name of the application component to be associated with the task instance.

Returns:
TKIID - The object ID of the task instance created.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

createTask

  1. TKIID createTask(TaskModel taskModel,
  2. java.lang.String applicationName,
  3. java.lang.String parentContext,
  4. ClientObjectWrapper input)
  5. throws ApplicationVetoException
  6. ArchiveUnsupportedOperationException
  7. CannotCreateWorkItemException
  8. IdWrongTypeException
  9. InvalidLengthException
  10. NotAuthorizedException
  11. ObjectDoesNotExistException
  12. ParameterNullException
  13. WrongMessageTypeException
  14. UnexpectedFailureException
  15. TaskDeploymentException
  16. TELValidationException
  17. CommunicationException
Creates a task instance from the specified task model and specifies an input message.

The caller must have potential-instance-creator rights on the associated application component.

The action associated to this method is TaskTemplateActions.CREATETASK.

This method is not supported in archive mode.

Parameters:
taskModel - The model that describes the task instance to be created Runtime.
applicationName - The name of the enterprise application that contains the message or business calendar definitions used in the TaskModel. If the message definitions are simple types only or if you do not use a business calendar, null may be specified.
parentContext - The object ID (ACOID) or the name of the application component to be associated with the task instance.
input - The input message to be used when the task is run. The object wrapped by the ClientObjectWrapper must be serializable.

Returns:
TKIID - The object ID of the task instance created.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

createTaskTemplate

  1. TKTID createTaskTemplate(TaskModel taskModel,
  2. java.lang.String applicationName)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. InvalidLengthException
  6. NotAuthorizedException
  7. ObjectDoesNotExistException
  8. ParameterNullException
  9. UnexpectedFailureException
  10. TaskDeploymentException
  11. TELValidationException
  12. CommunicationException
Creates a task template from the specified task model.

The caller must have potential-instance-creator rights on the associated application component.

This method is not supported in archive mode.

Parameters:
taskModel - The model that describes the task template to be created Runtime.
applicationName - The name of the enterprise application that contains the message or business calendar definitions used in the TaskModel. If the message definitions are simple types only or if you do not use a business calendar, null may be specified.

Returns:
TKTID - The task template ID of the task template created.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

createWorkItem

  1. void createWorkItem(java.lang.String identifier,
  2. int assignmentReason,
  3. java.lang.String userID)
  4. throws ApplicationVetoException
  5. ArchiveUnsupportedOperationException
  6. EverybodyWorkItemException
  7. GroupWorkItemException
  8. IdWrongFormatException
  9. IdWrongTypeException
  10. InvalidAssignmentReasonException
  11. InvalidLengthException
  12. NotAuthorizedException
  13. UserDoesNotExistException
  14. ObjectDoesNotExistException
  15. ParameterNullException
  16. TaskDelegationNotSupportedException
  17. WorkItemManagerException
  18. WrongKindException
  19. WrongStateException
  20. UnexpectedFailureException
  21. CommunicationException
Creates a user work item for the specified task or escalation instance using a string representation of the task or escalation instance ID. The work item is created with the specified assignment reason for the specified user.

The caller must be an administrator. As long as the task is inactive, the originator of the task can also create new work items.

The following rules apply for the creation work items:

  • Work items assigned to "everybody" cannot be created.
  • Work items with assignment reasons "owner", "starter", and "originator" cannot be created.
  • "potential starter" work items can be created as long as the task is inactive. The task must be a stand-alone, non-inline task.
  • "potential owner" or "editor" work items can be created when the task is ready or claimed.
  • "escalation receiver" work items can be created when the task is escalated.
  • "administrator" or "reader" work items can be created in any task state but inactive. When the task is in the terminated or expired state, the task must be a stand-alone, non-inline task.

The action associated to this method is TaskActions.CREATEWORKITEM or EscalationActions.CREATEWORKITEM.

This method is not supported in archive mode.

Parameters:
identifier - A string representation of the task or escalation instance ID that is used to identify the object for which a new work item is to be created.
assignmentReason - The reason why the work item is assigned - refer to the work item assignment reasons.
userID - The user for which a work item is to be created. It is checked whether the user exists but the check may be executed case insensitively. The check can be suppressed by setting the 'SupportVirtualUserIdsForPeopleAssignments' custom property of the Human Task Manager configuration to 'true'.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.1 Throws a TaskDelegationNotSupportedException when the task cannot be delegated to the specified user.
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

createWorkItem

  1. void createWorkItem(TKIID tkiid,
  2. int assignmentReason,
  3. java.lang.String userID)
  4. throws ApplicationVetoException
  5. ArchiveUnsupportedOperationException
  6. EverybodyWorkItemException
  7. GroupWorkItemException
  8. IdWrongFormatException
  9. InvalidAssignmentReasonException
  10. InvalidLengthException
  11. NotAuthorizedException
  12. UserDoesNotExistException
  13. ObjectDoesNotExistException
  14. ParameterNullException
  15. TaskDelegationNotSupportedException
  16. WorkItemManagerException
  17. WrongKindException
  18. WrongStateException
  19. UnexpectedFailureException
  20. CommunicationException
Creates a user work item for the specified task instance using the task instance ID. The work item is created with the specified assignment reason for the specified user.

The caller must be an administrator when the task is active. As long as the task is inactive, the originator of the task can also create new work items.

The following rules apply for the creation of additional work items:

  • Work items assigned to "everybody" cannot be created.
  • Work items with assignment reasons "owner", "starter", and "originator" cannot be created.
  • "potential starter" work items can be created as long as the task is inactive. The task must be a stand-alone, non-inline task.
  • "potential owner" or "editor" work items can be created when the task is ready or claimed.
  • "administrator" or "reader" work items can be created in any task state but inactive. When the task is in the terminated or expired state, the task must be a stand-alone, non-inline task.

The action associated to this method is TaskActions.CREATEWORKITEM.

This method is not supported in archive mode.

Parameters:
tkiid - The object ID of the task instance the new work item should belong to.
assignmentReason - The reason why the work item is assigned - refer to the work item assignment reasons.
userID - The user the work item should belong to. It is checked whether the user exists but the check may be executed case insensitively. The check can be suppressed by setting the 'SupportVirtualUserIdsForPeopleAssignments' custom property of the Human Task Manager configuration to 'true'.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.1 Throws a TaskDelegationNotSupportedException when the task cannot be delegated to the specified user.
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

createWorkItem

  1. void createWorkItem(ESIID esiid,
  2. int assignmentReason,
  3. java.lang.String userID)
  4. throws ApplicationVetoException
  5. ArchiveUnsupportedOperationException
  6. EverybodyWorkItemException
  7. GroupWorkItemException
  8. IdWrongFormatException
  9. InvalidAssignmentReasonException
  10. InvalidLengthException
  11. NotAuthorizedException
  12. UserDoesNotExistException
  13. ObjectDoesNotExistException
  14. ParameterNullException
  15. TaskDelegationNotSupportedException
  16. WorkItemManagerException
  17. WrongKindException
  18. WrongStateException
  19. UnexpectedFailureException
  20. CommunicationException
Creates a user work item for the specified escalation instance using the escalation instance ID. The work item is created with the specified assignment reason for the specified user.

The caller must be an administrator. Additional "escalation receiver" work items can only be created when the task is escalated.

The action associated to this method is EscalationActions.CREATEWORKITEM.

This method is not supported in archive mode.

Parameters:
esiid - The object ID of the escalation instance for which a new work item is to be created.
assignmentReason - The reason why the work item is assigned - refer to the work item assignment reasons. Valid values are WorkItem.REASON_ESCALATION_RECEIVER, WorkItem.REASON_READER, and WorkItem.REASON_ADMINISTRATOR.
userID - The user for which a new work item is to be created. It is checked whether the user exists but the check may be executed case insensitively. The check can be suppressed by setting the 'SupportVirtualUserIdsForPeopleAssignments' custom property of the Human Task Manager configuration to 'true'.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.1 Throws a GroupWorkItemException when a group is specified as user ID.
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

delete

  1. void delete(java.lang.String tkiid)
  2. throws ApplicationVetoException
  3. ChildTaskInstanceActiveException
  4. IdWrongFormatException
  5. IdWrongTypeException
  6. IsNotTopLevelTaskException
  7. NotAuthorizedException
  8. WrongKindException
  9. WrongStateException
  10. UnexpectedFailureException
  11. CommunicationException
Deletes the specified task instance using a string representation of the task instance ID. A to-do, collaboration, or administration task must not be inline or stand-alone with "child" autonomy. The task cannot be a subtask or follow-on task. Note that collaboration and to-do task instances are also known as human and participating task instances.

The task must be in the inactive, terminated, expired, finished, or failed state. It can be escalated or suspended.

The caller must have administrative rights or be the originator of the task. An originator can only delete an inactive task.

The action associated to this method is TaskActions.DELETE.

Parameters:
tkiid - A string representation of the task instance ID that is used to identify the task instance.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

delete

  1. void delete(TKIID tkiid)
  2. throws ApplicationVetoException
  3. IdWrongFormatException
  4. IsNotTopLevelTaskException
  5. NotAuthorizedException
  6. WrongKindException
  7. WrongStateException
  8. UnexpectedFailureException
  9. CommunicationException
Deletes the specified task instance using the task instance ID. A to-do, collaboration, or administration task must not be inline or stand-alone with "child" autonomy. The task cannot be a subtask or follow-on task. Note that collaboration and to-do task instances are also known as human and participating task instances.

The task must be in the inactive, terminated, expired, finished, or failed state. It can be escalated or suspended.

The caller must have administrative rights or be the originator of the task. An originator can only delete an inactive task.

The action associated to this method is TaskActions.DELETE.

Parameters:
tkiid - The task instance ID that is used to identify the task instance.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

delete

  1. void delete(java.lang.String identifier,
  2. boolean deleteInstances)
  3. throws ApplicationVetoException
  4. ChildTaskInstanceActiveException
  5. IdWrongFormatException
  6. IdWrongTypeException
  7. IsNotAdHocException
  8. NotAuthorizedException
  9. ObjectDoesNotExistException
  10. RunningInstancesException
  11. WrongKindException
  12. WrongStateException
  13. UnexpectedFailureException
  14. CommunicationException
Deletes the specified task template using a string representation of the task template ID. The task template must have been created at Runtime. Templates that have been installed as part of an enterprise application are deleted (uninstalled) together with the enterprise application.

The task template must be in the stopped state to prevent new instances from being created. No task instances may exist that are derived from this template unless deletion of the instances is requested.

The caller must have administrative rights.

The action associated to this method is TaskTemplateActions.DELETETEMPLATE.

Parameters:
identifier - A string representation of the task template ID that is used to identify the task template to be deleted.
deleteInstances - Specifies whether all instances that are derived from this template are to be deleted together with the template. True states that all derived instances are to be deleted. False states that derived instances are not to be deleted; if instances exist, a RunningInstancesException is thrown.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.1

delete

  1. void delete(TKTID tktid,
  2. boolean deleteInstances)
  3. throws ApplicationVetoException
  4. ChildTaskInstanceActiveException
  5. IdWrongFormatException
  6. IsNotAdHocException
  7. NotAuthorizedException
  8. ObjectDoesNotExistException
  9. RunningInstancesException
  10. WrongKindException
  11. WrongStateException
  12. UnexpectedFailureException
  13. CommunicationException
Deletes the specified task template using the task template ID. The task template must have been created Runtime. Templates that have been installed as part of an enterprise application are deleted (uninstalled) together with the enterprise application.

The task template must be in the stopped state to prevent new instances from being created. No task instances may exist that are derived from this template unless deletion of the instances is requested.

The caller must have administrative rights.

The action associated to this method is TaskTemplateActions.DELETETEMPLATE.

Parameters:
tktid - The task template ID that is used to identify the task template to be deleted.
deleteInstances - Specifies whether all instances that are derived from this template are to be deleted together with the template. True states that all derived instances are to be deleted. False states that derived instances are not to be deleted; if instances exist, a RunningInstancesException is thrown.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.1

deleteStoredQuery

  1. void deleteStoredQuery(java.lang.String storedQueryName)
  2. throws NotAuthorizedException
  3. ParameterNullException
  4. UnexpectedFailureException
  5. CommunicationException
Deletes the specified stored query. If this method is called by a task system administrator, then a stored query is deleted that is available for public usage. If this method is called by a regular user, then a stored query is deleted that is privately available for the calling logged-on user.

No error is signalled when the specified stored query does no longer exist.

Refer to createStoredQuery for the creation of stored queries.

Parameters:
storedQueryName - The name of the stored query to be deleted - refer to getStoredQueryNames for the retrieval of existing stored query names.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.0.2 Can delete a private stored query.

deleteStoredQuery

  1. void deleteStoredQuery(java.lang.String userID,
  2. java.lang.String storedQueryName)
  3. throws NotAuthorizedException
  4. ParameterNullException
  5. UnexpectedFailureException
  6. CommunicationException
Deletes the specified stored query for the specified user.

A regular user can only delete stored queries that are available for his personal usage. A task system administrator can also delete stored queries that are available for the usage of the specified person.

No error is signalled when the specified stored query does no longer exist.

Refer to createStoredQuery for the creation of stored queries.

Parameters:
userID - The name of the user who is the owner of the stored query.
storedQueryName - The name of the stored query to be deleted - refer to getStoredQueryNames for the retrieval of existing stored query names.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

deleteWorkItem

  1. void deleteWorkItem(java.lang.String identifier,
  2. int assignmentReason,
  3. java.lang.String userID)
  4. throws ApplicationVetoException
  5. ArchiveUnsupportedOperationException
  6. EverybodyWorkItemException
  7. GroupWorkItemException
  8. IdWrongFormatException
  9. IdWrongTypeException
  10. InvalidAssignmentReasonException
  11. InvalidLengthException
  12. LastAdminWorkItemException
  13. NotAuthorizedException
  14. WorkItemDoesNotExistException
  15. ObjectDoesNotExistException
  16. ParameterNullException
  17. TaskDelegationNotSupportedException
  18. WorkItemManagerException
  19. WrongKindException
  20. WrongStateException
  21. UnexpectedFailureException
  22. CommunicationException
Deletes the specified user work item using a string representation of the task or escalation instance ID.

The caller must be an administrator for the deletion of work items for escalation instances or when the task is active. As long as the task is inactive, the originator of the task can also delete a work item.

The following rules apply for the deletion of work items:

  • Work items assigned to "everybody" cannot be deleted.
  • Work items with assignment reasons "owner", "starter", and "originator" cannot be deleted.
  • The last "administrator" work item cannot be deleted.
  • "potential starter" work items can only be deleted as long as the task is inactive. The task must be a stand-alone, non-inline task.
  • "potential owner" or "editor" work items can only be deleted when the task is ready or claimed.
  • "escalation receiver" work items can only be deleted when the task is escalated.
  • "administrator" or "reader" work items can be deleted in any task state but inactive. When the task is in the terminated or expired state, the task must be a stand-alone, non-inline task.

The action associated to this method is TaskActions.DELETEWORKITEM or EscalationActions.DELETEWORKITEM.

This method is not supported in archive mode.

Parameters:
identifier - A string representation of the task or escalation instance ID that is used to identify the work item to be deleted.
assignmentReason - The reason why the work item is assigned - refer to the work item assignment reasons.
userID - The user the work item belongs to.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.1 Throws a GroupWorkItemException when a group work item is asked to be deleted.
6.1 Throws a TaskDelegationNotSupportedException when the last work item is deleted and the task cannot be delegated to the fallback user.
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

deleteWorkItem

  1. void deleteWorkItem(TKIID tkiid,
  2. int assignmentReason,
  3. java.lang.String userID)
  4. throws ApplicationVetoException
  5. ArchiveUnsupportedOperationException
  6. EverybodyWorkItemException
  7. GroupWorkItemException
  8. IdWrongFormatException
  9. InvalidAssignmentReasonException
  10. InvalidLengthException
  11. LastAdminWorkItemException
  12. NotAuthorizedException
  13. WorkItemDoesNotExistException
  14. ObjectDoesNotExistException
  15. ParameterNullException
  16. TaskDelegationNotSupportedException
  17. WorkItemManagerException
  18. WrongKindException
  19. WrongStateException
  20. UnexpectedFailureException
  21. CommunicationException
Deletes the specified user work item using the task instance ID.

The caller must be an administrator when the task is active. As long as the task is inactive, the originator of the task can also delete a work item.

The following rules apply for the deletion of work items:

  • Work items assigned to "everybody" cannot be deleted.
  • Work items with assignment reasons "owner", "starter", and "originator" cannot be deleted.
  • The last "administrator" work item cannot be deleted.
  • "potential starter" work items can only be deleted as long as the task is inactive. The task must be a stand-alone, non-inline task.
  • "potential owner" or "editor" work items can only be deleted when the task is ready or claimed.
  • "administrator" or "reader" work items can be deleted in any task state but inactive. When the task is in the terminated or expired state, the task must be a stand-alone, non-inline task.

The action associated to this method is TaskActions.DELETEWORKITEM.

This method is not supported in archive mode.

Parameters:
tkiid - The ID of task instance that is used to identify the work item to be deleted.
assignmentReason - The reason why the work item is assigned - refer to the work item assignment reasons.
userID - The user the work item belongs to.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.1 Throws a GroupWorkItemException when a group work item is asked to be deleted.
6.1 Throws a TaskDelegationNotSupportedException when the last work item is deleted and the task cannot be delegated to the fallback user.
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

deleteWorkItem

  1. void deleteWorkItem(ESIID esiid,
  2. int assignmentReason,
  3. java.lang.String userID)
  4. throws ApplicationVetoException
  5. ArchiveUnsupportedOperationException
  6. EverybodyWorkItemException
  7. GroupWorkItemException
  8. IdWrongFormatException
  9. InvalidAssignmentReasonException
  10. InvalidLengthException
  11. LastAdminWorkItemException
  12. NotAuthorizedException
  13. WorkItemDoesNotExistException
  14. ObjectDoesNotExistException
  15. ParameterNullException
  16. TaskDelegationNotSupportedException
  17. WorkItemManagerException
  18. WrongKindException
  19. WrongStateException
  20. UnexpectedFailureException
  21. CommunicationException
Deletes the specified user work item using the escalation instance ID.

The caller must be an administrator. "Escalation receiver" work items can only be deleted when the task is escalated.

The action associated to this method is EscalationActions.DELETEWORKITEM.

This method is not supported in archive mode.

Parameters:
esiid - The ID of escalation instance that is used to identify the work item to be deleted.
assignmentReason - The reason why the work item is assigned - refer to the work item assignment reasons.
userID - The user the work item belongs to.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.1 Throws a GroupWorkItemException when a group is specified as user ID.
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

getAbsence

  1. boolean getAbsence()
  2. throws StaffServiceCannotAccessVMMException
  3. StaffServiceSubstitutionNotEnabledException
  4. StaffServiceRuntimeException
  5. UserDoesNotExistException
  6. UnexpectedFailureException
  7. CommunicationException
Deprecated. As of version 7.0, replaced by getUserSubstitutionDetail.

Returns the absence setting of the logged-on user. Absent users do not receive any work items but a substitute receives the work item instead.
Returns:
boolean - The absence setting of the specified user. True states that the specified user is absent. False states that the specified user is not absent.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

getAbsence

  1. boolean getAbsence(java.lang.String userID)
  2. throws NotAuthorizedException
  3. ParameterNullException
  4. StaffServiceCannotAccessVMMException
  5. StaffServiceSubstitutionNotEnabledException
  6. StaffServiceRuntimeException
  7. UserDoesNotExistException
  8. UnexpectedFailureException
  9. CommunicationException
Deprecated. As of version 7.0, replaced by getUserSubstitutionDetail.
Returns the absence setting of the specified user. Absent users do not receive any work items but a substitute receives the work item instead.

If retrieving the absence setting is not restricted to administrators, then everybody can retrieve the absence setting of any user.

If retrieving the absence setting is restricted to administrators, then only task system monitors or task system administrators can retrieve the absence setting of arbitrary users. A user may, however, always read his/her personal setting.

Parameters:
userID - The name of the user whose absence setting is to be retrieved.

Returns:
boolean - The absence setting of the specified user. True states that the specified user is absent. False states that the specified user is not absent.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

getAllCustomProperties

  1. java.util.List getAllCustomProperties( java.lang.String identifier)
  2. throws IdWrongFormatException
  3. IdWrongTypeException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. UnexpectedFailureException
  7. CommunicationException
Retrieves all custom properties of the specified task template or task instance using a string representation of the object ID.

Custom properties allow a user to add additional properties to a task beyond those provided and managed by the Human Task Manager.

In contrast to custom properties that are attached to an object, inline custom properties are an integral part of the object. Thus, using inline custom properties can increase performance.

This method returns the custom properties that are attached to the object as well as the inline custom properties.

Custom properties can be retrieved in any state of the task instance. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETCUSTOMPROPERTY.

Parameters:
identifier - A string representation of the task template or task instance object ID. This string is used to identify the object for which the custom properties are to be retrieved.

Returns:
List - A list of CustomProperty and InlineCustomProperty objects.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.5.1

getAllCustomProperties

  1. java.util.List getAllCustomProperties( TKTID tktid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Retrieves all custom properties of the specified task template using the task template ID.

Custom properties allow a user to add additional properties to a task beyond those provided and managed by the Human Task Manager.

In contrast to custom properties that are attached to an object, inline custom properties are an integral part of the object. Thus, using inline custom properties can increase performance.

This method returns the custom properties that are attached to the process template as well as the inline custom properties.

The caller must have at least reader authority for the task template.

The action associated to this method is TaskTemplateActions.GETCUSTOMPROPERTY.

Parameters:
tktid - The task template object ID whose custom properties are to be retrieved.

Returns:
List - A list of CustomProperty and InlineCustomProperty objects.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.5.1

getAllCustomProperties

  1. java.util.List getAllCustomProperties( TKIID tkiid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Retrieves all custom properties of the specified task instance using the task instance ID.

Custom properties allow a user to add additional properties to a task beyond those provided and managed by the Human Task Manager.

In contrast to custom properties that are attached to an object, inline custom properties are an integral part of the object. Thus, using inline custom properties can increase performance.

This method returns the custom properties that are attached to the task instance as well as the inline custom properties.

Custom properties can be retrieved in any state of the task instance. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETCUSTOMPROPERTY.

Parameters:
tkiid - The task instance object ID whose custom properties are to be retrieved.

Returns:
List - A list of CustomProperty and InlineCustomProperty objects.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.5.1

getAllWorkItems

  1. WorkItem[] getAllWorkItems(java.lang.String identifier)
  2. throws IdWrongFormatException
  3. IdWrongTypeException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. WorkItemManagerException
  7. UnexpectedFailureException
  8. CommunicationException
Returns all work item assignments associated to specified task or escalation instance using a string representation of the task or escalation instance ID.

The task or escalation instance can be in any execution state.

The caller must have a work item for the task or escalation instance or be a task system administrator or task system monitor.

Parameters:
identifier - The string representation of a task or escalation instance ID. The string is used to identify the object whose work item assignments are to be retrieved.

Returns:
WorkItem[] - An array of work items. If there are no work items, an empty array is returned. Refer to WorkItem to view the work item properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2.1

getAllWorkItems

  1. WorkItem[] getAllWorkItems(ESIID esiid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. WorkItemManagerException
  6. UnexpectedFailureException
  7. CommunicationException
Returns all work item assignments associated to specified escalation instance using the escalation instance ID.

The escalation instance can be in any state.

The caller must have a work item for the escalation instance or be a task system administrator or task system monitor.

Parameters:
esiid - The object ID of the escalation instance. This ID is used to identify the escalation whose work item assignments are to be retrieved.

Returns:
WorkItem[] - An array of work items. If there are no work items, an empty array is returned. Refer to WorkItem to view the work item properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2.1

getAllWorkItems

  1. WorkItem[] getAllWorkItems(TKIID tkiid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. WorkItemManagerException
  6. UnexpectedFailureException
  7. CommunicationException
Returns all work item assignments associated to specified task instance using the task instance ID.

The task instance can be in any execution state.

The caller must have a work item for the task instance or be a task system administrator or task system monitor.

Parameters:
tkiid - The object ID of the task instance. This ID is used to identify the task whose work item assignments are to be retrieved.

Returns:
WorkItem[] - An array of work items. If there are no work items, an empty array is returned. Refer to WorkItem to view the work item properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2.1

getAvailableActionFlags

  1. boolean[][] getAvailableActionFlags( java.lang.String[] identifiers)
  2. throws IdWrongFormatException
  3. IdWrongTypeException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. UnexpectedFailureException
  7. CommunicationException
Returns the actions that can be called for the specified tasks or escalations in their current state by the logged-on user using string representations of the task or escalation instance IDs. Refer to TaskActions or EscalationActions for possible actions.
Parameters:
identifiers - An array of string representations of task or escalation instance IDs.

Returns:
boolean[][] - An array of actions that can be called for each specified task or escalation instance. The array contains a row per task or escalation instance and a column per possible action. An array entry thus indicates whether a possible action can be called for the task or escalation instance by the logged-on user in the current task or escalation instance state. True states that the action can be called. False states that the action cannot be called.

The task or escalation instances appear in the same order as specified. Refer to TaskActionIndex or EscalationActionIndex for index constants that can be used to access the columns of the two-dimensional array.

Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.1 Supports escalation instances.

getAvailableActionFlags

  1. boolean[][] getAvailableActionFlags( ESIID[] esiids)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Returns the actions that can be called for the specified escalation instances in their current state by the logged-on user using escalation instance IDs. Refer to EscalationActions for possible actions.
Parameters:
esiids - An array of escalation instance IDs.

Returns:
boolean[][] - An array of actions that can be called for each specified escalation instance. The array contains a row per escalation instance and a column per possible action. An array entry thus indicates whether a possible action can be called for the escalation instance by the logged-on user in the current escalation instance state. True states that the action can be called. False states that the action cannot be called.

The escalation instances appear in the same order as specified. Refer to EscalationActionIndex for index constants that can be used to access the columns of the two-dimensional array.

Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

getAvailableActionFlags

  1. boolean[][] getAvailableActionFlags( TKIID[] tkiids)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Returns the actions that can be called for the specified tasks in their current state by the logged-on user using task instance IDs. Refer to TaskActions for possible actions.
Parameters:
tkiids - An array of task instance IDs.

Returns:
boolean[][] - An array of actions that can be called for each specified task instance. The array contains a row per task instance and a column per possible action. An array entry thus indicates whether a possible action can be called for the task instance by the logged-on user in the current task instance state. True states that the action can be called. False states that the action cannot be called.

The task instances appear in the same order as specified. Refer to TaskActionIndex for index constants that can be used to access the columns of the two-dimensional array.

Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

getAvailableActions

  1. int[] getAvailableActions(java.lang.String identifier)
  2. throws IdWrongFormatException
  3. IdWrongTypeException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. UnexpectedFailureException
  7. CommunicationException
Returns the actions that can be called by the logged-on user for the specified task instance, task template, escalation instance, or escalation template using a string representation of the object ID. Refer to TaskActions, TaskTemplateActions, EscalationActions, or EscalationTemplateActions for possible actions.
Parameters:
identifier - The string representation of the object ID.

Returns:
int[] - The set of possible actions. Returns null if there are no available actions.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.1 Supports task templates, escalation templates, and escalation instances.

getAvailableActions

  1. int[] getAvailableActions(ESTID estid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Returns the actions that can be called in the current escalation template state by the logged-on user using the escalation template ID. Refer to EscalationTemplateActions for possible actions.
Parameters:
estid - The object ID of the escalation template.

Returns:
int[] - The set of possible actions. Returns null if there are no available actions.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

getAvailableActions

  1. int[] getAvailableActions(ESIID esiid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Returns the actions that can be called in the current escalation instance state by the logged-on user using the escalation instance ID. Refer to EscalationActions for possible actions.
Parameters:
esiid - The object ID of the escalation instance.

Returns:
int[] - The set of possible actions. Returns null if there are no available actions.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

getAvailableActions

  1. int[] getAvailableActions(TKIID tkiid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Returns the actions that can be called in the current task instance state by the logged-on user using the task instance ID. Refer to TaskActions for possible actions.
Parameters:
tkiid - The object ID of the task instance.

Returns:
int[] - The set of possible actions. Returns null if there are no available actions.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

getAvailableActions

  1. int[] getAvailableActions(TKTID tktid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Returns the actions that can be called in the current task template state by the logged-on user using the task template ID. Refer to TaskTemplateActions for possible actions.
Parameters:
tktid - The object ID of the task template.

Returns:
int[] - The set of possible actions. Returns null if there are no available actions.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

getApplicationComponent

  1. ApplicationComponent getApplicationComponent( java.lang.String acoid)
  2. throws IdWrongFormatException
  3. IdWrongTypeException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. UnexpectedFailureException
  7. CommunicationException
Retrieves the specified application component using a string representation of the application component ID.

The caller must be the task system administrator or the task system monitor.

The action associated to this method is ApplicationComponentActions.GETAPPLICATIONCOMPONENT.

Parameters:
acoid - A string representation of the application component ID. This is used to identify the application component to be retrieved.

Returns:
ApplicationComponent - The application component. Refer to ApplicationComponent to view the application component properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

getApplicationComponent

  1. ApplicationComponent getApplicationComponent( ACOID acoid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Retrieves the specified application component using the application component ID.

The caller must be the task system administrator or the task system monitor.

The action associated to this method is ApplicationComponentActions.GETAPPLICATIONCOMPONENT.

Parameters:
acoid - The object ID of the application component to be retrieved.

Returns:
ApplicationComponent - The application component. Refer to ApplicationComponent to view the application component properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

getCustomProperty

  1. java.lang.String getCustomProperty( java.lang.String identifier,
  2. java.lang.String propertyName)
  3. throws IdWrongFormatException
  4. IdWrongTypeException
  5. NotAuthorizedException
  6. ObjectDoesNotExistException
  7. ParameterNullException
  8. WrongKindException
  9. WrongStateException
  10. UnexpectedFailureException
  11. CommunicationException
Retrieves the named custom property of the specified task instance, task template, escalation instance, or escalation template using a string representation of the object ID.

Custom properties allow a user to add additional properties to tasks or escalations beyond those provided and managed by the task manager.

A custom property can be retrieved in any state of a task or escalation instance. The caller must have at least reader authority for the object.

The action associated to this method is TaskActions.GETCUSTOMPROPERTY or EscalationActions.GETCUSTOMPROPERTY or TaskTemplateActions.GETCUSTOMPROPERTY or EscalationTemplateActions.GETCUSTOMPROPERTY.

Parameters:
identifier - A string representation of the task instance, task template, escalation instance, or escalation template ID. This string is used to identify the object for which the custom property is to be retrieved.
propertyName - The name of the custom property for which the value is to be retrieved.

Returns:
String - The value of the specified custom property. Returns null when the specified property cannot be found.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.1 Supports task templates, escalation templates, and escalation instances.

getCustomProperty

  1. java.lang.String getCustomProperty( ESTID estid,
  2. java.lang.String propertyName)
  3. throws IdWrongFormatException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. ParameterNullException
  7. UnexpectedFailureException
  8. CommunicationException
Retrieves the named custom property of the specified escalation template using the escalation template ID.

Custom properties allow a user to add additional properties to escalations beyond those provided and managed by the task manager.

The caller must have at least reader authority for the escalation template.

The action associated to this method is EscalationTemplateActions.GETCUSTOMPROPERTY.

Parameters:
estid - The escalation template ID whose named custom property is to be retrieved.
propertyName - The name of the custom property for which the value is to be retrieved.

Returns:
String - The value of the specified custom property. Returns null when the specified property cannot be found.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

getCustomProperty

  1. java.lang.String getCustomProperty( ESIID esiid,
  2. java.lang.String propertyName)
  3. throws IdWrongFormatException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. ParameterNullException
  7. UnexpectedFailureException
  8. CommunicationException
Retrieves the named custom property of the specified escalation instance using the escalation instance ID.

Custom properties allow a user to add additional properties to an escalation beyond those provided and managed by the task manager.

A custom property can be retrieved in any state of the escalation instance. The caller must have at least reader authority for the escalation instance.

The action associated to this method is EscalationActions.GETCUSTOMPROPERTY.

Parameters:
esiid - The escalation instance ID whose named custom property is to be retrieved.
propertyName - The name of the custom property for which the value is to be retrieved.

Returns:
String - The value of the specified custom property. Returns null when the specified property cannot be found.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

getCustomProperty

  1. java.lang.String getCustomProperty( TKTID tktid,
  2. java.lang.String propertyName)
  3. throws IdWrongFormatException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. ParameterNullException
  7. UnexpectedFailureException
  8. CommunicationException
Retrieves the named custom property of the specified task template using the task template ID.

Custom properties allow a user to add additional properties to tasks beyond those provided and managed by the task manager.

The caller must have at least reader authority for the task template.

The action associated to this method is TaskTemplateActions.GETCUSTOMPROPERTY.

Parameters:
tktid - The task template ID whose named custom property is to be retrieved.
propertyName - The name of the custom property for which the value is to be retrieved.

Returns:
String - The value of the specified custom property. Returns null when the specified property cannot be found.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

getCustomProperty

  1. java.lang.String getCustomProperty( TKIID tkiid,
  2. java.lang.String propertyName)
  3. throws IdWrongFormatException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. ParameterNullException
  7. WrongKindException
  8. WrongStateException
  9. UnexpectedFailureException
  10. CommunicationException
Retrieves the named custom property of the specified task instance using the task instance ID.

Custom properties allow a user to add additional properties to a task beyond those provided and managed by the task manager.

A custom properties can be retrieved in any state of the task instance. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETCUSTOMPROPERTY.

Parameters:
tkiid - The task instance ID whose named custom property is to be retrieved.
propertyName - The name of the custom property for which the value is to be retrieved.

Returns:
String - The value of the specified custom property. Returns null when the specified property cannot be found.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

getCustomPropertyInfo

  1. java.util.List getCustomPropertyInfo( int objectType,
  2. java.lang.String nameFilter,
  3. java.lang.Integer threshold)
  4. throws InvalidParameterException
  5. WorkItemManagerException
  6. UnexpectedFailureException
  7. CommunicationException
Retrieves information about custom properties of the specified object types.

Custom properties allow a user to add additional properties to objects beyond those provided and managed by the Human Task Manager.

Besides specifying an object type, you can specify a threshold or a filter to reduce the number of custom property information returned.

Parameters:
objectType - An indicator that specifies for which object type custom property information is to be retrieved. If there are multiple custom properties with the same name for the same object type, a single information entry is returned.
nameFilter - A filter on the names of custom properties. A SQL LIKE predicate is applied to the custom property names.
threshold - Specifies the maximum number of custom property information entries to be returned from the server to the client. If a threshold is not to be applied, null must be specified.

Returns:
List - A list of CustomPropertyInfo objects. For instances, information is only returned for custom properties the logged-on user is authorized to read.

The list is empty if there are no custom properties for the specified object type the user is authorized to read.

Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1.2

getCustomPropertyNames

  1. java.util.List getCustomPropertyNames( java.lang.String identifier)
  2. throws IdWrongFormatException
  3. IdWrongTypeException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. UnexpectedFailureException
  7. CommunicationException
Retrieves the names of all custom properties of the specified task instance, task template, escalation instance, or escalation template using a string representation of the object ID.

Custom properties allow a user to add additional properties to tasks or escalations beyond those provided and managed by the task manager.

Custom properties names can be retrieved in any state of a task or escalation instance. The caller must have at least reader authority for the task or escalation instance.

The action associated to this method is TaskActions.GETCUSTOMPROPERTY or EscalationActions.GETCUSTOMPROPERTY or TaskTemplateActions.GETCUSTOMPROPERTY or EscalationTemplateActions.GETCUSTOMPROPERTY.

Parameters:
identifier - A string representation of the task instance, task template, escalation instance, or escalation template ID. This string is used to identify the object for which the custom property names are to be retrieved.

Returns:
List - A list of custom property names. Returns an empty list when there are no custom properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.1 Supports escalation instances and templates.

getCustomPropertyNames

  1. java.util.List getCustomPropertyNames( ESTID estid)
  2. throws NotAuthorizedException
  3. IdWrongFormatException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Retrieves the names of all custom properties of the specified escalation template using the escalation template ID.

Custom properties allow a user to add additional properties to escalations beyond those provided and managed by the task manager.

The caller must have at least reader authority for the escalation template.

The action associated to this method is EscalationTemplateActions.GETCUSTOMPROPERTY.

Parameters:
estid - The escalation template ID whose custom property names are to be retrieved.

Returns:
List - A list of custom property names. Returns an empty list when there are no custom properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

getCustomPropertyNames

  1. java.util.List getCustomPropertyNames( ESIID esiid)
  2. throws NotAuthorizedException
  3. IdWrongFormatException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Retrieves the names of all custom properties of the specified escalation instance using the escalation instance ID.

Custom properties allow a user to add additional properties to escalations beyond those provided and managed by the task manager.

Custom properties names can be retrieved in any state of the escalation instance. The caller must have at least reader authority for the escalation instance.

The action associated to this method is EscalationActions.GETCUSTOMPROPERTY.

Parameters:
esiid - The escalation instance ID whose custom property names are to be retrieved.

Returns:
List - A list of custom property names. Returns an empty list when there are no custom properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

getCustomPropertyNames

  1. java.util.List getCustomPropertyNames( TKTID tktid)
  2. throws NotAuthorizedException
  3. IdWrongFormatException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Retrieves the names of all custom properties of the specified task template using the task template ID.

Custom properties allow a user to add additional properties to tasks beyond those provided and managed by the task manager.

The caller must have at least reader authority for the task template.

The action associated to this method is TaskTemplateActions.GETCUSTOMPROPERTY.

Parameters:
tktid - The task template ID whose custom property names are to be retrieved.

Returns:
List - A list of custom property names. Returns an empty list when there are no custom properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

getCustomPropertyNames

  1. java.util.List getCustomPropertyNames( TKIID tkiid)
  2. throws NotAuthorizedException
  3. IdWrongFormatException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Retrieves the names of all custom properties of the specified task instance using the task instance ID.

Custom properties allow a user to add additional properties to tasks beyond those provided and managed by the task manager.

Custom properties names can be retrieved in any state of the task instance. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETCUSTOMPROPERTY.

Parameters:
tkiid - The task instance ID whose custom property names are to be retrieved.

Returns:
List - A list of custom property names. Returns an empty list when there are no custom properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

getCustomProperties

  1. java.util.List getCustomProperties( java.lang.String identifier)
  2. throws IdWrongFormatException
  3. IdWrongTypeException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. UnexpectedFailureException
  7. CommunicationException
Retrieves the custom properties of the specified task instance, task template, escalation instance, or escalation template using a string representation of the object ID.

Custom properties allow a user to add additional properties to tasks or escalations beyond those provided and managed by the task manager.

Custom properties can be retrieved in any state of a task or escalation instance. The caller must have at least reader authority for the task or escalation.

The action associated to this method is TaskActions.GETCUSTOMPROPERTY or EscalationActions.GETCUSTOMPROPERTY or TaskTemplateActions.GETCUSTOMPROPERTY or EscalationTemplateActions.GETCUSTOMPROPERTY.

Parameters:
identifier - A string representation of the task instance, task template, escalation instance, or escalation template ID. This string is used to identify the object for which the custom properties are to be retrieved.

Returns:
List - A list of CustomProperty objects. Returns an empty list when there are no custom properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.1 Supports escalation instances and templastes.

getCustomProperties

  1. java.util.List getCustomProperties( ESTID estid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Retrieves the custom properties of the specified escalation template using the escalation template ID.

Custom properties allow a user to add additional properties to an escalation beyond those provided and managed by the task manager.

The caller must have at least reader authority for the escalation template.

The action associated to this method is EscalationTemplateActions.GETCUSTOMPROPERTY.

Parameters:
estid - The escalation template ID whose custom properties are to be retrieved.

Returns:
List - A list of CustomProperty objects. Returns an empty list when there are no custom properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

getCustomProperties

  1. java.util.List getCustomProperties( ESIID esiid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Retrieves the custom properties of the specified escalation instance using the escalation instance ID.

Custom properties allow a user to add additional properties to an escalation beyond those provided and managed by the task manager.

Custom properties can be retrieved in any state of the escalation instance. The caller must have at least reader authority for the escalation instance.

The action associated to this method is EscalationActions.GETCUSTOMPROPERTY.

Parameters:
esiid - The escalation instance ID whose custom properties are to be retrieved.

Returns:
List - A list of CustomProperty objects. Returns an empty list when there are no custom properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

getCustomProperties

  1. java.util.List getCustomProperties( TKTID tktid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Retrieves the custom properties of the specified task template using the task template ID.

Custom properties allow a user to add additional properties to a tasks beyond those provided and managed by the task manager.

The caller must have at least reader authority for the task template.

The action associated to this method is TaskTemplateActions.GETCUSTOMPROPERTY.

Parameters:
tktid - The task template ID whose custom properties are to be retrieved.

Returns:
List - A list of CustomProperty objects. Returns an empty list when there are no custom properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

getCustomProperties

  1. java.util.List getCustomProperties( TKIID tkiid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Retrieves all custom properties of the specified task instance using the task instance ID.

Custom properties allow a user to add additional properties to a task beyond those provided and managed by the task manager.

Custom properties can be retrieved in any state of the task instance. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETCUSTOMPROPERTY.

Parameters:
tkiid - The task instance ID whose custom properties are to be retrieved.

Returns:
List - A list of CustomProperty objects. Returns an empty list when there are no custom properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

getBinaryCustomProperty

  1. BinaryCustomProperty getBinaryCustomProperty( java.lang.String identifier,
  2. java.lang.String propertyName)
  3. throws IdWrongFormatException
  4. IdWrongTypeException
  5. NotAuthorizedException
  6. ObjectDoesNotExistException
  7. ParameterNullException
  8. UnexpectedFailureException
  9. CommunicationException
Retrieves the named binary custom property of the specified task or escalation instance using a string representation of the object ID.

Custom properties allow a user to add additional properties to tasks or escalations beyond those provided and managed by the task manager. Binary custom properties allow, for example, to attach a Java object to a task instance. Binary custom properties cannot be searched for directly. It is, however, possible to specify an additional queryable string.

A binary custom property can be retrieved in any state of a the task or escalation instance. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETCUSTOMPROPERTY or EscalationActions.GETCUSTOMPROPERTY.

Parameters:
identifier - A string representation of the task or escalation instance ID. This string is used to identify the task or escalation instance for which the binary custom property is to be retrieved.
propertyName - The name of the binary custom property to be retrieved.

Returns:
BinaryCustomProperty - The BinaryCustomProperty object. Returns null when the named binary custom property cannot be found.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.1 Supports escalation instances.

getBinaryCustomProperty

  1. BinaryCustomProperty getBinaryCustomProperty( ESIID esiid,
  2. java.lang.String propertyName)
  3. throws IdWrongFormatException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. ParameterNullException
  7. UnexpectedFailureException
  8. CommunicationException
Retrieves the named binary custom property of the specified escalation instance using the escalation instance ID.

Custom properties allow a user to add additional properties to escalations beyond those provided and managed by the task manager. Binary custom properties allow, for example, to attach a Java object to an escalation instance. Binary custom properties cannot be searched for directly. It is, however, possible to specify an additional queryable string.

A binary custom property can be retrieved in any state of a the escalation instance. The caller must have at least reader authority for the escalation instance.

The action associated to this method is EscalationActions.GETCUSTOMPROPERTY.

Parameters:
esiid - The escalation instance ID. This ID is used to identify the escalation instance for which the binary custom property is to be retrieved.
propertyName - The name of the binary custom property to be retrieved.

Returns:
BinaryCustomProperty - The BinaryCustomProperty object. Returns null when the named binary custom property cannot be found.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

getBinaryCustomProperty

  1. BinaryCustomProperty getBinaryCustomProperty( TKIID tkiid,
  2. java.lang.String propertyName)
  3. throws IdWrongFormatException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. ParameterNullException
  7. UnexpectedFailureException
  8. CommunicationException
Retrieves the named binary custom property of the specified task instance using the task instance ID.

Custom properties allow a user to add additional properties to tasks beyond those provided and managed by the task manager. Binary custom properties allow, for example, to attach a Java object to a task instance. Binary custom properties cannot be searched for directly. It is, however, possible to specify an additional queryable string.

A binary custom property can be retrieved in any state of a the task instance. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETCUSTOMPROPERTY.

Parameters:
tkiid - The task instance ID. This ID is used to identify the task instance for which the binary custom property is to be retrieved.
propertyName - The name of the binary custom property to be retrieved.

Returns:
BinaryCustomProperty - The BinaryCustomProperty object. Returns null when the named binary custom property cannot be found.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

getBinaryCustomPropertyNames

  1. java.util.List getBinaryCustomPropertyNames( java.lang.String identifier)
  2. throws IdWrongFormatException
  3. IdWrongTypeException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. UnexpectedFailureException
  7. CommunicationException
Retrieves the names of all binary custom properties of the specified task or escalation instance using a string representation of the task or escalation instance ID.

Custom properties allow a user to add additional properties to tasks or escalations beyond those provided and managed by the task manager. Binary custom properties allow, for example, to attach a Java object to a task instance. Binary custom properties cannot be searched for directly. It is, however, possible to specify an additional queryable string.

Binary custom properties names can be retrieved in any state of the task or escalation instance. The caller must have at least reader authority for the task instance.

Parameters:
identifier - A string representation of the task or escalation instance ID. This string is used to identify the task or escalation instance for which the binary custom property names are to be retrieved.

Returns:
List - A list of binary custom property names. Returns an empty list when there are no binary custom properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

getBinaryCustomPropertyNames

  1. java.util.List getBinaryCustomPropertyNames( ESIID esiid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Retrieves the names of all binary custom properties of the specified escalation instance using the escalation instance ID.

Custom properties allow a user to add additional properties to escalations beyond those provided and managed by the task manager. Binary custom properties allow, for example, to attach a Java object to an escalation instance. Binary custom properties cannot be searched for directly. It is, however, possible to specify an additional queryable string.

Binary custom properties names can be retrieved in any state of the escalation instance. The caller must have at least reader authority for the escalation instance.

Parameters:
esiid - The escalation instance ID. This ID is used to identify the escalation instance for which the binary custom property names are to be retrieved.

Returns:
List - A list of binary custom property names. Returns an empty list when there are no binary custom properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

getBinaryCustomPropertyNames

  1. java.util.List getBinaryCustomPropertyNames( TKIID tkiid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Retrieves the names of all binary custom properties of the specified task instance using the task instance ID.

Custom properties allow a user to add additional properties to tasks beyond those provided and managed by the task manager. Binary custom properties allow, for example, to attach a Java object to a task instance. Binary custom properties cannot be searched for directly. It is, however, possible to specify an additional queryable string.

Binary custom properties names can be retrieved in any state of the task instance. The caller must have at least reader authority for the task instance.

Parameters:
tkiid - The task instance ID. This ID is used to identify the task instance for which the binary custom property names are to be retrieved.

Returns:
List - A list of binary custom property names. Returns an empty list when there are no binary custom properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

getDocumentation

  1. java.lang.String getDocumentation( java.lang.String identifier,
  2. java.util.Locale locale)
  3. throws IdWrongFormatException
  4. IdWrongTypeException
  5. NotAuthorizedException
  6. ObjectDoesNotExistException
  7. UnexpectedFailureException
  8. CommunicationException
Retrieves the documentation of the specified object using a string representation of the object ID.

Documentations can be retrieved in any state of the object. The caller must have at least reader authority for the object.

The action associated to this method is TaskActions.GETDOCUMENTATION or EscalationActions.GETDOCUMENTATION or TaskTemplateActions.GETDOCUMENTATION or EscalationTemplateActions.GETDOCUMENTATION.

Parameters:
identifier - A string representation of the object ID that is used to identify the object.
locale - The locale for which the documentation is to be provided. If no locale is provided, then the documentation is searched for in the default language.

Returns:
String - The documentation. Returns null when there is no documentation in the specified locale.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

getDocumentation

  1. java.lang.String getDocumentation( ESIID esiid,
  2. java.util.Locale locale)
  3. throws IdWrongFormatException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. UnexpectedFailureException
  7. CommunicationException
Retrieves the documentation of the specified escalation instance using the escalation instance ID.

Documentations can be retrieved in any state of the escalation. The caller must have at least reader authority for the escalation.

The action associated to this method is EscalationActions.GETDOCUMENTATION.

Parameters:
esiid - The escalation instance ID that is used to identify the escalation instance.
locale - The locale for which the documentation is to be provided. If no locale is provided, then the documentation is searched for in the default language.

Returns:
String - The documentation. Returns null when there is no documentation in the specified locale.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

getDocumentation

  1. java.lang.String getDocumentation( ESTID estid,
  2. java.util.Locale locale)
  3. throws IdWrongFormatException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. UnexpectedFailureException
  7. CommunicationException
Retrieves the documentation of the specified escalation template using the escalation template ID.

The caller must have at least reader authority for the escalation template.

The action associated to this method is EscalationTemplateActions.GETDOCUMENTATION.

Parameters:
estid - The escalation template ID that is used to identify the escalation template.
locale - The locale for which the documentation is to be provided. If no locale is provided, then the documentation is searched for in the default language.

Returns:
String - The documentation. Returns null when there is no documentation in the specified locale.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

getDocumentation

  1. java.lang.String getDocumentation( TKIID tkiid,
  2. java.util.Locale locale)
  3. throws IdWrongFormatException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. UnexpectedFailureException
  7. CommunicationException
Retrieves the documentation of the specified task instance using the task instance ID.

Documentations can be retrieved in any state of the task instance. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETDOCUMENTATION.

Parameters:
tkiid - The task instance ID that is used to identify the task instance.
locale - The locale for which the documentation is to be provided. If no locale is provided, then the documentation is searched for in the default language.

Returns:
String - The documentation. Returns null when there is no documentation in the specified locale.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

getDocumentation

  1. java.lang.String getDocumentation( TKTID tktid,
  2. java.util.Locale locale)
  3. throws IdWrongFormatException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. UnexpectedFailureException
  7. CommunicationException
Retrieves the documentation of the specified task template using the task template ID.

The caller must have at least reader authority for the task template.

The action associated to this method is TaskTemplateActions.GETDOCUMENTATION.

Parameters:
tktid - The task template ID that is used to identify the task template.
locale - The locale for which the documentation is to be provided. If no locale is provided, then the documentation is searched for in the default language.

Returns:
String - The documentation. Returns null when there is no documentation in the specified locale.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

getEscalation

  1. Escalation getEscalation(java.lang.String tkiid,
  2. java.lang.String escalationName)
  3. throws EscalationDoesNotExistException
  4. IdWrongFormatException
  5. IdWrongTypeException
  6. NotAuthorizedException
  7. ObjectDoesNotExistException
  8. ParameterNullException
  9. UnexpectedFailureException
  10. CommunicationException
Retrieves the specified escalation instance using a string representation of the associated task instance ID and the escalation name.

Escalations can be retrieved in any escalation state and any task state. The caller must have at least reader authority.

The action associated to this method is EscalationActions.GETESCALATION.

Parameters:
tkiid - A string representation of the task instance ID that is used to identify the associated task instance.
escalationName - The name of the escalation.

Returns:
Escalation - The escalation instance. Refer to Escalation to view the escalation properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

getEscalation

  1. Escalation getEscalation(java.lang.String esiid)
  2. throws IdWrongFormatException
  3. IdWrongTypeException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. UnexpectedFailureException
  7. CommunicationException
Retrieves the specified escalation instance using a string representation of the escalation instance ID.

Escalations can be retrieved in any escalation state. The caller must have at least reader authority.

The action associated to this method is EscalationActions.GETESCALATION.

Parameters:
esiid - A string representation of the escalation instance ID that is used to identify the escalation to be retrieved.

Returns:
Escalation - The escalation instance. Refer to Escalation to view the escalation properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

getEscalation

  1. Escalation getEscalation(ESIID esiid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Retrieves the specified escalation instance using the escalation instance ID.

Escalations can be retrieved in any escalation state. The caller must have at least reader authority.

The action associated to this method is EscalationActions.GETESCALATION.

Parameters:
esiid - The escalation instance ID that is used to identify the escalation to be retrieved.

Returns:
Escalation - The escalation instance. Refer to Escalation to view the escalation properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

getEscalation

  1. Escalation getEscalation(TKIID tkiid,
  2. java.lang.String escalationName)
  3. throws EscalationDoesNotExistException
  4. IdWrongFormatException
  5. NotAuthorizedException
  6. ObjectDoesNotExistException
  7. ParameterNullException
  8. UnexpectedFailureException
  9. CommunicationException
Retrieves the specified escalation instance using the associated task instance ID and the escalation name.

Escalations can be retrieved in any escalation state and any task state. The caller must have at least reader authority.

The action associated to this method is EscalationActions.GETESCALATION.

Parameters:
tkiid - The task instance ID that is used to identify the associated task instance.
escalationName - The name of the escalation.

Returns:
Escalation - The escalation instance. Refer to Escalation to view the escalation properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

getEscalationInfo

  1. EscalationInfo getEscalationInfo( java.lang.String tkiid)
  2. throws IdWrongFormatException
  3. IdWrongTypeException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. UnexpectedFailureException
  7. CommunicationException
Retrieves information about all escalations of the specified task instance using a string representation of the task instance ID.

Escalation information can be retrieved in any task state. The caller must have at least reader authority.

Parameters:
tkiid - A string representation of the task instance ID that is used to identify the task instance.

Returns:
EscalationInfo - The escalation information. Refer to EscalationInfo to view the information returned.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

getEscalationInfo

  1. EscalationInfo getEscalationInfo( TKIID tkiid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Retrieves information about all escalations of the specified task instance using the task instance ID.

Escalation information can be retrieved in any task state. The caller must have at least reader authority.

Parameters:
tkiid - The task instance ID that is used to identify the task instance.

Returns:
EscalationInfo - The escalation information. Refer to EscalationInfo to view the information returned.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

getEscalationTemplate

  1. EscalationTemplate getEscalationTemplate( java.lang.String estid)
  2. throws IdWrongFormatException
  3. IdWrongTypeException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. UnexpectedFailureException
  7. CommunicationException
Retrieves the specified escalation template using a string representation of the escalation template ID.

The caller must have at least reader authority.

The action associated to this method is EscalationTemplateActions.GETESCALATIONTEMPLATE.

Parameters:
estid - A string representation of the escalation template ID that is used to identify the escalation template to be retrieved.

Returns:
EscalationTemplate - The escalation template. Refer to EscalationTemplate to view the escalation template properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

getEscalationTemplate

  1. EscalationTemplate getEscalationTemplate( ESTID estid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Retrieves the specified escalation template using the escalation template ID.

The caller must have at least reader authority.

The action associated to this method is EscalationTemplateActions.GETESCALATIONTEMPLATE.

Parameters:
estid - The escalation template ID that is used to identify the escalation template to be retrieved.

Returns:
EscalationTemplate - The escalation template. Refer to EscalationTemplate to view the escalation template properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

getFaultMessage

  1. ClientObjectWrapper getFaultMessage( java.lang.String tkiid)
  2. throws DataHandlingException
  3. IdWrongFormatException
  4. IdWrongTypeException
  5. NotAuthorizedException
  6. ObjectDoesNotExistException
  7. WrongKindException
  8. WrongStateException
  9. UnexpectedFailureException
  10. CommunicationException
Retrieves the fault message of the specified task instance using a string representation of the task instance ID.

The task instance must be a to-do, collaboration, or invocation task. Collaboration, to-do, and invocation task instances are also known as human, participating, and originating task instances.

The task instance can be in any state but inactive. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETFAULTMESSAGE.

Parameters:
tkiid - A string representation of the task instance ID. This string is used to identify the task instance for which the fault message is to be retrieved.

Returns:
ClientObjectWrapper - The fault message. If there is no fault message, an empty client object wrapper is returned.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

getFaultMessage

  1. ClientObjectWrapper getFaultMessage( TKIID tkiid)
  2. throws DataHandlingException
  3. IdWrongFormatException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. WrongKindException
  7. WrongStateException
  8. UnexpectedFailureException
  9. CommunicationException
Retrieves the fault message of the specified task instance using the task instance ID.

The task instance must be a to-do, collaboration, or invocation task. Collaboration, to-do, and invocation task instances are also known as human, participating, and originating task instances.

The task instance can be in any state but inactive. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETFAULTMESSAGE.

Parameters:
tkiid - The object ID of the task instance for which the fault message is to be retrieved.

Returns:
ClientObjectWrapper - The fault message. If there is no fault message, an empty client object wrapper is returned.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

getFaultNames

  1. java.util.List getFaultNames(java.lang.String identifier)
  2. throws IdWrongFormatException
  3. IdWrongTypeException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. WrongKindException
  7. WrongStateException
  8. UnexpectedFailureException
  9. CommunicationException
Retrieves the fault names defined for the specified task instance or template using a string representation of the task instance or template ID.

The task instance or template must be a to-do, collaboration, or invocation task. Collaboration, to-do, and invocation tasks are also known as human, participating, and originating tasks.

The task instance or template can be in any state.

The caller must have at least reader authority for the task instance or template.

The action associated to this method is TaskActions.GETFAULTNAMES or TaskTemplateActions.GETFAULTNAMES.

Parameters:
identifier - A string representation of the task instance or template ID that is used to identify the task instance or template for which fault names are to be retrieved.

Returns:
List - A list of fault names. If there are no faults, an empty list is returned. Fault names are to be specified when a fault message is set or created. Refer to complete, setFaultMessage, or to createFaultMessage(TKIID), or to createFaultMessage(TKTID).
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
7.0 Supports task templates.

getFaultNames

  1. java.util.List getFaultNames(TKTID tktid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. WrongKindException
  6. UnexpectedFailureException
  7. CommunicationException
Retrieves the fault names defined for the specified task template using the task template ID.

The task template must describe a to-do, collaboration, or invocation task. Collaboration, to-do, and invocation tasks are also known as human, participating, and originating tasks.

The task template can be in any state. The caller must have at least reader authority for the task template.

The action associated to this method is TaskTemplateActions.GETFAULTNAMES.

Parameters:
tktid - The object ID of the task template for which the fault names are to be retrieved.

Returns:
List - A list of fault names. If there are no faults, an empty list is returned. Fault names are to be specified when a fault message is set or created. Refer to complete, setFaultMessage, or to createFaultMessage.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

getFaultNames

  1. java.util.List getFaultNames(TKIID tkiid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. WrongKindException
  6. WrongStateException
  7. UnexpectedFailureException
  8. CommunicationException
Retrieves the fault names defined for the specified task instance using the task instance ID.

The task instance must be a to-do, collaboration, or invocation task. Collaboration, to-do, and invocation task instances are also known as human, participating, and originating task instances.

The task instance can be in any state. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETFAULTNAMES.

Parameters:
tkiid - The object ID of the task instance for which the fault names are to be retrieved.

Returns:
List - A list of fault names. If there are no faults, an empty list is returned. Fault names are to be specified when a fault message is set. Refer to complete, setFaultMessage, or to createFaultMessage.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

getGroupDetails

  1. java.util.List getGroupDetails( java.lang.String[] groupNames,
  2. java.lang.String[] groupProperties,
  3. java.lang.String[] userProperties,
  4. java.lang.String[] subGroupProperties,
  5. java.lang.Integer threshold)
  6. throws ParameterNullException
  7. StaffServiceCannotAccessVMMException
  8. StaffServiceRuntimeException
  9. UnexpectedFailureException
  10. CommunicationException
Returns details about the specified groups. All properties of type String from the VMM Group object can be requested, for example, displayName or description.

Note that this request does not participate in any global transaction, that is, exceptions do not cause a global transaction rollback.

Parameters:
groupNames - The groups that are to be queried. The names are unique names as defined in VMM.
groupProperties - The Group VMM properties that are to be returned for the specified groups. The "members" property is ignored, if specified.
userProperties - The PersonAccount VMM properties that are to be returned for the users directly contained in the group. If not specified, an empty list of user details is returned.
subGroupProperties - The Group VMM properties that are to be returned for the subgroups directly contained in the group. If not specified, an empty list of group details is returned. Note that the "members" property is ignored, if specified.
threshold - The maximum number of group, user, or subgroup details to be returned from the server to the client. If a threshold is not to be applied, null must be specified.

Group details are determined depth-first. This means that the last group returned may not be complete if a threshold is applied.

Returns:
List - A list of GroupDetail objects. An object is returned for each group specified even when the group does not exist. In that case, the group is marked as not found in the peopele directory.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1.2

getGroupNames

  1. java.lang.String[] getGroupNames( )
  2. throws UserDoesNotExistException
  3. UserRegistryException
  4. UnexpectedFailureException
  5. CommunicationException
Returns the names of groups the logged-on user is part of. The names returned may be names of groups that are defined in the user registry as well as names of dynamically allocated groups.

Returns:
String[] - An array of group names. When the user is not part of a group or when group work items are not enabled, an empty array is returned.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1.2

getHtmConfiguration

  1. HtmConfiguration getHtmConfiguration( )
  2. throws CommunicationException
Returns configuration settings of the Human Task Manager.

This interface returns configuration settings that influence the functionality of specific API methods. For example, whether substitution or group work items are enabled.

Returns:
HtmConfiguration - Human Task Manager configuration settings. Refer to HtmConfiguration to view the Human Task Manager configuration settings returned.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

getInlineCustomProperty

  1. InlineCustomProperty getInlineCustomProperty( java.lang.String identifier,
  2. java.lang.String propertyName)
  3. throws IdWrongFormatException
  4. IdWrongTypeException
  5. NotAuthorizedException
  6. ObjectDoesNotExistException
  7. ParameterNullException
  8. UnsupportedParameterValueException
  9. UnexpectedFailureException
  10. CommunicationException
Retrieves the named inline custom property of the specified task template or task instance using string representations of the object IDs.

Custom properties allow a user to add additional properties to a task beyond those provided and managed by the Human Task Manager.

In contrast to custom properties that are attached to an object, inline custom properties are an integral part of the task template or instance. Thus, using inline custom properties can increase performance.

Custom properties can be retrieved in any state of the task instance. The caller must have at least reader authority for the task instance or task template.

The action associated to this method is TaskActions.GETCUSTOMPROPERTY respectively TaskTemplateActions.GETCUSTOMPROPERTY.

Parameters:
identifier - A string representation of the task template or task instance object ID. This string is used to identify the object for which the inline custom property is to be retrieved.
propertyName - The name of the inline custom property for which the value is to be retrieved. The name can be one of the predefined names InlineCustomProperty.CUSTOM_TEXT_1 etc.

Returns:
InlineCustomProperty - The InlineCustomProperty.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.5.1

getInlineCustomProperty

  1. InlineCustomProperty getInlineCustomProperty( TKTID tktid,
  2. java.lang.String propertyName)
  3. throws IdWrongFormatException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. ParameterNullException
  7. UnsupportedParameterValueException
  8. UnexpectedFailureException
  9. CommunicationException
Retrieves the named inline custom property of the specified task template using the task template ID.

Custom properties allow a user to add additional properties to a task template beyond those provided and managed by the Human Task Manager.

In contrast to custom properties that are attached to an object, inline custom properties are an integral part of the task template. Thus, using inline custom properties can increase performance.

The caller must have at least reader authority for the task template.

The action associated to this method is TaskTemplateActions.GETCUSTOMPROPERTY.

Parameters:
tktid - The task template object ID whose named custom property is to be retrieved.
propertyName - The name of the inline custom property for which the value is to be read. The name can be one of the predefined names InlineCustomProperty.CUSTOM_TEXT_1 etc.

Returns:
InlineCustomProperty - The InlineCustomProperty.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.5.1

getInlineCustomProperty

  1. InlineCustomProperty getInlineCustomProperty( TKIID tkiid,
  2. java.lang.String propertyName)
  3. throws IdWrongFormatException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. ParameterNullException
  7. UnsupportedParameterValueException
  8. UnexpectedFailureException
  9. CommunicationException
Retrieves the named inline custom property of the specified task instance using the task instance ID.

Custom properties allow a user to add additional properties to a task instance beyond those provided and managed by the Human Task Manager.

In contrast to custom properties that are attached to an object, inline custom properties are an integral part of the task instance. Thus, using inline custom properties can increase performance.

Custom properties can be retrieved in any state of the task instance. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETCUSTOMPROPERTY.

Parameters:
tkiid - The task instance object ID whose custom property is to be retrieved.
propertyName - The name of the custom property for which the value is to be retrieved. The name can be one of the predefined names InlineCustomProperty.CUSTOM_TEXT_1 etc.

Returns:
InlineCustomProperty - The InlineCustomProperty.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.5.1

getInputMessage

  1. ClientObjectWrapper getInputMessage( java.lang.String tkiid)
  2. throws DataHandlingException
  3. IdWrongFormatException
  4. IdWrongTypeException
  5. NotAuthorizedException
  6. ObjectDoesNotExistException
  7. WrongKindException
  8. WrongStateException
  9. UnexpectedFailureException
  10. CommunicationException
Retrieves the input message of the specified task instance using a string representation of the task instance ID.

The input message can be retrieved in any state of the task instance. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETINPUTMESSAGE.

Parameters:
tkiid - A string representation of the task instance ID. The string is used to identify the task instance for which the input message is to be retrieved.

Returns:
ClientObjectWrapper - The input message. Returns an empty client object wrapper when there is no input message.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

getInputMessage

  1. ClientObjectWrapper getInputMessage( TKIID tkiid)
  2. throws DataHandlingException
  3. IdWrongFormatException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. WrongKindException
  7. WrongStateException
  8. UnexpectedFailureException
  9. CommunicationException
Retrieves the input message of the task instance using the task instance ID.

The input message can be retrieved in any state of the task instance. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETINPUTMESSAGE.

Parameters:
tkiid - The object ID of the task instance whose input message is to be retrieved.

Returns:
ClientObjectWrapper - The input message. Returns an empty client object wrapper when there is no input message.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

getMessageTextOfException

  1. java.lang.String getMessageTextOfException( java.util.Locale locale,
  2. java.lang.String messageKey,
  3. java.lang.Object[] variableValues)
  4. throws ParameterNullException
  5. ObjectDoesNotExistException
  6. UnexpectedFailureException
  7. CommunicationException
Retrieves the message text associated to the specified message key and locale.
Parameters:
locale - The locale to specify the language in which the message text is to be retrieved. If no locale is specified, the default language of the server is used.
messageKey - The message key of the exception.
variableValues - The values of variables to be pasted into the message text, if any.

Returns:
String - The message text.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

getOperationMode

  1. int getOperationMode()
  2. throws CommunicationException
Indicates whether the Human Task Manager database is used as an archive.

If the Human Task Manager database is used as an archive, then only reading methods can be called. All method calls that try to change the archive throw an ArchiveUnsupportedOperationException.

Returns:
int - States whether the Human Task Manager database is used as an archive or not. Refer to OperationMode for more details.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.2.0.3

getOutputMessage

  1. ClientObjectWrapper getOutputMessage( java.lang.String tkiid)
  2. throws DataHandlingException
  3. IdWrongFormatException
  4. IdWrongTypeException
  5. NotAuthorizedException
  6. ObjectDoesNotExistException
  7. WrongKindException
  8. WrongStateException
  9. UnexpectedFailureException
  10. CommunicationException
Retrieves the output message of the specified task instance using a string representation of the ID.

The output message can be retrieved in any state of the task instance. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETOUTPUTMESSAGE.

Parameters:
tkiid - A string representation of the task instance ID that is used to identify the task instance for which the output message is to be retrieved.

Returns:
ClientObjectWrapper - The output message. If the output message has not yet been set, an empty client object wrapper is returned.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

getOutputMessage

  1. ClientObjectWrapper getOutputMessage( TKIID tkiid)
  2. throws DataHandlingException
  3. IdWrongFormatException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. WrongKindException
  7. WrongStateException
  8. UnexpectedFailureException
  9. CommunicationException
Retrieves the output message of the specified task instance using the task instance ID.

The output message can be retrieved in any state of the task instance. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETOUTPUTMESSAGE.

Parameters:
tkiid - The object ID of the task instance whose output message is to be retrieved.

Returns:
ClientObjectWrapper - The output message. If the output message has not yet been set, an empty client object wrapper is returned.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

getStoredQuery

  1. StoredQuery getStoredQuery(java.lang.String storedQueryName)
  2. throws ObjectDoesNotExistException
  3. ParameterNullException
  4. UnexpectedFailureException
  5. CommunicationException
Retrieves the specified stored query definition. If a private stored query exists for the calling user, then the private stored query is returned; otherwise the public stored query with the specified name.
Parameters:
storedQueryName - The name of the stored query to be retrieved - refer to getStoredQueryNames for the retrieval of existing stored query names.

Returns:
StoredQuery - StoredQuery - The definition of the stored query retrieved - refer to StoredQuery to view the stored query definition.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.0.2 Supports private stored queries.

getStoredQuery

  1. StoredQuery getStoredQuery(java.lang.String userID,
  2. java.lang.String storedQueryName)
  3. throws NotAuthorizedException
  4. ObjectDoesNotExistException
  5. ParameterNullException
  6. UnexpectedFailureException
  7. CommunicationException
Retrieves the specified stored query definition for the specified user. You must be a task system administrator to retrieve the private stored query of a different user.
Parameters:
userID - The name of the user who is the owner of the stored query. If no user is specified, a public stored query with the specified name is retrieved.
storedQueryName - The name of the stored query to be retrieved - refer to getStoredQueryNames for the retrieval of existing stored query names.

Returns:
StoredQuery - StoredQuery - The definition of the stored query retrieved - refer to StoredQuery to view the stored query definition.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

getStoredQuery

  1. StoredQuery getStoredQuery(int kind,
  2. java.lang.String storedQueryName)
  3. throws InvalidParameterException
  4. ObjectDoesNotExistException
  5. ParameterNullException
  6. UnexpectedFailureException
  7. CommunicationException
Retrieves the specified private or public stored query definition.
Parameters:
kind - An indicator to specify whether a private or public stored query is to be retrieved.

KIND_PUBLIC states that a public stored query is to be retrieved. KIND_PRIVATE states that a private stored query for the logged-on user is to be retrieved.

storedQueryName - The name of the stored query to be retrieved - refer to getStoredQueryNames for the retrieval of existing stored query names.

Returns:
StoredQuery - StoredQuery - The definition of the stored query retrieved - refer to StoredQuery to view the stored query definition.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

getStoredQueryNames

  1. java.lang.String[] getStoredQueryNames( )
  2. throws WorkItemManagerException
  3. UnexpectedFailureException
  4. CommunicationException
Retrieves the names of stored queries that are persistently stored in the database. Both the names of public and private stored queries are returned.

Refer to createStoredQuery for the creation of stored queries.

Returns:
String[] - String[] - An array of stored query names. If there are no stored queries, an empty array is returned.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.0.2 Supports private stored queries.

getStoredQueryNames

  1. java.lang.String[] getStoredQueryNames( java.lang.String userID)
  2. throws NotAuthorizedException
  3. UnexpectedFailureException
  4. CommunicationException
Retrieves the names of stored queries that are persistently stored in the database for the specified user. Both the names of public and private stored queries are returned. You must be a task system administrator to retrieve informations of a different user.

Refer to createStoredQuery for the creation of stored queries.

Parameters:
userID - The name of the user who is the owner of the private stored queries whose names are to be retrieved together with any public names. A regular user can only specify his own name; a task system administrator can also specify the name of a different user.

Returns:
String[] - String[] - An array of stored query names. If there are no stored queries, an empty array is returned.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

getStoredQueryNames

  1. java.lang.String[] getStoredQueryNames( int kind)
  2. throws InvalidParameterException
  3. UnexpectedFailureException
  4. CommunicationException
Retrieves the names of private or public stored queries that are persistently stored in the database.

Refer to createStoredQuery for the creation of stored queries.

Parameters:
kind - An indicator to specify whether a private or public stored query names are to be retrieved.

KIND_PUBLIC states that names of public stored queries are to be retrieved. KIND_PRIVATE states that names of private stored queries for the logged-on user are to be retrieved.

Returns:
String[] - String[] - An array of stored query names. If there are no stored queries, an empty array is returned.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

getSubTaskIDs

  1. java.util.List getSubTaskIDs(java.lang.String tkiid)
  2. throws IdWrongFormatException
  3. IdWrongTypeException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. UnexpectedFailureException
  7. CommunicationException
Retrieves the object IDs of all task instances that are subtasks of the specified task instance using a string representation of the task instance ID.

The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETTASK.

Parameters:
tkiid - A string representation of the task instance ID that is used to identify the task instance for which the subtask IDs are to be retrieved.

Returns:
List - A list of task instance IDs ( TKIID). Returns an empty list when there are no subtasks.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

getSubTaskIDs

  1. java.util.List getSubTaskIDs(TKIID tkiid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Retrieves the object IDs of all task instances that are subtasks of the specified task instance using the task instance ID.

The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETTASK.

Parameters:
tkiid - The task instance ID that is used to identify the task instance for which the subtask IDs are to be retrieved.

Returns:
List - A list of task instance IDs ( TKIID). Returns an empty list when there are no subtasks.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

getSubstitutes

  1. java.util.List getSubstitutes()
  2. throws StaffServiceCannotAccessVMMException
  3. StaffServiceSubstitutionNotEnabledException
  4. StaffServiceRuntimeException
  5. UserDoesNotExistException
  6. UnexpectedFailureException
  7. CommunicationException
Deprecated. As of version 7.0, replaced by getUserSubstitutionDetail.

Retrieves the substitutes of the logged-on user.
Returns:
List - A list of users that substitute the logged-on user. Returns an empty list when there are no substitutes.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

getSubstitutes

  1. java.util.List getSubstitutes(java.lang.String userID)
  2. throws NotAuthorizedException
  3. ParameterNullException
  4. StaffServiceCannotAccessVMMException
  5. StaffServiceSubstitutionNotEnabledException
  6. StaffServiceRuntimeException
  7. UserDoesNotExistException
  8. UnexpectedFailureException
  9. CommunicationException
Deprecated. As of version 7.0, replaced by getUserSubstitutionDetail.
Retrieves the substitutes of the specified user.

If retrieving the substitutes is not restricted to administrators, then everybody can retrieve the substitutes of any user.

If retrieving the substitutes is restricted to administrators, then only task system monitors or task system administrators can retrieve the substitutes of arbitrary users. A user may, however, always read his/her personal settings.

Parameters:
userID - The name of the user whose substitutes are to be retrieved.

Returns:
List - A list of users that substitute the specified user. Returns an empty list when there are no substitutes.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

getTask

  1. Task getTask(java.lang.String tkiid)
  2. throws IdWrongFormatException
  3. IdWrongTypeException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. UnexpectedFailureException
  7. CommunicationException
Retrieves the specified task instance using a string representation of the task instance ID.

The task instance can be in any state. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETTASK.

Parameters:
tkiid - A string representation of the task instance ID. This is used to identify the task instance to be retrieved.

Returns:
Task - The task instance. Refer to Task to view the task instance properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

getTask

  1. Task getTask(TKIID tkiid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Retrieves the specified task instance using the task instance ID.

The task instance can be in any state. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETTASK.

Parameters:
tkiid - The object ID of the task instance to be retrieved.

Returns:
Task - The task instance. Refer to Task to view the task instance properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

getTaskAndMarkRead

  1. Task getTaskAndMarkRead(java.lang.String tkiid)
  2. throws ApplicationVetoException
  3. ArchiveUnsupportedOperationException
  4. IdWrongFormatException
  5. IdWrongTypeException
  6. NotAuthorizedException
  7. ObjectDoesNotExistException
  8. UnexpectedFailureException
  9. CommunicationException
Retrieves the specified task instance using a string representation of the task instance ID and marks the task as read.

The task instance can be in any state. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETTASK.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID. This is used to identify the task instance to be retrieved.

Returns:
Task - The task instance. Refer to Task to view the task instance properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

Change History

Release Modification
7.0.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

getTaskAndMarkRead

  1. Task getTaskAndMarkRead(TKIID tkiid)
  2. throws ApplicationVetoException
  3. ArchiveUnsupportedOperationException
  4. IdWrongFormatException
  5. NotAuthorizedException
  6. ObjectDoesNotExistException
  7. UnexpectedFailureException
  8. CommunicationException
Retrieves the specified task instance using the task instance ID and marks the task as read.

The task instance can be in any state. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETTASK.

This method is not supported in archive mode.

Parameters:
tkiid - The object ID of the task instance to be retrieved.

Returns:
Task - The task instance. Refer to Task to view the task instance properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

Change History

Release Modification
7.0.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

getTaskHistory

  1. java.util.List getTaskHistory(java.lang.String tkiid)
  2. throws IdWrongFormatException
  3. IdWrongTypeException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. WorkItemManagerException
  7. UnexpectedFailureException
  8. CommunicationException
Retrieves the history events associated to the specified task instance using a string representation of the task instance ID.

The task instance can be in any state. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETTASK.

Parameters:
tkiid - A string representation of the task instance ID. This is used to identify the task instance whose history events are to be retrieved.

Returns:
List - A list of TaskHistoryEvent objects. Returns an empty list when there are no history events.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.5

getTaskHistory

  1. java.util.List getTaskHistory(TKIID tkiid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. WorkItemManagerException
  6. UnexpectedFailureException
  7. CommunicationException
Retrieves the history events associated to the specified task instance using the task instance ID.

The task instance can be in any state. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETTASK.

Parameters:
tkiid - The object ID of the task instance. This is used to identify the task instance whose history events are to be retrieved.

Returns:
List - A list of TaskHistoryEvent objects. Returns an empty list when there are no history events.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.5

getTaskRead

  1. boolean getTaskRead(java.lang.String tkiid)
  2. throws IdWrongFormatException
  3. IdWrongTypeException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. UnexpectedFailureException
  7. CommunicationException
States whether the specified task instance is marked read using a string representation of the task instance ID.

The task instance can be in any state. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETTASK.

Parameters:
tkiid - A string representation of the task instance ID that is used to identify the task instance.

Returns:
boolean - States whether the task is marked read. True states that the task is marked read. False states that the task is not marked read.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

getTaskRead

  1. boolean getTaskRead(TKIID tkiid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
States whether the specified task instance is marked read using the task instance ID.

The task instance can be in any state. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETTASK.

Parameters:
tkiid - The object ID of the task instance that is used to identify the task instance.

Returns:
boolean - States whether the task is marked read. True states that the task is marked read. False states that the task is not marked read.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

getTaskTemplate

  1. TaskTemplate getTaskTemplate(java.lang.String tktid)
  2. throws IdWrongFormatException
  3. IdWrongTypeException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. UnexpectedFailureException
  7. CommunicationException
Retrieves the specified task template using a string representation of the task template ID.

The caller must have at least reader authority for the task template.

The action associated to this method is TaskTemplateActions.GETTEMPLATE.

Parameters:
tktid - A string representation of the object ID of the task template to be retrieved.

Returns:
TaskTemplate - The task template. Refer to TaskTemplate to view the task template properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

getTaskTemplate

  1. TaskTemplate getTaskTemplate(TKTID tktid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Retrieves the specified task template using the task template ID.

The caller must have at least reader authority for the task template.

The action associated to this method is TaskTemplateActions.GETTEMPLATE.

Parameters:
tktid - The object ID of the task template to be retrieved.

Returns:
TaskTemplate - The task template. Refer to TaskTemplate to view the task template properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

getActivityID

  1. AIID getActivityID(java.lang.String tkiid)
  2. throws IdWrongFormatException
  3. IdWrongTypeException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. UnexpectedFailureException
  7. CommunicationException
Retrieves the object ID of the activity instance associated to the specified task instance using a string representation of the task instance ID.

The task instance can be in any state. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETTASK.

Parameters:
tkiid - A string representation of the task instance ID. This is used to identify the task instance.

Returns:
AIID - The object ID of the associated activity instance in a BPEL process. Returns null when there is no associated activity instance, for example, when the task is no inline to-do aka participating task in a BPEL process.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

getActivityID

  1. AIID getActivityID(TKIID tkiid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Retrieves the object ID of the activity instance associated to the specified task instance using the task instance ID.

The task instance can be in any state. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETTASK.

Parameters:
tkiid - The object ID of the task instance.

Returns:
AIID - The object ID of the associated activity instance in a BPEL process. Returns null when there is no associated activity instance, for example, when the task is no inline to-do aka participating task in a BPEL process.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

getProcessID

  1. PIID getProcessID(java.lang.String tkiid)
  2. throws IdWrongFormatException
  3. IdWrongTypeException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. UnexpectedFailureException
  7. CommunicationException
Retrieves the object ID of the BPEL process instance that contains the specified task instance using a string representation of the task instance ID.

The task instance can be in any state. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETTASK.

Parameters:
tkiid - A string representation of the task instance ID. This is used to identify the task instance.

Returns:
PIID - The object ID of the associated BPEL process instance. Returns null when there is no associated process instance, for example, when the task is not an integral part of a process.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

getProcessID

  1. PIID getProcessID(TKIID tkiid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. CommunicationException
Retrieves the object ID of the BPEL process instance that contains the specified task instance using the task instance ID.

The task instance can be in any state. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETTASK.

Parameters:
tkiid - The object ID of the task instance.

Returns:
PIID - The object ID of the associated BPEL process instance. Returns null when there is no associated process instance, for example, when the task is not an integral part of a process.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

getUISettings

  1. CustomClientSettings getUISettings( java.lang.String identifier)
  2. throws IdWrongFormatException
  3. IdWrongTypeException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. WrongKindException
  7. UnexpectedFailureException
  8. CommunicationException
Retrieves client interface settings for the specified task instance or template using a string representation of the object ID.

Client interface settings allow for the specification of presentations that can be used by the caller to present objects and data to an end user.

Client interface settings can be retrieved in any state of the task instance. The caller must have at least reader authority for the task instance or template.

The action associated to this method is TaskActions.GETUISETTINGS or TaskTemplateActions.GETUISETTINGS.

Parameters:
identifier - A string representation of the task instance or template ID.

Returns:
CustomClientSettings - The customized client interface settings. Returns null when there are no client interface settings.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

getUISettings

  1. CustomClientSettings getUISettings( TKTID tktid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. WrongKindException
  7. CommunicationException
Retrieves client interface settings for the specified task template using the task template ID.

Client interface settings allow for the specification of presentations that can be used by the caller to present objects and data to an end user.

The caller must have at least reader authority for the task template.

The action associated to this method is TaskTemplateActions.GETUISETTINGS.

Parameters:
tktid - The object ID of the task template.

Returns:
CustomClientSettings - The customized client interface settings. Returns null when there are no client interface settings.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

getUISettings

  1. CustomClientSettings getUISettings( TKIID tkiid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. UnexpectedFailureException
  6. WrongKindException
  7. CommunicationException
Retrieves client interface settings for the specified task instance using the task instance ID.

Client interface settings allow for the specification of presentations that can be used by the caller to present objects and data to an end user.

Client interface settings can be retrieved in any state of the task instance. The caller must have at least reader authority for the task instance.

The action associated to this method is TaskActions.GETUISETTINGS.

Parameters:
tkiid - The object ID of the task instance.

Returns:
CustomClientSettings - The customized client interface settings. Returns null when there are no client interface settings.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

getUserDetails

  1. java.util.List getUserDetails(java.lang.String[] userIDs,
  2. java.lang.String[] userProperties)
  3. throws ParameterNullException
  4. StaffServiceCannotAccessVMMException
  5. StaffServiceRuntimeException
  6. UnexpectedFailureException
  7. CommunicationException
Retrieves details about the specified users. All properties of type String or IdentifierType from the VMM PersonAccount object can be requested, for example, uid, cn, sn, givenName, or manager. For properties of type IdentifierType, the sub-property uniqueName is returned as a string.

Note that this request does not participate in any global transaction, that is, exceptions do not cause a global transaction rollback.

Parameters:
userIDs - The users that are to be queried.
userProperties - The PersonAccount VMM properties that are to be returned for the specified users. If no user properties are specified, then no properties are returned. It is, however, stated whether the user is defined in the people directory or whether the user is a virtual user.

Returns:
List - A list of UserDetail objects. An object is returned for each user specified even when the user does not exist. In that case, the user is marked as not found in the people directory.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1.2

getUsersInRole

  1. StaffResultSet getUsersInRole(java.lang.String identifier,
  2. int role)
  3. throws IdWrongFormatException
  4. IdWrongTypeException
  5. InvalidAssignmentReasonException
  6. NotAuthorizedException
  7. ObjectDoesNotExistException
  8. WorkItemManagerException
  9. UnexpectedFailureException
  10. CommunicationException
Retrieves the users that are members of the specified role for the specified task instance or template using a string representation of the task instance or template ID.

The action associated to this method is TaskActions.GETROLEINFO or TaskTemplateActions.GETROLEINFO.

Parameters:
identifier - A string representation of task instance or template ID that is used to identify the task instance or template.
role - The role whose members are to be queried. Refer to the work item assignment reasons.

Returns:
StaffResultSet - The users that are members of the specified role. Refer to StaffResultSet for more information.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.0.2 Supports task templates.

getUsersInRole

  1. StaffResultSet getUsersInRole(TKTID tktid,
  2. int role)
  3. throws IdWrongFormatException
  4. InvalidAssignmentReasonException
  5. NotAuthorizedException
  6. ObjectDoesNotExistException
  7. WorkItemManagerException
  8. UnexpectedFailureException
  9. CommunicationException
Retrieves the users that are members of the specified role for the specified task template using the task template ID.

The action associated to this method is TaskTemplateActions.GETROLEINFO.

Parameters:
tktid - The object ID of the task template that is used to identify the task template.
role - The role whose members are to be queried, either an administrator, reader, or potential instance creator. Refer to the work item assignment reasons.

Returns:
StaffResultSet - The users that are members of the specified role. Refer to StaffResultSet for more information.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

getUsersInRole

  1. StaffResultSet getUsersInRole(TKIID tkiid,
  2. int role)
  3. throws IdWrongFormatException
  4. InvalidAssignmentReasonException
  5. NotAuthorizedException
  6. ObjectDoesNotExistException
  7. WorkItemManagerException
  8. UnexpectedFailureException
  9. CommunicationException
Retrieves the users that are members of the specified role for the specified task using the task instance ID.

The action associated to this method is TaskActions.GETROLEINFO.

Parameters:
tkiid - The object ID of the task instance that is used to identify the task instance.
role - The role whose members are to be queried, either an administrator, reader, editor, potential owner, owner, potential starter, starter, originator, or escalation receiver. Refer to the work item assignment reasons.

Returns:
StaffResultSet - The users that are members of the specified role. Refer to StaffResultSet for more information.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

getUserSubstitutionDetail

  1. UserSubstitutionDetail getUserSubstitutionDetail( )
  2. throws NotAuthorizedException
  3. StaffServiceCannotAccessVMMException
  4. StaffServiceSubstitutionNotEnabledException
  5. StaffServiceRuntimeException
  6. UserDoesNotExistException
  7. UnexpectedFailureException
  8. CommunicationException
Retrieves absence and substitution details about the logged-on user.

Returns:
UserSubstitutionDetail - The absence and substitution details of the logged-on user. Refer to UserSubstitutionDetail.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

getUserSubstitutionDetail

  1. UserSubstitutionDetail getUserSubstitutionDetail( java.lang.String userID)
  2. throws NotAuthorizedException
  3. ParameterNullException
  4. StaffServiceCannotAccessVMMException
  5. StaffServiceSubstitutionNotEnabledException
  6. StaffServiceRuntimeException
  7. UserDoesNotExistException
  8. UnexpectedFailureException
  9. CommunicationException
Retrieves absence and substitution details about the specified user.

The caller must be a task system administrator or task system monitor.

Parameters:
userID - The userID that is queried.

Returns:
UserSubstitutionDetail - The absence and substitution details of the specified user. Refer to UserSubstitutionDetail.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

getWorkItems

  1. WorkItem[] getWorkItems(java.lang.String identifier)
  2. throws IdWrongFormatException
  3. IdWrongTypeException
  4. NotAuthorizedException
  5. ObjectDoesNotExistException
  6. WorkItemManagerException
  7. UnexpectedFailureException
  8. CommunicationException
Returns the work item assignments for the logged-on user and the specified task or escalation instance using a string representation of the task or escalation instance ID.

The task or escalation instance can be in any execution state.

Note that a task system administrator is treated like any other user, that is, does only see the personally owned work items.

Parameters:
identifier - The string representation of a task or escalation instance ID. The string is used to identify the object whose work item assignments are to be retrieved.

Returns:
WorkItem[] - An array of work items. If there are no work items, an empty array is returned. Refer to WorkItem to view the work item properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2.1

getWorkItems

  1. WorkItem[] getWorkItems(ESIID esiid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. WorkItemManagerException
  6. UnexpectedFailureException
  7. CommunicationException
Returns the work item assignments for the logged-on user and the specified escalation instance using the escalation instance ID.

The escalation instance can be in any state.

Note that a task system administrator is treated like any other user, that is, does only see the personally owned work items.

Parameters:
esiid - The object ID of the escalation instance. This ID is used to identify the escalation whose work item assignments are to be retrieved.

Returns:
WorkItem[] - An array of work items. If there are no work items, an empty array is returned. Refer to WorkItem to view the work item properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2.1

getWorkItems

  1. WorkItem[] getWorkItems(TKIID tkiid)
  2. throws IdWrongFormatException
  3. NotAuthorizedException
  4. ObjectDoesNotExistException
  5. WorkItemManagerException
  6. UnexpectedFailureException
  7. CommunicationException
Returns the work item assignments for the logged-on user and the specified task instance using the task instance ID.

The task instance can be in any execution state.

Note that a task system administrator is treated like any other user, that is, does only see the personally owned work items.

Parameters:
tkiid - The object ID of the task instance. This ID is used to identify the task whose work item assignments are to be retrieved.

Returns:
WorkItem[] - An array of work items. If there are no work items, an empty array is returned. Refer to WorkItem to view the work item properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2.1

isSystemAdministrator

  1. boolean isSystemAdministrator()
  2. throws CommunicationException
States whether the logged-on user is a system administrator for the Human Task Manager component.

In general, authorization is granted to persons explicitly when a task template is defined or implicitly, for example, when a task is started. Above that, special authority is granted to a person playing the role of a task system administrator. A system administrator has all priviledges.

Returns:
boolean - boolean - True states that the logged-on user is a task system administrator. False states that the logged-on user is no task system administrator.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

isSystemMonitor

  1. boolean isSystemMonitor()
  2. throws CommunicationException
States whether the logged-on user is a task system monitor for the Human Task Manager component.

In general, authorization is granted to persons explicitly when a task template is defined or implicitly, for example, when a task is started. Above that, special authority is granted to a person playing the role of a task system monitor. A task system monitor has the priviledge to read all objects.

Returns:
boolean - boolean - True states that the logged-on user is a task system monitor. False states that the logged-on user is no task system monitor.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

isUserInRole

  1. boolean isUserInRole(java.lang.String identifier,
  2. java.lang.String userID,
  3. int role)
  4. throws IdWrongFormatException
  5. IdWrongTypeException
  6. InvalidAssignmentReasonException
  7. NotAuthorizedException
  8. UserDoesNotExistException
  9. ObjectDoesNotExistException
  10. ParameterNullException
  11. UserRegistryException
  12. WorkItemManagerException
  13. UnexpectedFailureException
  14. CommunicationException
States whether the specified user is a member of the specified role for the specified task instance or template using a string representation of the task instance or template ID.

The action associated to this method is TaskActions.GETROLEINFO or TaskTemplateActions.GETROLEINFO.

Parameters:
identifier - A string representation of task instance or template ID that is used to identify the task instance or template.
userID - The user whose membership in a role is to be queried.

The existence of the user ID is verified but the verification may be executed case insensitively. Verification can be suppressed by setting the 'SupportVirtualUserIdsForPeopleAssignments' custom property of the Human Task Manager configuration to 'true'.

role - The role that the user needs to be a member of. Refer to the work item assignment reasons.

Returns:
boolean - boolean - True states that the user is a member of the specified role. False states that the user is no member of the specified role.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.1 Throws a UserDoesNotExistException when the specified user cannot be found.

isUserInRole

  1. boolean isUserInRole(TKTID tktid,
  2. java.lang.String userID,
  3. int role)
  4. throws IdWrongFormatException
  5. InvalidAssignmentReasonException
  6. NotAuthorizedException
  7. UserDoesNotExistException
  8. ObjectDoesNotExistException
  9. ParameterNullException
  10. UserRegistryException
  11. WorkItemManagerException
  12. UnexpectedFailureException
  13. CommunicationException
States whether the specified user is a member of the specified role for the specified task template using the task template ID.

The action associated to this method is TaskTemplateActions.GETROLEINFO.

Parameters:
tktid - The object ID of the task template that is used to identify the task template.
userID - The user whose membership in a role is to be queried.

The existence of the user ID is verified but the verification may be executed case insensitively. Verification can be suppressed by setting the 'SupportVirtualUserIdsForPeopleAssignments' custom property of the Human Task Manager configuration to 'true'.

role - The role that the user needs to be a member of, either an administrator, reader, or potential instance creator. Refer to the work item assignment reasons.

Returns:
boolean - boolean - True states that the user is a member of the specified role. False states that the user is no member of the specified role.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.1 Throws a UserDoesNotExistException when the specified user cannot be found.

isUserInRole

  1. boolean isUserInRole(TKIID tkiid,
  2. java.lang.String userID,
  3. int role)
  4. throws IdWrongFormatException
  5. InvalidAssignmentReasonException
  6. NotAuthorizedException
  7. UserDoesNotExistException
  8. ObjectDoesNotExistException
  9. ParameterNullException
  10. UserRegistryException
  11. WorkItemManagerException
  12. UnexpectedFailureException
  13. CommunicationException
States whether the specified user is a member of the specified role for the specified task instance using the task instance ID.

The action associated to this method is TaskActions.GETROLEINFO.

Parameters:
tkiid - The object ID of the task instance that is used to identify the task instance.
userID - The user whose membership in a role is to be queried.

The existence of the user ID is verified but the verification may be executed case insensitively. Verification can be suppressed by setting the 'SupportVirtualUserIdsForPeopleAssignments' custom property of the Human Task Manager configuration to 'true'.

role - The role that the user needs to be a member of, either an administrator, reader, editor, potential owner, owner, potential starter, starter, originator, or escalation receiver. Refer to the work item assignment reasons.

Returns:
boolean - boolean - True states that the user is a member of the specified role. False states that the user is no member of the specified role.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.1 Throws a UserDoesNotExistException when the specified user cannot be found.

query

  1. QueryResultSet query(java.lang.String selectClause,
  2. java.lang.String whereClause,
  3. java.lang.String orderByClause,
  4. java.lang.Integer threshold,
  5. java.util.TimeZone timeZone)
  6. throws ParameterNullException
  7. UnexpectedFailureException
  8. WorkItemManagerException
  9. CommunicationException
Retrieves selected object properties persistently stored in the database.

You can specify a filter or a threshold to restrict the number of tuples returned. The tuples are sorted on the server according to the specified sort criteria. Sorting on the server means that the locale of the server is used.

Specify the parameters of the query, the select-, where-, and order-by-clause, using SQL based on the published views. Execution of the query can thus be shifted to SQL and becomes portable and optimizable.

Note, however, when you use a combination of the order-by-clause and threshold parameters, the tuples returned depend on your database system. For example, some database systems order all records and then return the requested number of tuples. Other database systems first take the requested number of tuples and then apply the order criteria.

The domain of the query, that is, the SQL from-clause, is determined automatically. In principle, all properties of objects are selectable for which you own a work item or which can be transitively reached via your work item. As a rule of thumb, all objects except task templates can be reached via work items. This means that you cannot use task template properties only but that you must specify a non task template property in the select- or where-clause.

Note that a task system administrator has special rights and can retrieve information on objects associated to other users. query thus returns the selected properties of all objects for which there are work items to the task systems administrator, no matter whether there is a personally owned work item or another user's work item. If the task system administrator wants to view everything that is stored on the database, independently from the existence of a work item, he/she can use queryAll.

Parameters:
selectClause - Describes the query result, that is, declares a list of names that identify the object properties (columns of the result) to be returned. Its syntax is an SQL select-clause. Aggregation functions like AVG, SUM, MIN, and MAX are not supported. Each comma separated part of the select-clause must specify a property from the published views - see the InfoCenter for details.

To select properties of name-value pairs like custom properties, add a one-digit suffix (0-9) to the view name. For example, "TASK_CPROP1.STRING_VALUE, TASK_CPROP2.STRING_VALUE".

To count the number of potentially qualifying tuples, use the COUNT keyword. For example, to count the number of task instance IDs that satisfy the where-clause, specify a select-clause such as "COUNT(DISTINCT TASK.TKIID)". If you use the more generic "COUNT(*)", then you must specify a where-clause so that the tuples to be counted can be determined. For example, to count all tasks, specify a where-clause such as "TASK.TKIID=TASK.TKIID" that always evaluates to true.

The QueryResultSet contains columns in the same order as specified in the selectClause. If tuples are to be counted, an int value is returned (row 1, column 1).

whereClause - The search condition to be applied to the query domain. Its syntax is an SQL where-clause. The following rules apply:
  • Specify object ID constants as ID('string-rep-of-oid').
  • Specify timestamp constants as TS('yyyy-mm-ddThh:mm:ss') or as CURRENT_DATE for comparisons with the current date.
    The date and time parts of a TS definition are optional; either the date or the time must be specified. If no date part of a TS definition is specified, the current date is taken. Optional time values that are not specified are set to zero. The timestamp is 24 hours based. For example, TS('16:04') is the same as TS('2002-12-24T16:04:00') provided that the current date is December 24th, 2002.
    If a date part of a TS definition is specified, the year must consist of 4 letters; the month and day specifications are optional. Missing month and day specifications are set to 01. For example, specifying TS('2003') is the same as specifying TS('2003-01-01T00:00:00').
  • Specify binary constants as BIN('UTF-8 string').
  • Use constants instead of integer enumerations. For example, instead of specifying a task instance state expression "TASK.STATE=2" , specify "TASK.STATE=TASK.STATE.STATE_READY".
  • Duplicate apostrophes (') in comparising values. For example, "TASK_CPROP.STRING_VALUE='d''automatisation'".
  • To specify a where clause that refers to properties of name-value pairs, like custom properties, add a one-digit suffix (0-9) to the view name.
    For example, to have only tuples returned where a task custom property "prop1" has the value "v1" or where a task custom property "prop2" has the value v2", the where clause can look like "TASK_CPROP1.NAME='prop1' AND TASK_CPROP1.STRING_VALUE='v1' OR TASK_CPROP2.NAME='prop2' AND TASK_CPROP2.STRING_VALUE = 'v2'". For performance reasons, you should not use more than one "OR" construct; use "IN" instead.
    For example, to retrieve the values of custom properties "prop1" and "prop2" of all task instances, the select clause can look like "DISTINCT TASK.TKIID, TASK_CPROP1.STRING_VALUE, TASK_CPROP2.STRING_VALUE" and the where-clause "TASK_CPROP1.NAME = 'prop1' AND TASK_CPROP2.NAME = 'prop2'".

If a filter is not to be applied, null must be specified.

orderByClause - Sorts the query result set by the values of the columns you identify. Its syntax is an SQL order-by-clause. Each comma separated part of the order-by-clause must specify a property from the published views - see the InfoCenter for details.

If you identify more that one property, the query result set is ordered by the values of the first property you identify, then by the values of the second property, and so on.

If sort criteria are not to be applied, null must be specified.

Note that sort criteria are applied on the server, that is, the locale of the server is used for sorting.

threshold - The maximum number of query result set tuples to be returned from the server to the client. If a threshold is not to be applied, null must be specified.
timeZone - The time zone of the timestamp constants in the whereClause respectively the time zone for the timestamp values returned. If a timezone is not specified, UTC is assumed.

Returns:
QueryResultSet - An object containing the query result. If qualifying tuples are not found, an empty query result set is returned. Refer to QueryResultSet for information on how to analyze the query result set.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

query

  1. QueryResultSet query(java.lang.String selectClause,
  2. java.lang.String whereClause,
  3. java.lang.String orderByClause,
  4. java.lang.Integer skipTuples,
  5. java.lang.Integer threshold,
  6. java.util.TimeZone timeZone)
  7. throws ParameterNullException
  8. UnexpectedFailureException
  9. WorkItemManagerException
  10. CommunicationException
Retrieves selected object properties persistently stored in the database and allows for retrieving a specified set of data only.

You can specify a filter, a starting tuple, or a threshold to restrict the number of tuples returned. The tuples are sorted on the server according to the specified sort criteria. Sorting on the server means that the locale of the server is used.

Specify the parameters of the query, the select-, where-, and order-by-clause, using SQL based on the published views. Execution of the query can thus be shifted to SQL and becomes portable and optimizable.

Note, however, when you use a combination of the order-by-clause, threshold, or skipTuples parameters, the tuples returned depend on your database system. For example, some database systems order all records and then return the requested number of tuples. Other database systems first take the requested number of tuples and then apply the order criteria.

The domain of the query, that is, the SQL from-clause, is determined automatically. In principle, all properties of objects are selectable for which you own a work item, or which can be transitively reached via your work item. As a rule of thumb, all objects except task templates can be reached via work items. This means that you cannot use task template properties only but that you must specify a non task template property in the select- or where-clause.

Note that a task system administrator has special rights and can retrieve information on objects associated to other users. query thus returns the selected properties of all objects for which there are work items to the task systems administrator, no matter whether there is a personally owned work item or another user's work item. If the task system administrator wants to view everything that is stored on the database, independently from the existence of a work item, he/she can use queryAll.

Parameters:
selectClause - Describes the query result, that is, declares a list of names that identify the object properties (columns of the result) to be returned. Its syntax is an SQL select-clause. Aggregation functions like AVG, SUM, MIN, and MAX are not supported. Each comma separated part of the select-clause must specify a property from the published views - see the InfoCenter for details.

To select properties of name-value pairs like custom properties, add a one-digit suffix (0-9) to the view name. For example, "TASK_CPROP1.STRING_VALUE, TASK_CPROP2.STRING_VALUE".

To count the number of potentially qualifying tuples, use the COUNT keyword. For example, to count the number of task instance IDs that satisfy the where-clause, specify a select-clause such as "COUNT(DISTINCT TASK.TKIID)". If you use the more generic "COUNT(*)", then you must specify a where-clause so that the tuples to be counted can be determined. For example, to count all tasks, specify a where-clause such as "TASK.TKIID=TASK.TKIID" that always evaluates to true.

The QueryResultSet contains columns in the same order as specified in the selectClause. If tuples are to be counted, an int value is returned (row 1, column 1).

whereClause - The search condition to be applied to the query domain. Its syntax is an SQL where-clause. The following rules apply:
  • Specify object ID constants as ID('string-rep-of-oid').
  • Specify timestamp constants as TS('yyyy-mm-ddThh:mm:ss') or as CURRENT_DATE for comparisons with the current date.
    The date and time parts of a TS definition are optional; either the date or the time must be specified. If no date part of a TS definition is specified, the current date is taken. Optional time values that are not specified are set to zero. The timestamp is 24 hours based. For example, TS('16:04') is the same as TS('2002-12-24T16:04:00') provided that the current date is December 24th, 2002.
    If a date part of a TS definition is specified, the year must consist of 4 letters; the month and day specifications are optional. Missing month and day specifications are set to 01. For example, specifying TS('2003') is the same as specifying TS('2003-01-01T00:00:00').
  • Specify binary constants as BIN('UTF-8 string').
  • Use constants instead of integer enumerations. For example, instead of specifying a task instance state expression "TASK.STATE=2" , specify "TASK.STATE=TASK.STATE.STATE_READY".
  • Duplicate apostrophes (') in comparising values. For example, "TASK_CPROP.STRING_VALUE='d''automatisation'".
  • To specify a where clause that refers to properties of name-value pairs, like custom properties, add a one-digit suffix (0-9) to the view name.
    For example, to have only tuples returned where a task custom property "prop1" has the value "v1" or where a task custom property "prop2" has the value v2", the where clause can look like "TASK_CPROP1.NAME='prop1' AND TASK_CPROP1.STRING_VALUE='v1' OR TASK_CPROP2.NAME='prop2' AND TASK_CPROP2.STRING_VALUE = 'v2'". For performance reasons, you should not use more than one "OR" construct; use "IN" instead.
    For example, to retrieve the values of custom properties "prop1" and "prop2" of all task instances, the select clause can look like "DISTINCT TASK.TKIID, TASK_CPROP1.STRING_VALUE, TASK_CPROP2.STRING_VALUE" and the where-clause "TASK_CPROP1.NAME = 'prop1' AND TASK_CPROP2.NAME = 'prop2'".

If a filter is not to be applied, null must be specified.

orderByClause - Sorts the query result set by the values of the columns you identify. Its syntax is an SQL order-by-clause. Each comma separated part of the order-by-clause must specify a property from the published views - see the InfoCenter for details.

If you identify more that one property, the query result set is ordered by the values of the first property you identify, then by the values of the second property, and so on.

If sort criteria are not to be applied, null must be specified.

Note that sort criteria are applied on the server, that is, the locale of the server is used for sorting.

skipTuples - The number of query result set tuples to be ignored and not to be returned to the caller. For example, a value of '5' means that the first 5 qualifying tuples are not returned. Use this parameter together with the threshold to implement paging in your client application.

If all qualifying tuples are to be returned, null or 0 must be specified.

threshold - The maximum number of query result set tuples to be returned from the server to the client. If a threshold is not to be applied, null must be specified.
timeZone - The time zone of the timestamp constants in the whereClause respectively the time zone for the timestamp values returned. If a timezone is not specified, UTC is assumed.

Returns:
QueryResultSet - An object containing the query result. If qualifying tuples are not found, an empty query result set is returned. Refer to QueryResultSet for information on how to analyze the query result set.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

query

  1. QueryResultSet query(java.lang.String storedQueryName,
  2. java.lang.Integer skipTuples)
  3. throws IdWrongFormatException
  4. ObjectDoesNotExistException
  5. ParameterNullException
  6. QueryCannotJoinException
  7. QueryInvalidOperandException
  8. QueryInvalidTimestampException
  9. QueryUndefinedParameterException
  10. QueryUnknownColumnException
  11. QueryUnknownOperatorException
  12. QueryUnknownTableException
  13. UnexpectedFailureException
  14. CommunicationException
Deprecated. As of version 6.0.2, replaced by query(Sting storedQueryName, Integer skipTuples, List parameters),
Performs the specified stored query and returns the qualifying object properties. If a private stored query with the specified name exists for the calling user, then the private stored query is performed; otherwise the public stored query with the specified name.

Only properties of objects are returned for which the logged-on user has a work item. Note that a task system administrator has special rights and can retrieve information on objects associated to other users. query thus returns the selected properties of all objects for which there are work items to the task systems administrator, no matter whether there is a personally owned work item or another user's work item.

Refer to createStoredQuery for the creation of stored queries.

Parameters:
storedQueryName - The name of the stored query to be executed - refer to getStoredQueryNames for the retrieval of existing stored query names.
skipTuples - The number of query result set tuples to be ignored and not to be returned to the caller. For example, a value of '5' means that the first 5 qualifying tuples are not returned. Use this parameter together with the threshold of the stored query definition to implement paging in your client application.

If all qualifying tuples are to be returned, null or 0 must be specified.

Returns:
QueryResultSet - QueryResultSet - The qualifying object properties. If qualifying objects are not found, an empty query result set is returned. Refer to QueryResultSet for information on how to analyze the query result set.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.0.2 Supports private stored queries.
6.1 Throws a QueryCannotJoinException when views that are used cannot be joined.

query

  1. QueryResultSet query(java.lang.String storedQueryName,
  2. java.lang.Integer skipTuples,
  3. java.util.List parameters)
  4. throws IdWrongFormatException
  5. InvalidStoredQueryParametersException
  6. ObjectDoesNotExistException
  7. ParameterNullException
  8. QueryCannotJoinException
  9. QueryInvalidOperandException
  10. QueryInvalidTimestampException
  11. QueryUndefinedParameterException
  12. QueryUnknownColumnException
  13. QueryUnknownOperatorException
  14. QueryUnknownTableException
  15. UnexpectedFailureException
  16. CommunicationException
Performs the specified stored query, specifies values for the parameters in the where-clause, and returns the qualifying object properties. If a private stored query with the specified name exists for the calling user, then the private stored query is performed; otherwise the public stored query with the specified name.

Only properties of objects are returned for which the logged-on user has a work item. Note that a task system administrator has special rights and can retrieve information on objects associated to other users. query thus returns the selected properties of all objects for which there are work items to the task systems administrator, no matter whether there is a personally owned work item or another user's work item.

Refer to createStoredQuery for the creation of stored queries.

Parameters:
storedQueryName - The name of the stored query to be executed - refer to getStoredQueryNames for the retrieval of existing stored query names.
skipTuples - The number of query result set tuples to be ignored and not to be returned to the caller. For example, a value of '5' means that the first 5 qualifying tuples are not returned. Use this parameter together with the threshold of the stored query definition to implement paging in your client application.

If all qualifying tuples are to be returned, null or 0 must be specified.

parameters - A list of string values to replace parameters in the where-clause. There must be a value for each parameter in the where-clause. The first string replaces all occurrences of @param1, the second string replaces all occurrences of @param2, and so on.

Returns:
QueryResultSet - QueryResultSet - The qualifying object properties. If qualifying objects are not found, an empty query result set is returned. Refer to QueryResultSet for information on how to analyze the query result set.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.1 Throws a QueryCannotJoinException when views that are used cannot be joined.

query

  1. QueryResultSet query(java.lang.String storedQueryName,
  2. java.lang.Integer skipTuples,
  3. java.lang.Integer threshold)
  4. throws IdWrongFormatException
  5. ObjectDoesNotExistException
  6. ParameterNullException
  7. QueryCannotJoinException
  8. QueryInvalidOperandException
  9. QueryInvalidTimestampException
  10. QueryUndefinedParameterException
  11. QueryUnknownColumnException
  12. QueryUnknownOperatorException
  13. QueryUnknownTableException
  14. UnexpectedFailureException
  15. CommunicationException
Performs the specified stored query and returns the properties of objects in the specified range. If a private stored query with the specified name exists for the calling user, then the private stored query is performed; otherwise the public stored query with the specified name.

Only properties of objects are returned for which the logged-on user has a work item. Note that a task system administrator has special rights and can retrieve information on objects associated to other users. query thus returns the selected properties of all objects for which there are work items to the task systems administrator, no matter whether there is a personally owned work item or another user's work item.

Refer to createStoredQuery for the creation of stored queries.

Parameters:
storedQueryName - The name of the stored query to be executed - refer to getStoredQueryNames for the retrieval of existing stored query names.
skipTuples - The number of query result set tuples to be ignored and not to be returned to the caller. For example, a value of '5' means that the first 5 qualifying tuples are not returned. Use this parameter together with the threshold to implement paging in your client application.

If all qualifying tuples are to be returned, null or 0 must be specified.

threshold - The maximum number of result set tuples to be returned from the server to the client. If the threshold is to be taken from the stored query definition, specify null or use the query method that does not request a threshold parameter.

Returns:
QueryResultSet - QueryResultSet - The qualifying object properties. If qualifying objects are not found, an empty query result set is returned. Refer to QueryResultSet for information on how to analyze the query result set.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.1

Change History

Release Modification
6.0.2 Supports private stored queries.
6.1 Throws a QueryCannotJoinException when views that are used cannot be joined.

query

  1. QueryResultSet query(java.lang.String storedQueryName,
  2. java.lang.Integer skipTuples,
  3. java.lang.Integer threshold,
  4. java.util.List parameters)
  5. throws IdWrongFormatException
  6. InvalidStoredQueryParametersException
  7. ObjectDoesNotExistException
  8. ParameterNullException
  9. QueryCannotJoinException
  10. QueryInvalidOperandException
  11. QueryInvalidTimestampException
  12. QueryUndefinedParameterException
  13. QueryUnknownColumnException
  14. QueryUnknownOperatorException
  15. QueryUnknownTableException
  16. UnexpectedFailureException
  17. CommunicationException
Performs the specified stored query and specifies values for parameters in the where-clause.

If a private stored query with the specified name exists for the calling user, then the private stored query is performed; otherwise the public stored query with the specified name.

Only properties of objects are returned for which the logged-on user has a work item. Note that a task system administrator has special rights and can retrieve information on objects associated to other users. query thus returns the selected properties of all objects for which there are work items to the task systems administrator, no matter whether there is a personally owned work item or another user's work item.

Refer to createStoredQuery for the creation of stored queries.

Parameters:
storedQueryName - The name of the stored query to be executed - refer to getStoredQueryNames for the retrieval of existing stored query names.
skipTuples - The number of query result set tuples to be ignored and not to be returned to the caller. For example, a value of '5' means that the first 5 qualifying tuples are not returned. Use this parameter together with the threshold to implement paging in your client application.

If all qualifying tuples are to be returned, null or 0 must be specified.

threshold - The maximum number of result set tuples to be returned from the server to the client. If the threshold is to be taken from the stored query definition, specify null or use the query method that does not request a threshold parameter.
parameters - A list of string values to replace parameters in the where-clause. There must be a value for each parameter in the where-clause. The first string replaces all occurrences of @param1, the second string replaces all occurrences of @param2, and so on.

Returns:
QueryResultSet - QueryResultSet - The qualifying object properties. If qualifying objects are not found, an empty query result set is returned. Refer to QueryResultSet for information on how to analyze the query result set.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.1 Throws a QueryCannotJoinException when views that are used cannot be joined.

query

  1. QueryResultSet query(java.lang.String userID,
  2. java.lang.String storedQueryName,
  3. java.lang.Integer skipTuples,
  4. java.lang.Integer threshold,
  5. java.util.List parameters)
  6. throws IdWrongFormatException
  7. InvalidStoredQueryParametersException
  8. NotAuthorizedException
  9. ObjectDoesNotExistException
  10. ParameterNullException
  11. QueryCannotJoinException
  12. QueryInvalidOperandException
  13. QueryInvalidTimestampException
  14. QueryUndefinedParameterException
  15. QueryUnknownColumnException
  16. QueryUnknownOperatorException
  17. QueryUnknownTableException
  18. UnexpectedFailureException
  19. CommunicationException
Performs the specified private stored query of the specified user.

Only properties of objects are returned for which the logged-on user has a work item. Note that a task system administrator has special rights and can retrieve information on objects associated to other users. query thus returns the selected properties of all objects for which there are work items to the task systems administrator, no matter whether there is a personally owned work item or another user's work item.

Refer to createStoredQuery for the creation of stored queries.

Parameters:
userID - The name of the user who is the owner of the stored query.
storedQueryName - The name of the stored query to be executed - refer to getStoredQueryNames for the retrieval of existing stored query names.
skipTuples - The number of query result set tuples to be ignored and not to be returned to the caller. For example, a value of '5' means that the first 5 qualifying tuples are not returned. Use this parameter together with the threshold to implement paging in your client application.

If all qualifying tuples are to be returned, null or 0 must be specified.

threshold - The maximum number of result set tuples to be returned from the server to the client. If the threshold is to be taken from the stored query definition, specify null or use the query method that does not request a threshold parameter.
parameters - A list of string values to replace parameters in the where-clause. There must be a value for each parameter in the where-clause. The first string replaces all occurrences of @param1, the second string replaces all occurrences of @param2, and so on.

Returns:
QueryResultSet - QueryResultSet - The qualifying object properties. If qualifying objects are not found, an empty query result set is returned. Refer to QueryResultSet for information on how to analyze the query result set.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.1 Throws a QueryCannotJoinException when views that are used cannot be joined.

query

  1. QueryResultSet query(int kind,
  2. java.lang.String storedQueryName,
  3. java.lang.Integer skipTuples,
  4. java.lang.Integer threshold,
  5. java.util.List parameters)
  6. throws IdWrongFormatException
  7. InvalidParameterException
  8. InvalidStoredQueryParametersException
  9. ObjectDoesNotExistException
  10. ParameterNullException
  11. QueryCannotJoinException
  12. QueryInvalidOperandException
  13. QueryInvalidTimestampException
  14. QueryUndefinedParameterException
  15. QueryUnknownColumnException
  16. QueryUnknownOperatorException
  17. QueryUnknownTableException
  18. UnexpectedFailureException
  19. CommunicationException
Performs the specified public or private stored query.

Only properties of objects are returned for which the logged-on user has a work item. Note that a task system administrator has special rights and can retrieve information on objects associated to other users. query thus returns the selected properties of all objects for which there are work items to the task systems administrator, no matter whether there is a personally owned work item or another user's work item.

Refer to createStoredQuery for the creation of stored queries.

Parameters:
kind - An indicator to specify whether a private or public stored query is to be used.

KIND_PUBLIC states that a public stored query is to be used. KIND_PRIVATE states that a private stored query for the logged-on user is to be used.

storedQueryName - The name of the stored query to be executed - refer to getStoredQueryNames for the retrieval of existing stored query names.
skipTuples - The number of query result set tuples to be ignored and not to be returned to the caller. For example, a value of '5' means that the first 5 qualifying tuples are not returned. Use this parameter together with the threshold to implement paging in your client application.

If all qualifying tuples are to be returned, null or 0 must be specified.

threshold - The maximum number of result set tuples to be returned from the server to the client. If the threshold is to be taken from the stored query definition, specify null or use the query method that does not request a threshold parameter.
parameters - A list of string values to replace parameters in the where-clause. There must be a value for each parameter in the where-clause. The first string replaces all occurrences of @param1, the second string replaces all occurrences of @param2, and so on.

Returns:
QueryResultSet - QueryResultSet - The qualifying object properties. If qualifying objects are not found, an empty query result set is returned. Refer to QueryResultSet for information on how to analyze the query result set.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.1 Throws a QueryCannotJoinException when views that are used cannot be joined.

queryAll

  1. QueryResultSet queryAll(java.lang.String selectClause,
  2. java.lang.String whereClause,
  3. java.lang.String orderByClause,
  4. java.lang.Integer skipTuples,
  5. java.lang.Integer threshold,
  6. java.util.TimeZone timeZone)
  7. throws NotAuthorizedException
  8. ParameterNullException
  9. UnexpectedFailureException
  10. WorkItemManagerException
  11. CommunicationException
Retrieves selected object properties of all objects persistently stored in the database and allows for retrieving a specified set of data only.

You can specify a filter, a starting tuple, or a threshold to restrict the number of tuples returned. The tuples are sorted on the server according to the specified sort criteria. Sorting on the server means that the locale of the server is used.

Specify the parameters of the query, the select-, where-, and order-by-clause, using SQL based on the published views. Execution of the query can thus be shifted to SQL and becomes portable and optimizable.

Note, however, when you use a combination of the order-by-clause, threshold, or skipTuples parameters, the tuples returned depend on your database system. For example, some database systems order all records and then return the requested number of tuples. Other database systems first take the requested number of tuples and then apply the order criteria.

The domain of the query, that is, the SQL from-clause, is determined automatically.

The caller must be a task system administrator or monitor.

Parameters:
selectClause - Describes the query result, that is, represents a list of names that identify the object properties (columns of the result) to be returned. Its syntax is an SQL select-clause. Aggregation functions like AVG, SUM, MIN, and MAX are not supported. Each comma separated part of the select-clause must specify a property from the published views - see the InfoCenter for details.

To select properties of name-value pairs like custom properties, add a one-digit suffix (0-9) to the view name. For example, "TASK_CPROP1.STRING_VALUE, TASK_CPROP2.STRING_VALUE".

To count the number of potentially qualifying tuples, use the COUNT keyword. For example, to count the number of task instance IDs that satisfy the where-clause, specify a select-clause such as "COUNT(DISTINCT TASK.TKIID)". If you use the more generic "COUNT(*)", then you must specify a where-clause so that the tuples to be counted can be determined. For example, to count all tasks, specify a where-clause such as "TASK.TKIID=TASK.TKIID" that always evaluates to true.

The QueryResultSet contains columns in the same order as specified in the selectClause. If tuples are to be counted, an int value is returned (row 1, column 1).

whereClause - The search condition to be applied to the query domain. Its syntax is an SQL where-clause. The following rules apply:
  • Specify object ID constants as ID('string-rep-of-oid').
  • Specify timestamp constants as TS('yyyy-mm-ddThh:mm:ss') or as CURRENT_DATE for comparisons with the current date.
    The date and time parts of a TS definition are optional; either the date or the time must be specified. If no date part of a TS definition is specified, the current date is taken. Optional time values that are not specified are set to zero. The timestamp is 24 hours based. For example, TS('16:04') is the same as TS('2002-12-24T16:04:00') provided that the current date is December 24th, 2002.
    If a date part of a TS definition is specified, the year must consist of 4 letters; the month and day specifications are optional. Missing month and day specifications are set to 01. For example, specifying TS('2003') is the same as specifying TS('2003-01-01T00:00:00').
  • Specify binary constants as BIN('UTF-8 string').
  • Use constants instead of integer enumerations. For example, instead of specifying a task instance state expression "TASK.STATE=2" , specify "TASK.STATE=TASK.STATE.STATE_READY".
  • Duplicate apostrophes (') in comparising values. For example, "TASK_CPROP.STRING_VALUE='d''automatisation'".
  • To specify a where clause that refers to properties of name-value pairs, like custom properties, add a one-digit suffix (0-9) to the view name.
    For example, to have only tuples returned where a task custom property "prop1" has the value "v1" or where a task custom property "prop2" has the value v2", the where clause can look like "TASK_CPROP1.NAME='prop1' AND TASK_CPROP1.STRING_VALUE='v1' OR TASK_CPROP2.NAME='prop2' AND TASK_CPROP2.STRING_VALUE = 'v2'". For performance reasons, you should not use more than one "OR" construct; use "IN" instead.
    For example, to retrieve the values of custom properties "prop1" and "prop2" of all task instances, the select clause can look like "DISTINCT TASK.TKIID, TASK_CPROP1.STRING_VALUE, TASK_CPROP2.STRING_VALUE" and the where-clause "TASK_CPROP1.NAME = 'prop1' AND TASK_CPROP2.NAME = 'prop2'".

If a filter is not to be applied, null must be specified.

orderByClause - Sorts the query result set by the values of the columns you identify. Its syntax is an SQL order-by-clause. Each comma separated part of the order-by-clause must specify a property from the published views - see the InfoCenter for details.

If you identify more that one property, the query result set is ordered by the values of the first property you identify, then by the values of the second property, and so on.

If sort criteria are not to be applied, null must be specified.

Note that sort criteria are applied on the server, that is, the locale of the server is used for sorting.

skipTuples - The number of query result set tuples to be ignored and not to be returned to the caller. For example, a value of '5' means that the first 5 qualifying tuples are not returned. Use this parameter together with the threshold to implement paging in your client application.

If all qualifying tuples are to be returned, null or 0 must be specified.

threshold - The maximum number of query result set tuples to be returned. If a threshold is not to be applied, null must be specified.
timeZone - The time zone of the timestamp constants in the whereClause respectively the time zone for the timestamp values returned. If a timezone is not specified, UTC is assumed.

Returns:
QueryResultSet - An object containing the query result. If qualifying tuples are not found, an empty query result set is returned. Refer to QueryResultSet for information on how to analyze the query result set.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

queryTaskTemplates

  1. TaskTemplate[] queryTaskTemplates( java.lang.String whereClause,
  2. java.lang.String orderByClause,
  3. java.lang.Integer threshold,
  4. java.util.TimeZone timeZone)
  5. throws IdWrongFormatException
  6. QueryCannotJoinException
  7. QueryInvalidOperandException
  8. QueryInvalidTimestampException
  9. QueryUndefinedParameterException
  10. QueryUnknownColumnException
  11. QueryUnknownOperatorException
  12. QueryUnknownTableException
  13. UnexpectedFailureException
  14. CommunicationException
Retrieves task templates that are persistently stored in the database. If the HumanTaskManager is running in archive mode, then all qualifying task templates are returned. If the HumanTaskManager is not running in archive mode, then qualifying task templates that are part of started applications are returned.

You can specify a threshold or filter to restrict the number of task templates returned. If the number of task templates is not restricted, all task templates that qualify are returned. Note that all versions of a task template are returned unless you filter for their valid-from times. The task templates are sorted on the server according to the specified sort criteria. Sorting on the server means that the locale of the server is used.

The parameters of the query, the where- and order-by-clause, are specified using SQL based on the TASK_TEMPLATE view. Execution of the query can thus be shifted to SQL and becomes portable and customizable.

Note, however, when you use a combination of the order-by-clause and threshold parameters, the tuples returned depend on your database system. For example, some database systems order all records and then return the requested number of tuples. Other database systems first take the requested number of tuples and then apply the order criteria.

Parameters:
whereClause - The search condition to be applied to the set of available task templates. Its syntax is an SQL where-clause. The following rules apply:
  • Specify object ID constants as ID('string-rep-of-oid').
  • Specify timestamp constants as TS('yyyy-mm-ddThh:mm:ss') or as CURRENT_DATE for comparisons with the current date.
    The date and time parts of a TS definition are optional; either the date or the time must be specified. If no date part of a TS definition is specified, the current date is taken. Optional time values that are not specified are set to zero. The timestamp is 24 hours based. For example, TS('16:04') is the same as TS('2002-12-24T16:04:00') provided that the current date is December 24th, 2002.
    If a date part of a TS definition is specified, the year must consist of 4 letters; the month and day specifications are optional. Missing month and day specifications are set to 01. For example, specifying TS('2003') is the same as specifying TS('2003-01-01T00:00:00').
  • Specify binary constants as BIN('UTF-8 string').
  • Use constants instead of integer enumerations. For example, instead of specifying a task tempalte state expression "TASK_TEMPL.STATE=2" , specify "TASK_TEMPL.STATE=TASK_TEMPL.STATE.STATE_STOPPED".
  • Duplicate apostrophes (') in comparising values. For example, "TASK_CPROP.STRING_VALUE='d''automatisation'".

If a filter is not to be applied, null must be specified.

orderByClause - Sorts the qualifying task templates by the values of the columns you identify. Its syntax is an SQL order-by-clause. Each comma separated part of the order-by-clause must specify a property from the TASK_TEMPL view - see the InfoCenter for details.

If you identify more that one property, the task templates are ordered by the values of the first property you identify, then by the values of the second property, and so on.

If sort criteria are not to be applied, null must be specified.

Note that sort criteria are applied on the server, that is, the locale of the server is used for sorting.

threshold - The maximum number of task templates to be returned. If a threshold is not to be applied, null must be specified.
timeZone - The time zone of the timestamp constants in the whereClause respectively the time zone for the timestamp values returned. If a timezone is not specified, UTC is assumed.

Returns:
TaskTemplate[] - An array of qualifying task templates. If no templates qualify, an empty array is returned. Refer to TaskTemplate to view the task template properties.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.1 Throws a QueryCannotJoinException when views that are used cannot be joined.

resolveStaffQuery

  1. StaffResultSet resolveStaffQuery( java.lang.String parameterizedPeopleAssignmentCriteria,
  2. java.lang.String jndiNameOfStaffPluginProvider,
  3. int substitutionPolicy,
  4. java.util.Map contextVariables)
  5. throws InvalidParameterException
  6. ParameterNullException
  7. StaffServiceRuntimeException
  8. UnexpectedFailureException
  9. CommunicationException
Tentatively resolves the specified people assignment criteria and returns the qualifying users or groups.

Note that any exception thrown does not cause a database rollback because a database update is not involved in this call.

Parameters:
parameterizedPeopleAssignmentCriteria - The parameterized people assignment criteria to be resolved. These are the criteria as specified in the TEL.
jndiNameOfStaffPluginProvider - The JNDI name of the people directory configuration to be used.
substitutionPolicy - The substitution policy to be applied. Refer to SubstitutionPolicy for valid specifications. Note that a substitution policy can only be applied if the Virtual Memory Management (VMM) people directory configuration is used.
contextVariables - An optional map of context variable names and their values. Context variables allow for context-sensitive queries so that even static people assignment queries show dynamic behavior. Context variable names are, for example, wf:process.starter or wf:process.administrators.

The value of a context variable is a string or an array of strings. Note that there can only be a single array with more than one value.

Returns:
StaffResultSet - The users that qualify when the specified people assignment criteria are resolved. Refer to StaffResultSet for more information.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

restart

  1. void restart(java.lang.String tkiid,
  2. ClientObjectWrapper input,
  3. boolean keepResultMessages)
  4. throws AdministratorCannotBeResolvedException
  5. ApplicationVetoException
  6. ArchiveUnsupportedOperationException
  7. CannotCreateWorkItemException
  8. IdWrongFormatException
  9. IdWrongTypeException
  10. InvalidApplicationStateException
  11. InvalidLengthException
  12. NotAuthorizedException
  13. UserDoesNotExistException
  14. ObjectDoesNotExistException
  15. ParallelRoutingTaskException
  16. SCAServiceAccessFailureException
  17. SCAServiceResultErrorException
  18. SchedulingFailedException
  19. WrongKindException
  20. WrongMessageTypeException
  21. WrongStateException
  22. UnexpectedFailureException
  23. CommunicationException
Restarts the specified task instance using a string representation of the task instance ID.

The task instance can be a collaboration, invocation, or to-do task. The task instance can be in any state but inactive. Additionally,

  • An invocation task cannot be in the running state.
  • A to-do task cannot be in an end state, that is, cannot be finished, failed, terminated, or expired. If the to-do task is forwarded, then the follow-on task cannot be in an end state.
  • An inline to-do task cannot be in the ready or running state.

The task instance can be escalated, suspended, or waiting for subtasks. The caller must be the originator or an administrator of the task instance.

Note that collaboration, invocation, and to-do tasks are also known as human, originating, and participating tasks.

Restarting the task instance causes staff resolution to be newly performed and all timers to be reset. If you used the update method to change timer durations, then timers are set up according to these values. If you used the update method to explicitely set a scheduler time, then the corresponding durations are not calculated. Timers are not set up. For inline to-do tasks, expiration is not recalculated.

Any subtasks or follow-on tasks are deleted. Any escalations are cancelled and reset into the inactive state.

For invocation tasks, the logged-on user becomes the starter of the restarted task instance.

The action associated to this method is TaskActions.RESTARTTASK.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID that is used to identify the task instance.
input - The input message. If no input message is provided, the original input message is used. Note that, for inline to-do tasks, the input message is not synchronized with the Business Flow Manager staff activity.

The object wrapped by the ClientObjectWrapper must be serializable.

keepResultMessages - Specifies whether output or fault messages are to be kept. True states that any output or fault message set is to be kept. False states that any output or fault message set is to be deleted.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when starting of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

restart

  1. void restart(TKIID tkiid,
  2. ClientObjectWrapper input,
  3. boolean keepResultMessages)
  4. throws AdministratorCannotBeResolvedException
  5. ApplicationVetoException
  6. ArchiveUnsupportedOperationException
  7. CannotCreateWorkItemException
  8. IdWrongFormatException
  9. InvalidApplicationStateException
  10. InvalidLengthException
  11. NotAuthorizedException
  12. UserDoesNotExistException
  13. ObjectDoesNotExistException
  14. ParallelRoutingTaskException
  15. SCAServiceAccessFailureException
  16. SCAServiceResultErrorException
  17. SchedulingFailedException
  18. WrongKindException
  19. WrongMessageTypeException
  20. WrongStateException
  21. UnexpectedFailureException
  22. CommunicationException
Restarts the specified task instance using the task instance ID.

The task instance can be a collaboration, invocation, or to-do task. The task instance can be in any state but inactive. Additionally,

  • An invocation task cannot be in the running state.
  • A to-do task cannot be in an end state, that is, cannot be finished, failed, terminated, or expired. If the to-do task is forwarded, then the follow-on task cannot be in an end state.
  • An inline to-do task cannot be in the ready or running state.

The task instance can be escalated, suspended, or waiting for subtasks. The caller must be the originator or an administrator of the task instance.

Note that collaboration, invocation, and to-do tasks are also known as human, originating, and participating tasks.

Restarting the task instance causes staff resolution to be newly performed and all timers to be reset. If you used the update method to change timer durations, then timers are set up according to these values. If you used the update method to explicitely set a scheduler time, then the corresponding durations are not calculated. Timers are not set up. For inline to-do tasks, expiration is not recalculated.

Any subtasks or follow-on tasks are deleted. Any escalations are cancelled and reset into the inactive state.

For invocation tasks, the logged-on user becomes the starter of the restarted task instance.

The action associated to this method is TaskActions.RESTARTTASK.

This method is not supported in archive mode.

Parameters:
tkiid - The task instance ID that is used to identify the task instance.
input - The input message. If no input message is provided, the original input message is used. Note that, for inline to-do tasks, the input message is not synchronized with the Business Flow Manager staff activity.

The object wrapped by the ClientObjectWrapper must be serializable.

keepResultMessages - Specifies whether output or fault messages are to be kept. True states that any output or fault message set is to be kept. False states that any output or fault message set is to be deleted.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when starting of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

resume

  1. void resume(java.lang.String tkiid)
  2. throws ApplicationVetoException
  3. ArchiveUnsupportedOperationException
  4. IdWrongFormatException
  5. IdWrongTypeException
  6. NotAuthorizedException
  7. ObjectDoesNotExistException
  8. WrongKindException
  9. WrongStateException
  10. UnexpectedFailureException
  11. CommunicationException
Resumes the execution of the specified suspended collaboration or to-do task instance using a string representation of the task instance ID. Collaboration and to-do task instances are also known as human and participating task instances.

The suspended task instance can be in the ready or claimed state. It can be escalated or waiting for subtasks. The caller can be the owner, originator, or administrator of the task instance.

The action associated to this method is TaskActions.RESUME.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID to be resumed.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

resume

  1. void resume(TKIID tkiid)
  2. throws ApplicationVetoException
  3. ArchiveUnsupportedOperationException
  4. IdWrongFormatException
  5. NotAuthorizedException
  6. ObjectDoesNotExistException
  7. WrongKindException
  8. WrongStateException
  9. UnexpectedFailureException
  10. CommunicationException
Resumes the execution of the specified suspended collaboration or to-do task instance using the task instance ID. Collaboration and to-do task instances are also known as human and participating task instances.

The suspended task instance can be in the ready or claimed state. It can be escalated or waiting for subtasks. The caller can be the owner, originator, or administrator of the task instance.

The action associated to this method is TaskActions.RESUME.

This method is not supported in archive mode.

Parameters:
tkiid - The object ID of the task instance to be resumed.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

searchGroupDetails

  1. java.util.List searchGroupDetails( java.lang.String searchCondition,
  2. java.lang.String[] groupProperties,
  3. java.lang.String[] userProperties,
  4. java.lang.String[] subGroupProperties,
  5. java.lang.Integer threshold)
  6. throws ParameterNullException
  7. StaffServiceCannotAccessVMMException
  8. StaffServiceRuntimeException
  9. UnexpectedFailureException
  10. CommunicationException
Returns details about the groups searched for. All properties of type String from the VMM Group object can be requested, for example, displayName or description.

Note that this request does not participate in any global transaction, that is, exceptions do not cause a global transaction rollback.

Parameters:
searchCondition - The groups that are to be searched for.

The group names are specified as part of a VMM search expression "//entities[@xsi:type='Group' and ( searchCondition )]". For example, If you specify a search condition "cn='a*'", the following VMM search expression is build and executed: "//entities[@xsi:type='Group' and (cn='a*')]".

groupProperties - The Group VMM properties that are to be returned for the groups found. The "members" property is ignored, if specified. If no group properties are specified, then no properties are returned. The name of the group is, however, returned.
userProperties - The PersonAccount VMM properties that are to be returned for the users directly contained in the group. If not specified, an empty list of user details is returned.
subGroupProperties - The Group VMM properties that are to be returned for the subgroups directly contained in the group. If not specified, an empty list of group details is returned. Note that the "members" property is ignored, if specified.
threshold - The maximum number of group, user, and subgroup objects to be returned from the server to the client. If a threshold is not to be applied, null must be specified.

Group details are determined depth-first. This means that the last group returned may not be complete if a threshold is applied.

Returns:
List - A list of GroupDetail objects. Returns an empty list when there are no groups that fulfil the search condition.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1.2

searchUserDetails

  1. java.util.List searchUserDetails( java.lang.String searchCondition,
  2. java.lang.String[] userProperties,
  3. java.lang.Integer threshold)
  4. throws ParameterNullException
  5. StaffServiceCannotAccessVMMException
  6. StaffServiceRuntimeException
  7. UnexpectedFailureException
  8. CommunicationException
Returns details about the users searched for. All properties of type String or IdentifierType from the VMM PersonAccount object can be requested, for example, uid, cn, sn, givenName, or manager. For properties of type IdentifierType, the sub-property uniqueName is returned as a string.

Note that this request does not participate in any global transaction, that is, exceptions do not cause a global transaction rollback.

Parameters:
searchCondition - The users that are to be searched for.

The users are specified as part of a VMM search expression "//entities[@xsi:type='PersonAccount' and ( searchCondition )]". For example, If you specify a search condition "uid='a*'", the following VMM search expression is build and executed: "//entities[@xsi:type='PersonAccount' and (uid='a*')]".

userProperties - The PersonAccount VMM properties that are to be returned for the users found. If no user properties are specified, then no properties are returned. The name of the user is, however, returned.
threshold - The maximum number of UserDetail objects to be returned from the server to the client. If a threshold is not to be applied, null must be specified.

Returns:
List - A list of UserDetail objects. Returns an empty list when there are no users that fulfil the search condition.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1.2

setAbsence

  1. void setAbsence(boolean absence)
  2. throws ArchiveUnsupportedOperationException
  3. StaffServiceCannotAccessVMMException
  4. StaffServiceSubstitutionNotEnabledException
  5. StaffServiceRuntimeException
  6. UserDoesNotExistException
  7. UnexpectedFailureException
  8. CommunicationException
Deprecated. As of version 7.0, replaced by setUserSubstitutionDetail.
Sets the absence information of the logged-on user to the specified value. Absent users do not receive any work items but a substitute receives the work item instead.

This method is not supported in archive mode.

Parameters:
absence - Specifies the absence setting of the logged-on user. True states that the specified user is absent. False states that the specified user is not absent.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

setAbsence

  1. void setAbsence(java.lang.String userID,
  2. boolean absence)
  3. throws ArchiveUnsupportedOperationException
  4. NotAuthorizedException
  5. ParameterNullException
  6. StaffServiceCannotAccessVMMException
  7. StaffServiceSubstitutionNotEnabledException
  8. StaffServiceRuntimeException
  9. UserDoesNotExistException
  10. UnexpectedFailureException
  11. CommunicationException
Deprecated. As of version 7.0, replaced by setUserSubstitutionDetail.
Sets the absence information of the specified user to the specified value. Absent users do not receive any work items but a substitute receives the work item instead.

If setting the absence is not restricted to administrators, then everybody can set the absence flag of any user.

If setting the absence is restricted to administrators, then only the task system administrators can set the absence flag of arbitrary users. A user may, however, always set his/her absence.

This method is not supported in archive mode.

Parameters:
userID - The name of the user whose absence setting is to be set.
absence - States the absence setting of the specified user. True states that the specified user is absent. False states that the specified user is not absent.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

setCustomProperty

  1. void setCustomProperty(java.lang.String identifier,
  2. java.lang.String propertyName,
  3. java.lang.String propertyValue)
  4. throws ApplicationVetoException
  5. ArchiveUnsupportedOperationException
  6. IdWrongFormatException
  7. IdWrongTypeException
  8. InvalidLengthException
  9. NotAuthorizedException
  10. ObjectDoesNotExistException
  11. ParameterNullException
  12. WrongKindException
  13. UnexpectedFailureException
  14. CommunicationException
Stores custom-specific values for the specified task or escalation instance using a string representation of the object ID.

Custom properties allow a user to add additional properties to tasks or escalations beyond those provided and managed by the task manager.

A custom property has a name and a value of type string.

Custom properties can be provided in any state of the task or escalation instance. The parent application may, however, reject to set a property. The caller must be the originator, owner, starter, editor, or administrator of the task instance or must be the escalation receiver or administrator of the escalation instance.

The action associated to this method is TaskActions.SETCUSTOMPROPERTY or EscalationActions.SETCUSTOMPROPERTY.

This method is not supported in archive mode.

Parameters:
identifier - A string representation of the task or escalation instance ID that is used to identify the task or escalation instance.
propertyName - The name of the custom property to be set. The name must not be greater than 220 bytes in UTF-8 format.
propertyValue - The custom value to be set. The value must not be greater than 254 bytes in UTF-8 format.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.1 Supports escalation instances.
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

setCustomProperty

  1. void setCustomProperty(ESIID esiid,
  2. java.lang.String propertyName,
  3. java.lang.String propertyValue)
  4. throws ApplicationVetoException
  5. ArchiveUnsupportedOperationException
  6. IdWrongFormatException
  7. InvalidLengthException
  8. NotAuthorizedException
  9. ObjectDoesNotExistException
  10. ParameterNullException
  11. WrongKindException
  12. UnexpectedFailureException
  13. CommunicationException
Stores custom-specific values for the specified escalation instance.

Custom properties allow a user to add additional properties to escalations beyond those provided and managed by the task manager.

A custom property has a name and a value of type string.

Custom properties can be provided in any state of the escalation instance. The parent application may, however, reject to set a property. The caller must be the escalation receiver, or administrator of the escalation instance.

The action associated to this method is EscalationActions.SETCUSTOMPROPERTY.

This method is not supported in archive mode.

Parameters:
esiid - The object ID of the escalation instance.
propertyName - The name of the custom property to be set. The name must not be greater than 220 bytes in UTF-8 format.
propertyValue - The custom value to be set. The value must not be greater than 254 bytes in UTF-8 format.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

setCustomProperty

  1. void setCustomProperty(TKIID tkiid,
  2. java.lang.String propertyName,
  3. java.lang.String propertyValue)
  4. throws ApplicationVetoException
  5. ArchiveUnsupportedOperationException
  6. IdWrongFormatException
  7. InvalidLengthException
  8. NotAuthorizedException
  9. ObjectDoesNotExistException
  10. ParameterNullException
  11. WrongKindException
  12. UnexpectedFailureException
  13. CommunicationException
Stores custom-specific values for the specified task instance.

Custom properties allow a user to add additional properties to tasks beyond those provided and managed by the task manager.

A custom property has a name and a value of type string.

Custom properties can be provided in any state of the task instance. The parent application may, however, reject to set a property. The caller must be the originator, owner, starter, editor, or administrator of the task instance.

The action associated to this method is TaskActions.SETCUSTOMPROPERTY.

This method is not supported in archive mode.

Parameters:
tkiid - The object ID of the task instance.
propertyName - The name of the custom property to be set. The name must not be greater than 220 bytes in UTF-8 format.
propertyValue - The custom value to be set. The value must not be greater than 254 bytes in UTF-8 format.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

setCustomProperty

  1. java.util.List setCustomProperty( java.lang.String[] tkiids,
  2. java.lang.String propertyName,
  3. java.lang.String propertyValue)
  4. throws ArchiveUnsupportedOperationException
  5. IdWrongFormatException
  6. IdWrongTypeException
  7. InvalidLengthException
  8. ParameterNullException
  9. UnexpectedFailureException
  10. CommunicationException
Stores custom-specific values for the specified task instances using string representations of the task instance IDs.

Custom properties allow a user to add additional properties to tasks beyond those provided and managed by the task manager.

A custom property has a name and a value of type string.

Custom properties can be provided in any state of the task instance. The parent application may, however, reject to set a property. The caller must be the originator, owner, starter, editor, or administrator of the task instance.

All operations are executed within the current transaction. If a transaction timeout occurs, then all already executed operations are rolled back.

The action associated to this method is TaskActions.SETCUSTOMPROPERTY.

This method is not supported in archive mode.

Parameters:
tkiids - An array of task instance IDs that are used to identify the tasks,
propertyName - The name of the custom property to be set. The name must not be greater than 220 bytes in UTF-8 format.
propertyValue - The custom value to be set. The value must not be greater than 254 bytes in UTF-8 format.

Returns:
List - A list of TaskResult objects, one for every task instance specified. Refer to TaskResult.

If a single operation fails because any of the following exceptions has been thrown, then the result object contains the respective exception. Otherwise, the TaskException property is null.

  • com.ibm.task.api.ApplicationVetoException
  • com.ibm.task.api.NotAuthorizedException
  • com.ibm.task.api.ObjectDoesNotExistException
If any of these exceptions is thrown, processing continues. If another exception is thrown, a rollback of the global transaction is enforced, and all operations are undone.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

Change History

Release Modification
7.0.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

setCustomProperty

  1. java.util.List setCustomProperty( TKIID[] tkiids,
  2. java.lang.String propertyName,
  3. java.lang.String propertyValue)
  4. throws ArchiveUnsupportedOperationException
  5. IdWrongFormatException
  6. InvalidLengthException
  7. ParameterNullException
  8. UnexpectedFailureException
  9. CommunicationException
Stores custom-specific values for the specified task instances using task instance IDs.

Custom properties allow a user to add additional properties to tasks beyond those provided and managed by the task manager.

A custom property has a name and a value of type string.

Custom properties can be provided in any state of the task instance. The parent application may, however, reject to set a property. The caller must be the originator, owner, starter, editor, or administrator of the task instance.

All operations are executed within the current transaction. If a transaction timeout occurs, then all already executed operations are rolled back.

The action associated to this method is TaskActions.SETCUSTOMPROPERTY.

This method is not supported in archive mode.

Parameters:
tkiids - An array of task instance IDs that are used to identify the tasks,
propertyName - The name of the custom property to be set. The name must not be greater than 220 bytes in UTF-8 format.
propertyValue - The custom value to be set. The value must not be greater than 254 bytes in UTF-8 format.

Returns:
List - A list of TaskResult objects, one for every task instance specified. Refer to TaskResult.

If a single transfer operation fails because any of the following exceptions has been thrown, then the result object contains the respective exception. Otherwise, the TaskException property is null.

  • com.ibm.task.api.ApplicationVetoException
  • com.ibm.task.api.NotAuthorizedException
  • com.ibm.task.api.ObjectDoesNotExistException
If any of these exceptions is thrown, processing continues. If another exception is thrown, a rollback of the global transaction is enforced, and all operations are undone.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

Change History

Release Modification
7.0.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

setCustomProperties

  1. void setCustomProperties(java.lang.String tkiid,
  2. java.util.List customProperties)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. IdWrongFormatException
  6. IdWrongTypeException
  7. InvalidLengthException
  8. NotAuthorizedException
  9. ObjectDoesNotExistException
  10. ParameterNullException
  11. WrongKindException
  12. UnexpectedFailureException
  13. CommunicationException
Stores custom-specific values for the specified task instance using a string representation of the task instance ID.

Custom properties allow a user to add additional properties to tasks beyond those provided and managed by the task manager.

A custom property has a name and a value of type string. It may be constructed using the CustomPropertyFactory.

Custom properties can be provided in any state of the task instance. The parent application may, however, reject to set a property. The caller must be the originator, owner, starter, editor, or administrator of the task instance.

The action associated to this method is TaskActions.SETCUSTOMPROPERTY.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID.
customProperties - A list of CustomProperty objects.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

Change History

Release Modification
7.0.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

setCustomProperties

  1. void setCustomProperties(TKIID tkiid,
  2. java.util.List customProperties)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. IdWrongFormatException
  6. InvalidLengthException
  7. NotAuthorizedException
  8. ObjectDoesNotExistException
  9. ParameterNullException
  10. WrongKindException
  11. UnexpectedFailureException
  12. CommunicationException
Stores custom-specific values for the specified task instance using the task instance ID.

Custom properties allow a user to add additional properties to tasks beyond those provided and managed by the task manager.

A custom property has a name and a value of type string. It may be constructed using the CustomPropertyFactory.

Custom properties can be provided in any state of the task instance. The parent application may, however, reject to set a property. The caller must be the originator, owner, starter, editor, or administrator of the task instance.

The action associated to this method is TaskActions.SETCUSTOMPROPERTY.

This method is not supported in archive mode.

Parameters:
tkiid - The task instance ID that is used to identify the task instance.
customProperties - A list of CustomProperty objects.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

Change History

Release Modification
7.0.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

setBinaryCustomProperty

  1. void setBinaryCustomProperty(java.lang.String identifier,
  2. BinaryCustomProperty property)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. IdWrongFormatException
  6. IdWrongTypeException
  7. InvalidLengthException
  8. NotAuthorizedException
  9. ObjectDoesNotExistException
  10. ParameterNullException
  11. UnexpectedFailureException
  12. CommunicationException
Stores custom-specific binary values for the specified task or escalation instance using a string representation of the task or escalation instance ID.

Custom properties allow a user to add additional properties to tasks or escalations beyond those provided and managed by the task manager. Binary custom properties allow, for example, to attach a Java object to a task instance. Binary custom properties cannot be searched for directly. It is, however, possible to specify an additional queryable string.

Custom properties can be provided in any state of the task or escalation instance. The parent application may, however, reject to set a property. The caller must be the originator, owner, starter, editor, or administrator of the task instance or must be the escalation receiver or administrator of the escalation instance.

The action associated to this method is TaskActions.SETCUSTOMPROPERTY or EscalationActions.SETCUSTOMPROPERTY.

This method is not supported in archive mode.

Parameters:
identifier - A string representation of the task or escalation instance ID that is used to identify the object.
property - The BinaryCustomProperty object.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.1 Supports escalation instances.
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

setBinaryCustomProperty

  1. void setBinaryCustomProperty(TKIID tkiid,
  2. BinaryCustomProperty property)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. IdWrongFormatException
  6. InvalidLengthException
  7. NotAuthorizedException
  8. ObjectDoesNotExistException
  9. ParameterNullException
  10. UnexpectedFailureException
  11. CommunicationException
Stores custom-specific binary values for the specified task instance using the task instance ID.

Custom properties allow a user to add additional properties to tasks beyond those provided and managed by the task manager. Binary custom properties allow, for example, to attach a Java object to a task instance. Binary custom properties cannot be searched for directly. It is, however, possible to specify an additional queryable string.

Custom properties can be provided in any state of the task instance. The parent application may, however, reject to set a property. The caller must be the originator, owner, starter, editor, or administrator of the task instance.

The action associated to this method is TaskActions.SETCUSTOMPROPERTY.

This method is not supported in archive mode.

Parameters:
tkiid - The task instance ID that is used to identify the task instance.
property - The BinaryCustomProperty object.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

setBinaryCustomProperty

  1. void setBinaryCustomProperty(ESIID esiid,
  2. BinaryCustomProperty property)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. IdWrongFormatException
  6. InvalidLengthException
  7. NotAuthorizedException
  8. ObjectDoesNotExistException
  9. ParameterNullException
  10. UnexpectedFailureException
  11. CommunicationException
Stores custom-specific binary values for the specified escalation instance using the escalation instance ID.

Custom properties allow a user to add additional properties to escalations beyond those provided and managed by the task manager. Binary custom properties allow, for example, to attach a Java object to an escalation instance. Binary custom properties cannot be searched for directly. It is, however, possible to specify an additional queryable string.

Custom properties can be provided in any state of the escalation instance. The parent application may, however, reject to set a property. The caller must be the escalation receiver or administrator of the escalation instance.

The action associated to this method is EscalationActions.SETCUSTOMPROPERTY.

This method is not supported in archive mode.

Parameters:
esiid - The escalation instance ID that is used to identify the escalation instance.
property - The BinaryCustomProperty object.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

setFaultMessage

  1. void setFaultMessage(java.lang.String tkiid,
  2. java.lang.String faultName,
  3. ClientObjectWrapper faultMessage)
  4. throws ApplicationVetoException
  5. ArchiveUnsupportedOperationException
  6. IdWrongFormatException
  7. IdWrongTypeException
  8. InvalidQNameException
  9. NotAuthorizedException
  10. ObjectDoesNotExistException
  11. ParameterNullException
  12. WrongKindException
  13. WrongMessageTypeException
  14. WrongStateException
  15. UnexpectedFailureException
  16. CommunicationException
Stores the specified fault message for the specified task instance into the database using a string representation of the task instance ID. The fault message is saved only, that is, the state of the task instance is not changed. Refer to complete for information on how to complete a task instance.

Any previously stored fault or output message is deleted.

The task instance must be a collaboration or to-do task. Collaboration and to-do task instances are also known as human and participating task instances.

The task instance must be in the claimed state. It can be escalated. The caller must be the owner, an editor, or an administrator of the task instance.

The action associated to this method is TaskActions.SETFAULTMESSAGE.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID. This string is used to identify the task instance whose fault message is to be set.
faultName - The name of the fault message to be set. Must be a fault defined for the task. Refer to getFaultNames.
faultMessage - The fault message. The object wrapped by the ClientObjectWrapper must be serializable.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.1.0.1 Throws an ApplicationFailedException when the application refuses to execute the method.
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

setFaultMessage

  1. void setFaultMessage(TKIID tkiid,
  2. java.lang.String faultName,
  3. ClientObjectWrapper faultMessage)
  4. throws ApplicationVetoException
  5. ArchiveUnsupportedOperationException
  6. IdWrongFormatException
  7. InvalidQNameException
  8. NotAuthorizedException
  9. ObjectDoesNotExistException
  10. ParameterNullException
  11. WrongKindException
  12. WrongMessageTypeException
  13. WrongStateException
  14. UnexpectedFailureException
  15. CommunicationException
Stores the specified fault message for the specified task instance into the database using the task instance ID. The fault message is saved only, that is, the state of the task instance is not changed. Refer to complete for information on how to complete a task instance.

Any previously stored fault or output message is deleted.

The task instance must be in the claimed state. It can be escalated. The caller must be the owner, an editor, or an administrator of the task instance.

The action associated to this method is TaskActions.SETFAULTMESSAGE.

This method is not supported in archive mode.

Parameters:
tkiid - The task instance ID that is used to identify the task instance whose fault message is to be set.
faultName - The name of the fault message to be set. Must be a fault defined for the task. Refer to getFaultNames.
faultMessage - The fault message. The object wrapped by the ClientObjectWrapper must be serializable.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.1.0.1 Throws an ApplicationFailedException when the application refuses to execute the method.
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

setInlineCustomProperties

  1. void setInlineCustomProperties( java.lang.String tkiid,
  2. java.util.List customProperties)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. IdWrongFormatException
  6. IdWrongTypeException
  7. InvalidLengthException
  8. NotAuthorizedException
  9. ObjectDoesNotExistException
  10. ParameterNullException
  11. UnsupportedParameterValueException
  12. UnexpectedFailureException
  13. CommunicationException
Stores custom-specific values for the specified task instance using a string representation of the task instance ID.

Custom properties allow a user to add additional properties to a task beyond those provided and managed by the Human Task Manager.

In contrast to custom properties that are attached to an object, inline custom properties are an integral part of the task instance. Thus, using inline custom properties can increase performance.

An inline custom property has a predefined name and a value of type string. It may be constructed using the CustomPropertyFactory.

Custom properties can be provided in any state of the task instance. The parent application may, however, reject to set a property. The caller must be the originator, owner, starter, editor, or administrator of the task instance.

The action associated to this method is TaskActions.SETCUSTOMPROPERTY.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance object ID that is used to identify the task instance.
customProperties - A list of InlineCustomProperty objects.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.5.1

setInlineCustomProperties

  1. void setInlineCustomProperties( TKIID tkiid,
  2. java.util.List customProperties)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. IdWrongFormatException
  6. InvalidLengthException
  7. NotAuthorizedException
  8. ObjectDoesNotExistException
  9. ParameterNullException
  10. UnsupportedParameterValueException
  11. UnexpectedFailureException
  12. CommunicationException
Stores custom-specific values for the specified task instance using the task instance ID.

Custom properties allow a user to add additional properties to a task beyond those provided and managed by the Human Task Manager.

In contrast to custom properties that are attached to an object, inline custom properties are an integral part of the task instance. Thus, using inline custom properties can increase performance.

An inline custom property has a predefined name and a value of type string. It may be constructed using the CustomPropertyFactory.

Custom properties can be provided in any state of the task instance. The parent application may, however, reject to set a property. The caller must be the originator, owner, starter, editor, or administrator of the task instance.

The action associated to this method is TaskActions.SETCUSTOMPROPERTY.

This method is not supported in archive mode.

Parameters:
tkiid - The object ID of the task instance for which the inline custom properties are to be set.
customProperties - A list of InlineCustomProperty objects.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.5.1

setInlineCustomProperty

  1. void setInlineCustomProperty(java.lang.String tkiid,
  2. InlineCustomProperty property)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. IdWrongFormatException
  6. IdWrongTypeException
  7. InvalidLengthException
  8. NotAuthorizedException
  9. ObjectDoesNotExistException
  10. ParameterNullException
  11. UnsupportedParameterValueException
  12. UnexpectedFailureException
  13. CommunicationException
Stores a custom-specific value for the specified task instance using a string representation of the task instance ID.

Custom properties allow a user to add additional properties to a task beyond those provided and managed by the Human Task Manager.

In contrast to custom properties that are attached to an object, inline custom properties are an integral part of the task instance. Thus, using inline custom properties can increase performance.

An inline custom property has a predefined name and a value of type string. It may be constructed using the CustomPropertyFactory.

Custom properties can be provided in any state of the task instance. The parent application may, however, reject to set a property. The caller must be the originator, owner, starter, editor, or administrator of the task instance.

The action associated to this method is TaskActions.SETCUSTOMPROPERTY.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance object ID that is used to identify the task instance.
property - The inline custom property to be set.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.5.1

setInlineCustomProperty

  1. void setInlineCustomProperty(TKIID tkiid,
  2. InlineCustomProperty property)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. IdWrongFormatException
  6. InvalidLengthException
  7. NotAuthorizedException
  8. ObjectDoesNotExistException
  9. ParameterNullException
  10. UnsupportedParameterValueException
  11. UnexpectedFailureException
  12. CommunicationException
Stores a custom specific value for the specified task instance using the task instance ID.

Custom properties allow a user to add additional properties to a task beyond those provided and managed by the Human Task Manager.

In contrast to custom properties that are attached to an object, inline custom properties are an integral part of the task instance. Thus, using inline custom properties can increase performance.

An inline custom property has a predefined name and a value of type string. It may be constructed using the CustomPropertyFactory.

Custom properties can be provided in any state of the task instance. The parent application may, however, reject to set a property. The caller must be the originator, owner, starter, editor, or administrator of the task instance.

The action associated to this method is TaskActions.SETCUSTOMPROPERTY.

This method is not supported in archive mode.

Parameters:
tkiid - The object ID of the task instance for which the inline custom property is to be set.
property - The inline custom property to be set.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.5.1

setInlineCustomProperty

  1. java.util.List setInlineCustomProperty( java.lang.String[] tkiids,
  2. InlineCustomProperty property)
  3. throws ArchiveUnsupportedOperationException
  4. IdWrongFormatException
  5. IdWrongTypeException
  6. InvalidLengthException
  7. ParameterNullException
  8. UnsupportedParameterValueException
  9. UnexpectedFailureException
  10. CommunicationException
Stores a custom-specific value for the specified task instances using string representations of the task instance IDs.

Custom properties allow a user to add additional properties to a task beyond those provided and managed by the Human Task Manager.

In contrast to custom properties that are attached to an object, inline custom properties are an integral part of the task instance. Thus, using inline custom properties can increase performance.

An inline custom property has a predefined name and a value of type string. It may be constructed using the CustomPropertyFactory.

Custom properties can be provided in any state of the task instance. The parent application may, however, reject to set a property. The caller must be the originator, owner, starter, editor, or administrator of the task instance.

The action associated to this method is TaskActions.SETCUSTOMPROPERTY.

This method is not supported in archive mode.

Parameters:
tkiids - An array of task instance IDs that are used to identify the task instances,
property - The inline custom property to be set.

Returns:
List - A list of TaskResult objects, one for every task instance specified. Refer to TaskResult.

If a single operation fails because any of the following exceptions has been thrown, then the result object contains the respective exception. Otherwise, the TaskException property is null.

  • com.ibm.task.api.ApplicationVetoException
  • com.ibm.task.api.NotAuthorizedException
  • com.ibm.task.api.ObjectDoesNotExistException

If any of these exceptions is thrown, processing continues. If another exception is thrown, a rollback of the global transaction is enforced, and all operations are undone.

Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.5.1

setInlineCustomProperty

  1. java.util.List setInlineCustomProperty( TKIID[] tkiids,
  2. InlineCustomProperty property)
  3. throws ArchiveUnsupportedOperationException
  4. IdWrongFormatException
  5. InvalidLengthException
  6. ParameterNullException
  7. UnsupportedParameterValueException
  8. UnexpectedFailureException
  9. CommunicationException
Stores a custom-specific value for the specified task instances using task instance IDs.

Custom properties allow a user to add additional properties to a task beyond those provided and managed by the Human Task Manager.

In contrast to custom properties that are attached to an object, inline custom properties are an integral part of the task instance. Thus, using inline custom properties can increase performance.

An inline custom property has a predefined name and a value of type string. It may be constructed using the CustomPropertyFactory.

Custom properties can be provided in any state of the task instance. The parent application may, however, reject to set a property. The caller must be the originator, owner, starter, editor, or administrator of the task instance.

The action associated to this method is TaskActions.SETCUSTOMPROPERTY.

This method is not supported in archive mode.

Parameters:
tkiids - An array of task instance IDs that are used to identify the task instances,
property - The inline custom property to be set.

Returns:
List - A list of TaskResult objects, one for every task instance specified. Refer to TaskResult.

If a single operation fails because any of the following exceptions has been thrown, then the result object contains the respective exception. Otherwise, the TaskException property is null.

  • com.ibm.task.api.ApplicationVetoException
  • com.ibm.task.api.NotAuthorizedException
  • com.ibm.task.api.ObjectDoesNotExistException

If any of these exceptions is thrown, processing continues. If another exception is thrown, a rollback of the global transaction is enforced, and all operations are undone.

Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.5.1

setInputMessage

  1. void setInputMessage(java.lang.String tkiid,
  2. ClientObjectWrapper inputMessage)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. DataHandlingException
  6. IdWrongFormatException
  7. IdWrongTypeException
  8. NotAuthorizedException
  9. ObjectDoesNotExistException
  10. ParameterNullException
  11. WrongKindException
  12. WrongMessageTypeException
  13. WrongStateException
  14. UnexpectedFailureException
  15. CommunicationException
Stores the input message of the specified task instance into the database using a string representation of the task instance ID. The input message is saved only, that is, the state of the task instance is not changed. Refer to startTask or claim for information on how to start or claim a task instance.

Any previously stored input message is deleted.

The task instance must be in the inactive state. It can be a collaboration, invocation, or to-do task. The caller must be the originator, a potential starter, or an administrator of the task instance.

Note that collaboration, invocation, and to-do task instances are also known as human, originating, and participating task instances.

The action associated to this method is TaskActions.SETINPUTMESSAGE.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID. This string is used to identify the task instance whose input message is to be set.
inputMessage - The input message. The object wrapped by the ClientObjectWrapper must be serializable.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

setInputMessage

  1. void setInputMessage(TKIID tkiid,
  2. ClientObjectWrapper inputMessage)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. DataHandlingException
  6. IdWrongFormatException
  7. NotAuthorizedException
  8. ObjectDoesNotExistException
  9. ParameterNullException
  10. WrongKindException
  11. WrongMessageTypeException
  12. WrongStateException
  13. UnexpectedFailureException
  14. CommunicationException
Stores the input message of the specified task instance into the database using the task instance ID. The input message is saved only, that is, the state of the task instance is not changed. Refer to startTask or claim for information on how to start or claim a task instance.

Any previously stored input message is deleted.

The task instance must be in the inactive state. It can be a collaboration, invocation, or to-do task. The caller must be the originator, a potential starter, or an administrator of the task instance.

Note that collaboration, invocation, and to-do task instances are also known as human, originating, and participating task instances.

The action associated to this method is TaskActions.SETINPUTMESSAGE.

This method is not supported in archive mode.

Parameters:
tkiid - The object ID of the task instance whose input message is to be set.
inputMessage - The input message. The object wrapped by the ClientObjectWrapper must be serializable.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

setOutputMessage

  1. void setOutputMessage(java.lang.String tkiid,
  2. ClientObjectWrapper outputMessage)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. DataHandlingException
  6. IdWrongFormatException
  7. IdWrongTypeException
  8. NotAuthorizedException
  9. ObjectDoesNotExistException
  10. ParameterNullException
  11. WrongKindException
  12. WrongMessageTypeException
  13. WrongStateException
  14. UnexpectedFailureException
  15. CommunicationException
Stores the output message of the specified task instance into the database using a string representation of the task instance ID. The output message is saved only, that is, the state of the task instance is not changed. Refer to complete for information on how to complete a task instance.

Any previously stored output or fault message is deleted.

The task instance must be in the claimed state. It can be escalated. The caller must be the owner, an editor, or an administrator of the task instance.

The action associated to this method is TaskActions.SETOUTPUTMESSAGE.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID. This string is used to identify the task instance whose output message is to be set.
outputMessage - The output message. The object wrapped by the ClientObjectWrapper must be serializable.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.1.0.1 Throws an ApplicationFailedException when the application refuses to execute the method.
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

setOutputMessage

  1. void setOutputMessage(TKIID tkiid,
  2. ClientObjectWrapper outputMessage)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. DataHandlingException
  6. IdWrongFormatException
  7. NotAuthorizedException
  8. ObjectDoesNotExistException
  9. ParameterNullException
  10. WrongKindException
  11. WrongMessageTypeException
  12. WrongStateException
  13. UnexpectedFailureException
  14. CommunicationException
Stores the output message of the specified task instance into the database using the task instance ID. The output message is saved only, that is, the state of the task instance is not changed. Refer to complete for information on how to complete a task instance.

Any previously stored output or fault message is deleted.

The task instance must be in the claimed state. It can be escalated. The caller must be the owner, an editor, or an administrator of the task instance.

The action associated to this method is TaskActions.SETOUTPUTMESSAGE.

This method is not supported in archive mode.

Parameters:
tkiid - The object ID of the task instance whose output message is to be set.
outputMessage - The output message. The object wrapped by the ClientObjectWrapper must be serializable.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.1.0.1 Throws an ApplicationFailedException when the application refuses to execute the method.
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

setSubstitutes

  1. void setSubstitutes(java.util.List substitutes)
  2. throws ArchiveUnsupportedOperationException
  3. ParameterNullException
  4. StaffServiceCannotAccessVMMException
  5. StaffServiceSubstitutionNotEnabledException
  6. StaffServiceRuntimeException
  7. SubstituteDoesNotExistException
  8. UserDoesNotExistException
  9. UnexpectedFailureException
  10. CommunicationException
Deprecated. As of version 7.0, replaced by setUserSubstitutionDetail.
Sets the substitutes of the logged-on user.

This method is not supported in archive mode.

Parameters:
substitutes - A list of users that are substitutes of the logged-on user. The substitutes that are provided replace any substitutes that are already set. To remove the substitutes that are set, specify an empty list.

The user IDs of the substitutes are checked but the check may be executed case insensitively. The check can be suppressed by setting the 'SupportVirtualUserIdsForPeopleAssignments' custom property of the Human Task Manager configuration to 'true'.

Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

setSubstitutes

  1. void setSubstitutes(java.lang.String userID,
  2. java.util.List substitutes)
  3. throws ArchiveUnsupportedOperationException
  4. NotAuthorizedException
  5. ParameterNullException
  6. StaffServiceCannotAccessVMMException
  7. StaffServiceSubstitutionNotEnabledException
  8. StaffServiceRuntimeException
  9. SubstituteDoesNotExistException
  10. UserDoesNotExistException
  11. UnexpectedFailureException
  12. CommunicationException
Deprecated. As of version 7.0, replaced by setUserSubstitutionDetail.
Sets the substitutes of the specified user.

If setting substitutes is not restricted to administrators, then everybody can set the substitutes of any user.

If setting substitutes is restricted to administrators, then only task the task system administrators can set the substitutes of arbitrary users. A user may, however, always modify his/her substitutes.

This method is not supported in archive mode.

Parameters:
userID - The name of the user whose substitutes are to be set. It is checked whether the user exists but the check may be executed case insensitively.
substitutes - A list of users that are substitutes of the specified user. The substitutes that are provided replace any substitutes that are already set. To remove the substitutes that are set, specify an empty list.

The user IDs of the substitutes are checked but the check may be executed case insensitively. The check can be suppressed by setting the 'SupportVirtualUserIdsForPeopleAssignments' custom property of the Human Task Manager configuration to 'true'.

Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

setTaskRead

  1. void setTaskRead(java.lang.String tkiid,
  2. boolean newValue)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. IdWrongFormatException
  6. IdWrongTypeException
  7. NotAuthorizedException
  8. ObjectDoesNotExistException
  9. UnexpectedFailureException
  10. CommunicationException
Specifies whether the specified task instance is to be marked as read using a string representation of the task instance ID.

The task instance can be in any state. The caller must have at least editor authority for the task instance.

The action associated to this method is TaskActions.SETTASKREAD.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID that is used to identify the task instance.
newValue - Specifies whether the task is to be marked as read. True states that the task is to be marked as read. False states that the task is not to be marked as read.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

Change History

Release Modification
7.0.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

setTaskRead

  1. void setTaskRead(TKIID tkiid,
  2. boolean newValue)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. IdWrongFormatException
  6. NotAuthorizedException
  7. ObjectDoesNotExistException
  8. UnexpectedFailureException
  9. CommunicationException
Specifies whether the specified task instance is to be marked as read using the task instance ID.

The task instance can be in any state. The caller must have at least editor authority for the task instance.

The action associated to this method is TaskActions.SETTASKREAD.

This method is not supported in archive mode.

Parameters:
tkiid - The object ID of the task instance.
newValue - Specifies whether the task is to be marked as read. True states that the task is to be marked as read. False states that the task is not to be marked as read.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

Change History

Release Modification
7.0.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

setUserSubstitutionDetail

  1. void setUserSubstitutionDetail( UserSubstitutionDetail substitutionDetail)
  2. throws ArchiveUnsupportedOperationException
  3. NotAuthorizedException
  4. StaffServiceCannotAccessVMMException
  5. StaffServiceSubstitutionNotEnabledException
  6. StaffServiceRuntimeException
  7. ParameterNullException
  8. SubstitutionInvalidParametersException
  9. UserDoesNotExistException
  10. UnexpectedFailureException
  11. CommunicationException
Sets absence and substitution details for the logged-on user.

This method is not supported in archive mode.

Parameters:
substitutionDetail - The absence and substitution details. Refer to UserSubstitutionDetail.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

Change History

Release Modification
7.0.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

setUserSubstitutionDetail

  1. void setUserSubstitutionDetail( java.lang.String userID,
  2. UserSubstitutionDetail substitutionDetail)
  3. throws ArchiveUnsupportedOperationException
  4. NotAuthorizedException
  5. StaffServiceCannotAccessVMMException
  6. StaffServiceSubstitutionNotEnabledException
  7. StaffServiceRuntimeException
  8. ParameterNullException
  9. SubstitutionInvalidParametersException
  10. UserDoesNotExistException
  11. UnexpectedFailureException
  12. CommunicationException
Sets absence and substitution details for the specified user.

The caller must be a task system administrator.

This method is not supported in archive mode.

Parameters:
userID - The userID of the user whose settings are changed.
substitutionDetail - The absence and substitution details. Refer to UserSubstitutionDetail.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

Change History

Release Modification
7.0.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

startTask

  1. void startTask(java.lang.String tkiid,
  2. ClientObjectWrapper input,
  3. ReplyHandlerWrapper replyHandler)
  4. throws AdministratorCannotBeResolvedException
  5. ApplicationVetoException
  6. ArchiveUnsupportedOperationException
  7. CannotCreateWorkItemException
  8. IdWrongFormatException
  9. IdWrongTypeException
  10. InvalidLengthException
  11. NotAuthorizedException
  12. UserDoesNotExistException
  13. ObjectDoesNotExistException
  14. ParallelRoutingTaskException
  15. SCAServiceAccessFailureException
  16. SCAServiceResultErrorException
  17. SchedulingFailedException
  18. WrongKindException
  19. WrongMessageTypeException
  20. WrongStateException
  21. UnexpectedFailureException
  22. CommunicationException
Asynchronously executes a previously created task using a string representation of the task instance ID.

The task instance must be in the inactive state. The caller must be a potential starter, the originator, or an administrator of the task. When the task is an invocation aka originating task instance, then the caller becomes the starter of the task.

The action associated to this method is TaskActions.STARTTASK.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID that is used to identify the task instance.
input - The input message. The object wrapped by the ClientObjectWrapper must be serializable.
replyHandler - The reply handler to be used to send the result of execution back to the caller. "null" must be passed if no reply handler is provided.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when starting of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

startTask

  1. void startTask(TKIID tkiid,
  2. ClientObjectWrapper input,
  3. ReplyHandlerWrapper replyHandler)
  4. throws AdministratorCannotBeResolvedException
  5. ApplicationVetoException
  6. ArchiveUnsupportedOperationException
  7. CannotCreateWorkItemException
  8. IdWrongFormatException
  9. InvalidLengthException
  10. NotAuthorizedException
  11. UserDoesNotExistException
  12. ObjectDoesNotExistException
  13. ParallelRoutingTaskException
  14. SCAServiceAccessFailureException
  15. SCAServiceResultErrorException
  16. SchedulingFailedException
  17. WrongKindException
  18. WrongMessageTypeException
  19. WrongStateException
  20. UnexpectedFailureException
  21. CommunicationException
Asynchronously executes a previously created task using the task instance ID.

The task instance must be in the inactive state. The caller must be a potential starter, the originator, or an administrator of the task. When the task is an invocation aka originating task instance, then the caller becomes the starter of the task.

The action associated to this method is TaskActions.STARTTASK.

This method is not supported in archive mode.

Parameters:
tkiid - The task instance ID that is used to identify the task instance.
input - The input message. The object wrapped by the ClientObjectWrapper must be serializable.
replyHandler - The reply handler to be used to send the result of execution back to the caller. "null" must be passed if no reply handler is provided.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when starting of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

startTaskAsSubTask

  1. void startTaskAsSubTask(java.lang.String tkiid,
  2. java.lang.String parentTaskID,
  3. ClientObjectWrapper input)
  4. throws AdministratorCannotBeResolvedException
  5. ApplicationVetoException
  6. ArchiveUnsupportedOperationException
  7. CannotCreateWorkItemException
  8. IdWrongFormatException
  9. IdWrongTypeException
  10. InvalidApplicationStateException
  11. InvalidLengthException
  12. NotAuthorizedException
  13. UserDoesNotExistException
  14. ObjectDoesNotExistException
  15. ParallelRoutingTaskException
  16. SCAServiceAccessFailureException
  17. SCAServiceResultErrorException
  18. SchedulingFailedException
  19. SubTasksNotSupportedException
  20. WrongKindException
  21. WrongMessageTypeException
  22. WrongStateException
  23. UnexpectedFailureException
  24. CommunicationException
Executes a previously created task as a subtask of the specified parent task instance using a string representation of the task instance ID. The parent task instance is then waiting for the completion of the subtask. It can only be completed when all subtasks came to an end.

The subtask must be a collaboration or stand-alone invocation task. An invocation task must have been derived from a task template that has not been created at Runtime. The parent task instance must be a collaboration or to-do task in the claimed state. It can be escalated or already waiting for a subtask. It can, however, not be suspended.

Note that collaboration, invocation, and to-do task instances are also known as human, originating, amd participating task instances.

A subtask can only be started when the parent task supports subtask creation - refer to Task to view the task instance properties.

The subtask instance must be in the inactive state. When started it will be in the ready or running state. The caller must be a potential starter, the originator, or an administrator of the subtask and an owner or administrator of the parent task instance. When the task is an invocation aka originating task instance, then the caller becomes the starter of the task.

The action associated to this method is TaskActions.STARTTASKASSUBTASK.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID that is used to identify the subtask instance.
parentTaskID - A string representation of the task instance ID that identifies the parent task instance.
input - The input message. The object wrapped by the ClientObjectWrapper must be serializable.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when starting of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

startTaskAsSubTask

  1. void startTaskAsSubTask(TKIID tkiid,
  2. TKIID parentTaskID,
  3. ClientObjectWrapper input)
  4. throws AdministratorCannotBeResolvedException
  5. ApplicationVetoException
  6. ArchiveUnsupportedOperationException
  7. CannotCreateWorkItemException
  8. IdWrongFormatException
  9. InvalidApplicationStateException
  10. InvalidLengthException
  11. NotAuthorizedException
  12. UserDoesNotExistException
  13. ObjectDoesNotExistException
  14. ParallelRoutingTaskException
  15. SCAServiceAccessFailureException
  16. SCAServiceResultErrorException
  17. SchedulingFailedException
  18. SubTasksNotSupportedException
  19. WrongKindException
  20. WrongMessageTypeException
  21. WrongStateException
  22. UnexpectedFailureException
  23. CommunicationException
Executes a previously created task as a subtask of the specified parent task instance using the task instance ID. The parent task instance is then waiting for the completion of the subtask. It can only be completed when all subtasks came to an end.

The subtask must be a collaboration or stand-alone invocation task. An invocation task must have been derived from a task template that has not been created at Runtime. The parent task instance must be a collaboration or to-do task in the claimed state. It can be escalated or already waiting for a subtask. It can, however, not be suspended.

Collaboration, invocation, and to-do task instances are also known as human, originating, and participating task instances.

A subtask can only be started when the parent task supports subtask creation - refer to Task to view the task instance properties.

The subtask instance must be in the inactive state. When started it will be in the ready or running state. The caller must be a potential starter, the originator, or an administrator of the subtask and an owner or administrator of the parent task instance. When the task is an invocation aka originating task instance, then the caller becomes the starter of the task.

The action associated to this method is TaskActions.STARTTASKASSUBTASK.

This method is not supported in archive mode.

Parameters:
tkiid - The task instance ID that is used to identify the subtask instance.
parentTaskID - The task instance ID that identifies the parent task instance.
input - The input message. The object wrapped by the ClientObjectWrapper must be serializable.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when starting of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

startTaskTemplate

  1. void startTaskTemplate(java.lang.String tktid)
  2. throws ApplicationVetoException
  3. ArchiveUnsupportedOperationException
  4. IdWrongFormatException
  5. IdWrongTypeException
  6. NotAuthorizedException
  7. ObjectDoesNotExistException
  8. WrongKindException
  9. WrongStateException
  10. UnexpectedFailureException
  11. CommunicationException
This method starts a task template that has been created at Runtime using a string representation of the task template ID. When a task template is started instances can be created using the task template.

The caller must be an administrator of the task template. The task template must be stopped.

The action associated to this method is TaskTemplateActions.STARTTEMPLATE.

This method is not supported in archive mode.

Parameters:
tktid - A string representation of the object ID of the task template to be started.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

startTaskTemplate

  1. void startTaskTemplate(TKTID tktid)
  2. throws ApplicationVetoException
  3. ArchiveUnsupportedOperationException
  4. IdWrongFormatException
  5. NotAuthorizedException
  6. ObjectDoesNotExistException
  7. WrongKindException
  8. WrongStateException
  9. UnexpectedFailureException
  10. CommunicationException
This method starts a task template that has been created at Runtime using the task template ID. When a task template is started instances can be created using the task template.

The caller must be an administrator of the task template. The task template must be stopped.

The action associated to this method is TaskTemplateActions.STARTTEMPLATE.

This method is not supported in archive mode.

Parameters:
tktid - The object ID of the task template which is to be stopped.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

stopTaskTemplate

  1. void stopTaskTemplate(java.lang.String tktid)
  2. throws ApplicationVetoException
  3. ArchiveUnsupportedOperationException
  4. IdWrongFormatException
  5. IdWrongTypeException
  6. NotAuthorizedException
  7. ObjectDoesNotExistException
  8. WrongKindException
  9. WrongStateException
  10. UnexpectedFailureException
  11. CommunicationException
This method stops a task template that has been created at Runtime using a string representation of the task template ID. When a task template is in the stopped state no more instances can be created using the task template.

The caller must be an administrator of the task template. The task template must be started.

The action associated to this method is TaskTemplateActions.STOPTEMPLATE.

This method is not supported in archive mode.

Parameters:
tktid - A string representation of the object ID of the task template to be stopped.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

stopTaskTemplate

  1. void stopTaskTemplate(TKTID tktid)
  2. throws ApplicationVetoException
  3. ArchiveUnsupportedOperationException
  4. IdWrongFormatException
  5. NotAuthorizedException
  6. ObjectDoesNotExistException
  7. WrongKindException
  8. WrongStateException
  9. UnexpectedFailureException
  10. CommunicationException
This method stops a task template that has been created at Runtime using the task template ID. When a task template is in the stopped state no more instances can be created using the task template.

The caller must be an administrator of the task template. The task template must be started.

The action associated to this method is TaskTemplateActions.STOPTEMPLATE.

This method is not supported in archive mode.

Parameters:
tktid - The object ID of the task template which is to be stopped.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

suspend

  1. void suspend(java.lang.String tkiid)
  2. throws ApplicationVetoException
  3. ArchiveUnsupportedOperationException
  4. IdWrongFormatException
  5. IdWrongTypeException
  6. NotAuthorizedException
  7. ObjectDoesNotExistException
  8. WrongKindException
  9. WrongStateException
  10. UnexpectedFailureException
  11. CommunicationException
Suspends the specified collaboration or to-do task instance using a string representation of the task instance ID. Collaboration and to-do task instances are also known as human and participating task instances.

The task instance can be in the ready, running, or claimed state. It can be escalated or be waiting for subtasks to complete. The caller can be the owner, originator, or administrator of the task instance.

Note that escalation timers continue to run.

The action associated to this method is TaskActions.SUSPEND.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID to be suspended.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 A task with parallel ownership can be in the running state.

suspend

  1. void suspend(TKIID tkiid)
  2. throws ApplicationVetoException
  3. ArchiveUnsupportedOperationException
  4. IdWrongFormatException
  5. NotAuthorizedException
  6. ObjectDoesNotExistException
  7. WrongKindException
  8. WrongStateException
  9. UnexpectedFailureException
  10. CommunicationException
Suspends the specified collaboration or to-do task instance using the task instance ID. Collaboration and to-do task instances are also known as human and participating task instances.

The task instance can be in the ready, running, or claimed state. It can be escalated or be waiting for subtasks to complete. The caller can be the owner, originator, or administrator of the task instance.

Note that escalation timers continue to run.

The action associated to this method is TaskActions.SUSPEND.

This method is not supported in archive mode.

Parameters:
tkiid - The object ID of the task instance to be suspended.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 A task with parallel ownership can be in the running state.

suspend

  1. void suspend(java.lang.String tkiid,
  2. java.lang.String duration)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. IdWrongFormatException
  6. IdWrongTypeException
  7. NotAuthorizedException
  8. ObjectDoesNotExistException
  9. ParameterNullException
  10. WrongKindException
  11. WrongStateException
  12. UnexpectedFailureException
  13. CommunicationException
Suspends the specified collaboration or to-do task instance for the specified duration using a string representation of the task instance ID. Collaboration and to-do task instances are also known as human and participating task instances.

The task instance can be in the ready, running, or claimed state. It can be escalated or be waiting for subtasks to complete. The caller can be the owner, originator, or administrator of the task instance.

The task is then suspended for the specified duration or until an explicit resume request is issued.

Note that escalation timers continue to run.

The action associated to this method is TaskActions.SUSPEND.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID to be suspended.
duration - The time for which the task instance is to be suspended. Its format depends on the calendar that is used and may, for example, be "5days". When the time has passed, the task instance is automatically resumed.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 A task with parallel ownership can be in the running state.

suspend

  1. void suspend(TKIID tkiid,
  2. java.lang.String duration)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. IdWrongFormatException
  6. NotAuthorizedException
  7. ObjectDoesNotExistException
  8. ParameterNullException
  9. WrongKindException
  10. WrongStateException
  11. UnexpectedFailureException
  12. CommunicationException
Suspends the specified collaboration or to-do task instance for the specified duration using the task instance ID. Collaboration and to-do task instances are also known as human and participating task instances.

The task instance can be in the ready, running, or claimed state. It can be escalated or be waiting for subtasks to complete. The caller can be the owner, originator, or administrator of the task instance.

The task is then suspended for the specified duration or until an explicit resume request is issued.

Note that escalation timers continue to run.

The action associated to this method is TaskActions.SUSPEND.

This method is not supported in archive mode.

Parameters:
tkiid - The object ID of the task instance to be suspended.
duration - The time for which the task instance is to be suspended. Its format depends on the calendar that is used and may, for example, be "5days". When the time has passed, the task instance is automatically resumed.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 A task with parallel ownership can be in the running state.

suspend

  1. void suspend(java.lang.String tkiid,
  2. int duration)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. IdWrongFormatException
  6. IdWrongTypeException
  7. InvalidParameterException
  8. NotAuthorizedException
  9. ObjectDoesNotExistException
  10. WrongKindException
  11. WrongStateException
  12. UnexpectedFailureException
  13. CommunicationException
Suspends the specified collaboration or to-do task instance for the specified number of seconds using a string representation of the task instance ID. Collaboration and to-do task instances are also known as human and participating task instances.

The task instance can be in the ready, running, or claimed state. It can be escalated or be waiting for subtasks to complete. The caller can be the owner, originator, or administrator of the task instance.

The task is then suspended for the specified duration or until an explicit resume request is issued.

Note that escalation timers continue to run.

The action associated to this method is TaskActions.SUSPEND.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID to be suspended.
duration - The seconds for which the task instance is to be suspended. When the time has passed, the task instance is automatically resumed.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 A task with parallel ownership can be in the running state.

suspend

  1. void suspend(TKIID tkiid,
  2. int duration)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. IdWrongFormatException
  6. InvalidParameterException
  7. NotAuthorizedException
  8. ObjectDoesNotExistException
  9. WrongKindException
  10. WrongStateException
  11. UnexpectedFailureException
  12. CommunicationException
Suspends the specified collaboration or to-do task instance for the specified number of seconds using the task instance ID. Collaboration and to-do task instances are also known as human and participating task instances.

The task instance can be in the ready, running, or claimed state. It can be escalated or be waiting for subtasks to complete. The caller can be the owner, originator, or administrator of the task instance.

The task is then suspended for the specified duration or until an explicit resume request is issued.

Note that escalation timers continue to run.

The action associated to this method is TaskActions.SUSPEND.

This method is not supported in archive mode.

Parameters:
tkiid - The object ID of the task instance to be suspended.
duration - The seconds for which the task instance is to be suspended. When the time has passed, the task instance is automatically resumed.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 A task with parallel ownership can be in the running state.

suspend

  1. void suspend(java.lang.String tkiid,
  2. java.util.Calendar deadline)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. IdWrongFormatException
  6. IdWrongTypeException
  7. NotAuthorizedException
  8. ObjectDoesNotExistException
  9. ParameterNullException
  10. WrongKindException
  11. WrongStateException
  12. UnexpectedFailureException
  13. CommunicationException
Suspends the specified collaboration or to-do task instance until the specified point in time is reached using a string representation of the task instance ID. Collaboration and to-do task instances are also known as human and participating task instances.

The task instance can be in the ready, running, or claimed state. It can be escalated or be waiting for subtasks to complete. The caller can be the owner, originator, or administrator of the task instance.

The task is then suspended until the specified point in time or until an explicit resume request is issued.

Note that escalation timers continue to run.

The action associated to this method is TaskActions.SUSPEND.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance to be suspended.
deadline - The time up to which the task instance is to be suspended. When the specified time has been reached, the task instance is automatically resumed.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 A task with parallel ownership can be in the running state.

suspend

  1. void suspend(TKIID tkiid,
  2. java.util.Calendar deadline)
  3. throws ApplicationVetoException
  4. ArchiveUnsupportedOperationException
  5. IdWrongFormatException
  6. NotAuthorizedException
  7. ObjectDoesNotExistException
  8. ParameterNullException
  9. WrongKindException
  10. WrongStateException
  11. UnexpectedFailureException
  12. CommunicationException
Suspends the specified collaboration or to-do task instance until the specified point in time is reached using the task instance ID. Collaboration and to-do task instances are also known as human and participating task instances.

The task instance can be in the ready, running, or claimed state. It can be escalated or be waiting for subtasks to complete. The caller can be the owner, originator, or administrator of the task instance.

The task is then suspended until the specified point in time or until an explicit resume request is issued.

Note that escalation timers continue to run.

The action associated to this method is TaskActions.SUSPEND.

This method is not supported in archive mode.

Parameters:
tkiid - The object ID of the task instance to be suspended.
deadline - The time up to which the task instance is to be suspended. When the specified time has been reached, the task instance is automatically resumed.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 A task with parallel ownership can be in the running state.

suspendAndCancelClaim

  1. void suspendAndCancelClaim(java.lang.String tkiid,
  2. java.lang.String duration,
  3. boolean keepTaskData)
  4. throws ApplicationVetoException
  5. ArchiveUnsupportedOperationException
  6. IdWrongFormatException
  7. IdWrongTypeException
  8. NotAuthorizedException
  9. ObjectDoesNotExistException
  10. ParameterNullException
  11. WrongKindException
  12. WrongStateException
  13. UnexpectedFailureException
  14. CommunicationException
Suspends the specified collaboration or to-do task instance for the specified duration and cancels the claim of the task instance when execution is resumed using a string representation of the task instance ID. Collaboration and to-do task instances are also known as human and participating task instances.

The task instance must be in the claimed state. It can be escalated but not waiting for subtasks to complete. It cannot be a task with parallel ownership. A task with parallel ownership is not claimed and does not have an owner,

When the task instance is automatically resumed after the duration passed, it is returned to the ready state. When the task instance is resumed on request before the duration has passed, then the task instance remains claimed.

If specified, any previously stored output or fault message is kept.

The caller can be the owner or administrator of the task instance.

The action associated to this method is TaskActions.SUSPENDWITHCANCELCLAIM.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID to be suspended.
duration - The time for which the task instance is to be suspended. Its format depends on the calendar that is used and may, for example, be "5days". When the time has passed, the task instance is automatically resumed.
keepTaskData - Specifies whether data saved for the claimed task instance is to be kept. True states that any output or fault message set is to be kept. False states that any output or fault message set is to be deleted.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

suspendAndCancelClaim

  1. void suspendAndCancelClaim(TKIID tkiid,
  2. java.lang.String duration,
  3. boolean keepTaskData)
  4. throws ApplicationVetoException
  5. ArchiveUnsupportedOperationException
  6. IdWrongFormatException
  7. NotAuthorizedException
  8. ObjectDoesNotExistException
  9. ParameterNullException
  10. WrongKindException
  11. WrongStateException
  12. UnexpectedFailureException
  13. CommunicationException
Suspends the specified collaboration or to-do task instance for the specified duration and cancels the claim of the task instance when execution is resumed using the task instance ID. Collaboration and to-do task instances are also known as human and participating task instances.

The task instance must be in the claimed state. It can be escalated but not waiting for subtasks to complete. It cannot be a task with parallel ownership. A task with parallel ownership is not claimed and does not have an owner,

When the task instance is automatically resumed after the duration passed, it is returned to the ready state. When the task instance is resumed on request before the duration has passed, then the task instance remains claimed.

If specified, any previously stored output or fault message is kept.

The caller can be the owner or administrator of the task instance.

The action associated to this method is TaskActions.SUSPENDWITHCANCELCLAIM.

This method is not supported in archive mode.

Parameters:
tkiid - The object ID of the task instance to be suspended.
duration - The time for which the task instance is to be suspended. Its format depends on the calendar that is used and may, for example, be "5days". When the time has passed, the task instance is automatically resumed.
keepTaskData - Specifies whether data saved for the claimed task instance is to be kept. True states that any output or fault message set is to be kept. False states that any output or fault message set is to be deleted.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

suspendAndCancelClaim

  1. void suspendAndCancelClaim(java.lang.String tkiid,
  2. int duration,
  3. boolean keepTaskData)
  4. throws ApplicationVetoException
  5. ArchiveUnsupportedOperationException
  6. IdWrongFormatException
  7. IdWrongTypeException
  8. InvalidParameterException
  9. NotAuthorizedException
  10. ObjectDoesNotExistException
  11. WrongKindException
  12. WrongStateException
  13. UnexpectedFailureException
  14. CommunicationException
Suspends the specified collaboration or to-do task instance for the specified number of seconds and cancels the claim of the task instance when execution is resumed using a string representation of the task instance ID. Collaboration and to-do task instances are also known as human and participating task instances.

The task instance must be in the claimed state. It can be escalated but not waiting for subtasks to complete. It cannot be a task with parallel ownership. A task with parallel ownership is not claimed and does not have an owner,

When the task instance is automatically resumed after the duration passed, it is returned to the ready state. When the task instance is resumed on request before the duration has passed, then the task instance remains claimed.

If specified, any previously stored output or fault message is kept.

The caller can be the owner or administrator of the task instance.

The action associated to this method is TaskActions.SUSPENDWITHCANCELCLAIM.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID to be suspended.
duration - The seconds for which the task instance is to be suspended. When the time has passed, the task instance is automatically resumed.
keepTaskData - Specifies whether data saved for the claimed task instance is to be kept. True states that any output or fault message set is to be kept. False states that any output or fault message set is to be deleted.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

suspendAndCancelClaim

  1. void suspendAndCancelClaim(TKIID tkiid,
  2. int duration,
  3. boolean keepTaskData)
  4. throws ApplicationVetoException
  5. ArchiveUnsupportedOperationException
  6. IdWrongFormatException
  7. InvalidParameterException
  8. NotAuthorizedException
  9. ObjectDoesNotExistException
  10. WrongKindException
  11. WrongStateException
  12. UnexpectedFailureException
  13. CommunicationException
Suspends the specified collaboration or to-do task instance for the specified number of seconds and cancels the claim of the task instance when execution is resumed using the task instance ID.

The task instance must be in the claimed state. It can be escalated or be waiting for subtasks to complete. When the task instance is automatically resumed after the duration passed, it is returned to the ready state. When the task instance is resumed on request before the duration has passed, then the task instance remains claimed.

If specified, any previously stored output or fault message is kept.

The caller can be the owner or administrator of the task instance.

The action associated to this method is TaskActions.SUSPENDWITHCANCELCLAIM.

This method is not supported in archive mode.

Parameters:
tkiid - The object ID of the task instance to be suspended.
duration - The seconds for which the task instance is to be suspended. When the time has passed, the task instance is automatically resumed.
keepTaskData - Specifies whether data saved for the claimed task instance is to be kept. True states that any output or fault message set is to be kept. False states that any output or fault message set is to be deleted.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

suspendAndCancelClaim

  1. void suspendAndCancelClaim(java.lang.String tkiid,
  2. java.util.Calendar deadline,
  3. boolean keepTaskData)
  4. throws ApplicationVetoException
  5. ArchiveUnsupportedOperationException
  6. IdWrongFormatException
  7. IdWrongTypeException
  8. NotAuthorizedException
  9. ObjectDoesNotExistException
  10. ParameterNullException
  11. WrongKindException
  12. WrongStateException
  13. UnexpectedFailureException
  14. CommunicationException
Suspends the specified collaboration or to-do task instance until the specified point in time is reached, and cancels the claim of the task instance when execution is resumed using a string representation of the task instance ID. Collaboration and to-do task instances are also known as human and participating task instances.

The task instance must be in the claimed state. It can be escalated but not waiting for subtasks to complete. It cannot be a task with parallel ownership. A task with parallel ownership is not claimed and does not have an owner,

When the task instance is automatically resumed after the duration passed, it is returned to the ready state. When the task instance is resumed on request before the duration has passed, then the task instance remains claimed.

If specified, any previously stored output or fault message is kept.

The caller can be the owner or administrator of the task instance.

The action associated to this method is TaskActions.SUSPENDWITHCANCELCLAIM.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID to be suspended.
deadline - The time up to which the task instance is to be suspended. When the specified time has been reached, the task instance is automatically resumed and returned to the ready state.
keepTaskData - Specifies whether data saved for the claimed task instance is to be kept. True states that any output or fault message set is to be kept. False states that any output or fault message set is to be deleted.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

suspendAndCancelClaim

  1. void suspendAndCancelClaim(TKIID tkiid,
  2. java.util.Calendar deadline,
  3. boolean keepTaskData)
  4. throws ApplicationVetoException
  5. ArchiveUnsupportedOperationException
  6. IdWrongFormatException
  7. NotAuthorizedException
  8. ObjectDoesNotExistException
  9. ParameterNullException
  10. WrongKindException
  11. WrongStateException
  12. UnexpectedFailureException
  13. CommunicationException
Suspends the specified collaboration or to-do task instance until the specified point in time is reached, and cancels the claim of the task instance when execution is resumed using the task instance ID.

The task instance must be in the claimed state. It can be escalated but not waiting for subtasks to complete. It cannot be a task with parallel ownership. A task with parallel ownership is not claimed and does not have an owner,

When the task instance is automatically resumed after the duration passed, it is returned to the ready state. When the task instance is resumed on request before the duration has passed, then the task instance remains claimed.

If specified, any previously stored output or fault message is kept.

The caller can be the owner or administrator of the task instance.

The action associated to this method is TaskActions.SUSPENDWITHCANCELCLAIM.

This method is not supported in archive mode.

Parameters:
tkiid - The object ID of the task instance to be suspended.
deadline - The time up to which the task instance is to be suspended. When the specified time has been reached, the task instance is automatically resumed and returned to the ready state.
keepTaskData - Specifies whether data saved for the claimed task instance is to be kept. True states that any output or fault message set is to be kept. False states that any output or fault message set is to be deleted.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

terminate

  1. void terminate(java.lang.String tkiid)
  2. throws ApplicationVetoException
  3. ArchiveUnsupportedOperationException
  4. IdWrongFormatException
  5. IdWrongTypeException
  6. NotAuthorizedException
  7. ObjectDoesNotExistException
  8. ParallelRoutingTaskException
  9. SchedulingFailedException
  10. WrongKindException
  11. WrongStateException
  12. UnexpectedFailureException
  13. CommunicationException
Terminates the specified task instance using a string representation of the task instance ID. Terminating an invocation aka originating task instance has no impact on the invoked service.

The task instance can be in the ready, claimed, or running state. It can be escalated, suspended, or waiting for subtasks. It cannot be an inline task or a stand-alone task with "child" autonomy. The caller can be the owner, starter, originator, or administrator of the task instance.

The action associated to this method is TaskActions.TERMINATE.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the object ID of the task instance to be terminated.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when completion of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

terminate

  1. void terminate(TKIID tkiid)
  2. throws ApplicationVetoException
  3. ArchiveUnsupportedOperationException
  4. IdWrongFormatException
  5. NotAuthorizedException
  6. ObjectDoesNotExistException
  7. ParallelRoutingTaskException
  8. SchedulingFailedException
  9. WrongKindException
  10. WrongStateException
  11. UnexpectedFailureException
  12. CommunicationException
Terminates the specified task instance using the task instance ID. Terminating an invocation aka originating task instance has no impact on the invoked service.

The task instance can be in the ready, claimed, or running state. It can be escalated, suspended, or waiting for subtasks. It cannot be an inline task or a stand-alone task with "child" autonomy. The caller can be the owner, starter, originator, or administrator of the task instance.

The action associated to this method is TaskActions.TERMINATE.

This method is not supported in archive mode.

Parameters:
tkiid - The object ID of the task instance to be terminated.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws a ParallelRoutingTaskException when completion of a parallel routing task failed.
7.0 Throws a SchedulingFailedException when scheduling the task failed.

transferToWorkBasket

  1. java.util.List transferToWorkBasket( java.lang.String[] tkiids,
  2. java.lang.String workBasketName)
  3. throws ArchiveUnsupportedOperationException
  4. IdWrongFormatException
  5. IdWrongTypeException
  6. InvalidLengthException
  7. InvalidParameterException
  8. UnexpectedFailureException
  9. CommunicationException
Transfers the specified task instances to the specified work basket using string representations of the task instance IDs. The caller must be an owner, starter, originator, editor, or administrator of the task instance.

All tasks are marked unread. The isTransferredToWorkBasket property is set to true.

All transfer operations are executed within the current transaction. If a transaction timeout occurs, then all already executed transfer operations are rolled back.

The action associated to this method is TaskActions.TRANSFERTOWORKBASKET.

This method is not supported in archive mode.

Parameters:
tkiids - An array of task instance IDs that are used to identify the tasks to be transferred.
workBasketName - The name of the work basket the tasks are to be transferred to. The work basket name must not contain any replacement variables.

Returns:
List - A list of TaskResult objects, one for every task instance specified. Refer to TaskResult.

If a single transfer operation fails because any of the following exceptions has been thrown, then the result object contains the respective exception. Otherwise, the TaskException property is null.

  • com.ibm.task.api.ApplicationVetoException
  • com.ibm.task.api.NotAuthorizedException
  • com.ibm.task.api.ObjectDoesNotExistException
  • com.ibm.task.api.TaskNotInWorkBasketException
  • com.ibm.task.api.WrongTaskStateException
If any of these exceptions is thrown, processing continues. If another exception is thrown, a rollback of the global transaction is enforced, and all transfer operations are undone.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.2.0.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws an InvalidParameterException when the work basket name contains replacement variables.
7.0.0.2 May return a TaskNotInWorkBasketException or a WrongTaskStateException in the list of TaskResult's.

transferToWorkBasket

  1. java.util.List transferToWorkBasket( TKIID[] tkiids,
  2. java.lang.String workBasketName)
  3. throws ArchiveUnsupportedOperationException
  4. IdWrongFormatException
  5. InvalidLengthException
  6. InvalidParameterException
  7. UnexpectedFailureException
  8. CommunicationException
Transfers the specified task instances to the specified work basket using task instance IDs. The caller must be an owner, starter, originator, editor, or administrator of the task instance.

All tasks are marked unread. The isTransferredToWorkBasket property is set to true.

All transfer operations are executed within the current transaction. If a transaction timeout occurs, then all already executed transfer operations are rolled back.

The action associated to this method is TaskActions.TRANSFERTOWORKBASKET.

This method is not supported in archive mode.

Parameters:
tkiids - An array of task instance IDs that are used to identify the tasks to be transferred.
workBasketName - The name of the work basket the tasks are to be transferred to. The work basket name must not contain any replacement variables.

Returns:
List - A list of TaskResult objects, one for every task instance specified. Refer to TaskResult.

If a single transfer operation fails because any of the following exceptions has been thrown, then the result object contains the respective exception. Otherwise, the TaskException property is null.

  • com.ibm.task.api.ApplicationVetoException
  • com.ibm.task.api.NotAuthorizedException
  • com.ibm.task.api.ObjectDoesNotExistException
  • com.ibm.task.api.TaskNotInWorkBasketException
  • com.ibm.task.api.WrongTaskStateException
If any of these exceptions is thrown, processing continues. If another exception is thrown, a rollback of the global transaction is enforced, and all transfer operations are undone.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.2.0.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Throws an InvalidParameterException when the work basket name contains replacement variables.
7.0.0.2 May return a TaskNotInWorkBasketException or a WrongTaskStateException in the list of TaskResult's.

transferWorkItem

  1. void transferWorkItem(java.lang.String identifier,
  2. int assignmentReason,
  3. java.lang.String fromOwner,
  4. java.lang.String toOwner)
  5. throws ApplicationVetoException
  6. ArchiveUnsupportedOperationException
  7. EverybodyWorkItemException
  8. IdWrongFormatException
  9. IdWrongTypeException
  10. InvalidAssignmentReasonException
  11. InvalidLengthException
  12. NotAuthorizedException
  13. UserDoesNotExistException
  14. WorkItemDoesNotExistException
  15. ObjectDoesNotExistException
  16. ParameterNullException
  17. TaskDelegationNotSupportedException
  18. WorkItemManagerException
  19. WrongKindException
  20. WrongStateException
  21. UnexpectedFailureException
  22. CommunicationException
Transfers the specified work item using a string representation of the task or escalation instance ID.

When work items of a task instance are transferred, then the caller must be an owner, starter, originator, or administrator of the task instance. The task can be escalated. suspended, or waiting for subtasks.

When work items of an escalation instance are transferred, then the caller must be an administrator of the associated task instance. "Escalation receiver" work items can be transferred when the task is escalated, that is, the escalation is in the escalated state. An e-mail is not sent to the user or group that receives the transferred work item.

The following specific rules apply for the transfer of work items:

  • Work items assigned to "everybody" cannot be transferred.
  • The owner of a task instance can transfer the "owner" work item to a potential owner or an administrator of the task instance.
  • The starter of a task instance can transfer the "starter" work item to a potential starter or an administrator of the task instance. A "starter" work item can be transferred in the expired, terminated, finished, failed, and running state.
  • The originator of a task instance can transfer the "originator" work item to a potential instance creator or an administrator of the task instance.
  • The originator of a task instance can transfer a "potential starter" work item to any person. A "potential starter" work item can be transferred in the inactive state.
  • The administrator of a task instance can transfer all work items to any person. A "starter" work item can be transferred in the expired, terminated, finished, failed, and running state. A "potential starter" work item can be transferred in the inactive state. A "reader" or "administrator" work items can be transferred in all but the inactive state. A "potential owner" or "editor" work item can be transferred in the ready or claimed state. An "escalation receiver" work item can be transferred in the ready, running, or claimed state.

The action associated to this method is TaskActions.TRANSFERWORKITEM or EscalationActions.TRANSFERWORKITEM.

This method is not supported in archive mode.

Parameters:
identifier - A string representation of the task or escalation instance ID that is used to identify the work item to be transferred.
assignmentReason - The reason why the work item is assigned - refer to the work item assignment reasons.
fromOwner - The user ID or the name of the group the work item currently belongs to.
toOwner - The user ID or the name of the group the work item is to be transferred to. Work items can be transferred from a user to a user or from a group of users to a group of users. If a user work item is transferred, it is checked whether the user transferred to exists but the check may be executed case insensitively. The check can be suppressed by setting the 'SupportVirtualUserIdsForPeopleAssignments' custom property of the Human Task Manager configuration to 'true'.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.0.2 Supports escalation instances.
6.0.2 Throws a TaskDelegationNotSupportedException when task delegation is not supported.
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

transferWorkItem

  1. void transferWorkItem(ESIID esiid,
  2. int assignmentReason,
  3. java.lang.String fromOwner,
  4. java.lang.String toOwner)
  5. throws ApplicationVetoException
  6. ArchiveUnsupportedOperationException
  7. EverybodyWorkItemException
  8. IdWrongFormatException
  9. InvalidAssignmentReasonException
  10. InvalidLengthException
  11. NotAuthorizedException
  12. UserDoesNotExistException
  13. WorkItemDoesNotExistException
  14. ObjectDoesNotExistException
  15. ParameterNullException
  16. TaskDelegationNotSupportedException
  17. WorkItemManagerException
  18. WrongKindException
  19. WrongStateException
  20. UnexpectedFailureException
  21. CommunicationException
Transfers the specified work item for the specified escalation instance using the escalation instance ID.

The caller must be an administrator of the associated task instance. "Escalation receiver" work items can be transferred when the task is escalated, that is, the escalation is in the escalated state. An e-mail is not sent to the user or group that receives the transferred work item.

The action associated to this method is EscalationActions.TRANSFERWORKITEM.

This method is not supported in archive mode.

Parameters:
esiid - The escalation instance ID that is used to identify the work item to be transferred.
assignmentReason - The reason why the work item is assigned - refer to the work item assignment reasons.
fromOwner - The user ID or the name of the group the work item currently belongs to.
toOwner - The user ID or the name of the group the work item is to be transferred to. Work items can be transferred from a user to a user or from a group of users to a group of users. If a user work item is transferred, it is checked whether the user transferred to exists but the check may be executed case insensitively. The check can be suppressed by setting the 'SupportVirtualUserIdsForPeopleAssignments' custom property of the Human Task Manager configuration to 'true'.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.2

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

transferWorkItem

  1. void transferWorkItem(TKIID tkiid,
  2. int assignmentReason,
  3. java.lang.String fromOwner,
  4. java.lang.String toOwner)
  5. throws ApplicationVetoException
  6. ArchiveUnsupportedOperationException
  7. EverybodyWorkItemException
  8. IdWrongFormatException
  9. InvalidAssignmentReasonException
  10. InvalidLengthException
  11. NotAuthorizedException
  12. UserDoesNotExistException
  13. WorkItemDoesNotExistException
  14. ObjectDoesNotExistException
  15. ParameterNullException
  16. TaskDelegationNotSupportedException
  17. WorkItemManagerException
  18. WrongKindException
  19. WrongStateException
  20. UnexpectedFailureException
  21. CommunicationException
Transfers the specified work item for the specified task instance using the task instance ID.

The caller must be an owner, starter, originator, or administrator of the task instance. The task can be escalated. suspended, or waiting for subtasks.

The following specific rules apply for the transfer of work items:

  • Work items assigned to "everybody" cannot be transferred.
  • The owner of a task instance can transfer the "owner" work item to a potential owner or an administrator of the task instance.
  • The starter of a task instance can transfer the "starter" work item to a potential starter or an administrator of the task instance. A "starter" work item can be transferred in the expired, terminated, finished, failed, and running state.
  • The originator of a task instance can transfer the "originator" work item to a potential instance creator or an administrator of the task instance.
  • The originator of a task instance can transfer a "potential starter" work item to any person. A "potential starter" work item can be transferred in the inactive state.
  • The administrator of a task instance can transfer all work items to any person. A "starter" work item can be transferred in the expired, terminated, finished, failed, and running state. A "potential starter" work item can be transferred in the inactive state. A "reader" or "administrator" work item can be transferred in all but the inactive state. A "potential owner" or "editor" work item can be transferred in the ready or claimed state.

The action associated to this method is TaskActions.TRANSFERWORKITEM.

This method is not supported in archive mode.

Parameters:
tkiid - The task instance ID that is used to identify the work item to be transferred.
assignmentReason - The reason why the work item is assigned - refer to the work item assignment reasons.
fromOwner - The user ID or the name of the group the work item currently belongs to.
toOwner - The user ID or the name of the group the work item is to be transferred to. Work items can be transferred from a user to a user or from a group of users to a group of users. If a user work item is transferred, it is checked whether the user transferred to exists but the check may be executed case insensitively. The check can be suppressed by setting the 'SupportVirtualUserIdsForPeopleAssignments' custom property of the Human Task Manager configuration to 'true'.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
5.1.1

Change History

Release Modification
6.0.2 Throws a TaskDelegationNotSupportedException when task delegation is not supported.
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

transferWorkItem

  1. java.util.List transferWorkItem( java.lang.String[] identifiers,
  2. int assignmentReason,
  3. java.lang.String fromOwner,
  4. java.lang.String toOwner)
  5. throws ArchiveUnsupportedOperationException
  6. IdWrongFormatException
  7. IdWrongTypeException
  8. InvalidAssignmentReasonException
  9. InvalidLengthException
  10. ParameterNullException
  11. WorkItemNotFoundException
  12. WorkItemManagerException
  13. UnexpectedFailureException
  14. CommunicationException
Transfers the specified work items for the specified escalation or task instances using string representations of escalation or task instance IDs.

Note: All transfer work item operations are executed within the current transaction. If a transaction timeout occurs, then all already executed transfer operations are rolled back. Because of this, you may consider to use bulkTransferWorkItem.

When work items of a task instance are transferred, then the caller must be an owner, starter, originator, or administrator of the task instances. The task can be escalated. suspended, or waiting for subtasks.

When work items of an escalation instance are transferred, then the caller must be an administrator of the associated task instances. "Escalation receiver" work items can be transferred when the task is escalated, that is, the escalation is in the escalated state. An e-mail is not sent to the user or group that receives the transferred work item.

The following specific rules apply for the transfer of work items:

  • Work items assigned to "everybody" cannot be transferred.
  • The owner of a task instance can transfer the "owner" work item to a potential owner or an administrator of the task instance.
  • The starter of a task instance can transfer the "starter" work item to a potential starter or an administrator of the task instance. A "starter" work item can be transferred in the expired, terminated, finished, failed, and running state.
  • The originator of a task instance can transfer the "originator" work item to a potential instance creator or an administrator of the task instance.
  • The originator of a task instance can transfer a "potential starter" work item to any person. A "potential starter" work item can be transferred in the inactive state.
  • The administrator of a task instance can transfer all work items to any person. A "starter" work item can be transferred in the expired, terminated, finished, failed, and running state. A "potential starter" work item can be transferred in the inactive state. A "reader" or "administrator" work items can be transferred in all but the inactive state. A "potential owner" or "editor" work item can be transferred in the ready or claimed state. An "escalation receiver" work item can be transferred in the ready, running, or claimed state.

The action associated to this method is TaskActions.TRANSFERWORKITEM or EscalationActions.TRANSFERWORKITEM.

This method is not supported in archive mode.

Parameters:
identifiers - An array of either escalation instance IDs or task instance IDs that are used to identify the work items to be transferred.
assignmentReason - The reason why the work item is assigned - refer to the work item assignment reasons.
fromOwner - The user ID or the name of the group the work item currently belongs to.
toOwner - The user ID or the name of the group the work item is to be transferred to. Work items can be transferred from a user to a user or from a group of users to a group of users. If a user work item is transferred, it is checked whether the user transferred to exists but the check may be executed case insensitively. The check can be suppressed by setting the 'SupportVirtualUserIdsForPeopleAssignments' custom property of the Human Task Manager configuration to 'true'.

Returns:
List - A list of EscalationResult or TaskResult objects, one for every escalation or task instance specified. Refer to EscalationResult or to TaskResult.

If a single transfer operation fails because any of the following exceptions has been thrown, then the result object contains the respective exception. Otherwise, the TaskException property is null.

  • com.ibm.task.api.ApplicationVetoException
  • com.ibm.task.api.NotAuthorizedException
  • com.ibm.task.api.UserDoesNotExistException
  • com.ibm.task.api.ObjectDoesNotExistException
  • com.ibm.task.api.TaskDelegationNotSupportedException
  • com.ibm.task.api.WrongKindException
  • com.ibm.task.api.WrongStateException
If any of these exceptions is thrown, processing continues. If another exception is thrown, a rollback of the global transaction is enforced, and all transfer operations are undone.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

transferWorkItem

  1. java.util.List transferWorkItem( ESIID[] esiids,
  2. int assignmentReason,
  3. java.lang.String fromOwner,
  4. java.lang.String toOwner)
  5. throws ArchiveUnsupportedOperationException
  6. IdWrongFormatException
  7. InvalidAssignmentReasonException
  8. InvalidLengthException
  9. ParameterNullException
  10. WorkItemNotFoundException
  11. WorkItemManagerException
  12. UnexpectedFailureException
  13. CommunicationException
Transfers the specified work items for the specified escalation instances using escalation instance IDs.

Note: All transfer work item operations are executed within the current transaction. If a transaction timeout occurs, then all already executed transfer operations are rolled back. Because of this, you may consider to use bulkTransferWorkItem.

The caller must be an administrator of the associated task instances. "Escalation receiver" work items can be transferred when the task is escalated, that is, the escalation is in the escalated state. An e-mail is not sent to the user or group that receives the transferred work item.

The action associated to this method is EscalationActions.TRANSFERWORKITEM.

This method is not supported in archive mode.

Parameters:
esiids - An array of escalation instance IDs that are used to identify the work items to be transferred.
assignmentReason - The reason why the work item is assigned - refer to the work item assignment reasons.
fromOwner - The user ID or the name of the group the work item currently belongs to.
toOwner - The user ID or the name of the group the work item is to be transferred to. Work items can be transferred from a user to a user or from a group of users to a group of users. If a user work item is transferred, it is checked whether the user transferred to exists but the check may be executed case insensitively. The check can be suppressed by setting the 'SupportVirtualUserIdsForPeopleAssignments' custom property of the Human Task Manager configuration to 'true'.

Returns:
List - A list of EscalationResult objects, one for every escalation instance specified. Refer to EscalationResult.

If a single transfer operation fails because any of the following exceptions has been thrown, then the result object contains the respective exception. Otherwise, the TaskException property is null.

  • com.ibm.task.api.ApplicationVetoException
  • com.ibm.task.api.NotAuthorizedException
  • com.ibm.task.api.EscalationDoesNotExistException
  • com.ibm.task.api.TaskDelegationNotSupportedException
  • com.ibm.task.api.UserDoesNotExistException
  • com.ibm.task.api.WrongKindException
  • com.ibm.task.api.WrongStateException
If any of these exceptions is thrown, processing continues. If another exception is thrown, a rollback of the global transaction is enforced, and all transfer operations are undone.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

transferWorkItem

  1. java.util.List transferWorkItem( TKIID[] tkiids,
  2. int assignmentReason,
  3. java.lang.String fromOwner,
  4. java.lang.String toOwner)
  5. throws ArchiveUnsupportedOperationException
  6. IdWrongFormatException
  7. InvalidAssignmentReasonException
  8. InvalidLengthException
  9. ParameterNullException
  10. WorkItemNotFoundException
  11. WorkItemManagerException
  12. UnexpectedFailureException
  13. CommunicationException
Transfers the specified work items for the specified task instances using task instance IDs.

Note: All transfer work item operations are executed within the current transaction. If a transaction timeout occurs, then all already executed transfer operations are rolled back. Because of this, you may consider to use bulkTransferWorkItem.

The caller must be an owner, starter, originator, or administrator of the task instances. The task can be escalated. suspended, or waiting for subtasks.

The following specific rules apply for the transfer of work items:

  • Work items assigned to "everybody" cannot be transferred.
  • The owner of a task instance can transfer the "owner" work item to a potential owner or an administrator of the task instance.
  • The starter of a task instance can transfer the "starter" work item to a potential starter or an administrator of the task instance. A "starter" work item can be transferred in the expired, terminated, finished, failed, and running state.
  • The originator of a task instance can transfer the "originator" work item to a potential instance creator or an administrator of the task instance.
  • The originator of a task instance can transfer a "potential starter" work item to any person. A "potential starter" work item can be transferred in the inactive state.
  • The administrator of a task instance can transfer all work items to any person. A "starter" work item can be transferred in the expired, terminated, finished, failed, and running state. A "potential starter" work item can be transferred in the inactive state. A "reader" or "administrator" work item can be transferred in all but the inactive state. A "potential owner" or "editor" work item can be transferred in the ready or claimed state.

The action associated to this method is TaskActions.TRANSFERWORKITEM.

This method is not supported in archive mode.

Parameters:
tkiids - An array of task instance IDs that are used to identify the work items to be transferred.
assignmentReason - The reason why the work item is assigned - refer to the work item assignment reasons.
fromOwner - The user ID or the name of the group the work item currently belongs to.
toOwner - The user ID or the name of the group the work item is to be transferred to. Work items can be transferred from a user to a user or from a group of users to a group of users. If a user work item is transferred, it is checked whether the user transferred to exists but the check may be executed case insensitively. The check can be suppressed by setting the 'SupportVirtualUserIdsForPeopleAssignments' custom property of the Human Task Manager configuration to 'true'.

Returns:
List - A list of TaskResult objects, one for every task instance specified. Refer to TaskResult.

If a single transfer operation fails because any of the following exceptions has been thrown, then the result object contains the respective exception. Otherwise, the TaskException property is null.

  • com.ibm.task.api.ApplicationVetoException
  • com.ibm.task.api.NotAuthorizedException
  • com.ibm.task.api.TaskDoesNotExistException
  • com.ibm.task.api.TaskDelegationNotSupportedException
  • com.ibm.task.api.UserDoesNotExistException
  • com.ibm.task.api.WrongKindException
  • com.ibm.task.api.WrongStateException
If any of these exceptions is thrown, processing continues. If another exception is thrown, a rollback of the global transaction is enforced, and all transfer operations are undone.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

triggerEscalation

  1. void triggerEscalation(java.lang.String esiid)
  2. throws ApplicationVetoException
  3. ArchiveUnsupportedOperationException
  4. CannotCreateWorkItemException
  5. EscalationNotificationException
  6. IdWrongFormatException
  7. IdWrongTypeException
  8. NotAuthorizedException
  9. ObjectDoesNotExistException
  10. SchedulingFailedException
  11. WrongStateException
  12. UnexpectedFailureException
  13. CommunicationException
Manually triggers the specified escalation instance using a string representation of the escalation instance ID.

The escalation must be in the waiting state. The caller must be an administrator of the escalation.

The action associated to this method is EscalationActions.TRIGGERESCALATION.

This method is not supported in archive mode.

Parameters:
esiid - A string representation of the escalation instance ID that is used to identify the escalation to be triggered.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

Change History

Release Modification
7.0.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

triggerEscalation

  1. void triggerEscalation(ESIID esiid)
  2. throws ApplicationVetoException
  3. ArchiveUnsupportedOperationException
  4. CannotCreateWorkItemException
  5. EscalationNotificationException
  6. IdWrongFormatException
  7. NotAuthorizedException
  8. ObjectDoesNotExistException
  9. SchedulingFailedException
  10. WrongStateException
  11. UnexpectedFailureException
  12. CommunicationException
Manually triggers the specified escalation instance using the escalation instance ID.

The escalation must be in the waiting state. The caller must be an administrator of the escalation.

The action associated to this method is EscalationActions.TRIGGERESCALATION.

This method is not supported in archive mode.

Parameters:
esiid - The escalation instance ID that is used to identify the escalation to be triggered.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

Change History

Release Modification
7.0.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

update

  1. void update(Task task)
  2. throws ApplicationVetoException
  3. ArchiveUnsupportedOperationException
  4. InvalidLengthException
  5. NotAuthorizedException
  6. ObjectDoesNotExistException
  7. ParameterNullException
  8. PropertyVetoException
  9. WrongKindException
  10. WrongStateException
  11. UnexpectedFailureException
  12. CommunicationException
Updates a persistently stored task instance. The task and the properties to be updated are identified by the provided task object. Only the properties changed within the previously retrieved task instance are updated. When the same task property is updated in parallel, the last writer wins.

  • business relevance flag
    • The caller must be the owner, the starter, the originator, an editor, or an administrator of the task.
    • The task can be a stand-alone task that is derived from a task template or created at Runtime.
    • The task can be in an inactive, ready, running, or claimed state and can be escalated.
  • context authorization
    • The caller must be the originator or an administrator of the task.
    • The task can be in an inline task that is derived from a task template.
    • The task can be in an inactive or ready state, can be escalated, or waiting for subtasks.
  • custom properties
  • deletion time
    • The caller must be the originator or an administrator of the task.
    • The task can be a stand-alone task with "peer" autonomy or an invocation aka originating task that is derived from a task template or created at Runtime. Inline, child, follow-on, or subtasks are not supported.
    • The task can be in an end state, can be escalated.
    • Note, when you update this time, a duration until deletion is not calculated when you restart the task instance. A deletion timer is not set up.
  • description
    • The caller must be the owner, the starter, the originator, an editor, or an administrator of the task.
    • The task can be a stand-alone task that is derived from a task template or created at Runtime.
    • The task can be in all states, can be escalated, or waiting for subtasks.
  • display name
    • The caller must be the owner, the starter, the originator, an editor, or an administrator of the task.
    • The task can be a stand-alone task that is derived from a task template or created at Runtime.
    • The task can be in all states, can be escalated, or waiting for subtasks.
  • due time
    • The caller must be the owner, the starter, the originator, an editor, or an administrator of the task.
    • The task can be a stand-alone or inline task that is derived from a task template or created at Runtime.
    • The task can be in a ready, running, or claimed state, can be escalated, or waiting for subtasks.
    • Note, when you update this time, a duration until due is not calculated when you restart the task instance.
  • duration until deleted
    • The caller must be the originator or an administrator of the task.
    • The task can be a stand-alone task with "peer" autonomy or an invocation aka originating task that is derived from a task template or created at Runtime. Inline, child, follow-on, or subtasks are not supported.
    • The task can be in an inactive, ready, running, claimed, or end state, can be escalated, or waiting for subtasks.
    • Note, this is the duration taken when restarting the task instance.
  • duration until due
    • The caller must be the owner, the starter, the originator, an editor, or an administrator of the task.
    • The task can be a stand-alone or inline task that is derived from a task template or created at Runtime.
    • The task can be in an inactive, ready, running, or claimed state, can be escalated, or waiting for subtasks.
    • Note, this is the duration taken when restarting the task instance.
  • duration until expires
    • The caller must be the originator or an administrator of the task.
    • The task can be derived from a task template or created at Runtime. Inline, child, and follow-on tasks are not supported.
    • The task can be in an inactive, ready, running, claimed, or forwarded state, can be escalated, or waiting for subtasks.
    • Note, this is the duration taken when restarting the task instance.
  • escalation state
    • The caller must be the originator, starter, or an administrator of the task.
    • The task can be derived from a task template or created at Runtime.
    • The task can be in a ready, running, claimed, or forwarded state, can be escalated, or waiting for subtasks. If the task belongs to a chain of follow-on tasks, all tasks in the chain will be escalated or de-escalated.
  • event handler name
    • The caller must be the originator or an administrator of the task.
    • The task can be a stand-alone or inline task that is derived from a task template or created at Runtime.
    • The task can be in all states, can be escalated, or waiting for subtasks.
  • expiration time
    • The caller must be the originator or an administrator of the task.
    • The task can be derived from a task template or created at Runtime. Inline, child, and follow-on tasks are not supported.
    • The task can be in a ready, running, claimed, or forwarded state, can be escalated, or waiting for subtasks.
    • Note, when you update this time, a duration until expiration is not calculated when you restart the task instance. An expiration timer is not set up.
  • name
    • The caller must be the owner, the starter, the originator, an editor, or an administrator of the task.
    • The task can be a stand-alone task that is derived from a task template or created at Runtime.
    • The task can be in all states, can be escalated, or waiting for subtasks.
  • namespace
    • The caller must be the owner, the starter, the originator, an editor, or an administrator of the task.
    • The task can be a stand-alone task that is derived from a task template or created at Runtime.
    • The task can be in all states, can be escalated, or waiting for subtasks.
  • parent context ID
    • The caller must be the originator or an administrator of the task.
    • The task can be a stand-alone task that is derived from a task template or created at Runtime. It can, however, not be a to-do task with "child" autonomy, not be a subtask, or follow-on task,
    • The task can be in all states, can be escalated, or waiting for subtasks.
  • priority
    • The caller must be the potential starter, the starter, the originator, or an administrator of the task.
    • The task can be a stand-alone or inline task that is derived from a task template or created at Runtime.
    • The task can be in an inactive, ready, running, or claimed state, can be escalated, or waiting for subtasks.
  • read flag
    • The caller must have at least reader authority for the task.
    • The task can be a stand-alone or inline task that is derived from a task template or created at Runtime.
    • The task can be in any state, can be escalated, or waiting for subtasks.
  • supports claim if suspended flag
    • The caller must be the owner, the originator, an editor, or an administrator of the task.
    • The task can be a stand-alone or inline to-do task or a collaboration task that is derived from a task template or created at Runtime. Note that to-do and collaboration tasks are also known as participating and human tasks.
    • The task can be in an inactive or ready state and can be escalated.
  • supports delegation flag
    • The caller must be the owner or an administrator of the task.
    • The task can be a stand-alone or inline task that is derived from a task template or created at Runtime.
    • The task can be in an inactive, ready, running, or claimed state, can be escalated, or waiting for subtasks.
  • supports follow-on tasks flag
    • The caller must be the owner or an administrator of the task.
    • The task can be a stand-alone or inline to-do task or a collaboration task that is derived from a task template or created at Runtime. Note that to-do and collaboration tasks are also known as participating and human tasks.
    • The task can be in an inactive, ready, running, or claimed state, can be escalated, or waiting for subtasks.
  • supports subtasks flag
    • The caller must be the owner or an administrator of the task.
    • The task can be a stand-alone or inline to-do task or a collaboration task that is derived from a task template or created at Runtime. Note that to-do and collaboration tasks are also known as participating and human tasks.
    • The task can be in an inactive, ready, running, or claimed state, and can be escalated.
  • type
    • The caller must be the owner, the starter, the originator, an editor, or an administrator of the task.
    • The task can be a stand-alone or inline task that is derived from a task template or created at Runtime.
    • The task can be in all states, can be escalated, or waiting for subtasks.
  • work basket name
    • The caller must be the the originator of the task.
    • The task can be a stand-alone or inline task that is derived from a task template or created at Runtime.
    • The task must be in the inactive state. Note that setting the work basket name does not update the isTransferredToWorkBasket property.

The action associated to this method is TaskActions.UPDATE.

This method is not supported in archive mode.

Parameters:
task - The task instance and the properties to be updated.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0

Change History

Release Modification
6.0.2 Allows to update the business relevance flag, the context authorization, the duration until deleted, the event handler name, namespace, parent context ID, the claim if suspended flag, the supports delegation flag, the supports follow-on flag, the supports subtasks flag, and the type.
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.
7.0 Allows to update the deletion time, the due time, the expiration time, the duration until expiration, the escalation state, the read property, and the work basket name.

update

  1. void update(java.lang.String tkiid,
  2. TaskModel taskModel,
  3. java.lang.String applicationName,
  4. java.lang.String parentContext,
  5. ClientObjectWrapper input)
  6. throws ApplicationVetoException
  7. ArchiveUnsupportedOperationException
  8. CannotCreateWorkItemException
  9. IdWrongFormatException
  10. IdWrongTypeException
  11. InvalidLengthException
  12. NotAuthorizedException
  13. ObjectDoesNotExistException
  14. ParameterNullException
  15. WrongKindException
  16. WrongMessageTypeException
  17. WrongStateException
  18. UnexpectedFailureException
  19. TaskDeploymentException
  20. TELValidationException
  21. CommunicationException
Updates a task instance that has been created at Runtime using a string representation of the task instance ID. All properties are changed according to the values provided by the task model. Actually, the specified task instance is deleted and a new task instance is created.

The task must still be in the inactive state. The caller must be the originator of the task instance.

The action associated to this method is TaskActions.UPDATEINACTIVETASK.

This method is not supported in archive mode.

Parameters:
tkiid - A string representation of the task instance ID that is used to identify the task instance to be updated.
taskModel - The model that specifies the task properties and their new values.
applicationName - The name of the enterprise application that contains the message or business calendar definitions used in the TaskModel. If the message definitions are simple types only or if you do not use a business calendar, null may be specified.
parentContext - The object ID (ACOID) or the name of the application component to be associated. If not specified, the parent context of the updated task instance is kept.
input - The input message. If not specified, the input message of the updated task instance is kept, if any. Note that the object wrapped by the ClientObjectWrapper must be serializable.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

update

  1. void update(TKIID tkiid,
  2. TaskModel taskModel,
  3. java.lang.String applicationName,
  4. java.lang.String parentContext,
  5. ClientObjectWrapper input)
  6. throws ApplicationVetoException
  7. ArchiveUnsupportedOperationException
  8. CannotCreateWorkItemException
  9. IdWrongFormatException
  10. IdWrongTypeException
  11. InvalidLengthException
  12. NotAuthorizedException
  13. ObjectDoesNotExistException
  14. ParameterNullException
  15. WrongKindException
  16. WrongMessageTypeException
  17. WrongStateException
  18. UnexpectedFailureException
  19. TaskDeploymentException
  20. TELValidationException
  21. CommunicationException
Updates a task instance that has been created at Runtime using the task instance ID. All properties are changed according to the values provided by the task model. Actually, the specified task instance is deleted and a new task instance is created.

The task must still be in the inactive state. The caller must be the originator of the task instance.

The action associated to this method is TaskActions.UPDATEINACTIVETASK.

This method is not supported in archive mode.

Parameters:
tkiid - The task instance ID that is used to identify the task instance to be updated.
taskModel - The model that specifies the task properties and their new values.
applicationName - The name of the enterprise application that contains the message or business calendar definitions used in the TaskModel. If the message definitions are simple types only or if you do not use a business calendar, null may be specified.
parentContext - The object ID (ACOID) or the name of the application component to be associated. If not specified, the parent context of the updated task instance is kept.
input - The input message. If not specified, the input message of the updated task instance is kept, if any. Note that the object wrapped by the ClientObjectWrapper must be serializable.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
6.0.1

Change History

Release Modification
6.2.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

update

  1. void update(Escalation escalation)
  2. throws ApplicationVetoException
  3. ArchiveUnsupportedOperationException
  4. InvalidLengthException
  5. NotAuthorizedException
  6. ObjectDoesNotExistException
  7. ParameterNullException
  8. PropertyVetoException
  9. WrongStateException
  10. UnexpectedFailureException
  11. CommunicationException
Updates a persistently stored escalation instance. The escalation and the properties to be updated are identified by the provided escalation object. Only the properties changed within the previously retrieved escalation instance are updated. When the same escalation property is updated in parallel, the last writer wins.

  • duration until escalated
    • The caller must be an administrator of the escalation.
    • The escalation can be in an inactive or waiting state,
  • duration until repeated
    • The caller must be an administrator of the escalation.
    • The escalation can be in an inactive, waiting, or escalated state,
    • Any running timer is canceled. A new timer is created.
  • escalation time
    • The caller must be an administrator of the escalation.
    • The escalation can be in a waiting or escalated state,
    • Any running timer is canceled. A new timer is created. Note that if no timer is running, the new timer is a only run once.
  • name
    • The caller must be an administrator of the escalation.
    • The escalation can be in an inactive, waiting, or escalated state,

The action associated to this method is EscalationActions.UPDATE.

This method is not supported in archive mode.

Parameters:
escalation - The escalation instance and the properties to be updated.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

Change History

Release Modification
7.0.0.3 Throws an ArchiveUnsupportedOperationException when called in archive mode.

findQueryTableMetaData

  1. java.util.List findQueryTableMetaData( MetaDataOptions metaDataOptions)
  2. throws UnexpectedFailureException
  3. TaskException
  4. CommunicationException
Queries the meta data of query tables.

You can specify options to limit the number of query tables for which the meta data is returned.

Note that the TaskException contains a com.ibm.bpe.api.ProcessException.

Parameters:
metaDataOptions - The options to be applied - refer to MetaDataOptions. If no restrictions are to be applied, null can be specified.

Returns:
List - A list of QueryTableMetaData objects.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

getQueryTableMetaData

  1. QueryTableMetaData getQueryTableMetaData( java.lang.String queryTableName,
  2. java.util.Locale locale)
  3. throws ParameterNullException
  4. UnexpectedFailureException
  5. TaskException
  6. CommunicationException
Returns the meta data of the specified query table.

Note that the TaskException contains a com.ibm.bpe.api.ProcessException.

Parameters:
queryTableName - The name of the query table.
locale - The locale that is used to calculate the value of the $LOCALE variable. If no locale is specified, defaults are used for the calculation.

Returns:
QueryTableMetaData - The meta data of the query table - refer to QueryTableMetaData.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

queryEntities

  1. EntityResultSet queryEntities(java.lang.String queryTableName,
  2. FilterOptions filterOptions,
  3. AuthorizationOptions authorizationOptions,
  4. java.util.List parameters)
  5. throws InvalidParameterException
  6. NotAuthorizedException
  7. ParameterNullException
  8. UserDoesNotExistException
  9. UserRegistryException
  10. UnexpectedFailureException
  11. TaskException
  12. CommunicationException
Queries entities using the specified query table.

You can specify filter and authorization options to limit the number of entities returned and values for parameters used in query table filters and selection criteria.

Note that the TaskException contains a com.ibm.bpe.api.ProcessException.

Parameters:
queryTableName - The name of the query table.
filterOptions - The filter options to be applied in addition to any filters defined for the query table. Refer to FilterOptions.
authorizationOptions - The authorization options to be applied in addition to any authorization specifications defined for the query table.

Authorization options can be specified for predefined query tables that contain instance data or for composite query tables that define a primary query table which contains instance data and that use instance-based authorization. If authorization options are specified for query tables that do not contain instance but template data, a NotAuthorizedException is thrown. They are ignored for supplemental query tables.

System administrators and monitors can use the AdminAuthorizationOptions to run queries that need special authorization, for example, to run a query on behalf of another user. These options must be specified when the query is run on predefined query tables. When the query is run on composite query tables and the primary view contains template data, administrative options must be specified if role-based authorization is required. When specified for a predefined query table that contains instance data or for a composite query table with a primary view that contains instance data, then all data contained in the query table is returned.

Refer to AuthorizationOptions or AdminAuthorizationOptions.

parameters - A list of Parameter objects to set values for parameters used in query table filters and selection criteria. Refer to Parameter.

Returns:
EntityResultSet - The entity result set containing the qualifying entities. If no qualifying entities are found, an empty result set is returned. Refer to EntityResultSet for information on how to analyze the result set.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

queryEntityCount

  1. int queryEntityCount(java.lang.String queryTableName,
  2. FilterOptions filterOptions,
  3. AuthorizationOptions authorizationOptions,
  4. java.util.List parameters)
  5. throws InvalidParameterException
  6. NotAuthorizedException
  7. ParameterNullException
  8. UserDoesNotExistException
  9. UserRegistryException
  10. UnexpectedFailureException
  11. TaskException
  12. CommunicationException
Counts qualifying entities of a potential query for entities.

Note that the TaskException contains a com.ibm.bpe.api.ProcessException.

Parameters:
queryTableName - The name of the query table.
filterOptions - The filter options to limit the number of entities and attributes. Refer to FilterOptions.
authorizationOptions - The authorization options to limit the number of entities. Refer to AuthorizationOptions or AdminAuthorizationOptions.
parameters - A list of Parameter objects to replace parameters in the query condition. Refer to Parameter.

Returns:
int - The number of qualifying entities.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

queryRows

  1. RowResultSet queryRows(java.lang.String queryTableName,
  2. FilterOptions filterOptions,
  3. AuthorizationOptions authorizationOptions,
  4. java.util.List parameters)
  5. throws InvalidParameterException
  6. NotAuthorizedException
  7. ParameterNullException
  8. UserDoesNotExistException
  9. UserRegistryException
  10. UnexpectedFailureException
  11. TaskException
  12. CommunicationException
Queries attributes using the specified query table.

You can specify filter and authorization options to limit the number of rows returned and values for parameters used in query table filters and selection criteria.

Note that the TaskException contains a com.ibm.bpe.api.ProcessException.

Parameters:
queryTableName - The name of the query table.
filterOptions - The filter options to be applied in addition to any filters defined for the query table. Refer to FilterOptions.
authorizationOptions - The authorization options to be applied in addition to any authorization specifications defined for the query table.

Authorization options can be specified for predefined query tables that contain instance data or for composite query tables that define a primary query table which contains instance data and that use instance-based authorization. If authorization options are specified for query tables that do not contain instance but template data, a NotAuthorizedException is thrown. They are ignored for supplemental query tables.

System administrators and monitors can use the AdminAuthorizationOptions to run queries that need special authorization, for example, to run a query on behalf of another user. These options must be specified when the predefined query table or the primary view of a composite query table contains template data.

Refer to AuthorizationOptions or AdminAuthorizationOptions.

parameters - A list of Parameter objects to set values for parameters used in query table filters and selection criteria. Refer to Parameter.

Returns:
RowResultSet - The row result set containing the qualifying objects. If no qualifying objects are found, an empty result set is returned. Refer to RowResultSet for information on how to analyze the result set.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0

queryRowCount

  1. int queryRowCount(java.lang.String queryTableName,
  2. FilterOptions filterOptions,
  3. AuthorizationOptions authorizationOptions,
  4. java.util.List parameters)
  5. throws InvalidParameterException
  6. NotAuthorizedException
  7. ParameterNullException
  8. UserDoesNotExistException
  9. UserRegistryException
  10. UnexpectedFailureException
  11. TaskException
  12. CommunicationException
Counts qualifying objects of a potential query table query.

Note that the TaskException contains a com.ibm.bpe.api.ProcessException.

Parameters:
queryTableName - The name of the query table.
filterOptions - The filter options to limit the number of rows or attributes. Refer to FilterOptions.
authorizationOptions - The authorization options to limit the number of rows. Refer to AuthorizationOptions or AdminAuthorizationOptions.
parameters - A list of Parameter objects to replace parameters in the query condition. Refer to Parameter.

Returns:
int - The number of qualifying objects in rows.
Throws:
CommunicationException - Thrown when the method failed due to a communication or system-level failure.

Since:
7.0