Configuring Siebel Business Applications > Configuring Siebel Web Templates and Siebel Tags > Customizing Web Templates to Render Menus, Toolbars, and Thread Bars >

Using Web Templates to Customize Toolbars

Siebel CRM displays a toolbar as an HTML toolbar in standard interactivity and as a customizable JavaScript toolbar in high interactivity. For an application that uses computer-telephony integration (CTI), you can display another toolbar as a Java applet. For more information, see About Standard Interactivity and High Interactivity.

A JavaScript toolbar object resides in the JSSApplication hidden frame, which typically does not reload during the life cycle of the Siebel application. Therefore, Siebel CRM does not redraw when a page refresh occurs. The user interface part of the JavaScript toolbar resides in a visible HTML frame and redraws when the HTML frame reloads. It is recommended that the visible HTML frame is a persistent frame that reloads infrequently. HTML toolbars reside in the topmost frame in the application template, which is set aside for this purpose.

Tags That You Use with a Toolbar

This topic describes the toolbar tags that you use with a web template.

SWE Tag That Specifies a Toolbar

The swe:toolbar tag specifies a toolbar where the name corresponds to the Name property in the Toolbar object definition. Siebel CRM currently supports two types of toolbars: HTML toolbars and Java applet toolbars, as defined in the javaapplet attribute.

The swe:toolbar tag uses the following format:

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

The swe:toolbar tag includes the following attributes:

  • Name. The name of the toolbar as defined in Siebel Tools.
  • Javaapplet. Must be set to true for a Java toolbar, and false for an HTML toolbar.
  • Width. Width of the toolbar in pixels.
  • Height. Height of the toolbar in pixels.
SWE Tag That Retrieves Toolbar Items

The swe:toolbaritem tag recursively retrieves all of the toolbar items for that toolbar from the Siebel repository. It exists between the toolbar start tag and end tag.

The swe:toolbaritem tag uses the following format:


The swe:toolbaritem tag does not include any attributes.

Using Templates to Customize HTML and JavaScript Toolbars

You can define an HTML or JavaScript toolbar.

To use templates to customize HTML and JavaScript toolbars

  1. Add the following code to the Siebel web template file:

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

    // any HTML stuff here...


    // any HTML stuff here...


  2. For combo box items, make sure you target the command to a service.

Customizing a Java Toolbar

You use a Java applet to customize the toolbar. This applet includes all the toolbar controls and the threads that interact with the Siebel Server. The Java applet calls the following methods:

  • ShellUIInit method on the command target service when the applet attempts to initialize
  • ShellUIExit method when the applet exits

A set of communication protocols is defined for the communication between the Java Applet and the service.

To customize a Java toolbar

  • Add the following code to the Siebel web template file:

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

Configuring Siebel Business Applications Copyright © 2011, Oracle and/or its affiliates. All rights reserved. Legal Notices.