Siebel Consumer Goods Handheld Guide > Developing Siebel Handheld Applications > Configuring User Interface Elements in the Siebel Handheld Client     >

Configuring Form Applets for the Siebel Handheld Client

The Siebel Handheld application uses a specialized algorithm to format and display form applets. Due to the display limitations on the device, only one pair of label and field controls are displayed on each row of the form, regardless of the layout shown within Siebel Tools.

Layout Sequence

When configuring form applets for the Siebel Handheld application, the Applet Web Template Items in the Applet Web Template determine the controls that appear on a form applet. The layout of form applets on the Handheld application is determined by the HTML Sequence field set on control objects.

The HTML Sequence field determines the screen layout of a Handheld application. Controls are ordered from top-to-bottom based on their HTML Sequence property values. Label and control pairs that do not fit on the same line as other label and control pairs wrap to the next line.

Labels

Keep field labels in applications short (approximately 12 characters or fewer, depending on the character width). Use abbreviations where possible. Labels that are too long are truncated.

Group Boxes

Group boxes are not supported and are not displayed in form applets, even if they are added in the Web Applet Designer. Therefore, reword the field labels to include group box information if necessary. For example, you can have two group boxes on the form, one labeled Ship To and another labeled Bill To. Each group box includes a field named Address. Because group boxes are not supported, the Ship To and Bill To labels are lost, and two fields with the identical Address label remain. Therefore, you must rename the Address labels "Ship To Addr" and "Bill To Addr" or some other label that distinguishes them.

Radio Buttons

You can configure any static or dynamic picklist control in form applets to display as a set of radio buttons, instead of as a normal picklist. To do this, you must set field type to DT_RADIO.