Customizing the Solution Menu
The
solution master mashup (
PTC.Base.SolutionMaster_MM) includes a menu in the navigation bar at the top left of the page. This solution menu is dynamically generated from the menu configuration settings on the manager Things for user interface building blocks. Each item in the menu is configured to launch a specific mashup from a user interface pattern building block. An example of the solution menu is the menu used by the Digital Performance Management (DPM) solution. For more information, see "Customizing the DPM Menu" in the DPM Help Center, available here:
https://www.ptc.com/en/support/help/Solutions.
To add an item to the solution menu, complete the following steps:
1. Ensure that the Master property of the mashup you want the menu item to open is set to PTC.Base.SolutionMaster_MM.
2. In ThingWorx Composer, navigate to the manager Thing for a user interface building block, and click Edit.
3. Under Configuration, click Add on the Menu Configuration table.
4. On the MenuConfiguration window, enter the information for your menu item:
◦ menuTitleKey—Enter the name of the localization token that provides the display text for the menu item.
◦ menuItemMashupName—Enter the name of the mashup that you want the menu item to open.
◦ menuName—Enter MasterMenuNavigation.
◦ menuOrderPreference—Enter the number representing the position in which you want this menu item to appear in the menu, starting from 0. Smaller numbers appear before larger numbers, for example, 0 appears before 4. If more than one menu item has the same menuOrderPreference value, then they are sorted alphabetically by the name of the manager Thing on which each menu item is configured. For example, if two menu items have the same menuOrderPreference value, then the menu item that is configured on ABC.Administration.Manager appears before the menu item that is configured on ABC.Dashboard.Manager.
◦ submenu—If this menu item will have one or more sub-menu items, click Add next to the submenu field. Enter the menuTitleKey, menuItemMashupName, menuName, and menuOrderPreference for the sub-menu item as described above, and click Add. Repeat for each sub-menu item that you want to add. The menuOrderPreference values apply only to this sub-menu.
Leave the following field blank: menuSectionKey.
5. Click Add to close the MenuConfiguration window.
6. Click Save to save the changes on the manager Thing.
Repeat these steps for each item that you want to be included in your solution mashup. If your menu item has a sub-menu, you can view all the sub-menu items by clicking on the submenu field in the MenuConfiguration table.