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

Урок 97 из 256
Автор: Анна Кокина
Сложность урока:
4 уровень - сложно, требуется сосредоточится, внимание деталям и точному следованию инструкции.
4 из 5
Дата изменения: 20.09.2019
Просмотров: 25336
Ограничения по редакциям: Ограничений нет

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

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

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

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

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

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

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

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

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

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

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

LAST_NAME;PERSONAL_PHOTO;NAME;SECOND_NAME;WORK_POSITION;

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

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

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


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

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

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

Если вы хотите выгрузить пользователей, то выполните следующее:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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



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

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

Мы стараемся сделать документацию понятнее и доступнее,
и Ваше мнение важно для нас