com.ibm.task.spi

Interface APIEventHandlerPlugin5

All Superinterfaces:
APIEventHandlerPlugin, APIEventHandlerPlugin2, APIEventHandlerPlugin3, APIEventHandlerPlugin4
All known subinterfaces:
APIEventHandlerPlugin6
All known implementing classes:
APIEventHandler

  1. public interface APIEventHandlerPlugin5
  2. extends APIEventHandlerPlugin4
This interface supports the creation of API event handlers.

API events occur when a human task changes its state or when a task property is updated. These events can be used by other components and applications to participate in state transitions of human tasks. Use the APIEventHandlerPlugin5 service provider interface (SPI) to create plug-ins to get informed about events sent by the API or the internal events that have equivalent API events.

To handle API events, the event handler is invoked directly before a modification is done (pre-event method) and after the modification is done (post-event method).

This interface provides for methods that are called as API pre- or post-events (extends APIEventHandlerPlugin4).

Since:
7.0.0
Version:
7.0.0

Field Summary

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

Method Summary

Modifier and Type Method and Description
  1. void
postGetTaskAndMarkRead(Task task,TaskException taskException)
This method is called after a "GET TASK AND MARK READ" request was executed.
  1. void
postSetCustomProperties(Task task,java.util.List customProperties,TaskException taskException)
This method is called after a "SET CUSTOM PROPERTIES" request was executed.
  1. void
postSetTaskRead(Task task,boolean taskRead,TaskException taskException)
This method is called after a "SET TASK READ" request was executed.
  1. void
postTransferToWorkBasket(Task task,java.lang.String workBasketName,boolean preserveTransferState,TaskException taskException)
This method is called after a "TRANSFER TO WORK BASKET" request was executed.
  1. void
postTriggerEscalation(Escalation escalation,TaskException taskException)
This method is called after a "TRIGGER ESCALATION" request was executed.
  1. void
preGetTaskAndMarkRead(Task task)
This method is called before a "GET TASK AND MARK READ" request is executed.
  1. void
preSetCustomProperties(Task task,java.util.List customProperties)
This method is called before a "SET CUSTOM PROPERTIES" request is executed.
  1. void
preSetTaskRead(Task task,boolean taskRead)
This method is called before a "SET TASK READ" request is executed.
  1. void
preTransferToWorkBasket(Task task,java.lang.String workBasketName,boolean preserveTransferState)
This method is called before a "TRANSFER TO WORK BASKET" request is executed.
  1. void
preTriggerEscalation(Escalation escalation)
This method is called before a "TRIGGER ESCALATION" request is executed.
Methods inherited from interface com.ibm.task.spi.APIEventHandlerPlugin4
postSetInputMessage, postUpdateEscalation, preSetInputMessage, preUpdateEscalation
Methods inherited from interface com.ibm.task.spi.APIEventHandlerPlugin3
postSuspendTaskUntil, postSuspendTaskUntil, postSuspendTaskWithCancelClaim, postSuspendTaskWithCancelClaim, preSuspendTaskUntil, preSuspendTaskUntil, preSuspendTaskWithCancelClaim, preSuspendTaskWithCancelClaim
Methods inherited from interface com.ibm.task.spi.APIEventHandlerPlugin2
postClaim, postCreateWorkItem, postDeleteWorkItem, postSetBinaryCustomProperty, postSetBinaryCustomProperty, postSuspendTaskUntil, postSuspendTaskWithCancelClaim, postTransferWorkItem, preCreateWorkItem, preDeleteWorkItem, preSetBinaryCustomProperty, preSetBinaryCustomProperty, preSuspendTaskUntil, preSuspendTaskWithCancelClaim, preTransferWorkItem
Methods inherited from interface com.ibm.task.spi.APIEventHandlerPlugin
postCallTask, postCancelClaim, postClaim, postComplete, postCompleteWithFollowOnTask, postCompleteWithNewFollowOnTask, postCreateAndCallTask, postCreateAndStartTask, postCreateAndStartTaskAsSubTask, postCreateTask, postCreateWorkItem, postDeleteTask, postDeleteWorkItem, postReplaceWorkItem, postRestartTask, postResumeTask, postSetBinaryCustomProperty, postSetCustomProperty, postSetFaultMessage, postSetOutputMessage, postStartTask, postStartTaskAsSubTask, postSuspendTask, postTerminateTask, postTransferWorkItem, postUpdateInactiveTask, postUpdateTask, preCallTask, preCancelClaim, preClaim, preComplete, preCompleteWithFollowOnTask, preCompleteWithNewFollowOnTask, preCreateAndCallTask, preCreateAndStartTask, preCreateAndStartTaskAsSubTask, preCreateTask, preCreateWorkItem, preDeleteTask, preDeleteWorkItem, preReplaceWorkItem, preRestartTask, preResumeTask, preSetBinaryCustomProperty, preSetCustomProperty, preSetFaultMessage, preSetOutputMessage, preStartTask, preStartTaskAsSubTask, preSuspendTask, preTerminateTask, preTransferWorkItem, preUpdateInactiveTask, preUpdateTask

Field Detail

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

Method Detail

preGetTaskAndMarkRead

  1. void preGetTaskAndMarkRead(Task task)
  2. throws ApplicationVetoException
This method is called before a "GET TASK AND MARK READ" request is executed.
Parameters:
task - The task whose read property is to be set and returned.
Throws:
ApplicationVetoException - if the subsequent execution is to be aborted.

postGetTaskAndMarkRead

  1. void postGetTaskAndMarkRead(Task task,
  2. TaskException taskException)
This method is called after a "GET TASK AND MARK READ" request was executed.
Parameters:
task - The task whose read property was to be set and returned.
taskException - The TaskException that occurred or null if no exception occurred.

preSetCustomProperties

  1. void preSetCustomProperties(Task task,
  2. java.util.List customProperties)
  3. throws ApplicationVetoException
This method is called before a "SET CUSTOM PROPERTIES" request is executed.
Parameters:
task - The task for which the custom properties are to be set.
customProperties - The list of custom properties.
Throws:
ApplicationVetoException - if the subsequent execution is to be aborted.

postSetCustomProperties

  1. void postSetCustomProperties(Task task,
  2. java.util.List customProperties,
  3. TaskException taskException)
This method is called after a "SET CUSTOM PROPERTIES" request was executed.
Parameters:
task - The task whose custom properties were requested to be set.
customProperties - The list of custom properties.
taskException - The TaskException that occurred or null if no exception occurred.

preSetTaskRead

  1. void preSetTaskRead(Task task,
  2. boolean taskRead)
  3. throws ApplicationVetoException
This method is called before a "SET TASK READ" request is executed.
Parameters:
task - The task whose read property is to be set.
taskRead - The new value of the read flag.
Throws:
ApplicationVetoException - if the subsequent execution is to be aborted.

postSetTaskRead

  1. void postSetTaskRead(Task task,
  2. boolean taskRead,
  3. TaskException taskException)
This method is called after a "SET TASK READ" request was executed.
Parameters:
task - The task whose read property was to be set.
taskRead - The new value of the read flag.
taskException - The TaskException that occurred or null if no exception occurred.

preTransferToWorkBasket

  1. void preTransferToWorkBasket(Task task,
  2. java.lang.String workBasketName,
  3. boolean preserveTransferState)
  4. throws ApplicationVetoException
This method is called before a "TRANSFER TO WORK BASKET" request is executed.
Parameters:
task - The task that is to be transferred to another work basket.
workBasketName - The target work basket where this task is to be transferred to.
preserveTransferState - The flag indicating if the transferredToWorkBasket property of the task should be changed as part of this transfer operation.
Throws:
ApplicationVetoException - if the subsequent execution is to be aborted.

postTransferToWorkBasket

  1. void postTransferToWorkBasket(Task task,
  2. java.lang.String workBasketName,
  3. boolean preserveTransferState,
  4. TaskException taskException)
This method is called after a "TRANSFER TO WORK BASKET" request was executed.
Parameters:
task - The task that was transferred to another work basket.
workBasketName - The target work basket where this task was transferred to.
preserveTransferState - The flag indicating if the transferredToWorkBasket property of the task should be changed as part of this transfer operation.
taskException - The TaskException that occurred or null if no exception occurred.

preTriggerEscalation

  1. void preTriggerEscalation(Escalation escalation)
  2. throws ApplicationVetoException
This method is called before a "TRIGGER ESCALATION" request is executed.
Parameters:
escalation - The escalation that will be triggered.
Throws:
ApplicationVetoException - if the subsequent execution is to be aborted

postTriggerEscalation

  1. void postTriggerEscalation(Escalation escalation,
  2. TaskException taskException)
This method is called after a "TRIGGER ESCALATION" request was executed.
Parameters:
escalation - The escalation that was triggered.
taskException - The TaskException that occurred or null if no exception occurred.