Appearance
Role
Platform settingsAccessRoles and permissionsRolePermission:
settings.roles.viewOpen in Roari ERP (new tab)Also known as
- new role
- edit role
- permission matrix
- grant permission
- access rights
- privileges
- RBAC
- SoD conflict
- segregation of duties
- portal role
The role page shows one role: its name and description, whether it is a portal role, and its permissions as a matrix of resources and actions. Administrators use it to create a role or to change what a role allows.
Create a role
- Go to SettingsRoles and permissions and select New role.
- Fill in Name and Description (see the table below).
- Turn on Portal role only for a role meant for external contacts.
- Tick the permissions in the matrix (see Grant permissions).
- Select Create role. You see Role “…” created with the number of permissions, and the role opens.
To give the role to people, open them in Users.
| Field | Required | What to enter |
|---|---|---|
| Name | Yes | The job the role is for, for example Accounts payable clerk. Must be unique: Another role has this name. Empty: Enter a name. |
| Description | No | What people with this role do. Shown in the roles list. |
| Portal role | No | On for external contacts such as vendors. People whose roles are all portal roles see only the portal pages: no Home dashboard, approvals, reports or other modules. |
Grant permissions
The matrix has one block per module (Settings, Catalogue, then the enabled modules), one row per resource (for example order, receipt, alert) and one column per action (View, Create, Edit, Approve, Post, Export, Import, Close, Release …). A dash means the action does not exist for that resource.
- Type in Filter modules, resources or permissions to narrow the matrix, for example
invoice. - Tick a cell to grant one permission. Hover a cell to see the permission's full name.
- To grant a whole block at once:
- the box next to a module's name grants every permission of that module;
- the box under a column heading grants that action on every resource;
- the box at the end of a row grants every action on that resource.
- Use Grant all or Clear all above the matrix (with a filter: Grant shown / Clear shown).
The count next to the filter says how many permissions are granted, for example 6 of 418 permissions granted. Ticked cells are shaded. Only modules your organisation has enabled appear.
TIP
Grant View with every other action on a resource: a user who can create orders but not view them cannot open the list to find them.
Check for segregation-of-duties conflicts
While you tick permissions, the page checks them against your organisation's enforced segregation-of-duties rules (when the Compliance module is enabled). If the role breaks a rule, a warning appears above the matrix listing each rule's code and name and the two permissions that conflict, for example P2P-02 Create and approve purchase orders: procurement.order.create with procurement.order.approve.
| Warning | What happens when you give the role to a user |
|---|---|
| …assigning this role to a user will be flagged. (warned on assignment) | The assignment is saved and recorded as an SoD warning for review. |
| …assigning this role to a user will be refused. (blocked on assignment) | Saving the user with this role fails until the conflict is removed or mitigated. |
You can still save the role. Conflicts with an approved mitigation in Segregation of duties are not shown.
Change or delete a role
- Open the role from SettingsRoles and permissions. The line under the name shows how many users hold it and how many permissions it has.
- Change the fields or the matrix. Unsaved changes and the number of permissions appear at the bottom.
- Select Save role, or Discard to undo your changes. Leaving with unsaved changes asks Leave without saving?.
Changes apply to every user with the role at their next request.
To delete a role, select Delete role and confirm. You can delete only a role that no user holds (otherwise: Remove this role from its users first.).
Differences by role
- The Account admin role shows the banner The account administrator role has full control. It holds every permission and cannot be edited or deleted; create a custom role for narrower access.
- Without Permission:
settings.roles.manage, the page is read-only.
