Interacting with a Tree Object
  • 18 Oct 2024
  • 5 Minutes to read
  • Contributors
  • Dark
    Light

Interacting with a Tree Object

  • Dark
    Light

Article summary

The Tree Object provides the following interactive features:

Any changes made to a Tree Object using the functions listed above will be lost if you leave the Screen or update it, except for data entry actions.

Details popover

When you hover over a secondary node label (the member of the Entity set By Row in the Layout), a Block details popover will appear. The popover will display relevant information related to that member from all Blocks set in the Layout.

contents/assets/images/tree.popover.gif

Pan, zoom, interactive selection

You can drag the mouse over the Tree Object to perform a specific action.

Available actions are:

  • Pan. You can navigate through the tree diagram by dragging the mouse. To reset the map position and zoom to its original state, click the dedicated button contents/assets/images/assets/images/reset-pos-zoom.jpg in the bottom right corner of the Object area

  • Zoom. You can zoom in or out of the tree diagram using the mouse wheel. You can also use the zoom control buttons in the bottom right corner of the Object area. To reset the map position and zoom to its original state, click the dedicated button contents/assets/images/assets/images/reset-pos-zoom.jpg in the bottom right corner of the Object area

  • Interactive selection. To apply a selection, select a set of nodes by holding the Ctrl button and clicking on them, then click the Select icon contents/assets/images/select.window.png that will automatically appear in the sliding toolbar. The selection is applied as a Screen selection and all other Objects on the Screen are updated accordingly. 
    To reset the selection, click the reset button contents/assets/images/refresh.png in the top left corner of the Object area.

Example of interactive selection

contents/assets/images/tree.interactive.select.update.gif

Master

If the Tree has been configured as a Master Object, clicking on a node will update the data displayed by all other Objects on the Screen in order to show only the data relating to the selected node. The Master Object result is similar to applying a Screen selection.

By clicking on the "Disable master" icon contents/assets/images/pin.upward.png in the sliding toolbar, you can disable this option. Click on the "Enable master" icon contents/assets/images/unpin-16.png to re-enable it.

Drill anywhere

The Drill anywhere button allows you to configure a default Drill-down that will be available for all nodes. To configure it, proceed as follows:

  1. Select a node and click on the Drill anywhere icon contents/assets/images/drill-settings-16.png in the sliding toolbar to open a window with the list of Entities you are allowed to drill down on

  2. Select the desired Entity and click APPLY or double click the Entity to save the Drill and to perform it. The configured drill data is always displayed in a Data View

Once the drill is saved, it can be easily performed again by clicking on the Drill down icon contents/assets/images/drill.down.png.

The Drill down configuration process can also be started by double clicking on the item you want to drill down on. The Drill anywhere function is available also in Drill down windows, so you can create your own drill-down paths at different levels of granularity.

Drill-down

Once you have configured a drill using the Drill anywhere function, click the Drill-down button contents/assets/images/drill.down.png to perform it on the selected item or double click on it.

Drill-to-Screen

If a Drill-to-Screen has been configured, the Drill anywhere contents/assets/images/drill-settings-16.png and the Drill-down icons contents/assets/images/drill.down.png won't be available.

In this case, double click on a node or on information displayed in it to follow the drill path from the Tree Object to another Screen of the current Capsule.

Depending on the Drill-to-screen configuration, the destination Screen will open with:

  • A selection based on the Entity member selected (or double clicked) in the Tree Object

  • No inherited selection

Drill-Procedure

If a Drill-Procedure has been configured, the Drill anywhere contents/assets/images/drill-settings-16.png and the Drill down icons contents/assets/images/drill.down.png won't be available.

In this case, double click on a node or on information displayed in it to trigger the configured Procedure or choose from a list of available Procedures.

Depending on the Drill-Procedure configuration, the Procedure will run with:

  • A selection based on the Entity member selected or double-clicked in the Tree Object

  • No inherited selection

Data entry (in drill down windows)

Although the Tree Object doesn't allow it directly, you can perform data entry actions in Data Views displayed in drill down windows. 

See Data entry on Cubes and Data Block settings for more details.

When Data entry is enabled on a Cube, the background of totals cells becomes yellow while the background of values cells becomes beige (unless otherwise formatted), as in the following example:

contents/assets/images/assets/images/ex-de.png

To perform a data entry action, double click on a cell to enter data (either by typing a value, by uploading a file or a picture, by picking a date from a date picker, and so on).

If Save/Undo mode is enabled on the Screen, after you have entered a value, press the save icon contents/assets/images/checkmark.png at the top left of the Data View to actually save the value in the Cube. To do this, you can also press the F9 key on your keyboard.

The undo arrow icon allows to restore the last saved values (i.e. it discards all unsaved changes).

Unsaved values and totals that depend on those values are shown in red. When you press the save icon, their text color will change to match the text color of previously saved values, indicating that all changes have been saved in the target Cube.


When the Data entry option is enabled in the Layout, after you have manually entered data in a cell, the contextual menu (sliding toolbar) in the top left corner of the Data View will automatically show the Save/Undo icons (if Save/Undo mode is enabled on the Screen) and the Lock/Unlock icons (see Lock and Spread for more details).

contents/assets/images/data.entry.save.undo (1).png

contents/assets/images/data.entry.lock.cells1.png

The Object toolbar

When you hover over the Tree Object, the Object toolbar icon contents/assets/images/contextual.menu.3dots.png appears in the top left corner. Click on it to reveal the Object toolbar as a sliding toolbar. You can fully expand it by clicking on the 3 vertical dots on the right.

contents/assets/images/tree.contextual.menu (1).png

In addition to the icons mentioned above, the Object toolbar includes the following icons by default (unless otherwise configured):

  • The Layout icon . Opens the Layout editor

  • XLSX icon contents/assets/images/export.excel.png. Exports data in a MS Excel Worksheet as a flattened table

  • Export printable report to PDF contents/assets/images/export.pdf.png. Export the chart as as a PDF file

  • Export screenshot to .png contents/assets/images/screenshot.png. Takes a screenshot of the chart and saves it as a .png

  • Comment icon contents/assets/images/chat.bubble.png. Displays any comment attached to the chart (if any). Depending on the comment configuration, the icon displayed can be a balloon icon, a question mark icon or an alert icon


Was this article helpful?