Bookshelf Home | Contents | Index | PDF |
Siebel Developer's Reference > SWE Tags > swe:select-rowMultiselect list applets provide a way to select multiple items for a transaction. The check boxes in the left column are used to select the items. SWE supports selection of multiple records in list applets for invoking methods that act on these selected records. The selection of rows is done using check boxes that are placed on each row. This is different from positioning the current record using the PositionOnRow control. You can have both the PositionOnRow control and Multiple Row Selection on the same list applet. When you initially navigate to a list applet, the record on which the business component is positioned is automatically selected. Users can unselect this record using the check box if desired. Unlike PositionOnRow, when you select rows using the check box there is no server round trip. The selected records are marked as selected on the business component only when a method is invoked on the applet. You can select records across multiple pages (that is, you can navigate using the Next and Previous controls and select records from different working sets). By default, multirecord selection is not enabled for list applets. To enable multirecord selection on a list applet, in Siebel Tools set to TRUE the HTML Multi Row Select attribute of the applet's List object. To render the check boxes to select multiple rows in list applet templates, use the NOTE: You need to place your list applet controls and list columns within a The HTML Client framework marks the records as selected in the buscomp when a method is invoked on the applet. This happens in CSSSWEFrame::PrepareToInvokeMethod before the CSSSWEFrame::DoInvokeMethod is called. The sequence of events when the framework gets a command to invoke a method on an applet are:
Currently none of the methods in the base CSSSWEFrame support multiple records. This may change in the future. If any specialized applet needs to support this feature, the DoInvokeMethod should be specialized. In this method you can call CSSSWEFrame::IsMultiRecSelected to check if multiple records are selected. If TRUE, you can call CSSBusComp::EnumAllSelections to get all the records that are currently selected in the buscomp. Controls that do not support invoking methods when multiple records are selected are not disabled. This is because there is no server call when selecting multiple records. Instead, when the control is activated the user gets a message that the action cannot be performed when multiple records are selected. SyntaxTo render the check boxes to select multiple rows in list applet templates a new tag, <swe:select-row property="FormattedHtml" /> AttributesProperty. When the property attribute is set to FormattedHtml in either the Example
|
Siebel Developer's Reference |