Описание полей формы импорта и режимов работы

Чтобы выполнить нужную пакетную операцию с использованием данного модуля необходимо заполнить форму на панели ИМПОРТ. Обязательным является только поле файл или список, значения остальных полей не обязательны.

Значения полей выделенных [квадратными скобками] могут содержаться в операционном файле и отличаться для разных строк файла.

[Куда загружать] - id объекта, дочерними которого становятся загружаемые объекты (если в загружаемом операционном файле есть столбец parent_id и в строках данных указаны соответствующие значения, то данное поле игнорируется).

Файл - операционный файл для ввода или редактирования информации (текстовый файл или архив RAR/ZIP, содержащий операционный файл с именем list.txt).

[Владелец сообщений] (user_id) – id пользователя: кто будет владельцем загружаемых объектов. Если параметр не установлен, то владельцем будет тот, кто загружает.

[Группа пользователей] (group_id) - группа для загружаемых объектов (id группы пользователей). Если параметр не установлен, группа будет такая же, как у родительских объектов.

[Права сообщений] (rg,wg,xg,ro,wo,xo) - задает права загружаемых объектов.

Параметры для заголовка - список параметров, из которых будет создаваться заголовок, если отсутствует столбец mess_header. Если данное поле не заполнено и отсутствует mess_header, то заголовок формируется из номера строки операционного файла.

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

Управление - шаблон заголовка при загрузке архива RAR/ZIP с отсутствующим файлом list.txt (перечень полей в автогенерируемом list.txt).

Данные - шаблон строки данных при загрузке архива RAR/ZIP с отсутствующим файлом list.txt (шаблон для автогенерации list.txt).

Список - альтернатива операционного файла, первая строка - описание структуры загружаемых данных, следующие строки - данные.

Импорт (объект | параметры ) - режим работы импорта - загрузка объектов или параметров и их групп.

Тест - данный модуль запускается в режиме тестирования, т.е. анализируются загружаемые данные, выводится вся диагностическая информация, но не производятся операции добавления и редактирования объектов.

Будьте внимательны при использовании данного модуля! Результаты операции пакетного редактирования не обратимы.

Допустимы следующие способы импорта объектов:

Используется поле "Файл": загружается текстовый операционный файл (list.txt)

В поле файл загружен текстовый файл (и любым именем и расширением), содержащий данные в формате CSV согласно формату операционного файла. В этом случае вся информация о вводимых объектах, включая их контент и значения иных параметров должна содержаться в самом текстовом файле. При таком варианте невозможно ввести параметры с картинками или параметры, текст которых должен быть получен из doc или иных дополнительных файлов.

Используется поле "Список"

В поле список вводится текст, согласно все тому же формату операционного файла. Этот способ полностью аналогичен первому варианту, за исключением того, что никаких файлов создавать не нужно.

Пример.

Задача: создать пять новых разделов внутри каталога с id 12345.

Вместо того, чтобы создавать объекты руками – используем импорт. В поле "список" достаточно вставить один столбец с заголовками, если нужны другие параметры (с общими для всех новых объектов значениями) выбираем при импорте нужный образец или устанавливаем образец для раздела в которой производится импорт (с помощью параметра "образец дочерних" из группы "МЕНЕДЖЕР").

Куда загружать: 12345

Список:
mess_header
Первый раздел
Второй раздел
Третий раздел
Четвертый раздел
Последний раздел

Используется поле "Файл": ZIP/RAR c list.txt внутри

В поле файл загружен архив ZIP/RAR. В этом случае загружаемый архив обязательно должен содержать операционный файл, названный list.txt. Формат list.txt аналогичен варианту (А): но при этом можно также работать и со значениями параметров типа file и image. В качестве значения такого параметра в list.txt необходимо просто указать имя загружаемого файла с расширением.

Например:

mess_header;	icon;	mess_content_file;	mess_content_doc
Заголовок 1;	foto1.jpg;	1.html;
Заголовок 2;	foto2.gif;	;	1.doc

Из файлов, указанных в столбце mess_content_file будет извлечено содержимое без каких-либо изменений - только для текстовых и html файлов; файлы, указанные в mess_content_doc - будут пропущены через конвертор (допустимые форматы файлоы: doc, rtf, xls) перед вставкой текста на сайт.

И сам файл list.txt, и все упомянутые в нем файлы, должны находиться в загружаемом архиве. В именах файлов, находящихся в архиве, русские буквы следует использовать с особой осторожностью: обязательно сначала нужно произвести импорт в режиме "Тест" и убедиться что русские имена корректно отображаются, а ошибки при импорте отсутствуют. Возможность, либо невозможность использования русских букв в именах файлах целиком зависит от настроек сервера. Если имеются проблемы, и при тестировании вы видите русские буквы в неправильной кодировке, попробуйте другой формат архива, например RAR вместо ZIP и наоборот.

Используется поле "Файл": ZIP/RAR без list.txt (фотогалереи)

Существует упрощенный режим импорта объектов, предназначенный для наиболее распространенной операции – загрузки фотографий на сайт. Данный режим "включается" в случае, если в загруженном архиве нет операционного файла, а поля "список", "управление" и "данные" (см. ниже) пустые.

Все что нужно сделать чтобы загрузить на сайт фотографии (или иную графику) – запаковать в zip или rar архив графические файлы (gif / jpg / png), затем отправить такой архив в модуль импорта.

В этом случае:

обязательно нужно заполнить поле "куда загружать" (указать id галереи);
создастся столько объектов, сколько графических файлов будет в архиве;
картинки будут загружены в параметр "графика", если нужно загружать их в другой параметр – используйте автогенерацию операционного файла (см. ниже);
если в самой галерее нет параметра "образец дочерних", а в каждой фотографии требуются какие-то специальные параметры – нужно выбрать образец с этими специальными параметрами в поле формы импорта "образец дочерних";
если нужно автоматически создавать иконки для фотографий – можно это сделать "по требованию" после импорта используя фильтр или же заранее (до импорта) настроить параметр "эффекты иконки".

Используются поля "Управление" / "Данные", "Файл": ZIP/RAR без list.txt (автогенерация операционного файла)

В данном режиме (когда заполнены поля "Управление" и "Данные") операционный файл создается "на лету" при переборе файлов, содержащихся в архиве. Если в архиве содержится также list.txt, то в качестве операционного файла будет использован он.

Данный режим позволяет быстро решать самые разнообразные типовые задачи. Он аналогичен предыдущему, однако позволяет задать собственную логику обработки файлов в архиве, например, объединять по 2 графических файла в один объект, загружать файлы в произвольный параметр, обрабатывать текстовые (txt, doc, xsl) файлы и т.д.

Особенно удобно пользоваться этим режимом при настройке модуля импорта в отдельно стоящем объекте. В этом случае можно ввести настройки "данные"/"управление" для конкретной задачи в параметр объекта "настройки менеджера", а ряд данных, используемых в операционном файле, запрашивать через интерактивную форму.

В поле "Управление" нужно указать первую строку операционного файла (см. формат операционного файла)

В поле "Данные" нужно записать специально составленный шаблон для конкретной операции.
Операционный файл будет составлен в процессе перебора файлов внутри полученного архива.

В шаблоне допустимо использовать следующие обозначения:
$PARAMS [file] – полное имя текущего файла обработанное (в формате файловой системы – кириллица предобазована в трнаслит, нет заглавных букв)
$PARAMS [filename] – имя текущего файла без расширения, обработанное
$PARAMS [fileext] – расширение текущего файла
$PARAMS [fileorig] – оригинальное имя файла текущего без расширения (предусмотрена поддержка кириллицы, заглавных и сточный букв, пробелов)
NB: после $PARAMS, перед квадратными скобками (здесь и далее по тексту) нет пробела.

Если используется вариант отдельно стоящего импорта (не интегрированного в JM) c интерактивной формой, то можно использовать конструкции вида $_REQUEST[p__имя_параметра].

Пример 1:

Управление: mess_header;icon;view_icon_photo;mess_content
Данные: $PARAMS [fileorig];$PARAMS [file];$PARAMS [filename]_ico.$PARAMS [fileext];< p >Текст под фото.< br > © 2008 Имя автора< /p >

В данном случае, в загружаемом архиве должны быть фотографии и вручную изготовленные иконки к ним. Если фотографий называются "abc.jpg", "zxc.gif", то иконки к ним должны называться "abc_ico.jpg", "zxc_ico.gif". Это определено строкой $PARAMS [filename]_ico.$PARAMS [fileext] (имя иконки такое же как у оригинального файла – $PARAMS [filename]) с окончанием "_ico" и расширение такое же как у оригинального файла).

Заголовком объекта стане оригинальное имя файла.

Стоит заметить, что дополнительные файлы, вовлеченные шаблоном исключаются из общего перебора, в противном случае, в вышеуказанном примере объектов было бы в два раза больше чем нужно – по количеству файлов в архиве.

Пример 2:

Тоже, что и в примере 1, однако с получением данных через интерактивную форму (для отдельно стоящего импорта):

import_ctrl=mess_header;icon;view_icon_photo;art_author;art_keywords;mess_content
import_data=$PARAMS [fileorig] - $_REQUEST[p__uni_topic_ic];$PARAMS [file];$PARAMS [filename]_ico.$PARAMS [fileext];$_REQUEST[p__art_author];$_REQUEST[p__art_keywords]; © 2008 "$_REQUEST[p__site_copyright]".

Значения параметров uni_topic_ic (тема фотогалереи), art_keywords (ключевые слова), art_author (автор) и site_copyright (авторские права) одинаковы для всех загружаемых в данный момент объектов и передаются вместе с архивом через интерактивную форму.

Пример 3:

Управление: id;icon;
Данные: $PARAMS [filename]; $PARAMS [file]

Загрузка графики происходит в уже существующий объект, id которого строго совпадает с именем файла без расширения, при условии существования такого объекта.

В остальном, данный способ импорта работает аналогично предыдущим.