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

Configure the relationships to query on

Configure the type of relationships that you want to query for in CMDB Query Builder. For example, configure which CI on the canvas is the parent and which is the child in the relationship or the level of relationships to query on.

Before you begin

Role required: cmdb_query_builder_read

About this task

When you connect CI classes on the canvas, the CMDB Query Builder displays the Connection Properties in the right-side bar, where you can configure the properties of the relationship to query on. For Service Mapping queries, you can also configure whether to query for related or unrelated CIs.

Note: Newly added relationships between CI classes might take up to 30 minutes to appear in the relationship list.

Procedure

  1. While adding CIs to the canvas, select a connection box on a CI and then select the connection box on another CI that you want to create a relationship with.

  2. Configure the relationship properties in the Connection Properties side-bar.

SectionFieldDescription
Relationship Direction

Parent

Child

Set the relationship direction. Which CI class is the parent and which CI class is the child in the relationship.
Relationship LevelsLevelQuery only on first-level relationship or also on second-level relationships.
Relationship Types and Related ItemsNo RelationshipsSelect to query for CIs which have no relationships to the set class.
Relationship Types and Related ItemsSelect Add Relationship TypesQuery for CIs and descending classes with specific relationship types.
Relationship Types and Related ItemsSelect Add a Related ItemQuery on related CIs using a field that the parent and ancestor parent CI classes use to reference the child CI class.
  1. Select Save.

Related topics

CMDB groups