Add, Change, or Delete Default Values for a Report Parameter (Report Builder and SSRS)

 

Applies To: SQL Server 2016

After you create a report parameter, you can provide a list of default values. If all parameters have a valid default value, the report runs automatically when you first view or preview it.

Report parameters can represent one value or multiple values. For single values, you can provide a literal or expression. For multiple values, you can provide a static list or a list from a report dataset.

System_CAPS_ICON_note.jpg Note


You can create and modify paginated report definition (.rdl) files in Report Builder and in Report Designer in SQL Server Data Tools. Each authoring environment provides different ways to create, open, and save reports and related items.

After you publish a report, you can override the default values that you define in the report in the report authoring tool, by setting parameter property values on the report server. You can also provide multiple sets of default parameter values by creating linked reports. For more information, see Report Parameters (Report Builder and Report Designer)

To add or change the default values for a report parameter

  1. In the Report Data pane, expand the Parameters node. Right-click the parameter and click Edit. The Report Parameter Properties dialog box opens.

    System_CAPS_ICON_note.jpg Note


    If the Report Data pane is not visible, click View and then click Report Data.

  2. Click Default Values.

  3. Select a default option:

    • To manually provide a value or list of values, click Specify values. Click Add and then enter the value in the Value text box. You can write an expression for a value. The data type must match the data type of the parameter. Field names cannot be used in an expression for a parameter.

      For multivalue parameters, repeat this step for as many values as you want to provide. The order of items you see in this list determines the order that the user sees them in the drop-down list. To change the order of an item in the list, click the Value text box to select the item, and then use the up and down arrow buttons to move the item higher or lower in the list.

    • To provide the name of an existing dataset that retrieves the values, click Get values from a query. In Dataset, choose the name of the dataset.

      In Value field, choose the name of the field that provides parameter values.

  4. Click OK.

To remove the default values for a report parameter

  1. In the Report Data pane, expand the Parameters node. Right-click the parameter and click Edit. The Report Parameter Properties dialog box opens.

  2. Click Default Values.

  3. In Select from one of the following options, click No default value.

  4. Click OK.

Report Parameters (Report Builder and Report Designer)
Add Cascading Parameters to a Report (Report Builder and SSRS)
Tutorial: Add a Parameter to Your Report (Report Builder)
Add Dataset Filters, Data Region Filters, and Group Filters (Report Builder and SSRS)
Parameters Collection References (Report Builder and SSRS)
Change the Order of a Report Parameter (Report Builder and SSRS)
Add, Change, or Delete a Report Parameter (Report Builder and SSRS)
Expressions (Report Builder and SSRS)

Community Additions

ADD
Show: