Bookshelf v7.5.3: About the UI Properties

You can define an attribute that has values the user can select from a pick applet. The pick applet displays records from a specified business component. When the user selects a record, a specified field in the record displays in the selection page as the value of the attribute.

Several predefined UI properties are provided to associate the attribute with a pick applet and pick business component. Defining these UI properties on the attribute replaces the Siebel Tools procedures for configuring the originating business component when defining a pick applet.

You define these UI properties on the attribute that you have set up to display a select button in the selection pages. These UI properties associate the attribute with a pick applet and a pick business component and are shown in Table 12.

Table 12. Predefined UI Properties
Name	Value
PickApplet	The name of the pick applet.
PickList	The name of the pick business component.
PickMap01	This is an XML tag that associates the attribute name with the pick business component field that you want to display.
PickMapnn	PickMap02 and so on, display multiple fields from the same pick business component. You can also use this PickMap definition to define a constraint on the records the user sees in the pick applet.

<PickMap Field="AttributeName" PickField="BusCompFieldname" Constrain="Y/N" BusObj="BusObjName" />

Field. For UI properties with name PickMap01, this specifies the name of the attribute in the selection page. Use the attribute name, not its display name.

For UI properties with Constrain="Y", specifies the business component field name or attribute name to be used as a filter for the records displayed in the pick applet. The format for specifying a business component is buscompname.fieldname. The format for specifying an attribute name is attributename.

For example, to constrain the records displayed in the pick applet to those having the current record's Opportunity name in the Quotes view, (Quote business component), you would enter Quote.Opportunity. To constrain records to the value of the Account Name attribute, you would enter Account Name.

PickField. Specifies the pick business component field name. When the user selects a record from the pick applet, the contents of this field becomes the attribute value shown in the selection page. Use the business component field name, not the field's display name.

Constrain. When set to "Y" (Yes), PickMap specifies a business component field that filters the records the user sees in the pick applet. If not specified, the default is "N" (No).

BusObj. Specifies the business object in which the PickMap definition is active. If omitted, the PickMap definition is active in all business objects. For example, if you set BusObj="Order Entry", the PickMap applies to orders but not quotes. Use this argument to constrain the pick applet differently for orders than for quotes. If you insert a BusObj argument in PickMap01, this limits the display of the select icon and pick applet to the specified business object, for example Quote.