About Toolbars | ||
| ||
Page Toolbar
This section describes the components of a page toolbar.
This graphic shows a toolbar that contains all the main components that a toolbar can have.
The toolbar can contain:
- Default links such as the Help and Printer-Friendly links shown above.
The toolbar component relies on querystring parameters to determine whether to display the Printer-Friendly link, the Export to Excel links, and the TipPage. By default, these buttons display, unless they are explicitly turned-off.
The Help link always displays. If no valid help marker is passed in, it defaults to the main help page for the specific application.
- Linked commands configured for the toolbar, such as the Create Issue link shown above.
When the user clicks such a link, the configured page for it is called.
- Top-level menu items that contain a list of drop-down actions, such
as the Actions menu item shown above.
When the user clicks the menu item, a list of drop-down actions displays.
- Naviagation tree including object categories, shown as the Categories menu. See Navigation Trees for details.
- Vertical dividers that separate links on the toolbar. The divider is specified by connecting the AEFSeparator command to the toolbar.
The above graphic has 2 vertical dividers. The dividers can be placed as needed. For example, you can configure the toolbar to have a divider for every two buttons. Or, a divider can be added to create a logical grouping of links, much like the grouping of new, open, save buttons on the Windows toolbar.
The emxFramework.Toolbar.PivotCommand.Limit property in the emxSystem.Properties file controls whether or not the Actions menu shows as a drop-down menu, or if the menu items display as toolbar buttons. If the number of menu items is less than or equal to the value of this property, the menu items will display as toolbar buttons. See emxSystem.properties for details.
This lists shows the URL Parameters that can be passed to the toolbar, emxToolbar.jsp, that enable/disable the specified toolbar buttons. For each parameter, the value can be true or false.
- AutoFilter
- customize
- CurrencyConverter
- editLink
- expandLevelFilter
If a toolbar menu includes the Expand Menu = true setting, the menu takes precedence over the expandLevelFilter URL parameter (the button will not be loaded in the toolbar and the custom Expand Menu will be loaded in the toolbar.
- export
- findMxLink
- massPromoteDemote
- multiColumnSort
- objectCompare
- PrinterFriendly
- showChartOptions
- showClipboard
- showTableCalcOptions
- tipPage
- triggerValidation
The helpMarker parameter is always passed. If no specific helpmarker value is provided, the button opens the help system at the cover page.
Drop-Down Menus
The drop-down contains the list of actions that can be performed from the current page.
This graphic shows a drop-down menu from the page toolbar:
Drop-down menus can contain:
- Top-level menu buttons that activate the drop-down menu. This is the
Actions button in the graphic shown above.
The title of the top-level menu button is configurable.
The key corresponding to the display name is found in the emxSystem.properties file by the name: emxFramework.UIActionbarMenu.Label. This property points to a key in the frameworkstringresource.properties file. The default value is emxNavigator.UIMenuBar.Shortcuts. To view or change the value for the display actions name, open the emxFrameworkStringResource.properties file and look for the emxNavigator.UIMenuBar.Shortcuts key and change its value to the desired string.
- Commands. When users click the links, the page configured for that link is called.
- Both the drop-down menu links and the toolbar links can be configured
with the following characteristics:
- Icons/Text/Both--For example, the Create Library link shown above is configured as an icon with text and the rest of the command links are shown as text only.
- Activation--Toolbar buttons and drop-down menus can be enabled and disabled. For example, if the action requires that at least one item is selected on the list page, then the action is disabled until at least one item is selected.
- Form Submission--Support for form submission through toolbar buttons/ drop-down options.
- Horizontal separators. Connect the command AEFSeparator to the menu.
The configurable toolbar replaces the top and bottom action bars used in prior versions of ENOVIA Business Process Services.
For both the toolbar and the drop-down menus, there are no set limits for the number of items.
If you design a page that includes multiple toolbars, any drop-down menus must appear on the last toolbar passed to the page (becomes the bottom toolbar). Toolbars with many items that could force a drop-down menu into the overflow menu should be redesigned so that all drop-down menus appear on the bottom toolbar. If a drop-down menu appears on the top toolbar or is forced into the overflow menu, the drop-down menu will not work within the frameset.
Pivot Command
Drop-down menus can be converted to toolbar buttons.
When the Actions menu only contains a few submenu items, the items can display as toolbar buttons instead of as a drop-down menu. The emxFramework.Toolbar.PivotCommand.Limit property controls when the items in the Actions menu can be added to the toolbar. If the number of menu items is less than or equal to the limit, then the Framework places the commands in the toolbar instead of the menu (and the menu button does not display in the toolbar).
This screen shows a pivoted toolbar. The Specifications page does not have an Actions menu; the commands Checkout and Request Download, which normally would be in an Actions menu, have been added as buttons to the toolbar.
See emxSystem.properties for more information.
