Enter Parameter Settings dialog

The dialog allows you to customize the default parameter values for a report.

To access the dialog, on the JReport Console > Resources page, browse to the target report, then do one of the following:

• Select the row the report is in, then on the task bar of the Resources page, click Tools > Parameter Settings.
• Select the report row, right-click in the row and select Parameter Settings from the shortcut menu.
• Put the mouse pointer over the report row and click the Parameter Settings button on the floating toolbar.

See the dialog.

Parameters

Specifies the default values of the parameters in the report. If no parameter is used, "No Parameter Needed" will be displayed here.

You may specify parameter values in these ways:

• In the parameter value combo box, input the value manually or select the required one from the drop-down list.
• Click the button if it is available to specify multiple values in the Enter Values dialog.
• Click the calendar button if it is available to set a date and time value in the Calendar dialog.
• Check the Use Saved Values checkbox and select a previously saved parameter value list to apply to the report.

  The Use Saved Values option is available when Enable Saving Parameter Values is enabled and Manually is checked in the Profile > Customize Server Preferences > Advanced tab. When Use Saved Values is checked, a drop-down list that contains the lists of previously saved parameter values will be displayed for you to choose one to apply. The button next to the drop-down list is used to delete a saved list from the list library.

Save Values

This link is available when Use Saved Values is checked. When it is clicked, the currently displayed parameter values set for the specified report will be saved as a whole marked as a list for reuse next time, and you need to provide a name for the list in the prompted dialog as required.

The parameter value lists saved for the report are limited. The maximum number is controlled by the option Maximum Number of Auto Complete Parameters List in the Profile > Customize Server Preferences > Advanced tab. By default it is 3. When the number of the saved parameter value lists reaches the maximum number, if you want to save another parameter list, it will overwrite the oldest one.

Save as default

Saves current parameter values to the default item of the "Use Saved Values" list for the report. The default item is used to retrieve default values to the parameters. If users do not set the default values, or if any of the parameters cannot find a matched validated value from the default item, all the parameters will use their default values specified in the parameters' definition.

This operation takes effect after the task is submitted.

Do not show the screen again

When this option is selected, the next time the report runs it uses the default parameter values directly without popping the parameter dialog. However, if the default values specified using the save as default action cannot completely match the report parameters, the parameter dialog will still be displayed.

OK

Applies the settings and exits the dialog.

Reset

Resets the parameter values to either of the following:

• Original Default Values
  The default values defined in the parameters' definition.
• User Defined Default Values
  The default values specified using the save as default action.
  

Cancel

Closes the dialog and discards any changes.