Импорт пользователей из CSV-файла

Урок 54 из 741
Автор: Анна Кокина
Сложность урока:
4 уровень - сложно, требуется сосредоточиться, внимание деталям и точному следованию инструкции.
4 из 5
Просмотров: 88234
Дата изменения: 28.11.2024
Недоступно в лицензиях:
Текущую редакцию Вашего 1С-Битрикс можно просмотреть на странице Обновление платформы (Marketplace > Обновление платформы).
Ограничений нет

  Видеоурок

  Импорт из файла

Внимание! При импорте не происходит перезаписи данных, если логин импортируемого пользователя совпадает с существующим. Будет создан новый пользователь. Также не будет перезаписи данных, если совпадает идентификатор.

Для добавления целого списка пользователей в систему служит специальная страница административного раздела Импорт пользователей (Настройки > Пользователи > Импорт пользователей).

Нажмите на рисунок, чтобы увеличить

Важно! CSV-файл создаётся Создавать CSV-файлы рекомендуется в программе MS Excel. Если вы создали файл в другой программе, то рекомендуется открыть и проверить файл в MS Excel. в кодировке сайта. Кодировку можно посмотреть в форме создания/редактирования сайта (Настройки > Настройки продукта > Сайты > Список сайтов). Обычно это UTF-8.

  Подготовка файла CSV

CSV-файл должен быть подготовлен заранее. Он должен иметь следующий формат:

заголовок
данные
данные
данные

Каждая строка файла — это одна строка таблицы. Заголовок может состоять из любого количества записей, расположенных в одной строке. Он указывает тип данных, содержащихся в разделе, который следует после заголовка. Значения в строках файлов (как заголовка, так и данных) разделяются разделительным символом (delimiter).

Пример заголовка данных пользователей

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

Например, если заголовок файла имеет следующий вид:

LAST_NAME;PERSONAL_PHOTO;NAME;SECOND_NAME;WORK_POSITION;

а в какой-либо из строк нет данных для части полей, скажем, 2, 4 и 5, то строка с данными должна иметь вид:

Иванов;;Андрей;;;

Поля, в которых нет данных, просто отмечены разделителем.

Важно! Для импорта пользователей из CSV-файла минимально необходимое условие – это указание имени (NAME) и фамилии пользователя (LAST_NAME).
Таблица заголовков полей и типов данных

Перед форматированием CSV-файла учтите следующие аспекты:

  • Разделитель (delimiter) может быть любым: запятая (,), точка с запятой (;), пробел или табуляция. Нельзя вводить пробелы между значениями. Если в качестве разделителя выбран пробел, то необходимо следить за тем, чтобы не было двойных пробелов между значениями.
  • Если запятая является частью значения (например: свойства объекта перечислением через запятую), заключите значение в двойные кавычки "рыжий,красный,зеленый".
  • Если двойные кавычки являются частью значения, заключите значение в пару двойных кавычек. Например, "Иван" в CSV-файле должно выглядеть следующим образом: ""Иван"".
  • Пустые строки в CSV-файле не допускаются.
  • Регистр не учитывается в заголовках, строковых значениях, логине.
  • Пароли вводятся с учетом регистра.
  • Логические значения могут быть представлены следующим образом: Y — истина; N — ложь.
  • Данные, расположенные в строке данных после последнего распознанного значения в строке заголовка, игнорируются. Например, если в строке заголовка файла указано 10 значений, а в строке данных упоминается 12 значений, последние 2 будут отброшены.
  • Элементы данных, значения которых не указаны, обрабатываются как пустые строки.
  • Формат времени должен быть установлен в формате языка сайта. Например: MM/DD/YYYY HH:MI:SS (для английского языка), либо DD.MM.YYYY HH:MI:SS (для русского языка).

Пример CSV-файла

Чтобы гарантировать отсутствие ошибок в ходе импорта, проверьте, что данные в файле соответствуют формату, указанному в начале этой главы. Проверить правильность формата файлов можно, открыв CSV-файл в MS Excel, и просмотреть результат:

  • Проверьте заголовки данных.
  • Проверьте, что длина пароля для учетных записей, которые необходимо импортировать, составляет не менее 6 знаков.
  • Проверьте, что длина логина не менее 3 символов.

После проверки CSV-файла можно приступать к импорту.

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

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

  1. Перейдите на страницу Список пользователей (Настройки > Пользователи > Список пользователей);
  2. Нажмите на кнопку с шестерёнкой в правом верхнем углу страницы и выберите Excel, чтобы выгрузить данные из списка;
  3. После выгрузки адаптируйте файл под требования CSV-формата. В частности:
    • удалите итоговые строки внизу таблицы;
    • в заголовке замените названия значений на правильные латинские названия в соответствии с Таблицей типов данных, приведенной в подразделе Подготовка файла CSV;
    • проверьте правильность заполнения полей данными в соответствии с Таблицей типов данных. (Например, значения пола должны быть указаны латинскими буквами M и F, а не записями Мужской и Женский).

  Выполнение процедуры импорта

В форме импорта пользователей в качестве источника данных выберите CSV-файл и нажмите кнопку Далее.

Заполните поля второго шага импорта (закладка Параметры импорта):

Настройка параметров импорта

Совет: по ссылке Пример справа от параметра Файл данных вы можете скачать хороший пример CSV файла с тестовыми данными. Особенно полезен он для администраторов коробочной версии Битрикс24, т.к. содержит пример привязки к подразделениям через IBLOCK_SECTION_NAME_*.
  • Файл данных – укажите путь до CSV-файла.
  • Разделитель полей – укажите разделитель, который использовался в файле.
  • Привязать пользователей к группам – выберите группу (группы с помощью Ctrl), к которой нужно привязать пользователей из файла.
  • Путь к картинкам относительно корня сайта – путь к папке с картинками, относительно которой будут указаны пути значений PERSONAL_PHOTO и WORK_LOGO. Если поле пустое, то в значениях PERSONAL_PHOTO и WORK_LOGO необходимо указать полный путь относительно корня сайта.
  • Привязать пользователей к разделам информационного блока – выберите инфоблок, к которому будут привязаны пользователи, имеющие данные в значении IBLOCK_SECTION_NAME_* Пример:
    В коробочном Битрикс24 можно сразу развести сотрудников по подразделениям. В импортируемом файле * обозначает уровень вложенности подразделения (т.е. если подразделение верхнего уровня, то IBLOCK_SECTION_NAME_1, следующего IBLOCK_SECTION_NAME_2 и т.д.). На втором шаге импорта нужно указать Привязать пользователей к разделам информационного блока: Подразделения.
    . Указать можно только один инфоблок. Если один и тот же пользователь должен быть привязан к разным инфоблокам, то привязку нужно осуществить впоследствии вручную.
  • Разрешить пользователям авторизовываться через LDAP-сервер – укажите имя сервера, через который будет проводиться авторизация. При необходимости можно перейти к созданию сервера сразу с этого шага по ссылке Создать.
  • Оповестить пользователя, если был указан e-mail – оповещать пользователей о регистрации на сайте с помощью выбранного шаблона, если в CSV-файле был указан e-mail.
  • Игнорировать пользователей, логин которых уже существует в системе – укажите эту опцию, чтобы при импорте не добавлялись пользователи с логинами, которые уже существуют в системе.

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

  Просмотр импортированных данных

Для просмотра импортированных данных в административном разделе перейдите на страницу Список пользователей (Настройки > Пользователи > Список пользователей). Откроется таблица со всеми пользователями системы.

Если импорт прошел неправильно, то необходимо удалить все записи, исправить CSV-файл и повторить описанные действия заново.



Нам жаль это слышать… Но мы постараемся быть лучше!

Мы благодарны Вам за помощь в улучшении документации.

Спасибо, мы рады что смогли помочь Вам. Ниже Вы можете оставить свой отзыв или пожелание :)
Мы стараемся сделать документацию понятнее и доступнее,
и Ваше мнение важно для нас
Курсы разработаны в компании «1С-Битрикс»