Description

The remove-association command notifies the DirXML engine that a particular unique key is not valid. The DirXML engine never sends a remove-association command to the external application. The DirXML driver sends this command to the DirXML engine either as an input or output command.

This command has two main purposes. The first allows an event transformation to change a delete command into a remove-association command. When an entry is deleted in an external application, a system administrator may not want that entry deleted from eDirectory. When that is the case, an event transformation rule needs to convert the delete command to a remove-association command.

The other use for this command is for the following condition that shouldn't occur, but might. If the DirXML engine sends the driver an association that doesn't match anything in its external application, the driver can return a command to remove the bogus association.

Definition

  <!ELEMENT remove-association    (#PCDATA) >
  <!ATTLIST remove-association
            event-id              CDATA            #IMPLIED>
  
  

Attributes

event-id

Specifies an identifier used to identify a particular instance of the command or event.

Request Format

Reply Format

If the event is an input event, the DirXML engine returns a status command indicating whether the event was processed successfully.

Parent

• input
• output

Example

The following example shows a remove-association event sent by the driver.

  <remove-association>{BC3E7155-CDF9-d311-9846-0008C76B16C2}</remove-association>