Previous Topic
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 formats 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 the Data panel, then drag it to the destination. If the given 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 as follows:
- 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 the Insert button 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, you can clear Insert field name label with field in the Options dialog box (File > Options > Component > Insert field name label with field).
Adding Conditional Formats to Parameter Fields
You can add conditional formats to parameter fields in a report, then when a specified condition is fulfilled, Logi Report automatically applies the format defined on the condition to the field values. This is very useful to highlight values that the report users may need to act on at runtime.
To add conditional format 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 Formats to DBFields.