Bookshelf v7.5.2: Configuring Pop-Up Applets Launched from Applets

Siebel Tools Reference > Special-Purpose Applets and Controls > Pop-Up Windows >

Configuring Pop-Up Applets Launched from Applets

This is the typical scenario in which clicking a button on an applet invokes a pop-up window for editing a set of values, or browsing through a list, and so on.

To configure a pop-up applet

Select the applet from which to launch the pop-up window.

Create a control for the applet.

Set the Method Invoked property of the control to ShowPopup.

Expand the Control object, and then select the Control User Prop object.

Create three control user properties:

Popup. Set to the applet you want to appear. This applet must use a class derived from CSSSWEFramePopup.

Mode. Optional. Mode of the applet, either Base or Edit. If not specified, the default is Base.

NOTE: Edit mode should be used only with applets that are not based on a business component. This mode is for showing a dialog that requires user input. Editing regular applets should be done without opening a pop-up window.

Popup Dimension. Optional. Dimension of the pop-up window. The format is Height X Width, for example 500 X 800. If not specified, the dimensions will default to the value specified in the applet's HTML Popup Dimension property. If that is not specified, the pop-up window dimensions will default to 600 X 600.

Create the pop-up applet.

Add controls to the pop-up applet:

Cancel. Set the Method Invoked property of the control to CloseApplet or UndoRecord. This will close the pop-up applet when Cancel is clicked.

OK. Set the Method Invoked property of the control to CloseApplet to close the applet after you finish processing other calls within your invoked method. This will close the pop-up applet, and then refresh the parent applet in the main browser window.

In Siebel eSales, there is an applet called Product Form Applet (eSales). It is based on the specialized class CSSSWEFrameBuyNow. Although this is noted as CSSFrameBuyNow in the Class property of the applet, the class name includes "SWE." This class is a subclass of CSSSWEFrameBase.

The form applet provides a product name, description, list price, customer price, and quantity. It also has five button controls: Add To Cart (Method Invoked property AddToCart), Add To Favorites (AddToFavoriteList), Add To Template (AddToTemplate), Browse Deals (ShowPopup), and Customize (Customize). All of these controls except Browse Deals invoke their methods without activating a pop-up applet and therefore have no user properties.

The Browse Deals button launches a read-only pop-up applet called CPG Deal List Applet for Catalog Products, as specified in the Popup user property. It opens in Base mode (as specified in the Mode user property) because there is no editing, only scrolling through the displayed information and selecting a promotion. The Popup Dimension property is inactive, so the dimensions by default are 600 X 600.

The ShowPopup method (defined in CSSSWEFrame) opens the pop-up applet, using the applet name in the Popup user property. This is the standard way to open a pop-up from an applet.

The pop-up applet is a list applet with a Query button above the list and Add and Close buttons below the list. The Add button has a Method Invoked property of SelectPromotion; the Close button has a Method Invoked property of CloseApplet; and the Query button has a Method Invoked property of NewQuery.