Specifying Rule Conditions
The Rules object model supports the most commonly used rule actions and conditions. Each Rule object has an Actions property that represents the rule actions for that rule, as well as a Conditions property and an Exceptions property that represent the conditions for that rule. This topic describes how the Rules object model supports rule conditions.
Rule conditions for a rule are represented by a RuleConditions collection object. A RuleConditions object has properties that correspond to each commonly used rule condition in a rule. For example, if a rule specifies two conditions - the message is important and the subject contains certain words - then the Importance and Subject properties of the rule's RuleConditions collection object will return respective rule condition objects that are enabled (RuleCondition.Enabled is True). Conditions that are not specified in a rule will not be enabled in the corresponding RuleCondition object (RuleCondition.Enabled is False). Rule condition objects are represented by either the RuleCondition object or customized objects derived from the RuleCondition object. In the last example, the RuleConditions.Importance property will return an ImportanceRuleCondition object, and the RuleConditions.Subject property will return a TextRuleCondition object, both of which are derived from the RuleCondition object. The RuleCondition object and its derived objects have the ConditionType property that will indicate the type of the rule condition, for example, ImportanceRuleCondition.ConditionType will indicate the value olConditionImportance, and TextRuleCondition.ConditionType will indicate olConditionSubject.
Note that the Rules object model maintains partial parity with the Rules and Alerts Wizard. This means that while you can use the Wizard to create rules that specify any action and condition that you see in the Wizard, you can programmatically create rules that use some but not all of these actions and conditions. An example of a condition that the Rules object model supports for rules created by the Wizard but not for those created by the object model is messages of certain level of sensitivity. You can use the Wizard to create a rule specifying sensitivity as a condition. Using the Rules object model, you can enumerate this kind of rule in the Rules collection - for each rule in the Rules collection, enumerate its RuleConditions collection and look for an enabled rule condition for sensitivity. In code, this would mean for each rule in the Rules collection, enumerate RuleConditions.Item(Index) using the Index from 1 to RuleConditions.Count and look for an enabled condition with RuleCondition.ConditionType equal to olConditionSensitivity. You can also enable or disable such a rule condition in a rule. However, you cannot programmatically create a rule that specifies the olConditionSensitivity condition.
The following table lists all the rule conditions supported by the Rules and Alerts Wizard, and whether each rule condition is supported when creating a rule using the Rules object model. A rule condition that is not supported in rules created by the Rules object model is supported only for programmatic enumeration and enabling or disabling in existing rules created by the Rules and Alerts Wizard. The table also shows whether the rule condition applies to rules with the olRuleReceive rule type or olRuleSend rule type, or both.
Note
You cannot enable or disable a rule condition of the type olConditionOtherMachine. This type of rule condition indicates that the rule can run only on a certain computer, but the current computer is not that computer. This happens when the rule is created on one computer and the rule condition olConditionLocalMachineOnly is enabled, indicating that the rule can run only on that computer. In certain cases, olConditionLocalMachine is automatically set as a result of enabling another rule condition such as olConditionAccount. When you run the same rule on another computer, the rule will show that the condition olConditionOtherMachine is enabled.
Condition |
Constant in olRuleConditionType |
Supported when creating new rules programmatically? |
Apply to olRuleReceive rules? |
Apply to olRuleSend rules? |
Account is the account specified in AccountRuleCondition.Account. |
olConditionAccount |
Yes |
Yes |
Yes |
Message is assigned any category. |
olCondtionAnyCategory |
Yes |
Yes |
Yes |
Body contains words specified in TextRuleCondition.Text. |
olConditionBody |
Yes |
Yes |
Yes |
Body or subject contains words specified by TextRuleCondition.Text. |
olConditionBodyOrSubject |
Yes |
Yes |
Yes |
Message is assigned the category or categories specified in CategoryRuleCondition.Categories. |
olConditionCategory |
Yes |
Yes |
Yes |
Message has my name in the Cc box. |
olConditionCc |
Yes |
Yes |
|
Message was received between x and y, where x and y are Integer values. |
olConditionDateRange |
No |
Yes |
Yes |
Message is flagged for the specified action. |
olConditionFlaggedForAction |
No |
Yes |
Yes |
Message uses the form specified in FormNameRuleCondition.FormName. |
olConditionFormName |
Yes |
Yes |
Yes |
Sender is in the recipient list specified in ToOrFromRuleCondition.Recipients. |
olConditionFrom |
Yes |
Yes |
No |
Message is generated from any RSS subscription. |
olCondtionFromAnyRssFeed |
Yes |
Yes |
No |
Message is generated from a specified RSS subscription. |
olCondtionFromRssFeed |
Yes |
Yes |
No |
Message has an attachment. |
olConditionHasAttachment |
Yes |
Yes |
Yes |
Message is marked with the specified level of importance. |
olConditionImportance |
Yes |
Yes |
Yes |
Rule can run only on this machine. |
olConditionLocalMachineOnly |
Yes |
Yes |
Yes |
Message is a meeting invitation or update. |
olConditionMeetingInviteOrUpdate |
Yes |
Yes |
Yes |
Message header contains words specified in TextRuleCondition.Text. |
olConditionMessageHeader |
Yes |
Yes |
No |
Message does not have my name in the To box. |
olConditionNotTo |
Yes |
Yes |
No |
Message is sent only to me. |
olConditionOnlyToMe |
Yes |
Yes |
No |
Message is an out-of-office message. |
olConditionOOF |
No |
Yes |
No |
Rule can run only on a specific machine that is not the current one. |
olConditionOtherMachine |
No |
Yes |
Yes |
Document property is exactly, contains, or does not contain specified properties. |
olConditionProperty |
No |
Yes |
Yes |
Recipient address contains words specified in TextRuleCondition.Text. |
olConditionRecipientAddress |
Yes |
Yes |
Yes |
Sender address contains words specified in TextRuleCondition.Text. |
olConditionSenderAddress |
Yes |
Yes |
No |
Sender is in the address list specified in AddressRuleCondition.Address. |
olConditionSenderInAddressBook |
Yes |
Yes |
No |
Message is marked with the specified level of sensitivity. |
olConditionSensitivity |
No |
Yes |
Yes |
Sent to recipients (To, Cc) are in the recipient list specified in ToOrFromRuleCondition.Recipients. |
olConditionSentTo |
Yes |
Yes |
Yes |
Message size is between x and y in units of KB, where x and y are Date values. For example, “10;50” sets the size condition between 10 and 50KB. |
olConditionSizeRange |
No |
Yes |
Yes |
Subject contains words specified in TextRuleCondition.Text. |
olConditionSubject |
Yes |
Yes |
Yes |
My name is in the To box. |
olConditionTo |
Yes |
Yes |
No |
Message has my name in the To or Cc box. |
olConditionToOrCc |
Yes |
Yes |
No |
Unrecognized rule condition. |
olConditionUnknown |
No |
Yes |
No |