Product Administration Guide > Attributes with Business Component Domains >

Setting Up Multiple Fields for Display

You can group attributes together so that selecting a record from a pick applet for one attribute populates several attributes. You do this by defining additional PickMap UI properties on an attribute. These additional UI properties define how to populate the other attributes.

The attribute on which you define PickMap01 is called the primary attribute. The user selects a value for this attribute and this causes the values for the other attributes to be selected automatically. This means the other attributes are read-only. The only way the user can change the value of these attributes is to open the pick applet for the primary attribute and choose another record.

The Product Administrator has created a customizable product called Premier Service Package. This product has been assigned to a product class that has the attributes Account, Location, and Opportunity defined on it. These attributes have been added to a group in the Product UI Designer and will display in selection pages.

The Product Administrator wants users to be able to select an account name when configuring the product. When they do, the Account Administrator wants to automatically populate the Location attribute with the state in which the account is located.

To do this, the Product Administrator must define the following UI properties on the Account attribute:

• PickList. Its value is PickList Account.
• PickApplet. Its value is Account Pick Applet.
• PickMap01. This UI property provides the name of the attribute and the business component field. Its value is an XML tag that has the following elements:
  • Field = "Account". This is the attribute name.
  • PickField = "Name". This is the business component field.
• PickMap02. This UI property defines an attribute that will receive its value automatically when the user selects a value for the primary attribute. In this case, the attribute is Location. The value of the UI property is an XML tag that has the following elements:
  • Field = "Location". This is the attribute name.
  • PickField = "State". This is the business component field.

The Account and Location attributes display with a text box next to them in the configuration selection pages. When the user clicks the select button and chooses an Account name, it is transferred to the Account field and the state name is transferred to the Location field.

Table 14 shows how to use the predefined UI properties to set up multiple fields for display.

To set up multiple fields for display

1. Navigate to Product Administration.
2. Select and lock the desired customizable product.
3. Navigate to Customizable Product > User Interface Property Designer.
4. Select the desired attribute.
5. Define the UI properties as shown in Table 14.