Bookshelf v7.5.2: Configuring Views for Layout Control

Siebel Tools Reference > Logical User Interface Objects Configuration > Defining Views >

Configuring Views for Layout Control

Certain views in Siebel applications, such as home page views, allow the user to control the layout of the view. For example, these views allow the user to:

Reorder applets

Collapse or expand applets

Show or hide applets

See the Customizing Your Home Page section in Fundamentals for a description of this feature from the end-user perspective.

The user can edit view layout in two modes. Show mode and Edit Layout mode.

Show mode. Allows users to move, collapse and expand, show and hide individual applets within the view, using controls placed at the top of each applet on the view. For example, home page views are displayed in Show mode until a user clicks the Edit Layout button.

Edit Layout mode. Allows users to move, expand and collapse, show and hide, individual applets, plus perform the following operations on all applets within the view: show all applets, hide all applets, minimize all applets, maximize all applets, and reset the default layout definition. This mode is presented to the user using a separate applet called the Layout Controls applet and appears after the user clicks the Edit Layout button.

To configure a view to support personal layout control

Set the User Layout property of the View's View Web Template object to TRUE.

Define the default layout of the view by setting the following properties of the View Web Template Items associated with the view.

Display Size. Determines whether the applet is minimized or maximized. Always Maximized indicates that the applet cannot be minimized by the end user.

NOTE: Minimized and maximized are referred to as collapse and expand in the client user interface.

Display Visibility. Determines whether the applet is shown or hidden. Always Show indicates that the applet cannot be hidden by the end user.

Move Range. Defines a range in which the applet may be moved. For example, on an application home page with two columns, applets would specify a move range of either Column1 or Column2. Any applet with a move range of Column1 is movable only within the first (left) column. Any applet with a move range of Column2 is movable only within the second (right) column.

If this property is not defined, the applet cannot be moved by the end-user. The applet location is fixed within the view. For example, the salutation applet on the home page would typically not have move range specified for it.

Add the Layout Controls Applet to the view, add a corresponding View Web Template Item, and map the applet to a placeholder in the Web Template.

There is an applet in the Siebel repository called Layout Controls applet. Add this applet to the view that you want to enable for personal layout control. It serves as a container for the controls that handle view-level operations, such as Reset Default Layout. In Show Mode, this applet appears as the Edit Layout button. In Edit Layout mode, which appears after the user clicks the Edit Layout button, this applet shows all applets on the view, and allows the user to Hide All Applets, Show All Applets, Reset Default Layout, and return to Show mode by clicking Done.

Add the following view layout controls to applets within personalized views, add corresponding Applet Web Template Items, and map the controls to the appropriate placeholders in the Web template.

ButtonMoveAppletUp

ButtonMoveAppletDown

ButtonHideApplet

ButtonShowApplet

ButtonMinimizeApplet

ButtonMaximizeApplet

These view layout controls use Invoke Methods to manipulate the user's view layout preferences.