com.ibm.task.api
Interface HumanTaskManagerService

All Known Subinterfaces:
HumanTaskManager, LocalHumanTaskManager, LocalHumanTaskManagerService

public interface HumanTaskManagerService

HumanTaskManagerService defines the human task methods that can be called by a local or remote client.


Field Summary
static java.lang.String COPYRIGHT
           
 
Method Summary
 ClientObjectWrapper callTask(java.lang.String tkiid, ClientObjectWrapper input)
          Synchronously executes a previously created originating task using a string representation of the task instance ID.
 ClientObjectWrapper callTask(TKIID tkiid, ClientObjectWrapper input)
          Synchronously executes a previously created originating task using the task instance ID.
 void cancelClaim(java.lang.String tkiid)
          Cancels the claim of a task instance using a string representation of the task instance ID.
 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.
 void cancelClaim(TKIID tkiid)
          Cancels the claim of a task instance using the task instance ID.
 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.
 ClientObjectWrapper claim(java.lang.String tkiid)
          Claims a ready participating or human task instance for user processing using a string representation of the task instance ID.
 Task claim(java.lang.String whereClause, java.lang.String orderByClause, java.util.TimeZone timeZone)
          Claims some ready participating or human task instance for user processing.
 ClientObjectWrapper claim(TKIID tkiid)
          Claims a ready participating or human task instance for user processing using the task instance ID.
 void complete(java.lang.String tkiid)
          Completes a claimed task instance using a string representation of the task instance ID.
 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.
 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.
 void complete(TKIID tkiid)
          Completes a claimed task instance using a string representation of the task instance ID.
 void complete(TKIID tkiid, ClientObjectWrapper output)
          Completes a claimed task instance using a string representation of the task instance ID and passes the result of user processing.
 void complete(TKIID 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.
 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.
 void completeWithFollowOnTask(TKIID tkiid, TKIID followOnID, ClientObjectWrapper input)
          Completes a task instance and starts a follow-on task using the task instance ID.
 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.
 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.
 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.
 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.
 ClientObjectWrapper createAndCallTask(java.lang.String name, java.lang.String namespace, ClientObjectWrapper input)
          Creates and synchronously executes an originating task instance.
 TKIID createAndStartTask(java.lang.String name, java.lang.String namespace, ClientObjectWrapper input, ReplyHandlerWrapper replyHandler)
          Creates and starts a task instance.
 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.
 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.
 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.
 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.
 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.
 ClientObjectWrapper createFaultMessage(java.lang.String tkiid, java.lang.String faultName)
          Creates a fault message for a fault that is defined by the specified task instance using a string representation of the task instance ID.
 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.
 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.
 ClientObjectWrapper createInputMessage(TKIID tkiid)
          Creates an input message for the specified task instance using the task instance ID.
 ClientObjectWrapper createInputMessage(TKTID tktid)
          Creates an input message for the specified task template using the task template ID.
 ClientObjectWrapper createMessage(java.lang.String tkiid, java.lang.String messageTypeName)
          Deprecated. Use createInputMessage, createOutputMessage, createFaultMessage.
 ClientObjectWrapper createMessage(TKIID tkiid, java.lang.String messageTypeName)
          Deprecated. Use createInputMessage, createOutputMessage, createFaultMessage.
 ClientObjectWrapper createOutputMessage(java.lang.String tkiid)
          Creates an output message for the specified task instance using a string representation of the task instance ID.
 ClientObjectWrapper createOutputMessage(TKIID tkiid)
          Creates an output message for the specified task instance using the task instance ID.
 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.
 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.
 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.
 TKIID createTask(java.lang.String name, java.lang.String namespace)
          Creates a task instance.
 TKIID createTask(java.lang.String name, java.lang.String namespace, ClientObjectWrapper input)
          Creates a task instance and specifies an input message.
 TKIID createTask(TaskModel taskModel, java.lang.String applicationName, java.lang.String parentContext)
          Creates a task instance from the specified task model.
 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.
 TKTID createTaskTemplate(TaskModel taskModel, java.lang.String applicationName)
          Creates a task template from the specified task model.
 void createWorkItem(ESIID esiid, int assignmentReason, java.lang.String userID)
          Creates a work item for the specified escalation instance using the escalation instance ID.
 void createWorkItem(java.lang.String identifier, int assignmentReason, java.lang.String userID)
          Creates a work item for the specified task or escalation instance using a string representation of the task or escalation instance ID.
 void createWorkItem(TKIID tkiid, int assignmentReason, java.lang.String userID)
          Creates a work item for the specified task instance using the task instance ID.
 void delete(java.lang.String tkiid)
          Deletes the specified task instance using a string representation of the task instance ID.
 void delete(java.lang.String identifier, boolean deleteInstances)
          Deletes the specified task template using a string representation of the task template ID.
 void delete(TKIID tkiid)
          Deletes the specified task instance using the task instance ID.
 void delete(TKTID tktid, boolean deleteInstances)
          Deletes the specified task template using the task template ID.
 void deleteStoredQuery(java.lang.String storedQueryName)
          Deletes the specified stored query.
 void deleteStoredQuery(java.lang.String userID, java.lang.String storedQueryName)
          Deletes the specified stored query for the specified user.
 void deleteWorkItem(ESIID esiid, int assignmentReason, java.lang.String userID)
          Deletes the specified work item using the escalation instance ID.
 void deleteWorkItem(java.lang.String identifier, int assignmentReason, java.lang.String userID)
          Deletes the specified work item using a string representation of the task or escalation instance ID.
 void deleteWorkItem(TKIID tkiid, int assignmentReason, java.lang.String userID)
          Deletes the specified work item using the task instance ID.
 WorkItem[] getAllWorkItems(ESIID esiid)
          Returns an array of work items that exist for the escalation instance.
 WorkItem[] getAllWorkItems(java.lang.String oid)
          Returns an array of work items that exist for the task or escalation instance.
 WorkItem[] getAllWorkItems(TKIID tkiid)
          Returns an array of work items that exist for the task instance.
 ApplicationComponent getApplicationComponent(ACOID acoid)
          Retrieves the specified application component using the application component ID.
 ApplicationComponent getApplicationComponent(java.lang.String acoid)
          Retrieves the specified application component using a string representation of the application component ID.
 boolean[][] getAvailableActionFlags(java.lang.String[] tkiids)
          Returns the actions that can be called for the specified tasks in their current state by the logged-on user using string representations of the task instance IDs.
 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.
 int[] getAvailableActions(java.lang.String tkiid)
          Returns the actions that can be called in the current task instance state by the logged-on user using a string representation of the task instance ID.
 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.
 BinaryCustomProperty getBinaryCustomProperty(java.lang.String tkiid, java.lang.String propertyName)
          Retrieves the named binary custom property of the specified task instance using a string representation of the task instance ID.
 BinaryCustomProperty getBinaryCustomProperty(TKIID tkiid, java.lang.String propertyName)
          Retrieves the named binary custom property of the specified task instance using the task instance ID.
 java.util.List getBinaryCustomPropertyNames(java.lang.String tkiid)
          Retrieves the names of all binary custom properties of the specified task instance using a string representation of the task instance ID.
 java.util.List getBinaryCustomPropertyNames(TKIID tkiid)
          Retrieves the names of all binary custom properties of the specified task instance using the task instance ID.
 java.util.List getCustomProperties(java.lang.String identifier)
          Retrieves all custom properties of the specified task instance or task template using a string representation of the object ID.
 java.util.List getCustomProperties(TKIID tkiid)
          Retrieves all custom properties of the specified task instance using the task instance ID.
 java.util.List getCustomProperties(TKTID tktid)
          Retrieves all custom properties of the specified task template using the task template ID.
 java.lang.String getCustomProperty(java.lang.String identifier, java.lang.String propertyName)
          Retrieves the named custom property of the specified task instance or task template using a string representation of the object ID.
 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.
 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.
 java.util.List getCustomPropertyNames(java.lang.String identifier)
          Retrieves the names of all custom properties of the specified task instance or task template using a string representation of the object ID.
 java.util.List getCustomPropertyNames(TKIID tkiid)
          Retrieves the names of all custom properties of the specified task instance using the task instance ID.
 java.util.List getCustomPropertyNames(TKTID tktid)
          Retrieves the names of all custom properties of the specified task template using the task template ID.
 java.lang.String getDocumentation(ESIID esiid, java.util.Locale locale)
          Retrieves the documentation of the specified escalation instance using the escalation instance ID.
 java.lang.String getDocumentation(ESTID estid, java.util.Locale locale)
          Retrieves the documentation of the specified escalation template using the escalation template ID.
 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.
 java.lang.String getDocumentation(TKIID tkiid, java.util.Locale locale)
          Retrieves the documentation of the specified task instance using the task instance ID.
 java.lang.String getDocumentation(TKTID tktid, java.util.Locale locale)
          Retrieves the documentation of the specified task template using the task template ID.
 Escalation getEscalation(ESIID esiid)
          Retrieves the specified escalation instance using the escalation instance ID.
 Escalation getEscalation(java.lang.String esiid)
          Retrieves the specified escalation instance using a string representation of the escalation instance ID.
 EscalationTemplate getEscalationTemplate(ESTID estid)
          Retrieves the specified escalation template using the escalation template ID.
 EscalationTemplate getEscalationTemplate(java.lang.String estid)
          Retrieves the specified escalation template using a string representation of the escalation template ID.
 ClientObjectWrapper getFaultMessage(java.lang.String tkiid)
          Retrieves the fault message of the specified task instance using a string representation of the task instance ID.
 ClientObjectWrapper getFaultMessage(TKIID tkiid)
          Retrieves the fault message of the specified task instance using the task instance ID.
 java.util.List getFaultNames(java.lang.String tkiid)
          Retrieves the fault names defined for the specified task instance using a string representation of the task instance ID.
 java.util.List getFaultNames(TKIID tkiid)
          Retrieves the fault names defined for the specified task instance using the task instance ID.
 ClientObjectWrapper getInputMessage(java.lang.String tkiid)
          Retrieves the input message of the specified task instance using a string representation of the task instance ID.
 ClientObjectWrapper getInputMessage(TKIID tkiid)
          Retrieves the input message of the task instance using the task instance ID.
 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.
 ClientObjectWrapper getOutputMessage(java.lang.String tkiid)
          Retrieves the output message of the specified task instance using a string representation of the ID.
 ClientObjectWrapper getOutputMessage(TKIID tkiid)
          Retrieves the output message of the specified task instance using the task instance ID.
 StoredQuery getStoredQuery(int kind, java.lang.String storedQueryName)
          Retrieves the specified private or public stored query definition.
 StoredQuery getStoredQuery(java.lang.String storedQueryName)
          Retrieves the specified stored query definition.
 StoredQuery getStoredQuery(java.lang.String userID, java.lang.String storedQueryName)
          Retrieves the specified stored query definition for the specified user.
 java.lang.String[] getStoredQueryNames()
          Retrieves the names of stored queries that are persistently stored in the database.
 java.lang.String[] getStoredQueryNames(int kind)
          Retrieves the names of private or public stored queries that are persistently stored in the database.
 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.
 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.
 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.
 Task getTask(java.lang.String tkiid)
          Retrieves the specified task instance using a string representation of the task instance ID.
 Task getTask(TKIID tkiid)
          Retrieves the specified task instance using the task instance ID.
 TaskTemplate getTaskTemplate(java.lang.String tktid)
          Retrieves the specified task template using a string representation of the task template ID.
 TaskTemplate getTaskTemplate(TKTID tktid)
          Retrieves the specified task template using the task template ID.
 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.
 CustomClientSettings getUISettings(TKIID tkiid)
          Retrieves client interface settings for the specified task instance using the task instance ID.
 CustomClientSettings getUISettings(TKTID tktid)
          Retrieves client interface settings for the specified task template using the task template ID.
 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.
 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.
 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.
 WorkItem[] getWorkItems(ESIID esiid)
          Returns an array of escalation work items of the logged-on user.
 WorkItem[] getWorkItems(java.lang.String oid)
          Returns an array of task or escalation work items of the logged-on user.
 WorkItem[] getWorkItems(TKIID tkiid)
          Returns an array of task work items of the logged-on user.
 boolean isSystemAdministrator()
          States whether the logged-on user is a system administrator for the human task manager component.
 boolean isSystemMonitor()
          States whether the logged-on user is a system monitor for the human task manager component.
 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.
 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.
 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.
 QueryResultSet query(int kind, java.lang.String storedQueryName, java.lang.Integer skipTuples, java.lang.Integer threshold, java.util.List parameters)
          Calls the specified public or private stored query.
 QueryResultSet query(java.lang.String storedQueryName, java.lang.Integer skipTuples)
          Deprecated. Use query,
 QueryResultSet query(java.lang.String storedQueryName, java.lang.Integer skipTuples, java.lang.Integer threshold)
          Deprecated. Use query,
 QueryResultSet query(java.lang.String storedQueryName, java.lang.Integer skipTuples, java.lang.Integer threshold, java.util.List parameters)
          Calls the specified stored query and specifies values for parameters in the where-clause.
 QueryResultSet query(java.lang.String storedQueryName, java.lang.Integer skipTuples, java.util.List parameters)
          Calls the specified stored query, specifies values for the parameters in the where-clause, and returns the qualifying object properties.
 QueryResultSet query(java.lang.String userID, java.lang.String storedQueryName, java.lang.Integer skipTuples, java.lang.Integer threshold, java.util.List parameters)
          Calls the specified stored query of the specified user.
 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.
 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.
 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.
 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 and that are part of started applications.
 void resume(java.lang.String tkiid)
          Resumes the execution of the specified suspended human or participating task instance using a string representation of the task instance ID.
 void resume(TKIID tkiid)
          Resumes the execution of the specified suspended human or participating task instance using the task instance ID.
 void setBinaryCustomProperty(java.lang.String tkiid, BinaryCustomProperty property)
          Stores custom-specific binary values for the specified task instance using a string representation of the task instance ID.
 void setBinaryCustomProperty(TKIID tkiid, BinaryCustomProperty property)
          Stores custom-specific binary values for the specified task instance using the task instance ID.
 void setCustomProperty(java.lang.String tkiid, java.lang.String propertyName, java.lang.String propertyValue)
          Stores custom-specific values for the specified task instance using a string representation of the object ID.
 void setCustomProperty(TKIID tkiid, java.lang.String propertyName, java.lang.String propertyValue)
          Stores custom-specific values for the specified task instance.
 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.
 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.
 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.
 void setOutputMessage(TKIID tkiid, ClientObjectWrapper outputMessage)
          Stores the output message of the specified task instance into the database using the task instance ID.
 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.
 void startTask(TKIID tkiid, ClientObjectWrapper input, ReplyHandlerWrapper replyHandler)
          Asynchronously executes a previously created task using the task instance ID.
 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.
 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.
 void startTaskTemplate(java.lang.String tktid)
          This method starts a task template that has been created spontaneously using a string representation of the task template ID.
 void startTaskTemplate(TKTID tktid)
          This method starts a task template that has been created spontaneously using the task template ID.
 void stopTaskTemplate(java.lang.String tktid)
          This method stops a task template that has been created spontaneously using a string representation of the task template ID.
 void stopTaskTemplate(TKTID tktid)
          This method stops a task template that has been created spontaneously using the task template ID.
 void suspend(java.lang.String tkiid)
          Suspends the specified human or participating task instance using a string representation of the task instance ID.
 void suspend(java.lang.String tkiid, java.lang.String duration)
          Suspends the specified human or participating task instance for the specified duration using a string representation of the task instance ID.
 void suspend(TKIID tkiid)
          Suspends the specified human or participating task instance using the task instance ID.
 void suspend(TKIID tkiid, java.lang.String duration)
          Suspends the specified human or participating task instance for the specified duration using the task instance ID.
 void suspendAndCancelClaim(java.lang.String tkiid, java.lang.String duration, boolean keepTaskData)
          Suspends the specified human or participating 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.
 void suspendAndCancelClaim(TKIID tkiid, java.lang.String duration, boolean keepTaskData)
          Suspends the specified human or participating task instance for the specified duration and cancels the claim of the task instance when execution is resumed using the task instance ID.
 void terminate(java.lang.String tkiid)
          Terminates the specified task instance using a string representation of the task instance ID.
 void terminate(TKIID tkiid)
          Terminates the specified task instance using the task instance ID.
 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.
 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.
 void transferWorkItem(TKIID tkiid, int assignmentReason, java.lang.String fromOwner, java.lang.String toOwner)
          Transfers a work item for the specified task instance using the task instance ID.
 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 spontaneously using a string representation of the task instance ID.
 void update(Task task)
          Updates a persistently stored task instance.
 void update(TKIID tkiid, TaskModel taskModel, java.lang.String applicationName, java.lang.String parentContext, ClientObjectWrapper input)
          Updates a task instance that has been created spontaneously using the task instance ID.
 

Field Detail

COPYRIGHT

public static final java.lang.String COPYRIGHT
See Also:
Constant Field Values
Method Detail

callTask

public ClientObjectWrapper callTask(java.lang.String tkiid,
                                    ClientObjectWrapper input)
                             throws AdministratorCannotBeResolvedException,
                                    ApplicationVetoException,
                                    CannotCreateWorkItemException,
                                    FaultReplyException,
                                    IdWrongFormatException,
                                    IdWrongTypeException,
                                    InvalidLengthException,
                                    NotAuthorizedException,
                                    ObjectDoesNotExistException,
                                    SCAServiceAccessFailureException,
                                    SCAServiceResultErrorException,
                                    WrongKindException,
                                    WrongMessageTypeException,
                                    WrongStateException,
                                    UnexpectedFailureException,
                                    java.rmi.RemoteException,
                                    javax.ejb.EJBException
Synchronously executes a previously created originating task using a string representation of the task instance ID. An input message can be passed to specify intial values for the task.

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 in the ready state. The caller must be a potential starter, the originator, or an administrator of the task instance.

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:
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
FaultReplyException
IdWrongFormatException
IdWrongTypeException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
SCAServiceAccessFailureException
SCAServiceResultErrorException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

callTask

public ClientObjectWrapper callTask(TKIID tkiid,
                                    ClientObjectWrapper input)
                             throws AdministratorCannotBeResolvedException,
                                    ApplicationVetoException,
                                    CannotCreateWorkItemException,
                                    FaultReplyException,
                                    IdWrongFormatException,
                                    InvalidLengthException,
                                    NotAuthorizedException,
                                    ObjectDoesNotExistException,
                                    SCAServiceAccessFailureException,
                                    SCAServiceResultErrorException,
                                    WrongKindException,
                                    WrongMessageTypeException,
                                    WrongStateException,
                                    UnexpectedFailureException,
                                    java.rmi.RemoteException,
                                    javax.ejb.EJBException
Synchronously executes a previously created originating task using the task instance ID. An input message can be passed to specify intial values for the task.

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 in the ready state. The caller must be a potential starter, the originator, or an administrator of the task instance.

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:
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
FaultReplyException
IdWrongFormatException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
SCAServiceAccessFailureException
SCAServiceResultErrorException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

cancelClaim

public void cancelClaim(java.lang.String tkiid)
                 throws ApplicationVetoException,
                        IdWrongFormatException,
                        IdWrongTypeException,
                        NotAuthorizedException,
                        ObjectDoesNotExistException,
                        WrongKindException,
                        WrongStateException,
                        UnexpectedFailureException,
                        java.rmi.RemoteException,
                        javax.ejb.EJBException
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.

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

Throws:
ApplicationVetoException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0 - introduced in 5.1.1

cancelClaim

public void cancelClaim(TKIID tkiid)
                 throws ApplicationVetoException,
                        IdWrongFormatException,
                        NotAuthorizedException,
                        ObjectDoesNotExistException,
                        WrongKindException,
                        WrongStateException,
                        UnexpectedFailureException,
                        java.rmi.RemoteException,
                        javax.ejb.EJBException
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.

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

Throws:
ApplicationVetoException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0 - introduced in 5.1.1

cancelClaim

public void cancelClaim(java.lang.String tkiid,
                        boolean keepTaskData)
                 throws ApplicationVetoException,
                        IdWrongFormatException,
                        IdWrongTypeException,
                        NotAuthorizedException,
                        ObjectDoesNotExistException,
                        WrongKindException,
                        WrongStateException,
                        UnexpectedFailureException,
                        java.rmi.RemoteException,
                        javax.ejb.EJBException
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.

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:
ApplicationVetoException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

cancelClaim

public void cancelClaim(TKIID tkiid,
                        boolean keepTaskData)
                 throws ApplicationVetoException,
                        IdWrongFormatException,
                        NotAuthorizedException,
                        ObjectDoesNotExistException,
                        WrongKindException,
                        WrongStateException,
                        UnexpectedFailureException,
                        java.rmi.RemoteException,
                        javax.ejb.EJBException
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.

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:
ApplicationVetoException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

claim

public ClientObjectWrapper claim(java.lang.String tkiid)
                          throws ApplicationVetoException,
                                 CannotCreateWorkItemException,
                                 IdWrongFormatException,
                                 IdWrongTypeException,
                                 NotAuthorizedException,
                                 ObjectDoesNotExistException,
                                 WrongKindException,
                                 WrongStateException,
                                 UnexpectedFailureException,
                                 java.rmi.RemoteException,
                                 javax.ejb.EJBException
Claims a ready participating or human task instance for user processing using a string representation of the task instance ID. The task instance can be escalated.

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.

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:
ApplicationVetoException
CannotCreateWorkItemException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0 - introduced in 5.1.1

claim

public ClientObjectWrapper claim(TKIID tkiid)
                          throws ApplicationVetoException,
                                 CannotCreateWorkItemException,
                                 IdWrongFormatException,
                                 NotAuthorizedException,
                                 ObjectDoesNotExistException,
                                 WrongKindException,
                                 WrongStateException,
                                 UnexpectedFailureException,
                                 java.rmi.RemoteException,
                                 javax.ejb.EJBException
Claims a ready participating or human task instance for user processing using the task instance ID. The task instance can be escalated.

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.

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

Returns:
ClientObjectWrapper - The input message of the claimed task instance.

Throws:
ApplicationVetoException
CannotCreateWorkItemException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0 - introduced in 5.1.1

claim

public Task claim(java.lang.String whereClause,
                  java.lang.String orderByClause,
                  java.util.TimeZone timeZone)
           throws CannotCreateWorkItemException,
                  WorkItemManagerException,
                  UnexpectedFailureException,
                  java.rmi.RemoteException,
                  javax.ejb.EJBException
Claims some ready participating or human task instance for user processing. The task instance can be escalated.

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.

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 process 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:
CannotCreateWorkItemException
WorkItemManagerException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

complete

public void complete(java.lang.String tkiid)
              throws ApplicationVetoException,
                     IdWrongFormatException,
                     IdWrongTypeException,
                     NotAuthorizedException,
                     ObjectDoesNotExistException,
                     WrongKindException,
                     WrongStateException,
                     UnexpectedFailureException,
                     java.rmi.RemoteException,
                     javax.ejb.EJBException
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.

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

Throws:
ApplicationVetoException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0 - introduced in 5.1.1

complete

public void complete(TKIID tkiid)
              throws ApplicationVetoException,
                     IdWrongFormatException,
                     NotAuthorizedException,
                     ObjectDoesNotExistException,
                     WrongKindException,
                     WrongStateException,
                     UnexpectedFailureException,
                     java.rmi.RemoteException,
                     javax.ejb.EJBException
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.

Parameters:
tkiid - The object ID to identify the task instance to be completed.

Throws:
ApplicationVetoException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0 - introduced in 5.1.1

complete

public void complete(java.lang.String tkiid,
                     ClientObjectWrapper output)
              throws ApplicationVetoException,
                     IdWrongFormatException,
                     IdWrongTypeException,
                     NotAuthorizedException,
                     ObjectDoesNotExistException,
                     ParameterNullException,
                     WrongKindException,
                     WrongMessageTypeException,
                     WrongStateException,
                     UnexpectedFailureException,
                     java.rmi.RemoteException,
                     javax.ejb.EJBException
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.

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:
ApplicationVetoException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0 - introduced in 5.1.1

complete

public void complete(TKIID tkiid,
                     ClientObjectWrapper output)
              throws ApplicationVetoException,
                     IdWrongFormatException,
                     NotAuthorizedException,
                     ObjectDoesNotExistException,
                     ParameterNullException,
                     WrongKindException,
                     WrongMessageTypeException,
                     WrongStateException,
                     UnexpectedFailureException,
                     java.rmi.RemoteException,
                     javax.ejb.EJBException
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.

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:
ApplicationVetoException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0 - introduced in 5.1.1

complete

public void complete(java.lang.String tkiid,
                     java.lang.String faultName,
                     ClientObjectWrapper faultMessage)
              throws ApplicationVetoException,
                     IdWrongFormatException,
                     IdWrongTypeException,
                     InvalidQNameException,
                     NotAuthorizedException,
                     ObjectDoesNotExistException,
                     ParameterNullException,
                     WrongKindException,
                     WrongMessageTypeException,
                     WrongStateException,
                     UnexpectedFailureException,
                     java.rmi.RemoteException,
                     javax.ejb.EJBException
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.

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:
ApplicationVetoException
IdWrongFormatException
IdWrongTypeException
InvalidQNameException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0 - introduced in 5.1.1

complete

public void complete(TKIID tkiid,
                     java.lang.String faultName,
                     ClientObjectWrapper faultMessage)
              throws ApplicationVetoException,
                     IdWrongFormatException,
                     InvalidQNameException,
                     NotAuthorizedException,
                     ObjectDoesNotExistException,
                     ParameterNullException,
                     WrongKindException,
                     WrongMessageTypeException,
                     WrongStateException,
                     UnexpectedFailureException,
                     java.rmi.RemoteException,
                     javax.ejb.EJBException
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.

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:
ApplicationVetoException
IdWrongFormatException
InvalidQNameException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0 - introduced in 5.1.1

completeWithFollowOnTask

public void completeWithFollowOnTask(java.lang.String tkiid,
                                     java.lang.String followOnID,
                                     ClientObjectWrapper input)
                              throws AdministratorCannotBeResolvedException,
                                     ApplicationVetoException,
                                     CannotCreateWorkItemException,
                                     FaultMessageDefinitionDoesNotMatchException,
                                     FollowOnTasksNotSupportedException,
                                     IdWrongFormatException,
                                     IdWrongTypeException,
                                     InvalidLengthException,
                                     NotAuthorizedException,
                                     ObjectDoesNotExistException,
                                     OutputMessageDefinitionDoesNotMatchException,
                                     SCAServiceAccessFailureException,
                                     SCAServiceResultErrorException,
                                     WrongKindException,
                                     WrongMessageTypeException,
                                     WrongStateException,
                                     UnexpectedFailureException,
                                     java.rmi.RemoteException,
                                     javax.ejb.EJBException
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 human or standalone originating task. Escalation or deletion timer settings of the completed task become active.

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.

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:
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
FaultMessageDefinitionDoesNotMatchException
FollowOnTasksNotSupportedException
IdWrongFormatException
IdWrongTypeException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
OutputMessageDefinitionDoesNotMatchException
SCAServiceAccessFailureException
SCAServiceResultErrorException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

completeWithFollowOnTask

public void completeWithFollowOnTask(TKIID tkiid,
                                     TKIID followOnID,
                                     ClientObjectWrapper input)
                              throws AdministratorCannotBeResolvedException,
                                     ApplicationVetoException,
                                     CannotCreateWorkItemException,
                                     FaultMessageDefinitionDoesNotMatchException,
                                     FollowOnTasksNotSupportedException,
                                     IdWrongFormatException,
                                     InvalidLengthException,
                                     NotAuthorizedException,
                                     ObjectDoesNotExistException,
                                     OutputMessageDefinitionDoesNotMatchException,
                                     SCAServiceAccessFailureException,
                                     SCAServiceResultErrorException,
                                     WrongKindException,
                                     WrongMessageTypeException,
                                     WrongStateException,
                                     UnexpectedFailureException,
                                     java.rmi.RemoteException,
                                     javax.ejb.EJBException
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 human or standalone originating task. Escalation or deletion timer settings of the completed task become active.

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.

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:
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
FaultMessageDefinitionDoesNotMatchException
FollowOnTasksNotSupportedException
IdWrongFormatException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
OutputMessageDefinitionDoesNotMatchException
SCAServiceAccessFailureException
SCAServiceResultErrorException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

completeWithNewFollowOnTask

public void completeWithNewFollowOnTask(java.lang.String tkiid,
                                        java.lang.String name,
                                        java.lang.String namespace,
                                        ClientObjectWrapper input)
                                 throws AdministratorCannotBeResolvedException,
                                        ApplicationVetoException,
                                        CannotCreateWorkItemException,
                                        FaultMessageDefinitionDoesNotMatchException,
                                        FollowOnTasksNotSupportedException,
                                        IdWrongFormatException,
                                        IdWrongTypeException,
                                        InvalidApplicationStateException,
                                        InvalidLengthException,
                                        NotAuthorizedException,
                                        ObjectDoesNotExistException,
                                        OutputMessageDefinitionDoesNotMatchException,
                                        ParameterNullException,
                                        SCAServiceAccessFailureException,
                                        SCAServiceResultErrorException,
                                        WrongKindException,
                                        WrongMessageTypeException,
                                        WrongStateException,
                                        UnexpectedFailureException,
                                        java.rmi.RemoteException,
                                        javax.ejb.EJBException
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 human or standalone originating task. Escalation or deletion timer settings of the completed task become active.

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.

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:
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
FaultMessageDefinitionDoesNotMatchException
FollowOnTasksNotSupportedException
IdWrongFormatException
IdWrongTypeException
InvalidApplicationStateException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
OutputMessageDefinitionDoesNotMatchException
ParameterNullException
SCAServiceAccessFailureException
SCAServiceResultErrorException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

completeWithNewFollowOnTask

public void completeWithNewFollowOnTask(TKIID tkiid,
                                        java.lang.String name,
                                        java.lang.String namespace,
                                        ClientObjectWrapper input)
                                 throws AdministratorCannotBeResolvedException,
                                        ApplicationVetoException,
                                        CannotCreateWorkItemException,
                                        FaultMessageDefinitionDoesNotMatchException,
                                        FollowOnTasksNotSupportedException,
                                        IdWrongFormatException,
                                        InvalidApplicationStateException,
                                        InvalidLengthException,
                                        NotAuthorizedException,
                                        ObjectDoesNotExistException,
                                        OutputMessageDefinitionDoesNotMatchException,
                                        ParameterNullException,
                                        SCAServiceAccessFailureException,
                                        SCAServiceResultErrorException,
                                        WrongKindException,
                                        WrongMessageTypeException,
                                        WrongStateException,
                                        UnexpectedFailureException,
                                        java.rmi.RemoteException,
                                        javax.ejb.EJBException
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 human or standalone originating task. Escalation or deletion timer settings of the completed task become active.

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.

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:
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
FaultMessageDefinitionDoesNotMatchException
FollowOnTasksNotSupportedException
IdWrongFormatException
InvalidApplicationStateException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
OutputMessageDefinitionDoesNotMatchException
ParameterNullException
SCAServiceAccessFailureException
SCAServiceResultErrorException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

completeWithNewFollowOnTask

public void completeWithNewFollowOnTask(java.lang.String tkiid,
                                        TaskModel taskModel,
                                        java.lang.String applicationName,
                                        ClientObjectWrapper input)
                                 throws AdministratorCannotBeResolvedException,
                                        ApplicationVetoException,
                                        CannotCreateWorkItemException,
                                        FaultMessageDefinitionDoesNotMatchException,
                                        FollowOnTasksNotSupportedException,
                                        IdWrongFormatException,
                                        IdWrongTypeException,
                                        InvalidLengthException,
                                        NotAuthorizedException,
                                        ObjectDoesNotExistException,
                                        OutputMessageDefinitionDoesNotMatchException,
                                        ParameterNullException,
                                        com.ibm.task.plugins.TaskDeploymentException,
                                        com.ibm.task.plugins.TELValidationException,
                                        WrongKindException,
                                        WrongMessageTypeException,
                                        WrongStateException,
                                        UnexpectedFailureException,
                                        java.rmi.RemoteException,
                                        javax.ejb.EJBException
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 human or standalone originating task. Escalation or deletion timer settings of the completed task become active.

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.

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 spontaneously.
applicationName - The name of the enterprise application that contains the message definitions used in the TaskModel. If the message definitions are simple types only, 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:
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
FaultMessageDefinitionDoesNotMatchException
FollowOnTasksNotSupportedException
IdWrongFormatException
IdWrongTypeException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
OutputMessageDefinitionDoesNotMatchException
ParameterNullException
com.ibm.task.plugins.TaskDeploymentException
com.ibm.task.plugins.TELValidationException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

completeWithNewFollowOnTask

public void completeWithNewFollowOnTask(TKIID tkiid,
                                        TaskModel taskModel,
                                        java.lang.String applicationName,
                                        ClientObjectWrapper input)
                                 throws AdministratorCannotBeResolvedException,
                                        ApplicationVetoException,
                                        CannotCreateWorkItemException,
                                        FaultMessageDefinitionDoesNotMatchException,
                                        FollowOnTasksNotSupportedException,
                                        IdWrongFormatException,
                                        InvalidLengthException,
                                        NotAuthorizedException,
                                        ObjectDoesNotExistException,
                                        OutputMessageDefinitionDoesNotMatchException,
                                        ParameterNullException,
                                        com.ibm.task.plugins.TaskDeploymentException,
                                        com.ibm.task.plugins.TELValidationException,
                                        WrongKindException,
                                        WrongMessageTypeException,
                                        WrongStateException,
                                        UnexpectedFailureException,
                                        java.rmi.RemoteException,
                                        javax.ejb.EJBException
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 human or standalone originating task. Escalation or deletion timer settings of the completed task become active.

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.

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 spontaneously.
applicationName - The name of the enterprise application that contains the message definitions used in the TaskModel. If the message definitions are simple types only, 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:
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
FaultMessageDefinitionDoesNotMatchException
FollowOnTasksNotSupportedException
IdWrongFormatException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
OutputMessageDefinitionDoesNotMatchException
ParameterNullException
com.ibm.task.plugins.TaskDeploymentException
com.ibm.task.plugins.TELValidationException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

createAndCallTask

public ClientObjectWrapper createAndCallTask(java.lang.String name,
                                             java.lang.String namespace,
                                             ClientObjectWrapper input)
                                      throws AdministratorCannotBeResolvedException,
                                             ApplicationVetoException,
                                             CannotCreateWorkItemException,
                                             FaultReplyException,
                                             InvalidApplicationStateException,
                                             InvalidLengthException,
                                             NotAuthorizedException,
                                             ObjectDoesNotExistException,
                                             ParameterNullException,
                                             SCAServiceAccessFailureException,
                                             SCAServiceResultErrorException,
                                             WrongKindException,
                                             WrongMessageTypeException,
                                             WrongStateException,
                                             UnexpectedFailureException,
                                             java.rmi.RemoteException,
                                             javax.ejb.EJBException
Creates and synchronously executes an originating task instance. An input message can be passed to specify intial values for the task.

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.

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:
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
FaultReplyException
InvalidApplicationStateException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
SCAServiceAccessFailureException
SCAServiceResultErrorException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

createAndStartTask

public TKIID createAndStartTask(java.lang.String name,
                                java.lang.String namespace,
                                ClientObjectWrapper input,
                                ReplyHandlerWrapper replyHandler)
                         throws AdministratorCannotBeResolvedException,
                                ApplicationVetoException,
                                CannotCreateWorkItemException,
                                InvalidApplicationStateException,
                                InvalidLengthException,
                                NotAuthorizedException,
                                ObjectDoesNotExistException,
                                ParameterNullException,
                                SCAServiceAccessFailureException,
                                SCAServiceResultErrorException,
                                WrongKindException,
                                WrongMessageTypeException,
                                WrongStateException,
                                UnexpectedFailureException,
                                java.rmi.RemoteException,
                                javax.ejb.EJBException
Creates and starts a task instance.

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 originating task, then the caller also becomes the starter of the task.

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:
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
InvalidApplicationStateException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
SCAServiceAccessFailureException
SCAServiceResultErrorException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

createAndStartTask

public TKIID createAndStartTask(TaskModel taskModel,
                                java.lang.String applicationName,
                                java.lang.String parentContext,
                                ClientObjectWrapper input,
                                ReplyHandlerWrapper replyHandler)
                         throws AdministratorCannotBeResolvedException,
                                ApplicationVetoException,
                                CannotCreateWorkItemException,
                                IdWrongTypeException,
                                InvalidLengthException,
                                NotAuthorizedException,
                                ObjectDoesNotExistException,
                                ParameterNullException,
                                WrongMessageTypeException,
                                UnexpectedFailureException,
                                com.ibm.task.plugins.TaskDeploymentException,
                                com.ibm.task.plugins.TELValidationException,
                                java.rmi.RemoteException,
                                javax.ejb.EJBException
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.

Parameters:
taskModel - The model that describes the task instance to be created spontaneously.
applicationName - The name of the enterprise application that contains the message definitions. If the message definitions are simple types only, 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:
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
IdWrongTypeException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongMessageTypeException
UnexpectedFailureException
com.ibm.task.plugins.TaskDeploymentException
com.ibm.task.plugins.TELValidationException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.1

createAndStartTaskAsSubTask

public TKIID createAndStartTaskAsSubTask(java.lang.String name,
                                         java.lang.String namespace,
                                         java.lang.String parentTaskID,
                                         ClientObjectWrapper input)
                                  throws AdministratorCannotBeResolvedException,
                                         ApplicationVetoException,
                                         CannotCreateWorkItemException,
                                         IdWrongFormatException,
                                         IdWrongTypeException,
                                         InvalidApplicationStateException,
                                         InvalidLengthException,
                                         NotAuthorizedException,
                                         ObjectDoesNotExistException,
                                         ParameterNullException,
                                         SCAServiceAccessFailureException,
                                         SCAServiceResultErrorException,
                                         SubTasksNotSupportedException,
                                         WrongKindException,
                                         WrongMessageTypeException,
                                         WrongStateException,
                                         UnexpectedFailureException,
                                         java.rmi.RemoteException,
                                         javax.ejb.EJBException
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 human or standalone originating task. The parent task instance must be a human or participating task in the claimed state. 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 originating task, then the caller also becomes the starter of the task.

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:
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
IdWrongFormatException
IdWrongTypeException
InvalidApplicationStateException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
SCAServiceAccessFailureException
SCAServiceResultErrorException
SubTasksNotSupportedException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

createAndStartTaskAsSubTask

public TKIID createAndStartTaskAsSubTask(java.lang.String name,
                                         java.lang.String namespace,
                                         TKIID parentTaskID,
                                         ClientObjectWrapper input)
                                  throws AdministratorCannotBeResolvedException,
                                         ApplicationVetoException,
                                         CannotCreateWorkItemException,
                                         IdWrongFormatException,
                                         InvalidApplicationStateException,
                                         InvalidLengthException,
                                         NotAuthorizedException,
                                         ObjectDoesNotExistException,
                                         ParameterNullException,
                                         SCAServiceAccessFailureException,
                                         SCAServiceResultErrorException,
                                         SubTasksNotSupportedException,
                                         WrongKindException,
                                         WrongMessageTypeException,
                                         WrongStateException,
                                         UnexpectedFailureException,
                                         java.rmi.RemoteException,
                                         javax.ejb.EJBException
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 human or standalone originating task. The parent task instance must be a human or participating task in the claimed state. 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 originating task, then the caller also becomes the starter of the task.

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:
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
IdWrongFormatException
InvalidApplicationStateException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
SCAServiceAccessFailureException
SCAServiceResultErrorException
SubTasksNotSupportedException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

createAndStartTaskAsSubTask

public TKIID createAndStartTaskAsSubTask(TaskModel taskModel,
                                         java.lang.String applicationName,
                                         java.lang.String parentTaskID,
                                         ClientObjectWrapper input)
                                  throws AdministratorCannotBeResolvedException,
                                         ApplicationVetoException,
                                         CannotCreateWorkItemException,
                                         IdWrongFormatException,
                                         IdWrongTypeException,
                                         InvalidLengthException,
                                         NotAuthorizedException,
                                         ObjectDoesNotExistException,
                                         ParameterNullException,
                                         SCAServiceAccessFailureException,
                                         SCAServiceResultErrorException,
                                         SubTasksNotSupportedException,
                                         com.ibm.task.plugins.TaskDeploymentException,
                                         com.ibm.task.plugins.TELValidationException,
                                         WrongMessageTypeException,
                                         WrongKindException,
                                         WrongStateException,
                                         UnexpectedFailureException,
                                         java.rmi.RemoteException,
                                         javax.ejb.EJBException
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 human or standalone originating task. The parent task instance must be a human or participating task in the claimed state. 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 originating task, then the caller also becomes the starter of the task. The subtask inherits the context of the parent.

Parameters:
taskModel - The model that describes the subtask to be created spontaneously.
applicationName - The name of the enterprise application that contains the message definitions. If the message definitions are simple types only, 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:
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
IdWrongFormatException
IdWrongTypeException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
SCAServiceAccessFailureException
SCAServiceResultErrorException
SubTasksNotSupportedException
com.ibm.task.plugins.TaskDeploymentException
com.ibm.task.plugins.TELValidationException
WrongMessageTypeException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

createAndStartTaskAsSubTask

public TKIID createAndStartTaskAsSubTask(TaskModel taskModel,
                                         java.lang.String applicationName,
                                         TKIID parentTaskID,
                                         ClientObjectWrapper input)
                                  throws AdministratorCannotBeResolvedException,
                                         ApplicationVetoException,
                                         CannotCreateWorkItemException,
                                         IdWrongFormatException,
                                         InvalidLengthException,
                                         NotAuthorizedException,
                                         ObjectDoesNotExistException,
                                         ParameterNullException,
                                         SCAServiceAccessFailureException,
                                         SCAServiceResultErrorException,
                                         SubTasksNotSupportedException,
                                         com.ibm.task.plugins.TaskDeploymentException,
                                         com.ibm.task.plugins.TELValidationException,
                                         WrongMessageTypeException,
                                         WrongKindException,
                                         WrongStateException,
                                         UnexpectedFailureException,
                                         java.rmi.RemoteException,
                                         javax.ejb.EJBException
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 human or standalone originating task. The parent task instance must be a human or participating task in the claimed state. 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 originating task, then the caller also becomes the starter of the task. The subtask inherits the context of the parent.

Parameters:
taskModel - The model that describes the subtask to be created spontaneously.
applicationName - The name of the enterprise application that contains the message definitions. If the message definitions are simple types only, 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:
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
IdWrongFormatException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
SCAServiceAccessFailureException
SCAServiceResultErrorException
SubTasksNotSupportedException
com.ibm.task.plugins.TaskDeploymentException
com.ibm.task.plugins.TELValidationException
WrongMessageTypeException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

createFaultMessage

public ClientObjectWrapper createFaultMessage(java.lang.String tkiid,
                                              java.lang.String faultName)
                                       throws IdWrongFormatException,
                                              IdWrongTypeException,
                                              InvalidQNameException,
                                              NotAuthorizedException,
                                              ObjectDoesNotExistException,
                                              ParameterNullException,
                                              WrongKindException,
                                              WrongStateException,
                                              UnexpectedFailureException,
                                              java.rmi.RemoteException,
                                              javax.ejb.EJBException
Creates a fault message for a fault that is defined by the specified task instance using a string representation of the task instance ID. This method creates a message that can be used when unsuccessfully completing a task - refer to complete.

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

Parameters:
tkiid - A string representation of 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:
IdWrongFormatException
IdWrongTypeException
InvalidQNameException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

createFaultMessage

public ClientObjectWrapper createFaultMessage(TKIID tkiid,
                                              java.lang.String faultName)
                                       throws IdWrongFormatException,
                                              InvalidQNameException,
                                              NotAuthorizedException,
                                              ObjectDoesNotExistException,
                                              ParameterNullException,
                                              WrongKindException,
                                              WrongStateException,
                                              UnexpectedFailureException,
                                              java.rmi.RemoteException,
                                              javax.ejb.EJBException
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 caller must be the owner, an editor, or an administrator of the task instance.

Parameters:
tkiid - The task instance ID that is used to identify the task instance.
faultName - The name of the fault fot 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:
IdWrongFormatException
InvalidQNameException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

createInputMessage

public ClientObjectWrapper createInputMessage(java.lang.String identifier)
                                       throws IdWrongFormatException,
                                              IdWrongTypeException,
                                              NotAuthorizedException,
                                              ObjectDoesNotExistException,
                                              WrongKindException,
                                              WrongStateException,
                                              UnexpectedFailureException,
                                              java.rmi.RemoteException,
                                              javax.ejb.EJBException
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 caller must be the owner, a potential starter, the originator, or an administrator of the task instance.

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:
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

createInputMessage

public ClientObjectWrapper createInputMessage(TKIID tkiid)
                                       throws IdWrongFormatException,
                                              NotAuthorizedException,
                                              ObjectDoesNotExistException,
                                              WrongKindException,
                                              WrongStateException,
                                              UnexpectedFailureException,
                                              java.rmi.RemoteException,
                                              javax.ejb.EJBException
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 caller must be the owner, a potential starter, the originator, or an administrator of the task instance.

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:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

createInputMessage

public ClientObjectWrapper createInputMessage(TKTID tktid)
                                       throws IdWrongFormatException,
                                              NotAuthorizedException,
                                              ObjectDoesNotExistException,
                                              WrongKindException,
                                              WrongStateException,
                                              UnexpectedFailureException,
                                              java.rmi.RemoteException,
                                              javax.ejb.EJBException
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 caller must be the owner, a potential starter, the originator, or an administrator of the task instance.

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:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

createMessage

public ClientObjectWrapper createMessage(java.lang.String tkiid,
                                         java.lang.String messageTypeName)
                                  throws IdWrongFormatException,
                                         IdWrongTypeException,
                                         NotAuthorizedException,
                                         ObjectDoesNotExistException,
                                         ParameterNullException,
                                         UnexpectedFailureException,
                                         java.rmi.RemoteException,
                                         javax.ejb.EJBException
Deprecated. Use createInputMessage, createOutputMessage, 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.

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:
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
5.1.1

createMessage

public ClientObjectWrapper createMessage(TKIID tkiid,
                                         java.lang.String messageTypeName)
                                  throws IdWrongFormatException,
                                         NotAuthorizedException,
                                         ObjectDoesNotExistException,
                                         ParameterNullException,
                                         UnexpectedFailureException,
                                         java.rmi.RemoteException,
                                         javax.ejb.EJBException
Deprecated. Use createInputMessage, createOutputMessage, 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.

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:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
5.1.1

createOutputMessage

public ClientObjectWrapper createOutputMessage(java.lang.String tkiid)
                                        throws IdWrongFormatException,
                                               IdWrongTypeException,
                                               NotAuthorizedException,
                                               ObjectDoesNotExistException,
                                               WrongKindException,
                                               WrongStateException,
                                               UnexpectedFailureException,
                                               java.rmi.RemoteException,
                                               javax.ejb.EJBException
Creates an output message for 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 be the owner, an editor, or an administrator of the task instance.

Parameters:
tkiid - A string representation of 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:
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

createOutputMessage

public ClientObjectWrapper createOutputMessage(TKIID tkiid)
                                        throws IdWrongFormatException,
                                               NotAuthorizedException,
                                               ObjectDoesNotExistException,
                                               WrongKindException,
                                               WrongStateException,
                                               UnexpectedFailureException,
                                               java.rmi.RemoteException,
                                               javax.ejb.EJBException
Creates an output message for the specified task instance using the task instance ID. For example, create a message that can be used when completing a task.

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

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:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

createStoredQuery

public 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)
                       throws InvalidLengthException,
                              NotAuthorizedException,
                              ParameterNullException,
                              StoredQueryNameNotUniqueException,
                              UnexpectedFailureException,
                              java.rmi.RemoteException,
                              javax.ejb.EJBException
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. 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. All properties of objects are returned for which you own a work item, that is, which can be transitively reached via your work items.

Note that a system administrator or system monitor has special rights. They may retrieve all properties of objects for which there is some user's work item. Above that, these persons are the only users who can use properties of the TASK_TEMPL view only. All other users must specify at least one non-task template property in the select- or where-clause.

Although stored query definitions are stored persistently, object properties contained in the result set are assembled dynamically when they are queried. All stored queries are publicly accessible - 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:
InvalidLengthException
NotAuthorizedException
ParameterNullException
StoredQueryNameNotUniqueException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2 -introduced in 6.0

createStoredQuery

public 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)
                       throws InvalidLengthException,
                              InvalidParameterException,
                              ParameterNullException,
                              StoredQueryNameNotUniqueException,
                              UnexpectedFailureException,
                              java.rmi.RemoteException,
                              javax.ejb.EJBException
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. All properties of objects are returned for which you own a work item, that is, which can be transitively reached via your work items.

Note that a system administrator or system monitor has special rights. They may retrieve all properties of objects for which there is some user's work item. Above that, these persons are the only users who can use properties of the TASK_TEMPL view only. All other users must specify at least one non-task template property in the select- or where-clause.

Although stored query definitions are stored persistently, object properties contained in the result set are assembled dynamically when they are queried. All stored queries are publicly accessible - 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:
InvalidLengthException
InvalidParameterException
ParameterNullException
StoredQueryNameNotUniqueException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

createStoredQuery

public 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)
                       throws InvalidLengthException,
                              InvalidParameterException,
                              NotAuthorizedException,
                              ParameterNullException,
                              StoredQueryNameNotUniqueException,
                              UnexpectedFailureException,
                              java.rmi.RemoteException,
                              javax.ejb.EJBException
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. All properties of objects are returned for which you own a work item, that is, which can be transitively reached via your work items.

Note that a system administrator or system monitor has special rights. They may retrieve all properties of objects for which there is some user's work item. Above that, these persons are the only users who can use properties of the TASK_TEMPL view only. All other users must specify at least one non-task template property in the select- or where-clause.

Although stored query definitions are stored persistently, object properties contained in the result set are assembled dynamically when they are queried. All stored queries are publicly accessible - 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:
InvalidLengthException
InvalidParameterException
NotAuthorizedException
ParameterNullException
StoredQueryNameNotUniqueException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

createTask

public TKIID createTask(java.lang.String name,
                        java.lang.String namespace)
                 throws ApplicationVetoException,
                        CannotCreateWorkItemException,
                        InvalidApplicationStateException,
                        InvalidLengthException,
                        NotAuthorizedException,
                        ObjectDoesNotExistException,
                        ParameterNullException,
                        WrongKindException,
                        WrongStateException,
                        UnexpectedFailureException,
                        java.rmi.RemoteException,
                        javax.ejb.EJBException
Creates a task instance.

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

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:
ApplicationVetoException
CannotCreateWorkItemException
InvalidApplicationStateException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

createTask

public TKIID createTask(java.lang.String name,
                        java.lang.String namespace,
                        ClientObjectWrapper input)
                 throws ApplicationVetoException,
                        CannotCreateWorkItemException,
                        InvalidApplicationStateException,
                        InvalidLengthException,
                        NotAuthorizedException,
                        ObjectDoesNotExistException,
                        ParameterNullException,
                        WrongKindException,
                        WrongStateException,
                        UnexpectedFailureException,
                        java.rmi.RemoteException,
                        javax.ejb.EJBException
Creates a task instance and specifies an input message.

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

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:
ApplicationVetoException
CannotCreateWorkItemException
InvalidApplicationStateException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

createTask

public TKIID createTask(TaskModel taskModel,
                        java.lang.String applicationName,
                        java.lang.String parentContext)
                 throws ApplicationVetoException,
                        CannotCreateWorkItemException,
                        IdWrongTypeException,
                        InvalidLengthException,
                        NotAuthorizedException,
                        ObjectDoesNotExistException,
                        ParameterNullException,
                        UnexpectedFailureException,
                        com.ibm.task.plugins.TaskDeploymentException,
                        com.ibm.task.plugins.TELValidationException,
                        java.rmi.RemoteException,
                        javax.ejb.EJBException
Creates a task instance from the specified task model.

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

Parameters:
taskModel - The model that describes the task instance to be created spontaneously.
applicationName - The name of the enterprise application that contains the message definitions. If the message definitions are simple types only, 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:
ApplicationVetoException
CannotCreateWorkItemException
IdWrongTypeException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
UnexpectedFailureException
com.ibm.task.plugins.TaskDeploymentException
com.ibm.task.plugins.TELValidationException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.1

createTask

public TKIID createTask(TaskModel taskModel,
                        java.lang.String applicationName,
                        java.lang.String parentContext,
                        ClientObjectWrapper input)
                 throws ApplicationVetoException,
                        CannotCreateWorkItemException,
                        IdWrongTypeException,
                        InvalidLengthException,
                        NotAuthorizedException,
                        ObjectDoesNotExistException,
                        ParameterNullException,
                        WrongMessageTypeException,
                        UnexpectedFailureException,
                        com.ibm.task.plugins.TaskDeploymentException,
                        com.ibm.task.plugins.TELValidationException,
                        java.rmi.RemoteException,
                        javax.ejb.EJBException
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.

Parameters:
taskModel - The model that describes the task instance to be created spontaneously.
applicationName - The name of the enterprise application that contains the message definitions. If the message definitions are simple types only, 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:
ApplicationVetoException
CannotCreateWorkItemException
IdWrongTypeException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongMessageTypeException
UnexpectedFailureException
com.ibm.task.plugins.TaskDeploymentException
com.ibm.task.plugins.TELValidationException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.1

createTaskTemplate

public TKTID createTaskTemplate(TaskModel taskModel,
                                java.lang.String applicationName)
                         throws ApplicationVetoException,
                                InvalidLengthException,
                                NotAuthorizedException,
                                ObjectDoesNotExistException,
                                ParameterNullException,
                                UnexpectedFailureException,
                                com.ibm.task.plugins.TaskDeploymentException,
                                com.ibm.task.plugins.TELValidationException,
                                java.rmi.RemoteException,
                                javax.ejb.EJBException
Creates a task template from the specified task model.

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

Parameters:
taskModel - The model that describes the task template to be created spontaneously.
applicationName - The name of the enterprise application that contains the message definitions. If the message definitions are simple types only, null may be specified.

Returns:
TKTID - The task template ID of the task template created.

Throws:
ApplicationVetoException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
UnexpectedFailureException
com.ibm.task.plugins.TaskDeploymentException
com.ibm.task.plugins.TELValidationException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.1

createWorkItem

public void createWorkItem(java.lang.String identifier,
                           int assignmentReason,
                           java.lang.String userID)
                    throws ApplicationVetoException,
                           EverybodyWorkItemException,
                           IdWrongFormatException,
                           IdWrongTypeException,
                           InvalidAssignmentReasonException,
                           InvalidLengthException,
                           NotAuthorizedException,
                           UserDoesNotExistException,
                           ObjectDoesNotExistException,
                           ParameterNullException,
                           TaskDelegationNotSupportedException,
                           WorkItemManagerException,
                           WrongKindException,
                           WrongStateException,
                           UnexpectedFailureException,
                           java.rmi.RemoteException,
                           javax.ejb.EJBException
Creates a 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 for the creation of work items for escalation instances or for active tasks. 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:

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 getAssignmentReason.
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.

Throws:
ApplicationVetoException
EverybodyWorkItemException
IdWrongFormatException
IdWrongTypeException
InvalidAssignmentReasonException
InvalidLengthException
NotAuthorizedException
UserDoesNotExistException
ObjectDoesNotExistException
ParameterNullException
TaskDelegationNotSupportedException
WorkItemManagerException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2 - introduced in 5.1.1

createWorkItem

public void createWorkItem(TKIID tkiid,
                           int assignmentReason,
                           java.lang.String userID)
                    throws ApplicationVetoException,
                           EverybodyWorkItemException,
                           IdWrongFormatException,
                           InvalidAssignmentReasonException,
                           InvalidLengthException,
                           NotAuthorizedException,
                           UserDoesNotExistException,
                           ObjectDoesNotExistException,
                           ParameterNullException,
                           TaskDelegationNotSupportedException,
                           WorkItemManagerException,
                           WrongKindException,
                           WrongStateException,
                           UnexpectedFailureException,
                           java.rmi.RemoteException,
                           javax.ejb.EJBException
Creates a 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:

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 getAssignmentReason.
userID - The user the work item should belong to. It is checked whether the user exists but the check may be executed case insensitively.

Throws:
ApplicationVetoException
EverybodyWorkItemException
IdWrongFormatException
InvalidAssignmentReasonException
InvalidLengthException
NotAuthorizedException
UserDoesNotExistException
ObjectDoesNotExistException
ParameterNullException
TaskDelegationNotSupportedException
WorkItemManagerException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2 - introduced in 5.1.1

createWorkItem

public void createWorkItem(ESIID esiid,
                           int assignmentReason,
                           java.lang.String userID)
                    throws ApplicationVetoException,
                           EverybodyWorkItemException,
                           IdWrongFormatException,
                           InvalidAssignmentReasonException,
                           InvalidLengthException,
                           NotAuthorizedException,
                           UserDoesNotExistException,
                           ObjectDoesNotExistException,
                           ParameterNullException,
                           TaskDelegationNotSupportedException,
                           WorkItemManagerException,
                           WrongKindException,
                           WrongStateException,
                           UnexpectedFailureException,
                           java.rmi.RemoteException,
                           javax.ejb.EJBException
Creates a 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.

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 getAssignmentReason. 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.

Throws:
ApplicationVetoException
EverybodyWorkItemException
IdWrongFormatException
InvalidAssignmentReasonException
InvalidLengthException
NotAuthorizedException
UserDoesNotExistException
ObjectDoesNotExistException
ParameterNullException
TaskDelegationNotSupportedException
WorkItemManagerException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

delete

public void delete(java.lang.String tkiid)
            throws ApplicationVetoException,
                   ChildTaskInstanceActiveException,
                   IdWrongFormatException,
                   IdWrongTypeException,
                   IsNotTopLevelTaskException,
                   NotAuthorizedException,
                   WrongKindException,
                   WrongStateException,
                   UnexpectedFailureException,
                   java.rmi.RemoteException,
                   javax.ejb.EJBException
Deletes the specified task instance using a string representation of the task instance ID. A participating, human, or administrative task must not be inline.

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.

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

Throws:
ApplicationVetoException
ChildTaskInstanceActiveException
IdWrongFormatException
IdWrongTypeException
IsNotTopLevelTaskException
NotAuthorizedException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

delete

public void delete(TKIID tkiid)
            throws ApplicationVetoException,
                   IdWrongFormatException,
                   IsNotTopLevelTaskException,
                   NotAuthorizedException,
                   WrongKindException,
                   WrongStateException,
                   UnexpectedFailureException,
                   java.rmi.RemoteException,
                   javax.ejb.EJBException
Deletes the specified task instance using the task instance ID. A participating, human, or administrative task must not be inline.

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.

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

Throws:
ApplicationVetoException
IdWrongFormatException
IsNotTopLevelTaskException
NotAuthorizedException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

delete

public void delete(java.lang.String identifier,
                   boolean deleteInstances)
            throws ApplicationVetoException,
                   ChildTaskInstanceActiveException,
                   IdWrongFormatException,
                   IdWrongTypeException,
                   IsNotAdHocException,
                   NotAuthorizedException,
                   ObjectDoesNotExistException,
                   RunningInstancesException,
                   WrongKindException,
                   WrongStateException,
                   UnexpectedFailureException,
                   java.rmi.RemoteException,
                   javax.ejb.EJBException
Deletes the specified task template using a string representation of the task template ID. The task template must have been created spontaneously. 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.

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:
ApplicationVetoException
ChildTaskInstanceActiveException
IdWrongFormatException
IdWrongTypeException
IsNotAdHocException
NotAuthorizedException
ObjectDoesNotExistException
RunningInstancesException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.1

delete

public void delete(TKTID tktid,
                   boolean deleteInstances)
            throws ApplicationVetoException,
                   ChildTaskInstanceActiveException,
                   IdWrongFormatException,
                   IsNotAdHocException,
                   NotAuthorizedException,
                   ObjectDoesNotExistException,
                   RunningInstancesException,
                   WrongKindException,
                   WrongStateException,
                   UnexpectedFailureException,
                   java.rmi.RemoteException,
                   javax.ejb.EJBException
Deletes the specified task template using the task template ID. The task template must have been created spontaneously. 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.

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:
ApplicationVetoException
ChildTaskInstanceActiveException
IdWrongFormatException
IsNotAdHocException
NotAuthorizedException
ObjectDoesNotExistException
RunningInstancesException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.1

deleteStoredQuery

public void deleteStoredQuery(java.lang.String storedQueryName)
                       throws NotAuthorizedException,
                              ParameterNullException,
                              UnexpectedFailureException,
                              java.rmi.RemoteException,
                              javax.ejb.EJBException
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:
NotAuthorizedException
ParameterNullException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2 - introduced in 6.0

deleteStoredQuery

public void deleteStoredQuery(java.lang.String userID,
                              java.lang.String storedQueryName)
                       throws NotAuthorizedException,
                              ParameterNullException,
                              UnexpectedFailureException,
                              java.rmi.RemoteException,
                              javax.ejb.EJBException
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:
NotAuthorizedException
ParameterNullException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

deleteWorkItem

public void deleteWorkItem(java.lang.String identifier,
                           int assignmentReason,
                           java.lang.String userID)
                    throws ApplicationVetoException,
                           EverybodyWorkItemException,
                           IdWrongFormatException,
                           IdWrongTypeException,
                           InvalidAssignmentReasonException,
                           InvalidLengthException,
                           LastAdminWorkItemException,
                           NotAuthorizedException,
                           WorkItemDoesNotExistException,
                           ObjectDoesNotExistException,
                           ParameterNullException,
                           TaskDelegationNotSupportedException,
                           WorkItemManagerException,
                           WrongKindException,
                           WrongStateException,
                           UnexpectedFailureException,
                           java.rmi.RemoteException,
                           javax.ejb.EJBException
Deletes the specified 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:

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 getAssignmentReason for valid values.
userID - The user the work item belongs to.

Throws:
ApplicationVetoException
EverybodyWorkItemException
IdWrongFormatException
IdWrongTypeException
InvalidAssignmentReasonException
InvalidLengthException
LastAdminWorkItemException
NotAuthorizedException
WorkItemDoesNotExistException
ObjectDoesNotExistException
ParameterNullException
TaskDelegationNotSupportedException
WorkItemManagerException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2 - introduced in 5.1.1

deleteWorkItem

public void deleteWorkItem(TKIID tkiid,
                           int assignmentReason,
                           java.lang.String userID)
                    throws ApplicationVetoException,
                           EverybodyWorkItemException,
                           IdWrongFormatException,
                           InvalidAssignmentReasonException,
                           InvalidLengthException,
                           LastAdminWorkItemException,
                           NotAuthorizedException,
                           WorkItemDoesNotExistException,
                           ObjectDoesNotExistException,
                           ParameterNullException,
                           TaskDelegationNotSupportedException,
                           WorkItemManagerException,
                           WrongKindException,
                           WrongStateException,
                           UnexpectedFailureException,
                           java.rmi.RemoteException,
                           javax.ejb.EJBException
Deletes the specified 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:

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 getAssignmentReason.
userID - The user the work item belongs to.

Throws:
ApplicationVetoException
EverybodyWorkItemException
IdWrongFormatException
InvalidAssignmentReasonException
InvalidLengthException
LastAdminWorkItemException
NotAuthorizedException
WorkItemDoesNotExistException
ObjectDoesNotExistException
ParameterNullException
TaskDelegationNotSupportedException
WorkItemManagerException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0 - introduced in 5.1.1

deleteWorkItem

public void deleteWorkItem(ESIID esiid,
                           int assignmentReason,
                           java.lang.String userID)
                    throws ApplicationVetoException,
                           EverybodyWorkItemException,
                           IdWrongFormatException,
                           InvalidAssignmentReasonException,
                           InvalidLengthException,
                           LastAdminWorkItemException,
                           NotAuthorizedException,
                           WorkItemDoesNotExistException,
                           ObjectDoesNotExistException,
                           ParameterNullException,
                           TaskDelegationNotSupportedException,
                           WorkItemManagerException,
                           WrongKindException,
                           WrongStateException,
                           UnexpectedFailureException,
                           java.rmi.RemoteException,
                           javax.ejb.EJBException
Deletes the specified 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.

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 getAssignmentReason for valid values.
userID - The user the work item belongs to.

Throws:
ApplicationVetoException
EverybodyWorkItemException
IdWrongFormatException
InvalidAssignmentReasonException
InvalidLengthException
LastAdminWorkItemException
NotAuthorizedException
WorkItemDoesNotExistException
ObjectDoesNotExistException
ParameterNullException
TaskDelegationNotSupportedException
WorkItemManagerException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

getAllWorkItems

public WorkItem[] getAllWorkItems(ESIID esiid)
                           throws IdWrongFormatException,
                                  NotAuthorizedException,
                                  ObjectDoesNotExistException,
                                  WorkItemManagerException,
                                  UnexpectedFailureException,
                                  java.rmi.RemoteException,
                                  javax.ejb.EJBException
Returns an array of work items that exist for the escalation instance.

Parameters:
esiid - The object ID of the escalation instance.

Returns:
com.ibm.task.api.WorkItem[] - Array of WorkItem objects.Refer to WorkItem to view the WorkItem properties.

Throws:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WorkItemManagerException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2.1

getAllWorkItems

public WorkItem[] getAllWorkItems(java.lang.String oid)
                           throws IdWrongFormatException,
                                  IdWrongTypeException,
                                  NotAuthorizedException,
                                  ObjectDoesNotExistException,
                                  WorkItemManagerException,
                                  UnexpectedFailureException,
                                  java.rmi.RemoteException,
                                  javax.ejb.EJBException
Returns an array of work items that exist for the task or escalation instance.

Parameters:
oid - The string representation of the task or escalation instance ID.

Returns:
com.ibm.task.api.WorkItem[] - Array of WorkItem objects.Refer to WorkItem to view the WorkItem properties.

Throws:
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WorkItemManagerException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2.1

getAllWorkItems

public WorkItem[] getAllWorkItems(TKIID tkiid)
                           throws IdWrongFormatException,
                                  NotAuthorizedException,
                                  ObjectDoesNotExistException,
                                  WorkItemManagerException,
                                  UnexpectedFailureException,
                                  java.rmi.RemoteException,
                                  javax.ejb.EJBException
Returns an array of work items that exist for the task instance.

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

Returns:
com.ibm.task.api.WorkItem[] - Array of WorkItem objects.Refer to WorkItem to view the WorkItem properties.

Throws:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WorkItemManagerException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2.1

getAvailableActions

public int[] getAvailableActions(java.lang.String tkiid)
                          throws IdWrongFormatException,
                                 IdWrongTypeException,
                                 NotAuthorizedException,
                                 ObjectDoesNotExistException,
                                 UnexpectedFailureException,
                                 java.rmi.RemoteException,
                                 javax.ejb.EJBException
Returns the actions that can be called in the current task instance state by the logged-on user using a string representation of the task instance ID. Refer to TaskActions for possible actions.

Parameters:
tkiid - The string representation of the task instance ID.

Returns:
int[] - The set of possible actions. Returns null if there are no available actions.

Throws:
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
5.1.1

getAvailableActions

public int[] getAvailableActions(TKIID tkiid)
                          throws IdWrongFormatException,
                                 NotAuthorizedException,
                                 ObjectDoesNotExistException,
                                 UnexpectedFailureException,
                                 java.rmi.RemoteException,
                                 javax.ejb.EJBException
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:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
5.1.1

getAvailableActionFlags

public boolean[][] getAvailableActionFlags(java.lang.String[] tkiids)
                                    throws IdWrongFormatException,
                                           IdWrongTypeException,
                                           NotAuthorizedException,
                                           ObjectDoesNotExistException,
                                           UnexpectedFailureException,
                                           java.rmi.RemoteException,
                                           javax.ejb.EJBException
Returns the actions that can be called for the specified tasks in their current state by the logged-on user using string representations of the task instance IDs. Refer to TaskActions for possible actions.

Parameters:
tkiids - An array of string representations 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:
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

getAvailableActionFlags

public boolean[][] getAvailableActionFlags(TKIID[] tkiids)
                                    throws IdWrongFormatException,
                                           NotAuthorizedException,
                                           ObjectDoesNotExistException,
                                           UnexpectedFailureException,
                                           java.rmi.RemoteException,
                                           javax.ejb.EJBException
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:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

getApplicationComponent

public ApplicationComponent getApplicationComponent(java.lang.String acoid)
                                             throws IdWrongFormatException,
                                                    IdWrongTypeException,
                                                    NotAuthorizedException,
                                                    ObjectDoesNotExistException,
                                                    UnexpectedFailureException,
                                                    java.rmi.RemoteException,
                                                    javax.ejb.EJBException
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.

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:
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

getApplicationComponent

public ApplicationComponent getApplicationComponent(ACOID acoid)
                                             throws IdWrongFormatException,
                                                    NotAuthorizedException,
                                                    ObjectDoesNotExistException,
                                                    UnexpectedFailureException,
                                                    java.rmi.RemoteException,
                                                    javax.ejb.EJBException
Retrieves the specified application component using the application component ID.

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

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:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

getCustomProperty

public java.lang.String getCustomProperty(java.lang.String identifier,
                                          java.lang.String propertyName)
                                   throws IdWrongFormatException,
                                          IdWrongTypeException,
                                          NotAuthorizedException,
                                          ObjectDoesNotExistException,
                                          ParameterNullException,
                                          WrongKindException,
                                          WrongStateException,
                                          UnexpectedFailureException,
                                          java.rmi.RemoteException,
                                          javax.ejb.EJBException
Retrieves the named custom property of the specified task instance or task template using a string representation of the object ID.

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

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

Parameters:
identifier - A string representation of the task instance or task 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:
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2 - introduced in 5.1.1

getCustomProperty

public java.lang.String getCustomProperty(TKTID tktid,
                                          java.lang.String propertyName)
                                   throws IdWrongFormatException,
                                          NotAuthorizedException,
                                          ObjectDoesNotExistException,
                                          ParameterNullException,
                                          UnexpectedFailureException,
                                          java.rmi.RemoteException,
                                          javax.ejb.EJBException
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.

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:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

getCustomProperty

public java.lang.String getCustomProperty(TKIID tkiid,
                                          java.lang.String propertyName)
                                   throws IdWrongFormatException,
                                          NotAuthorizedException,
                                          ObjectDoesNotExistException,
                                          ParameterNullException,
                                          WrongKindException,
                                          WrongStateException,
                                          UnexpectedFailureException,
                                          java.rmi.RemoteException,
                                          javax.ejb.EJBException
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.

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:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
5.1.1

getCustomPropertyNames

public java.util.List getCustomPropertyNames(java.lang.String identifier)
                                      throws IdWrongFormatException,
                                             IdWrongTypeException,
                                             NotAuthorizedException,
                                             ObjectDoesNotExistException,
                                             UnexpectedFailureException,
                                             java.rmi.RemoteException,
                                             javax.ejb.EJBException
Retrieves the names of all custom properties of the specified task instance or task template using a string representation of the object 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 a task instance. The caller must have at least reader authority for the task instance or template.

Parameters:
identifier - A string representation of the task instance or task 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:
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2 - introduced in 6.0

getCustomPropertyNames

public java.util.List getCustomPropertyNames(TKTID tktid)
                                      throws NotAuthorizedException,
                                             IdWrongFormatException,
                                             ObjectDoesNotExistException,
                                             UnexpectedFailureException,
                                             java.rmi.RemoteException,
                                             javax.ejb.EJBException
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.

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:
NotAuthorizedException
IdWrongFormatException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

getCustomPropertyNames

public java.util.List getCustomPropertyNames(TKIID tkiid)
                                      throws NotAuthorizedException,
                                             IdWrongFormatException,
                                             ObjectDoesNotExistException,
                                             UnexpectedFailureException,
                                             java.rmi.RemoteException,
                                             javax.ejb.EJBException
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.

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:
NotAuthorizedException
IdWrongFormatException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

getCustomProperties

public java.util.List getCustomProperties(java.lang.String identifier)
                                   throws IdWrongFormatException,
                                          IdWrongTypeException,
                                          NotAuthorizedException,
                                          ObjectDoesNotExistException,
                                          UnexpectedFailureException,
                                          java.rmi.RemoteException,
                                          javax.ejb.EJBException
Retrieves all custom properties of the specified task instance or task template using a string representation of the object ID.

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

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

Parameters:
identifier - A string representation of the task instance or task 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 containing the name and value pairs. Returns an empty list when there are no custom properties.

Throws:
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2 - introduced in 6.0

getCustomProperties

public java.util.List getCustomProperties(TKTID tktid)
                                   throws IdWrongFormatException,
                                          NotAuthorizedException,
                                          ObjectDoesNotExistException,
                                          UnexpectedFailureException,
                                          java.rmi.RemoteException,
                                          javax.ejb.EJBException
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 tasks beyond those provided and managed by the task manager.

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

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

Returns:
List - A list of CustomProperty objects containing the name and value pairs. Returns an empty list when there are no custom properties.

Throws:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

getCustomProperties

public java.util.List getCustomProperties(TKIID tkiid)
                                   throws IdWrongFormatException,
                                          NotAuthorizedException,
                                          ObjectDoesNotExistException,
                                          UnexpectedFailureException,
                                          java.rmi.RemoteException,
                                          javax.ejb.EJBException
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.

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

Returns:
List - A list of CustomProperty objects containing the name and value pairs. Returns an empty list when there are no custom properties.

Throws:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

getBinaryCustomProperty

public BinaryCustomProperty getBinaryCustomProperty(java.lang.String tkiid,
                                                    java.lang.String propertyName)
                                             throws IdWrongFormatException,
                                                    IdWrongTypeException,
                                                    NotAuthorizedException,
                                                    ObjectDoesNotExistException,
                                                    ParameterNullException,
                                                    UnexpectedFailureException,
                                                    java.rmi.RemoteException,
                                                    javax.ejb.EJBException
Retrieves the named binary custom property of 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. 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.

Parameters:
tkiid - A string representation of the task instance ID. This string 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 binary custom property. Returns null when the named binary custom property cannot be found.

Throws:
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

getBinaryCustomProperty

public BinaryCustomProperty getBinaryCustomProperty(TKIID tkiid,
                                                    java.lang.String propertyName)
                                             throws IdWrongFormatException,
                                                    NotAuthorizedException,
                                                    ObjectDoesNotExistException,
                                                    ParameterNullException,
                                                    UnexpectedFailureException,
                                                    java.rmi.RemoteException,
                                                    javax.ejb.EJBException
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.

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 binary custom property. Returns null when the named binary custom property cannot be found.

Throws:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

getBinaryCustomPropertyNames

public java.util.List getBinaryCustomPropertyNames(java.lang.String tkiid)
                                            throws IdWrongFormatException,
                                                   IdWrongTypeException,
                                                   NotAuthorizedException,
                                                   ObjectDoesNotExistException,
                                                   UnexpectedFailureException,
                                                   java.rmi.RemoteException,
                                                   javax.ejb.EJBException
Retrieves the names of all binary custom properties of 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. 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 - A string representation of the task instance ID. This string 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:
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

getBinaryCustomPropertyNames

public java.util.List getBinaryCustomPropertyNames(TKIID tkiid)
                                            throws IdWrongFormatException,
                                                   NotAuthorizedException,
                                                   ObjectDoesNotExistException,
                                                   UnexpectedFailureException,
                                                   java.rmi.RemoteException,
                                                   javax.ejb.EJBException
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:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

getDocumentation

public java.lang.String getDocumentation(java.lang.String identifier,
                                         java.util.Locale locale)
                                  throws IdWrongFormatException,
                                         IdWrongTypeException,
                                         NotAuthorizedException,
                                         ObjectDoesNotExistException,
                                         UnexpectedFailureException,
                                         java.rmi.RemoteException,
                                         javax.ejb.EJBException
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.

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.

Returns:
String - The documentation. Returns null when there is no documentation in the specified locale.

Throws:
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

getDocumentation

public java.lang.String getDocumentation(ESIID esiid,
                                         java.util.Locale locale)
                                  throws IdWrongFormatException,
                                         NotAuthorizedException,
                                         ObjectDoesNotExistException,
                                         UnexpectedFailureException,
                                         java.rmi.RemoteException,
                                         javax.ejb.EJBException
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.

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.

Returns:
String - The documentation. Returns null when there is no documentation in the specified locale.

Throws:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

getDocumentation

public java.lang.String getDocumentation(ESTID estid,
                                         java.util.Locale locale)
                                  throws IdWrongFormatException,
                                         NotAuthorizedException,
                                         ObjectDoesNotExistException,
                                         UnexpectedFailureException,
                                         java.rmi.RemoteException,
                                         javax.ejb.EJBException
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.

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.

Returns:
String - The documentation. Returns null when there is no documentation in the specified locale.

Throws:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

getDocumentation

public java.lang.String getDocumentation(TKIID tkiid,
                                         java.util.Locale locale)
                                  throws IdWrongFormatException,
                                         NotAuthorizedException,
                                         ObjectDoesNotExistException,
                                         UnexpectedFailureException,
                                         java.rmi.RemoteException,
                                         javax.ejb.EJBException
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.

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.

Returns:
String - The documentation. Returns null when there is no documentation in the specified locale.

Throws:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

getDocumentation

public java.lang.String getDocumentation(TKTID tktid,
                                         java.util.Locale locale)
                                  throws IdWrongFormatException,
                                         NotAuthorizedException,
                                         ObjectDoesNotExistException,
                                         UnexpectedFailureException,
                                         java.rmi.RemoteException,
                                         javax.ejb.EJBException
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.

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.

Returns:
String - The documentation. Returns null when there is no documentation in the specified locale.

Throws:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

getEscalation

public Escalation getEscalation(java.lang.String esiid)
                         throws IdWrongFormatException,
                                IdWrongTypeException,
                                NotAuthorizedException,
                                ObjectDoesNotExistException,
                                UnexpectedFailureException,
                                java.rmi.RemoteException,
                                javax.ejb.EJBException
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.

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:
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

getEscalation

public Escalation getEscalation(ESIID esiid)
                         throws IdWrongFormatException,
                                NotAuthorizedException,
                                ObjectDoesNotExistException,
                                UnexpectedFailureException,
                                java.rmi.RemoteException,
                                javax.ejb.EJBException
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.

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:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

getEscalationTemplate

public EscalationTemplate getEscalationTemplate(java.lang.String estid)
                                         throws IdWrongFormatException,
                                                IdWrongTypeException,
                                                NotAuthorizedException,
                                                ObjectDoesNotExistException,
                                                UnexpectedFailureException,
                                                java.rmi.RemoteException,
                                                javax.ejb.EJBException
Retrieves the specified escalation template using a string representation of the escalation template ID.

The caller must have at least reader authority.

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:
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

getEscalationTemplate

public EscalationTemplate getEscalationTemplate(ESTID estid)
                                         throws IdWrongFormatException,
                                                NotAuthorizedException,
                                                ObjectDoesNotExistException,
                                                UnexpectedFailureException,
                                                java.rmi.RemoteException,
                                                javax.ejb.EJBException
Retrieves the specified escalation template using the escalation template ID.

The caller must have at least reader authority.

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:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

getFaultMessage

public ClientObjectWrapper getFaultMessage(java.lang.String tkiid)
                                    throws DataHandlingException,
                                           IdWrongFormatException,
                                           IdWrongTypeException,
                                           NotAuthorizedException,
                                           ObjectDoesNotExistException,
                                           WrongKindException,
                                           WrongStateException,
                                           UnexpectedFailureException,
                                           java.rmi.RemoteException,
                                           javax.ejb.EJBException
Retrieves the fault message of the specified task instance using a string representation of the task instance ID.

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

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:
DataHandlingException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
5.1.1

getFaultMessage

public ClientObjectWrapper getFaultMessage(TKIID tkiid)
                                    throws DataHandlingException,
                                           IdWrongFormatException,
                                           NotAuthorizedException,
                                           ObjectDoesNotExistException,
                                           WrongKindException,
                                           WrongStateException,
                                           UnexpectedFailureException,
                                           java.rmi.RemoteException,
                                           javax.ejb.EJBException
Retrieves the fault message of the specified task instance using the task instance ID.

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

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:
DataHandlingException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
5.1.1

getFaultNames

public java.util.List getFaultNames(java.lang.String tkiid)
                             throws IdWrongFormatException,
                                    IdWrongTypeException,
                                    NotAuthorizedException,
                                    ObjectDoesNotExistException,
                                    WrongKindException,
                                    WrongStateException,
                                    UnexpectedFailureException,
                                    java.rmi.RemoteException,
                                    javax.ejb.EJBException
Retrieves the fault names defined for the specified task instance using a string representation of the task instance ID.

The task instance must be a participating or human task. It can be in any state. The caller must have at least reader authority for the task instance.

Parameters:
tkiid - A string representation of the task instance ID that is used to identify the task instance 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. Refer to complete, setFaultMessage, or to createFaultMessage.

Throws:
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
5.1.1

getFaultNames

public java.util.List getFaultNames(TKIID tkiid)
                             throws IdWrongFormatException,
                                    NotAuthorizedException,
                                    ObjectDoesNotExistException,
                                    WrongKindException,
                                    WrongStateException,
                                    UnexpectedFailureException,
                                    java.rmi.RemoteException,
                                    javax.ejb.EJBException
Retrieves the fault names defined for the specified task instance using the task instance ID.

The task instance must be a participating or human task. It can be in any state. The caller must have at least reader authority for the task instance.

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:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
5.1.1

getInputMessage

public ClientObjectWrapper getInputMessage(java.lang.String tkiid)
                                    throws DataHandlingException,
                                           IdWrongFormatException,
                                           IdWrongTypeException,
                                           NotAuthorizedException,
                                           ObjectDoesNotExistException,
                                           WrongKindException,
                                           WrongStateException,
                                           UnexpectedFailureException,
                                           java.rmi.RemoteException,
                                           javax.ejb.EJBException
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.

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:
DataHandlingException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
5.1.1

getInputMessage

public ClientObjectWrapper getInputMessage(TKIID tkiid)
                                    throws DataHandlingException,
                                           IdWrongFormatException,
                                           NotAuthorizedException,
                                           ObjectDoesNotExistException,
                                           WrongKindException,
                                           WrongStateException,
                                           UnexpectedFailureException,
                                           java.rmi.RemoteException,
                                           javax.ejb.EJBException
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.

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:
DataHandlingException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
5.1.1

getMessageTextOfException

public java.lang.String getMessageTextOfException(java.util.Locale locale,
                                                  java.lang.String messageKey,
                                                  java.lang.Object[] variableValues)
                                           throws ParameterNullException,
                                                  ObjectDoesNotExistException,
                                                  UnexpectedFailureException,
                                                  java.rmi.RemoteException,
                                                  javax.ejb.EJBException
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:
ParameterNullException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

getOutputMessage

public ClientObjectWrapper getOutputMessage(java.lang.String tkiid)
                                     throws DataHandlingException,
                                            IdWrongFormatException,
                                            IdWrongTypeException,
                                            NotAuthorizedException,
                                            ObjectDoesNotExistException,
                                            WrongKindException,
                                            WrongStateException,
                                            UnexpectedFailureException,
                                            java.rmi.RemoteException,
                                            javax.ejb.EJBException
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.

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:
DataHandlingException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
5.1.1

getOutputMessage

public ClientObjectWrapper getOutputMessage(TKIID tkiid)
                                     throws DataHandlingException,
                                            IdWrongFormatException,
                                            NotAuthorizedException,
                                            ObjectDoesNotExistException,
                                            WrongKindException,
                                            WrongStateException,
                                            UnexpectedFailureException,
                                            java.rmi.RemoteException,
                                            javax.ejb.EJBException
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.

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:
DataHandlingException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
5.1.1

getStoredQuery

public StoredQuery getStoredQuery(java.lang.String storedQueryName)
                           throws ObjectDoesNotExistException,
                                  ParameterNullException,
                                  UnexpectedFailureException,
                                  java.rmi.RemoteException,
                                  javax.ejb.EJBException
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:
ObjectDoesNotExistException
ParameterNullException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2 - introduced in 6.0

getStoredQuery

public StoredQuery getStoredQuery(java.lang.String userID,
                                  java.lang.String storedQueryName)
                           throws NotAuthorizedException,
                                  ObjectDoesNotExistException,
                                  ParameterNullException,
                                  UnexpectedFailureException,
                                  java.rmi.RemoteException,
                                  javax.ejb.EJBException
Retrieves the specified stored query definition for the specified 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:
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

getStoredQuery

public StoredQuery getStoredQuery(int kind,
                                  java.lang.String storedQueryName)
                           throws InvalidParameterException,
                                  ObjectDoesNotExistException,
                                  ParameterNullException,
                                  UnexpectedFailureException,
                                  java.rmi.RemoteException,
                                  javax.ejb.EJBException
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:
InvalidParameterException
ObjectDoesNotExistException
ParameterNullException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

getStoredQueryNames

public java.lang.String[] getStoredQueryNames()
                                       throws WorkItemManagerException,
                                              UnexpectedFailureException,
                                              java.rmi.RemoteException,
                                              javax.ejb.EJBException
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:
WorkItemManagerException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2 - introduced in 6.0

getStoredQueryNames

public java.lang.String[] getStoredQueryNames(java.lang.String userID)
                                       throws NotAuthorizedException,
                                              UnexpectedFailureException,
                                              java.rmi.RemoteException,
                                              javax.ejb.EJBException
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.

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:
NotAuthorizedException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

getStoredQueryNames

public java.lang.String[] getStoredQueryNames(int kind)
                                       throws InvalidParameterException,
                                              UnexpectedFailureException,
                                              java.rmi.RemoteException,
                                              javax.ejb.EJBException
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:
InvalidParameterException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

getSubTaskIDs

public java.util.List getSubTaskIDs(java.lang.String tkiid)
                             throws IdWrongFormatException,
                                    IdWrongTypeException,
                                    NotAuthorizedException,
                                    ObjectDoesNotExistException,
                                    UnexpectedFailureException,
                                    java.rmi.RemoteException,
                                    javax.ejb.EJBException
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.

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:
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

getSubTaskIDs

public java.util.List getSubTaskIDs(TKIID tkiid)
                             throws IdWrongFormatException,
                                    NotAuthorizedException,
                                    ObjectDoesNotExistException,
                                    UnexpectedFailureException,
                                    java.rmi.RemoteException,
                                    javax.ejb.EJBException
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.

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:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

getTask

public Task getTask(java.lang.String tkiid)
             throws IdWrongFormatException,
                    IdWrongTypeException,
                    NotAuthorizedException,
                    ObjectDoesNotExistException,
                    UnexpectedFailureException,
                    java.rmi.RemoteException,
                    javax.ejb.EJBException
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.

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:
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
5.1.1

getTask

public Task getTask(TKIID tkiid)
             throws IdWrongFormatException,
                    NotAuthorizedException,
                    ObjectDoesNotExistException,
                    UnexpectedFailureException,
                    java.rmi.RemoteException,
                    javax.ejb.EJBException
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.

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:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
5.1.1

getTaskTemplate

public TaskTemplate getTaskTemplate(java.lang.String tktid)
                             throws IdWrongFormatException,
                                    IdWrongTypeException,
                                    NotAuthorizedException,
                                    ObjectDoesNotExistException,
                                    UnexpectedFailureException,
                                    java.rmi.RemoteException,
                                    javax.ejb.EJBException
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.

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:
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

getTaskTemplate

public TaskTemplate getTaskTemplate(TKTID tktid)
                             throws IdWrongFormatException,
                                    NotAuthorizedException,
                                    ObjectDoesNotExistException,
                                    UnexpectedFailureException,
                                    java.rmi.RemoteException,
                                    javax.ejb.EJBException
Retrieves the specified task template using the task template ID.

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

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:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

getUISettings

public CustomClientSettings getUISettings(java.lang.String identifier)
                                   throws IdWrongFormatException,
                                          IdWrongTypeException,
                                          NotAuthorizedException,
                                          ObjectDoesNotExistException,
                                          WrongKindException,
                                          UnexpectedFailureException,
                                          java.rmi.RemoteException,
                                          javax.ejb.EJBException
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.

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:
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
5.1.1

getUISettings

public CustomClientSettings getUISettings(TKTID tktid)
                                   throws IdWrongFormatException,
                                          NotAuthorizedException,
                                          ObjectDoesNotExistException,
                                          UnexpectedFailureException,
                                          WrongKindException,
                                          java.rmi.RemoteException,
                                          javax.ejb.EJBException
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.

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:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
WrongKindException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

getUISettings

public CustomClientSettings getUISettings(TKIID tkiid)
                                   throws IdWrongFormatException,
                                          NotAuthorizedException,
                                          ObjectDoesNotExistException,
                                          UnexpectedFailureException,
                                          WrongKindException,
                                          java.rmi.RemoteException,
                                          javax.ejb.EJBException
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.

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:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
WrongKindException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
5.1.1

getUsersInRole

public StaffResultSet getUsersInRole(java.lang.String identifier,
                                     int role)
                              throws IdWrongFormatException,
                                     IdWrongTypeException,
                                     InvalidAssignmentReasonException,
                                     NotAuthorizedException,
                                     ObjectDoesNotExistException,
                                     WorkItemManagerException,
                                     UnexpectedFailureException,
                                     java.rmi.RemoteException,
                                     javax.ejb.EJBException
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.

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.

Returns:
StaffResultSet - The users that are members of the specified role. Refer to StaffResultSet for more information.

Throws:
IdWrongFormatException
IdWrongTypeException
InvalidAssignmentReasonException
NotAuthorizedException
ObjectDoesNotExistException
WorkItemManagerException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2 - introduced in 6.0

getUsersInRole

public StaffResultSet getUsersInRole(TKTID tktid,
                                     int role)
                              throws IdWrongFormatException,
                                     InvalidAssignmentReasonException,
                                     NotAuthorizedException,
                                     ObjectDoesNotExistException,
                                     WorkItemManagerException,
                                     UnexpectedFailureException,
                                     java.rmi.RemoteException,
                                     javax.ejb.EJBException
Retrieves the users that are members of the specified role for the specified task template using the task template ID.

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.

Returns:
StaffResultSet - The users that are members of the specified role. Refer to StaffResultSet for more information.

Throws:
IdWrongFormatException
InvalidAssignmentReasonException
NotAuthorizedException
ObjectDoesNotExistException
WorkItemManagerException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

getUsersInRole

public StaffResultSet getUsersInRole(TKIID tkiid,
                                     int role)
                              throws IdWrongFormatException,
                                     InvalidAssignmentReasonException,
                                     NotAuthorizedException,
                                     ObjectDoesNotExistException,
                                     WorkItemManagerException,
                                     UnexpectedFailureException,
                                     java.rmi.RemoteException,
                                     javax.ejb.EJBException
Retrieves the users that are members of the specified role for the specified task using the task instance ID.

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.

Returns:
StaffResultSet - The users that are members of the specified role. Refer to StaffResultSet for more information.

Throws:
IdWrongFormatException
InvalidAssignmentReasonException
NotAuthorizedException
ObjectDoesNotExistException
WorkItemManagerException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

getWorkItems

public WorkItem[] getWorkItems(ESIID esiid)
                        throws IdWrongFormatException,
                               NotAuthorizedException,
                               ObjectDoesNotExistException,
                               WorkItemManagerException,
                               UnexpectedFailureException,
                               java.rmi.RemoteException,
                               javax.ejb.EJBException
Returns an array of escalation work items of the logged-on user.

Parameters:
esiid - The object ID of the escalation instance.

Returns:
com.ibm.task.api.WorkItem[] - Array of WorkItem objects.Refer to WorkItem to view the WorkItem properties.

Throws:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WorkItemManagerException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2.1

getWorkItems

public WorkItem[] getWorkItems(java.lang.String oid)
                        throws IdWrongFormatException,
                               IdWrongTypeException,
                               NotAuthorizedException,
                               ObjectDoesNotExistException,
                               WorkItemManagerException,
                               UnexpectedFailureException,
                               java.rmi.RemoteException,
                               javax.ejb.EJBException
Returns an array of task or escalation work items of the logged-on user.

Parameters:
oid - The string representation of the task or escalation instance ID.

Returns:
com.ibm.task.api.WorkItem[] - Array of WorkItem objects.Refer to WorkItem to view the WorkItem properties.

Throws:
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WorkItemManagerException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2.1

getWorkItems

public WorkItem[] getWorkItems(TKIID tkiid)
                        throws IdWrongFormatException,
                               NotAuthorizedException,
                               ObjectDoesNotExistException,
                               WorkItemManagerException,
                               UnexpectedFailureException,
                               java.rmi.RemoteException,
                               javax.ejb.EJBException
Returns an array of task work items of the logged-on user.

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

Returns:
com.ibm.task.api.WorkItem[] - Array of WorkItem objects.Refer to WorkItem to view the WorkItem properties.

Throws:
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WorkItemManagerException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2.1

isSystemAdministrator

public boolean isSystemAdministrator()
                              throws java.rmi.RemoteException,
                                     javax.ejb.EJBException
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:
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

isSystemMonitor

public boolean isSystemMonitor()
                        throws java.rmi.RemoteException,
                               javax.ejb.EJBException
States whether the logged-on user is a 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 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:
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

isUserInRole

public boolean isUserInRole(java.lang.String identifier,
                            java.lang.String userID,
                            int role)
                     throws IdWrongFormatException,
                            IdWrongTypeException,
                            InvalidAssignmentReasonException,
                            NotAuthorizedException,
                            ObjectDoesNotExistException,
                            ParameterNullException,
                            UserRegistryException,
                            WorkItemManagerException,
                            UnexpectedFailureException,
                            java.rmi.RemoteException,
                            javax.ejb.EJBException
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.

Parameters:
identifier - A string representation of task instance or template ID that is used to identify the task instance or template.
userID - The user who is to be checked.
role - The role that the user needs to be a member of.

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:
IdWrongFormatException
IdWrongTypeException
InvalidAssignmentReasonException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
UserRegistryException
WorkItemManagerException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2 - introduced in 6.0

isUserInRole

public boolean isUserInRole(TKTID tktid,
                            java.lang.String userID,
                            int role)
                     throws IdWrongFormatException,
                            InvalidAssignmentReasonException,
                            NotAuthorizedException,
                            ObjectDoesNotExistException,
                            ParameterNullException,
                            UserRegistryException,
                            WorkItemManagerException,
                            UnexpectedFailureException,
                            java.rmi.RemoteException,
                            javax.ejb.EJBException
States whether the specified user is a member of the specified role for the specified task template using the task template ID.

Parameters:
tktid - The object ID of the task template that is used to identify the task template.
userID - The user who is to be checked.
role - The role that the user needs to be a member of, either an administrator, reader, or potential instance creator.

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:
IdWrongFormatException
InvalidAssignmentReasonException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
UserRegistryException
WorkItemManagerException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

isUserInRole

public boolean isUserInRole(TKIID tkiid,
                            java.lang.String userID,
                            int role)
                     throws IdWrongFormatException,
                            InvalidAssignmentReasonException,
                            NotAuthorizedException,
                            ObjectDoesNotExistException,
                            ParameterNullException,
                            UserRegistryException,
                            WorkItemManagerException,
                            UnexpectedFailureException,
                            java.rmi.RemoteException,
                            javax.ejb.EJBException
States whether the specified user is a member of the specified role for the specified task instance using the task instance ID.

Parameters:
tkiid - The object ID of the task instance that is used to identify the task instance.
userID - The user who is to be checked.
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.

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:
IdWrongFormatException
InvalidAssignmentReasonException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
UserRegistryException
WorkItemManagerException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2 - introduced in 6.0

query

public QueryResultSet query(java.lang.String selectClause,
                            java.lang.String whereClause,
                            java.lang.String orderByClause,
                            java.lang.Integer threshold,
                            java.util.TimeZone timeZone)
                     throws ParameterNullException,
                            UnexpectedFailureException,
                            WorkItemManagerException,
                            java.rmi.RemoteException,
                            javax.ejb.EJBException
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. This means that the locale of the server is used for sorting.

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. All properties of objects are returned for which you own a work item, that is, which can be transitively reached via your work items.

Note that a system administrator or system monitor has special rights and can retrieve all properties of objects for which there are some user's work item. Above that, these persons are the only users who can use properties of the TASK_TEMPL view only. All other users must specify a non task template property in the select- or where-clause.

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:
ParameterNullException
UnexpectedFailureException
WorkItemManagerException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
5.1.1

query

public 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)
                     throws ParameterNullException,
                            UnexpectedFailureException,
                            WorkItemManagerException,
                            java.rmi.RemoteException,
                            javax.ejb.EJBException
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. This means that the locale of the server is used for sorting.

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. All properties of objects are returned for which you own a work item, that is, which can be transitively reached via your work items.

Note that a system administrator or system monitor has special rights and can retrieve all properties of objects for which there are some user's work item. Above that, these persons are the only users who can use properties of the TASK_TEMPL view only. All other users must specify a non task template property in the select- or where-clause.

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:
ParameterNullException
UnexpectedFailureException
WorkItemManagerException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

query

public QueryResultSet query(java.lang.String storedQueryName,
                            java.lang.Integer skipTuples)
                     throws IdWrongFormatException,
                            ObjectDoesNotExistException,
                            ParameterNullException,
                            QueryInvalidOperandException,
                            QueryInvalidTimestampException,
                            QueryUndefinedParameterException,
                            QueryUnknownColumnException,
                            QueryUnknownOperatorException,
                            QueryUnknownTableException,
                            UnexpectedFailureException,
                            java.rmi.RemoteException,
                            javax.ejb.EJBException
Deprecated. Use query,

Calls the specified stored query and returns the qualifying object properties. If a private stored query exists for the calling user, then the private stored query is called; 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 system administrator or system monitor has special rights and can retrieve all properties of objects for which there are some 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:
IdWrongFormatException
ObjectDoesNotExistException
ParameterNullException
QueryInvalidOperandException
QueryInvalidTimestampException
QueryUndefinedParameterException
QueryUnknownColumnException
QueryUnknownOperatorException
QueryUnknownTableException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2 - introduced in 6.0

query

public QueryResultSet query(java.lang.String storedQueryName,
                            java.lang.Integer skipTuples,
                            java.util.List parameters)
                     throws IdWrongFormatException,
                            InvalidStoredQueryParametersException,
                            ObjectDoesNotExistException,
                            ParameterNullException,
                            QueryInvalidOperandException,
                            QueryInvalidTimestampException,
                            QueryUndefinedParameterException,
                            QueryUnknownColumnException,
                            QueryUnknownOperatorException,
                            QueryUnknownTableException,
                            UnexpectedFailureException,
                            java.rmi.RemoteException,
                            javax.ejb.EJBException
Calls the specified stored query, specifies values for the parameters in the where-clause, and returns the qualifying object properties. If a private stored query exists for the calling user, then the private stored query is called; 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 system administrator or system monitor has special rights and can retrieve all properties of objects for which there are some 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:
IdWrongFormatException
InvalidStoredQueryParametersException
ObjectDoesNotExistException
ParameterNullException
QueryInvalidOperandException
QueryInvalidTimestampException
QueryUndefinedParameterException
QueryUnknownColumnException
QueryUnknownOperatorException
QueryUnknownTableException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

query

public QueryResultSet query(java.lang.String storedQueryName,
                            java.lang.Integer skipTuples,
                            java.lang.Integer threshold)
                     throws IdWrongFormatException,
                            ObjectDoesNotExistException,
                            ParameterNullException,
                            QueryInvalidOperandException,
                            QueryInvalidTimestampException,
                            QueryUndefinedParameterException,
                            QueryUnknownColumnException,
                            QueryUnknownOperatorException,
                            QueryUnknownTableException,
                            UnexpectedFailureException,
                            java.rmi.RemoteException,
                            javax.ejb.EJBException
Deprecated. Use query,

Calls the specified stored query and returns the properties of objects in the specified range. If a private stored query exists for the calling user, then the private stored query is called; 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 system administrator or system monitor has special rights and can retrieve all properties of objects for which there are some 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:
IdWrongFormatException
ObjectDoesNotExistException
ParameterNullException
QueryInvalidOperandException
QueryInvalidTimestampException
QueryUndefinedParameterException
QueryUnknownColumnException
QueryUnknownOperatorException
QueryUnknownTableException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2 - introduced in 6.0.1

query

public QueryResultSet query(java.lang.String storedQueryName,
                            java.lang.Integer skipTuples,
                            java.lang.Integer threshold,
                            java.util.List parameters)
                     throws IdWrongFormatException,
                            InvalidStoredQueryParametersException,
                            ObjectDoesNotExistException,
                            ParameterNullException,
                            QueryInvalidOperandException,
                            QueryInvalidTimestampException,
                            QueryUndefinedParameterException,
                            QueryUnknownColumnException,
                            QueryUnknownOperatorException,
                            QueryUnknownTableException,
                            UnexpectedFailureException,
                            java.rmi.RemoteException,
                            javax.ejb.EJBException
Calls the specified stored query and specifies values for parameters in the where-clause.

Only properties of objects are returned for which the logged-on user has a work item. Note that a system administrator or system monitor has special rights and can retrieve all properties of objects for which there are some 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:
IdWrongFormatException
InvalidStoredQueryParametersException
ObjectDoesNotExistException
ParameterNullException
QueryInvalidOperandException
QueryInvalidTimestampException
QueryUndefinedParameterException
QueryUnknownColumnException
QueryUnknownOperatorException
QueryUnknownTableException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

query

public QueryResultSet query(java.lang.String userID,
                            java.lang.String storedQueryName,
                            java.lang.Integer skipTuples,
                            java.lang.Integer threshold,
                            java.util.List parameters)
                     throws IdWrongFormatException,
                            InvalidStoredQueryParametersException,
                            NotAuthorizedException,
                            ObjectDoesNotExistException,
                            ParameterNullException,
                            QueryInvalidOperandException,
                            QueryInvalidTimestampException,
                            QueryUndefinedParameterException,
                            QueryUnknownColumnException,
                            QueryUnknownOperatorException,
                            QueryUnknownTableException,
                            UnexpectedFailureException,
                            java.rmi.RemoteException,
                            javax.ejb.EJBException
Calls the specified 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 system administrator or system monitor has special rights and can retrieve all properties of objects for which there are some 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:
IdWrongFormatException
InvalidStoredQueryParametersException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
QueryInvalidOperandException
QueryInvalidTimestampException
QueryUndefinedParameterException
QueryUnknownColumnException
QueryUnknownOperatorException
QueryUnknownTableException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

query

public QueryResultSet query(int kind,
                            java.lang.String storedQueryName,
                            java.lang.Integer skipTuples,
                            java.lang.Integer threshold,
                            java.util.List parameters)
                     throws IdWrongFormatException,
                            InvalidParameterException,
                            InvalidStoredQueryParametersException,
                            ObjectDoesNotExistException,
                            ParameterNullException,
                            QueryInvalidOperandException,
                            QueryInvalidTimestampException,
                            QueryUndefinedParameterException,
                            QueryUnknownColumnException,
                            QueryUnknownOperatorException,
                            QueryUnknownTableException,
                            UnexpectedFailureException,
                            java.rmi.RemoteException,
                            javax.ejb.EJBException
Calls 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 system administrator or system monitor has special rights and can retrieve all properties of objects for which there are some 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:
IdWrongFormatException
InvalidParameterException
InvalidStoredQueryParametersException
ObjectDoesNotExistException
ParameterNullException
QueryInvalidOperandException
QueryInvalidTimestampException
QueryUndefinedParameterException
QueryUnknownColumnException
QueryUnknownOperatorException
QueryUnknownTableException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

queryAll

public 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)
                        throws NotAuthorizedException,
                               ParameterNullException,
                               UnexpectedFailureException,
                               WorkItemManagerException,
                               java.rmi.RemoteException,
                               javax.ejb.EJBException
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. This means that the locale of the server is used for sorting.

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 system administrator or system 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:
NotAuthorizedException
ParameterNullException
UnexpectedFailureException
WorkItemManagerException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

queryTaskTemplates

public TaskTemplate[] queryTaskTemplates(java.lang.String whereClause,
                                         java.lang.String orderByClause,
                                         java.lang.Integer threshold,
                                         java.util.TimeZone timeZone)
                                  throws IdWrongFormatException,
                                         QueryInvalidOperandException,
                                         QueryInvalidTimestampException,
                                         QueryUndefinedParameterException,
                                         QueryUnknownColumnException,
                                         QueryUnknownOperatorException,
                                         QueryUnknownTableException,
                                         UnexpectedFailureException,
                                         java.rmi.RemoteException,
                                         javax.ejb.EJBException
Retrieves task templates that are persistently stored in the database and that are part of started applications.

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. This means that the locale of the server is used for sorting.

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 process template properties.

Throws:
IdWrongFormatException
QueryInvalidOperandException
QueryInvalidTimestampException
QueryUndefinedParameterException
QueryUnknownColumnException
QueryUnknownOperatorException
QueryUnknownTableException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

resume

public void resume(java.lang.String tkiid)
            throws ApplicationVetoException,
                   IdWrongFormatException,
                   IdWrongTypeException,
                   NotAuthorizedException,
                   ObjectDoesNotExistException,
                   WrongKindException,
                   WrongStateException,
                   UnexpectedFailureException,
                   java.rmi.RemoteException,
                   javax.ejb.EJBException
Resumes the execution of the specified suspended human or participating task instance using a string representation of the task instance ID.

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.

Parameters:
tkiid - A string representation of the task instance ID to be resumed.

Throws:
ApplicationVetoException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

resume

public void resume(TKIID tkiid)
            throws ApplicationVetoException,
                   IdWrongFormatException,
                   NotAuthorizedException,
                   ObjectDoesNotExistException,
                   WrongKindException,
                   WrongStateException,
                   UnexpectedFailureException,
                   java.rmi.RemoteException,
                   javax.ejb.EJBException
Resumes the execution of the specified suspended human or participating task instance using the task instance ID.

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.

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

Throws:
ApplicationVetoException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

setCustomProperty

public void setCustomProperty(java.lang.String tkiid,
                              java.lang.String propertyName,
                              java.lang.String propertyValue)
                       throws ApplicationVetoException,
                              IdWrongFormatException,
                              IdWrongTypeException,
                              InvalidLengthException,
                              NotAuthorizedException,
                              ObjectDoesNotExistException,
                              ParameterNullException,
                              WrongKindException,
                              UnexpectedFailureException,
                              java.rmi.RemoteException,
                              javax.ejb.EJBException
Stores custom-specific values for the specified task instance using a string representation of the object 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.

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 owner, starter, editor, or administrator of the task instance.

Parameters:
tkiid - A string representation of the task instance ID that is used to identify 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:
ApplicationVetoException
IdWrongFormatException
IdWrongTypeException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
5.1.1

setCustomProperty

public void setCustomProperty(TKIID tkiid,
                              java.lang.String propertyName,
                              java.lang.String propertyValue)
                       throws ApplicationVetoException,
                              IdWrongFormatException,
                              InvalidLengthException,
                              NotAuthorizedException,
                              ObjectDoesNotExistException,
                              ParameterNullException,
                              WrongKindException,
                              UnexpectedFailureException,
                              java.rmi.RemoteException,
                              javax.ejb.EJBException
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 owner, starter, editor, or administrator of the task instance.

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:
ApplicationVetoException
IdWrongFormatException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
5.1.1

setBinaryCustomProperty

public void setBinaryCustomProperty(java.lang.String tkiid,
                                    BinaryCustomProperty property)
                             throws ApplicationVetoException,
                                    IdWrongFormatException,
                                    IdWrongTypeException,
                                    InvalidLengthException,
                                    NotAuthorizedException,
                                    ObjectDoesNotExistException,
                                    ParameterNullException,
                                    UnexpectedFailureException,
                                    java.rmi.RemoteException,
                                    javax.ejb.EJBException
Stores custom-specific binary 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. 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 owner, starter, editor, or administrator of the task instance.

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

Throws:
ApplicationVetoException
IdWrongFormatException
IdWrongTypeException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

setBinaryCustomProperty

public void setBinaryCustomProperty(TKIID tkiid,
                                    BinaryCustomProperty property)
                             throws ApplicationVetoException,
                                    IdWrongFormatException,
                                    InvalidLengthException,
                                    NotAuthorizedException,
                                    ObjectDoesNotExistException,
                                    ParameterNullException,
                                    UnexpectedFailureException,
                                    java.rmi.RemoteException,
                                    javax.ejb.EJBException
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 owner, starter, editor, or administrator of the task instance.

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

Throws:
ApplicationVetoException
IdWrongFormatException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

setFaultMessage

public void setFaultMessage(java.lang.String tkiid,
                            java.lang.String faultName,
                            ClientObjectWrapper faultMessage)
                     throws IdWrongFormatException,
                            IdWrongTypeException,
                            InvalidQNameException,
                            NotAuthorizedException,
                            ObjectDoesNotExistException,
                            ParameterNullException,
                            WrongKindException,
                            WrongMessageTypeException,
                            WrongStateException,
                            UnexpectedFailureException,
                            java.rmi.RemoteException,
                            javax.ejb.EJBException
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 participating or human task. 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.

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:
IdWrongFormatException
IdWrongTypeException
InvalidQNameException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
5.1.1

setFaultMessage

public void setFaultMessage(TKIID tkiid,
                            java.lang.String faultName,
                            ClientObjectWrapper faultMessage)
                     throws IdWrongFormatException,
                            InvalidQNameException,
                            NotAuthorizedException,
                            ObjectDoesNotExistException,
                            ParameterNullException,
                            WrongKindException,
                            WrongMessageTypeException,
                            WrongStateException,
                            UnexpectedFailureException,
                            java.rmi.RemoteException,
                            javax.ejb.EJBException
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.

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:
IdWrongFormatException
InvalidQNameException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
5.1.1

setOutputMessage

public void setOutputMessage(java.lang.String tkiid,
                             ClientObjectWrapper outputMessage)
                      throws DataHandlingException,
                             IdWrongFormatException,
                             IdWrongTypeException,
                             NotAuthorizedException,
                             ObjectDoesNotExistException,
                             ParameterNullException,
                             WrongKindException,
                             WrongMessageTypeException,
                             WrongStateException,
                             UnexpectedFailureException,
                             java.rmi.RemoteException,
                             javax.ejb.EJBException
Stores the output message of 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 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.

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:
DataHandlingException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
5.1.1

setOutputMessage

public void setOutputMessage(TKIID tkiid,
                             ClientObjectWrapper outputMessage)
                      throws DataHandlingException,
                             IdWrongFormatException,
                             NotAuthorizedException,
                             ObjectDoesNotExistException,
                             ParameterNullException,
                             WrongKindException,
                             WrongMessageTypeException,
                             WrongStateException,
                             UnexpectedFailureException,
                             java.rmi.RemoteException,
                             javax.ejb.EJBException
Stores the output message of 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 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.

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:
DataHandlingException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
5.1.1

startTask

public void startTask(java.lang.String tkiid,
                      ClientObjectWrapper input,
                      ReplyHandlerWrapper replyHandler)
               throws AdministratorCannotBeResolvedException,
                      ApplicationVetoException,
                      CannotCreateWorkItemException,
                      IdWrongFormatException,
                      IdWrongTypeException,
                      InvalidLengthException,
                      NotAuthorizedException,
                      ObjectDoesNotExistException,
                      SCAServiceAccessFailureException,
                      SCAServiceResultErrorException,
                      WrongKindException,
                      WrongMessageTypeException,
                      WrongStateException,
                      UnexpectedFailureException,
                      java.rmi.RemoteException,
                      javax.ejb.EJBException
Asynchronously executes a previously created task using a string representation of the task instance ID.

The task instance must be in the ready state. The caller must be a potential starter, the originator, or an administrator of the task. When the task is an originating task, then the caller becomes the starter of the task.

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:
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
IdWrongFormatException
IdWrongTypeException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
SCAServiceAccessFailureException
SCAServiceResultErrorException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

startTask

public void startTask(TKIID tkiid,
                      ClientObjectWrapper input,
                      ReplyHandlerWrapper replyHandler)
               throws AdministratorCannotBeResolvedException,
                      ApplicationVetoException,
                      CannotCreateWorkItemException,
                      IdWrongFormatException,
                      InvalidLengthException,
                      NotAuthorizedException,
                      ObjectDoesNotExistException,
                      SCAServiceAccessFailureException,
                      SCAServiceResultErrorException,
                      WrongKindException,
                      WrongMessageTypeException,
                      WrongStateException,
                      UnexpectedFailureException,
                      java.rmi.RemoteException,
                      javax.ejb.EJBException
Asynchronously executes a previously created task using the task instance ID.

The task instance must be in the ready state. The caller must be a potential starter, the originator, or an administrator of the task. When the task is an originating task, then the caller becomes the starter of the task.

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:
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
IdWrongFormatException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
SCAServiceAccessFailureException
SCAServiceResultErrorException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

startTaskAsSubTask

public void startTaskAsSubTask(java.lang.String tkiid,
                               java.lang.String parentTaskID,
                               ClientObjectWrapper input)
                        throws AdministratorCannotBeResolvedException,
                               ApplicationVetoException,
                               CannotCreateWorkItemException,
                               IdWrongFormatException,
                               IdWrongTypeException,
                               InvalidApplicationStateException,
                               InvalidLengthException,
                               NotAuthorizedException,
                               ObjectDoesNotExistException,
                               SCAServiceAccessFailureException,
                               SCAServiceResultErrorException,
                               SubTasksNotSupportedException,
                               WrongKindException,
                               WrongMessageTypeException,
                               WrongStateException,
                               UnexpectedFailureException,
                               java.rmi.RemoteException,
                               javax.ejb.EJBException
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 human or standalone originating task. The parent task instance must be a human or participating task in the claimed state. 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 ready 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 originating task, then the caller becomes the starter of the task.

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:
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
IdWrongFormatException
IdWrongTypeException
InvalidApplicationStateException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
SCAServiceAccessFailureException
SCAServiceResultErrorException
SubTasksNotSupportedException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

startTaskAsSubTask

public void startTaskAsSubTask(TKIID tkiid,
                               TKIID parentTaskID,
                               ClientObjectWrapper input)
                        throws AdministratorCannotBeResolvedException,
                               ApplicationVetoException,
                               CannotCreateWorkItemException,
                               IdWrongFormatException,
                               InvalidApplicationStateException,
                               InvalidLengthException,
                               NotAuthorizedException,
                               ObjectDoesNotExistException,
                               SCAServiceAccessFailureException,
                               SCAServiceResultErrorException,
                               SubTasksNotSupportedException,
                               WrongKindException,
                               WrongMessageTypeException,
                               WrongStateException,
                               UnexpectedFailureException,
                               java.rmi.RemoteException,
                               javax.ejb.EJBException
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 human or standalone originating task. The parent task instance must be a human or participating task in the claimed state. 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 ready 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 originating task, then the caller becomes the starter of the task.

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:
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
IdWrongFormatException
InvalidApplicationStateException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
SCAServiceAccessFailureException
SCAServiceResultErrorException
SubTasksNotSupportedException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

startTaskTemplate

public void startTaskTemplate(java.lang.String tktid)
                       throws ApplicationVetoException,
                              IdWrongFormatException,
                              IdWrongTypeException,
                              NotAuthorizedException,
                              ObjectDoesNotExistException,
                              WrongKindException,
                              WrongStateException,
                              UnexpectedFailureException,
                              java.rmi.RemoteException,
                              javax.ejb.EJBException
This method starts a task template that has been created spontaneously 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.

Parameters:
tktid - A string representation of the object ID of the task template to be started.

Throws:
ApplicationVetoException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.1

startTaskTemplate

public void startTaskTemplate(TKTID tktid)
                       throws ApplicationVetoException,
                              IdWrongFormatException,
                              NotAuthorizedException,
                              ObjectDoesNotExistException,
                              WrongKindException,
                              WrongStateException,
                              UnexpectedFailureException,
                              java.rmi.RemoteException,
                              javax.ejb.EJBException
This method starts a task template that has been created spontaneously 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.

Parameters:
tktid - The object ID of the task template which is to be stopped.

Throws:
ApplicationVetoException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.1

stopTaskTemplate

public void stopTaskTemplate(java.lang.String tktid)
                      throws ApplicationVetoException,
                             IdWrongFormatException,
                             IdWrongTypeException,
                             NotAuthorizedException,
                             ObjectDoesNotExistException,
                             WrongKindException,
                             WrongStateException,
                             UnexpectedFailureException,
                             java.rmi.RemoteException,
                             javax.ejb.EJBException
This method stops a task template that has been created spontaneously 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.

Parameters:
tktid - A string representation of the object ID of the task template to be stopped.

Throws:
ApplicationVetoException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.1

stopTaskTemplate

public void stopTaskTemplate(TKTID tktid)
                      throws ApplicationVetoException,
                             IdWrongFormatException,
                             NotAuthorizedException,
                             ObjectDoesNotExistException,
                             WrongKindException,
                             WrongStateException,
                             UnexpectedFailureException,
                             java.rmi.RemoteException,
                             javax.ejb.EJBException
This method stops a task template that has been created spontaneously 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.

Parameters:
tktid - The object ID of the task template which is to be stopped.

Throws:
ApplicationVetoException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.1

suspend

public void suspend(java.lang.String tkiid)
             throws ApplicationVetoException,
                    IdWrongFormatException,
                    IdWrongTypeException,
                    NotAuthorizedException,
                    ObjectDoesNotExistException,
                    WrongKindException,
                    WrongStateException,
                    UnexpectedFailureException,
                    java.rmi.RemoteException,
                    javax.ejb.EJBException
Suspends the specified human or participating task instance using a string representation of the task instance ID.

The task instance can be in the ready 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.

Parameters:
tkiid - A string representation of the task instance ID to be suspended.

Throws:
ApplicationVetoException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

suspend

public void suspend(TKIID tkiid)
             throws ApplicationVetoException,
                    IdWrongFormatException,
                    NotAuthorizedException,
                    ObjectDoesNotExistException,
                    WrongKindException,
                    WrongStateException,
                    UnexpectedFailureException,
                    java.rmi.RemoteException,
                    javax.ejb.EJBException
Suspends the specified human or participating task instance using the task instance ID.

The task instance can be in the ready 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.

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

Throws:
ApplicationVetoException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

suspend

public void suspend(java.lang.String tkiid,
                    java.lang.String duration)
             throws ApplicationVetoException,
                    IdWrongFormatException,
                    IdWrongTypeException,
                    NotAuthorizedException,
                    ObjectDoesNotExistException,
                    ParameterNullException,
                    WrongKindException,
                    WrongStateException,
                    UnexpectedFailureException,
                    java.rmi.RemoteException,
                    javax.ejb.EJBException
Suspends the specified human or participating task instance for the specified duration using a string representation of the task instance ID.

The task instance can be in the ready 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.

Parameters:
tkiid - A string representation of the task instance ID to be suspended.
duration - The time for which the task instance ID 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:
ApplicationVetoException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

suspend

public void suspend(TKIID tkiid,
                    java.lang.String duration)
             throws ApplicationVetoException,
                    IdWrongFormatException,
                    NotAuthorizedException,
                    ObjectDoesNotExistException,
                    ParameterNullException,
                    WrongKindException,
                    WrongStateException,
                    UnexpectedFailureException,
                    java.rmi.RemoteException,
                    javax.ejb.EJBException
Suspends the specified human or participating task instance for the specified duration using the task instance ID.

The task instance can be in the ready 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.

Parameters:
tkiid - The object ID of the task instance to be suspended.
duration - The time for which the task instance ID 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:
ApplicationVetoException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

suspendAndCancelClaim

public void suspendAndCancelClaim(java.lang.String tkiid,
                                  java.lang.String duration,
                                  boolean keepTaskData)
                           throws ApplicationVetoException,
                                  IdWrongFormatException,
                                  IdWrongTypeException,
                                  NotAuthorizedException,
                                  ObjectDoesNotExistException,
                                  ParameterNullException,
                                  WrongKindException,
                                  WrongStateException,
                                  UnexpectedFailureException,
                                  java.rmi.RemoteException,
                                  javax.ejb.EJBException
Suspends the specified human or participating 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.

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.

Parameters:
tkiid - A string representation of the task instance ID to be suspended.
duration - The time for which the task instance ID 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:
ApplicationVetoException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

suspendAndCancelClaim

public void suspendAndCancelClaim(TKIID tkiid,
                                  java.lang.String duration,
                                  boolean keepTaskData)
                           throws ApplicationVetoException,
                                  IdWrongFormatException,
                                  NotAuthorizedException,
                                  ObjectDoesNotExistException,
                                  ParameterNullException,
                                  WrongKindException,
                                  WrongStateException,
                                  UnexpectedFailureException,
                                  java.rmi.RemoteException,
                                  javax.ejb.EJBException
Suspends the specified human or participating task instance for the specified duration 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.

Parameters:
tkiid - The object ID of the task instance to be suspended.
duration - The time for which the task instance ID 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:
ApplicationVetoException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

terminate

public void terminate(java.lang.String tkiid)
               throws ApplicationVetoException,
                      IdWrongFormatException,
                      IdWrongTypeException,
                      NotAuthorizedException,
                      ObjectDoesNotExistException,
                      WrongKindException,
                      WrongStateException,
                      UnexpectedFailureException,
                      java.rmi.RemoteException,
                      javax.ejb.EJBException
Terminates the specified task instance using a string representation of the task instance ID. Terminating an originating task has no impact on the invoked service.

The task instance can be in the ready, claimed, or running state. It can be escalated or suspended. The caller can be the owner, starter, or administrator of the task instance.

Parameters:
tkiid - A string representation of the object ID of the task instance to be terminated.

Throws:
ApplicationVetoException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

terminate

public void terminate(TKIID tkiid)
               throws ApplicationVetoException,
                      IdWrongFormatException,
                      NotAuthorizedException,
                      ObjectDoesNotExistException,
                      WrongKindException,
                      WrongStateException,
                      UnexpectedFailureException,
                      java.rmi.RemoteException,
                      javax.ejb.EJBException
Terminates the specified task instance using the task instance ID. Terminating an originating task has no impact on the invoked service.

The task instance can be in the ready, claimed, or running state. It can be escalated or suspended. The caller can be the owner, starter, or administrator of the task instance.

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

Throws:
ApplicationVetoException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0

transferWorkItem

public void transferWorkItem(java.lang.String identifier,
                             int assignmentReason,
                             java.lang.String fromOwner,
                             java.lang.String toOwner)
                      throws ApplicationVetoException,
                             EverybodyWorkItemException,
                             IdWrongFormatException,
                             IdWrongTypeException,
                             InvalidAssignmentReasonException,
                             InvalidLengthException,
                             NotAuthorizedException,
                             UserDoesNotExistException,
                             WorkItemDoesNotExistException,
                             ObjectDoesNotExistException,
                             ParameterNullException,
                             TaskDelegationNotSupportedException,
                             WorkItemManagerException,
                             WrongKindException,
                             WrongStateException,
                             UnexpectedFailureException,
                             java.rmi.RemoteException,
                             javax.ejb.EJBException
Transfers the specified work item using a string representation of the task or escalation instance ID.

The caller must be an owner, starter, originator, or administrator of the task instance. The task can be escalated.

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

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 getAssignmentReason for valid values.
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 the work item is transferred to a user, it is checked whether the user exists but the check may be executed case insensitively.

Throws:
ApplicationVetoException
EverybodyWorkItemException
IdWrongFormatException
IdWrongTypeException
InvalidAssignmentReasonException
InvalidLengthException
NotAuthorizedException
UserDoesNotExistException
WorkItemDoesNotExistException
ObjectDoesNotExistException
ParameterNullException
TaskDelegationNotSupportedException
WorkItemManagerException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2 - introduced in 5.1.1

transferWorkItem

public void transferWorkItem(TKIID tkiid,
                             int assignmentReason,
                             java.lang.String fromOwner,
                             java.lang.String toOwner)
                      throws ApplicationVetoException,
                             EverybodyWorkItemException,
                             IdWrongFormatException,
                             InvalidAssignmentReasonException,
                             InvalidLengthException,
                             NotAuthorizedException,
                             UserDoesNotExistException,
                             WorkItemDoesNotExistException,
                             ObjectDoesNotExistException,
                             ParameterNullException,
                             TaskDelegationNotSupportedException,
                             WorkItemManagerException,
                             WrongKindException,
                             WrongStateException,
                             UnexpectedFailureException,
                             java.rmi.RemoteException,
                             javax.ejb.EJBException
Transfers a 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.

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

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 getAssignmentReason.
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 the work item is transferred to a user, it is checked whether the user exists but the check may be executed case insensitively.

Throws:
ApplicationVetoException
EverybodyWorkItemException
IdWrongFormatException
InvalidAssignmentReasonException
InvalidLengthException
NotAuthorizedException
UserDoesNotExistException
WorkItemDoesNotExistException
ObjectDoesNotExistException
ParameterNullException
TaskDelegationNotSupportedException
WorkItemManagerException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2 - introduced in 5.1.1

transferWorkItem

public void transferWorkItem(ESIID esiid,
                             int assignmentReason,
                             java.lang.String fromOwner,
                             java.lang.String toOwner)
                      throws ApplicationVetoException,
                             EverybodyWorkItemException,
                             IdWrongFormatException,
                             InvalidAssignmentReasonException,
                             InvalidLengthException,
                             NotAuthorizedException,
                             UserDoesNotExistException,
                             WorkItemDoesNotExistException,
                             ObjectDoesNotExistException,
                             ParameterNullException,
                             TaskDelegationNotSupportedException,
                             WorkItemManagerException,
                             WrongKindException,
                             WrongStateException,
                             UnexpectedFailureException,
                             java.rmi.RemoteException,
                             javax.ejb.EJBException
Transfers the specified work item for the specified escalation instance using the escalation instance ID.

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

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 getAssignmentReason.
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 the work item is transferred to a user, it is checked whether the user exists but the check may be executed case insensitively.

Throws:
ApplicationVetoException
EverybodyWorkItemException
IdWrongFormatException
InvalidAssignmentReasonException
InvalidLengthException
NotAuthorizedException
UserDoesNotExistException
WorkItemDoesNotExistException
ObjectDoesNotExistException
ParameterNullException
TaskDelegationNotSupportedException
WorkItemManagerException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2

update

public void update(Task task)
            throws ApplicationVetoException,
                   InvalidLengthException,
                   NotAuthorizedException,
                   ObjectDoesNotExistException,
                   ParameterNullException,
                   PropertyVetoException,
                   WrongKindException,
                   WrongStateException,
                   UnexpectedFailureException,
                   java.rmi.RemoteException,
                   javax.ejb.EJBException
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.

The context authorization can be updated for inline tasks and tasks derived from task templates. All other properties can be updated for standalone tasks no matter whether they have been derived from task templates or whether they have been created spontaneously.

Parameters:
task - The task instance and the properties to be updated.

Throws:
ApplicationVetoException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
PropertyVetoException
WrongKindException
WrongStateException
UnexpectedFailureException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.2 - introduced in 6.0

update

public void update(java.lang.String tkiid,
                   TaskModel taskModel,
                   java.lang.String applicationName,
                   java.lang.String parentContext,
                   ClientObjectWrapper input)
            throws ApplicationVetoException,
                   CannotCreateWorkItemException,
                   IdWrongFormatException,
                   IdWrongTypeException,
                   InvalidLengthException,
                   NotAuthorizedException,
                   ObjectDoesNotExistException,
                   ParameterNullException,
                   WrongKindException,
                   WrongMessageTypeException,
                   WrongStateException,
                   UnexpectedFailureException,
                   com.ibm.task.plugins.TaskDeploymentException,
                   com.ibm.task.plugins.TELValidationException,
                   java.rmi.RemoteException,
                   javax.ejb.EJBException
Updates a task instance that has been created spontaneously 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.

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 definitions. If not specified, the application of the updated task instance is kept.
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:
ApplicationVetoException
CannotCreateWorkItemException
IdWrongFormatException
IdWrongTypeException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
com.ibm.task.plugins.TaskDeploymentException
com.ibm.task.plugins.TELValidationException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.1

update

public void update(TKIID tkiid,
                   TaskModel taskModel,
                   java.lang.String applicationName,
                   java.lang.String parentContext,
                   ClientObjectWrapper input)
            throws ApplicationVetoException,
                   CannotCreateWorkItemException,
                   IdWrongFormatException,
                   IdWrongTypeException,
                   InvalidLengthException,
                   NotAuthorizedException,
                   ObjectDoesNotExistException,
                   ParameterNullException,
                   WrongKindException,
                   WrongMessageTypeException,
                   WrongStateException,
                   UnexpectedFailureException,
                   com.ibm.task.plugins.TaskDeploymentException,
                   com.ibm.task.plugins.TELValidationException,
                   java.rmi.RemoteException,
                   javax.ejb.EJBException
Updates a task instance that has been created spontaneously 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.

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 definitions. If not specified, the application of the updated task instance is kept.
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:
ApplicationVetoException
CannotCreateWorkItemException
IdWrongFormatException
IdWrongTypeException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
com.ibm.task.plugins.TaskDeploymentException
com.ibm.task.plugins.TELValidationException
java.rmi.RemoteException
javax.ejb.EJBException
Since:
6.0.1