.. _dashboard-usersAndRoles-roles:

Роли
====

Для просмотра и редактирования ролей необходимо выбрать пункт меню ``Роли`` или перейти по адресу: ``{адрес:порт}/usersAndRoles/roles``. 
Данное действие доступно для пользователей с разрешением «Администратрирование».

.. image:: img/Dashboard_UsersAndRoles_Roles.png
   :scale: 37
   :align: center
   :alt: Роли

Для поиска ролей по названию или описанию можно ввести запрос в текстовое поле над перечнем ролей и нажать кнопку ``Поиск``.

Добавление роли
---------------

Для добавления роли необходимо на странице с ролями нажать кнопку ``Добавить``. Откроется страница с формой для добавления роли.

.. image:: img/Dashboard_UsersAndRoles_Roles_AddRole.png
   :align: center
   :alt: Форма добавления роли

Заполните поля с параметрами роли. 
    
.. note:: Описание параметров ролей см. `Параметры ролей`_.
 
Для сохранения введенных параметров нажмите кнопку ``Сохранить``.

В случае если сохранять введенные данные не требуется, нажмите кнопку ``Отмена``.

Изменение роли
--------------

Для изменения роли необходимо для выбранной роли нажать кнопку ``Изменить``. Откроется страница с формой для изменения роли.

.. image:: img/Dashboard_UsersAndRoles_Roles_EditRole.png
   :align: center
   :alt: Форма изменения роли

Заполните поля с параметрами роли. 
    
.. note:: Описание параметров ролей см. `Параметры ролей`_.
 
Для сохранения введенных параметров нажмите кнопку ``Сохранить``.

В случае если сохранять введенные данные не требуется, нажмите кнопку ``Отмена``.

Удаление роли
-------------

Для удаления роли нужно нажать кнопку ``Удалить`` напротив удаляемой роли.

Параметры ролей
---------------

Свойства
~~~~~~~~

Описание свойств ролей приведено в таблице ниже.

.. list-table:: Параметры ролей
    :widths: 40 40 20
    :header-rows: 1
    
    * - Название параметра
      - Описание 
      - Обязательность
    * - Наименование
      - Краткое описание роли в API. Должно быть уникальным.
      - Да
    * - Описание
      - Описание роли пользователя.
      - Да

.. _tags-settings-permissions:

Разрешения
~~~~~~~~~~

Разрешения, доступные роли, выбираются на вкладке ``Разрешения``. Разрешения описывают действия, которые разрешены пользователям с выбранной ролью.

.. image:: img/Dashboard_UsersAndRoles_Roles_Permissions.png
   :align: center
   :alt: Разрешения роли



.. _tags-settings-roles: 

Настройка тэгов ролей
----------------------------------

Для редактирования перечня тэгов, которые доступны ролям пользователей, нужно выбрать необходимую роль и нажать кнопку ``Тэги``. Откроется страница с формой для редактирования перечня тэгов.

.. image:: img/tags-settings-roles-tags.png
   :align: center
   :alt: Форма изменения перечня тэгов

.. note:: Информацию по настройке тэгов см. в разделе :ref:`tags-settings`.

Для добавления роли необходимо нажать кнопку ``Добавить``. Откроется окно для выбора тэга.
В этом окне можно ввести описание или наименование тэга и нажать кнопку ``Поиск``. После этого выбрать нужный тэг, нажав кнопку ``Выбрать``.

.. image:: img/tags-settings-roles-add-tag.png
   :align: center
   :alt: Форма добавления тэга в список ролей

Для изменения тэга нужно нажать кнопку |settings-icon| рядом с выбранным тэгом. После этого откроется окно с выбором нового тэга.

Для удаления тэга нужно нажать кнопку |delete-icon| рядом с выбранным тэгом.

Для сохранения данных нажмите кнопку ``Сохранить``.

В случае если сохранять введенные данные не требуется, нажмите кнопку ``Отмена``.

.. |settings-icon| image:: img/settings-icon.png
.. |delete-icon| image:: img/delete-icon.png