Модуль "Импорт"

Данный модуль позволяет импортировать любые данные в любой модуль системы.

  1. Для корректной работы модуля нужно установить расширение php xmlwriter. Увеличить значение параметров upload_max_filesize и max_post_size в php.ini.
  2. После установки модуля нужно добавить консольную команду php yii import/import в cron на каждые 3 минуты.

Шаблоны для импорта

Первоначально в системе создается шаблон для импорта, в котором задаются учетные данные, отображаемые в интерфейсе, и выбирается “Модель” yii\db\ActiveRecord.

В поле “Модель” необходимо выбрать ActiveRecord, который описывает необходимую таблицу в базе данных. Полем “Пространство имен” можно отсортировать список в поле “Модель”.

В поле “Название папки для сохранения файлов” необходимо указать наименование папки для сохранения будущих импортируемых файлов. Поле должно содержать только латинские буквы и цифры. Не должно содержать пробелы, знаки табуляции и следующие символы “? “ # $ ^ ( ) ; < > [ ] | \ * @ ‘ ~ & /”. Необходимо избегать использование знаков +, - или . в качестве первого символа в имени файла, а также лучше использовать строчные буквы.

Правила валидации

Для того, чтобы обеспечить корректность импортируемых данных, в модуле предусмотрен раздел “Правила валидации” (/import/import-validate-rule/manage).

При добавлении нового правила валидации необходимо задать “Тип поля”.

Если в процессе импорта в файле Excel данные не пройдут валидации, то система выдаст ошибку. Ниже приведено описание типов полей для проверки на соответствие:

Тип валидации Правила валидации
Без валидации Не производить валидацию поля. Применяется, когда не требуется проводить валидацию поля.
Строка тип varchar (меньше 255 символов) Проверка строки длиной не более 255 символов.
Строка тип text (больше 255 символов) Проверка строки длиной более 255 символов.
Целое число Проверка на целое число.
Дробное число Проверка на дробное число с возможностью указания округления до определенного количества символов после запятой.
Дата (dd.mm.yyyy) Проверка на дату в формате dd.mm.yyyy.
Время и дата (DD.MM.YYYY HH:mm) Проверка на дату и время в формате DD.MM.YYYY HH:mm.
Время и дата (DD.MM.YYYY HH:mm:ss) Проверка на дату и время в формате DD.MM.YYYY HH:mm:ss.
Список Проверка на список возможных значений с возможностью их изменения.
E-mail Проверка на Email.
URL Проверка на Url.
Регулярное выражение Проверка на указанное регулярное выражение. Присутствует подготовленный список часто используемых регулярных выражений.

Столбцы шаблона импорта

Когда создан шаблон и правила валидации, то на основании созданного шаблона (/import/import-configuration/manage) добавляются столбцы для импортируемого файла.

При добавлении нового столбца в системе настраивается, куда будут добавлены импортируемые данные.