Skip to main content
Version: 4.3

Navigation Trees

A navigation tree is a hierarchical representation of CMDBuild cards.

Each level of the tree represents cards belonging to a class and linked to cards of the parent class through a domain.

Navigation trees are used in several CMDBuild features:

  • to define filters applied to the relation graph, excluding relations that are not relevant for navigation
  • to create hierarchical structures in the application menu, configured in Menu management
  • to configure hierarchical navigation structures for georeferenced items on maps, configured in GIS management

Menu‑based and GIS‑based navigation trees are described in their dedicated chapters.

This section focuses on navigation trees used for all other purposes.

Properties​

This function allows creating new navigation trees and managing existing ones.

Available operations:

  • create a new navigation tree
  • edit a navigation tree
  • delete a navigation tree
  • disable a navigation tree by marking it as inactive

Properties

Each navigation tree requires the configuration of a set of metadata properties.

General Properties​

The following information is required:

  • Name: name of the navigation tree
  • Description: description displayed in the application. This field supports localization through the flag icon, which opens a dialog for entering translations in the enabled languages
  • Source class: root class from which the navigation tree starts
  • Active: enables or disables the navigation tree

General Properties

Starting from the root class, CMDBuild displays the hierarchy of related classes.

For each class in the navigation tree, the following parameters can be configured:

  • Domain: domain used to populate the next level of the hierarchy
  • Class: for the selected domain, allows choosing a specific subclass when the target class is a superclass
  • CQL filter: filter used to restrict the list of displayed cards
  • Recursive: enables recursive navigation when supported by the selected domain

Navigation Tree Definition