Working with Parameter Fields
A parameter in Logi Report is a variable whose value is determined at runtime. The runtime parameters help you dynamically control your report result. This topic introduces how you can insert parameter fields in a report and apply conditional formatting to the parameter fields.
For the parameter fields in a report, you can use them as the trigger object of links, and change their display types if you want.
This topic contains the following sections:
See an example: The SampleComponents catalog, included with Designer, contains reports that have examples of how you could use each component type in a report. For the parameter field examples, open the following reports: <install_root>\Demo\Reports\SampleComponents\Parameter.cls
, and <install_root>\Demo\Reports\SampleComponents\ParameterField.cls
.
Inserting Parameter Fields in a Report
You can insert parameter fields in the report areas listed in Component Placement.
To insert a parameter field into a report, select the required parameter from Parameters node in the Data panel, then drag it to the destination. If the predefined parameters are not what your want, select the <New Parameter...> item to create one as required. For a business view-based report, you can create local parameters to use in the report specifically.
For a page report using a query resource, you can also use dialog box to insert a parameter field into it.
- Position the mouse pointer at the destination where you want to insert the parameter.
- Select Insert > Parameter or Home > Insert > Parameter. Designer displays the Insert Fields dialog box.
- Select the required parameter from the Parameters node. You can select multiple parameters to insert them all a time.
- If you select multiple parameters, in the Insert Layout box, specify the layout of the parameter fields in the report. By default, Designer arranges them in the default layout. You can arrange the parameter fields horizontally or vertically by selecting Horizontal or Vertical, and customize the space between them.
- Select Insert to insert the parameter fields into the destination.
If you insert a parameter into the detail panel of a banded object or table, Designer automatically inserts its name as a label into the corresponding header panel; otherwise, Designer places the parameter and its name label in the same panel. If you do not want Designer to insert the name label automatically, clear "Insert field name label with field" in the Component category of the Options dialog box.
Adding Conditional Formatting to Parameter Fields
You can add conditional formatting to parameter fields in a report, then in the report result, the field values that meet a specified condition automatically apply the formatting you define for the condition. This is very useful to highlight values that users may need to act on at runtime.
To apply conditional formatting to a parameter field, right-click it and select Conditional Formatting from the shortcut menu, then take the same procedure as described in Adding Conditional Formatting to DBFields.