Импорт списка пользователей

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

Как это сделать:

1. Подготовьте таблицу в Google Таблицах со списком пользователей — скачать шаблон. В таблицу вы можете включить колонки со следующими значениями (колонки, которые не будут использованы, нужно удалить):

• email — адрес электронной почты;
• password — пароль;
• fname — имя;
• lname — фамилия;
• mname — отчество;
• identification_number — идентификатор пользователя в вашей системе;
• gender — пол, значение male или female;
• city — город;
• phone — телефон;
• position — должность;
• login — логин;
• password_setup_notification - отправка письма о приглашении на платформу на почту. Актуально только в случае, если пользователь передается с email. Укажите в поле значение "true", если хотите, чтобы письмо было отправлено или "false", если хотите, чтобы пароль был назначен из файла (по умолчанию все пользователи импортируются со значением "false")
• manager_email_1 — почта руководителя; можно добавить колонки manager_email_2, manager_email_3 и т. д. для привязки сотрудника к нескольким руководителям, номера должны идти последовательно);
• manager_login_1 — логин руководителя; можно добавить колонки manager_login_2, manager_login_3 и т. д. для привязки сотрудника к нескольким руководителям, номера должны идти последовательно;
• manager_id_1 — идентификатор руководителя в системе ТренингСпэйс; можно добавить колонки manager_id_2, manager_id_3 и т. д. для привязки сотрудника к нескольким руководителям, номера должны идти последовательно; в качестве значения в поле должен использоваться именно uuid пользователя в системе;
• is_active — используется для деактивации пользователей, значение true или false;
• locale — используется для выбора языка интерфейса пользователя в системе. Укажите в поле значение "ru" (русский язык) или "en" (английский язык). Если поле не указано или оно пустое, по умолчанию будет использован русский язык;
• tenant — укажите дочернюю организацию, к которой должен относиться пользователь. Актуально только если в вашей организации есть такое разделение. Укажите в заголовке столбца tenant и добавьте для каждого пользователя отношение к дочерней организации. Отношение устанавливается в формате записи названий дочерних организаций, к которым должен относить пользователь, через точку с запятой с пробелом (Компания 1; Компания 2; Компания 3);
• custom_field — любая дополнительная информация, которую необходимо добавить для пользователя; чтобы добавить дополнительное поле для пользователя, нужно чтобы его создал администратор в настройках дополнительных полей вашей организации (как это сделать, читайте здесь), после этого вы сможете добавить поле в файл: укажите в заголовке столбца идентификатор поля на латинице, который был добавлен администратором.

Примечания:

• Поле email или login (одно из полей), а также password являются обязательными для заполнения по умолчанию, если не передается поле password_setup_notification со значением "true"
• Если передается поле password_setup_notification со значением "true", то обязательна передача поля email. Поле password при этом передавать не нужно.
• Если для пользователя указаны email и login, то он сможет использовать для входа как email, так и login. Если будет указан только login, то вход в систему возможен только по ссылке на страницу авторизации для конкретной организации. Свяжитесь с техподдержкой для уточнения этих данных.
• Порядок колонок не важен.
• Ограничения по количеству строк нет.
• Вы можете добавить свои колонки. Например, birth_date. Для этого администратор вашей организации должен задекларировать необходимые поля в настройках. После этого вы сможете импортировать данные в эти поля в соответствии с комментарием выше.
• Если в аккаунте есть дочерние организации и администратор не укажет, к каким именно организациям должен относиться загружаемый пользователь, то он будет добавлен во все дочерние организации, к которым принадлежит администратор, осуществляющий импорт. Более подробно ознакомиться с логикой работы дочерних организаций можно здесь.

2. Сохраните таблицу в формате csv. Для этого выберите «Файл» → «Сохранить как». В «Тип файла» укажите «CSV (разделители — запятые)».

3. В личном кабинете на экране «Пользователи» нажмите «Импорт» и загрузите подготовленный csv-файл. Появится предпросмотр данных по первым 4 пользователям.

4. Выберите кодировку, при которой данные отображаются корректно (UTF-8 или Windows-1251). Если в обоих случаях данные отображаются некорректно, обратитесь в техподдержку.

Обратите внимание на поля custom_data:

• если вы использовали только стандартный набор колонок, то в custom_data должно быть пусто;
• если вы добавляли свои колонки (например, birth_date), то они должны появиться в custom_data (название колонки и значение);
• если в custom_data есть какие-то другие колонки, скорее всего, вы допустили опечатку в названии стандартных колонок или забыли удалить добавленную вами колонку. Внесите изменения в файл и импортируйте еще раз.

5. Нажмите на галочку справа сверху:

• Вы увидите количество успешно импортированных пользователей («Успешно добавлено»);
• Если вы что-то некорректно заполнили в csv-файле (например, 2 раза указали данные по одному пользователю), то появится отчёт по всем ошибкам («Обработано с ошибками»).

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