OdsMailFiltersGuide Creating Filters in ODS-MailCreating Filters in ODS-Mail ODS-Mail offers to the user the powerful feature of setting its own filters in ODS-Mail. Where? ODS user can create its own filters by going to ODS-Mail -> Preferences -> Filters:
Activities? ODS User can manage its filters by 2 main options: creating new filters and deleting existing ones: Create New Filter ODS User can create new filters, by clicking the "Create Filter" button. The presented form offers the following options: "Name": name of the filter; "Apply filter when": ; "Name": the setting has four options: "Checking Mail or Manually Run" ( set by default ); "Never"; "Checking Mail"; "Manually Run". "Attach to IMAP account": allows the filter to be attached to existing IMAP4 account set up for the current ODS-Mail instance:
"Apply filter actions when": the setting has two options: "all criteria are matched" (set by default ); "any of criteria is matched" . "Criteria" section: consists of 3 fields per each criteria: "Field", matching "Condition" list and "Value":
<tgroup><thead /><tbody> <row /> <row><entry>Subject</entry><entry>Can be one of: "equal to"</entry><entry> Any </entry></row> <row><entry> </entry><entry>"not equal to" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"contains substring" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"does not contain substring"</entry><entry>Any </entry></row> <row><entry> </entry><entry> "starts with" </entry><entry>Any </entry></row> <row><entry> </entry><entry> "does not start with" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"ends with" </entry><entry>Any </entry></row> <row><entry> </entry><entry> "does not end with"</entry><entry>Any </entry></row> <row><entry>Body</entry><entry>"contains"</entry><entry>Any </entry></row> <row><entry>From</entry><entry>"equal to"</entry><entry>Any </entry></row> <row><entry> </entry><entry>"not equal to" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"contains substring" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"does not contain substring"</entry><entry>Any </entry></row> <row><entry> </entry><entry> "starts with" </entry><entry>Any </entry></row> <row><entry> </entry><entry> "does not start with" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"ends with" </entry><entry>Any </entry></row> <row><entry> </entry><entry> "does not end with"</entry><entry>Any</entry></row> <row><entry> </entry><entry>"is null" </entry><entry>No value</entry></row> <row><entry> </entry><entry> "is not null"</entry><entry>No value </entry></row> <row><entry>To</entry><entry>"equal to"</entry><entry>Any </entry></row> <row><entry> </entry><entry>"not equal to" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"contains substring" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"does not contain substring"</entry><entry>Any </entry></row> <row><entry> </entry><entry> "starts with" </entry><entry>Any </entry></row> <row><entry> </entry><entry> "does not start with" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"ends with" </entry><entry>Any </entry></row> <row><entry> </entry><entry> "does not end with"</entry><entry>Any </entry></row> <row><entry> </entry><entry>"is null" </entry><entry>No Value </entry></row> <row><entry> </entry><entry> "is not null"</entry><entry>No Value </entry></row> <row><entry>CC</entry><entry>"equal to"</entry><entry>Any </entry></row> <row><entry> </entry><entry>"not equal to" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"contains substring" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"does not contain substring"</entry><entry>Any </entry></row> <row><entry> </entry><entry> "starts with" </entry><entry>Any </entry></row> <row><entry> </entry><entry> "does not start with" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"ends with" </entry><entry>Any </entry></row> <row><entry> </entry><entry> "does not end with"</entry><entry>Any </entry></row> <row><entry> </entry><entry>"is null" </entry><entry>No value </entry></row> <row><entry> </entry><entry> "is not null"</entry><entry>No value </entry></row> <row><entry>Return-Path</entry><entry>"equal to"</entry><entry>Any </entry></row> <row><entry> </entry><entry>"not equal to" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"contains substring" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"does not contain substring"</entry><entry>Any </entry></row> <row><entry> </entry><entry> "starts with" </entry><entry>Any </entry></row> <row><entry> </entry><entry> "does not start with" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"ends with" </entry><entry>Any </entry></row> <row><entry> </entry><entry> "does not end with"</entry><entry>Any </entry></row> <row><entry> </entry><entry>"is null" </entry><entry>No value </entry></row> <row><entry> </entry><entry> "is not null"</entry><entry>No value </entry></row> <row><entry>Date</entry><entry>"equal to"</entry><entry>Any from type Date</entry></row> <row><entry> </entry><entry>"not equal to" </entry><entry>Any from type Date</entry></row> <row><entry> </entry><entry>"less than" </entry><entry>Any from type Date</entry></row> <row><entry> </entry><entry>"less than or equal to" </entry><entry>Any from type Date</entry></row> <row><entry> </entry><entry>"greater than"</entry><entry>Any from type Date</entry></row> <row><entry> </entry><entry> "greater than or equal to" </entry><entry>Any from type Date</entry></row> <row><entry>Priority</entry><entry>"equal to"</entry><entry> Can be one of: Normal, Lowest, Low, High, Highest</entry></row> <row><entry> </entry><entry>"not equal to" </entry><entry>Can be one of: Normal, Lowest, Low, High, Highest</entry></row> <row><entry> </entry><entry>"less than" </entry><entry>Can be one of: Normal, Lowest, Low, High, Highest</entry></row> <row><entry> </entry><entry>"less than or equal to" </entry><entry>Can be one of: Normal, Lowest, Low, High, Highest</entry></row> <row><entry> </entry><entry>"greater than"</entry><entry>Can be one of: Normal, Lowest, Low, High, Highest</entry></row> <row><entry> </entry><entry> "greater than or equal to" </entry><entry>Can be one of: Normal, Lowest, Low, High, Highest</entry></row> <row><entry>Attachments</entry><entry>"equal to"</entry><entry>Can be one of: Yes, No</entry></row> <row><entry> </entry><entry>"not equal to" </entry><entry>Can be one of: Yes, No</entry></row> <row><entry>Read</entry><entry>"equal to"</entry><entry>Can be one of: Yes, No</entry></row> <row><entry> </entry><entry>"not equal to" </entry><entry>Can be one of: Yes, No</entry></row> <row><entry>Size</entry><entry>"equal to"</entry><entry>Any </entry></row> <row><entry> </entry><entry>"not equal to" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"less than" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"less than or equal to" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"greater than"</entry><entry>Any </entry></row> <row><entry> </entry><entry> "greater than or equal to" </entry><entry>Any </entry></row> <row><entry>Tags</entry><entry>"contains"</entry><entry>Any </entry></row> <row><entry>Encrypted</entry><entry>"equal to"</entry><entry>Can be one of: Yes, No</entry></row> <row><entry> </entry><entry>"not equal to" </entry><entry>Can be one of: Yes, No</entry></row> <row><entry>Signed</entry><entry>"equal to"</entry><entry>Can be one of: Yes, No</entry></row> <row><entry> </entry><entry>"not equal to" </entry><entry>Can be one of: Yes, No</entry></row> <row><entry>Signed (Verified)</entry><entry>"equal to"</entry><entry>Can be one of: Yes, No</entry></row> <row><entry> </entry><entry>"not equal to" </entry><entry>Can be one of: Yes, No</entry></row> <row><entry>Certificate - Verified </entry><entry>"equal to"</entry><entry>Can be one of: Yes, No</entry></row> <row><entry> </entry><entry>"not equal to" </entry><entry>Can be one of: Yes, No</entry></row> <row><entry>Certificate - Expiration Status </entry><entry>"equal to"</entry><entry>Can be one of: Yes, No</entry></row> <row><entry> </entry><entry>"not equal to" </entry><entry>Can be one of: Yes, No</entry></row> <row><entry>Certificate - Serial Number </entry><entry>"equal to"</entry><entry>Any </entry></row> <row><entry> </entry><entry>"not equal to" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"contains substring" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"does not contain substring"</entry><entry>Any </entry></row> <row><entry> </entry><entry> "starts with" </entry><entry>Any </entry></row> <row><entry> </entry><entry> "does not start with" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"ends with" </entry><entry>Any </entry></row> <row><entry> </entry><entry> "does not end with"</entry><entry>Any </entry></row> <row><entry>Certificate - <ulink url="WebID">WebID</ulink> </entry><entry>"equal to"</entry><entry>Any </entry></row> <row><entry> </entry><entry>"not equal to" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"contains substring" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"does not contain substring"</entry><entry>Any </entry></row> <row><entry> </entry><entry> "starts with" </entry><entry>Any </entry></row> <row><entry> </entry><entry> "does not start with" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"ends with" </entry><entry>Any </entry></row> <row><entry> </entry><entry> "does not end with"</entry><entry>Any </entry></row> <row><entry>Certificate - Mail</entry><entry>"equal to"</entry><entry>Any </entry></row> <row><entry> </entry><entry>"not equal to" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"contains substring" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"does not contain substring"</entry><entry>Any </entry></row> <row><entry> </entry><entry> "starts with" </entry><entry>Any </entry></row> <row><entry> </entry><entry> "does not start with" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"ends with" </entry><entry>Any </entry></row> <row><entry> </entry><entry> "does not end with"</entry><entry>Any </entry></row> <row><entry>Certificate - Subject</entry><entry>"equal to"</entry><entry>Any </entry></row> <row><entry> </entry><entry>"not equal to" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"contains substring" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"does not contain substring"</entry><entry>Any </entry></row> <row><entry> </entry><entry> "starts with" </entry><entry>Any </entry></row> <row><entry> </entry><entry> "does not start with" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"ends with" </entry><entry>Any </entry></row> <row><entry> </entry><entry> "does not end with"</entry><entry>Any </entry></row> <row><entry>Certificate - Issuer</entry><entry>"equal to"</entry><entry>Any </entry></row> <row><entry> </entry><entry>"not equal to" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"contains substring" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"does not contain substring"</entry><entry>Any </entry></row> <row><entry> </entry><entry> "starts with" </entry><entry>Any </entry></row> <row><entry> </entry><entry> "does not start with" </entry><entry>Any </entry></row> <row><entry> </entry><entry>"ends with" </entry><entry>Any </entry></row> <row><entry> </entry><entry> "does not end with"</entry><entry>Any </entry></row> <row><entry>Certificate - Issue Date</entry><entry>"equal to"</entry><entry>Any from type Date</entry></row> <row><entry> </entry><entry>"not equal to" </entry><entry>Any from type Date</entry></row> <row><entry> </entry><entry>"less than" </entry><entry>Any from type Date</entry></row> <row><entry> </entry><entry>"less than or equal to" </entry><entry>Any from type Date</entry></row> <row><entry> </entry><entry>"greater than"</entry><entry>Any from type Date</entry></row> <row><entry> </entry><entry> "greater than or equal to" </entry><entry>Any from type Date</entry></row> <row><entry>Certificate - Expiry Date</entry><entry>"equal to"</entry><entry>Any from type Date</entry></row> <row><entry> </entry><entry>"not equal to" </entry><entry>Any from type Date</entry></row> <row><entry> </entry><entry>"less than" </entry><entry>Any from type Date</entry></row> <row><entry> </entry><entry>"less than or equal to" </entry><entry>Any from type Date</entry></row> <row><entry> </entry><entry>"greater than"</entry><entry>Any from type Date</entry></row> <row><entry> </entry><entry> "greater than or equal to" </entry><entry>Any from type Date</entry></row> <row><entry>Certificate - Fingerprint Digest </entry><entry>"equal to"</entry><entry>Any </entry></row> <row><entry> </entry><entry>"not equal to" </entry><entry>Any </entry></row> <row><entry>SPARQL ASK Statement</entry><entry>"equal to"</entry><entry>Can be one of: Yes, No</entry></row> <row><entry> </entry><entry>"not equal to" </entry><entry>Can be one of: Yes, No</entry></row> </tbody></tgroup></table> </listitem> <listitem>"Commands" section: consists of 2 fields per each criteria: "Command" and matching "Value" list: <table><title /><tgroup><thead /><tbody> <row /> <row><entry>"Move To" </entry><entry>Can be any folder from the presented ODS-Mail instance folders list</entry></row> <row><entry>"Copy To" </entry><entry>Can be any folder from the presented ODS-Mail instance folders list</entry></row> <row><entry> "Delete"</entry><entry>No value </entry></row> <row><entry>"Forward To" </entry><entry>Accepts any value </entry></row> <row><entry>"Tags (coma separated)" </entry><entry>Accepts tags value separated by comma </entry></row> <row><entry>"Mark as Read" </entry><entry>No value </entry></row> <row><entry>"Set Priority To" </entry><entry> Can be one of: Normal, Lowest, Low, High, Highest</entry></row> </tbody></tgroup></table> </listitem> </orderedlist></listitem> </itemizedlist><bridgehead class="http://www.w3.org/1999/xhtml:h3">System Created Filters</bridgehead> <para>With creation of a new ODS-Mail instance is created a system filter for every user, so called "System: <ulink url="WebID">WebID</ulink> Important". It is scoped to "Local and POP3 accounts".</para> <orderedlist spacing="compact"><listitem>From the list of existing filters for filter "System: <ulink url="WebID">WebID</ulink> Important" click "Edit" to view its properties: <figure><graphic fileref="OdsMailFiltersGuide/filt2.png" /></figure> </listitem> <listitem>The filter has 2 criteria and 2 commands: if the message is signed and verified with certificate, then set its priority to "High" and move it to the system folder "Important".</listitem> </orderedlist><bridgehead class="http://www.w3.org/1999/xhtml:h2">Examples</bridgehead> <itemizedlist mark="bullet" spacing="compact"><listitem><ulink url="ODSMailWebIDFilterRule">Web ID Filter Rule Example</ulink>; </listitem> <listitem><ulink url="ODSMailIMAP4FilterRule">Set Filter Rule associated with IMAP4 account Example</ulink>; </listitem> <listitem><ulink url="OdsMailSpamFilterGuide">Set Spam Filter Example</ulink>; </listitem> <listitem><ulink url="ODSMailSpamFilterRule">Manage Spam Filter with Addressbook interaction</ulink></listitem> </itemizedlist><bridgehead class="http://www.w3.org/1999/xhtml:h2">Related</bridgehead> <para> </para> <itemizedlist mark="bullet" spacing="compact"><listitem><ulink url="OdsMail">ODS-Mail</ulink> </listitem> <listitem><ulink url="OdsMailInstallGuide">ODS-Mail's Installation Guide</ulink> </listitem> <listitem><ulink url="OdsMailSpamFilterGuide">ODS-Mail's Spam Filter Setting Guide</ulink> </listitem> <listitem><ulink url="ODSMailWebIDSMIME">ODS-Mail's SMIME + WebID Support Guide</ulink> </listitem> <listitem><ulink url="OdsWebmailProgrammersGuide">ODS-Mail's Programmers Guide</ulink> </listitem> <listitem><ulink url="ODSMailPop3External">Configure an external POP3 account in ODS-Mail</ulink> </listitem> <listitem><ulink url="ODSMailIMAP4External">Configure an external IMAP4 account in ODS-Mail</ulink> </listitem> <listitem><ulink url="ODSMailIMAP4Thunderbird">Synchronizing Mozilla Thunderbird IMAP4 account store with ODS-Mail IMAP4 mapped instance</ulink> </listitem> </itemizedlist></section></docbook>