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. This guide discusses the procedure to deploy the connector that is used to integrate Oracle Identity Manager with Oracle Retail Warehouse Management System.

This chapter contains the following sections:

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

Note:

In this guide, the term Oracle Identity Manager server refers to the computer on which Oracle Identity Manager is installed.

At some places in this guide, Oracle Retail Warehouse Management System has been referred to as the target system.

1.1 Reconciliation Module

Reconciliation involves duplicating in Oracle Identity Manager the creation of and modifications to user accounts on the target system. It is an automated process initiated by a scheduled task that you configure.

The reconciliation module handles the reconciliation of new, updated, and deleted user profiles in Oracle Identity Manager. A reconciliation event is created for each user profile to be reconciled.

1.1.1 Lookup Fields Reconciliation

Lookup fields reconciliation involves reconciling the following lookup fields:

FacilityID
LanguageCode
Department
UserClass

1.1.2 User Reconciliation

User reconciliation involves reconciling the following fields:

FacilityID
UserID
Department
UserName
User Privilege
User LogDate
Language Code
Picking Percent QA
Packing Percent QA
DCDept
User Class
Equipment

1.2 Provisioning Module

Provisioning involves creating or modifying a user's account on the target system through Oracle Identity Manager. You use the Oracle Identity Manager Administrative and User Console to perform provisioning operations.

1.3 Supported Functionality

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

Function	Type
Create User	Provisioning
Reset User's Password	Provisioning
Update User's Name	Provisioning
Update User's Privilege	Provisioning
Update User's Department	Provisioning
Update User's Language Code	Provisioning
Update User's Picking Percent QA	Provisioning
Update User's Packing Percent QA	Provisioning
Update User's User Class	Provisioning
Update User's Equipment	Provisioning
Delete User	Provisioning
Create User (Account Discovery)	Reconciliation
Update User's Name	Reconciliation
Update User's Department	Reconciliation
Update User's Language Code	Reconciliation
Update User's Picking Percent QA	Reconciliation
Update User's Packing Percent QA	Reconciliation
Update User's User Class	Reconciliation
Update User's Equipment	Reconciliation

1.4 Supported Languages

This release of the connector supports only the English language. This limitation is also mentioned in the "Known Issues" chapter.

1.5 Files and Directories That Comprise the Connector

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

Enterprise Applications/Oracle Retail Applications/Oracle Retail Warehouse Mgmt

These files and directories are listed and described in Table 1-1.

Table 1-1 Files and Directories on the Installation Media

File in the Installation Media Directory	Description
config/attributemapping_prov.properties	This file contains the parameters required for provisioning.
config/attributemapping_recon.properties	This file contains the parameters required for reconciliation.
lib/rwmsadapter.jar	This JAR file contains the class files that are used to implement provisioning and reconciliation.
File in the `resources` directory	This resource bundle contains English 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.
scripts/DB Schema XML/xdb_app_map.xsd	This XML file contains information about the validation rules to which the `RWMS.xml` file conforms.
scripts/RWMS.xml	This XML file contains the configuration information of Oracle Retail Warehouse Management System users.
scripts/RWMSTrigger/TriggerRWMS.sql	This file contains the SQL code for creating a temporary table and the trigger that is used to implement the reconciliation of user account deletion on the target system.
test/config/config.properties	This file is used to specify the parameters and settings required to connect to the target system by using the testing utility.
test/config/log.properties	This file is used for storing log information.
test/scripts/rwms.bat test/scripts/rwms.sh	This file is used to run the test utility.
xml/xlRWMSNonTrusted.xml	This file contains definitions for the following components of the connector: IT resource type IT resource Resource object Process form Process definition Process tasks Adapters
xml/xlRWMSTrusted.xml	This XML file contains the configuration for the Xellerate User. You must import this file only if you plan to use the connector for trusted source reconciliation.

Note:

The files in the test directory are used only to run tests on the connector.

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

1.6 Determining the Release Number of the Connector

You can use the following method to determine the release number of the connector:

Extract the contents of the rwmsadapter.jar file. This file is in the following directory on the installation media:
```
Enterprise Applications/Oracle Retail Applications/Oracle Retail Warehouse Mgmt
```
Open the manifest.mf file in a text editor. The manifest.mf file is one of the files bundled inside the rwmsadapter.jar file.

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