Siebel CRM Desktop for Microsoft Outlook Administration Guide > XML Files Reference > XML Code to Customize Forms >

Control Tag of the forms_xx.xml File

The control tag defines a control that is located in a cell. It includes the following attributes:

• id. Defines the control ID. If you use the id attribute to specify the ID of a native Microsoft Outlook control, then Siebel CRM Desktop requires no more attributes except tab_order, if necessary. The class attribute defines the control type.
• tab_order. Defines the tab order of the control. Siebel CRM Desktop displays the control that contains the smallest tab_order value as the first control in the tab order. You can start at 1. If the control contains no tab_order, then Siebel CRM Desktop does not include the control in the tab order.
• class. Defines the type of the control. Depending on the value of the class attribute, you must define more attributes and tags. For more information, see Types of Controls for the Control Tag of the forms_xx.xml File.
• allow_negative. For multi_currency control only.
• caption. For list control only.
• type. For Microsoft Outlook_view control only.
• view_id. For Microsoft Outlook_view control only.

The following controls support the control tag:

• button
• check box
• gradient_checkbox

The control tag includes the following tags. These tags depend on the value that is set for the class attribute of the parent control tag:

• source. Used for multivalue controls, such as combobox, lookup, and mvg_primary_selector. It defines the objects that Siebel CRM Desktop displays in this control. It includes the following attributes:
  • type. Defines a type of an object that Siebel CRM Desktop displays in the current control. Objects of this type must be described in the basic_mapping.xml file.
  • display_format. Defines what object fields Siebel CRM Desktop displays in a control. Used for the mvg_primary_selector control only.
  • format. The same as the display_format tag, but applied to other controls.
  • field. Defines what object field is chosen as a value in a combobox. Used for the combobox control only.
  • left_id. Defines a field on a related object where Siebel CRM Desktop stores the ID of the parent object. This is the ID of the current object on which the left_id control is used. Used for the mvg_primary_selector control only.
  • item_value. Defines a field on a related object where Siebel CRM Desktop stores the ID of the parent object. This is the ID of the chosen object. Used for the mvg_primary_selector control only.
• text. Defines the text that Siebel CRM Desktop uses for the control. You use this tag primarily for the label control.
• field. Contains the field identifier with which this control works:
  • This field tag must be described in the siebel_basic_mapping.xml file.
  • Contains one attribute, value, which Siebel CRM Desktop uses for edit controls only. This attribute describes the type of the value for the field.
  • The following values are available: string, binary, int, double, or currency.
  • The API name field is an example of a field identifier.

Example Code of the Control Tag

The following code is an example of the control tag:

<cell>

<control id="0x10000" class="edit">

<field value="string"> Name</field>

</control>

</cell>