Displaying references as a tree

Select the “Tree” widget type to display references as a tree. In this tree each node representing a referred object may also have sub-nodes representing referred objects of this object and so on.

Most of the options that you can specify for the tree representation are the same as for the table representation. Tree-specific options are explained below:

Tick this checkbox to get the tree to automatically expand nodes at all levels.

Clicking on this property brings up the “Tree Contents” dialog. There are two radio buttons in this dialog. Select the “Show all objects in the tree” radio button if you do not want to impose any limitations on which objects should be included in a tree. When you select this option all references of the encountered objects will be included in the tree.

Select the “Show types selected in the table below” radio button if you want to impose limitations on which business objects and attributes should be included in the tree. You will then need to define which robjects you want the tree to show.

In the pane on the left you can choose which business objects will be included in the tree by ticking the box next to the object’s name. When you do this reference attributes of this object will be displayed in the right pane. You can either select that all reference attributes of the selected object will be considered when building a reference tree or select particular attributes by ticking a box next to the attribute’s name. You can also tick a box indicating whether the details of the selected object should be displayed in a tree. This may be useful if you want to consider reference attributes of the object in a tree, but you don’t actually want to display the details of the object itself.

One of the common examples of selecting particular references to be shown in a tree is when you have a hierarchical object and you want to display this hierarchy in a tree. In the example shown on the picture below the Part object has Components attribute that also refers to the Part object – in other words, a Part can have other Parts, which can have their own Parts etc. If you want the tree to show this hierarchy you would select the Part object and its Components attribute to be displayed in a tree, but not any other objects or attributes. The result is show on the picture below: