Insert Frameset

• Overview
• Preparations
• Insert frameset
  • Split frame as it is loaded
  • Split frame when activated from menu
  • Split page as site is loaded

Overview

WebsydianExpress uses frames to specify the structure of the site. Framesets instructs the browser about how to split the page (or frame) into sub-frames, which frames to populate and what to populate them with.

In WebsydianExpress all this is defined in the site structure in combination with the HTML template for the frameset site element.

You can read more about framesets in WebsydianExpress here.

Preparations

Before inserting the frameset in the site structure, it is necessary that a new presentation has been defined for the generic frameset process (process ID: WSFRMP). This presentation must specify a template (using the template suffix), which specifies the frames to split the page/frame into.

You can read more about specifying a presentation for an existing process here.

Insert frameset

The menu item "Site structure->Site Structure" is used for accessing the site structure tree.

The frameset can be used in three different contexts.

• The frameset will split a frame, when this frame is loaded by another frameset (the new frameset will create a number of subframes)
• The frameset will split a frame (or the top browser page), when the frameset is activated by a menu item.
• The frameset process is executed when the site is loaded - and splits the top browser page.

Split frame as it is loaded

You will do this when you wish a frame to be split into sub-frames as soon as it is loaded.

1. Select the frameset that should load the frame in the site structure tree.
2. Press "Add". This starts a wizard that will lead you through the process.
3. Select "Create new site element" and "Frameset", press "Next".
4. Select the presentation of the frameset element to be used by pressing "Select".
   Use the search facility to find the presentation.
5. Supply information about the site element, and press "Next"
   • Text - the name that you want to appear for the menu site element in the site structure.
   • Frame - Name of the frame
   • Comments - Optional comments
6. Assign the roles for the site element, and press "Finish"

Split frame when a menu item is activated

This is used in several cases - one of the most common is when you wish to load a submenu and a business process when activating a menu item.

1. Select the menu that should contain the new menu item.
2. Press "Add". This starts a wizard that will lead you through the process.
3. Select "Create new site element" and "Frameset", press "Next".
4. Select the presentation of the frameset element to be used by pressing "Select".
   Use the search facility to find the presentation.
5. Supply information about the site element, and press "Next".
   • Menu item text - this is the text that will be shown for the menu item in the menu. (It will also be shown in the site structure tree).
   • Alignment - indicating whether you want to show the menu item in the first (left) or second (right) section of the menu.
   • Sequence - this specifies the order that the menu items will be shown in. Be aware that by defining two or more menu items with the same combination of alignment and sequence will result in only one of them being shown in the menu. Which menu item to show is decided from the roles assigned to the menu items in combination with the roles assigned to the current session.
   • Display in frame - this specifies the frame you want to split using the frameset when the menu item is activated.
   • Comments - optional field for your comments
6. Assign the roles for the site element, and press "Finish".

Split page when site is loaded

The most common child of a site root is a frameset - in very many situations you will wish to split the site into several sub-frames as soon as it is loaded.

1. Select the site root.
2. Press "Add". This starts a wizard that will lead you through the process.
3. Select "Create new site element" and "Frameset", press "Next".
4. Select the presentation of the frameset element to be used by pressing "Select".
   Use the search facility to find the presentation.
5. Supply information about the site element, and press "Next".
   • Text - the name that you want to appear for the frameset element in the site structure
   • Comments - optional field for your comments.
6. Assign the roles for the site element, and press "Finish".