The Parameters Panel

<< Click to Display Table of Contents >>

RayVentory Data Hub > 12.5 u5 > Dashboards and Reports Customization Guide > Designing Reports > Use Report Parameters 

The Parameters Panel

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

 

eurd-web-parameters-panel

 

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.

 

parameters-panel-reset-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-parameter-from-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

 

default-parameters-panel-1

 

 

customized-parameters-panel-1

 

 

Use the Report Parameters Editor

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

 

invoke-report-parameters-editor

 

This action invokes the Report Parameters Editor.

 

edit-parameters-window

 

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.

 

specify-label-orientation

 

Label orientation = Horizontal (Default)

Label orientation = Vertical

 

label-orientation-horizontal

 

 

label-orientation-vertical

 

 

Create and Customize a Group

Click the Add group button to create a new group.

 

report-parameters-editor-create-new-group

 

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

 

report-parameters-editor-setup-elements-order

 

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

 

report-parameters-editor-drag-and-drop-elements-in-menu

 

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.

 

report-parameters-editor-group-customization-options

 

Default panel

Panel with a group

 

default-parameters-panel-1

 

 

customized-parameters-panel-2

 

 

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.

 

report-parameters-editor-create-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.

 

report-parameters-editor-specify-location-for-separator

 

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

 

Default panel

Panel with separator

 

default-parameters-panel-3

 

 

customized-parameters-panel-3