Administer > Extend NNMi Capabilities > Control the NNMi Console Menus > Configure Menu Item Context Details > Configure Launch Actions

Configure Launch Actions

[This is the context-sensitive help for User Interface Configuration: Menu Items tab: Menu Items Form: Menu Item Contexts form: Launch Action form.]

The Launch Actions option enables you to configure Menu Items that will appear beneath the NNMi Actions menu structure. These additional menu items can access in-house tools, websites, or a variety of other resources.

To configure Launch Actions that users will access beneath the Actions menu:

Note  You can configure a Launch Actions only for the Actions Parent Menu.

  1. ClosedNavigate to the Menu Item Contexts form.
    1. From the workspace navigation panel, select the Configuration workspace.
    2. Expand User Interface.
    3. Select Menu Items.

    4. Do one of the following:

      • To edit an existing Launch Action menu item, double-click the row representing the configuration you want to edit, and continue.
      • To create a new Launch Action menu item, click the  New icon, and continue.
      • To delete an Launch Action menu item, select a row, and click the  Delete icon.

    5. Provide the Basic details for this Menu Item (see Configure Menu Item Basic Details).

      Caution If the Author attribute value is Network Node Manager, any changes are at risk of being overwritten in the future. See Author form for important information.

    6. Navigate to the Menu Item Contexts tab.
    7. Do one of the following:
      • To edit an existing Menu Item Context, double-click the row representing the configuration you want to edit, and continue.
      • To create a new Menu Item Context, click the  New icon, and continue.
      • To delete a Menu Item Context, select a row, and click the  Delete icon.
  2. Locate the Menu Item Action attribute. Click the  Lookup icon, and click the  New Launch Action icon.
  3. In the Full URLattribute, type the URL and any required additional configuration syntax rules (see Launch Action Basics).
  4. Click  Save and Close to apply your changes and return to the Menu Item Context form.
  5. Limit the use of the Action menu item to a subset of the chosen object-type instances by defining filter criteria (see Specify Optional Menu Item Enablement Filters)
  6. Click  Save and Close to save and apply your changes.

  7. To test your changes to the NNMi console menu:

    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.

      Troubleshooting Tip: If a specified attribute does not exist (for example, you made a mistake when typing the attribute's name), the attribute passes through literally (unresolved). ClosedFor example:

      A node named "mynode" is selected, and the URL is:

      http://example.com?name=${name}&error=${error}

      The output would be:

      http://example.com?name=mynode&error=${error}

Launch Actions Basics
Attribute Description
Name Type a meaningful and descriptive name to help you remember the type of action.
Full URL

Add one or more definitions for the actual URL syntax.

Type the full URL specification. The URL must comply with W3C Rules for URLs. Include any required machine name and port number. Include any required parameters.

  • You can begin with either http:// or https://

    ClosedFor an example, click here:

    To execute a Launch Action requesting something from NNMi:

    http://<serverName>:<portNumber>/nnm/launch?cmd=showMenuItem&key=<MenuItemKey>[&nodename=<hostname or IP_address>

    Note If the NNMi Web server uses the https protocol, use https instead of http.

    <serverName> = the fully-qualified domain name of the NNMi management server (values allowed here are determined by the Enable URL Redirect setting in User Interface Configuration, see Configure the NNMi User Interface)

    <portNumber> = the NNMi HTTP port number

    For a quick-reference list of all URL choices for launching NNMi, see Help → Documentation Library → Integrate NNMi Elsewhere with URLs. The Integrate NNMi Elsewhere with URLs page also contains a link to a list of sample URLs that you can copy/paste as a starting point.

    To execute a Launch Action requesting a script, application, or tool from your environment (not NNMi):

    http://<serverName>:<portNumber>/<application>?<yourURLparameter1>=${<attribute>}&<yourURLparameter2>=${<attribute>}

    Note To extend the NNMi environment with additional applications, you must deploy them into a separate web-server or application-server on the same or different physical server from where the NNMi web-server or application-server is installed. See the Network Node Manager Developer Toolkit for more information.

    <serverName> = the appropriate fully-qualified domain name

    <portNumber> = the appropriate port number

     

  • You can also use other common URL protocols such as ftp://, mailto://, news://, or telnet://.

  • The list of available parameters changes depending on which limiting factors you configure. The & is used as the separator between the <yourURLparameter> and ${<attribute>} pairs. 

    ClosedFor an example, click here: 
    http://example.com/nodeReport.jsp?myNode=${hostname}&mySnmpOid=${systemObjectId}

    If the application that your URL calls is installed on the NNMi management server, the syntax can be as follows:
    /<application>?<yourURLparameter1>=${<Attribute>}&<yourURLparameter2>=${<Attribute>}

See Attributes per Object Type for Full URLs for more information about the valid attributes per Object Type.
Enable Cumulative Launch

If  enabled, any object attribute references in the Full URL are populated with values from all selected objects. The multiple values are separated by a comma character. For example, if the attribute is "name", the URL results would be "name1,name2,name3".

If  disabled, the action launches a separate web page instance for each selected object.

See Attributes per Object Type for Full URLs for details about including object attributes in your Full URL.
Browser Width Optional. When empty, the default browser settings are used. If the value is 1 or more, the browser is launched this number of pixels wide.
Browser Height Optional. When empty, the default browser settings are used. If the value is 1 or more, the browser is launched this number of pixels high.
Add Browser Decorations

If  enabled, the web browser toolbar and menus appear when a user launches your URL.

If  disabled, the web browser has no toolbar or menu when a user launches your URL.

Send Help Center feedback