Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Tip

Role required: admin.

In SimpleOne, navigation is based on these entities:

  • Categories (physically stored in the Menu Category (sys_menu_category) table).
  • Child categories (–  physically stored in the Menu Category (sys_menu_category) table).
  • Menu items (physically stored in the Menu Item (sys_menu_item)  table)table.
  • Dynamic categories (physically stored in the Dynamic Menu Category (sys_menu_dynamic_category) table).

A category can have one or more child categories. Child categories never have other child categories.

The hierarchy of a category containing child categories and items is shown below:

To add a menu item, follow the steps below:

  1. Navigate to System Definition → Menu Items.
  2. Click New and fill in the fields.
  3. Click Save or Save and Exit to apply changes.

A category can also be a dynamic one that is an entry point to a separate submenu. The order of a dynamic category containing child categories, subcategories and its items, and its own items is shown below:



To create a new category, please follow these steps:

  1. Navigate to System Definition → Menu Settings → Menu Categories.
  2. Click New and fill in the fields. See an example below.
  3. Click Save or Save and Exitexit to apply the changes.

Service Portfolio Portal Structure category form fields

Image RemovedImage Added


The Edit button is marked with a pencil icon .

It allows you to modify the properties of a specific category or category item. Click it to open the property editing form.

Menu category Category form fields

Order
FieldMandatoryDescription
TitleYDisplayed Specify the displayed category title.
ActiveNSelect the checkbox to activate the category.
DynamicNSelect the checkbox if you want that need the category to be dynamic.
YCategory order in the interface (categories are arranged in the ascending order).Dynamic categoryYSpecify the dynamic category to extend the category you are creating.
OrderYSpecify the category order in the interface (categories are arranged in ascending order).
DescriptionNBrief category descriptionEnter a short description for the category.
User RolesrolesNUser Specify user roles that have access to the category can be specified here. If the list is left field is left blank, then the category will be available to all users.
ParentN

The Specify the category which is the parent to the current one. This allows you to change the level of a the category.

A category cannot be a parent to itself.

Info

A category with a child category cannot become a child category itself (child Child categories cannot have their child categories). In other words, if the Service Portfolio has a child category Service Option, the Service Portfolio cannot become a child category itself.

The maximum level hierarchy is shown below:

  1. Service Portfolio

1.1. Service Option

Service Option item

Service Item



Info

If the newly created category contains no items, then it will not appear in the navigation panel. To display it, create one or more menu items for this category. To learn how to create a menu item, please refer to Menu Items section of this article.


category

Child category is an optional level for a category that allows you to implement hierarchy in the Navigator.

To create a new child category, please follow these steps:

  1. Navigate to System Definition → Menu CategoriesSettings → Menu Categories.
  2. Open a category record you need , open a record you want to create a child category for.
  3. Find Open the Child Categories tab in the Related Lists area.
  4. Click New and fill in the fields.
  5. Click Save or Save and Exitexit to apply the changes.
Info

You can also open the form create a child category this way:

  1. Navigate to System Definition Settings → Menu Categories.
  2. Click New and fill in the fields.
  3. Click Save or Save and Exitexit to apply the changes.

Please note Note that in this case, you need to fill in the Parent field manually.

Image Removed

Tip

A child category cannot have any child categories.


Info

If the newly created child category contains no items, then it will not appear in the navigation panel. To display it, create at least one menu item for this child category. To learn how to create the menu item, please refer to Menu Items section of this article.

Menu items


SimpleOne administrators can use menu items as links to content pages (e.g.for example, lists or forms of table records).  Menu Menu items can be related to a category or to a child category.

Info

To make a menu item point to an external source, on the Link typeType tab, fill in the URL field with a link to the source.

To create a new category item, please follow these steps:

  1. Navigate to System Definition → Menu CategoriesSettings → Menu Categories.
  2. Оpen a category record you need , open a record you want to create a menu item for.
  3. Find In the Related Lists area, select the Menu Item tab in the Related Lists area.
  4. Click New and fill in the fields.
  5. Click Save or Save and Exitexit to apply the changes.
Image Removed

Menu item Item form fields

Notes

FieldMandatoryDescription
TitleYSpecify the displayed menu item title.
CategoryY

The Specify the category of the item. Move it from one category to another by clicking on the magnifier icon Image Modified and choosing the new category from the list.

User RolesrolesNUser Specify user roles that should have access to the menu item can be specified here. If the list is left empty, the category will be available to all users.
Visibility tab
ActiveNSelect the checkbox to display the element in the navigator.
OrderYThe Specify the element order in the interface (elements . Elements are sorted in the ascending order).
Link type Type tab
TableYSpecify the table to which the menu item refers to.
Link TypetypeYThe

Specify the link type in this Choice field. Available options:

  • List of
Records or
  • records
  • Record
.
FilterN

The Condition Buildercondition builder field that allows to allows you to tune up a filter that will be applied to a list view.

Info
title
  • The filter allows you to specify several conditions.
  • It is possible to create AND/OR constructions.
  • It is possible to add sorting.
URLN

Enter a URL if a navigation item should point to an internal or external source. 

Note

If you enter a URL, values of the Table and Link Type type fields will be ignored.

Favorites

The "Favorites" functionality provides the ability of quick access to the frequently used categories (including their child categories), child categories (including their items but not the parent category), category items, and also filters.

List of favorite items is available in the "Favorites" tab marked with the star icon. Every user has their own Favorites. Physically, they are stored in the Favorites (sys_menu_favorite) table.

To add a category, child category, or category item to Favorites, click a star near it (in other words, star it). Also, you can add a filter of the list view that was prepared earlier to the Favorites. For this, just drag and drop it to the "Favorites" navigation tab.

Image Removed

There are two ways to delete the category, category item or the filter from Favorites:

(applicable for categories, category items and filters)

  • When you are in Favorites, click the Delete icon in front of the desired item.

(applicable for categories and category items)

  • When you are in the Categories tab, unmark the item you want to delete from Favorites.



Dynamic menu is a special navigator element that is the entry point to a separate submenu. Categories and items of such a menu are formed based on table data. There are two options for forming a dynamic menu structure while creating it:

  • Specify one table, so its records will be both categories and category items. To do thisso, specify the field in the Category parent column that defines the parent-child relationship.
  • Specify two tables, one for the category and one the other for the items included in the category. To do thisso, specify the field that defines the parent-child relationship in the Category parent column for the category and subcategories table, and . And also specify the field in Item parent column that defines the item-to-category relationship for the table with items.

Image Modified

Dynamic Category form fields

FieldMandatoryDescription
TitleYSpecify the category title.
Use categoriesNSelect the checkbox if you need to create a hierarchy using two tables.
Category tableY

Define the table that will be used as a category for items.

Info

The field appears when the Use categories checkbox is selected.


Category parent columnY

Specify the column to define parent-child relationship of elements.

Info

The field appears when the Use categories checkbox is selected.


Category icon sourceN

Specify the vector image for the category.

Info

The field appears when the Use categories checkbox is selected.


Category UI listN

Specify the List Layout for the category.

Info

The field appears when the Use categories checkbox is selected.


Category conditionsN

Specify the conditions that must be met to filter categories.

Info
Navigator filtering

The field appears when the Use categories checkbox is selected.


Item tableYDefine the table which records will be used as items.
Item parent columnYSpecify the column that will define parent-child relationship between items and categories. 
Item icon sourceNSpecify the vector image for items.
Item UI formNSpecify the form layout for items.
Item conditionsNSpecify the conditions that must be met to filter items.



You can use the search bar at the top of the navigator to reduce the number of items displayed. It may be helpful if there are many items displayed, and it is hard to find the preferred one.

For this, enter some characters or keywords in the search bar at the top of the navigator:


Note

Initial The initial filtration is performed by the category name.

  • When you enter some characters of a keyword, the navigator displays categories whose titles contain characters, and all their items.
  • When a full keyword is entered, items with the keyword and their categories will be shown.


Table of Contents
absoluteUrltrue
classfixedPosition