You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
2. Create a report parameter whose values you want to filter. Click the **Filter String** property's ellipsis button in the **Add New Parameter** dialog and specify a filter string that references the parameter you created in the first step.
> In a filter string for a parameter's look-up values, you can reference only those parameters that you created before the parameter whose look-up values you want to filter. You can use the **Report Parameters Editor** to change the order in which you created the parameters. To invoke the editor, right-click the **Parameters** node in the [Field List](../report-designer-tools/ui-panels/field-list.md) and select **Edit Parameters**.
29
29
30
30
3. In the report's smart tag, click the **Filter String** property's ellipsis button. In the invoked **FilterString Editor**, specify an expression that uses both parameters to filter report data:
31
31
32
-
32
+
33
33
34
34
The following image illustrates cascading parameters where the **Product** parameter values are filtered by the selected **Category**.
You can filter the list of predefined parameter values by another parameter's value to create **cascading parameters**.
41
-
42
-
> [!TIP]
43
-
> See the following topics for information on how to specify a predefined list of parameter values:
44
-
> *[Report Parameters with Predefined Static Values](report-parameters-with-predefined-static-values.md) - to directly specify the list of values.
45
-
> *[Report Parameters with Predefined Dynamic Values](report-parameters-with-predefined-dynamic-values.md) - to specify the storage that contains the list of values.
46
-
47
-
Follow the steps below to filter the list of parameter values by another parameter's value.
48
-
49
-
1. Click the **Filter String** property's ellipsis button in the **Add Parameter** dialog and specify a filter string that refers to another parameter.
1. In the report's smart tag, click the **Filter String** property's ellipsis button. In the invoked **Filter Editor**, specify an expression that uses both parameters:
Copy file name to clipboardExpand all lines: interface-elements-for-web/articles/report-designer/use-report-parameters/create-a-report-parameter.md
+16-65Lines changed: 16 additions & 65 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,39 +9,29 @@ This topic demonstrates how to create a report parameter in the [Report Designer
9
9
10
10
## Create a Report Parameter in the Report Designer
11
11
12
-
In the **Report Designer**, you can create a parameter from the [Field List](../report-designer-tools/ui-panels/field-list.md), [Properties panel](../report-designer-tools/ui-panels/properties-panel.md), or [Filter Editor](../use-expressions.md#filter-editor). The created parameter appears in the [Field List](../report-designer-tools/ui-panels/field-list.md)'s **Parameters** node.
12
+
In the **Report Designer**, you can create a parameter from the [Field List](../report-designer-tools/ui-panels/field-list.md) and [Properties panel](../report-designer-tools/ui-panels/properties-panel.md). The created parameter appears in the [Field List](../report-designer-tools/ui-panels/field-list.md)'s **Parameters** node.
13
13
14
-
14
+
15
15
16
16
### Create From the Field List
17
17
18
-
Right-click the **Parameters** node in the [Field List](../report-designer-tools/ui-panels/field-list.md) and select **Add Parameter**.
18
+
Click the plus button in the [Field List](../report-designer-tools/ui-panels/field-list.md)'s **Parameters** node.
19
19
20
-
20
+
21
21
22
22
Specify [parameter options](#parameter-options) in the invoked **Add New Parameter** dialog and click *OK*.
23
23
24
-
24
+
25
25
26
-
### Create From the Properties Window
26
+
### Create From the Properties Panel
27
27
28
-
Select a report and click the **Parameters** property's ellipsis button in the [Properties panel](../report-designer-tools/ui-panels/properties-panel.md).
28
+
Select a report, navigate to the [Properties panel](../report-designer-tools/ui-panels/properties-panel.md)*Data* section, and click the plus button right to the *Parameters* node.
29
29
30
-
31
-
32
-
Click **Add** in the invoked **Report Parameters Editor** dialog to add a new parameter. Specify [parameter options](#parameter-options) and click *OK*.
You can create a parameter when you construct a condition in the [Filter Editor](../use-expressions.md#filter-editor). Choose the **Select a parameter** field, click the field, and select **Add Parameter** in the invoked context menu.
39
-
40
-
30
+
41
31
42
32
Specify [parameter options](#parameter-options) in the invoked **Add New Parameter** dialog and click *OK*.
43
33
44
-
34
+
45
35
46
36
## Parameter Options
47
37
@@ -53,31 +43,25 @@ The name by which you can [reference a parameter in a report](reference-report-p
53
43
54
44
A parameter description that appears on a report's **Print Preview** in the [Parameters panel](parameters-panel.md).
You can assign an [expression](../use-expressions.md) to this option. The example below specifies an expression that shows/hides a parameter based on a value of another parameter.
65
53
66
-
67
-
68
-
54
+
69
55
70
56
### Enabled
71
57
72
58
Specifies whether a parameter editor is enabled or disabled in the [Parameters panel](parameters-panel.md). You can set this option to **No** to make a parameter's [default value](#default-value) read-only.
You can also assign an [expression](../use-expressions.md) to this option. The example below specifies an expression that enables/disables a parameter's editor based on a value of another parameter.
77
63
78
-
79
-
80
-
64
+
81
65
82
66
### Type
83
67
@@ -100,7 +84,7 @@ A parameter's default value. This value is displayed in the [Parameters panel](p
100
84
101
85
You can specify an [expression](../use-expressions.md) for this option. For example, set this option to **Now()** to use the current date as a date parameter's default value.
102
86
103
-
87
+
104
88
105
89
> [!NOTE]
106
90
> You can use only [constants](../use-expressions/expression-syntax.md#constants), [operators](../use-expressions/expression-syntax.md#operators), and date-time / logical / math / string [functions](../use-expressions/expression-syntax.md#functions-basic) in an expression for a parameter's default value.
@@ -109,13 +93,13 @@ You can specify an [expression](../use-expressions.md) for this option. For exam
109
93
110
94
When the **Allow Null Value** option is enabled, you can leave the parameter's value unspecified.
111
95
112
-
96
+
113
97
114
98
### Allow Multiple Values
115
99
116
100
When the **Allow Multiple Values** option is enabled, you can specify multiple values for a report parameter.
@@ -131,36 +115,3 @@ Use the **Value Source** option to specify a custom set of values a parameter ca
131
115
*[Report Parameters with Predefined Static Values](report-parameters-with-predefined-static-values.md)
132
116
*[Report Parameters with Predefined Dynamic Values](report-parameters-with-predefined-dynamic-values.md)
133
117
*[Date Range Report Parameters](date-range-report-parameters.md)
134
-
135
-
# Create a Report Parameter (Old)
136
-
137
-
This topic describes how to create a basic report parameter and specify its value.
138
-
139
-
## Create a Parameter
140
-
141
-
Click the  button next to **Parameters** in the the [Field List](../../report-designer-tools/ui-panels/field-list.md) to invoke the **Add Parameter** dialog.
142
-
143
-
144
-
145
-
Specify the following basic options:
146
-
147
-
| Option | Description |
148
-
| --- | --- |
149
-
|**Name**| A parameter should have a unique name. You can use this name to refer to this parameter in expressions and filter strings. |
150
-
|**Type**| Specifies which values a parameter can accept. |
151
-
|**Value** or **[Expression](../../use-expressions.md#expression-syntax)**| Specifies a parameter's value. Expressions can include data source fields or other parameters. When evaluated, expressions are parsed and processed to obtain a value. |
152
-
153
-
## Use the Parameters Panel to Ask for User Input
154
-
155
-
Enable the **Visible** option to make your report interactive. The Preview displays the **Parameters** panel that shows editors for report parameters marked as visible. This allows you to specify a value before the report is rendered. Specify the parameter's **Description** to display the editor's caption in the **Parameters** panel.
> Disable the report's **Request Parameters** property to avoid the **Waiting for parameter values** message in **Preview** and display the report with default parameter values.
161
-
162
-
Enable the **Allow Null** property if the parameter's value can be unspecified.
163
-
164
-
The following image shows editors for different parameter types.
Copy file name to clipboardExpand all lines: interface-elements-for-web/articles/report-designer/use-report-parameters/date-range-report-parameters.md
+6-58Lines changed: 6 additions & 58 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,80 +7,28 @@ author: Sergey Andreev
7
7
8
8
This topic describes how to create a date range parameter and filter a report's data by the specified dates.
9
9
10
-
10
+
11
11
12
12
## Create a Date Range Parameter in the Report Designer
13
13
14
14
Follow the steps below to add a date range parameter to a report in the [Report Designer](../first-look-at-the-report-designer.md):
15
15
16
16
1.[Create a report parameter](create-a-report-parameter.md) and set the **Value Source** option to **Range Parameters**. The **Start Parameter** and **End Parameter** sections appear, and you can configure options in these sections to create a date range.
2. Set the name and initial value for the **Start Parameter** and **End Parameter**. To specify an [expression](../use-expressions.md) instead of a static value, click the **Value** option's ellipsis button and use the **Expression Editor** dialog.
After you create a date range parameter, you can reference the names of the **Start Parameter** and **End Parameter** in the report's filter string to [filter the report's data](../shape-report-data/filter-data/filter-data-at-the-report-level.md) by the created date range. Select the report, click the **FilterString**'s ellipsis button in the **Properties window**, and construct a filter condition in the invoked **FilterString Editor**.
When you switch to the report's **Print Preview** tab, the [Parameters panel](parameters-panel.md) displays the date range parameter. After you submit a start and end date, the report document shows filtered data.
29
29
30
-
30
+
31
31
32
32
The start and end parameter values store the selected day's midnight time. For instance, if you choose _10/15/2019_, the *DateTime* value is _10/15/2019 12:00:00 AM_. If your date fields include non-midnight times, records for the end date _10/15/2019_ are excluded from the report. To include data for the 10/15/2019 date, use the **GetDate()** function in the **FilterString Editor**.
This document describes how to create a date range parameter and filter report data by the specified dates.
39
-
40
-
41
-
42
-
Perform the steps below to add a date range parameter to a report.
43
-
44
-
1. Switch to the [Field List](../../report-designer-tools/ui-panels/field-list.md) and click the  button next to **Parameters**.
1. Specify the options below in the invoked **Add Parameter** dialog and click **OK**.
49
-
50
-
-**Name**
51
-
52
-
The parameter's name.
53
-
54
-
-**Description**
55
-
56
-
The parameter's description displayed to users.
57
-
58
-
-**Type**
59
-
60
-
The parameter's data type. Set it to **Date** to create a date range.
61
-
62
-
-**Visible**
63
-
64
-
This option enables the **Preview** to show the parameter's editor in the **Parameters** panel. See [Use the Parameters Panel to Ask for User Input](create-a-report-parameter.md#use-the-parameters-panel-to-ask-for-user-input) for more information.
65
-
66
-
-**Value Source**
67
-
68
-
Settings that are used to generate the parameter's predefined values. Set this property to **Range Parameters**. The **Start Parameter** and **End Parameter** sections appear where you can configure the inner parameters.
- Use the **Start Parameter** and **End Parameter**'s **Value** properties to specify default values. Use the **Expression** properties to conditionally specify parameter values or to bind them to fields or other parameters. Click the **Expression** property's ellipsis button and specify an expression in the invoked **Expression Editor**.
1. Use the start and end parameter names in the report's filter string to [filter data](../filter-data/filter-data-at-the-report-level.md) by the created date range. Select the report, click the **Filter String** property's ellipsis button in the [Properties Panel](../../report-designer-tools/ui-panels/properties-panel.md), and construct the filter string in the invoked **Filter Editor**.
> The start and end parameter values store the selected day's midnight time. For instance, if you choose _10/15/2019_, the DateTime value is _10/15/2019 12:00:00 AM_. If your date fields include non-midnight time, records for the end date _10/15/2019_ are excluded from a report. Use the **GetDate()** function in the **Filter Editor** to include data for the 10/15/2019 date.
When you switch to **Preview**, the **Parameters** panel displays the date range parameter. After you submit a start and end date, a report document is displayed with filtered data.
85
-
86
-
0 commit comments