Creating a Utility Task

2-26 Oracle Fusion Middleware Developers Guide for Oracle Identity Manager 1. Select the adapter to which you wish to add a utility task, for example, the Update Solaris User Group adapter. 2. Click the Adapter Tasks tab.

3. Click Add.

The Adapter Task Selection window is displayed.

4. Select the Utility Task option.

5. From the display area to the right of the option, select Utility, and click Continue.

The Object Instance Selection window is displayed.

6. Click Continue. The Add an Adapter Factory Task window is displayed

7. In the Task Name field, enter the name of the utility task you are creating, for

example, Update User Group.

8. Optional. If you want your utility task to be reusable, select Persistent Instance,

type the name of the instance of this task in the text field to the right of the check box.

9. Click the Application API list. The class files appear, which belong to the

xlUtils.jar , xlIntegration.jar, and rt.jar files. 10. From the Add an Adapter Factory Task window, select a constructor and method. Then, set the mappings for the parameters of the constructor and method.

11. From the Add an Adapter Factory Task windows toolbar, click Save. The

information pertaining to the utility task is stored in the Oracle Identity Manager database.

12. From this windows toolbar, click Close.

The Add an Adapter Factory Task window disappears, and the main screen is active once again. The utility task that you created for example, Update User Group appears within the Adapter Factory form. See Also: Creating a Java Task on page 2-17 to learn more about the choices of this window Caution: Ensure that name of the instance does not contain any spaces. See Also: Creating a Java Task on page 2-17 for more information about the regions of the Add an Adapter Factory Task window Configuring the Adapter Environment on page 2-7 Note: The xlUtils.jar, xlIntegration.jar, and rt.jar files contain all of the class files that you can use for a utility task. Therefore, you do not have to access the API Source list. See Also: Adapter Mapping Information on page 3-19 for more information about which mappings to select Developing Adapters 2-27 13. Optional. Repeat steps 3 through 12 to create additional utility tasks for the adapter. You are now ready to compile the adapter, so it can be used with a process task or form field.

14. 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.

2.8.6 To Create an Oracle Identity Manager API Task

For greater portability of the adapter code, an Oracle Identity Manager API task enables Adapter tasks to call APIs published by Oracle Identity Manager. This is better than accessing Oracle Identity Manager data directly through hardcoded SQL statements. The Adapter Factory is shipped with a library of utility classes and methods, which increase the efficiency of developing adapters that contain Oracle Identity Manager API tasks. These utility classes and methods are contained within the xlAPI.jar file. To create this type of adapter task:

1. Select the adapter to which you wish to add an Oracle Identity Manager API task,

for example, the Get Users Password adapter.

2. Click the Adapter Tasks tab.

3. Click Add.