Progress
Report Builder
Deployment Guide
Prompting for User Input
You can use both predefined and user-defined parameters to prompt users for input. However, the user must be using the machine where Report Engine is running.
Prompting for Input with a Predefined Parameter
There are two ways to prompt for user input using predefined parameters. The first way is to write your own 4GL code to prompt users for input, then pass the values to Report Engine using predefined parameters. The second way to prompt for user input is to use the built-in Report Engine prompting mechanism. Several of the predefined parameters allow you to specify a question mark (?) as the parameter value. When you specify a question mark, Report Engine automatically prompts the user for input for the parameter.
You can specify a question mark for the RB-PRINT-DESTINATION, RB-PRINTER-NAME, RB-PRINTER-PORT, and RB-INCLUDE-RECORDS parameters.
Prompting for Input with a User-defined Parameter
You can prompt a user for other report information using a user-defined parameter.
In the “User-defined Parameters” section, the example shows how to print the report author’s name at the top of the report. To prompt the user to enter his or her name, follow these steps:
- In the Report Builder, create a calculated field named MYNAME with the following expression:
- Place MYNAME in the title band line.
- When you run the Report Engine, you can:
- Use the Report Engine prompt to prompt the user to enter his or her name using the following code in the RB-OTHER-PARAMETERS parameter:
This causes the Report Engine Parameter dialog box shown below to appear:
![]()
- Customize the prompt using the following code:
The Report Engine Parameters dialog box will appear as shown below:
![]()
When you prompt users for input, the Report Engine Parameter dialog box title bar contains the value of the RB-WINDOW-TITLE parameter. If RB-WINDOW-TITLE is empty or UNKNOWN, Report Engine uses the report name as the dialog box title.
You cannot modify the dimensions of the dialog box to accommodate the anticipated user input. The dialog box always remains the same size and users can enter up to 512 characters. If the user chooses the Cancel button, Report Engine does not run the report and writes the “Cancelled” message to the report status file or the RB-STATUS field, depending on the interface and command-line parameters you use. For information about the status file, see the “Verifying Report Status” section of Report Engine Administration."
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |