RDORule object |
RDORule object represents a rule defined in the parent Exchange mailbox.
Returned by:
RDORules.Create, RDORules.Item
The example below creates a new rule that marks all incoming messages as read
set Session =
CreateObject("Redemption.RDOSession") |
Derived from: IDispatch |
|||
|
|||
Properties |
|||
|
|||
Actions |
RDORuleActions, read-only. Returns the collection representing the available actions for the rule.
|
See the example above |
|
Conditions |
Reserved for future use. To set the rule conditions and exceptions, use the SetRawConditionsKind method (see below). To read the existing conditions and exceptions, use the RawConditions property (see below).
|
||
ConditionsAsSQL |
String, read/write. Allows to retrieve or set the rule conditions as a standard SQL style string.
The properties specified in the SQL query must either use the Outlook Object Model (or RDO) property name (e.g. Subject, Email1Address) or a DASL style property name (e.g. "http://schemas.microsoft.com/mapi/proptag/0x0037001E", "http://schemas.microsoft.com/mapi/id/{00062004-0000-0000-C000-000000000046}/8083001E") When a DASL property name is used, it must be enclosed in double quotes. Use OutlookSpy to figure out the DASL property names - select an item in Outlook, click IMessage button on the OutlookSpy toolbar, select the property, see the "DASL" edit box on he right hand side of the window.
|
set Session =
CreateObject("Redemption.RDOSession")
|
|
Enabled |
Boolean, read/write. True if the rule is enabled, false otherwise.
|
|
|
Exceptions |
Reserved for future use. To set the rule conditions and exceptions, use the SetRawConditionsKind method (see below). To read the existing conditions and exceptions, use the RawConditions property (see below).
|
||
ExecutionOrder |
Integer, read/write. Indicates the order of execution of the rule among the rules in the parent RDORules collection.
|
|
|
KeepOOFHistory |
Boolean, read/write. Applicable only when OnlyWhenOOF property is set to true. If true, the rule fires only once for each sender. This way the action such as an OOF reply will be sent only once per sender. The OOF history is reset when OOF is reset back to false (RDOExchangeMailboxStore.OutOfOfficeAssistant.OutOfOffice = false)
|
|
|
Name: |
String, read/write. Returns or sets the name of the rule.
|
set Session =
CreateObject("Redemption.RDOSession")
|
|
OnlyWhenOOF |
|
'Create a rule for the "natalia"
mailbox that will redirect all messages set Session =
CreateObject("Redemption.RDOSession")
|
|
Provider |
String, read/write. Returns or sets the name of the rule provider, such as "RuleOrganizer". Corresponds to PR_RULE_NAME in MAPI.
|
|
|
RawConditions |
Returns Restriction object representing the restriction determining when and if the rule fires. If NULL, the rule will fire on each incoming message. To set the conditions for a new rule or modify conditions for an existing rule, use the SetRawConditionsKind method (see below)
|
See SetRawConditionsKind below |
|
StopProcessingOtherRules |
Boolean, read/write. When set to true, if the rule conditions are met and the rule is executed, other rules with the ExecutionOrder property higher than that for this rule will not be executed. Useful if the rule moves or deletes the message.
|
|
|
Methods |
|||
|
|||
Delete |
Deletes the rule
|
||
Save |
Saves the rule
|
||
SetRawConditionsKind(Kind) |
Set the rule conditions for the rule. Returns Restriction object representing the restriction determining when and if the rule fires.
You can also set the conditions using the ConditionsAsSQL property (see above).
Kind - one of the RestrictionKind enums:
RES_AND = 0 |
'Example 1 'Create a rule for the "natalia"
mailbox that will redirect all messages
'Example 2 'Create a rule for the "natalia"
mailbox that will redirect all messages
|
|
|