|
|
Introducing Map-Specific Menus
Once a Map is constructed, its functionality and properties are handled by the Client Framework. Every constructed Map has unique functionality. The user might desire to invoke these Map functionality in the Client through menus. Therefore, such menus which get displayed in the menu bar on selecting a particular Map from the NMS panel are known as Map-specific menus.
Location of Map-Specific Menu Configuration Files
The Map-Specific menus are defined in XML format. The .xml menu file of the corresponding Map defines the Map-Specific menu items which on being clicked trigger a particular operation. The .xml menu files can be located either in <Web NMS Home>/users/<username>/mapmenus directory (user-specific access) or in <Web NMS Home>/mapdata/menus directory. Web NMS searches for the menu file first in the former directory and then in the latter one (i.e., if the file is unavailable in the former directory). For example, failedobjectsmenu.xml <Web NMS Home>/mapdata/menus directory is set as Map-Specific menu for the default FailedObjects map.
The XML file formats of the Map-Specific menus are explained in Menu File Organization.
The Map-Specific menus can also be invoked by specifying the menu configuration file name through the map property form. By default, these menus get displayed at the center of the menu bar. The user can also configure the position of these menus. The map specific menu property is set only when the particular map symbol is created in the server (i.e., mapdb).
A Pictorial Representation of Map-Specific Menus
The following image illustrates the display of the Map-Specific menu in the menu bar:
The action performed on clicking a Map-Specific menu item depends on the action defined by the action_type/action_value attribute in the menu configuration file. The action performed can be that of opening a new frame, a form, etc. The different actions invoked on clicking the Map-Specific menu item are covered in the Menu Action chapter.
|
|