Как импортировать данные о товарах из XML

27.01.2022

Варианты реализации XML-выгрузки

  1. Возможно передавать данные о товарах и их категориях, как в одном общем файле, так и в двух отдельных (рекомендуется): один - для категорий, второй - для товаров
  2. Возможна, как выгрузка только XML-данных, так и XML-данных вместе с изображениями товаров (рекомендуется). XML-файлы могут загружаться, как в ту же папку, что и изображения, так и в другие доступные для загрузки папки
  3. Если планируется онлайн-продажа товаров на сайте, то в XML-данных о товарах должна быть хотя бы одна свойство, которое можно использовать в качестве цены. Могут быть переданы данные и о других свойствах
  4. Данные можно загружать, как вручную, так и автоматически (рекомендуется) через FTP
  5. При использовании FTP рекомендуется использовать шифрование

Если используются два отдельных XML-файла для категорий и товаров

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


<?xml version="1.0" encoding="windows-1251"?>
<Элементы>
  <Элемент ID="12325" Имя="Аксессуары" РодительID="---"/>
  <Элемент ID="12343" Имя="Аккумуляторы" РодительID="12325"/>
  <Элемент ID="12341" Имя="Зеркала" РодительID="12325"/>
  <Элемент ID="12345" Имя="Наклейки" РодительID="12325"/>
  <Элемент ID="12344" Имя="Сигнализации, магнитолы, подсветка и др." РодительID="12325"/>
  <Элемент ID="12326" Имя="Тюнинг" РодительID="12325"/>
  <Элемент ID="12346" Имя="Фильтра" РодительID="12325"/>
  <Элемент ID="12368" Имя="Бензопилы" РодительID="---"/>
...
  <Элемент ID="12333" Имя="Ремни вариатора генератора" РодительID="12330"/>
  <Элемент ID="12335" Имя="Свечи" РодительID="12330"/>
  <Элемент ID="12337" Имя="Удаленное" РодительID="12330"/>
  <Элемент ID="01111" Имя="Удаленное" РодительID="---"/>
  <Элемент ID="12367" Имя="Удаленное" РодительID="01111"/>
</Элементы>


В примере приведены данные о категориях товаров. У каждой из них есть:

  • ID (нечто уникальное, можно латинские буквы, цифры и дефисы)
  • Имя (здесь ограничений нет)
  • ID родительской категории (для категорий верхнего уровня указываем --- - три дефиса)
  • Могут быть и другие свойства

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

  • XML-заголовок может быть любым, но корректным.
  • Какая бы кодировка ни была указана в XML-заголовке, 1С всегда использует windows-1251. Если в Вашем случае используется другая кодировка, об этом нужно сообщить отдельно
  • В именах тегов и их свойств допускаются буквы (в том числе кириллица), цифры, подчёркивания. Первый символ должен быть буквой. Других ограничений нет.
  • Если через выгрузку нужно удалить с сайта категорию или товар, то для неё/него нужно указать имя Удаленное

<?xml version="1.0" encoding="windows-1251"?>
<Элементы>
  <Элемент ID="00002702" Имя="Автомат сцепления Юпитер" БазоваяЕИ="шт" Категория="12318" АдресФото="DSC03810.JPG" Цена="156" Остаток="37"/>
  <Элемент ID="00003535" Имя="Удаленное" БазоваяЕИ="пара" Категория="12318" АдресФото="DSC03808.JPG" Цена="4190" Остаток="0"/>
  <Элемент ID="00900631" Имя="Амортизатор задний Иж реставрация" БазоваяЕИ="пара" Категория="12318" АдресФото="DSC038082.JPG" Цена="1350" Остаток="1"/>
  <Элемент ID="00004115" Имя="Удаленное" БазоваяЕИ="пара" Категория="12318" АдресФото="DSC038081.JPG" Цена="1578" Остаток="0"/>
  <Элемент ID="00003119" Имя="Барабан задний Юнкер" БазоваяЕИ="шт" Категория="12318" АдресФото="IMG_20160325_162751.jpg" Цена="1990" Остаток="6"/>
  <Элемент ID="00002159" Имя="Барабан передний в сборе ИЖ" БазоваяЕИ="шт" Категория="12318" АдресФото="DSC03798.JPG" Цена="1950" Остаток="4"/>
  <Элемент ID="00004042" Имя="Барабан сцепления Планета широкий Иж П5-01сб.1-41г.Ижевск" БазоваяЕИ="шт" Категория="12318" АдресФото="20171130_175731.jpg" Цена="1350" Остаток="0"/>
  <Элемент ID="00002315" Имя="Барабан сцепления внутрений Иж Планета" БазоваяЕИ="шт" Категория="12318" АдресФото="DSC03805.JPG" Цена="300" Остаток="0"/>
...
  <Элемент ID="00003578" Имя="Барабан сцепления внутрений Иж Юпитер" БазоваяЕИ="шт" Категория="12318" АдресФото="DSC03806.JPG" Цена="300" Остаток="2"/>
  <Элемент ID="00000016" Имя="Удаленное" БазоваяЕИ="шт" Категория="12318" АдресФото="DSC03859.JPG" Цена="2800" Остаток="0"/>
  <Элемент ID="00000015" Имя="Барабан сцепления ИЖ Юпитер 4 узкий в сборе 1-31" БазоваяЕИ="шт" Категория="12318" АдресФото="DSC03858.JPG" Цена="2800" Остаток="7"/>
</Элементы>


В примере приведены данные о товарах. У каждого из них есть:

  • ID (также нечто уникальное, можно латинские буквы, цифры и дефисы)
  • Имя (здесь тоже ограничений нет)
  • Категория (ID одной из категорий - про них написано в описании примера с категориями)
  • Адрес файла с изображением (желательно просто указывать имя файла - при этом нежелательно дублирование имён нескольких файлов)
  • Цена (в рублях)
  • Могут быть и другие свойства, например, единица измерения, остаток на складе
  • Если организация работает с СДЭК и нужен расчёт стоимости и срок доставки также нужны:
    • вес в килограммах
    • габариты в сантиметрах

Если используется один общий XML-файл для категорий и товаров


<?xml version="1.0" encoding="windows-1251"?>
<Элементы>
  <Элемент ID="00013813" Имя="Автомат сцепления ЗАЗ" БазоваяЕИ="шт" КатегорияID="12318" КатегорияНазвание="Сцепление"/>
  <Элемент ID="00092424" Имя="Удаленное" БазоваяЕИ="пара" КатегорияID="12318" КатегорияНазвание="Газ"/>
  <Элемент ID="00100369" Имя="Амортизатор задний ВАЗ" БазоваяЕИ="пара" КатегорияID="12318" КатегорияНазвание="Тормоз"/>
...
</Элементы>


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

Частичный или полный импорт данных

Импортировать можно, как все товары/категории, так и только необходимые. Новые добавятся, уже имеющиеся обновятся (сравнение идёт по ID).

О загрузке файлов

Вам будет предоставлен FTP-доступ к одной из папок на сайте. Желательно использовать шифрование - SFTP или FTPS. Часто бывает, что 1С шифрование не поддерживает. Если так, то можно и обычный FTP, но это не безопасно.

У Вас будет доступ на создание подпапок.

В ту же папку (или в подпапку) можно загружать изображения - каждое в отдельном файле (имена указываются в файле с товарами). После обработки сайт будет перемещать эти картинки в другую папку (по FTP она будет недоступна).

Файлы с данными о товарах/категориях также будут автоматически удаляться при успешном импорте.


CMS Zion WebEngine является бесплатной системой. Развивается за счёт рекламы, помощи веб-студии #webZion и других спонсоров.

 

Будем рады, если Вы поддержите нас любой суммой, а также поделитесь идеями на счёт каких-либо улучшений и доработок для CMS...

 

Заранее, большое, спасибо

 

Блог обновлений

Zion WebEngine X8.07.29
  • Упразднён плагин Ask, который раньше использовался для отправки вопросов в службу поддержки:
    • Теперь для этих целей используется данный Портал поддержки
  • Доработаны главный файл административного интерфейса и класс для управления пользователями:
    • Упразднена панель поддержки:
      • Теперь для этих целей используется данный Портал поддержки
      • Пользователи более старых версий при попытке открыть панель поддержки будут перенаправляться на портал
  • Доработана система мониторинга:
    • При отсутствии поддержки необходимого функцила выдаётся предупреждение о невозможности загрузить данные о курсах валют
  • Доработан класс для управления курсами валют:
    • Во избежании возникновения ошибок часть его возможностей отключается при отсутствии поддержки необходимого функцила
  • Доработан класс для управления XML-данными (спасибо Moto-Retail18):
    • Значительно расширен функционал для импорта данных из 1С
    • Разработка ещё не завершена
  • Доработан класс для управления файлами и папками:
    • Функционал расширен для нужд импорта данных

Zion WebEngine Zion Catalog Zion Server XML/RSS/1С/YML Административный интерфейс Валюты Доступы/Пользователи Импорт/Экспорт Классы Мониторинг Плагины Помощники/Мастеры/Инструкции/Подсказки Файлы/Папки

Zion WebEngine X8.07.26
  • Доработан класс для управления Robokassa (спасибо ЛеоСталь):
    • Доработана инструкция по настройке
    • Устранены некоторые недочёты

Zion Robokassa Robokassa Классы Помощники/Мастеры/Инструкции/Подсказки Способы оплаты

Zion WebEngine X8.07.25
  • Доработан класс для управления Robokassa (спасибо ЛеоСталь):
    • Доработана инструкция по настройке
  • Доработан класс для управления импортом из XLS/CSV:
    • Устранена вероятность появления двойных кавычек, свойственных для формата CSV

Zion Robokassa CSV/Excel Robokassa Импорт/Экспорт Классы Помощники/Мастеры/Инструкции/Подсказки Способы оплаты

Zion WebEngine X8.07.24
  • Доработан класс для управления импортом из XLS/CSV (спасибо ЛеоСталь):
    • Доработана инструкция по подготовке файла с импортируемыми данными
    • Реализована возможность импортировать данные о габаритах и весе
    • Реализована возможность импортировать данные об изображениях из выбранной папки:
      • Если расширение у файла с изображением есть, но оно не указано в файле с импортируемыми данными, то производится поиск файла с расширением, принятым для одного из распространённых форматов (jpg, png, gif, bmp)

Zion Catalog CSV/Excel Вес и габариты Изображение Импорт/Экспорт Классы Помощники/Мастеры/Инструкции/Подсказки Файлы/Папки

Zion WebEngine X8.07.20
  • Доработан класс для управления курсами валют:
    • Исправлена опечатка в инструкции к автоматическому обновлению курса валют (спасибо Moto-Retail18)
  • Доработано меню администратора
  • Создан класс для управления XML-данными:
    • В том числе пригоден для импорта данных из 1С
    • Разработка ещё не завершена
  • Доработан класс для управления файлами и папками:
    • Функционал расширен для нужд импорта данных

Zion WebEngine Zion Catalog XML/RSS/1С/YML Валюты Импорт/Экспорт Классы Меню администратора Помощники/Мастеры/Инструкции/Подсказки Файлы/Папки

Zion WebEngine X8.07.16
  • Доработаны классы для управления навигацией и HTML-кодом веб-страниц
    • В комплект поставки включены примеры использования модальных окон:
      • Доступен пример, в котором для каждой новости реализовано своё отдельное окно
      • Доступен пример, в котором для всех товаров реализовано одно общее окно
        • Данные обновляются через AJAX
  • Доработан класс для управления галереей:
    • Устранена несовместимость слайдов, добавленных по одному, и слайдов, массово добавленных из указанной папки (спасибо GoodАвто)
    • Устранена проблема с неудалением файла изображения вместе со слайдом
    • Реализована опциональная возможность сортировать файлы перед массовым добавлением в галерею
  • Доработан класс для управления файлами и папками:
    • Реализована сортировка папок, которые можно выбрать для быстрой загрузки файлов в галерею
    • Упрощено отображение выпадающего списка папок:
      • Стал доступен поиск нужной папки прямо в выпадающем списке папок:
        • Просто нажмите на список и начните набирать имя искомой папки 

Zion WebEngine Zion Gallery AJAX HTML-код веб-страницы Галереи/Слайды Классы Меню/Списки/Навигация Модальное окно Файлы/Папки

Zion WebEngine X8.07.10
  • Доработан плагин универсального меню:
    • Устранены недоработки при обработке некоторых условий
  • Доработан класс для управления контентом:
    • Реализован запрет подстановки свойств контентных единиц:
      • Полезно в тех случаях, когда требуется привести пример кода подстановки свойства, но саму подстановку делать не требуется

Zion WebEngine Классы Контент/Контентные единицы Меню/Списки/Навигация Мониторинг Пагинация/Подстраницы Плагины Свойства

Zion WebEngine X8.07.02
  • Для улучшения пагинации доработаны плагин универсального меню, класс навигации и помощник по вставке плагина универсального меню:
    • Добавлен параметр maxsubpages, который позволяет ограничить количество подстраниц
      • Активная подстраница автоматически центруется в списке, если это необходимо
    • Доступные новые свойства для использования прямо в оформлении списка:
      • {menu_subpage_firsturl} - ссылка на начало списка - на первую подстраницу
      • {menu_subpage_lasturl} - ссылка на конец списка - на последнюю подстраницу

Zion WebEngine Классы Меню/Списки/Навигация Мониторинг Пагинация/Подстраницы Плагины Помощники/Мастеры/Инструкции/Подсказки Свойства

Zion WebEngine X8.06.30
  • Доработан драйвер оболочки:
    • Реализован запрет поиска команд для запуска любых плагинов:
      • Полезно в тех случаях, когда требуется привести пример кода запуска плагина, но сам запуск делать не требуется

Zion WebEngine Драйверы Мониторинг Плагины

Zion WebEngine X8.06.22
  • Доработано сравнение товаров:
    • Устранены проблемы при отображении/скрытии габаритов товаров
  • Доработаны записи по умолчанию:
    • Скорректирован набор характеристик для товаров:
      • В том числе учтены некоторые особенности СДЭК
    • Скорректировано оформление новостей, товаров и аксессуаров
  • Доработан модуль связи с СДЭК:
    • Устранены некоторые недочёты
    • Реализовано отображение уведомлений в случае указания некорректных параметров
    • Реализован точный расчёт стоимости и срока доставки с учётом веса и габаритов каждого отдельного товара:
      • При отсутствии данных о весе и габаритах для какого-либо из товаров подставляются настраиваемые данные по умолчанию
  • Драйвер Shop для управления заказами в Интернет-магазине удалён из комплекта поставки:
    • Весь его функционал реализован в других компонентах новой платформы
  • Доработано управление галереями:
    • При правке галереи теперь видно не только изображение, но и его адрес
    • Реализована возможность удалять слайды вместе с файлами изображений:
      • При этом удаляются все слайды с этим изображением из всех галерей
      • Также удаляются эскизы, которые нужны для предпросмотра изображений в файл-менеджере
      • Удаление файлов происходит только при наличии у соответствующей группы пользователей доступа к файл-менеджеру:
        • Без наличия такого доступа удаляется только слайд, связанный с этим изображением (во всех галереях)
    • Набор полей, доступных для слайдов в галереях, теперь можно настроить прямо в шаблоне:
      • Ограничения доступа для групп пользователей продолжают влиять на доступность полей в слайдах:
        • И те и другие параметры не конфликтуют, а дополняют друг друга:
          • Из соображений безопасности запрет доступа в одном месте имеет приоритет над разрешением в другом месте
      • По умолчанию доступны все поля
  • Доработаны административные JS-скрипты
  • Обновлены изображения, доступные в комплекте поставки для примера

Zion WebEngine Zion Catalog Zion xDelivery Zion Gallery Zion Pub Hub Вес и габариты Галереи/Слайды Доступы/Пользователи Драйверы Интернет-магазин Контент/Контентные единицы Корзина для заказов Настраиваемые модули Платформа СДЭК Способы доставки/самовывоза Сравнение Файл-менеджер Шаблоны контента Элементы Эскизы

Zion WebEngine X8.06.21
  • Завершён перевод пакета Zion Qiwi на новую платформу
  • Внесены некоторые доработки в класс для работы с доставкой
  • Доработан класс для управления контентом:
    • Улучшена обработка свойств некоторых элементов контента
    • Улучшено сравнение товаров
  • Доработаны записи по умолчанию, касающиеся отображения веса и габаритов товаров

Zion WebEngine Zion Catalog Zion Qiwi Qiwi Касса Вес и габариты Классы Контент/Контентные единицы Платформа Способы доставки/самовывоза Способы оплаты Сравнение Элементы

Zion WebEngine X8.06.16
  • Доработаны административные скрипты
  • Создан класс для управления файлами и папками
  • Реализовано массовое добавление изображений в галерею (спасибо Good Авто):
    • Достаточно просто выбрать одну из папок, и в галерею добавятся все файлы внутри неё
    • Есть опциональное отключение дублирования для файлов, которые уже добавлены в эту галерею

Zion WebEngine Zion Gallery Галереи/Слайды Классы Файлы/Папки Элементы

Zion WebEngine X8.06.15
  • Доработаны класс для управления навигацией и плагин универсального меню:
    • Расширен список условий для более тонкой настройки каждого элемента списка или меню
  • Доработан класс для управления датами:
    • Создан плагин, позволяющий вернуть временную метку прошедшего или будущего времени с указанными смещением от текущего времени:
      • Можно указать количество секунд, минут, часов, дней, месяцев или лет, которые уже прошли или должны пройти
      • Удобно для отображения, например, статей или новостей, за час, неделю и т.д.

Zion WebEngine Zion Pub Hub Дата/Время/TimeMashine Классы Контент/Контентные единицы Меню/Списки/Навигация Мониторинг Плагины Условия Элементы

Zion WebEngine X8.06.14
  • Доработана система мониторинга для сайта-каталога и интернет-магазина

Zion Catalog Интернет-магазин Мониторинг Сайт-каталог

Zion WebEngine X8.06.08
  • Продолжен перевод пакета Zion Qiwi на новую платформу:
    • Удалены все архаизмы из старой платформы
    • Реализована инструкция по настройке
    • Доработан класс платёжного модуля
      • Работа ещё не завершена
  • Доработана графическая составляющая пакетов Zion Catalog и Zion Qiwi
  • Доработано автоматическое создание способов оплаты по умолчанию
  • Устранена опечатка в инструкции по настройке Robokassa
  • Доработана система мониторинга для Zion ExpressDelivery и Zion Catalog
  • Создан новый элемент контента "Вес и габариты":
    • Он будет использоваться для наиболее точного расчёта срока и стоимости доставки

Zion Catalog Zion xDelivery Zion Robokassa Zion Qiwi Qiwi Касса Robokassa Вес и габариты Классы Мониторинг Настраиваемые модули Платформа Способы доставки/самовывоза Способы оплаты Элементы

Zion WebEngine X8.06.07
  • Доработан элемент контента Число (спасибо Good Авто):
    • Устранены недочёты при редактировании дробных чисел
  • Расширен функционал класса для управления контентом
  • Переработано использование некоторых параметров в плагине универсального меню
    • В том числе можно управлять отображением/скрытием элементов контента, которые имеют пустые, нулевые или незаполненные значения
  • Создан новый элемент контента "Выбор нескольких вариантов":
    • Список вариантов редактируется при правке шаблона
    • При правке контента для каждого варианта доступна соответствующая галочка

Zion WebEngine Zion Catalog Выбор нескольких вариантов Классы Контент/Контентные единицы Меню/Списки/Навигация Число Элементы

Zion WebEngine X8.06.04
  • Доработан плагин универсального меню (спасибо Moto-Retail18):
    • Устранены некоторые недочёты при отображении/скрытии списка подстраниц

Zion WebEngine Меню/Списки/Навигация Пагинация/Подстраницы Плагины

Zion WebEngine X8.05.27
  • Доработана система мониторинга:
    • Реализовано отображение уведомления в случае отсутствия в конфигурации веб-сервера компонентов, необходимых для расчёта стоимости и срока доставки заказа в Интернет-магазине
  • Начат перевод пакета Zion Qiwi на новую платформу:
    • Создан класс для управления модулем для онлайн-оплаты через Qiwi Кассу
    • Разработка ещё не завершена
  • Доработан класс для управления корзиной заказов
    • Форма и обработчик заказа приведены в соответствие актуальным требованиям Qiwi Кассы
  • Доработан класс для управления модулем онлайн-оплаты через Robokassa
    • Учтена возможность неконфликтного одновременного множественного использования одного и того же платёжного модуля с различными параметрами

Zion Catalog Zion xDelivery Zion Robokassa Zion Qiwi Qiwi Касса Robokassa Интернет-магазин Корзина для заказов Мониторинг Настраиваемые модули Обработчики Платформа Способы доставки/самовывоза Способы оплаты Формы

Zion WebEngine X8.05.26
  • Доработан вспомогательный класс для работы с вкладками (спасибо Good Авто):
    • Улучшена совместимость с PHP 7.2.1
  • Доработан класс для управления категориями:
    • Устранены некоторые недочёты
  • Доработан плагин отображения контента:
    • Отменено отображение некоторых уведомлений
  • Доработан класс для управления базой данных:
    • Учтено отсутствие некоторых компонентов в комплекте поставки (спасибо Moto-Retail18)

Zion WebEngine PHP База данных/Таблицы данных Вкладки Категории Классы Контент/Контентные единицы Плагины Уведомления

Zion WebEngine X8.05.24
  • Доработан импорт данных из Excel/CSV (спасибо Moto-Retail18):
    • Улучшена обработка пустых данных
  • Доработана отправка email-сообщения (спасибо Good Авто):
    • Устранена вероятность зацикливания при работе на локальных веб-серверах
  • Доработан плагин универсального меню:
    • Улучшена обработка некоторых условий для тонкой настройки элементов меню/списков

Zion WebEngine Zion Catalog Zion Mail Back CSV/Excel Email-сообщения Веб-сервер/Хостинг Импорт/Экспорт Меню/Списки/Навигация Плагины Условия