# Hierarchy Map

## Launch Hierarchy Map

1. Launch the Application Navigator and filter for a target table.

!\[Image]\(../images/d3ef4d8-YouDesign Command-tree\_map1.png)

2. Select the checkboxes for one or multiple elements to build a Hierarchy Map.

!\[Image]\(../images/bd3f5b3-YouDesign Command-tree\_map6.png)

3. Scroll down and select **Hierarchy Map**.

!\[Image]\(../images/bd4538f-YouDesign Command-hm\_new9.png)

### Relationships in ServiceNow

Hierarchy Maps use the following ServiceNow elements:

| Element                          | Function                                                                                                                                                                                                                                                                                     |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Parent/child reference field** | A reference field called "Parent" in ServiceNow that refers to the table itself. This feature allows you to cascade data in a hierarchical structure. The hierarchy starts at level 0, where level 1 elements are children of level 0, and level 0 elements are parents of level 1 elements. |
| **CI Relationships**             | All relationships within the CMDB and YouDesign Command scope are stored in the `cmdb_rel_ci` table. Relationships have a base (starting) element and a dependent (ending) element. Two elements are connected via a relationship type defined as a suggested relationship.                  |

{% hint style="success" %}
**Visualization Resources**

For a more fundamental overview of using visualization in YouDesign Command, see [Edit Relationships](doc:relationship-editor-edit).
{% endhint %}

## Hierarchy Map UI Overview

The Hierarchy Map UI consists of three main elements:

* [**Hierarchy Map**](doc:hierarchy-map#hierarchy-map) – Visualizations are rendered here.

!\[Image]\(../images/e042b4d-YouDesign Command-hm\_ui1.png)

* [**Overlay Menu**](doc:hierarchy-map#overlay-menu) – Provides quick access to main features including [editing](doc:hierarchy-map#editing-mode), export, and fullscreen.

!\[Image]\(../images/1e94c06-YouDesign Command-hm\_ui2.png)

* [**Sidebar**](doc:hierarchy-map#sidebar) – Enables you to apply filters to the visualization and change container background colors based on indicators. The sidebar automatically disappears after 2 seconds. Hover your cursor over the visualization to reveal it again.

!\[Image]\(../images/f01db10-YouDesign Command-hm\_ui3.png)

{% hint style="info" %}
**Real-Time Indicators**

Real-time indicators allow users to color code data based on field values. These heat maps and visualizations enable audiences to quickly identify risks and issues for further analysis.
{% endhint %}

## Hierarchy Map

Hierarchy maps offer an excellent way to visualize complex data in an easy-to-understand format. The relationships between objects are removed, and the content is rendered as nested containers. Each Hierarchy Map consists of the following elements.

### Top Level Capability

* **Level Capability** – Shows the top-level capability (level 0), the parent container with all child elements. This container has three levels.

!\[Image]\(../images/cbf161d-YouDesign Command-hm\_new1.png)

* **Rolled-up Objects** – Shows the number of rolled-up objects. You can adjust the rollup count in the [Sidebar](doc:hierarchy-map#sidebar).

!\[Image]\(../images/e680a33-YouDesign Command-hm\_new2.png)

* **Collapse Button** – Select the open/close button to hide or reveal the table's contents.

!\[Image]\(../images/fc20ee5-YouDesign Command-hm\_new3.png)

### Table Elements

Each table consists of the following elements:

* **Icon** – An icon associated with the table.

!\[Image]\(../images/02676b2-YouDesign Command-hm\_new4.png)

* **Table Name** – The table name for each node in each container.

!\[Image]\(../images/9e6dff3-YouDesign Command-hm\_new5.png)

* **Element Name** – Name associated with each element.

!\[Image]\(../images/8b927e0-YouDesign Command-hm\_new7.png)

* **Colored Real-Time Indicator (Optional)** – You can select a color for the containers and nodes in the [Sidebar](doc:hierarchy-map#sidebar).

!\[Image]\(../images/de3088f-YouDesign Command-hm\_new6.png)

{% hint style="info" %}
**Form View Access**

Right-click on a node or container to access its form view in ServiceNow.
{% endhint %}

## Overlay Menu

The Overlay Menu has the following features:

* **Edit Button** – Toggle between static and edit mode by selecting the Edit button.

!\[]\(../images/44e8f1c-YouDesign Command-hm\_new8.gif)

* **Options** – Select the Options menu to export the visualization as a PNG file. 

!\[Image]\(../images/6742ac8-YouDesign Command-hm\_edit\_buttons1.png)

* **Scale to Fit** – Scales the visualization to fit your screen's width.

!\[Image]\(../images/5e72bee-YouDesign Command-hm\_edit\_buttons2.png)

* **Fullscreen** – Triggers your browser's fullscreen mode, expanding the visualization to fill the entire screen.

!\[Image]\(../images/3facfce-YouDesign Command-hm\_edit\_buttons3.png)

* **Toggle Sidebar** – Select this button to collapse the Sidebar.

!\[Image]\(../images/846f8ba-YouDesign Command-hm\_edit\_buttons5.png)

* **Add New Node** – (Only available in edit mode) Select **+** to add new nodes. Refer to [Editing Mode](doc:hierarchy-map#editing-mode) for more information.

## Sidebar

The Sidebar contains various widgets to change the visualization content. 

### Level Selector

Use the **Level** widget in the Sidebar to collapse containers.

!\[Image]\(../images/06b51c5-YouDesign Command-hm5.gif)

### Hierarchy Selector

The **Hierarchy** widget allows you to search within the hierarchy tree and select or unselect elements within the hierarchy. 

!\[]\(../images/5436373-YouDesign Command-hm6.gif)

### Rollup Count

The **Rollup Count** widget counts all elements (nodes) within the hierarchy and visualizes the total with a number on the level 0 container. 

Click on the rollup count number to see a list of nodes. 

!\[]\(../images/0f2d291-YouDesign Command-hm7.gif)

### Indicators

Real-time indicators allow users to color data based on any field value. The resulting heat maps and visualizations help audiences identify risks and issues for further analysis.

Select a defined Indicator from the **Indicator** widget within the Sidebar to color nodes and containers of the hierarchy map. You can select labels to hide or show the corresponding nodes and containers in the hierarchy map.  

![](https://www.ins-pi.com/hubfs/Editable%20Hierarchy%20Map%20Indicators-gif.gif)!\[]\(../images/8a2f58a-YouDesign Command-hm8.gif)

### Class Filters

Class Filters help you quickly remove a specific object type (table) from the hierarchy view. 

There are two primary functions:

1. Hover over a table name to highlight the nodes on the hierarchy map. 
2. Click on a table name to unselect and hide the nodes from the hierarchy map. Click on the table name again to select and show the nodes on the hierarchy map.  

![](https://www.ins-pi.com/hubfs/Editable%20Hierarchy%20Map%20Class%20Filters-gif.gif)!\[]\(../images/fc7d3ea-YouDesign Command-hm9.gif)

### Editing Mode

A core feature of Hierarchy Map is the *Edit* function.

## Creating a new Node

Clicking the **Edit** button will enter the editing mode, so you can add new nodes to the hierarchy map (see point #6). Once the editing mode is entered, the edit button changes to **Stop Edit**. Click "Stop Edit" to leave the editing mode. \
Note that the filtering options in the Sidebar will disappear, and the history will appear. 

Now, click the "**+**" button and enter a Name. Click the **Create** button to create a new Node. 

!\[]\(../images/5c6a98c-YouDesign Command-hm10.gif)

### Moving a Node via drag & drop

Drag the newly created Node and move it to the target position. Drop it at the hierarchy position where you want to add it as a child or parent. Of course, you can change the hierarchy levels for any node of the starting table. 

!\[]\(../images/25189aa-YouDesign Command-hm11.gif)

### Undo changes

The *History of Node Movements* in the Sidebar is visible during the edit mode and will show you the recent movements done.

Select the *arrow* button to undo the change.

Please note that the creation process is permanent.

!\[]\(../images/69a5904-YouDesign Command-hm12.gif)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ins-pi.com/command/visualizations/hierarchy-map.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.