Enterprise Vault™ Setting up Exchange Server Archiving
- About this guide
- Distributing Exchange Server Forms
- Setting up archiving from mailboxes
- Points to note before you set up Enterprise Vault mailbox archiving
- Defining Exchange Server mailbox archiving policies
- Mailbox policy settings when setting up Exchange Server archiving
- Mailbox policy settings when setting up Exchange Server archiving
- Defining desktop policies in Exchange Server archiving
- Desktop policy settings in Exchange Server archiving
- Options tab (Exchange Server archiving desktop policy setting)
- Advanced tab (Exchange Server archiving desktop policy setting)
- Desktop policy settings in Exchange Server archiving
- Adding Exchange Server archiving targets
- Using customized shortcuts with Exchange Server archiving
- About editing automatic messages for Exchange Server archiving
- Enabling mailboxes for Exchange Server archiving
- Setting up users' desktops
- Enterprise Vault Outlook Add-In for Exchange Server archiving
- Enterprise Vault Client for Mac OS X with Exchange Server archiving
- Getting users started with Exchange Server archiving
- Setting up Vault Cache and Virtual Vault
- Vault Cache synchronization
- Vault Cache header synchronization and content download
- Vault Cache advanced settings
- Virtual Vault advanced settings
- Setting up archiving from public folders
- About public folder policy settings
- Exchange Public Folder policy settings
- Exchange Public Folder policy settings
- Adding public folder archiving targets
- Setting up archiving of journaled messages
- Envelope Journaling
- Setting up Enterprise Vault Office Mail App for Exchange Server 2013 and later
- About the Enterprise Vault Office Mail App
- Deploying the Enterprise Vault Office Mail App
- Troubleshooting the Enterprise Vault Office Mail App
- Setting up Enterprise Vault access for OWA clients on Exchange Server 2010
- About Enterprise Vault functionality in OWA clients
- Enterprise Vault OWA Extensions in an Exchange Server 2010 environment
- Configuring access to Enterprise Vault from Outlook RPC over HTTP clients
- Using firewall software for external access to OWA and Outlook
- Configuring filtering
- About filtering
- Configuring selective journaling
- Configuring group journaling
- Configuring custom filtering
- About custom filtering ruleset files
- About controlling default custom filtering behavior
- About the general format of ruleset files for custom filtering
- About rule actions for custom filtering
- About message attribute filters for custom filtering
- About the general format of Custom Properties.xml
- About content categories
- Defining how custom properties are presented in third party applications
- Custom properties example
About custom filtering ruleset files
Custom filter rules and actions are defined in XML ruleset files. Each ruleset file contains one or more rules with associated actions.
Each rule contains the following:
A set of one or more attribute filters for evaluating each item that the archiving task processes. The order of attribute filters in a rule is not significant, all the attribute filters are evaluated.
An action to be applied to an item that matches all the attribute filters in the rule. Examples of actions are applying a particular retention category or storing the item in a specified archive. More than one action can be applied to matching items.
Although the order of the attribute filters in a rule is not significant, the order of the rules in the ruleset file is significant. The rules are evaluated in the order in which they appear in the file. The action associated with the first matching rule is applied to the item, and no further rules are evaluated for that item. If none of the rules match the item, the default action is to archive the item.
An item may be a message or an attachment. If a message has an attachment, the message is evaluated first, and then the attachment is evaluated.
By default items that do not match any rules are archived by the mailbox archiving task or the journal archiving task. If you want to archive only items that match a rule, you can create a catch-all rule as the last rule in the ruleset file. Assign the action "MARK_DO_NOT_ARCHIVE" to this last rule.
While developing and testing your filter, we strongly advise that you assign the action "MARK_DO_NOT_ARCHIVE" to your rules. Check that the rules are applied exactly as you expect before changing them to the actions that you want to use in your production environment.
All ruleset files must be available in the folder Custom Filter Rules
in the main Enterprise Vault folder (for example C:\Program Files (x86)\Enterprise Vault
) on the computer hosting the archiving tasks that are enabled for custom filtering.
After Enterprise Vault has been installed, this folder contains the following XML files:
Example Filter Rules.xml
- This provides examples of filter rules.ruleset schema.xdr
- This contains the XML schema for validating the XML ruleset files.Example Custom Properties.xml
- This provides example entries for the custom properties.xml file.customproperties.xsd
- This contains the XML schema for validating the custom properties XML file.
When you create ruleset files or modify existing ruleset files, you must restart the associated archiving tasks before the changes take effect. In a distributed environment, you must copy the updated file to each computer with tasks enabled for custom filtering, and then restart the associated tasks on each computer.
Note:
If you create rules to match names that contain special characters, you must save the XML ruleset files with Unicode encoding.
More Information