Programming Guides › Programming Guide for Java › Business Logic Task Handler API › Calling Sequence
Calling Sequence
CA Identity Manager calls business logic task handlers after all logical attribute handler processing is complete, so that business logic task handlers have access to the logical attribute values and the physical attribute values set by the logical attribute handlers.
Business logic task handlers are invoked in the following order:
- A CA Identity Manager admin task is submitted on a task screen.
- CA Identity Manager creates a BLTHContext object for the task, and passes this object to each business logic task handler it invokes.
- If any task-specific handlers are defined for the task, CA Identity Manager invokes the first handler referenced on the task screen.
- After all task-specific handlers are executed, CA Identity Manager invokes any global task handlers defined in the Management Console for the environment, beginning with the first handler defined on the Business Logic Task Handlers screen.
If a business logic task handler throws an exception (or if a JavaScript handler returns false), the task screen is redisplayed with one or more exception messages, giving the administrator a chance to address any errors and resubmit the admin task.
To create a custom business logic task handler, you write a class that extends the base class BLTHAdapter. You can implement your adapter so that CA Identity Manager can execute the business logic at various points during the synchronous phase of task execution.
You can implement any or all of the following methods in your custom adapter:
- To execute business logic at the beginning of the task, implement handleStart().
- To execute business logic after selecting the subject from the search result, implement handleSetSubject().
- To execute business logic before the user submits the task, implement handleValidationBeforeSubmission().
- To execute business logic after the user has submitted the task, but before the security check, implement handleValidation().
- To execute business logic after a security check and the events are ready to be posted, implement handleSubmission().
