Configuring Siebel Business Applications > Configuring Siebel Web Templates and Siebel Tags > Configuring Siebel Web Templates and Siebel Tags >

Displaying Multiple Views on a Page

The Siebel Web Engine can simultaneously display multiple views on a page. These views include the following main view and one or more alternate views:

• Main view. Chosen from the link bar. Only one main view exists.
• Alternate views. Other views that Siebel CRM displays with the main view. For example, the Search View that displays applets that it uses for find and search operations.

You can display multiple views in the following ways:

• Place multiple views in separate HTML frames.
• Share multiple views in the same frame.
• Display multiple views in the main view in the main browser window and display a single alternate view in a pop-up window.

Only the main view can use high interactivity. Siebel CRM displays alternate views in standard interactivity. It is recommended that you define alternate views as simple views that do not contain complex navigation links. For more information, see About Standard Interactivity and High Interactivity.

The examples in this topic describe how to create multiple view layouts if you use HTML frames. The procedure is similar to the procedure you use if you do not use HTML frames. If you do not use HTML frames, then to position the views, you can use HTML tables instead of frames and framesets.

To support multiple views, you must modify the structure of frames and framesets.

To display multiple views on a page

1. Replace the first line of the swe:frameset code of the CCPageContainer.swt file with the following example code:

   <swe:frameset htmlAttr="rows='80,50,50,*' border='0' frameborder='No'">

   For more information, see Guidelines for Naming a Siebel Web Template.

2. Replace the view frame in the container page with a content frame.

   This frame defines the area where Siebel CRM loads one or more views. Initially this frame contains a frameset that includes a view type frame. You can replace this view frame with the following example content frame:

   <swe:frame type="Content" htmlAttr="marginheight='0' marginwidth='0' noresize scrolling='Yes'">

   <swe:include file="CCMainView.swt"/>

   </swe:frame>

   For more information, see Example Code of the CCMainView.swt File.

3. Modify all the application container templates to use the content frame.
4. To display more views in the content area, load a different content container page in the content frame:
   1. Call the LoadContentContainer method from a control or page item.
   2. Make sure the User Property container loads the content container.

      For more information, see Using the LoadContentContainer Method to Load Multiple Views.

Siebel CRM behaves the same before and after you make this modification. You only add one more layer of frames in the content area. The unmodified application container page template included in the view frame without the outer content frame does not create errors. You cannot use it to display multiple views.

Using the LoadContentContainer Method to Load Multiple Views

You must use the Web Template Name of the content container page and not the SWT file name. For example, to display the search view with the main view, do the following:

• Create a content container page, such as CCSMainAndSearchView.swt.
• Use the LoadContentContainer method to load this page.

To load the main view and search view into two frames, the CCSMainAndSearchView.swt file contains the following tags:

<swe:frameset htmlAttr="cols='100%' border='0' frameborder='No'">

<swe:frame type="View" htmlAttr="noresize scrolling='Yes'">

<swe:current-view/>

</swe:frame>

<swe:frame type="AltView" name="Search" htmlAttr="noresize scrolling='Yes'">

<swe:view name="Search View" id="Search" />

</swe:frame>

</swe:frameset>

In this example, you still reference the main view in the swe:current-view tag. You reference alternate views in the swe:view tag.

To switch from displaying the search and main views to displaying only the main view, you can call the LoadContentContainer method again, but this time reference the container page that references the CCMainView.swt file.

SWE View Tag

The swe:view tag uses the following format:

<swe:view name="xxx" id="yyy">

The swe:view tag includes the following attributes:

• Name. Name of the alternate view.
• Id. Identifies the location that this view occupies. You use this Id to replace this view with another view.

The swe:frame tag contains an alternate view named AltView. You can define only one alternate view for each frameset. If you add more than one alternate view, then you might encounter an error.

Example Code of the CCMainView.swt File

The CCMainView.swt file that you reference in the swe:frameset code of the CCPageContainer.swt page includes the following frameset. This frameset contains the main view:

<swe:frameset htmlAttr="cols='100%' border='0' frameborder='No'">

<swe:frame type="View" htmlAttr=" noresize scrolling='Yes'">

<swe:current-view/>

</swe:frame>

</swe:frameset>