rename

Used as an event notification from the PublicationShim to Identity Manager that an object is renamed in the application. When it is used as a notification, an <association> is required. Also used as a command from Identity Manager to the SubsciptionShim to rename an object in the application. When it is used as a command, an <association> is required and is the unique key of the object to rename.

Remarks

<rename> contains a <new-name> that specifies the new name.

A response to <rename> should be a <status> indicating whether or not the <rename> was processed successfully.

Example

<rename class-name="User" src-dn="\Samuel" old-src-dn="\Sam">        <association>1012</association>        <new-name>Samuel</new-name></rename>

Allowed Content

Element

Description

association

Unique key of the application object.

new-name

The new name of a renamed object.

operation-data

The operation adds additional custom data.

Attributes

Attribute

Possible Values

Default Value

dest-entry-id

CDATA

The entry ID of the target object in the namespace of the receiver.

Reserved. Should be ignored by the driver.

#IMPLIED

event-id

CDATA

An identifier used to tag the results of an event or command.

#IMPLIED

old-src-dn

CDATA

The original distinguished name of the source object that generated the event in the namespace of the sender.

#IMPLIED

qualified-old-src-dn

CDATA

The qualified version of the old-src-dn. Only used for describing objects from eDirectory.

#IMPLIED

qualified-src-dn

CDATA

The qualified version of the src-dn. Only used for describing objects from eDirectory.

#IMPLIED

remove-old-name

true | false

True if the old name should be removed, false otherwise.

Usually only used in X.500 type applications where the name of an object is also an attribute of the object that can exist independently.

true

src-dn

CDATA

The distinguished name of the source object that generated the event in the namespace of the sender.

The new distinguished name of the source object that generated the event in the namespace of the sender.

#IMPLIED

src-entry-id

CDATA

The entry ID of the source object that generated the event in the namespace of the sender.

Reserved. Should be ignored by the driver.

#IMPLIED

timestamp

CDATA

Reserved. Should be ignored by the driver.

#IMPLIED

Content Rule

( association ? , new-name , operation-data ? )

Parent Elements

Element

Description

input

Input events or commands.