Подключение LMS
Как подключить платформу к Moodle по LTI 1.3 одной ссылкой, связать курс с потоком и проверить, что вход, состав группы и оценки работают.
После подключения студенты и преподаватели попадают на платформу по ссылке из своего курса в LMS: без кода приглашения и с ФИО из LMS. Подходит любая LMS с LTI 1.3. Шаги ниже описаны для Moodle.
Вход, состав группы и оценки в журнале мы проверяли на Moodle 5.0.2 в прежней версии платформы. Текущую версию на живом Moodle ещё не запускали, поэтому при первом подключении держите с нами связь.
Кто что делает:
- администратор организации на платформе выдаёт ссылку для подключения;
- администратор Moodle вставляет её в Moodle;
- преподаватель курса первым входом из курса связывает курс с потоком.
Вход по коду приглашения не отменяется
Подключение LMS добавляет второй вход рядом с кодом приглашения. Если что-то пойдёт не так, поток продолжает работать как раньше.
Шаг 1. Получить ссылку на платформе
Администратор организации открывает в меню платформы страницу «LMS» и нажимает «Получить ссылку для LMS». Ссылка подписана, называет вашу организацию и действует 7 дней. Её можно переслать почтой администратору Moodle.
Подключение одно на LMS: если зарегистрировать ту же LMS повторно, платформа обновит прежнее подключение, а не заведёт второе.
Шаг 2. Вставить ссылку в Moodle
В Moodle откройте «Администрирование», раздел «Плагины», затем «Модули деятельности», «Внешний инструмент» и «Управление инструментами». Вставьте ссылку в поле «URL инструмента» и нажмите «Добавить LTI Advantage».
Moodle откроет окно, и платформа зарегистрируется сама: Moodle и платформа обменяются адресами и ключами без ручного ввода. Когда в окне появится «Disputa подключена», его можно закрыть.
Затем в списке инструментов включите Disputa и откройте её настройки. Проверьте:
| где | что должно быть | зачем |
|---|---|---|
| Контейнер для запуска инструмента по умолчанию | Новое окно | платформа открывается своей страницей, у преподавателя на защите вся ширина экрана |
| Показать при создании элементов | Показать в выборе элемента и как предварительно настроенный инструмент | преподаватель сможет добавить Disputa в курс |
| Службы заданий и оценок IMS LTI | Использовать эту службу для синхронизации оценок и управления столбцами | оценки попадают в журнал Moodle |
| Предоставление имён и ролей IMS LTI | Использовать эту службу для получения информации об участниках | организатор видит, кто из группы ещё не дошёл до платформы |
| Определять полное имя пользователя, запускающего инструмент | Всегда | на защите и в составе группы видны фамилии, а не номера |
| Определять адрес электронной почты пользователя | по вашему решению | почта платформе не обязательна |
Если LMS не умеет подключаться по ссылке
На странице «LMS» раскройте «LMS без динамической регистрации». Там четыре адреса для LMS:
| на платформе | вид адреса |
|---|---|
| Tool URL | https://<адрес платформы>/app |
| Initiate login URL | https://<адрес платформы>/api/lti/login |
| Redirection URI | https://<адрес платформы>/api/lti/launch |
| Public keyset URL | https://<адрес платформы>/api/lti/jwks |
В Moodle выберите «настроить инструмент вручную», укажите версию LTI 1.3, тип открытого ключа «URL-адрес набора ключей» и эти адреса, а настройки из таблицы выше задайте так же. После сохранения Moodle покажет в сведениях о конфигурации шесть значений: Platform ID, Client ID, Deployment ID, Authentication request URL, Access token URL и Public keyset URL. Их вписывают в форму на той же странице платформы и нажимают «Подключить».
Адреса и значения не секретные: это идентификаторы, по которым платформа узнаёт ваш Moodle.
Шаг 3. Добавить в курс и связать с потоком
Преподаватель добавляет в курс элемент «Внешний инструмент» и выбирает Disputa. Его первый вход из курса связывает курс LMS с потоком: платформа показывает потоки, которые он ведёт, и просит выбрать. Связывать может организатор потока или администратор организации.
Курс связывается один раз. Уже связанный курс к другому потоку не перепривязывается: это изменило бы, куда попадают люди.
Если поток известен заранее, в пользовательских параметрах инструмента можно указать disputa_run=<ключ потока>. Тогда первый вход преподавателя свяжет курс без выбора.
Студенты, которые нажали ссылку раньше преподавателя, увидят «Курс ещё не подключён». После привязки та же ссылка поведёт их в поток.
Роли
Роли выдаются в потоке, с которым связан курс.
| в курсе LMS | на платформе |
|---|---|
| преподаватель, администратор | организатор потока и проверяющий |
| ассистент преподавателя | проверяющий |
| все остальные | студент |
Что увидит человек при первом входе
Платформа один раз спрашивает, кто пришёл: тот, кто уже входил в Disputa, входит своей учётной записью, новый нажимает «Продолжить». Дальше ссылка в курсе открывает платформу сразу.
Если работы сдаются через pull request на GitHub, платформа попросит студента привязать GitHub перед командой или первой сдачей: входить через GitHub закон не разрешает, по нему только зовут в репозиторий.
По почте учётные записи не объединяются: в Moodle почту часто меняет сам студент, и так можно попасть в чужую учётную запись.
Состав группы
На странице «LMS» у каждого связанного курса есть «состав группы»: сколько студентов в курсе, сколько уже дошли до платформы и кто ещё не входил, поимённо. Адрес состава LMS сообщает только при входе, поэтому состав доступен после первого входа из курса.
Оценки в журнале
Оценка уходит в журнал LMS после того, как проверяющий закрыл приёмку. Отправляется только принятая работа, в том числе принятая с долгом; долг уходит комментарием к оценке. Возвращённая на доработку работа оценки не даёт и в журнал не попадает.
У каждой работы свой столбец «Работа N. Название». Платформа заводит его сама при первой оценке, повторная оценка той же работы попадает в тот же столбец. Предупредите преподавателей, иначе столбцы выглядят как чужие.
Оценку получают те, кто хотя бы раз входил из курса LMS. Если журнал не ответил, приёмка всё равно закрывается: оценку можно перенести руками.
Если не заработало
| что видно | в чём дело |
|---|---|
| «Ссылка для подключения устарела или неверна» | ссылке больше 7 дней или она скопирована не целиком, возьмите новую на странице «LMS» |
| «Эту ссылку вставляют в LMS» | ссылку открыли в браузере, её нужно вставить в Moodle |
| «Не получилось подключиться» | Moodle не отдал настройки или не принял регистрацию, причина написана в том же сообщении |
| «эта LMS не подключена к платформе» | регистрация не завершилась или инструмент заведён для другой организации |
| «это подключение LMS не зарегистрировано у нас» | инструмент в Moodle заведён заново, подключите его ссылкой ещё раз |
| «вход устарел» | со времени нажатия прошло больше 10 минут, нажмите ссылку в курсе ещё раз |
| «токен просрочен» или «часы LMS и наши разошлись» | часы сервера Moodle ушли, включите синхронизацию времени (NTP) |
| платформа открылась внутри страницы курса и не пускает | контейнер запуска не «Новое окно», поменяйте в настройках инструмента |
| «Курс ещё не подключён» | преподаватель ещё не входил из курса и не выбрал поток |
| состав группы не приходит | в курсе ещё никто не входил или выключена служба «Предоставление имён и ролей» |
| оценки не появляются в журнале | выключена служба «Службы заданий и оценок», приёмка не закрыта, работа возвращена или студент не входил из LMS |
Спецификация LTI 1.3 требует HTTPS: вузовский Moodle обычно так и работает, а на тестовом стенде без него могут не пройти вход и службы.
Не нашли ответа, напишите в Telegram, разберёмся по вашему Moodle.