### Query Filter dialog

This dialog helps you to apply a filter to the business view used by the specified data component to narrow down its data scope. It has the following two modes:

- Basic
- Advanced

Advanced/Basic

Switches the dialog to the advanced/basic mode.

OK

Applies the settings and closes the dialog.

Cancel

Closes the dialog and discards any changes.

Help

Displays the help document about this feature.

#### Basic mode

The basic mode provides function for creating simple filter conditions which are connected by the AND and OR operators. See the dialog.

Query Filter

Specifies the filter you want to apply to the business view.

- User Defined
  Specifies to create a user defined filter to apply to the business view.
- Predefined filters
  The names of the predefined filters which were created on the business view in JReport Designer. You can choose one of them to apply.
  - Edit
    Edits the selected predefined filter. Once a predefined filter is edited, it will be saved as a user defined filter in the business view.
  - Description
    Displays the description of the selected predefined filter.

Deletes the current condition line.

Field

Specifies the field to be filtered.

Operator

Specifies the operator to compose the filter expression.

- =
  Equal to
- >
  Greater than
- >=
  Greater than or equal to
- <
  Less than
- <=
  Less than or equal to
- !=
  Not equal to
- [not] in
  Causes an enumerated list of values to appear in the WHERE clause predicate, used for evaluating for a true condition.
- [not] like
  Like string pattern matching operator is used to compare the first expression string value to the pattern string (the second expression). If you want to use wildcard character in the pattern string, only "_" and "%" are supported.
- [not] between
  Allows the system to evaluate whether or not data values are located between a range of values indicated in the predicate.
- is [not] null
  It is used in WHERE clause predicates to match null values occurring in a specified data field.

Value

Specifies the value of how to filter the field. You can either enter the value manually in the text box or select a value from the drop-down list. Click the button or to switch to filter the field by field or value. When you type in the value manually, if multiple values are required, they should be separated with ",", and if "," or "\" is contained in the values, write it as "\," or "\\".

Logic

Lists the logic operator.

- AND
  Logic operator AND which is applied to this and the next line.
- OR
  Logic operator OR which is applied to this and the next line.

#### Advanced mode

The advanced mode enables the building of more complex filter conditions via the grouping of conditions. See the dialog.

Query Filter

Specifies the filter you want to apply to the business view.

- User Defined
  Specifies to create a user defined filter to apply to the business view.
- Predefined filters
  The names of the predefined filters which were created on the business view in JReport Designer. You can choose one of them to apply.
  - Edit
    Edits the selected predefined filter. Once a predefined filter is edited, it will be saved as a user defined filter in the business view.
  - Description
    Displays the description of the selected predefined filter.

Add Condition

Adds a new condition line.

Delete

Deletes the selected condition line.

Group

Makes the selected conditions in one group. Conditions can also be added to an existing group by selecting the conditions and the group while holding the Ctrl button, and then clicking the Group button.

Ungroup

Makes the selected condition ungrouped.

Up

Moves the selected condition or group up to a higher level.

Down

Moves the selected condition or group down to a lower level.

Logic

Specifies the logic operator.

- AND
  Logic operator AND which is applied to this and the next line.
- OR
  Logic operator OR which is applied to this and the next line.
- AND NOT
  Logic operator AND NOT which is applied to this and the next line.
- OR NOT
  Logic operator OR NOT Not which is applied to this and the next line.

Field

Specifies the field to be filtered.

Operator

Specifies the operator to compose the filter expression.

Value

Specifies the value of how to filter the field. You can either enter the value manually in the text box or select a value from the drop-down list. Click the button or to switch to filter the field by field or value. When you type in the value manually, if multiple values are required, they should be separated with ",", and if "," or "\" is contained in the values, write it as "\," or "\\".

Condition Expression

Displays the SQL statement of the filter condition.

###### Related topics:

- Applying filters to business views