Working with Rules in the Exchange Server |
|
Microsoft Exchange uses "rules" to define actions that get triggered when certain conditions are met. For instance, you can set up a rule such that when a new message arrives in your inbox with the subject containing the phrase "want more money?", this message automatically gets deleted and a reply message sent to the sender with the subject "Please don't send me any more spam!".
Rules can be accessed programmatically through the COM library RULE.DLL which comes with the Exchange 5.5 SDK. RULE.DLL is only on version 1 but it works with Exchange Server 5.5, 2000 and 2003. You can use Java via J-Integra to programmatically create rules in the Exchange Server. To do this, follow these steps:
- Setup a Windows machine with Outlook installed in it. We will call this the client machine.
- Install CDO.DLL in the client machine. To do this, refer to KB article 113792.
- Obtain a copy of RULE.DLL. You can download one from here: http://www.cdolive.com/download/ruleasp.zip
- Register RULE.DLL in the client machine by using regsvr32
- Compile and run the sample Java code below. This sample Java application needs the Java proxies for RULE.DLL (rule.jar) which you can download here. You will also need the J-Integra for Exchange runtime (jintegra.jar) and the Java proxies for CDO (cdo.jar), both of which are found in the "library" folder when you download J-Integra for Exchange.
|
import com.intrinsyc.cdo.*;
import com.intrinsyc.rule.*;
public class InboxRule {
static String domain = "DOMAIN"; //domain where the CDO host machine belongs
//make sure it's all capitalized
static String user = "username"; //username of Java-Exchange user
static String password = "password"; //password of Java-Exchange user
static String mailbox = "mailbox"; //mailbox of Java-Exchange user. By MS Exchange settings,
//the mailbox name is the same as the username
static String CDOmachine = "000.000.000.000"; // IP address of the CDO host machine
// or name of the machine (e.g. "machine1")
static String exchangeServer = "000.000.000.000"; // IP address of the Exchange Server
// or name of the Exchange Server (e.g. "mailServer")
final static String SUBJECT_TO_SEARCH = "Test";
final static int SUBSTRING = 1;
final static int ACTION_DELETE = 3;
final static int ACTION_REPLY = 4;
final static int CdoPR_SUBJECT = Integer.parseInt("37001E", 16);
final static int IGNORECASE = Integer.parseInt("10000", 16);
public static void main(String[] args) {
try {
System.setProperty("JINTEGRA_NATIVE_MODE", "");
// Authenticate to NT domain via NTLM
com.linar.jintegra.AuthInfo.setDefault(domain, user, password);
// Start a MAPI Session
Session session = new Session(CDOmachine);
// Logon to the Exchange Server
session.logon(null, null, new Boolean(false), new Boolean(true),
new Integer(0), new Boolean(true),
exchangeServer + "\n" + mailbox);
// Get the inbox
Folder inbox = new FolderProxy(session.getInbox());
// for deletion
Messages m = new MessagesProxy(inbox.getMessages());
System.out.println("Inbox has " + m.getCount().toString() + " messages.");
// ******************
// Each folder has a Rules collection.
Rules rules = new Rules(CDOmachine);
rules.setFolder(inbox);
// Create condition for rules.
PropVal propVal = new PropVal(CDOmachine);
propVal.setTag(CdoPR_SUBJECT); // looks in Subject property
propVal.setValue(SUBJECT_TO_SEARCH); // looks for this string
// Create ContentCondition
ContentCondition condition = new ContentCondition(CDOmachine);
condition.setValue(propVal);
condition.setPropertyType(CdoPR_SUBJECT);
condition.setOperator(SUBSTRING + IGNORECASE); // ignores case and other text.
// Create reply message and store in HiddenMessages collection
Messages hiddenMessages = new MessagesProxy(inbox.getHiddenMessages());
Message replyMessage = new MessageProxy(hiddenMessages.add(null, null, null, null));
// Set reply message properties.
replyMessage.setType("IPM.Note.Rules.ReplyTemplate.Microsoft");
replyMessage.setText("Please do not send messages to this address");
replyMessage.update(new Boolean(true), new Boolean(true));
// Create Reply Rule first.
Rule replyRule = new Rule(CDOmachine);
// Set reply action.
Action replyAction = new Action(CDOmachine);
replyAction.setActionType(ACTION_REPLY);
Object[] params = new Object[2];
params[0] = replyMessage.getID(); // ID of template
params[1] = replyMessage.getFolderID(); // folder ID of template
replyAction.setArg(params); // Set the parameters
// Set other reply rule properties.
replyRule.setName("Reply Test");
replyRule.setCondition(condition);
Actions replyActions = new Actions(replyRule.getActions());
replyActions.add(null, replyAction);
// Add reply rule to rules collection.
rules.add(null, replyRule);
// Create Delete Rule object.
Rule deleteRule = new Rule(CDOmachine);
// Create delete action.
Action deleteAction = new Action(CDOmachine);
deleteAction.setActionType(ACTION_DELETE);
// Set delete rule properties.
deleteRule.setName("Delete Test");
deleteRule.setCondition(condition); // reuse condition
Actions deleteActions = new Actions(deleteRule.getActions());
deleteActions.add(null, deleteAction);
// Add delete rule to the rules collection
rules.add(null, deleteRule);
rules.update();
// log off
session.logoff();
} catch (Exception e) {
e.printStackTrace();
} finally {
com.linar.jintegra.Cleaner.releaseAll();
}
}
} |
|