Managing User Roles

Overview

User roles are a central part of managing permissions within the system for groups of homogenous users.  If you have a number of users or are adding and removing users often, setting up roles which retain the desired permissions can be a big time-saver in the system.  Read on below to understand how to utilize these best.  To access the user roles features, you must have permissions to Avantalytics Admin and "Manage User Roles" option in the menu shown below on the left.

Adding User Roles

Adding a user role can be done where the role is defined from scratch, with not permissions initially.  To do this locate the "Add User Role" option in the blue toolbar across the top and click on it.  You'll be asked to provide a role name.  Once you've done so, the role will be available in the list of user roles.

Adding A Role Based on an Existing User

Sometimes it can be a quick time saver to create a role where the initial permissions match that of an existing user.  This allows you to start with a number of permissions and then you can customize the role permissions without having to manually assign each and every permission from scratch.  To do this, you need to have access to "User Permissions" – click on the user you wish use as the model then see the toolbar option below called "Create Role From User" – this will take care of creating and assgining initial permissions.  You can then customize the role through the normal role management screens

Interacting & Updating User Roles

The table shown below has a number of links which allow you to interact with roles – assigning roles to one or more user, adding or removing permissions and report access, editing the descriptive for the role or even deleting the role.  As you make changes to permissions – any user assigned this role will receive the updated permissions.  If you are removing permissions, a user will lose that permission if the role providing it was the only way it gained permission.  It should be noted  that users can be assigned multiple roles which may have overlapping permissions.  In these cases, removing the permission from one role will not remove the permission from a user if another role they remain assigned to also lists that permission.

Tip: right clicking on the role ID on the left provides access to all functions to modify user roles directly.