Package oracle.sysman.dbTarget.db.changemgr.emo.cpapi

Provides a Java interface for the creation, population and modification of Change Manager Change Plans from a remote client.

See:
          Description

Class Summary
ApplyChangeItemResult Reports the result of applying a change item to the corresponding object in a database.
ChangeItem A ChangeItem represents the changes to be made with regard to a single database object at the destination database(s).
ChangeItemInfo ChangeItemInfo contains top-level information that identifies and describes a change item.
ChangePlan ChangePlan provides methods that allow a client to access and manipulate a single Change Manager Change Plan.
ChangePlanAccess ChangePlanAccess provides methods that allow a client to access Change Manager Change Plans.
ChangePlanInfo ChangePlanInfo contains top-level information that identifies and describes a Change Plan.
CPDemo  
CPDemo2  
VerifyEmapi  
 

Exception Summary
ChangePlanAccessException ChangePlanAccessException is a general-purpose Exception thrown by many methods in the ChangePlanAccess family.
 

Package oracle.sysman.dbTarget.db.changemgr.emo.cpapi Description

Provides a Java interface for the creation, population and modification of Change Manager Change Plans from a remote client. A Change Plan describes changes to be made to database objects at one or more destination databases.

The central object of the API is a ChangePlanAccess (see the ChangePlanAccess class). Use a ChangePlanAccess to establish a connection to the Enterprise Manager (EM) repository in which Change Manager objects are stored. (See login.) Once connected, list the existing Change Plans (getChangePlans) or create a new Change Plan (createChangePlan).

To access a Change Plan, get a ChangePlan object (getOneChangePlan). See the ChangePlan class.

Within a Change Plan, change items describe the changes to be made with regard to individual database objects. A change item may add a database object; modify an object; or drop an object. From a ChangePlan, list its change items (getChangeItems), add a change item (addChangeItem), or remove a change item (removeChangeItem).

Instances of the ChangeItem class represent individual change items. (See the ChangeItem class). To add a change item to a Change Plan, create a new ChangeItem, then pass it to the addChangeItem method. To update a change item with a new definition, first get the ChangeItem from the Change Plan using the getOneChangeItem method. Modify the ChangeItem using its methods, then write it back to the repository using the updateChangeItem method.

NOTE: The current design of this package assumes that Change Manager Java code to support XML comparison and change conflict resolution is available at the client. It should be possible to bundle related CM Java packages into a client-side jarfile without pulling in large amounts of Enterprise Manager code. Under this assumption, XML comparison (which occurs during Modify change item creation) and change conflict resolution (which occurs when a Modify change item is updated) takes place on the client. If this is not the case, comparison and conflict detection will need to take place in the Change Manager mid-tier code in the EM server. This in turn means that this API will need to communicate with EM using a web service, rather than a simple database connection.