msImportExport

Компонент предназначен для импорта экспорта как документов Modx так и данных других дополнений..

Внимание! Для получения версии пакета с поддержкой PHP 8 пишите в техническую поддержку.

Видео обзор:

Поддерживаемые форматы файлов:

• CSV
• TSV
• XLSX
• ODS
• XML (только экспорт)

Поддерживаемы типы экспорта:

• документы Modx
• категории, товары, связи, галерея MiniShop2;
• данные msOptionsPrice2;
• данные msOptionsColor;
• данные msProductRemain;
• данные msSalePrice;
• данные ms2Gallery;
• данные SEO Pro;
• фиды Yandex.Market для DBS модели.

Поддерживаемы типы импорта:

• документы Modx;
• категории, товары, связи, галерея MiniShop2;
• данные msOptionsPrice2;
• данные msOptionsColor;
• данные msProductRemain;
• данные msSalePrice;
• данные ms2Gallery;
• данные SEO Pro;

Дополнения расширяющие базовый компонент:

• ieMs2 — сервисы импорта/экспорта MiniShop2;
• ieGallery — сервисы импорта/экспорта галерей ms2Gallery и MiniShop2;
• ieMsOptionsPrice2 — сервисы импорта/экспорта msOptionsPrice2;
• ieMsOptionsColor — сервисы импорта/экспорта msOptionsColor;
• ieMsProductRemains — сервисы импорта/экспорта msProductRemains;
• ieMsSalePrice — сервисы импорта/экспорта msSalePrice;
• ieYandexMarket — сервис экспорта Yandex.Market для DBS модел.

Примечание. Если файл экспорта не скачивается, то скорей всего у вас сайт открывается по https протоколу но при этом в системной настройке server_protocol modx стоит http из-за чего ссылка на скачивания получается с http что приводит к блокировке открытия всплывающего окно скачивания.

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

kill -9 `pgrep -f '.*watcher.php'`

Системные события

msieOnLoadServices — загрузка списка сервисов

• msie — объект класса Msie;
• mode — типа сервиса. Допустимые значение: import;export

msieOnManagerCustomCssJs — загрузка скриптов

• controller — экземпляр класса контроллер;
• page — идентификатор страницы

msieOnGetServiceFields — загрузка списка полей

• msie — объект класса Msie;
• mode — типа сервиса. Допустимые значение: import; export.
• service — объект класса MsIeService
• fields — список полей

msieOnExportStart — старт экспорт

• worker — объект класса
• presetId — ID пресета
• skip — прервать действие. Допустимые значения: true; false. По умолчанию false.
• cached — запущен ли экспорт в кэшированном режиме

msieOnExportBeforeFinish — завершение экспорта

• worker — объект класса MsIeWorker
• presetId — ID пресета
• skip — прервать действие. Допустимые значения: true; false. По умолчанию false.
• cached — является ли запуск в кэшированном режиме
• file — файл экспорта

msieOnExportBeforeArchive — перед архивированием данных экспорта

• worker — объект класса MsIeWorker
• presetId — ID пресета
• skip — прервать действие. Допустимые значения: true; false. По умолчанию false.
• files — список файлов для архивации

msieOnExportFinish — конец экспорта

• worker — объект класса MsIeWorker
• presetId — ID пресета
• skip — прервать действие. Допустимые значения: true; false. По умолчанию false.
• cached — запущен ли экспорт в кэшированном режиме
• file — файл экспорта

msieOnExportPrepareQuery — подготовка запроса экспорта

• worker — объект класса MsIeWorker
• presetId — ID пресета
• skip — прервать действие. Допустимые значения: true; false. По умолчанию false.
• config — массив с данными для формирования SQL запроса

msieOnExportBeforePrepareRow
msieOnExportAfterPrepareRow — подготовка данных записи экспорта

• worker — объект класса MsIeWorker
• presetId — ID пресета
• skip — прервать действие. Допустимые значения: true; false. По умолчанию false.
• dataType — тип записи. Допустимые значение:keys;fields;records.
• data — массив данных

msieOnExportBeforeWriteRow
msieOnExportAfterWriteRow — запись данных в файл

• worker — объект класса
• presetId — ID пресета
• skip — прервать действие. Допустимые значения: true; false. По умолчанию false.
• dataType — тип записи. Допустимые значение:keys;fields;records.
• data — массив данных
• options — массив опций

msieOnImportStart — старт импорта

• worker — объект класса MsIeWorker
• presetId — ID пресета
• skip — прервать действие. Допустимые значения: true; false. По умолчанию false.
• files — массив файлов импорта

msieOnImportBeforePrepare — подготовка данных импорта

• worker — объект класса MsIeWorker
• presetId — ID пресета
• skip — прервать действие. Допустимые значения: true; false. По умолчанию false.
• data — массив данных импорта

msieOnImportAfterPrepare
msieOnImportBeforePrepare — подготовка данных импорта

• worker — объект класса MsIeWorker
• presetId — ID пресета
• skip — прервать действие. Допустимые значения: true; false. По умолчанию false.
• data — массив данных импорта
• record — подготовленные данные импорта
• action — действие. Допустимые значение: create; update.

msieOnBeforeImport — импорт данных

• worker — объект класса MsIeWorker
• presetId — ID пресета
• skip — прервать действие. Допустимые значения: true; false. По умолчанию false.
• data — массис данных импорта
• record — подготовленные данные импорта
• action — действие. Допустимые значение: create; update.
• tvs — массив tv полей (присутствует только у сервиса быстрого обновления)
• poolQuery — массив SQL запросов быстрого обновления (присутствует только у сервиса быстрого обновления)

msieOnImport — импорт данных

• worker — объект класса MsIeWorker
• presetId — ID пресета
• skip — прервать действие. Допустимые значения: true; false. По умолчанию false.
• data — массив данных импорта
• record — подготовленные данные импорта
• object — массив данных объекта импорта
• action — действие. Допустимые значение: create; update.

msieOnImportNotUnique — проверка на дублирование

• worker — объект класса MsIeWorker
• presetId — ID пресета
• skip — прервать действие. Допустимые значения: true; false. По умолчанию false.
• data — массив данных импорта
• record — подготовленные данные импорта
• field — название проверочного поля. По умолчанию “alias”
• duplicate — ID дублирующего ресурса

msieOnImportFinish — конец импорта

• worker — объект класса MsIeWorker
• presetId — ID пресета
• skip — прервать действие. Допустимые значения: true; false. По умолчанию false.
• ids — массив ID объектов которые были созданы/обновлены в процессе импорта. Параметр присутствует только для сервисов импорта каких либо ресурсов Modx.

Примечание! Любой из сервисов также может к перечисленному списку параметров событий добавлять свои, поэтому также необходимо смотреть параметры событий на страницах конкретных дополнений которые добавляют свои сервисы.

Не скачивается файл экспорта

Если файл экспорта не скачивается, то скорей всего у вас сайт открывается по https протоколу, но при этом в системной настройке server_protocol Modx стоит http. В результате ссылка на скачивание получается с http, что приводит к блокировке открытия всплывающего окна скачивания.

Зависания процесса обновлении :

Если при обновлении пакета зависает процесс то скорей всего у вас накопилось большое количества файлов в директориях

/ваш путь/assets/components/msimportexport/tmp
/ваш путь/assets/components/msimportexport/upload
/ваш путь/core/components/msimportexport/data/task

А так как при обновлении пакета его текущею версия Modx архивирует то этот процесс в случае большого количества файлов занимает длительное время что в итоге привышает лимит выполнения php скрипта и процесс установки отваливается.
Решение
В консоли сервера выполните следующее команды которые находят в указанных директория файлы и папки старше 1 дня у удаляет их

find /ваш путь/assets/components/msimportexport/tmp -mindepth 1 -mtime +1 \( -type f -o -type d -empty \) -exec rm -rf {} +
find /ваш путь/assets/components/msimportexport/upload -mindepth 1 -mtime +1 \( -type f -o -type d -empty \) -exec rm -rf {} +
find /ваш путь/core/components/msimportexport/data/task -mindepth 1 -mtime +1 \( -type f -o -type d -empty \) -exec rm -rf {} +

для удаление файлов старше 30 минут замените -mtime +1 на -mmin +30

Переход с первой версии на вторую:

Вторая версия компонента не совместима с первой поэтому просто так обновится не получится и лучше всего ее использовать на новых проектах.

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

• msie_cron
• msie_head_alias
• msie_access_price
• msie_presets_fields