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

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

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

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

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

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

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

Указан пользователь, его роль, группа, состояние ЛК и дата последнего изменения состояния ЛК (Рис. 4.2).

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

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

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

Перейдем к настройке обработчиков ЛК и действий (Рис. 4.1.1).

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

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

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

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

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

• Однократные выполняют блок действий один раз.
• Периодические выполняют действия многократно с указанным интервалом.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Включить. Включает (= Да) или отключает (= Нет) отправку сообщений.

• Получатель. Позволяет указать пользователей курса, которым будет отправлено сообщение. Доступные варианты:
  
  • Преподаватель.
  • Куратор.
  • Студент.

• Текст уведомления. Непосредственно текст сообщения, которое будет разослано получателям при срабатывании логики курса. При формировании текста сообщения могут быть использованы возможности встроенного редактора и макроподстановки.

• Краткое уведомление.  Если в СЭО 3КL настроена отправка уведомлений по СМС, в поле можно задать отдельный текст для СМС сообщения.  Поддерживается использование макроподстановок.

• Отправлять от имени. Позволяет указать, от имени какой роли будут отправляться сообщения. Доступные варианты:
  • Студент.
  • Преподаватель.
  • Администратор.

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

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

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

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

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

• Включить. Включает (= Да) или отключает (= Нет) запись значения в поле профиля.

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

• Шаблон макроподстановки. В этом поле указывается значение, которое нужно записать в поле профиля. Здесь также поддерживаются макроподстановки.

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

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

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

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

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

• Группы.  Выпадающий список настройки позволяет определить локальную группу (или группы, настройка допускает множественный выбор), в которую должен быть зачислен слушатель при срабатывании Логики курса. Выбор локальной группы для записи выполняется либо непосредственно по ее названию (поз. 1 Рис. 5.3.2), либо по значению поля профиля пользователя (поз. 2 Рис. 5.3.2), отмеченных в выпадающем списка настройки. При этом, необходимое поле профиля можно указать используя автоподстановку (перечень доступных автоподстановок доступен в модальном окне подсказки настройки).

• Нестрогое соответствие. Настройка включает следующие опции:

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

• Опция «Учитывать регистр». Если опция включена, во время поиска групп будет учитываться регистр букв.
  

• Опция «Создать группу, если не найдена». Если опция установлена, но локальная группа с указанным значением поля отсутствует в курсе на момент срабатывания Логики курсаи — такая группа будет автоматически создана системой и пользователи будут туда записаны.

• Способ распределения слушателей в группы. Определяет алгоритм распределения слушателей в локальные группы. Возможные варианты:
  • Добавить во все группы — слушатели зачисляются сразу во все указанные локальные группы.
  • Добавить в одну из групп — слушатели зачисляются в локальную группу с наименьшим количеством участников (при этом, если локальные группы на момент срабатывания Логики курса содержат одинаковое количество участников, группа для записи выбирается в случайном порядке).

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

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

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

• Включить. Включает (= Да) или отключает (= Нет) действие.

• Курс. Выпадающие списки настройки позволяют выбрать категорию курсов и курс в ней.

• Роль. Устанавливает роль, с которой пользователь будет записан на курс.

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

• Восстановить оценки. Определяет алгоритм восстановления оценок, если ранее пользователь уже был подписан на этот курс:
  
  • Да — пытаться восстановить предыдущие оценки.
  • Нет — не учитывать предыдущие оценки.

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

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

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

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

•  Включить. Включает (= Да) или отключает (= Нет) действие.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{CURRENTDATE} — Текущая дата в формате d-m-Y H:i:s;
{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). 

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

Пример приветственного письма новому студенту, содержащего макроподстановки (Рис. 7.1.1):

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

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

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

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

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

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

8. Возможные сценарии

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

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

Предусловия:

1) Курс уже создан и наполнен материалами.

2) В профиле пользователя указан город «Москва».

3) Пользователь уже прошел элементы «Задание» и «Тест» и получил оценку.

Решение:

1) Добавление ограничения.

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

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

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

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

Результат:

Добавляем действие  «Записать на курс». Правильно настроенное действие будет выглядеть следующим образом (Рис. 8.1.5):

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

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

8.2. Запись в локальные группы

Задача: нужно в курсе по литературе автоматически записать пользователей в группы с соответсвующим их классу названием.

Предусловия:

1) Курс уже создан и наполнен материалами.

2) Пользователи уже подписаны на курс.

3) У пользователей заполнено дополнительное поле профиля «Класс»: значение «7А» или «7Б».

Решение:

1) Добавление Логики курса.

При добавлении ЛК нужно обязательно настроить ограничение доступности по полю профиля «Класс» (поз. 2 Рис. 8.2.1) и разрешить студенту соответствовать любому из значений (поз. 1 Рис. 8.2.1).

2) Добавление действия.

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

Откроется страница настройки действия. Для успешного выполнения задачи они должны быть заполнены следующим образом (Рис. 8.2.3):

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

Страница обновится, а статус «Выключен» пропадет. Обработчик сработает корректно.

Результат.

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

На странице групп курса также будут отображаться созданные группы с пользователями, которые автоматически были туда добавлены (Рис. 8.2.6 и 8.2.7).

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

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