Click the Start button.

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. Developing Adapters 2-11

6. Select the type of adapter you want, for example, Process Task T. Then, click OK.

7. In the Description field, type a description for the adapter, for example, This adapter is used to create a new user for the Solaris environment .

8. From the toolbar, click Save.

The adapter is now stored in the Oracle Identity Manager database.

2.5 Tabs of the Adapter Factory Form

The Adapter Factory form in the Design Console contains the following tabs: ■ Adapter Tasks ■ Execution Schedule ■ Resources ■ Variable List ■ Usage Lookup ■ Responses

2.5.1 Adapter Tasks

In the Adapter Tasks tab, you can create and manage the atomic function calls of an adapter. These function calls are known as adapter tasks. The sequence of calls is vital because these calls in turn gets converted into Java statements. In other words, if you put an Else call before an If call, then the adapter is not compiled. In addition, you must understand the logical flow of java program while creating adapter. Analogically, this is like writing an algorithm instead of a program with Java syntax.

2.5.2 Execution Schedule

The Execution Schedule tab lets you specify when you want Oracle Identity Manager to trigger a rule generator or an entity adapter. You can schedule Oracle Identity Manager to run a rule generator Adapter Type R on preinsert andor preupdate. You can also configure Oracle Identity Manager to execute an entity adapter Adapter Type E on preinsert, preupdate, predelete, postinsert, postupdate, or postdelete. Tip: If you create an entity adapter, then an error might be generated while compiling the adapter on computers with less file limits. To avoid this problem, change the file limits in the etcsecuritylimits.conf file to the following: soft nofile 4096 hard nofile 4096 Then, restart Oracle Identity Manager. See Also: Form Designer Form on page 13-1 for more information about the Form Designer form