Process Form Changes Connector Object Changes Supported by the Upgrade Connectors Feature

6-40 Oracle Fusion Middleware Administrators Guide for Oracle Identity Manager ■ If the form attribute is retained and the corresponding connector objects, for example Lookup Definition and IT Resource Type Definition are removed to which this attribute has references, then you need to modify the form attribute properties by pointing it to the correct connector object. After the upgrade, the name of the process form is the version number of the upgraded connector.

6.8.2.6 Lookup Definition Changes

The Upgrade Connectors feature can run on a lookup definition on which any combination of the following changes have been made. In addition, an upgrade operation might involve any combination of the following changes to a lookup definition. ■ Lookup definitions can be added. ■ Existing lookup definitions can be retained or modified. During an upgrade operation, new entries in an existing lookup definition are appended after the existing entries.

6.8.2.7 Adapter Changes

The Upgrade Connectors feature can run on an adapter on which any combination of the following changes have been made. In addition, an upgrade operation might involve any combination of the following changes to an adapter. ■ New adapters can be added. ■ The custom adapters are retained as part of upgrade. If there are any customization on the default adapters, these changes need to be applied after upgrade as all the default adapters will be overwritten. ■ After applying the customization on the default adapters if there are any, the corresponding mapping for these adapters in Process Task, form field, and data object manager need to be verified for mapping.

6.8.2.8 Rule Changes

The Upgrade Connectors feature can run on a rule on which any combination of the following changes have been made. In addition, an upgrade operation might involve any combination of the following changes to a rule. ■ New rules can be added. ■ If there are any customizations in default Rules, these customizations need to be applied after the upgrade as all default Rules will be overwritten.

6.8.2.9 IT Resource Type Changes

The Upgrade Connectors feature can run on an IT resource type on which any combination of the following changes have been made. In addition, an upgrade Note: Existing lookup definitions are not deleted during an upgrade operation. Note: Existing adapters are not deleted during an upgrade operation. Managing Connector Lifecycle 6-41 operation might involve any combination of the following changes to an IT resource type. ■ The existing IT resource type can be replaced by a new IT resource type. ■ In an existing IT resource type, new parameters can be added and existing parameters can have their default values and types modified or deleted. ■ All custom parameters are displayed while mapping IT Resource Type definitions. You can retain the custom parameters.

6.8.2.10 IT Resource Changes

The Upgrade Connectors feature can run on an IT resource on which any combination of the following changes have been made. In addition, an upgrade operation might involve any combination of the following changes to an IT resource. ■ The parameter retained for IT Resource Type definition will be available for all the IT Resource instances of this type. If an existing parameter in IT Resource Type definition is not retained, then this parameter will not available in all the IT Resource instances of this type. ■ In an existing IT resource, new parameters can be added and existing parameters can have their default values and types modified or deleted. After the upgrade, the new name of the IT Resource Type definition is the one specified in the connector XML of the target connector.

6.8.2.11 Scheduled Task Changes

The Upgrade Connectors feature can run on a scheduled task that has been retained or existing scheduled tasks have been replaced by new scheduled tasks.

6.8.3 What Happens When You Upgrade a Connector

See Upgrade Use Cases Supported by the Connector Upgrade Feature for information about the changes that can be put into effect when you upgrade a connector. In addition, the following events are part of the outcome of an upgrade operation: ■ While performing the upgrade procedure, you are prompted to map new connector objects with existing objects. For example, you are prompted to map each resource object in the target connector with a resource object in the source connector. If the object names are same in both source and target, then for the new object, the corresponding old object need to be mapped. If there are changes in the object names in source and target, then you need to map the object properly by referring the source and target connector release documents. It is your responsibility map the source and target objects properly. If the objects are not mapped properly, then the source object will be corrupted by the upgrade process. Therefore, it is mandatory that you must know about all the source and the target connector objects.

6.8.4 Summary of the Upgrade Procedure

The following is a summary of the procedure to upgrade a connector: