Предыдущая версия справа и слева
Предыдущая версия
Следующая версия
|
Предыдущая версия
|
tech:api:embed_writing_form [2023/03/01 08:36] dmitry_kalashnikov [Кабинет организатора корпоративного диктанта] |
tech:api:embed_writing_form [2023/09/11 04:34] (текущий) dmitry_kalashnikov |
====== Встраивание формы написания диктанта ====== | ====== Встраивание формы написания диктанта ====== |
| |
Ниже представлен полный код HTML-страницы для встраивания формы написания диктанта. | |
Выбран тестовый диктант ("Выдумщик") и тестовый пользователь, поэтому можно писать диктант без предварительной регистрации, а также вставлять готовый текст в форму ввода (временно не работает). | |
| |
Предварительная регистрация включает в себя ввод имени и адреса электронной почты. Подтверждение почты не требуется, чтобы исключить проблемы с регистрацией и в целом её упростить. | |
| |
===== Код встраивания ===== | ===== Код встраивания ===== |
| |
Чтобы появилось окно предварительной регистрации, необходимо из скрипта убрать строчку с заданием ''userId''. В этом режиме вставка в поле ввода запрещается. | Ниже представлен полный код HTML-страницы для встраивания формы написания диктанта. |
| Выбран тестовый диктант ("Выдумщик") и тестовый пользователь, поэтому можно писать диктант без предварительной регистрации. |
| |
| Предварительная регистрация включает в себя ввод имени и адреса электронной почты. Подтверждение почты не требуется, чтобы исключить проблемы с процедурой и в целом её упростить. |
| |
| Чтобы окно предварительной регистрации исчезло, необходимо в скрипте раскомментировать строчку с определением параметра ''customerUserId'' и передавать туда идентификатор пользователя из внешней системы Заказчика. Это может быть любое строковое значение, в том числе email. |
| |
<code javascript > | <code javascript > |
diktado.dict.app.init({ // вызов функции для отрисовки формы написания диктанта (или отчёта, если диктант уже писали) | diktado.dict.app.init({ // вызов функции для отрисовки формы написания диктанта (или отчёта, если диктант уже писали) |
key: "63fdc5cc7f0ae915a5fc30df", // ключ заказчика диктанта | key: "63fdc5cc7f0ae915a5fc30df", // ключ заказчика диктанта |
userId: "63ff08b25d838a2905793493", //ключ тестового пользователя (test@diktado.com), если убрать это поле, то появится предварительное окно регистрации | //customerUserId: "123456", // идентификатор пользователя из внешней системы, если убрать это поле, то появится предварительное окно регистрации |
container: '#dict-container', // селектор html-элемента, куда нужно отрисовать форму написания или отчёт, в формате jQuery | container: '#dict-container', // селектор html-элемента, куда нужно отрисовать форму написания или отчёт, в формате jQuery |
dictId: "62c2b81356a90881f1155a6d", // идентификатор диктанта (тестовый, "Выдумщик") | dictId: "62c2b81356a90881f1155a6d", // идентификатор диктанта (тестовый, "Выдумщик") |
| |
| |
| ===== Пример встроенной формы ===== |
| |
| Пример встроенного тестового диктанта на чистую страницу https://diktado.com/embedded |
| |
===== Тестовый диктант ===== | ===== Тестовый диктант ===== |
===== Кабинет организатора корпоративного диктанта ===== | ===== Кабинет организатора корпоративного диктанта ===== |
| |
Для доступа в кабинет организатора необходимо авторизоваться на веб-сайте https://diktado.com/ под аккаунтом ''test@diktado.com'' (пароль сообщается отдельно). | Для полноценного тестирования встроенного тестового диктанта нужно авторизоваться в кабинете организатора: |
| * авторизуйтесь на веб-сайте https://diktado.com/login/ под аккаунтом ''test@diktado.com'' (пароль ''testdiktado''); |
| * в правом верхнем меню профиля выберите пункт "Корпоративные диктанты", далее диктант "Выдумщик". |
| |
| Внутри кабинета можно увидеть список написавших, отчёты о проверке и статистику по оценкам. Именно так выглядит кабинет организатора для любого встроенного диктанта. |
| |
| ===== Параметры встраивания ===== |
| |
| Для запуска боевого (не тестового) диктанта следует изменить в коде встраивания, который приведён выше, два параметра: |
| * ''key'' (Ключ заказчика) |
| * ''dictId'' (Идентификатор диктанта). |
| |
В правом верхнем меню профиля выбирается пункт "Корпоративные диктанты", далее диктант "Выдумщик". | Эти параметры для конкретного диктанта можно найти в кабинете [[corporate/cabinet#nastrojki_diktanta|организатора диктанта]]. |
| |
Внутри кабинета можно увидеть список написавших и отследить статистику по оценкам. | Также следует сообщить Администратору домен, в который будет встроен диктант (полный URL, например: ''https://mycompany.ru/dictant/''), чтобы он прописал нужные разрешения. |