Webitel: Documentation

Permissions (Contact groups )

1. Description

This detail specifies roles and their permissions for this contact group.

The section consists of the following elements:

  1. Records registry (Fig. 1.(1));

  2. Add tool (Fig. 1.(2));

  3. Refresh records registry tool (Fig. 1.(3));

  4. Pagination (Fig. 1.(4)).

Permissions tab.png
Fig. 1. Permissions detail page

1.1. Records registry

The registry consists of the following columns:

  • Name — role name;

  • Read — dropdown list with read permissions;

  • Edit — dropdown list with edit permissions;

  • Delete — dropdown list with delete permissions.

Access options:

  • Forbidden — the action is forbidden;

  • Allow — the action is allowed;

  • Allow with delegation — allowed with delegation (the user has permission and can grant it to others).

When creating a contact group, the following users/roles are added to the records registry:

  1. If there are no records on the Managed by records detail page of the contact_groups section — only the user who created the contact group is added.

  2. If there are records on the Managed by records detail page of the contact_groups section:

    • the user who created the contact group;

    • grantees specified on the Managed by records detail page of the contacts section, where the grantor is the contact creator. All roles of the user who created the contact group, as well as the user themselves, are taken into account.

Note!

The specified roles and their permissions for this contact group are applied only if Managed by records is enabled (the switch is in the enabled position) on the Objects page in the contacts section.

On the Permissions detail page, only roles and users that the current user has permission to view are displayed. If the user does not have permission to view other users, only their own roles and themselves (if configured) will be displayed.

1.2. Add tool

To add a role, use the add button – %D0%9A%D0%BD%D0%BE%D0%BF%D0%BA%D0%B0%20%D0%94%D0%BE%D0%B1%D0%B0%D0%B2%D0%B8%D1%82%D1%8C.png?version=2&modificationDate=1708703213817&cacheVersion=1&api=v2&width=20&height=20 . After clicking the add button, a modal window opens (Fig. 2). When clicking the Grantee field, a dropdown list opens containing all roles and users.

To quickly find the required user or role, you can use the Role field as a search field: enter the name of the user or role, and the dropdown list will display only those users or roles that contain the entered name.

Users and roles can be distinguished by icons:

  • %D0%98%D0%BA%D0%BE%D0%BD%D0%BA%D0%B0%20%D0%9F%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D1%82%D0%B5%D0%BB%D1%8C.png?version=1&modificationDate=1708702811980&cacheVersion=1&api=v2&width=28&height=27 - user;

  • %D0%98%D0%BA%D0%BE%D0%BD%D0%BA%D0%B0%20%D0%A0%D0%BE%D0%BB%D1%8C.png?version=1&modificationDate=1708702834720&cacheVersion=1&api=v2&width=28&height=27 - role.

Clicking a specific role or user selects it. Clicking the Add button adds the selected role to the records registry. Clicking the Close button closes the modal window without adding it to the records registry.

New_grantee.png
Fig. 2. Modal window for adding a role in Permissions

The added role or user has the following parameters:

  • Read — Allow;

  • Edit — Forbidden;

  • Delete — Forbidden.

These parameters can be changed by selecting the required value from the dropdown list in the corresponding column.

The user who created this contact has the Allow with delegation access option for all actions.

1.3. Refresh records registry tool

Refreshing the records registry table is performed by clicking the refresh button – image2024-1-25_1-4-32.png?version=1&modificationDate=1706137477833&cacheVersion=1&api=v2&width=20&height=19 .

1.4. Pagination

It consists of the Rows per page field, which indicates the number of entries (it is possible to set from 1 to 1000) per page, and forward and backward buttons for switching pages.

2. Opportunities

2.1. Add a role or user with access to the contact group

Goal

Add a role or user with access to the contact group

Preconditions

  1. Access to the Admin application;

  2. Access to the Contact groups section in the Admin application;

  3. Permission to edit or create in the Contact groups section;

  4. At least one contact group exists or a new one is being created.

Scenario:

  1. Click the add button. The New grantee modal window opens.

  2. Click the Role field. A dropdown list opens.

  3. Select the required role or user from the list.

  4. Click the Add button.

Result

The modal window is closed. The selected role is added to the records registry.

2.2. Remove a role or user from the list of those who have access to the contact group

Goal

Remove a role or user from the list of those who have access to the contact group

Preconditions

  1. Access to the Admin application;

  2. Access to the Contact groups section in the Admin application;

  3. Permission to edit or create in the Contact groups section;

  4. At least one contact group exists or a new one is being created;

  5. At least one record exists in the registry.

Scenario:

  1. Find the role or user to be removed from the list.

  2. Click the field in the Read column. A dropdown list opens.

  3. Select the Forbidden option.

Result

The selected role or user is removed from the records registry.

2.3. Modify action permissions

Goal

Modify action permissions

Preconditions

  1. Access to the Admin application;

  2. Access to the Contact groups section in the Admin application;

  3. Permission to edit or create in the Contact groups section;

  4. At least one contact group exists or a new one is being created;

  5. At least one record exists in the registry.

Scenario:

  1. Find the role or user for which permissions need to be modified.

  2. Click the field in the required column. A dropdown list opens.

  3. Select the required value from the dropdown list.

Result

The permission value is updated in the column.