Create custom roles for functional permissions

Create custom user roles and define functional permissions to control access to application features and data.

Overview

Administrators can edit the permissions of the standard Scheduler and Resource roles or create custom user roles with specific sets of permission. Users can be assigned any combination of roles.

Users with multiple roles are granted all of the permissions from all their assigned roles. For example, a user with a standard Scheduler role (which includes permission to dispatch resources) and a custom role without the permission to dispatch resources will still be able to dispatch resources.

Required permissions (⚠️)

Certain permissions are required to access the Skedulo web app and Skedulo mobile app.

Users assigned a role that does not include these base-level permissions will not have access and will receive an error when attempting to log into the app.

Additionally, some pages in the web app may require users to have multiple permissions to access them, such as both view and modify permissions.

Web app access

Users can get basic read access to the Skedulo web app with only a custom role; they do not necessarily need one of the standard roles (although the standard roles are recommended to ensure that base functionality works as intended). At a minimum, to access the web app, users must have a role containing the permissions identifiable by an alert ⚠️ icon in the description.

Mobile app access

Users must have the Resource role to be allocated work and to access the Skedulo mobile app. Custom roles can be added and the Resource role can be modified, however, without the Resource role, they cannot be allocated work or log into the mobile app.

Modify standard role permissions

Skedulo’s standard roles have a pre-defined set of permissions by default. These roles can also be modified to add or revoke permissions for users with these roles.

  1. Navigate to the Settings > User roles page.
    The user roles settings page
  2. Click the standard role for which you want to adjust the permissions, for example, Scheduler. The role details page
  3. On the Permissions tab, click a chevron to expand a section and then select or deselect permissions as required. When you make changes to a permission, a non-default label is added beside it and the label on the section header of its category updates to show how many non-default permissions there are within it.
    The non-default indicator on the permissions list
  4. Click Save.

Reset a standard role

If you make changes to the permissions assigned to the standard Scheduler or Resource roles, you can easily reset to the default permissions set.

To reset any changes you’ve made to the standard Scheduler or Resource roles:

  1. Navigate to the Settings > User roles page.
  2. Select the standard role you want to reset.
  3. Click Reset permissions to default on the Actions dropdown menu.
    The actions button options

Clone a standard Skedulo role to create a custom role

Custom roles can be created by cloning one of the standard Skedulo roles and modifying the default permissions to add or revoke permissions.

Skedulo recommends this approach for creating new custom roles to prevent roles from being created without the required base permissions to use the Skedulo apps. A custom role with a small number of permissions can, however, be used to add onto an existing role.

The following procedure shows how to clone the standard Resource role to create a custom role that contains the standard Resource permissions and, additionally, permissions to provide access to the Skedulo web app.

  1. Navigate to the Settings > User roles page.
  2. Click Create role.
  3. Provide a name and description for the new custom role.
    The new user role dialog
  4. Select Create from existing role and select the role you want to clone from the dropdown menu. For this scenario, click Resource.
  5. Click Create to save your changes and create the role. The permissions page for your new role displays.
    The new role permissions list
  6. Expand the permission section headings and select or deselect the permissions as required. To add web app access, enable the Web app access permission and the other permissions it requires, which are marked with a warning icon. The new role with a permission selected
  7. Click Save. Your custom role is saved and you are returned to the User roles list view page.

Alternative approach using a complementary role

An alternative approach to providing web app access to a resource by cloning the Resource role (as described above) is to create a “Web app user” role that contains only the permissions required to use the web app and then to give the appropriate users both the Resource and the Web app user roles.

Assign a custom role to a user

The procedure for assigning a custom role is the same as assigning a standard role.

To assign a custom role to a user:

  1. Navigate to the Settings > Users page.
  2. Click the name of the user to whom you want to assign the role. The user’s details page displays.
  3. Select the custom role from the Roles dropdown menu.
  4. Click Save to apply the role to the user.