Click Delete. About Adapter Variables

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. Developing Adapters 2-17 ■ A set variable task, which allows you to set a variable within an adapter. ■ An error handler task, which lets you display any errors associated with an adapter that occur at run time. In addition, you can see the reasons for the errors, along with possible solutions. ■ A logic task, which lets you build a conditional statement within an adapter. You can create the following types of logic tasks: ■ FOR loops ■ WHILE loops ■ IF statements ■ ELSE statements ■ ELSE IF statements ■ BREAK statements ■ RETURN statements ■ CONTINUE statements ■ SET VARIABLE statements ■ Handle Error statements For classification purposes, Oracle Identity Manager represents each type of adapter task by an icon. The icon, which precedes the task name, is a visual indicator of the type of task it is. For example, J represents a Java task, and LT represents a logic task. To see a list of these icons, select the Adapter Tasks tab, and click Legend. The Legend window appears, displaying the following list of icons: ■ Functional Task – Java – Remote – Stored Procedure ■ Utility Task – Utility – Oracle Identity Manager API ■ Logical Task

2.8.2 Creating a Java Task

Oracle Identity Manager can handshake with an external source through a Java API. To make this happen, you must add a task to an adapter which, when triggered by Oracle Identity Manager, initiates communications with the external source. This type of task is called a Java task. To create a Java task: See Also: Section 2.8.9, Creating a Logic Task for more information about the types of logic tasks you can build