Mario Blättermann
mario.blaettermann@gmail.com 2008-2010, 2016-2017

# Das Filter-Fenster

This window is divided in two parts: the left part is the list of all filters. When you select one of them, the right part displays its properties. The right part is a two-page notebook (the match page, and the action page); their descriptions follow.

Unter den Filterlisten befinden sich zwei Knöpfe:

The New button: you click on it to create a new filter; the filter is initially named “New Filter”, and contains no condition. Then you fill in the different fields in the notebook pages (in particular remember to change the name of the filter), add the conditions that will describe how this filter matches a message, and to confirm the modifications push the Apply button on the right hand side of the Filters window.

Der Entfernen-Knopf entfernt den aktuell ausgewählten Filter.

# The Match Page

Jeder Filter wird aus einer oder mehreren Bedingungen gebildet. Jede Bedingung repräsentiert einen Test, der auf die Nachrichten angewendet wird. Die Ergebnisse dieser Tests werden dann entsprechend des Typs der angegebenen Operation kombiniert:

AND: Alle Bedingungstests müssen wahr sein, um eine Übereinstimmung zu bilden.

OR: Ein Bedingungstest muss wahr sein, um eine Übereinstimmung zu bilden.

Then the page displays the name of the filter and the conditions that describes how the filters matches a message. The list displays the type of the conditions (the conditions will be described later):

Simple: the match is done by a simple substring test.

Regular expression: the match uses regular expressions on the message headers.

Date interval: the match is done by checking if the date of the message is within certain bounds.

Flag condition: the match is done by checking the flags of the message: unread, replied, deleted, flagged.

The three buttons under the list allows you to edit the selected condition, add a new one, or remove one. Editing or creating a condition is done in the condition window, which pops up when you click on the Edit or the New button.

The two buttons under the notebook at the right hand side of the window lets you manipulate the currently selected filter. The Apply button is used to confirm the modifications you have made on any field. If you make changes and select another filter without first clicking on the Apply button, all your changes will be lost.

The Revert button cancels all previous changes: the current filter is reverted to its state just before the last click on the Apply button.

# Die Aktionen-Seite

This page describes the actions to take in case the filter matches. First you specify the notification to inform you that the one or several messages has matched the filter in the Notification frame. Then in the Action frame you tell what to do with the matching messages. You can ask Balsa to copy or move them to any mailbox, or to send them to the trash can. The other actions are not yet implemented.

# Das Bedingungen-Fenster

This window is used to edit an existing condition or to create a new one. It displays all the information needed to describe the condition, it is launched when you click on the Edit or New buttons under the conditions list in the match page of the notebook in the right part of the filters window.

Dieses Fenster besteht aus drei Teilfenstern:

The Match Fields frame: it's a set of check boxes, one per match field. For example if you want to match all messages that was sent by hotmail users, you just have to check the From box, or if you want to match all messages about Balsa, check the Subject box.

Be careful with Body match, this can take time for large messages.

For advanced use you can also specify directly the name of the header to match on. A standard example the “X-Mailer” is a header added to your message by the MUAs with their name and versions.

The All button will check all boxes, whereas the Clear button will uncheck all boxes (as you might have guessed).

If you specify several headers, a message will match this condition if one of the headers matches. For example if you want to filter all messages talking about Balsa, you should check the Body and the Subject boxes, so that all mails with the word “Balsa” in its subject or its body will match. You can also, if you're fed up with Balsa ;-), match all mails that do NOT contain the word “Balsa” in their subject and in their body neither. See the description of the search types to see how to do this.

The Search Type frame: it's a list of the different condition types. You choose Simple, Regular expression, Date interval, or Flag condition. Your choice will change the third frame so that it displays the fields needed by the type of match chosen.

Dieser Teil ist von dem von Ihnen gewählten Suchtyp abhängig:

Simple type: a text entry lets you input the string to look for (case does not matter, the search is case-insensitive). The button lets you specify if a message matches when the string is or is NOT a substring of the specified headers, the sentence above the text entry will be updated accordingly.

Regular expression: you can input a list of regular expressions. You type your regular expression in the text entry, then you click on the Add button to put it into the list. Of course the Remove button destroys the selected regular expression in the list. The last button One matches/None matches lets you specify when a message matches the condition: when one of the regular expression matches or when none matches. The sentence above the list will be updated accordingly.

Date interval: you can input the interval by the mean of the two text entries. A blank entry means no bound. The button tells to match when the message date is within the bounds or not. The sentence above the text entries will be updated accordingly.

Flag condition: the four check boxes let you select which messages will match this condition. If you want to match all replied OR unread messages, check the corresponding boxes. The button let you specify that the match will be done when none of the specified flags are set, the sentence above the check boxes will be updated accordingly. For example if you want to filter all read and replied messages, check the unread and replied boxes, and click on the button.