Filter dialog

This dialog appears when you do either of the following, and is of different usage in each case:

• Click the Filter button on the toolbar of the Business Cube Editor window. In this case, the dialog helps you to create or modify a built-in filter for a business cube. The built-in filter is transparent to the end users running the BC reports. Each business cube can only have one built-in filter.
• Select 0001 - Filter from the drop-down list of the Message ID column and then click in the Actions column of the Receive Message dialog, or when you select *Filter and then click OK in the Web Action List dialog. In this case, the dialog helps you to define to filter data of the current library component as a response to the message the library component receives at runtime.

When the dialog is used to filter a business cube, options in the dialog are as follows. See the dialog.

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 up to a higher level.

Down

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

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.

Field

Specifies the field to be filtered. You can either type in the field directly or click next to the text box to specify the field.

Operator

Specifies the operator to compose the filter expression.

• =
  Equal to
• >=
  Greater than or equal to
• >
  Greater than
• <
  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. For operator ‘in' or ‘not in', it is allowed to input multiple values in the Value input box and separate the values with comma (,).
• [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. For operator ‘between' or ‘not between', there are two value input boxes for inputting the same type of values.
• is [not] null
  It is used in WHERE clause predicates to match null values occurring in a specified data field. For operator ‘is null' or ‘is not null', the value input box is hidden.

Value

Specifies the value of how to filter the field. You can either click next to the text box to specify the value or type the value in the text box manually.

When you click to specify the value, the Values dialog is displayed:

• Fields tab
  Lists the fields which can be used in the filter expression. Double-click the required field to add it as the filter value.
• Value tab
  Lists values of the field to be filtered. Double-click the required value to add it as the filter value.

When you type in the value, if multiple values are required, they should be separated with ",", and if "," or "\" is contained in the values, write it as "\," or "\\".

SQL Statement

Displays the SQL statement of the filter condition.

OK

Applies the changes and closes the dialog.

Cancel

Cancels the changes and exits the dialog.

Help

Displays the help document about this feature.

The following are details about options in the dialog:

Adds a new filter condition.

Removes the selected filter condition.

Moves the selected filter condition up a step.

Moves the selected filter condition down a step.

Filter On

Specifies the field on which the filter is based.

Operator

Specifies the operator to compose the filter expression.

• =
  Equal to
• >
  Greater than
• <
  Less than
• >=
  Greater than or equal to
• <=
  Less than or equal to
• !=
  Not equal to
• in
  Causes an enumerated list of values to appear in the WHERE clause predicate, used for evaluating for a true condition. For operator ‘in', it is allowed to input multiple values in the Value input box and separate the values with comma (,).

Value

Specifies the value of how to filter the field. If multiple values are required, they should be separated with ",", and if "," or "\" is contained in the values, write it as "\," or "\\".

More

Lists some additional commands, which includes AND, OR, and End.

OK

Accepts the changes and closes this dialog.

Cancel

Does not retain any changes and closes the dialog.

Help

Displays the help document about this feature.

Related topics:

• Creating filters
• Receiving messages