Skip to main content
Matrix42 Self-Service Help Center



Structures are entities that allow users to display sub-categories by types of data stored in the database. With structures, you can categorize data in the navigation area according to freely definable rules. Names of entities displayed in the hierarchy in the navigation area are taken from the lookup table (represented by the Data Definition or obtained from the Service Operation) you select when creating the structure. A structure must be assigned to a Navigation Item (from the New/Edit Navigation Item dialog) to be displayed in the UI. Structures are, therefore, always child entities in the navigation area. The screenshot below shows a sample structure. 


Structures are created and maintained automatically by the system. Any changes in the database are automatically reflected in structures. 

Features of Structures

  • Defined starting points for process start.
  • Simple creation of object lists and work related lists according to user-definable criteria.
  • Automatic integration in the navigation tree.
  • Transparency and binding.
  • Hierarchic arrangement.

Use of Structures

  • Self-maintaining and self-adjusting.
  • Use of one filter criterion only.
  • Ability to display data according to category, type or status.

Creating a Structure

To create a structure: 

  1. Go to Administration > User Interface > Navigation Items > Structures and click the FAB button in the bottom right-hand corner of the grid.
  2. In the New Structure dialog that appears: 
    • Specify the Name, Description, and Data Definition (pickup) for the structure.
      Note: You may also select the Service Operation option here, instead of Data Definition, if needed, and fill in the remaining fields accordingly. Examples of the use of Service Operations with structures are sparse for the time being, though. 
    • Set up the Item Configuration as follows: 
      • Name: provide an expression for the Data Definition which returns the name of the item. 
      • Data Relation: specify an ASQL expression which sets up projection of the item to the data. 
      • Parent: specify an ASQL expression that sets up the hierarchical relation between items. The expression has to return the ID of the parent item. For non hierarchical data that has no parent child relation you must set this field to the NULL expression.
      • Filter: specify an ASQL expression for filtering the data. Only items of the Data Definition which match the logical expression specified here will be shown. 
    • Click DONE to save and close the dialog. 

Assigning a Structure to a Navigation Item

A structure must be assigned to a navigation item in order to to be displayed in the UI.

To assign a structure to a navigation item: 

  1. Open the navigation item for editing and specify the structure in the Structure field.
  2. SAVE the changes.


  • Was this article helpful?