diff -r ed1c9f64298a -r 5b9d4d8641ce trace/traceviewer/com.nokia.traceviewer.help/html/tasks/advancedfilter.htm --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/trace/traceviewer/com.nokia.traceviewer.help/html/tasks/advancedfilter.htm Wed Jun 23 14:49:59 2010 +0300 @@ -0,0 +1,95 @@ + + + +Setting filtering options + + + +

Setting filtering options

+

TraceViewer provides various options for setting up filtering. +In some cases, it may also be necessary to use an external filter +application to modify the results. For instructions, +see Using an external filter application.

+ +

Basic options

+

You can create new filter rules in the basic Rules dialog, as for +other items. For instructions, see Setting up rules +and filters.

+ +

To set filtering-specific options:

+
    +
  1. After the rules are defined, select one or more of them from the tree.
  2. +
  3. Select either Hide or Show, to make the selected rules visible +on the tree.

    Special fields in Filter Rules dialog

  4. +
  5. Select either the OR or AND operator: + +
  6. +
  7. To take the selected rules to use, click Apply.
  8. +
+ +

Creating rule statements

+

You can make also more complicated filtering rules by setting advanced options. The point +is to make an effective and reasonable filter rule set, which will then be +used when filtering traces.

+

A rule set is written the form of a statement such as this:

+

(rule AND rule2) OR (smallRule AND NOT filterRule)

+

where traces are included or excluded based on this criterion.

+

Tip: You can also type the rule set statement manually into +the text field.

+

To set advanced options:

+
    +
  1. In the Filter Rules dialog, click Advanced.

    The Advanced +Filter Rules dialog is displayed, showing the basic rules already created. +

  2. +
  3. To start creating a new rule set, click Start Set.

    An opening +parenthesis ( is inserted into the text field to indicate the beginning.

  4. +
  5. To edit the rule set, select rules from the tree and combine them with +each other by clicking any of the following buttons: + +

    The Back button removes the last word from the text field, +starting from the caret position.

  6. +
  7. (Optional) To quickly add all the rules from a group to the set, click +the group name on the tree.

    From the pop-up, select OR or AND. After choosing, +all the rules from this group are added to the text field, separated by the +selected logical operation.

  8. +
  9. Click End Set to insert a closing parenthesis ) into the field.

    +Note: TraceViewer automatically checks that the rule is reasonable and +well-formed, that is, contains as many start brackets as end brackets. The +following is an example of a reasonable filter rule set that is correct and +ready to be applied:

  10. +
  11. (Optional) To hide or show a trace that hits this filter rule, change +the value of Show and Hide selection as needed.
  12. +
  13. Click OK to save the rule set.
  14. +
+ + + +
Related tasks
+ + + + + \ No newline at end of file