Skip Headers
Oracle® Identity Manager Tools Reference Guide
Release 9.0.3

Part Number B32457-01
Go to Documentation Home
Go to Book List
Book List
Go to Table of Contents
Go to Index
Go to Feedback page
Contact Us

Go to previous page
Go to next page
View PDF

1 Introduction

This chapter describes the challenges of integrating access rights management applications with other software solutions, and the solution that Oracle Identity Manager offers. It contains the following topics:

The Integration Problem

An access rights management application cannot be successful today unless it can be integrated with other software solutions. Not only are there many resources, but also there is no single integration standard for connecting to these resources.

One way to tackle this challenge is by using the common functionality that is supported by all the integrations. To do this, you need developers who can write this code. In addition, every time an existing software resource is modified, or a new one is added, you must write more code.

The Oracle Identity Manager Solution

The Adapter Factory is a code-generation tool provided by Oracle Identity Manager. It enables an Oracle Identity Manager administrator to create Java classes, known as adapters.An adapter provides the following benefits:

About Adapters

As stated earlier, an adapter is a Java class created by an Oracle Identity Manager user through the Adapter Factory. In addition, it is an aggregation of atomic function calls in a logical flow. These atomic steps are known as adapter tasks.


Oracle Identity Manager can connect to external systems such as databases and directory servers using Java APIs for JDBC and LDAP. In addition, for all other APIs (such as C, C++, VB, COM/DCOM, and so on.), you can create a Java wrapper so that Oracle Identity Manager can communicate with the API directly.

There are five types of adapters:

Figure 1-1 illustrates the functionality of five different types of adapters.

Figure 1-1 Adapter Functionality

How adapters work
Description of "Figure 1-1 Adapter Functionality"

These five types of adapters will be explained in greater detail in the chapters that follow.


For more information about the Form Designer form, refer to Oracle Identity Manager Administrative and User Console Guide.

Tabs of the Adapter Factory Form

The Adapter Factory form contains the following tabs:

Each of these tabs is covered in greater detail in the following sections.

Adapter Tasks

Within the Adapter Tasks tab, you can create and manage the atomic function calls of an adapter. These function calls are known as adapter tasks.

Execution Schedule

The Execution Schedule tab enables you to 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 and/or preupdate. You can also configure Oracle Identity Manager to execute an entity adapter (Adapter Type E) on pre-insert, pre-update, pre-delete, post-insert, post-update, or post-delete.


Process task adapters and task assignment adapters, which are attached to process tasks, are triggered once the process task's status becomes Pending. Because you do not need to specify when Oracle Identity Manager will trigger these types of adapters, Oracle Identity Manager disables the Execution Schedule tab for them.

Also, because Oracle Identity Manager always triggers prepopulate adapters on pre-insert, Oracle Identity Manager disables the check boxes of this tab for prepopulate adapters.


From the Resources tab, you can:

  • Click the Java APIs sub-tab to see the Java APIs that are being used by the adapter.

  • Click the Other sub-tab to document a non-Java API file to the adapter, if necessary.

Variable List

From the Variable List tab, you can:

  • Create, modify, and delete adapter variables.

  • Set the data type and provide a description for each variable.

  • Map an adapter variable to a literal or an adapter reference. You can also postpone the mapping until it is attached to a process task or a form field.

You also can resolve the value of the adapter variable at runtime, when it is attached to a process task and the process task is run. Thus, process-specific data is available to map to this variable.

Usage Lookup

For a process task or task assignment adapter, the Usage Lookup tab displays the process task to which the adapter is attached, as well as the process of which this process task is a member.

For a rule generator or entity adapter, this tab shows the Oracle Identity Manager form and associated data object to which the adapter is attached. In addition, it displays the execution schedule of the adapter, along with a sequence number that represents the order in which Oracle Identity Manager will trigger the adapter.

For a prepopulate adapter, this tab displays the user-defined form and form field to which the adapter is attached. Also, it shows the prepopulate rule that is associated with the adapter.


For more information about the different types of adapters, refer to the Chapter 3, "Creating Adapters".


The Responses tab is used for defining meaningful responses to the process task. These responses depend on the execution result of the adapter. The various errors messages returned by the external system can then be mapped to these responses in a way that they make sense in the context of the process task. On attaching the adapter to a process task, the status bucket (Pending, Completed, Rejected) of the process task (and subsequently the Object status) can be set, based on the adapter response code.


Oracle Identity Manager enables the Responses tab only for process task adapters. If an adapter is a task assignment, rule generator, prepopulate, or entity adapter, then Oracle Identity Manager disables this tab.