Administer > Integrate NNMi Elsewhere with URLs > Launch a View (showView)

Launch a View (showView)

Tip This technique launches views independent of the NNMi console. When using this URL method, do not launch the view into a browser window where the NNMi console is currently running. (If you are using Mozilla Firefox, see also Configure Mozilla Firefox Timeout Interval.) To continuously display up-to-date information in your network operation center (NOC), launch an Integration URL view.

To launch a default table view that displays all instances of a specified object type, use the following URL:

http://<serverName>:<portNumber>/nnm/launch?cmd= showView&objtype= <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 HelpDocumentation LibraryIntegrate 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.

Default View for Each Object Type and Available Filters
x = objtype Value Default View Node
Filter
Interface
Filter
Incident Incidents workspace, All Incidents table view Yes No
Node Inventory workspace, Nodes table view Yes No
Interface Inventory workspace, Interfaces table view Yes Yes
IPAddress Inventory workspace, IP Addresses table view Yes Yes
IPSubnet Inventory workspace, IP Subnets table view No No
NodeGroup Inventory workspace, Node Groups table view No No
InterfaceGroup Inventory workspace, Interface Groups table view No No

The following are optional filter parameters:

http://<serverName>:<portNumber>/nnm/launch?cmd= showView&objtype= <x>&nodegroup= <Name> 

http://<serverName>:<portNumber>/nnm/launch?cmd= showView&objtype= <x>&ifgroup= <Name>

Filter by Node Group (launched Incident, Node, Interface, and IP Address views)
Attribute Values
nodegroup

The case-sensitive Name attribute value of the Node Group to use as a filter for this view.

Note The Node Group name is translated. If your team shares NNMi within multiple locales, use nodegroupid or nodegroupuuid.

If the Name value includes space characters, consider replacing the space character in your URL statement (see W3C Rules for URLs).

nodegroupid

The id is the Unique Object Identifier (unique across the entire NNMi database). Provide the id of the Node Group to use as a filter for this view.

This attribute value is not visible on any form within the console. To find this value, use the nnmconfigexport.ovpl command-line tool to export an XML file that includes the id attribute value for each object instance.

nodegroupuuid

The uuid is the Universally Unique Object Identifier (unique across all databases). Provide the uuid of the Node Group to use as a filter for this view.

This attribute value is not visible on any form within the console. To find this value, use the nnmconfigexport.ovpl command-line tool to export an XML file that includes the uuid attribute value for each object instance.

Filter by Interface Group (launched Interface and IP Address views)
Attribute Values
ifgroup

The case-sensitive Name attribute value of the Interface Group to use as a filter for this view. 

Note The Interface Group name is translated. If your team shares NNMi within multiple locales, use ifgroupid or ifgroupuuid.

If the Name value includes space characters, consider replacing the space character in your URL statement (see W3C Rules for URLs).

ifgroupid

The id is the Unique Object Identifier (unique across the entire NNMi database). Provide the id of the Interface Group to use as a filter for this view. 

This attribute value is not visible on any form within the console. To find this value, use the nnmconfigexport.ovpl command-line tool to export an XML file that includes the id attribute value for each object instance.

ifgroupuuid

The uuid is the Universally Unique Object Identifier (unique across all databases). Provide the uuid of the Interface Group to use as a filter for this view. 

This attribute value is not visible on any form within the console. To find this value, use the nnmconfigexport.ovpl command-line tool to export an XML file that includes the uuid attribute value for each object instance.

The following are optional parameters: 

http://<serverName>:<portNumber>/nnm/launch?cmd= showView&objtype= <x>&menus= <true|false>&newWindow= <true|false>&readonly= <true|false>&readonlygroupselector = <true|false>&envattrs= <name1= value>;<name2= value>

Attributes for Launched Views
Attribute Values
menus

true = Show the view's button bar. If not specified, the default is true.

false = Hide the view's button bar to save space in the view.

newWindow

true = Display the view in a new browser window. This new window does not display the browser-specific menu bars. The browser-specific menu bars are hidden to provide the maximum amount of room for the requested view.

false = Display the view within the current browser window (if not specified, the default is false).

readonly

Caution The readonly setting overrides the readonlygroupselector setting. This means that when readonly is set to true and readonlygroupselector is set to false, users are able to change the Node Group filter.

true = Prevents the user from doing either of the following:

  • Open any forms from the view
  • Manipulate any objects in the view (for example, delete an object)

false = Enables the user to do either of the following:

  • Open any forms from the view
  • Manipulate any objects in the view (for example, delete an object)
readonlygroupselector

Caution The readonly setting overrides the readonlygroupselector setting. This means that when readonly is set to true and readonlygroupselector is set to false, users are able to change the Node Group filter.

true = Prevents the user from selecting a Node Group.

Note When readonlygroupselector is set to true, the Node Group filter selection box appears disabled.

false = Enables the user to select a Node Group.

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.

If you want to launch some other view, specify the view rather than the object type:

http://<serverName>:<portNumber>/nnm/launch?cmd= showView&view= <x>

For more information, see: