Modifying an Adapter Variable

2-16 Oracle Fusion Middleware Developers Guide for Oracle Identity Manager

2.8 Creating Adapter Tasks

After you construct the adapter and create its variables, you can create the atomic function calls of an adapter. These function calls are known as adapter tasks. This section explains adapter tasks and how to create tasks: ■ Types of Adapter Tasks ■ Creating a Java Task ■ Creating a Remote Task ■ Creating a Stored Procedure Task ■ Creating a Utility Task ■ To Create an Oracle Identity Manager API Task ■ Reassigning the Value of an Adapter Variable ■ Adding an Error Handler Task ■ Creating a Logic Task

2.8.1 Types of Adapter Tasks

Oracle Identity Manager allows you to create the following adapter tasks: ■ A Java task, which allows an adapter to communicate with an external source by invoking Java API. ■ A remote task, which enables an adapter to call a method on an API. This API resides on a computer that is external to Oracle Identity Manager. This type of task is used mostly with integrations of third-party APIs that are not network-enabled. A remote manager executes the remote API method, which is located on a remote computer. In addition, if the third-party API does not use SSL, you can use the remote manager to invoke third-party APIs over SSL-protected communication. Remote tasks can also be used with integrations of third-party APIs, which are network-enabled, but are not located on the Oracle Identity Manager server for scalability purposes. The remote API method is still executed by a remote manager. However, because the third-party API is network-enabled, the remote manager does not have to reside on the target system. ■ A stored procedure task, which allows Oracle Identity Manager to map to and execute SQL programs located within a particular database schema. These programs are known as stored procedures. They contain information, such as SQL statements, which are pre-compiled for greater efficiency. By incorporating a stored procedure task into an adapter, and attaching this adapter to a process task, Oracle Identity Manager can incorporate 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. ■ A utility task, which enables you to populate an adapter with methods and APIs that come packaged with Oracle Identity Manager. In addition, this type of task provides you with access to the Java Standard Library APIs. ■ An Oracle Identity Manager API task, which enables access to Oracle Identity Manager published APIs from adapter tasks. This allows for enhanced portability of adapter code.