Admin Tasks › Advanced Task Components › Create Business Logic Task Handlers

Create Business Logic Task Handlers

You define a business logic task handler's fully qualified class name as follows:

1. Create or modify an admin task.
2. On the Admin Profile tab, click Business Logic Task Handlers.

   The Business Logic Task Handlers screen appears. This screen lists any existing business logic task handlers assigned to the task. Identity Manager executes the handlers in the order in which they appear in the list.

3. Click Add.

   The Business Logic Task Handler Detail screen appears.

Use the Business Logic Task Handler Detail screen to define the following information for the business logic task handler you are assigning to the task:

• Name

  The name you are assigning to the business logic task handler.

• Description

  An optional description of the business logic task handler.

• Java Class

  If the business logic task handler is implemented in Java, the fully qualified business logic task handler class name--for example:

  com.mycompany.MyJavaBLTH

  Identity Manager expects the class file to be located in the root directory designated for custom Java class files. For information on deploying Java class files, see the Programming Guide for Java.

• JavaScript Filename

  If the business logic task handler is implemented in JavaScript, and the JavaScript code is contained in a file, specify the file name in this field. For example, you might want to put the JavaScript in a file if the business logic task handler is to be used by several task screens.

  Identity Manager expects the file to be located in the root directory designated for custom JavaScript files. For information on deploying JavaScript files, see the Programming Guide for Java.

  If you store the file in a subdirectory of the root, include the subdirectory name when you specify the JavaScript file name--for example:

  JavaScriptSubDir\MyJavaScriptBLTH.js

  The slashes must be appropriate for the platform where the JavaScript file is deployed.

• JavaScript

  You can implement a JavaScript business logic task handler by typing the complete JavaScript code in this field instead of in a file. For example, you might want to put the JavaScript in this field if the script is very short or if it is to be used with no other task screens.

• Property and Value

  With Java implementations, these fields are optional name/value pairs of data that are passed into the init() method of the Java business logic task handler, to be used in any way that the handler's business logic requires.

  To add a user-defined property, specify a property name and value, and then click Add.

Note: If you add a Java business logic task handler, you restart the application server for the handler to be loaded.