Roles Page

28 Feb 2025
2 Minutes to read

Print
Dark
Light
PDF

Roles Page

Updated on 28 Feb 2025
2 Minutes to read

Print
Dark
Light
PDF

Article summary

Did you find this summary helpful?

Thank you for your feedback!

Role Management

Role Management is designated for controlling access to various functionality and widgets of the application. There are three main entities in the Management system: Users, Roles, and Groups. Relations between Users←→ ←→ Groups←→ ←→ Roles are “many-to-many”. So one User can be a member of one, two or more Groups. And Group can be connected to one, two or more Roles.

Users page

Represent all users that are created for corresponding groups. Each user can belong to one or more groups. The Add User button allows to create a new user.

Field Name	Description	Visualization
Name	Can be set any name. Name will be used for User through Clearion Web widgets. Required field.
Key	The key field determines the uniqueness of the created item; when merging and cloning groups or projects, items are sorted according to the key field.
Group	Select a Group where the created item will be stored
User Search	Search field that gets all available username data based on the search entry. Data is loaded from [tablename] table.
Table	Shows the list of Usernames that were found after filtering using the User Search field.
Save	Saves the configuration

Example of the created User entity in the Studio:

Groups page

Represent all groups that are created for corresponding Roles. Groups are collections of users. Can be associated with one or more roles. The Add Group button allows to create a new group.

Field Name	Description	Visualization
Name	Can be set any name. Name will be used for the Group through Clearion Web widgets. Required field.
Description	Can be set any description for the Group. Required field.
Users	List of users that should belong to the particular Group. Users should be added to the Users page in advance. Multiple Users can be selected for one Group. Required field.
Save	Saves the configuration

Example of the created Group entity in the Studio:

Roles page

Represent all roles that are created for the particular Clearion product. Roles define specific permissions and rights in the system to control access to various functionalities and widgets of the application. The Add Role button allows to create a new role.

Field Name	Description	Visualization
Name	Can be set any name. Name will be used for the Role through Clearion Web widgets and products. Required field.
Description	Can be set any description for the Group. Required field.
Slug	Can be set any unique name.
Scope	List of products where current Role will be used: Both—both Manager and Mobile (selected by default); Mobile: Role will only be usable for Mobile; Manager: Role will only be usable for Clearion Web.
Groups	List of Groups that should belong to particular Role. Groups should be added to the Groups page in advance. Multiple Groups can be selected for one Role. Required field.
Save	Saves the configuration

Roles Settings

When all users are assigned to corresponding groups and roles, we need to configure an additional “Settings” widget, which should be added as a separate panel in the configuration. Navigation to the Settings panel in the web project allows to change the current role if those roles are configured for the current user. E.g. if a user added to only one Role, this user will see only one option in the Settings drop-down. And if user is added to several roles, there will be more items in the drop-down.

Example of the created Settings panel in the Studio:

Example of the created Settings panel in the Web Project:

Example of the created Role entity in the Studio:

Roles Configuration Per Widget

Roles configuration is available for the following widgets:

What's Next

Project Structure

Table of contents