<< Click to Display Table of Contents >> RayVentory Data Hub > 12.5 u5 > Dashboards and Reports Customization Guide > Designing Reports > Use Report Parameters > Create a Report Parameter Multi-Value Report Parameters |
This document describes how to create a multi-value parameter and use this parameter to filter report data.
Tip: Refer to this help article for information on how to use multi-value parameters in an SQL query: Specify Query Parameters. |
Follow the steps below to create a multi-value parameter in the Report Designer:
1.Create a report parameter and enable the Allow multiple values option.
2.Specify a list of predefined values for the parameter. You can create a static list of values or load values from a data source. Refer to the following topics for instructions on how to do it:
oReport Parameters with Predefined Static Values
oReport Parameters with Predefined Dynamic Values
To filter a report's data by a multi-value parameter, use the Is any of operator for this parameter in the report's filter string:
A multi-value parameter's default values are selected automatically when you open a report's Print Preview:
Use one of the following methods to specify default values:
•Click the Add button right to the Value option and specify a value in a new editor.
•Enable the Select all values property to populate the parameter value with all items from the parameter's value source (static or dynamic).
Tip: Disable a report's Request Parameters property to avoid the Waiting for parameter values message on the report's Print Preview and display the report with default parameter values. |
Note: Ensure that the type of default values match the parameter type when you specify these values for the parameter. |
Optional parameters allow you to filter report data only if parameter values are specified. Otherwise, if parameter values are not set, the parameter is ignored.
Do the following to make a multi-value parameter optional.
1.Create a multi-value report parameter and specify its Allow null value, Value, and Select all values options as shown below:
Option |
Value |
Allow null value |
true |
Value |
Not specified |
Select all values |
false |
2.Disable the report's Request Parameters property.
3.Assign the following filter condition to the report's filter string:
?category Is Null or [Category ID] In (?category)
Tip: You can also use the filter string shown above to filter report data at the data source level. Refer to this help article for more information: Filter Data at the Data Source Level. |