A role determines the level of privileges your users have within your account. To edit the properties of a role in your CalAmp account, follow these steps:
Note: The CalAmp application comes prepackaged with two roles — Admin and User. For details on which screens they can view and modify, go to Viewing Your Roles.
Unless you have special privileges, you will find that you can only edit roles you yourself have created.
- In the sidebar menu on the left, click .
- Click Roles on the flyout menu that appears.
The Admin - Roles screen will appear.
- If the role you need to modify is in a subgroup of the one you have selected in the Group Chooser, make sure that View Subgroups is selected at the bottom of the screen.
Note: Step 3 shouldn't be necessary, as roles are primarily created to be used throughout the CalAmp application and are best assigned to your top-level group (and set to be inheritable). - In the row of the role, click at the far right. (To find the role, you can sort or filter the Name column, if needed, as shown in Sorting and Filtering Column Data.)
A menu will appear.
Caution: As mentioned earlier, you might not be able to edit the default roles (Admin and User). If that's the case, instead of Edit Role, the first option on this menu will be View Role. This enables you to at least view what privileges the role has. (Also, the Delete Role option will be grayed out, as you won't be able to remove it.)
- Click Edit Role.
The Edit Role dialog box will appear.
- To change the name of the role, select the text in the Name field and type the new one, such as Driver Supervisor or Basic User.
- If you would like to place the role in a different group, click the Group drop-down arrow and select the new group from the list.
Note: As roles are primarily created to be used throughout the CalAmp application, they are best assigned to your top-level group (and set to be inheritable, as shown in step 10). - To edit the description of the role, select the current value in the Description field and type the new text, including what the role is designed for (such as a driver supervisor) and which screens it will be able to view and modify.
- Normally, you will leave the Role Status field set to Enabled.
Note: If you don't want the role to be used for a temporary period of time, you can click this drop-down arrow and select Disabled or Suspended. This will make the role unable to be assigned to a user. (For Disabled, the role will no longer appear as an option in the Edit User dialog box. For Suspended, it will be listed but grayed out.)
If any users currently have the role, you won't be able to disable or suspend it. (You'll receive an error when you try to save.)
If you do disable a role and later reenable it, you'll need to log out and back in to the CalAmp application in order for the change to take effect. (This isn't necessary for Suspended.) - You should generally leave Inheritable selected so that the role can be seen by subgroups of the group it is assigned to (so the subgroups, or child groups, inherit the role from the parent group).
Note: The Inheritable attribute is not really employed as a role feature and is somewhat a leftover from similar screens.
In the Features section, you will find a list of all the CalAmp screens. If a page is set to Deny, the role cannot view it. If a page is set to Allow, the role does have access to it.
- Scroll through the list of screens and make any Allow/Deny changes you need by clicking the selectors. ( means selected [Allow], and deselected [Deny].)
Note: You won't be able to give access to screens you yourself don't have rights for. For example, if your role is the prepackaged Admin, you won't be able to allow the new role to delete groups, as your role doesn't have that privilege.
Tip: If you've received queries from your users, asking if there's a way to disable the session timeout, you'll be happy to learn that you can add that as a role feature, as follows:
- Scroll down to the bottom of the Admin section.
- Select Admin Command Center.
After you save your changes to the role, users assigned to it will not be logged out of their sessions according to the normal timeout rules.
- Scroll down to the bottom of the Admin section.
- Click Done.
Your edits will appear in the Admin - Roles grid.
Also, a success message will appear at the bottom of the screen.
- Click OK to dismiss it. (Or you can wait a few seconds, and it will automatically close.)