Configuring Siebel eBusiness Applications > Configuring Applets > About Applet Controls and List Columns >

Text

A text control displays text inside a rectangular box. An example of a text control is Name, shown in Figure 60.

Figure 60.  Sample Figure

Some characteristics of Text controls are as follows:

• A text control allows the entry and editing of text, unless the Text control is read-only (in which case it has a gray background, and displays text which cannot be altered).
• A text control displays data of a particular data type, such as alphanumeric, numeric, date, or currency and will display as drop-down list, picklist, MVG, calculator, or calendar icon depending on the underlying business component field.
• A Select icon is automatically attached to the right edge of a Text control when the MVG Applet property has a nonblank value or the Pop-up Edit property is TRUE. This allows the user to call up a multi-value group applet or a calendar or calculator widget.

  NOTE:  The Runtime property must also be TRUE any time the field is supposed to pop up a Calendar or Calculator type control.

• The Select button is attached to the right edge of a text control when the Pick Applet property has a non-blank value. This allows the user to call up a picklist by clicking the icon.

  Static picklists and pick applets are discussed in About Static Picklists.

NOTE:  Trailing spaces are truncated in data displayed through the Siebel application user interface or through Siebel Tools.

When configuring controls of type Text the consider the following:

• Field. The field in the business component from which the Text control displays data.
• Display Format. A format specification for data displayed by the Text control, used for numeric, date, currency, and similar non-text data types. Used as follows:
  • For DTYPE_NUMBER data, the property can be left blank (indicating that the appearance of numeric values should be as set in the Regional Settings section of the Windows Control Panel) or explicitly specified using 0, #, +, minus sign, comma, and period symbols.
  • For DTYPE_CURRENCY data, the property can be specified explicitly using the same symbols as for DTYPE_NUMBER, plus the dollar sign. The display of currency values can also be controlled using the Scale field in the Currencies view under the Application Administration screen.
  • For DTYPE_DATETIME data, one of the keywords Date, Date Time, Date TimeNoSec, and TimeNoSec may be specified.
  • For DTYPE_DATE data, the property can be left blank (indicating that the appearance of date values should be as set in the Windows Control Panel) or explicitly specified using combinations of M, D, Y, and / symbols.
  • For DTYPE_TIME data, the keyword TimeNoSec can be entered, the property may be left blank (indicating that the appearance of time values should be as set in the Windows Control Panel), or a format mask may be explicitly specified using combinations of H, h, m, s, and : symbols.
  • For DTYPE_PHONE data, the Display Format property is left blank, and the Windows Control Panel setting is used.

    NOTE:  Postal code formatting options are not explicitly provided, and hyphens in a postal code are not supported. Generally, for postal codes you should use the DTYPE_NUMBER data type, and a format mask in the Display Format property consisting of octothorpes and blank spaces, such as ##### #### for U.S. Zip+4 postal codes.

• Read Only. A TRUE/FALSE value. Indicates if the user can edit the value displayed in the text box.

  NOTE:  The Read Only property must be set to FALSE to use the Runtime property to access multi-value groups and pick applets.

• Runtime. This is a TRUE/FALSE value. When the text box control has an MVG Applet or Pick Applet property setting other than blank, a value of TRUE in the Runtime property directs the system to activate an icon or drop-down arrow to the right of the text box. A FALSE value directs the system not to provide the icon or arrow. This makes the multi-value group or pick applet inaccessible.

  NOTE:  A Runtime setting of TRUE, combined with blank MVG Applet and Pick Applet property settings, directs the system to determine from the data type of the underlying field if an icon for a calculator, calendar, or currency pop-up applet should be provided.

• MVG Applet. Identifies the applet to use for the multi-value group dialog box (multi-value group applet). The field for the control must be a multi-value field, and the Runtime property must be set to TRUE.
• Pick Applet. Identifies the applet to use for the picklist dialog box (pick applet). The field for the control must have a picklist specified, and the Runtime property must be set to TRUE.