Логика курса, часть 2. Управление действиями и обработчики

*
2024-05-22 11:11
Функционал, описанный в данной статье, в полном объеме доступен в СЭО 3КL, начиная с версии 4.1.6a.
Если вы используете более раннюю версию системы — обратитесь с заявкой на проведение обновления в службу технической поддержки ООО «Открытые технологии».

Инструкция по разделу «Логика курса». Часть 2. Управление действиями и обработчики

«Логика курса» (ЛК) — инструмент, позволяющий автоматизировать процессы отправки уведомлений, записи на курс, отписки от курса и внесения изменений в профиль подписчиков в зависимости от широкого ряда условий и настроек.

Данная инструкция описывает настройки «Обработчиков» и «Управления действиями» Логики курса.

Содержание:

4. Страница Логики курса

Перейдем на страницу просмотра самого элемента Логика курса. Здесь отображается таблица статусов пользователей. Мы только что добавили ЛК и статусы еще не пересчитаны, поэтому здесь нет пользователей и данных. Обычно к этой странице устанавливается доступ только учителям.

Рис. 4.1. Пересчет состояния.

При нажатии на «Пересчитать состояния», мы увидим пересчитанные текущие состояния.

Указан пользователь, его роль, группа, состояние ЛК и дата последнего изменения состояния ЛК:

Пример:

Рис. 4.2. Пример № 1.

Можно перейти по ссылкам в начале каждой строки (иконка с часами) и посмотреть логирование срабатывания обработчиков. Поскольку, ничего еще не выполнялось, логи у нас пустые. Как только обработчик будет выполнен, это действие будет залогировано, будет указано время и успешно или не успешно было выполнено действие. Например, так:

 Пример:

Рис. 4.3. Пример № 2.

или

Рис. 4.4. Пример № 3.

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

4.1. Обработчики Логики курса

Перейдем к настройке обработчиков Логики курса и действий, см. Рис.4.1.1

Рис 4.1.1. Управление действиями. Обработчики.

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

4.1.1. Виды обработчиков

Обработчики ЛК можно условно поделить на два типа:
Обработчики при активации и обработчики при деактивации.

  • При активации выполняются действия при смене статуса с неактивного на активный, «Условие: логика курса активна».
  • При деактивации — наоборот — при смене статуса с активного на неактивный. «Условие: логика курса неактивна".

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

  • Однократные выполняют блок действий один раз.
  • Периодические выполняют действия многократно с указанным интервалом.
Примечание.
Повторно попасть на страницу «Управление действиями» ЛК можно нажав на иконку или описание элемента ЛК в курсе. При этом, мы сначала попадаем на страницу Просмотра Логики курса (описание в п.7). На этой странице нужно нажать на ссылку «Управление действиями» в верхнем подменю. См. рис.4.1.1.а

Рис 4.1.1.а. Переход из Просмотра ЛК в Управление действиями.

Чтобы перейти в настройки обработчика, нажмем на пиктограмму «шестеренка», см. Рис.4.

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

4.1.2. Настройки обработчиков

Рис 4.1.2.а. Настройки обработчика.

«Включить» — «Нет/Да». Включение и выключение обработчика. По умолчанию выключен.

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

«Срабатывает» — «1 раз / Периодично». Будет ли обработчик срабатывать один раз или периодически, с указанным ниже интервалом.

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

«Условие» — «Логика курса активна / Логика курса не активна». Указывает, когда срабатывает обработчик — при активации или при дезактивации ЛК. Эта опция позволяет делать инверсию срабатывания обработчика на оба изменения состояния ЛК.

Пример. К примеру, включим обработчик, укажем однократное срабатывание при активации логики курса и сохраним настройки.

 Рис 4.2.2. Настройки обработчика. Пример.

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

5. Управление действиями. Добавление действий.

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

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

Рис 5.1. Добавление действий.

Доступные действия описаны ниже.

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

5.1. Действие «Отправить сообщение»

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

Рис. 5.1.1. Страница настроек действия «Отправить сообщение».

Доступны следующие настройки (см. Рис. 5.1.1):

  • Включить. Включает (= Да) или отключает (= Нет) отправку сообщений.
  • Получатель. Позволяет указать пользователей курса, которым будет отправлено сообщение. Доступные варианты:
    • Преподаватель.
    • Куратор.
    • Студент.
  • Текст уведомления. Непосредственно текст сообщения, которое будет разослано получателям при срабатывании логики курса. При формировании текста сообщения могут быть использованы возможности встроенного редактора и макроподстановки.
Актуальные макроподстановки и их описание доступны также в окне справки настройки «Текст уведомления» (Рис. 5.1.2).
  • Краткое уведомление.  Если в СЭО 3КL настроена отправка уведомлений по СМС, в поле можно задать отдельный текст для СМС сообщения.  Поддерживается использование макроподстановок.
Подробная информация по настройке уведомлений и СМС  в статьях «Уведомления в СЭО 3КL» и «Настройка отправки уведомлений пользователю по СМС».
  • Отправлять от имени. Позволяет указать, от имени какой роли будут отправляться сообщения. Доступные варианты:
    • Студент.
    • Преподаватель.
    • Администратор.
  • Выберите отправителя.  Позволяет выбрать в качестве отправителя определенного преподавателя, если в курсе присутствует несколько пользователей с ролью «Преподаватель».

По завершении редактирования действия сохраняем его настройки нажатием кнопки «Сохранить».

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

5.2. Действие «Записать в поле профиля»

При срабатывании логики курса действие записывает в указанное в настройках поля профиля заданное значение.

Рис 5.2. Добавление действия «Записать в поле профиля».
  • Включить. Включает (= Да) или отключает (= Нет) запись значения в поле профиля.
  • Запись в поле профиля. Выпадающий список настройки позволяет выбрать поле профиля, в которое будет, по срабатыванию Логики курса,  записываться значение. Поддерживаются и основные, и дополнительные поля профиля пользователя.
  • Шаблон макроподстановки. В этом поле указывается значение, которое нужно записать в поле профиля. Здесь также поддерживаются макроподстановки.

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

5.3. Действие «Добавить в группу»

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

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

Доступны следующие настройки действия (см. Рис. 5.3.1):

  • Включить. Включает (= Да) или отключает (= Нет) действие добавления в группу.
  • Группы.  Выпадающий список настройки позволяет определить локальную группу (или группы, настройка допускает множественный выбор), в которую должен быть зачислен слушатель при срабатывании Логики курса. Выбор локальной группы для записи выполняется либо непосредственно по ее названию (поз. 1 Рис. 5.3.2), либо по значению поля профиля пользователя (поз. 2 Рис. 5.3.2), отмеченных в выпадающем списка настройки. При этом, необходимое поле профиля можно указать используя автоподстановку (перечень доступных автоподстановок доступен в модальном окне подсказки настройки).
  • Нестрогое соответствие. Настройка включает следующие опции:
  • Опция «Если включено, то группа может быть найдена по неполному совпадению с выбранными полями пользователя». Если опция включена, слушатели зачислятся во все группы, у которых при сопоставлении названий групп со значением поля  было частичное совпадение.
Например, при значении «математика» слушатели будут зачислены сразу во все группы, названия которых включают это слово: «математика для младших классов», «математика для старших классов», «высшая математика» и т. п.
  • Опция «Учитывать регистр». Если опция включена, во время поиска групп будет учитываться регистр букв.
  • Опция «Создать группу, если не найдена». Если опция установлена, но локальная группа с указанным значением поля отсутствует в курсе на момент срабатывания Логики курсаи — такая группа будет автоматически создана системой и пользователи будут туда записаны.
  • Способ распределения слушателей в группы. Определяет алгоритм распределения слушателей в локальные группы. Возможные варианты:
    • Добавить во все группы — слушатели зачисляются сразу во все указанные локальные группы.
    • Добавить в одну из групп — слушатели зачисляются в локальную группу с наименьшим количеством участников (при этом, если локальные группы на момент срабатывания Логики курса содержат одинаковое количество участников, группа для записи выбирается в случайном порядке).

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

5.4. Действие «Записать на курс»

Действие позволяет записать пользователя в выбранный курс с указанной ролью.

Обратите внимание,  действие может быть выполнено только в отношении других курсов (так как, если Логика Курса сработала в отношении пользователей, значит, они уже являются подписчиками данного курса) и может быть востребовано, когда необходимо  подписать слушателей текущего курса на другой курс по событию или по условию, например:
   • слушатель при входном тестировании набрал меньше определенного количества баллов и автоматически подписывается  на курс «ликбеза» для повторения предыдущего материала;
   • для слушателей предусмотрена регулярная переаттестация и необходима повторная (ежегодная) запись на курс тестирования, с обнулением предыдущих попыток тестирования и результатов.

Рис 5.4.1. Добавление действия «Записать на курс».
  • Включить. Включает (= Да) или отключает (= Нет) действие.
  • Курс. Выпадающие списки настройки позволяют выбрать категорию курсов и курс в ней.
  • Роль. Устанавливает роль, с которой пользователь будет записан на курс.
  • Перезапись на курс. Определяет алгоритм действия в случае, если у пользователя уже есть подписка на указанный курс:
    • Нет — существующая подписка остается без изменений.
    • Да — пользователь отписывается от курса и подписывается заново.
  • Восстановить оценки. Определяет алгоритм восстановления оценок, если ранее пользователь уже был подписан на этот курс:
    • Да — пытаться восстановить предыдущие оценки.
    • Нет — не учитывать предыдущие оценки.
  • Очистить модули курса. Если = «Да», все предыдущие следы и действия пользователя в элементах курса и ресурсах (оценки, попытки прохождения, ответы и т. п.) будут удалены.
Не рекомендуем применять очистку модулей курса без полной уверенности в том, что удаляемые данные вам больше никогда не понадобятся: операция очистки данных пользователя в курсе необратима и удаляет все следы деятельности пользователя в курсе и его оценки (кроме данных в блоке «История обучения» и отдельных плагинов, не поддерживающих очистку).
Дополнительная информация в статье «Способы записи пользователей на курс».

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

5.5. Действие «Отписать от текущего курса»

При срабатывании логики курса действие отписывает слушателей курса из текущего курса.

Обратите внимание: после отписки пользователя от текущего курса он перестанет как-либо обрабатываться Логикой курса, поэтому использовать этот инструмент для перезаписи пользователя невозможно.

 Рис 5.5. Добавление действия «Отписать от текущего курса».
  •  Включить. Включает (= Да) или отключает (= Нет) действие.

Удалить результат обучения. Если = «Да», все данные пользователя в текущем курсе (оценки, попытки прохождения, ответы и т. п.) будут удалены.

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

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

5.5.1. Перезапись пользователя на курс без сохранения оценок

Если необходимо отчислить пользователя из курса и записать его заново без сохранения оценок за такие элементы, как «Задание» и «Тест», нужно добавить действие  «Записать на курс» в условие. Правильно настроенное условие будет выглядеть следующим образом:

Рис. 5.5.1.1. Условия для перезаписи пользователя в курс.
Пошаговые настройки

1. Добавление ограничения. При добавлении элемента ЛК в курс нужно, в первую очередь, настроить ограничение доступа.
Добавим, к примеру, ограничение по городу в поле профиля пользователя «Город». Для срабатывания ЛК нужно, чтобы у пользователя в поле профиля «Город» было указано значение «Москва». Ограничение может быть любым в зависимости от потребностей в конкретной ситуации.

Рис. 5.5.1.2. Ограничение по полю профиля пользователя.

2. Добавление условия. После добавления ограничения нужно нажать кнопку «Сохранить и показать».  На открывшейся странице выбрать вкладку «Управление действиями». Выбрать «Условие: логика курса активна».

Рис. 5.5.1.3. Выбор действий.

Далее добавляется действие «Записать на курс».

Рис. 5.5.1.4. Добавление действия «Записать на курс».

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

Рис. 5.5.1.5. Настройка действия «Записать на курс».
Обязательно обратите внимание на настройки «Перезаписать на курс» и «Очистить модули курса». Они обязательно должны быть переведены в значение «ДА»!

После сохранения настроек ВСЕ пользователи, в полях профилей которых значение «Город» соответствует значению «Москва»,  будут перезаписаны в этот курс и все выполненные ими задания/тесты и оценки за них обнулятся.

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

5.6. Действие «Удалить пользовательские данные в курсе»

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

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

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

Настройка «Включить» (см. Рис. 5.6) позволяет включить (= Да) или выключить (= Нет) действие.

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

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

6. Обработчики и действия

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

Пример:

Рис 6. Примеры добавленных действий.

При наведении на (?) можно увидеть подсказку по выбранному действию.

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

7. Дополнительная информация

7.1. Макроподстановки

Макроподстановки позволяют использовать в тексте письма динамически меняющиеся элементы, например, название курса или ФИО студента. В тексте сообщений возможно использование следующих макроподстановок:

Доступные макроподстановки:

{CURRENTDATE} — Текущая дата в формате d-m-Y H:i:s;
{CURRENTTIMESTAMP} – Позволяет записать текущую дату в поле профиля пользователя типа «Дата»;

Макроподстановка {CURRENTTIMESTAMP} может быть применена только для действия «Записать в поле профиля».

{STUDENTFULLNAME} — ФИО студента;
{STUDENTPROFILELINK} — Ссылка на профиль студента;
{COURSEFULLNAME} — полное название курса;
{COURSELINK} — Ссылка на курс;
{MODULEPAGE} — Ссылка на страницу текущего элемента с сообщением;
{MODULENAME} — Текущее название элемента курса.

Макроподстановки данных студента:

{FIRSTNAME} — Имя;
{LASTNAME} — Фамилия;
{EMAIL} — Адрес электронной почты;
{CITY} — Город;
{COUNTRY} — Страна;
{LANG} — Предпочитаемый язык;
{DESCRIPTION} — Описание;
{URL} — Веб-страница;
{IDNUMBER} — Индивидуальный номер;
{INSTITUTION} — Учреждение (организация);
{DEPARTMENT} — Отдел;
{PHONE1} — Телефон;
{PHONE2} — Мобильный телефон;
{ADDRESS} — Адрес;
{FIRSTNAMEPHONETIC} — Имя — фонетическая запись;
{LASTNAMEPHONETIC} — Фамилия — фонетическая запись;
{MIDDLENAME} — Отчество или второе имя;
{ALTERNATENAME} — Альтернативное имя.
{PROFILE_FIELD_XXXX} — где XXXX — краткое имя настраиваемого поля профиля пользователя. Подставляет значение из указанного кастомного поля профиля (доступно с версии 3.5.6a).
{USERNAME} — Логин (доступно с версии 3.5.6a). 

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

На скриншоте приведён пример приветственного письма новому студенту, содержащему макроподстановки:

Рис 5.1.2. Пример сообщения с макроподстановками.

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

7.2. Права на получение уведомлений

Важно помнить, что отправка уведомлений происходит с учетом прав пользователей. 

 По умолчанию роль «Студент» имеет право получать уведомления для студентов, роль «Учитель» имеет право получать уведомления для учителей, роль «Куратор» — для кураторов. Если в курсе используются нестандартные роли, и пользователям с этими нестандартными ролями необходимо получать уведомления, в их роли нужно добавить соответствующие права:

mod/otcourselogic:is_student,
mod/otcourselogic:is_teacher,
mod/otcourselogic:is_curator.

Право mod/otcourselogic:is_curator имеет контекст пользователя, права для учителя и студента в контексте курса.

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

Можно перейти к Части 3 данной инструкции — «Примеры использования Логики курса»

Tags: Логика курса, элемент курса
Average rating: 5 (2 Votes)

You cannot comment on this entry