Defining the Menu Bar Items Using a Menu Entity
You can define the menu bar items using standard menu entities in Composer. Create multiple entities to use in the primary and secondary navigation sections of the Menu Bar widget. In addition, you can create multiple levels of navigation by creating multiple entities that are linked. For more information about menu entities in composer, see Menus.
To define the top level navigation items on the menu bar:
1. In Composer, click New, then choose Menu.
2. On the General Information tab, enter a name, choose a project for the entity, and then click Save.
3. On the Menu Definition tab, click Add. The New Menu Definition pane opens.
4. Under Type, choose one of the following item types:
◦ Mashup—Opens a mashup on the server. You can configure the following options:
▪ Title—Specifies the item name to display on the Menu Bar.
▪ Link—Specifies the Mashup entity to open when the menu item is clicked.
▪ Target—Controls how the menu item opens at run time. You can open the mashup in the current or in a new browser window.
▪ Icon—Specifies the icon to display next to the menu item.
◦ Menu—Opens another Menu entity in a cascading menu or an accordion, depending on the Menu Bar widget configuration. You can configure the following options:
▪ Target—The Menu entity used to define the items in the submenu.
 |
Additional options such as the item name and icon are defined in the selected Menu entity.
|
◦ Hyperlink—Opens a URL to a web page. You can configure the following options:
▪ Title—Specifies the item name to display on the menu bar.
▪ Link—The web page URL.
▪ Target—Controls how the URL opens. You can set it to open in a new browser window or replace the current window.
▪ Icon—The icon to display next to the link item.
▪ Logout—Logs out the user from the current ThingWorx session.
The following are general options that are available for every menu item type:
◦ Groups—Controls the visibility of the menu items for different user groups on the ThingWorx server. You can use this option to specify which groups can see the item. By default, items are visible for all user groups.
◦ Default—Displays the linked mashup automatically when the mashup Menu Bar widget is loaded. You can only set one default item for a Menu entity.
5. Repeat the previous step for each item that you want to display on the menu bar.
6. Click Save to save the Menu entity.
You can create additional Menu entities on the platform to define multiple levels of navigation on a menu bar.
To configure a top-level item as a second-level navigation menu:
1. In Composer, create a new Menu entity to define the items for submenu items.
2. On the General Information tab, enter a name, choose a project for the entity, and then click Save.
3. Set the display name for the menu item in the Display Name box. This name is used on the parent menu.
4. On the Menu Definition tab, click Add to define the menu items. The New Menu Item pane opens.
Optionally, to display an icon for the menu, specify a media entity under Icon. This icon is displayed on the parent menu.
5. Define menu items for the submenu. Refer to Step 4 in the previous section for more information.
6. Click Save to save the Menu entity.
7. Open the parent Menu entity, and on the Menu Definition tab, select the menu item that you want to display as a second navigation level. The Edit Menu Item pane opens.
8. Under Type, select Menu.
9. In the Target box, select the Menu entity that you created in Step 1.
10. Save the changes.