Configuring Siebel Business Applications > Configuring Views, Screens, and Applications > Configuring a View >

Controlling How the User Can Modify View Layout

Some views in Siebel CRM, such as the home page view, allow the user to modify the layout of the view. For example, the user can do the following in some views:

• Reorder applets
• Collapse or expand applets
• Show or hide applets

For more information, see Siebel Fundamentals.

To control how the user can modify view layout

1. In Siebel Tools, click View in the Object Explorer.
2. In the Views list, locate the view you must modify.
3. In the Object Explorer, expand the View tree, and then click View Web Template.
4. In the View Web Templates list, set the User Layout property to TRUE.
5. In the Object Explorer, expand the View Web Template tree, and then click View Web Template Item.
6. In the View Web Template Items list, set properties using values from the following table.

   Property	Description
   Display Size	Determines if Siebel CRM minimizes or maximizes the applet. If you set Display Size to Always Maximized, then the user cannot minimize the applet.
   Display Visibility	Determines if Siebel CRM displays or hides the applet. If you set Display Visibility to Always Show, then the user cannot hide the applet.
   Move Range	Defines the range where the user can move the applet. For example, on an application home page that contains two columns, applets require a move range of Column1 or Column2. Any applet with a move range of Column1 is movable only in the left-side column. Any applet with a move range of Column2 is movable only in the right-side column. If this property is not defined, then the user cannot move the applet. Siebel CRM fixes the location of an applet in the view. For example, a move range is typically defined for the salutation applet on the home page.

   This step defines the default layout of the view.

7. In the View Web Template Items list, add the layout control applet to the view:
   • If the view includes a standard interactivity (SI) applet, then add the Layout Controls SI Applet.
   • If the view does not include a standard interactivity applet, then add the Layout Controls Applet.

     For more information, see How the Layout Control Applet Works.

8. Map the layout control applet to a placeholder in the web template.
9. Add the following controls to the appropriate applet in the view:
   • ButtonMoveAppletUp
   • ButtonMoveAppletDown
   • ButtonHideApplet
   • ButtonShowApplet
   • ButtonMinimizeApplet
   • ButtonMaximizeApplet

     These view layout controls use invoke methods to manipulate the user preferences of the view layout.

10. For each control you added in Step 9, add a corresponding applet web template item, and then map the control to the appropriate placeholder in the web template.

    For more information, see Properties of the Applet Web Template Item.

11. Compile and test your modifications.

    For more information, see Using Siebel Tools.

How the Layout Control Applet Works

The layout control applet works as a container for the controls that handle operations that occur in the view, such as Reset Default Layout. The following modes determine how Siebel CRM displays the applet:

• Show Mode. Allows the user to use controls that Siebel CRM displays at the top of each applet to edit the layout. For example, it displays a home page view in Show mode until the user clicks Edit Layout. It displays the layout control applet as the Edit Layout button.
• Edit Layout mode. Provides the user with more edit capabilities than the Show mode. Siebel CRM uses the Layout Controls applet to display the Edit Layout mode. It displays this applet if the user clicks Edit Layout. It displays all applets on the view, and it allows the user to click Done to choose one of the following options:
  • Hide All Applets
  • Show All Applets
  • Reset Default Layout
  • Return to Show mode