Skip to content

Commit 21dbf3b

Browse files
authored
Merge pull request #31124 from mohitp930/mp7152024-freshness
Freshness - SSRS Batch 1
2 parents 3f12edd + be8df93 commit 21dbf3b

5 files changed

Lines changed: 98 additions & 92 deletions
Lines changed: 40 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -1,73 +1,76 @@
11
---
2-
title: "Add a Filter to a Dataset (Report Builder)"
2+
title: Add a filter to a Report Builder dataset
33
description: Learn how to add a filter to a dataset to limit the data in a report after the data is retrieved from an external data source.
44
author: maggiesMSFT
55
ms.author: maggies
6-
ms.date: 03/07/2017
6+
ms.date: 08/01/2024
77
ms.service: reporting-services
88
ms.subservice: report-data
9-
ms.topic: conceptual
9+
ms.topic: how-to
1010
ms.custom: updatefrequency5
11+
12+
#customer intent: As a Report Builder user, I want to learn how to add filters to my datasets so that I can limit the data in a report that's retrieved from a shared data source.
1113
---
12-
# Add a Filter to a Dataset (Report Builder and SSRS)
13-
Add a filter to a dataset to limit the data in a report after the data is retrieved from an external data source. When you add a filter to a dataset, all report parts or data regions use only data that matches the filter conditions.
14+
# Add a filter to a Report Builder dataset
15+
16+
Add a filter to a dataset to limit the data in a report after the data is retrieved from an external data source. When you add a filter to a dataset, all report parts or data regions use only data that matches the filter conditions.
1417

1518
[!INCLUDE [ssrs-report-parts-deprecated](../../includes/ssrs-report-parts-deprecated.md)]
1619

17-
For a shared dataset, a filter that applies to all dependent items must be part of the shared dataset definition on the report server. A report or report part that contains an instance of a shared dataset can create an additional filter that applies only to the instance.
20+
For a shared dataset, a filter that applies to all dependent items must be part of the shared dataset definition on the report server. A report or report part that contains an instance of a shared dataset can create another filter that applies only to the instance.
1821

19-
To add a filter, you must specify one or more conditions that are filter equations. A filter equation consists of an expression that identifies the data that you want to filter, an operator, and the value to compare to. The data types of the filtered data and the value must match. Filtering on aggregate values for a dataset is not supported.
22+
To add a filter, you must specify one or more conditions that are filter equations. A filter equation consists of an expression that identifies the data that you want to filter, an operator, and the value to compare to. The data types of the filtered data and the value must match. Filtering on aggregate values for a dataset isn't supported.
2023

2124
> [!NOTE]
22-
> [!INCLUDE[ssRBRDDup](../../includes/ssrbrddup-md.md)]
23-
24-
### To add a filter to a shared dataset
25-
26-
1. Open a shared dataset in shared dataset mode.
25+
> [!INCLUDE[ssRBRDDup](../../includes/ssrbrddup-md.md)]
2726
28-
2. On the **Home** tab, in the **Shared Datasets** group, click Datasets. The **Dataset Properties** dialog box opens.
27+
## Add a filter to a shared dataset
2928

30-
3. Click **Filters**. This displays the current list of filter equations. By default, the list is empty.
29+
1. Open a shared dataset in Report Builder.
3130

32-
4. Click **Add**. A new blank filter equation appears.
31+
1. On the **Home** tab, select **Set Options**. The **Dataset Properties** dialog box opens.
3332

34-
5. In **Expression**, type or select the expression for the field to filter. To edit the expression, click the expression (*fx*) button.
33+
1. Select the **Filters** tab. This option displays the current list of filter equations. By default, the list is empty.
3534

36-
6. From the list box, select the data type that matches the type of data in the expression you created in step 5.
37-
38-
7. In the **Operator** box, select the operator that you want the filter to use to compare the values in the **Expression** box and the **Value** box. The operator you choose determines the number of values that are used from the next step.
35+
1. Select **Add**. A new blank filter equation appears.
36+
37+
:::image type="content" source="../../reporting-services/report-data/media/add-dataset-filter.png" alt-text="Screenshot of the Dataset Properties dialog box on the Filters tab highlighting the add button.":::
3938

40-
8. In the **Value** box, type the expression or value against which you want the filter to evaluate the value in **Expression**.
39+
1. In the **Expression** field, enter or select the expression for the field to filter. To edit the expression, select the expression (**fx**) button.
4140

42-
For examples of filter equations, see [Filter Equation Examples (Report Builder and SSRS)](../../reporting-services/report-design/filter-equation-examples-report-builder-and-ssrs.md).
41+
1. From the dropdown list, select the data type that matches the type of data in the expression you created in the previous step.
4342

44-
9. Select **OK**.
43+
1. In the **Operator** dropdown list, select the operator that you want the filter to use to compare the values in the **Expression** and **Value** field. The operator you choose determines the number of values that are used from the next step.
4544

46-
### To add a filter to an embedded dataset or a shared dataset instance
45+
1. In the **Value** field, enter the expression or value against which you want the filter to evaluate the value in the **Expression** field. To edit the value, select the expression (**fx**) button.
4746

48-
1. Open a report in report design mode.
47+
For examples of filter equations, see [Filter equation examples in a paginated report (Report Builder)](../../reporting-services/report-design/filter-equation-examples-report-builder-and-ssrs.md).
4948

50-
2. Right-click a dataset in the **Report Data** pane and then click **Dataset Properties**. The **Dataset Properties** dialog box opens.
49+
1. Select **OK**.
5150

52-
3. Click **Filters**. This displays the current list of filter equations. By default, the list is empty.
51+
## Add a filter to an embedded dataset or a shared dataset instance
5352

54-
4. Click **Add**. A new blank filter equation appears.
53+
1. In your report, right-click a dataset in the **Report Data** pane and then select **Dataset Properties**. The **Dataset Properties** dialog box opens.
5554

56-
5. In **Expression**, type or select the expression for the field to filter. To edit the expression, click the expression (*fx*) button.
55+
1. Select the **Filters** tab. This option displays the current list of filter equations. By default, the list is empty.
5756

58-
6. From the drop-down box, select the data type that matches the type of data in the expression you created in step 5.
57+
1. Select **Add**. A new blank filter equation appears.
5958

60-
7. In the **Operator** box, select the operator that you want the filter to use to compare the values in the **Expression** box and the **Value** box. The operator you choose determines the number of values that are used from the next step.
59+
1. In the **Expression** field, enter or select the expression for the field to filter. To edit the expression, select the expression (**fx**) button.
6160

62-
8. In the **Value** box, type the expression or value against which you want the filter to evaluate the value in **Expression**.
61+
1. From the dropdown list, select the data type that matches the type of data in the expression you created in the previous step.
6362

64-
For examples of filter equations, see [Filter Equation Examples (Report Builder and SSRS)](../../reporting-services/report-design/filter-equation-examples-report-builder-and-ssrs.md).
63+
1. In the **Operator** dropdown list, select the operator that you want the filter to use to compare the values in the **Expression** and **Value** field. The operator you choose determines the number of values used in the next step.
6564

66-
9. Select **OK**.
65+
1. In the **Value** field, type the expression or value against which you want the filter to evaluate the value in the **Expression** field. To edit the value, select the expression (**fx**) button.
6766

68-
## See Also
69-
[Add Dataset Filters, Data Region Filters, and Group Filters (Report Builder and SSRS)](../../reporting-services/report-design/add-dataset-filters-data-region-filters-and-group-filters.md)
70-
[Expression Examples (Report Builder and SSRS)](../../reporting-services/report-design/expression-examples-report-builder-and-ssrs.md)
71-
[Add a Filter (Report Builder and SSRS)](../../reporting-services/report-design/add-a-filter-report-builder-and-ssrs.md)
67+
For examples of filter equations, see [Filter equation examples in a paginated report (Report Builder)](../../reporting-services/report-design/filter-equation-examples-report-builder-and-ssrs.md).
7268

69+
1. Select **OK**.
7370

71+
## Related content
72+
73+
- [Add dataset filters, data region filters, and group filters to a paginated report (Report Builder)](../../reporting-services/report-design/add-dataset-filters-data-region-filters-and-group-filters.md)
74+
- [Expression examples in paginated reports (Report Builder)](../../reporting-services/report-design/expression-examples-report-builder-and-ssrs.md)
75+
- [Add a filter to a paginated report (Report Builder)](../../reporting-services/report-design/add-a-filter-report-builder-and-ssrs.md)
76+
Lines changed: 30 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,64 +1,67 @@
11
---
2-
title: "Add and Verify a Data Connection (Report Builder)"
3-
description: Learn how to use Report Builder to add and verify a data connection to verify that the credentials that are specified are sufficient.
2+
title: Add and verify a data connection in Report Builder
3+
description: Learn how to use Report Builder to add and verify a data connection to make sure that the credentials you specify are sufficient.
44
author: maggiesMSFT
55
ms.author: maggies
6-
ms.date: 12/13/2020
6+
ms.date: 08/01/2024
77
ms.service: reporting-services
88
ms.subservice: report-data
9-
ms.topic: conceptual
9+
ms.topic: how-to
1010
ms.custom: updatefrequency5
11+
12+
#customer intent: As a Report Builder user, I want to learn how to add and verify data sources so that I can use the shared data sources from my report servers.
1113
---
1214

13-
# Add and Verify a Data Connection (Report Builder and SSRS)
15+
# Add and verify a data connection in Report Builder
1416

1517
In Report Builder, you can add a shared data source from the report server or create an embedded data source for your report. In Report Designer, you can create a shared data source or an embedded data source and deploy it to a report server.
1618

1719
To add a shared data source to your report, browse to a report server and select a shared data source. The shared data source in your report points to the shared data source definition on the report server.
1820

1921
To create an embedded data source, you must have connection information to the external source of data and you must know which permissions you need to access the data. This information usually comes from the owner of the data source. You can test the connection to verify that the credentials that are specified are sufficient.
2022

21-
For more information, see [Create data connection strings - Report Builder & SSRS](data-connections-data-sources-and-connection-strings-report-builder-and-ssrs.md) and [Specify Credentials in Report Builder](./specify-credential-and-connection-information-for-report-data-sources.md)
23+
For more information, see [Create data connection strings in Report Builder](data-connections-data-sources-and-connection-strings-report-builder-and-ssrs.md) and [Specify credential and connection information for report data sources](./specify-credential-and-connection-information-for-report-data-sources.md).
2224

2325
> [!NOTE]
2426
> [!INCLUDE[ssRBRDDup](../../includes/ssrbrddup-md.md)]
2527
26-
## To create a connection to a shared data source in Report Builder
28+
## Create a connection to a shared data source in Report Builder
2729

28-
1. On the toolbar in the Report Data pane, click **New,** and then click **Data Source**. The **Data Source Properties** dialog box opens.
30+
1. On the menu in the **Report Data** pane, select **New,** and then select **Data Source**. The **Data Source Properties** dialog box opens.
2931

30-
2. In the **Name** text box, type a name for the data source.
32+
1. In the **Name** text box, enter a name for the data source.
3133

3234
> [!NOTE]
33-
> This name is saved in the local report definition. This name is not the name of the shared data source on the report server.
35+
> This name is saved in the local report definition. This name isn't the name of the shared data source on the report server.
36+
37+
1. Select **Use a shared connection or report model**. The list of recently used shared data sources and report models appears. To select one from a report server, choose **Browse** and go to the folder on the report server where shared data sources are available.
3438

35-
3. Select **Use a shared connection or report model**. The list of recently used shared data sources and report models appears. To select one from a report server, click **Browse** and browse to the folder on the report server where shared data sources are available.
39+
:::image type="content" source="../../reporting-services/report-data/media/use-shared-connection-or-report-model.png" alt-text="Screenshot that shows the Data Source Properties dialog box highlighting the Use a shared connection or report model option.":::
3640

37-
4. Select the shared data source and then click **Open**.
41+
1. Select the shared data source and then choose **Open**.
3842

39-
5. Select **OK**.
43+
1. Select **OK**.
4044

41-
The data source appears in the Report Data pane.
45+
The data source appears in the **Report Data** pane.
4246

43-
### To verify a data connection
47+
### Verify a data connection
4448

45-
1. On the toolbar in the Report Data pane, double-click the data source. The **Data Source Properties** dialog box opens.
49+
1. In the **Report Data** pane, double-click your data source. The **Data Source Properties** dialog box opens.
4650

47-
2. Click **Test Connection**.
51+
1. Select **Test Connection**.
4852

49-
3. If the connection is successful, the following message appears: "Connection created successfully". Select **OK**.
53+
1. If the connection is successful, the following message appears: "Connection created successfully." Select **OK**.
5054

51-
4. If the connection is not successful, the following message appears: "Unable to connect to the data source."
55+
1. If the connection isn't successful, the following message appears: "Unable to connect to the data source."
5256

53-
5. Click **Details**, and use the information to correct the issue.
57+
1. Select **Details**, and use the information to correct the issue.
5458

55-
For more information, see [Specify Credentials in Report Builder](./specify-credential-and-connection-information-for-report-data-sources.md).
59+
For more information, see [Specify credential and connection information for report data sources](./specify-credential-and-connection-information-for-report-data-sources.md).
5660

57-
6. Select **OK**.
61+
1. Select **OK**.
5862

59-
## See also
63+
## Related content
6064

61-
- [Report Datasets (SSRS)](../../reporting-services/report-data/report-datasets-ssrs.md)
62-
- [Report Embedded Datasets and Shared Datasets (Report Builder and SSRS)](../../reporting-services/report-data/report-embedded-datasets-and-shared-datasets-report-builder-and-ssrs.md)
63-
- [Finding, Viewing, and Managing Reports (Report Builder and SSRS )](../../reporting-services/report-builder/finding-viewing-and-managing-reports-report-builder-and-ssrs.md)
64-
- [Create data connection strings - Report Builder & SSRS](data-connections-data-sources-and-connection-strings-report-builder-and-ssrs.md)
65+
- [Report datasets (SSRS)](../../reporting-services/report-data/report-datasets-ssrs.md)
66+
- [Report embedded datasets and shared datasets (Report Builder and SSRS)](../../reporting-services/report-data/report-embedded-datasets-and-shared-datasets-report-builder-and-ssrs.md)
67+
- [Find, view, and manage reports (Report Builder and SSRS)](../../reporting-services/report-builder/finding-viewing-and-managing-reports-report-builder-and-ssrs.md)

0 commit comments

Comments
 (0)