Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Create or modify a connection using the map editor

Use the map editor to add a relationship between two CIs or to modify an existing relationship.

Before you begin

Role required: sn_cmdb_admin or sn_cmdb_editor

About this task

  • A solid line indicates a relationship. The arrowhead indicates the dependent node.
  • A dashed line indicates a reference.
  • A badge on a line indicates the number of relationships between the CIs.

Two CIs might be connected by one or more relationships (stored in the CI Relationship [cmdb_rel_ci] table). For example, two CIs might be connected by the Runs On::Runs, Depends On::Discovered From, and by the Owned By::Owns relationships.

You can learn more about relationships at CI relationships in the CMDB.

The map editor does not support the following actions:

  • Editing mapped application services (service instances).
  • Deleting reference or endpoint connections or removing from the map a CI that has reference or endpoint connections.
  • Updating the applicative flow relationship type (connection between endpoint CIs).

Note: At any time, select the reset icon

Image omitted: icon-um-reset-map.png
No alternative text supplied

to undo all unsaved changes.

Procedure

  1. While editing a map, specify whether to create or modify a connection.
ActionProcedure
Create a connection

Take one of the following actions:

  • Select and hold (or right-click) a CI and select Connect to.
  • Select a CI for the connection (either the parent or the child) and then select the Manage connection icon
    Image omitted: icon-um-edit-connection.png
    No alternative text supplied
    .
Modify an existing connection

Take one of the following actions:

  • Select the connection and then select the Manage connection icon
    Image omitted: icon-um-edit-connection.png
    No alternative text supplied
    .
  • Select a CI for the connection (either the parent or the child) and then select the Attributes icon
    Image omitted: icon-um-attributes-panel.png
    No alternative text supplied
    . All connections for the CI are listed in boxes.
    Image omitted: um-editor-attrib-card-cxn.png
    No alternative text supplied
    Select Change.
Delete a connectionFor instructions, see Delete a connection using the map editor.
  1. On the Manage connection panel (
Image omitted: icon-um-edit-connection.png
No alternative text supplied

), specify the settings.

FieldDescription
Source CI

You can select the swap icon

Image omitted: icon-um-edit-swap.png
No alternative text supplied
to swap source and target.

Note: In the context of a CI relationship, this is the parent CI.

Target CI

You can select the swap icon

Image omitted: icon-um-edit-swap.png
No alternative text supplied
to swap source and target.

Note: In the context of a CI relationship, this is the child CI.

Show suggested relationshipsOption to control the contents of the Relationship type selection box: The relationship types that are most appropriate for the two CIs appear at the top of the list.
Relationship typeThe relationship between the CIs. For example, the relationship between the parent ‘Tomcat’ and the child ‘WAR File’ is Contains::Contained By.
  1. When you have specified all connection settings, select Change to change an existing connection or Create connection to add a connection.

Related topics

CI relationships in the CMDB

Suggested class relationships

Add a suggested relationship

Editing maps in Unified Map

Delete a connection using the map editor