The input form

Use this page of the wizard, Design the Input Form, to specify the page properties and the fields for the generated Web input page. This page appears in the wizard if you selected Generate input page on the page Specify the Input and Output Pages for your Web Interaction.

After the input page is generated as a JSP file in your Web project, you can edit the file to make further changes. If you add or delete any fields or iSeries Web components, you need to re-run the Web Interaction wizard to ensure that the iSeries run-time classes are updated to reflect the changes.

The following options appear when you select the Fields tab (below the list of properties).

Option Description
Input parameters Lists the input parameters defined for the Web interaction. By default, all of the parameters in the list are selected for inclusion on the input page. The parameters in the list are:
  • Those defined with usage input, or input & output, on the page Specify the Input and Output Parameters for your iSeries Host Program.
  • All input parameters of the Java bean methods selected on the page Choose the Java bean and Methods to Invoke.

To exclude a parameter from the input page, click the check box next to the parameter name.

Use Move up and Move down to change the order of the parameters on the page.

Select All selects all of the parameters for inclusion on the input page.

Deselect All removes all of the parameters from the input page.

Any changes are reflected in the preview area.

Label The text description for the field that appears on the page.

To change the field description, click on the parameter name in the input parameter list, then click in the value field for the Label property and enter the description. You must press Enter for the change to take effect and to appear in the preview area.

Data type Shows the data type that you specified for the parameter on the page Specify the Input and Output Parameters for your iSeries Host Program.

If you selected Use a Java bean on that page, the data type that appears is for the Java bean method that you selected on the page Choose the Java bean and the Methods to Invoke.

Input Style Default: Text Entry.

To change the input style, click in the value field and open the list of styles. Select one of the following styles in the list: Password, Check Box, Radio Button Group, Hidden, Text Area, Combo Box, or Selection Box.

If you select Radio Button Group, Combo Box, or Selection Box, an Input Choices window opens in which you define the choices available for the input style.

Input Choices The Input Choices window opens when you select Radio Button Group, Combo Box, or Selection Box as the input style. Click New to add a label and a value for each choice you define. Click Enter to complete the definition.

Use the New, Delete, Move up, or Move down buttons to add input choices to the list, to remove input choices from the list, or to rearrange the order of the input choices in the list, respectively.

Size The visible width of the field on the page.

To change the size value, click in the value field and enter a new value. Click again or press Enter to apply the value.

Name in Session Indicates the name of the parameter that identifies the data to be saved in the browser session if Save to Session is set to true.

To change the name, click in the value field and enter a name. Click again or press Enter to apply the value.

Restore from Session Default: false.

Indicates whether or not to retrieve the data that was entered into the field and stored in the browser session from a previous interaction. The session name identifies the saved data in the browser session.

The value can only be set to true if the input parameter is not selected for inclusion on the Web input page.

To change the value to true, click in the value field and select true in the list.

Save to Session Default: false.

Indicates whether or not to save the data that is entered into the field to the browser session. The session name identifies the saved data in the browser session.

To change the value to true, click in the value field and select true in the list.

Get Browser Info Default: false.

Indicates whether or not the host program or the Java bean that is called during the Web interaction can access browser information through an input parameter.

The value can only be set to true if the input parameter is not selected for inclusion on the Web input page.

To change the value to true, click in the value field and select true in the list.

The following options appear when you select the Page tab (below the list of properties).

Option Description
Page Title Default: Input Form

The heading that appears on the input page.

To change the text, click in the value field and enter a new heading. You must press Enter for the change to take effect and to appear in the preview area.

Background Color Default: RGB {248, 247, 205}

To change the color, click in the value field and select the menu button to open the Color Palette. Select a color and click OK. The new background color appears in the preview area.

Title Color Default: RGB {0, 0, 255}

The color of the heading text.

To change the color, click in the value field and select the menu button to open the Color Palette. Select a color and click OK. The new heading color appears in the preview area.

Form Bean Scope

The default value for Form Bean Scope is request. This indicates that the data contained in the form bean is only available for sharing within the context of the Web interaction.

If you change the value to session, the data contained in the form bean is saved to the session and is available for sharing with other Web interactions.