|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
HumanTaskManagerDelegate wraps the functions of the Human Task Manager API and hides the details of setting up the communication.
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(TKIID tkiid)
Cancels the claim of a task instance 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. |
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. |
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 getInputMessage ,
getOutputMessage ,
getFaultMessage . |
ClientObjectWrapper |
createMessage(TKIID tkiid,
java.lang.String messageTypeName)
Deprecated. Use getInputMessage ,
getOutputMessage ,
getFaultMessage . |
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 for general usage. |
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(java.lang.String tkiid,
int assignmentReason,
java.lang.String userID)
Creates a work item for the specified task instance using a string representation of the task 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 identifier)
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 |
deleteWorkItem(java.lang.String tkiid,
int assignmentReason,
java.lang.String userID)
Deletes the specified work item using a string representation of the task instance ID. |
void |
deleteWorkItem(TKIID tkiid,
int assignmentReason,
java.lang.String userID)
Deletes the specified work item using the task instance ID. |
void |
executeQuery(ExecutableQuery query)
Retrieves selected object properties persistently stored in the database using a predefined query object. |
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. |
java.util.List |
getCustomProperties(java.lang.String tkiid)
Retrieves all custom properties of the specified task instance using a string representation of the task instance ID. |
java.util.List |
getCustomProperties(TKIID tkiid)
Retrieves all custom properties of the specified task instance using the task instance ID. |
java.lang.String |
getCustomProperty(java.lang.String tkiid,
java.lang.String propertyName)
Retrieves the named custom property of the specified task instance 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.util.List |
getCustomPropertyNames(java.lang.String tkiid)
Retrieves the names of all custom properties of the specified task instance 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.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. |
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(java.lang.String storedQueryName)
Retrieves the specified stored query definition. |
java.lang.String[] |
getStoredQueryNames()
Retrieves the names of stored queries that are persistently stored in the database. |
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 tkiid,
int role)
Retrieves the users that are members of the specified role for the specified task using a string representation of the task instance 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. |
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 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 a string representation of the task instance 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. |
QueryResultSet |
query(java.lang.String storedQueryName,
java.lang.Integer skipTuples)
Calls the specified stored query and returns the qualifying object properties. |
QueryResultSet |
query(java.lang.String storedQueryName,
java.lang.Integer skipTuples,
java.lang.Integer threshold)
Calls the specified stored query and returns the properties of objects in the specified range. |
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 |
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 |
startTaskTemplate(java.lang.String tktid)
This method starts a task template that has been created on-the-fly using a string representation of the task template ID. |
void |
startTaskTemplate(TKTID tktid)
This method starts a task template that has been created on-the-fly using the task template ID. |
void |
stopTaskTemplate(java.lang.String tktid)
This method stops a task template that has been created on-the-fly using a string representation of the task template ID. |
void |
stopTaskTemplate(TKTID tktid)
This method stops a task template that has been created on-the-fly 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(TKIID tkiid)
Suspends the specified human or participating task instance 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(java.lang.String tkiid,
int assignmentReason,
java.lang.String fromUserID,
java.lang.String toUserID)
Transfers the specified work item to the specified user using a string representation of the task instance ID. |
void |
transferWorkItem(TKIID tkiid,
int assignmentReason,
java.lang.String fromUserID,
java.lang.String toUserID)
Transfers a work item for the specified task instance to the specified user 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 on-the-fly 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 on-the-fly using the task instance ID. |
Method Detail |
public void executeQuery(ExecutableQuery query) throws CommunicationException, ParameterNullException, WorkItemManagerException, UnexpectedFailureException
query
- The query specification
CommunicationException
ParameterNullException
WorkItemManagerException
UnexpectedFailureException
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, CommunicationException
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.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
FaultReplyException
IdWrongFormatException
IdWrongTypeException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
SCAServiceAccessFailureException
SCAServiceResultErrorException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
public ClientObjectWrapper callTask(TKIID tkiid, ClientObjectWrapper input) throws AdministratorCannotBeResolvedException, ApplicationVetoException, CannotCreateWorkItemException, FaultReplyException, IdWrongFormatException, InvalidLengthException, NotAuthorizedException, ObjectDoesNotExistException, SCAServiceAccessFailureException, SCAServiceResultErrorException, WrongKindException, WrongMessageTypeException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
FaultReplyException
IdWrongFormatException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
SCAServiceAccessFailureException
SCAServiceResultErrorException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
public void cancelClaim(java.lang.String tkiid) throws ApplicationVetoException, IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
tkiid
- A string representation of the task instance ID that is used
to identify the task instance.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public void cancelClaim(TKIID tkiid) throws ApplicationVetoException, IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
tkiid
- The task instance ID that is used to identify the task instance.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public ClientObjectWrapper claim(java.lang.String tkiid) throws ApplicationVetoException, CannotCreateWorkItemException, IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
tkiid
- A string representation of the task instance ID that is used
to identify the task instance to be claimed.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
CannotCreateWorkItemException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public ClientObjectWrapper claim(TKIID tkiid) throws ApplicationVetoException, CannotCreateWorkItemException, IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
tkiid
- The object ID of the task instance to be claimed.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
CannotCreateWorkItemException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public Task claim(java.lang.String whereClause, java.lang.String orderByClause, java.util.TimeZone timeZone) throws CannotCreateWorkItemException, WorkItemManagerException, UnexpectedFailureException, CommunicationException
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.
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:
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.
If a timezone is not specified, UTC is assumed.
Task
to view the task instance properties.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
CannotCreateWorkItemException
WorkItemManagerException
UnexpectedFailureException
public void complete(java.lang.String tkiid) throws ApplicationVetoException, IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
tkiid
- A string representation of the task instance ID that is used
to identify the task instance to be completed.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public void complete(TKIID tkiid) throws ApplicationVetoException, IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
tkiid
- The object ID to identify the task instance to be completed.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public void complete(java.lang.String tkiid, ClientObjectWrapper output) throws ApplicationVetoException, IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, ParameterNullException, WrongKindException, WrongMessageTypeException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
public void complete(TKIID tkiid, ClientObjectWrapper output) throws ApplicationVetoException, IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, ParameterNullException, WrongKindException, WrongMessageTypeException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
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, CommunicationException
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.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
IdWrongFormatException
IdWrongTypeException
InvalidQNameException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
public void complete(TKIID tkiid, java.lang.String faultName, ClientObjectWrapper faultMessage) throws ApplicationVetoException, IdWrongFormatException, InvalidQNameException, NotAuthorizedException, ObjectDoesNotExistException, ParameterNullException, WrongKindException, WrongMessageTypeException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
IdWrongFormatException
InvalidQNameException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
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, CommunicationException
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.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
FaultReplyException
InvalidApplicationStateException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
SCAServiceAccessFailureException
SCAServiceResultErrorException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
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, CommunicationException
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.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
InvalidApplicationStateException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
SCAServiceAccessFailureException
SCAServiceResultErrorException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
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, CommunicationException
The caller must have potential-instance-creator rights on the associated application component. The caller becomes the originator of the new task.
taskModel
- The model that describes the task instance to be created on-the-fly.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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
IdWrongTypeException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongMessageTypeException
UnexpectedFailureException
com.ibm.task.plugins.TaskDeploymentException
com.ibm.task.plugins.TELValidationException
public ClientObjectWrapper createFaultMessage(java.lang.String tkiid, java.lang.String faultName) throws IdWrongFormatException, IdWrongTypeException, InvalidQNameException, NotAuthorizedException, ObjectDoesNotExistException, ParameterNullException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
complete
.
The caller must be the owner, an editor, or an administrator of the task instance.
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
.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
IdWrongTypeException
InvalidQNameException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongStateException
UnexpectedFailureException
public ClientObjectWrapper createFaultMessage(TKIID tkiid, java.lang.String faultName) throws IdWrongFormatException, InvalidQNameException, NotAuthorizedException, ObjectDoesNotExistException, ParameterNullException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
complete
.
The caller must be the owner, an editor, or an administrator of the task instance.
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
.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
InvalidQNameException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongStateException
UnexpectedFailureException
public ClientObjectWrapper createInputMessage(java.lang.String identifier) throws IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
The caller must be the owner, a potential starter, the originator, or an administrator of the task instance.
identifier
- A string representation of the task instance or template ID
that is used to identify the task instance or template.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public ClientObjectWrapper createInputMessage(TKIID tkiid) throws IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
The caller must be the owner, a potential starter, the originator, or an administrator of the task instance.
tkiid
- The task instance ID that is used to identify the task instance.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public ClientObjectWrapper createInputMessage(TKTID tktid) throws IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
The caller must be the owner, a potential starter, the originator, or an administrator of the task instance.
tktid
- The task template ID that is used to identify the task template.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public ClientObjectWrapper createMessage(java.lang.String tkiid, java.lang.String messageTypeName) throws IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, ParameterNullException, UnexpectedFailureException, CommunicationException
getInputMessage
,
getOutputMessage
,
getFaultMessage
.
The caller must have at least reader authority for the task instance.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
UnexpectedFailureException
public ClientObjectWrapper createMessage(TKIID tkiid, java.lang.String messageTypeName) throws IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, ParameterNullException, UnexpectedFailureException, CommunicationException
getInputMessage
,
getOutputMessage
,
getFaultMessage
.
The caller must have at least reader authority for the task instance.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
UnexpectedFailureException
public ClientObjectWrapper createOutputMessage(java.lang.String tkiid) throws IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
The caller must be the owner, an editor, or an administrator of the task instance.
tkiid
- A string representation of the task instance ID
that is used to identify the task instance.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public ClientObjectWrapper createOutputMessage(TKIID tkiid) throws IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
The caller must be the owner, an editor, or an administrator of the task instance.
tkiid
- The task instance ID that is used to identify the task instance.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
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, CommunicationException
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.
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.
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.
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:
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.
If a timezone is not specified, UTC is assumed.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
InvalidLengthException
NotAuthorizedException
ParameterNullException
StoredQueryNameNotUniqueException
UnexpectedFailureException
public TKIID createTask(java.lang.String name, java.lang.String namespace) throws ApplicationVetoException, CannotCreateWorkItemException, InvalidApplicationStateException, InvalidLengthException, NotAuthorizedException, ObjectDoesNotExistException, ParameterNullException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
The caller must be a potential instance creator or an administrator of the task template.
name
- The name of the task template from which an instance is to be created.namespace
- The namespace of the task template.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
CannotCreateWorkItemException
InvalidApplicationStateException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongStateException
UnexpectedFailureException
public TKIID createTask(java.lang.String name, java.lang.String namespace, ClientObjectWrapper input) throws ApplicationVetoException, CannotCreateWorkItemException, InvalidApplicationStateException, InvalidLengthException, NotAuthorizedException, ObjectDoesNotExistException, ParameterNullException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
The caller must be a potential instance creator or an administrator of the task template.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
CannotCreateWorkItemException
InvalidApplicationStateException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongStateException
UnexpectedFailureException
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, CommunicationException
The caller must have potential-instance-creator rights on the associated application component.
taskModel
- The model that describes the task instance to be created on-the-fly.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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
CannotCreateWorkItemException
IdWrongTypeException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
UnexpectedFailureException
com.ibm.task.plugins.TaskDeploymentException
com.ibm.task.plugins.TELValidationException
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, CommunicationException
The caller must have potential-instance-creator rights on the associated application component.
taskModel
- The model that describes the task instance to be created on-the-fly.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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
CannotCreateWorkItemException
IdWrongTypeException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongMessageTypeException
UnexpectedFailureException
com.ibm.task.plugins.TaskDeploymentException
com.ibm.task.plugins.TELValidationException
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, CommunicationException
The caller must have potential-instance-creator rights on the associated application component.
taskModel
- The model that describes the task template to be created on-the-fly.applicationName
- The name of the enterprise application that contains the message definitions.
If the message definitions are simple types only, null may be specified.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
UnexpectedFailureException
com.ibm.task.plugins.TaskDeploymentException
com.ibm.task.plugins.TELValidationException
public void createWorkItem(java.lang.String tkiid, int assignmentReason, java.lang.String userID) throws ApplicationVetoException, EverybodyWorkItemException, IdWrongFormatException, IdWrongTypeException, InvalidAssignmentReasonException, InvalidLengthException, NotAuthorizedException, ObjectDoesNotExistException, ParameterNullException, TaskDelegationNotSupportedException, WorkItemManagerException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
The caller must be an administrator when the task is no longer inactive. 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:
tkiid
- A string representation of the task instance ID that is used to identify
the object the new work item should belong to.assignmentReason
- The reason why the work item is assigned - refer to
getAssignmentReason
for valid values.userID
- The user the work item should belong to.
It is not checked whether the user exists.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
EverybodyWorkItemException
IdWrongFormatException
IdWrongTypeException
InvalidAssignmentReasonException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
TaskDelegationNotSupportedException
WorkItemManagerException
WrongKindException
WrongStateException
UnexpectedFailureException
public void createWorkItem(TKIID tkiid, int assignmentReason, java.lang.String userID) throws ApplicationVetoException, EverybodyWorkItemException, IdWrongFormatException, InvalidAssignmentReasonException, InvalidLengthException, NotAuthorizedException, ObjectDoesNotExistException, ParameterNullException, TaskDelegationNotSupportedException, WorkItemManagerException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
The caller must be an administrator when the task is no longer inactive. 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:
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
for valid values.userID
- The user the work item should belong to.
It is not checked whether the user exists.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
EverybodyWorkItemException
IdWrongFormatException
InvalidAssignmentReasonException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
TaskDelegationNotSupportedException
WorkItemManagerException
WrongKindException
WrongStateException
UnexpectedFailureException
public void delete(java.lang.String identifier) throws ApplicationVetoException, ChildTaskInstanceActiveException, IdWrongFormatException, IdWrongTypeException, IsNotTopLevelTaskException, NotAuthorizedException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
identifier
- A string representation of the task instance ID
that is used to identify the task instance.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
ChildTaskInstanceActiveException
IdWrongFormatException
IdWrongTypeException
IsNotTopLevelTaskException
NotAuthorizedException
WrongKindException
WrongStateException
UnexpectedFailureException
public void delete(TKIID tkiid) throws ApplicationVetoException, IdWrongFormatException, IsNotTopLevelTaskException, NotAuthorizedException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
tkiid
- The task instance ID that is used to identify the task instance.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
IdWrongFormatException
IsNotTopLevelTaskException
NotAuthorizedException
WrongKindException
WrongStateException
UnexpectedFailureException
public void delete(java.lang.String identifier, boolean deleteInstances) throws ApplicationVetoException, ChildTaskInstanceActiveException, IdWrongFormatException, IdWrongTypeException, IsNotAdHocException, NotAuthorizedException, ObjectDoesNotExistException, RunningInstancesException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
ChildTaskInstanceActiveException
IdWrongFormatException
IdWrongTypeException
IsNotAdHocException
NotAuthorizedException
ObjectDoesNotExistException
RunningInstancesException
WrongKindException
WrongStateException
UnexpectedFailureException
public void delete(TKTID tktid, boolean deleteInstances) throws ApplicationVetoException, ChildTaskInstanceActiveException, IdWrongFormatException, IsNotAdHocException, NotAuthorizedException, ObjectDoesNotExistException, RunningInstancesException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
ChildTaskInstanceActiveException
IdWrongFormatException
IsNotAdHocException
NotAuthorizedException
ObjectDoesNotExistException
RunningInstancesException
WrongKindException
WrongStateException
UnexpectedFailureException
public void deleteStoredQuery(java.lang.String storedQueryName) throws NotAuthorizedException, ParameterNullException, UnexpectedFailureException, CommunicationException
Refer to createStoredQuery
for
the creation of stored queries.
storedQueryName
- The name of the stored query to be deleted -
refer to getStoredQueryNames
for the retrieval of existing stored query names.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
NotAuthorizedException
ParameterNullException
UnexpectedFailureException
public void deleteWorkItem(java.lang.String tkiid, int assignmentReason, java.lang.String userID) throws ApplicationVetoException, EverybodyWorkItemException, IdWrongFormatException, IdWrongTypeException, InvalidAssignmentReasonException, InvalidLengthException, LastAdminWorkItemException, NotAuthorizedException, WorkItemDoesNotExistException, ObjectDoesNotExistException, ParameterNullException, TaskDelegationNotSupportedException, WorkItemManagerException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
The caller must be an administrator when the task is no longer inactive. 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:
tkiid
- A string representation of the task 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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
EverybodyWorkItemException
IdWrongFormatException
IdWrongTypeException
InvalidAssignmentReasonException
InvalidLengthException
LastAdminWorkItemException
NotAuthorizedException
WorkItemDoesNotExistException
ObjectDoesNotExistException
ParameterNullException
TaskDelegationNotSupportedException
WorkItemManagerException
WrongKindException
WrongStateException
UnexpectedFailureException
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, CommunicationException
The caller must be an administrator when the task is no longer inactive. 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:
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
for valid values.userID
- The user the work item belongs to.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
EverybodyWorkItemException
IdWrongFormatException
InvalidAssignmentReasonException
InvalidLengthException
LastAdminWorkItemException
NotAuthorizedException
WorkItemDoesNotExistException
ObjectDoesNotExistException
ParameterNullException
TaskDelegationNotSupportedException
WorkItemManagerException
WrongKindException
WrongStateException
UnexpectedFailureException
public int[] getAvailableActions(java.lang.String tkiid) throws IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, UnexpectedFailureException, CommunicationException
TaskActions
for possible actions.
tkiid
- The string representation of the task instance ID.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
public int[] getAvailableActions(TKIID tkiid) throws IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, UnexpectedFailureException, CommunicationException
TaskActions
for possible actions.
tkiid
- The object ID of the task instance.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
public boolean[][] getAvailableActionFlags(java.lang.String[] tkiids) throws IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, UnexpectedFailureException, CommunicationException
TaskActions
for possible actions.
tkiids
- An array of string representations of task instance IDs.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
public boolean[][] getAvailableActionFlags(TKIID[] tkiids) throws IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, UnexpectedFailureException, CommunicationException
TaskActions
for possible actions.
tkiids
- An array of task instance IDs.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
public ApplicationComponent getApplicationComponent(java.lang.String acoid) throws IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, UnexpectedFailureException, CommunicationException
The caller must be the task system administrator or the task system monitor.
acoid
- A string representation of the application component ID. This is used
to identify the application component to be retrieved.
ApplicationComponent
to view the
application component properties.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
public ApplicationComponent getApplicationComponent(ACOID acoid) throws IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, UnexpectedFailureException, CommunicationException
The caller must be the task system administrator or the task system monitor.
acoid
- The object ID of the application component to be retrieved.
ApplicationComponent
to view the
application component properties.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
public java.lang.String getCustomProperty(java.lang.String tkiid, java.lang.String propertyName) throws IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, ParameterNullException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
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 the task instance. The caller must have at least reader authority for the task instance.
tkiid
- A string representation of the task instance 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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongStateException
UnexpectedFailureException
public java.lang.String getCustomProperty(TKIID tkiid, java.lang.String propertyName) throws IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, ParameterNullException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongStateException
UnexpectedFailureException
public java.util.List getCustomPropertyNames(java.lang.String tkiid) throws IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, UnexpectedFailureException, CommunicationException
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.
tkiid
- A string representation of the task instance ID. This
string is used to identify the task for which the
custom property names are to be retrieved.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
public java.util.List getCustomPropertyNames(TKIID tkiid) throws NotAuthorizedException, IdWrongFormatException, ObjectDoesNotExistException, UnexpectedFailureException, CommunicationException
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.
tkiid
- The task instance ID whose
custom property names are to be retrieved.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
NotAuthorizedException
IdWrongFormatException
ObjectDoesNotExistException
UnexpectedFailureException
public java.util.List getCustomProperties(java.lang.String tkiid) throws IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, UnexpectedFailureException, CommunicationException
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 the task instance. The caller must have at least reader authority for the task instance.
tkiid
- A string representation of the task instance ID. This
string is used to identify the task for which the
custom properties are to be retrieved.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
public java.util.List getCustomProperties(TKIID tkiid) throws IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, UnexpectedFailureException, CommunicationException
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.
tkiid
- The task instance ID whose
custom properties are to be retrieved.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
public java.lang.String getDocumentation(java.lang.String identifier, java.util.Locale locale) throws IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, UnexpectedFailureException, CommunicationException
Documentations can be retrieved in any state of the object. The caller must have at least reader authority for the object.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
public java.lang.String getDocumentation(ESIID esiid, java.util.Locale locale) throws IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, UnexpectedFailureException, CommunicationException
Documentations can be retrieved in any state of the escalation. The caller must have at least reader authority for the escalation.
esiid
- The escalation instance ID that is used
to identify the escalation instance.locale
- The locale for which the documentation is to be provided.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
public java.lang.String getDocumentation(ESTID estid, java.util.Locale locale) throws IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, UnexpectedFailureException, CommunicationException
The caller must have at least reader authority for the escalation template.
estid
- The escalation template ID that is used
to identify the escalation template.locale
- The locale for which the documentation is to be provided.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
public java.lang.String getDocumentation(TKIID tkiid, java.util.Locale locale) throws IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, UnexpectedFailureException, CommunicationException
Documentations can be retrieved in any state of the task instance. The caller must have at least reader authority for the task instance.
tkiid
- The task instance ID that is used to identify the task instance.locale
- The locale for which the documentation is to be provided.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
public java.lang.String getDocumentation(TKTID tktid, java.util.Locale locale) throws IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, UnexpectedFailureException, CommunicationException
The caller must have at least reader authority for the task template.
tktid
- The task template ID that is used to identify the task template.locale
- The locale for which the documentation is to be provided.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
public Escalation getEscalation(java.lang.String esiid) throws IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, UnexpectedFailureException, CommunicationException
Escalations can be retrieved in any escalation state. The caller must have at least reader authority.
esiid
- A string representation of the escalation instance ID that is used
to identify the escalation to be retrieved.
Escalation
to view the escalation properties.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
public Escalation getEscalation(ESIID esiid) throws IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, UnexpectedFailureException, CommunicationException
Escalations can be retrieved in any escalation state. The caller must have at least reader authority.
esiid
- The escalation instance ID that is used
to identify the escalation to be retrieved.
Escalation
to view the escalation properties.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
public EscalationTemplate getEscalationTemplate(java.lang.String estid) throws IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, UnexpectedFailureException, CommunicationException
The caller must have at least reader authority.
estid
- A string representation of the escalation template ID that is used
to identify the escalation template to be retrieved.
EscalationTemplate
to view the escalation template properties.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
public EscalationTemplate getEscalationTemplate(ESTID estid) throws IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, UnexpectedFailureException, CommunicationException
The caller must have at least reader authority.
estid
- The escalation template ID that is used
to identify the escalation template to be retrieved.
EscalationTemplate
to view the escalation template properties.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
public ClientObjectWrapper getFaultMessage(java.lang.String tkiid) throws DataHandlingException, IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
The task instance can be in any state but inactive. The caller must have at least reader authority for the task instance.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
DataHandlingException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public ClientObjectWrapper getFaultMessage(TKIID tkiid) throws DataHandlingException, IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
The task instance can be in any state but inactive. The caller must have at least reader authority for the task instance.
tkiid
- The object ID of the task instance for which the fault message is to be retrieved.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
DataHandlingException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public java.util.List getFaultNames(java.lang.String tkiid) throws IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
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.
complete
,
setFaultMessage
,
or to createFaultMessage
.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public java.util.List getFaultNames(TKIID tkiid) throws IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
tkiid
- The object ID of the task instance for which the fault names are to be retrieved.
complete
,
setFaultMessage
,
or to createFaultMessage
.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public ClientObjectWrapper getInputMessage(java.lang.String tkiid) throws DataHandlingException, IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
DataHandlingException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public ClientObjectWrapper getInputMessage(TKIID tkiid) throws DataHandlingException, IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
tkiid
- The object ID of the task instance whose input message is to be retrieved.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
DataHandlingException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public ClientObjectWrapper getOutputMessage(java.lang.String tkiid) throws DataHandlingException, IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
DataHandlingException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public ClientObjectWrapper getOutputMessage(TKIID tkiid) throws DataHandlingException, IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
tkiid
- The object ID of the task instance whose output message is to be retrieved.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
DataHandlingException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public StoredQuery getStoredQuery(java.lang.String storedQueryName) throws ObjectDoesNotExistException, ParameterNullException, UnexpectedFailureException, CommunicationException
storedQueryName
- The name of the stored query to be retrieved -
refer to getStoredQueryNames
for the retrieval of existing stored query names.
StoredQuery
to view the stored query definition. If
the specified stored query is not found, a null object is returned.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ObjectDoesNotExistException
ParameterNullException
UnexpectedFailureException
public java.lang.String[] getStoredQueryNames() throws WorkItemManagerException, UnexpectedFailureException, CommunicationException
createStoredQuery
for the
creation of stored queries.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
WorkItemManagerException
UnexpectedFailureException
public Task getTask(java.lang.String tkiid) throws IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, UnexpectedFailureException, CommunicationException
The task instance can be in any state. The caller must have at least reader authority for the task instance.
tkiid
- A string representation of the task instance ID. This is used
to identify the task instance to be retrieved.
Task
to view the task instance properties.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
public Task getTask(TKIID tkiid) throws IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, UnexpectedFailureException, CommunicationException
The task instance can be in any state. The caller must have at least reader authority for the task instance.
tkiid
- The object ID of the task instance to be retrieved.
Task
to view the task instance properties.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
public TaskTemplate getTaskTemplate(java.lang.String tktid) throws IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, UnexpectedFailureException, CommunicationException
The caller must have at least reader authority for the task template.
tktid
- A string representation of the object ID of the task template to be retrieved.
TaskTemplate
to view the task template properties.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
public TaskTemplate getTaskTemplate(TKTID tktid) throws IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, UnexpectedFailureException, CommunicationException
The caller must have at least reader authority for the task template.
tktid
- The object ID of the task template to be retrieved.
TaskTemplate
to view the task template properties.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
public CustomClientSettings getUISettings(java.lang.String identifier) throws IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, UnexpectedFailureException, CommunicationException
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.
identifier
- A string representation of the task instance or template ID.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
UnexpectedFailureException
public CustomClientSettings getUISettings(TKTID tktid) throws IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, UnexpectedFailureException, WrongKindException, CommunicationException
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.
tktid
- The object ID of the task template.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
WrongKindException
public CustomClientSettings getUISettings(TKIID tkiid) throws IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, UnexpectedFailureException, WrongKindException, CommunicationException
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.
tkiid
- The object ID of the task instance.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
UnexpectedFailureException
WrongKindException
public StaffResultSet getUsersInRole(java.lang.String tkiid, int role) throws IdWrongFormatException, IdWrongTypeException, InvalidAssignmentReasonException, NotAuthorizedException, ObjectDoesNotExistException, WorkItemManagerException, UnexpectedFailureException, CommunicationException
tkiid
- A string representation of task instance ID that is used to identify the
task instance.role
- The role whose members are to be queried.
StaffResultSet
for more information.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
IdWrongTypeException
InvalidAssignmentReasonException
NotAuthorizedException
ObjectDoesNotExistException
WorkItemManagerException
UnexpectedFailureException
public StaffResultSet getUsersInRole(TKIID tkiid, int role) throws IdWrongFormatException, InvalidAssignmentReasonException, NotAuthorizedException, ObjectDoesNotExistException, WorkItemManagerException, UnexpectedFailureException, CommunicationException
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.
StaffResultSet
for more information.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
InvalidAssignmentReasonException
NotAuthorizedException
ObjectDoesNotExistException
WorkItemManagerException
UnexpectedFailureException
public boolean isSystemAdministrator() throws CommunicationException
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
public boolean isSystemMonitor() throws CommunicationException
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
public boolean isUserInRole(java.lang.String tkiid, java.lang.String userID, int role) throws IdWrongFormatException, IdWrongTypeException, InvalidAssignmentReasonException, NotAuthorizedException, ObjectDoesNotExistException, ParameterNullException, WorkItemManagerException, UnexpectedFailureException, CommunicationException
tkiid
- A string representation of task instance ID 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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
IdWrongTypeException
InvalidAssignmentReasonException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WorkItemManagerException
UnexpectedFailureException
public boolean isUserInRole(TKIID tkiid, java.lang.String userID, int role) throws IdWrongFormatException, InvalidAssignmentReasonException, NotAuthorizedException, ObjectDoesNotExistException, ParameterNullException, WorkItemManagerException, UnexpectedFailureException, CommunicationException
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
InvalidAssignmentReasonException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WorkItemManagerException
UnexpectedFailureException
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, CommunicationException
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.
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 is a 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.
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:
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.
If a timezone is not specified, UTC is assumed.
QueryResultSet
for information on how to analyze the query result set.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ParameterNullException
UnexpectedFailureException
WorkItemManagerException
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, CommunicationException
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.
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 is a 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.
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:
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.
If a timezone is not specified, UTC is assumed.
QueryResultSet
for information on how to analyze the query result set.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ParameterNullException
UnexpectedFailureException
WorkItemManagerException
public QueryResultSet query(java.lang.String storedQueryName, java.lang.Integer skipTuples) throws IdWrongFormatException, ObjectDoesNotExistException, ParameterNullException, QueryInvalidOperandException, QueryInvalidTimestampException, QueryUndefinedParameterException, QueryUnknownColumnException, QueryUnknownOperatorException, QueryUnknownTableException, UnexpectedFailureException, CommunicationException
Refer to createStoredQuery
for
the creation of stored queries.
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.
QueryResultSet
for information on how to analyze the query result set.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
ObjectDoesNotExistException
ParameterNullException
QueryInvalidOperandException
QueryInvalidTimestampException
QueryUndefinedParameterException
QueryUnknownColumnException
QueryUnknownOperatorException
QueryUnknownTableException
UnexpectedFailureException
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, CommunicationException
Refer to createStoredQuery
for
the creation of stored queries.
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.
QueryResultSet
for information on how to analyze the query result set.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
ObjectDoesNotExistException
ParameterNullException
QueryInvalidOperandException
QueryInvalidTimestampException
QueryUndefinedParameterException
QueryUnknownColumnException
QueryUnknownOperatorException
QueryUnknownTableException
UnexpectedFailureException
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, CommunicationException
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.
The domain of the query, that is, the SQL from-clause, is determined automatically.
The caller must be a system administrator or system monitor.
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:
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.
If a timezone is not specified, UTC is assumed.
QueryResultSet
for information on how to analyze the query result set.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
NotAuthorizedException
ParameterNullException
UnexpectedFailureException
WorkItemManagerException
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, CommunicationException
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.
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:
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.
If a timezone is not specified, UTC is assumed.
TaskTemplate
to view the process template properties.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
QueryInvalidOperandException
QueryInvalidTimestampException
QueryUndefinedParameterException
QueryUnknownColumnException
QueryUnknownOperatorException
QueryUnknownTableException
UnexpectedFailureException
public void resume(java.lang.String tkiid) throws ApplicationVetoException, IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
The suspended task instance can be in the ready or claimed state. It can have been escalated. The caller can be the owner, originator, or administrator of the task instance.
tkiid
- A string representation of the task instance ID to be resumed.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public void resume(TKIID tkiid) throws ApplicationVetoException, IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
The suspended task instance can be in the ready or claimed state. It can have been escalated. The caller can be the owner, originator, or administrator of the task instance.
tkiid
- The object ID of the task instance to be resumed.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
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, CommunicationException
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.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
IdWrongFormatException
IdWrongTypeException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
UnexpectedFailureException
public void setCustomProperty(TKIID tkiid, java.lang.String propertyName, java.lang.String propertyValue) throws ApplicationVetoException, IdWrongFormatException, InvalidLengthException, NotAuthorizedException, ObjectDoesNotExistException, ParameterNullException, WrongKindException, UnexpectedFailureException, CommunicationException
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.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
IdWrongFormatException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
UnexpectedFailureException
public void setFaultMessage(java.lang.String tkiid, java.lang.String faultName, ClientObjectWrapper faultMessage) throws IdWrongFormatException, IdWrongTypeException, InvalidQNameException, NotAuthorizedException, ObjectDoesNotExistException, ParameterNullException, WrongKindException, WrongMessageTypeException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
IdWrongTypeException
InvalidQNameException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
public void setFaultMessage(TKIID tkiid, java.lang.String faultName, ClientObjectWrapper faultMessage) throws IdWrongFormatException, InvalidQNameException, NotAuthorizedException, ObjectDoesNotExistException, ParameterNullException, WrongKindException, WrongMessageTypeException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
IdWrongFormatException
InvalidQNameException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
public void setOutputMessage(java.lang.String tkiid, ClientObjectWrapper outputMessage) throws DataHandlingException, IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, ParameterNullException, WrongKindException, WrongMessageTypeException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
DataHandlingException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
public void setOutputMessage(TKIID tkiid, ClientObjectWrapper outputMessage) throws DataHandlingException, IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, ParameterNullException, WrongKindException, WrongMessageTypeException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
DataHandlingException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
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, CommunicationException
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.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
IdWrongFormatException
IdWrongTypeException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
SCAServiceAccessFailureException
SCAServiceResultErrorException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
public void startTask(TKIID tkiid, ClientObjectWrapper input, ReplyHandlerWrapper replyHandler) throws AdministratorCannotBeResolvedException, ApplicationVetoException, CannotCreateWorkItemException, IdWrongFormatException, InvalidLengthException, NotAuthorizedException, ObjectDoesNotExistException, SCAServiceAccessFailureException, SCAServiceResultErrorException, WrongKindException, WrongMessageTypeException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
AdministratorCannotBeResolvedException
ApplicationVetoException
CannotCreateWorkItemException
IdWrongFormatException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
SCAServiceAccessFailureException
SCAServiceResultErrorException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
public void startTaskTemplate(java.lang.String tktid) throws ApplicationVetoException, IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
The caller must be an administrator of the task template. The task template must be stopped.
tktid
- A string representation of the object ID of the task template to be started.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public void startTaskTemplate(TKTID tktid) throws ApplicationVetoException, IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
The caller must be an administrator of the task template. The task template must be stopped.
tktid
- The object ID of the task template which is to be stopped.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public void stopTaskTemplate(java.lang.String tktid) throws ApplicationVetoException, IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
The caller must be an administrator of the task template. The task template must be started.
tktid
- A string representation of the object ID of the task template to be stopped.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public void stopTaskTemplate(TKTID tktid) throws ApplicationVetoException, IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
The caller must be an administrator of the task template. The task template must be started.
tktid
- The object ID of the task template which is to be stopped.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public void suspend(java.lang.String tkiid) throws ApplicationVetoException, IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
The task instance can be in the ready or claimed state. It can have been escalated. The caller can be the owner, originator, or administrator of the task instance.
tkiid
- A string representation of the task instance ID to be suspended.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public void suspend(TKIID tkiid) throws ApplicationVetoException, IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
The task instance can be in the ready or claimed state. It can have been escalated. The caller can be the owner, originator, or administrator of the task instance.
tkiid
- The object ID of the task instance to be suspended.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public void terminate(java.lang.String tkiid) throws ApplicationVetoException, IdWrongFormatException, IdWrongTypeException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
tkiid
- A string representation of the object ID of the task instance to be terminated.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
IdWrongFormatException
IdWrongTypeException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public void terminate(TKIID tkiid) throws ApplicationVetoException, IdWrongFormatException, NotAuthorizedException, ObjectDoesNotExistException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
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.
tkiid
- The object ID of the task instance to be terminated.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
IdWrongFormatException
NotAuthorizedException
ObjectDoesNotExistException
WrongKindException
WrongStateException
UnexpectedFailureException
public void transferWorkItem(java.lang.String tkiid, int assignmentReason, java.lang.String fromUserID, java.lang.String toUserID) throws ApplicationVetoException, EverybodyWorkItemException, IdWrongFormatException, IdWrongTypeException, InvalidAssignmentReasonException, InvalidLengthException, NotAuthorizedException, WorkItemDoesNotExistException, ObjectDoesNotExistException, ParameterNullException, TaskDelegationNotSupportedException, WorkItemManagerException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
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:
tkiid
- A string representation of 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
for valid values.fromUserID
- The user the work item belongs to.toUserID
- The user the work item is to be transferred to.
It is not checked whether the user exists.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
EverybodyWorkItemException
IdWrongFormatException
IdWrongTypeException
InvalidAssignmentReasonException
InvalidLengthException
NotAuthorizedException
WorkItemDoesNotExistException
ObjectDoesNotExistException
ParameterNullException
TaskDelegationNotSupportedException
WorkItemManagerException
WrongKindException
WrongStateException
UnexpectedFailureException
public void transferWorkItem(TKIID tkiid, int assignmentReason, java.lang.String fromUserID, java.lang.String toUserID) throws ApplicationVetoException, EverybodyWorkItemException, IdWrongFormatException, InvalidAssignmentReasonException, InvalidLengthException, NotAuthorizedException, WorkItemDoesNotExistException, ObjectDoesNotExistException, ParameterNullException, TaskDelegationNotSupportedException, WorkItemManagerException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
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:
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
for valid values.fromUserID
- The user the work item belongs to.toUserID
- The user the work item is to be transferred to.
It is not checked whether the user exists.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
EverybodyWorkItemException
IdWrongFormatException
InvalidAssignmentReasonException
InvalidLengthException
NotAuthorizedException
WorkItemDoesNotExistException
ObjectDoesNotExistException
ParameterNullException
TaskDelegationNotSupportedException
WorkItemManagerException
WrongKindException
WrongStateException
UnexpectedFailureException
public void update(Task task) throws ApplicationVetoException, InvalidLengthException, NotAuthorizedException, ObjectDoesNotExistException, ParameterNullException, PropertyVetoException, WrongKindException, WrongStateException, UnexpectedFailureException, CommunicationException
The task can be in any state. It can be escalated. The caller must be the owner, the starter, an editor, or an administrator of the task instance.
task
- The task instance and the properties to be updated.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
PropertyVetoException
WrongKindException
WrongStateException
UnexpectedFailureException
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, CommunicationException
The task must still be in the inactive state. The caller must be the originator of the task instance.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
CannotCreateWorkItemException
IdWrongFormatException
IdWrongTypeException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
com.ibm.task.plugins.TaskDeploymentException
com.ibm.task.plugins.TELValidationException
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, CommunicationException
The task must still be in the inactive state. The caller must be the originator of the task instance.
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.
CommunicationException
- Thrown when the method failed due to a communication or system-level failure.
ApplicationVetoException
CannotCreateWorkItemException
IdWrongFormatException
IdWrongTypeException
InvalidLengthException
NotAuthorizedException
ObjectDoesNotExistException
ParameterNullException
WrongKindException
WrongMessageTypeException
WrongStateException
UnexpectedFailureException
com.ibm.task.plugins.TaskDeploymentException
com.ibm.task.plugins.TELValidationException
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |