Общие сведения

Ролевая модель приложения предоставляет доступ к разделам приложения по следующим принципам.

• Только просмотр – соответствующий раздел доступен только для просмотра.
• Полный доступ – в соответствующем разделе доступно создание и копирование сущностей.

Ролевая модель предусматривает следующий паттерн доступов к разделам.

	Модуль Dashboards					Модуль Manager
	Проекты	Виджеты	Библиотека компонентов			Датасеты	Источники	Фильтры	Группы	Пользователи	Роли	Плагины	Модули	Логи
			Доступ к компонентам	Доступ к темам	Доступ к SVG-объектам
Только просмотр
Полный доступ

Создание роли

Для создания роли необходимо на странице со списком в реестре ролей нажать на кнопку «Добавить роль», расположенную справа над списком:

После нажатия кнопки откроется окно создания роли:

Окно состоит из следующих блоков:

• Название и описание роли;
• Ресурс по умолчанию;
• Выбор модуля;
• Преднастройка;
• Переключатель отключения и включения доступа;
• Назначение роли пользователям.

Название и описание роли

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

В поле «Название» необходимо внести наименование роли. Поле «Название» не может быть пустым, поле «Введите описание роли» не является обязательным для заполнения.

Для отмены ввода наименования и описания роли и скрытия соответствующих полей необходимо нажать кнопку.

Для сохранения введенных значений необходимо нажать кнопку «Применить». Поля для ввода названия и описания роли скроются из левой части окна создания роли. Название и описание роли отобразятся в блоке названия и описания:

Ресурс по умолчанию

Ресурс по умолчанию, это ссылка, по которой выполняется переадресация при обращении к серверу по адресу

протокол://доменное_имя_сервера

Если ссылка может быть распознана как адрес внутреннего ресурса системы, то часть ссылки протокол://доменное имя автоматически обрезается, например:

протокол://доменное_имя_сервера/dashboard → /dashboard

Выбор модуля

Для выбора модуля системы следует воспользоваться выпадающим списком «Выберите модуль»:

Для каждого модуля предусмотрены свои пункты прав доступа в соответствии с содержимым модуля.

При выборе в выпадающем списке "Выберите модуль" значение Dashboards окно для создания роли принимает следующий вид:

У каждого модуля системы есть предустановленные базовые роли. 

Преднастройка

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

Базовые роли:

• Администратор.
  Для данной роли по умолчанию предоставлены полные права доступа ко всему содержимому модулей;
  
  
• Аналитик.
  Для данной роли установлены права просмотра и полный доступ к ограниченному объему содержимого модулей;
  
  
• Пользователь.
  Для данной роли предусмотрены права просмотра некоторого содержимого модулей;

Вне зависимости от базовой роли параметр «Доступ к фильтрам» для модуля "Manager" находится в выключенном состоянии (не установлен флажок). Для включения данного параметра необходимо поставить флажок слева от надписи «Доступ к фильтрам».

Для сброса всех настроек необходимо нажать на текстовую кнопку «Сбросить настройки». При нажатии на кнопку все установленные флажки будут сброшены.

Переключатель отключения и включения доступа

Для отключения доступа для роли ко всему содержимому какого-либо модуля следует установить положение переключателя  во включенное состояние:

При отключении доступа для роли область с содержимым модуля и пунктами прав доступа с флажками становятся неактивными. Доступ роли к данному модулю отключен. Отключение роли в текущем модуле не влияет на остальные модули системы. Для перехода в другой модуль системы следует воспользоваться выпадающим списком «Выберите модуль».

Назначение роли пользователям

Для назначения создаваемой роли какому-либо пользователю необходимо нажать на кнопку , расположенную в верхнем углу окна создания роли. После нажатия кнопки в правой части окна создания роли отобразится область для выбора пользователей:

Область для выбора пользователей состоит из следующих блоков:

• Вкладки для переключения пользователей «Только с данной ролью» и «Все пользователи»;
• Поиск; 
• Список пользователей;
• Пагинация;
• Сортировка списка пользователей.

Вкладки для переключения пользователей "Только с данной ролью" и "Все пользователи"

Во вкладке «Все пользователи» отображаются все пользователи системы. Во вкладке «Только с данной ролью» отображены пользователи, которым назначена данная роль. Вкладка «Все пользователи» открыта по умолчанию.

Поиск

Для поиска пользователей следует ввести в поле искомое значение. Список ниже отфильтруется относительно искомого значения. Введенное значение исчезает из поля при нажатии на кнопку.

Список пользователей

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

Если пользователю уже была назначена другая роль, то такая роль отобразится под наименованием пользователя:

При назначении новой роли предыдущая роль пользователя будет отключена.

Пагинация

Если в списке пользователей содержится большое количество записей, используется пагинация, расположенная в левом нижнем углу под списком пользователей: . Пагинация представляет собой перечень страниц списка пользователей. Для доступа к необходимой странице списка пользователей необходимо нажать на порядковый номер данной страницы. 

Сортировка списка пользователей

Для сортировки пользователей используется кнопка , расположенная в верхнем левом углу над списком пользователей. При нажатии на кнопку изменяется порядок отображения имеющихся пользователей в списке.

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

Сохранение роли

Для закрытия окна создания роли следует нажать кнопку «Отменить»,  или нажать левую кнопку мыши вне области окна. Произойдет возврат на страницу со списком ролей системы.

Для сохранения внесенных значений в окно создания роли необходимо нажать кнопку «Создать». Созданная роль будет сохранена, произойдет переход на страницу со списком ролей. Сохраненная роль отобразится в списке ролей.