Filter Queries

<< Click to Display Table of Contents >>

Navigation:  User Interface Reference > Dashboard Designer > Working with Data >

Filter Queries

Dashboard for Desktop > Dashboard Designer > Working with Data > Filter Queries

SQL queries constructed in the Query Builder can be filtered by including WHERE clauses to the query. Filtering can be applied to either underlying or aggregated data. You can also limit the number of returned records when filtering data.

Invoke the Filter Editor

Filter Data

Add Limits

ExpandedCollapsed Invoke the Filter Editor

To filter data in the Query Builder, click the Filter... button... in the Data Source ribbon tab...

img118162

... or use a corresponding button within the Query Builder. This will invoke the Filter Editor dialog, which allows you to build filter criteria.

img121069

The Filter tab allows you to filter underlying data while the Group Filter tab provides the capability to filter data aggregated on the server side.

ExpandedCollapsed Filter Data

In the Filter Editor, you can compare a field value with the following objects.

A static value (represented by the img21820 icon). Click this button to switch to the next item mode ("another field value") to compare the field value with another field value.

Another field value (represented by the img21824 icon). Click this button to switch to the next item mode (“parameter value”) to compare the field value with a parameter value.

A parameter value (represented by the img21825 icon). Click this button to switch back to the initial mode ("static value") to compare the field value with a static value.

Thus, you can pass the query parameter to the filter string. To do this, click the img21820 button, then click the img21824 button and finally click <select a parameter>.

img121070

In the invoked popup menu, you can choose from the following options.

Add Query Parameter - allows you to create a new query parameter. The following dialog will be invoked.

img121074

In this dialog, you can specify a parameter's name (Name), type (Type) and value (Value).

If the current query already contains query parameters, they will be displayed within the popup menu.

Bind to - allows you to pass a dashboard parameter to a filter string. You can choose from the list of predefined dashboard parameters or create a new dashboard parameter by selecting Add Dashboard Parameter. If you selected Add Dashboard Parameter, the following dialog will be invoked.

img121075

In this dialog, you can specify settings of the dashboard parameter to be created. To learn more, see Creating Parameters.

After you specified the required settings, click OK. A new dashboard parameter along with a new query parameter will be created. Note that created dashboard and query parameters will be bound automatically.

The Group Filter tab of the Filter Editor allows you to apply filtering to grouped/aggregated data fields by including HAVING clauses to the query. Grouping and aggregation are managed by the Group By and Aggregate options in the Query Builder. To learn more, see the Edit Column Settings paragraph in the Query Builder topic.

ExpandedCollapsed Add Limits

The Filter Editor also allows you to limit the number of returned records. To do this, enable the Select only checkbox and specify the number of records to be returned.

img121073

You can also skip the required number of records in the returned dataset by specifying the records starting with index value.

Note

Note that the Sorting type should be specified in the Query Builder to enable the capability to skip the specified number of records. To learn how to apply sorting, see the Edit Column Settings paragraph in the Query Builder topic.

Copyright (c) 1998-2016 Developer Express Inc. All rights reserved.

Send Feedback on this topic to DevExpress.