========================== Role Setup ========================== The **Role Setup** page allows user to manage roles. List and View Roles ------------------- #. In browser, log in to Izenda as a user with Role Setup permissions. #. Click Settings, then Role Setup in the left menu. #. Select the Setting Level: either System or a specific tenant. #. List of roles and statuses will be displayed in the Middle Panel. #. Click any role in the list. #. The role's information will be displayed in the 4 tabs Data Model Access, Permissions, Users, and Permission Summary. .. _Role_Setup_List_and_Details: .. figure:: /_static/images/Role_Setup_List_and_Details.png :width: 787px Role Setup List and Details (in versions prior to v2.9.0 the available and selected data sources are represented in 2 trees) Search for Roles ---------------- The Search box at the top allows searching for specific roles. #. .. _Role_Setup_Search: .. figure:: /_static/images/Role_Setup_Search.png :align: right :width: 185px Search for Roles Type a partial name and click the search icon (🔍). #. Only matching roles will be displayed in the list. #. Clear the search box to see the full list. |br| Add Role -------- #. Click the + Add Role button at the top. #. Enter a unique name for the role. #. .. _Role_Data_Model_Access: .. figure:: /_static/images/Role_Data_Model_Access.png :align: right :width: 462px Data Model Access In Data Model Access tab, tick items in Data Sources to select data sources that the role can access. It is possible to select only some fields of a table. In this case, users of the role will only see selected fields in the table. Tick **Show selected items only** checkbox to manage the list easily. This option is available from version 2.9.0. |br| #. In Permissions tab, configure permissions for this role similarly to :ref:`Tenant Permissions `. #. .. _Role_Users_tab: .. figure:: /_static/images/Role_Users_tab.png :align: right :width: 462px Users tab In Users tab, tick users in Assigned Users. Assigning users is not available when Izenda is integrated inside an existing system. |br| #. The Permission Summary tab is a read-only comparison of permissions among all roles of the current tenant. .. _Role_Permission_Summary: .. figure:: /_static/images/Role_Permission_Summary.png :width: 659px Permission Summary tab For example: a quick scan through this page ensures that mod002 role consists of User and Role setup permissions only while mod001 role consists of Data Model, Report and Dashboard permissions only. #. Click the Save button at the top. #. The new role will appear in the list in Middle Panel. #. Click the Activate link next to the role in Middle Panel to make it active. Edit Role --------- #. Click the role in the list in Middle Panel. #. The role's information is displayed in the 4 tabs. #. Edit the information. #. Click the Save button at the top, then OK in the confirmation pop-up. Deactivate Role --------------- #. Untick the Active checkbox (☑) of the role in Middle Panel. #. Click OK in the confirmation pop-up. #. The role becomes inactive. Its users no longer have the permissions specified in this role. .. note:: The Cancel button at the top will have no effect in this case. Delete Role ----------- #. Click the Delete icon (x) of each role. #. Click OK in the confirmation pop-up. #. The role is deleted and removed from the list in Middle Panel. .. note:: The Cancel button at the top will have no effect in this case.