9 Compiling Adapters

When you are creating multiple adapters and compiling them, you can do so in one of two ways. First, you can access each adapter, and compile it individually. However, this method consumes a lot of time and effort.

A more efficient approach is to either select the adapters that you want to compile, and compile them in one shot, or, when necessary, to compile all adapters that exist in the Oracle Identity Manager database, by clicking a button.

Automatic Compilation of Adapters

Release 9.1.0 onward, adapters are compiled automatically when you import connector files by using the Deployment Manager. The compiled adapter classfiles are stored in the Oracle Identity Manager database, as opposed to the filesystem, from where they are loaded at run time. The following two APIs have been added 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, then the API throws an appropriate exception.
public void compileAll: This API compiles all adapters in a system. If it encounters any errors during compilation, then it throws an exception of the type tcBulkException. This exception comprises all the individual errors that the API encounters during compilation.

However, you can modify the adapters manually if you make changes.

Note:

You must set the path of the JDK directory in the XL.CompilerPath system property. If this is not done, then an error is encountered during the adapter compilation stage of the process performed when you import an XML file by using the Deployment Manager.

Refer to the "The System Configuration Form" section in Oracle Identity Manager Design Console Guide for information about setting values of system properties.

Compiling Adapters Manually

The Adapter Manager form is located in the Development Tools folder. It is used to compile multiple adapters simultaneously.

To manually compile multiple adapters, perform the following steps:

Open the Adapter Manager form.
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.
Click the Start button.

Oracle Identity Manager will compile the adapters that match the criteria you specified in Step 2.

Tip:

Oracle Identity Manager lets you look at the record of any adapter that appears within the Adapter Manager form. By doing so, you can see detailed information about the adapter.

To view an adapter's record, select the desired adapter. Then, either double-click its row header, or right-click the adapter, and select the Launch Adapter command from the menu that appears.