Create or modify Dependency Views map indicators

Dependency Views maps uses icons to display additional information for a CI by displaying its related records such as alerts, outages, incidents and problems. These icons are called map indicator.

About this task

The default configuration includes map indicators for the following record types:
  • Open incident.
  • Open alert.
  • Unplanned current outage.
  • Planned current outage, or an open problem.
  • Current, planned, or recent change request.

You can filter out the display of affected CIs, alerts, current change requests, incidents and problems from the Settings menu. Also, you can create a map indicator to define additional record types, such as trouble sources for business service CIs. You can also modify an existing map indicator, for example to use a different color scheme or to alter the priority of a task.

The Affected CI’s map indicator appears for CIs in two related but not identical situations. It appears for CIs for which tasks such as change request, incident, or problem were directly created for, and for any CIs that were added in those tasks (parent tasks) as Affected CIs (The CI for which a task is directly created for, is automatically added as an affected CI in that task). The state of affected CI’s depends on the status of the respective parent task. For as long as the parent task is active, the associated affected CIs continue to be impacted by the task issue. In a Dependency Views map, the Affected CI’s indicator displays for all affected CIs for as long as the parent task is active. On a Dependency Views map, the Affected CI tooltip displays the details of the task records in which the CI was added as an affected CI. However, the Details pane does not contain an Affected CI’s tab, and no further details about affected CIs, or the associated tasks are displayed. After the parent task is closed, the Affected CI’s indicator no longer displays for any of the tasks’ affected CIs. For information about affected CIs in Change Management, see Associate CIs to a change request.

Note: Details about affected CIs are derived from the task and the cmdb_ci tables and their extensions. Therefore, if you use custom tables to store CIs for incidents, problems and changes, it affects the details that are displayed for affected CIs.

For more information on how map indicators are used to show tasks and outages in clusters and collapsed nodes, see Cluster nodes in a Dependency Views map.

Procedure

  1. Navigate to Dependency Views > Map Indicators.
  2. Click New to create a new map indicator, or click the name of an indicator from the Table column to modify an existing map indicator.
  3. Fill in the fields on the form, as appropriate.
    Table 1. Map Indicator form
    Field Description
    Table Name of the table represented by this map indicator.

    Note: The list shows only tables and database views that are in the same scope as the map indicator. Views are not supported, although included in the list.

    Name Name of the indicator.
    Order Priority order of the task. The highest priority task is the indicator with the lowest order number. When more than one indicator is present on a CI, the displayed color is the color associated with the highest priority task.

    Additionally, a glyph on a CI displays the color indicator of the highest priority task attached to that CI.

    Node color This field is used for backward compatibility.
    Icon File name and path of the icon image file, which can be a system image.
    Active Name of the field on the selected table to be associated with the map indicator.
    CMDB CI field Name of the field on the selected table that contains the configuration item.
    Start field This field is used for backward compatibility.
    End field This field is used for backward compatibility.
    Description field Name of the field on the selected table that contains the description of the configuration item.
    Description Text to display when hovering over the indicator. Alphanumeric characters and spaces are valid for this field.
    Conditions Condition builder that specifies for which CIs to apply this indicator. For example, a CI that has a current past outage is highlighted for 5 days. You can configure a condition to designate a different timeframe for what is considered to be current.
    Active Dependencies Check box to enable display of the indicator in a Dependency Views map.
    Label Text to display for the indicator on the map.
    Tooltip Label The prefix portion of the tooltip (Tooltip Label : Tooltip info).
    Tooltip Info The suffix portion of the tooltip (Tooltip Label : Tooltip info).
  4. Click Submit to enter a new map indicator. Click Update to modify an existing map indicator.

Result

For an indicator to appear in a Dependency Views map, a CI must meet all filter conditions, and Active Dependencies must be selected.