Enter Values dialog

The dialog appears when you click the button

while specifying values for a parameter. It helps you to specify multiple values for the parameter. See the dialog.

Lists all predefined parameter values for selection. When the parameter is bound with a column, but the Display Column is different from the Bind Column, values of the Display Column are listed here.

Adds the selected values from the Available Values box to the Selected Values box.

Adds all the selected values from the Available Values box to the Selected Values box.

This option is available when the parameter's Allow Type-in of Value property is set to true in JReport Designer.

Enter a value manually in the text box and then click the button next to add the value to the Selected Values box. When the parameter is bound with a column, but the display column is different from the bind column, make sure the value you enter is that of the bind column.

Opens the Calendar dialog to specify a date and time value. Available only for Date, DateTime, or Time parameter which allows for type-in values and is not bound with any column.

This option is available when the parameter's Allow Type-in of Value property is set to false in JReport Designer. It is used to search for values among the available values. After you type text in the Search text box, the matched text in the available values will be highlighted.

If selected, it means that the parameter value result is all the values in the DBMS. This option is available when the parameter's Enable the "All" Option property is set to true in JReport Designer. This is translated in SQL to remove the parameter which may select more values than listed in the available values list.

SELECT CUSTOMERS.CUSTOMERID,CUSTOMERS.CUSTOMERNAME FROM CUSTOMERS where CUSTOMERS.CUSTOMERID>0 and CUSTOMERS.CUSTOMERID<4

When you click

to add 1, 2 and 3 as the parameter values, which are all the available values, the SQL is:

Run the same report again and this time check the All checkbox in the Enter Values dialog, the query is then:

In this case, you will get more customers even though available values are only 1 – 3.

Note: When a multi-value parameter is inserted as a field into a report and All is selected as the value, the field will show the string "All". If the parameter allows type-in values, "All" means all possible values of the parameter data type; if the parameter does not, "All" represents all the values of the parameter that come from the DBMS.