CI Relationships
On this page
A relationship connects two objects, for example a configuration item (CI) and a ticket, or two CIs, so that each side sees the relation from its own side. A relationship type is a directed pair of names: one name reads the relation from one side, and the inverse name reads it from the other side. The Admin Center presents a type whose two names are the same, ignoring case, as a Sibling type, and any other type as a Parent-Child type.
Which classes can take part in a relationship type is administrative data, set up in the Admin Center; see Object Relationship Map.
A relationship is not added a second time when one of the same type already joins the same two objects in the same direction, and an object cannot be related to itself.
Adding or removing a relationship writes a Relationship entry into the history of both objects. The entry names the other object by its class, ID, and name. Changing a relationship's type also writes an entry into the history of both objects. That entry names the other object by its ID, or by its name, and records the old and new type names, each as read from that object's side of the relation.
In the Web App
The record's Relationships tab lists its related objects as a tree, and can show them as a map instead. Add Relation, Modify Relation, and Unrelate are unavailable while the record is read-only.
View related objects
The tree's first level has one group row per relationship type, captioned with the type's name and a count in parentheses. Under each group are the record's related objects of that type.
- Use the Filter menu to narrow the tree's first level, and the map, to All, CIs, Tickets, or Impact Analysis. The menu's button shows the current choice. The filter starts at All each time the tab opens.
- Select Show only active to list only active related objects.
- Click a related object's link, double-click its row, or use Open to go to that object's page. It opens in the current window, or in a new tab when your setting to open objects in a new window is on.
Your Show only active, View as map, and Vertical choices are saved in your user settings and apply the next time you open the tab.
View the relationship map
Select View as map to replace the tree with a map. The map runs left to right, or top to bottom while Vertical is selected. A record with no relations shows No data to display.
- The root node is the open record, with its ID, name, status, and class icon.
- Under the root is one group node per relationship type, showing the type's name. The number of its objects appears in a badge while you point to the node or it has focus. Each group node starts collapsed; expand it to see its objects.
- An object node shows its class icon, ID, name, and status. An object with relations of its own expands on demand, showing its related objects grouped by type one level deeper. An object you do not have permission to view cannot be expanded, and under the Impact Analysis filter no object below the first level can be expanded.
To work with the map:
- Hold Ctrl and use the mouse wheel, or pinch with two fingers on a touch screen, to zoom between half and seven times the map's size. Without Ctrl, the mouse wheel does not zoom the map. The map has no zoom-in, zoom-out, or fit button.
- Drag anywhere except a node to move the map. The map cannot be dragged so that its left or top edge passes the edge of its area.
- Press Tab to move to a node; this clicks the node, as a mouse click would. On a focused node, press Space to show or hide its children.
- Hold Ctrl and click an object node to open the object in a new tab, unless that node already has focus.
- Point to an object node and click its ⋮ button. The root and the group nodes have no such button. The menu offers Open, which replaces the current page with the object whatever your setting to open objects in a new window, Open in new tab, Details, which opens the object's preview form, and, under Actions, the object's workflow actions. An action that is not available is shown disabled, and a named group of actions appears as a submenu. When the server returns a message instead of actions, that message is the only entry under Actions.
While the map is shown, the tab keeps the Filter menu, Add Relation, Modify Relation, Unrelate, Show only active, View as map, Vertical, and a Refresh button.
Select relations
In the tree, select a relation with its row's check box, or by holding Ctrl or Shift and clicking the row. A plain click on a row only focuses it and clears the selection. Group rows, the relations of field-link types, and rows below the first level cannot be selected with a check box, and select-all passes them by.
On the map, click an object node on the first level below a group to select its relation. Group nodes, deeper nodes, and the relations of field-link types cannot be selected on the map.
Relate an object
- On the record's Relationships tab, click Add Relation.
- In the Select object from list dialog, find the objects to relate. The dialog opens on All Tickets when you may view tickets, and otherwise on the first class in the drop-down beside the search box. It lists results at once unless your setting not to prepopulate select dialogs is on. To relate other objects, such as CIs, pick another class in the drop-down beside the search box, and then click Search.
- Select one or more objects, and then click Select.
- In the dialog that opens, choose the relationship type, and confirm. Only the types valid for both classes are offered; when you selected several objects, only the types common to all of them are offered.
If your selection includes the record you started from, an alert tells you that you cannot relate an object to itself, and no relationship type dialog opens.
Change a relationship type
- On the Relationships tab, select exactly one relation.
- Click Modify Relation. The button is available only when exactly one relation is selected.
- In the Relation dialog, choose a different type, and confirm. Only the types valid for both classes are offered.
The tree, the map, and the tab's counter refresh.
Remove relationships
- On the Relationships tab, select one or more relations.
- Click Unrelate.
- At Remove selected relationships?, confirm.
The selection clears, and the tree, the map, and the tab's counter refresh.
To remove a field-link relation, clear or change the record's field that holds it; see Field-link relationships.
Field-link relationships
Some relationship types are field-link types: a relation of such a type is held by a field of the record rather than stored as a separate relation. The Relationships tab shows these relations like any other. Field-link relations come from these fields:
- the CI that an incident, problem, change request, work order, or service request is related to
- the change request of an incident or a problem
- the problem an incident is related to
- the CI that an asset or a configuration is associated with
- the asset of a library item
A field-link relation leaves the Relationships tab when the field that holds it is cleared or pointed to another object, whether a technician or a workflow updates the field. Adding or removing a field-link relation does not write a Relationship entry into the history of either object. A workflow's Unrelate operation removes stored relations only, so it does not remove a field-link relation; see Operations Reference.
Related topics
- Object Relationship Map - set up relationship types and which classes can use them, in the Admin Center.