Configuring Siebel eBusiness Applications > Configuring Picklists and Pick Applets > About Dynamic Picklists >

About Pick Applets

Pick applets are invoked by clicking the Select button that appears next to certain fields. Pick applets contain a scrolling list table of available selections in one list column, with the information from related fields in adjacent list columns. The user selects a row in the list table and clicks the OK button to accept the selection. Each row corresponds to a business component record in the pick business component. The pick applet is dismissed, and the user's selection populates the text box or list column cell in the originating applet (the applet from which the pick applet was invoked). The user's selection can also populate other controls or list column cells in the originating applet.

For example, when a user clicks the Select button in the Account field in the Opportunity Form applet, the Pick Account dialog box (pick applet) appears for the selection of an account. When an account has been selected, and the Pick Account dialog box has been dismissed, the Account text box contains the selected account, and the Site text box in the originating applet contains the site that corresponds to the selected account.

Figure 81 shows a detailed definition of the pick applet from Figure 78.

Figure 81.  Pick Applet Details

The pick applet (Applet object type) has the following important property settings:

• Business Component. Pick business component.
• Class. CSSFrameList, indicating that this is a list applet.
• Type. A value of Pick List is entered, to indicate that this is a pick applet. This setting configures the behavior of the dialog box and button controls.
• Title. Name of the pick applet that appears in the title bar.

The pick applet has the following important child object definitions:

• List. List columns are attached to the list.
• List columns (grandchild object definitions). Each displays the contents of one field in the business component.
• Pick Record control. Invokes the PickRecord method when clicked. The PickRecord method locates the pick map child object definitions of the originating field and, from these, determines which fields to update in the originating business component. These fields are updated based on the record selected from the pick business component by the user.
• Web Templates. Define the layout, such as position of list columns and controls, for each of the defined modes.
• Web Template Items. Map list columns and controls to placeholders in the Web template. Web template items exist for each list column and control defined for the applet.