Загрузить пользователей

Загрузка пользователей через текстовый файл

Участвуют различные опции для загрузки информации (полей, связанных с пользователем) этим методом: от записи пользователей на несколько курсов с конкретными ролями до обновления информации пользователя в Профиле пользователя и удаления пользователей с сайта.

Совет: Обычно нет необходимости массово загружать пользователей с помощью «Загрузить пользователей». Чтобы сократить объём работ по обслуживанию, следует сначала изучить формы аутентификации, не требующие ручного обслуживания, такие как подключение к существующим внешним базам данных или позволить пользователям создавать свои учётные записи (Самостоятельная запись). Дополнительная информация в разделе Аутентификация. Видеоссылка: Как массово загружать пользователей и добавлять на курсы

Форматы файлов для загрузки пользователей

Файл для загрузки пользователей содержит поля, разделённые запятой (или другим разделителем) — без пробелов. Первая строка содержит допустимые имена полей. Остальные строки (записи) содержат информацию о каждом пользователе.

Совет: Избегайте специальных символов в информации о полях, таких как кавычки или другие запятые. Протестируйте файл с одной записью перед массовой загрузкой.

Совет: Вы можете использовать программу для работы с электронными таблицами, чтобы создать файл с требуемыми столбцами и полями. Затем сохраните файл как «CSV (с разделителями-запятыми)». Эти файлы можно открыть с помощью простых текстовых редакторов (например, Notepad++) для проверки.

Допустимый файл для загрузки для тестирования

• Из раздела «Администрирование» / «Пользователи» / «Загрузить пользователей» доступен пример текстового файла (example.csv). Его можно скачать и адаптировать под свои нужды. Он включает:

username,firstname,lastname,email
student1,Student,One,s1@example.com
student2,Student,Two,s2@example.com
student3,Student,Three,s3@example.com

• Дополнительные поля могут быть добавлены следующим образом. Курс и глобальная группа должны быть созданы вручную заранее.

username,firstname,lastname,email,course1,group1,cohort1
student1,Student,One,s1@example.com,math102,groupA,cohortZ
student2,Student,Two,s2@example.com,math102,groupB,cohort Y
student3,Student,Three,s3@example.com,math102,groupA,cohortZ

Поля пользователя, которые можно включить

Совет: Мы настоятельно рекомендуем протестировать файл, содержащий поля, которые вы планируете использовать, с одним пользователем, прежде чем пытаться загрузить файл в первый раз.

Обязательные поля

Это обязательные идентификационные поля пользователя: username,firstname,lastname,email Проверки допустимости выполняются для:

• username может содержать только буквенные строчные буквы, цифры, дефис '-', нижнее подчёркивание '_', точку '.' или знак @
• email имеет форму: name@example.com

Пароли

Поле «пароль» не обязательно, если в настройках экрана загрузки установлено «Создать пароль, если необходимо, и отправить по электронной почте», но требуется, если настройка «Обязательно в файле».

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

Чтобы принудительно изменить пароль для конкретного пользователя, установите поле пароля на changeme. Если оно опущено, пароль будет сгенерирован для каждого пользователя (во время следующего задания Cron) и отправлены приветственные электронные письма. Текст приветственного письма находится в языковых настройках в Администрирование сайта > Язык > Локальные изменения языкового пакета с идентификатором строки 'newusernewpasswordtext'.

Необязательные поля пользователя

Примечание: запятые внутри поля должны быть закодированы как &#44 — скрипт преобразует их обратно в запятые. Совет: для логических полей с двумя значениями используйте 0 для false и 1 для true.

Чтобы задать значения, отличные от значений по умолчанию, вы можете включить одно или несколько из этих необязательных полей пользователя:

institution,department,city,country,lang,auth,timezone,idnumber,icq,phone1,phone2,address,url,description,mailformat,maildisplay,maildigest,htmleditor,autosubscribe,interests,theme

Большинство из них являются полями профиля пользователя или полями настроек пользователя, которые принадлежат профилю пользователя и заполняются пользователем или при ручном создании. Некоторые, однако, требуют определённых форматов:

См. Дополнительные поля имени для более подробной информации. Основные моменты, на которые следует обратить внимание:

country — используйте двухбуквенный код страны, в верхнем регистре, например, AU, ES, GB, US. Все они ЗАПИСАНЫ В ВЕРХНЕМ РЕГИСТРЕ. Использование «au» или «es» или «USA» в качестве кода страны приведёт к ошибке в базе данных. Если у вас возникли проблемы с определением двухбуквенного кода страны, вы можете ознакомиться со списком названий стран и кодовых элементов, доступным на веб-сайте ISO. Распространённой ошибкой является использование UK для Соединённого Королевства; должно быть GB.

lang — используйте двухбуквенный (или расширенный четырёхбуквенный) код, как определено в языковых пакетах Moodle, например, en, es, en_us, de, in Администрирование сайта > Язык > Языковые пакеты.

auth — поле auth должно быть использовано, если на сайте используется альтернативный метод аутентификации, такой как LDAP, иначе метод аутентификации будет установлен вручную, и пользователи, использующие другой метод auth, не смогут войти в систему. Используйте короткие коды, определённые в разделе «Плагины > Аутентификация» для различных типов, например, manual, nlogin, ldap, cas, mnet, db, none. Если вы не включите столбец auth, то вновь созданные пользователи будут созданы с типом учётной записи вручную.

Вы можете установить «auth» на «nologin» в своём CSV-файле, что означает, что созданные пользователи не смогут войти в систему.

timezone — должен быть в формате, как указано в настройках местоположения в терминах Zone/Region, например, Australia/Sydney, Asia/Kathmandu, Europe/Madrid и т. д. Запись чувствительна к регистру, поэтому Europe/London будет работать, а europe/london — нет.

Примечание: Необходимы настройки для mailformat, maildisplay, htmleditor, autosubscribe.

maildigest Чтобы предотвратить получение пользователями большого количества электронных писем с курсов или форумов с принудительной подпиской, используйте maildigest. Варианты для этого поля: 0 = Без дайджеста, 1 = Полный дайджест и 2 = Дайджест только с темами.

maildisplay позволяет вам установить опцию отображения электронной почты для пользователя. Варианты для этого поля: 0 = Скрыть мой адрес электронной почты от непривилегированных пользователей, 1 = Разрешить всем видеть мой адрес электронной почты и 2 = Разрешить видеть мой адрес электронной почты только другим участникам курса.

emailstop позволяет вам предотвратить уведомления. Варианты для этого поля: 0 = без уведомлений и 1 = разрешить уведомления.

theme Пользовательские темы могут быть добавлены с помощью 'classic', 'boost' или названия любой другой установленной темы. Значение должно быть кратким названием темы, например, 'boost', а не 'Boost', 'fordson', а не 'Fordson'.

Названия настраиваемых полей профиля

Они необязательны и зависят от того, создали ли вы какие-либо настраиваемые поля профиля на своём сайте. Название заголовка в файле имеет вид 'profile_field_xxxxx', где xxxx — уникальное краткое название настраиваемого поля профиля пользователя, как вы его создали.

Название поля должно соответствовать регистру краткого названия поля профиля. Так, например, если краткое название вашего настраиваемого поля профиля написано полностью в верхнем регистре, например, DOB, тогда используйте заголовок profile_field_DOB, чтобы соответствовать регистру, а не profile_field_dob, что приведёт к ошибке «недействительное имя поля». Аналогично, краткое название в смешанном регистре, такое как Dob, должно иметь заголовок profile_field_Dob. (Исключением является случай, когда краткое название написано полностью в нижнем регистре, тогда любой регистр будет работать в заголовке поля, что является исторической особенностью: но лучшая практика — соблюдать регистр, и вы избежите ошибок.)

profile_field_xxxxx

Пример: Чтобы создать настраиваемое поле «жанр», вы должны написать краткое название «жанр» в новом поле и написать «profile_field_genre» в заголовке .csv файла.

Для настраиваемых полей профиля, которые являются датами, используйте стандартный формат ISO YYYY-MM