Using a Query to Filter Multiple Queries
The Data Source Filter property is added to queries for specifying whether or not a query works as a data source filter. By setting a query's Data Source Filter property to true and joining the query with other data resources, the filters defined in the query will be applied to all the other queries in the same catalog data source when the following conditions are satisfied:
- The queries contain the data resources with which the data source filter query is joined.
- The queries do not contain any of the data resources that are included in the data source filter query.
To create a query and use it as a data source filter:
- Create the query with the required data resources.
- Create filters on the query, then save the query.
- In the Catalog Manager, select Pre-join.
- In the Select Data Source dialog, select the catalog data source in which the query is created and select OK.
- In the Pre-join Editor, select Add Tables.
- In the Add Tables/Views/Queries dialog, select the query you just created and the data resources which you want to join with the query, then select OK.
- Define the joins between the query with the other data resources and save them. For more information, see Editing Pre-joins in a Catalog.
- Set the Data Source Filter property of the query to true.
The following example shows the usage of data source filter in detail. In this example, we add a filter Order ID > 3400 on a query and make it work as a data source filter. The example is based on the SampleReports catalog in <install_root>\Demo\Reports\SampleReports
.
- In the Catalog Manager, right-click the Queries node in Data Source 1 and select New Query from the shortcut menu.
- In the Enter Query Name dialog, type DSFQuery and select OK.
- In the Add Tables/Views/Queries dialog, expand the JDBC connection > Tables node, select Orders, select to add it to the right box, then select OK.
- In the Query Editor, select all the columns in the Orders table by selecting the top checkbox.
- Select Menu > Query > Filter.
- In the Search Condition dialog, select Add Condition to add a line, define the filter as @"Order ID" > 3400, and then select OK.
- Select OK in the Query Editor and then close the prompted dialog. The query DSFQuery is now added under the Queries node in the Catalog Manager and selected by default.
- In the Catalog Manager, select Show Properties, then set the query's Data Source Filter property to true.
Next, we will create a pre-join to join DSFQuery with the table Orders Detail.
- Select Pre-join on the Catalog Manager toolbar.
- In the Select Data Source dialog, select Data Source 1 and select OK.
- In the Pre-join Editor, select Add Tables.
- In the Add Tables/Views/Queries dialog, add the table Orders Detail and the query DSFQuery, then select OK.
- Join DSFQuery and Orders Detail by connecting the Order ID columns.
- Select Save to save the pre-join. Select Yes in the message dialog to accept the default path.
Next, we will create another query that contains the table joined with DSFQuery and use the query to create a report to test the data source filter.
- Repeat steps 1 to 4 to create another query named OrdersDetail which contains the Orders Detail table with all of its columns.
- Create a page report with a standard banded object in it based on the OrdersDetail query, which displays the fields Order_ID_FK1, Quantity and Unit Price.
- Preview the report. We can see that only the records the order IDs of which are higher than 3400 are shown.