1 About the Connector

Oracle Identity Manager automates access rights management, security, and provisioning of IT resources. Oracle Identity Manager connectors are used to integrate Oracle Identity Manager with third-party applications. The connector for Oracle e-Business User Management is used to integrate Oracle Identity Manager with Oracle e-Business User Management.

Note:

Oracle Identity Manager connectors were referred to as resource adapters prior to the acquisition of Thor Technologies by Oracle.

This chapter contains the following sections:

Supported Functionality
Multilanguage Support
Reconciliation Module
Provisioning Module
Files and Directories That Comprise the Connector
Determining the Release Number of the Connector

Supported Functionality

The following table lists the functions that are available with this connector.

Function	Type	Description
Create User	Provisioning	Creates a user
Disable User	Provisioning	Disables a user When this function is run, the end date assigned to the user account is changed to the current date.
Email Updated	Provisioning	Updates the e-mail address of a user
Password Updated	Provisioning	Updates the password of a user
Description Updated	Provisioning	Updates the description of a user
Start Date Updated	Provisioning	Updates the start date of a user's account validity period
End Date Updated	Provisioning	Updates the end date of a user's account validity period
LifeSpan Type Updated	Provisioning	Updates the Life Span type of a user
LifeSpan Updated	Provisioning	Updates the Life Span value of a user
Enable User	Provisioning	Enables a user so that the user is able to log in to Oracle e-Business User Management When this function is run on a disabled user account, the end date of the user account is changed to a null value.
Add Responsibility	Provisioning	Adds a responsibility to a user
Remove Responsibility	Provisioning	Removes a responsibility from a user When this function is run, the end date of the responsibility allocation is changed to the current date.
Employee Id Updated	Provisioning	Updates the employee ID of a user
Update Xellerate user	Reconciliation	Updates an Oracle Identity Manager user with data received from Oracle e-Business User Management
Update Apps Resource	Reconciliation	Updates an Oracle Identity Manager resource with data received from Oracle e-Business User Management
Create Link with Oracle HR Employee	Reconciliation	Sets the employee ID of an Xellerate User to the corresponding Oracle e-Business User Management user

Multilanguage Support

This release of the connector supports the following languages:

English
Brazilian Portuguese
French
German
Italian
Korean
Simplified Chinese
Spanish
Traditional Chinese

Reconciliation Module

This section discusses the elements that the reconciliation module extracts from Oracle e-Business User Management to construct reconciliation event records.

Reconciliation can be divided into the following types:

Lookup Fields Reconciliation
User Reconciliation

Lookup Fields Reconciliation

Lookup fields reconciliation involves reconciling the Responsibility lookup field.

User Reconciliation

User reconciliation involves reconciling the following fields:

username
E-mail
Desc
lifeSpanType
lifeSpanValue
startDate
endDate
employeeId
respName
respStartDate
respEndDate

Provisioning Module

The following fields are provisioned:

userName
password
confPassword
lifeSpanType
lifeSpanValue
startDate
endDate
email
employeeId
description
respName
respStartDate
respEndDate

Note:

During provisioning, if you want to link a newly created user account with an employee account, then you must ensure that the OracleHR.Employees lookup field is populated. For this, you must install the Oracle e-Business Employee Reconciliation connector and reconcile employee data.

If you do not want to link a newly created user account with an employee account, then the OracleHR.Employees lookup field is not required.

Files and Directories That Comprise the Connector

The files and directories that comprise this connector are compressed in the following directory on the installation media:

Enterprise Applications\Oracle e-Business\Oracle e-Business User Management

These files and directories are listed in the following table.

File in the Installation Media Directory	Description
lib\JavaTask\xlHostAccess.jar	This file contains the class files that are required for provisioning.
lib\JavaTask\connect.properties	This file contains the following connection parameters: Administrator credentials IP address Port SID of the target system
lib\ScheduleTask\xlReconOracleApps.jar	This file contains the class files that are required for reconciliation.
OracleApps Scripts\connect.properties	This file is a copy of the file in the `lib\JavaTask` directory. It contains the same connection parameters.
Files in the `resources` directory	Each of these resource bundle files contains language-specific information that is used by the connector. Note: A resource bundle is a file containing localized versions of the text strings that are displayed on the user interface of Oracle Identity Manager. These text strings include GUI element labels and messages displayed on the Administrative and User Console.
xml\oracleAppsResAdp.xml	This file contains definitions for the following components of the connector: IT resource type IT resource Custom process form Process tasks and adapters (along with their mappings) Resource object Provisioning process
xml\XellUserOraApps.xml	This XML file contains the configuration for the Xellerate User. You must import this file only if you plan to use the connector in trusted source reconciliation mode.

The "Step 3: Copying the Connector Files and External Code" section provides instructions to copy these files into the required directories.

Determining the Release Number of the Connector

To determine the release number of the connector that you have deployed:

Extract the contents of the xlReconOracleApps.jar file. For a connector that has been deployed, this file is in the following directory:
```
OIM_home\xellerate\JavaTasks
```
Open the manifest.mf file in a text editor. The manifest.mf file is one of the files bundled inside the xlReconOracleApps.jar file.

In the manifest.mf file, the release number of the connector is displayed as the value of the Version property.