Use > CMS Modules > Home > Work with Home > How to work with the Topology Map

Working with the Topology Map

The Topology Map provides a graphical display of a view. All the CIs in a given layer of the view are represented by icons together with connecting links that represent relationships between CIs. If there is more than one relationship between the same two CIs, only one connecting link is displayed. The connecting link is thicker, with no direction. To view all the existing relationships between the same two CIs, click the connecting link, and then click the Configuration Item Details button () to display the CI Links pane. In the CI Links pane, you can view the number of relationships between the two CIs, relationships types and directions.

The topology map is automatically updated dynamically with changes in the IT Universe data, such as new CIs discovered by the Data Flow Management process.

The Topology Map can display up to 200 objects in Internet Explorer and 2000 objects in other browsers. Layers in views that contain more than this number of items, are split into chunks of 200 (in Internet Explorer) or 2000 (in other browsers) CIs. If an object on the Topology Map has an additional CI layer beneath it, a count indicator above the CI icon displays the total number of CIs in all the sublayers under it.

Display the Topology Map for a view

To display the Topology Map for a view, hover the mouse over the view's widget, and then click the Map mode icon () in the top-right corner of the widget.

Tip  

  • To switch between displaying the view in map mode and text mode, click the Map/Text toggle button ().
  • To open a report in the Text mode directly, click the report widget in the Home page.

Navigate the Topology Map

The toolbar at the lower left of the Topology Map enable you to change the magnification level of the Topology Map, quickly navigate around a large Topology Map, and configure the Topology Map.

  • Click the Fit to Screen icon () to expand or shrink the Topology Map so that all CIs fit in the pane.
  • Click the Zoom Out () or Zoom In () icons to zoom out or zoom in the Topology Map.
  • Click the Original Size icon () to return the Topology Map to its original zoom level.

  • Click the Overview icon () to display the quick navigation map. The quick navigation map overlays a selected area (which represents the currently displayed area of the Topology Map) over a representation of the whole Topology Map. You can drag and resize the selected area in the quick navigation map to zoom in or out and to jump directly to a particular part of the Topology Map.

Configure the Topology Map

Change the layout of the Topology Map

To change the layout of the Topology Map, click the Layout Settings icon () in the toolbar. Then, select one of the following options from the Layout drop-down list:

  • Hierarchical layout.
  • Orthogonal layout.
  • Radial layout.
  • Circular layout.
  • Tree layout.
  • Organic layout.
  • Balloon layout.
  • Swimlanes layout.

Change the grouping of the Topology Map

To change the grouping of CIs in the Topology Map, click the Layout Settings icon () in the toolbar. Then, select one of the following options from the Grouping drop-down list:

  • None.

  • CI Type.

    Note When you group the CIs by CI Type, the default layout of the Topology Map is Organic, and you cannot change it. The Change Layout option is not visible.

    When you change the grouping to None, the Change Layout option is available, and the Organic layout is selected.

Work with CIs on the Topology Map

Search for CIs

To search for a specific CI or for all CIs of a single type in a Topology Map, follow these steps:

  1. Click the More icon () to expand the More menu, click the Locate CI icon (), and then click the Locate CI search box.

  2. To view all CIs of a certain CI Type, select the CI Type from the drop-down list under the search box.

    To search for a specific CI, enter its Global ID in the search box, and then select the CI from the drop-down list under the search box. Or, enter the CI label in the search box, and then select the desired CI from the drop-down list.

View CI details

To view detailed information about a CI, follow these steps:

  1. Search for or drill down to the relevant CI ( to drill down to the CI, double-click on the relevant nodes in the Topology Map until the correct layer is displayed).
  2. Click the CI to display the Configuration Item Details button (), and then click the button to display the CI details pane.

Add layers of CIs

To add a layer of CIs to a Topology Map, click the More icon () to expand the More menu, click the Add layers icon (), and then select a layer from the list. If the layer that you want to add is not included in the list, click More Layers to view the complete list.

Note The Topology Map supports up to 10 layers.

Get related CIs

To identify the CIs that are related to a specific CI, follow these steps:

  1. Search for or drill down to the relevant CI ( to drill down to the CI, double-click on the relevant nodes in the Topology Map until the correct layer is displayed), and then click the CI.

    Note The related CIs functionality does not work if you select more than one CI.

  2. Click the More icon () to expand the More menu, and then click the Get Related icon ().

  3. Click on a CI Type to display all the related CIs of that CI Type, and then select the CIs that you want to view in the Topology Map.

    Tip You can also search for specific CIs by typing the CI label in the Filter search box.

  4. When you have selected all the related CIs that you want to view in the Topology Map, click APPLY. CIs that are added to the Topology Map (that is, related CIs that are not in the currently displayed View) are displayed in purple.

Note  

  • If you click the Get Related icon after you have added some related CIs to a Topology Map, the related CIs that you added are no longer selected. However, they will remain on the Topology Map until you click CLEAR ALL.
  • If you add some related CIs to a Topology Map that already displays some related CIs, both sets of related CIs are displayed together. To clear the Topology Map of the existing related CIs, click CLEAR ALL before you add the new set of related CIs.

View the CI Types of the CIs

To view the CI Types of the CIs, Zoom Out the Topology Map.

View the Core Properties of a CI

To view the Core Properties of a CI, search for or drill down to the relevant CI, and then Zoom In the Topology Map.

The following information is available for each CI:

  • CI icon
  • CI name
  • CI Type
  • UCMDB ID

  • Maximum three Core Properties

    A maximum of three Core Properties are displayed for the each CI, according to the following priorities:

    • The properties that are specific for the CI Type have the highest priority.

    • Special or calculated attributes, according to the CI Type:

      • For Node CI Type: Memory Size, Discovered Model, Discovered OS Name

      • For Running Software CI Type: Application Category, Discovered Product Name

      • For Business Element CI Type: Last Modified Time, Business Criticality

    Note The order in which the Core Properties are presented is the one listed above and cannot be configured.

    The following Core Properties are not displayed for a CI:

    • Name
    • Display Label
    • Attributes with empty values
    • Attributes that are not visible

Configure the Core Properties to be displayed for a CI

To configure the Core Properties to be displayed for a CI in the Topology Map, follow these steps:

  1. In UCMDB, go to Modeling > Modeling Studio.
  2. In the editing pane, right-click the required query node and select Query Node Properties.

  3. Click the Element Layout tab.

  4. Select the attributes you want to include in the query result, and then click OK.

Send Help Center feedback