|
The properties of the table columns displayed for the Network Events, Alarms, Network Database, and the Configured Collection panels are configurable. The tabular display of data for these panels facilitates studying the status of any entity over a period of time. It is also possible to add 'user-defined' columns for a panel table as per the requirement. The panel tabular view also encapsulates several view properties such as setting the page length view for the table, enabling sorting of displayed data either in the server side or in the client side, and facilitating resizing and reordering of the table columns.
Defining Attributes Related to Table
There are certain configurable table column attributes that can be specified in the Tree.xml file located in <Web NMS Home>/users/<username> directory.
TABLE-COLUMNS : This property is for configuring the table column view characteristics such as the label, its fieldname, and its column width.
ORDERBYNAME : This property is used for configuring the table column for which default sort is to be set.
ORDERBYCOLUMN : This property is used for configuring the sorting of a table column statically. This means, every time the client is started the specified table column remains sorted in the configured order.
REORDERING-ALLOWED : This property is used for configuring the reordering of the table columns.
RESIZING-ALLOWED : This property is used for configuring the resizing of the table columns.
SERVER-SORT-DISABLED-COLUMNS : This property is used for configuring the server-side sorting of the table columns.
CLIENT-SORT-DISABLED-COLUMNS : This property is used for configuring the client-side sorting of the table columns.
How to make an Attribute Entry in Tree.xml File ?
The entries of all the above-mentioned attributes that are to be made in the Tree.xml file for a specific panel/custom view to configure its tabular view, are as shown below :
<DEVICE-DATA>
<DEVICE-GROUP>
<DEVICE ID="Events"
TABLE-COLUMNS="Class = severity = 55, Source = source = 135; Date = date = 155; Message = text = 275"
ORDERBYNAME="Date "
REORDERING-ALLOWED="true "
RESIZING-ALLOWED="false"
SERVER-SORT-DISABLED-COLUMNS="name"
CLIENT-SORT-DISABLED-COLUMNS="groupName"/>
</DEVICE-GROUP>
</DEVICE-DATA>
The above snippet shows the manner in which the respective attributes can be specified in Tree.xml file. It is not a must to specify all the attributes for a specific tree node. Removal of the TABLE-COLUMNS attribute from the Tree.xml file for a panel results in the display of four default table columns. If the same TABLE-COLUMNS attribute is not specified for the custom views of a specific panel, then as per the inheritance property, the child tree node too contains the same number of columns as the parent tree node. If the table column names are invalid for a panel, then the default column values are shown.
By default, as defined in the Tree.xml file, the table columns displayed for the four panels are :
|
Network Database |
Name, IpAddress, Status, Type, Is Snmp, and Netmask. |
|
Events |
Class, Source, Date, and Message. |
|
Alerts |
Owner,failure Object, Date, and Alert Message |
|
Performance views |
Statistics Name, Object ID, Community, and Interval |
Panel-specific menus can be associated with the tables of the custom views. The menu that pops up on right-clicking the displayed table is known as the Table Pop-up menu. An attribute, namely TABLE-POPUP-MENU takes in menus/menu items as values, that are to be displayed on right clicking on the table. This attribute can be specified for specific panel (i.e., <DEVICE> </DEVICE> tag of Network Events, Alarms, Configured Collection, and Network Database) in the Tree.xml file located in <Web NMS Home>/users/<username> directory.
The table pop-up menus/menu items are panel-specific in characteristics and can either be names of any menu configuration file (i.e..xml ) or names of the menus that are contained in the menu configuration file specified for the MENU-FILE-NAME attribute for that panel in Tree.xml file.
<DEVICE ID ="Network Database"
TREE-NAME="Network Database"
PANEL-NAME ="com.adventnet.nms.mapui.NmsListView"
MENU-FILE-NAME =""
TABLE-POPUP-MENU ="Custom View, test1.xml, test2.xml "
HTML-client = "true"
TABLE-COLUMNS ="Name = name = 150; IPAddress =ipAddress = 100; Status
= status = 70; Type = type = 90;
IsSnmp = isSNMP = 65; NetMask = netmask = 100"
ICON-FILE ="images/db.png">
</DEVICE>
In the above entry, you can find the entry for the table pop-up menu which comprises of the menu configuration files such as test1.xml and test2.xml and panel-specific menus such as Custom View. The menus and menu items specified in the two .xml files along with the 'Custom View' menu are displayed as Table Pop-up menus for the panel. More details about the Table Pop-up Menus are covered in Table PopUp Menu.
|