Associating an EGL record with a Faces JSP

To associate an EGL record with a Faces JSP, do as follows:

1. Open a Faces JSP file in the Page Designer. If you do not have a JSP file open, double-click on the JSP file in the Project Explorer. The JSP file opens in the Page Designer. Click the Design tab to access the Design view.

   Note: You can access the related page handler by right clicking in the Design view (or Source view) and clicking Edit Page Code.

2. From the Window menu, select Show View > Other >Basic > Palette.

3. In the Palette view, click the EGL drawer to display the EGL data object types.

4. Drag Record from the palette to the JSP page. The Select a Record Part dialog is displayed.

5. Select a record from the list.

   If the default values in the dialog are acceptable, you can double-click the record name and continue working on the Insert Control dialog, as described later. If you click the record name once, do as follows on the current dialog:

   1. Specify the field name or accept the default value, which is the record-part name.

   2. If you are not declaring an array of records, accept the radio button for none.

   3. If you are declaring an array of records, select the radio box that indicates the type of array, whether static or dynamic, and type an integer in the Size text box. If you selected static, you are specifying the number of records in the array. If you selected dynamic, you are specifying the maximum number of records that can be in the array.

   4. If you wish to include the fields in the JSP file, select the check box for Add controls to display the EGL element on the Web page and click OK.

   5. If you wish only to declare the record or array in the page handler without including the related fields in the JSP file, clear the check box for Add controls to display the EGL element on the Web page and click OK. You can add the field in the JSP file later by dragging the field from the Page Data view to the JSP.

6. When the Insert Control dialog is displayed, select the radio button that indicates your intended use of the field:
   • For output (Displaying an existing record)

   • For input or output (Updating an existing record)

   • For input (Creating a new record)

   Your choice affects the types of controls that are available.

7. To change the order of fields, use the up and down arrows.

8. If you wish to select only a subset of the listed fields, click None and select the fields of interest. To select all fields instead, click All.

9. Do as follows for each field:
   1. To exclude a field, clear the related check box. To include the field, ensure that the check box is selected.

   2. To change the field label, select the label that is displayed next to the field name, then type the new content.

   3. To select a control type different from the one identified (if possible), select from a list of types.

10. If you click Options, the Options dialog is displayed, and the specific options that are available depend on whether you are using fields for input, for output, or for both. One option in any case is to include or exclude the JSF tag <h:outputLabel> around field labels.

    When you complete your work in the Options dialog, click OK.

11. Click Finish.

Related concepts
Record parts

Related reference
Page Designer support for EGL