G Custom Element Handlers For The Subscriber Channel; Constructing Urls For Use With The Publisher Channel Web Server; Appendix G, "Custom Element Handlers For The Subscriber Channel - Novell IDENTITY MANAGER 3.6.1 - MANUAL TASK SERVICE DRIVER Implementation Manual

Custom Element Handlers for the
G
Subscriber Channel
The driver provides an extension mechanism for sending user notifications using methods other than
the Simplified Mail Transport Protocol (SMTP). For example, a customer might have a need to send
notifications using the Messaging Application Programming Interface (MAPI) rather than using
SMTP.
To use a mechanism other than SMTP for sending notifications, you must write a Java class to
handle a custom XML element that is submitted on the driver's Subscriber channel.
The Java custom element handler must implement the
com.novell.nds.dirxml.driver.manualtask.CommandHandler Java interface. The name of the custom
element class is specified in the Additional Handlers item found in the Subscriber configuration
parameters.
When the Subscriber channel encounters a command element, it looks in its table of handlers. When
it finds a handler that reports that it handles the command element, the command element is passed
to the handler. The handler then performs any processing required.
There are two built-in command element handlers in the driver: a handler for
handler for elements.
<add>
The custom command element definition is up to the author of the custom handler. A reasonable
place to start in designing the custom command element is the design of the
The custom elements are created by policies on the Subscriber channel in the same fashion that the
element is created.
<mail>
The documentation for com.novell.nds.dirxml.driver.manualtask.CommandHandler and the
documentation for many utility and support classes are found in the javadocs that ship with the
driver. The javadocs are found in the file named
Section G.1, "Constructing URLs for Use with the Publisher Channel Web Server," on page 69
Section G.2, "Constructing Message Documents by Using Stylesheets and Template
Documents," on page 70
Section G.3, "SampleCommandHandler.java," on page 70
G.1 Constructing URLs for Use with the
Publisher Channel Web Server
To securely use the driver's Publisher channel Web server, it is necessary to use utility classes to
construct the URL that is to be included with a notification message. The
com.novell.nds.dirxml.driver.manualtask.URLData is designed for this task.
The sample code found in
manual_task_docs.zip
SampleCommandHandler.java
in the distribution image.
illustrates this process.
Custom Element Handlers for the Subscriber Channel
elements and a
<mail>
element.
<mail>
G
69