Adding New Menu Groups and Items to the Asset Search Menu
Menu Groups
Overriding the GetAssetSearchMenuGroups service allows you to add one or more custom menu groups to the asset search menu. For example, the PTC.Demo.AssetManager.MRIMenuHelper overrides GetAssetSearchMenuGroups to add a custom "MRI Machines" group to the asset search menu. The service parameters are:
|
Parameter
|
Description
|
|
group
|
The custom group name. Localized tokens are supported using the “[[tokenstring]]” format. For example, newRow.group=”[[MyCustomGroupName]]”.
|
|
sortOrder (Optional)
|
An integer value that controls the order of the custom menu group.
|
|
If this is not set or is set to null or zero, the new group will be added to the top of the menu.
|
|
In the example below, the PTC Demo.AssetManager.MRIMenuHelper overrides GetAssetSearchMenuGroups to add a custom “MRI Machines" group to the Asset Search menu.
Menu Items
Override the GetAssetSearchMenuItems service allows to add one or more custom menu items to the Asset Search menu. The PTC Demo.AssetManager.MRIMenuHelper overrides GetAssetSearchMenuItems to add a custom "MRI DASHBOARD" menu item to the custom "MRI Machines" group in the Asset Search menu. Several parameters must be provided per menu item:
Parameter | Description |
group | The name of the group that the menu item is to be added. Localized tokens are supported using the “[[tokenstring]]”; format. This can be a custom group or a pre-existing group. To add to a pre-existing group, use one of the following strings mentioned in the Appendix. For example, newRow.group = "[[PTC.Asset.Current]]";. |
title | The string used for the menu item label. Localization tokens are supported. |
linkDestination | The name of the custom mashup to associate to the new menu item. | URLs are not yet supported. |
|
imageURL (Optional) | A URL or media entity name for an optional icon. |
In the example below, the PTC Demo.AssetManager.MRIMenuHelper overrides GetAssetSearchMenuItems to add a custom "MRI DASHBOARD" menu item to the custom "MRI Machines" menu group in the Asset Search menu.
The new MRI Machines menu group and MRI DASHBOARD menu item appears in the Asset Search menu.
