The tree structure allows you to manage nested hierarchical structures of items, such as the portal header menu and cards. This functionality is intended to reduce work efforts spent on the portal structure configuration. The nested portal items can be managed through a special tree-like structure, making this process easier and more effective.

Use the tree structure to create a node hierarchy with any predefined nesting level that allows you to implement the navigation structure on a portal. 

It is recommended to recreate portal elements (headers and cards) using the tree structure if you are using the customized ones. Otherwise, the errors may occur in the portal header or cards functionality.

A scheme below illustrates the functionality work principles:

Configure a tree structure


To configure a tree structure from scratch, follow the steps below:

  1. Configure a node type.
  2. Configure a tree structure.
  3. Create a node itself and configure its attributes.

Create a node type


To create a node type, complete the steps below:

  1. Navigate to Tree Structures → Node Types.
  2. Click New and fill in the fields.
  3. Click Save or Save and exit to apply the changes.

Node Type form fields

FieldMandatoryDescription
NameYSpecify a node type name (for example, Portal Card).
RE modelNSpecify a record extented model responsible for the final object view and behavior.  
Need URLNSelect this checkbox to define that all objects using this node type will require the URL specification.

Create a new tree


To create a new tree, complete the steps below:

  1. Navigate to Tree Structures → Trees.
  2. Click New and fill in the fields.
  3. Click Save or Save and exit to apply the changes.

Tree form fields

FieldMandatoryDescription
NameYSpecify a descriptive tree name.
Available node typesYSelect node types to use within this structure. You can select more than one item.
Maximum nesting levelYSpecify an integer number responsible for the hierarchy maximum level.
ActiveNSelect this checkbox to activate a tree record.

Create a node


To create a node, complete the steps below:

  1. Navigate to Tree Structures → Trees.
  2. Open a tree record for which you need to create a node.
  3. In the Related Lists area, select the Simple Node tab.
  4. Click New and fill in the fields.
  5. Click Save or Save and exit to apply the changes.

To create a node from scratch, complete the steps below:

  1. Navigate to Tree Structures → Nodes.
  2. Click New and fill in the fields.
  3. Click Save or Save and exit to apply the changes.


Node form fields

FieldMandatoryDescription
TitleYSpecify the node title. This field can be populated in any language supported by the platform.
TreeY

Select a previously created tree containing information about the structure.

You can use the "out-of-the-box" tree. It is called Portal Header Menu and is stored in the Tree (simple_tree) table 

ActiveNSelect this checkbox to make the node active or inactive.
OrderYEnter a number to define the node order. The nodes are sorted in ascending order.
General tab
Access criteriaNSpecify the user criteria defining user access to this node (a card or a header element). If no criteria selected, all users are allowed to use this element and its sub-elements as long as the separate criteria do not protect them.
Node typeNSpecify a node type by choosing from the previously created ones.
Nesting levelY

Node nesting level. This field is populated automatically.

This parameter shows on which nesting level this item is located.

ParentN

Specify a parent item if you are implementing a structure with some nesting levels, like this:

Structure
* Parent item 1

** Child item 1

** Child item 2

** Child item 3

* Parent item 2

** Child item 4

** Child item 5

Extra Attributes tab

This tab appears if the used node type has the RE model specified, and the Need URL attribute of the node type is enabled.
URLY

Specify a URL for an item. In this field, you can specify either absolute or relative URL (relative to the current portal referring to the tree to which the current node is assigned):

Absolute URL: https://instance.example.com/portal/profile

Relative URL: /profile

When a node is created, you can create child nodes for it. To do so, complete the following steps:

  1. In the Child nodes related list, click New.
  2. Fill in the fields as described above.
  3. Click Save or Save and exit to apply the changes.

  • No labels