Administer > Extend NNMi Capabilities > Control the NNMi Console Menus > Configure Menu Item Basic Details

Configure Menu Item Basic Details

[This is the Context-Sensitive Help topic for the Menu Item form.]

The Menu Items tab of the User Interface Configuration option enables you to make changes or additions to the items available in the NNMi console menus. For example, you can configure SNMP Line Graphs and provide menu items that display in-house tools, Web sites, or access a variety of other resources.

Note If you are configuring a Launch Action, you must select Actions as the Parent Menu or an expandable menu submenu beneath Actions.

To make changes or additions to the items available in the NNMi console menus:

  1. Provide the required information to define the action (see Basics tables).

    Caution If you make changes to a Menu Item provided by NNMi, those changes are at risk of being overwritten in the future. See Author form for important information.

  2. Provide the required Context details (see Configure Menu Item Context Basic Details).
  3. Click  Save and Close to save and apply your changes.
  4. To test your changes to the menu you configured:

    1. If required, access a view or form that contains the appropriate object type.
    2. If required, select an object instance.
    3. Click the menu you configured.
    4. Verify your changes are working.
Basics
Attribute Description
Menu Item Label

The text string that appears as the menu link. Ensure that your menu label is unique and accurately reflects the intended use of the Menu Item.

Note If you add two Menu Item Labels with the same text string but different Unique Keys, it would be possible for both to show up beneath the same specified Parent Menu.

Unique Key

Used as a unique identifier when exporting and importing action definitions. To ensure that the value you enter is unique, it is recommended that you use the Java name space convention when providing this value. It is also useful to include the Menu Item Label value as part of the unique key as shown in the following example:

com.<company_name>.nnm.menu.item.<menu_item_label>

Type a maximum of 80 characters. Alpha-numeric and period characters are permitted. Spaces and underline characters are not permitted.

Caution This value cannot be changed after you click the Save icon.

Author

Indicates who created or last modified the Menu Item.

If the Author attribute value is Network Node Manager, any changes are at risk of being overwritten in the future.

  • Click  Lookup and select  Show Analysis to display details about the currently selected Author.
  • Click  Quick Find to access the list of existing Author values.
  • Click  New to create an Author value.
Parent Menu

Specify where this action appears in the NNMi console's expandable menu structure:

  • Select any existing parent-level menu item from the drop-down list.
  • Create a new parent-level menu item. See Create Menu Nesting for more information.
Ordering

A numeric value. NNMi checks for configuration settings in the order you define (lowest number first). NNMi uses the first match found to determine the placement of this Menu Item within the group you configure.

The Ordering numbers are calculated separately for each submenu group.

Tip It is recommended that ordering numbers are incremented by 10s to provide flexibility over time.

Prepend Separator

Based on the Ordering number, inserts a separator line above this menu item.

Tip Use this attribute to separate unrelated menu items.

Enabled

Use to temporarily disable a Menu Item configuration (when disabled, the Menu Item does not appear under the specified Parent Menu):

Disable  = Temporarily disable the selected configuration.

Enable  = Enable the selected configuration.

Selection
Attribute Description
Selection Type

Optional. The default is Single Selection.

The Menu Item is always available if you specify No Selection or Any Selection.

  • If you specify any of the following, an error message appears when the user launches the action before selecting an appropriate object or objects:

    • Any Selection means zero or more selections required.
    • Single Selection means exactly one selection required.
    • Multiple Selection means one or more selections required.
  • If you specify No Selection, the user must launch the action without selecting any objects. An error message appears if any objects are selected.

Only for Multiple Selection or Any Selection

Attribute Description
Max Selection
Count
Only valid if Selection Type = Any Selection or Multiple Selection. Zero means unlimited. Specify the maximum number of objects the user can select before launching this action.
Path View Only

If  enabled, your action appears only in the Path View window's menu. See Attributes per Object Type for Full URLs for additional information about Path View Full URL configuration choices.

If  disabled, your action can appear in the menu of multiple views.

Description
Attribute Description
Description

Optional. Provide a description of your action. Your description is visible only within this configuration form.

Type a maximum of 1024 characters. Alpha-numeric, spaces, and special characters (~ ! @ # $ % ^ & * ( ) _+ -) are permitted.