Загрузка CSV файлов

Сценарий массового создания пользователей и сеансов через CSV файлы

Такая загрузка бывает необходима при варианте без интеграции с вашей системой тестирования (СДО/ЛМС). Для этого нужно использовать функции импорта и экспорта CSV. Студент сможет войти на сеанс в таком варианте по логину и паролю.

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

По созданию экзамена через CSV есть одно правило:

Сначала создаём пользователей
Затем создаём сеансы

Далее необходимо действовать по инструкции:

Выгружаем CSV таблицы пользователей и сеансов из прокторинга и открываем таблицу у себя на устройстве через Excel или Libre office
Для создания пользователей: удалить не нужные нам поля, оставить только нужные поля. Также можно использовать наш шаблон для развития прокторинга (смотри пункт 2.5 инструкции)
Загружаем таблицу через «Импорт CSV»
Для создания сеансов: удалить не нужные нам поля, оставить только нужные поля. Также можно использовать наш шаблон для развития прокторинга (смотри пункт 2.5 инструкции)
Загружаем таблицу через «Импорт CSV»
Участник может приступать к тесту

Часть 1: Базовая CSV выгрузка

1. Загрузка пользователей

1.Нужно загрузить вот такой файл в прокторинг в формате CSV

2. Здесь нужно:

Указать логины студентов в колонке username.
Пароли в колонке password.
Выбрать роль в колонке role (proctor или student).
В nickname можно указать ФИО участника либо оставить столбец пустым, lang – оставить без изменений.

Ограничений по загрузке нет.

3. Загрузить пользователей в прокторинг

2. Загрузка сеансов

1.Правила заполнения шаблона:

В колонке URL необходимо поменять ссылку на свой тест!!! Сейчас там сайт proctoredu.ru
В subject нужно указать название теста. Можно на любом языке.
В поле identifier нужно указывать идентификатор (Без пропусков и только на английском языке, например, session_1).
Скопировать логины студентов из таблицы загрузки пользователей в шаблон загрузки сеансов (в поле students. username).
В поле lifetime указано время проведения экзамена в минутах. Если указано 120, то 120 минут будет идти тест.
Остальные поля можно не менять.

2.Выбрать один из шаблонов:

3.Загрузить сеансы на сервер

3. Выгрузка CSV таблицы из прокторинга

В Microsoft Excel можно открыть файл CSV в кодировке UTF-8, для этого нужно выполнить несколько простых шагов:

1. Выгружаем сеансы:

2. Выгружаем пользователей:

3. Открываем пустой Microsoft Excel файл → Кликаем вкладку «Данные» → кликаем кнопку «Из текста»

4. Выбираем файл CSV в открывшемся диалоге.

5. Откроется окно, где необходимо выбрать кодировку Unicode (UTF-8) и выбрать разделитель столбцов «,» — запятая

6. Альтернативно можно использовать Libreoffice и выбрать разделитель столбцов «,» — запятая.

4. Прохождение сеанса с прокторингом под студентом

Студент открывает ссылку на ваш домен прокторинга. Например, https://demo.proctoring.online/

(сервер demo.proctoring.online используется только в качестве примера, вместо него передайте студенту адрес вашего сервера прокторинга. Адрес вам предоставляет менеджер компании ProctorEdu)

Студент нажимает Войти. Вводит Логин и Пароль. Проходит проверку оборудования.

Часть 2: Подробная инструкция по CSV выгрузке

1. Загрузка пользователей через CSV таблицы:

Обязательными полями для заполнения таблицы с пользователями являются (красным цветом на картинке ниже):

username - логин
password - пароль
role - без указания роли всем пользователям будет автоматически присвоена роль “студент”. Всего роли три: student, proctor, administrator.

Опциональными полями для заполнения являются (зелёным цветом на картинке ниже):

lang - параметр отвечающий за язык интерфейса у пользователя
labels - пользователю возможно присвоить метку для ускорения поиска
nickname - имя пользователя
group - данный параметр актуален только для прокторов, поскольку их можно объединять в группы

!!Другие параметры (колонки) нужно удалить. Они нам не требуются и их нельзя заменить!!

Далее нужно сохранить файл в формате CSV (Файл – Сохранить Как -> CSV UTF-8(разделитель – запятая)(*.csv))

Загрузить файл в администраторе прокторинга в пользователях:

Пользователь создан:

Мы сделали для вас шаблон по за грузке пользователей

2. Создание сеансов через CSV таблицы

Обязательными полями для заполнения таблицы с сессиями являются (красные на скриншоте):

identifier - в случае, если его не указать, идентификатор сеанса будет создаваться автоматически. Это должно быть слово (набор символов) на английском языке без пробелов
subject - название тестирования. Например Математика. Название может быть с пробелами, на любом языке.
student.username - обязательное поле, поскольку без указания студента сеанс будет создан в статусе “шаблон”
url – ссылка на тест

Ненужные поля, которые необходимо удалить:

id - генерируется автоматически
provider - не нужно, сеансы созданы вручную, без интеграции
template - данные не подтягиваются из шаблона
api - не нужно
status - выставляется автоматически
scale - выставляется автоматически
grade - выставляется автоматически
student.id - генерируется автоматически
student.nickname - нет необходимости указывать, поскольку подтянется из профиля студента
student.verified - выставляется автоматически
proctor.id - генерируется автоматически
proctor.nickname - нет необходимости указывать, поскольку подтянется из профиля проктора
proctor.id – выставляется автоматически
proctor.username – используем в members и invites.
pausedAt- выставляется автоматически
signedAt- выставляется автоматически
error- выставляется автоматически
duration- выставляется автоматически
chatAt- выставляется автоматически
incidents- выставляется автоматически
conclusion- выставляется автоматически
comment- выставляется автоматически
score- выставляется автоматически
removedAt - удаление сеансов необходимо запрашивать у команды ProctorEdu через почту поддержки
stoppedAt – время, когда сеанс фактически закончился студентом. Нам это нельзя использовать.
createdAt – нет необходимости использовать. Определяется автоматически.
startedAt - нет необходимости использовать. Определяется автоматически. Фактическое начало теста студентом.
Все поля “averages.–”- выставляется автоматически

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

Все остальные поля являются необязательными для изменения:

rules – правила проведения мероприятия. Нужно указывать ссылку URL
weights – Можно оставить (1,1,1,1,1 итд) как есть. Тогда вес метрик в сеансе останется единичным
local - язык протокола
attempt – количество попыток на сдачу сеанса. Если не указано, то одна попытка. Если поставить 1, то будет несколько сеансов.
timeout – время, на которое студент может переподключиться к тесту в случае отключения от сети в минутах. Если укажете 10, то будет 10 минут на возвращение в тест
scheduledAt- начало сеанса. С этого момента можно зайти в тест под студентом
deadline – время окончания сеанса
lifetime – то время, которое участник может проходить тест в минутах. Если укажете 120, то будет 120 минут на тест
addons - прописываются все необходимые дополнения через запятую без пробелов в одной ячейке (rules,check,mobile,shared и тд)
metrics - прописываются все метрики через запятую без пробелов в одной ячейке (b1, b2,c1,c2 и тд).
timezone – временная зона pdf протокола
members – указываются логины прокторов (Участники). Указываются через запятую.
invites – указываются логины прокторов (Приглашения). Указываются через запятую
quorum – поле кворум
concurrent – поле одновременно

Принцип здесь тот же, что и у пользователей:

Необходимо открыть csv файл с сеансами и оставить необходимые нам поля

Далее нужно сохранить файл в формате CSV (Файл – Сохранить Как -> CSV UTF-8(разделитель – запятая)(*.csv))

Загрузить файл в администраторе прокторинга в сеансах:

Сеансы созданы:

Мы сделали для вас шаблон загрузки сеансов без ненужных вам полей.

3. Особенности при добавлении метрик, весов метрик, дополнений, нескольких прокторов для CSV загрузки сеансов:

Метрики указываются в поле metrics через запятые и addons через запятые. Эти обозначения можно посмотреть в метриках и дополнениях сеанса. Например, если указываете в списке face, то в сеансе будет включена метрика Фотографирование лица

В поле weights указывается вес метрики через запятую. Можно оставить единицу на каждый вес. В интерфейсе прокторинга вес показан здесь:

Логины прокторов нужно указывать через запятую по тому же принципу. В шаблоне есть пример

4. Особенности при добавлении времени начала и окончания сеанса через CSV:

В загрузке сеансов CSV мы используем только поля scheduledAt (начало экзамена) и Deadline (конец экзамена). В них указывается дата в формате UTC

Где:
2023 (год) – 08 (месяц) – 23(число)T19(часы):00(минуты):00(секунды, в прокторинге автоматически округляется до минуты).000Z(можно убрать)

Получается, что здесь нужно учитывать вашу временную зону. Например для Москвы: 21:00 UTC = 00:00 MSK.(UTC +3) Если разбирать пример на скриншоте выше, то в табличке указано 19:00, в прокторинге сеанс начнётся в 21:00 МСК.

Для параметров lifetime и timeout – это нам не нужно. Там мы указываем целое значение. Например, 120 будет означать 120 минут

5. Изменение сеансов через CSV таблицы

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

1) В разделе «сеансы» с помощью инструмента фильтрации ищем сеансы, требующие внесения изменений.
2) Экспортируем CSV файл: в окне «Выбор полей для экспорта» обязательно указав графу «Внутренний ИД» (id), а также те графы, где необходимо произвести изменения в рамках сеансов.

3) Открываем CSV файл, вносим необходимые изменения и сохраняем в корректном (Файл – Сохранить Как -> CSV UTF-8(разделитель – запятая) (*.csv))
4) Далее импортируем CSV файл в разделе «сеансы». В активные и созданные сеансы автоматически вносятся коррективы.