*
Metamerge logo
Search

Advanced Search
*
*
*
* HOME DOCUMENTS & RESOURCES DOWNLOADS EARLY TECH ACCESS SUPPORT FAQ KNOWN ISSUES OLD VERSIONS
*

LDAP EventHandler

Overview

This EventHandler uses the LDAP event notification mechanism to detect changes in an LDAP directory. In order to use this EventHandler your LDAP server must support the version 3 persistent search control extension. The only LDAP server tested with this EventHandler is the Netscape/iPlanet directory server but other LDAP servers may work as well.

When the EventHandler starts it connects to the LDAP server and specifies the selection criteria for event notifications. When an event occurs in the LDAP directory the EventHandler sets the ldap.operation property to one of the following values:

Value Operation
objAdded A new entry was added to the directory
objRenamed An existing entry was renamed
objModified An existing entry's attributes were modified
objRemoved An existing entry was removed

Depending on the ldap.operation the EventHandler sets the following properties:

Object Added (objAdded)

Property Description
ldap.newdn The new distinguished name in case of a rename operation
ldap.newentry The new entry with changes applied

Object Rename (objRenamed)

Property Description
ldap.dn The old distinguished name
ldap.newdn The new distinguished name

Object Modified (objModified)

Property Description
ldap.dn The distinguished name before the modify operation
ldap.entry The contents of the LDAP entry before the modify operation
ldap.newdn The distinguished name after the modify operation
ldap.newentry The contents of the LDAP entry after the modify operation

Object Removed (objRemoved)

Property Description
ldap.dn The distinguished name before the remove operation
ldap.entry The contents of the LDAP entry before the remove operation

The ldap.entry and ldap.newentry properties are instances of the Entry class so you can access these as you would normally to with conn and work objects in the AssemblyLine as shown in the following snippet:

	var old = event.getObject ("ldap.entry");
	task.logmsg ("Old common name = " + old.getString("cn") );

One important aspect of the LDAP EventHandler is that you can risk loosing important notifications when the handler is not running. This handler is best used when you want to trap changes in a directory but still can tolerate loss of information.

Configuration

See the LDAP Connector for a description of the LDAP configuration parameters. 

 Downloads

Included in base product since 4.5

See Also

EventHandler Overview, Netscape Changelog Connector

 

 

 

*
  Metamerge Integrator version 4.5 ©Copyright Metamerge AS 2000-2002 Last edited 2002-04-30 contact us