add

Used as an event notification from the PublicationShim to Identity Manager when an object is added in the application. When it is used as a notification, an <association> is required. It is also used as a command from Identity Manager to the SubsciptionShim to add an object in the application.

Remarks

<add> contains an <add-attr> for each attribute of the object added.

<add> might contain a <password> for the object added.

A response to <add> should be a <status> indicating whether or not the <add> was processed successfully. When used as a command, <add> should also return an <add-association> that contains the unique key for the newly added object. The dest-dn and dest-entry-id attributes of the <add-association> should be set to the src-dn and src-entry-id of the <add>.

Example

<add class-name="User" src-dn="\Sam">        <association>1012</association>        <add-attr attr-name="cn">                <value>Sam</value>        </add-attr>        <add-attr attr-name="Surname">                <value>Jones</value>        </add-attr>        <add-attr attr-name="Given Name">                <value>Sam</value>        </add-attr>        <add-attr attr-name="Telephone Number">                <value>555-1212</value>        </add-attr></add>

Allowed Content

Element

Description

association

Unique key of the application object.

add-attr

Add attribute.

password

The authentication password.

operation-data

The operation adds additional custom data.

Attributes

Attribute

Possible Values

Default Value

class-name

CDATA

The name of the base class of the object. The class name is mapped between the application and eDirectory namespaces by the Schema Mapping policy so that Identity Manager sees the name in the eDirectory™ namespace and a driver sees the name in the application namespace.

#REQUIRED

dest-dn

CDATA

The distinguished name of the target object in the namespace of the receiver.

Should be left empty for event notifications. Filled in by the Placement policy on commands.

#IMPLIED

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.

Should be copied to the event-id attribute of the resulting <status> and <add-association> elements.

#IMPLIED

qualified-src-dn

CDATA

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

#IMPLIED

src-dn

CDATA

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

Should be copied to the dest-dn attribute of the resulting <add-association> for commands.

#IMPLIED

src-entry-id

CDATA

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

Should be copied to the dest-entry-id attribute of the resulting <add-association> for commands.

#IMPLIED

template-dn

CDATA

The distinguished name of a template in the receiver's namespace to use as a basis for creating the object.

Filled in by the Create policy for commands. Drivers only need to implement this if it makes sense for the application.

#IMPLIED

timestamp

CDATA

Reserved. Should be ignored by the driver.

#IMPLIED

Content Rule

( association ? , add-attr * , password ? , operation-data ? )

Parent Elements

Element

Description

input

Input events or commands.