Automatic Compilation of Adapters

Developing Adapters 2-9 at run time. The following two APIs are available to compile adapters programmatically: ■ public void compileAdapter String adapterName : This API compiles a single adapter and stores the compiled classfile in the database. It takes the name of the adapter as a parameter. If the adapter is not found or if there are any errors, the API throws an appropriate exception. ■ public void compileAll : This API compiles all adapters in a system. If it encounters any errors during compilation, it throws an exception of the type tcBulkException . This exception comprises all the individual errors that the API encounters during compilation. You can modify the adapters manually if you make any changes.

2.3.4.2 Compiling Adapters Manually

The Adapter Manager form is located in the Development Tools folder. You use it to compile multiple adapters simultaneously. To manually compile multiple adapters, perform these steps:

1. Open the Adapter Manager form.

The Adapter Manager form is in the Development Tools folder. It is used to compile multiple adapters simultaneously, as shown in Figure 2–3 . Figure 2–3 Adapter Manager Form

2. To compile every adapter that resides within the Oracle Identity Manager

database, select the Compile All option. To compile multiple adapters, select the adapters you want to compile. Then, select the Compile Selected option. To compile all adapters that do not have an OK status, select the Compile Previously Failed option.

3. Click the Start button.

Oracle Identity Manager will compile the adapters that match the criteria you specified in Step 2. Note: You must set the path of the JDK directory in the XL.CompilerPath system property. Otherwise, an error is encountered during the adapter compilation stage when you import an XML file using the Deployment Manager. Refer to the System Properties in Oracle Identity Manager in the Oracle Fusion Middleware System Administrators Guide for Oracle Identity Manager for information about setting values of system properties. 2-10 Oracle Fusion Middleware Developers Guide for Oracle Identity Manager

2.4 Defining Adapters

To define an adapter: 1. Log in to Oracle Identity Manager Design Console. 2. Open the Adapter Factory form. This form is in the Development Tools folder in the Design Console. 3. In the Adapter Name field, enter the name of the adapter, for example, Create Solaris User . 4. Double-click the Adapter Type lookup field. The Lookup window is displayed, displaying the five types of Oracle Identity Manager adapters. These are: ■ Process Task ■ Rule Generator ■ Pre-populate Rule Generator ■ Entity ■ Task Assignment

5. To enable the adapter to automate a process task, select Process Task T.

To incorporate business rules into an Oracle Identity Manager or user-defined form field, select Rule Generator R. For example, for the User ID field of a form, you can configure Oracle Identity Manager to concatenate the initial letter of the users first name with the users last name. You can attach a type of rule generator adapter to a user-created form field, so that it can: ■ Display the data, which is generated by the adapter, automatically or manually. ■ Use criteria that enable Oracle Identity Manager to determine which adapter is applied to the designated form field. To attach the adapter to an Oracle Identity Manager or user-defined form field, and have Oracle Identity Manager trigger the adapter on preinsert, preupdate, predelete, postinsert, postupdate, or postdelete, select Entity E. To allow the adapter to automate the allocation of a process task to a user or group, select Task Assignment A. Tip: Oracle Identity Manager lets you review the record of any adapter that appears within the Adapter Manager form to see detailed information about the adapter. To view an adapters record, select the desired adapter and either double-click its row header, or right-click the adapter, and select the Launch Adapter command from the menu that appears. Note: Although the adapter name can contain special characters, Oracle recommends that you do not use them because there might be run-time errors.