Siebel Developer's Reference > Siebel Web Engine Tags > Applet Tags >

Control Tag


The control tag provides a placeholder in an applet Web template for a control or list column. It uses the following format:

<swe:control id="1" property="property_name" />

where:

  • id. Maps a child applet, control, or list column to this placeholder tag.
  • property. Optional. If you include this attribute, then it identifies the property of the control or list item that SWE displays on the Web page.

You can use this tag only in an applet Web template of type Base, Edit, New, or Query.

You cannot nest the control tag. For example, SWE does not support following usage:

<swe:control id = "1"> <!-- the "parent" control
<swe:this property = "displayname"/>
<swe:this property = "formattedHtml"/>
<swe:control id = "2" property="formattedHtml">
<!-- A child control gets context or gets properties from its "parent">
</swe:control>         <!-- End of parent -->

Defining the Property Attribute of the Control Tag

Table 37 describes the values that you can use for the property attribute. You can use this attribute only in a singleton tag. A singleton tag is a tag that does not include a required end tag.

If you do not include this attribute, then:

  • This tag displays the body only if the ID attribute maps the control ID.
  • You can use the following tag to display this user property in the body of the control tag:

    this

Table 37. Values You Can Use for the Property Attribute
Value
Description

FormattedHtml

Displays the data for a control or list item in HTML.

DisplayName

Displays the caption property of the control or list item.

ListHeader

Displays a column header for a list column that includes links that the user can use to sort the column. You can use this value only with a control tag that Siebel CRM maps to a list column that resides in the Base template of a list applet.

RequiredIndicator

Displays an icon if the control is required. For example, assume the user must enter a value for the control before Siebel CRM can save the record to the database. The RequiredIndicator parameter that resides in the SWE section of the application configuration file identifies this icon.

Siebel Developer's Reference Copyright © 2013, Oracle and/or its affiliates. All rights reserved. Legal Notices.