Панель управления СЭО 3KL. Локальный плагин

Сергей Гусев, Алексей Городков
2021-04-09 14:24

1. Назначение, размещение, доступ

Панель управления СЭО 3KL - инструмент администрирования, предназначенный для просмотра и выполнения массовых действий с основными объектами системы (курсами, пользователями, глобальными группами, подписками на курсы и т.п.).

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

Интерфейс плагина удобен тем, что позволяет выбирать объекты из единой таблицы и совершать над ними массовые действия.

Функционал плагина может быть полезен при формировании статистических и аналитических отчетов по разноплановым параметрам курсов, качеству освоения материалов  и посещения курсов обучающимися.

Модуль постоянно модифицируется и дополняется новыми функциями силами специалистов компании «Открытые технологии».

Переход в Панель управления СЭО 3КL (Рис. 1.1) осуществляется через административный раздел настроек (Настройки>Администрирование>Панель управления СЭО 3КL).

Рис. 1.1. Доступ к Панели управления СЭО 3КL.

 Доступ к функционалу плагина Панель управления СЭО 3KL регулируется следующими правами:

  • local/otcontrolpanel:view_data - просмотр данных в панели;
  • local/otcontrolpanel:config - настройка панели;
  • local/otcontrolpanel:take_actions - совершение действий через панель.

По умолчанию весь набор прав выдан Диспетчеру-администратору.

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

2. Интерфейс Главной страницы плагина

 При переходе в Панель управления СЭО 3КL пользователь попадает на «Главную страницу» плагина (Рис. 2.1).

 

Рис. 2.1. Панель управления СЭО 3КL, главная страница.

На «Главной странице» доступны следующие элементы:

  • панель вкладок (поз. 1 Рис. 2.1), содержит доступные вкладки и позволяет переключаться между ними;
  • кнопка «Конфигурация» (поз. 2 Рис. 2.1), предназначена для перехода на одноименную страницу;
  • информационное сообщение (поз. 3 Рис. 2.1).

3. Вкладки. Общие элементы интерфейса

 При выборе на «Главной странице» пользователем интересующей вкладки (Рис. 3.1), она раскроется и на экране отобразятся следующие функциональные элементы:

  • Кнопка «Выполнить действие» (поз. 1 Рис. 3.1). При нажатии раскрывается модальное окно инструмента для осуществления массовых действий над выбранными в таблице объектами.
  • Таблица объектов (поз. 2 Рис. 3.1), наполнение которой зависит от выбранной вкладки.
  • Поле поиска (поз. 3 Рис. 3.1), служащее для фильтрации данных в таблице.
  • Кнопка расширенного поиска (поз. 4 Рис. 3.1). При нажатии раскрывается модальное окно, позволяющее производить дополнительную фильтрацию по каждому из столбцов таблицы.
  • Кнопка «Export data» (Выгрузка данных) (поз. 5 Рис. 3.1). Позволяет выгрузить сформированные в таблице вкладки данные и сохранить их в виде файла выбранного формата на компьютере пользователя (Рис. 3.2). Текущая версия плагина поддерживает выгрузку в форматах .json, .xml, .csv, .txt, .sql, .xls.
  • Селектор количества записей (поз. 6 Рис. 3.1). Выбирая из выпадающего меню селектора необходимое значение (предустановленные шаблоны: 10, 25, 50, 100, Все), пользователь может ограничить количество строк таблицы, отображаемых на экране.

 Рис. 3.1. Вкладка «Пользователи» Панели управления СЭО 3КL.
  Рис. 3.2.  Выпадающее меню выбора формата файла для выгрузки данных.

 Для таблицы объектов (Рис. 3.3), независимо от выбранной вкладки (количества и названий колонок), доступны следующие функциональные элементы:

  • чекбоксы выбора объектов (поз. 1 Рис. 3.3);
  • элементы сортировки (прямой и обратной) объектов по значениям столбцов (поз. 2 Рис. 3.3);
  • кнопки навигации и «быстрого» перехода между страницами таблицы (поз. 3 Рис. 3.3).

Рис. 3.3. Функциональные элементы таблицы объектов на примере вкладки «Пользователи».

-Вернуться к Содержанию-

3.1. Вкладка Пользователи

 Таблица предустановленной вкладки «Пользователи» (см. Рис. 3.1) сформирована на основании списка пользователей системы и, по умолчанию, состоит из значений следующих полей:

  • id - идентификатор пользователя;
  • email - электронная почта пользователя;
  • username - логин пользователя;
  • ФИО - фамилия, имя, отчество;
  • timecreate - дата регистрации пользователя в системе (дата создания).

 Изменить состав таблицы (убрать существующие или добавить новые поля) пользователь может на странице «Конфигурация».

3.1.1. Возможные действия на вкладке «Пользователи»

 Таблица данной вкладки предоставляет возможность удобного просмотра и анализа (с применением инструментов сортировки и фильтрации) списка пользователей с установленными данными выбранных полей (Рис. 3.1.1.а).

Рис. 3.1.1.а. Пример отсортированной по столбцу ФИО (по возрастанию) таблицы вкладки «Пользователи».

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

В текущей версии плагина выполнение каких-либо групповых действий на вкладке «Пользователи» при помощи инструмента «Выполнить действие» не предусмотрено.

-Вернуться к Содержанию-

3.2. Вкладка «Глобальные группы»

 В таблице предустановленной вкладки «Глобальные группы» (Рис. 3.2.1) представлен список глобальных групп системы. По умолчанию выводятся значения следующих полей:

  • name - название глобальной группы;
  • fullname (связанной сущности Курсы) - перечень названий курсов, имеющих связанную с глобальной группой запись на курс «Синхронизация с глобальной группой»;
  • ФИО (связанной сущности Участники группы) - перечень ФИО пользователей, являющихся участниками глобальной группы.

 Изменить состав таблицы (убрать существующие или добавить новые поля) пользователь может на странице «Конфигурация».

Рис. 3.2.1.  Вкладка «Глобальные группы» Панели управления СЭО 3КL.

 -Вернуться к Содержанию-

3.2.1. Возможные действия на вкладке «Глобальные группы»

 Ячейка столбца «Название», помимо названия глобальной группы, содержит элементы «Редактировать» (см. поз. 1 Рис. 3.2.1) и «Назначить» (см. поз. 2 Рис. 3.2.1), при нажатии на которые происходит открытие страниц административных настроек «Редактировать глобальную группу» и «Назначить» (назначить пользователей в выбранную глобальную группу) соответственно.

Нажатие на иконку расположенную в ячейке столбца «Курсы» (см. поз. 3 Рис. 3.2.1), позволяет перейти на витрину выбранного курса.

Нажатие на ФИО пользователя в ячейке столбца «Участники группы» позволяет перейти на страницу профиля выбранного пользователя.

На вкладке «Глобальные группы» предусмотрено  выполнение следующих  групповых действий при помощи инструмента «Выполнить действие» :

  • запись выбранных глобальных групп на курсы;
  • отчисление выбранных глобальных групп из курсов.

Для записи выбранных глобальных групп на курсы следует отобрать необходимые глобальные группы (отметить маркером соответствующий чекбокс), нажать кнопку «Выполнить действие» и, в открывшемся диалоговом окне, выбрать «Запись выбранных глобальных групп на курсы» (Рис. 3.2.1.а).

Рис. 3.2.1.а. Диалоговое окно выбора группового действия для вкладки «Глобальные группы».

Затем из раскрывающегося списка в поле «Найти» выбрать курсы, на которые должны быть записаны отобранные глобальные группы (допускается множественный выбор). В поле «Роль» определить назначаемую участникам группы роль (Рис. 3.2.1.б).

Рис. 3.2.1.б. Настройки действия при групповой записи глобальных групп на курсы (пример записи участников глобальной группы Группа1 на курсы «Космонавтика» и «Теория музыки» с ролью Студент).

 В поле «Режим синхронизации с локальными группами» определить необходимость локальной группы (Рис. 3.2.1.в).

Рис. 3.2.1.в.  Поле «Режим синхронизации с локальными группами» настроек действия диалогового окна «Запись выбранных глобальных групп на курсы».

После нажатия кнопки «Записать» произойдет запись отобранных глобальных групп на выбранные курсы с назначенной ролью, результат будет отображен в информационном окне (Рис. 3.2.1.г).

 Рис. 3.2.1.г.  Информационное окно о результатах записи отобранных глобальных групп на выбранные курсы.

 После обновления страницы, результат выполненных действий отобразится в таблице вкладки «Глобальные группы» (Рис. 3.2.1.д).

 Рис. 3.2.1.д. Таблица вкладки «Глобальные группы» по завершению процедуры «Выполнить действие» (участники глобальной группы Группа 1 успешно записаны на курсы «Космонавтика» и «Теория музыки» с ролью Студент).

 -Вернуться к Содержанию- 

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

 Рис. 3.2.1.е. Выбор процедуры отчисления  глобальных групп из курсов в диалоговом окне инструмента «Выполнить действие».

 Затем из раскрывающегося списка в поле «Найти» (Рис. 3.2.1.ж) выбрать курсы, из  которых должны быть отчислены отобранные глобальные группы (допускается множественный выбор).

Рис. 3.2.1.ж. Настройки действия при отчислении глобальных групп из курсов (пример настроек при отчислении участников глобальной группы Группа1 из курса «Теория музыки»).

Если существует необходимость удалить пустые локальные группы в курсе - поставить маркер для «Удалить связанную группу в курсе, если в ней не осталось участников». После нажатия кнопки «Отчислить» произойдет отчисление отобранных глобальных групп из выбранных курсов, результат будет отображен в информационном окне (Рис. 3.2.1.з).

 Рис. 3.2.1.з. Информационное окно о результатах отчисления отобранных глобальных групп из выбранных курсов.

После обновления страницы, результат выполненных действий появится в таблице вкладки «Глобальные группы» (Рис. 3.2.1.и).

Рис. 3.2.1.и. Таблица вкладки «Глобальные группы» по завершению процедуры «Выполнить действие» (участники глобальной группы Группа 1 успешно отчислены из курса «Теория музыки»).

-Вернуться к Содержанию-

3.3. Вкладка «Курсы»

 В таблице предустановленной вкладки «Курсы» (Рис. 3.3.1) представлен перечень курсов. По умолчанию, выводятся значения следующих полей:

  • fullname - полное название курса;
  • name (связанной сущности Глобальные группы) - названия глобальных групп, синхронизированных с курсом через запись на курс «Синхронизация с глобальной группой».

Рис. 3.3.1. Вкладка «Курсы» Панели управления СЭО 3КL.

 Изменить состав таблицы (убрать существующие или добавить новые поля) пользователь может на странице «Конфигурация».

-Вернуться к Содержанию-

3.3.1. Возможные действия на вкладке «Курсы»

 Нажатие на название-ссылку, расположенную в ячейке столбца «Полное название курса», позволяет перейти на витрину выбранного курса.

На вкладке «Курсы» предусмотрено  выполнение следующих  групповых действий при помощи инструмента «Выполнить действие»:

  • запись глобальных групп на выбранные курсы;
  • отчисление из выбранных курсов глобальных групп.

  Для записи глобальных групп на курсы следует отобрать необходимые курсы (отметить маркером соответствующий чекбокс), нажать кнопку «Выполнить действие» и, в открывшемся диалоговом окне, выбрать «Запись глобальных групп выбранные на курсы» (Рис. 3.3.1.а). 

Рис. 3.3.1.а. Выбор процедуры записи глобальных групп на выбранные курсы в диалоговом окне инструмента «Выполнить действие».

Затем из раскрывающегося списка в поле «Найти» выбрать глобальные группы, которые должны быть записаны на отмеченные курсы (допускается множественный выбор). В поле «Роль» выбрать из списка назначаемую участникам группы роль (Рис. 3.3.1.б). 

Рис. 3.3.1.б. Настройки действия при групповой записи глобальных групп на курсы (пример записи участников глобальной группы Группа1 на выбранный курс «Демонстрация возможностей Moodle» с ролью Студент).

  В поле формы «Режим синхронизации с локальными группами» определить необходимость локальной группы. После нажатия кнопки «Записать» произойдет запись выбранных глобальных групп на отмеченные курсы с назначенной ролью, результат будет отображен в информационном окне (Рис. 3.3.1.в).

 Рис. 3.3.1.в. Информационное окно о результатах записи глобальных групп на выбранные курсы.

 После обновления страницы, результат выполненных действий появится в таблице вкладки «Курсы» (Рис. 3.3.1.г).

Рис. 3.3.1.г. Таблица вкладки «Курсы» по завершению процедуры «Выполнить действие» (участники глобальной группы Группа 1 успешно записаны на курс «Демонстрация возможностей Moodle» с ролью Студент).

 -Вернуться к Содержанию-

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

Рис. 3.3.1.д. Выбор процедуры отчисления  из выбранных курсов глобальных групп из курсов в диалоговом окне инструмента «Выполнить действие».

Затем из раскрывающегося списка в поле «Найти» (Рис.3.3.1.е) выбрать глобальные группы,  которые должны быть отчислены из отмеченных курсов (допускается множественный выбор).

Рис. 3.3.1.е. Настройки действия при отчислении глобальных групп из курсов (пример настроек при отчислении участников глобальной группы Группа1 из курса «Демонстрация возможностей Moodle»).

Если существует необходимость удалить пустые локальные группы в курсе - поставить маркер для «Удалить связанную группу в курсе, если в ней не осталось участников». После нажатия кнопки «Отчислить» произойдет отчисление выбранных глобальных групп из отмеченных курсов, результат будет отображен в информационном окне (Рис. 3.3.1.ж).

Рис. 3.3.1.ж. Информационное окно о результатах отчисления глобальных групп из выбранных курсов.

После обновления страницы, результат выполненных действий появится в таблице вкладки «Курсы» (Рис. 3.3.1.з).

Рис. 3.3.1.з. Таблица вкладки «Курсы» по завершению процедуры «Выполнить действие» (участники глобальной группы Группа 1 успешно отчислены из курса «Демонстрация возможностей Moodle»).

 -Вернуться к Содержанию-

4. Страница Конфигурация

Нажав кнопку «Конфигурация» пользователь переходит на одноименную страницу плагина (Рис. 4.1), на которой доступны следующие элементы:

  • Табличный список вкладок (поз. 1 Рис. 4.1), отображаемых на панели вкладок Главной страницы. Список содержит названия существующих, на текущий момент, вкладок и количество полей  в них. Вкладки разделяются на предустановленные («Пользователи», «Глобальные группы», «Курсы») и пользовательские (создаваемые пользователем на основе шаблонов).
  • Форма «Добавление новой вкладки» (поз. 2 Рис. 4.1), для создания пользовательских вкладок.
  • Кнопка «Вернуть настройки по умолчанию» (поз. 3 Рис. 4.1). Нажатие на кнопку приводит состояние и количество вкладок к исходному виду: все пользовательские вкладки удаляются, редактирование в предустановленных - отменяется.

Рис. 4.1. Страница Конфигурация Панели управления СЭО 3КL.

На данной странице у пользователя есть возможность редактировать вкладки (изменять названия и состав полей) и добавлять, на основе предустановленных шаблонов, новые.

-Вернуться к Содержанию-

4.1. Редактирование вкладок

 Для изменения существующей вкладки необходимо в перечне вкладок (см. поз.1. Рис. 4.1) кликнуть указателем мыши в выбранной строке. На вновь открывшейся странице (Рис. 4.1.1) будет отображен полный перечень доступных для таблицы полей.

 Рис. 4.1.1. Страница выбора полей вкладок Панели управления СЭО 3КL на примере вкладки «Пользователи».

Значение параметра «Отображаемое имя» (расположен вверху страницы) содержит текущее название редактируемой вкладки, которое пользователь может изменить, внеся соответствующие корректировки в области ввода параметра (Рис. 4.1.2). 

 Рис. 4.1.2. Фрагмент страницы выбора полей для вкладки «Пользователи».

Далее, в разделе «Основные поля», расположены строки перечня доступных для отображения в таблице вкладки полей. Каждая строка поля содержит чекбокс для выбора( см. поз.1 Рис. 4.1.2), название поля с системе (см. поз. 2 Рис. 4.1.2),отображаемое в шапке таблицы название поля  (см. поз. 3 Рис. 4.1.2). Так же, как и  название вкладки, отображаемое имя поля пользователь может отредактировать.

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

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

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

 -Вернуться к Содержанию-

4.2. Создание вкладок

Для того, чтобы создать новую вкладку, в выпадающем меню  формы «Добавление новой вкладки» (Рис. 4.2.1) пользователю нужно выбрать подходящий для его целей шаблон и нажать кнопку «Добавить».

 

 Рис. 4.2.1. Выпадающее меню с шаблонами вкладок формы «Добавление новой вкладки», выбор шаблона «Ответы на задание».

В результате этого откроется страница выбора полей, по содержанию аналогичная странице выбора полей при редактировании вкладки (Рис. 4.2.2).

 Рис. 4.2.2. Страница выбора полей, создание новой вкладки по шаблону «Ответы на задание».

 Выбирая необходимые поля, редактируя отображаемые названия полей и название вкладки пользователь формирует состав и внешний вид таблицы.

После того, как все необходимые изменения будут произведены и сохранены, созданная вкладка появится в списке на странице «Конфигурация» и в панели вкладок «Главной страницы» (Рис. 4.2.3).

Рис. 4.2.3. Главная страница Панели управления СЭО 3КL со вновь добавленной вкладкой «Ответы на задание».

 -Вернуться к Содержанию-

5. Дополнительные возможности настройки вкладок

Внимание!
Применение приведенной ниже информации предполагает наличие у Администратора специализированных знаний и навыков.

Текущая версия плагина предусматривает возможность управления конфигурационным массивом в формате yaml через настраиваемые поля пользователя.

Добавление (изменение) настраиваемых полей и модификаторов осуществляется в профиле пользователя, через  вставку  (редактирование) кода в форме «Конфигурация панели управления СЭО 3KL» на странице «Редактировать настраиваемые поля»  (Меню пользователя>О пользователе>раздел Подробная информация о пользователе>Редактировать настраиваемые поля) (Рис.5.1).

 Рис. 5.1. Страница «Редактировать настраиваемые поля» профиля пользователя.

 -Вернуться к Содержанию-

5.1. Особенности настройки отображения полей даты и времени

 В связи с тем, что значения времени и даты сохраняются в СЭО 3KL в формате Unix Timestamp, немодифицированный  вывод этих параметров может быть не совсем удобен для восприятия пользователями (Рис. 5.1.1).

Рис. 5.1.1. Немодифицированные значения дат в полях «Дата начала» и «Дата последней попытки» вкладки «Ответы на задание».

 Добавление строки модификатора в существующий код настраиваемых полей позволяет преобразовать отображаемые значения дат и времени, в привычный формат. Для этого, в форме «Конфигурация панели управления СЭО 3KL» (см. Рис. 5.1) нужно найти фрагменты кода, которые описывают необходимые даты (в нашем примере это поля «Дата начала» и «Дата последней попытки») и добавить модификатор userdate (Рис. 5.1.2).

Рис. 5.1.2. Вид окна «Конфигурация панели управления СЭО 3KL» до (слева) и после (справа) добавления модификатора для полей «Дата начала» и «Дата последней попытки».

Фрагмент кода на примере поля «Дата начала»: 

            displayname: 'Дата начала' 
            fieldcode: timecreated
modifiers: [userdate]

 После сохранения внесенных изменений  и возврате во вкладку «Ответы на задание» «Главной страницы» Панели управления СЭО 3KL, формат отображения дат примет более удобный для пользователя вид (Рис. 5.1.3). 

Рис. 5.1.3. Вкладка «Ответы на задание», вид после модификации полей «Дата начала» и «Дата последней попытки».

 -Вернуться к Содержанию-

5.2. Создание вкладок средствами yaml

 Добавление подготовленного конфигурационного кода через форму «Конфигурация панели управления СЭО 3KL» позволяет создать новую вкладку с заранее определенными пользователем объектами, полями и настройками, дополнительно реализуя возможности, недоступные при «ручном» создании вкладки.

 Приведенный ниже в качестве примера код создает новую вкладку «Отчет» (модифицированный шаблон «Курсы»), в которой реализован дополнительный элемент фильтрации (выбора периода времени отчета)  и  заблокирована возможность редактирования вкладки через страницу «Конфигурация»:

-
    displayname: Отчёт
    entitycode: course
    editdisabled: true
    filterform:
        date_start:
            type: date_selector
            label: 'Дата начала периода'
        date_end:
            type: date_selector
            label: 'Дата окончания периода'
        submit:
            type: submit
            label: Применить
    fields:
        -
            displayname: Курс
            fieldcode: fullname
            modifiers:
                - crw_link
        -
            displayname: Подкатегория
            fieldcode: categoryname
        -
            displayname: Категория
            fieldcode: categorypath
        -
            displayname: 'Количество студентов на курсе'
            relationcode: students
            fields: {  }
        -
            displayname: 'Количество поступивших на курс'
            relationcode: students
            filterparams:
                enrol__startdate__start: date_start
                enrol__startdate__end: date_end
            fields: {  }
        -
            displayname: 'Количество завершивших курс'
            relationcode: userscompleted
            filterparams:
                course_completions__timecompleted__start: date_start
                course_completions__timecompleted__end: date_end
            fields: {  }
        -
            displayname: 'Количество поступивших ответов по учебному элементу "Задание"'
            relationcode: assign_submission_first_attempt
            filterparams:
                assign_submission__timecreated__start: date_start
                assign_submission__timecreated__end: date_end
            fields: {  }
        -
            displayname: 'Количество выданных простых сертификатов'
            relationcode: certissues
            filterparams:
                simplecertificate_issues__timecreated__start: date_start
                simplecertificate_issues__timecreated__end: date_end
            fields: {  }
        -
            displayname: 'ФИО преподавателя'
            relationcode: contacts
            template: sequence
            fields:
                -
                    fieldcode: lastname
displayname: lastname

 В таблице созданной вкладки (Рис. 5.2.1) выводятся значения следующих полей:

  • fullname - полное название курса.
  • Название категории - подкатегория, в которой размещен курс.
  • Путь категории- категория, в которой размещен курс.
  • Пользователи, записанные на курс в оцениваемой роли (связанной сущности Пользователи) -количество студентов на курсе (фильтр не применяется).
  • Пользователи, записанные на курс в оцениваемой роли (связанной сущности Пользователи) - количество поступивших на курс.
  • Пользователи, завершившие курс (связанной сущности Пользователи) - количество завершивших курс.
  • Первые попытки ответов на задание в курсе (связанной сущности Ответы на задание) -количество поступивших ответов по учебному элементу «Задание».
  • Сертификаты, выпущенные в курсе в указанном периоде (связанной сущности Выданные сертификаты) - количество выданных простых сертификатов.
  • lastname (связанной сущности Пользователи) - ФИО преподавателя (фамилии преподавателей курса).

Рис. 5.2.1. Вкладка «Отчеты».

Элемент вкладки «Фильтрация» позволяет выбрать необходимый при формировании отчета период времени. 

Групповые действия, доступные для выполнения при помощи инструмента «Выполнить действие», аналогичны описанным для вкладки «Курсы».

 Дополнительная информация о настраиваемых полях и синтаксисе YAML в статьях
Настраиваемые поля курса. Применение в поиске курсов через Витрину
Настраиваемые поля. Локальный плагин

 -Вернуться к Содержанию-

Tags: администрирование, подписка
Average rating: 0 (0 Votes)

You cannot comment on this entry