Report parameters
You can define parameters in a report. Parameter is a variable, the value of which can be defined both in a report itself and outside of it (a program, calling a report can transfer parameters values into it. See details in "Programmer's manual"). A parameter can be used in expressions and be displayed in report objects like the "Text" object.
Most common methods of using parameters:
- data filtering by condition set in a parameter;
- printing parameter value in a report.
A parameter has the following properties:
Property | Description |
---|---|
Name | Parameter's name can have any symbols except dot ".". |
DataType | Parameter data type. |
Expression | Expression which returns parameter's value. More details about expressions can be found in the "Expression" chapter. This expression will be processed when calling a parameter. |
Value | Parameter value. This property is not available in the designer and can be filled programmatically. |
You have to set up "Name" and "DataType" properties. The "Expression" property can be left empty. In this case parameter's value should be passed programmatically.
To add a parameter, you should open the window "Data". Click on the green icon with a plus sign in front of Parameters node. After that, set the above parameters in the "Properties" window. Now, you can drag a parameter to the desired location on the report page, or use it to filter the data.
To remove a parameter, use the red icon with a minus sign.