Skip to Main Content
Return to Navigation

Understanding Toolbars

This section discusses:

Toolbar Elements

A toolbar contains these parts:

  • Title area.

  • Button bar.

  • Component-specific data.

  • Toolbar footer.

Title Area

Based on the configuration, the title area includes one or more of these controls:

  • Page title, if enabled, is shown left-aligned on top of the toolbar buttons.

  • Date and time, if enabled, is shown right aligned on top of the toolbar buttons.

See Toolbar Definition - Description Page.

Button Bar

The button bar is similar to a browser's toolbar. It can include the following elements:

  • PeopleTools actions

    This includes buttons such as Save, Refresh, Add, Next in List, Previous in List, Return to Search, and Update/Display, which map to the corresponding buttons (which are available at the bottom of a page) that are defined in PeopleTools.

  • Custom actions

    This includes buttons that perform application-specific actions, such as cloning a case. Often, clicking a custom button displays a page on which you complete the action.

  • The Personalize action

    This enables users to reconfigure the buttons on the button bar.

You can choose which toolbar elements to display and, for PeopleTools and custom actions, you can define their appearance sequence. There are two kinds of toolbar buttons: primary and secondary. Primary toolbar buttons are orange-colored, rectangular buttons with text label on them. They always appear on the left of the toolbar, and cannot be hidden through user personalizations. Secondary toolbar buttons, on the other hand, can be configured to show only the button icon, the text label, or both. End users can hide secondary toolbar buttons through personalizations, if the buttons are configured to support this functionality in the toolbar definition.

Also, you can modify the delivered toolbar buttons' definitions, or you can create new toolbar buttons using application classes.

See Toolbar Definition - Button Page.

Component-Specific Data

Under the button bar, the toolbar displays summary information about the object that you are viewing. For example, the Manage Job Opening toolbar shows summary information about the current job opening. PeopleCode in the underlying component makes this information available.

When you configure a toolbar, you choose which and how summary data appear.

See Toolbar Definition - Content Page

Toolbar Footer

If a page is too long to be displayed in a single browser window and you need to scroll to see the entire page, you can add a toolbar footer so that toolbar buttons are also available when users are at the bottom of the page. The toolbar footer is the same as the toolbar button area at the top of the page. One exception is that the footer has the Top of Page link instead of a Personalize link as you see in the header. When you click the right or left arrow for more buttons in either direction, the other toolbar shifts at the same time.

Delivered Toolbars

To obtain a list of system-delivered toolbars, and to identify the components and pages that use them, go to the Toolbar Definition component (select Enterprise Components, then select Component Configurations, then select Toolbar, then select Toolbar Definition) and click Search without entering search criteria. The system displays all delivered toolbars on the Search Results list.

To review the buttons and display items that are available for use in toolbars, access the Toolbar Definition - Button Page and the Toolbar Definition - Content Page of the selected toolbar definition.

Delivered Toolbar Buttons

To obtain a list of system-delivered toolbar buttons, go to the Toolbar Button Definition component (select Enterprise Components, then select Component Configurations, then select Toolbar, then select Toolbar Button Definition) and click Search without entering search criteria. The system displays all delivered buttons on the Search Results list.

Note that before you add a custom button to the toolbar of a component, confirm that the component has the PeopleCode to support the action that the button performs. For instance, do not include the Clone button in the toolbar of a component that does not have the code needed to support cloning.