4 How to Control Form Layout

Create the HT_EMP Table

To create the HT_EMP table and the appropriate associated objects:

1. Click SQL Workshop on the Workspace home page.

2. Under SQL Scripts, click Scripts.

3. When the Script Repository appears, click Create.

4. In the Create Script Wizard:

   1. For Script Name, enter HT_EMP and click Next.

   2. In Script, enter the following DDL:

      CREATE TABLE ht_emp (
         emp_id                 NUMBER       primary key,
         emp_first_name         VARCHAR2(30) not null,
         emp_middle_initial     VARCHAR2(1),
         emp_last_name          VARCHAR2(45) not null,
         emp_part_or_full_time  VARCHAR2(1)  not null check (emp_part_or_full_time in ('P','F')),
         emp_salary             NUMBER,
         emp_dept               VARCHAR2(20) check (emp_dept in ('SALES','ACCOUNTING',
      
      'MANUFACTURING','HR')), 
         emp_hiredate           DATE,
         emp_manager            NUMBER       references ht_emp,
         emp_special_info       VARCHAR2(2000),
         emp_telecommute        VARCHAR2(1) check (emp_telecommute in ('Y')),
         rec_create_date        DATE         not null,
         rec_update_date        date)
      /
       
      INSERT INTO ht_emp
         (emp_id, emp_first_name, emp_middle_initial, emp_last_name, emp_part_or_full_time, 
          emp_salary, emp_dept, emp_hiredate, emp_manager, emp_special_info, emp_telecommute,
          rec_create_date)
      VALUES
         (1,'Scott','R','Tiger','F',
          100000,'SALES',sysdate,null,'cell phone number is xxx.xxx.xxxx
      home phone is yyy.yyy.yyyy','Y',
          SYSDATE)
      /
       
      CREATE SEQUENCE ht_emp_seq
         start with 2
      /
       
      CREATE OR REPLACE TRIGGER bi_ht_emp
            BEFORE INSERT ON ht_emp
            FOR EACH ROW
         BEGIN
            SELECT ht_emp_seq.nextval
              INTO :new.emp_id
              FROM DUAL;
            :new.rec_create_date := SYSDATE;
         END;
      /
       
      CREATE OR REPLACE TRIGGER bu_ht_emp
            BEFORE UPDATE ON ht_emp
            FOR EACH ROW
         BEGIN
            :new.rec_update_date := SYSDATE;
         END;
      /
      
      

   3. Click Create Script.

      The script appears in the Script Repository.

5. Run the HT_EMP script:

   1. In the Script Repository, click Run in the Actions column adjacent to the HT_EMP script.

   2. From Parse As, select the schema owner that was initially provisioned with your workspace.

   3. Click Run Script.

      Red text indicates errors while executing the file.

Create a New Page Containing a Input Form

Next, create a new form using the Form on a Table or View Wizard.

To create a data input form:

1. Navigate to the Workspace home page.

2. From the Available Applications list, select Sample Application.

3. Click Create Page.

4. On Create New Page, select Page with Component and click Next.

5. On Select Component Type, select Form and click Next.

6. On Create Page, select Form on a Table or View and click Next.

7. For Table/View Owner, select the schema owner used to create the HT_EMP table and click Next.

8. For Table/View Name, select the HT_EMP table and click Next.

9. On Identify Page and Region Attributes:

   1. For Page, enter 900.

   2. For the Page Name, enter HT_EMP.

   3. For the Region Name, enter How to Layout a Form.

   4. Click Next.

10. On Identify Tab, accept the default Do not use tabs and click Next.

11. On Identify Primary Key, accept the default and click Next.

    Note that the wizard reads the primary key from the database definition.

12. On Primary Key Default, accept the default Existing Trigger and click Next.

13. On Identify Columns to Include, select all columns and click Next.

14. On Identify Process Options, accept the defaults and click Next.

15. On Identify Branching, set all branching to the page 900 (the page you are creating) and click Next.

    Since this page is just for demonstration, you will not be utilizing branching.

16. Click Finish.

17. View the Page Definition by clicking Edit Page.

    The Page Definition for page 900 appears.

18. Delete the following validation:

    • Under Page Processing Validations, select P900_REC_CREATE_DATE not null.

    • Click Delete.

Run the Page

Once you create the HT_EMP table and page 900, the next step is to run the page.

To run the page from the Page Definition:

1. Click the Run Page icon in the upper right corner.

2. If prompted to enter a username and password:

   1. For User Name, enter either demo or admin.

   2. For Password, enter the name of the current workspace using all lowercase letters.

   3. Click Login.

   4. Navigate to page 900:

      • Select Edit Page from the Developer Toolbar.

      • In Page, enter 900 and click Go.

   5. On the Page Definition for page 900, click the Run Page icon in the upper right corner.

As shown in Figure 4-1, note that the HT Emp form contains basic employee details and includes select lists, text areas, and display only items.

Figure 4-1 HT_EMP Form

Description of the illustration frm_htemp.gif

By default, the Primary Key column does not display since it is assumed that the primary key is system generated. In reality, the primary key is included in the page, but appears as a hidden item.

Notice that the page defaults with one item for each row and labels display to the left of the items. The item labels default to the column names with initial capitalization and with the underscores (_) replaced with spaces. You can override this default behavior by configuring user interface defaults for the table.

Also notice that items based on date columns default to include a date picker. Lastly, notice that the Emp Special Info item was created as a text area because of the size of the base column. This item type is a better choice for large text items since it allows for wrapping of input text.

Edit Item Attributes

To edit item attributes:

1. Navigate to the Page Definition for page 900.

2. On the Page Definition, select the title Items.

   The Page Items summary page appears.

   You change how a page appears by editing the item attributes. Common item attribute changes include:

   • Changing item labels by editing the Prompt field.

   • Placing more than one item in certain rows to group like items together. For example, you could group all items that make up an employee's name.

   • Changing the item width. Many items display better when they have a width that is less than the maximum. To change the item width, enter a new value in the Width field.

   • Reordering the items. The initial order of items is based on the order of the columns in the table on which the region is based. You can reorder items by changing the sequence. You can reorder items by entering a new value in the Sequence field.

3. To see the how item attributes affect page layout, make the following changes:

   1. Change the values in the Prompt, New Line, and Width fields to match those in Table 4-1:

      Table 4-1 New Prompt, New Line, and Width Field Values

      Prompt Field	New Line	Width
      Emp ID	Yes	30
      First Name	Yes	15
      Middle Initial	No	2
      Last Name	No	15
      Part or Full Time	Yes	2
      Salary	Yes	10
      Department	Yes	15
      Hire Date	Yes	10
      Manager	No	15
      Special Information	Yes	60
      Telecommute	Yes	2
      Record Create Date	Yes	10
      Record Update Date	Yes	10

      
      

   2. Click Apply Changes.

   3. Click the Run Page icon. (See Figure 4-3.)

      Figure 4-3 HT_EMP After Editing the Prompt, New Line, Width Attributes

      
      Description of the illustration frm_chg_item.gif
      
      

   Note that some items are pushed too far to the right. This display is caused by the width of the Special Information item. Oracle HTML DB lays out regions as tables and of a width of each column is determined by the largest display width of the items in that column.

Fix Item Alignment

There are several approaches to fixing item alignment:

• For the items Middle Initial, Last Name and Manager items, set New Field to equal No.

  This places the items directly after the items they follow, but in the same column. This approach is best used for positioning embedded buttons next to items. Note that this setting can make text items appear squashed.

• Change the Column Span field of the Special Information item.

  For example, setting the Column Span for the Special Information item to 5 would enable multiple items to display above and below it. This change causes five items to display above Special Information (First Name, Middle Initial, and Last Name).

  Be aware, however, that using Column Span to fix the display of the name does not result in a consistent layout. The Manager item would still be in the same column as Middle Initial. Because the Manager item is larger than Middle Initial, Last Name would still be pushed too far to the right. To fix this, you could change the Column Span of the Manager item to 3 so it displays above Special Information.

• Reset the column width in the middle of the region by adding an item of type Stop and Start HTML Table. This forces the close of an HTML table using the </table> tag and starts a new HTML table. Inserting a Stop and Start HTML Table item just after the Last Name item, results in an even layout. Note that a Stop and Start HTML Table item only displays its label. You can prevent the label from displaying at all by setting it to null. To do this, you simply remove the defaulted label.

To add a Stop and Start HTML Table item and reset the column width:

1. Navigate to the Page Definition for page 900.

2. Under Items, click the Create icon.

3. From the Tasks list, select Create "stop and start" HTML table control.

   The Create Page Item wizard appears.

4. On Identify Item Name and Display Position:

   1. In Sequence, enter 4.5.

   2. From Region, select Employee Info.

   3. Click Next.

5. On Identify Item Attributes:

   1. For Label, remove X.

   2. Accept all other defaults and click Next.

6. Click Create Item.

   The Page Definition appears.

7. Click the title Items.

8. For Special Information, change the Column Span to 3 and click Apply Changes.

9. Click the Run Page icon.

Change Label Placement

Item labels can display above, below, or to the left of an item. Labels can display left, right, or center justified. For labels set to left, you can further specify the vertical alignment options of top, bottom or center. Change the position of the Special Information label to above the item.

To change the placement of the Special Information label:

1. Navigate to the Page Definition for page 900.

2. Under Items, select the name of item P900_EMP_SPECIAL_INFO.

3. Scroll down to Label.

4. From the Horizontal/Vertical Alignment list, select Above.

5. Click Apply Changes.

Change Items to Display-only

There are two columns in the HT_EMP table for auditing, Record Create Date and Record Update Date. Because the values of these columns are set with triggers, these columns should not be updatable by users. This exercise describes how to make items display-only and then how to add them to their own region.

To make an item P900_REC_CREATE_DATE display-only:

1. Navigate to the Page Definition for page 900.

2. Under Items, select the item P900_REC_CREATE_DATE.

3. Under Display As, select Text Field (Disabled, saves state).

4. Click Apply Changes.

To make an item P900_REC_UPDATE_DATE display-only:

1. Navigate to the Page Definition for page 900.

2. Under Items, select the item P900_REC_UPDATE_DATE.

3. Under Display As, select Text Field (Disabled, saves state).

4. Click Apply Changes.

Next, create a new region and then move the audit items into that region.

To create a new region:

1. Navigate to the Page Definition for page 900.

2. Under Regions, click the Create icon.

3. On Identify Region Type, select HTML and click Next.

4. On Region Type, select HTML and click Next.

5. For the Title, enter Audit Information and click Next.

6. Click Create Region.

To move the items to the new region:

1. Navigate to the Page Definition for page 900.

2. Select the heading Items.

   A summary page appears.

3. For P900_REC_CREATE_DATE and P900_REC_UPDATE_DATE:

   1. Under Prompt, add a colon to the end of the label name.

   2. Under Region, select Audit Information.

   3. Click Apply Changes.

Figure 4-4 demonstrates how these items would display in a running page.

Figure 4-4 Audit Information Region

Description of the illustration frm_audit.gif

The Hide/Show Region template enables the user to click a plus (+) sign to expand the contents of the region or click a minus (-) sign to hide the contents. By changing the region template to Hide/Show Region, users can decide whether they wish to see the Audit Information region.

To change the region template to Hide/Show Region:

1. Navigate to the Page Definition for page 900.

2. Under Regions, select Audit Information.

3. Under User Interface Attributes, select Hide and Show Region from the Template list.

4. Click Apply Changes.

Change an Item to a Radio Group

Because the Part or Full-time item only has two valid choices, this item is a good candidate for either a check box or a radio group.

To change the Part or Full-time item to a radio group:

1. Navigate to the Page Definition.

2. Under Items, select P900_EMP_PART_OR_FULL_TIME.

3. From Display As, select Radiogroup.

4. For Label, remove the label text. (It will be redundant.)

5. Under List of Values, create a static list of values:

   • From Named LOV, select Select Named LOV

   • In List of values definition, enter:

     STATIC:Full-time;F,Part-time;P
     
     

   This definition will display as two radio buttons with the labels Full-time and Part-time, but the value that being inserted into the database will be either F or P.

6. Click Apply Changes.

7. Run the page. (See Figure 4-7.)

Figure 4-7 Part or Full-time item Changed to a Radio Group

Description of the illustration frm_radio.gif

Notice that Full-time and Part-time displays as radio group that is stacked in one column. You can have these button display side by side.

To display the Full-time and Part-time radio buttons display side by side:

1. Navigate to the Page Definition for page 900.

2. Under Items, select P900_EMP_PART_OR_FULL_TIME.

3. Scroll down to Lists of Values.

4. Set Columns to 2.

5. Click Apply Changes.

By changing this setting to match the number of valid values (that is, Full-time and Part-time), the values display side by side.

Change an Item to a Select List

In the DDL you used to create the HT_EMP table, Department is validated by a check constraint. You can implement Department as a radio group, a select list, or a Popup LOV.

To change Department to a select list:

1. Navigate to the Page Definition for page 900.

2. Under Items, select P900_EMP_DEPT.

3. From Display As, select Select List.

   The other Select List choices are for either redirecting the user to another page or URL based on the selection, or submitting the current page which is used when other information needs to be retrieved based upon the selection in the Select List.

4. Under Lists of Values, create a static list of values:

   1. From Named LOV, select Select Named LOV

   2. In List of values definition, enter:

      STATIC:SALES,ACCOUNTING,MANUFACTURING,HR
      
      

   3. From Display Null, select Yes.

   4. In Null display value, enter:

      - No Assignment -
      
      

      The last two selections take into account that the EMP_DEPT column can contain nulls. As a best practice, whenever you implement a select list and have a column that can be null, you should set Display Null to Yes. Failure to do so, results in the item defaulting to the first item in the select list.

5. Click Apply Changes.

6. Run the page. (See Figure 4-8.)

Figure 4-8 Department Changed to a Select List

Description of the illustration frm_sel_list.gif

Change an Item to a Check Box

The item Telecommute is ideal for a check box. When you change the Display Type, you can also move it up on the page and place is next to the Full-time and Part-time radio group.

To change Telcommute to a check box:

1. Navigate to the Page Definition for page 900.

2. Under Items, select P900_EMP_TELECOMMUTE.

3. From Display As, select Checkbox.

4. Under Displayed:

   1. In Sequence, enter 5.5.

   2. From Begin on New Line, select No

5. Scroll down to List of Values.

6. To have the label precede the check box:

   1. From Named LOV, select Select Named LOV

   2. In List of values definition, enter:

      STATIC:;Y
      
      

      This displays the check box after the label, but will not display a value associated with the check box. If the check box is checked, the value passed to the database will be Y.

7. Click Apply Changes.

8. Run the page.