Optional. If you want your remote task to be reusable, select the Persistent

Developing Adapters 2-23

13. To compile the adapter, click Build.

The text in the Compile Status field changes from Recompile to OK. This indicates that Oracle Identity Manager compiled the adapter and did not find any errors. You can now attach the adapter to a process task or form field, so Oracle Identity Manager can communicate with the external API.

2.8.4 Creating a Stored Procedure Task

Through Oracle Identity Manager, you can map to and execute SQL programs that are located within a particular database schema. These SQL programs are known as stored procedures. Stored procedures contain information, such as SQL statements, which are precompiled for greater efficiency. For this to occur, you must add a stored procedure task to an adapter. When triggered by Oracle Identity Manager, this task incorporates stored procedures on any Oracle Database or Microsoft SQL Server database that is accessible on its network. This includes retrieving primitive values from stored procedures. Take these steps to create a stored procedure task:

1. For Oracle Identity Manager Installations that use Oracle Database, copy the

ojdbc14.jar file from the OIM_HOMEext directory to the OIM_DC_HOMExlclientext directory. For Oracle Identity Manager Installations that use Microsoft SQL Server, you must obtain the following files from Microsoft and copy them to the OIM_DC_HOMExlclientext directory: ■ msbase.jar ■ mssqlserver.jar ■ msutil.jar

2. Select the adapter to which you wish to add a stored procedure task, for example,

the Update User ID adapter.

3. Click the Adapter Tasks tab.

4. Click Add.

The Adapter Task Selection window is displayed.

5. Select the Functional Task option.

6. From the display area to the right of the option, select Stored Procedure, and click

Continue . The Add an Adapter Factory Task window is displayed. Note: The parameter values and server type for the database schema are set within the IT Resources form. The server type of the schema must be set to Database. Otherwise, Oracle Identity Manager cannot reference the database schema during the creation of a stored procedure task, the execution of a stored procedure task, or both. In addition, Oracle Identity Manager uses values, which are represented by parameters—for example, Database Name or URL—to connect to the schema. As a result, the stored procedures contained within the schema, can be executed.