Administer > Integrate NNMi Elsewhere with URLs > Launch a Form (showForm/showConfigForm) > Incident Form

Launch an Incident Form

Note If you copy/paste this URL, remove the spaces that were added for line-ending purposes in the documentation.

http://<serverName>:<portNumber>/nnm/launch?cmd= showForm&objtype= Incident&objid= <x>

http://<serverName>:<portNumber>/nnm/launch?cmd= showForm&objtype= Incident&objuuid= <x>

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.

Note: If you are using Mozilla Firefox or Google Chrome, Closedclick here for more information.

Due to the Mozilla Firefox security implementation, launching an NNMi form with a URL has the following limitations:

  • The Close button does not work.
  • The File → Close menu item does not work.
  • The Save and Close button saves data, but does not close the window.
  • The File → Save and Close menu item saves data, but does not close the window.

Use the browser buttons to close the form.

Individual incident objects must be identified by their database unique identifiers.

Incident Attributes
Attribute Values
objid

The Unique Object Identifier (unique per object type in the NNMi database).

NNMi displays the id attribute value on the object form's Registration tab.
objuuid

The Universally Unique Object Identifier (unique across all databases).

NNMi displays the uuid attribute value on the object form's Registration tab.

The following are optional filter parameters: 

http://<serverName>:<portNumber>/nnm/launch?cmd= showForm&showForm&objtype= Incident&objid= <x>&menus= <true/false>&envattrs= <name1= value>;<name2= value>

Note If you copy/paste this URL, remove the spaces that were added for line-ending purposes in the documentation.

Attributes for Launched Forms
Attribute Values
menus

true = Show the view menus and the Close button. If not specified, the default is true.

false = Hide the view menus and the Close button to save space in the view.
envattrs

Use Environment Attributes (envattrs) to pass <name=value> pairs from an external application to NNMi. Environment Attributes are session-specific and stored in memory (not in the NNMi database). The name-value pairs can be any arbitrary string (as required by the external program).

For example, let’s assume that NNMi was launched from an application that wants to preserve a session ID (123) and object attribute (node25) as follows:

http://<yourServerName/nnm?cmd= showView&objtype= Node&envattrs= com.my.sessionId= 123;com.my.objectName= node25

Note See Pass Environment Attributes for information about how to retrieve these Environment Attributes (envattrs) <name=value> pairs from NNMi, and pass them back to the originating external application.

Send Help Center feedback