Configuring Siebel eBusiness Applications > Overview of Web Templates and Siebel Tags > About Using Toolbars and Menus in Templates >

How Toolbars are Displayed in Templates

Toolbars are displayed as HTML toolbars in standard interactivity applications and as extensible JavaScript toolbars in high interactivity applications. For applications using CTI, an additional toobar can be displayed as a Java applet.

HTML toolbars reside in the topmost frame in the application template, which is set aside for this purpose. JavaScript toolbar objects reside in the JSSApplication hidden frame, which usually does not reload during the application lifecycle. Therefore, they are not redrawn when there is a page refresh. The UI part of the JavaScript toolbar resides in a visible HTML frame (recommended to be a persistent frame that reloads infrequently) and redraws when the HTML frame reloads.

In SWE templates, the <swe:toolbar> tag specifies a named toolbar (where the name corresponds to the Name property in the Toolbar object definition in the repository), and the <swe:toolbaritem> tag between the toolbar start and end tags recursively retrieves all of the toolbar items for that toolbar from the repository.

HTML and JavaScript Toolbars

For an HTML or JavaScript toolbar, add the following to the SWT file:

<swe:toolbar name=xxx> // where xxx is the name of toolbar in the repository.

// any HTML stuff here...

<swe:toolbaritem>

// any HTML stuff here...

</swe:toolbar>

NOTE:  For combobox items, the command has to be targeted to a service.

Java Toolbars

For a Java toolbar, add the following to the SWT file:

<swe:toolbar name="xxx" javaapplet="true" />

The Java applet invokes the ShellUIInit method on the command target service when it tries to initialize. It invokes ShellUIExit when it exits. There is a set of communication protocols defined for the communication between the Java Applet and the service.

The toolbar is implemented as a Java Applet (including all the toolbar controls and the threads interacting with the server).

The full syntax specifications for the <swe:toolbar> and <swe:toolbaritem> tags are below:

• <swe:toolbar>

  Purpose:

  In SWE templates, the <swe:toolbar> tag specifies a named toolbar (where the name corresponds to the Name property in the Toolbar object definition in the repository), and the <swe:toolbaritem> tag between the toolbar start and end tags recursively retrieves all of the toolbar items for that toolbar from the repository. Siebel eBusiness Applications currently support two types of toolbars: HTML toolbars and Java applet toolbars, as specified in the javaapplet attribute.

  Usage:

  <swe:toolbar name="XXX" javaapplet="true/false" width="XXX" height="XXX" />

  Attributes:

  • name. The name of the toolbar as defined in Tools.
  • javaapplet. This should be set to true for java toolbar, and false for HTML toolbar.
  • width. Width of the toolbar in pixels.
  • height. Height of the toolbar in pixels.
• <swe:toolbaritem>

  Usage: <swe:toolbaritem>

  Attributes: None.