Code That Creates the Custom Field

To create the custom field for the contact method, you add the following code:

<cell size="22">
  <combobox id="cbx_ContactPreferred CommunicationsPicklist">
    <field>Preferred Communications</field>
      <source type="ContactPreferred CommunicationsPicklist" field="Value" 
format=":[:(Label):]">
      </source>
  </combobox>
</cell>

where:

  • Id is an arbitrary, unique value in the form. A picklist must include the cbx prefix.

  • Tab_order determines the order that Siebel CRM Desktop uses to place the cursor in the fields in the form when the user presses the TAB key. The value you enter here must be greater than the value you enter in the Tab_order for the label.

  • Source determines where to get the data.

  • Type identifies the object name. This name is defined in the siebel_basic_mapping.xml file.

  • Field specifies the field that provides the values that the user chooses from the pick list. In this example, the Value field provides these values.

  • <Field> identifies the field name from the object definition that populates the picklist.

  • Format specifies how to display text in the picklist.

The format tag allows you to use a combination of static text and fields in the picklist. It uses the following format:

*any_static_text*:[:(field1_name):]*any_static_text*:[:(field2_name):]*any_static_
text*

You must use the bracket, colon, and parentheses. For example:

Contact :[:(First Name):] :[:(Last Name):] ? Contact: John Smith

For more information, see Adding Custom Fields and Combobox Control of the Forms File.