com.novell.nds.dirxml.job
Interface JobEmail


public interface JobEmail

Interface to allow a Job implementation to send email using the Identity Manager email notification template facility.


Method Summary
 JobResult[] checkConfig(Locale msgLocale)
          Verify that the job is configured properly to send email.
 JobResult sendMail(String from, String replyTo, String[] to, String[] cc, String[] bcc, DirectoryObject template, Map replacementData, String encoding, List customHeaders)
          Send email based on an eDirectory notfMergeTemplate object that contains the email body and the subject information.
 JobResult sendMail(String from, String replyTo, String[] to, String[] cc, String[] bcc, String subject, String body, String encoding, List customHeaders, boolean sendAsHTML)
          Send email based on passed subject and email body.
 

Method Detail

checkConfig

public JobResult[] checkConfig(Locale msgLocale)
Verify that the job is configured properly to send email. This means that the DirXML-Job object has a reference to a properly configured notfTemplateCollection object.

Returns:
an array of one or more JobResult implementations if there is an error, null if everything appears to be configured correctly.

sendMail

public JobResult sendMail(String from,
                          String replyTo,
                          String[] to,
                          String[] cc,
                          String[] bcc,
                          DirectoryObject template,
                          Map replacementData,
                          String encoding,
                          List customHeaders)
                   throws IllegalArgumentException
Send email based on an eDirectory notfMergeTemplate object that contains the email body and the subject information.

Parameters:
from - SMTP email address for "From" field. If null then the "from" value from the notfTemplateCollection object specified for the job will be used.
replyTo - SMTP email address for "Reply to" field (may be null)
to - array of primary recipient SMTP email addresses (may not be null or empty)
cc - array of "CC" recipient SMTP email addresses (may be null)
bcc - array of "BCC" recipient SMTP email addresses (may be null)
template - notfMergeTemplate object containing email subject and body data
replacementData - key-value pairs of strings containing replacement data for the template
encoding - character encoding to use (may be null)
customHeaders - list of Strings, each containing a custom SMTP header line (may be null)
Returns:
result (will not be null)
Throws:
IllegalArgumentException - if one of the required parameters is null, empty, or otherwise invalid

sendMail

public JobResult sendMail(String from,
                          String replyTo,
                          String[] to,
                          String[] cc,
                          String[] bcc,
                          String subject,
                          String body,
                          String encoding,
                          List customHeaders,
                          boolean sendAsHTML)
                   throws IllegalArgumentException
Send email based on passed subject and email body.

Parameters:
from - SMTP email address for "From" field. If null then the "from" value from the notfTemplateCollection object specified for the job will be used.
replyTo - SMTP email address for "Reply to" field (may be null)
to - array of primary recipient SMTP email addresses (may not be null or empty)
cc - array of "CC" recipient SMTP email addresses (may be null)
bcc - array of "BCC" recipient SMTP email addresses (may be null)
subject - email message subject line
body - email message body
encoding - character encoding to use (may be null)
customHeaders - list of Strings, each containing a custom SMTP header line (may be null)
sendAsHTML - if true, email is sent as HTML, if false email is sent as plain text.
Returns:
result (will not be null)
Throws:
IllegalArgumentException - if one of the required parameters is null, empty, or otherwise invalid