Skip to content

Latest commit

 

History

History
108 lines (62 loc) · 4.49 KB

parameters-panel.md

File metadata and controls

108 lines (62 loc) · 4.49 KB
Raw
title author
The Parameters Panel
Eugene Polevikov

The Parameters Panel

The Parameters panel allows you to specify parameter values in a report's Print Preview.

Use the Parameters panel to specify parameter values

Submit Parameter Values

When you open a report's Print Preview, the Parameters panel displays default parameter values and descriptions.

Parameters panel, "Waiting for parameter values" message

Specify parameter values and click Submit to generate the report's Print Preview. Set the report's RequestParameters property to false to display a report document for the default parameter values when you open the Print Preview.

Reset Parameter Values to Defaults

Click the Reset button to reset parameter values to defaults.

Reset parameter values to defaults

Hide the Parameters Panel

To remove the Parameters panel from a report's Print Preview, disable the Visible option for all report parameters in the Report Parameters Editor.

Hide a parameter from the Parameters panel

When you hide the Parameters panel, the report's Print Preview is generated with the default parameter values.

Customize the Parameters Panel

You can unite report parameters into expandable groups, place parameters side-by-side, add separators, and more.

Default panel Customized panel

Use the Report Parameters Editor

Select the Parameters item in the Field List and click the Edit parameters button.

This action invokes the Report Parameters Editor.

Use the menu on the left to create and customize parameters, groups, and separators.

Customize a Parameter

Specify the Orientation property to choose the position of a parameter label relative to an editor.

Label orientation = Horizontal (Default) Label orientation = Vertical

Create and Customize a Group

Click the Add group button to create a new group.

Use the Up and Down buttons to change the order of parameters and groups, and place parameters inside or outside a group.

You can also drag-and-drop parameters and groups inside the menu to achieve the same result.

To customize a group, select it and use its editors on the right to set up the group appearance. The following example unites the customerName and companyName parameters into a group called Select a customer.

Default panel Panel with a group

Besides a title, you can also specify the following properties to customize the group appearance:

  • Orientation (specifies whether to place parameters inside the group vertically or horizontally).
  • Show title
  • Show borders
  • Show expand/collapse button
  • Expanded

Add a Separator

Click the Add separator button to create a separator.

Similar to parameters and groups, you can use the Up and Down buttons or drag-and-drop separators inside the menu to specify the location for these separators relative to other elements.

The example below shows the Parameters panel with a separator between the Company Name and Customer Name parameters.

Default panel Panel with a separator