Configuring Siebel Business Applications > Configuring Applets > Configuring an Applet in Standard Interactivity >

Allowing the User to Choose Multiple Rows in Standard Interactivity

A multiselect list applet is a type of applet that allows the user to choose multiple records for a transaction in the following ways:

• Use the check boxes in the left column to choose the items.
• Use the Select All button to choose all available records in the list.
• Use the Select action button to choose all of the records that are chosen for inclusion in the selection.

Siebel CRM supports the multiselect list applet in standard interactivity. If Siebel CRM runs in high interactivity, then multirow selection is available in all list applets where Siebel CRM uses the swe:list tag, except for pick applets. In a pick applet, the user can use the Control and Shift keys to choose multiple rows, as in a typical Windows application. For more information, see About Standard Interactivity and High Interactivity.

Siebel CRM does not enable multirecord selection for list applets, by default.

For more information, see About List Applet Templates.

To allow the user to choose multiple rows in standard interactivity

1. Make sure you understand how to modify code of the list applet template.

   For more information, see About List Applet Templates.

2. In Siebel Tools, in the Object Explorer, click Applet.
3. In the Applets list, locate the list applet you must modify.
4. In the Object Explorer, expand the Applet tree, and then click List.
5. In the Lists list, make sure the HTML Multi Row Select property of the List object contains a check mark.
6. Modify the following swe:select-row tag of the list applet template that the multiselect list applet references:

   <swe:select-row property="FormattedHtml" />

   or

   <swe:select-row>
   <swe:this property="FormattedHtml" />
   </swe:select-row>

   Siebel CRM uses the swe:select-row tag to display the check boxes that the user clicks to choose multiple rows. If you configure the applet for multirecord selection in Siebel Tools, then note the following:

   • If you set the property attribute in the swe:select-row tag or in the swe:this tag to FormattedHtml, then Siebel CRM displays the check boxes.
   • If you use the swe:select-row tag without the property attribute, then the tag acts as a conditional tag that displays only the body of the tag.

     For more information, see About List Applet Templates.

7. Reference the controls and list columns for the list applet in the swe:form tag of the list applet template.

   Any invoke method on the applet requires the form tag that contains the row selection check boxes. If the user chooses multiple records, then Siebel CRM does not call the Siebel Server. If the user chooses multiple records, then Siebel CRM does not disable controls that do not support calling methods. If the control is activated, and if the form tag does not contain the check boxes, then Siebel CRM displays a message that it cannot perform the action if multiple records are chosen.

8. Optional. Modify the list applet template to supports all list applets.

   For more information, see Modify the List Applet Template to Support All List Applets.

Modify the List Applet Template to Support All List Applets

You can use the swe:select-row tag of the list applet template to create a list applet template that you can use with list applets that support multirecord selection and with list applets that do not support multirecord selection.

To modify the list applet template to support all list applets

1. In the list header, use the swe:select-row tag conditionally to put in a td tag for the header for the row selection check box column.
2. In the list body, use the swe:select-row tag with the swe:this tag conditionally to put in a td tag that contains the check box.

Comparison of the Multiselect List Applet to the PositionOnRow Control

The Siebel Web Engine calls methods that act on the multiple records that the user chooses in a list applet. Check boxes on each row allow the user to choose rows. This configuration is different from using the PositionOnRow control to choose the current record. You can use the PositionOnRow control and allow the user to choose multiple rows on the same list applet.

The first time the user navigates to a list applet, Siebel CRM selects the record where the business component is positioned. The user can use the check box to deselect this record. Unlike PositionOnRow, if the user uses the check boxes to choose multiple rows, then no round trip to the Siebel Server occurs. Siebel CRM only marks the chosen records on the business component when it calls a method on the applet. The user can use the Next and Previous controls to choose records from different working sets or records that Siebel CRM displays across multiple pages.