Introducing the Menu Configurator Tool
The Menu Configurator tool facilitates customization of Object-Specific menus and Map-Specific menus on the fly. It also eases association of users with menus created in the Java GUI. Customization of menus manually involves editing of a number of menu configuration files. The Menu Configurator tool makes customization of menus conducive due to the design of its intuitive and self- explanatory GUI.
How to Start the Tool
Run the Menu Configurator tool from the Web NMS Launcher/Utilities or run MenuConfigurator.bat/sh present in <Web NMS Home>/bin/developertools directory.
The Various Menu Bar Options of the Menu Configurator Tool
File (menu) --> The menu items available under this are as follows:
New - Use this option to add a new menu.
Open - Use this option to open the existing menu /menu item file to be customized.
Save - Use this option to save a single file.
Save All - Use this option to save all files.
Close -Use this option to wind up the tree operations and start again.
Exit - Use this to quit from the Menu Configurator tool operations.
View (menu)--> The menu items available under this are as follows :
Source -View the source code of the selected configuration file in a separate dialog box called View source.
Help (menu )--> Use this to view the help document of the Menu Configurator Tool.
The Functions of the Menu Configurator Tool
The Menu Configurator Tool specifically allows you
To Create a New Object-Specific Menu Configuration File
Click on File -> New. This prompts you to create a new menu file. The screen Create Menu pops up for you to enter Menu File Name and Menu Name. The check boxes enable you to specify if you want to create it for List Menu or for Map Menu or for both . The users for whom the changes have to be implemented can be configured by selecting the User Configuration check box and adding the required user to the list. Next click on the OK button. This brings up the new menu in the main screen.
To Create a New Object-Specific Menu Item
If you right-click on the Menu Node on the tree, you will get a pop-up menu. The menu items are New Node, Delete, Rename, Cut, Paste, and Paste as Child. Click on New, a Dialog box pops up prompting you to enter the new node name (Menu Item name). Enter the new node name. You can choose this either for Java UI or for HTML UI, or for both. Click the OK button, the new node gets added in the corresponding tree. Click on the Advanced button to get a dialog which takes up the Security details for the selected menu item. For more information about Security Details, refer to Secure Menus.
Deleting a Menu Item
Select the Menu Item you want to delete. Right-click on the Menu Item and click Delete from the pop-up menu. A message pops up asking you to confirm if you want to delete the Menu Item selected. Click on YES to delete it.
Renaming a Menu/Menu Item
Select the Menu/Menu Item you want to rename and right-click on it. Select Rename from the pop-up menu. Type in the new Menu/Menu Item name to rename it.
Cutting and Pasting a Menu/ Menu Item as a Child Node in the Tree
Select the Menu/Menu Item and right-click on it. Select the Cut option from the pop-up menu if you want to cut the node and then Paste it either just below the node or Paste as a Child, i.e., as a child node. The Paste and Paste as Child options are provided in the pop-up menu on right-clicking the Menu/Menu Item.
Customizing an Existing Object-Specific Menu
Click File->Open. A dialog box "Select Menu" pops up. Choose between User Specific and Device specific menu.
Customizing Menus for Users
Click on User Specific menu radio button.
Select the file from <Web NMS Home>/listmenus directory, <Web NMS Home>/mapdata/menus directory or from the mapmenus and listmenu directories of the <Web NMS Home>/ users/ <username> directory. You can either select all the files or click a specific file for customization. Click the OK button. The selected menu files appear on the list /map menu tab in the main screen.
Select the menu/menu item you want to customize and right-click on it. You can add a new node, delete an existing node, rename an existing node, cut, paste or paste as child node.
To specify a new function and action, select the menu/menu item.
Customize the action by choosing any action for the selected Menu/Menu Item from the Select Action combo box. Each action has a corresponding function which you should specify. For example the action function has the following options- addobj, undo, addlink, properties, addfield, deletefromdb, Managed Object Properties,delete, ungroup, opengroup, tofront, toback, save, refresh, search, and moveobjs. To know more about Menu Action Functions refer to Object Specific Menu.
Select the action and fill the relevant fields corresponding to the action. Your new Menu functionality is now changed.
Customizing Menu Configuration File for Existing Object :
Select the Device Name by clicking the Select button which brings up the Device Selection screen. This screen has a list of devices which are in <Web NMS Home>/conf/OIDType.data.
Select a Device from the given list. The device OID , the map menu file name, map menu name, list menu file name, and list menu name are loaded .
You can create a new menu file to the device by clicking on Define New.
On clicking Define New the Create Menu dialog box pops up . Enter the new Menu file name and Menu name. You can associate it with either List Menu or Map Menu or both.
To configure for users, click User Configuration button in the Create Menu dialog box . After configuring the users, click the Add button. Next Click the OK button to complete the process of associating a new menu file with an existing device.
To define a new List menu or map menu for an existing device, click the existing Define New button which brings up the Create Menu Dialog box and follow the same process as described above.
If you want to model your device, click the OIDDetails button. The screen that appears lists all Device Information. If the device type already exists, you can modify t; or if the Device type is new, you have to provide necessary details to represent the Device in the Client. To represent the device in the client, a list of image files and an image should be entered. For the device to be shown in the NMS List View, you can either give a single transparent image or provide a list of images corresponding to each severity. If the type of the device is already found then the corresponding images are shown or the user should enter a new image for each severity.
Viewing Source of the New Menu Configuration File
To view the source code of the menu configuration file, select the menu from the tree and then click on View –> Source from the menu bar. A screen pop-ups with the source code .