Viewing User Processing Rules

This page displays an overview all of the processing rules that have been created for the selected user.

Name. The number of the rule in the processing order. You cannot name processing rules, they are identified only by their sequence in the list (i.e. Rule1, Rule 2).

Field. The field that the rule searches in: Subject, To, From, Sender, Header or Body.

Rule. Either Contains or Doesn't Contain.

Value. The search string, or phrase that the rule searches for. This section displays all conditions for the rule.

Send To. The name of the mailbox to which messages meeting the rule criteria will be sent.

Working with Processing Rules

• To add a rule click Add, and the Edit Rule page is displayed. For more information on adding a rule for a list, click the Help button on that page.

• To edit a rule, click on the pencil icon located next to the rule that you want to edit.

• To delete a rule, click on the trash icon located next to the rule that you want to delete. If you want to delete all of the current rules, click Delete All.

• To move a rule up in the list, click on the up arrow icon located next to the rule.

• To move a rule down in the list, click on the down arrow icon located next to the rule.

Adding a processing Rule for a User

Inbound processing Rules can be used to sort incoming mail messages into specific mailboxes for each user based on the contents of the To, From, Sender, Subject, the entire message Header or Body fields.
 

Creating a processing Rule

1. From the Field box, select the field that you want the rule to search. You can select from (Subject, To, From, Sender, Header and Body).

2. Select contains to have the processing rule look for messages that contain the search string; select doesn't contain to look for messages that do not contain the string.

3. To enter search text, you can either enter it into the PHRASE text box as described below

Enter the search text by doing one or more of the following:

• Enter the literal text (up to 255 characters) that you want to search for. For example, if you want to find the word jazz, type: jazz.

• Type search expressions and quantifiers as shown in Text Patterns.

• Paste a portion of a mail message that meets your search criteria. For example, you could copy and paste text such as "XMSMailPriority(High)" from the header of a message; this would search for High priority messages.

4. Select Search string from file if you have placed the search text in an external  text file. The list box shows a list of the existing rule files.

5. Turn on Case Sensitive Match to search for text that matches the case of the search text. To ignore case, clear Case Sensitive Match.

6. Click Add Condition. The condition that you just created is added to the rule and is displayed in the Rule text box.

7. Specify what will be done with messages meeting the rule criteria by choosing one of the following options:

   • Send the message to a mailbox. Select Move the message to this mailbox. Then, in the text box to the right of this option, enter the name of the mailbox to which messages meeting the rule criteria will be sent. If you enter a mailbox that does not exist,  one will be created for the user on the IMail Server system. A POP3 user will see this mailbox only if he logs on to this mailbox using the format userid-mailbox. By default, if nothing is entered in this text box, messages meeting the rule criteria will be sent to the user's Main mailbox.

   • Send the message to an address. Select Forward the message to. Then, in the text box to the right of this option, enter the e-mail address to which messages meeting the rule criteria will be sent. You must enter the full e-mail address, such as Fred@domain1.com.

   • Delete the message. Select Delete the message to delete the message.

   • Deliver the message and copy to an additional mailbox. Select Copy to deliver the message to its intended recipient as well as copy it to an additional mailbox that you specify in the Address text box.

   • Return the message to sender. Select Bounce to send the message back to the sender without being processed.

Note: The above options cannot be combined, you must choose only one.

8. If this is the only condition you want the rule to have, click Finish and the rule will be activated. If you want to add more conditions, read the next section.
    

Adding Multiple Conditions

To add more than one condition to a rule, create the first condition by following steps 1 through 6 above and then click either the "Insert AND" or the "Insert OR" button. Create the second condition as you did the first, then proceed to steps 7 and 8.

Changing the Processing Order of Conditions

Conditions are processed in the order that they appear from top to bottom, as boolean expressions. To change the processing order of a condition, select the condition in the Rule text box and click either Move Up or Move Down.

Adding a processing Rule for a User

1. From the Field box, select the field that you want the rule to search. You can select from (Subject, To, From, Sender, Header and Body).

2. Select contains to have the processing rule look for messages that contain the search string; select doesn't contain to look for messages that do not contain the string.

3. To enter search text, you can either enter it into the PHRASE text box as described below.
    

Enter the search text by doing one or more of the following:

• Enter the literal text (up to 255 characters) that you want to search for. For example, if you want to find the word jazz, type: jazz.

• Type search expressions and quantifiers as shown in Text Patterns.

• Paste a portion of a mail message that meets your search criteria. For example, you could copy and paste text such as "XMSMailPriority(High)" from the header of a message; this would search for High priority messages.

4. Select Search string from file if you have placed the search text in an external  text file. The list box shows a list of the existing rule files.

5. Turn on Case Sensitive Match to search for text that matches the case of the search text. To ignore case, clear Case Sensitive Match.

6. Click Add Condition. The condition that you just created is added to the rule and is displayed in the Rule text box.

7. Specify what will be done with messages meeting the rule criteria by choosing one of the following options:

   • Send the message to a mailbox. Select Move the message to this mailbox. Then, in the text box to the right of this option, enter the name of the mailbox to which messages meeting the rule criteria will be sent. If you enter a mailbox that does not exist,  one will be created for the user on the IMail Server system. A POP3 user will see this mailbox only if he logs on to this mailbox using the format userid-mailbox. By default, if nothing is entered in this text box, messages meeting the rule criteria will be sent to the user's Main mailbox.

   • Send the message to an address. Select Forward the message to. Then, in the text box to the right of this option, enter the e-mail address, of the person or list, to which messages meeting the rule criteria will be sent. You must enter the full e-mail address, such as Fred@domain1.com.

   • Delete the message. Select Delete the message to delete the message.

   • Deliver the message and copy to an additional mailbox. Select Copy to deliver the message to its intended recipient as well as copy it to an additional mailbox that you specify in the Address text box.

   • Send a Bounce message to sender. Select Bounce to send a message back to the sender informing them that the message was not processed.

Note: The above options cannot be combined, you must choose only one.

8. If this is the only condition you want the rule to have, click Finish and the rule will be activated. If you want to add more conditions, read the next section.

Adding Multiple Conditions

To add more than one condition to a rule, create the first condition by following steps 1 through 6 above and then click either the "Insert AND" or the "Insert OR" button. Create the second condition as you did the first, then proceed to steps 7 and 8.

To edit an existing processing rule:

1. Select the condition that you want to change from the Rules text box. The previously grayed out options will display the settings for the rule.

2. Edit the rule as desired and click Update Condition.

3. Click Finish to save your changes.

Changing the Processing Order of Conditions

To change the processing order of a condition  in the list, select a condition and click Move Up or Move Down.

Deleting a Condition from a Rule

To delete a condition, select the condition from the Rules text box. Then click Remove. You must then click Finish
to save your changes.